# w3c/aria-practices

WAI-ARIA Authoring Practices Guide (APG)

Repository: https://github.com/w3c/aria-practices
Canonical: https://ross.abutalabs.com/products/aria-practices
Homepage: https://www.w3.org/wai/aria/apg/
Language: HTML
License: NOASSERTION
License Family: other
Topics: aria, css, html
Last push: 2026-08-21T05:51:16+00:00

## Health v2 (maintenance only)
Score: 67/100 (v2, computed 2026-09-02T17:46:02.011165+00:00)
- activity 98, release rhythm 8, longevity 100
- inputs: {"age_days": 3800, "days_push": 12, "days_rel": null, "gap_med": null, "n_releases_24m": 0}
- flags: no_license
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 1345, forks 487 (observed 2026-08-28T04:04:27.288744+00:00)

## What it is
The W3C WAI-ARIA Authoring Practices Guide (APG), a guide and repository of design patterns and functional examples for building accessible web widgets using ARIA roles, states, properties, and keyboard support. It is maintained by the W3C ARIA Authoring Practices Task Force and published at w3.org/wai/aria/apg.

## Use cases
- learn how to make accessible web components with ARIA
- find keyboard interaction patterns for widgets like modals and tabs
- get example implementations of ARIA design patterns
- learn how to use ARIA landmarks and accessible names
- reference best practices for accessible web development

## When to choose
- you are building custom web widgets and need accessibility guidance with working examples
- you want authoritative, standards-based ARIA usage recommendations from W3C
- you need to train developers on accessible design patterns and keyboard support

## When to avoid
- you need a ready-made component library rather than guidance and examples
- you need normative specifications - the APG is informative, not a standard
- you need automated accessibility testing tools rather than authoring practices

## Facets
- artifact type: learning-resource
- maturity: active
- function: documentation, accessibility, ui-components
- domain: web-development, frontend, accessibility, documentation
- platform: browser
- tags: aria, wai-aria, wcag, design-patterns, assistive-technology, keyboard-navigation, w3c, web-standards, web, nodejs

## Member repositories
- w3c/aria-practices (main) score 67

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:04:27.288744+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-30T04:42:47.097270+00:00, confidence not recorded.
  - readme: https://github.com/w3c/aria-practices (fetched 2026-08-28T04:04:27.288744+00:00, sha 71b2659d1287)
  - homepage: https://www.w3.org/wai/aria/apg/ (fetched 2026-08-29T12:02:04.476772+00:00, sha 0c1aa7af3b8b)
  - site_page: https://www.w3.org/WAI/ARIA/apg/about (fetched 2026-08-29T12:02:04.486177+00:00, sha 970b8fc2bd10)
  - site_page: https://www.w3.org/WAI/standards-guidelines/wcag/docs (fetched 2026-08-29T12:02:04.488105+00:00, sha 02cadec46278)
  - site_page: https://www.w3.org/WAI/about/contacting (fetched 2026-08-29T12:02:04.491544+00:00, sha e98ad1bb04aa)
  - site_page: https://www.w3.org/WAI/about/support (fetched 2026-08-29T12:02:04.493351+00:00, sha e90e68c092ce)
  - site_page: https://www.w3.org/WAI/about/accessibility-statement (fetched 2026-08-29T12:02:04.495254+00:00, sha e9255bb1824f)
  - site_page: https://www.w3.org/WAI/about/using-wai-material (fetched 2026-08-29T12:02:04.496924+00:00, sha 4653a5310b51)
  - site_page: https://www.w3.org/WAI/ARIA/task-forces/practices (fetched 2026-08-29T12:02:04.489885+00:00, sha 261aaa79083c)
- Data as of 2026-08-30T08:39:29.467469+00:00.