View source for DPub AAM 1.0 Testable Statements

== Introduction ==
=== Assumptions about Testing DPub ARIA 1.0 Features ===
# For new, ''non-global'' properties: We need a test for each role that supports that new property.
#* Rationale: We cannot assume that user agents use our taxonomy programmatically in their implementations. Thus for non-global properties, there's an excellent chance t we won't get the implementation "for free"; instead, user agents will likely have to add new support on a per-role basis.
# For new, ''global'' properties: We just need to test one representative role, plus any role for which there is special/custom behavior related to that property.
#* Rationale: Global properties without role-specific special/custom behavior is something we ''can'' assume user agents will not be implementing on a per-role basis. Thus because the implementation itself is likely to be global, exhaustive testing is not needed.
# For new roles: We just need to test non-global properties supported on those roles.
#* Rationale: See rationales 1 and 2 above.

=== Overview ===
* The following testable statements are the tests needed for exiting DPub ARIA 1.0 Candidate Recommendation
* The format in use in this file is:

<pre>
=== UNIQUE NAME FOR THE TEST ===
* List documenting purpose of test

; // name of thing(s) being tested (can be used as name of test case)
&lt;pre&gt;
if given
  &lt;element&gt;some HTML fragment
  &lt;/element&gt;
then CONDITIONS FOR TEST
&lt;/pre&gt;
{| class="wikitable"
#### OPTIONAL
|-
|colspan=5|element ELEMENT_ID
|-
|colspan=5|attribute ELEMENT_ID:ATTR_NAME set "value"
|-
|colspan=5|attribute ELEMENT_ID:ATTR_OTHER_NAME clear
####
|-
|rowspan=NUMBER OF CONDITIONS|NAME OF API
|TEST CLASS
|TEST TYPE
|ASSERTION TYPE
|VALUE
... etc...
|}
</pre>

* "NAME OF API" is one of (MSAA, AXAPI, UIA, IAccessible2, or ATK)
* "TEST CLASS" is one of (property, result, event, or TBD (to be determined))
* "TEST TYPE" is dependent upon "TEST CLASS"
** PROPERTY then one of (name, description, childCount, role, subrole, parentID, relations, states, controlPatterns, interfaces, or objectAttributes)
** RESULT then an expression or method call (e.g., Selection.clear_selection())
** EVENT @@@TODO@@@
* ASSERTION TYPE is one of (is, isNot, contains, doesNotContain, isType, isAny)
* VALUE is the value or values to evaluate using ASSERTION TYPE.  If multiple values, enclose in brackets and separate with commas (e.g. [value1, value2, value3])

The TEST CLASS of ''event'' is special in that the each occurrence of the TEST TYPE ''type'' establishes a context for the next event rows in the table.  Each subsequent event row is an assertion about an event of the type referenced in that first special row.  That context continues until the end of the table, until a row that is NOT an ''event'' assertion, or until a row that is an event but with a TEST TYPE of ''type''.

There can be more than one element being tested in an assertion table. When there is, each group of assertions should begin with a row specifying that ID.

NOTE: All of these things are extensible.  The list of PROPERTY values, for example, will surely need to be expanded over time as additional platform ATTAs are implemented.

=== Example (Dont Generate) ===
When the selected item changes in a listbox, ATK/AT-SPI2 expects the following:

# object:selection-changed emitted by the listbox
# object:state-changed:selected, with detail1 = 0 emitted by the item(s) which became unselected
# object:state-changed:selected, with detail1 = 1 emitted by the item(s) which became selected

To test this, we could use the following markup and table:

<pre>
  &lt;div id="test" role="listbox" tabindex="0"&gt;
    &lt;div id="item1" role="option" aria-selected="true"&gt;First&lt;/div&gt;
    &lt;div id="item2" role="option" aria-selected="false"&gt;Second&lt;/div&gt;
  &lt;/div&gt;
</pre>

{| class="wikitable"
|colspan=5|attribute item1:aria-selected "false"
|-
|colspan=5|attribute item2:aria-selected "true"
|-
|colspan=5|element test
|-
|ATK
|event
|type
|is
|object:selection-changed
|-
|colspan=5|element item1
|-
|rowspan=3|ATK
|property
|states
|doesNotContain
|STATE_SELECTED
|-
|event
|type
|is
|object:state-changed:selected
|-
|event
|detail1
|is
|0
|-
|colspan=5|element item2
|-
|rowspan=3|ATK
|property
|states
|contains
|STATE_SELECTED
|-
|event
|type
|is
|object:state-changed:selected
|-
|event
|detail1
|is
|1
|-
|}

The first two rows in the above table specify that both ARIA properties should be changed before proceeding with the test assertions, i.e. as a single step. The rows that follow identify the element being tested, any expected changes to accessible properties, and the expected accessibility events that element should emit.

== DPub AAM 1.0 Roles ==

The following roles are defined DPub ARIA and have mappings in the AAM.


=== doc-abstract ===
<pre>
if given
  <div role="doc-abstract" id="test">Text</div>
then expose a role of doc-abstract for the element with id of test
</pre>
{| class="wikitable"
|-
|colspan=5|element test
|-
|rowspan=2|ATK
|property
|role
|is
|ROLE_SECTION
|-
|property
|objectAttributes
|contains
|xml-roles:doc-abstract
|-
|rowspan=3|AXAPI
|property
|AXRole
|is
|AXGroup
|-
|property
|AXSubrole
|is
|AXApplicationGroup
|-
|property
|AXRoleDescription
|is
|group
|-
|rowspan=2|IAccessible2
|property
|objectAttributes
|contains
|xml-roles:doc-abstract
|-
|property
|role
|is
|IA2_ROLE_SECTION
|-
|rowspan=2|UIA
|property
|ControlType
|is
|Text
|-
|property
|LocalizedControlType
|is
|abstract
|}

