From f48bd03f6f01da82a8981a02793bc2b8ed3064b2 Mon Sep 17 00:00:00 2001 From: Scott O'Hara Date: Thu, 28 Mar 2024 12:49:14 -0400 Subject: [PATCH 01/41] add obsolete dir element the dir element is semantically equivalent to the UL element, and thus it should also map to role=list. As browsers have recently updated the rendering of this element to have visual consistency with the UL element / across browsers, then too, the mappings should update to match what is spec'd in HTML. --- html-aam/index.html | 52 +++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 52 insertions(+) diff --git a/html-aam/index.html b/html-aam/index.html index ee6158905..cbc1c9a48 100644 --- a/html-aam/index.html +++ b/html-aam/index.html @@ -1980,6 +1980,58 @@

`dialog`

+

`dir`

+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
HTML Specification + `dir` +
[[wai-aria-1.2]] + `list` role +
Computed Role
Use WAI-ARIA mapping
MSAA + IAccessible2 +
Use WAI-ARIA mapping
+
UIA +
Use WAI-ARIA mapping
+
ATK +
Use WAI-ARIA mapping
+
AX +
Use WAI-ARIA mapping
+
Comments + The `dir` element is marked as obsolete in HTML, and is not to be used by authors. +

`div`

From 29de20adbfb2ab5193e5cc7d1079ef9e4bb21d5d Mon Sep 17 00:00:00 2001 From: Clay Miller Date: Thu, 8 Aug 2024 12:34:35 -0400 Subject: [PATCH 02/41] Add 'class' and 'id' mappings --- html-aam/index.html | 16 ++++++++-------- 1 file changed, 8 insertions(+), 8 deletions(-) diff --git a/html-aam/index.html b/html-aam/index.html index 30d4a330a..c194dea73 100644 --- a/html-aam/index.html +++ b/html-aam/index.html @@ -9010,25 +9010,25 @@

`class`

MSAA + IAccessible2 @@ -11207,25 +11207,25 @@

`id`

MSAA + IAccessible2 From d18c43498ee3cefae0b07da5fdb78cdbb637832e Mon Sep 17 00:00:00 2001 From: Clay Miller Date: Thu, 15 Aug 2024 12:25:32 -0400 Subject: [PATCH 03/41] fix: Append '' to object attributes --- html-aam/index.html | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/html-aam/index.html b/html-aam/index.html index c194dea73..e3ff6cf26 100644 --- a/html-aam/index.html +++ b/html-aam/index.html @@ -9010,7 +9010,7 @@

`class`

MSAA + IAccessible2 @@ -9022,7 +9022,7 @@

`class`

@@ -11207,7 +11207,7 @@

`id`

MSAA + IAccessible2 @@ -11219,7 +11219,7 @@

`id`

From d9b8df6962f6b6fef790af12893129f057c66f1f Mon Sep 17 00:00:00 2001 From: Scott O'Hara Date: Mon, 19 Aug 2024 08:52:22 -0400 Subject: [PATCH 04/41] Apply suggestions from code review change `` to just ` marks per (most) other instances --- html-aam/index.html | 16 ++++++++-------- 1 file changed, 8 insertions(+), 8 deletions(-) diff --git a/html-aam/index.html b/html-aam/index.html index e3ff6cf26..8e376e7f0 100644 --- a/html-aam/index.html +++ b/html-aam/index.html @@ -9010,25 +9010,25 @@

`class`

MSAA + IAccessible2 @@ -11207,25 +11207,25 @@

`id`

