docs: update accessibility and keyboard-nav specs

kendo-bot · kendo-bot · commit dc46238221fd · 2026-02-12T15:13:21.000Z
diff --git a/components/autocomplete/accessibility/wai-aria-support.md b/components/autocomplete/accessibility/wai-aria-support.md
@@ -34,7 +34,7 @@ The following table summarizes the selectors and attributes supported by the Aut
 |  | `label for` or `aria-label` or `aria-labelledby` | The input needs an accessible name that will be assigned to it. |
 |  | `aria-haspopup=listbox` | Indicates that the component has a listbox popup. |
 |  | `aria-expanded=true/false` | Announces the state of the popup visibility. |
-|  | `aria-controls=.k-list-ul id` | Points to the `listbox` element. Signifies that the `combobox` element controls the `listbox` one. |
+|  | `aria-controls=[role='listbox'] id` | Points to the `listbox` element. Signifies that the `combobox` element controls the `listbox` one. |
 |  | `aria-activedescendant=.k-list-item.k-focus id` | Points to the focused item in the popup. The focused item is changed with keyboard navigation. If the popup is not visible, the attribute must not point to any element or must be removed. |
 |  | `aria-autocomplete=list` | The attribute is rendered and the value is set to `list` when the filtering feature is enabled. |
 |  | `aria-autocomplete=both` | The attribute is rendered and the value is set to `both` when both the filtering and suggest features are enabled. |
@@ -55,15 +55,17 @@ The popup element of the AutoComplete has to implement the WAI-ARIA specificatio
 | `.k-animation-container` | `role=region` | When the component container is appended to the `<body>` element of the document, it requires you to assing a `landmark` role to it. Otherwise, append it to an element with an appropriate `landmark` role. |
 |  | `aria-label` or `aria-labelledby` | When the container has a `region` role assigned, povides a label. |
 | `.k-list .k-no-data` | `aria-live=polite` | Identifies the element as a live region in the `polite` state, meaning assistive technology users are informed about changes to the region at the next available opportunity. |
-| `.k-list-ul` | `role=listbox` | Identifies the `ul` element as a listbox. |
-|  | `aria-label` or `aria-labelledby` | Provides a label for the listbox of the ComboBox. |
-| `.k-list-item` | `role=option` | Identifies the `li` element as a listbox option. |
-|  | `id` | When grouped, the list items must have an `id` attribute specified, so that the "aria-owns" attribute of their group header elements (with `role=group`) point to that ids. |
-|  | `aria-describedby` | When grouped, the list items must have an "aria-describedby" attribute pointing to the id of the `k-list-item-text` element in their `k-list-group-item`. |
+| `.k-list-item-icon-wrapper` | `role=presentation` | Indicates that the icon wrapper is decorative and should be ignored by assistive technologies. |
+| `.k-list-item-icon` | `aria-hidden=true` | Ensures that the icon itself is hidden from assistive technologies since it is decorative. |
 | `.k-list-item.k-selected` | `aria-selected=true` | Indicates the selected state of the item. |
-| `.k-list-group-item` | `role=group` | The group elements in the popup list must be have `role=group`. |
-|  | `aria-owns` | The group elements in the popup list must own the list items belonging to their group. |
-| `.k-list-group-item>.k-list-item-text` | `id` | The `k-list-item-text` elements of the `k-list-group-item` must have an id specified. The `aria-labelledby` attribute of the list items in the group must point to that id. |
+| `.k-list-content` | `role=listbox` | When data is grouped, role is listbox. |
+|  | `aria-multiselectable=true` | Signifies that the grouped list allows multiple selection. |
+| `.k-list-ul` | `role=listbox/group` | When data is grouped, role is group, otherwise - listbox. |
+|  | `aria-multiselectable=true` | Signifies that the list allows multiple selection. |
+|  | `aria-labelledby=id of group header` | References the id of the group header element that labels this group. |
+| `.k-list-group-item` | `role=presentation` | The group header has role='presentation' since the grouping semantics are provided by the ul[role=group]. |
+|  | `id` | Provides an id for the group header that is referenced by the group's aria-labelledby attribute. |
+| `.k-list-ul .k-list-item` | `role=option` | Items within a group maintain the option role. |
 
 ### Adaptive Mode
 