=== doc-acknowledgments ===
<pre>
if given
  <div role="doc-acknowledgments" id="test">Text</div>
then expose a role of doc-acknowledgments for the element with id of test
</pre>
{| class="wikitable"
|-
|colspan=5|element test
|-
|rowspan=2|ATK
|property
|role
|is
|ROLE_LANDMARK
|-
|property
|objectAttributes
|contains
|xml-roles:doc-acknowledgments
|-
|rowspan=3|AXAPI
|property
|AXRole
|is
|AXGroup
|-
|property
|AXSubrole
|is
|AXLandmarkRegion
|-
|property
|AXRoleDescription
|is
|region
|-
|rowspan=2|IAccessible2
|property
|objectAttributes
|contains
|xml-roles:doc-acknowledgments
|-
|property
|role
|is
|IA2_ROLE_LANDMARK
|-
|rowspan=4|UIA
|property
|ControlType
|is
|Text
|-
|property
|LocalizedControlType
|is
|acknowledgments
|-
|property
|landmarkType
|is
|Custom
|-
|property
|LocalizedLandmarkType
|is
|acknowledgments
|}

=== doc-afterword ===
<pre>
if given
  <div role="doc-afterword" id="test">Text</div>
then expose a role of doc-afterword for the element with id of test
</pre>
{| class="wikitable"
|-
|colspan=5|element test
|-
|rowspan=2|ATK
|property
|role
|is
|ROLE_LANDMARK
|-
|property
|objectAttributes
|contains
|xml-roles:doc-afterword
|-
|rowspan=3|AXAPI
|property
|AXRole
|is
|AXGroup
|-
|property
|AXSubrole
|is
|AXLandmarkRegion
|-
|property
|AXRoleDescription
|is
|region
|-
|rowspan=2|IAccessible2
|property
|objectAttributes
|contains
|xml-roles:doc-afterword
|-
|property
|role
|is
|IA2_ROLE_LANDMARK
|-
|rowspan=4|UIA
|property
|ControlType
|is
|Text
|-
|property
|LocalizedControlType
|is
|afterword
|-
|property
|landmarkType
|is
|Custom
|-
|property
|LocalizedLandmarkType
|is
|afterword
|}

=== doc-appendix ===
<pre>
if given
  <div role="doc-appendix" id="test">Text</div>
then expose a role of doc-appendix for the element with id of test
</pre>
{| class="wikitable"
|-
|colspan=5|element test
|-
|rowspan=2|ATK
|property
|role
|is
|ROLE_LANDMARK
|-
|property
|objectAttributes
|contains
|xml-roles:doc-appendix
|-
|rowspan=3|AXAPI
|property
|AXRole
|is
|AXGroup
|-
|property
|AXSubrole
|is
|AXLandmarkRegion
|-
|property
|AXRoleDescription
|is
|region
|-
|rowspan=2|IAccessible2
|property
|objectAttributes
|contains
|xml-roles:doc-appendix
|-
|property
|role
|is
|IA2_ROLE_LANDMARK
|-
|rowspan=4|UIA
|property
|ControlType
|is
|Text
|-
|property
|LocalizedControlType
|is
|appendix
|-
|property
|landmarkType
|is
|Custom
|-
|property
|LocalizedLandmarkType
|is
|appendix
|}

=== doc-backlink ===
<pre>
if given
  <div role="doc-backlink" id="test">
      <div id="child">child 1</div>
  </div>
then expose a role of doc-backlink for the element with id of test
</pre>
{| class="wikitable"
|-
|colspan=5|element test
|-
|rowspan=2|ATK
|property
|role
|is
|ROLE_LINK
|-
|property
|objectAttributes
|contains
|xml-roles:doc-backlink
|-
|rowspan=3|AXAPI
|property
|AXRole
|is
|AXLink
|-
|property
|AXSubrole
|is
|<nil>
|-
|property
|AXRoleDescription
|is
|link
|-
|rowspan=2|IAccessible2
|property
|objectAttributes
|contains
|xml-roles:doc-backlink
|-
|property
|interfaces
|contains
|IAccessibleHypertext2
|-
|rowspan=2|MSAA
|property
|role
|is
|ROLE_SYSTEM_LINK
|-
|property
|states
|contains
|STATE_LINKED
|-
|rowspan=2|UIA
|property
|ControlType
|is
|Text
|-
|property
|LocalizedControlType
|is
|backlink
|-
|colspan=5|element child
|-
|rowspan=1|MSAA
|property
|states
|contains
|STATE_LINKED
|-
|}

=== doc-biblioentry ===
<pre>
if given
  <div role="doc-biblioentry" id="test">Text</div>
then expose a role of doc-biblioentry for the element with id of test
</pre>
{| class="wikitable"
|-
|colspan=5|element test
|-
|rowspan=2|ATK
|property
|role
|is
|ROLE_LIST_ITEM
|-
|property
|objectAttributes
|contains
|xml-roles:doc-biblioentry
|-
|rowspan=3|AXAPI
|property
|AXRole
|is
|AXGroup
|-
|property
|AXSubrole
|is
|<nil>
|-
|property
|AXRoleDescription
|is
|group
|-
|rowspan=1|IAccessible2
|property
|objectAttributes
|contains
|xml-roles:doc-biblioentry
|-
|rowspan=2|MSAA
|property
|role
|is
|ROLE_SYSTEM_LISTITEM
|-
|property
|states
|contains
|STATE_SYSTEM_READONLY
|-
|rowspan=2|UIA
|property
|ControlType
|is
|Text
|-
|property
|LocalizedControlType
|is
|biblioentry
|}