MSAA + IAccessible2 From a1291060a88ca906179c478a5025474ddc682475 Mon Sep 17 00:00:00 2001 From: Melanie Sumner Date: Wed, 25 Sep 2024 15:02:55 -0500 Subject: [PATCH 05/41] Add prettier config file for monorepo --- .prettierrc | 3 +++ 1 file changed, 3 insertions(+) create mode 100644 .prettierrc diff --git a/.prettierrc b/.prettierrc new file mode 100644 index 000000000..a4ead5283 --- /dev/null +++ b/.prettierrc @@ -0,0 +1,3 @@ +{ + "printWidth": 200 +} \ No newline at end of file From 03599d6fc2ceb6dd81461ddcb5127809c4dce982 Mon Sep 17 00:00:00 2001 From: Daniel Date: Mon, 7 Oct 2024 15:08:08 +0200 Subject: [PATCH 06/41] Update core-aam changelog --- core-aam/index.html | 37 ++++++++++++++++++++++++++++++------- 1 file changed, 30 insertions(+), 7 deletions(-) diff --git a/core-aam/index.html b/core-aam/index.html index fa74f9282..743c31408 100644 --- a/core-aam/index.html +++ b/core-aam/index.html @@ -11074,9 +11074,38 @@

Security considerations

Change Log

-

Substantive changes since the last public working draft

+

Substantive changes since the last Candidate Recommendation Snapshot

    +
  • 4-Jan-2024: Fix: errant computed role for treegrid row
    • +
  • 31-Oct-2023: Update UIA aria-readonly mappings
    • +
  • 31-Oct-2023: Add aria-haspopup='grid' mappings
    • +
  • 31-Oct-2023: Correct AXAPI notifications
    • +
  • 26-Oct-2023: Remove UIA_DescribedBy property from aria-describedby UIA mappings
    • +
  • 12-Oct-2023: Make haspopup='true' mapping identical to haspopup='menu'
    • +
  • 1-Sep-2023: Fix AX API aria-haspopup mappings
    • +
  • 25-Aug-2023: Add map for `role=image` (synonym of `img`)
    • +
  • 17-Aug-2023: add normative expectations and examples for computedrole
    • +
  • 16-Aug-2023: Update mapping for aria-errormessage
    • +
  • 15-May-2023: Add computed role section and mappings
    • +
  • 8-May-2023: update UIA ins/del
    • +
  • 13-Apr-2023: Add mapping for aria-braillelabel and aria-brailleroledescription
    • +
  • 9-Apr-2023: Update annotation roles AXAPI mapping
    • +
  • 6-Apr-2023: Update aria-describedby and aria-description AXAPI
    • +
  • 6-Apr-2023: Update role='meter' subrole for AXAPI
    • +
  • 1-Feb-2023: remove AXAPI-specific 'menuitem in group' guidance
    • +
  • 1-Feb-2023: Update AXAPI mapping for aria-keyshortcuts
    • +
  • 1-Feb-2023: Update IA2 role='blockquote' map
    • +
  • 1-Feb-2023: Update MSAA mapping for paragraph and time and caption
    • + +
+
+
+

Substantive changes since the Core Accessibility API Mappings 1.1 Recommendation

+
    + +
  • 1-Nov-2022: draft privacy and security
    • +
  • 13-Oct-2022: fix: remove label and legend
  • 12-Oct-2022: Remove mappings for label and legend.
  • 05-Apr-2021: Update ATK mappings for aria-colindex, aria-colspan, aria-colcount, aria-rowindex, aria-rowspan, and @@ -11109,12 +11138,6 @@

    Substantive changes since the last public working draft

  • 05-Mar-2018: Add events for aria-label, aria-labelledby, and aria-describedby.
-
-

Substantive changes since the Core Accessibility API Mappings 1.1 Recommendation

-
    - -
-

Acknowledgments

From d8ae2626539d6fd110d5a28765bfbc4526d6932c Mon Sep 17 00:00:00 2001 From: daniel-montalvo Date: Mon, 7 Oct 2024 13:15:11 +0000 Subject: [PATCH 07/41] chore: prettier --- core-aam/index.html | 17 ++++++++--------- 1 file changed, 8 insertions(+), 9 deletions(-) diff --git a/core-aam/index.html b/core-aam/index.html index 743c31408..aabe75073 100644 --- a/core-aam/index.html +++ b/core-aam/index.html @@ -11077,27 +11077,26 @@

Change Log