diff --git a/components/combobox/accessibility/wai-aria-support.md b/components/combobox/accessibility/wai-aria-support.md
@@ -34,7 +34,7 @@ The following table summarizes the selectors and attributes supported by the Com
 |  | `label for` or `aria-label` or `aria-labelledby` | The input requires an accessible name that will be assigned to it. |
 |  | `aria-haspopup=listbox` | Indicates that the component has a listbox popup. |
 |  | `aria-expanded=true/false` | Announces the visibility state of the popup. |
-|  | `aria-controls=.k-list-ul id` | Points to the listbox element. Signifies that the `combobox` controls the `listbox` element. |
+|  | `aria-controls=[role='listbox'] id` | Points to the listbox element. Signifies that the `combobox` controls the `listbox` element. |
 |  | `aria-activedescendant=.k-list-item.k-focus id` | Points to the focused item in the popup. The focused item is changed through keyboard navigation. If the popup is not visible, the attribute must not point to any element or must be removed. |
 |  | `aria-autocomplete=list` | When filtering is enabled, the attribute is rendered and the value is set to `list`. |
 |  | `aria-autocomplete=both` | When both the filtering and the suggest featutres are enabled, the attribute is rendered and the value is set to `both`. |
@@ -59,15 +59,17 @@ The popup element of the ComboBox has to implement the WAI-ARIA specification fo
 | `.k-animation-container` | `role=region` | When the component container is appended to the `<body>` element of the document, it requires you to assing a `landmark` role to it. Otherwise, append it to an element with an appropriate `landmark` role. |
 |  | `aria-label` or `aria-labelledby` | When the container has a `region` role assigned, povides a label. |
 | `.k-list .k-no-data` | `aria-live=polite` | Identifies the element as a live region in the `polite` state, meaning assistive technology users are informed about changes to the region at the next available opportunity. |
-| `.k-list-ul` | `role=listbox` | Identifies the `ul` element as a listbox. |
-|  | `aria-label` or `aria-labelledby` | Provides a label for the listbox of the ComboBox. |
-| `.k-list-item` | `role=option` | Identifies the `li` element as a listbox option. |
-|  | `id` | When grouped, the list items must have an `id` attribute specified, so that the "aria-owns" attribute of their group header elements (with `role=group`) point to that ids. |
-|  | `aria-describedby` | When grouped, the list items must have an "aria-describedby" attribute pointing to the id of the `k-list-item-text` element in their `k-list-group-item`. |
+| `.k-list-item-icon-wrapper` | `role=presentation` | Indicates that the icon wrapper is decorative and should be ignored by assistive technologies. |
+| `.k-list-item-icon` | `aria-hidden=true` | Ensures that the icon itself is hidden from assistive technologies since it is decorative. |
 | `.k-list-item.k-selected` | `aria-selected=true` | Indicates the selected state of the item. |
-| `.k-list-group-item` | `role=group` | The group elements in the popup list must be have `role=group`. |
-|  | `aria-owns` | The group elements in the popup list must own the list items belonging to their group. |
-| `.k-list-group-item>.k-list-item-text` | `id` | The `k-list-item-text` elements of the `k-list-group-item` must have an id specified. The `aria-labelledby` attribute of the list items in the group must point to that id. |
+| `.k-list-content` | `role=listbox` | When data is grouped, role is listbox. |
+|  | `aria-multiselectable=true` | Signifies that the grouped list allows multiple selection. |
+| `.k-list-ul` | `role=listbox/group` | When data is grouped, role is group, otherwise - listbox. |
+|  | `aria-multiselectable=true` | Signifies that the list allows multiple selection. |
+|  | `aria-labelledby=id of group header` | References the id of the group header element that labels this group. |
+| `.k-list-group-item` | `role=presentation` | The group header has role='presentation' since the grouping semantics are provided by the ul[role=group]. |
+|  | `id` | Provides an id for the group header that is referenced by the group's aria-labelledby attribute. |
+| `.k-list-ul .k-list-item` | `role=option` | Items within a group maintain the option role. |
 
 ### Adaptive Mode
 
