From 23dd0fcac7479c9805c1ea13121c21464a63f6b9 Mon Sep 17 00:00:00 2001 From: James Nurthen Date: Mon, 29 Apr 2019 14:46:24 -0700 Subject: [PATCH 01/33] Make aria-label and labelledby non global --- index.html | 80 +++++++++++++++++++++++++++++++++++++++++++++--------- 1 file changed, 67 insertions(+), 13 deletions(-) diff --git a/index.html b/index.html index 1725f4664..4713c7649 100644 --- a/index.html +++ b/index.html @@ -969,7 +969,13 @@

Definition of Roles

Supported States and Properties: - aria-activedescendant + + + Inherited States and Properties: @@ -2500,7 +2506,13 @@

Definition of Roles

Supported States and Properties: - aria-expanded + + + Inherited States and Properties: @@ -2668,7 +2680,12 @@

Definition of Roles

Supported States and Properties: -   + + + Inherited States and Properties: @@ -3039,7 +3056,13 @@

Definition of Roles

Supported States and Properties: - aria-activedescendant + + + Inherited States and Properties: @@ -3213,8 +3236,12 @@

Definition of Roles

Supported States and Properties: -   - + + + Inherited States and Properties: Placeholder @@ -3548,7 +3575,12 @@

Definition of Roles

Supported States and Properties: -   + +   + Inherited States and Properties: @@ -3837,7 +3869,12 @@

Definition of Roles

Supported States and Properties: -   + + + Inherited States and Properties: @@ -5931,11 +5968,14 @@
Presentational Roles Conflict Resolution
Supported States and Properties: - aria-valuetext + Inherited States and Properties: @@ -7828,6 +7868,8 @@
Presentational Roles Conflict Resolution
@@ -8010,7 +8052,12 @@
Presentational Roles Conflict Resolution
Supported States and Properties: -   + + + Inherited States and Properties: @@ -9014,7 +9061,12 @@
Presentational Roles Conflict Resolution
Supported States and Properties: -   + + + Inherited States and Properties: @@ -9093,6 +9145,8 @@
Presentational Roles Conflict Resolution
@@ -10623,7 +10677,7 @@

Definitions of States and Properties (all aria-* attributes)

Used in Roles: - All elements of the base markup + Placeholder Inherits into Roles: @@ -10661,7 +10715,7 @@

Definitions of States and Properties (all aria-* attributes)

