wai-website icon indicating copy to clipboard operation
wai-website copied to clipboard

structure and semantics updates?

Open shawna-slh opened this issue 2 years ago • 5 comments

Let's review structure and semantics in the templates, tools, and pages. For example:

Banners/Headers

  • [ ] Should the top part with the logos be marked <banner> or <header>?
    • [ ] Is that implemented consistently in the main site, the report tools, the listings, the minimal-headers /standalone-resources?
  • [ ] Is <header> used where it should not be? e.g., is <header> not good within the <aside> for Page Contents, and it should have an h2 or other instead?

Asides

  • [ ] Some HTML elements have implicit ARIA roles — e.g., HTML <aside> and ARIA complementary. Are we using them in ways that work well for ARIA?
  • [ ] Are <aside>s used where they should not be? (Asides are for "content that is tangentially related... and which could be considered separate from that content". HTML spec)
    e.g., is <aside> not good for "Rule Mapping" in Rules because it is essential content. Is it not good for the Page Contents box, because that is neither tangential or separate?

Navigation

  • [ ] Are the navigation areas appropriately marked up? Including:
    • [ ] Main navigation (along the top)
    • [ ] Secondary navigation (along the left)
    • [ ] Page Contents (inline for main WAI site, float right for most minimal-header pages)

ARIA

  • [ ] Are we providing landmarks and labels as we would like to?

More info below.

shawna-slh avatar May 06 '22 18:05 shawna-slh