diff --git a/components/dropdownlist/accessibility/wai-aria-support.md b/components/dropdownlist/accessibility/wai-aria-support.md
@@ -34,7 +34,7 @@ The following table summarizes the selectors and attributes supported by the Dro
 |  | `label for` or `aria-label` or `aria-labelledby` | The input requires an accessible name that will be assigned to it. |
 |  | `aria-haspopup=listbox` | Indicates the presence of a listbox popup. |
 |  | `aria-expanded=true/false` | Announces the visibility state of the popup. |
-|  | `aria-controls=.k-list-ul id` | Points to the listbox element. Signifies that the `combobox` controls the `listbox` element. |
+|  | `aria-controls=[role='listbox'] id` | Points to the listbox element. Signifies that the `combobox` controls the `listbox` element. |
 |  | `aria-describedby=.k-input-inner id` | Announces the selected value of the drop-down. |
 |  | `aria-activedescendant=.k-list-item.k-focus id` | Points to the focused item in the popup. The focused item is changed through keyboard navigation. If the popup is not visible, the attribute must not point to any element or must be removed. |
 |  | `aria-readonly=true` | The attribute is rendered only when the DropDownList is read-only. |
@@ -57,7 +57,7 @@ The following table summarizes the selectors and attributes supported by the Dro
 |  | `aria-label` | Points to the search label. |
 |  | `aria-activedescendant=.k-list-item.k-focus id` | Points to the focused item or to an item from the popup. |
 |  | `aria-autocomplete=list` | Indicates the list-filtering capabilities of the selected items. |
-|  | `aria-controls=.k-list-ul id` | Points to the popup element. Builds the relationship between the input and the popup. |
+|  | `aria-controls=[role='listbox'] id` | Points to the popup element. Builds the relationship between the input and the popup. |
 |  | `aria-haspopup=listbox` | Indicates the presence of a listbox popup. |
 | `.k-list-ul` | `aria-live=polite/off` | Assures the live updates on the selected value of the popup. |
 
@@ -71,15 +71,17 @@ The listbox placed in the popup element of the DropDownList has to implement the
 | `.k-animation-container` | `role=region` | When the component container is appended to the `<body>` element of the document, it requires you to assing a `landmark` role to it. Otherwise, append it to an element with an appropriate `landmark` role. |
 |  | `aria-label` or `aria-labelledby` | When the container has a `region` role assigned, povides a label. |
 | `.k-list .k-no-data` | `aria-live=polite` | Identifies the element as a live region in the `polite` state, meaning assistive technology users are informed about changes to the region at the next available opportunity. |
-| `.k-list-ul` | `role=listbox` | Identifies the `ul` element as a listbox. |
-|  | `aria-label` or `aria-labelledby` | Provides a label for the listbox of the ComboBox. |
-| `.k-list-item` | `role=option` | Identifies the `li` element as a listbox option. |
-|  | `id` | When grouped, the list items must have an `id` attribute specified, so that the "aria-owns" attribute of their group header elements (with `role=group`) point to that ids. |
-|  | `aria-describedby` | When grouped, the list items must have an "aria-describedby" attribute pointing to the id of the `k-list-item-text` element in their `k-list-group-item`. |
+| `.k-list-item-icon-wrapper` | `role=presentation` | Indicates that the icon wrapper is decorative and should be ignored by assistive technologies. |
+| `.k-list-item-icon` | `aria-hidden=true` | Ensures that the icon itself is hidden from assistive technologies since it is decorative. |
 | `.k-list-item.k-selected` | `aria-selected=true` | Indicates the selected state of the item. |
