@progress/wct-a11y-spec/dist/design-system/ActionSheet.json

Contains accessibility and keyboard navigation specification of Telerik and Kendo web components.

[
    {
        "h2": "Accessibility Support"
    },
    {
        "p": "Out of the box, the Telerik and Kendo UI ActionSheet provides extensive accessibility support and enables users with disabilities to acquire complete control over its features."
    },
    {
        "p": "The ActionSheet is compliant with the [Web Content Accessibility Guidelines (WCAG) 2.2 standards](https://www.w3.org/TR/WCAG22/) and [Section 508](http://www.section508.gov/) requirements, follows the [Web Accessibility Initiative - Accessible Rich Internet Applications (WAI-ARIA)](https://www.w3.org/WAI/ARIA/apg/) best practices for implementing the [keyboard navigation](#keyboard-navigation) for its `component` role, provides options for [managing its focus](#managing-the-focus) and is tested against the most popular [screen readers](#screen-readers)."
    },
    {
        "h3": "WAI-ARIA"
    },
    {
        "p": "This section lists the selectors, attributes, and behavior patterns supported by the component and its composite elements, if any."
    },
    {
        "h4": "ActionSheet component"
    },
    {
        "table": {
            "headers": [
                "Selector",
                "Attribute",
                "Usage"
            ],
            "rows": [
                {
                    "Selector": "`.k-actionsheet`",
                    "Attribute": "`role=dialog`",
                    "Usage": "Announces the dialog role of the component."
                },
                {
                    "Selector": "",
                    "Attribute": "`aria-labelledby=.k-actionsheet-title id`",
                    "Usage": "Associates the title of the action sheet."
                },
                {
                    "Selector": "",
                    "Attribute": "`aria-hidden=true/false`",
                    "Usage": "Announces the hidden state of the ActionSheet container."
                },
                {
                    "Selector": "",
                    "Attribute": "`aria-modal=true`",
                    "Usage": "Announces that the action sheet is modal."
                },
                {
                    "Selector": "`.k-actionsheet .k-actionsheet-title`",
                    "Attribute": "`id`",
                    "Usage": "Used to associate the title with the action sheet wrapper element."
                },
                {
                    "Selector": "`.k-list-ul`",
                    "Attribute": "`role=group`",
                    "Usage": "Sets the role attribute of the action sheet items wrapper to group."
                },
                {
                    "Selector": "`.k-actionsheet-item`",
                    "Attribute": "`tabindex=0`",
                    "Usage": "Makes items focusable and includes them in the natural tab sequence."
                },
                {
                    "Selector": "",
                    "Attribute": "`role=button`",
                    "Usage": "Sets action sheet items role to button."
                },
                {
                    "Selector": "`.k-actionsheet-item.k-disabled`",
                    "Attribute": "`aria-disabled=true`",
                    "Usage": "Announces action items as disabled as necessary."
                }
            ]
        }
    },
    {
        "h3": "Managing the Focus"
    },
    {
        "p": "When the action sheet is opened, the first action item is focused. Focus is thereafter trapped and wrapped in the ActionSheet container until closed. After the ActionSheet is closed, the developer is responsible for returning the focus to the element that triggered the ActionSheet."
    },
    {
        "h3": "Keyboard Shortcuts"
    },
    {
        "table": {
            "headers": [
                "Shortcut",
                "Behavior"
            ],
            "rows": [
                {
                    "Shortcut": "`Escape`",
                    "Behavior": "Dismisses the ActionSheet."
                },
                {
                    "Shortcut": "`Tab`",
                    "Behavior": "Cycles through the focusable items."
                },
                {
                    "Shortcut": "`Enter`",
                    "Behavior": "Triggers the action associated with the currently focused item."
                }
            ]
        }
    },
    {
        "h3": "Testing"
    },
    {
        "p": "The ActionSheet has been extensively tested automatically with [axe-core](https://github.com/dequelabs/axe-core) and manually with the most popular screen readers."
    },
    {
        "h3": "Screen Readers"
    },
    {
        "p": "The ActionSheet has been tested with the following screen readers and browsers combinations:"
    },
    {
        "table": {
            "headers": [
                "Environment",
                "Tool"
            ],
            "rows": [
                [
                    "Firefox",
                    "NVDA"
                ],
                [
                    "Chrome",
                    "JAWS"
                ],
                [
                    "Microsoft Edge",
                    "JAWS"
                ]
            ]
        }
    },
    {
        "h3": "Resources"
    },
    {
        "ul": [
            {
                "link": {
                    "source": "https://www.w3.org/WAI/ARIA/apg/patterns/dialog-modal/examples/dialog/",
                    "title": "ARIA practices Modal Dialog Example"
                }
            },
            {
                "link": {
                    "source": "https://www.w3.org/WAI/ARIA/apg/patterns/dialogmodal/",
                    "title": "ARIA Authoring Practices: Dialog (Modal) Pattern"
                }
            }
        ]
    }
]