@progress/wct-a11y-spec/dist/design-system/Signature.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 Signature provides extensive accessibility support and enables users with disabilities to acquire complete control over its features."
    },
    {
        "p": "The Signature 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": "Signature canvas"
    },
    {
        "table": {
            "headers": [
                "Selector",
                "Attribute",
                "Usage"
            ],
            "rows": [
                {
                    "Selector": "`.k-signature-canvas`",
                    "Attribute": "`role=img`",
                    "Usage": "Sets canvas `role` to `img`."
                },
                {
                    "Selector": "`.k-signature-canvas`",
                    "Attribute": "`aria-label`",
                    "Usage": "Announces the purpose of the Signature."
                },
                {
                    "Selector": "`.k-signature-canvas:nth-child(1)`",
                    "Attribute": "`tabindex=0`",
                    "Usage": "Makes the Signature canvas the first focusable element."
                }
            ]
        }
    },
    {
        "h4": "Signature action buttons"
    },
    {
        "table": {
            "headers": [
                "Selector",
                "Attribute",
                "Usage"
            ],
            "rows": [
                {
                    "Selector": "`.k-signature-action`",
                    "Attribute": "`nodeName=button`",
                    "Usage": "Renders button."
                },
                {
                    "Selector": "`.k-signature-action`",
                    "Attribute": "`aria-label`",
                    "Usage": "Announces the purpose of the button."
                }
            ]
        }
    },
    {
        "h3": "Managing the Focus"
    },
    {
        "p": "The Signature is focusable by default, and follows the regular tab order of the page."
    },
    {
        "p": "The maximize and clear buttons, if present, are included in the page tab order."
    },
    {
        "p": "When the maximize button is pressed, the focus is trapped in the dialog. The focus is moved to the minimize button of the popup dialog. Then the order of tab presses is:"
    },
    {
        "p": "When the dialog is closed, the focus moves to the maximize button of the main signature."
    },
    {
        "h3": "Keyboard Shortcuts"
    },
    {
        "table": {
            "headers": [
                "Shortcut",
                "Behavior"
            ],
            "rows": [
                {
                    "Shortcut": "`Esc`",
                    "Behavior": "Closes the dialog if open."
                }
            ]
        }
    },
    {
        "h3": "Testing"
    },
    {
        "p": "The Signature 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 Signature has been tested with the following screen readers and browsers combinations:"
    },
    {
        "table": {
            "headers": [
                "Environment",
                "Tool"
            ],
            "rows": [
                [
                    "Firefox",
                    "NVDA"
                ],
                [
                    "Chrome",
                    "JAWS"
                ],
                [
                    "Microsoft Edge",
                    "JAWS"
                ]
            ]
        }
    }
]