=== doc-bibliography ===
<pre>
if given
  <div role="doc-bibliography" id="test">Text</div>
then expose a role of doc-bibliography for the element with id of test
</pre>
{| class="wikitable"
|-
|colspan=5|element test
|-
|rowspan=2|ATK
|property
|role
|is
|ROLE_LANDMARK
|-
|property
|objectAttributes
|contains
|xml-roles:doc-bibliography
|-
|rowspan=3|AXAPI
|property
|AXRole
|is
|AXGroup
|-
|property
|AXSubrole
|is
|AXLandmarkRegion
|-
|property
|AXRoleDescription
|is
|region
|-
|rowspan=2|IAccessible2
|property
|objectAttributes
|contains
|xml-roles:doc-bibliography
|-
|property
|role
|is
|IA2_ROLE_LANDMARK
|-
|rowspan=4|UIA
|property
|ControlType
|is
|Text
|-
|property
|LocalizedControlType
|is
|bibliography
|-
|property
|landmarkType
|is
|Custom
|-
|property
|LocalizedLandmarkType
|is
|bibliography
|}

=== doc-biblioref ===
<pre>
if given
  <div role="doc-biblioref" id="test">
      <div id="child">child 1</div>
  </div>
then expose a role of doc-biblioref for the element with id of test
</pre>
{| class="wikitable"
|-
|colspan=5|element test
|-
|rowspan=2|ATK
|property
|role
|is
|ROLE_LINK
|-
|property
|objectAttributes
|contains
|xml-roles:doc-biblioref
|-
|rowspan=3|AXAPI
|property
|AXRole
|is
|AXLink
|-
|property
|AXSubrole
|is
|<nil>
|-
|property
|AXRoleDescription
|is
|link
|-
|rowspan=2|IAccessible2
|property
|objectAttributes
|contains
|xml-roles:doc-biblioref
|-
|property
|interfaces
|contains
|IAccessibleHypertext2
|-
|rowspan=2|MSAA
|property
|role
|is
|ROLE_SYSTEM_LINK
|-
|property
|states
|contains
|STATE_LINKED
|-
|rowspan=2|UIA
|property
|ControlType
|is
|Text
|-
|property
|LocalizedControlType
|is
|biblioref
|-
|colspan=5|element child
|-
|rowspan=1|MSAA
|property
|states
|contains
|STATE_LINKED
|}

=== doc-chapter ===
<pre>
if given
  <div role="doc-chapter" id="test">Text</div>
then expose a role of doc-chapter for the element with id of test
</pre>
{| class="wikitable"
|-
|colspan=5|element test
|-
|rowspan=2|ATK
|property
|role
|is
|ROLE_LANDMARK
|-
|property
|objectAttributes
|contains
|xml-roles:doc-chapter
|-
|rowspan=3|AXAPI
|property
|AXRole
|is
|AXGroup
|-
|property
|AXSubrole
|is
|AXLandmarkRegion
|-
|property
|AXRoleDescription
|is
|region
|-
|rowspan=2|IAccessible2
|property
|objectAttributes
|contains
|xml-roles:doc-chapter
|-
|property
|role
|is
|IA2_ROLE_LANDMARK
|-
|rowspan=4|UIA
|property
|ControlType
|is
|Text
|-
|property
|LocalizedControlType
|is
|chapter
|-
|property
|landmarkType
|is
|Custom
|-
|property
|LocalizedLandmarkType
|is
|chapter
|}

=== doc-colophon ===
<pre>
if given
  <div role="doc-colophon" id="test">Text</div>
then expose a role of doc-colophon for the element with id of test
</pre>
{| class="wikitable"
|-
|colspan=5|element test
|-
|rowspan=2|ATK
|property
|role
|is
|ROLE_SECTION
|-
|property
|objectAttributes
|contains
|xml-roles:doc-colophon
|-
|rowspan=3|AXAPI
|property
|AXRole
|is
|AXGroup
|-
|property
|AXSubrole
|is
|AXApplicationGroup
|-
|property
|AXRoleDescription
|is
|group
|-
|rowspan=2|IAccessible2
|property
|objectAttributes
|contains
|xml-roles:doc-colophon
|-
|property
|role
|is
|IA2_ROLE_SECTION
|-
|rowspan=2|UIA
|property
|ControlType
|is
|Text
|-
|property
|LocalizedControlType
|is
|colophon
|-
|}

=== doc-conclusion ===
<pre>
if given
  <div role="doc-conclusion" id="test">Text</div>
then expose a role of doc-conclusion for the element with id of test
</pre>
{| class="wikitable"
|-
|colspan=5|element test
|-
|rowspan=2|ATK
|property
|role
|is
|ROLE_LANDMARK
|-
|property
|objectAttributes
|contains
|xml-roles:doc-conclusion
|-
|rowspan=3|AXAPI
|property
|AXRole
|is
|AXGroup
|-
|property
|AXSubrole
|is
|AXLandmarkRegion
|-
|property
|AXRoleDescription
|is
|region
|-
|rowspan=2|IAccessible2
|property
|objectAttributes
|contains
|xml-roles:doc-conclusion
|-
|property
|role
|is
|IA2_ROLE_LANDMARK
|-
|rowspan=4|UIA
|property
|ControlType
|is
|Text
|-
|property
|LocalizedControlType
|is
|conclusion
|-
|property
|landmarkType
|is
|Custom
|-
|property
|LocalizedLandmarkType
|is
|conclusion
|}

=== doc-cover ===
<pre>
if given
  <div role="doc-cover" id="test">Text</div>
