Skip to content

Add heading and separator roles to feed's allowed accessibility children#2245

Open
smhigley wants to merge 4 commits intomainfrom
feed-heading
Open

Add heading and separator roles to feed's allowed accessibility children#2245
smhigley wants to merge 4 commits intomainfrom
feed-heading

Conversation

@smhigley
Copy link
Copy Markdown
Contributor

@smhigley smhigley commented Jun 13, 2024

🚀 Netlify Preview:
🔄 this PR updates the following sspecs:

Closes #2236

Based on the working group discussion of the linked issue, we decided to make a quick PR to add heading & separator to feed, and work on ARIA role content models separately. At some point, the content model approach may replace the heading/separator addition when it's ready.

Test, Documentation and Implementation tracking

Once this PR has been reviewed and has consensus from the working group, tests should be written and issues should be opened on browsers. Add N/A and check when not applicable.

  • "author MUST" tests: N/A
  • "user agent MUST" tests: N/A
  • Browser implementations (link to issue or commit): N/A
    • WebKit:
    • Gecko:
    • Blink:
  • ACT review?
  • Does this need AT implementations? no
  • Related APG Issue/PR: N/A
  • MDN Issue/PR: N/A

Preview | Diff

@shirsha
Copy link
Copy Markdown

shirsha commented Jun 24, 2024

In The feed role , "Authors MAY use heading and separator children in a feed . For example, in a feed of news stories there could be headings separating sets of articles into sequential dates. If a feed does have headings or separators as children, they SHOULD NOT be focusable or contain information necessary for understanding or navigating the feed 's articles ."

Confused with last sentence "If a feed does have headings or separators as children, they SHOULD NOT be focusable or contain information necessary for understanding or navigating the feed 's articles ". May be provide examples like timestamp and name etc. Provide some explicit info

Also, will there be any related info is added to the heading and the separator role?

@giacomo-petri
Copy link
Copy Markdown
Contributor

Should we consider adding the scrollbar role as an allowed child element?

When dealing with a high but "static" number of articles, showing them on scroll for any reason (e.g. for performance reasons), this setup might be one of the rare cases where an author would want to create a custom scrollbar.
By doing so, it would give the impression that all the content is already fully loaded, allowing users to see the entire scroll progress right from the initial page load.

I understand that the scrollbar can be positioned outside the feed element, but I don't see why the author shouldn't be allowed to place it inside, as the scrollbar is an integral part of the feed document.

Regarding the rest of the addition, I like it. The details about focusability and not including important text are crucial for maintaining a smooth experience for keyboard users.

@smhigley
Copy link
Copy Markdown
Contributor Author

smhigley commented Jul 8, 2024

Should we consider adding the scrollbar role as an allowed child element?

@giacomo-petri this makes sense to me! Though I think scrollbar should generally be an allowed child of any composite widget, not just feed. Probably as a separate PR, or as part of the roles categorization that @scottaohara mentioned on the last ARIA call -- WDYT?

@smhigley
Copy link
Copy Markdown
Contributor Author

smhigley commented Jul 8, 2024

@shirsha the sentence you quoted contains an example in it -- "For example, in a feed of news stories there could be headings separating sets of articles into sequential dates." Is that example enough to address your comment, or is there additional information you want included?

I didn't add anything to the heading and separator role sections, since this change doesn't affect their usage outside of feed.

@pkra pkra added the spec:aria label Jul 9, 2024
@css-meeting-bot
Copy link
Copy Markdown
Member

The ARIA Working Group just discussed review: normative pr checklist.

The full IRC log of that discussion <ZoeBijl> topic: review: normative pr checklist
<ZoeBijl> we refined the checklist after monorepo
<ZoeBijl> https://github.com//pull/2245
<ZoeBijl> Github: https://github.com//pull/2245

@pkra
Copy link
Copy Markdown
Member

pkra commented Mar 7, 2025

@smhigley rebased on main.

@netlify
Copy link
Copy Markdown

netlify bot commented Mar 7, 2025

Deploy Preview for wai-aria ready!

Name Link
🔨 Latest commit 0c53656
🔍 Latest deploy log https://app.netlify.com/projects/wai-aria/deploys/69737847e859e700085ca0d5
😎 Deploy Preview https://deploy-preview-2245--wai-aria.netlify.app
📱 Preview on mobile
Toggle QR Code...

QR Code

Use your smartphone camera to open QR code link.

To edit notification comments on pull requests, go to your Netlify project configuration.

@spectranaut spectranaut moved this from Needs Review to Reviewed, other needs in ARIA Normative PR Tracking Jun 19, 2025
<code>-1</code> or <code>0</code>.
</p>
<p>
Authors MAY use <rref>heading</rref> and <rref>separator</rref> children in a <code>feed</code>. For example, in a feed of news stories there could be headings separating sets of
Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
Authors MAY use <rref>heading</rref> and <rref>separator</rref> children in a <code>feed</code>. For example, in a feed of news stories there could be headings separating sets of
Authors MAY use elements with role <rref>heading</rref> and <rref>separator</rref> as <a>accessibility children</a> of an element with role <code>feed</code>. For example, in a feed of news stories there could be headings separating sets of

<p>
Authors MAY use <rref>heading</rref> and <rref>separator</rref> children in a <code>feed</code>. For example, in a feed of news stories there could be headings separating sets of
articles into sequential dates. If a <code>feed</code> does have <rref>headings</rref> or <rref>separators</rref> as children, they SHOULD NOT be focusable or contain information
necessary for understanding or navigating the <code>feed</code>'s <rref data-lt="article">articles</rref>.
Copy link
Copy Markdown
Member

@pkra pkra Jun 19, 2025

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I'm not sure about the two SHOULD NOTs.

For the first part is about focusability. Why should headings not be focusable? I'm not sure if the APG example is any good, but thinking about this change from that example, it seems to me a user may want to stop at headings when navigating through the feed.

The second part is about the contents. I feel that's out of scope for ARIA - it feels WCAG-ish to me. Without much deep diving, I couldn't find anything like it in the spec. Are we sure we want to start with this?

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

For comparison, #2159 uses a note for similar author guidance.

@spectranaut spectranaut moved this from Reviewed, other needs to Needs updates from review in ARIA Normative PR Tracking Jul 17, 2025
@github-actions
Copy link
Copy Markdown
Contributor

🚀 Deployed on https://deploy-preview-2245--wai-aria.netlify.app

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

Status: Needs updates from review

Development

Successfully merging this pull request may close these issues.

Consider adding headings to feed's allowed accessibility children

7 participants