From 44678efd4348a065adad41290c1dd0094e781e30 Mon Sep 17 00:00:00 2001 From: erdem <137915983+erdemonal11@users.noreply.github.com> Date: Thu, 9 Oct 2025 13:21:27 +0200 Subject: [PATCH] Docs: Clarify use of aria-current in navigation treeview example The navigation treeview example uses aria-current="page" to indicate the current item, which differs from the general treeview pattern's mention of aria-selected. This was causing confusion for users. This change adds an explanatory note to the "Accessibility Features" section, clarifying that aria-current is used because it more effectively communicates the state of a navigation widget. The new text follows the project's editorial style guidelines. Closes #3371 --- .../treeview/examples/treeview-navigation.html | 12 ++++++++++-- 1 file changed, 10 insertions(+), 2 deletions(-) diff --git a/content/patterns/treeview/examples/treeview-navigation.html b/content/patterns/treeview/examples/treeview-navigation.html index d35ca9a332..535d730aa7 100644 --- a/content/patterns/treeview/examples/treeview-navigation.html +++ b/content/patterns/treeview/examples/treeview-navigation.html @@ -347,8 +347,16 @@

Assistive Technology Support Features

  • When focus leaves the tree, if the item representing the current page is in a branch that has been collapsed, that branch is expanded to ensure the current page item is both visible and exposed as active to assistive technologies.
    • - -

    Visual design and high contrast features

    +        +       

    +          In this navigation example, the +          aria-current +          attribute is used instead of +          aria-selected +          because it more clearly communicates which page is currently displayed. +          The ARIA Tree View pattern does not require that an item be selected. +       

    +       

    Visual design and high contrast features