then expose a role of doc-cover for the element with id of test
</pre>
{| class="wikitable"
|-
|colspan=5|element test
|-
|rowspan=2|ATK
|property
|role
|is
|ROLE_IMAGE
|-
|property
|objectAttributes
|contains
|xml-roles:doc-cover
|-
|rowspan=3|AXAPI
|property
|AXRole
|is
|AXImage
|-
|property
|AXSubrole
|is
|<nil>
|-
|property
|AXRoleDescription
|is
|image
|-
|rowspan=1|IAccessible2
|property
|objectAttributes
|contains
|xml-roles:doc-cover
|-
|rowspan=1|MSAA
|property
|role
|is
|ROLE_SYSTEM_GRAPHIC
|-
|rowspan=1|UIA
|property
|ControlType
|is
|Image
|-
|}

=== doc-credit ===
<pre>
if given
  <div role="doc-credit" id="test">Text</div>
then expose a role of doc-credit for the element with id of test
</pre>
{| class="wikitable"
|-
|colspan=5|element test
|-
|rowspan=2|ATK
|property
|role
|is
|ROLE_SECTION
|-
|property
|objectAttributes
|contains
|xml-roles:doc-credit
|-
|rowspan=3|AXAPI
|property
|AXRole
|is
|AXGroup
|-
|property
|AXSubrole
|is
|AXApplicationGroup
|-
|property
|AXRoleDescription
|is
|group
|-
|rowspan=2|IAccessible2
|property
|objectAttributes
|contains
|xml-roles:doc-credit
|-
|property
|role
|is
|IA2_ROLE_SECTION
|-
|rowspan=2|UIA
|property
|ControlType
|is
|Text
|-
|property
|LocalizedControlType
|is
|credit
|}

=== doc-credits ===
<pre>
if given
  <div role="doc-credits" id="test">Text</div>
then expose a role of doc-credits for the element with id of test
</pre>
{| class="wikitable"
|-
|colspan=5|element test
|-
|rowspan=2|ATK
|property
|role
|is
|ROLE_LANDMARK
|-
|property
|objectAttributes
|contains
|xml-roles:doc-credits
|-
|rowspan=3|AXAPI
|property
|AXRole
|is
|AXGroup
|-
|property
|AXSubrole
|is
|AXLandmarkRegion
|-
|property
|AXRoleDescription
|is
|region
|-
|rowspan=2|IAccessible2
|property
|objectAttributes
|contains
|xml-roles:doc-credits
|-
|property
|role
|is
|IA2_ROLE_LANDMARK
|-
|rowspan=4|UIA
|property
|ControlType
|is
|Text
|-
|property
|LocalizedControlType
|is
|credits
|-
|property
|landmarkType
|is
|Custom
|-
|property
|LocalizedLandmarkType
|is
|credits
|}

=== doc-dedication ===
<pre>
if given
  <div role="doc-dedication" id="test">Text</div>
then expose a role of doc-dedication for the element with id of test
</pre>
{| class="wikitable"
|-
|colspan=5|element test
|-
|rowspan=2|ATK
|property
|role
|is
|ROLE_SECTION
|-
|property
|objectAttributes
|contains
|xml-roles:doc-dedication
|-
|rowspan=3|AXAPI
|property
|AXRole
|is
|AXGroup
|-
|property
|AXSubrole
|is
|AXApplicationGroup
|-
|property
|AXRoleDescription
|is
|group
|-
|rowspan=2|IAccessible2
|property
|objectAttributes
|contains
|xml-roles:doc-dedication
|-
|property
|role
|is
|IA2_ROLE_SECTION
|-
|rowspan=2|UIA
|property
|ControlType
|is
|Text
|-
|property
|LocalizedControlType
|is
|dedication
|}

=== doc-endnote ===
<pre>
if given
  <div role="doc-endnote" id="test">Text</div>
then expose a role of doc-endnote for the element with id of test
</pre>
{| class="wikitable"
|-
|colspan=5|element test
|-
|rowspan=2|ATK
|property
|role
|is
|ROLE_LIST_ITEM
|-
|property
|objectAttributes
|contains
|xml-roles:doc-endnote
|-
|rowspan=3|AXAPI
|property
|AXRole
|is
|AXGroup
|-
|property
|AXSubrole
|is
|<nil>
|-
|property
|AXRoleDescription
|is
|group
|-
|rowspan=1|IAccessible2
|property
|objectAttributes
|contains
|xml-roles:doc-endnote
|-
|rowspan=2|MSAA
|property
|role
|is
|ROLE_SYSTEM_LISTITEM
|-
|property
|states
|contains
|STATE_SYSTEM_READONLY
|-
|rowspan=2|UIA
|property
|ControlType
|is
|Text
|-
|property
|LocalizedControlType
|is
|endnote
|}

=== doc-endnotes ===
<pre>
if given
  <div role="doc-endnotes" id="test">Text</div>
then expose a role of doc-endnotes for the element with id of test
</pre>
{| class="wikitable"
|-
|colspan=5|element test
|-
|rowspan=2|ATK
|property
|role
|is
|ROLE_LANDMARK
|-
|property
|objectAttributes
|contains
|xml-roles:doc-endnotes
|-
|rowspan=3|AXAPI
|property
|AXRole
|is
|AXGroup
|-
|property
|AXSubrole
|is
|AXLandmarkRegion
|-
|property
|AXRoleDescription
|is
|region
|-
|rowspan=2|IAccessible2
|property
|objectAttributes
|contains
|xml-roles:doc-endnotes
|-
|property
|role
|is
|IA2_ROLE_LANDMARK
|-
|rowspan=4|UIA
|property
|ControlType
|is
|Text
|-
|property
|LocalizedControlType
|is
|endnotes
|-
|property
|landmarkType
|is
|Custom
|-
|property
|LocalizedLandmarkType
|is
|endnotes
|}

