A feed
is a dynamic scrollable list
of articles
in which articles are added to or removed from either end of the list as the user scrolls. A feed
enables screen readers to use the browse mode reading cursor to both read and scroll through a stream of rich content that may continue scrolling infinitely by loading more content as the user reads.
<section role="feed" aria-busy="false"> ... <article aria-posinset="427" aria-setsize="-1">...</article> <article aria-posinset="428" aria-setsize="-1">...</article> <article aria-posinset="429" aria-setsize="-1">...</article> ... </section>
Description
A feed is a page structure for a scrollable list of articles
where scrolling may cause articles to be added to the top or end of the list. The list establishes an interoperability contract between the web page and assistive technologies that governs scroll interactions so that assistive technology users can read articles, jump forward and backward by article, and reliably trigger new articles to load while in reading mode. Examples include an RSS feed, news feeds, social media feeds like Facebook, Instagram or Twitter, or even a list of related products on an eCommerce page. These streams can be limited or infinite, loading more content as the user scrolls. Implementing the feed pattern allows a screen reader to reliably read and trigger the loading of feed content while in reading mode.
A feed
is a container element whose children are <article>s or have role article
. Each article within a feed should be focusable, with tabindex of 0 or -1. An article should be scrolled into view when it, or a descendant element, receives focus. If the addition of articles occupies the main browser thread, make sure to set aria-busy="true"
on the feed itself, and make sure to set it back to false
when processing ends, or the user may not see the updates.
To ensure good user experience, avoid inserting or removing articles in the middle of a feed
, load new articles before the user has reached the end of the feed, and provide keyboard commands for moving focus among articles so that keyboard users can navigate through your feed. See keyboard interactions below.
If the number of articles is known, set aria-setsize
on the articles themselves. However, if the total number is extremely large, indefinite, or changes often, set aria-setsize="-1"
to indicate that the size of the feed is not known.
Another feature of the feed pattern is skim reading: Articles within a feed can contain both an accessible name with the aria-label
and a description with an aria-describedby,
suggesting to screen readers which elements to speak after the label when navigating by article. By identifying the elements inside of an article that provide the title and the primary content, assistive technologies can provide functions that enable users to jump from article to article and efficiently discern which articles they want to read.
The feed pattern enables reliable assistive technology reading mode interaction by establishing the following interoperability agreement between the web page and assistive technologies:
- In the context of a feed, the web page code is responsible for:
- Appropriate visual scrolling of the content based on which article contains DOM focus.
- Loading or removing feed articles based on which article contains DOM focus.
- In the context of a feed, assistive technologies with a reading mode are responsible for:
- Indicating which article contains the reading cursor by ensuring the article element or one of its descendants has DOM focus.
- Providing reading mode keys that move DOM focus to the next and previous articles.
- Providing reading mode keys for moving the reading cursor and DOM focus past the end and before the start of the feed.
Keyboard interaction
Supporting the following, or a similar, interface is recommended when focus is inside the feed:
- Page Down: Move focus to next article.
- Page Up: Move focus to previous article.
- Control + End: Move focus to the first focusable element after the feed.
- Control + Home: Move focus to the first focusable element before the feed.
If a feed is nested within a feed, such as a comments feed within a feed of blog posts, the convention is to tab into the nested feed with the Tab key and to provide another key, such as Alt + Page Down, to navigate from an 'outer' article to the first item in that article's nested feed. Navigate between the nested feed and main feed with Control + End , moving focus from the inner feed to the next article in the outer feed.
WAI-ARIA roles, states, and properties
- aria-labelled
- If the feed has no visible title, the
feed
element has a label specified with aria-label. If it does, see aria-labelledby. - aria-labelledby
- If the feed has a visible title, the
feed
element has aria-labelledby referring to the element containing the title. If not, add an aria-label. - aria-busy
- When busy, such as when articles are being added or removed from the
feed
, setaria-busy="true"
during the update operation. Make sure it's reset tofalse
when the operation is complete or the changes may not become visible. - article
- Each section of content in a feed should be contained in an
<article>
or element with role article. Eacharticle
should have an aria-labelledby referring to the article title or other child that can serve as a distinguishing label. Each article should preferably have aria-describedby referring to one or more elements inside the article that serve as the primary content of the article. Eacharticle
element has aria-posinset set to a value that represents its position in the feed and an aria-setsize set to a value that represents either the total number of articles that have been loaded or the total number in the feed, depending on which value is more helpful to users. If the total number in the feed is not known, setaria-setsize="-1"
.
Required JavaScript features
None, except as required by any attributes. For example, setting aria-busy
to true
during the update operation if needed, and then to false
upon completion.
Examples
Example Implementation of Feed Pattern
Specifications
Specification | Status |
---|---|
Accessible Rich Internet Applications (WAI-ARIA) 1.1 The definition of 'feed' in that specification. |
Recommendation |
Screen reader support
Coming soon
See also
- HTML <article> element
- Lists in HTML
- ARIA: article role
- ARIA: list role
- WAI-ARIA Authoring Practices - additional details on implementing a feed design pattern.