Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Draft guidance on aria-details #70

Open
TzviyaSiegman opened this issue Aug 2, 2016 · 7 comments
Open

Draft guidance on aria-details #70

TzviyaSiegman opened this issue Aug 2, 2016 · 7 comments
Assignees
Labels
Practice Page Related to a page within the practices section of the APG Required for ARIA Spec Resolution needed to permit merging of an ARIA feature into the stable branch of the spec

Comments

@TzviyaSiegman
Copy link

aria-details is new to ARIA 1.1. It would be very useful to include best practices for details, especially as opposed to described-by. Members of DPUB can be called upon to assist or provide samples.

@TzviyaSiegman
Copy link
Author

Aside from the obvious examples of descriptions being hidden by default, it would be valuable to see examples of descriptions displayed by default. (This is a request from George Kerscher on behalf of DAISY et al)

@mcking65 mcking65 added this to the 1.1 PR milestone Aug 15, 2016
@mcking65 mcking65 changed the title add information about aria-details Draft guidance on aria-details Jan 19, 2017
@mcking65 mcking65 added the Practice Page Related to a page within the practices section of the APG label Jan 25, 2017
zcorpan added a commit that referenced this issue Feb 28, 2019
@zcorpan zcorpan self-assigned this Mar 14, 2019
zcorpan added a commit that referenced this issue Apr 29, 2019
mcking65 pushed a commit that referenced this issue Jun 28, 2019
Addresses issues #70 and #74 by adding section 5: - providing accessible names and descriptions.
michael-n-cooper pushed a commit that referenced this issue Jun 28, 2019
Add section on accessible names and descriptions (pull #994)

Addresses issues #70 and #74 by adding section 5: - providing accessible names and descriptions.
mcking65 added a commit that referenced this issue Jul 11, 2019
… 1050 (pull #1062)

* Fallback naming guidance section: reference cardinal rule 4 to avoid it.
* Naming Rule 3: Remove mention of alt attribute: Per feedback from @LJWatson in issue #1050, revises rule 3 to remove mention of alt.
* Adds sentence refering readers to the naming techniques for specific advantages of using HTML features instead of ARIA.
* Fix formatting and bugs in code snippets reported in #1060.
* Intro: most fundamental and important -> most important
* Minor editorial change to section: How Are Name and Description Strings Derived?
* Intro paragraph: additional editorial simplification based on feedback from @LJWatson in issue #1050.
* Clarify language describing when captions become descriptions: to resolve feedback from @jessebeach in issue #1050. Modified language in sections 5.3.2.6 Naming Tables and Figures with Captions  and  section 5.4.1.3 Describing Tables and Figures with Captions.
* Provide richer description of screen reader behavior in section 5.1 per feedback from @jongund in issue #1050.
* Remove aria-details guidance, which will be addressed in the future by issue #70.
@mcking65 mcking65 modified the milestones: 1.1 APG Release 4, 1.2 CR Aug 14, 2019
@mcking65 mcking65 modified the milestones: 1.2 Release 1, 1.2 Release 2 Dec 9, 2019
@jnurthen jnurthen added the Required for ARIA Spec Resolution needed to permit merging of an ARIA feature into the stable branch of the spec label Mar 19, 2021
@jnurthen
Copy link
Member

This is now critical for the spec with the changes for annotations to support multiple idrefs

Content to support this can be taken from https://github.com/aleventhal/aria-annotations

@zcorpan
Copy link
Member

zcorpan commented Mar 20, 2021

#994 covers aria-details and has been merged. Can this issue be closed?

@jnurthen
Copy link
Member

@zcorpan I see this was done but do not see it in the latest editors draft https://w3c.github.io/aria-practices/#describing_techniques

@jnurthen
Copy link
Member

Looks like #1062 removed it

@zcorpan
Copy link
Member

zcorpan commented Mar 22, 2021

Ah right, OK. Thanks.

@jongund
Copy link
Contributor

jongund commented Mar 22, 2021

Biggest problem for general usage of aria-details outside of DPUB is support screen readers, but maybe the ARIA-AT project can help shine light on this problem,

@a11ydoer a11ydoer modified the milestones: Launch Redesigned APG, ARIA 1.3 additions in support of ARIA 1.3 public working draft Jan 18, 2022
@mcking65 mcking65 modified the milestones: ARIA 1.3 public working draft additions, ARIA 1.3 Additions Jul 26, 2023
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
Practice Page Related to a page within the practices section of the APG Required for ARIA Spec Resolution needed to permit merging of an ARIA feature into the stable branch of the spec
Projects
Development

No branches or pull requests

6 participants