Substantive changes since the last Candidate Recommendation Snapshot

    -
  • 4-Jan-2024: Fix: errant computed role for treegrid row
    • -
  • 31-Oct-2023: Update UIA aria-readonly mappings
    • -
  • 31-Oct-2023: Add aria-haspopup='grid' mappings
    • -
  • 31-Oct-2023: Correct AXAPI notifications
    • +
  • 4-Jan-2024: Fix: errant computed role for treegrid row
    • +
  • 31-Oct-2023: Update UIA aria-readonly mappings
    • +
  • 31-Oct-2023: Add aria-haspopup='grid' mappings
    • +
  • 31-Oct-2023: Correct AXAPI notifications
  • 26-Oct-2023: Remove UIA_DescribedBy property from aria-describedby UIA mappings
  • 12-Oct-2023: Make haspopup='true' mapping identical to haspopup='menu'
  • 1-Sep-2023: Fix AX API aria-haspopup mappings
  • 25-Aug-2023: Add map for `role=image` (synonym of `img`)
  • 17-Aug-2023: add normative expectations and examples for computedrole
  • 16-Aug-2023: Update mapping for aria-errormessage
    • -
  • 15-May-2023: Add computed role section and mappings
    • +
  • 15-May-2023: Add computed role section and mappings
  • 8-May-2023: update UIA ins/del
    • -
  • 13-Apr-2023: Add mapping for aria-braillelabel and aria-brailleroledescription
    • -
  • 9-Apr-2023: Update annotation roles AXAPI mapping
    • +
  • 13-Apr-2023: Add mapping for aria-braillelabel and aria-brailleroledescription
    • +
  • 9-Apr-2023: Update annotation roles AXAPI mapping
  • 6-Apr-2023: Update aria-describedby and aria-description AXAPI
  • 6-Apr-2023: Update role='meter' subrole for AXAPI
  • 1-Feb-2023: remove AXAPI-specific 'menuitem in group' guidance
  • 1-Feb-2023: Update AXAPI mapping for aria-keyshortcuts
  • 1-Feb-2023: Update IA2 role='blockquote' map
    • -
  • 1-Feb-2023: Update MSAA mapping for paragraph and time and caption
    • - +
  • 1-Feb-2023: Update MSAA mapping for paragraph and time and caption
