diff --git a/.github/workflows/css-aam.yml b/.github/workflows/css-aam.yml new file mode 100644 index 000000000..2c4236296 --- /dev/null +++ b/.github/workflows/css-aam.yml @@ -0,0 +1,69 @@ +name: css-aam ED +on: + push: + branches: + - "main" + paths: + - "common/**" + - "css-aam/**" + workflow_dispatch: + +jobs: + dispatch: + runs-on: ubuntu-latest + steps: + - name: Dispatch to css-aam repo + run: | + curl -L -X POST \ + -H "Accept: application/vnd.github+json" \ + -H "Authorization: Bearer ${{secrets.W3CGRUNTBOT_TOKEN}}" \ + -H "X-GitHub-Api-Version: 2022-11-28" \ + https://api.github.com/repos/w3c/css-aam/actions/workflows/build-from-monorepo.yaml/dispatches \ + -d '{"ref":"gh-pages"}' + update-css-aam: + runs-on: ubuntu-latest + steps: + - name: Checkout monorepo + uses: actions/checkout@v5 + with: + ref: main + path: aria + sparse-checkout: | + css-aam + common + - name: Copy common + run: | + mkdir aria/css-aam/common + cp -r aria/common/** aria/css-aam/common/ + sed -i 's|\.\./common|common|g' aria/css-aam/index.html + - uses: w3c/spec-prod@v2 + with: + TOOLCHAIN: respec + SOURCE: aria/css-aam/index.html + DESTINATION: aria/css-aam/index.html + # W3C_ECHIDNA_TOKEN: ${{ secrets.ECHIDNA_TOKEN_pdf_aam }} + # W3C_WG_DECISION_URL: https://lists.w3.org/Archives/Public/public-aria-admin/2018Sep/0011.html + # W3C_BUILD_OVERRIDE: | + # specStatus: WD + ARTIFACT_NAME: css-aam + - name: Checkout css-aam repo + uses: actions/checkout@v5 + with: + repository: w3c/css-aam + ref: gh-pages + path: css-aam + token: ${{ secrets.W3CGRUNTBOT_TOKEN }} + - uses: actions/download-artifact@v4 + with: + name: css-aam + - name: Copy files + run: | + cp -r index.html css-aam/ + - name: Push new files to child repo + run: | + git config user.name "github-actions[bot]" + git config user.email "41898282+github-actions[bot]@users.noreply.github.com" + git add . + git commit -m "ED update" + git push origin gh-pages + working-directory: css-aam diff --git a/README.md b/README.md index 6e1959fdb..e106e49d8 100644 --- a/README.md +++ b/README.md @@ -18,6 +18,10 @@ This repository contains the main deliverable of the ARIA Working Group, Accessi * [Spec](core-aam/index.html) * [Editor's Draft](https://w3c.github.io/core-aam/) * [Issue Repository](https://github.com/w3c/core-aam) +* CSS Accessibility API Mappings (css-aam) + * [Spec](css-aam/index.html) + * [Editor's Draft](https://w3c.github.io/css-aam/) + * [Issue Repository](https://github.com/w3c/css-aam) * HTML Accessibility API Mappings (html-aam) * [Spec](html-aam/index.html) * [Editor's Draft](https://w3c.github.io/html-aam/) diff --git a/css-aam/.editorconfig b/css-aam/.editorconfig new file mode 100644 index 000000000..9c61627fa --- /dev/null +++ b/css-aam/.editorconfig @@ -0,0 +1,9 @@ +root = true + +[*] +charset = utf-8 +end_of_line = lf +indent_style = space +indent_size = 4 +insert_final_newline = true +trim_trailing_whitespace = true diff --git a/css-aam/README.md b/css-aam/README.md new file mode 100644 index 000000000..46697b1a9 --- /dev/null +++ b/css-aam/README.md @@ -0,0 +1,5 @@ +# CSS-AAM + +CSS Accessibility API Mappings (css-aam) developed by the [Accessible Rich Internet Applications Working Group](https://www.w3.org/WAI/ARIA/) (previously the [Web Applications Working Group](https://www.w3.org/2019/webapps/)). + +This specification was part of the [ARIA suite](https://www.w3.org/WAI/ARIA/deliverables). General information about editing the specification is in the [main ARIA repository readme](https://github.com/w3c/aria/). diff --git a/css-aam/biblio.js b/css-aam/biblio.js new file mode 100644 index 000000000..ccfbc2dac --- /dev/null +++ b/css-aam/biblio.js @@ -0,0 +1,48 @@ +respecConfig.localBiblio = { + ...respecConfig.localBiblio, + + // Correct reference for ATK + ATK: { + href: "https://gitlab.gnome.org/GNOME/at-spi2-core/", + title: "ATK - Accessibility Toolkit", + publisher: "The GNOME Project", + }, + "AT-SPI": { + href: "https://gitlab.gnome.org/GNOME/at-spi2-core/", + title: "Assistive Technology Service Provider Interface", + publisher: "The GNOME Project", + }, + // Custom reference for the Mac OSX Accessibility API + AXAPI: { + href: "https://developer.apple.com/library/mac/documentation/Cocoa/Reference/ApplicationKit/Protocols/NSAccessibility_Protocol/index.html", + title: "The Mac OS X Accessibility Protocol Mac OS 10.10", + publisher: "Apple Corporation", + }, + "EPUB-SSV": { + href: "http://www.idpf.org/epub/vocab/structure/", + title: "EPUB Structural Semantics Vocabulary", + publisher: "IDPF", + }, + // Custom reference for GTK+ (GNOME GUI Toolkit) (not available from SpecRef biblio) + GTK: { + href: "https://developer.gnome.org/gtk3/stable/", + title: "GTK+ 3 Reference Manual", + publisher: "The GNOME Project", + }, + MSAA: { + href: "https://msdn.microsoft.com/en-us/library/ms697707.aspx", + title: "Microsoft Active Accessibility (MSAA) 2.0", + publisher: "Microsoft Corporation", + }, + "UI-AUTOMATION": { + href: "https://msdn.microsoft.com/en-us/library/ee684009%28v=vs.85%29.aspx", + title: "UI Automation", + publisher: "Microsoft Corporation", + }, + // Custom reference for UIA Express (not available from SpecRef biblio). + "UIA-EXPRESS": { + href: "https://msdn.microsoft.com/en-us/library/windows/desktop/dd561898%28v=vs.85%29.aspx", + title: "The IAccessibleEx Interface", + publisher: "Microsoft Corporation", + }, +}; diff --git a/css-aam/index.html b/css-aam/index.html new file mode 100644 index 000000000..d65ff030d --- /dev/null +++ b/css-aam/index.html @@ -0,0 +1,169 @@ + + + + + CSS Accessibility API Mappings 1.0 + + + + + + + + +
+

