From aad9b2177045df6d4ac7c6e7fdcd928051fc58d3 Mon Sep 17 00:00:00 2001 From: Rahim Abdi Date: Thu, 23 Jan 2025 19:52:28 -0800 Subject: [PATCH 01/37] Update common.css for state CSS rule (keyword), update aria-atomic IDL definition --- common/css/common.css | 4 ++-- index.html | 10 ++++++++-- 2 files changed, 10 insertions(+), 4 deletions(-) diff --git a/common/css/common.css b/common/css/common.css index 9dc5be9e1..04cd5cddb 100644 --- a/common/css/common.css +++ b/common/css/common.css @@ -99,10 +99,10 @@ caption{ margin:1em 0 0.1em; padding:0 0 0 0.3em; } -table.role-features th, table.role-features td, table.state-features th, table.state-features td, table.property-features th, table.property-features td, table.value-descriptions th, table.value-descriptions td { +table.role-features th, table.role-features td, table.state-features th, table.state-features td, table.property-features th, table.property-features td, table.value-descriptions th, table.value-descriptions td, table.state-descriptions th, table.state-descriptions td { min-width:20em; } -table.role-features tbody th, table.state-features tbody th, table.property-features tbody th, table.value-descriptions tbody th { +table.role-features tbody th, table.state-features tbody th, table.property-features tbody th, table.value-descriptions tbody th, table.state-descriptions tbody th { text-align: left !important; } th+th, td+td{ diff --git a/index.html b/index.html index 553ea7f0b..e5c550e49 100644 --- a/index.html +++ b/index.html @@ -10183,6 +10183,8 @@

Value

Value representing true, false, mixed, or undefined values. The default value for this value type is undefined unless otherwise specified.
true/false/undefined
Value representing true, false, or undefined (not applicable). The default value for this value type is undefined unless otherwise specified. For example, an element with aria-expanded set to false is not currently expanded; an element with aria-expanded set to undefined is not expandable.
+
enumerated
+
Values are limited to a predefined, finite set of states including two special states: missing value default and invalid value default.
ID reference
Reference to the ID of another element in the same document
ID reference list
@@ -10492,7 +10494,7 @@

Definitions of States and Properties (all aria-* attributes)

Value: - true/false + Enumerated @@ -10500,21 +10502,25 @@

Definitions of States and Properties (all aria-* attributes)

Values: - Value + Value (keyword) + State Description false + False Assistive technologies will present only the changed node or nodes. true + True Assistive technologies will present the entire changed region as a whole, including the author-defined label if one exists. +

The attribute's missing value default and invalid value default. are both the Missing state.

aria-autocomplete From 85b6f35e265450f3cff66363d101b827721fe2d5 Mon Sep 17 00:00:00 2001 From: Rahim Abdi Date: Thu, 23 Jan 2025 19:57:00 -0800 Subject: [PATCH 02/37] Minor typo fix for aria-atomic IDL --- index.html | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/index.html b/index.html index e5c550e49..13fe919de 100644 --- a/index.html +++ b/index.html @@ -10520,7 +10520,7 @@

Definitions of States and Properties (all aria-* attributes)

-

The attribute's missing value default and invalid value default. are both the Missing state.

+

The attribute's missing value default and invalid value default are both the Missing state.

aria-autocomplete From 0a417417cd8dd8cc01318b9f233f6af4914ecf8f Mon Sep 17 00:00:00 2001 From: Rahim Abdi Date: Thu, 23 Jan 2025 20:04:18 -0800 Subject: [PATCH 03/37] Update aria-autocomplete IDL --- index.html | 12 +++++++++--- 1 file changed, 9 insertions(+), 3 deletions(-) diff --git a/index.html b/index.html index 13fe919de..72254e471 100644 --- a/index.html +++ b/index.html @@ -10565,7 +10565,7 @@

Definitions of States and Properties (all aria-* attributes)

Value: - token + Enumerated @@ -10573,29 +10573,35 @@

Definitions of States and Properties (all aria-* attributes)

Values: - Value + Value (keyword) + State Description inline + Inline When a user is providing input, text suggesting one way to complete the provided input might be dynamically inserted after the caret. list + List When a user is providing input, an element containing a collection of values that could complete the provided input might be displayed. both + Both When a user is providing input, an element containing a collection of values that could complete the provided input might be displayed. If displayed, one value in the collection is automatically selected, and the text needed to complete the automatically selected value appears after the caret in the input. - none (default) + none + None When a user is providing input, an automatic suggestion that attempts to predict how the user intends to complete the input is not displayed. +

The attribute's missing value default and invalid value default are both the None state.

aria-braillelabel From 0d7c040f1c746dc9858c2c124d2059f1537fe314 Mon Sep 17 00:00:00 2001 From: Rahim Abdi Date: Thu, 23 Jan 2025 20:07:08 -0800 Subject: [PATCH 04/37] Update aria-busy IDL --- index.html | 10 +++++++--- 1 file changed, 7 insertions(+), 3 deletions(-) diff --git a/index.html b/index.html index 72254e471..771bd5782 100644 --- a/index.html +++ b/index.html @@ -10751,7 +10751,7 @@

Definitions of States and Properties (all aria-* attributes)

Value: - true/false + Enumerated @@ -10759,21 +10759,25 @@

Definitions of States and Properties (all aria-* attributes)

Values: - Value + Value (keyword) + State Description - false (default): + false: + False There are no expected updates for the element. true + True The element is being updated. +

The attribute's missing value default and invalid value default are both the False state.

aria-checked From bd3138aba5726a6432c1734c9616cf4e87ed0ae2 Mon Sep 17 00:00:00 2001 From: Rahim Abdi Date: Sun, 16 Feb 2025 19:52:52 -0800 Subject: [PATCH 05/37] aria-busy IDL updates --- index.html | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff --git a/index.html b/index.html index 771bd5782..8c0bfa013 100644 --- a/index.html +++ b/index.html @@ -10766,7 +10766,7 @@

Definitions of States and Properties (all aria-* attributes)

- false: + false, empty string (""): False There are no expected updates for the element. @@ -10778,6 +10778,7 @@

Definitions of States and Properties (all aria-* attributes)

The attribute's missing value default and invalid value default are both the False state.

+

For the purposes of reflection, the canonical keyword for the False state is the "false" keyword.

aria-checked From 2b7243d725fb5dc188ceca356bed57143c42a6e2 Mon Sep 17 00:00:00 2001 From: Rahim Abdi Date: Sun, 16 Feb 2025 19:56:42 -0800 Subject: [PATCH 06/37] aria-checked IDL updates --- index.html | 7 ++++++- 1 file changed, 6 insertions(+), 1 deletion(-) diff --git a/index.html b/index.html index 8c0bfa013..08af92684 100644 --- a/index.html +++ b/index.html @@ -10819,22 +10819,26 @@

Definitions of States and Properties (all aria-* attributes)

Values: - Value + Value (keyword) + State Description false + False The element supports being checked but is not currently checked. mixed + Mixed Indicates a mixed mode value for a tri-state checkbox or menuitemcheckbox. true + True The element is checked. @@ -10843,6 +10847,7 @@

Definitions of States and Properties (all aria-* attributes)

+

The attribute's missing value default and invalid value default are both the Undefined state.

aria-colcount From fe1875e93aaad8d466aac7724fc4605d8181651d Mon Sep 17 00:00:00 2001 From: Rahim Abdi Date: Sun, 16 Feb 2025 19:58:18 -0800 Subject: [PATCH 07/37] Add enumerated value type for aria-checked --- index.html | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/index.html b/index.html index 08af92684..c8b30dbb2 100644 --- a/index.html +++ b/index.html @@ -10811,7 +10811,7 @@

Definitions of States and Properties (all aria-* attributes)

Value: - tristate + Enumerated From 31e99c73fdf575f8f7743a3313b092ecae7efa40 Mon Sep 17 00:00:00 2001 From: Rahim Abdi Date: Sun, 16 Feb 2025 20:07:53 -0800 Subject: [PATCH 08/37] aria-current IDL updates --- index.html | 16 +++++++++++++--- 1 file changed, 13 insertions(+), 3 deletions(-) diff --git a/index.html b/index.html index c8b30dbb2..39acca5ec 100644 --- a/index.html +++ b/index.html @@ -11178,7 +11178,7 @@

Definitions of States and Properties (all aria-* attributes)

Value: - token + Enumerated @@ -11186,41 +11186,51 @@

Definitions of States and Properties (all aria-* attributes)

Values: - Value + Value (keyword) + State Description page + Page Represents the current page within a set of pages. step + Step Represents the current step within a process. location + Location Represents the current location within an environment or context. date + Date Represents the current date within a collection of dates. time + Time Represents the current time within a set of times. true + True Represents the current item within a set. - false (default) + false, undefined, empty string ("") + False Does not represent the current item within a set. +

The attribute's missing value default is the False state, and its invalid value default are both the True state.

+

For the purposes of reflection, the canonical keyword for the False state is the "false" keyword.

aria-describedby From f74d5f98b883f559bb1834f630e92fbde62df77d Mon Sep 17 00:00:00 2001 From: Rahim Abdi Date: Sun, 16 Feb 2025 20:13:24 -0800 Subject: [PATCH 09/37] aria-disabled IDL updates --- index.html | 11 ++++++++--- 1 file changed, 8 insertions(+), 3 deletions(-) diff --git a/index.html b/index.html index 39acca5ec..11997645b 100644 --- a/index.html +++ b/index.html @@ -11418,7 +11418,7 @@

Definitions of States and Properties (all aria-* attributes)

Value: - true/false + Enumerated @@ -11426,21 +11426,26 @@

Definitions of States and Properties (all aria-* attributes)

Values: - Value + Value (keyword) + State Description - false (default) + false, empty string ("") + False The element is enabled. true + True The element and all focusable descendants are disabled and its value cannot be changed by the user. +

The attribute's missing value default and invalid value default are both the False state.

+

For the purposes of reflection, the canonical keyword for the False state is the "false" keyword.

aria-dropeffect From 22d6af219cc63cd5f43254500152511d894b659f Mon Sep 17 00:00:00 2001 From: Rahim Abdi Date: Sun, 16 Feb 2025 20:15:41 -0800 Subject: [PATCH 10/37] aria-expanded IDL updates --- index.html | 8 ++++++-- 1 file changed, 6 insertions(+), 2 deletions(-) diff --git a/index.html b/index.html index 11997645b..010bbbee7 100644 --- a/index.html +++ b/index.html @@ -11597,7 +11597,7 @@

Definitions of States and Properties (all aria-* attributes)

Value: - true/false/undefined + Enumerated @@ -11605,17 +11605,20 @@

Definitions of States and Properties (all aria-* attributes)

Values: - Value + Value (keyword) + State Description false + False The grouping element this element controls or is the accessibility parent of is collapsed. true + True The grouping element this element controls or is the accessibility parent of is expanded. @@ -11624,6 +11627,7 @@

Definitions of States and Properties (all aria-* attributes)

+

The attribute's missing value default and invalid value default are both the Undefined state.

aria-flowto From 88ca55eaffc29f49b54146fdaa9368ba36634246 Mon Sep 17 00:00:00 2001 From: Rahim Abdi Date: Sun, 16 Feb 2025 20:19:42 -0800 Subject: [PATCH 11/37] aria-haspopup IDL updates --- index.html | 12 ++++++++++-- 1 file changed, 10 insertions(+), 2 deletions(-) diff --git a/index.html b/index.html index 010bbbee7..267de8d55 100644 --- a/index.html +++ b/index.html @@ -11766,7 +11766,7 @@

Definitions of States and Properties (all aria-* attributes)

Value: - token + Enumerated @@ -11774,7 +11774,8 @@

Definitions of States and Properties (all aria-* attributes)

Values: - Value + Value (keyword) + State Description @@ -11785,30 +11786,37 @@

Definitions of States and Properties (all aria-* attributes)

true + True Indicates the popup is a menu. menu + Menu Indicates the popup is a menu. listbox + Listbox Indicates the popup is a listbox. tree + Tree Indicates the popup is a tree. grid + Grid Indicates the popup is a grid. dialog + Dialog Indicates the popup is a dialog. +

The attribute's missing value default is the Undefined state, and its invalid value default is the Menu state.

aria-hidden From 58332fdde67c1ba89ae19d09b61a0c8f5edb0525 Mon Sep 17 00:00:00 2001 From: Rahim Abdi Date: Sun, 16 Feb 2025 20:25:32 -0800 Subject: [PATCH 12/37] aria-hidden IDL updates --- index.html | 17 +++++++++-------- 1 file changed, 9 insertions(+), 8 deletions(-) diff --git a/index.html b/index.html index 267de8d55..ac2623cd0 100644 --- a/index.html +++ b/index.html @@ -11852,7 +11852,7 @@

Definitions of States and Properties (all aria-* attributes)

Value: - true/false/undefined + Enumerated @@ -11860,25 +11860,26 @@

Definitions of States and Properties (all aria-* attributes)

Values: - Value + Value (keyword) + State Description - false - The element's [=element/hidden=] state is determined by the user agent based on whether it is rendered. Synonym of undefined. + false, undefined, empty string ("") + False + The element's [=element/hidden=] state is determined by the user agent based on whether it is rendered. true + True The element is [=element/hidden=] from the accessibility API. - - undefined (default) - The element's [=element/hidden=] state is determined by the user agent based on whether it is rendered. - +

The attribute's missing value default and invalid value default are both the Undefined state.

+

For the purposes of reflection, the canonical keyword for the Undefined state is the "undefined" keyword.

aria-invalid From 9d27c54f4f88f16723ccb954c6b99a17eb4d92db Mon Sep 17 00:00:00 2001 From: Rahim Abdi Date: Sun, 16 Feb 2025 20:27:06 -0800 Subject: [PATCH 13/37] Fix aria-hidden 'undefined' state --- index.html | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/index.html b/index.html index ac2623cd0..00cdd4845 100644 --- a/index.html +++ b/index.html @@ -11868,7 +11868,7 @@

Definitions of States and Properties (all aria-* attributes)

false, undefined, empty string ("") - False + Undefined The element's [=element/hidden=] state is determined by the user agent based on whether it is rendered. From 77967761d2d8a052136a593d03d683ba177b579c Mon Sep 17 00:00:00 2001 From: Rahim Abdi Date: Sun, 16 Feb 2025 20:30:20 -0800 Subject: [PATCH 14/37] aria-invalid IDL updates --- index.html | 13 ++++++++++--- 1 file changed, 10 insertions(+), 3 deletions(-) diff --git a/index.html b/index.html index 00cdd4845..4de2fe828 100644 --- a/index.html +++ b/index.html @@ -11913,7 +11913,7 @@

Definitions of States and Properties (all aria-* attributes)

Value: - token + Enumerated @@ -11921,29 +11921,36 @@

Definitions of States and Properties (all aria-* attributes)

Values: - Value + Value (keyword) + State Description grammar + Grammar A grammatical error was detected. - false (default) + false, empty string ("") + False There are no detected errors in the value. spelling + Spelling A spelling error was detected. true + True The value entered by the user has failed validation. +

The attribute's missing value default is the False state, and its invalid value default is the True state.

+

For the purposes of reflection, the canonical keyword for the False state is the "false" keyword.

aria-keyshortcuts From 5aaf29bc0b312b7e6a306e1168bcf90895ad277d Mon Sep 17 00:00:00 2001 From: Rahim Abdi Date: Sun, 16 Feb 2025 20:32:38 -0800 Subject: [PATCH 15/37] aria-live IDL updates --- index.html | 11 ++++++++--- 1 file changed, 8 insertions(+), 3 deletions(-) diff --git a/index.html b/index.html index 4de2fe828..ac0295510 100644 --- a/index.html +++ b/index.html @@ -12153,7 +12153,7 @@

Definitions of States and Properties (all aria-* attributes)

Value: - token + Enumerated @@ -12161,25 +12161,30 @@

Definitions of States and Properties (all aria-* attributes)

Values: - Value + Value (keyword) + State Description assertive + Assertive Indicates that updates to the region have the highest priority and should be presented the user immediately. - off (default) + off + Off Indicates that updates to the region should not be presented to the user unless the user is currently focused on that region. polite + Polite Indicates that updates to the region should be presented at the next graceful opportunity, such as at the end of speaking the current sentence or when the user pauses typing. +

The attribute's missing value default and invalid value default are both the Off state.

aria-modal From 7b8a97c9e491ee0d562d43013a09077562ac5e4d Mon Sep 17 00:00:00 2001 From: Rahim Abdi Date: Sun, 16 Feb 2025 20:35:09 -0800 Subject: [PATCH 16/37] aria-modal IDL updates --- index.html | 11 ++++++++--- 1 file changed, 8 insertions(+), 3 deletions(-) diff --git a/index.html b/index.html index ac0295510..99b0fd302 100644 --- a/index.html +++ b/index.html @@ -12217,7 +12217,7 @@

Definitions of States and Properties (all aria-* attributes)

Value: - true/false + Enumerated @@ -12225,21 +12225,26 @@

Definitions of States and Properties (all aria-* attributes)

Values: - Value + Value (keyword) + State Description - false (default) + false, empty string ("") + False Element is not modal. true + True Element is modal. +

The attribute's missing value default and invalid value default are both the False state.

+

For the purposes of reflection, the canonical keyword for the False state is the "false" keyword.

aria-multiline From bd504f7da8e225133542f91f5f638271dd602033 Mon Sep 17 00:00:00 2001 From: Rahim Abdi Date: Sun, 16 Feb 2025 20:37:29 -0800 Subject: [PATCH 17/37] aria-multiline IDL updates --- index.html | 11 ++++++++--- 1 file changed, 8 insertions(+), 3 deletions(-) diff --git a/index.html b/index.html index 99b0fd302..a276cb232 100644 --- a/index.html +++ b/index.html @@ -12276,7 +12276,7 @@

Definitions of States and Properties (all aria-* attributes)

Value: - true/false + Enumerated @@ -12284,21 +12284,26 @@

Definitions of States and Properties (all aria-* attributes)

Values: - Value + Value (keyword) + State Description - false (default) + false, empty string ("") + False This is a single-line text box. true + True This is a multi-line text box. +

The attribute's missing value default and invalid value default are both the False state.

+

For the purposes of reflection, the canonical keyword for the False state is the "false" keyword.

aria-multiselectable From 1dafb680991a1e16173a65fb53f2ea7150579bf4 Mon Sep 17 00:00:00 2001 From: Rahim Abdi Date: Sun, 16 Feb 2025 20:39:22 -0800 Subject: [PATCH 18/37] aria-multiselectable IDL updates --- index.html | 11 ++++++++--- 1 file changed, 8 insertions(+), 3 deletions(-) diff --git a/index.html b/index.html index a276cb232..7723e1e68 100644 --- a/index.html +++ b/index.html @@ -12335,7 +12335,7 @@

Definitions of States and Properties (all aria-* attributes)

Value: - true/false + Enumerated @@ -12343,21 +12343,26 @@

Definitions of States and Properties (all aria-* attributes)

Values: - Value + Value (keyword) + State Description - false (default) + false, empty string ("") + False Only one item can be selected. true + True More than one item in the widget can be selected at a time. +

The attribute's missing value default and invalid value default are both the False state.

+

For the purposes of reflection, the canonical keyword for the False state is the "false" keyword.

aria-orientation From e6f4a9a9950d4e9755cc7cbde64d7e097e568a50 Mon Sep 17 00:00:00 2001 From: Rahim Abdi Date: Sun, 16 Feb 2025 20:42:43 -0800 Subject: [PATCH 19/37] aria-orientation IDL updates --- index.html | 12 +++++++++--- 1 file changed, 9 insertions(+), 3 deletions(-) diff --git a/index.html b/index.html index 7723e1e68..87a353474 100644 --- a/index.html +++ b/index.html @@ -12393,7 +12393,7 @@

Definitions of States and Properties (all aria-* attributes)

Value: - token + Enumerated @@ -12401,25 +12401,31 @@

Definitions of States and Properties (all aria-* attributes)

Values: - Value + Value (keyword) + State Description horizontal + Horizontal The element is oriented horizontally. - undefined (default) + undefined, empty string ("") + Undefined The element's orientation is unknown/ambiguous. vertical + Vertical The element is oriented vertically. +

The attribute's missing value default and invalid value default are both the Undefined state.

+

For the purposes of reflection, the canonical keyword for the Undefined state is the "undefined" keyword.

aria-owns From ee86d41cdc66cb650a2f206886d064afaa8c6a2f Mon Sep 17 00:00:00 2001 From: Rahim Abdi Date: Sun, 16 Feb 2025 20:45:49 -0800 Subject: [PATCH 20/37] aria-pressed IDL updates --- index.html | 13 ++++++++++--- 1 file changed, 10 insertions(+), 3 deletions(-) diff --git a/index.html b/index.html index 87a353474..d7fa644f3 100644 --- a/index.html +++ b/index.html @@ -12585,7 +12585,7 @@

Definitions of States and Properties (all aria-* attributes)

Value: - tristate + Enumerated @@ -12593,30 +12593,37 @@

Definitions of States and Properties (all aria-* attributes)

Values: - Value + Value (keyword) + State Description false + False The element supports being pressed but is not currently pressed. mixed + Mixed Indicates a mixed mode value for a tri-state toggle button. true + True The element is pressed. - undefined (default) + undefined, empty string ("") + Undefined The element does not support being pressed. +

The attribute's missing value default and invalid value default are both the Undefined state.

+

For the purposes of reflection, the canonical keyword for the Undefined state is the "undefined" keyword.

aria-readonly From c3a62a9dd70a52ede0d2bce3c6981a20feb0a4f1 Mon Sep 17 00:00:00 2001 From: Rahim Abdi Date: Sun, 16 Feb 2025 20:49:39 -0800 Subject: [PATCH 21/37] aria-readonly IDL updates --- index.html | 11 ++++++++--- 1 file changed, 8 insertions(+), 3 deletions(-) diff --git a/index.html b/index.html index d7fa644f3..5f0983ab9 100644 --- a/index.html +++ b/index.html @@ -12660,7 +12660,7 @@

Definitions of States and Properties (all aria-* attributes)

Value: - true/false + Enumerated @@ -12668,21 +12668,26 @@

Definitions of States and Properties (all aria-* attributes)

Values: - Value + Value (keyword) + State Description - false (default) + false, empty string ("") + False The user can set the value of the element. true + True The user cannot change the value of the element. +

The attribute's missing value default and invalid value default are both the False state.

+
aria-relevant From 46794d333037f8fd3e3897f59bfd45f3e3c2de35 Mon Sep 17 00:00:00 2001 From: Rahim Abdi Date: Sun, 16 Feb 2025 20:50:54 -0800 Subject: [PATCH 22/37] add aria-readonly canonical keyword --- index.html | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/index.html b/index.html index 5f0983ab9..057889aa7 100644 --- a/index.html +++ b/index.html @@ -12687,7 +12687,7 @@

Definitions of States and Properties (all aria-* attributes)

The attribute's missing value default and invalid value default are both the False state.

- +

For the purposes of reflection, the canonical keyword for the False state is the "false" keyword.

aria-relevant From c4de6cf41111ad4428f32980de9bd778ee069f21 Mon Sep 17 00:00:00 2001 From: Rahim Abdi Date: Sun, 16 Feb 2025 20:53:17 -0800 Subject: [PATCH 23/37] aria-required IDL updates --- index.html | 11 ++++++++--- 1 file changed, 8 insertions(+), 3 deletions(-) diff --git a/index.html b/index.html index 057889aa7..a1fce9368 100644 --- a/index.html +++ b/index.html @@ -12791,7 +12791,7 @@

Definitions of States and Properties (all aria-* attributes)

Value: - true/false + Enumerated @@ -12799,21 +12799,26 @@

Definitions of States and Properties (all aria-* attributes)

Values: - Value + Value (keyword) + State Description - false (default) + false, empty string ("") + False User input is not necessary to submit the form. true + True Users need to provide input on an element before a form is submitted. +

The attribute's missing value default and invalid value default are both the False state.

+

For the purposes of reflection, the canonical keyword for the False state is the "false" keyword.

aria-roledescription From 9eb97d12c9f7ad9c23fa3c75217df89276826b99 Mon Sep 17 00:00:00 2001 From: Rahim Abdi Date: Sun, 16 Feb 2025 20:57:55 -0800 Subject: [PATCH 24/37] aria-selected IDL updates --- index.html | 14 ++++++++++---- 1 file changed, 10 insertions(+), 4 deletions(-) diff --git a/index.html b/index.html index a1fce9368..d61999584 100644 --- a/index.html +++ b/index.html @@ -13146,7 +13146,7 @@

Definitions of States and Properties (all aria-* attributes)

Value: - true/false/undefined + Enumerated @@ -13154,25 +13154,31 @@

Definitions of States and Properties (all aria-* attributes)

Values: - Value + Value (keyword) + State Description - false + false, empty string ("") + False The selectable element is not selected. true + True The selectable element is selected. - undefined (default) + undefined + Undefined The element is not selectable. +

The attribute's missing value default and invalid value default are both the Undefined state.

+

For the purposes of reflection, the canonical keyword for the Undefined state is the "undefined" keyword.

aria-setsize From 9c07517de6eb60e7710e88affe7095fb0089f03c Mon Sep 17 00:00:00 2001 From: Rahim Abdi Date: Sun, 16 Feb 2025 21:00:00 -0800 Subject: [PATCH 25/37] aria-sort IDL updates --- index.html | 12 +++++++++--- 1 file changed, 9 insertions(+), 3 deletions(-) diff --git a/index.html b/index.html index d61999584..ff2e82d26 100644 --- a/index.html +++ b/index.html @@ -13262,7 +13262,7 @@

Definitions of States and Properties (all aria-* attributes)

Value: - token + Enumerated @@ -13270,29 +13270,35 @@

Definitions of States and Properties (all aria-* attributes)

Values: - Value + Value (keyword) + State Description ascending + Ascending Items are sorted in ascending order. descending + Descending Items are sorted in descending order. - none (default) + none + None There is no defined sort applied. other + Other A sort algorithm other than ascending or descending has been applied. +

The attribute's missing value default and invalid value default are both the None state.

aria-valuemax From e2c125669e5939bfbe251b3a238472b0b9ead8b4 Mon Sep 17 00:00:00 2001 From: Rahim Abdi Date: Sun, 16 Feb 2025 21:09:22 -0800 Subject: [PATCH 26/37] Update Section 12.A 'Mapping WAI-ARIA Value types to languages' --- index.html | 17 +---------------- 1 file changed, 1 insertion(+), 16 deletions(-) diff --git a/index.html b/index.html index ff2e82d26..d1086a007 100644 --- a/index.html +++ b/index.html @@ -14033,21 +14033,6 @@

Mapping WAI-ARIA Value types to languages

HTML XML Schema - - true/false - Keyword and enumerated attributes with allowed values of "true" and "false" - boolean - - - true/false/undefined - Keyword and enumerated attributes with allowed values of true, false, and undefined - NMTOKEN with an enumeration constraint allowing values of true, false, and undefined - - - tristate - Keyword and enumerated attributes with allowed values of "true", "false", and "mixed" - NMTOKEN with an enumeration constraint allowing values of "true", "false", and "mixed" - number Floating-point numbers @@ -14059,7 +14044,7 @@

Mapping WAI-ARIA Value types to languages

integer - token + enumerated Keyword and enumerated attributes NMTOKEN with an enumeration constraint allowing values listed in the state or property definition From 3883b65cf78788fa9b43e466742dd44867c8b948 Mon Sep 17 00:00:00 2001 From: Rahim Abdi Date: Sun, 16 Feb 2025 21:11:29 -0800 Subject: [PATCH 27/37] Remove 12.A note on 'The suggested mappings for true/false values in HTML...' --- index.html | 1 - 1 file changed, 1 deletion(-) diff --git a/index.html b/index.html index d1086a007..78c827be4 100644 --- a/index.html +++ b/index.html @@ -14024,7 +14024,6 @@

Privacy Considerations

Mapping WAI-ARIA Value types to languages

The HTML column of the table below is advisory. Guidance on use of WAI-ARIA state and properties in HTML is provided in Document conformance requirements for use of ARIA attributes in HTML ([[HTML-ARIA]]).

-

The suggested mappings for true/false values in HTML use Keyword and enumerated attributes with allowed values of true and false, instead of using the HTML boolean value type.

The table below provides recommended mappings between WAI-ARIA state and property types and attribute types from [[[HTML]]] and [[[XMLSCHEMA11-2]]].

Languages not listed below might have appropriate value types defined in the language. If they do not, we recommend XML Schema Datatypes for general purpose XML languages. Documents using DTDs instead of schemas will not be able to validate automatically and require additional processing on WAI-ARIA attributes.

From 2de68de5d7b24e1a73bb63571cb441621ee349c5 Mon Sep 17 00:00:00 2001 From: Rahim Abdi Date: Sun, 16 Feb 2025 21:14:52 -0800 Subject: [PATCH 28/37] Update 'Indicates' definition to remove references to true/false, true/false/undefined, etc. --- index.html | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/index.html b/index.html index 78c827be4..165ae4f0b 100644 --- a/index.html +++ b/index.html @@ -343,7 +343,7 @@

Important Terms

Indicates
-

Used in an attribute description to denote that the value type is a named token or otherwise token-like, including the Boolean-like true/false, true/false/undefined, tristate (true/false/mixed), a single named token, or a token list.

+

Used in an attribute description to denote that the value type is a named token or otherwise token-like, including a single named token or a token list.

Related Terms: Defines, Identifies

Keyboard Accessible
From da118e9f7f0adf8b8110727193ca00ccdc0cc00b Mon Sep 17 00:00:00 2001 From: Rahim Abdi Date: Sun, 16 Feb 2025 21:16:33 -0800 Subject: [PATCH 29/37] Update section 6.2.4 'Value' to remove references to true/false, true/false/undefined, tristate --- index.html | 6 ------ 1 file changed, 6 deletions(-) diff --git a/index.html b/index.html index 165ae4f0b..50f6bfa03 100644 --- a/index.html +++ b/index.html @@ -10177,12 +10177,6 @@

Inherits into Roles

Value

Value type of the state or [=ARIA/property=]. The value is one of the following types:

-
true/false
-
Value representing either true or false. The default value for this value type is false unless otherwise specified.
-
tristate
-
Value representing true, false, mixed, or undefined values. The default value for this value type is undefined unless otherwise specified.
-
true/false/undefined
-
Value representing true, false, or undefined (not applicable). The default value for this value type is undefined unless otherwise specified. For example, an element with aria-expanded set to false is not currently expanded; an element with aria-expanded set to undefined is not expandable.
enumerated
Values are limited to a predefined, finite set of states including two special states: missing value default and invalid value default.
ID reference
From 860a2e6ce3246afb4a085f4a4cf9eaa20f0dd87d Mon Sep 17 00:00:00 2001 From: Rahim Abdi Date: Sun, 16 Feb 2025 21:28:32 -0800 Subject: [PATCH 30/37] Remove obsolete note in '6.3.4 ARIA nullable DOMString Attributes' --- index.html | 3 --- 1 file changed, 3 deletions(-) diff --git a/index.html b/index.html index 50f6bfa03..7bcdd0916 100644 --- a/index.html +++ b/index.html @@ -10229,9 +10229,6 @@

ARIA nullable DOMString Attributes

otherwise, the IDL attribute must get the value in a transparent, case-preserving manner. On setting, if the new value is null, the content attribute must be removed, and otherwise, the content attribute must be set to the specified new value in a transparent, case-preserving manner.

-

- Note: As of ARIA 1.2, all ARIA attributes exposed via IDL are defined as nullable {{DOMString}}s. This matches the current implementation of all major rendering engines. This specification change should result in no implementation changes; it will merely represent the current reality of web engines. - However, in a future draft, the ARIA Working Group intends to change several ARIA attributes to non-nullable DOMStrings, and seek implementations. The proposed change will bring ARIA into alignment with the HTML’s usage of enumerated attributes.

Example Attribute Usage

IDL reflection of ARIA attributes

-

All ARIA attributes reflect in IDL as [=nullable type|nullable=] {{DOMString}} attributes. - This includes the boolean-like true/false type, and all other ARIA attributes.

+

ARIA attributes may reflect as several IDL attribute types such as [=nullable type|nullable=] {{DOMString}} attributes, [=nullable type|nullable=] {{FrozenArray}} attributes or [=nullable type|nullable=] {{Element}} attributes.

Default values from the ARIA values tables MUST NOT reflect to IDL as the missing value default or the invalid value default for the attribute. From 21bfc5e3659c0e427a8f109f8630ad6024062994 Mon Sep 17 00:00:00 2001 From: Rahim Abdi Date: Sun, 16 Feb 2025 21:40:26 -0800 Subject: [PATCH 32/37] More updates to '6.3.2 IDL reflection of ARIA attributes' removing requirement to not reflect missing/invalid value default --- index.html | 5 ----- 1 file changed, 5 deletions(-) diff --git a/index.html b/index.html index daa5d452a..340accb37 100644 --- a/index.html +++ b/index.html @@ -10208,11 +10208,6 @@

Multi-value Attribute Values

IDL reflection of ARIA attributes

ARIA attributes may reflect as several IDL attribute types such as [=nullable type|nullable=] {{DOMString}} attributes, [=nullable type|nullable=] {{FrozenArray}} attributes or [=nullable type|nullable=] {{Element}} attributes. -

Default values from the ARIA values tables MUST NOT reflect to IDL as the - missing value default or the - invalid value default for the attribute. - On getting, a missing ARIA attribute will return null. ARIA attributes are not validated on get. - If an ARIA value is invalid, on getting, it will return its set value as a literal string, and will not return an invalid value default.

Operating System Accessibility API mapping of multi-value ARIA attributes

From 9eedd0aae389636153573c802c0f5bb7422e75bb Mon Sep 17 00:00:00 2001 From: Rahim Abdi Date: Sun, 16 Feb 2025 21:59:09 -0800 Subject: [PATCH 33/37] Undo previous change --- index.html | 5 +++++ 1 file changed, 5 insertions(+) diff --git a/index.html b/index.html index 340accb37..daa5d452a 100644 --- a/index.html +++ b/index.html @@ -10208,6 +10208,11 @@

Multi-value Attribute Values

IDL reflection of ARIA attributes

ARIA attributes may reflect as several IDL attribute types such as [=nullable type|nullable=] {{DOMString}} attributes, [=nullable type|nullable=] {{FrozenArray}} attributes or [=nullable type|nullable=] {{Element}} attributes. +

Default values from the ARIA values tables MUST NOT reflect to IDL as the + missing value default or the + invalid value default for the attribute. + On getting, a missing ARIA attribute will return null. ARIA attributes are not validated on get. + If an ARIA value is invalid, on getting, it will return its set value as a literal string, and will not return an invalid value default.

Operating System Accessibility API mapping of multi-value ARIA attributes

From dc940583103885d9e452c452e2fd0bc3ca342e8c Mon Sep 17 00:00:00 2001 From: Rahim Abdi Date: Sun, 16 Feb 2025 22:20:42 -0800 Subject: [PATCH 34/37] More updates to 6.3 --- index.html | 15 +++++---------- 1 file changed, 5 insertions(+), 10 deletions(-) diff --git a/index.html b/index.html index daa5d452a..c708314dc 100644 --- a/index.html +++ b/index.html @@ -10200,18 +10200,17 @@

Value

ARIA Attributes

-

Multi-value Attribute Values

+

Enumerated Attribute Values

When the ARIA attribute definition includes a table listing the attribute's allowed values, - that attribute is a multi-value nullable attribute. - Each value in the table is a keyword for the attribute, mapping to a state of the same name.

+ it is an [=enumerated attribute=]. Each value in the table is a keyword for the attribute, mapping to a state of the same name and one or more keywords may map to the same state.

IDL reflection of ARIA attributes

ARIA attributes may reflect as several IDL attribute types such as [=nullable type|nullable=] {{DOMString}} attributes, [=nullable type|nullable=] {{FrozenArray}} attributes or [=nullable type|nullable=] {{Element}} attributes. -

Default values from the ARIA values tables MUST NOT reflect to IDL as the +

For non-enumerated attributes, default values from the ARIA values tables MUST NOT reflect to IDL as the missing value default or the invalid value default for the attribute. - On getting, a missing ARIA attribute will return null. ARIA attributes are not validated on get. + On getting (a non-enumerated attribute), a missing ARIA attribute will return null as such ARIA attributes are not validated on get. If an ARIA value is invalid, on getting, it will return its set value as a literal string, and will not return an invalid value default.

@@ -10223,11 +10222,7 @@

Operating System Accessibility API mapping of multi-value ARIA attributes

ARIA nullable DOMString Attributes

As noted in [[[#typemapping]]], attributes are included in host languages, and the syntax for representation of WAI-ARIA types is governed by the host language.

-

The following algorithm should be used for ARIA nullable {{DOMString}} attributes in HTML:

-

On getting, if the corresponding content attribute is not present, then the IDL attribute must return null, - otherwise, the IDL attribute must get the value in a transparent, case-preserving manner. - On setting, if the new value is null, the content attribute must be removed, and otherwise, - the content attribute must be set to the specified new value in a transparent, case-preserving manner.

+

ARIA attributes [=reflect=] in IDL as defined in HTML.

Example Attribute Usage

-

ARIA nullable DOMString Attributes

+

ARIA IDL Attribute Types

As noted in [[[#typemapping]]], attributes are included in host languages, and the syntax for representation of WAI-ARIA types is governed by the host language.

ARIA attributes [=reflect=] in IDL as defined in HTML.

From e9e0f97a551a8046ca46033dcff3cb69882661f3 Mon Sep 17 00:00:00 2001 From: Rahim Abdi Date: Sun, 16 Feb 2025 22:39:51 -0800 Subject: [PATCH 36/37] Add note on IDL vs. content attributes --- index.html | 6 +++++- 1 file changed, 5 insertions(+), 1 deletion(-) diff --git a/index.html b/index.html index f56f3db0f..11884c304 100644 --- a/index.html +++ b/index.html @@ -10199,10 +10199,14 @@

Value

ARIA Attributes

+
+

Distinguishing Between Content and IDL Attributes

+

HTML content attributes, including ARIA states and properties, are set in HTML markup, while IDL attributes (or DOM properties) are the corresponding JavaScript properties exposed on DOM elements. + See [=reflect|reflection=] in HTML for more details.

Enumerated Attribute Values

When the ARIA attribute definition includes a table listing the attribute's allowed values, - it is an [=enumerated attribute=]. Each value in the table is a keyword for the attribute, mapping to a state of the same name and one or more keywords may map to the same state.

+ it is an [=enumerated attribute=]. Each value in the table is a keyword for the attribute, mapping to a state of the same name and one or more keywords may map to the same state.

IDL reflection of ARIA attributes

From 509091fc10092bae8add5159657b5428927bc2bf Mon Sep 17 00:00:00 2001 From: Rahim Abdi Date: Sun, 16 Feb 2025 22:59:54 -0800 Subject: [PATCH 37/37] Update 'Example Attribute Usage' --- index.html | 33 +++++++++++++++++++++++---------- 1 file changed, 23 insertions(+), 10 deletions(-) diff --git a/index.html b/index.html index 11884c304..aec75c982 100644 --- a/index.html +++ b/index.html @@ -10230,6 +10230,21 @@

ARIA IDL Attribute Types

Example Attribute Usage

+