From 977d20949710ddcde7b521fb5c399490c739fbcf Mon Sep 17 00:00:00 2001 From: Daniel Montalvo <49305434+daniel-montalvo@users.noreply.github.com> Date: Mon, 14 Oct 2024 18:17:20 +0200 Subject: [PATCH 08/41] Editorial: Handle PRs from forks (#2307) --- .github/workflows/prettier.yaml | 16 +++++++++++++--- 1 file changed, 13 insertions(+), 3 deletions(-) diff --git a/.github/workflows/prettier.yaml b/.github/workflows/prettier.yaml index 284800354..3836b3520 100644 --- a/.github/workflows/prettier.yaml +++ b/.github/workflows/prettier.yaml @@ -15,13 +15,23 @@ jobs: - name: Checkout uses: actions/checkout@v3 with: - # Make sure the actual branch is checked out when running on pull requests - ref: ${{ github.head_ref }} - # This is important to fetch the changes to the previous commit + ref: ${{github.event.pull_request.head.ref}} + repository: ${{github.event.pull_request.head.repo.full_name}} fetch-depth: 0 + - name: Check if PR is from a fork + id: check_fork + run: echo "::set-output name=is_fork::${{ github.event.pull_request.head.repo.fork }}" + - name: Prettify code + id: prettify uses: creyD/prettier_action@v4.3 with: + dry: true prettier_options: --write **/index.html --print-width 200 commit_message: "chore: prettier" + continue-on-error: true + + - name: Handle commit failure + if: ${{ steps.prettify.outcome == 'failure' && steps.check_fork.outputs.is_fork == 'true' }} + run: echo "Please run prettier locally" From c77c2c650d462693be1951798ccdd54cb55fdfca Mon Sep 17 00:00:00 2001 From: Daniel Montalvo <49305434+daniel-montalvo@users.noreply.github.com> Date: Mon, 14 Oct 2024 18:20:50 +0200 Subject: [PATCH 09/41] Editorial: Add ./github/labeler (#2321) --- .github/labeler.yml | 49 ++++++++++++++++++++++++++++++++++ .github/workflows/labeler.yaml | 15 +++++++++++ 2 files changed, 64 insertions(+) create mode 100644 .github/labeler.yml create mode 100644 .github/workflows/labeler.yaml diff --git a/.github/labeler.yml b/.github/labeler.yml new file mode 100644 index 000000000..9cab9f6c7 --- /dev/null +++ b/.github/labeler.yml @@ -0,0 +1,49 @@ +spec:aria: + - any: + - changed-files: + - 'index.html' + +spec:accname: + any: + - changed-files: + - 'accname/**/*' + +spec:core-aam: + - any: + - changed-files: + - 'core/aam/**/*' + +spec:dpub-aam: + - any: + - changed-files: + - 'dpub/aam/**/*' + +spec:dpub-aria: + - any: + - changed-files: + - 'dpub/aria/**/*' + +spec:graphics-aam: + - any: + - changed-files: + - 'graphics/aam/**/*' + +spec:graphics-aria: + - any: + - changed-files: + - 'graphics/aria/**/*' + +spec:html-aam: + - any: + - changed-files: + - 'html/aam/**/*' + +spec:svg-aam: + - any: + - changed-files: + - 'svg/aam/**/*' + +spec:mathml-aam: + - any: + - changed-files: + - 'mathml/aam/**/*' \ No newline at end of file diff --git a/.github/workflows/labeler.yaml b/.github/workflows/labeler.yaml new file mode 100644 index 000000000..c3f0462bd --- /dev/null +++ b/.github/workflows/labeler.yaml @@ -0,0 +1,15 @@ +name: "Pull Request Labeler" +on: +- pull_request_target + +jobs: + labeler: + permissions: + contents: read + pull-requests: write + runs-on: ubuntu-latest + steps: + - uses: actions/checkout@v4 # Uploads repository content to the runner + - uses: actions/labeler@v5 + with: + sync-labels: true From af82139d3dc4df97016c4d5cc44926a7a4e9f08a Mon Sep 17 00:00:00 2001 From: jnurthen Date: Fri, 18 Oct 2024 09:01:01 -0700 Subject: [PATCH 10/41] fix labeler --- .github/labeler.yml | 20 ++++++++++---------- 1 file changed, 10 insertions(+), 10 deletions(-) diff --git a/.github/labeler.yml b/.github/labeler.yml index 9cab9f6c7..7ea6d19ab 100644 --- a/.github/labeler.yml +++ b/.github/labeler.yml @@ -1,49 +1,49 @@ spec:aria: - any: - changed-files: - - 'index.html' + - any-glob-to-any-file: ['index.html'] spec:accname: any: - changed-files: - - 'accname/**/*' + - any-glob-to-any-file: ['accname/**'] spec:core-aam: - any: - changed-files: - - 'core/aam/**/*' + - any-glob-to-any-file: ['core-aam/**'] spec:dpub-aam: - any: - changed-files: - - 'dpub/aam/**/*' + - any-glob-to-any-file: ['dpub-aam/**'] spec:dpub-aria: - any: - changed-files: - - 'dpub/aria/**/*' + - any-glob-to-any-file: ['dpub-aria/**'] spec:graphics-aam: - any: - changed-files: - - 'graphics/aam/**/*' + - any-glob-to-any-file: ['graphics-aam/**'] spec:graphics-aria: - any: - changed-files: - - 'graphics/aria/**/*' + - any-glob-to-any-file: ['graphics-aria/**'] spec:html-aam: - any: - changed-files: - - 'html/aam/**/*' + - any-glob-to-any-file: ['html-aam/**'] spec:svg-aam: - any: - changed-files: - - 'svg/aam/**/*' + - any-glob-to-any-file: ['svg-aam/**'] spec:mathml-aam: - any: - changed-files: - - 'mathml/aam/**/*' \ No newline at end of file + - any-glob-to-any-file: ['mathml-aam/**'] \ No newline at end of file From 3bb8f6ffd3d1b11cc3a893037e5286ae7952b851 Mon Sep 17 00:00:00 2001 From: jnurthen Date: Fri, 18 Oct 2024 09:05:30 -0700 Subject: [PATCH 11/41] try again --- .github/labeler.yml | 20 ++++++++++---------- 1 file changed, 10 insertions(+), 10 deletions(-) diff --git a/.github/labeler.yml b/.github/labeler.yml index 7ea6d19ab..6e3411cef 100644 --- a/.github/labeler.yml +++ b/.github/labeler.yml @@ -1,49 +1,49 @@ spec:aria: - any: - changed-files: - - any-glob-to-any-file: ['index.html'] + - any-glob-to-any-file: 'index.html' spec:accname: any: - changed-files: - - any-glob-to-any-file: ['accname/**'] + - any-glob-to-any-file: 'accname/**' spec:core-aam: - any: - changed-files: - - any-glob-to-any-file: ['core-aam/**'] + - any-glob-to-any-file: 'core-aam/**' spec:dpub-aam: - any: - changed-files: - - any-glob-to-any-file: ['dpub-aam/**'] + - any-glob-to-any-file: 'dpub-aam/**' spec:dpub-aria: - any: - changed-files: - - any-glob-to-any-file: ['dpub-aria/**'] + - any-glob-to-any-file: 'dpub-aria/**' spec:graphics-aam: - any: - changed-files: - - any-glob-to-any-file: ['graphics-aam/**'] + - any-glob-to-any-file: 'graphics-aam/**' spec:graphics-aria: - any: - changed-files: - - any-glob-to-any-file: ['graphics-aria/**'] + - any-glob-to-any-file: 'graphics-aria/**' spec:html-aam: - any: - changed-files: - - any-glob-to-any-file: ['html-aam/**'] + - any-glob-to-any-file: 'html-aam/**' spec:svg-aam: - any: - changed-files: - - any-glob-to-any-file: ['svg-aam/**'] + - any-glob-to-any-file: 'svg-aam/**' spec:mathml-aam: - any: - changed-files: - - any-glob-to-any-file: ['mathml-aam/**'] \ No newline at end of file + - any-glob-to-any-file: 'mathml-aam/**' \ No newline at end of file From a175b70e1f2fe2e3b1477df20add066d3bfd38e5 Mon Sep 17 00:00:00 2001 From: James Craig Date: Fri, 18 Oct 2024 09:11:40 -0700 Subject: [PATCH 12/41] editorial: initial (mostly empty) PDF-AAM doc (#2356) --- .github/labeler.yml | 7 +- pdf-aam/.pr-preview.json | 4 + pdf-aam/README.md | 4 + pdf-aam/index.html | 355 +++++++++++++++++++++++++++++++++++++++ 4 files changed, 369 insertions(+), 1 deletion(-) create mode 100644 pdf-aam/.pr-preview.json create mode 100644 pdf-aam/README.md create mode 100644 pdf-aam/index.html diff --git a/.github/labeler.yml b/.github/labeler.yml index 9cab9f6c7..a89989416 100644 --- a/.github/labeler.yml +++ b/.github/labeler.yml @@ -46,4 +46,9 @@ spec:svg-aam: spec:mathml-aam: - any: - changed-files: - - 'mathml/aam/**/*' \ No newline at end of file + - 'mathml/aam/**/*' + +spec:pdf-aam: + - any: + - changed-files: + - 'pdf-aam/**' \ No newline at end of file diff --git a/pdf-aam/.pr-preview.json b/pdf-aam/.pr-preview.json new file mode 100644 index 000000000..a239968f5 --- /dev/null +++ b/pdf-aam/.pr-preview.json @@ -0,0 +1,4 @@ +{ + "src_file": "index.html", + "type": "respec" +} diff --git a/pdf-aam/README.md b/pdf-aam/README.md new file mode 100644 index 000000000..ff5c3997b --- /dev/null +++ b/pdf-aam/README.md @@ -0,0 +1,4 @@ + +# Specification 'pdf-aam' + +This is the repository for PDF Accessibility API Mappings (pdf-aam), which is part of the [ARIA suite](https://www.w3.org/WAI/ARIA/deliverables). General information about editing specifications is in the [main ARIA repository readme](https://github.com/w3c/aria/). diff --git a/pdf-aam/index.html b/pdf-aam/index.html new file mode 100644 index 000000000..677196834 --- /dev/null +++ b/pdf-aam/index.html @@ -0,0 +1,355 @@ + + + + PDF Accessibility API Mappings 1.0 + + + + + + + + + + + + + + + +
+

+ This document describes how [=user agents=] should expose semantics of PDF content to accessibility APIs. This helps users with disabilities to obtain and interact with information using assistive technologies. Documenting these mappings promotes interoperable exposure of + roles, states, properties, and events implemented by accessibility APIs and helps to ensure that this information appears in a manner consistent with author intent. +

+
+
+

+ The Accessible Rich Internet Applications Working Group seeks feedback on any aspect of the specification. When submitting feedback, please consider issues in the context of the companion + documents. To comment, file an issue in the W3C pdf-aam GitHub repository. If this is + not feasible, send email to public-aria@w3.org (comment archive). In-progress updates to the document may be viewed in the publicly visible editors' draft. +

+
+
+

Introduction

+

+ TBD. Some from Core-AAM. +

+
+

Accessibility APIs

+

TBD. Should we duplicate or cross-reference this content from the corresponding Core-AAM section?

+
+
+

Comparing Accessibility APIs

+

TBD. Should we duplicate or cross-reference this content from the corresponding Core-AAM section?

+
+
Accessible Names and Descriptions
+

TBD. Should we duplicate or cross-reference this content from the corresponding Core-AAM section?

+
+
+
+
+
+

RFC-2119 Keywords

+

+ RFC-2119 keywords are formatted in uppercase and contained in a strong element with class="rfc2119". When the keywords shown above are used, but do not share this format, they do not convey formal information in the RFC 2119 sense, and are merely explanatory, i.e., informative. As much as possible, such usages are avoided in this specification. +

+
+
+

Normative and Informative Sections

+

The indication whether a section is normative or non-normative (informative) applies to the entire section including sub-sections.

+

+ Informative sections provide information useful to understanding the specification. Such sections may contain examples of recommended practice, but it is not required to follow such recommendations in order to conform to this specification. +

+
+
+
+

Important Terms

+
+

TBD. Can we add only PDF-specific terms here and cross-reference the others from common dir?

+
+
term 1
+
+

+ definition 1 +

+
+
term 2
+
+

+ definition 2 +

+
+
+
+
+
+

Mapping WAI-ARIA to Accessibility APIs

+

TBD. Should we duplicate or cross-reference this content from the corresponding Core-AAM section?

+ + +
+

Role mapping

+

TBD. Should we duplicate or cross-reference this content from the corresponding Core-AAM section?

+ +
+

General rules

+

TBD. Should we duplicate or cross-reference this content from the corresponding Core-AAM section?

+
+ +
+

Role Mapping Tables

+

example

+
-
Not mapped
+
Object attributes: class
UIA -
Not mapped
+
Property: UIA_ClassNamePropertyId
ATK -
Not mapped
+
Object attributes: class
AX -
Not mapped
+
Property: AXDOMClassList
-
Not mapped
+
Object attributes: id
UIA -
Not mapped
+
Property: UIA_AutomationIdPropertyId
ATK -
Not mapped
+
Object attributes: id
AX -
Not mapped
+
Property: AXDOMIdentifier
-
Object attributes: class
+
Object attributes: class: <value>
ATK -
Object attributes: class
+
Object attributes: class: <value>
-
Object attributes: id
+
Object attributes: id: <value>
ATK -
Object attributes: id
+
Object attributes: id: <value>
-
Object attributes: class: <value>
+
Object attributes: `class: <value>`
UIA -
Property: UIA_ClassNamePropertyId
+
Property: `UIA_ClassNamePropertyId`
ATK -
Object attributes: class: <value>
+
Object attributes: `class: <value>`
AX -
Property: AXDOMClassList
+
Property: `AXDOMClassList`
-
Object attributes: id: <value>
+
Object attributes: `id: <value>`
UIA -
Property: UIA_AutomationIdPropertyId
+
Property: `UIA_AutomationIdPropertyId`
ATK -
Object attributes: id: <value>
+
Object attributes: `id: <value>`
AX -
Property: AXDOMIdentifier
+
Property: `AXDOMIdentifier`
+ + + + + + + + + + + + + + + + + + + + + + +
ARIA Specification + example +
MSAA + IAccessible2 + Role: ROLE_SYSTEM_EXAMPLE
+ +
UIA + Control Type: Example
+
ATK/AT-SPI + Role: ROLE_EXAMPLE
+
+ AX API[Note 1] + + AXRole: AXxample
+ AXSubrole:
+
+ + +
+

+ [Note 1] + Footnote content +

+
+ + + + +
+

State and Property Mapping

+

This section describes how to expose PDF states and [=ARIA/properties=].

+
+

General rules

+

TBD. Should we duplicate or cross-reference this content from the corresponding Core-AAM section?

+
+
+

State and Property Mapping Tables

+
+

Not Mapped

+

+ There are a number of occurrences in the table where a given state or property is declared "Not mapped". In some cases, this occurs for the default value of the state/property, and is equivalent to its absence. User agents might find it quicker to map the value than check to see if it is the default. For computational efficiency, user agents MAY expose the state or property value if doing so is equivalent to not mapping it. These cases are marked with an asterisk. +

+

+ In other cases, it is mandatory that the state/property not be mapped, since exposing it implies a related affordance. An example is + aria-grabbed. Its absence not only indicates that the accessible object is not grabbed, but further defines it as not grab-able. These cases are marked as "Not mapped" without an asterisk. +

+
+ +

aria-example=true

+ + + + + + + + + + + + + + + + + + + + + + + +
ARIA Specification + aria-example=true +
MSAA + IAccessible2 + Object Attribute: example: true
+
UIA + Property: example: true
+
ATK/AT-SPI + Object Attribute: example:true
+
AX API + Property: AXExample: YES
+
+ +
+
+
+

Special Processing Requiring Additional Computation

+

TBD. Should we duplicate or cross-reference this content from the corresponding Core-AAM section?

+
+
+

Actions

+

TBD. Should we duplicate or cross-reference this content from the corresponding Core-AAM section?

+ +
+ + +
+

Privacy considerations

+

TBD. Should we duplicate or cross-reference this content from the corresponding Core-AAM section?

+
+
+

Security considerations

+

This specification introduces no new security considerations.

+
+ +
+

Change Log

+

TBD. Should we duplicate or cross-reference this content from the corresponding Core-AAM section?

+
+
+

Acknowledgments

+

The following people contributed to the development of this document.

+
    + +
+
+
+
+ + From 35a7f30938b1946a41a92d82480ca91e0b611d27 Mon Sep 17 00:00:00 2001 From: Rahim Abdi Date: Thu, 24 Oct 2024 09:55:19 -0700 Subject: [PATCH 13/41] Editorial: Create documentation/aria-idl.md (#2340) Co-authored-by: Rahim Abdi Co-authored-by: Keith Cirkel --- documentation/aria-idl.md | 235 ++++++++++++++++++++++++++++++++++++++ 1 file changed, 235 insertions(+) create mode 100644 documentation/aria-idl.md diff --git a/documentation/aria-idl.md b/documentation/aria-idl.md new file mode 100644 index 000000000..64378e70a --- /dev/null +++ b/documentation/aria-idl.md @@ -0,0 +1,235 @@ +# ARIA IDL + +## IDL (Interface Definition Language) Overview +### What is IDL (Interface Definition Language)? +- IDL (Interface Definition Language) is broadly used to define object interfaces in computing. On the web, Web IDL is “used to describe interfaces that are intended to be implemented in web browsers” and “...provides a syntax for specifying the surface APIs of web platform objects, as well as JavaScript bindings that detail how those APIs manifest as JavaScript constructs.”([Web IDL Section 1. Introduction](https://webidl.spec.whatwg.org/#introduction)) +- Interfaces + - The HTML DOM API is a good example: all HTML elements (e.g., `