diff --git a/content/about/coverage-and-quality/coverage-and-quality-report.html b/content/about/coverage-and-quality/coverage-and-quality-report.html index cad4d60acb..95e47d0f3f 100644 --- a/content/about/coverage-and-quality/coverage-and-quality-report.html +++ b/content/about/coverage-and-quality/coverage-and-quality-report.html @@ -369,7 +369,6 @@

Roles with More than One Guidance or Exa
  • Switch Using HTML Button (HC)
  • File Directory Treeview Using Computed Properties
  • File Directory Treeview Using Declared Properties
  • -
  • [Experimental] File Directory Treeview Using Computed Properties
  • Navigation Treeview (HC)
  • @@ -704,7 +703,6 @@

    Roles with More than One Guidance or Exa @@ -715,7 +713,6 @@

    Roles with More than One Guidance or Exa @@ -963,7 +960,6 @@

    Properties and States with More than One
  • Treegrid Email Inbox
  • File Directory Treeview Using Computed Properties
  • File Directory Treeview Using Declared Properties
  • -
  • [Experimental] File Directory Treeview Using Computed Properties
  • Navigation Treeview (HC)
  • @@ -1071,7 +1067,6 @@

    Properties and States with More than One
  • Tabs with Manual Activation (HC)
  • File Directory Treeview Using Computed Properties
  • File Directory Treeview Using Declared Properties
  • -
  • [Experimental] File Directory Treeview Using Computed Properties
  • Navigation Treeview (HC)
  • Complementary Landmark
  • Form Landmark
  • @@ -1183,7 +1178,6 @@

    Properties and States with More than One
  • Tabs with Manual Activation (HC)
  • File Directory Treeview Using Computed Properties
  • File Directory Treeview Using Declared Properties
  • -
  • [Experimental] File Directory Treeview Using Computed Properties
  • @@ -1278,7 +1272,7 @@

    Coding Summary

    Total Examples - 61 + 60 High Contrast Documentation @@ -1294,7 +1288,7 @@

    Coding Summary

    Uses event.KeyCode - 17 + 16 Uses event.which @@ -1306,11 +1300,11 @@

    Coding Summary

    Use Prototype - 23 + 22 Mouse Events - 16 + 15 Pointer Events @@ -2104,19 +2098,6 @@

    Coding Practices

    6 aria-label - - [Experimental] File Directory Treeview Using Computed Properties - prototype - Yes - - - ex1 - 3 - 3 - 4 - 3 - aria-label - Navigation Treeview class @@ -2627,16 +2608,6 @@

    Graphics Techniques

    Yes - - [Experimental] File Directory Treeview Using Computed Properties - - - - - Yes - - Yes - Navigation Treeview Yes @@ -2784,11 +2755,6 @@

    Mouse and Pointer Events

    Yes - - [Experimental] File Directory Treeview Using Computed Properties - Yes - - Navigation Treeview Yes diff --git a/content/about/coverage-and-quality/prop-coverage.csv b/content/about/coverage-and-quality/prop-coverage.csv index d57b8cc3de..7effc0b049 100644 --- a/content/about/coverage-and-quality/prop-coverage.csv +++ b/content/about/coverage-and-quality/prop-coverage.csv @@ -14,7 +14,7 @@ "aria-disabled","0","3","Example: Alert Dialog","Example: Editor Menubar","Example: Toolbar" "aria-dropeffect","0","0" "aria-errormessage","0","0" -"aria-expanded","0","23","Example: Accordion","Example: Editable Combobox With Both List and Inline Autocomplete","Example: Editable Combobox With List Autocomplete","Example: Editable Combobox without Autocomplete","Example: Date Picker Combobox","Example: Select-Only Combobox","Example: Editable Combobox with Grid Popup","Example: Disclosure (Show/Hide) for Answers to Frequently Asked Questions","Example: Disclosure (Show/Hide) for Image Description","Example: Disclosure Navigation Menu with Top-Level Links","Example: Disclosure Navigation Menu","Example: (Deprecated) Collapsible Dropdown Listbox","Example: Actions Menu Button Using aria-activedescendant","Example: Actions Menu Button Using element.focus()","Example: Navigation Menu Button","Example: Editor Menubar","Example: Navigation Menubar","Example: Toolbar","Example: Treegrid Email Inbox","Example: File Directory Treeview Using Computed Properties","Example: File Directory Treeview Using Declared Properties","Example: [Experimental] File Directory Treeview Using Computed Properties","Example: Navigation Treeview" +"aria-expanded","0","22","Example: Accordion","Example: Editable Combobox With Both List and Inline Autocomplete","Example: Editable Combobox With List Autocomplete","Example: Editable Combobox without Autocomplete","Example: Date Picker Combobox","Example: Select-Only Combobox","Example: Editable Combobox with Grid Popup","Example: Disclosure (Show/Hide) for Answers to Frequently Asked Questions","Example: Disclosure (Show/Hide) for Image Description","Example: Disclosure Navigation Menu with Top-Level Links","Example: Disclosure Navigation Menu","Example: (Deprecated) Collapsible Dropdown Listbox","Example: Actions Menu Button Using aria-activedescendant","Example: Actions Menu Button Using element.focus()","Example: Navigation Menu Button","Example: Editor Menubar","Example: Navigation Menubar","Example: Toolbar","Example: Treegrid Email Inbox","Example: File Directory Treeview Using Computed Properties","Example: File Directory Treeview Using Declared Properties","Example: Navigation Treeview" "aria-flowto","0","0" "aria-grabbed","0","0" "aria-haspopup","0","9","Example: Date Picker Combobox","Example: Editable Combobox with Grid Popup","Example: (Deprecated) Collapsible Dropdown Listbox","Example: Actions Menu Button Using aria-activedescendant","Example: Actions Menu Button Using element.focus()","Example: Navigation Menu Button","Example: Editor Menubar","Example: Navigation Menubar","Example: Toolbar" @@ -22,7 +22,7 @@ "aria-invalid","0","0" "aria-keyshortcuts","0","0" "aria-label","1","18","Guidance: Naming with a String Attribute Via aria-label","Example: Breadcrumb","Example: Auto-Rotating Image Carousel with Buttons for Slide Control","Example: Auto-Rotating Image Carousel with Tabs for Slide Control","Example: Editable Combobox With Both List and Inline Autocomplete","Example: Editable Combobox With List Autocomplete","Example: Editable Combobox without Autocomplete","Example: Date Picker Combobox","Example: Date Picker Dialog","Example: Link","Example: Editor Menubar","Example: Navigation Menubar","Example: Rating Radio Group","Example: Horizontal Multi-Thumb Slider","Example: Date Picker Spin Button","Example: Table","Example: Toolbar","Example: Treegrid Email Inbox","Example: Navigation Treeview" -"aria-labelledby","1","41","Guidance: Naming with Referenced Content Via aria-labelledby","Example: Accordion","Example: Alert Dialog","Example: Checkbox (Two State)","Example: Date Picker Combobox","Example: Select-Only Combobox","Example: Editable Combobox with Grid Popup","Example: Date Picker Dialog","Example: Modal Dialog","Example: Infinite Scrolling Feed","Example: Data Grid","Example: Layout Grid","Example: (Deprecated) Collapsible Dropdown Listbox","Example: Listbox with Grouped Options","Example: Listboxes with Rearrangeable Options","Example: Scrollable Listbox","Example: Actions Menu Button Using aria-activedescendant","Example: Actions Menu Button Using element.focus()","Example: Navigation Menu Button","Example: Navigation Menubar","Example: Meter","Example: Radio Group Using aria-activedescendant","Example: Rating Radio Group","Example: Radio Group Using Roving tabindex","Example: Color Viewer Slider","Example: Rating Slider","Example: Media Seek Slider","Example: Vertical Temperature Slider","Example: Date Picker Spin Button","Example: Switch Using HTML Button","Example: Tabs with Automatic Activation","Example: Tabs with Manual Activation","Example: File Directory Treeview Using Computed Properties","Example: File Directory Treeview Using Declared Properties","Example: [Experimental] File Directory Treeview Using Computed Properties","Example: Navigation Treeview","Example: Complementary Landmark","Example: Form Landmark","Example: Main Landmark","Example: Navigation Landmark","Example: Region Landmark","Example: Search Landmark" +"aria-labelledby","1","40","Guidance: Naming with Referenced Content Via aria-labelledby","Example: Accordion","Example: Alert Dialog","Example: Checkbox (Two State)","Example: Date Picker Combobox","Example: Select-Only Combobox","Example: Editable Combobox with Grid Popup","Example: Date Picker Dialog","Example: Modal Dialog","Example: Infinite Scrolling Feed","Example: Data Grid","Example: Layout Grid","Example: (Deprecated) Collapsible Dropdown Listbox","Example: Listbox with Grouped Options","Example: Listboxes with Rearrangeable Options","Example: Scrollable Listbox","Example: Actions Menu Button Using aria-activedescendant","Example: Actions Menu Button Using element.focus()","Example: Navigation Menu Button","Example: Navigation Menubar","Example: Meter","Example: Radio Group Using aria-activedescendant","Example: Rating Radio Group","Example: Radio Group Using Roving tabindex","Example: Color Viewer Slider","Example: Rating Slider","Example: Media Seek Slider","Example: Vertical Temperature Slider","Example: Date Picker Spin Button","Example: Switch Using HTML Button","Example: Tabs with Automatic Activation","Example: Tabs with Manual Activation","Example: File Directory Treeview Using Computed Properties","Example: File Directory Treeview Using Declared Properties","Example: Navigation Treeview","Example: Complementary Landmark","Example: Form Landmark","Example: Main Landmark","Example: Navigation Landmark","Example: Region Landmark","Example: Search Landmark" "aria-level","0","2","Example: Treegrid Email Inbox","Example: File Directory Treeview Using Declared Properties" "aria-live","0","5","Example: Alert","Example: Auto-Rotating Image Carousel with Buttons for Slide Control","Example: Auto-Rotating Image Carousel with Tabs for Slide Control","Example: Date Picker Combobox","Example: Date Picker Dialog" "aria-modal","0","4","Example: Alert Dialog","Example: Date Picker Combobox","Example: Date Picker Dialog","Example: Modal Dialog" @@ -40,7 +40,7 @@ "aria-rowcount","1","2","Guidance: Using aria-rowcount and aria-rowindex","Example: Data Grid","Example: Layout Grid" "aria-rowindex","1","2","Guidance: Using aria-rowcount and aria-rowindex","Example: Data Grid","Example: Layout Grid" "aria-rowspan","1","0","Guidance: Defining cell spans using aria-colspan and aria-rowspan" -"aria-selected","0","17","Example: Auto-Rotating Image Carousel with Tabs for Slide Control","Example: Editable Combobox With Both List and Inline Autocomplete","Example: Editable Combobox With List Autocomplete","Example: Editable Combobox without Autocomplete","Example: Date Picker Combobox","Example: Select-Only Combobox","Example: Editable Combobox with Grid Popup","Example: Date Picker Dialog","Example: (Deprecated) Collapsible Dropdown Listbox","Example: Listbox with Grouped Options","Example: Listboxes with Rearrangeable Options","Example: Scrollable Listbox","Example: Tabs with Automatic Activation","Example: Tabs with Manual Activation","Example: File Directory Treeview Using Computed Properties","Example: File Directory Treeview Using Declared Properties","Example: [Experimental] File Directory Treeview Using Computed Properties" +"aria-selected","0","16","Example: Auto-Rotating Image Carousel with Tabs for Slide Control","Example: Editable Combobox With Both List and Inline Autocomplete","Example: Editable Combobox With List Autocomplete","Example: Editable Combobox without Autocomplete","Example: Date Picker Combobox","Example: Select-Only Combobox","Example: Editable Combobox with Grid Popup","Example: Date Picker Dialog","Example: (Deprecated) Collapsible Dropdown Listbox","Example: Listbox with Grouped Options","Example: Listboxes with Rearrangeable Options","Example: Scrollable Listbox","Example: Tabs with Automatic Activation","Example: Tabs with Manual Activation","Example: File Directory Treeview Using Computed Properties","Example: File Directory Treeview Using Declared Properties" "aria-setsize","0","3","Example: Infinite Scrolling Feed","Example: Treegrid Email Inbox","Example: File Directory Treeview Using Declared Properties" "aria-sort","1","2","Guidance: Indicating sort order with aria-sort","Example: Data Grid","Example: Sortable Table" "aria-valuemax","1","8","Guidance: Using aria-valuemin, aria-valuemax and aria-valuenow","Example: Meter","Example: Horizontal Multi-Thumb Slider","Example: Color Viewer Slider","Example: Rating Slider","Example: Media Seek Slider","Example: Vertical Temperature Slider","Example: Date Picker Spin Button","Example: Toolbar" diff --git a/content/about/coverage-and-quality/role-coverage.csv b/content/about/coverage-and-quality/role-coverage.csv index 7652edde9c..cbebe3fb38 100644 --- a/content/about/coverage-and-quality/role-coverage.csv +++ b/content/about/coverage-and-quality/role-coverage.csv @@ -25,7 +25,7 @@ "generic","0","0" "grid","3","5","Guidance: Grid Popup Keyboard Interaction","Guidance: Grid (Interactive Tabular Data and Layout Containers) Pattern","Guidance: Grid and Table Properties","Example: Date Picker Combobox","Example: Editable Combobox with Grid Popup","Example: Date Picker Dialog","Example: Data Grid","Example: Layout Grid" "gridcell","0","3","Example: Editable Combobox with Grid Popup","Example: Layout Grid","Example: Treegrid Email Inbox" -"group","2","11","Guidance: Radio Group Pattern","Guidance: For Radio Group Contained in a Toolbar","Example: Auto-Rotating Image Carousel with Buttons for Slide Control","Example: Checkbox (Two State)","Example: Listbox with Grouped Options","Example: Editor Menubar","Example: Color Viewer Slider","Example: Date Picker Spin Button","Example: Switch Using HTML Button","Example: File Directory Treeview Using Computed Properties","Example: File Directory Treeview Using Declared Properties","Example: [Experimental] File Directory Treeview Using Computed Properties","Example: Navigation Treeview" +"group","2","10","Guidance: Radio Group Pattern","Guidance: For Radio Group Contained in a Toolbar","Example: Auto-Rotating Image Carousel with Buttons for Slide Control","Example: Checkbox (Two State)","Example: Listbox with Grouped Options","Example: Editor Menubar","Example: Color Viewer Slider","Example: Date Picker Spin Button","Example: Switch Using HTML Button","Example: File Directory Treeview Using Computed Properties","Example: File Directory Treeview Using Declared Properties","Example: Navigation Treeview" "heading","0","0" "img","0","0" "input","0","0" @@ -74,6 +74,6 @@ "timer","0","0" "toolbar","3","1","Guidance: For Radio Groups Not Contained in a Toolbar","Guidance: For Radio Group Contained in a Toolbar","Guidance: Toolbar Pattern","Example: Toolbar" "tooltip","1","0","Guidance: Tooltip Pattern" -"tree","2","4","Guidance: Tree Popup Keyboard Interaction","Guidance: Tree View Pattern","Example: File Directory Treeview Using Computed Properties","Example: File Directory Treeview Using Declared Properties","Example: [Experimental] File Directory Treeview Using Computed Properties","Example: Navigation Treeview" +"tree","2","3","Guidance: Tree Popup Keyboard Interaction","Guidance: Tree View Pattern","Example: File Directory Treeview Using Computed Properties","Example: File Directory Treeview Using Declared Properties","Example: Navigation Treeview" "treegrid","1","1","Guidance: Treegrid Pattern","Example: Treegrid Email Inbox" -"treeitem","0","4","Example: File Directory Treeview Using Computed Properties","Example: File Directory Treeview Using Declared Properties","Example: [Experimental] File Directory Treeview Using Computed Properties","Example: Navigation Treeview" +"treeitem","0","3","Example: File Directory Treeview Using Computed Properties","Example: File Directory Treeview Using Declared Properties","Example: Navigation Treeview" diff --git a/content/index/index.html b/content/index/index.html index 1bce2ab871..c96c528253 100644 --- a/content/index/index.html +++ b/content/index/index.html @@ -907,8 +907,7 @@

    Examples By Properties and States

    Experimental Examples

    NOTE: The HC abbreviation means example has High Contrast support.
    - +
    diff --git a/content/patterns/treeview/examples/treeview-1c.html b/content/patterns/treeview/examples/treeview-1c.html deleted file mode 100644 index 555bf19257..0000000000 --- a/content/patterns/treeview/examples/treeview-1c.html +++ /dev/null @@ -1,432 +0,0 @@ - - - - - - [Experimental] File Directory Treeview Example Using Computed Properties - - - - - - - - - - - - - - - - - - - -
    -

    [Experimental] File Directory Treeview Example Using Computed Properties

    -
    -

    About This Experimental Example

    - -

    - This experimental version of the File Directory Treeview Example Using Declared Properties example is not intended to ever be released or shown to the public. - It exists merely to ensure that experimental content support can be adequately developed and tested. - When support is fully implemented, this example can be deleted. -

    -

    - This example relies on the browser to compute values for aria-setsize, aria-posinset, and aria-level. - The ARIA specification for these properties states that browsers can, but are not required to, compute their values. - So, some browser and assistive technology combinations may not compute or report correct position and level information if it is not explicitly declared. - If testing reveals gaps in support for these properties, override automatic computation by explicitly declaring their values as demonstrated in the example of a File Directory Treeview using declared properties. -

    -

    Similar examples include:

    - -
    - -
    -
    -

    Experimental Example

    -
    - -
    -

    My Documents

    -
      - - - -
    - -

    - -

    -
    - -
    - -
    -

    Accessibility Features

    -

    To make the focus indicator easier to see, nodes in the tree have custom focus and hover styling created using CSS focus and hover pseudo-classes.

    -
    - -
    -

    Terms Used to Describe Trees

    -

    - A tree item that can be expanded to reveal child items is called a parent node. - It is a closed node when the children are hidden and an open node when it is expanded. - An end node does not have any children. - For a complete list of terms and definitions, see the Treeview Pattern. -

    -
    - -
    -

    Keyboard Support

    -

    - Note that in this example, selection and focus are distinct; moving focus does not change which node is selected. - Because selection does not follow focus, keyboard and screen reader users can navigate and explore the tree without changing the content of the file viewer. - To learn more about this aspect of the design, see - Deciding When to Make Selection Automatically Follow Focus. -

    - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
    KeyFunction
    EnterPerforms the default action, which is to select the node, causing the name of the node to appear in the File or Folder Selected textbox.
    SpacePerforms the default action, which is to select the node, causing the name of the node to appear in the File or Folder Selected textbox.
    Down arrow -
      -
    • Moves focus to the next node that is focusable without opening or closing a node.
    • -
    • If focus is on the last node, does nothing.
    • -
    -
    Up arrow -
      -
    • Moves focus to the previous node that is focusable without opening or closing a node.
    • -
    • If focus is on the first node, does nothing.
    • -
    -
    Right Arrow -
      -
    • When focus is on a closed node, opens the node; focus does not move.
    • -
    • When focus is on a open node, moves focus to the first child node.
    • -
    • When focus is on an end node, does nothing.
    • -
    -
    Left Arrow -
      -
    • When focus is on an open node, closes the node.
    • -
    • When focus is on a child node that is also either an end node or a closed node, moves focus to its parent node.
    • -
    • When focus is on a root node that is also either an end node or a closed node, does nothing.
    • -
    -
    HomeMoves focus to first node without opening or closing a node.
    EndMoves focus to the last node that can be focused without expanding any nodes that are closed.
    a-z, A-Z -
      -
    • Focus moves to the next node with a name that starts with the typed character.
    • -
    • Search wraps to first node if a matching name is not found among the nodes that follow the focused node.
    • -
    • Search ignores nodes that are descendants of closed nodes.
    • -
    -
    * (asterisk) -
      -
    • Expands all closed sibling nodes that are at the same level as the focused node.
    • -
    • Focus does not move.
    • -
    -
    -
    - -
    -

    Role, Property, State, and Tabindex Attributes

    - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
    RoleAttributeElementUsage
    treeul - -
    aria-labelledby="ID_REFERENCE"ulRefers to the heading element that contains the label that identifies the purpose of the tree.
    treeitemliIdentifies the element as a treeitem.
    tabindex="-1"li -
      -
    • Makes the treeitem element focusable without including it in the tab sequence of the page.
    • -
    • All treeitem elements are focusable, but only one is included in the tab sequence.
    • -
    -
    tabindex="0"li -
      -
    • Includes the treeitem element in the tab sequence.
    • -
    • Only one treeitem in the tree has tabindex="0".
    • -
    • In this implementation, the first treeitem in the tree is included in the tab sequence when the page loads.
    • -
    • - When the user moves focus in the tree, the element included in the tab sequence changes to the element with focus as described in - Managing Focus Within Components Using a Roving tabindex. -
    • -
    -
    aria-expanded="false"li -
      -
    • Applied only to treeitem elements that are parent nodes, i.e., they contain a ul with the group role.
    • -
    • Indicates the parent node is closed, i.e., the descendant elements are not visible.
    • -
    • The visual indication of the collapsed state is synchronized by a CSS attribute selector.
    • -
    -
    aria-expanded="true"li -
      -
    • Applied only to treeitem elements that are parent nodes, i.e., they contain a ul with the group role.
    • -
    • Indicates the parent node is open, i.e., the descendant elements are visible.
    • -
    • The visual indication of the expanded state is synchronized by a CSS attribute selector.
    • -
    -
    aria-selected="false"li -
      -
    • Applied to treeitem elements.
    • -
    • Indicates the file or folder for the item is not currently selected.
    • -
    -
    aria-selected="true"li -
      -
    • Applied to treeitem elements.
    • -
    • Indicates the file or folder for the item is currently selected.
    • -
    -
    groupul -
      -
    • Identifies the ul element as a container of treeitem elements that form a branch of the tree.
    • -
    • The group is contained in the element that serves as the parent treeitem.
    • -
    • Browsers use the grouping to compute aria-level, aria-setsize and aria-posinset values for the nodes contained in the branch.
    • -
    • The grouping also prevents browsers from including the content of the nodes in the group in the accessible name for the parent node.
    • -
    -
    -
    - -
    -

    JavaScript and CSS Source Code

    - -
    - -
    -

    HTML Source Code

    - -
    - - -
    -
    - -