# @lwc/aria-reflection

> ARIA element reflection polyfill for strings

Latest version **9.4.3** (published 2026-09-02) · MIT license · 0 weekly downloads

## Install

```sh
npm install @lwc/aria-reflection
pnpm add @lwc/aria-reflection
yarn add @lwc/aria-reflection
bun add @lwc/aria-reflection
```

## Health

**Score 70/100 (B)** — status: active.

Positive: has types; esm support; no vulnerabilities; has provenance; recently updated; high maintenance score.

Warnings: low downloads.

## Facts

| | |
|---|---|
| Version | 9.4.3 |
| Published | 2026-09-02 |
| First published | 2022-12-08 |
| Weekly downloads | 0 |
| License | MIT |
| TypeScript types | bundled |
| Module format | ESM + CommonJS |
| Node | >=16.6.0 |
| Dependencies | 0 |
| Unpacked size | 19.4 KB |
| Known vulnerabilities | 0 |
| Install scripts | no |
| Provenance | attested (GitHub Actions) |
| GitHub stars | 1790 |
| Maintainers | lwc-admin, caridy, jye-sf, ravi.jayaramappa, jodarove, abdulsattar, rax-it1, lpomerleau |
| Keywords | aom, aria, lwc, polyfill, reflection |

## Links

- npm: https://www.npmjs.com/package/@lwc/aria-reflection
- Repository: https://github.com/salesforce/lwc
- Homepage: https://lwc.dev
- Issues: https://github.com/salesforce/lwc/issues
- npm.io page: https://npm.io/package/@lwc/aria-reflection

## Recent versions

- 9.4.3 (latest) — 2026-09-02
- 9.4.6-alpha.1 (canary) — 2026-09-22
- 9.3.10 (winter27) — 2026-09-21
- 9.1.5 (summer26) — 2026-04-28
- 8.25.1 (spring26) — 2025-11-19
- 8.20.6 (winter26) — 2025-10-20
- 8.16.5 (summer25) — 2025-05-05
- 8.10.3 (spring25) — 2025-01-09
- 7.1.5 (winter25) — 2024-10-10
- 7.0.1-alpha.0 (next) — 2024-06-21
- 6.4.5 (summer24) — 2024-06-05
- 5.0.10 (spring24) — 2024-03-20
- 3.0.4 (winter24) — 2023-10-02
- 2.40.2-lbc (lbc-avante-garde) — 2023-03-21
- 9.4.6-alpha.0 — 2026-09-11
- … 250 more at https://npm.io/package/@lwc/aria-reflection/versions

## README

# @lwc/aria-reflection

> **Note:** use this code at your own risk. It is optimized for backwards-compatibility, not
> as a forward-looking polyfill that keeps up to date with web standards.

Polyfill for [ARIA string reflection](https://wicg.github.io/aom/spec/aria-reflection.html) on Elements.
This is part of the [Accessibility Object Model](https://wicg.github.io/aom/explainer.html) (AOM).

For example:

```js
element.setAttribute('aria-pressed', 'true');
console.log(element.ariaPressed); // true
element.ariaPressed = false;
console.log(element.getAttribute('aria-pressed')); // false
```

Note that the attribute `aria-pressed` is reflected to the property `ariaPressed`, and vice versa.

## Usage

```shell
npm install @lwc/aria-reflection
```

```js
import '@lwc/aria-reflection';
```

The polyfill is applied globally to `Element.prototype` as soon as the module is imported.

## Implementation

The polyfill patches these [standard](https://w3c.github.io/aria/#ARIAMixin) property/attribute reflections:

| Property                     | Attribute                     |
| ---------------------------- | ----------------------------- |
| `ariaAtomic`                 | `aria-atomic`                 |
| `ariaAutoComplete`           | `aria-autocomplete`           |
| `ariaBrailleLabel`           | `aria-braillelabel`           |
| `ariaBrailleRoleDescription` | `aria-brailleroledescription` |
| `ariaBusy`                   | `aria-busy`                   |
| `ariaChecked`                | `aria-checked`                |
| `ariaColCount`               | `aria-colcount`               |
| `ariaColIndex`               | `aria-colindex`               |
| `ariaColIndexText`           | `aria-colindextext`           |
| `ariaColSpan`                | `aria-colspan`                |
| `ariaCurrent`                | `aria-current`                |
| `ariaDescription`            | `aria-description`            |
| `ariaDisabled`               | `aria-disabled`               |
| `ariaExpanded`               | `aria-expanded`               |
| `ariaHasPopup`               | `aria-haspopup`               |
| `ariaHidden`                 | `aria-hidden`                 |
| `ariaInvalid`                | `aria-invalid`                |
| `ariaKeyShortcuts`           | `aria-keyshortcuts`           |
| `ariaLabel`                  | `aria-label`                  |
| `ariaLevel`                  | `aria-level`                  |
| `ariaLive`                   | `aria-live`                   |
| `ariaModal`                  | `aria-modal`                  |
| `ariaMultiLine`              | `aria-multiline`              |
| `ariaMultiSelectable`        | `aria-multiselectable`        |
| `ariaOrientation`            | `aria-orientation`            |
| `ariaPlaceholder`            | `aria-placeholder`            |
| `ariaPosInSet`               | `aria-posinset`               |
| `ariaPressed`                | `aria-pressed`                |
| `ariaReadOnly`               | `aria-readonly`               |
| `ariaRelevant`               | `aria-relevant`               |
| `ariaRequired`               | `aria-required`               |
| `ariaRoleDescription`        | `aria-roledescription`        |
| `ariaRowCount`               | `aria-rowcount`               |
| `ariaRowIndex`               | `aria-rowindex`               |
| `ariaRowIndexText`           | `aria-rowindextext`           |
| `ariaRowSpan`                | `aria-rowspan`                |
| `ariaSelected`               | `aria-selected`               |
| `ariaSetSize`                | `aria-setsize`                |
| `ariaSort`                   | `aria-sort`                   |
| `ariaValueMax`               | `aria-valuemax`               |
| `ariaValueMin`               | `aria-valuemin`               |
| `ariaValueNow`               | `aria-valuenow`               |
| `ariaValueText`              | `aria-valuetext`              |
| `role`                       | `role`                        |

As well as these [non-standard](https://github.com/w3c/aria/issues/1732) reflections:

| Property               | Attribute               |
| ---------------------- | ----------------------- |
| `ariaActiveDescendant` | `aria-activedescendant` |
| `ariaControls`         | `aria-controls`         |
| `ariaDescribedBy`      | `aria-describedby`      |
| `ariaDetails`          | `aria-details`          |
| `ariaErrorMessage`     | `aria-errormessage`     |
| `ariaFlowTo`           | `aria-flowto`           |
| `ariaLabelledBy`       | `aria-labelledby`       |
| `ariaOwns`             | `aria-owns`             |

To determine which browsers support ARIA reflection, see the relevant [Web Platform Tests](https://web-platform-tests.org/) for [ARIA string reflection](https://wpt.fyi/results/custom-elements/reactions/AriaMixin-string-attributes.html?label=experimental&label=master&aligned) and [ARIA element reflection](https://wpt.fyi/results/custom-elements/reactions/AriaMixin-element-attributes.html?label=experimental&label=master&aligned).

---
_Source: https://npm.io/package/@lwc/aria-reflection · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._