=== doc-epigraph ===
<pre>
if given
  <div role="doc-epigraph" id="test">Text</div>
then expose a role of doc-epigraph for the element with id of test
</pre>
{| class="wikitable"
|-
|colspan=5|element test
|-
|rowspan=2|ATK
|property
|role
|is
|ROLE_SECTION
|-
|property
|objectAttributes
|contains
|xml-roles:doc-epigraph
|-
|rowspan=3|AXAPI
|property
|AXRole
|is
|AXGroup
|-
|property
|AXSubrole
|is
|AXApplicationGroup
|-
|property
|AXRoleDescription
|is
|group
|-
|rowspan=2|IAccessible2
|property
|objectAttributes
|contains
|xml-roles:doc-epigraph
|-
|property
|role
|is
|IA2_ROLE_SECTION
|-
|rowspan=2|UIA
|property
|ControlType
|is
|Text
|-
|property
|LocalizedControlType
|is
|epigraph
|}

=== doc-epilogue ===
<pre>
if given
  <div role="doc-epilogue" id="test">Text</div>
then expose a role of doc-epilogue for the element with id of test
</pre>
{| class="wikitable"
|-
|colspan=5|element test
|-
|rowspan=2|ATK
|property
|role
|is
|ROLE_LANDMARK
|-
|property
|objectAttributes
|contains
|xml-roles:doc-epilogue
|-
|rowspan=3|AXAPI
|property
|AXRole
|is
|AXGroup
|-
|property
|AXSubrole
|is
|AXLandmarkRegion
|-
|property
|AXRoleDescription
|is
|region
|-
|rowspan=2|IAccessible2
|property
|objectAttributes
|contains
|xml-roles:doc-epilogue
|-
|property
|role
|is
|IA2_ROLE_LANDMARK
|-
|rowspan=4|UIA
|property
|ControlType
|is
|Text
|-
|property
|LocalizedControlType
|is
|epilogue
|-
|property
|landmarkType
|is
|Custom
|-
|property
|LocalizedLandmarkType
|is
|epilogue
|}

=== doc-errata ===
<pre>
if given
  <div role="doc-errata" id="test">Text</div>
then expose a role of doc-errata for the element with id of test
</pre>
{| class="wikitable"
|-
|colspan=5|element test
|-
|rowspan=2|ATK
|property
|role
|is
|ROLE_LANDMARK
|-
|property
|objectAttributes
|contains
|xml-roles:doc-errata
|-
|rowspan=3|AXAPI
|property
|AXRole
|is
|AXGroup
|-
|property
|AXSubrole
|is
|AXLandmarkRegion
|-
|property
|AXRoleDescription
|is
|region
|-
|rowspan=2|IAccessible2
|property
|objectAttributes
|contains
|xml-roles:doc-errata
|-
|property
|role
|is
|IA2_ROLE_LANDMARK
|-
|rowspan=4|UIA
|property
|ControlType
|is
|Text
|-
|property
|LocalizedControlType
|is
|errata
|-
|property
|landmarkType
|is
|Custom
|-
|property
|LocalizedLandmarkType
|is
|errata
|}

=== doc-example ===
<pre>
if given
  <div role="doc-example" id="test">Text</div>
then expose a role of doc-example for the element with id of test
</pre>
{| class="wikitable"
|-
|colspan=5|element test
|-
|rowspan=2|ATK
|property
|role
|is
|ROLE_SECTION
|-
|property
|objectAttributes
|contains
|xml-roles:doc-example
|-
|rowspan=3|AXAPI
|property
|AXRole
|is
|AXGroup
|-
|property
|AXSubrole
|is
|AXApplicationGroup
|-
|property
|AXRoleDescription
|is
|group
|-
|rowspan=2|IAccessible2
|property
|objectAttributes
|contains
|xml-roles:doc-example
|-
|property
|role
|is
|IA2_ROLE_SECTION
|-
|rowspan=2|UIA
|property
|ControlType
|is
|Text
|-
|property
|LocalizedControlType
|is
|example
|}

=== doc-footnote ===
<pre>
if given
  <div role="doc-footnote" id="test">Text</div>
then expose a role of doc-footnote for the element with id of test
</pre>
{| class="wikitable"
|-
|colspan=5|element test
|-
|rowspan=2|ATK
|property
|role
|is
|ROLE_FOOTNOTE
|-
|property
|objectAttributes
|contains
|xml-roles:doc-footnote
|-
|rowspan=3|AXAPI
|property
|AXRole
|is
|AXGroup
|-
|property
|AXSubrole
|is
|AXApplicationGroup
|-
|property
|AXRoleDescription
|is
|group
|-
|rowspan=2|IAccessible2
|property
|objectAttributes
|contains
|xml-roles:doc-footnote
|-
|property
|role
|is
|IA2_ROLE_FOOTNOTE
|-
|rowspan=2|UIA
|property
|ControlType
|is
|Text
|-
|property
|LocalizedControlType
|is
|footnote
|-
|}

=== doc-foreword ===
<pre>
if given
  <div role="doc-foreword" id="test">Text</div>
then expose a role of doc-foreword for the element with id of test
</pre>
{| class="wikitable"
|-
|colspan=5|element test
|-
|rowspan=2|ATK
|property
|role
|is
|ROLE_LANDMARK
|-
|property
|objectAttributes
|contains
|xml-roles:doc-foreword
|-
|rowspan=3|AXAPI
|property
|AXRole
|is
|AXGroup
|-
|property
|AXSubrole
|is
|AXLandmarkRegion
|-
|property
|AXRoleDescription
|is
|region
|-
|rowspan=2|IAccessible2
|property
|objectAttributes
|contains
|xml-roles:doc-foreword
|-
|property
|role
|is
|IA2_ROLE_LANDMARK
|-
|rowspan=4|UIA
|property
|ControlType
|is
|Text
|-
|property
|LocalizedControlType
|is
|foreword
|-
|property
|landmarkType
|is
|Custom
|-
|property
|LocalizedLandmarkType
|is
|foreword
|}