Used in Roles: - All elements of the base markup + Placeholder Inherits into Roles: From 11f85f41a5b621fdbe85fc9bcdcd270e653a48ba Mon Sep 17 00:00:00 2001 From: michael-n-cooper Date: Thu, 2 May 2019 17:48:12 +0000 Subject: [PATCH 02/33] TRAVIS-CI update from aria-common --- common/script/roleInfo.js | 213 ++++++++++++++++++++++++++++++-------- 1 file changed, 170 insertions(+), 43 deletions(-) diff --git a/common/script/roleInfo.js b/common/script/roleInfo.js index 9717562df..64ebf3cf9 100644 --- a/common/script/roleInfo.js +++ b/common/script/roleInfo.js @@ -169,6 +169,14 @@ var roleInfo = { ], "localprops": [] }, + "blockquote": { + "name": "blockquote", + "fragID": "blockquote", + "parentRoles": [ + "section" + ], + "localprops": [] + }, "button": { "name": "button", "fragID": "button", @@ -177,17 +185,25 @@ var roleInfo = { ], "localprops": [ { - "is": "property", + "is": "state", "name": "aria-expanded", "required": false }, { - "is": "property", + "is": "state", "name": "aria-pressed", "required": false } ] }, + "caption": { + "name": "caption", + "fragID": "caption", + "parentRoles": [ + "section" + ], + "localprops": [] + }, "cell": { "name": "cell", "fragID": "cell", @@ -800,6 +816,14 @@ var roleInfo = { ], "localprops": [] }, + "deletion": { + "name": "deletion", + "fragID": "deletion", + "parentRoles": [ + "section" + ], + "localprops": [] + }, "dialog": { "name": "dialog", "fragID": "dialog", @@ -1900,6 +1924,22 @@ var roleInfo = { } ] }, + "insertion": { + "name": "insertion", + "fragID": "insertion", + "parentRoles": [ + "section" + ], + "localprops": [] + }, + "label": { + "name": "label", + "fragID": "label", + "parentRoles": [ + "section" + ], + "localprops": [] + }, "landmark": { "name": "landmark", "fragID": "landmark", @@ -2020,6 +2060,14 @@ var roleInfo = { } ] }, + "legend": { + "name": "legend", + "fragID": "legend", + "parentRoles": [ + "section" + ], + "localprops": [] + }, "link": { "name": "link", "fragID": "link", @@ -2028,7 +2076,7 @@ var roleInfo = { ], "localprops": [ { - "is": "property", + "is": "state", "name": "aria-expanded", "required": false } @@ -2361,6 +2409,30 @@ var roleInfo = { ], "localprops": [] }, + "meter": { + "name": "meter", + "fragID": "meter", + "parentRoles": [ + "range" + ], + "localprops": [ + { + "is": "property", + "name": "aria-valuemax", + "required": true + }, + { + "is": "property", + "name": "aria-valuemin", + "required": true + }, + { + "is": "property", + "name": "aria-valuenow", + "required": true + } + ] + }, "menu": { "name": "menu", "fragID": "menu", @@ -2616,6 +2688,11 @@ var roleInfo = { "command" ], "localprops": [ + { + "is": "state", + "name": "aria-expanded", + "required": false + }, { "is": "property", "name": "aria-posinset", @@ -2628,6 +2705,11 @@ var roleInfo = { } ], "allprops": [ + { + "is": "state", + "name": "aria-expanded", + "required": false + }, { "is": "property", "name": "aria-posinset", @@ -2869,6 +2951,11 @@ var roleInfo = { "name": "aria-roledescription", "required": false }, + { + "is": "state", + "name": "aria-expanded", + "required": false + }, { "is": "property", "name": "aria-posinset", @@ -3030,7 +3117,7 @@ var roleInfo = { "required": true }, { - "is": "property", + "is": "state", "name": "aria-checked", "required": false }, @@ -3052,7 +3139,7 @@ var roleInfo = { "required": true }, { - "is": "property", + "is": "state", "name": "aria-checked", "required": false }, @@ -3173,29 +3260,13 @@ var roleInfo = { } ] }, - "password": { - "name": "password", - "fragID": "password", + "paragraph": { + "name": "paragraph", + "fragID": "paragraph", "parentRoles": [ - "input" + "section" ], - "localprops": [ - { - "is": "property", - "name": "aria-placeholder", - "required": false - }, - { - "is": "property", - "name": "aria-readonly", - "required": false - }, - { - "is": "property", - "name": "aria-required", - "required": false - } - ] + "localprops": [] }, "presentation": { "name": "presentation", @@ -3210,7 +3281,7 @@ var roleInfo = { "fragID": "progressbar", "parentRoles": [ "range", - "status" + "widget" ], "localprops": [] }, @@ -3383,7 +3454,7 @@ var roleInfo = { "name": "range", "fragID": "range", "parentRoles": [ - "widget" + "structure" ], "localprops": [ { @@ -3780,11 +3851,21 @@ var roleInfo = { "name": "aria-level", "required": false }, + { + "is": "property", + "name": "aria-posinset", + "required": false + }, { "is": "property", "name": "aria-rowindex", "required": false }, + { + "is": "property", + "name": "aria-setsize", + "required": false + }, { "is": "state", "name": "aria-selected", @@ -3820,7 +3901,8 @@ var roleInfo = { "name": "scrollbar", "fragID": "scrollbar", "parentRoles": [ - "range" + "range", + "widget" ], "localprops": [ { @@ -4369,18 +4451,34 @@ var roleInfo = { "name": "separator", "fragID": "separator", "parentRoles": [ - "structure" + "structure", + "widget" ], "localprops": [ { - "is": "state", - "name": "aria-expanded", - "required": false + "is": "property", + "name": "aria-valuemax", + "required": true + }, + { + "is": "property", + "name": "aria-valuemin", + "required": true + }, + { + "is": "property", + "name": "aria-valuenow", + "required": true }, { "is": "property", "name": "aria-orientation", "required": false + }, + { + "is": "property", + "name": "aria-valuetext", + "required": false } ] }, @@ -4423,33 +4521,39 @@ var roleInfo = { "name": "spinbutton", "fragID": "spinbutton", "parentRoles": [ + "composite", "input", "range" ], "localprops": [ { "is": "property", - "name": "aria-valuemax", - "required": true + "name": "aria-readonly", + "required": false }, { "is": "property", - "name": "aria-valuemin", - "required": true + "name": "aria-required", + "required": false }, { "is": "property", - "name": "aria-valuenow", - "required": true + "name": "aria-valuemax", + "required": false }, { "is": "property", - "name": "aria-readonly", + "name": "aria-valuemin", "required": false }, { "is": "property", - "name": "aria-required", + "name": "aria-valuenow", + "required": false + }, + { + "is": "property", + "name": "aria-valuetext", "required": false } ] @@ -4689,6 +4793,22 @@ var roleInfo = { } ] }, + "subscript": { + "name": "subscript", + "fragID": "subscript", + "parentRoles": [ + "section" + ], + "localprops": [] + }, + "superscript": { + "name": "superscript", + "fragID": "superscript", + "parentRoles": [ + "section" + ], + "localprops": [] + }, "switch": { "name": "switch", "fragID": "switch", @@ -5085,6 +5205,14 @@ var roleInfo = { } ] }, + "time": { + "name": "time", + "fragID": "time", + "parentRoles": [ + "section" + ], + "localprops": [] + }, "timer": { "name": "timer", "fragID": "timer", @@ -5645,5 +5773,4 @@ var roleInfo = { } ] } -} - +} \ No newline at end of file From 6aed776017785a9784501e93e0095f0afd1ecad1 Mon Sep 17 00:00:00 2001 From: Matt King Date: Thu, 2 May 2019 10:50:43 -0700 Subject: [PATCH 03/33] aria-expanded: revise definition and change applicability for issue 681 (#972) * aria-expanded: revise definition and change applicability Resolves issue #681 by: * Revising aria-expanded definition to state it aria-expanded belongs on interactive, focusable, controlling element. * Rewording normative authors SHOULD to clarify when aria-controls should be used. * Trimming unnecessary content from aria-expanded description related to grouping mechanisms and the benefits of collapsing content. * Removing support from document, section, sectionhead, and window. * Restoring support to following subclass roles that were effected by removals: gridcell, listbox (for issue #722), row, rowheader, tab, and treeitem. * Adding support for checkbox. * Adding aria-expanded as supported for role application Thus, support is removed from the roles listed below that do not act as interactive, focusable, controlling mechanisms for expansion: alert alertdialog article banner blockquote caption cell complementary contentinfo definition deletion dialog directory feed figure form grid group heading img insertion label landmark legend list listitem log main marquee math menu menubar navigation note paragraph radiogroup region search select status subscript superscript table tabpanel term time timer toolbar tooltip tree treegrid --- index.html | 50 ++++++++++++++++++++++++++++++-------------------- 1 file changed, 30 insertions(+), 20 deletions(-) diff --git a/index.html b/index.html index 1725f4664..fba5f7f4f 100644 --- a/index.html +++ b/index.html @@ -969,7 +969,12 @@

Definition of Roles

Supported States and Properties: - aria-activedescendant + +
    +
  • aria-activedescendant
    • +
  • aria-expanded
    • +
+ Inherited States and Properties: @@ -1564,6 +1569,7 @@

Definition of Roles

Supported States and Properties:
    +
  • aria-expanded
  • aria-readonly
@@ -2500,7 +2506,7 @@

Definition of Roles

Supported States and Properties: - aria-expanded + Inherited States and Properties: @@ -2950,6 +2956,7 @@

Definition of Roles

Supported States and Properties:
    +
  • aria-expanded
  • aria-readonly
  • aria-required
  • aria-selected
    • @@ -3934,6 +3941,7 @@

    Definition of Roles

    Supported States and Properties:
      +
    • aria-expanded
    • aria-multiselectable
    • aria-readonly
    • aria-required
      • @@ -6207,6 +6215,7 @@
      Presentational Roles Conflict Resolution
      • aria-colindex
        • +
      • aria-expanded
      • aria-level
      • aria-posinset
      • aria-rowindex
        • @@ -6347,7 +6356,7 @@
        Presentational Roles Conflict Resolution

        The rowheader role can be used to identify a cell as a header for a row in a table, grid, or treegrid. The rowheader establishes a relationship between it and all cells in the corresponding row. It is a structural equivalent to setting scope="row" on an HTML th element.

        Authors MUST ensure elements with role rowheader are contained in, or owned by, an element with the role row.

        Applying the aria-selected state on a rowheader MUST NOT cause the user agent to automatically propagate the aria-selected state to all the cells in the corresponding row. An author MAY choose to propagate selection in this manner depending on the specific application.

        -

        While the rowheader role can be used in both interactive grids and non-interactive tables, the use of aria-readonly and aria-required is only applicable to interactive elements. Therefore, authors SHOULD NOT use aria-required or aria-readonly in a rowheader that descends from a table, and user agents SHOULD NOT expose either property to assistive technologies unless the rowheader descends from a grid or treegrid.

        +

        While the rowheader role can be used in both interactive grids and non-interactive tables, the use of aria-expanded, aria-readonly, and aria-required is only applicable to interactive elements. Therefore, authors SHOULD NOT use aria-expanded, aria-readonly, oraria-required in a rowheader that descends from a table, and user agents SHOULD NOT expose these properties to assistive technologies unless the rowheader descends from a grid or treegrid.

        @@ -6398,7 +6407,12 @@
        Presentational Roles Conflict Resolution
        - + @@ -6741,7 +6755,7 @@
        Presentational Roles Conflict Resolution
        - + @@ -6811,7 +6825,7 @@
        Presentational Roles Conflict Resolution
        - + @@ -7728,6 +7742,7 @@
        Presentational Roles Conflict Resolution
        - + @@ -9090,12 +9105,7 @@
        Presentational Roles Conflict Resolution
        - + @@ -10189,9 +10199,9 @@

        Definitions of States and Properties (all aria-* attributes)

        aria-expanded
        -

        Indicates whether the element, or another grouping element it controls, is currently expanded or collapsed.

        -

        For example, this indicates whether a portion of a tree is expanded or collapsed. In other instances, this may be applied to page sections to mark expandable and collapsible regions that are flexible for managing content density. Simplifying the user interface by collapsing sections may improve usability for all, including those with cognitive or developmental disabilities.

        -

        If the element with the aria-expanded attribute controls the expansion of another grouping container that is not 'owned by' the element, the author SHOULD reference the container by using the aria-controls attribute.

        +

        Indicates whether a grouping element owned or controlled by this element is expanded or collapsed.

        +

        The aria-expanded attribute is applied to a focusable, interactive element that toggles visibility of content in another element. For example, it is applied to a parent treeitem to indicate whether its child branch of the tree is shown. Similarly, it can be applied to a button that controls visibility of a section of page content.

        +

        If a grouping container that can be expanded or collapsed is not owned by the element that has the aria-expanded attribute, the author SHOULD identify the controlling relationship by referencing the container from the element that has aria-expanded with the aria-controls property.

        Characteristics:
        Supported States and Properties:aria-sort +
          +
        • aria-expanded
          • +
        • aria-sort
          • +
        +
        Inherited States and Properties:
        Supported States and Properties:aria-expanded
        Inherited States and Properties:
        Supported States and Properties:aria-expanded
        Inherited States and Properties: Supported States and Properties:
          +
        • aria-expanded
        • aria-posinset
        • aria-selected
        • aria-setsize
          • @@ -8938,7 +8953,7 @@
          Presentational Roles Conflict Resolution
        Supported States and Properties: aria-expanded
        Inherited States and Properties:
        Supported States and Properties: -
          -
        • aria-expanded
          • -
        • aria-modal
          • -
        -         		aria-modal
        Inherited States and Properties:
        @@ -10204,7 +10214,7 @@

        Definitions of States and Properties (all aria-* attributes)

        - + @@ -10231,15 +10241,15 @@

        Definitions of States and Properties (all aria-* attributes)

        - + - + - +
        Characteristics:
        Related Concepts:Tapered prompts in voice browsing. Switch in SMIL [[SMIL3]].
        Used in Roles:
        falseThe element, or another grouping element it controls, is collapsed.The grouping element this element owns or controls is collapsed.
        trueThe element, or another grouping element it controls, is expanded.The grouping element this element owns or controls is expanded.
        undefined (default)The element, or another grouping element it controls, is neither expandable nor collapsible; all its child elements are shown or there are no child elements.The element does not own or control a grouping element that is expandable.
        From 47a5882fec8f6e9bcbb704dfe6a7dde7a122746f Mon Sep 17 00:00:00 2001 From: Joanmarie Diggs Date: Thu, 2 May 2019 10:57:25 -0700 Subject: [PATCH 04/33] Add changelog entries --- index.html | 2 ++ 1 file changed, 2 insertions(+) diff --git a/index.html b/index.html index fba5f7f4f..cff9dcc72 100644 --- a/index.html +++ b/index.html @@ -12609,6 +12609,8 @@

        Change Log

        Substantive changes since the last public working draft

          +
        • 02-May-2019: Add aria-expanded support to application and checkbox roles.
          • +
        • 02-May-2019: Remove aria-expanded support from the following roles: alert, alertdialog, article, banner, blockquote, caption, cell, complementary, contentinfo, definition, deletion, dialog, directory, feed, figure, form, grid, group, heading, img, insertion, label, landmark, legend, list, listitem, log, main, marquee, math, menu, menubar, navigation, note, paragraph, radiogroup, region, search, select, status, subscript, superscript, table, tabpanel, term, time, timer, toolbar, tooltip, tree, treegrid.
        • 11-Apr-2019: Add legend role
        • 11-Apr-2019: Remove children-presentational=true from math role
        • 10-Apr-2019: Add label role
          • From ebe4082fcb71d5dce51f3a5155608a98f93c96be Mon Sep 17 00:00:00 2001 From: Harris Schneiderman Date: Thu, 2 May 2019 11:43:08 -0700 Subject: [PATCH 05/33] Add the code role (#969) --- index.html | 93 ++++++++++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 93 insertions(+) diff --git a/index.html b/index.html index cff9dcc72..528006a07 100644 --- a/index.html +++ b/index.html @@ -1611,6 +1611,99 @@

          Definition of Roles

          + +
          + code +
          +

          A section whose content represents a fragment of computer code.

          +

          + The primary purpose of the code role is to inform assistive technologies that the content is computer code and + thus may require special presentation, in particular with respect to synthesized speech. More specifically, screen + readers and other tools which provide text-to-speech presentation of content SHOULD prefer full punctuation verbosity to ensure common symbols (e.g. "-") are spoken. +

          +
          + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
          Characteristics:
          CharacteristicValue
          Is Abstract: 
          Superclass Role: + section +
          Subclass Roles:Placeholder
          Base Concept: 
          Related Concepts: + HTML code +
          Required Context Role: 
          Required Owned Elements:
          Required States and Properties:
          Supported States and Properties:
          Inherited States and Properties:Placeholder
          Name From:author
          Accessible Name Required:
          Inherits Name Required: 
          Children Presentational: 
          Inherits Presentational: 
          Implicit Value for Role:
          +
          +
          columnheader
          From 3a2a5dae917e66162fa290e6be471f87076fe099 Mon Sep 17 00:00:00 2001 From: Joanmarie Diggs Date: Thu, 2 May 2019 11:44:26 -0700 Subject: [PATCH 06/33] Add ChangeLog --- index.html | 1 + 1 file changed, 1 insertion(+) diff --git a/index.html b/index.html index 528006a07..ebfb9a7cb 100644 --- a/index.html +++ b/index.html @@ -12702,6 +12702,7 @@

          Change Log

          Substantive changes since the last public working draft

            +
          • 02-May-2019: Add code role
          • 02-May-2019: Add aria-expanded support to application and checkbox roles.
          • 02-May-2019: Remove aria-expanded support from the following roles: alert, alertdialog, article, banner, blockquote, caption, cell, complementary, contentinfo, definition, deletion, dialog, directory, feed, figure, form, grid, group, heading, img, insertion, label, landmark, legend, list, listitem, log, main, marquee, math, menu, menubar, navigation, note, paragraph, radiogroup, region, search, select, status, subscript, superscript, table, tabpanel, term, time, timer, toolbar, tooltip, tree, treegrid.
          • 11-Apr-2019: Add legend role
            • From 2714fd041862f873fb3ce8a6a82305d74c847f64 Mon Sep 17 00:00:00 2001 From: Joanmarie Diggs Date: Thu, 2 May 2019 13:19:20 -0700 Subject: [PATCH 07/33] Markup: Fix whitespace consistency --- index.html | 888 +++++++++++++++++++++++++---------------------------- 1 file changed, 420 insertions(+), 468 deletions(-) diff --git a/index.html b/index.html index ebfb9a7cb..be2972aeb 100644 --- a/index.html +++ b/index.html @@ -13,7 +13,7 @@ var respecConfig = { // embed RDFa data in the output trace: true, - useExperimentalStyles: true, + useExperimentalStyles: true, doRDFa: '1.1', includePermalinks: true, permalinkEdge: true, @@ -63,10 +63,10 @@ w3cid: 89030 }, { - name: "James Nurthen", - company: "Adobe", - companyURL: "https://www.adobe.com/", - w3cid: 37155 + name: "James Nurthen", + company: "Adobe", + companyURL: "https://www.adobe.com/", + w3cid: 37155 }, { name: "Michael Cooper", @@ -664,7 +664,7 @@

            Document Structure

          • cell
          • columnheader
          • definition
            • -
          • deletion
            • +
          • deletion
          • directory
          • document
          • feed
            • @@ -672,9 +672,9 @@

            Document Structure

          • group
          • heading
          • img
            • -
          • insertion
            • -
          • label
            • -
          • legend
            • +
          • insertion
            • +
          • label
            • +
          • legend
          • list
          • listitem
          • math
            • @@ -1611,16 +1611,11 @@

            Definition of Roles

          -
          code

          A section whose content represents a fragment of computer code.

          -

          - The primary purpose of the code role is to inform assistive technologies that the content is computer code and - thus may require special presentation, in particular with respect to synthesized speech. More specifically, screen - readers and other tools which provide text-to-speech presentation of content SHOULD prefer full punctuation verbosity to ensure common symbols (e.g. "-") are spoken. -

          +

          The primary purpose of the code role is to inform assistive technologies that the content is computer code and thus may require special presentation, in particular with respect to synthesized speech. More specifically, screen readers and other tools which provide text-to-speech presentation of content SHOULD prefer full punctuation verbosity to ensure common symbols (e.g. "-") are spoken.

          @@ -1652,8 +1647,7 @@

          Definition of Roles

          @@ -1703,7 +1697,6 @@

          Definition of Roles

          Characteristics:
          Related Concepts: - HTML code + HTML code
          -
          columnheader
          @@ -2316,80 +2309,80 @@

          Definition of Roles

          -
          - deletion -
          -

          A deletion contains content that is marked as removed or content that is being suggested for removal. See related insertion.

          -

          Deletions are typically used to either mark differences between two versions of content or to designate content suggested for removal in scenarios where multiple people are revising content.

          -
          - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
          Characteristics:
          CharacteristicValue
          Is Abstract: 
          Superclass Role:section
          Base Concept: 
          Related Concepts:HTML del
          Required Context Role: 
          Required Owned Elements: 
          Required States and Properties: 
          Supported States and Properties:
          Inherited States and Properties:Placeholder
          Name From:author
          Accessible Name Required:False
          Inherits Name Required: 
          Children Presentational: 
          Inherits Presentational: 
          -
          +
          + deletion +
          +

          A deletion contains content that is marked as removed or content that is being suggested for removal. See related insertion.

          +

          Deletions are typically used to either mark differences between two versions of content or to designate content suggested for removal in scenarios where multiple people are revising content.

          +
          + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
          Characteristics:
          CharacteristicValue
          Is Abstract: 
          Superclass Role:section
          Base Concept: 
          Related Concepts:HTML del
          Required Context Role: 
          Required Owned Elements: 
          Required States and Properties: 
          Supported States and Properties:
          Inherited States and Properties:Placeholder
          Name From:author
          Accessible Name Required:False
          Inherits Name Required: 
          Children Presentational: 
          Inherits Presentational: 
          +
          dialog
          @@ -3411,191 +3404,183 @@

          Definition of Roles

          -
          - insertion -
          -

          An insertion contains content that is marked as added or content that is being suggested for addition. See related deletion.

          -

          Insertions are typically used to either mark differences between two versions of content or to designate content suggested for addition in scenarios where multiple people are revising content.

          -
          - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
          Characteristics:
          CharacteristicValue
          Is Abstract: 
          Superclass Role:section
          Base Concept: 
          Related Concepts:HTML ins
          Required Context Role: 
          Required Owned Elements: 
          Required States and Properties: 
          Supported States and Properties:
          Inherited States and Properties:Placeholder
          Name From:author
          Accessible Name Required:False
          Inherits Name Required: 
          Children Presentational: 
          Inherits Presentational: 
          -
          -
          - label -
          -

          A visible name or caption for a user interface component.

          -

          An element with role label can provide an accessible name for a user interface component if it is programatically associated with the element. Authors MAY associate an element with role label with another element by using one of two methods:

          - -
            -
          • encapsulation: The element with role label contains the element it names. -
          • reference: The element with role label is referenced by the element it names via the aria-labelledby attribute.
            • -
          - -

          The encapsulation method of naming is supported only if the element being named has one of the following roles:

          -
            -
          • checkbox
            • -
          • listbox
            • -
          • meter
            • -
          • radio
            • -
          • searchbox
            • -
          • spinbutton
            • -
          • switch
            • -
          • textbox
            • -
          - -

          Authors SHOULD ensure that:

          - -
            -
          • All elements with role label are associated with one or more other elements.
            • -
          • When an element with role label is activated by touch or a pointer and its associated element is focusable, focus moves to the associated element. If more than one focusable element is associated with the same label, focus moves to the first element.
            • -
          -
          - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
          Characteristics:
          CharacteristicValue
          Is Abstract:
          Superclass Role: -
            -
          • section
            • -
          -
          Subclass Roles:
          Base Concept:HTML label
          Related Concepts:
          Required Context Role:
          Required Owned Elements:
          Required States and Properties:
          Supported States and Properties:
          Inherited States and Properties:Placeholder
          Name From: -
            -
          • contents
            • -
          • author
            • -
          -
          Accessible Name Required:True
          Inherits Name Required:
          Children Presentational:
          Inherits Presentational:
          -
          +
          + insertion +
          +

          An insertion contains content that is marked as added or content that is being suggested for addition. See related deletion.

          +

          Insertions are typically used to either mark differences between two versions of content or to designate content suggested for addition in scenarios where multiple people are revising content.

          +
          + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
          Characteristics:
          CharacteristicValue
          Is Abstract: 
          Superclass Role:section
          Base Concept: 
          Related Concepts:HTML ins
          Required Context Role: 
          Required Owned Elements: 
          Required States and Properties: 
          Supported States and Properties:
          Inherited States and Properties:Placeholder
          Name From:author
          Accessible Name Required:False
          Inherits Name Required: 
          Children Presentational: 
          Inherits Presentational: 
          +
          +
          + label +
          +

          A visible name or caption for a user interface component.

          +

          An element with role label can provide an accessible name for a user interface component if it is programatically associated with the element. Authors MAY associate an element with role label with another element by using one of two methods:

          +
            +
          • encapsulation: The element with role label contains the element it names. +
          • reference: The element with role label is referenced by the element it names via the aria-labelledby attribute.
            • +
          +

          The encapsulation method of naming is supported only if the element being named has one of the following roles:

          +
            +
          • checkbox
            • +
          • listbox
            • +
          • meter
            • +
          • radio
            • +
          • searchbox
            • +
          • spinbutton
            • +
          • switch
            • +
          • textbox
            • +
          +

          Authors SHOULD ensure that:

          +
            +
          • All elements with role label are associated with one or more other elements.
            • +
          • When an element with role label is activated by touch or a pointer and its associated element is focusable, focus moves to the associated element. If more than one focusable element is associated with the same label, focus moves to the first element.
            • +
          +
          + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
          Characteristics:
          CharacteristicValue
          Is Abstract:
          Superclass Role:section
          Subclass Roles:
          Base Concept:HTML label
          Related Concepts:
          Required Context Role:
          Required Owned Elements:
          Required States and Properties:
          Supported States and Properties:
          Inherited States and Properties:Placeholder
          Name From: +
            +
          • contents
            • +
          • author
            • +
          +
          Accessible Name Required:True
          Inherits Name Required:
          Children Presentational:
          Inherits Presentational:
          +
          landmark
          @@ -3677,114 +3662,103 @@

          Definition of Roles

          -
          - legend -
          -

          A visible name or caption for a group of related user interface components.

          - -

          A element with role legend element can provide an accessible name for elements with grouping roles if it is progammatically associated with the element. Authors MAY associate an element with role legend with an element by using one of two methods:

          - -
            -
          • legend: The element contains an element with role legend element. If the element contains more than one element with role legend, only the first descendant element with role legend is used for computing the accessible name.
            • -
          • reference: The element eith role legend is referenced by the element it names via the aria-labelledby attribute.
            • -
          - -

          The legend method of naming is supported only if the element being named has one of the following grouping roles:

          - -
            -
          • group
            • -
          • radiogroup
            • -
          - -

          Authors SHOULD ensure that:

          - -
            -
          • All elements with role legend are associated with one or more elements with grouping roles.
            • -
          • When an element with role legend is activated by touch or a pointer, focus moves to the first focusable element in the associated group of user interface components. - -

            -
          - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
          Characteristics:
          CharacteristicValue
          Is Abstract: 
          Superclass Role: -
            -
          • section
            • -
          -
          Subclass Roles:
          Base Concept:HTML legend
          Related Concepts: 
          Required Context Role:
          Required Owned Elements: 
          Required States and Properties: 
          Supported States and Properties:
          Inherited States and Properties:Placeholder
          Name From: -
            -
          • contents
            • -
          • author
            • -
          -
          Accessible Name Required:True
          Inherits Name Required: 
          Children Presentational: 
          Inherits Presentational: 
          -
          +
          + legend +
          +

          A visible name or caption for a group of related user interface components.

          +

          A element with role legend element can provide an accessible name for elements with grouping roles if it is progammatically associated with the element. Authors MAY associate an element with role legend with an element by using one of two methods:

          +
            +
          • legend: The element contains an element with role legend element. If the element contains more than one element with role legend, only the first descendant element with role legend is used for computing the accessible name.
            • +
          • reference: The element eith role legend is referenced by the element it names via the aria-labelledby attribute.
            • +
          +

          The legend method of naming is supported only if the element being named has one of the following grouping roles:

          +
            +
          • group
            • +
          • radiogroup
            • +
          +

          Authors SHOULD ensure that:

          +
            +
          • All elements with role legend are associated with one or more elements with grouping roles.
            • +
          • When an element with role legend is activated by touch or a pointer, focus moves to the first focusable element in the associated group of user interface components.
            • +
          +
          + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
          Characteristics:
          CharacteristicValue
          Is Abstract: 
          Superclass Role:section
          Subclass Roles:
          Base Concept:HTML legend
          Related Concepts: 
          Required Context Role:
          Required Owned Elements: 
          Required States and Properties: 
          Supported States and Properties:
          Inherited States and Properties:Placeholder
          Name From: +
            +
          • contents
            • +
          • author
            • +
          +
          Accessible Name Required:True
          Inherits Name Required: 
          Children Presentational: 
          Inherits Presentational: 
          +
        - aria-valuetext + Inherited States and Properties: @@ -6237,10 +6212,8 @@
        Presentational Roles Conflict Resolution

        A row of cells in a tabular container.

        Rows contain cell or gridcell elements, and thus serve to organize a table, grid, or treegrid.

        -

        - While the row role can be used in tables, grids, and treegrids, the semantics of aria-expanded, aria-posinset, aria-setsize, and aria-level are only applicable to the hierarchical structure of an interactive tree grid. - Therefore, authors MUST NOT apply aria-expanded, aria-posinset, aria-setsize, and aria-level to a row that descends from a table or grid, and user agents SHOULD NOT expose any of these four properties to assistive technologies unless the row descends from a treegrid. -

        +

        While the row role can be used in tables, grids, and treegrids, the semantics of aria-expanded, aria-posinset, aria-setsize, and aria-level are only applicable to the hierarchical structure of an interactive tree grid. Therefore, authors MUST NOT apply aria-expanded, aria-posinset, aria-setsize, and aria-level to a row that descends from a table or grid, and user agents SHOULD NOT expose any of these four properties to assistive technologies unless the row descends from a treegrid. +

        Authors MUST ensure elements with role row are contained in, or owned by, an element with the role table, grid, rowgroup, or treegrid.

        @@ -6308,11 +6281,11 @@
        Presentational Roles Conflict Resolution
        @@ -6501,11 +6474,11 @@
        Presentational Roles Conflict Resolution
        +
          +
        • aria-expanded
          • +
        • aria-sort
          • +
        + @@ -6778,11 +6751,11 @@
        Presentational Roles Conflict Resolution
        +
          +
        • encapsulation
          • +
        • author
          • +
        + @@ -7136,7 +7109,6 @@
        Presentational Roles Conflict Resolution
        Default for aria-valuenow is 50.
        - @@ -7331,11 +7303,11 @@
        Presentational Roles Conflict Resolution
        +
          +
        • encapsulation
          • +
        • author
          • +
        + @@ -7746,11 +7718,11 @@
        Presentational Roles Conflict Resolution
        @@ -7835,7 +7807,7 @@
        Presentational Roles Conflict Resolution
        - + @@ -8416,11 +8388,11 @@
        Presentational Roles Conflict Resolution
        +
          +
        • encapsulation
          • +
        • author
          • +
        + @@ -8441,7 +8413,7 @@
        Presentational Roles Conflict Resolution
        • aria-colindex
          • -
        • aria-expanded
          • +
        • aria-expanded
        • aria-level
          • -
        • aria-posinset
          • +
        • aria-posinset
        • aria-rowindex
          • -
        • aria-setsize
          • +
        • aria-setsize
        • aria-selected
        Supported States and Properties: -
          -
        • aria-expanded
          • -
        • aria-sort
          • -
        -
        Inherited States and Properties:
        Name From: -
          -
        • encapsulation
          • -
        • author
          • -
        -
        Accessible Name Required:
        Implicit Value for Role: Default for aria-orientation is horizontal.
        Name From: -
          -
        • encapsulation
          • -
        • author
          • -
        -
        Accessible Name Required:
        Name From: -
          -
        • contents
          • -
        • encapsulation
          • -
        • author
          • -
        +
          +
        • contents
          • +
        • encapsulation
          • +
        • author
          • +
        Supported States and Properties:
          -
        • aria-expanded
          • +
        • aria-expanded
        • aria-posinset
        • aria-selected
        • aria-setsize
          • @@ -8042,7 +8014,7 @@
          Presentational Roles Conflict Resolution
        Name From:authorauthor
        Accessible Name Required:
        Name From: -
          -
        • encapsulation
          • -
        • author
          • -
        -
        Accessible Name Required:
        -
        +
        time

        An element that represents a specific point in time.

        @@ -8449,36 +8421,16 @@
        Presentational Roles Conflict Resolution

        Authors SHOULD limit text contents to a valid date- or time-related string, or apply this future datetime-equivalent property to the element which has role time.

        Examples of valid date- or time-related strings as text contents of an element with the time role:

          -
        • - A valid month string: 2019-11 -
          • -
        • - A valid date string: 2019-11-18 -
          • -
        • - A valid yearless date string: 11-18 -
          • -
        • - A valid time string: 09:54:39 -
          • -
        • - A valid floating date and time string: 2019-11-18T14:54 -
          • -
        • - A valid time-zone offset string: -08:00 -
          • -
        • - A valid global date and time string: 2019-11-18T14:54Z -
          • -
        • - A valid week string: 2019-W47 -
          • -
        • - Four or more ASCII digits, at least one of which is not U+0030 DIGIT ZERO (0): 0001 -
          • -
        • - A valid duration string: 4h 18m 3s -
          • +
        • A valid month string: 2019-11
          • +
        • A valid date string: 2019-11-18
          • +
        • A valid yearless date string: 11-18
          • +
        • A valid time string: 09:54:39
          • +
        • A valid floating date and time string: 2019-11-18T14:54
          • +
        • A valid time-zone offset string: -08:00
          • +
        • A valid global date and time string: 2019-11-18T14:54Z
          • +
        • A valid week string: 2019-W47
          • +
        • Four or more ASCII digits, at least one of which is not U+0030 DIGIT ZERO (0): 0001
          • +
        • A valid duration string: 4h 18m 3s
        From 64896f55be497469c3b844fa7708463113b20063 Mon Sep 17 00:00:00 2001 From: Joanmarie Diggs Date: Thu, 2 May 2019 13:39:24 -0700 Subject: [PATCH 08/33] Markup: Fix a couple of whitespace issues --- index.html | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/index.html b/index.html index be2972aeb..219e80ab9 100644 --- a/index.html +++ b/index.html @@ -1569,7 +1569,7 @@

        Definition of Roles

         @@ -1583,7 +1583,7 @@

        Definition of Roles

        From 7649e9bc70c67e76b0bff3876b134ac1a3a74c3e Mon Sep 17 00:00:00 2001 From: Joanmarie Diggs Date: Thu, 2 May 2019 13:41:20 -0700 Subject: [PATCH 09/33] Markup: Yet more whitespace issues --- index.html | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/index.html b/index.html index 219e80ab9..689028d56 100644 --- a/index.html +++ b/index.html @@ -4008,7 +4008,7 @@

        Definition of Roles

        Supported States and Properties:
          -
        • aria-expanded
          • +
        • aria-expanded
        • aria-readonly
        • contents
          • -
        • encapsulation
          • +
        • encapsulation
        • author
        		Supported States and Properties:
          -
        • aria-expanded
          • +
        • aria-expanded
        • aria-multiselectable
        • aria-readonly
        • aria-required
          • @@ -6422,7 +6422,7 @@
          Presentational Roles Conflict Resolution

          The rowheader role can be used to identify a cell as a header for a row in a table, grid, or treegrid. The rowheader establishes a relationship between it and all cells in the corresponding row. It is a structural equivalent to setting scope="row" on an HTML th element.

          Authors MUST ensure elements with role rowheader are contained in, or owned by, an element with the role row.

          Applying the aria-selected state on a rowheader MUST NOT cause the user agent to automatically propagate the aria-selected state to all the cells in the corresponding row. An author MAY choose to propagate selection in this manner depending on the specific application.

          -

          While the rowheader role can be used in both interactive grids and non-interactive tables, the use of aria-expanded, aria-readonly, and aria-required is only applicable to interactive elements. Therefore, authors SHOULD NOT use aria-expanded, aria-readonly, oraria-required in a rowheader that descends from a table, and user agents SHOULD NOT expose these properties to assistive technologies unless the rowheader descends from a grid or treegrid.

          +

          While the rowheader role can be used in both interactive grids and non-interactive tables, the use of aria-expanded, aria-readonly, and aria-required is only applicable to interactive elements. Therefore, authors SHOULD NOT use aria-expanded, aria-readonly, or aria-required in a rowheader that descends from a table, and user agents SHOULD NOT expose these properties to assistive technologies unless the rowheader descends from a grid or treegrid.

          From 45e5f4b5e586869c656dee6b8e55d2447a033e99 Mon Sep 17 00:00:00 2001 From: Joanmarie Diggs Date: Thu, 2 May 2019 13:44:41 -0700 Subject: [PATCH 10/33] Add aria-required as a supported property of checkbox Fixes issue #921 --- index.html | 2 ++ 1 file changed, 2 insertions(+) diff --git a/index.html b/index.html index 689028d56..2f911fb2a 100644 --- a/index.html +++ b/index.html @@ -1571,6 +1571,7 @@

          Definition of Roles

          • aria-expanded
          • aria-readonly
            • +
          • aria-required
          @@ -12654,6 +12655,7 @@

          Change Log

          Substantive changes since the last public working draft

            +
          • 02-May-2019: Add aria-required as a supported property of checkbox
          • 02-May-2019: Add code role
          • 02-May-2019: Add aria-expanded support to application and checkbox roles.
          • 02-May-2019: Remove aria-expanded support from the following roles: alert, alertdialog, article, banner, blockquote, caption, cell, complementary, contentinfo, definition, deletion, dialog, directory, feed, figure, form, grid, group, heading, img, insertion, label, landmark, legend, list, listitem, log, main, marquee, math, menu, menubar, navigation, note, paragraph, radiogroup, region, search, select, status, subscript, superscript, table, tabpanel, term, time, timer, toolbar, tooltip, tree, treegrid.
            • From 0f47d77c2474ebd5f02b867006021f5f803e0b5f Mon Sep 17 00:00:00 2001 From: joanmarie Date: Thu, 2 May 2019 13:56:15 -0700 Subject: [PATCH 11/33] Add strong and emphasis roles (#953) --- index.html | 160 +++++++++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 160 insertions(+) diff --git a/index.html b/index.html index 2f911fb2a..caed701ae 100644 --- a/index.html +++ b/index.html @@ -667,6 +667,7 @@

            Document Structure

          • deletion
          • directory
          • document
            • +
          • emphasis
          • feed
          • figure
          • group
            • @@ -686,6 +687,7 @@

            Document Structure

          • rowgroup
          • rowheader
          • separator (when not focusable)
            • +
          • strong
          • subscript
          • superscript
          • table
            • @@ -2622,6 +2624,85 @@

            Definition of Roles

          Characteristics:
          +
          + emphasis +
          +

          One or more emphasized characters. See related strong.

          +

          The purpose of the emphasis role is to stress or emphasize content. It is not for communicating changes in typographical presentation that do not impact the meaning of the content. Authors SHOULD use the emphasis role only if its absence would change the meaning of the content.

          +

          The emphasis role is not intended to convey importance; for that purpose, the strong role is more appropriate.

          +
          + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
          Characteristics:
          CharacteristicValue
          Is Abstract: 
          Superclass Role:section
          Subclass Roles:Placeholder
          Base Concept: 
          Related Concepts:HTML em
          Required Context Role: 
          Required Owned Elements: 
          Required States and Properties: 
          Supported States and Properties: 
          Inherited States and Properties:Placeholder
          Name From:author
          Accessible Name Required: 
          Inherits Name Required: 
          Children Presentational: 
          Inherits Presentational: 
          +
          feed
          @@ -7425,6 +7506,85 @@
          Presentational Roles Conflict Resolution
        +
        + strong +
        +

        Content which is important, serious, or urgent. See related emphasis.

        +

        The purpose of the strong role is to communicate strong importance, seriousness, or urgency. It is not for communicating changes in typographical presentation that are not important to the meaning of the content. Authors SHOULD use the strong role only if its absence would change the meaning of the content.

        +

        The strong role is not intended to convey stress or emphasis; for that purpose, the emphasis role is more appropriate.

        +
        + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
        Characteristics:
        CharacteristicValue
        Is Abstract: 
        Superclass Role:section
        Subclass Roles:Placeholder
        Base Concept: 
        Related Concepts:HTML strong
        Required Context Role: 
        Required Owned Elements: 
        Required States and Properties: 
        Supported States and Properties: 
        Inherited States and Properties:Placeholder
        Name From:author
        Accessible Name Required: 
        Inherits Name Required: 
        Children Presentational: 
        Inherits Presentational: 
        +
        structure
        From 3648d6a210ad498d8172adc5511dca00808eb7c3 Mon Sep 17 00:00:00 2001 From: Joanmarie Diggs Date: Thu, 2 May 2019 13:58:18 -0700 Subject: [PATCH 12/33] Add ChangeLog entry --- index.html | 1 + 1 file changed, 1 insertion(+) diff --git a/index.html b/index.html index caed701ae..f9a91fe62 100644 --- a/index.html +++ b/index.html @@ -12815,6 +12815,7 @@

        Change Log

        Substantive changes since the last public working draft

          +
        • 02-May-2019: Add strong and emphasis roles
        • 02-May-2019: Add aria-required as a supported property of checkbox
        • 02-May-2019: Add code role
        • 02-May-2019: Add aria-expanded support to application and checkbox roles.
          • From d28e434eb610a297b35bf167a6634ba8ab34a5c6 Mon Sep 17 00:00:00 2001 From: Carolyn MacLeod Date: Thu, 2 May 2019 18:35:33 -0400 Subject: [PATCH 13/33] Remove references to SMIL #973 (#974) --- index.html | 6 +----- 1 file changed, 1 insertion(+), 5 deletions(-) diff --git a/index.html b/index.html index f9a91fe62..78ef50934 100644 --- a/index.html +++ b/index.html @@ -6891,11 +6891,7 @@
          Presentational Roles Conflict Resolution
          Related Concepts: - - - + Required States and Properties: From ba4689ef3524ced50c86c945e6ac8c0118c39692 Mon Sep 17 00:00:00 2001 From: Melanie Richards Date: Mon, 13 May 2019 11:21:13 -0700 Subject: [PATCH 14/33] Remove implicit value of aria-level from heading role (#942) * Remove implicit value from heading role * Adjust heading role verbiage to reflect aria-level authoring expectations --- index.html | 6 +----- 1 file changed, 1 insertion(+), 5 deletions(-) diff --git a/index.html b/index.html index 78ef50934..c994b35ce 100644 --- a/index.html +++ b/index.html @@ -3252,7 +3252,7 @@

          Definition of Roles

          heading

          A heading for a section of the page.

          -

          Often, heading elements will be referenced with the aria-labelledby attribute of the section for which they serve as a heading. If headings are organized into a logical outline, the aria-level attribute is used to indicate the nesting level.

          +

          Often, heading elements will be referenced with the aria-labelledby attribute of the section for which they serve as a heading. To ensure headings are organized into a logical outline, authors MUST use the aria-level attribute to indicate the proper nesting level.

          @@ -3328,10 +3328,6 @@

          Definition of Roles

          - - - -
          Characteristics:
          Inherits Presentational:  
          Implicit Value for Role:Default for aria-level is 2.
        From 62bed5c33b49302f2d15f1c9c48d840ff6f411dc Mon Sep 17 00:00:00 2001 From: Melanie Richards Date: Mon, 13 May 2019 11:21:36 -0700 Subject: [PATCH 15/33] Remove default value for aria-expanded from combobox role (#943) * Remove default value for aria-expanded from combobox role * Update combobox role prose to better reflect removal of default aria-expanded value --- index.html | 3 +-- 1 file changed, 1 insertion(+), 2 deletions(-) diff --git a/index.html b/index.html index c994b35ce..1e903ed6f 100644 --- a/index.html +++ b/index.html @@ -1799,7 +1799,7 @@

        Definition of Roles

        A composite widget containing a single-line textbox and another element, such as a listbox or grid, that can dynamically pop up to help the user set the value of the textbox.

        Authors MUST ensure an element with role combobox contains or owns a text input element with role textbox or searchbox and that the text input has aria-multiline set to false. If the combobox provides autocompletion behavior for the text input as described in aria-autocomplete, authors MUST set aria-autocomplete on the textbox element to the value that corresponds to the provided behavior.

        -

        Typically, the default state of a combobox is collapsed. In the collapsed state, only the textbox element of a combobox is visible. A combobox is said to be expanded when both the textbox and a secondary element that serves as its popup are visible. Authors MUST set aria-expanded to true on an element with role combobox when it is expanded and false when it is collapsed. Elements with the role combobox have an implicit aria-expanded value of false.

        +

        Typically, the initial state of a combobox is collapsed. In the collapsed state, only the textbox element of a combobox is visible. A combobox is said to be expanded when both the textbox and a secondary element that serves as its popup are visible. Authors MUST set aria-expanded to true on an element with role combobox when it is expanded and false when it is collapsed.

        When a combobox is expanded, authors MUST ensure it contains or owns an element that has a role of listbox, tree, grid, or dialog. This element is the combobox popup. When the combobox is expanded, authors MUST set aria-controls on the textbox element to a value that refers to the combobox popup element.

        Elements with the role combobox have an implicit aria-haspopup value of listbox. If the combobox popup element has a role other than listbox, authors MUST specify a value for aria-haspopup that corresponds to the type of its popup.

        To be keyboard accessible, authors SHOULD manage focus of descendants for all instances of this role, as described in Managing Focus. When a combobox receives focus, authors SHOULD ensure focus is placed on the textbox element.

        @@ -1912,7 +1912,6 @@

        Definition of Roles

        Implicit Value for Role: - Default for aria-expanded is false.
        Default for aria-haspopup is listbox.
        From 8194d29b149ff87dc95291f4752f09b74b9e64b1 Mon Sep 17 00:00:00 2001 From: Joanmarie Diggs Date: Tue, 14 May 2019 15:18:25 +0200 Subject: [PATCH 16/33] Typo fix --- index.html | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/index.html b/index.html index 1e903ed6f..ec0dbf404 100644 --- a/index.html +++ b/index.html @@ -3746,7 +3746,7 @@

        Definition of Roles

        A element with role legend element can provide an accessible name for elements with grouping roles if it is progammatically associated with the element. Authors MAY associate an element with role legend with an element by using one of two methods:

        • legend: The element contains an element with role legend element. If the element contains more than one element with role legend, only the first descendant element with role legend is used for computing the accessible name.
          • -
        • reference: The element eith role legend is referenced by the element it names via the aria-labelledby attribute.
          • +
        • reference: The element with role legend is referenced by the element it names via the aria-labelledby attribute.

        The legend method of naming is supported only if the element being named has one of the following grouping roles:

          From aeb62bb3c8db4256a77e92ff9f27083195ed8db4 Mon Sep 17 00:00:00 2001 From: Simon Pieters Date: Tue, 21 May 2019 18:55:24 +0200 Subject: [PATCH 17/33] Remove appendix "Schemata" (#980) Fixes #977. --- index.html | 90 +----------------------------------------------------- 1 file changed, 1 insertion(+), 89 deletions(-) diff --git a/index.html b/index.html index ec0dbf404..d6db82cc9 100644 --- a/index.html +++ b/index.html @@ -405,7 +405,7 @@

          Important Terms

          The Roles Model

          -

          This section defines the WAI-ARIA role taxonomy and describes the characteristics and properties of all roles. A formal RDF/OWL representation of all the information presented here is available in Schemata Appendix.

          +

          This section defines the WAI-ARIA role taxonomy and describes the characteristics and properties of all roles.

          The roles, their characteristics, the states and properties they support, and specification of how they may be used in markup, shall be considered normative. The RDF/OWL representation used to model the taxonomy shall be considered informative. The RDF/OWL taxonomy may be used as a vehicle to extend WAI-ARIA in the future or by tool manufacturers to validate states and properties applicable to roles per this specification.

          Roles are element types and authors MUST NOT change role values over time or with user actions. Authors wishing to change a role MUST do so by deleting the associated element and its children and replacing it with a new element with the appropriate role. Typically, platform accessibility APIs do not provide a vehicle to notify assistive technologies of a role value change, and consequently, assistive technologies may not update their cache with the new role attribute value.

          In order to reflect the content in the DOM, user agents SHOULD map the role attribute to the appropriate value in the implemented accessibility API, and user agents SHOULD update the mapping when the role attribute changes.

          @@ -12648,94 +12648,6 @@

          Example IDL Attribute Usage

          -
          -

          Schemata

          -

          WAI-ARIA roles, states, and properties are available in a number of machine-readable formats to support validation of content using WAI-ARIA attributes. WAI-ARIA is not finalized, however, so these files are subject to change without notice. Todo: Remove disclaimers about not final at rec.

          -

          It is not appropriate to use these document types for live content. These are made available only for download, to support local use in development, evaluation, and validation tools. Using these versions directly from the W3C server could cause automatic blockage, preventing them from loading.

          -

          If it is necessary to use schemata in content, follow guidelines to avoid excessive DTD traffic. For instance, use caching proxies to avoid fetching the schema each time it is used, or ensure software uses a local cache, such as with XML catalogs.

          -
          -

          Roles Implementation

          -

          The taxonomy for WAI-ARIA expressed in RDF is available from http://www.w3.org/WAI/ARIA/schemata/aria-1.rdf.

          -
          -
          -

          WAI-ARIA Attributes Module

          -

          This module declares the WAI-ARIA attributes as a module that can be included in a modularized DTD. A sample XHTML DTD using this module follows. Note the WAI-ARIA attributes are in no namespace, and the attribute name begins with "aria-" to reduce the likelihood of collision with existing attributes.

          -

          This module is available from http://www.w3.org/MarkUp/DTD/aria-attributes-1.mod.

          -
          -
          -

          XHTML plus WAI-ARIA DTD

          -

          This DTD extends XHTML 1.1 and adds the WAI-ARIA state and property attributes to all its elements. In order to provide broader keyboard support and conform with the Focus Navigation section above, it also adds the tabindex attribute to a wider set of elements.

          -

          This is not a formal document type and may be obsoleted by future formal XHTML DTDs that support WAI-ARIA.

          -

          The XHTML 1.1 plus WAI-ARIA DTD is available from http://www.w3.org/WAI/ARIA/schemata/xhtml-aria-1.dtd.

          -

          Documents written using this XHTML Family markup language can be validated using the above DTD. If a document author wants to facilitate such validation, they can include the following declaration at the top of their document:

          - 
          <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML+ARIA 1.0//EN"
-  "http://www.w3.org/WAI/ARIA/schemata/xhtml-aria-1.dtd">
          -

          However, note that when this DOCTYPE is present in a document, most user agents treat the document as generic XML rather than HTML. This causes them to be unable to support named character entities defined by the DTD (e.g., &copy;). Therefore, authors need to avoid use of named entities outside of the predefined entities in XML ([[XML11]], Section 4.6).

          -

          To avoid the above problem, authors can omit the above DOCTYPE statement. This causes user agents to treat the document as generic HTML with named character entity support as well as built-in ARIA support. However, it causes user agents to enter "quirks" mode which affects CSS rendering, and causes conformance checkers to fail the document due to the added ARIA attributes.

          -

          To avoid the issues of named character entity support and quirks mode, authors can instead use the following generic DOCTYPE declaration for HTML:

          - 
          <!DOCTYPE html>
          -

          However, this still does not guarantee that documents will be validated by conformance checkers.

          -
          -
          -

          SGML Open Catalog Entry for XHTML+ARIA

          -

          This section contains the SGML Open Catalog-format definition [[SGML-CATALOG]] of the public identifiers for XHTML+ARIA 1.0.

          - 
          -- .......................................................................... --
--- File catalog  ............................................................ --
-
---  XHTML+ARIA Catalog Data File
-
-	Revision:  $Revision: 1.40 $
-
-	See "Entity Management", SGML Open Technical Resolution 9401 for detailed
-	information on supplying and using catalog data. This document is available
-	from OASIS at URL:
-
-		<http://www.oasis-open.org/html/tr9401.html>
-
---
-
--- .......................................................................... --
--- SGML declaration associated with XHTML  .................................. --
-
-OVERRIDE YES
-
-SGMLDECL "xml1.dcl"
-
--- :::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::: --
-
--- XHTML+ARIA modules          .............................................. --
-
-
-PUBLIC "-//W3C//DTD XHTML+ARIA 1.0//EN" "xhtml-aria-1.dtd"
-
-
-PUBLIC "-//W3C//ENTITIES XHTML ARIA Attributes 1.0//EN" "aria-attributes-1.mod"
-
--- End of catalog data  ..................................................... --
--- .......................................................................... --
-
          -
          -
          -

          WAI-ARIA Attributes XML Schema Module

          -

          This module declares the WAI-ARIA attributes as an XML Schema module that can be included in a modularized schema. Note the WAI-ARIA attributes are in no namespace, and the attribute name begins with "aria-" to reduce the likelihood of collision with existing attributes.

          -

          This module is available from http://www.w3.org/MarkUp/SCHEMA/aria-attributes-1.xsd.

          -
          -
          -

          HTML 4.01 plus WAI-ARIA DTD

          -

          This standalone DTD adds WAI-ARIA state and property attributes to all elements in HTML 4.01, as well as a role attribute. In order to provide broader keyboard support, it also adds the tabindex attribute to a wider set of elements.

          -

          The DTD is based on the HTML 4.01 Transitional DTD, and includes all entity references needed to make it a standalone file. This is not an official W3C DTD and should be considered a derivative work of HTML 4.01.

          -

          Documents written using this markup language can be validated using the above DTD. If a document author wants to facilitate such validation, they can include the following declaration at the top of their document:

          - 
          <!DOCTYPE html PUBLIC "-//W3C//DTD HTML+ARIA 1.0//EN"
-	"http://www.w3.org/WAI/ARIA/schemata/html4-aria-1.dtd">
          -

          However, note that when this DOCTYPE is present in a document, most user agents treat the document as generic XML rather than HTML. This causes them to be unable to support named character entities defined by the DTD (e.g., &copy;). Therefore, authors need to avoid use of named entities outside of the predefined entities in XML ([[XML11]], Section 4.6).

          -

          To avoid the above problem, authors can omit the above DOCTYPE statement. This causes user agents to treat the document as generic HTML with named character entity support as well as built-in ARIA support. However, it causes user agents to enter "quirks" mode which affects CSS rendering, and causes conformance checkers to fail the document due to the added ARIA attributes.

          -

          To avoid the issues of named character entity support and quirks mode, authors can instead use the following generic DOCTYPE declaration for HTML:

          - 
          <!DOCTYPE html>
          -

          However, this still does not guarantee that documents will be validated by conformance checkers.

          -

          The HTML Working Group is incorporating WAI-ARIA into HTML5. Official support for WAI-ARIA in HTML will be provided in that specification. This DTD is made available only as a bridging solution for applications requiring DTD validation but not using HTML 5.

          -

          This module is available from http://www.w3.org/WAI/ARIA/schemata/html4-aria-1.dtd.

          -
          -

          Mapping WAI-ARIA Value types to languages

          The HTML 5 column of the table below is advisory. Guidance on use of WAI-ARIA state and properties in HTML 5 is provided in State and Property Attributes ([[HTML51]], section 3.2.7.3.2).

          From 4176ffe64f74d5e4797326984537bafcfc851354 Mon Sep 17 00:00:00 2001 From: Scott O'Hara Date: Tue, 21 May 2019 19:09:28 -0400 Subject: [PATCH 18/33] =?UTF-8?q?[editorial]=20update=205=20instances=20of?= =?UTF-8?q?=20=E2=80=9CIDREF=E2=80=9D=20to=20"ID=20reference"=20or=20"ID?= =?UTF-8?q?=20reference=20list=E2=80=9D.=20(#964)?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit update 5 instances of “IDREF” to "ID reference" or "ID reference list”. Did not update instances where “IDREF” was specifically linking to https://www.w3.org/TR/xmlschema11-2/#IDREF --- index.html | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/index.html b/index.html index d6db82cc9..c8a60b0e1 100644 --- a/index.html +++ b/index.html @@ -10455,8 +10455,8 @@

          Definitions of States and Properties (all aria-* attributes)

          aria-flowto

          Identifies the next element (or elements) in an alternate reading order of content which, at the user's discretion, allows assistive technology to override the general default of reading in document source order.

          -

          When aria-flowto has a single IDREF, it allows assistive technologies to, at the user's request, forego normal document reading order and go to the targeted object. However, when aria-flowto is provided with multiple IDREFS, assistive technologies SHOULD present the referenced elements as path choices.

          -

          In the case of one or more IDREFS, user agents or assistive technologies SHOULD give the user the option of navigating to any of the targeted elements. The name of the path can be determined by the name of the target element of the aria-flowto attribute. Accessibility APIs can provide named path relationships.

          +

          When aria-flowto has a single ID reference, it allows assistive technologies to, at the user's request, forego normal document reading order and go to the targeted object. However, when aria-flowto is provided with multiple ID references, assistive technologies SHOULD present the referenced elements as path choices.

          +

          In the case of one or more ID references, user agents or assistive technologies SHOULD give the user the option of navigating to any of the targeted elements. The name of the path can be determined by the name of the target element of the aria-flowto attribute. Accessibility APIs can provide named path relationships.

          @@ -11205,7 +11205,7 @@

          Definitions of States and Properties (all aria-* attributes)

          aria-owns

          Identifies an element (or elements) in order to define a visual, functional, or contextual parent/child relationship between DOM elements where the DOM hierarchy cannot be used to represent the relationship. See related aria-controls.

          -

          The value of the aria-owns attribute is a space-separated list of IDREFS that reference one or more elements in the document by ID. The reason for adding aria-owns is to expose a parent/child contextual relationship to assistive technologies that is otherwise impossible to infer from the DOM.

          +

          The value of the aria-owns attribute is a space-separated ID reference list that references one or more elements in the document by ID. The reason for adding aria-owns is to expose a parent/child contextual relationship to assistive technologies that is otherwise impossible to infer from the DOM.

          If an element has both aria-owns and DOM children then the order of the child elements with respect to the parent/child relationship is the DOM children first, then the elements referenced in aria-owns. If the author intends that the DOM children are not first, then list the DOM children in aria-owns in the desired order. Authors SHOULD NOT use aria-owns as a replacement for the DOM hierarchy. If the relationship is represented in the DOM, do not use aria-owns. Authors MUST ensure that an element's ID is not specified in more than one other element's aria-owns attribute at any time. In other words, an element can have only one explicit owner.

          Characteristics:
          @@ -12288,7 +12288,7 @@

          ID Reference Error Processing

          User agents SHOULD ignore ID references that do not match the ID of another element in the same document.

          It is the web author's responsibility to ensure that IDs are unique. If more than one element has the same ID, the user agent SHOULD use the first element found with the given ID. The behavior will be the same as getElementById.

          If the same element is specified multiple times in a single WAI-ARIA relation, user agents SHOULD return multiple pointers to the same element.

          -

          aria-activedescendant is defined as referencing only a single ID reference. Any aria-activedescendant value that does not match an existing IDREF exactly is an author error and will not match any element in the DOM.

          +

          aria-activedescendant is defined as referencing only a single ID reference. Any aria-activedescendant value that does not match an existing ID reference exactly is an author error and will not match any element in the DOM.

          From a248824d318ecb39c3bbd5dddd0a97c7c9bcc85c Mon Sep 17 00:00:00 2001 From: Simon Pieters Date: Wed, 22 May 2019 17:06:35 +0200 Subject: [PATCH 19/33] Fix HTML syntax errors in the source (#981) --- index.html | 3 +-- 1 file changed, 1 insertion(+), 2 deletions(-) diff --git a/index.html b/index.html index c8a60b0e1..cfdd449cd 100644 --- a/index.html +++ b/index.html @@ -1,4 +1,3 @@ - @@ -577,7 +576,7 @@

          Implicit Value for Role

          Categorization of Roles

          To support the current user scenario, this specification categorizes roles that define user interface widgets (sliders, tree controls, etc.) and those that define page structure (sections, navigation, etc.). Note that some assistive technologies provide special modes of interaction for regions marked with role application or document.

          -
          Class diagram of the relationships described in the role data model +
          Class diagram of the relationships described in the role data model

          Class diagram of the relationships described in the role data model.

          SVG class diagram | PNG class diagram | Class diagram description

          From 971b41859e2e294ea80b5e476b5f7ae155718e8e Mon Sep 17 00:00:00 2001 From: michael-n-cooper Date: Wed, 22 May 2019 20:00:21 +0000 Subject: [PATCH 20/33] TRAVIS-CI update from aria-common --- common/acknowledgements.html | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/common/acknowledgements.html b/common/acknowledgements.html index d3ba96dae..5b8c9a626 100644 --- a/common/acknowledgements.html +++ b/common/acknowledgements.html @@ -1,7 +1,7 @@

          Acknowledgments

          The following people contributed to the development of this document.

          -
          -
          -
          +
          +
          +
          From 4e537d55af239e6359176f31ab8e61167b10cc68 Mon Sep 17 00:00:00 2001 From: Michael Cooper Date: Thu, 23 May 2019 14:14:14 -0400 Subject: [PATCH 21/33] Fix copy-paste error in conformance From e7a08aaaf5d9d1869d719ce2609ccf6959088a95 --- index.html | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/index.html b/index.html index cfdd449cd..512983bd1 100644 --- a/index.html +++ b/index.html @@ -369,7 +369,7 @@

          Information for User Agents

          Conformance

          -

          The main content of Graphics ARIA is normative and defines requirements that impact conformance claims. Introductory material, appendices, sections marked as "non-normative" and their subsections, diagrams, examples, and notes are informative (non-normative). Non-normative material provides advisory information to help interpret the guidelines but does not create requirements that impact a conformance claim.

          +

          The main content of Accessible Rich Internet Applications is normative and defines requirements that impact conformance claims. Introductory material, appendices, sections marked as "non-normative" and their subsections, diagrams, examples, and notes are informative (non-normative). Non-normative material provides advisory information to help interpret the guidelines but does not create requirements that impact a conformance claim.

          Normative sections provide requirements that user agents must follow for an implementation to conform to this specification. The keywords MUST, MUST NOT, REQUIRED, SHALL, SHALL NOT, SHOULD, RECOMMENDED, MAY, and OPTIONAL in this document are to be interpreted as described in Keywords for use in RFCs to indicate requirement levels [[!RFC2119]]. RFC-2119 keywords are formatted in uppercase and contained in an element with class="rfc2119". When the keywords shown above are used, but do not share this format, they do not convey formal information in the RFC 2119 sense, and are merely explanatory, i.e., informative. As much as possible, such usages are avoided in this specification.

          Normative sections provide requirements that authors, user agents and assistive technologies MUST follow for an implementation to conform to this specification.

          Non-normative (informative) sections provide information useful to understanding the specification. Such sections may contain examples of recommended practice, but it is not required to follow such recommendations in order to conform to this specification.

          From 6663ff10fcbf7467e852c1aad8e1c8d285ff5c09 Mon Sep 17 00:00:00 2001 From: Jon Gunderson Date: Tue, 28 May 2019 11:05:39 -0500 Subject: [PATCH 22/33] fixed term and definition related concepts, added an additional authoring option for definition --- index.html | 13 ++----------- 1 file changed, 2 insertions(+), 11 deletions(-) diff --git a/index.html b/index.html index 512983bd1..c8cdbb3b3 100644 --- a/index.html +++ b/index.html @@ -2231,7 +2231,7 @@

          Definition of Roles

          definition

          A definition of a term or concept. See related term.

          -

          Authors SHOULD identify the element being defined by giving that element a role of term and referencing it with the aria-labelledby attribute.

          +

          Authors SHOULD identify the element being defined by giving that element a role of term and referencing it with the aria-labelledby attribute or by making the element with role term a descendant of the element with role definition.

          @@ -2258,15 +2258,6 @@

          Definition of Roles

          - - - - @@ -8304,7 +8295,7 @@
          Presentational Roles Conflict Resolution
          - + From 6a9419fd5dfd06cdfcb042b3e9f332f44480e6b4 Mon Sep 17 00:00:00 2001 From: Melanie Richards Date: Tue, 4 Jun 2019 10:30:09 -0700 Subject: [PATCH 23/33] Update supported and required properties for the separator role (#945) --- index.html | 19 +++++++++---------- 1 file changed, 9 insertions(+), 10 deletions(-) diff --git a/index.html b/index.html index c8cdbb3b3..e93db7f7a 100644 --- a/index.html +++ b/index.html @@ -7073,7 +7073,6 @@
          Presentational Roles Conflict Resolution
          • The implicit value of aria-valuemin is 0.
          • The implicit value of aria-valuemax is 100.
            • -
          • The implicit value of aria-valuenow is 50.

          In applications where there is more than one focusable separator, authors SHOULD provide an accessible name for each one.

          Elements with the role separator have an implicit aria-orientation value of horizontal.

          @@ -7122,19 +7121,15 @@
          Presentational Roles Conflict Resolution
           - + @@ -7168,8 +7163,7 @@
          Presentational Roles Conflict Resolution
          @@ -12401,6 +12395,11 @@

          States and Properties

          + + + + + From 01e6cc662a1d53a607d22f3c4523329f6cc0da5d Mon Sep 17 00:00:00 2001 From: Joanmarie Diggs Date: Tue, 4 Jun 2019 13:43:57 -0400 Subject: [PATCH 24/33] Editorial: Remove duplicate row from characteristics table of separator --- index.html | 4 ---- 1 file changed, 4 deletions(-) diff --git a/index.html b/index.html index e93db7f7a..f32d4db86 100644 --- a/index.html +++ b/index.html @@ -7166,10 +7166,6 @@
          Presentational Roles Conflict Resolution
          Default for aria-valuemax is 100.           - - - -
          Characteristics:
          Base Concept:  
          Related Concepts: - -
          Required Context Role:  
          Related Concepts:HTML dtHTML dfn
          Required Context Role:
          Required States and Properties: -
            -
          • aria-valuemax (if focusable)
            • -
          • aria-valuemin (if focusable)
            • -
          • aria-valuenow (if focusable)
            • -
          -           		aria-valuenow (if focusable)
          Supported States and Properties:
          • aria-orientation
            • +
          • aria-valuemax (if focusable)
            • +
          • aria-valuemin (if focusable)
          • aria-valuetext (if focusable)
          		 Default for aria-orientation is horizontal.
          Default for aria-valuemin is 0.
          - Default for aria-valuemax is 100.
          - Default for aria-valuenow is 50.
          + Default for aria-valuemax is 100.
          aria-level 2
          separator (if focusable)aria-valuenowaria-valuemax - aria-valuemin) / 2
          scrollbar aria-controls
          Implicit Value for Role:Default for aria-orientation is horizontal.
        From cb9ec0a3c3ef6bae38a357d4342716f175ea2f32 Mon Sep 17 00:00:00 2001 From: Joanmarie Diggs Date: Tue, 4 Jun 2019 13:48:07 -0400 Subject: [PATCH 25/33] Add changelog entry --- index.html | 1 + 1 file changed, 1 insertion(+) diff --git a/index.html b/index.html index f32d4db86..39e778450 100644 --- a/index.html +++ b/index.html @@ -12703,6 +12703,7 @@

        Change Log

        Substantive changes since the last public working draft

          +
        • 04-June-2019: Make aria-valuemin and aria-valuemax supported, rather than required, properties of focusable separator
        • 02-May-2019: Add strong and emphasis roles
        • 02-May-2019: Add aria-required as a supported property of checkbox
        • 02-May-2019: Add code role
          • From 3704546c49d45df40f5c354d87e652a76e7f6e42 Mon Sep 17 00:00:00 2001 From: Melanie Richards Date: Tue, 4 Jun 2019 11:05:29 -0700 Subject: [PATCH 26/33] Move some properties from "required" to "supported" on slider role (#946) Addresses #860 * Reword slider role prose to reflect that aria-valuemin, valuemax are now supported, not required * Remove aria-valuenow repair techniques from inline in the slider role * Make fallback table more robust for aria-valuenow on slider role * Add pointer to the fallback table from slider role * Remove supported but not required attrs on slider from the author error handling table --- index.html | 27 +++++++-------------------- 1 file changed, 7 insertions(+), 20 deletions(-) diff --git a/index.html b/index.html index 39e778450..810bda82e 100644 --- a/index.html +++ b/index.html @@ -7172,16 +7172,14 @@
          Presentational Roles Conflict Resolution
          slider
          -

          A user input where the user selects a value from within a given range.

          +

          An input where the user selects a value from within a given range.

          A slider represents the current value and range of possible values via the size of the slider and position of the thumb. It is typically possible to add or subtract to the value by using directional keys such as arrow keys.

          -

          Authors MUST set the aria-valuemin, aria-valuemax, and aria-valuenow attributes. If missing, their implicit values follow the same rules as the HTML range input type:

          +

          Authors MAY set the aria-valuemin and aria-valuemax attributes. Otherwise, their implicit values follow the same rules as the HTML range input type:

          • If aria-valuemin is missing or not a number, it defaults to 0 (zero).
          • If aria-valuemax is missing or not a number, it defaults to 100.
            • -
          • If aria-valuenow is missing or not a number, it defaults to the value half way between aria-valuemin and aria-valuemax.
            • -
          • If aria-valuenow is present but less than aria-valuemin, it defaults to the value of aria-valuemin.
            • -
          • If aria-valuenow is present but greater than aria-valuemax, it defaults to the value of aria-valuemax.
          +

          Authors MUST set the aria-valuenow attribute. If aria-valuenow is missing or has an unexpected value, browsers MAY implement the repair techniques specified in the section describing handling author errors in states and properties, which are equivalent to the repair techniques for the HTML range input type.

          Elements with the role slider have an implicit aria-orientation value of horizontal.

          @@ -7228,8 +7226,6 @@
          Presentational Roles Conflict Resolution
          @@ -7240,6 +7236,8 @@
          Presentational Roles Conflict Resolution
          • aria-orientation
          • aria-readonly
            • +
          • aria-valuemax
            • +
          • aria-valuemin
          @@ -7272,8 +7270,7 @@
          Presentational Roles Conflict Resolution
          @@ -12421,20 +12418,10 @@

          States and Properties

          - - - - - - - - - - - + From cfa9744f14330271313e8c5d2b5860346779f7e7 Mon Sep 17 00:00:00 2001 From: Joanmarie Diggs Date: Tue, 4 Jun 2019 14:07:02 -0400 Subject: [PATCH 27/33] Add changelog entry --- index.html | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/index.html b/index.html index 810bda82e..8c0950d67 100644 --- a/index.html +++ b/index.html @@ -12690,7 +12690,7 @@

          Change Log

          Substantive changes since the last public working draft

            -
          • 04-June-2019: Make aria-valuemin and aria-valuemax supported, rather than required, properties of focusable separator
            • +
          • 04-June-2019: Make aria-valuemin and aria-valuemax supported, rather than required, properties of focusable separator and slider
          • 02-May-2019: Add strong and emphasis roles
          • 02-May-2019: Add aria-required as a supported property of checkbox
          • 02-May-2019: Add code role
            • From 9380b6535e3c8428c947347c073c8a65dc40d127 Mon Sep 17 00:00:00 2001 From: Melanie Richards Date: Tue, 4 Jun 2019 11:14:06 -0700 Subject: [PATCH 28/33] Move some properties from "required" to "supported" on scrollbar role (#944) Addresses #858 * Update scrollbar role prose to better reflect properties moving from 'required' to 'supported' * Scrollbar role: remove aria-valuenow repair techniques to the fallback table and point to said table * Remove supported but not required attrs on scrollbar from the author error handling table --- index.html | 34 ++++++++++++---------------------- 1 file changed, 12 insertions(+), 22 deletions(-) diff --git a/index.html b/index.html index 8c0950d67..eab8449cc 100644 --- a/index.html +++ b/index.html @@ -6585,14 +6585,12 @@
            Presentational Roles Conflict Resolution

            A graphical object that controls the scrolling of content within a viewing area, regardless of whether the content is fully displayed within the viewing area.

            A scrollbar represents the current value and range of possible values via the size of the scrollbar and position of the thumb with respect to the visible range of the orientation (horizontal or vertical) it controls. Its orientation represents the orientation of the scrollbar and the scrolling effect on the viewing area controlled by the scrollbar. It is typically possible to add or subtract to the current value by using directional keys such as arrow keys.

            Authors MUST set the aria-controls attribute on the scrollbar element to reference the scrollable area it controls.

            -

            Authors MUST set the aria-valuemin, aria-valuemax, and aria-valuenow attributes. If missing, their implicit values follow the same rules as the HTML range input type:

            +

            Authors MAY set aria-valuemin and aria-valuemax to indicate the minimum and maximum thumb position. Otherwise, their implicit values follow the same rules as the HTML range input type:

              -
            • If aria-valuemin is missing or not a number, it defaults to 0 (zero).
              • -
            • If aria-valuemax is missing or not a number, it defaults to 100.
              • -
            • If aria-valuenow is missing or not a number, it defaults to the value half way between aria-valuemin and aria-valuemax.
              • -
            • If aria-valuenow is present but less than aria-valuemin, it defaults to the value of aria-valuemin.
              • -
            • If aria-valuenow is present but greater than aria-valuemax, it defaults to the value of aria-valuemax.
              • +
            • If aria-valuemin is missing or not a number, it defaults to 0 (zero).
              • +
            • If aria-valuemax is missing or not a number, it defaults to 100.
            +

            Authors MUST set the aria-valuenow attribute to indicate the current thumb position. If aria-valuenow is missing or has an unexpected value, browsers MAY implement the repair techniques specified in the section describing handling author errors in states and properties, which are equivalent to the repair techniques for the HTML range input type.

            Elements with the role scrollbar have an implicit aria-orientation value of vertical.

            Assistive technologies generally will render the value of aria-valuenow as a percent of a range between the value of aria-valuemin and aria-valuemax, unless aria-valuetext is specified. It is best to set the values for aria-valuemin, aria-valuemax, and aria-valuenow in a manner that is appropriate for this calculation.

            @@ -6643,16 +6641,19 @@
            Presentational Roles Conflict Resolution
           - + @@ -6684,7 +6685,6 @@
          Presentational Roles Conflict Resolution
          Default for aria-orientation is vertical.
          Default for aria-valuemin is 0.
          Default for aria-valuemax is 100.
          - Default for aria-valuenow is half way between aria-valuemax and aria-valuemin. @@ -12403,20 +12403,10 @@

          States and Properties

          - - - - - - - - - - - + From 63ec695c1b2cbc291ac5cd96330692ed530cdbd6 Mon Sep 17 00:00:00 2001 From: Joanmarie Diggs Date: Tue, 4 Jun 2019 14:16:12 -0400 Subject: [PATCH 29/33] Add changelog entry --- index.html | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/index.html b/index.html index eab8449cc..1e73da249 100644 --- a/index.html +++ b/index.html @@ -12680,7 +12680,7 @@

          Change Log

          Substantive changes since the last public working draft

            -
          • 04-June-2019: Make aria-valuemin and aria-valuemax supported, rather than required, properties of focusable separator and slider
            • +
          • 04-June-2019: Make aria-valuemin and aria-valuemax supported, rather than required, properties of focusable separator, slider, and scrollbar. Make aria-orientation a supported, rather than required, property of scrollbar.
          • 02-May-2019: Add strong and emphasis roles
          • 02-May-2019: Add aria-required as a supported property of checkbox
          • 02-May-2019: Add code role
            • From 81399d4bb5cf8f3968c1ad9e9ea376d6d6f66ace Mon Sep 17 00:00:00 2001 From: James Nurthen Date: Thu, 13 Jun 2019 14:24:51 -0700 Subject: [PATCH 30/33] add aardvark abstract role --- index.html | 108 ++++++++++++++++++++++++++++++++++++++++++++++++----- 1 file changed, 99 insertions(+), 9 deletions(-) diff --git a/index.html b/index.html index 4713c7649..744f6ad67 100644 --- a/index.html +++ b/index.html @@ -595,6 +595,7 @@

            Abstract Roles

            The following roles are used to support the WAI-ARIA role taxonomy for the purpose of defining general role concepts.

            Abstract roles are used for the ontology. Authors MUST NOT use abstract roles in content.

              +
            • aardvark
            • command
            • composite
            • input
              • @@ -740,6 +741,76 @@

              Definition of Roles

              Below is an alphabetical list of WAI-ARIA roles to be used by rich internet application authors.

              Abstract roles are used for the ontology. Authors MUST NOT use abstract roles in content.

              Placeholder for compact list of roles

              +
              + aardvark +
              +

              A renderable structural containment unit in a document or application.

              +

              aardvark is an abstract role used for the ontology. Authors should not use this role in content.

              +
              +
          Required States and Properties:
            -
          • aria-valuemax
            • -
          • aria-valuemin
          • aria-valuenow
          Default for aria-orientation is horizontal.
          Default for aria-valuemin is 0.
          - Default for aria-valuemax is 100.
          - Default for aria-valuenow is half way between aria-valuemax and aria-valuemin. + Default for aria-valuemax is 100.
          aria-valuenow (aria-valuemax - aria-valuemin) / 2
          slideraria-valuemax100
          slideraria-valuemin0
          slider aria-valuenow(aria-valuemax - aria-valuemin) / 2If missing or not a number,(aria-valuemax - aria-valuemin) / 2. If present but less than aria-valuemin, the value of aria-valuemin. If present but greater than aria-valuemax, the value of aria-valuemax.
          spinbutton
          • aria-controls
            • -
          • aria-orientation
            • -
          • aria-valuemax
            • -
          • aria-valuemin
          • aria-valuenow
          Supported States and Properties:  +
            +
          • aria-orientation
            • +
          • aria-valuemax
            • +
          • aria-valuemin
            • +
          +
          Inherited States and Properties:
          aria-orientation vertical
          scrollbararia-valuemax100
          scrollbararia-valuemin0
          scrollbar aria-valuenow(aria-valuemax - aria-valuemin) / 2If missing or not a number,(aria-valuemax - aria-valuemin) / 2. If present but less than aria-valuemin, the value of aria-valuemin. If present but greater than aria-valuemax, the value of aria-valuemax.
          slider
          + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
          Characteristics:
          CharacteristicValue
          Is Abstract:True
          Superclass Role:structure
          Subclass Roles:Placeholder
          Base Concept: 
          Related Concepts:
          Required States and Properties: 
          Supported States and Properties:
          Inherited States and Properties:Placeholder
          Name From:n/a
          Accessible Name Required: 
          Inherits Name Required: 
          Children Presentational: 
          Inherits Presentational: 
          +
          alert
          @@ -1363,7 +1434,7 @@

          Definition of Roles

          Superclass Role: - section + aardvark Subclass Roles: @@ -2244,7 +2315,7 @@

          Definition of Roles

          Superclass Role: - section + aardvark Base Concept: @@ -3359,7 +3430,7 @@

          Definition of Roles

          Superclass Role: - section + aardvark Base Concept: @@ -5447,7 +5518,7 @@
          Note regarding the ARIA 1.1 none role.
          Superclass Role: - section + aardvark Subclass Roles: @@ -6351,7 +6422,12 @@
          Presentational Roles Conflict Resolution
          Supported States and Properties: -   + +
            +
          • aria-label
            • +
          • aria-labelledby
            • +
          +   Inherited States and Properties: @@ -6781,7 +6857,13 @@
          Presentational Roles Conflict Resolution
          Supported States and Properties: - aria-expanded + +
            +
          • aria-expanded
            • +
          • aria-label
            • +
          • aria-labelledby
            • +
          + Inherited States and Properties: @@ -6851,7 +6933,13 @@
          Presentational Roles Conflict Resolution
          Supported States and Properties: - aria-expanded + +
            +
          • aria-expanded
            • +
          • aria-label
            • +
          • aria-labelledby
            • +
          + Inherited States and Properties: @@ -7031,6 +7119,8 @@
          Presentational Roles Conflict Resolution
          Supported States and Properties:
            +
          • aria-label (if focusable)
            • +
          • aria-labelledby (if focusable)
          • aria-orientation
          • aria-valuetext (if focusable)
          @@ -7481,7 +7571,7 @@
          Presentational Roles Conflict Resolution
          Superclass Role: - section + aardvark Subclass Roles: @@ -7559,7 +7649,7 @@
          Presentational Roles Conflict Resolution
          Superclass Role: - section + aardvark Subclass Roles: From 4d3c5500cfbc77910a16c40a00b7bd25262ffad3 Mon Sep 17 00:00:00 2001 From: James Nurthen Date: Mon, 29 Apr 2019 14:46:24 -0700 Subject: [PATCH 31/33] Make aria-label and labelledby non global --- index.html | 88 +++++++++++++++++++++++++++++++++++++++++++----------- 1 file changed, 70 insertions(+), 18 deletions(-) diff --git a/index.html b/index.html index 1e73da249..e8143336e 100644 --- a/index.html +++ b/index.html @@ -970,12 +970,14 @@

          Definition of Roles

          Supported States and Properties: - -
            -
          • aria-activedescendant
            • -
          • aria-expanded
            • -
          - + +
            +
          • aria-activedescendant
            • +
          • aria-expanded
            • +
          • aria-label
            • +
          • aria-labelledby
            • +
          + Inherited States and Properties: @@ -2584,7 +2586,12 @@

          Definition of Roles

          Supported States and Properties: - + +
            +
          • aria-label
            • +
          • aria-labelledby
            • +
          + Inherited States and Properties: @@ -2831,7 +2838,12 @@

          Definition of Roles

          Supported States and Properties: -   + +
            +
          • aria-label
            • +
          • aria-labelledby
            • +
          + Inherited States and Properties: @@ -3203,7 +3215,13 @@

          Definition of Roles

          Supported States and Properties: - aria-activedescendant + +
            +
          • aria-activedescendant
            • +
          • aria-label
            • +
          • aria-labelledby
            • +
          + Inherited States and Properties: @@ -3373,8 +3391,12 @@

          Definition of Roles

          Supported States and Properties: -   - + +
            +
          • aria-label
            • +
          • aria-labelledby
            • +
          + Inherited States and Properties: Placeholder @@ -3700,7 +3722,12 @@

          Definition of Roles

          Supported States and Properties: -   + +
            +
          • aria-label
            • +
          • aria-labelledby
            • +
            + Inherited States and Properties: @@ -3978,7 +4005,12 @@

          Definition of Roles

          Supported States and Properties: -   + +
            +
          • aria-label
            • +
          • aria-labelledby
            • +
          + Inherited States and Properties: @@ -6073,6 +6105,8 @@
          Presentational Roles Conflict Resolution
          Supported States and Properties:
            +
          • aria-label
            • +
          • aria-labelledby
          • aria-valuemax
          • aria-valuemin
          • aria-valuenow
            • @@ -8037,6 +8071,8 @@
            Presentational Roles Conflict Resolution
            • aria-colcount
              • +
            • aria-label
              • +
            • aria-labelledby
            • aria-rowcount
            @@ -8219,7 +8255,12 @@
            Presentational Roles Conflict Resolution
            Supported States and Properties: -   + +
              +
            • aria-label
              • +
            • aria-labelledby
              • +
            + Inherited States and Properties: @@ -9203,7 +9244,12 @@
            Presentational Roles Conflict Resolution
            Supported States and Properties: -   + +
              +
            • aria-label
              • +
            • aria-labelledby
              • +
            + Inherited States and Properties: @@ -9279,7 +9325,13 @@
            Presentational Roles Conflict Resolution
            Supported States and Properties: - aria-modal + +
              +
            • aria-label
              • +
            • aria-labelledby
              • +
            • aria-modal
              • +
            + Inherited States and Properties: @@ -10807,7 +10859,7 @@

            Definitions of States and Properties (all aria-* attributes)

            Used in Roles: - All elements of the base markup + Placeholder Inherits into Roles: @@ -10845,7 +10897,7 @@

            Definitions of States and Properties (all aria-* attributes)

            Used in Roles: - All elements of the base markup + Placeholder Inherits into Roles: From 69737c71030b0cbf397b66e40efd5471730c67e3 Mon Sep 17 00:00:00 2001 From: James Nurthen Date: Thu, 13 Jun 2019 14:24:51 -0700 Subject: [PATCH 32/33] add aardvark abstract role --- index.html | 106 ++++++++++++++++++++++++++++++++++++++++++++++++----- 1 file changed, 97 insertions(+), 9 deletions(-) diff --git a/index.html b/index.html index e8143336e..62214f7ac 100644 --- a/index.html +++ b/index.html @@ -594,6 +594,7 @@

            Abstract Roles

            The following roles are used to support the WAI-ARIA role taxonomy for the purpose of defining general role concepts.

            Abstract roles are used for the ontology. Authors MUST NOT use abstract roles in content.

              +
            • aardvark
            • command
            • composite
            • input
              • @@ -741,6 +742,76 @@

              Definition of Roles

              Below is an alphabetical list of WAI-ARIA roles to be used by rich internet application authors.

              Abstract roles are used for the ontology. Authors MUST NOT use abstract roles in content.

              Placeholder for compact list of roles

              +
              + aardvark +
              +

              A renderable structural containment unit in a document or application.

              +

              aardvark is an abstract role used for the ontology. Authors should not use this role in content.

              +
              + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
              Characteristics:
              CharacteristicValue
              Is Abstract:True
              Superclass Role:structure
              Subclass Roles:Placeholder
              Base Concept: 
              Related Concepts:
              Required States and Properties: 
              Supported States and Properties:
              Inherited States and Properties:Placeholder
              Name From:n/a
              Accessible Name Required: 
              Inherits Name Required: 
              Children Presentational: 
              Inherits Presentational: 
              +
              alert
              @@ -1365,7 +1436,7 @@

              Definition of Roles

              Superclass Role: - section + aardvark Subclass Roles: @@ -2324,7 +2395,7 @@

              Definition of Roles

              Superclass Role: - section + aardvark Base Concept: @@ -3514,7 +3585,7 @@

              Definition of Roles

              Superclass Role: - section + aardvark Base Concept: @@ -5584,7 +5655,7 @@
              Note regarding the ARIA 1.1 none role.
              Superclass Role: - section + aardvark Subclass Roles: @@ -6487,7 +6558,12 @@
              Presentational Roles Conflict Resolution
              Supported States and Properties: -   + +
                +
              • aria-label
                • +
              • aria-labelledby
                • +
              +   Inherited States and Properties: @@ -6918,7 +6994,12 @@
              Presentational Roles Conflict Resolution
              Supported States and Properties: - + +
                +
              • aria-label
                • +
              • aria-labelledby
                • +
              + Inherited States and Properties: @@ -6988,7 +7069,12 @@
              Presentational Roles Conflict Resolution
              Supported States and Properties: - + +
                +
              • aria-label
                • +
              • aria-labelledby
                • +
              + Inherited States and Properties: @@ -7161,6 +7247,8 @@
              Presentational Roles Conflict Resolution
              Supported States and Properties:
                +
              • aria-label (if focusable)
                • +
              • aria-labelledby (if focusable)
              • aria-orientation
              • aria-valuemax (if focusable)
              • aria-valuemin (if focusable)
                • @@ -7683,7 +7771,7 @@
                Presentational Roles Conflict Resolution
                Superclass Role: - section + aardvark Subclass Roles: @@ -7761,7 +7849,7 @@
                Presentational Roles Conflict Resolution
                Superclass Role: - section + aardvark Subclass Roles: From fd7f6177316b7c572eef9d6e89e3d4b6fb0f7806 Mon Sep 17 00:00:00 2001 From: James Nurthen Date: Thu, 13 Jun 2019 15:13:57 -0700 Subject: [PATCH 33/33] remove aria-label from roles where inherited --- index.html | 55 +++++++++--------------------------------------------- 1 file changed, 9 insertions(+), 46 deletions(-) diff --git a/index.html b/index.html index 39a4fb108..7f2762bbf 100644 --- a/index.html +++ b/index.html @@ -2713,7 +2713,7 @@

                Definition of Roles

                Superclass Role: - section + aardvark Subclass Roles: @@ -2741,12 +2741,7 @@

                Definition of Roles

                Supported States and Properties: - -
                  -
                • aria-label
                  • -
                • aria-labelledby
                  • -
                - + Inherited States and Properties: @@ -2914,12 +2909,7 @@

                Definition of Roles

                Supported States and Properties: - -
                  -
                • aria-label
                  • -
                • aria-labelledby
                  • -
                - + Inherited States and Properties: @@ -3291,12 +3281,7 @@

                Definition of Roles

                Supported States and Properties: - -
                  -
                • aria-activedescendant
                  • -
                • aria-label
                  • -
                • aria-labelledby
                  • -
                + aria-activedescendant
              @@ -3467,12 +3452,7 @@

              Definition of Roles

              Supported States and Properties: - -
                -
              • aria-label
                • -
              • aria-labelledby
                • -
              - + Inherited States and Properties: Placeholder @@ -3798,12 +3778,7 @@

              Definition of Roles

              Supported States and Properties: - -
                -
              • aria-label
                • -
              • aria-labelledby
                • -
                - + Inherited States and Properties: @@ -4081,12 +4056,7 @@

              Definition of Roles

              Supported States and Properties: - -
                -
              • aria-label
                • -
              • aria-labelledby
                • -
              - + Inherited States and Properties: @@ -8163,9 +8133,7 @@
              Presentational Roles Conflict Resolution
              Supported States and Properties:
                -
              • aria-colcount
                • -
              • aria-label
                • -
              • aria-labelledby
                • +
              • aria-colcount
              • aria-rowcount
              @@ -8348,12 +8316,7 @@
              Presentational Roles Conflict Resolution
              Supported States and Properties: - -
                -
              • aria-label
                • -
              • aria-labelledby
                • -
              - + Inherited States and Properties: