@pingux/astro 2.208.0-alpha.0 → 2.208.1-alpha.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/lib/cjs/components/AIComponents/PromptInput/PromptInputReadMe.mdx +12 -15
- package/lib/cjs/components/AccordionGridGroup/AccordionGridGroup.mdx +13 -19
- package/lib/cjs/components/AccordionGroup/AccordionGroup.mdx +16 -17
- package/lib/cjs/components/ArrayField/ArrayField.mdx +10 -15
- package/lib/cjs/components/Badge/Badge.mdx +6 -8
- package/lib/cjs/components/Breadcrumbs/Breadcrumbs.mdx +11 -17
- package/lib/cjs/components/Button/Button.mdx +8 -12
- package/lib/cjs/components/Calendar/Calendar.mdx +17 -22
- package/lib/cjs/components/Callout/Callout.mdx +8 -13
- package/lib/cjs/components/Card/Card.mdx +6 -8
- package/lib/cjs/components/CheckboxField/CheckboxField.mdx +11 -16
- package/lib/cjs/components/CodeEditor/CodeEditor.mdx +8 -13
- package/lib/cjs/components/CodeView/CodeView.mdx +5 -8
- package/lib/cjs/components/CollapsiblePanel/CollapsiblePanel.mdx +10 -13
- package/lib/cjs/components/ColorField/ColorField.mdx +13 -18
- package/lib/cjs/components/ComboBoxField/ComboBoxField.mdx +13 -15
- package/lib/cjs/components/CopyText/CopyText.mdx +6 -8
- package/lib/cjs/components/DataTable/DataTable.mdx +17 -22
- package/lib/cjs/components/DatePicker/DatePicker.mdx +20 -27
- package/lib/cjs/components/EnvironmentBreadcrumb/EnvironmentBreadcrumb.mdx +14 -19
- package/lib/cjs/components/ExpandableText/ExpandableText.mdx +9 -15
- package/lib/cjs/components/FileInputField/FileInputField.mdx +11 -16
- package/lib/cjs/components/Footer/Footer.mdx +9 -14
- package/lib/cjs/components/GridList/GridList.mdx +16 -21
- package/lib/cjs/components/HelpHint/HelpHint.mdx +8 -14
- package/lib/cjs/components/Icon/Icon.mdx +5 -3
- package/lib/cjs/components/IconButton/IconButton.mdx +7 -10
- package/lib/cjs/components/IconButtonToggle/IconButtonToggle.mdx +9 -15
- package/lib/cjs/components/Image/Image.mdx +4 -4
- package/lib/cjs/components/ImageUploadField/ImageUploadField.mdx +18 -24
- package/lib/cjs/components/Link/Link.mdx +5 -6
- package/lib/cjs/components/LinkSelectField/LinkSelectField.mdx +18 -24
- package/lib/cjs/components/ListItem/ListItem.mdx +6 -6
- package/lib/cjs/components/ListView/ListView.mdx +22 -23
- package/lib/cjs/components/Loader/Loader.mdx +6 -5
- package/lib/cjs/components/Menu/Menu.mdx +13 -18
- package/lib/cjs/components/Messages/Messages.mdx +9 -13
- package/lib/cjs/components/Modal/Modal.mdx +18 -19
- package/lib/cjs/components/MultivaluesField/MultivaluesField.mdx +14 -20
- package/lib/cjs/components/NavBar/NavBar.mdx +12 -17
- package/lib/cjs/components/NavSideBar/NavSideBar.mdx +12 -17
- package/lib/cjs/components/NavigationHeader/NavigationHeader.mdx +11 -16
- package/lib/cjs/components/NumberField/NumberField.mdx +16 -17
- package/lib/cjs/components/OverlayPanel/OverlayPanel.mdx +10 -14
- package/lib/cjs/components/Pagination/Pagination.mdx +9 -13
- package/lib/cjs/components/PasswordField/PasswordField.mdx +10 -15
- package/lib/cjs/components/PopoverMenu/PopoverMenu.mdx +16 -22
- package/lib/cjs/components/ProgressBar/ProgressBar.mdx +6 -7
- package/lib/cjs/components/RadioGroupField/RadioGroupField.mdx +11 -17
- package/lib/cjs/components/RangeCalendar/RangeCalendar.mdx +17 -22
- package/lib/cjs/components/RockerButtonGroup/RockerButtonGroup.mdx +11 -16
- package/lib/cjs/components/SearchField/SearchField.mdx +8 -10
- package/lib/cjs/components/SelectField/SelectField.mdx +18 -23
- package/lib/cjs/components/Separator/Separator.mdx +4 -3
- package/lib/cjs/components/ServerErrorBoundary/ServerErrorBoundary.mdx +6 -8
- package/lib/cjs/components/SliderField/SliderField.mdx +12 -15
- package/lib/cjs/components/StatusIcon/StatusIcon.mdx +4 -3
- package/lib/cjs/components/Stepper/Stepper.mdx +18 -20
- package/lib/cjs/components/SwitchField/SwitchField.mdx +9 -14
- package/lib/cjs/components/Tabs/Tabs.mdx +13 -18
- package/lib/cjs/components/TextAreaField/TextAreaField.mdx +8 -12
- package/lib/cjs/components/TextField/TextField.mdx +8 -12
- package/lib/cjs/components/TimeField/TimeField.mdx +12 -18
- package/lib/cjs/components/TooltipTrigger/TooltipTrigger.mdx +4 -3
- package/lib/cjs/types/accessibilityTable.d.ts +8 -0
- package/lib/cjs/types/accessibilityTable.js +6 -0
- package/lib/cjs/types/index.d.ts +1 -0
- package/lib/cjs/types/index.js +75 -64
- package/lib/cjs/utils/docUtils/AccessibilityTable.d.ts +3 -0
- package/lib/cjs/utils/docUtils/AccessibilityTable.js +38 -0
- package/lib/cjs/utils/docUtils/AccessibilityTable.test.js +192 -0
- package/lib/cjs/utils/docUtils/accessibilityTableConstants.d.ts +130 -0
- package/lib/cjs/utils/docUtils/accessibilityTableConstants.js +137 -0
- package/lib/components/AIComponents/PromptInput/PromptInputReadMe.mdx +12 -15
- package/lib/components/AccordionGridGroup/AccordionGridGroup.mdx +13 -19
- package/lib/components/AccordionGroup/AccordionGroup.mdx +16 -17
- package/lib/components/ArrayField/ArrayField.mdx +10 -15
- package/lib/components/Badge/Badge.mdx +6 -8
- package/lib/components/Breadcrumbs/Breadcrumbs.mdx +11 -17
- package/lib/components/Button/Button.mdx +8 -12
- package/lib/components/Calendar/Calendar.mdx +17 -22
- package/lib/components/Callout/Callout.mdx +8 -13
- package/lib/components/Card/Card.mdx +6 -8
- package/lib/components/CheckboxField/CheckboxField.mdx +11 -16
- package/lib/components/CodeEditor/CodeEditor.mdx +8 -13
- package/lib/components/CodeView/CodeView.mdx +5 -8
- package/lib/components/CollapsiblePanel/CollapsiblePanel.mdx +10 -13
- package/lib/components/ColorField/ColorField.mdx +13 -18
- package/lib/components/ComboBoxField/ComboBoxField.mdx +13 -15
- package/lib/components/CopyText/CopyText.mdx +6 -8
- package/lib/components/DataTable/DataTable.mdx +17 -22
- package/lib/components/DatePicker/DatePicker.mdx +20 -27
- package/lib/components/EnvironmentBreadcrumb/EnvironmentBreadcrumb.mdx +14 -19
- package/lib/components/ExpandableText/ExpandableText.mdx +9 -15
- package/lib/components/FileInputField/FileInputField.mdx +11 -16
- package/lib/components/Footer/Footer.mdx +9 -14
- package/lib/components/GridList/GridList.mdx +16 -21
- package/lib/components/HelpHint/HelpHint.mdx +8 -14
- package/lib/components/Icon/Icon.mdx +5 -3
- package/lib/components/IconButton/IconButton.mdx +7 -10
- package/lib/components/IconButtonToggle/IconButtonToggle.mdx +9 -15
- package/lib/components/Image/Image.mdx +4 -4
- package/lib/components/ImageUploadField/ImageUploadField.mdx +18 -24
- package/lib/components/Link/Link.mdx +5 -6
- package/lib/components/LinkSelectField/LinkSelectField.mdx +18 -24
- package/lib/components/ListItem/ListItem.mdx +6 -6
- package/lib/components/ListView/ListView.mdx +22 -23
- package/lib/components/Loader/Loader.mdx +6 -5
- package/lib/components/Menu/Menu.mdx +13 -18
- package/lib/components/Messages/Messages.mdx +9 -13
- package/lib/components/Modal/Modal.mdx +18 -19
- package/lib/components/MultivaluesField/MultivaluesField.mdx +14 -20
- package/lib/components/NavBar/NavBar.mdx +12 -17
- package/lib/components/NavSideBar/NavSideBar.mdx +12 -17
- package/lib/components/NavigationHeader/NavigationHeader.mdx +11 -16
- package/lib/components/NumberField/NumberField.mdx +16 -17
- package/lib/components/OverlayPanel/OverlayPanel.mdx +10 -14
- package/lib/components/Pagination/Pagination.mdx +9 -13
- package/lib/components/PasswordField/PasswordField.mdx +10 -15
- package/lib/components/PopoverMenu/PopoverMenu.mdx +16 -22
- package/lib/components/ProgressBar/ProgressBar.mdx +6 -7
- package/lib/components/RadioGroupField/RadioGroupField.mdx +11 -17
- package/lib/components/RangeCalendar/RangeCalendar.mdx +17 -22
- package/lib/components/RockerButtonGroup/RockerButtonGroup.mdx +11 -16
- package/lib/components/SearchField/SearchField.mdx +8 -10
- package/lib/components/SelectField/SelectField.mdx +18 -23
- package/lib/components/Separator/Separator.mdx +4 -3
- package/lib/components/ServerErrorBoundary/ServerErrorBoundary.mdx +6 -8
- package/lib/components/SliderField/SliderField.mdx +12 -15
- package/lib/components/StatusIcon/StatusIcon.mdx +4 -3
- package/lib/components/Stepper/Stepper.mdx +18 -20
- package/lib/components/SwitchField/SwitchField.mdx +9 -14
- package/lib/components/Tabs/Tabs.mdx +13 -18
- package/lib/components/TextAreaField/TextAreaField.mdx +8 -12
- package/lib/components/TextField/TextField.mdx +8 -12
- package/lib/components/TimeField/TimeField.mdx +12 -18
- package/lib/components/TooltipTrigger/TooltipTrigger.mdx +4 -3
- package/lib/types/accessibilityTable.js +1 -0
- package/lib/types/index.js +1 -0
- package/lib/utils/docUtils/AccessibilityTable.js +30 -0
- package/lib/utils/docUtils/AccessibilityTable.test.js +190 -0
- package/lib/utils/docUtils/accessibilityTableConstants.js +130 -0
- package/package.json +1 -1
|
@@ -1,5 +1,7 @@
|
|
|
1
1
|
import { Meta } from '@storybook/addon-docs/blocks';
|
|
2
2
|
import * as BreadcrumbsStories from './Breadcrumbs.stories';
|
|
3
|
+
import AccessibilityTable from '../../utils/docUtils/AccessibilityTable';
|
|
4
|
+
import { KeyboardRows } from '../../utils/docUtils/accessibilityTableConstants';
|
|
3
5
|
|
|
4
6
|
<Meta of={BreadcrumbsStories} isTemplate />
|
|
5
7
|
|
|
@@ -22,20 +24,12 @@ This component requires Item originating from [react-stately/collections](https:
|
|
|
22
24
|
|
|
23
25
|
This component should adhere to the [WAI-ARIA Breadcrumbs](https://www.w3.org/WAI/ARIA/apg/example-index/breadcrumb/index.html) accessibility guidelines.
|
|
24
26
|
|
|
25
|
-
|
|
26
|
-
|
|
27
|
-
|
|
28
|
-
|
|
29
|
-
|
|
30
|
-
|
|
31
|
-
|
|
32
|
-
|
|
33
|
-
|
|
34
|
-
|
|
35
|
-
#### Screen readers
|
|
36
|
-
|
|
37
|
-
This component uses the following attributes to assist screen readers:
|
|
38
|
-
|
|
39
|
-
- The Breadcrumbs and BreadcrumbItems components use the **`aria-label`** attribute to provide an accessible name.
|
|
40
|
-
- The Icon component uses the **`aria-hidden`** attribute to hide its content from assistive technology.
|
|
41
|
-
- The last BreadcrumbItem component uses the **`aria-current`** attribute to indicate that the user is currently viewing that page.
|
|
27
|
+
<AccessibilityTable keyboardRows={[
|
|
28
|
+
{ key: 'Space or Enter', description: 'Selects the item and navigates to the associated location.' },
|
|
29
|
+
KeyboardRows.tabNextFocusableComponent,
|
|
30
|
+
KeyboardRows.shiftTabFocusPrevious,
|
|
31
|
+
]} screenReaderRows={[
|
|
32
|
+
'The Breadcrumbs and BreadcrumbItems components use the **`aria-label`** attribute to provide an accessible name.',
|
|
33
|
+
'The Icon component uses the **`aria-hidden`** attribute to hide its content from assistive technology.',
|
|
34
|
+
'The last BreadcrumbItem component uses the **`aria-current`** attribute to indicate that the user is currently viewing that page.',
|
|
35
|
+
]} />
|
|
@@ -1,5 +1,7 @@
|
|
|
1
1
|
import { Meta } from '@storybook/addon-docs/blocks';
|
|
2
2
|
import * as ButtonStories from './Button.stories';
|
|
3
|
+
import AccessibilityTable from '../../utils/docUtils/AccessibilityTable';
|
|
4
|
+
import { KeyboardRows, ScreenReaderRows } from '../../utils/docUtils/accessibilityTableConstants';
|
|
3
5
|
|
|
4
6
|
<Meta of={ButtonStories} isTemplate />
|
|
5
7
|
|
|
@@ -26,16 +28,10 @@ This component can be used independently and does not require additional compone
|
|
|
26
28
|
|
|
27
29
|
This component should adhere to the [WAI-ARIA Button](https://www.w3.org/TR/wai-aria-practices-1.1/examples/button/button.html) accessibility guidelines.
|
|
28
30
|
|
|
29
|
-
|
|
30
|
-
|
|
31
|
-
|
|
32
|
-
|
|
33
|
-
|
|
34
|
-
|
|
35
|
-
| Space or Enter | Selects the button. |
|
|
36
|
-
| Tab | Focuses the button and follows the page tab sequence. |
|
|
37
|
-
|
|
38
|
-
#### Screen readers.
|
|
39
|
-
|
|
40
|
-
This component uses the **`aria-label`** attribute to provide an accessible name.
|
|
31
|
+
<AccessibilityTable keyboardRows={[
|
|
32
|
+
KeyboardRows.spaceEnterSelectsButton,
|
|
33
|
+
KeyboardRows.tabFocusesButton,
|
|
34
|
+
]} screenReaderRows={[
|
|
35
|
+
ScreenReaderRows.componentAriaLabel,
|
|
36
|
+
]} />
|
|
41
37
|
|
|
@@ -1,4 +1,6 @@
|
|
|
1
1
|
import { Meta } from '@storybook/addon-docs/blocks';
|
|
2
|
+
import AccessibilityTable from '../../utils/docUtils/AccessibilityTable';
|
|
3
|
+
import { KeyboardRows, ScreenReaderRows } from '../../utils/docUtils/accessibilityTableConstants';
|
|
2
4
|
|
|
3
5
|
<Meta title="Components/Calendar/Calendar" />
|
|
4
6
|
|
|
@@ -15,25 +17,18 @@ This component can be used independently and does not require additional compone
|
|
|
15
17
|
|
|
16
18
|
### Accessibility
|
|
17
19
|
|
|
18
|
-
|
|
19
|
-
|
|
20
|
-
|
|
21
|
-
|
|
22
|
-
|
|
23
|
-
|
|
24
|
-
|
|
25
|
-
|
|
26
|
-
|
|
27
|
-
|
|
28
|
-
|
|
29
|
-
|
|
30
|
-
|
|
31
|
-
|
|
32
|
-
|
|
33
|
-
| Shift+ page down | Changes the grid of dates to the same month in the next year. |
|
|
34
|
-
|
|
35
|
-
#### Screen Readers
|
|
36
|
-
|
|
37
|
-
This component uses the following attributes to assist screen readers:
|
|
38
|
-
- The **`aria-label`** attribute is used to provide an accessible name.
|
|
39
|
-
- In each data cell, the **`aria-selected`** attribute is set to “true” when a date is selected, and **`aria-disabled`** is set to “false” by default.
|
|
20
|
+
<AccessibilityTable keyboardRows={[
|
|
21
|
+
{ key: 'Space or Enter', description: 'Selects the date when a date is focused, and navigates to the calendar pages when the navigational buttons are focused.' },
|
|
22
|
+
KeyboardRows.tabCalendar,
|
|
23
|
+
KeyboardRows.shiftTabFocusPrevious,
|
|
24
|
+
KeyboardRows.homeFirstCalendarDate,
|
|
25
|
+
{ key: 'Pressing End:(Fn + left Arrow Key) Or Control or Command + End', description: 'Shifts the focus to the last calendar date.' },
|
|
26
|
+
{ key: 'Arrow key', description: 'Navigates up, down, right, and left across the calendar.' },
|
|
27
|
+
KeyboardRows.pageUpPreviousMonth,
|
|
28
|
+
KeyboardRows.pageDownNextMonth,
|
|
29
|
+
KeyboardRows.shiftPageUpPreviousYear,
|
|
30
|
+
KeyboardRows.shiftPageDownNextYear,
|
|
31
|
+
]} screenReaderRows={[
|
|
32
|
+
ScreenReaderRows.ariaLabelAccessibleName,
|
|
33
|
+
'In each data cell, the **`aria-selected`** attribute is set to “true” when a date is selected, and **`aria-disabled`** is set to “false” by default.',
|
|
34
|
+
]} />
|
|
@@ -1,5 +1,7 @@
|
|
|
1
1
|
import { Meta } from '@storybook/addon-docs/blocks';
|
|
2
2
|
import * as CalloutStories from './Callout.stories';
|
|
3
|
+
import AccessibilityTable from '../../utils/docUtils/AccessibilityTable';
|
|
4
|
+
import { ScreenReaderRows } from '../../utils/docUtils/accessibilityTableConstants';
|
|
3
5
|
|
|
4
6
|
<Meta of={CalloutStories} isTemplate />
|
|
5
7
|
|
|
@@ -14,16 +16,9 @@ This component requires the [Text](./?path=/docs/components-text--default) compo
|
|
|
14
16
|
|
|
15
17
|
### Accessibility
|
|
16
18
|
|
|
17
|
-
|
|
18
|
-
|
|
19
|
-
|
|
20
|
-
|
|
21
|
-
|
|
22
|
-
|
|
23
|
-
| ---- | --------- |
|
|
24
|
-
| Space or Enter | Selects the component within. |
|
|
25
|
-
| Tab | Focuses the component within and follows the page tab sequence. |
|
|
26
|
-
|
|
27
|
-
#### Screen readers
|
|
28
|
-
|
|
29
|
-
This component uses the **`aria-label`** attribute to provide an accessible name.
|
|
19
|
+
<AccessibilityTable keyboardRows={[
|
|
20
|
+
{ key: 'Space or Enter', description: 'Selects the component within.' },
|
|
21
|
+
{ key: 'Tab', description: 'Focuses the component within and follows the page tab sequence.' },
|
|
22
|
+
]} screenReaderRows={[
|
|
23
|
+
ScreenReaderRows.componentAriaLabel,
|
|
24
|
+
]} keyboardDescription="The callout itself is not focusable but the components within it are. These keys provide additional functionality to the component." />
|
|
@@ -1,5 +1,7 @@
|
|
|
1
1
|
import { Meta } from '@storybook/addon-docs/blocks';
|
|
2
2
|
import * as CardStories from './Card.stories';
|
|
3
|
+
import AccessibilityTable from '../../utils/docUtils/AccessibilityTable';
|
|
4
|
+
import { KeyboardRows } from '../../utils/docUtils/accessibilityTableConstants';
|
|
3
5
|
|
|
4
6
|
<Meta of={CardStories} isTemplate />
|
|
5
7
|
|
|
@@ -23,14 +25,10 @@ This component can be used independently and does not require additional compone
|
|
|
23
25
|
|
|
24
26
|
### Accessibility
|
|
25
27
|
|
|
26
|
-
|
|
27
|
-
|
|
28
|
-
|
|
29
|
-
|
|
30
|
-
| Keys | Functions |
|
|
31
|
-
| ---- | --------- |
|
|
32
|
-
| Space or Enter | Selects the button. |
|
|
33
|
-
| Tab | Focuses the button and follows the page tab sequence.|
|
|
28
|
+
<AccessibilityTable keyboardRows={[
|
|
29
|
+
KeyboardRows.spaceEnterSelectsButton,
|
|
30
|
+
KeyboardRows.tabFocusesButton,
|
|
31
|
+
]} keyboardDescription="These keys provide additional functionality to the Interactive Card components." />
|
|
34
32
|
|
|
35
33
|
### Note
|
|
36
34
|
|
|
@@ -1,5 +1,7 @@
|
|
|
1
1
|
import { Meta } from '@storybook/addon-docs/blocks';
|
|
2
2
|
import * as CheckboxFieldStories from './CheckboxField.stories';
|
|
3
|
+
import AccessibilityTable from '../../utils/docUtils/AccessibilityTable';
|
|
4
|
+
import { KeyboardRows } from '../../utils/docUtils/accessibilityTableConstants';
|
|
3
5
|
|
|
4
6
|
<Meta of={CheckboxFieldStories} isTemplate />
|
|
5
7
|
|
|
@@ -25,19 +27,12 @@ This component can be used independently and does not require additional compone
|
|
|
25
27
|
|
|
26
28
|
This component should adhere to the [WAI-ARIA Checkbox](https://www.w3.org/WAI/ARIA/apg/patterns/checkbox/) accessibility guidelines.
|
|
27
29
|
|
|
28
|
-
|
|
29
|
-
|
|
30
|
-
|
|
31
|
-
|
|
32
|
-
|
|
33
|
-
|
|
34
|
-
|
|
35
|
-
|
|
36
|
-
|
|
37
|
-
|
|
38
|
-
#### Screen Readers
|
|
39
|
-
|
|
40
|
-
This component uses the following attributes to assist screen readers:
|
|
41
|
-
- The **`aria-checked`** attribute is used to indicate the current checked status.
|
|
42
|
-
- The **`aria-labelledby`** attribute is provided with the label ID to reference it.
|
|
43
|
-
- The **`aria-hidden`** attribute is used to hide its content from assistive technology.
|
|
30
|
+
<AccessibilityTable keyboardRows={[
|
|
31
|
+
{ key: 'Space', description: 'When focused, toggles the check box on and off.' },
|
|
32
|
+
KeyboardRows.tabNextFocusableComponent,
|
|
33
|
+
KeyboardRows.shiftTabFocusPrevious,
|
|
34
|
+
]} screenReaderRows={[
|
|
35
|
+
'The **`aria-checked`** attribute is used to indicate the current checked status.',
|
|
36
|
+
'The **`aria-labelledby`** attribute is provided with the label ID to reference it.',
|
|
37
|
+
'The **`aria-hidden`** attribute is used to hide its content from assistive technology.',
|
|
38
|
+
]} />
|
|
@@ -1,5 +1,7 @@
|
|
|
1
1
|
import { Meta } from '@storybook/addon-docs/blocks';
|
|
2
2
|
import * as CodeEditorStories from './CodeEditor.stories';
|
|
3
|
+
import AccessibilityTable from '../../utils/docUtils/AccessibilityTable';
|
|
4
|
+
import { ScreenReaderRows } from '../../utils/docUtils/accessibilityTableConstants';
|
|
3
5
|
|
|
4
6
|
<Meta of={CodeEditorStories} isTemplate />
|
|
5
7
|
|
|
@@ -21,16 +23,9 @@ This component can be used independently and does not require additional compone
|
|
|
21
23
|
|
|
22
24
|
### Accessibility
|
|
23
25
|
|
|
24
|
-
|
|
25
|
-
|
|
26
|
-
|
|
27
|
-
|
|
28
|
-
|
|
29
|
-
|
|
30
|
-
| Enter | Inserts a new line of code |
|
|
31
|
-
| Arrow keys | Move the cursor within the code in the set direction |
|
|
32
|
-
|
|
33
|
-
#### Screen Readers
|
|
34
|
-
|
|
35
|
-
The **`aria-live`** attribute is used to announce content changes in a live region.
|
|
36
|
-
|
|
26
|
+
<AccessibilityTable keyboardRows={[
|
|
27
|
+
{ key: 'Enter', description: 'Inserts a new line of code' },
|
|
28
|
+
{ key: 'Arrow keys', description: 'Move the cursor within the code in the set direction' },
|
|
29
|
+
]} screenReaderRows={[
|
|
30
|
+
ScreenReaderRows.ariaLiveAnnounce,
|
|
31
|
+
]} />
|
|
@@ -1,5 +1,6 @@
|
|
|
1
1
|
import { Meta } from '@storybook/addon-docs/blocks';
|
|
2
2
|
import * as CodeViewStories from './CodeView.stories';
|
|
3
|
+
import AccessibilityTable from '../../utils/docUtils/AccessibilityTable';
|
|
3
4
|
|
|
4
5
|
<Meta of={CodeViewStories} isTemplate />
|
|
5
6
|
|
|
@@ -17,11 +18,7 @@ This component requires the [Text](./?path=/docs/components-text--default) compo
|
|
|
17
18
|
|
|
18
19
|
### Accessibility
|
|
19
20
|
|
|
20
|
-
|
|
21
|
-
|
|
22
|
-
|
|
23
|
-
|
|
24
|
-
| Keys | Functions |
|
|
25
|
-
| ---- | --------- |
|
|
26
|
-
| Space or Enter | Selects the CopyButton inside the CodeView component. |
|
|
27
|
-
| Tab | Focuses the CopyButton inside the CodeView component. |
|
|
21
|
+
<AccessibilityTable keyboardRows={[
|
|
22
|
+
{ key: 'Space or Enter', description: 'Selects the CopyButton inside the CodeView component.' },
|
|
23
|
+
{ key: 'Tab', description: 'Focuses the CopyButton inside the CodeView component.' },
|
|
24
|
+
]} />
|
|
@@ -1,5 +1,7 @@
|
|
|
1
1
|
import { Meta } from '@storybook/addon-docs/blocks';
|
|
2
2
|
import * as CollapsiblePanelStories from './CollapsiblePanel.stories';
|
|
3
|
+
import AccessibilityTable from '../../utils/docUtils/AccessibilityTable';
|
|
4
|
+
import { KeyboardRows } from '../../utils/docUtils/accessibilityTableConstants';
|
|
3
5
|
|
|
4
6
|
<Meta of={CollapsiblePanelStories} isTemplate />
|
|
5
7
|
|
|
@@ -13,18 +15,13 @@ This component can be used independently and does not require additional compone
|
|
|
13
15
|
|
|
14
16
|
### Accessibility
|
|
15
17
|
|
|
16
|
-
|
|
17
|
-
|
|
18
|
-
|
|
19
|
-
|
|
20
|
-
|
|
21
|
-
|
|
22
|
-
|
|
23
|
-
|
|
24
|
-
| Shift + Tab | Moves focus to the previous focusable component. |
|
|
25
|
-
| Esc | Pressing the escape key closes the panel when it is expanded. |
|
|
26
|
-
|
|
27
|
-
#### Screen Readers
|
|
28
|
-
This component uses the **`aria-rowcount`** and **`aria-columncount`** attributes to indicate the total number of rows and columns in the grid structure.
|
|
18
|
+
<AccessibilityTable keyboardRows={[
|
|
19
|
+
{ key: 'Space or Enter', description: 'Expands or collapses the content when the trigger is focused.' },
|
|
20
|
+
{ key: 'Tab', description: 'Focuses the trigger button and the panel content.' },
|
|
21
|
+
KeyboardRows.shiftTabFocusPrevious,
|
|
22
|
+
{ key: 'Esc', description: 'Pressing the escape key closes the panel when it is expanded.' },
|
|
23
|
+
]} screenReaderRows={[
|
|
24
|
+
'This component uses the **`aria-rowcount`** and **`aria-columncount`** attributes to indicate the total number of rows and columns in the grid structure.',
|
|
25
|
+
]} />
|
|
29
26
|
|
|
30
27
|
|
|
@@ -1,5 +1,7 @@
|
|
|
1
1
|
import { Meta } from '@storybook/addon-docs/blocks';
|
|
2
2
|
import * as ColorFieldStories from './ColorField.stories';
|
|
3
|
+
import AccessibilityTable from '../../utils/docUtils/AccessibilityTable';
|
|
4
|
+
import { KeyboardRows } from '../../utils/docUtils/accessibilityTableConstants';
|
|
3
5
|
|
|
4
6
|
<Meta of={ColorFieldStories} isTemplate />
|
|
5
7
|
|
|
@@ -20,21 +22,14 @@ react-aria [OverlayProvider](https://react-spectrum.adobe.com/react-aria/useOver
|
|
|
20
22
|
|
|
21
23
|
### Accessibility
|
|
22
24
|
|
|
23
|
-
|
|
24
|
-
|
|
25
|
-
|
|
26
|
-
|
|
27
|
-
|
|
28
|
-
|
|
29
|
-
|
|
30
|
-
|
|
31
|
-
|
|
32
|
-
|
|
33
|
-
|
|
34
|
-
|
|
35
|
-
#### Screen Readers
|
|
36
|
-
|
|
37
|
-
This component uses the following attributes to assist screen readers:
|
|
38
|
-
- The trigger button uses the **`aria-expanded`** attribute to indicate the expansion and collapse of Sketch Picker.
|
|
39
|
-
- When expanded, **`aria-controls`** is added to the button pointing to the Sketch Picker.
|
|
40
|
-
- The visibly hidden input uses the **`aria-labelledby`** attribute supplied with label ID.
|
|
25
|
+
<AccessibilityTable keyboardRows={[
|
|
26
|
+
{ key: 'Tab', description: 'Focuses the color swatch and follows the page tab sequence.' },
|
|
27
|
+
KeyboardRows.shiftTabFocusPrevious,
|
|
28
|
+
{ key: 'Space or Enter', description: 'Opens the color swatch when it is focused. Once opened, the focus moves to the input field and is locked inside the ColorPicker Overlay.' },
|
|
29
|
+
{ key: 'Esc', description: 'When the picker is open, pressing the escape key closes the overlay and focuses on the previously focused component.' },
|
|
30
|
+
{ key: 'Up and Down Arrows', description: 'Using the up and down arrows on any of the RGBA inputs adjusts the value of the input in focus.' },
|
|
31
|
+
]} screenReaderRows={[
|
|
32
|
+
'The trigger button uses the **`aria-expanded`** attribute to indicate the expansion and collapse of Sketch Picker.',
|
|
33
|
+
'When expanded, **`aria-controls`** is added to the button pointing to the Sketch Picker.',
|
|
34
|
+
'The visibly hidden input uses the **`aria-labelledby`** attribute supplied with label ID.',
|
|
35
|
+
]} />
|
|
@@ -1,5 +1,7 @@
|
|
|
1
1
|
import { Meta } from '@storybook/addon-docs/blocks';
|
|
2
2
|
import * as ComboBoxFieldStories from './ComboBoxField.stories';
|
|
3
|
+
import AccessibilityTable from '../../utils/docUtils/AccessibilityTable';
|
|
4
|
+
import { KeyboardRows } from '../../utils/docUtils/accessibilityTableConstants';
|
|
3
5
|
|
|
4
6
|
<Meta of={ComboBoxFieldStories} isTemplate />
|
|
5
7
|
|
|
@@ -27,21 +29,17 @@ exported from Astro and Item originating from [react-stately/collections](https:
|
|
|
27
29
|
|
|
28
30
|
This component should adhere to the [WAI-ARIA ComboBox](https://www.w3.org/WAI/ARIA/apg/patterns/combobox/) accessibility guidelines.
|
|
29
31
|
|
|
30
|
-
|
|
31
|
-
|
|
32
|
-
|
|
33
|
-
|
|
34
|
-
|
|
35
|
-
|
|
36
|
-
|
|
37
|
-
|
|
38
|
-
|
|
39
|
-
|
|
40
|
-
|
|
41
|
-
| Typing in input field | Adds focus to it and opens the popover. |
|
|
42
|
-
| Home(Fn + Right Arrow Key) Or Control/Command + Home | Shifts the focus to the first item in the listbox. |
|
|
43
|
-
| End(Fn + Left Arrow Key) Or Control/Command + End | Shifts the focus to the last item in the listbox. |
|
|
44
|
-
| Esc | Pressing the escape key closes the overlay and adds focus to the previously focused component. |
|
|
32
|
+
<AccessibilityTable keyboardRows={[
|
|
33
|
+
KeyboardRows.tabFocusesField,
|
|
34
|
+
KeyboardRows.shiftTabFocusPrevious,
|
|
35
|
+
KeyboardRows.spaceEnterSelectsComponent,
|
|
36
|
+
{ key: 'Down arrow', description: "Opens the popover if it isn’t already open." },
|
|
37
|
+
{ key: 'Up and down arrows', description: 'Can be used to move through the selection in the popover.' },
|
|
38
|
+
KeyboardRows.typingOpenPopover,
|
|
39
|
+
KeyboardRows.homeFirstListboxItem,
|
|
40
|
+
KeyboardRows.endLastListboxItem,
|
|
41
|
+
{ key: 'Esc', description: 'Pressing the escape key closes the overlay and adds focus to the previously focused component.' }
|
|
42
|
+
]} />
|
|
45
43
|
|
|
46
44
|
#### Screen Readers
|
|
47
45
|
This component uses the following attributes to assist screen readers:
|
|
@@ -1,5 +1,7 @@
|
|
|
1
1
|
import { Meta } from '@storybook/addon-docs/blocks';
|
|
2
2
|
import * as CopyTextStories from './CopyText.stories';
|
|
3
|
+
import AccessibilityTable from '../../utils/docUtils/AccessibilityTable';
|
|
4
|
+
import { KeyboardRows } from '../../utils/docUtils/accessibilityTableConstants';
|
|
3
5
|
|
|
4
6
|
<Meta of={CopyTextStories} isTemplate />
|
|
5
7
|
|
|
@@ -14,11 +16,7 @@ This component requires the [Text](./?path=/docs/components-text--default) compo
|
|
|
14
16
|
|
|
15
17
|
### Accessibility
|
|
16
18
|
|
|
17
|
-
|
|
18
|
-
|
|
19
|
-
|
|
20
|
-
|
|
21
|
-
| Keys | Functions |
|
|
22
|
-
| ---- | --------- |
|
|
23
|
-
| Space or Enter | Selects the button. |
|
|
24
|
-
| Tab | Focuses the button and follows the page tab sequence.|
|
|
19
|
+
<AccessibilityTable keyboardRows={[
|
|
20
|
+
KeyboardRows.spaceEnterSelectsButton,
|
|
21
|
+
KeyboardRows.tabFocusesButton,
|
|
22
|
+
]} />
|
|
@@ -1,5 +1,7 @@
|
|
|
1
1
|
import { Meta } from '@storybook/addon-docs/blocks';
|
|
2
2
|
import * as DataTableStories from './DataTable.stories';
|
|
3
|
+
import AccessibilityTable from '../../utils/docUtils/AccessibilityTable';
|
|
4
|
+
import { KeyboardRows, ScreenReaderRows } from '../../utils/docUtils/accessibilityTableConstants';
|
|
3
5
|
|
|
4
6
|
<Meta of={DataTableStories} isTemplate />
|
|
5
7
|
|
|
@@ -30,26 +32,19 @@ This component requires these additional React Spectrum components:
|
|
|
30
32
|
|
|
31
33
|
### Accessibility
|
|
32
34
|
|
|
33
|
-
|
|
34
|
-
|
|
35
|
-
|
|
36
|
-
|
|
37
|
-
|
|
38
|
-
|
|
39
|
-
|
|
40
|
-
|
|
41
|
-
|
|
42
|
-
|
|
43
|
-
|
|
44
|
-
|
|
45
|
-
|
|
46
|
-
|
|
47
|
-
|
|
48
|
-
|
|
49
|
-
This component uses the following attributes to assist screen readers:
|
|
50
|
-
- The **`aria-label`** attribute is used to provide an accessible name.
|
|
51
|
-
- The **`aria-rowcount`** and **`aria-columncount`** attributes are used to indicate the total number of rows and columns in the grid structure.
|
|
52
|
-
- The DataTableHeader uses the **`aria-rowindex`** attribute and DataTableColumn uses the **`aria-colindex`** attribute to enumerate the header row and columns.
|
|
53
|
-
- In the body component, the DataTableRow uses the **`aria-labelledby`** attribute and the grid ID to identify the component and the **`aria-rowindex`** attribute is passed to each row.
|
|
54
|
-
- Each DataTableCell uses the **`aria-colindex`** attribute to enumerate the columns within each row.
|
|
35
|
+
<AccessibilityTable keyboardRows={[
|
|
36
|
+
{ key: 'Tab', description: 'Moves focus to the next focusable component. All focusable components in the table are included in the page tab sequence.' },
|
|
37
|
+
KeyboardRows.shiftTabFocusPrevious,
|
|
38
|
+
{ key: 'Space or Enter', description: 'Focuses the component and triggers an action if one is associated with it.' },
|
|
39
|
+
{ key: 'Arrow keys', description: 'Can be used to navigate between the components in the table.' },
|
|
40
|
+
{ key: 'Focus on a row and scroll down', description: 'Shifts the focus to the entire table, not the previously focused row.' },
|
|
41
|
+
{ key: 'Home or page up', description: 'Shifts the focus to the first row.' },
|
|
42
|
+
{ key: 'End or page down', description: 'Shifts the focus to the last visible row.' },
|
|
43
|
+
]} screenReaderRows={[
|
|
44
|
+
ScreenReaderRows.ariaLabelAccessibleName,
|
|
45
|
+
'The **`aria-rowcount`** and **`aria-columncount`** attributes are used to indicate the total number of rows and columns in the grid structure.',
|
|
46
|
+
'The DataTableHeader uses the **`aria-rowindex`** attribute and DataTableColumn uses the **`aria-colindex`** attribute to enumerate the header row and columns.',
|
|
47
|
+
'In the body component, the DataTableRow uses the **`aria-labelledby`** attribute and the grid ID to identify the component and the **`aria-rowindex`** attribute is passed to each row.',
|
|
48
|
+
'Each DataTableCell uses the **`aria-colindex`** attribute to enumerate the columns within each row.',
|
|
49
|
+
]} />
|
|
55
50
|
|
|
@@ -1,5 +1,7 @@
|
|
|
1
1
|
import { Meta } from '@storybook/addon-docs/blocks';
|
|
2
2
|
import * as DatePickerStories from './DatePicker.stories';
|
|
3
|
+
import AccessibilityTable from '../../utils/docUtils/AccessibilityTable';
|
|
4
|
+
import { KeyboardRows } from '../../utils/docUtils/accessibilityTableConstants';
|
|
3
5
|
|
|
4
6
|
<Meta of={DatePickerStories} isTemplate />
|
|
5
7
|
|
|
@@ -21,30 +23,21 @@ This component can be used independently and does not require additional compone
|
|
|
21
23
|
|
|
22
24
|
This component should adhere to the [WAI-ARIA DatePicker](https://www.w3.org/WAI/ARIA/apg/patterns/dialog-modal/examples/datepicker-dialog/) accessibility guidelines.
|
|
23
25
|
|
|
24
|
-
|
|
25
|
-
|
|
26
|
-
|
|
27
|
-
|
|
28
|
-
|
|
29
|
-
|
|
30
|
-
|
|
31
|
-
|
|
32
|
-
|
|
33
|
-
|
|
34
|
-
|
|
35
|
-
|
|
36
|
-
|
|
37
|
-
|
|
38
|
-
|
|
39
|
-
|
|
40
|
-
|
|
41
|
-
|
|
42
|
-
|
|
43
|
-
#### Screen Readers
|
|
44
|
-
|
|
45
|
-
This component uses the following attributes to assist screen readers:
|
|
46
|
-
|
|
47
|
-
- The hidden input, DateField, and all three spin buttons have an **`aria-labelledby`** attribute pointing to the label ID, along with the **`aria-label`** attribute for an accessible name.
|
|
48
|
-
- Each spin button has the **`aria-valuenow`** attribute that defines the current value and it is always used with its text alternative, **`aria-valuetext`**.
|
|
49
|
-
The spin buttons also have the **`aria-valuemin`** and **`aria-valuemax`** attributes to specify the minimum and maximum values allowed for a range widget.
|
|
50
|
-
- The **`aria-selected`** attribute is added to the grid cell when a date is selected, and **`aria-disabled`** is set to “false” by default.
|
|
26
|
+
<AccessibilityTable keyboardRows={[
|
|
27
|
+
{ key: 'Space or Enter', description: 'Opens the popover when the trigger is focused, selects the date when a date is focused, and navigates to the calendar pages when the navigational buttons are focused.' },
|
|
28
|
+
KeyboardRows.tabFocusesField,
|
|
29
|
+
KeyboardRows.shiftTabFocusPrevious,
|
|
30
|
+
KeyboardRows.homeFirstCalendarDate,
|
|
31
|
+
{ key: 'Pressing Home:(Fn + left Arrow Key) Or Control or Command + End', description: 'Shifts the focus to the last calendar date.' },
|
|
32
|
+
{ key: 'Up and down Arrow keys', description: 'When segments are focused, it increments and decrements dates starting from the present day.' },
|
|
33
|
+
{ key: 'Left and right arrows', description: 'Moves focus between segments.' },
|
|
34
|
+
KeyboardRows.pageUpPreviousMonth,
|
|
35
|
+
KeyboardRows.pageDownNextMonth,
|
|
36
|
+
KeyboardRows.shiftPageUpPreviousYear,
|
|
37
|
+
KeyboardRows.shiftPageDownNextYear,
|
|
38
|
+
{ key: 'Esc', description: 'Closes the overlay and shifts focus to the trigger.' },
|
|
39
|
+
]} screenReaderRows={[
|
|
40
|
+
'The hidden input, DateField, and all three spin buttons have an **`aria-labelledby`** attribute pointing to the label ID, along with the **`aria-label`** attribute for an accessible name.',
|
|
41
|
+
'Each spin button has the **`aria-valuenow`** attribute that defines the current value and it is always used with its text alternative, **`aria-valuetext`**. The spin buttons also have the **`aria-valuemin`** and **`aria-valuemax`** attributes to specify the minimum and maximum values allowed for a range widget.',
|
|
42
|
+
'The **`aria-selected`** attribute is added to the grid cell when a date is selected, and **`aria-disabled`** is set to “false” by default.',
|
|
43
|
+
]} />
|
|
@@ -1,5 +1,7 @@
|
|
|
1
1
|
import { Meta } from '@storybook/addon-docs/blocks';
|
|
2
2
|
import * as EnvironmentBreadcrumbStories from './EnvironmentBreadcrumb.stories';
|
|
3
|
+
import AccessibilityTable from '../../utils/docUtils/AccessibilityTable';
|
|
4
|
+
import { KeyboardRows, ScreenReaderRows } from '../../utils/docUtils/accessibilityTableConstants';
|
|
3
5
|
|
|
4
6
|
<Meta of={EnvironmentBreadcrumbStories} isTemplate />
|
|
5
7
|
|
|
@@ -16,22 +18,15 @@ Item from [react-stately/collections](https://react-spectrum.adobe.com/react-sta
|
|
|
16
18
|
|
|
17
19
|
### Accessibility
|
|
18
20
|
|
|
19
|
-
|
|
20
|
-
|
|
21
|
-
|
|
22
|
-
|
|
23
|
-
|
|
24
|
-
|
|
25
|
-
|
|
26
|
-
|
|
27
|
-
|
|
28
|
-
|
|
29
|
-
|
|
30
|
-
|
|
31
|
-
#### Screen readers
|
|
32
|
-
|
|
33
|
-
This component uses the following attributes to assist screen readers:
|
|
34
|
-
- Each breadcrumb item uses an **`aria-label`** attribute to provide an accessible name.
|
|
35
|
-
- The trigger button uses the **`aria-expanded`** attribute to indicate when the content expands and collapses.
|
|
36
|
-
- When expanded, **`aria-controls`** is added to the button pointing to the pop-up content.
|
|
37
|
-
- The **`aria-haspopup`** attribute describes the type of content presented.
|
|
21
|
+
<AccessibilityTable keyboardRows={[
|
|
22
|
+
{ key: 'Space or Enter', description: 'Selects the breadcrumb item.' },
|
|
23
|
+
{ key: 'Tab', description: 'Focuses the breadcrumb item and follows the page tab sequence.' },
|
|
24
|
+
KeyboardRows.shiftTabFocusPrevious,
|
|
25
|
+
{ key: 'Arrow keys', description: 'Can be used to navigate between the items in the dropdown list.' },
|
|
26
|
+
{ key: 'Esc', description: 'Closes the popover when it is expanded.' },
|
|
27
|
+
]} screenReaderRows={[
|
|
28
|
+
'Each breadcrumb item uses an **`aria-label`** attribute to provide an accessible name.',
|
|
29
|
+
ScreenReaderRows.triggerAriaExpandedExpandCollapse,
|
|
30
|
+
'When expanded, **`aria-controls`** is added to the button pointing to the pop-up content.',
|
|
31
|
+
'The **`aria-haspopup`** attribute describes the type of content presented.',
|
|
32
|
+
]} />
|
|
@@ -1,5 +1,7 @@
|
|
|
1
1
|
import { Meta } from '@storybook/addon-docs/blocks';
|
|
2
2
|
import * as ExpandableTextStories from './ExpandableText.stories';
|
|
3
|
+
import AccessibilityTable from '../../utils/docUtils/AccessibilityTable';
|
|
4
|
+
import { KeyboardRows, ScreenReaderRows } from '../../utils/docUtils/accessibilityTableConstants';
|
|
3
5
|
|
|
4
6
|
<Meta of={ExpandableTextStories} isTemplate />
|
|
5
7
|
|
|
@@ -14,18 +16,10 @@ This component can be used independently and does not require additional compone
|
|
|
14
16
|
|
|
15
17
|
### Accessibility
|
|
16
18
|
|
|
17
|
-
|
|
18
|
-
|
|
19
|
-
|
|
20
|
-
|
|
21
|
-
|
|
22
|
-
|
|
23
|
-
|
|
24
|
-
| Tab | Focuses the button and follows the page tab sequence. |
|
|
25
|
-
|
|
26
|
-
|
|
27
|
-
#### Screen readers
|
|
28
|
-
|
|
29
|
-
This component uses the following attributes to assist screen readers:
|
|
30
|
-
- The trigger button uses the **`aria-expanded`** attribute to indicate when the content expands and collapses.
|
|
31
|
-
- The button uses, **`aria-controls`** which references the iD of the collapsible region.
|
|
19
|
+
<AccessibilityTable keyboardRows={[
|
|
20
|
+
KeyboardRows.spaceEnterSelectsButton,
|
|
21
|
+
KeyboardRows.tabFocusesButton,
|
|
22
|
+
]} screenReaderRows={[
|
|
23
|
+
ScreenReaderRows.triggerAriaExpandedExpandCollapse,
|
|
24
|
+
'The button uses, **`aria-controls`** which references the iD of the collapsible region.',
|
|
25
|
+
]} />
|