=== doc-glossary ===
<pre>
if given
  <div role="doc-glossary" id="test">Text</div>
then expose a role of doc-glossary for the element with id of test
</pre>
{| class="wikitable"
|-
|colspan=5|element test
|-
|rowspan=2|ATK
|property
|role
|is
|ROLE_LANDMARK
|-
|property
|objectAttributes
|contains
|xml-roles:doc-glossary
|-
|rowspan=3|AXAPI
|property
|AXRole
|is
|AXGroup
|-
|property
|AXSubrole
|is
|AXLandmarkRegion
|-
|property
|AXRoleDescription
|is
|region
|-
|rowspan=2|IAccessible2
|property
|objectAttributes
|contains
|xml-roles:doc-glossary
|-
|property
|role
|is
|IA2_ROLE_LANDMARK
|-
|rowspan=4|UIA
|property
|ControlType
|is
|Text
|-
|property
|LocalizedControlType
|is
|glossary
|-
|property
|landmarkType
|is
|Custom
|-
|property
|LocalizedLandmarkType
|is
|glossary
|}

=== doc-glossref ===
<pre>
if given
  <div role="doc-glossref" id="test">
      <div id="child">child 1</div>
  </div>
then expose a role of doc-glossref for the element with id of test
</pre>
{| class="wikitable"
|-
|colspan=5|element test
|-
|rowspan=2|ATK
|property
|role
|is
|ROLE_LINK
|-
|property
|objectAttributes
|contains
|xml-roles:doc-glossref
|-
|rowspan=3|AXAPI
|property
|AXRole
|is
|AXLink
|-
|property
|AXSubrole
|is
|<nil>
|-
|property
|AXRoleDescription
|is
|link
|-
|rowspan=2|IAccessible2
|property
|objectAttributes
|contains
|xml-roles:doc-glossref
|-
|property
|interfaces
|contains
|IAccessibleHypertext2
|-
|rowspan=2|MSAA
|property
|role
|is
|ROLE_SYSTEM_LINK
|-
|property
|states
|contains
|STATE_LINKED
|-
|rowspan=2|UIA
|property
|ControlType
|is
|Text
|-
|property
|LocalizedControlType
|is
|glossref
|-
|colspan=5|element child
|-
|rowspan=1|MSAA
|property
|states
|contains
|STATE_LINKED
|}

=== doc-index ===
<pre>
if given
  <div role="doc-index" id="test">Text</div>
then expose a role of doc-index for the element with id of test
</pre>
{| class="wikitable"
|-
|colspan=5|element test
|-
|rowspan=2|ATK
|property
|role
|is
|ROLE_LANDMARK
|-
|property
|objectAttributes
|contains
|xml-roles:doc-index
|-
|rowspan=3|AXAPI
|property
|AXRole
|is
|AXGroup
|-
|property
|AXSubrole
|is
|AXLandmarkNavigation
|-
|property
|AXRoleDescription
|is
|navigation
|-
|rowspan=2|IAccessible2
|property
|objectAttributes
|contains
|xml-roles:doc-index
|-
|property
|role
|is
|IA2_ROLE_LANDMARK
|-
|rowspan=4|UIA
|property
|ControlType
|is
|Text
|-
|property
|LocalizedControlType
|is
|index
|-
|property
|landmarkType
|is
|Custom
|-
|property
|LocalizedLandmarkType
|is
|index
|}

=== doc-introduction ===
<pre>
if given
  <div role="doc-introduction" id="test">Text</div>
then expose a role of doc-introduction for the element with id of test
</pre>
{| class="wikitable"
|-
|colspan=5|element test
|-
|rowspan=2|ATK
|property
|role
|is
|ROLE_LANDMARK
|-
|property
|objectAttributes
|contains
|xml-roles:doc-introduction
|-
|rowspan=3|AXAPI
|property
|AXRole
|is
|AXGroup
|-
|property
|AXSubrole
|is
|AXLandmarkRegion
|-
|property
|AXRoleDescription
|is
|region
|-
|rowspan=2|IAccessible2
|property
|objectAttributes
|contains
|xml-roles:doc-introduction
|-
|property
|role
|is
|IA2_ROLE_LANDMARK
|-
|rowspan=4|UIA
|property
|ControlType
|is
|Text
|-
|property
|LocalizedControlType
|is
|introduction
|-
|property
|landmarkType
|is
|Custom
|-
|property
|LocalizedLandmarkType
|is
|introduction
|}

=== doc-noteref ===
<pre>
if given
  <div role="doc-noteref" id="test">
      <div id="child">child 1</div>
  </div>
then expose a role of doc-noteref for the element with id of test
</pre>
{| class="wikitable"
|-
|colspan=5|element test
|-
|rowspan=2|ATK
|property
|role
|is
|ROLE_LINK
|-
|property
|objectAttributes
|contains
|xml-roles:doc-noteref
|-
|rowspan=3|AXAPI
|property
|AXRole
|is
|AXLink
|-
|property
|AXSubrole
|is
|<nil>
|-
|property
|AXRoleDescription
|is
|link
|-
|rowspan=2|IAccessible2
|property
|objectAttributes
|contains
|xml-roles:doc-noteref
|-
|property
|interfaces
|contains
|IAccessibleHypertext2
|-
|rowspan=2|MSAA
|property
|role
|is
|ROLE_SYSTEM_LINK
|-
|property
|states
|contains
|STATE_LINKED
|-
|rowspan=2|UIA
|property
|ControlType
|is
|Text
|-
|property
|LocalizedControlType
|is
|noteref
|-
|colspan=5|element child
|-
|rowspan=1|MSAA
|property
|states
|contains
|STATE_LINKED
|}

