Audited and updated roles source of truth to HTML Accessibility API M…

…apping 1.0 (#447)
A11yance · Dec 5, 2022 · f7f6120 · f7f6120
1 parent c9dd9dd
commit f7f6120
Show file tree

Hide file tree

Showing 52 changed files with 1,922 additions and 5,217 deletions.
diff --git a/__tests__/src/ariaPropsMaps-test.js b/__tests__/src/ariaPropsMaps-test.js
diff --git a/__tests__/src/domMap-test.js b/__tests__/src/domMap-test.js
diff --git a/__tests__/src/elementRoleMap-test.js b/__tests__/src/elementRoleMap-test.js
diff --git a/__tests__/src/roleElementMap-test.js b/__tests__/src/roleElementMap-test.js
diff --git a/__tests__/src/rolesMap-test.js b/__tests__/src/rolesMap-test.js
diff --git a/flow/aria.js b/flow/aria.js
@@ -70,6 +70,7 @@ type ARIADocumentStructureRole =
   | 'insertion'
   | 'list'
   | 'listitem'
+  | 'mark'
   | 'math'
   | 'meter'
   | 'none'
@@ -166,36 +167,48 @@ type ARIARole =
   | ARIALandmarkRole
   | ARIALiveRegionRole
   | ARIAWindowRole
-  | ARIAUncategorizedRole;
+  | ARIAUncategorizedRole
+  | ARIADPubRole
+  | ARIAGraphicsRole;
 
 type ARIARoleDefinitionKey =
   ARIAAbstractRole
   | ARIARole
   | ARIADPubRole
   | ARIAGraphicsRole;
 
-type ARIARoleDefinition = {
+type ARIANameFromSources =
+  'author'
+  | 'contents'
+  | 'prohibited';
+
+type ARIARoleDefinition = {|
   /* Abstract roles may not be used in HTML. */
   abstract: boolean,
+  accessibleNameRequired: boolean,
   /* The concepts in related domains that inform behavior mappings. */
   baseConcepts: Array<ARIARoleRelation>,
   /* Child presentational roles strip child nodes of roles and flatten the
   * content to text. */
   childrenPresentational: boolean,
+  nameFrom?: Array<ARIANameFromSources>,
   /* aria-* properties and states disallowed on this role. */
   prohibitedProps: $Keys<ARIAPropertyMap>[],
   /* aria-* properties and states allowed on this role. */
   props: ARIAPropertyMap,
   /* The concepts in related domains that inform behavior mappings. */
   relatedConcepts: Array<ARIARoleRelation>,
+  requireContextRole?: Array<ARIARole>,
+  requiredContextRole?: Array<ARIARole>,
+  requiredOwnedElements?: Array<Array<string>>,
   /* aria-* properties and states required on this role. */
   requiredProps: ARIAPropertyMap,
   /* An array or super class "stacks." Each stack contains a LIFO list of
   * strings correspond to a super class in the inheritance chain of this
   * role. Roles may have more than one inheritance chain, which is why
   * this property is an array of arrays and not a single array. */
   superClass: Array<Array<ARIAAbstractRole | ARIARole | ARIADPubRole>>,
-};
+|};
 
 type RoleDefinitionTuple = [ARIARoleDefinitionKey, ARIARoleDefinition];
 type RoleDefinitions = Array<RoleDefinitionTuple>;
@@ -215,12 +228,15 @@ type ARIAProperty =
   'aria-activedescendant'
   | 'aria-atomic'
   | 'aria-autocomplete'
+  | 'aria-braillelabel'
+  | 'aria-brailleroledescription'
   | 'aria-colcount'
   | 'aria-colindex'
   | 'aria-colspan'
   | 'aria-controls'
   | 'aria-current'
   | 'aria-describedby'
+  | 'aria-description'
   | 'aria-details'
   | 'aria-dropeffect'
   | 'aria-errormessage'
@@ -255,29 +271,30 @@ type ARIAProperty =
 
 // {| [AriaProperty]?: mixed |}
 type ARIAPropertyMap = {|
-  'aria-busy'?: mixed,
-  'aria-checked'?: mixed,
-  'aria-disabled'?: mixed,
-  'aria-expanded'?: mixed,
-  'aria-grabbed'?: mixed,
-  'aria-hidden'?: mixed,
-  'aria-invalid'?: mixed,
-  'aria-pressed'?: mixed,
-  'aria-selected'?: mixed,
   'aria-activedescendant'?: mixed,
   'aria-atomic'?: mixed,
   'aria-autocomplete'?: mixed,
+  'aria-braillelabel'?: mixed,
+  'aria-brailleroledescription'?: mixed,
+  'aria-busy'?: mixed,
+  'aria-checked'?: mixed,
   'aria-colcount'?: mixed,
   'aria-colindex'?: mixed,
   'aria-colspan'?: mixed,
   'aria-controls'?: mixed,
   'aria-current'?: ?ARIAPropertyCurrent,
   'aria-describedby'?: mixed,
+  'aria-description'?: mixed,
   'aria-details'?: mixed,
+  'aria-disabled'?: mixed,
   'aria-dropeffect'?: mixed,
   'aria-errormessage'?: mixed,
+  'aria-expanded'?: mixed,
   'aria-flowto'?: mixed,
+  'aria-grabbed'?: mixed,
   'aria-haspopup'?: mixed,
+  'aria-hidden'?: mixed,
+  'aria-invalid'?: mixed,
   'aria-keyshortcuts'?: mixed,
   'aria-label'?: mixed,
   'aria-labelledby'?: mixed,
@@ -290,13 +307,15 @@ type ARIAPropertyMap = {|
   'aria-owns'?: mixed,
   'aria-placeholder'?: mixed,
   'aria-posinset'?: mixed,
+  'aria-pressed'?: mixed,
   'aria-readonly'?: mixed,
   'aria-relevant'?: mixed,
   'aria-required'?: mixed,
   'aria-roledescription'?: mixed,
   'aria-rowcount'?: mixed,
   'aria-rowindex'?: mixed,
   'aria-rowspan'?: mixed,
+  'aria-selected'?: mixed,
   'aria-setsize'?: mixed,
   'aria-sort'?: mixed,
   'aria-valuemax'?: mixed,
@@ -305,7 +324,7 @@ type ARIAPropertyMap = {|
   'aria-valuetext'?: mixed,
 |};
 
-type ARIAPropertyDefinition = {
+type ARIAPropertyDefinition = {|
   type: 'string'
   | 'id'
   | 'idlist'
@@ -317,7 +336,7 @@ type ARIAPropertyDefinition = {
   | 'tristate',
   values?: Array<string | boolean>,
   allowundefined?: boolean,
-};
+|};
 
 type ARIAPropertyCurrent =
   'page'
@@ -330,31 +349,44 @@ type ARIAPropertyCurrent =
   | true
   | false;
 
-type ARIARoleRelation = {
+type ARIARoleRelation = {|
   module?: string,
   concept?: ARIARoleRelationConcept,
-};
+|};
 
 /* The concept in a related domain that informs behavior mappings.
  * Related domains include: HTML, "Device Independence Delivery Unit", XForms,
  * and ARIA to name a few. */
-type ARIARoleRelationConcept = {
+type ARIARoleRelationConcept = {|
   name: string,
   attributes?: Array<ARIARoleRelationConceptAttribute>,
   // These constraints are drawn from the mapping between ARIA and HTML:
   // https://www.w3.org/TR/html-aria
-  constraints?: Array<'direct descendant of document'
-    | 'direct descendant of ol, ul or menu'
+  constraints?: Array<
+    | 'scoped to the body element'
+    | 'scoped to the main element'
+    | 'scoped to a sectioning root element other than body'
+    | 'scoped to a sectioning content element'
+    | 'direct descendant of document'
+    | 'direct descendant of ol'
+    | 'direct descendant of ul'
+    | 'direct descendant of menu'
     | 'direct descendant of details element with the open attribute defined'
-    | 'descendant of table'>,
-};
+    | 'ancestor table element has table role'
+    | 'ancestor table element has grid role'
+    | 'ancestor table element has treegrid role'
+    | 'the progress bar is determinate'
+    | 'the datalist selection model allows multiple option elements to be selected at a time'
+    | 'the aria-controls attribute is set to the same value as the list attribute'
+    | 'the size attribute value is greater than 1'
+    | 'the multiple attribute value is greater than 1'
+    | 'the multiple attribute and the size attribute do not have a value greater than 1'
+    | 'the list attribute is not set'>,
+|};
 
-type ARIARoleRelationConceptAttribute = {
+type ARIARoleRelationConceptAttribute = {|
   name: string,
   value?: string | number,
   // These constraints are drawn from the mapping between ARIA and HTML:
   // https://www.w3.org/TR/html-aria
-  constraints?: Array<'undefined' // The attribute does not exist on the node: <a>
-    | 'set' // The attribute has a value: <a b="c">
-    | '>1'>,
-};
+|};