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

Improve understandability of Figure in "Rules of ARIA attribute usage by HTML element" table #497

Open
giacomo-petri opened this issue Dec 20, 2023 · 0 comments · May be fixed by #498
Open

Comments

@giacomo-petri
Copy link
Contributor

giacomo-petri commented Dec 20, 2023

  • URL: https://www.w3.org/TR/html-aria/#el-figure

  • Issue description:
    The existing content in the "ARIA role, state, and property allowances" cell for the Figure is as follows:

    If the figure has no figcaption descendant:
    Any role, though figure is NOT RECOMMENDED.

    If the figure has a figcaption descendant:
    DPub Role: doc-example.

    Otherwise, figure is allowed, but NOT RECOMMENDED.

    Global aria-* attributes and any aria-* attributes applicable to the allowed roles.

    The if-if-else structure is perplexing because the "otherwise" scenario may never be applicable, given that the second "if" statement is the opposite of the first one and covers the entirety of the options (if has no figcaption descendant, if has figcaption descendant, otherwise).

    Additionally, the "Otherwise" condition diverges from the typical instances found in the document, where it generally advises "No role other than ***, which is NOT RECOMMENDED.".

    I am submitting a pull request that introduces a suggested resolution to address these concerns.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
1 participant