From eed0ef0eeb70447c4813ca5cbe1c35866d7c5929 Mon Sep 17 00:00:00 2001 From: Aaron Leventhal Date: Tue, 11 Feb 2020 12:27:34 -0500 Subject: [PATCH] Add comment role (#1135) Refers to issue #749 Co-Authored-By: Carolyn MacLeod Co-Authored-By: Matt King --- index.html | 102 +++++++++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 102 insertions(+) diff --git a/index.html b/index.html index 58c9b3aeb..f77e265d9 100644 --- a/index.html +++ b/index.html @@ -640,6 +640,7 @@

Document Structure Roles

  • caption
  • cell
  • columnheader
    • +
  • comment
  • definition
  • deletion
  • directory
    • @@ -2327,6 +2328,107 @@

    Definition of Roles

    +
    + comment +
    +

    A comment contains content expressing reaction to other content.

    +

    Comments can annotate any visible content, from small spans of text, to other comments, to entire articles. Authors SHOULD identify the relationships between comments and the commented content, as follows:

    +
      +
    1. If the comment is a reply to another comment: +
        +
      • If all ancestor comments are available in the DOM, make each reply comment a semantic descendant of the comment to which it is replying, either by making it a DOM descendant element or by using aria-owns.
        • +
      • Alternatively, if all ancestor comments are not in the DOM, such as when comments are paginated, the hierarchical + level MAY be indicated via aria-level. Additional group positional information MAY be indicated via aria-posinset and aria-setsize.
        • +
      +
      2. +
    2. Otherwise, if the comment relates to other content in the page: +
        +
      • Provide aria-details on the element containing the commented content with a value refering to the element with role comment.
        • +
      • If there are multiple comments related to the same commented content, either provide a value for aria-details on the commented content that refers to each individual comment, or use aria-details to refer to a parent container of the comments. If aria-details refers to an element containing comments rather than comment elements, authors SHOULD assign a role of group or region to the referenced container.
        • +
      +
      3. +
    +

    If the author has not explicitly declared aria-level, aria-posinset, or aria-setsize for a comment element, user agents MUST automatically compute the missing values and expose them to assistive technologies.

    +
    + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
    Characteristics:
    CharacteristicValue
    Is Abstract: 
    Superclass Role:article
    Base Concept: 
    Related Concepts: 
    Required Context Role: 
    Required Owned Elements:
    Required States and Properties: 
    Supported States and Properties: +
      +
    • aria-level
      • +
    • aria-posinset
      • +
    • aria-setsize
      • +
    +
    Inherited States and Properties:Placeholder
    Name From: +
      +
    • contents
      • +
    • author
      • +
    +
    Accessible Name Required: 
    Inherits Name Required: 
    Children Presentational: 
    Inherits Presentational: 
    +
    complementary