Merge pull request #273 from A11yance/html-accessibility-api-mappings-1dot0

Refreshing HTML mappings according to the HTML Accessibility API Mapping

Author: jessebeach

__tests__/src/AXObjectElementMap-test.js

@@ -2,28 +2,32 @@
  * @flow
  */
 
-type AXObjectModelDefinition = {
+
+
+type AXObjectModelDefinition = {|
   relatedConcepts: Array<AXObjectModelRelation>,
   type: 'window' | 'structure' | 'widget' | 'generic',
-};
+|};
 
-type AXObjectModelRelation = {
+type AXObjectModelRelation = {|
   module?: 'HTML' | 'ARIA',
   concept?: AXObjectModelRelationConcept,
-};
+|};
 
 /* The concept in a related domain that informs behavior mappings.
  * Related domains include: HTML and ARIA.
  */
-type AXObjectModelRelationConcept = {
+type AXObjectModelRelationConcept = {|
   name?: string,
   attributes?: Array<AXObjectModelRelationConceptAttribute>,
-};
+  constraints?: Array<
+  | 'scoped to a details element'>,
+|};
 
-type AXObjectModelRelationConceptAttribute = {
+type AXObjectModelRelationConceptAttribute = {|
   name: string,
   value?: string,
-};
+|};
 
 type AXObjectName = 
 'AbbrRole'
@@ -137,6 +141,7 @@ type AXObjectName =
 | 'TabListRole'
 | 'TabPanelRole'
 | 'TermRole'
+| 'TextAreaRole'
 | 'TextFieldRole'
 | 'TimeRole'
 | 'TimerRole'

__tests__/src/AXObjectRoleMap-test.js

@@ -390,6 +390,29 @@
       {
         "module": "HTML",
         "concept": {
+          "attributes": [
+            {
+              "name": "open",
+              "value": "open"
+            }
+          ],
+          "constraints": [
+            "scoped to a details element"
+          ],
+          "name": "summary"
+        }
+      },
+      {
+        "module": "HTML",
+        "concept": {
+          "attributes": [
+            {
+              "name": "aria-expanded"
+            }
+          ],
+          "constraints": [
+            "scoped to a details element"
+          ],
           "name": "summary"
         }
       }
@@ -1351,6 +1374,29 @@
       }
     ]
   },
+  "TextAreaRole": {
+    "type": "widget",
+    "relatedConcepts": [
+      {
+        "module": "ARIA",
+        "concept": {
+          "attributes": [
+            {
+              "name": "aria-multiline",
+              "value": "true"
+            }
+          ],
+          "name": "textbox"
+        }
+      },
+      {
+        "module": "HTML",
+        "concept": {
+          "name": "textarea"
+        }
+      }
+    ]
+  },
   "TextFieldRole": {
     "type": "widget",
     "relatedConcepts": [

__tests__/src/AXObjectsMap-test.js

@@ -114,6 +114,7 @@ import TableRole from './etc/objects/TableRole';
 import TabListRole from './etc/objects/TabListRole';
 import TabPanelRole from './etc/objects/TabPanelRole';
 import TermRole from './etc/objects/TermRole';
+import TextAreaRole from './etc/objects/TextAreaRole';
 import TextFieldRole from './etc/objects/TextFieldRole';
 import TimeRole from './etc/objects/TimeRole';
 import TimerRole from './etc/objects/TimerRole';
@@ -242,6 +243,7 @@ const AXObjects: TAXObjects = [
   ['TabListRole', TabListRole],
   ['TabPanelRole', TabPanelRole],
   ['TermRole', TermRole],
+  ['TextAreaRole', TextAreaRole],
   ['TextFieldRole', TextFieldRole],
   ['TimeRole', TimeRole],
   ['TimerRole', TimerRole],

__tests__/src/elementAXObjectMap-test.js

@@ -65,7 +65,9 @@ const elementAXObjectMap: TAXObjectQueryMap<
     }
   },
   get: function (key: AXObjectModelRelationConcept): ?Array<AXObjectName> {
-    const item = elementAXObjects.find(tuple => (deepEqual(key, tuple[0])) ? true : false);
+    const item = elementAXObjects.find(tuple => (
+      key.name === tuple[0].name && deepEqual(key.attributes, tuple[0].attributes)
+    ));
     return item && item[1];
   },
   has: function (key: AXObjectModelRelationConcept): boolean {

flow/axom.js

@@ -6,6 +6,29 @@ const DisclosureTriangleRole: AXObjectModelDefinition = {
     {
       module: 'HTML',
       concept: {
+        attributes: [
+          {
+            name: 'open',
+            value: 'open',
+          },
+        ],
+        constraints: [
+          'scoped to a details element',
+        ],
+        name: 'summary',
+      },
+    },
+    {
+      module: 'HTML',
+      concept: {
+        attributes: [
+          {
+            name: 'aria-expanded',
+          },
+        ],
+        constraints: [
+          'scoped to a details element',
+        ],
         name: 'summary',
       },
     },

scripts/axmodel.json

@@ -0,0 +1,28 @@
+/**
+ * @flow
+ */
+const TextAreaRole: AXObjectModelDefinition = {
+  relatedConcepts: [
+    {
+      module: 'ARIA',
+      concept: {
+        attributes: [
+          {
+            name: 'aria-multiline',
+            value: 'true',
+          },
+        ],
+        name: 'textbox',
+      },
+    },
+    {
+      module: 'HTML',
+      concept: {
+        name: 'textarea',
+      },
+    },
+  ],
+  type: 'widget',
+};
+
+export default TextAreaRole;