Define concept of minimum role

index.html

@@ -215,32 +215,65 @@ Exposing HTML Features That Do Not Directly Map to Accessibility APIs
       
     
     
-      HTML Element Role Mappings
+      Exposing HTML Features That Require a Minimum Role
+      
+        A minimum role is the equivalent WAI-ARIA role an element will map to when an element has no more specific implicit role. This can help ensure that users of assistive technologies get the best possible experience for commonly-used and valid HTML markup where otherwise a role would not be exposed.
+      
+      
+        A minimum role is provided when all of the following conditions are true:
+      
       
-        HTML elements with implicit WAI-ARIA role semantics MUST be mapped to platform accessibility APIs according to the identified WAI-ARIA role mapping as defined in the [[core-aam-1.2]] specification.
-        "Not mapped" means the element does not need to be exposed via an accessibility API. This is usually because the element is not displayed as part of the user interface. However, authors can force some of these elements to be rendered. For instance, by overriding user agent styles to render elements that would have been otherwise set to `display: none`. In these cases, the user agent SHOULD map such elements to the role of `generic`.
-        Where applicable, how an element participates in the computation of its own or another element's accessible name and/or accessible description is described in the Accessible Name and Description Computation section of this document.
-        Where an element is indicated as having "No corresponding (WAI-ARIA) role", or is mapped to the `generic` role, user agents MUST NOT expose the `aria-roledescription` property value in the accessibility tree unless the element has an explicit, conforming `role` attribute value which [[WAI-ARIA-1.2]] does not prohibit the use of `aria-roledescription`.
         
-          IAccessible2:
-          
-            All elements with accessible objects should implement the IAccessible, IAccessible2 and IAccessible2_2 interfaces.
-          
-        
+          the element either has no implicit mapping or has an implicit `generic` role mapping, 
         
-          UIA:
-          
-            When a labelable element is referenced by a `label` element's `for` attribute, or a descendant of a `label` element, the labelable element's UIA `LabeledBy` property points to the UIA element for the `label` element.
-            Elements mapped to the `Text` Control Type are not generally represented as accessible objects in the accessibility tree, but are just part of the `Text` Control Pattern implemented for the whole HTML document. However, if they have any `aria-` attributes or an explicit `tabindex` specified, elements mapped to the `Text` Control Type will be represented as accessible objects in the accessibility tree.
-          
+          the author has not specified an explicit role to the element, 
+        
+          and the author has specified properties which require a minimum role mapping for the element.
         
+      
+      
+        The properties which will require a minimum role mapping are specific global HTML attributes, identified in the Mappings of HTML attributes table.
+      
+      
+        When these conditions are met, the browser MUST expose an object using the mappings defined in CORE-AAM for the specified minimum role.
+      
+    
+    
+      HTML Element Role Mappings
+      
+        HTML elements with implicit WAI-ARIA role semantics MUST be mapped to platform accessibility APIs according to the identified WAI-ARIA role mapping as defined in the [[core-aam-1.2]] specification.
+        "Not mapped" means the element is not exposed via an accessibility API. Commonly, an element is not mapped because it's not displayed as part of the user interface. However, authors can force some of these elements to be rendered. For instance, by overriding user agent styles to render elements that would have been otherwise set to `display: none`. In these cases, the user agent SHOULD map such elements to the role of `generic`, unless other HTML features have been specified which would require a more specific minimum role to be exposed.
+        Where an element is indicated as having No corresponding (WAI-ARIA) role, or is mapped to the `generic` role, user agents MUST NOT expose the `aria-roledescription` property value in the accessibility tree unless the element has an explicit, conforming `role` attribute value for which [[WAI-ARIA-1.2]] does not prohibit the use of `aria-roledescription`.
         
-          AXAPI:
-          
-            User agents should return a user-presentable, localized string value for the Mac Accessibility AXRoleDescription.
-          
+          Some HTML elements expose implicit WAI-ARIA roles depending on whether they have been provided an accessible name. How an element participates in the computation of its own or another element's accessible name and/or accessible description is described in the Accessible Name and Description Computation section of this document.
         
+        HTML elements with no mapping, or an implicit mapping of `generic`
       
+
+      
+        Platform API mapping requirements
+        
+          
+            IAccessible2:
+            
+              All elements with accessible objects SHOULD implement the IAccessible, IAccessible2 and IAccessible2_2 interfaces.
+            
+          
+          
+            UIA:
+            
+              When a labelable element is referenced by a `label` element's `for` attribute, or a descendant of a `label` element, the labelable element's UIA `LabeledBy` property points to the UIA element for the `label` element.
+              Elements mapped to the `Text` Control Type are not generally represented as accessible objects in the accessibility tree, but are just part of the `Text` Control Pattern implemented for the whole HTML document. However, if they have any `aria-` attributes or an explicit `tabindex` specified, elements mapped to the `Text` Control Type will be represented as accessible objects in the accessibility tree.
+            
+          
+          
+            AXAPI:
+            
+              User agents should return a user-presentable, localized string value for the Mac Accessibility AXRoleDescription.
+            
+          
+        
+      
       
           
@@ -3318,7 +3351,9 @@ HTML Attribute State and Property Mappings
                 
               
               
-              
+              
+                Provides a minimum role of `group`.
+              
             
             
               
@@ -3493,7 +3528,7 @@ HTML Attribute State and Property Mappings
               
               
               
-                Similar to ariaFlowto">`aria-flowto`.
+                Provides a minimum role of role-map-group
               
             
             
@@ -3674,11 +3709,15 @@ HTML Attribute State and Property Mappings
               
               
                 Role:
-                AXtextArea
+                AXTextArea
                 Use WAI-ARIA mapping
               
               
-                If the element has the `contenteditable` attribute  and `aria-readonly="true"`, User Agents MUST expose only the `contenteditable` state.
+                If the element has the `contenteditable` attribute and `aria-readonly="true"`, User Agents MUST expose only the `contenteditable` state.
+                
+                  If the attribute exposes or inherits the `true` state, it provides a minimum role of `group`.
+                
+                
               
             
             
@@ -3917,7 +3956,9 @@ HTML Attribute State and Property Mappings
                 
               
               
-              
+              
+                Provides a minimum role of `group`.
+              
             
             
               
@@ -5336,7 +5377,9 @@ HTML Attribute State and Property Mappings
               
               
               
-              
+              
+                Provides a minimum role of `group`.
+