From d2789add482490ddf99515a31caf36b58a1c67c7 Mon Sep 17 00:00:00 2001 From: Simon Pieters Date: Mon, 28 Oct 2019 21:25:56 +0100 Subject: [PATCH 1/4] Add naming guidance for blockquote, meter and time roles Fixes #1212. --- aria-practices.html | 32 ++++++++++++++++++++++++++++++++ 1 file changed, 32 insertions(+) diff --git a/aria-practices.html b/aria-practices.html index 22a8825b9..b01b13593 100644 --- a/aria-practices.html +++ b/aria-practices.html @@ -4235,6 +4235,16 @@

Accessible Name Guidance by Role + + blockquote + Discretionary + +
    +
  • Naming is optional, but can potentially help screen reader users understand the context and purpose of the quote.
    • +
  • Named using aria-labelledby if a visible label is present, otherwise with aria-label.
    • +
+ + button Required Only If Content Insufficient @@ -4588,6 +4598,17 @@

Accessible Name Guidance by Role + + meter + Required + +
    +
  • If the meter role is applied to an HTML meter element, can be named with an HTML label element.
    • +
  • Otherwise use aria-labelledby if a visible label is present.
    • +
  • Use aria-label if a visible label is not present.
    • +
+ + navigation Recommended @@ -4869,6 +4890,16 @@

Accessible Name Guidance by Role + + time + Discretionary + +
    +
  • Naming is optional, but can potentially help screen reader users understand the context and purpose of the given specific point in time.
    • +
  • Named using aria-labelledby if a visible label is present, otherwise with aria-label.
    • +
+ + timer Discretionary @@ -6464,6 +6495,7 @@

Roles That Automatically Hide Semantics by Making Their Descendants Presenta
  • button
  • checkbox
  • img
    • +
  • meter
  • math
  • menuitemcheckbox
  • menuitemradio
    • From 471b50034e10f5cd396cb75996c39523223783d9 Mon Sep 17 00:00:00 2001 From: Simon Pieters Date: Tue, 29 Oct 2019 20:30:58 +0100 Subject: [PATCH 2/4] Apply suggestions from code review Co-Authored-By: Matt King --- aria-practices.html | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/aria-practices.html b/aria-practices.html index b01b13593..ab1039c52 100644 --- a/aria-practices.html +++ b/aria-practices.html @@ -4603,7 +4603,7 @@

    Accessible Name Guidance by RoleRequired
      -
    • If the meter role is applied to an HTML meter element, can be named with an HTML label element.
      • +
    • If based on an HTML meter element, can be named with an HTML label element.
    • Otherwise use aria-labelledby if a visible label is present.
    • Use aria-label if a visible label is not present.
    @@ -4891,7 +4891,7 @@

    Accessible Name Guidance by Role - time + time Discretionary
      From 4120cea1ece0b8b961cf3ba4a91494815561de38 Mon Sep 17 00:00:00 2001 From: Simon Pieters Date: Thu, 31 Oct 2019 19:57:33 +0100 Subject: [PATCH 3/4] Change suggestion for blockquote; change time to Do Not Name --- aria-practices.html | 14 +++----------- 1 file changed, 3 insertions(+), 11 deletions(-) diff --git a/aria-practices.html b/aria-practices.html index ab1039c52..43bd9aa68 100644 --- a/aria-practices.html +++ b/aria-practices.html @@ -4239,10 +4239,7 @@

      Accessible Name Guidance by Roleblockquote Discretionary -
        -
      • Naming is optional, but can potentially help screen reader users understand the context and purpose of the quote.
        • -
      • Named using aria-labelledby if a visible label is present, otherwise with aria-label.
        • -
      + If a visible label is present, associating it with the blockquote by using aria-labelledby could benefit some assistive technology users. @@ -4892,13 +4889,8 @@

      Accessible Name Guidance by Role time - Discretionary - -
        -
      • Naming is optional, but can potentially help screen reader users understand the context and purpose of the given specific point in time.
        • -
      • Named using aria-labelledby if a visible label is present, otherwise with aria-label.
        • -
      - + Do Not Name + Not supported by assistive technologies. timer From 3409c300e15fad1fd7b4a124e45a2e44b5df61da Mon Sep 17 00:00:00 2001 From: Simon Pieters Date: Tue, 5 Nov 2019 10:42:34 +0100 Subject: [PATCH 4/4] Clarify what is not supported by ATs --- aria-practices.html | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/aria-practices.html b/aria-practices.html index 43bd9aa68..f7bd8152e 100644 --- a/aria-practices.html +++ b/aria-practices.html @@ -4496,7 +4496,7 @@

      Accessible Name Guidance by Role listitem Do Not Name - Not supported by assistive technologies; it is necessary to include relevant content within the list item. + Naming is not supported by assistive technologies; it is necessary to include relevant content within the list item. log @@ -4713,7 +4713,7 @@

      Accessible Name Guidance by Role rowgroup Do Not Name - Not supported by assistive technologies. + Naming is not supported by assistive technologies. rowheader @@ -4890,7 +4890,7 @@

      Accessible Name Guidance by Role time Do Not Name - Not supported by assistive technologies. + Naming is not supported by assistive technologies. timer