-| `.k-list-group-item` | `role=group` | The group elements in the popup list must be have `role=group`. |
-|  | `aria-owns` | The group elements in the popup list must own the list items belonging to their group. |
-| `.k-list-group-item>.k-list-item-text` | `id` | The `k-list-item-text` elements of the `k-list-group-item` must have an id specified. The `aria-labelledby` attribute of the list items in the group must point to that id. |
+| `.k-list-content` | `role=listbox` | When data is grouped, role is listbox. |
+|  | `aria-multiselectable=true` | Signifies that the grouped list allows multiple selection. |
+| `.k-list-ul` | `role=listbox/group` | When data is grouped, role is group, otherwise - listbox. |
+|  | `aria-multiselectable=true` | Signifies that the list allows multiple selection. |
+|  | `aria-labelledby=id of group header` | References the id of the group header element that labels this group. |
+| `.k-list-group-item` | `role=presentation` | The group header has role='presentation' since the grouping semantics are provided by the ul[role=group]. |
+|  | `id` | Provides an id for the group header that is referenced by the group's aria-labelledby attribute. |
+| `.k-list-ul .k-list-item` | `role=option` | Items within a group maintain the option role. |
 
 ### Adaptive Mode
 
diff --git a/components/listbox/accessibility/wai-aria-support.md b/components/listbox/accessibility/wai-aria-support.md
@@ -45,7 +45,7 @@ The ListBox toolbar follows the specification of the ToolBar component.
 | -------- | --------- | ----- |
 | `.k-listbox-actions` | `role=toolbar` | The toolbar is a collection of command buttons. |
 |  | `aria-label` | Clarifies the purpose of the toolbar. |
-|  | `aria-controls=.k-list-ul id` | Points to the ids of the `role=listbox` elements that are being controlled by the ToolBar. |
+|  | `aria-controls=[role='listbox'] id` | Points to the ids of the `role=listbox` elements that are being controlled by the ToolBar. |
 | `.k-listbox-actions .k-button` | `aria-label` or `title` | All buttons in the ToolBar must have lables, so that their purpose is clear. |
 
 ## Resources
diff --git a/components/multiselect/accessibility/wai-aria-support.md b/components/multiselect/accessibility/wai-aria-support.md
@@ -34,7 +34,7 @@ The following table summarizes the selectors and attributes supported by the Mul
 |  | `label for` or `aria-label` or `aria-labelledby` | The input needs an accessible name that will be assigned to it. |
 |  | `aria-haspopup=listbox` | Indicates the presence of a listbox popup. |
 |  | `aria-expanded=true/false` | Announces the state of the popup visibility. |
-|  | `aria-controls=.k-list-ul id` | Points to the listbox element. Signifies that the `combobox` element controls the `listbox` one. |
+|  | `aria-controls=[role='listbox'] id` | Points to the listbox element. Signifies that the `combobox` element controls the `listbox` one. |
 |  | `aria-autocomplete=list` | When the filtering feature is enabled, the attribute is rendered and the value is set to the list. |
 |  | `aria-describedby=.k-chip-list id` | Points to the `taglist` element that contains the selected items. |
 |  | `aria-activedescendant=.k-list-item.k-focus id` | Points to the focused item,which is either an item from the popup or a tag item from the selected items. The focused item is changed through keyboard navigation. If the focus is not currently on a tag item and the popup is not visible, the attribute must not point to any element or must be removed. |
@@ -52,24 +52,22 @@ The following table summarizes the selectors and attributes supported by the Mul
 
 The popup element of the MultiSelect must implement the WAI-ARIA specification for a Popup List component. The following table summarizes the selectors and attributes supported by the listbox popup of the MultiSelect:
 