=== doc-notice ===
<pre>
if given
  <div role="doc-notice" id="test">Text</div>
then expose a role of doc-notice for the element with id of test
</pre>
{| class="wikitable"
|-
|colspan=5|element test
|-
|rowspan=2|ATK
|property
|role
|is
|ROLE_COMMENT
|-
|property
|objectAttributes
|contains
|xml-roles:doc-notice
|-
|rowspan=3|AXAPI
|property
|AXRole
|is
|AXGroup
|-
|property
|AXSubrole
|is
|AXDocumentNote
|-
|property
|AXRoleDescription
|is
|note
|-
|rowspan=2|IAccessible2
|property
|objectAttributes
|contains
|xml-roles:doc-notice
|-
|property
|role
|is
|IA2_ROLE_NOTE
|-
|rowspan=2|UIA
|property
|ControlType
|is
|Text
|-
|property
|LocalizedControlType
|is
|notice
|-
|}

=== doc-pagebreak ===
<pre>
if given
  <div role="doc-pagebreak" id="test">Text</div>
then expose a role of doc-pagebreak for the element with id of test
</pre>
{| class="wikitable"
|-
|colspan=5|element test
|-
|rowspan=2|ATK
|property
|role
|is
|ROLE_SEPARATOR
|-
|property
|objectAttributes
|contains
|xml-roles:doc-pagebreak
|-
|rowspan=3|AXAPI
|property
|AXRole
|is
|AXSplitter
|-
|property
|AXSubrole
|is
|<nil>
|-
|property
|AXRoleDescription
|is
|splitter
|-
|rowspan=1|IAccessible2
|property
|objectAttributes
|contains
|xml-roles:doc-pagebreak
|-
|rowspan=1|MSAA
|property
|role
|is
|ROLE_SYSTEM_SEPARATOR
|-
|rowspan=2|UIA
|property
|ControlType
|is
|Text
|-
|property
|LocalizedControlType
|is
|pagebreak
|}

=== doc-pagelist ===
<pre>
if given
  <div role="doc-pagelist" id="test">Text</div>
then expose a role of doc-pagelist for the element with id of test
</pre>
{| class="wikitable"
|-
|colspan=5|element test
|-
|rowspan=2|ATK
|property
|role
|is
|ROLE_LANDMARK
|-
|property
|objectAttributes
|contains
|xml-roles:doc-pagelist
|-
|rowspan=3|AXAPI
|property
|AXRole
|is
|AXGroup
|-
|property
|AXSubrole
|is
|AXLandmarkNavigation
|-
|property
|AXRoleDescription
|is
|navigation
|-
|rowspan=2|IAccessible2
|property
|objectAttributes
|contains
|xml-roles:doc-pagelist
|-
|property
|role
|is
|IA2_ROLE_LANDMARK
|-
|rowspan=4|UIA
|property
|ControlType
|is
|Text
|-
|property
|LocalizedControlType
|is
|pagelist
|-
|property
|landmarkType
|is
|Custom
|-
|property
|LocalizedLandmarkType
|is
|pagelist
|}

=== doc-part ===
<pre>
if given
  <div role="doc-part" id="test">Text</div>
then expose a role of doc-part for the element with id of test
</pre>
{| class="wikitable"
|-
|colspan=5|element test
|-
|rowspan=2|ATK
|property
|role
|is
|ROLE_LANDMARK
|-
|property
|objectAttributes
|contains
|xml-roles:doc-part
|-
|rowspan=3|AXAPI
|property
|AXRole
|is
|AXGroup
|-
|property
|AXSubrole
|is
|AXLandmarkRegion
|-
|property
|AXRoleDescription
|is
|region
|-
|rowspan=2|IAccessible2
|property
|objectAttributes
|contains
|xml-roles:doc-part
|-
|property
|role
|is
|IA2_ROLE_LANDMARK
|-
|rowspan=4|UIA
|property
|ControlType
|is
|Text
|-
|property
|LocalizedControlType
|is
|part
|-
|property
|landmarkType
|is
|Custom
|-
|property
|LocalizedLandmarkType
|is
|part
|}

=== doc-preface ===
<pre>
if given
  <div role="doc-preface" id="test">Text</div>
then expose a role of doc-preface for the element with id of test
</pre>
{| class="wikitable"
|-
|colspan=5|element test
|-
|rowspan=2|ATK
|property
|role
|is
|ROLE_LANDMARK
|-
|property
|objectAttributes
|contains
|xml-roles:doc-preface
|-
|rowspan=3|AXAPI
|property
|AXRole
|is
|AXGroup
|-
|property
|AXSubrole
|is
|AXLandmarkRegion
|-
|property
|AXRoleDescription
|is
|region
|-
|rowspan=2|IAccessible2
|property
|objectAttributes
|contains
|xml-roles:doc-preface
|-
|property
|role
|is
|IA2_ROLE_LANDMARK
|-
|rowspan=4|UIA
|property
|ControlType
|is
|Text
|-
|property
|LocalizedControlType
|is
|preface
|-
|property
|landmarkType
|is
|Custom
|-
|property
|LocalizedLandmarkType
|is
|preface
|}

=== doc-prologue ===
<pre>
if given
  <div role="doc-prologue" id="test">Text</div>