+ CSS Accessibility API Mappings (CSS-AAM) defines how user agents map CSS [[CSS]] pseudo-elements and properties to + platform accessibility application programming interfaces (APIs). It + leverages and extends the [[[core-aam-1.2]]] and the [[[accname-1.2]]] for use with the CSS language. 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. +

+
+
+

+ This document is subject to change without notice. +

+

+ This document was initially developed by and with the approval of the CSS Accessibility Task Force, a collaboration of + the Accessible Platform Architectures Working Group, + ARIA Working Group, and the CSS Working Group. This document is now maintained + by the Accessible Rich Internet Applications Working Group. +

+
+
+

Introduction

+

This specification defines how CSS user agents respond to and expose [=role=], [=state=] and [=ARIA/property=] information provided for Web content.

+
+

Accessibility APIs

+

Accessibility APIs covered by this document are:

+ +

+ If user agent developers need to expose information using other accessibility APIs, it is recommended that they work closely with the developer of the + platform where the API runs, and assistive technology developers on that platform. +

+

+ For more information regarding accessibility APIs, refer to section 1.1 Accessibility APIs of the + [[[core-aam-1.2]]]. +

+
+
+
+

Normative sections provide requirements that user agents and assistive technologies MUST follow for an implementation to conform to this specification.

+

+ Non-normative (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. +

+
+

Deprecated

+

There are currently no deprecated requirements.

+
+
+
+

Mapping CSS to Accessibility APIs

+
+

General Rules for Exposing WAI-ARIA Semantics

+
+
+

CSS Property mappings

+
+
+

CSS Pseudo-element mappings

+
+
+

CSS Mapping pseudo-class selectors

+
+
+ +