-| Selector | Attribute | Usage |
-| -------- | --------- | ----- |
-| `.k-list-ul` | `aria-multiselectable=true` | Announces multiselection of the listbox popup. |
-
 | Selector | Attribute | Usage |
 | -------- | --------- | ----- |
 | `.k-animation-container` | `role=region` | When the component container is appended to the `<body>` element of the document, it requires you to assing a `landmark` role to it. Otherwise, append it to an element with an appropriate `landmark` role. |
 |  | `aria-label` or `aria-labelledby` | When the container has a `region` role assigned, povides a label. |
 | `.k-list .k-no-data` | `aria-live=polite` | Identifies the element as a live region in the `polite` state, meaning assistive technology users are informed about changes to the region at the next available opportunity. |
-| `.k-list-ul` | `role=listbox` | Identifies the `ul` element as a listbox. |
-|  | `aria-label` or `aria-labelledby` | Provides a label for the listbox of the ComboBox. |
-| `.k-list-item` | `role=option` | Identifies the `li` element as a listbox option. |
-|  | `id` | When grouped, the list items must have an `id` attribute specified, so that the "aria-owns" attribute of their group header elements (with `role=group`) point to that ids. |
-|  | `aria-describedby` | When grouped, the list items must have an "aria-describedby" attribute pointing to the id of the `k-list-item-text` element in their `k-list-group-item`. |
+| `.k-list-item-icon-wrapper` | `role=presentation` | Indicates that the icon wrapper is decorative and should be ignored by assistive technologies. |
+| `.k-list-item-icon` | `aria-hidden=true` | Ensures that the icon itself is hidden from assistive technologies since it is decorative. |
 | `.k-list-item.k-selected` | `aria-selected=true` | Indicates the selected state of the item. |
-| `.k-list-group-item` | `role=group` | The group elements in the popup list must be have `role=group`. |
-|  | `aria-owns` | The group elements in the popup list must own the list items belonging to their group. |
-| `.k-list-group-item>.k-list-item-text` | `id` | The `k-list-item-text` elements of the `k-list-group-item` must have an id specified. The `aria-labelledby` attribute of the list items in the group must point to that id. |
+| `.k-list-content` | `role=listbox` | When data is grouped, role is listbox. |
+|  | `aria-multiselectable=true` | Signifies that the grouped list allows multiple selection. |
+| `.k-list-ul` | `role=listbox/group` | When data is grouped, role is group, otherwise - listbox. |
+|  | `aria-multiselectable=true` | Signifies that the list allows multiple selection. |
+|  | `aria-labelledby=id of group header` | References the id of the group header element that labels this group. |
+| `.k-list-group-item` | `role=presentation` | The group header has role='presentation' since the grouping semantics are provided by the ul[role=group]. |
+|  | `id` | Provides an id for the group header that is referenced by the group's aria-labelledby attribute. |
+| `.k-list-ul .k-list-item` | `role=option` | Items within a group maintain the option role. |
 
 ### Adaptive Mode
 
diff --git a/components/treeview/accessibility/wai-aria-support.md b/components/treeview/accessibility/wai-aria-support.md
@@ -38,7 +38,7 @@ If the tree supports the load-more functionality, the **Load More** button is re
 |  | `aria-setsize` | Announces the total count of the items at this level. Enables the user to understand the position of the navigation, for example, item 3 of 14. Must be added only when the load-more functionality of the tree is enabled and there are still nodes belonging to the group that are not loaded (rendered) yet. |
 |  | `aria-expanded=true/false` | Announces the expanded state of the node. The value is `true` when expanded, and `false` when collapsed. |
 |  | `aria-checked=true/false` | Rendered only when checkboxes are enabled. Announces the checked state of the node. If the checkbox is indeterminate, the value is `mixed`. |
-| `.k-treeview-item:has(> span > .k-selected, > div > .k-selected) ` | `aria-selected=true` | Rendered only when selection is enabled. Announces the selected state of the node. |
+| `.k-treeview-item:has(>.k-selected)` | `aria-selected=true` | Rendered only when selection is enabled. Announces the selected state of the node. |
 | `.k-checkbox` | `role=none/presentation` | Added to the wrapper element of the checkbox to prevent duplicated information announced to the user. The checked state is controlled by `aria-checked`. |
 
 ## Resources
