@pingux/astro 2.9.2 → 2.13.0-alpha.3
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/README.md +6 -2
- package/lib/README.md +6 -2
- package/lib/cjs/components/AccordionGridGroup/AccordionGridGroup.mdx +40 -0
- package/lib/cjs/components/AccordionGroup/Accordion.styles.js +1 -2
- package/lib/cjs/components/AccordionGroup/AccordionGroup.mdx +41 -0
- package/lib/cjs/components/ArrayField/ArrayField.mdx +34 -0
- package/lib/cjs/components/AstroWrapper/AstroWrapper.mdx +16 -0
- package/lib/cjs/components/Avatar/Avatar.mdx +14 -0
- package/lib/cjs/components/Badge/Badge.mdx +24 -0
- package/lib/cjs/components/Box/Box.d.ts +4 -0
- package/lib/cjs/components/Box/Box.js +4 -19
- package/lib/cjs/components/Box/Box.mdx +23 -0
- package/lib/cjs/components/Box/Box.styles.d.ts +6 -0
- package/lib/cjs/components/Box/Box.test.d.ts +1 -0
- package/lib/cjs/components/Box/Box.test.js +2 -6
- package/lib/cjs/components/Box/index.d.ts +1 -0
- package/lib/cjs/components/Bracket/Bracket.mdx +17 -0
- package/lib/cjs/components/Breadcrumbs/Breadcrumbs.mdx +40 -0
- package/lib/cjs/components/Button/Button.mdx +40 -0
- package/lib/cjs/components/Button/Button.stories.js +30 -5
- package/lib/cjs/components/Button/Buttons.styles.js +25 -7
- package/lib/cjs/components/Calendar/Calendar.mdx +39 -0
- package/lib/cjs/components/Callout/Callout.mdx +28 -0
- package/lib/cjs/components/Card/Card.mdx +32 -0
- package/lib/cjs/components/CheckboxField/CheckboxField.mdx +42 -0
- package/lib/cjs/components/CodeView/CodeView.mdx +23 -0
- package/lib/cjs/components/CollapsiblePanel/CollapsiblePanel.mdx +29 -0
- package/lib/cjs/components/ColorField/ColorField.mdx +38 -0
- package/lib/cjs/components/ComboBoxField/ComboBoxField.mdx +66 -0
- package/lib/cjs/components/CopyText/CopyText.mdx +23 -0
- package/lib/cjs/components/DataTable/DataTable.mdx +54 -0
- package/lib/cjs/components/DatePicker/DatePicker.mdx +49 -0
- package/lib/cjs/components/EnvironmentBreadcrumb/EnvironmentBreadcrumb.js +2 -1
- package/lib/cjs/components/EnvironmentBreadcrumb/EnvironmentBreadcrumb.mdx +36 -0
- package/lib/cjs/components/EnvironmentBreadcrumb/EnvironmentBreadcrumb.stories.js +29 -45
- package/lib/cjs/components/FileInputField/FileInputField.mdx +33 -0
- package/lib/cjs/components/HelpHint/HelpHint.mdx +32 -0
- package/lib/cjs/components/Icon/Icon.d.ts +4 -0
- package/lib/cjs/components/Icon/Icon.js +4 -27
- package/lib/cjs/components/Icon/Icon.mdx +49 -0
- package/lib/cjs/components/Icon/Icon.stories.d.ts +8 -0
- package/lib/cjs/components/Icon/Icon.test.d.ts +1 -0
- package/lib/cjs/components/Icon/index.d.ts +1 -0
- package/lib/cjs/components/IconBadge/IconBadge.mdx +14 -0
- package/lib/cjs/components/IconButton/IconButton.mdx +33 -0
- package/lib/cjs/components/IconButtonToggle/IconButtonToggle.mdx +31 -0
- package/lib/cjs/components/Image/Image.mdx +28 -0
- package/lib/cjs/components/ImageUploadField/ImageUploadField.mdx +38 -0
- package/lib/cjs/components/Link/Link.mdx +27 -0
- package/lib/cjs/components/LinkSelectField/LinkSelectField.mdx +47 -0
- package/lib/cjs/components/ListItem/ListItem.mdx +21 -0
- package/lib/cjs/components/ListView/ListView.mdx +44 -0
- package/lib/cjs/components/ListView/ListView.stories.js +93 -47
- package/lib/cjs/components/Loader/Loader.d.ts +4 -0
- package/lib/cjs/components/Loader/Loader.js +0 -14
- package/lib/cjs/components/Loader/Loader.mdx +29 -0
- package/lib/cjs/components/Loader/Loader.styles.d.ts +53 -0
- package/lib/cjs/components/Loader/Loader.test.d.ts +1 -0
- package/lib/cjs/components/Loader/index.d.ts +1 -0
- package/lib/cjs/components/Menu/Menu.mdx +43 -0
- package/lib/cjs/components/Messages/Messages.mdx +35 -0
- package/lib/cjs/components/Modal/Modal.mdx +59 -0
- package/lib/cjs/components/MultivaluesField/MultivaluesField.mdx +44 -0
- package/lib/cjs/components/NavBar/NavBar.mdx +42 -0
- package/lib/cjs/components/NumberField/NumberField.mdx +39 -0
- package/lib/cjs/components/OverlayPanel/OverlayPanel.mdx +39 -0
- package/lib/cjs/components/PasswordField/PasswordField.mdx +33 -0
- package/lib/cjs/components/PopoverContainer/PopoverContainer.d.ts +9 -0
- package/lib/cjs/components/PopoverContainer/PopoverContainer.js +7 -38
- package/lib/cjs/components/PopoverContainer/index.d.ts +2 -0
- package/lib/cjs/components/PopoverMenu/PopoverMenu.mdx +53 -0
- package/lib/cjs/components/RadioGroupField/RadioGroupField.mdx +41 -0
- package/lib/cjs/components/RequirementsList/RequirementsList.mdx +17 -0
- package/lib/cjs/components/RockerButtonGroup/RockerButtonGroup.mdx +36 -0
- package/lib/cjs/components/ScrollBox/ScrollBox.mdx +17 -0
- package/lib/cjs/components/SearchField/SearchField.mdx +33 -0
- package/lib/cjs/components/SelectField/SelectField.mdx +46 -0
- package/lib/cjs/components/Separator/Separator.mdx +19 -0
- package/lib/cjs/components/Stepper/Stepper.mdx +41 -0
- package/lib/cjs/components/SwitchField/SwitchField.mdx +36 -0
- package/lib/cjs/components/Table/Table.mdx +30 -0
- package/lib/cjs/components/TableCell/TableCell.d.ts +12 -0
- package/lib/cjs/components/TableCell/TableCell.js +0 -5
- package/lib/cjs/components/TableCell/TableCell.test.d.ts +1 -0
- package/lib/cjs/components/TableCell/index.d.ts +1 -0
- package/lib/cjs/components/Tabs/Tabs.mdx +40 -0
- package/lib/cjs/components/Text/Text.d.ts +4 -0
- package/lib/cjs/components/Text/Text.js +3 -7
- package/lib/cjs/components/Text/Text.mdx +13 -0
- package/lib/cjs/components/Text/Text.stories.d.ts +6 -0
- package/lib/cjs/components/Text/Text.styles.d.ts +286 -0
- package/lib/cjs/components/Text/Text.test.d.ts +1 -0
- package/lib/cjs/components/Text/index.d.ts +1 -0
- package/lib/cjs/components/TextAreaField/TextAreaField.mdx +34 -0
- package/lib/cjs/components/TextField/TextField.mdx +34 -0
- package/lib/cjs/components/TimeZonePicker/TimeZonePicker.mdx +18 -0
- package/lib/cjs/components/TooltipTrigger/TooltipTrigger.mdx +21 -0
- package/lib/cjs/docs/Props.stories.mdx +35 -0
- package/lib/cjs/docs/Welcome.stories.mdx +149 -0
- package/lib/cjs/docs/hooks/useDebounce.stories.mdx +59 -0
- package/lib/cjs/docs/hooks/useModalState.stories.mdx +83 -0
- package/lib/cjs/docs/hooks/useOverlayPanelState.stories.mdx +84 -0
- package/lib/cjs/docs/theme/AstroNanoTheme.stories.mdx +174 -0
- package/lib/cjs/docs/theme/AstroTheme.stories.mdx +20 -0
- package/lib/cjs/docs/theme/CustomThemes.stories.mdx +70 -0
- package/lib/cjs/docs/theme/StylingGuideline.stories.mdx +116 -0
- package/lib/cjs/docs/utils/messagesReducer.stories.mdx +64 -0
- package/lib/cjs/experimental/EditButton/EditButton.js +63 -0
- package/lib/cjs/experimental/EditButton/EditButton.mdx +9 -0
- package/lib/cjs/experimental/EditButton/EditButton.stories.js +91 -0
- package/lib/cjs/experimental/EditButton/EditButton.test.js +71 -0
- package/lib/cjs/experimental/EditButton/index.js +14 -0
- package/lib/cjs/experimental/ListView/ListView.mdx +47 -0
- package/lib/cjs/experimental/ListView/ListView.stories.js +742 -0
- package/lib/cjs/experimental/ListViewItem/ListViewItem.js +23 -5
- package/lib/cjs/experimental/ListViewItem/ListViewItem.mdx +36 -0
- package/lib/cjs/experimental/ListViewItem/ListViewItem.stories.js +31 -7
- package/lib/cjs/experimental/ListViewItem/ListViewItem.test.js +51 -7
- package/lib/cjs/experimental/ListViewItem/controls/ListViewItemEditButton.js +1 -4
- package/lib/cjs/experimental/ListViewItem/controls/ListViewItemEditButton.stories.js +4 -1
- package/lib/cjs/experimental/ListViewItem/controls/ListViewItemSwitchField.js +1 -0
- package/lib/cjs/experimental/ListViewItem/listViewItemAttributes.js +28 -13
- package/lib/cjs/experimental/PanelHeader/PanelHeader.js +88 -0
- package/lib/cjs/experimental/PanelHeader/PanelHeader.mdx +19 -0
- package/lib/cjs/experimental/PanelHeader/PanelHeader.stories.js +71 -0
- package/lib/cjs/experimental/PanelHeader/PanelHeader.styles.js +38 -0
- package/lib/cjs/experimental/PanelHeader/PanelHeader.test.js +46 -0
- package/lib/cjs/experimental/PanelHeader/controls/PanelHeaderCloseButton.js +34 -0
- package/lib/cjs/experimental/PanelHeader/controls/PanelHeaderCloseButton.stories.js +31 -0
- package/lib/cjs/experimental/PanelHeader/controls/PanelHeaderCloseButton.test.js +25 -0
- package/lib/cjs/experimental/PanelHeader/controls/PanelHeaderMenu.js +27 -0
- package/lib/cjs/experimental/PanelHeader/controls/PanelHeaderMenu.stories.js +36 -0
- package/lib/cjs/experimental/PanelHeader/controls/PanelHeaderMenu.test.js +58 -0
- package/lib/cjs/experimental/PanelHeader/controls/PanelHeaderSwitchField.js +27 -0
- package/lib/cjs/experimental/PanelHeader/controls/PanelHeaderSwitchField.stories.js +41 -0
- package/lib/cjs/experimental/PanelHeader/controls/PanelHeaderSwitchField.test.js +25 -0
- package/lib/cjs/experimental/PanelHeader/index.js +14 -0
- package/lib/cjs/experimental/README.stories.mdx +7 -0
- package/lib/cjs/experimental/SaveBar/SaveBar.mdx +13 -0
- package/lib/cjs/experimental/recipes/ListAndPanel.stories.js +1 -1
- package/lib/cjs/hooks/usePropWarning/usePropWarning.js +1 -1
- package/lib/cjs/hooks/useStatusClasses/useStatusClasses.js +2 -2
- package/lib/cjs/hooks/useTShirtSize/useTShirtSize.js +1 -1
- package/lib/cjs/index.d.ts +173 -0
- package/lib/cjs/index.js +53 -1
- package/lib/cjs/recipes/{AttributesAndPingOneMapping.stories.js → AttributeMapping.stories.js} +392 -132
- package/lib/cjs/styles/colors.js +1 -1
- package/lib/cjs/styles/variants/README.md +98 -0
- package/lib/cjs/styles/variants/variants.js +2 -0
- package/lib/cjs/types/box.d.ts +10 -0
- package/lib/cjs/types/box.js +6 -0
- package/lib/cjs/types/icon.d.ts +34 -0
- package/lib/cjs/types/icon.js +6 -0
- package/lib/cjs/types/index.d.ts +7 -0
- package/lib/cjs/types/index.js +86 -0
- package/lib/cjs/types/loader.d.ts +14 -0
- package/lib/cjs/types/loader.js +6 -0
- package/lib/cjs/types/mdx.d.js +1 -0
- package/lib/cjs/types/popoverContainer.d.ts +23 -0
- package/lib/cjs/types/popoverContainer.js +6 -0
- package/lib/cjs/types/shared/dom.d.ts +9 -0
- package/lib/cjs/types/shared/dom.js +6 -0
- package/lib/cjs/types/shared/index.d.ts +3 -0
- package/lib/cjs/types/shared/index.js +42 -0
- package/lib/cjs/types/shared/style.d.ts +11 -0
- package/lib/cjs/types/shared/style.js +6 -0
- package/lib/cjs/types/shared/test.d.ts +3 -0
- package/lib/cjs/types/shared/test.js +6 -0
- package/lib/cjs/types/shared/utils.d.ts +1 -0
- package/lib/cjs/types/shared/utils.js +6 -0
- package/lib/cjs/types/tableCell.d.ts +5 -0
- package/lib/cjs/types/tableCell.js +6 -0
- package/lib/cjs/types/text.d.ts +3 -0
- package/lib/cjs/types/text.js +6 -0
- package/lib/components/AccordionGridGroup/AccordionGridGroup.mdx +40 -0
- package/lib/components/AccordionGroup/Accordion.styles.js +1 -2
- package/lib/components/AccordionGroup/AccordionGroup.mdx +41 -0
- package/lib/components/ArrayField/ArrayField.mdx +34 -0
- package/lib/components/AstroWrapper/AstroWrapper.mdx +16 -0
- package/lib/components/Avatar/Avatar.mdx +14 -0
- package/lib/components/Badge/Badge.mdx +24 -0
- package/lib/components/Box/Box.js +4 -19
- package/lib/components/Box/Box.mdx +23 -0
- package/lib/components/Box/Box.test.js +2 -6
- package/lib/components/Bracket/Bracket.mdx +17 -0
- package/lib/components/Breadcrumbs/Breadcrumbs.mdx +40 -0
- package/lib/components/Button/Button.mdx +40 -0
- package/lib/components/Button/Button.stories.js +30 -5
- package/lib/components/Button/Buttons.styles.js +25 -7
- package/lib/components/Calendar/Calendar.mdx +39 -0
- package/lib/components/Callout/Callout.mdx +28 -0
- package/lib/components/Card/Card.mdx +32 -0
- package/lib/components/CheckboxField/CheckboxField.mdx +42 -0
- package/lib/components/CodeView/CodeView.mdx +23 -0
- package/lib/components/CollapsiblePanel/CollapsiblePanel.mdx +29 -0
- package/lib/components/ColorField/ColorField.mdx +38 -0
- package/lib/components/ComboBoxField/ComboBoxField.mdx +66 -0
- package/lib/components/CopyText/CopyText.mdx +23 -0
- package/lib/components/DataTable/DataTable.mdx +54 -0
- package/lib/components/DatePicker/DatePicker.mdx +49 -0
- package/lib/components/EnvironmentBreadcrumb/EnvironmentBreadcrumb.js +2 -1
- package/lib/components/EnvironmentBreadcrumb/EnvironmentBreadcrumb.mdx +36 -0
- package/lib/components/EnvironmentBreadcrumb/EnvironmentBreadcrumb.stories.js +29 -45
- package/lib/components/FileInputField/FileInputField.mdx +33 -0
- package/lib/components/HelpHint/HelpHint.mdx +32 -0
- package/lib/components/Icon/Icon.js +2 -25
- package/lib/components/Icon/Icon.mdx +49 -0
- package/lib/components/IconBadge/IconBadge.mdx +14 -0
- package/lib/components/IconButton/IconButton.mdx +33 -0
- package/lib/components/IconButtonToggle/IconButtonToggle.mdx +31 -0
- package/lib/components/Image/Image.mdx +28 -0
- package/lib/components/ImageUploadField/ImageUploadField.mdx +38 -0
- package/lib/components/Link/Link.mdx +27 -0
- package/lib/components/LinkSelectField/LinkSelectField.mdx +47 -0
- package/lib/components/ListItem/ListItem.mdx +21 -0
- package/lib/components/ListView/ListView.mdx +44 -0
- package/lib/components/ListView/ListView.stories.js +94 -48
- package/lib/components/Loader/Loader.js +0 -14
- package/lib/components/Loader/Loader.mdx +29 -0
- package/lib/components/Menu/Menu.mdx +43 -0
- package/lib/components/Messages/Messages.mdx +35 -0
- package/lib/components/Modal/Modal.mdx +59 -0
- package/lib/components/MultivaluesField/MultivaluesField.mdx +44 -0
- package/lib/components/NavBar/NavBar.mdx +42 -0
- package/lib/components/NumberField/NumberField.mdx +39 -0
- package/lib/components/OverlayPanel/OverlayPanel.mdx +39 -0
- package/lib/components/PasswordField/PasswordField.mdx +33 -0
- package/lib/components/PopoverContainer/PopoverContainer.js +7 -38
- package/lib/components/PopoverMenu/PopoverMenu.mdx +53 -0
- package/lib/components/RadioGroupField/RadioGroupField.mdx +41 -0
- package/lib/components/RequirementsList/RequirementsList.mdx +17 -0
- package/lib/components/RockerButtonGroup/RockerButtonGroup.mdx +36 -0
- package/lib/components/ScrollBox/ScrollBox.mdx +17 -0
- package/lib/components/SearchField/SearchField.mdx +33 -0
- package/lib/components/SelectField/SelectField.mdx +46 -0
- package/lib/components/Separator/Separator.mdx +19 -0
- package/lib/components/Stepper/Stepper.mdx +41 -0
- package/lib/components/SwitchField/SwitchField.mdx +36 -0
- package/lib/components/Table/Table.mdx +30 -0
- package/lib/components/TableCell/TableCell.js +0 -5
- package/lib/components/Tabs/Tabs.mdx +40 -0
- package/lib/components/Text/Text.js +3 -7
- package/lib/components/Text/Text.mdx +13 -0
- package/lib/components/TextAreaField/TextAreaField.mdx +34 -0
- package/lib/components/TextField/TextField.mdx +34 -0
- package/lib/components/TimeZonePicker/TimeZonePicker.mdx +18 -0
- package/lib/components/TooltipTrigger/TooltipTrigger.mdx +21 -0
- package/lib/docs/Props.stories.mdx +35 -0
- package/lib/docs/Welcome.stories.mdx +149 -0
- package/lib/docs/hooks/useDebounce.stories.mdx +59 -0
- package/lib/docs/hooks/useModalState.stories.mdx +83 -0
- package/lib/docs/hooks/useOverlayPanelState.stories.mdx +84 -0
- package/lib/docs/theme/AstroNanoTheme.stories.mdx +174 -0
- package/lib/docs/theme/AstroTheme.stories.mdx +20 -0
- package/lib/docs/theme/CustomThemes.stories.mdx +70 -0
- package/lib/docs/theme/StylingGuideline.stories.mdx +116 -0
- package/lib/docs/utils/messagesReducer.stories.mdx +64 -0
- package/lib/experimental/EditButton/EditButton.js +50 -0
- package/lib/experimental/EditButton/EditButton.mdx +9 -0
- package/lib/experimental/EditButton/EditButton.stories.js +75 -0
- package/lib/experimental/EditButton/EditButton.test.js +68 -0
- package/lib/experimental/EditButton/index.js +1 -0
- package/lib/experimental/ListView/ListView.mdx +47 -0
- package/lib/experimental/ListView/ListView.stories.js +729 -0
- package/lib/experimental/ListViewItem/ListViewItem.js +24 -6
- package/lib/experimental/ListViewItem/ListViewItem.mdx +36 -0
- package/lib/experimental/ListViewItem/ListViewItem.stories.js +28 -5
- package/lib/experimental/ListViewItem/ListViewItem.test.js +45 -1
- package/lib/experimental/ListViewItem/controls/ListViewItemEditButton.js +1 -4
- package/lib/experimental/ListViewItem/controls/ListViewItemEditButton.stories.js +4 -1
- package/lib/experimental/ListViewItem/controls/ListViewItemSwitchField.js +1 -0
- package/lib/experimental/ListViewItem/listViewItemAttributes.js +25 -12
- package/lib/experimental/PanelHeader/PanelHeader.js +75 -0
- package/lib/experimental/PanelHeader/PanelHeader.mdx +19 -0
- package/lib/experimental/PanelHeader/PanelHeader.stories.js +59 -0
- package/lib/experimental/PanelHeader/PanelHeader.styles.js +30 -0
- package/lib/experimental/PanelHeader/PanelHeader.test.js +43 -0
- package/lib/experimental/PanelHeader/controls/PanelHeaderCloseButton.js +25 -0
- package/lib/experimental/PanelHeader/controls/PanelHeaderCloseButton.stories.js +21 -0
- package/lib/experimental/PanelHeader/controls/PanelHeaderCloseButton.test.js +22 -0
- package/lib/experimental/PanelHeader/controls/PanelHeaderMenu.js +18 -0
- package/lib/experimental/PanelHeader/controls/PanelHeaderMenu.stories.js +26 -0
- package/lib/experimental/PanelHeader/controls/PanelHeaderMenu.test.js +55 -0
- package/lib/experimental/PanelHeader/controls/PanelHeaderSwitchField.js +18 -0
- package/lib/experimental/PanelHeader/controls/PanelHeaderSwitchField.stories.js +32 -0
- package/lib/experimental/PanelHeader/controls/PanelHeaderSwitchField.test.js +22 -0
- package/lib/experimental/PanelHeader/index.js +1 -0
- package/lib/experimental/README.stories.mdx +7 -0
- package/lib/experimental/SaveBar/SaveBar.mdx +13 -0
- package/lib/experimental/recipes/ListAndPanel.stories.js +1 -1
- package/lib/hooks/usePropWarning/usePropWarning.js +1 -1
- package/lib/hooks/useStatusClasses/useStatusClasses.js +2 -2
- package/lib/hooks/useTShirtSize/useTShirtSize.js +1 -1
- package/lib/index.js +6 -0
- package/lib/recipes/AttributeMapping.stories.js +540 -0
- package/lib/styles/colors.js +1 -1
- package/lib/styles/variants/README.md +98 -0
- package/lib/styles/variants/variants.js +2 -0
- package/lib/types/box.js +1 -0
- package/lib/types/icon.js +1 -0
- package/lib/types/index.js +7 -0
- package/lib/types/loader.js +1 -0
- package/lib/types/mdx.d.js +0 -0
- package/lib/types/popoverContainer.js +1 -0
- package/lib/types/shared/dom.js +1 -0
- package/lib/types/shared/index.js +3 -0
- package/lib/types/shared/style.js +1 -0
- package/lib/types/shared/test.js +1 -0
- package/lib/types/shared/utils.js +1 -0
- package/lib/types/tableCell.js +1 -0
- package/lib/types/text.js +1 -0
- package/package.json +19 -5
- package/CHANGELOG.md +0 -2565
- package/NOTICE +0 -2481
- package/NOTICE.html +0 -9174
- package/lib/cjs/recipes/AttributeMappingReadOnlyField.stories.js +0 -254
- package/lib/recipes/AttributeMappingReadOnlyField.stories.js +0 -243
- package/lib/recipes/AttributesAndPingOneMapping.stories.js +0 -282
@@ -0,0 +1,28 @@
|
|
1
|
+
import { Meta } from '@storybook/addon-docs';
|
2
|
+
|
3
|
+
<Meta title="Components/Callout/Callout" />
|
4
|
+
|
5
|
+
# Callout
|
6
|
+
|
7
|
+
Callouts are persistent box-like components that display brief status reports regarding continuing and developing conditions.
|
8
|
+
Callouts should contain only 1 or 2 pieces of information and display at the top of the panels or above the related content without blocking important information on the screen, and should not be stacked on top of each other.
|
9
|
+
|
10
|
+
### Required components
|
11
|
+
|
12
|
+
This component requires the [Link](./?path=/docs/components-link--default) and [Text](./?path=/docs/components-text--default) components.
|
13
|
+
|
14
|
+
### Accessibility
|
15
|
+
|
16
|
+
#### Keyboard Navigation
|
17
|
+
|
18
|
+
The callout itself is not focusable but the components within it are.
|
19
|
+
These keys provide additional functionality to the component.
|
20
|
+
|
21
|
+
| Keys | Functions |
|
22
|
+
| ---- | --------- |
|
23
|
+
| Space or Enter | Selects the component within. |
|
24
|
+
| Tab | Focuses the component within and follows the page tab sequence. |
|
25
|
+
|
26
|
+
#### Screen readers
|
27
|
+
|
28
|
+
This component uses the **`aria-label`** attribute to provide an accessible name.
|
@@ -0,0 +1,32 @@
|
|
1
|
+
import { Meta } from '@storybook/addon-docs';
|
2
|
+
|
3
|
+
<Meta title="Components/Card/Card" />
|
4
|
+
|
5
|
+
# Card
|
6
|
+
|
7
|
+
Cards are usually placed in groups and used to display content related to a single subject.
|
8
|
+
The content can consist of multiple components of varying types and sizes.
|
9
|
+
|
10
|
+
Card should:
|
11
|
+
- Relay clear expectations for user interactions.
|
12
|
+
- Be self-contained and freely placed based on function.
|
13
|
+
- Be grouped in a uniform layout when the content length and sizes are similar.
|
14
|
+
|
15
|
+
Cards shouldn’t contain too much information. Keep it simple and scannable.
|
16
|
+
|
17
|
+
This component is built on [Box from Theme-UI](https://theme-ui.com/components/box) and accepts most [Styled System props](https://styled-system.com/table/).
|
18
|
+
|
19
|
+
### Required Components
|
20
|
+
|
21
|
+
This component can be used independently and does not require additional components.
|
22
|
+
|
23
|
+
### Accessibility
|
24
|
+
|
25
|
+
#### Keyboard Navigation
|
26
|
+
|
27
|
+
These keys provide additional functionality to the Interactive Card components.
|
28
|
+
|
29
|
+
| Keys | Functions |
|
30
|
+
| ---- | --------- |
|
31
|
+
| Space or Enter | Selects the button. |
|
32
|
+
| Tab | Focuses the button and follows the page tab sequence.|
|
@@ -0,0 +1,42 @@
|
|
1
|
+
import { Meta } from '@storybook/addon-docs';
|
2
|
+
|
3
|
+
<Meta title="Components/CheckboxField/CheckboxField" />
|
4
|
+
|
5
|
+
# CheckboxField
|
6
|
+
|
7
|
+
This component combines Checkbox, Label, and HelperText for a complete, form-ready solution.
|
8
|
+
CheckboxFields are shown as square boxes that users can select or deselect to indicate true or false and should:
|
9
|
+
- Have short, concise, clear labels.
|
10
|
+
- Be used in multi-selection lists.
|
11
|
+
- Be used for options that can be toggled on or off.
|
12
|
+
|
13
|
+
These fields should not be used to select from mutually exclusive options.
|
14
|
+
Use the [RadioGroupField](./?path=/story/form-radiogroupfield--default) instead.
|
15
|
+
|
16
|
+
The CheckboxField component uses [useCheckbox](https://react-spectrum.adobe.com/react-aria/useCheckbox.html) from React Aria and
|
17
|
+
[useToggleState](https://react-spectrum.adobe.com/react-stately/useToggleState.html) from React Stately.
|
18
|
+
|
19
|
+
### Required Components
|
20
|
+
|
21
|
+
This component can be used independently and does not require additional components.
|
22
|
+
|
23
|
+
### Accessibility
|
24
|
+
|
25
|
+
This component should adhere to the [WAI-ARIA Checkbox](https://www.w3.org/WAI/ARIA/apg/patterns/checkbox/) accessibility guidelines.
|
26
|
+
|
27
|
+
#### Keyboard Navigation
|
28
|
+
|
29
|
+
These keys provide additional functionality to the component.
|
30
|
+
|
31
|
+
| Keys | Functions |
|
32
|
+
| ---- | ---- |
|
33
|
+
| Space | When focused, toggles the check box on and off. |
|
34
|
+
| Tab | Moves focus to the next focusable component and follows the page tab sequence. |
|
35
|
+
| Shift + Tab | Moves focus to the previous focusable component. |
|
36
|
+
|
37
|
+
#### Screen Readers
|
38
|
+
|
39
|
+
This component uses the following attributes to assist screen readers:
|
40
|
+
- The **`aria-checked`** attribute is used to indicate the current checked status.
|
41
|
+
- The **`aria-labelledby`** attribute is provided with the label ID to reference it.
|
42
|
+
- The **`aria-hidden`** attribute is used to hide its content from assistive technology.
|
@@ -0,0 +1,23 @@
|
|
1
|
+
import { Meta } from '@storybook/addon-docs';
|
2
|
+
|
3
|
+
<Meta title="Components/CodeView/CodeView" />
|
4
|
+
|
5
|
+
# CodeView
|
6
|
+
|
7
|
+
This component is used for code syntax highlighting and is built on [prism-react-renderer](https://github.com/FormidableLabs/prism-react-renderer).
|
8
|
+
It should contain the language title and be formatted with indentations, line breaks, and comments, and should not contain complex code snippets.
|
9
|
+
|
10
|
+
### Required Components
|
11
|
+
|
12
|
+
This component requires the [Text](./?path=/docs/components-text--default) component.
|
13
|
+
|
14
|
+
### Accessibility
|
15
|
+
|
16
|
+
#### Keyboard Navigation
|
17
|
+
|
18
|
+
These keys provide additional functionality to the component.
|
19
|
+
|
20
|
+
| Keys | Functions |
|
21
|
+
| ---- | --------- |
|
22
|
+
| Space or Enter | Selects the CopyButton inside the CodeView component. |
|
23
|
+
| Tab | Focuses the CopyButton inside the CodeView component. |
|
@@ -0,0 +1,29 @@
|
|
1
|
+
import { Meta } from '@storybook/addon-docs';
|
2
|
+
|
3
|
+
<Meta title="Components/CollapsiblePanel/CollapsiblePanel" />
|
4
|
+
|
5
|
+
# CollapsiblePanel
|
6
|
+
|
7
|
+
CollapsiblePanel provides users with the ability to expand and collapse content as needed while saving horizontal space, and shouldn’t be used with invisible triggers.
|
8
|
+
|
9
|
+
### Required Components
|
10
|
+
|
11
|
+
This component can be used independently and does not require additional components.
|
12
|
+
|
13
|
+
### Accessibility
|
14
|
+
|
15
|
+
#### Keyboard Navigation
|
16
|
+
|
17
|
+
These keys provide additional functionality to the component.
|
18
|
+
|
19
|
+
| Keys | Functions |
|
20
|
+
| ---- | --------- |
|
21
|
+
| Space or Enter | Expands or collapses the content when the trigger is focused. |
|
22
|
+
| Tab | Focuses the trigger button and the panel content. |
|
23
|
+
| Shift + Tab | Moves focus to the previous focusable component. |
|
24
|
+
| Esc | Pressing the escape key closes the panel when it is expanded. |
|
25
|
+
|
26
|
+
#### Screen Readers
|
27
|
+
This component uses the **`aria-rowcount`** and **`aria-columncount`** attributes to indicate the total number of rows and columns in the grid structure.
|
28
|
+
|
29
|
+
|
@@ -0,0 +1,38 @@
|
|
1
|
+
import { Meta } from '@storybook/addon-docs';
|
2
|
+
|
3
|
+
<Meta title="Components/ColorField/ColorField" />
|
4
|
+
|
5
|
+
# ColorField
|
6
|
+
|
7
|
+
The ColorField component allows users to pick a color from a color swatch and use that color.
|
8
|
+
The colors must use the same color naming conventions, such as HEX, RBBA, and HSLA.
|
9
|
+
Pick one convention and stick with it.
|
10
|
+
|
11
|
+
This component uses [useColorField](https://react-spectrum.adobe.com/react-aria/useColorField.html) from React Aria,
|
12
|
+
[useColorFieldState](https://react-spectrum.adobe.com/react-stately/useColorFieldState.html) from React Stately
|
13
|
+
and [React Color](https://casesandberg.github.io/react-color/) as a color picker.
|
14
|
+
|
15
|
+
### Required Components
|
16
|
+
|
17
|
+
This component is built using [useOverLayTrigger](https://react-spectrum.adobe.com/react-aria/useOverlayTrigger.html), and requires the
|
18
|
+
react-aria [OverlayProvider](https://react-spectrum.adobe.com/react-aria/useOverlayTrigger.html#:~:text=contained%20in%20an-,OverlayProvider,-%2C%20which%20is%20used), which is exported from Astro.
|
19
|
+
|
20
|
+
### Accessibility
|
21
|
+
|
22
|
+
#### Keyboard Navigation
|
23
|
+
|
24
|
+
These keys provide additional functionality to the component.
|
25
|
+
|
26
|
+
| Keys | Functions |
|
27
|
+
| ---- | ---- |
|
28
|
+
| Tab |Focuses the color swatch and follows the page tab sequence. |
|
29
|
+
| Shift + Tab | Moves focus to the previous focusable component. |
|
30
|
+
| Space or Enter | Opens the color swatch when it is focused. Once opened, the focus moves to the input field and is locked inside the ColorPicker Overlay. |
|
31
|
+
| Esc | When the picker is open, pressing the escape key closes the overlay and focuses on the previously focused component. |
|
32
|
+
|
33
|
+
#### Screen Readers
|
34
|
+
|
35
|
+
This component uses the following attributes to assist screen readers:
|
36
|
+
- The trigger button uses the **`aria-expanded`** attribute to indicate the expansion and collapse of Chrome Picker.
|
37
|
+
- When expanded, **`aria-controls`** is added to the button pointing to the Chrome Picker.
|
38
|
+
- The visibly hidden input uses the **`aria-labelledby`** attribute supplied with label ID.
|
@@ -0,0 +1,66 @@
|
|
1
|
+
import { Meta } from '@storybook/addon-docs';
|
2
|
+
|
3
|
+
<Meta title="Components/ComboBoxField/ComboBoxField" />
|
4
|
+
|
5
|
+
# ComboBoxField
|
6
|
+
|
7
|
+
The ComboBoxField combines the features of a textbox and a listbox.
|
8
|
+
This component provides a more compact way to present a list of choices, as the list is hidden until you click the drop-down arrow.
|
9
|
+
A combo box also gives you the ability to enter a value that is not in the list.
|
10
|
+
|
11
|
+
Use this component for large complex lists, ideally sorted. Do not use this component:
|
12
|
+
- If the list will never have more than 6 items.
|
13
|
+
- With small lists where one option is pre-selected by default. Use the [RadioGroupField](./?path=/docs/form-radiogroupfield--default) instead.
|
14
|
+
|
15
|
+
This component uses [useComboBox](https://react-spectrum.adobe.com/react-aria/useComboBox.html) from React
|
16
|
+
Aria and [useComboBoxState](https://react-spectrum.adobe.com/react-stately/useComboBoxState.html)
|
17
|
+
from React Stately.
|
18
|
+
|
19
|
+
### Required Components
|
20
|
+
|
21
|
+
This component is built using [useOverLayTrigger](https://react-spectrum.adobe.com/react-aria/useOverlayTrigger.html), and requires the
|
22
|
+
react-aria [OverlayProvider](https://react-spectrum.adobe.com/react-aria/useOverlayTrigger.html#:~:text=contained%20in%20an-,OverlayProvider,-%2C%20which%20is%20used),
|
23
|
+
exported from Astro and Item originating from [react-stately/collections](https://react-spectrum.adobe.com/react-stately/collections.html).
|
24
|
+
|
25
|
+
### Accessibility
|
26
|
+
|
27
|
+
This component should adhere to the [WAI-ARIA ComboBox](https://www.w3.org/WAI/ARIA/apg/patterns/combobox/) accessibility guidelines.
|
28
|
+
|
29
|
+
#### Keyboard Navigation
|
30
|
+
|
31
|
+
These keys provide additional functionality to the component.
|
32
|
+
|
33
|
+
| Keys | Functions |
|
34
|
+
| ---- | ---- |
|
35
|
+
| Tab | Focuses the field and follows the page tab sequence. |
|
36
|
+
| Shift + Tab | Moves focus to the previous focusable component. |
|
37
|
+
| Space or Enter | Selects the component when it is focused. |
|
38
|
+
| Down arrow | Opens the popover if it isn’t already open. |
|
39
|
+
| Up and down arrows | Can be used to move through the selection in the popover. |
|
40
|
+
| Typing in input field | Adds focus to it and opens the popover. |
|
41
|
+
| Home(Fn + Right Arrow Key) Or Control/Command + Home | Shifts the focus to the first item in the listbox. |
|
42
|
+
| End(Fn + Left Arrow Key) Or Control/Command + End | Shifts the focus to the last item in the listbox. |
|
43
|
+
| Esc | Pressing the escape key closes the overlay and adds focus to the previously focused component. |
|
44
|
+
|
45
|
+
#### Screen Readers
|
46
|
+
This component uses the following attributes to assist screen readers:
|
47
|
+
|
48
|
+
Input:
|
49
|
+
- The input uses **`aria-expanded`** to indicate the expansion/collapse of the listbox.
|
50
|
+
- When expanded **`aria-controls`** is added to the input pointing to the ListBox.
|
51
|
+
- The input has **`aria-labelledby`** supplied with label ID and **`aria-activedescendent`** identifies the currently focused option from the list.
|
52
|
+
- The label uses **`aria-hidden`** to hide its content from assistive technology.
|
53
|
+
- The **`aria-autocomplete`** list model displays all the possible values in the pop-up list.
|
54
|
+
- The Input has **`aria-invalid`** set to true when the entered value does not conform to the expected format.
|
55
|
+
|
56
|
+
Button:
|
57
|
+
- The trigger button uses **`aria-expanded`** to indicate the expansion/collapse of content.
|
58
|
+
- The attribute **`aria-haspopup`** has “True” set as the value, which indicates that the type of popup content is a Listbox.
|
59
|
+
- The button and label ID are supplied to **`aria-labelledby`** to reference it.
|
60
|
+
- When expanded **`aria-controls`** is added to the input pointing to the listbox.
|
61
|
+
|
62
|
+
Option:
|
63
|
+
- The ListBox has the label and its ID supplied to **`aria-labelledby`** and **`aria-label`** provides an accessible name to the component.
|
64
|
+
- Each ListBox option has the default **`aria-disabled`** set as false and **`aria-selected`** to indicate the currently selected option.
|
65
|
+
- The **`aria-posinset`** attribute defines an element's number or position in the current set of list items.
|
66
|
+
- The **`aria-setsize`** attribute defines the number of items in the current set of list items.
|
@@ -0,0 +1,23 @@
|
|
1
|
+
import { Meta } from '@storybook/addon-docs';
|
2
|
+
|
3
|
+
<Meta title="Components/CopyText/CopyText" />
|
4
|
+
|
5
|
+
# CopyText
|
6
|
+
|
7
|
+
CopyText allows users to copy information by clicking on the text or a nearby CopyButton. These components should have labels that match the action.
|
8
|
+
Do not override the colors used for this component for accessibility reasons, and ensure tooltip text is included.
|
9
|
+
|
10
|
+
### Required Components
|
11
|
+
|
12
|
+
This component requires the [Text](./?path=/docs/components-text--default) component.
|
13
|
+
|
14
|
+
### Accessibility
|
15
|
+
|
16
|
+
#### Keyboard Navigation
|
17
|
+
|
18
|
+
These keys provide additional functionality to the component.
|
19
|
+
|
20
|
+
| Keys | Functions |
|
21
|
+
| ---- | --------- |
|
22
|
+
| Space or Enter | Selects the button. |
|
23
|
+
| Tab | Focuses the button and follows the page tab sequence.|
|
@@ -0,0 +1,54 @@
|
|
1
|
+
import { Meta } from '@storybook/addon-docs';
|
2
|
+
|
3
|
+
<Meta title="Components/DataTable/DataTable" />
|
4
|
+
|
5
|
+
# DataTable
|
6
|
+
|
7
|
+
DataTables are containers that display data in rows, columns, and cells, which allows users to quickly scan, sort, and compare information. This component was inspired by [TableView](https://react-spectrum.adobe.com/react-spectrum/TableView.html)
|
8
|
+
from React Spectrum and build using [useTableState](https://react-spectrum.adobe.com/react-stately/useTableState.html)
|
9
|
+
from React Stately.
|
10
|
+
|
11
|
+
Columns are defined within the DataTableHeader component with the DataTableColumn component, and rows are defined within the DataTableBody component with the DataTableRow component.
|
12
|
+
Rows contain DataTableCell components that correspond to each column.
|
13
|
+
|
14
|
+
DataTables should:
|
15
|
+
- Contain vertically aligned content.
|
16
|
+
- Use multiple heading rows for higher-level column groupings.
|
17
|
+
- Use column dividers sparingly.
|
18
|
+
|
19
|
+
They should not use different indicators to represent empty fields.
|
20
|
+
|
21
|
+
### Required Components
|
22
|
+
|
23
|
+
This component requires these additional React Spectrum components:
|
24
|
+
- [TableHeader](https://react-spectrum.adobe.com/react-aria/useTable.html#:~:text=defined%20using%20the-,TableHeader,-%2C%20Column%2C) aliased DataTableHeader
|
25
|
+
- [Column](https://react-spectrum.adobe.com/react-aria/useTable.html#:~:text=the%20TableHeader%2C-,Column,-%2C%20TableBody%2C) aliased DataTableColumn
|
26
|
+
- [Cell](https://react-spectrum.adobe.com/react-aria/useTable.html#:~:text=Row%2C%20and-,Cell,-components%2C%20which%20support) aliased DataTableCell
|
27
|
+
- [Row](https://react-spectrum.adobe.com/react-aria/useTable.html#:~:text=%2C%20TableBody%2C-,Row,-%2C%20and%20Cell%20components) aliased DataTableRow
|
28
|
+
- [TableBody](https://react-spectrum.adobe.com/react-aria/useTable.html#:~:text=%2C%20Column%2C-,TableBody,-%2C%20Row%2C%20and) aliased DataTableBody
|
29
|
+
|
30
|
+
### Accessibility
|
31
|
+
|
32
|
+
#### Keyboard Navigation
|
33
|
+
|
34
|
+
These keys provide additional functionality to the component.
|
35
|
+
|
36
|
+
| Keys | Functions |
|
37
|
+
| ---- | --------- |
|
38
|
+
| Tab | Moves focus to the next focusable component. All focusable components in the table are included in the page tab sequence. |
|
39
|
+
| Shift + Tab | Moves focus to the previous focusable component. |
|
40
|
+
| Space or Enter | Focuses the component and triggers an action if one is associated with it. |
|
41
|
+
| Arrow keys | Can be used to navigate between the components in the table. |
|
42
|
+
| Focus on a row and scroll down | Shifts the focus to the entire table, not the previously focused row. |
|
43
|
+
| Home or page up | Shifts the focus to the first row. |
|
44
|
+
| End or page down | Shifts the focus to the last visible row. |
|
45
|
+
|
46
|
+
#### Screen Readers
|
47
|
+
|
48
|
+
This component uses the following attributes to assist screen readers:
|
49
|
+
- The **`aria-label`** attribute is used to provide an accessible name.
|
50
|
+
- The **`aria-rowcount`** and **`aria-columncount`** attributes are used to indicate the total number of rows and columns in the grid structure.
|
51
|
+
- The DataTableHeader uses the **`aria-rowindex`** attribute and DataTableColumn uses the **`aria-colindex`** attribute to enumerate the header row and columns.
|
52
|
+
- 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.
|
53
|
+
- Each DataTableCell uses the **`aria-colindex`** attribute to enumerate the columns within each row.
|
54
|
+
|
@@ -0,0 +1,49 @@
|
|
1
|
+
import { Meta } from '@storybook/addon-docs';
|
2
|
+
|
3
|
+
<Meta title="Components/DatePicker/DatePicker" />
|
4
|
+
|
5
|
+
# DatePicker
|
6
|
+
|
7
|
+
Date pickers allow users to select specific past, present, or future dates.
|
8
|
+
This component combines the [Calendar](./?path=/docs/components-calendar--default) component with the DateField component and can be localized to meet your needs.
|
9
|
+
|
10
|
+
This component is built on [useDatePicker](https://react-spectrum.adobe.com/react-aria/useDatePicker.html) from React Aria
|
11
|
+
and [useDatePickerState](https://react-spectrum.adobe.com/react-stately/useDatePickerState.html) from React Stately.
|
12
|
+
|
13
|
+
Properties not specified are passed to the underlying DateField component.
|
14
|
+
|
15
|
+
### Required components
|
16
|
+
|
17
|
+
This component can be used independently and does not require additional components.
|
18
|
+
|
19
|
+
### Accessibility
|
20
|
+
|
21
|
+
This component should adhere to the [WAI-ARIA DatePicker](https://www.w3.org/WAI/ARIA/apg/patterns/dialog-modal/examples/datepicker-dialog/) accessibility guidelines.
|
22
|
+
|
23
|
+
#### Keyboard Navigation
|
24
|
+
|
25
|
+
These keys provide additional functionality to the component.
|
26
|
+
|
27
|
+
| Keys | Functions |
|
28
|
+
| ---- | --------- |
|
29
|
+
| Space or Enter | 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. |
|
30
|
+
| Tab | Focuses the field and follows the page tab sequence. |
|
31
|
+
| Shift + Tab | Moves focus to the previous focusable component. |
|
32
|
+
| Pressing Home:(Fn + Right Arrow Key) Or Control or Command + Home | Shifts the focus to the first calendar date. |
|
33
|
+
| Pressing Home:(Fn + left Arrow Key) Or Control or Command + End | Shifts the focus to the last calendar date. |
|
34
|
+
| Up and down Arrow keys | When segments are focused, it increments and decrements dates starting from the present day. |
|
35
|
+
| Left and right arrows | Moves focus between segments. |
|
36
|
+
| Page up | Changes the grid of dates to the previous month. |
|
37
|
+
| Page down | Changes the grid of dates to the next month. |
|
38
|
+
| Shift + page up | Changes the grid of dates to the same month in the previous year. |
|
39
|
+
| Shift+ page down | Changes the grid of dates to the same month in the next year. |
|
40
|
+
| Esc | Closes the overlay and shifts focus to the trigger. |
|
41
|
+
|
42
|
+
#### Screen Readers
|
43
|
+
|
44
|
+
This component uses the following attributes to assist screen readers:
|
45
|
+
|
46
|
+
- 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.
|
47
|
+
- Each spin button has the **`aria-valuenow`** attribute that defines the current value and it is always used with its text alternative, **`aria-valuetext`**.
|
48
|
+
The spin buttons also have the **`aria-valuemin`** and **`aria-valuemax`** attributes to specify the minimum and maximum values allowed for a range widget.
|
49
|
+
- The **`aria-selected`** attribute is added to the grid cell when a date is selected, and **`aria-disabled`** is set to “false” by default.
|
@@ -152,7 +152,8 @@ var EnvironmentBreadcrumb = /*#__PURE__*/(0, _react.forwardRef)(function (props,
|
|
152
152
|
onSelectionChange: handleSelectionChange,
|
153
153
|
selectedKeys: selectedKeys,
|
154
154
|
selectionMode: 'single',
|
155
|
-
disallowEmptySelection:
|
155
|
+
disallowEmptySelection: true,
|
156
|
+
allowDuplicateSelectionEvents: true
|
156
157
|
};
|
157
158
|
var listBoxState = (0, _list.useListState)(listBoxProps);
|
158
159
|
|
@@ -0,0 +1,36 @@
|
|
1
|
+
import { Meta } from '@storybook/addon-docs';
|
2
|
+
|
3
|
+
<Meta title="Components/EnvironmentBreadcrumb/EnvironmentBreadcrumb" />
|
4
|
+
|
5
|
+
# EnvironmentBreadcrumb
|
6
|
+
|
7
|
+
EnvironmentBreadcrumb shows users where they are within the environment hierarchy.
|
8
|
+
They take up little space but still provide context for the user’s place in the hierarchy, but should be treated as secondary navigation and never entirely replace the primary navigation.
|
9
|
+
|
10
|
+
### Required components
|
11
|
+
|
12
|
+
This component requires the [Badge](./?path=/docs/components-badge--default),
|
13
|
+
[Box](./?path=/story/components-box--default), [Text](./?path=/docs/components-text--default) components and
|
14
|
+
Item from [react-stately/collections](https://react-spectrum.adobe.com/react-stately/collections.html).
|
15
|
+
|
16
|
+
### Accessibility
|
17
|
+
|
18
|
+
#### Keyboard Navigation
|
19
|
+
|
20
|
+
These keys provide additional functionality to the component.
|
21
|
+
|
22
|
+
| Keys | Functions |
|
23
|
+
| ---- | --------- |
|
24
|
+
| Space or Enter | Selects the breadcrumb item. |
|
25
|
+
| Tab | Focuses the breadcrumb item and follows the page tab sequence. |
|
26
|
+
| Shift + Tab | Moves focus to the previous focusable component. |
|
27
|
+
| Arrow keys | Can be used to navigate between the items in the dropdown list. |
|
28
|
+
| Esc | Closes the popover when it is expanded. |
|
29
|
+
|
30
|
+
#### Screen readers
|
31
|
+
|
32
|
+
This component uses the following attributes to assist screen readers:
|
33
|
+
- Each breadcrumb item uses an **`aria-label`** attribute to provide an accessible name.
|
34
|
+
- The trigger button uses the **`aria-expanded`** attribute to indicate when the content expands and collapses.
|
35
|
+
- When expanded, **`aria-controls`** is added to the button pointing to the pop-up content.
|
36
|
+
- The **`aria-haspopup`** attribute describes the type of content presented.
|
@@ -123,10 +123,7 @@ var environmentsWithSections = [{
|
|
123
123
|
}]
|
124
124
|
}];
|
125
125
|
var Default = function Default(args) {
|
126
|
-
var _useState = (0, _react.useState)(
|
127
|
-
name: 'Snail',
|
128
|
-
isSandbox: true
|
129
|
-
}),
|
126
|
+
var _useState = (0, _react.useState)(defaultEnvironments[0]),
|
130
127
|
_useState2 = (0, _slicedToArray2["default"])(_useState, 2),
|
131
128
|
selectedEnvironment = _useState2[0],
|
132
129
|
setSelectedEnvironment = _useState2[1];
|
@@ -170,10 +167,7 @@ var Default = function Default(args) {
|
|
170
167
|
};
|
171
168
|
exports.Default = Default;
|
172
169
|
var DefaultClosed = function DefaultClosed(args) {
|
173
|
-
var _useState3 = (0, _react.useState)(
|
174
|
-
name: 'Snail',
|
175
|
-
isSandbox: true
|
176
|
-
}),
|
170
|
+
var _useState3 = (0, _react.useState)(defaultEnvironments[0]),
|
177
171
|
_useState4 = (0, _slicedToArray2["default"])(_useState3, 2),
|
178
172
|
selectedEnvironment = _useState4[0],
|
179
173
|
setSelectedEnvironment = _useState4[1];
|
@@ -226,9 +220,7 @@ var WithSections = function WithSections() {
|
|
226
220
|
_useState8 = (0, _slicedToArray2["default"])(_useState7, 2),
|
227
221
|
filteredOptionsNumber = _useState8[0],
|
228
222
|
setFilteredOptionsNumber = _useState8[1];
|
229
|
-
var _useState9 = (0, _react.useState)(
|
230
|
-
name: 'Consumer Banking Prod'
|
231
|
-
}),
|
223
|
+
var _useState9 = (0, _react.useState)(environmentsWithSections[0].options[0]),
|
232
224
|
_useState10 = (0, _slicedToArray2["default"])(_useState9, 2),
|
233
225
|
selectedEnvironment = _useState10[0],
|
234
226
|
setSelectedEnvironment = _useState10[1];
|
@@ -334,10 +326,7 @@ var OrgLevel = function OrgLevel() {
|
|
334
326
|
};
|
335
327
|
exports.OrgLevel = OrgLevel;
|
336
328
|
var DefaultOpen = function DefaultOpen() {
|
337
|
-
var _useState11 = (0, _react.useState)(
|
338
|
-
name: 'Dog',
|
339
|
-
isSandbox: true
|
340
|
-
}),
|
329
|
+
var _useState11 = (0, _react.useState)(defaultEnvironments[0]),
|
341
330
|
_useState12 = (0, _slicedToArray2["default"])(_useState11, 2),
|
342
331
|
selectedEnvironment = _useState12[0],
|
343
332
|
setSelectedEnvironment = _useState12[1];
|
@@ -386,10 +375,7 @@ var ControlledMenu = function ControlledMenu() {
|
|
386
375
|
_useState14 = (0, _slicedToArray2["default"])(_useState13, 2),
|
387
376
|
isOpen = _useState14[0],
|
388
377
|
setIsOpen = _useState14[1];
|
389
|
-
var _useState15 = (0, _react.useState)(
|
390
|
-
name: 'Shark',
|
391
|
-
isSandbox: true
|
392
|
-
}),
|
378
|
+
var _useState15 = (0, _react.useState)(defaultEnvironments[0]),
|
393
379
|
_useState16 = (0, _slicedToArray2["default"])(_useState15, 2),
|
394
380
|
selectedEnvironment = _useState16[0],
|
395
381
|
setSelectedEnvironment = _useState16[1];
|
@@ -435,32 +421,6 @@ var ControlledMenu = function ControlledMenu() {
|
|
435
421
|
};
|
436
422
|
exports.ControlledMenu = ControlledMenu;
|
437
423
|
var RightAlignedBadges = function RightAlignedBadges(args) {
|
438
|
-
var _useState17 = (0, _react.useState)({
|
439
|
-
name: 'Snail',
|
440
|
-
isSandbox: true
|
441
|
-
}),
|
442
|
-
_useState18 = (0, _slicedToArray2["default"])(_useState17, 2),
|
443
|
-
selectedEnvironment = _useState18[0],
|
444
|
-
setSelectedEnvironment = _useState18[1];
|
445
|
-
var envNode = (0, _react2.jsx)(_index.Box, {
|
446
|
-
isRow: true
|
447
|
-
}, (0, _react2.jsx)(_index.Text, {
|
448
|
-
color: "inherit"
|
449
|
-
}, selectedEnvironment.name), selectedEnvironment.isSandbox ? (0, _react2.jsx)(_index.Badge, {
|
450
|
-
label: "SANDBOX",
|
451
|
-
variant: "environmentBadge",
|
452
|
-
bg: "neutral.40"
|
453
|
-
}) : null);
|
454
|
-
var findEnvObj = function findEnvObj(envName) {
|
455
|
-
return (0, _find["default"])(defaultEnvironments).call(defaultEnvironments, function (_ref11) {
|
456
|
-
var name = _ref11.name;
|
457
|
-
return name === envName;
|
458
|
-
});
|
459
|
-
};
|
460
|
-
var handleSelectionChange = function handleSelectionChange(newEnvName) {
|
461
|
-
var envObj = findEnvObj(newEnvName);
|
462
|
-
setSelectedEnvironment(_objectSpread({}, envObj));
|
463
|
-
};
|
464
424
|
var items = [{
|
465
425
|
name: 'Default'
|
466
426
|
}, {
|
@@ -490,6 +450,30 @@ var RightAlignedBadges = function RightAlignedBadges(args) {
|
|
490
450
|
}, {
|
491
451
|
name: 'Mouse'
|
492
452
|
}];
|
453
|
+
var _useState17 = (0, _react.useState)(items[0]),
|
454
|
+
_useState18 = (0, _slicedToArray2["default"])(_useState17, 2),
|
455
|
+
selectedEnvironment = _useState18[0],
|
456
|
+
setSelectedEnvironment = _useState18[1];
|
457
|
+
var envNode = (0, _react2.jsx)(_index.Box, {
|
458
|
+
isRow: true,
|
459
|
+
key: selectedEnvironment.name
|
460
|
+
}, (0, _react2.jsx)(_index.Text, {
|
461
|
+
color: "inherit"
|
462
|
+
}, selectedEnvironment.name), selectedEnvironment.isSandbox ? (0, _react2.jsx)(_index.Badge, {
|
463
|
+
label: "SANDBOX",
|
464
|
+
variant: "environmentBadge",
|
465
|
+
bg: "neutral.40"
|
466
|
+
}) : null);
|
467
|
+
var findEnvObj = function findEnvObj(envName) {
|
468
|
+
return (0, _find["default"])(items).call(items, function (_ref11) {
|
469
|
+
var name = _ref11.name;
|
470
|
+
return name === envName;
|
471
|
+
});
|
472
|
+
};
|
473
|
+
var handleSelectionChange = function handleSelectionChange(newEnvName) {
|
474
|
+
var envObj = findEnvObj(newEnvName);
|
475
|
+
setSelectedEnvironment(_objectSpread({}, envObj));
|
476
|
+
};
|
493
477
|
return (0, _react2.jsx)(_index.EnvironmentBreadcrumb, (0, _extends2["default"])({}, args, {
|
494
478
|
items: items,
|
495
479
|
name: "Globochem",
|
@@ -0,0 +1,33 @@
|
|
1
|
+
import { Meta } from '@storybook/addon-docs';
|
2
|
+
|
3
|
+
<Meta title="Components/FileInputField/FileInputField" />
|
4
|
+
|
5
|
+
# FileInputField
|
6
|
+
|
7
|
+
The FileInputField component allows users to upload files by clicking the button or dragging and dropping the files to a specific location.
|
8
|
+
We use [react-dropzone](https://react-dropzone.js.org/) for the drag-and-drop functionality.
|
9
|
+
|
10
|
+
This component should have clear, concise file names and labels that guide users through the upload process, and should not allow users to upload executable files, such as .exe, .bin, .app files.
|
11
|
+
|
12
|
+
### Required Components
|
13
|
+
|
14
|
+
This component can be used independently and does not require additional components.
|
15
|
+
|
16
|
+
### Accessibility
|
17
|
+
|
18
|
+
#### Keyboard Navigation
|
19
|
+
|
20
|
+
These keys provide additional functionality to the component.
|
21
|
+
|
22
|
+
| Keys | Functions |
|
23
|
+
| ---- | ---- |
|
24
|
+
| Tab | Focuses the field and follows the page tab sequence. |
|
25
|
+
| Shift + Tab | Moves focus to the previous focusable component. |
|
26
|
+
| Space or Enter | Selects the component when it is focused. |
|
27
|
+
|
28
|
+
#### Screen Readers
|
29
|
+
|
30
|
+
This component uses the following attributes to assist screen readers:
|
31
|
+
- This component uses the **`aria-label`** to provide an accessible name and has **`aria-labelledby`** attribute, supplied with the label ID.
|
32
|
+
- Upon uploading the file, the Button component, with the name of the uploaded file, displays with **`aria-describedby`** attribute, which references the helpText if passed along.
|
33
|
+
- The delete button has an **`aria-label`** to provide an accessible name.
|
@@ -0,0 +1,32 @@
|
|
1
|
+
import { Meta } from '@storybook/addon-docs';
|
2
|
+
|
3
|
+
<Meta title="Components/HelpHint/HelpHint" />
|
4
|
+
|
5
|
+
# HelpHint
|
6
|
+
|
7
|
+
HelpHints display information intended to help users enter, select or provide the appropriate information in a field. This component can be customized, and consists of the [TooltipTrigger](./?path=/docs/components-tooltiptrigger--default) and [IconButton](./?path=/docs/components-iconbutton--default).
|
8
|
+
|
9
|
+
When implementing this component, use short, clear language and a text size relative to the trigger button. They should not block important information when the tooltip displays, nor should it be used to communicate important information.
|
10
|
+
|
11
|
+
### Required Components
|
12
|
+
|
13
|
+
This component can be used independently and does not require additional components.
|
14
|
+
|
15
|
+
### Accessibility
|
16
|
+
This component adheres to [WAI-ARIA Button](https://www.w3.org/TR/wai-aria-practices-1.1/examples/button/button.html) accessibility guidelines.
|
17
|
+
|
18
|
+
#### Keyboard Navigation
|
19
|
+
|
20
|
+
These keys provide additional functionality to the component.
|
21
|
+
|
22
|
+
| Aria Attribute | Role |
|
23
|
+
| ---- | ---- |
|
24
|
+
| Space or Enter | Selects the help hint. |
|
25
|
+
| Tab | Focuses the help hint and follows the page tab sequence. |
|
26
|
+
|
27
|
+
#### Screen Readers
|
28
|
+
|
29
|
+
This component uses the following attributes to assist screen readers:
|
30
|
+
- The trigger button uses the **`aria-desribedby`** attribute, which announces the tooltip text.
|
31
|
+
- The **`aria-live`** attribute announces the dynamic changes in live region content.
|
32
|
+
|