From 2a047fd3316ba827d1514980b93589b8d41b7502 Mon Sep 17 00:00:00 2001 From: Aaron Leventhal Date: Thu, 13 Feb 2020 16:31:38 -0500 Subject: [PATCH] Add suggestion role (#1134) * Relates to ARIA Annotations, 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 159a45d2c..d6d37da36 100644 --- a/index.html +++ b/index.html @@ -670,6 +670,7 @@

Document Structure Roles

  • separator (when not focusable)
  • strong
  • subscript
    • +
  • suggestion
  • superscript
  • table
  • term
    • @@ -8394,6 +8395,107 @@
    Presentational Roles Conflict Resolution
    +
    + suggestion +
    +

    A single proposed change to content.

    +

    For example, in an editing system that supports multiple users, one user may suggest a change, and another user would be responsible + for accepting or rejecting the suggestion.

    +

    Authors MUST ensure that a suggestion contains either one insertion child or one deletion child or ensure that it contains two children where one is an insertion and the other is a deletion. Authors MUST ensure a suggestion does not contain any other children.

    +

    Authors MAY use aria-details or aria-description to associate the suggestion with related information such as comments, authoring info, and time stamps.

    + 
    +						<p>
+						  The best pet is a
+						  <span role="suggestion">
+						    <span role="deletion">cat</span>
+						    <span role="insertion">dog</span>
+						  </span>
+						</p>
+
    +

    When a suggestion is accepted, authors SHOULD remove the suggestion role, indicating that the proposed revision has been made. + After the suggestion role is removed, child insertion and deletion elements can either be retained to document the revision or replaced with the revised content. +

    +
    + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
    Characteristics:
    CharacteristicValue
    Is Abstract: 
    Superclass Role:section
    Base Concept: 
    Related Concepts: 
    Required Context Role: 
    Required Owned Elements: +
  • insertion
    • +
  • deletion
    • +
    Required States and Properties: 
    Supported States and Properties:
    Inherited States and Properties:Placeholder
    Prohibited States and Properties: +
      +
    • aria-label
      • +
    • aria-labelledby
      • +
    +
    Name From:prohibited
    Accessible Name Required: 
    Inherits Name Required: 
    Children Presentational: 
    Inherits Presentational: 
    +
    superscript