then expose a role of doc-prologue for the element with id of test
</pre>
{| class="wikitable"
|-
|colspan=5|element test
|-
|rowspan=2|ATK
|property
|role
|is
|ROLE_LANDMARK
|-
|property
|objectAttributes
|contains
|xml-roles:doc-prologue
|-
|rowspan=3|AXAPI
|property
|AXRole
|is
|AXGroup
|-
|property
|AXSubrole
|is
|AXLandmarkRegion
|-
|property
|AXRoleDescription
|is
|region
|-
|rowspan=2|IAccessible2
|property
|objectAttributes
|contains
|xml-roles:doc-prologue
|-
|property
|role
|is
|IA2_ROLE_LANDMARK
|-
|rowspan=4|UIA
|property
|ControlType
|is
|Text
|-
|property
|LocalizedControlType
|is
|prologue
|-
|property
|landmarkType
|is
|Custom
|-
|property
|LocalizedLandmarkType
|is
|prologue
|}

=== doc-pullquote ===
<pre>
if given
  <div role="doc-pullquote" id="test">Text</div>
then expose a role of doc-pullquote for the element with id of test
</pre>
{| class="wikitable"
|-
|colspan=5|element test
|-
|rowspan=2|ATK
|property
|role
|is
|ROLE_SECTION
|-
|property
|objectAttributes
|contains
|xml-roles:doc-pullquote
|-
|rowspan=3|AXAPI
|property
|AXRole
|is
|AXGroup
|-
|property
|AXSubrole
|is
|AXApplicationGroup
|-
|property
|AXRoleDescription
|is
|group
|-
|rowspan=2|IAccessible2
|property
|objectAttributes
|contains
|xml-roles:doc-pullquote
|-
|property
|role
|is
|IA2_ROLE_SECTION
|-
|rowspan=2|UIA
|property
|ControlType
|is
|Text
|-
|property
|LocalizedControlType
|is
|pullquote
|}

=== doc-qna ===
<pre>
if given
  <div role="doc-qna" id="test">Text</div>
then expose a role of doc-qna for the element with id of test
</pre>
{| class="wikitable"
|-
|colspan=5|element test
|-
|rowspan=2|ATK
|property
|role
|is
|ROLE_SECTION
|-
|property
|objectAttributes
|contains
|xml-roles:doc-qna
|-
|rowspan=3|AXAPI
|property
|AXRole
|is
|AXGroup
|-
|property
|AXSubrole
|is
|AXApplicationGroup
|-
|property
|AXRoleDescription
|is
|group
|-
|rowspan=2|IAccessible2
|property
|objectAttributes
|contains
|xml-roles:doc-qna
|-
|property
|role
|is
|IA2_ROLE_SECTION
|-
|rowspan=2|UIA
|property
|ControlType
|is
|Text
|-
|property
|LocalizedControlType
|is
|qna
|}

=== doc-subtitle ===
<pre>
if given
  <div role="doc-subtitle" id="test">Text</div>
then expose a role of doc-subtitle for the element with id of test
</pre>
{| class="wikitable"
|-
|colspan=5|element test
|-
|rowspan=2|ATK
|property
|role
|is
|ROLE_HEADING
|-
|property
|objectAttributes
|contains
|xml-roles:doc-subtitle
|-
|rowspan=3|AXAPI
|property
|AXRole
|is
|AXHeading
|-
|property
|AXSubrole
|is
|<nil>
|-
|property
|AXRoleDescription
|is
|heading
|-
|rowspan=2|IAccessible2
|property
|objectAttributes
|contains
|xml-roles:doc-subtitle
|-
|property
|role
|is
|IA2_ROLE_HEADING
|-
|rowspan=2|UIA
|property
|ControlType
|is
|Text
|-
|property
|LocalizedControlType
|is
|subtitle
|-
|}

=== doc-tip ===
<pre>
if given
  <div role="doc-tip" id="test">Text</div>
then expose a role of doc-tip for the element with id of test
</pre>
{| class="wikitable"
|-
|colspan=5|element test
|-
|rowspan=2|ATK
|property
|role
|is
|ROLE_COMMENT
|-
|property
|objectAttributes
|contains
|xml-roles:doc-tip
|-
|rowspan=3|AXAPI
|property
|AXRole
|is
|AXGroup
|-
|property
|AXSubrole
|is
|AXDocumentNote
|-
|property
|AXRoleDescription
|is
|note
|-
|rowspan=2|IAccessible2
|property
|objectAttributes
|contains
|xml-roles:doc-tip
|-
|property
|role
|is
|IA2_ROLE_NOTE
|-
|rowspan=2|UIA
|property
|ControlType
|is
|Text
|-
|property
|LocalizedControlType
|is
|tip
|-
|}

=== doc-toc ===
<pre>
if given
  <div role="doc-toc" id="test">Text</div>
then expose a role of doc-toc for the element with id of test
</pre>
{| class="wikitable"
|-
|colspan=5|element test
|-
|rowspan=2|ATK
|property
|role
|is
|ROLE_LANDMARK
|-
|property
|objectAttributes
|contains
|xml-roles:doc-toc
|-
|rowspan=3|AXAPI
|property
|AXRole
|is
|AXGroup
|-
|property
|AXSubrole
|is
|AXLandmarkNavigation
|-
|property
|AXRoleDescription
|is
|navigation
|-
|rowspan=2|IAccessible2
|property
|objectAttributes
|contains
|xml-roles:doc-toc
|-
|property
|role
|is
|IA2_ROLE_LANDMARK
|-
|rowspan=4|UIA
|property
|ControlType
|is
|Text
|-
|property
|LocalizedControlType
|is
|toc
|-
|property
|landmarkType
|is
|Custom
|-
|property
|LocalizedLandmarkType
|is
|toc
|}