@primer/components 32.0.1 → 32.0.2-rc.859381a1
Sign up to get free protection for your applications and to get access to all the features.
- package/.changeset/README.md +8 -0
- package/.changeset/config.json +10 -0
- package/.devcontainer/devcontainer.json +8 -0
- package/.eslintrc.json +137 -0
- package/.github/ISSUE_TEMPLATE/bug_report.md +38 -0
- package/.github/ISSUE_TEMPLATE/new_component_proposal_template.md +41 -0
- package/.github/dependabot.yml +18 -0
- package/.github/pull_request_template.md +18 -0
- package/.github/workflows/check_for_changeset.yml +25 -0
- package/.github/workflows/ci.yml +31 -0
- package/.github/workflows/deploy_preview.yml +47 -0
- package/.github/workflows/deploy_production.yml +70 -0
- package/.github/workflows/release.yml +35 -0
- package/.github/workflows/release_canary.yml +70 -0
- package/.github/workflows/release_candidate.yml +60 -0
- package/.github/workflows/size.yml +13 -0
- package/.github/workflows/stale.yml +26 -0
- package/.gitignore +10 -0
- package/.npmrc +4 -0
- package/.nvmrc +1 -0
- package/.storybook/main.js +9 -0
- package/.storybook/preview.js +117 -0
- package/.vscode/launch.json +21 -0
- package/.vscode/settings.json +13 -0
- package/@types/@styled-system/index.d.ts +0 -0
- package/@types/@styled-system/prop-types/index.d.ts +1 -0
- package/@types/@styled-system/props/index.d.ts +1 -0
- package/@types/jest-styled-components/index.d.ts +1 -0
- package/CHANGELOG.md +6 -0
- package/CODEOWNERS +2 -0
- package/babel-defines.js +13 -0
- package/babel.config.js +39 -0
- package/contributor-docs/CODE_OF_CONDUCT.md +76 -0
- package/contributor-docs/CONTRIBUTING.md +274 -0
- package/contributor-docs/adrs/adr-001-typescript.md +23 -0
- package/contributor-docs/adrs/adr-002-behavior-isolation.md +108 -0
- package/contributor-docs/adrs/adr-003-prop-norms.md +72 -0
- package/contributor-docs/behaviors.md +132 -0
- package/contributor-docs/component-contents-api-patterns.md +316 -0
- package/contributor-docs/principles.md +39 -0
- package/dist/browser.esm.js.map +1 -1
- package/dist/browser.umd.js.map +1 -1
- package/docs/.eslintrc +0 -0
- package/docs/.gitignore +91 -0
- package/docs/components/PropsList.js +5 -0
- package/docs/components/State.js +9 -0
- package/docs/components/constants.js +34 -0
- package/docs/components/index.js +2 -0
- package/docs/content/ActionList.mdx +99 -0
- package/docs/content/ActionList2.mdx +359 -0
- package/docs/content/ActionMenu.mdx +80 -0
- package/docs/content/AnchoredOverlay.mdx +37 -0
- package/docs/content/Autocomplete.mdx +657 -0
- package/docs/content/Avatar.mdx +33 -0
- package/docs/content/AvatarStack.mdx +37 -0
- package/docs/content/BorderBox.md +46 -0
- package/docs/content/Box.mdx +96 -0
- package/docs/content/BranchName.md +18 -0
- package/docs/content/Breadcrumbs.md +47 -0
- package/docs/content/Buttons.md +46 -0
- package/docs/content/CircleBadge.md +35 -0
- package/docs/content/CircleOcticon.md +18 -0
- package/docs/content/CounterLabel.md +22 -0
- package/docs/content/Details.md +105 -0
- package/docs/content/Dialog.md +105 -0
- package/docs/content/Dialog2.mdx +180 -0
- package/docs/content/Dropdown.md +65 -0
- package/docs/content/DropdownMenu.mdx +49 -0
- package/docs/content/FilterList.md +37 -0
- package/docs/content/FilteredSearch.md +32 -0
- package/docs/content/Flash.md +35 -0
- package/docs/content/Flex.md +58 -0
- package/docs/content/FormGroup.md +38 -0
- package/docs/content/Grid.md +59 -0
- package/docs/content/Header.md +77 -0
- package/docs/content/Heading.md +22 -0
- package/docs/content/Label.md +49 -0
- package/docs/content/LabelGroup.md +21 -0
- package/docs/content/Link.md +28 -0
- package/docs/content/Overlay.mdx +85 -0
- package/docs/content/Pagehead.md +18 -0
- package/docs/content/Pagination.md +178 -0
- package/docs/content/PointerBox.md +81 -0
- package/docs/content/Popover.md +129 -0
- package/docs/content/Portal.mdx +78 -0
- package/docs/content/Position.md +100 -0
- package/docs/content/ProgressBar.mdx +29 -0
- package/docs/content/SelectMenu.md +371 -0
- package/docs/content/SelectPanel.mdx +67 -0
- package/docs/content/SideNav.md +171 -0
- package/docs/content/Spinner.mdx +32 -0
- package/docs/content/StateLabel.md +27 -0
- package/docs/content/StyledOcticon.md +27 -0
- package/docs/content/SubNav.md +100 -0
- package/docs/content/TabNav.md +42 -0
- package/docs/content/Text.md +31 -0
- package/docs/content/TextInput.md +34 -0
- package/docs/content/TextInputTokens.mdx +89 -0
- package/docs/content/TextInputWithTokens.mdx +211 -0
- package/docs/content/Timeline.md +148 -0
- package/docs/content/Token.mdx +381 -0
- package/docs/content/Tooltip.md +32 -0
- package/docs/content/Truncate.md +55 -0
- package/docs/content/UnderlineNav.md +45 -0
- package/docs/content/anchoredPosition.mdx +163 -0
- package/docs/content/core-concepts.md +70 -0
- package/docs/content/focusTrap.mdx +103 -0
- package/docs/content/focusZone.mdx +145 -0
- package/docs/content/getting-started.md +138 -0
- package/docs/content/index.md +33 -0
- package/docs/content/linting.md +35 -0
- package/docs/content/overriding-styles.mdx +82 -0
- package/docs/content/philosophy.md +23 -0
- package/docs/content/primer-theme.md +89 -0
- package/docs/content/ssr.mdx +43 -0
- package/docs/content/system-props.mdx +37 -0
- package/docs/content/theme-reference.md +16 -0
- package/docs/content/theming.md +272 -0
- package/docs/content/useOnEscapePress.mdx +56 -0
- package/docs/content/useOnOutsideClick.mdx +57 -0
- package/docs/content/useOpenAndCloseFocus.mdx +49 -0
- package/docs/content/useOverlay.mdx +62 -0
- package/docs/content/useSafeTimeout.mdx +32 -0
- package/docs/gatsby-config.js +30 -0
- package/docs/gatsby-node.js +101 -0
- package/docs/package-lock.json +20867 -0
- package/docs/package.json +36 -0
- package/docs/src/@primer/gatsby-theme-doctocat/components/hero.js +21 -0
- package/docs/src/@primer/gatsby-theme-doctocat/components/live-preview-wrapper.js +41 -0
- package/docs/src/@primer/gatsby-theme-doctocat/live-code-scope.js +73 -0
- package/docs/src/@primer/gatsby-theme-doctocat/nav.yml +133 -0
- package/docs/src/@primer/gatsby-theme-doctocat/primer-components-hero.svg +1411 -0
- package/docs/src/component-checklist.js +81 -0
- package/docs/src/props.js +77 -0
- package/jest.config.js +13 -0
- package/lib/Overlay.d.ts +5 -3
- package/lib/__tests__/ActionList.test.d.ts +1 -0
- package/lib/__tests__/ActionList.test.js +69 -0
- package/lib/__tests__/ActionList.types.test.d.ts +6 -0
- package/lib/__tests__/ActionList.types.test.js +69 -0
- package/lib/__tests__/ActionList2.test.d.ts +1 -0
- package/lib/__tests__/ActionList2.test.js +53 -0
- package/lib/__tests__/ActionMenu.test.d.ts +1 -0
- package/lib/__tests__/ActionMenu.test.js +151 -0
- package/lib/__tests__/AnchoredOverlay.test.d.ts +1 -0
- package/lib/__tests__/AnchoredOverlay.test.js +162 -0
- package/lib/__tests__/Autocomplete.test.d.ts +1 -0
- package/lib/__tests__/Autocomplete.test.js +528 -0
- package/lib/__tests__/Avatar.test.d.ts +1 -0
- package/lib/__tests__/Avatar.test.js +67 -0
- package/lib/__tests__/AvatarStack.test.d.ts +1 -0
- package/lib/__tests__/AvatarStack.test.js +71 -0
- package/lib/__tests__/BorderBox.test.d.ts +1 -0
- package/lib/__tests__/BorderBox.test.js +58 -0
- package/lib/__tests__/Box.test.d.ts +1 -0
- package/lib/__tests__/Box.test.js +78 -0
- package/lib/__tests__/BranchName.test.d.ts +1 -0
- package/lib/__tests__/BranchName.test.js +36 -0
- package/lib/__tests__/Breadcrumbs.test.d.ts +1 -0
- package/lib/__tests__/Breadcrumbs.test.js +40 -0
- package/lib/__tests__/Breadcrumbs.types.test.d.ts +3 -0
- package/lib/__tests__/Breadcrumbs.types.test.js +25 -0
- package/lib/__tests__/BreadcrumbsItem.test.d.ts +1 -0
- package/lib/__tests__/BreadcrumbsItem.test.js +49 -0
- package/lib/__tests__/Button.test.d.ts +1 -0
- package/lib/__tests__/Button.test.js +147 -0
- package/lib/__tests__/Caret.test.d.ts +1 -0
- package/lib/__tests__/Caret.test.js +52 -0
- package/lib/__tests__/CircleBadge.test.d.ts +1 -0
- package/lib/__tests__/CircleBadge.test.js +83 -0
- package/lib/__tests__/CircleBadge.types.test.d.ts +3 -0
- package/lib/__tests__/CircleBadge.types.test.js +28 -0
- package/lib/__tests__/CircleOcticon.test.d.ts +1 -0
- package/lib/__tests__/CircleOcticon.test.js +71 -0
- package/lib/__tests__/ConfirmationDialog.test.d.ts +1 -0
- package/lib/__tests__/ConfirmationDialog.test.js +134 -0
- package/lib/__tests__/CounterLabel.test.d.ts +1 -0
- package/lib/__tests__/CounterLabel.test.js +58 -0
- package/lib/__tests__/CounterLabel.types.test.d.ts +3 -0
- package/lib/__tests__/CounterLabel.types.test.js +28 -0
- package/lib/__tests__/Details.test.d.ts +1 -0
- package/lib/__tests__/Details.test.js +117 -0
- package/lib/__tests__/Dialog.test.d.ts +1 -0
- package/lib/__tests__/Dialog.test.js +184 -0
- package/lib/__tests__/Dialog.types.test.d.ts +3 -0
- package/lib/__tests__/Dialog.types.test.js +28 -0
- package/lib/__tests__/Dialog2.types.test.d.ts +3 -0
- package/lib/__tests__/Dialog2.types.test.js +31 -0
- package/lib/__tests__/Dropdown.test.d.ts +1 -0
- package/lib/__tests__/Dropdown.test.js +63 -0
- package/lib/__tests__/Dropdown.types.test.d.ts +3 -0
- package/lib/__tests__/Dropdown.types.test.js +31 -0
- package/lib/__tests__/DropdownMenu.test.d.ts +1 -0
- package/lib/__tests__/DropdownMenu.test.js +150 -0
- package/lib/__tests__/FilterList.test.d.ts +1 -0
- package/lib/__tests__/FilterList.test.js +36 -0
- package/lib/__tests__/FilterList.types.test.d.ts +3 -0
- package/lib/__tests__/FilterList.types.test.js +27 -0
- package/lib/__tests__/FilterListItem.test.d.ts +1 -0
- package/lib/__tests__/FilterListItem.test.js +46 -0
- package/lib/__tests__/FilteredSearch.test.d.ts +1 -0
- package/lib/__tests__/FilteredSearch.test.js +36 -0
- package/lib/__tests__/FilteredSearch.types.test.d.ts +3 -0
- package/lib/__tests__/FilteredSearch.types.test.js +28 -0
- package/lib/__tests__/Flash.test.d.ts +1 -0
- package/lib/__tests__/Flash.test.js +62 -0
- package/lib/__tests__/Flash.types.test.d.ts +3 -0
- package/lib/__tests__/Flash.types.test.js +28 -0
- package/lib/__tests__/Flex.test.d.ts +1 -0
- package/lib/__tests__/Flex.test.js +74 -0
- package/lib/__tests__/FormGroup.test.d.ts +1 -0
- package/lib/__tests__/FormGroup.test.js +54 -0
- package/lib/__tests__/FormGroup.types.test.d.ts +3 -0
- package/lib/__tests__/FormGroup.types.test.js +28 -0
- package/lib/__tests__/Grid.test.d.ts +1 -0
- package/lib/__tests__/Grid.test.js +104 -0
- package/lib/__tests__/Header.test.d.ts +1 -0
- package/lib/__tests__/Header.test.js +58 -0
- package/lib/__tests__/Header.types.test.d.ts +3 -0
- package/lib/__tests__/Header.types.test.js +29 -0
- package/lib/__tests__/Heading.test.d.ts +1 -0
- package/lib/__tests__/Heading.test.js +109 -0
- package/lib/__tests__/KeyPaths.types.test.d.ts +11 -0
- package/lib/__tests__/KeyPaths.types.test.js +10 -0
- package/lib/__tests__/Label.test.d.ts +1 -0
- package/lib/__tests__/Label.test.js +46 -0
- package/lib/__tests__/Label.types.test.d.ts +3 -0
- package/lib/__tests__/Label.types.test.js +28 -0
- package/lib/__tests__/LabelGroup.test.d.ts +1 -0
- package/lib/__tests__/LabelGroup.test.js +38 -0
- package/lib/__tests__/LabelGroup.types.test.d.ts +3 -0
- package/lib/__tests__/LabelGroup.types.test.js +28 -0
- package/lib/__tests__/Link.test.d.ts +1 -0
- package/lib/__tests__/Link.test.js +76 -0
- package/lib/__tests__/Link.types.test.d.ts +3 -0
- package/lib/__tests__/Link.types.test.js +28 -0
- package/lib/__tests__/Merge.types.test.d.ts +30 -0
- package/lib/__tests__/Merge.types.test.js +27 -0
- package/lib/__tests__/NewButton.test.d.ts +1 -0
- package/lib/__tests__/NewButton.test.js +95 -0
- package/lib/__tests__/Overlay.test.d.ts +1 -0
- package/lib/__tests__/Overlay.test.js +145 -0
- package/lib/__tests__/Overlay.types.test.d.ts +6 -0
- package/lib/__tests__/Overlay.types.test.js +73 -0
- package/lib/__tests__/Pagehead.test.d.ts +1 -0
- package/lib/__tests__/Pagehead.test.js +37 -0
- package/lib/__tests__/Pagehead.types.test.d.ts +3 -0
- package/lib/__tests__/Pagehead.types.test.js +28 -0
- package/lib/__tests__/Pagination/Pagination.test.d.ts +1 -0
- package/lib/__tests__/Pagination/Pagination.test.js +47 -0
- package/lib/__tests__/Pagination/PaginationModel.test.d.ts +1 -0
- package/lib/__tests__/Pagination/PaginationModel.test.js +186 -0
- package/lib/__tests__/Pagination.types.test.d.ts +3 -0
- package/lib/__tests__/Pagination.types.test.js +33 -0
- package/lib/__tests__/PointerBox.test.d.ts +1 -0
- package/lib/__tests__/PointerBox.test.js +46 -0
- package/lib/__tests__/Popover.test.d.ts +1 -0
- package/lib/__tests__/Popover.test.js +66 -0
- package/lib/__tests__/Popover.types.test.d.ts +3 -0
- package/lib/__tests__/Popover.types.test.js +27 -0
- package/lib/__tests__/Portal.test.d.ts +1 -0
- package/lib/__tests__/Portal.test.js +124 -0
- package/lib/__tests__/Position.test.d.ts +1 -0
- package/lib/__tests__/Position.test.js +143 -0
- package/lib/__tests__/ProgressBar.test.d.ts +1 -0
- package/lib/__tests__/ProgressBar.test.js +68 -0
- package/lib/__tests__/SelectMenu.test.d.ts +1 -0
- package/lib/__tests__/SelectMenu.test.js +155 -0
- package/lib/__tests__/SelectMenu.types.test.d.ts +3 -0
- package/lib/__tests__/SelectMenu.types.test.js +47 -0
- package/lib/__tests__/SelectPanel.test.d.ts +1 -0
- package/lib/__tests__/SelectPanel.test.js +80 -0
- package/lib/__tests__/SelectPanel.types.test.d.ts +3 -0
- package/lib/__tests__/SelectPanel.types.test.js +44 -0
- package/lib/__tests__/SideNav.test.d.ts +1 -0
- package/lib/__tests__/SideNav.test.js +71 -0
- package/lib/__tests__/SideNav.types.test.d.ts +3 -0
- package/lib/__tests__/SideNav.types.test.js +28 -0
- package/lib/__tests__/Spinner.test.d.ts +1 -0
- package/lib/__tests__/Spinner.test.js +53 -0
- package/lib/__tests__/StateLabel.test.d.ts +1 -0
- package/lib/__tests__/StateLabel.test.js +71 -0
- package/lib/__tests__/StateLabel.types.test.d.ts +3 -0
- package/lib/__tests__/StateLabel.types.test.js +28 -0
- package/lib/__tests__/StyledOcticon.test.d.ts +1 -0
- package/lib/__tests__/StyledOcticon.test.js +40 -0
- package/lib/__tests__/StyledOcticon.types.test.d.ts +3 -0
- package/lib/__tests__/StyledOcticon.types.test.js +32 -0
- package/lib/__tests__/SubNav.test.d.ts +1 -0
- package/lib/__tests__/SubNav.test.js +62 -0
- package/lib/__tests__/SubNav.types.test.d.ts +3 -0
- package/lib/__tests__/SubNav.types.test.js +27 -0
- package/lib/__tests__/SubNavLink.test.d.ts +1 -0
- package/lib/__tests__/SubNavLink.test.js +49 -0
- package/lib/__tests__/TabNav.test.d.ts +1 -0
- package/lib/__tests__/TabNav.test.js +49 -0
- package/lib/__tests__/TabNav.types.test.d.ts +3 -0
- package/lib/__tests__/TabNav.types.test.js +25 -0
- package/lib/__tests__/Text.test.d.ts +1 -0
- package/lib/__tests__/Text.test.js +105 -0
- package/lib/__tests__/TextInput.test.d.ts +1 -0
- package/lib/__tests__/TextInput.test.js +78 -0
- package/lib/__tests__/TextInputWithTokens.test.d.ts +1 -0
- package/lib/__tests__/TextInputWithTokens.test.js +572 -0
- package/lib/__tests__/ThemeProvider.test.d.ts +1 -0
- package/lib/__tests__/ThemeProvider.test.js +444 -0
- package/lib/__tests__/Timeline.test.d.ts +1 -0
- package/lib/__tests__/Timeline.test.js +75 -0
- package/lib/__tests__/Timeline.types.test.d.ts +3 -0
- package/lib/__tests__/Timeline.types.test.js +31 -0
- package/lib/__tests__/Token.test.d.ts +1 -0
- package/lib/__tests__/Token.test.js +180 -0
- package/lib/__tests__/Tooltip.test.d.ts +1 -0
- package/lib/__tests__/Tooltip.test.js +69 -0
- package/lib/__tests__/Tooltip.types.test.d.ts +3 -0
- package/lib/__tests__/Tooltip.types.test.js +28 -0
- package/lib/__tests__/Truncate.test.d.ts +1 -0
- package/lib/__tests__/Truncate.test.js +63 -0
- package/lib/__tests__/Truncate.types.test.d.ts +3 -0
- package/lib/__tests__/Truncate.types.test.js +31 -0
- package/lib/__tests__/UnderlineNav.test.d.ts +1 -0
- package/lib/__tests__/UnderlineNav.test.js +72 -0
- package/lib/__tests__/UnderlineNav.types.test.d.ts +3 -0
- package/lib/__tests__/UnderlineNav.types.test.js +25 -0
- package/lib/__tests__/UnderlineNavLink.test.d.ts +1 -0
- package/lib/__tests__/UnderlineNavLink.test.js +51 -0
- package/lib/__tests__/behaviors/anchoredPosition.test.d.ts +1 -0
- package/lib/__tests__/behaviors/anchoredPosition.test.js +390 -0
- package/lib/__tests__/behaviors/focusTrap.test.d.ts +1 -0
- package/lib/__tests__/behaviors/focusTrap.test.js +234 -0
- package/lib/__tests__/behaviors/focusZone.test.d.ts +1 -0
- package/lib/__tests__/behaviors/focusZone.test.js +570 -0
- package/lib/__tests__/behaviors/iterateFocusableElements.test.d.ts +1 -0
- package/lib/__tests__/behaviors/iterateFocusableElements.test.js +55 -0
- package/lib/__tests__/behaviors/scrollIntoViewingArea.test.d.ts +1 -0
- package/lib/__tests__/behaviors/scrollIntoViewingArea.test.js +226 -0
- package/lib/__tests__/filterObject.test.d.ts +1 -0
- package/lib/__tests__/filterObject.test.js +30 -0
- package/lib/__tests__/hooks/useAnchoredPosition.test.d.ts +1 -0
- package/lib/__tests__/hooks/useAnchoredPosition.test.js +54 -0
- package/lib/__tests__/hooks/useOnEscapePress.test.d.ts +1 -0
- package/lib/__tests__/hooks/useOnEscapePress.test.js +32 -0
- package/lib/__tests__/hooks/useOnOutsideClick.test.d.ts +1 -0
- package/lib/__tests__/hooks/useOnOutsideClick.test.js +87 -0
- package/lib/__tests__/hooks/useOpenAndCloseFocus.test.d.ts +1 -0
- package/lib/__tests__/hooks/useOpenAndCloseFocus.test.js +60 -0
- package/lib/__tests__/hooks/useProvidedStateOrCreate.test.d.ts +1 -0
- package/lib/__tests__/hooks/useProvidedStateOrCreate.test.js +45 -0
- package/lib/__tests__/theme.test.d.ts +1 -0
- package/lib/__tests__/theme.test.js +36 -0
- package/lib/__tests__/themeGet.test.d.ts +1 -0
- package/lib/__tests__/themeGet.test.js +25 -0
- package/lib/__tests__/useSafeTimeout.test.d.ts +1 -0
- package/lib/__tests__/useSafeTimeout.test.js +45 -0
- package/lib/__tests__/utils/createSlots.test.d.ts +1 -0
- package/lib/__tests__/utils/createSlots.test.js +75 -0
- package/lib/stories/ActionList.stories.js +454 -0
- package/lib/stories/ActionList2.stories.js +909 -0
- package/lib/stories/ActionMenu.stories.js +348 -0
- package/lib/stories/AnchoredOverlay.stories.js +127 -0
- package/lib/stories/Autocomplete.stories.js +619 -0
- package/lib/stories/AvatarStack.stories.js +49 -0
- package/lib/stories/Button.stories.js +125 -0
- package/lib/stories/ConfirmationDialog.stories.js +119 -0
- package/lib/stories/Dialog.stories.js +269 -0
- package/lib/stories/DropdownMenu.stories.js +122 -0
- package/lib/stories/IssueLabelToken.stories.js +165 -0
- package/lib/stories/NewButton.stories.js +230 -0
- package/lib/stories/Overlay.stories.js +204 -0
- package/lib/stories/Portal.stories.js +104 -0
- package/lib/stories/ProfileToken.stories.js +162 -0
- package/lib/stories/SelectPanel.stories.js +399 -0
- package/lib/stories/TextInput.stories.js +144 -0
- package/lib/stories/TextInputWithTokens.stories.js +252 -0
- package/lib/stories/ThemeProvider.stories.js +102 -0
- package/lib/stories/Token.stories.js +176 -0
- package/lib/stories/useAnchoredPosition.stories.js +351 -0
- package/lib/stories/useFocusTrap.stories.js +360 -0
- package/lib/stories/useFocusZone.stories.js +607 -0
- package/lib-esm/Overlay.d.ts +5 -3
- package/lib-esm/__tests__/ActionList.test.d.ts +1 -0
- package/lib-esm/__tests__/ActionList.test.js +57 -0
- package/lib-esm/__tests__/ActionList.types.test.d.ts +6 -0
- package/lib-esm/__tests__/ActionList.types.test.js +45 -0
- package/lib-esm/__tests__/ActionList2.test.d.ts +1 -0
- package/lib-esm/__tests__/ActionList2.test.js +41 -0
- package/lib-esm/__tests__/ActionMenu.test.d.ts +1 -0
- package/lib-esm/__tests__/ActionMenu.test.js +139 -0
- package/lib-esm/__tests__/AnchoredOverlay.test.d.ts +1 -0
- package/lib-esm/__tests__/AnchoredOverlay.test.js +136 -0
- package/lib-esm/__tests__/Autocomplete.test.d.ts +1 -0
- package/lib-esm/__tests__/Autocomplete.test.js +494 -0
- package/lib-esm/__tests__/Avatar.test.d.ts +1 -0
- package/lib-esm/__tests__/Avatar.test.js +56 -0
- package/lib-esm/__tests__/AvatarStack.test.d.ts +1 -0
- package/lib-esm/__tests__/AvatarStack.test.js +58 -0
- package/lib-esm/__tests__/BorderBox.test.d.ts +1 -0
- package/lib-esm/__tests__/BorderBox.test.js +47 -0
- package/lib-esm/__tests__/Box.test.d.ts +1 -0
- package/lib-esm/__tests__/Box.test.js +67 -0
- package/lib-esm/__tests__/BranchName.test.d.ts +1 -0
- package/lib-esm/__tests__/BranchName.test.js +26 -0
- package/lib-esm/__tests__/Breadcrumbs.test.d.ts +1 -0
- package/lib-esm/__tests__/Breadcrumbs.test.js +30 -0
- package/lib-esm/__tests__/Breadcrumbs.types.test.d.ts +3 -0
- package/lib-esm/__tests__/Breadcrumbs.types.test.js +12 -0
- package/lib-esm/__tests__/BreadcrumbsItem.test.d.ts +1 -0
- package/lib-esm/__tests__/BreadcrumbsItem.test.js +39 -0
- package/lib-esm/__tests__/Button.test.d.ts +1 -0
- package/lib-esm/__tests__/Button.test.js +137 -0
- package/lib-esm/__tests__/Caret.test.d.ts +1 -0
- package/lib-esm/__tests__/Caret.test.js +42 -0
- package/lib-esm/__tests__/CircleBadge.test.d.ts +1 -0
- package/lib-esm/__tests__/CircleBadge.test.js +70 -0
- package/lib-esm/__tests__/CircleBadge.types.test.d.ts +3 -0
- package/lib-esm/__tests__/CircleBadge.types.test.js +13 -0
- package/lib-esm/__tests__/CircleOcticon.test.d.ts +1 -0
- package/lib-esm/__tests__/CircleOcticon.test.js +59 -0
- package/lib-esm/__tests__/ConfirmationDialog.test.d.ts +1 -0
- package/lib-esm/__tests__/ConfirmationDialog.test.js +113 -0
- package/lib-esm/__tests__/CounterLabel.test.d.ts +1 -0
- package/lib-esm/__tests__/CounterLabel.test.js +47 -0
- package/lib-esm/__tests__/CounterLabel.types.test.d.ts +3 -0
- package/lib-esm/__tests__/CounterLabel.types.test.js +13 -0
- package/lib-esm/__tests__/Details.test.d.ts +1 -0
- package/lib-esm/__tests__/Details.test.js +107 -0
- package/lib-esm/__tests__/Dialog.test.d.ts +1 -0
- package/lib-esm/__tests__/Dialog.test.js +171 -0
- package/lib-esm/__tests__/Dialog.types.test.d.ts +3 -0
- package/lib-esm/__tests__/Dialog.types.test.js +13 -0
- package/lib-esm/__tests__/Dialog2.types.test.d.ts +3 -0
- package/lib-esm/__tests__/Dialog2.types.test.js +16 -0
- package/lib-esm/__tests__/Dropdown.test.d.ts +1 -0
- package/lib-esm/__tests__/Dropdown.test.js +53 -0
- package/lib-esm/__tests__/Dropdown.types.test.d.ts +3 -0
- package/lib-esm/__tests__/Dropdown.types.test.js +17 -0
- package/lib-esm/__tests__/DropdownMenu.test.d.ts +1 -0
- package/lib-esm/__tests__/DropdownMenu.test.js +137 -0
- package/lib-esm/__tests__/FilterList.test.d.ts +1 -0
- package/lib-esm/__tests__/FilterList.test.js +26 -0
- package/lib-esm/__tests__/FilterList.types.test.d.ts +3 -0
- package/lib-esm/__tests__/FilterList.types.test.js +13 -0
- package/lib-esm/__tests__/FilterListItem.test.d.ts +1 -0
- package/lib-esm/__tests__/FilterListItem.test.js +36 -0
- package/lib-esm/__tests__/FilteredSearch.test.d.ts +1 -0
- package/lib-esm/__tests__/FilteredSearch.test.js +26 -0
- package/lib-esm/__tests__/FilteredSearch.types.test.d.ts +3 -0
- package/lib-esm/__tests__/FilteredSearch.types.test.js +13 -0
- package/lib-esm/__tests__/Flash.test.d.ts +1 -0
- package/lib-esm/__tests__/Flash.test.js +51 -0
- package/lib-esm/__tests__/Flash.types.test.d.ts +3 -0
- package/lib-esm/__tests__/Flash.types.test.js +13 -0
- package/lib-esm/__tests__/Flex.test.d.ts +1 -0
- package/lib-esm/__tests__/Flex.test.js +64 -0
- package/lib-esm/__tests__/FormGroup.test.d.ts +1 -0
- package/lib-esm/__tests__/FormGroup.test.js +44 -0
- package/lib-esm/__tests__/FormGroup.types.test.d.ts +3 -0
- package/lib-esm/__tests__/FormGroup.types.test.js +13 -0
- package/lib-esm/__tests__/Grid.test.d.ts +1 -0
- package/lib-esm/__tests__/Grid.test.js +94 -0
- package/lib-esm/__tests__/Header.test.d.ts +1 -0
- package/lib-esm/__tests__/Header.test.js +48 -0
- package/lib-esm/__tests__/Header.types.test.d.ts +3 -0
- package/lib-esm/__tests__/Header.types.test.js +15 -0
- package/lib-esm/__tests__/Heading.test.d.ts +1 -0
- package/lib-esm/__tests__/Heading.test.js +99 -0
- package/lib-esm/__tests__/KeyPaths.types.test.d.ts +11 -0
- package/lib-esm/__tests__/KeyPaths.types.test.js +3 -0
- package/lib-esm/__tests__/Label.test.d.ts +1 -0
- package/lib-esm/__tests__/Label.test.js +36 -0
- package/lib-esm/__tests__/Label.types.test.d.ts +3 -0
- package/lib-esm/__tests__/Label.types.test.js +13 -0
- package/lib-esm/__tests__/LabelGroup.test.d.ts +1 -0
- package/lib-esm/__tests__/LabelGroup.test.js +26 -0
- package/lib-esm/__tests__/LabelGroup.types.test.d.ts +3 -0
- package/lib-esm/__tests__/LabelGroup.types.test.js +13 -0
- package/lib-esm/__tests__/Link.test.d.ts +1 -0
- package/lib-esm/__tests__/Link.test.js +66 -0
- package/lib-esm/__tests__/Link.types.test.d.ts +3 -0
- package/lib-esm/__tests__/Link.types.test.js +13 -0
- package/lib-esm/__tests__/Merge.types.test.d.ts +30 -0
- package/lib-esm/__tests__/Merge.types.test.js +14 -0
- package/lib-esm/__tests__/NewButton.test.d.ts +1 -0
- package/lib-esm/__tests__/NewButton.test.js +84 -0
- package/lib-esm/__tests__/Overlay.test.d.ts +1 -0
- package/lib-esm/__tests__/Overlay.test.js +123 -0
- package/lib-esm/__tests__/Overlay.types.test.d.ts +6 -0
- package/lib-esm/__tests__/Overlay.types.test.js +49 -0
- package/lib-esm/__tests__/Pagehead.test.d.ts +1 -0
- package/lib-esm/__tests__/Pagehead.test.js +26 -0
- package/lib-esm/__tests__/Pagehead.types.test.d.ts +3 -0
- package/lib-esm/__tests__/Pagehead.types.test.js +13 -0
- package/lib-esm/__tests__/Pagination/Pagination.test.d.ts +1 -0
- package/lib-esm/__tests__/Pagination/Pagination.test.js +35 -0
- package/lib-esm/__tests__/Pagination/PaginationModel.test.d.ts +1 -0
- package/lib-esm/__tests__/Pagination/PaginationModel.test.js +182 -0
- package/lib-esm/__tests__/Pagination.types.test.d.ts +3 -0
- package/lib-esm/__tests__/Pagination.types.test.js +18 -0
- package/lib-esm/__tests__/PointerBox.test.d.ts +1 -0
- package/lib-esm/__tests__/PointerBox.test.js +36 -0
- package/lib-esm/__tests__/Popover.test.d.ts +1 -0
- package/lib-esm/__tests__/Popover.test.js +53 -0
- package/lib-esm/__tests__/Popover.types.test.d.ts +3 -0
- package/lib-esm/__tests__/Popover.types.test.js +13 -0
- package/lib-esm/__tests__/Portal.test.d.ts +1 -0
- package/lib-esm/__tests__/Portal.test.js +104 -0
- package/lib-esm/__tests__/Position.test.d.ts +1 -0
- package/lib-esm/__tests__/Position.test.js +133 -0
- package/lib-esm/__tests__/ProgressBar.test.d.ts +1 -0
- package/lib-esm/__tests__/ProgressBar.test.js +58 -0
- package/lib-esm/__tests__/SelectMenu.test.d.ts +1 -0
- package/lib-esm/__tests__/SelectMenu.test.js +145 -0
- package/lib-esm/__tests__/SelectMenu.types.test.d.ts +3 -0
- package/lib-esm/__tests__/SelectMenu.types.test.js +33 -0
- package/lib-esm/__tests__/SelectPanel.test.d.ts +1 -0
- package/lib-esm/__tests__/SelectPanel.test.js +65 -0
- package/lib-esm/__tests__/SelectPanel.types.test.d.ts +3 -0
- package/lib-esm/__tests__/SelectPanel.types.test.js +29 -0
- package/lib-esm/__tests__/SideNav.test.d.ts +1 -0
- package/lib-esm/__tests__/SideNav.test.js +60 -0
- package/lib-esm/__tests__/SideNav.types.test.d.ts +3 -0
- package/lib-esm/__tests__/SideNav.types.test.js +13 -0
- package/lib-esm/__tests__/Spinner.test.d.ts +1 -0
- package/lib-esm/__tests__/Spinner.test.js +43 -0
- package/lib-esm/__tests__/StateLabel.test.d.ts +1 -0
- package/lib-esm/__tests__/StateLabel.test.js +61 -0
- package/lib-esm/__tests__/StateLabel.types.test.d.ts +3 -0
- package/lib-esm/__tests__/StateLabel.types.test.js +13 -0
- package/lib-esm/__tests__/StyledOcticon.test.d.ts +1 -0
- package/lib-esm/__tests__/StyledOcticon.test.js +29 -0
- package/lib-esm/__tests__/StyledOcticon.types.test.d.ts +3 -0
- package/lib-esm/__tests__/StyledOcticon.types.test.js +16 -0
- package/lib-esm/__tests__/SubNav.test.d.ts +1 -0
- package/lib-esm/__tests__/SubNav.test.js +50 -0
- package/lib-esm/__tests__/SubNav.types.test.d.ts +3 -0
- package/lib-esm/__tests__/SubNav.types.test.js +14 -0
- package/lib-esm/__tests__/SubNavLink.test.d.ts +1 -0
- package/lib-esm/__tests__/SubNavLink.test.js +39 -0
- package/lib-esm/__tests__/TabNav.test.d.ts +1 -0
- package/lib-esm/__tests__/TabNav.test.js +39 -0
- package/lib-esm/__tests__/TabNav.types.test.d.ts +3 -0
- package/lib-esm/__tests__/TabNav.types.test.js +12 -0
- package/lib-esm/__tests__/Text.test.d.ts +1 -0
- package/lib-esm/__tests__/Text.test.js +93 -0
- package/lib-esm/__tests__/TextInput.test.d.ts +1 -0
- package/lib-esm/__tests__/TextInput.test.js +68 -0
- package/lib-esm/__tests__/TextInputWithTokens.test.d.ts +1 -0
- package/lib-esm/__tests__/TextInputWithTokens.test.js +511 -0
- package/lib-esm/__tests__/ThemeProvider.test.d.ts +1 -0
- package/lib-esm/__tests__/ThemeProvider.test.js +408 -0
- package/lib-esm/__tests__/Timeline.test.d.ts +1 -0
- package/lib-esm/__tests__/Timeline.test.js +65 -0
- package/lib-esm/__tests__/Timeline.types.test.d.ts +3 -0
- package/lib-esm/__tests__/Timeline.types.test.js +18 -0
- package/lib-esm/__tests__/Token.test.d.ts +1 -0
- package/lib-esm/__tests__/Token.test.js +166 -0
- package/lib-esm/__tests__/Tooltip.test.d.ts +1 -0
- package/lib-esm/__tests__/Tooltip.test.js +59 -0
- package/lib-esm/__tests__/Tooltip.types.test.d.ts +3 -0
- package/lib-esm/__tests__/Tooltip.types.test.js +13 -0
- package/lib-esm/__tests__/Truncate.test.d.ts +1 -0
- package/lib-esm/__tests__/Truncate.test.js +53 -0
- package/lib-esm/__tests__/Truncate.types.test.d.ts +3 -0
- package/lib-esm/__tests__/Truncate.types.test.js +16 -0
- package/lib-esm/__tests__/UnderlineNav.test.d.ts +1 -0
- package/lib-esm/__tests__/UnderlineNav.test.js +60 -0
- package/lib-esm/__tests__/UnderlineNav.types.test.d.ts +3 -0
- package/lib-esm/__tests__/UnderlineNav.types.test.js +12 -0
- package/lib-esm/__tests__/UnderlineNavLink.test.d.ts +1 -0
- package/lib-esm/__tests__/UnderlineNavLink.test.js +41 -0
- package/lib-esm/__tests__/behaviors/anchoredPosition.test.d.ts +1 -0
- package/lib-esm/__tests__/behaviors/anchoredPosition.test.js +388 -0
- package/lib-esm/__tests__/behaviors/focusTrap.test.d.ts +1 -0
- package/lib-esm/__tests__/behaviors/focusTrap.test.js +227 -0
- package/lib-esm/__tests__/behaviors/focusZone.test.d.ts +1 -0
- package/lib-esm/__tests__/behaviors/focusZone.test.js +487 -0
- package/lib-esm/__tests__/behaviors/iterateFocusableElements.test.d.ts +1 -0
- package/lib-esm/__tests__/behaviors/iterateFocusableElements.test.js +48 -0
- package/lib-esm/__tests__/behaviors/scrollIntoViewingArea.test.d.ts +1 -0
- package/lib-esm/__tests__/behaviors/scrollIntoViewingArea.test.js +224 -0
- package/lib-esm/__tests__/filterObject.test.d.ts +1 -0
- package/lib-esm/__tests__/filterObject.test.js +27 -0
- package/lib-esm/__tests__/hooks/useAnchoredPosition.test.d.ts +1 -0
- package/lib-esm/__tests__/hooks/useAnchoredPosition.test.js +46 -0
- package/lib-esm/__tests__/hooks/useOnEscapePress.test.d.ts +1 -0
- package/lib-esm/__tests__/hooks/useOnEscapePress.test.js +23 -0
- package/lib-esm/__tests__/hooks/useOnOutsideClick.test.d.ts +1 -0
- package/lib-esm/__tests__/hooks/useOnOutsideClick.test.js +68 -0
- package/lib-esm/__tests__/hooks/useOpenAndCloseFocus.test.d.ts +1 -0
- package/lib-esm/__tests__/hooks/useOpenAndCloseFocus.test.js +52 -0
- package/lib-esm/__tests__/hooks/useProvidedStateOrCreate.test.d.ts +1 -0
- package/lib-esm/__tests__/hooks/useProvidedStateOrCreate.test.js +36 -0
- package/lib-esm/__tests__/theme.test.d.ts +1 -0
- package/lib-esm/__tests__/theme.test.js +33 -0
- package/lib-esm/__tests__/themeGet.test.d.ts +1 -0
- package/lib-esm/__tests__/themeGet.test.js +22 -0
- package/lib-esm/__tests__/useSafeTimeout.test.d.ts +1 -0
- package/lib-esm/__tests__/useSafeTimeout.test.js +39 -0
- package/lib-esm/__tests__/utils/createSlots.test.d.ts +1 -0
- package/lib-esm/__tests__/utils/createSlots.test.js +67 -0
- package/lib-esm/stories/ActionList.stories.js +395 -0
- package/lib-esm/stories/ActionList2.stories.js +797 -0
- package/lib-esm/stories/ActionMenu.stories.js +303 -0
- package/lib-esm/stories/AnchoredOverlay.stories.js +101 -0
- package/lib-esm/stories/Autocomplete.stories.js +560 -0
- package/lib-esm/stories/AvatarStack.stories.js +32 -0
- package/lib-esm/stories/Button.stories.js +86 -0
- package/lib-esm/stories/ConfirmationDialog.stories.js +94 -0
- package/lib-esm/stories/Dialog.stories.js +244 -0
- package/lib-esm/stories/DropdownMenu.stories.js +94 -0
- package/lib-esm/stories/IssueLabelToken.stories.js +139 -0
- package/lib-esm/stories/NewButton.stories.js +178 -0
- package/lib-esm/stories/Overlay.stories.js +173 -0
- package/lib-esm/stories/Portal.stories.js +68 -0
- package/lib-esm/stories/ProfileToken.stories.js +136 -0
- package/lib-esm/stories/SelectPanel.stories.js +334 -0
- package/lib-esm/stories/TextInput.stories.js +117 -0
- package/lib-esm/stories/TextInputWithTokens.stories.js +210 -0
- package/lib-esm/stories/ThemeProvider.stories.js +83 -0
- package/lib-esm/stories/Token.stories.js +146 -0
- package/lib-esm/stories/useAnchoredPosition.stories.js +313 -0
- package/lib-esm/stories/useFocusTrap.stories.js +313 -0
- package/lib-esm/stories/useFocusZone.stories.js +562 -0
- package/migrating.md +250 -0
- package/now.json +17 -0
- package/package-lock.json +66509 -0
- package/package.json +1 -1
- package/rollup.config.js +36 -0
- package/script/build +21 -0
- package/script/build-storybook +10 -0
- package/script/setup +12 -0
- package/src/ActionList/Divider.tsx +25 -0
- package/src/ActionList/Group.tsx +45 -0
- package/src/ActionList/Header.tsx +74 -0
- package/src/ActionList/Item.tsx +480 -0
- package/src/ActionList/List.tsx +258 -0
- package/src/ActionList/index.ts +21 -0
- package/src/ActionList2/Description.tsx +52 -0
- package/src/ActionList2/Divider.tsx +24 -0
- package/src/ActionList2/Group.tsx +103 -0
- package/src/ActionList2/Header.tsx +58 -0
- package/src/ActionList2/Item.tsx +246 -0
- package/src/ActionList2/LinkItem.tsx +49 -0
- package/src/ActionList2/List.tsx +55 -0
- package/src/ActionList2/Selection.tsx +60 -0
- package/src/ActionList2/Visuals.tsx +76 -0
- package/src/ActionList2/index.ts +39 -0
- package/src/ActionMenu.tsx +106 -0
- package/src/AnchoredOverlay/AnchoredOverlay.tsx +191 -0
- package/src/AnchoredOverlay/index.ts +2 -0
- package/src/Autocomplete/Autocomplete.tsx +103 -0
- package/src/Autocomplete/AutocompleteContext.tsx +19 -0
- package/src/Autocomplete/AutocompleteInput.tsx +179 -0
- package/src/Autocomplete/AutocompleteMenu.tsx +341 -0
- package/src/Autocomplete/AutocompleteOverlay.tsx +68 -0
- package/src/Autocomplete/index.ts +2 -0
- package/src/Avatar.tsx +46 -0
- package/src/AvatarPair.tsx +35 -0
- package/src/AvatarStack.tsx +159 -0
- package/src/BaseStyles.tsx +53 -0
- package/src/BorderBox.tsx +18 -0
- package/src/Box.tsx +54 -0
- package/src/BranchName.tsx +19 -0
- package/src/Breadcrumbs.tsx +101 -0
- package/src/Button/Button.tsx +39 -0
- package/src/Button/ButtonBase.tsx +39 -0
- package/src/Button/ButtonClose.tsx +36 -0
- package/src/Button/ButtonDanger.tsx +42 -0
- package/src/Button/ButtonGroup.tsx +55 -0
- package/src/Button/ButtonInvisible.tsx +31 -0
- package/src/Button/ButtonOutline.tsx +42 -0
- package/src/Button/ButtonPrimary.tsx +40 -0
- package/src/Button/ButtonStyles.tsx +36 -0
- package/src/Button/ButtonTableList.tsx +45 -0
- package/src/Button/index.ts +16 -0
- package/src/Caret.tsx +133 -0
- package/src/CircleBadge.tsx +53 -0
- package/src/CircleOcticon.tsx +37 -0
- package/src/CounterLabel.tsx +50 -0
- package/src/Details.tsx +23 -0
- package/src/Dialog/ConfirmationDialog.tsx +184 -0
- package/src/Dialog/Dialog.tsx +444 -0
- package/src/Dialog.tsx +145 -0
- package/src/Dropdown.tsx +154 -0
- package/src/DropdownMenu/DropdownButton.tsx +15 -0
- package/src/DropdownMenu/DropdownMenu.tsx +115 -0
- package/src/DropdownMenu/index.ts +4 -0
- package/src/DropdownStyles.ts +128 -0
- package/src/FilterList.tsx +75 -0
- package/src/FilteredActionList/FilteredActionList.tsx +142 -0
- package/src/FilteredActionList/index.ts +2 -0
- package/src/FilteredSearch.tsx +27 -0
- package/src/Flash.tsx +75 -0
- package/src/Flex.tsx +15 -0
- package/src/FormGroup.tsx +24 -0
- package/src/Grid.tsx +15 -0
- package/src/Header.tsx +74 -0
- package/src/Heading.tsx +21 -0
- package/src/Label.tsx +72 -0
- package/src/LabelGroup.tsx +17 -0
- package/src/Link.tsx +42 -0
- package/src/NewButton/button-counter.tsx +15 -0
- package/src/NewButton/button.tsx +283 -0
- package/src/NewButton/index.ts +10 -0
- package/src/NewButton/types.ts +36 -0
- package/src/Overlay.tsx +203 -0
- package/src/Pagehead.tsx +16 -0
- package/src/Pagination/Pagination.tsx +212 -0
- package/src/Pagination/index.ts +4 -0
- package/src/Pagination/model.tsx +187 -0
- package/src/PointerBox.tsx +31 -0
- package/src/Popover.tsx +225 -0
- package/src/Portal/Portal.tsx +97 -0
- package/src/Portal/index.ts +5 -0
- package/src/Position.tsx +63 -0
- package/src/ProgressBar.tsx +52 -0
- package/src/SelectMenu/SelectMenu.tsx +123 -0
- package/src/SelectMenu/SelectMenuContext.tsx +9 -0
- package/src/SelectMenu/SelectMenuDivider.tsx +24 -0
- package/src/SelectMenu/SelectMenuFilter.tsx +50 -0
- package/src/SelectMenu/SelectMenuFooter.tsx +27 -0
- package/src/SelectMenu/SelectMenuHeader.tsx +48 -0
- package/src/SelectMenu/SelectMenuItem.tsx +136 -0
- package/src/SelectMenu/SelectMenuList.tsx +41 -0
- package/src/SelectMenu/SelectMenuLoadingAnimation.tsx +25 -0
- package/src/SelectMenu/SelectMenuModal.tsx +119 -0
- package/src/SelectMenu/SelectMenuTab.tsx +87 -0
- package/src/SelectMenu/SelectMenuTabPanel.tsx +29 -0
- package/src/SelectMenu/SelectMenuTabs.tsx +43 -0
- package/src/SelectMenu/hooks/useKeyboardNav.js +90 -0
- package/src/SelectMenu/index.ts +15 -0
- package/src/SelectPanel/SelectPanel.tsx +173 -0
- package/src/SelectPanel/index.ts +2 -0
- package/src/SideNav.tsx +191 -0
- package/src/Spinner.tsx +59 -0
- package/src/StateLabel.tsx +112 -0
- package/src/StyledOcticon.tsx +22 -0
- package/src/SubNav.tsx +124 -0
- package/src/TabNav.tsx +73 -0
- package/src/Text.tsx +13 -0
- package/src/TextInput.tsx +68 -0
- package/src/TextInputWithTokens.tsx +351 -0
- package/src/ThemeProvider.tsx +176 -0
- package/src/Timeline.tsx +140 -0
- package/src/Token/AvatarToken.tsx +54 -0
- package/src/Token/IssueLabelToken.tsx +150 -0
- package/src/Token/Token.tsx +126 -0
- package/src/Token/TokenBase.tsx +129 -0
- package/src/Token/_RemoveTokenButton.tsx +111 -0
- package/src/Token/_TokenTextContainer.tsx +47 -0
- package/src/Token/index.ts +3 -0
- package/src/Tooltip.tsx +263 -0
- package/src/Truncate.tsx +31 -0
- package/src/UnderlineNav.tsx +107 -0
- package/src/_TextInputWrapper.tsx +113 -0
- package/src/_UnstyledTextInput.tsx +19 -0
- package/src/__tests__/.eslintrc.json +11 -0
- package/src/__tests__/ActionList.test.tsx +53 -0
- package/src/__tests__/ActionList.types.test.tsx +51 -0
- package/src/__tests__/ActionList2.test.tsx +47 -0
- package/src/__tests__/ActionMenu.test.tsx +136 -0
- package/src/__tests__/AnchoredOverlay.test.tsx +150 -0
- package/src/__tests__/Autocomplete.test.tsx +444 -0
- package/src/__tests__/Avatar.test.tsx +44 -0
- package/src/__tests__/AvatarStack.test.tsx +48 -0
- package/src/__tests__/BorderBox.test.tsx +43 -0
- package/src/__tests__/Box.test.tsx +42 -0
- package/src/__tests__/BranchName.test.tsx +26 -0
- package/src/__tests__/Breadcrumbs.test.tsx +27 -0
- package/src/__tests__/Breadcrumbs.types.test.tsx +22 -0
- package/src/__tests__/BreadcrumbsItem.test.tsx +31 -0
- package/src/__tests__/Button.test.tsx +128 -0
- package/src/__tests__/Caret.test.tsx +36 -0
- package/src/__tests__/CircleBadge.test.tsx +66 -0
- package/src/__tests__/CircleBadge.types.test.tsx +11 -0
- package/src/__tests__/CircleOcticon.test.tsx +50 -0
- package/src/__tests__/ConfirmationDialog.test.tsx +120 -0
- package/src/__tests__/CounterLabel.test.tsx +50 -0
- package/src/__tests__/CounterLabel.types.test.tsx +11 -0
- package/src/__tests__/Details.test.tsx +115 -0
- package/src/__tests__/Dialog.test.tsx +155 -0
- package/src/__tests__/Dialog.types.test.tsx +11 -0
- package/src/__tests__/Dialog2.types.test.tsx +11 -0
- package/src/__tests__/Dropdown.test.tsx +53 -0
- package/src/__tests__/Dropdown.types.test.tsx +21 -0
- package/src/__tests__/DropdownMenu.test.tsx +136 -0
- package/src/__tests__/FilterList.test.tsx +26 -0
- package/src/__tests__/FilterList.types.test.tsx +17 -0
- package/src/__tests__/FilterListItem.test.tsx +31 -0
- package/src/__tests__/FilteredSearch.test.tsx +26 -0
- package/src/__tests__/FilteredSearch.types.test.tsx +11 -0
- package/src/__tests__/Flash.test.tsx +45 -0
- package/src/__tests__/Flash.types.test.tsx +11 -0
- package/src/__tests__/Flex.test.tsx +58 -0
- package/src/__tests__/FormGroup.test.tsx +38 -0
- package/src/__tests__/FormGroup.types.test.tsx +11 -0
- package/src/__tests__/Grid.test.tsx +82 -0
- package/src/__tests__/Header.test.tsx +49 -0
- package/src/__tests__/Header.types.test.tsx +19 -0
- package/src/__tests__/Heading.test.tsx +91 -0
- package/src/__tests__/KeyPaths.types.test.ts +14 -0
- package/src/__tests__/Label.test.tsx +34 -0
- package/src/__tests__/Label.types.test.tsx +11 -0
- package/src/__tests__/LabelGroup.test.tsx +30 -0
- package/src/__tests__/LabelGroup.types.test.tsx +11 -0
- package/src/__tests__/Link.test.tsx +47 -0
- package/src/__tests__/Link.types.test.tsx +11 -0
- package/src/__tests__/Merge.types.test.ts +39 -0
- package/src/__tests__/NewButton.test.tsx +70 -0
- package/src/__tests__/Overlay.test.tsx +103 -0
- package/src/__tests__/Overlay.types.test.tsx +33 -0
- package/src/__tests__/Pagehead.test.tsx +23 -0
- package/src/__tests__/Pagehead.types.test.tsx +11 -0
- package/src/__tests__/Pagination/Pagination.test.tsx +30 -0
- package/src/__tests__/Pagination/PaginationModel.test.tsx +133 -0
- package/src/__tests__/Pagination/__snapshots__/Pagination.test.tsx.snap +184 -0
- package/src/__tests__/Pagination.types.test.tsx +11 -0
- package/src/__tests__/PointerBox.test.tsx +34 -0
- package/src/__tests__/Popover.test.tsx +68 -0
- package/src/__tests__/Popover.types.test.tsx +17 -0
- package/src/__tests__/Portal.test.tsx +103 -0
- package/src/__tests__/Position.test.tsx +117 -0
- package/src/__tests__/ProgressBar.test.tsx +40 -0
- package/src/__tests__/SelectMenu.test.tsx +142 -0
- package/src/__tests__/SelectMenu.types.test.tsx +37 -0
- package/src/__tests__/SelectPanel.test.tsx +63 -0
- package/src/__tests__/SelectPanel.types.test.tsx +31 -0
- package/src/__tests__/SideNav.test.tsx +62 -0
- package/src/__tests__/SideNav.types.test.tsx +11 -0
- package/src/__tests__/Spinner.test.tsx +42 -0
- package/src/__tests__/StateLabel.test.tsx +48 -0
- package/src/__tests__/StateLabel.types.test.tsx +11 -0
- package/src/__tests__/StyledOcticon.test.tsx +26 -0
- package/src/__tests__/StyledOcticon.types.test.tsx +12 -0
- package/src/__tests__/SubNav.test.tsx +50 -0
- package/src/__tests__/SubNav.types.test.tsx +25 -0
- package/src/__tests__/SubNavLink.test.tsx +31 -0
- package/src/__tests__/TabNav.test.tsx +32 -0
- package/src/__tests__/TabNav.types.test.tsx +22 -0
- package/src/__tests__/Text.test.tsx +78 -0
- package/src/__tests__/TextInput.test.tsx +49 -0
- package/src/__tests__/TextInputWithTokens.test.tsx +422 -0
- package/src/__tests__/ThemeProvider.test.tsx +441 -0
- package/src/__tests__/Timeline.test.tsx +58 -0
- package/src/__tests__/Timeline.types.test.tsx +31 -0
- package/src/__tests__/Token.test.tsx +118 -0
- package/src/__tests__/Tooltip.test.tsx +52 -0
- package/src/__tests__/Tooltip.types.test.tsx +11 -0
- package/src/__tests__/Truncate.test.tsx +43 -0
- package/src/__tests__/Truncate.types.test.tsx +11 -0
- package/src/__tests__/UnderlineNav.test.tsx +58 -0
- package/src/__tests__/UnderlineNav.types.test.tsx +22 -0
- package/src/__tests__/UnderlineNavLink.test.tsx +31 -0
- package/src/__tests__/__snapshots__/ActionList.test.tsx.snap +223 -0
- package/src/__tests__/__snapshots__/ActionList2.test.tsx.snap +14 -0
- package/src/__tests__/__snapshots__/ActionMenu.test.tsx.snap +80 -0
- package/src/__tests__/__snapshots__/AnchoredOverlay.test.tsx.snap +232 -0
- package/src/__tests__/__snapshots__/Autocomplete.test.tsx.snap +3888 -0
- package/src/__tests__/__snapshots__/Avatar.test.tsx.snap +19 -0
- package/src/__tests__/__snapshots__/AvatarStack.test.tsx.snap +377 -0
- package/src/__tests__/__snapshots__/BorderBox.test.tsx.snap +14 -0
- package/src/__tests__/__snapshots__/Box.test.tsx.snap +201 -0
- package/src/__tests__/__snapshots__/BranchName.test.tsx.snap +17 -0
- package/src/__tests__/__snapshots__/Breadcrumbs.test.tsx.snap +29 -0
- package/src/__tests__/__snapshots__/BreadcrumbsItem.test.tsx.snap +79 -0
- package/src/__tests__/__snapshots__/Button.test.tsx.snap +840 -0
- package/src/__tests__/__snapshots__/Caret.test.tsx.snap +373 -0
- package/src/__tests__/__snapshots__/CircleBadge.test.tsx.snap +142 -0
- package/src/__tests__/__snapshots__/CircleOcticon.test.tsx.snap +65 -0
- package/src/__tests__/__snapshots__/ConfirmationDialog.test.tsx.snap +89 -0
- package/src/__tests__/__snapshots__/CounterLabel.test.tsx.snap +22 -0
- package/src/__tests__/__snapshots__/Details.test.tsx.snap +15 -0
- package/src/__tests__/__snapshots__/Dialog.test.tsx.snap +201 -0
- package/src/__tests__/__snapshots__/Dropdown.test.tsx.snap +249 -0
- package/src/__tests__/__snapshots__/DropdownMenu.test.tsx.snap +107 -0
- package/src/__tests__/__snapshots__/FilterList.test.tsx.snap +13 -0
- package/src/__tests__/__snapshots__/FilterListItem.test.tsx.snap +80 -0
- package/src/__tests__/__snapshots__/FilteredSearch.test.tsx.snap +32 -0
- package/src/__tests__/__snapshots__/Flash.test.tsx.snap +32 -0
- package/src/__tests__/__snapshots__/Flex.test.tsx.snap +130 -0
- package/src/__tests__/__snapshots__/FormGroup.test.tsx.snap +25 -0
- package/src/__tests__/__snapshots__/Grid.test.tsx.snap +178 -0
- package/src/__tests__/__snapshots__/Header.test.tsx.snap +79 -0
- package/src/__tests__/__snapshots__/Heading.test.tsx.snap +13 -0
- package/src/__tests__/__snapshots__/Label.test.tsx.snap +73 -0
- package/src/__tests__/__snapshots__/LabelGroup.test.tsx.snap +15 -0
- package/src/__tests__/__snapshots__/Link.test.tsx.snap +212 -0
- package/src/__tests__/__snapshots__/NewButton.test.tsx.snap +305 -0
- package/src/__tests__/__snapshots__/Pagehead.test.tsx.snap +15 -0
- package/src/__tests__/__snapshots__/PointerBox.test.tsx.snap +174 -0
- package/src/__tests__/__snapshots__/Popover.test.tsx.snap +4687 -0
- package/src/__tests__/__snapshots__/Position.test.tsx.snap +44 -0
- package/src/__tests__/__snapshots__/ProgressBar.test.tsx.snap +53 -0
- package/src/__tests__/__snapshots__/SelectMenu.test.tsx.snap +473 -0
- package/src/__tests__/__snapshots__/SelectPanel.test.tsx.snap +124 -0
- package/src/__tests__/__snapshots__/SideNav.test.tsx.snap +143 -0
- package/src/__tests__/__snapshots__/Spinner.test.tsx.snap +33 -0
- package/src/__tests__/__snapshots__/StateLabel.test.tsx.snap +395 -0
- package/src/__tests__/__snapshots__/StyledOcticon.test.tsx.snap +26 -0
- package/src/__tests__/__snapshots__/SubNav.test.tsx.snap +44 -0
- package/src/__tests__/__snapshots__/SubNavLink.test.tsx.snap +199 -0
- package/src/__tests__/__snapshots__/TabNav.test.tsx.snap +58 -0
- package/src/__tests__/__snapshots__/Text.test.tsx.snap +7 -0
- package/src/__tests__/__snapshots__/TextInput.test.tsx.snap +446 -0
- package/src/__tests__/__snapshots__/TextInputWithTokens.test.tsx.snap +6045 -0
- package/src/__tests__/__snapshots__/ThemeProvider.test.tsx.snap +15 -0
- package/src/__tests__/__snapshots__/Timeline.test.tsx.snap +159 -0
- package/src/__tests__/__snapshots__/Token.test.tsx.snap +3811 -0
- package/src/__tests__/__snapshots__/Tooltip.test.tsx.snap +227 -0
- package/src/__tests__/__snapshots__/Truncate.test.tsx.snap +17 -0
- package/src/__tests__/__snapshots__/UnderlineNav.test.tsx.snap +59 -0
- package/src/__tests__/__snapshots__/UnderlineNavLink.test.tsx.snap +130 -0
- package/src/__tests__/behaviors/anchoredPosition.test.ts +295 -0
- package/src/__tests__/behaviors/focusTrap.test.tsx +236 -0
- package/src/__tests__/behaviors/focusZone.test.tsx +549 -0
- package/src/__tests__/behaviors/iterateFocusableElements.test.tsx +61 -0
- package/src/__tests__/behaviors/scrollIntoViewingArea.test.ts +195 -0
- package/src/__tests__/filterObject.test.ts +54 -0
- package/src/__tests__/hooks/useAnchoredPosition.test.tsx +31 -0
- package/src/__tests__/hooks/useOnEscapePress.test.tsx +16 -0
- package/src/__tests__/hooks/useOnOutsideClick.test.tsx +48 -0
- package/src/__tests__/hooks/useOpenAndCloseFocus.test.tsx +48 -0
- package/src/__tests__/hooks/useProvidedStateOrCreate.test.tsx +39 -0
- package/src/__tests__/theme.test.ts +41 -0
- package/src/__tests__/themeGet.test.ts +15 -0
- package/src/__tests__/useSafeTimeout.test.tsx +36 -0
- package/src/__tests__/utils/__snapshots__/createSlots.test.tsx.snap +55 -0
- package/src/__tests__/utils/createSlots.test.tsx +74 -0
- package/src/behaviors/anchoredPosition.ts +442 -0
- package/src/behaviors/focusTrap.ts +184 -0
- package/src/behaviors/focusZone.ts +713 -0
- package/src/behaviors/scrollIntoViewingArea.ts +27 -0
- package/src/constants.ts +62 -0
- package/src/drafts.ts +10 -0
- package/src/hooks/index.ts +11 -0
- package/src/hooks/useAnchoredPosition.ts +54 -0
- package/src/hooks/useCombinedRefs.ts +40 -0
- package/src/hooks/useDetails.tsx +54 -0
- package/src/hooks/useDialog.ts +121 -0
- package/src/hooks/useFocusTrap.ts +80 -0
- package/src/hooks/useFocusZone.ts +64 -0
- package/src/hooks/useOnEscapePress.ts +63 -0
- package/src/hooks/useOnOutsideClick.tsx +82 -0
- package/src/hooks/useOpenAndCloseFocus.ts +32 -0
- package/src/hooks/useOverlay.tsx +34 -0
- package/src/hooks/useProvidedRefOrCreate.ts +14 -0
- package/src/hooks/useProvidedStateOrCreate.ts +27 -0
- package/src/hooks/useRenderForcingRef.ts +22 -0
- package/src/hooks/useResizeObserver.ts +11 -0
- package/src/hooks/useSafeTimeout.ts +38 -0
- package/src/hooks/useScrollFlash.ts +21 -0
- package/src/index.ts +172 -0
- package/src/polyfills/eventListenerSignal.ts +66 -0
- package/src/stories/ActionList.stories.tsx +436 -0
- package/src/stories/ActionList2.stories.tsx +1291 -0
- package/src/stories/ActionMenu.stories.tsx +331 -0
- package/src/stories/AnchoredOverlay.stories.tsx +117 -0
- package/src/stories/Autocomplete.stories.tsx +655 -0
- package/src/stories/AvatarStack.stories.tsx +37 -0
- package/src/stories/Button.stories.tsx +92 -0
- package/src/stories/ConfirmationDialog.stories.tsx +105 -0
- package/src/stories/Dialog.stories.tsx +240 -0
- package/src/stories/DropdownMenu.stories.tsx +84 -0
- package/src/stories/IssueLabelToken.stories.tsx +138 -0
- package/src/stories/NewButton.stories.tsx +201 -0
- package/src/stories/Overlay.stories.tsx +213 -0
- package/src/stories/Portal.stories.tsx +109 -0
- package/src/stories/ProfileToken.stories.tsx +129 -0
- package/src/stories/SelectPanel.stories.tsx +353 -0
- package/src/stories/TextInput.stories.tsx +113 -0
- package/src/stories/TextInputWithTokens.stories.tsx +155 -0
- package/src/stories/ThemeProvider.stories.tsx +104 -0
- package/src/stories/Token.stories.tsx +137 -0
- package/src/stories/useAnchoredPosition.stories.tsx +332 -0
- package/src/stories/useFocusTrap.stories.tsx +400 -0
- package/src/stories/useFocusZone.stories.tsx +663 -0
- package/src/sx.ts +24 -0
- package/src/theme-preval.js +80 -0
- package/src/theme.ts +89 -0
- package/src/utils/create-slots.tsx +96 -0
- package/src/utils/deprecate.tsx +73 -0
- package/src/utils/isNumeric.tsx +4 -0
- package/src/utils/iterateFocusableElements.ts +121 -0
- package/src/utils/ssr.tsx +1 -0
- package/src/utils/test-deprecations.tsx +19 -0
- package/src/utils/test-helpers.tsx +7 -0
- package/src/utils/test-matchers.tsx +109 -0
- package/src/utils/testing.tsx +242 -0
- package/src/utils/theme.js +64 -0
- package/src/utils/types/AriaRole.ts +71 -0
- package/src/utils/types/ComponentProps.ts +13 -0
- package/src/utils/types/Flatten.ts +4 -0
- package/src/utils/types/KeyPaths.ts +10 -0
- package/src/utils/types/MandateProps.ts +19 -0
- package/src/utils/types/Merge.ts +20 -0
- package/src/utils/types/index.ts +5 -0
- package/src/utils/uniqueId.ts +6 -0
- package/src/utils/use-force-update.ts +7 -0
- package/src/utils/useIsomorphicLayoutEffect.ts +10 -0
- package/src/utils/userAgent.ts +7 -0
- package/stats.html +3279 -0
- package/tsconfig.build.json +7 -0
- package/tsconfig.json +20 -0
@@ -0,0 +1,713 @@
|
|
1
|
+
import {iterateFocusableElements} from '../utils/iterateFocusableElements'
|
2
|
+
import {polyfill as eventListenerSignalPolyfill} from '../polyfills/eventListenerSignal'
|
3
|
+
import {isMacOS} from '../utils/userAgent'
|
4
|
+
import {uniqueId} from '../utils/uniqueId'
|
5
|
+
|
6
|
+
eventListenerSignalPolyfill()
|
7
|
+
|
8
|
+
export type Direction = 'previous' | 'next' | 'start' | 'end'
|
9
|
+
|
10
|
+
export type FocusMovementKeys =
|
11
|
+
| 'ArrowLeft'
|
12
|
+
| 'ArrowDown'
|
13
|
+
| 'ArrowUp'
|
14
|
+
| 'ArrowRight'
|
15
|
+
| 'h'
|
16
|
+
| 'j'
|
17
|
+
| 'k'
|
18
|
+
| 'l'
|
19
|
+
| 'a'
|
20
|
+
| 's'
|
21
|
+
| 'w'
|
22
|
+
| 'd'
|
23
|
+
| 'Tab'
|
24
|
+
| 'Home'
|
25
|
+
| 'End'
|
26
|
+
| 'PageUp'
|
27
|
+
| 'PageDown'
|
28
|
+
|
29
|
+
// eslint-disable-next-line no-shadow
|
30
|
+
export enum FocusKeys {
|
31
|
+
// Left and right arrow keys (previous and next, respectively)
|
32
|
+
ArrowHorizontal = 0b000000001,
|
33
|
+
|
34
|
+
// Up and down arrow keys (previous and next, respectively)
|
35
|
+
ArrowVertical = 0b000000010,
|
36
|
+
|
37
|
+
// The "J" and "K" keys (next and previous, respectively)
|
38
|
+
JK = 0b000000100,
|
39
|
+
|
40
|
+
// The "H" and "L" keys (previous and next, respectively)
|
41
|
+
HL = 0b000001000,
|
42
|
+
|
43
|
+
// The Home and End keys (previous and next, respectively, to end)
|
44
|
+
HomeAndEnd = 0b000010000,
|
45
|
+
|
46
|
+
// The PgUp and PgDn keys (previous and next, respectively, to end)
|
47
|
+
PageUpDown = 0b100000000,
|
48
|
+
|
49
|
+
// The "W" and "S" keys (previous and next, respectively)
|
50
|
+
WS = 0b000100000,
|
51
|
+
|
52
|
+
// The "A" and "D" keys (previous and next, respectively)
|
53
|
+
AD = 0b001000000,
|
54
|
+
|
55
|
+
// The Tab key (next)
|
56
|
+
Tab = 0b010000000,
|
57
|
+
|
58
|
+
ArrowAll = FocusKeys.ArrowHorizontal | FocusKeys.ArrowVertical,
|
59
|
+
HJKL = FocusKeys.HL | FocusKeys.JK,
|
60
|
+
WASD = FocusKeys.WS | FocusKeys.AD,
|
61
|
+
All = FocusKeys.ArrowAll |
|
62
|
+
FocusKeys.HJKL |
|
63
|
+
FocusKeys.HomeAndEnd |
|
64
|
+
FocusKeys.PageUpDown |
|
65
|
+
FocusKeys.WASD |
|
66
|
+
FocusKeys.Tab
|
67
|
+
}
|
68
|
+
|
69
|
+
const KEY_TO_BIT = {
|
70
|
+
ArrowLeft: FocusKeys.ArrowHorizontal,
|
71
|
+
ArrowDown: FocusKeys.ArrowVertical,
|
72
|
+
ArrowUp: FocusKeys.ArrowVertical,
|
73
|
+
ArrowRight: FocusKeys.ArrowHorizontal,
|
74
|
+
h: FocusKeys.HL,
|
75
|
+
j: FocusKeys.JK,
|
76
|
+
k: FocusKeys.JK,
|
77
|
+
l: FocusKeys.HL,
|
78
|
+
a: FocusKeys.AD,
|
79
|
+
s: FocusKeys.WS,
|
80
|
+
w: FocusKeys.WS,
|
81
|
+
d: FocusKeys.AD,
|
82
|
+
Tab: FocusKeys.Tab,
|
83
|
+
Home: FocusKeys.HomeAndEnd,
|
84
|
+
End: FocusKeys.HomeAndEnd,
|
85
|
+
PageUp: FocusKeys.PageUpDown,
|
86
|
+
PageDown: FocusKeys.PageUpDown
|
87
|
+
} as {[k in FocusMovementKeys]: FocusKeys}
|
88
|
+
|
89
|
+
const KEY_TO_DIRECTION = {
|
90
|
+
ArrowLeft: 'previous',
|
91
|
+
ArrowDown: 'next',
|
92
|
+
ArrowUp: 'previous',
|
93
|
+
ArrowRight: 'next',
|
94
|
+
h: 'previous',
|
95
|
+
j: 'next',
|
96
|
+
k: 'previous',
|
97
|
+
l: 'next',
|
98
|
+
a: 'previous',
|
99
|
+
s: 'next',
|
100
|
+
w: 'previous',
|
101
|
+
d: 'next',
|
102
|
+
Tab: 'next',
|
103
|
+
Home: 'start',
|
104
|
+
End: 'end',
|
105
|
+
PageUp: 'start',
|
106
|
+
PageDown: 'end'
|
107
|
+
} as {[k in FocusMovementKeys]: Direction}
|
108
|
+
|
109
|
+
/**
|
110
|
+
* Options that control the behavior of the arrow focus behavior.
|
111
|
+
*/
|
112
|
+
export interface FocusZoneSettings {
|
113
|
+
/**
|
114
|
+
* Choose the behavior applied in cases where focus is currently at either the first or
|
115
|
+
* last element of the container.
|
116
|
+
*
|
117
|
+
* "stop" - do nothing and keep focus where it was
|
118
|
+
* "wrap" - wrap focus around to the first element from the last, or the last element from the first
|
119
|
+
*
|
120
|
+
* Default: "stop"
|
121
|
+
*/
|
122
|
+
focusOutBehavior?: 'stop' | 'wrap'
|
123
|
+
|
124
|
+
/**
|
125
|
+
* If set, this will be called to get the next focusable element. If this function
|
126
|
+
* returns null, we will try to determine the next direction ourselves. Use the
|
127
|
+
* `bindKeys` option to customize which keys are listened to.
|
128
|
+
*
|
129
|
+
* The function can accept a Direction, indicating the direction focus should move,
|
130
|
+
* the HTMLElement that was previously focused, and lastly the `KeyboardEvent` object
|
131
|
+
* created by the original `"keydown"` event.
|
132
|
+
*/
|
133
|
+
getNextFocusable?: (direction: Direction, from: Element | undefined, event: KeyboardEvent) => HTMLElement | undefined
|
134
|
+
|
135
|
+
/**
|
136
|
+
* Called to decide if a focusable element is allowed to participate in the arrow
|
137
|
+
* key focus behavior.
|
138
|
+
*
|
139
|
+
* By default, all focusable elements within the given container will participate
|
140
|
+
* in the arrow key focus behavior. If you need to withhold some elements from
|
141
|
+
* participation, implement this callback to return false for those elements.
|
142
|
+
*/
|
143
|
+
focusableElementFilter?: (element: HTMLElement) => boolean
|
144
|
+
|
145
|
+
/**
|
146
|
+
* Bit flags that identify keys that will be bound to. Each available key either
|
147
|
+
* moves focus to the "next" element or the "previous" element, so it is best
|
148
|
+
* to only bind the keys that make sense to move focus in your UI. Use the `FocusKeys`
|
149
|
+
* object to discover supported keys.
|
150
|
+
*
|
151
|
+
* Use the bitwise "OR" operator (`|`) to combine key types. For example,
|
152
|
+
* `FocusKeys.WASD | FocusKeys.HJKL` represents all of W, A, S, D, H, J, K, and L.
|
153
|
+
*
|
154
|
+
* A note on FocusKeys.PageUpDown: This behavior does not support paging, so by default
|
155
|
+
* using these keys will result in the same behavior as Home and End. To override this
|
156
|
+
* behavior, implement `getNextFocusable`.
|
157
|
+
*
|
158
|
+
* The default for this setting is `FocusKeys.ArrowVertical | FocusKeys.HomeAndEnd`, unless
|
159
|
+
* `getNextFocusable` is provided, in which case `FocusKeys.ArrowAll | FocusKeys.HomeAndEnd`
|
160
|
+
* is used as the default.
|
161
|
+
*/
|
162
|
+
bindKeys?: FocusKeys
|
163
|
+
|
164
|
+
/**
|
165
|
+
* If provided, this signal can be used to disable the behavior and remove any
|
166
|
+
* event listeners.
|
167
|
+
*/
|
168
|
+
abortSignal?: AbortSignal
|
169
|
+
|
170
|
+
/**
|
171
|
+
* If `activeDescendantControl` is supplied, do not move focus or alter `tabindex` on
|
172
|
+
* any element. Instead, manage `aria-activedescendant` according to the ARIA best
|
173
|
+
* practices guidelines.
|
174
|
+
* @see https://www.w3.org/TR/wai-aria-practices-1.1/#kbd_focus_activedescendant
|
175
|
+
*
|
176
|
+
* The given `activeDescendantControl` will be given an `aria-controls` attribute that
|
177
|
+
* references the ID of the `container`. Additionally, it will be given an
|
178
|
+
* `aria-activedescendant` attribute that references the ID of the currently-active
|
179
|
+
* descendant.
|
180
|
+
*
|
181
|
+
* This element will retain DOM focus as arrow keys are pressed.
|
182
|
+
*/
|
183
|
+
activeDescendantControl?: HTMLElement
|
184
|
+
|
185
|
+
/**
|
186
|
+
* Called each time the active descendant changes. Note that either of the parameters
|
187
|
+
* may be undefined, e.g. when an element in the container first becomes active, or
|
188
|
+
* when the controlling element becomes unfocused.
|
189
|
+
*/
|
190
|
+
onActiveDescendantChanged?: (
|
191
|
+
newActiveDescendant: HTMLElement | undefined,
|
192
|
+
previousActiveDescendant: HTMLElement | undefined,
|
193
|
+
directlyActivated: boolean
|
194
|
+
) => void
|
195
|
+
|
196
|
+
/**
|
197
|
+
* This option allows customization of the behavior that determines which of the
|
198
|
+
* focusable elements should be focused when focus enters the container via the Tab key.
|
199
|
+
*
|
200
|
+
* When set to "first", whenever focus enters the container via Tab, we will focus the
|
201
|
+
* first focusable element. When set to "previous", the most recently focused element
|
202
|
+
* will be focused (fallback to first if there was no previous).
|
203
|
+
*
|
204
|
+
* The "closest" strategy works like "first", except either the first or the last element
|
205
|
+
* of the container will be focused, depending on the direction from which focus comes.
|
206
|
+
*
|
207
|
+
* If a function is provided, this function should return the HTMLElement intended
|
208
|
+
* to receive focus. This is useful if you want to focus the currently "selected"
|
209
|
+
* item or element.
|
210
|
+
*
|
211
|
+
* Default: "previous"
|
212
|
+
*
|
213
|
+
* For more information, @see https://www.w3.org/TR/wai-aria-practices-1.1/#kbd_general_within
|
214
|
+
*/
|
215
|
+
focusInStrategy?: 'first' | 'closest' | 'previous' | ((previousFocusedElement: Element) => HTMLElement | undefined)
|
216
|
+
}
|
217
|
+
|
218
|
+
function getDirection(keyboardEvent: KeyboardEvent) {
|
219
|
+
const direction = KEY_TO_DIRECTION[keyboardEvent.key as keyof typeof KEY_TO_DIRECTION]
|
220
|
+
if (keyboardEvent.key === 'Tab' && keyboardEvent.shiftKey) {
|
221
|
+
return 'previous'
|
222
|
+
}
|
223
|
+
const isMac = isMacOS()
|
224
|
+
if ((isMac && keyboardEvent.metaKey) || (!isMac && keyboardEvent.ctrlKey)) {
|
225
|
+
if (keyboardEvent.key === 'ArrowLeft' || keyboardEvent.key === 'ArrowUp') {
|
226
|
+
return 'start'
|
227
|
+
} else if (keyboardEvent.key === 'ArrowRight' || keyboardEvent.key === 'ArrowDown') {
|
228
|
+
return 'end'
|
229
|
+
}
|
230
|
+
}
|
231
|
+
return direction
|
232
|
+
}
|
233
|
+
|
234
|
+
/**
|
235
|
+
* There are some situations where we do not want various keys to affect focus. This function
|
236
|
+
* checks for those situations.
|
237
|
+
* 1. Home and End should not move focus when a text input or textarea is active
|
238
|
+
* 2. Keys that would normally type characters into an input or navigate a select element should be ignored
|
239
|
+
* 3. The down arrow sometimes should not move focus when a select is active since that sometimes invokes the dropdown
|
240
|
+
* 4. Page Up and Page Down within a textarea should not have any effect
|
241
|
+
* 5. When in a text input or textarea, left should only move focus if the cursor is at the beginning of the input
|
242
|
+
* 6. When in a text input or textarea, right should only move focus if the cursor is at the end of the input
|
243
|
+
* 7. When in a textarea, up and down should only move focus if cursor is at the beginning or end, respectively.
|
244
|
+
* @param keyboardEvent
|
245
|
+
* @param activeElement
|
246
|
+
*/
|
247
|
+
function shouldIgnoreFocusHandling(keyboardEvent: KeyboardEvent, activeElement: Element | null) {
|
248
|
+
const key = keyboardEvent.key
|
249
|
+
|
250
|
+
// Get the number of characters in `key`, accounting for double-wide UTF-16 chars. If keyLength
|
251
|
+
// is 1, we can assume it's a "printable" character. Otherwise it's likely a control character.
|
252
|
+
// One exception is the Tab key, which is technically printable, but browsers generally assign
|
253
|
+
// its function to move focus rather than type a <TAB> character.
|
254
|
+
const keyLength = [...key].length
|
255
|
+
|
256
|
+
const isTextInput =
|
257
|
+
(activeElement instanceof HTMLInputElement && activeElement.type === 'text') ||
|
258
|
+
activeElement instanceof HTMLTextAreaElement
|
259
|
+
|
260
|
+
// If we would normally type a character into an input, ignore
|
261
|
+
// Also, Home and End keys should never affect focus when in a text input
|
262
|
+
if (isTextInput && (keyLength === 1 || key === 'Home' || key === 'End')) {
|
263
|
+
return true
|
264
|
+
}
|
265
|
+
|
266
|
+
// Some situations we want to ignore with <select> elements
|
267
|
+
if (activeElement instanceof HTMLSelectElement) {
|
268
|
+
// Regular typeable characters change the selection, so ignore those
|
269
|
+
if (keyLength === 1) {
|
270
|
+
return true
|
271
|
+
}
|
272
|
+
// On macOS, bare ArrowDown opens the select, so ignore that
|
273
|
+
if (key === 'ArrowDown' && isMacOS() && !keyboardEvent.metaKey) {
|
274
|
+
return true
|
275
|
+
}
|
276
|
+
// On other platforms, Alt+ArrowDown opens the select, so ignore that
|
277
|
+
if (key === 'ArrowDown' && !isMacOS() && keyboardEvent.altKey) {
|
278
|
+
return true
|
279
|
+
}
|
280
|
+
}
|
281
|
+
|
282
|
+
// Ignore page up and page down for textareas
|
283
|
+
if (activeElement instanceof HTMLTextAreaElement && (key === 'PageUp' || key === 'PageDown')) {
|
284
|
+
return true
|
285
|
+
}
|
286
|
+
|
287
|
+
if (isTextInput) {
|
288
|
+
const textInput = activeElement as HTMLInputElement | HTMLTextAreaElement
|
289
|
+
const cursorAtStart = textInput.selectionStart === 0 && textInput.selectionEnd === 0
|
290
|
+
const cursorAtEnd =
|
291
|
+
textInput.selectionStart === textInput.value.length && textInput.selectionEnd === textInput.value.length
|
292
|
+
|
293
|
+
// When in a text area or text input, only move focus left/right if at beginning/end of the field
|
294
|
+
if (key === 'ArrowLeft' && !cursorAtStart) {
|
295
|
+
return true
|
296
|
+
}
|
297
|
+
if (key === 'ArrowRight' && !cursorAtEnd) {
|
298
|
+
return true
|
299
|
+
}
|
300
|
+
|
301
|
+
// When in a text area, only move focus up/down if at beginning/end of the field
|
302
|
+
if (textInput instanceof HTMLTextAreaElement) {
|
303
|
+
if (key === 'ArrowUp' && !cursorAtStart) {
|
304
|
+
return true
|
305
|
+
}
|
306
|
+
if (key === 'ArrowDown' && !cursorAtEnd) {
|
307
|
+
return true
|
308
|
+
}
|
309
|
+
}
|
310
|
+
}
|
311
|
+
|
312
|
+
return false
|
313
|
+
}
|
314
|
+
|
315
|
+
export const isActiveDescendantAttribute = 'data-is-active-descendant'
|
316
|
+
/**
|
317
|
+
* A value of activated-directly for data-is-active-descendant indicates the descendant was activated
|
318
|
+
* by a manual user interaction with intent to move active descendant. This usually translates to the
|
319
|
+
* user pressing one of the bound keys (up/down arrow, etc) to move through the focus zone. This is
|
320
|
+
* intended to be roughly equivalent to the :focus-visible pseudo-class
|
321
|
+
**/
|
322
|
+
export const activeDescendantActivatedDirectly = 'activated-directly'
|
323
|
+
/**
|
324
|
+
* A value of activated-indirectly for data-is-active-descendant indicates the descendant was activated
|
325
|
+
* implicitly, and not by a direct key press. This includes focus zone being created from scratch, focusable
|
326
|
+
* elements being added/removed, and mouseover events. This is intended to be roughly equivalent
|
327
|
+
* to :focus:not(:focus-visible)
|
328
|
+
**/
|
329
|
+
export const activeDescendantActivatedIndirectly = 'activated-indirectly'
|
330
|
+
export const hasActiveDescendantAttribute = 'data-has-active-descendant'
|
331
|
+
|
332
|
+
/**
|
333
|
+
* Sets up the arrow key focus behavior for all focusable elements in the given `container`.
|
334
|
+
* @param container
|
335
|
+
* @param settings
|
336
|
+
* @returns
|
337
|
+
*/
|
338
|
+
export function focusZone(container: HTMLElement, settings?: FocusZoneSettings): AbortController {
|
339
|
+
const focusableElements: HTMLElement[] = []
|
340
|
+
const savedTabIndex = new WeakMap<HTMLElement, string | null>()
|
341
|
+
const bindKeys =
|
342
|
+
settings?.bindKeys ??
|
343
|
+
(settings?.getNextFocusable ? FocusKeys.ArrowAll : FocusKeys.ArrowVertical) | FocusKeys.HomeAndEnd
|
344
|
+
const focusOutBehavior = settings?.focusOutBehavior ?? 'stop'
|
345
|
+
const focusInStrategy = settings?.focusInStrategy ?? 'previous'
|
346
|
+
const activeDescendantControl = settings?.activeDescendantControl
|
347
|
+
const activeDescendantCallback = settings?.onActiveDescendantChanged
|
348
|
+
let currentFocusedElement: HTMLElement | undefined
|
349
|
+
|
350
|
+
function getFirstFocusableElement() {
|
351
|
+
return focusableElements[0] as HTMLElement | undefined
|
352
|
+
}
|
353
|
+
|
354
|
+
function isActiveDescendantInputFocused() {
|
355
|
+
return document.activeElement === activeDescendantControl
|
356
|
+
}
|
357
|
+
|
358
|
+
function updateFocusedElement(to?: HTMLElement, directlyActivated = false) {
|
359
|
+
const from = currentFocusedElement
|
360
|
+
currentFocusedElement = to
|
361
|
+
|
362
|
+
if (activeDescendantControl) {
|
363
|
+
if (to && isActiveDescendantInputFocused()) {
|
364
|
+
setActiveDescendant(from, to, directlyActivated)
|
365
|
+
} else {
|
366
|
+
clearActiveDescendant()
|
367
|
+
}
|
368
|
+
|
369
|
+
return
|
370
|
+
}
|
371
|
+
|
372
|
+
if (from && from !== to && savedTabIndex.has(from)) {
|
373
|
+
from.setAttribute('tabindex', '-1')
|
374
|
+
}
|
375
|
+
|
376
|
+
to?.setAttribute('tabindex', '0')
|
377
|
+
}
|
378
|
+
|
379
|
+
function setActiveDescendant(from: HTMLElement | undefined, to: HTMLElement, directlyActivated = false) {
|
380
|
+
if (!to.id) {
|
381
|
+
to.setAttribute('id', uniqueId())
|
382
|
+
}
|
383
|
+
|
384
|
+
if (from && from !== to) {
|
385
|
+
from.removeAttribute(isActiveDescendantAttribute)
|
386
|
+
}
|
387
|
+
|
388
|
+
if (
|
389
|
+
!activeDescendantControl ||
|
390
|
+
(!directlyActivated && activeDescendantControl.getAttribute('aria-activedescendant') === to.id)
|
391
|
+
) {
|
392
|
+
// prevent active descendant callback from being called repeatedly if the same element is activated (e.g. via mousemove)
|
393
|
+
return
|
394
|
+
}
|
395
|
+
|
396
|
+
activeDescendantControl.setAttribute('aria-activedescendant', to.id)
|
397
|
+
container.setAttribute(hasActiveDescendantAttribute, to.id)
|
398
|
+
to.setAttribute(
|
399
|
+
isActiveDescendantAttribute,
|
400
|
+
directlyActivated ? activeDescendantActivatedDirectly : activeDescendantActivatedIndirectly
|
401
|
+
)
|
402
|
+
activeDescendantCallback?.(to, from, directlyActivated)
|
403
|
+
}
|
404
|
+
|
405
|
+
function clearActiveDescendant(previouslyActiveElement = currentFocusedElement) {
|
406
|
+
if (focusInStrategy === 'first') {
|
407
|
+
currentFocusedElement = undefined
|
408
|
+
}
|
409
|
+
|
410
|
+
activeDescendantControl?.removeAttribute('aria-activedescendant')
|
411
|
+
container.removeAttribute(hasActiveDescendantAttribute)
|
412
|
+
previouslyActiveElement?.removeAttribute(isActiveDescendantAttribute)
|
413
|
+
activeDescendantCallback?.(undefined, previouslyActiveElement, false)
|
414
|
+
}
|
415
|
+
|
416
|
+
function beginFocusManagement(...elements: HTMLElement[]) {
|
417
|
+
const filteredElements = elements.filter(e => settings?.focusableElementFilter?.(e) ?? true)
|
418
|
+
if (filteredElements.length === 0) {
|
419
|
+
return
|
420
|
+
}
|
421
|
+
// Insert all elements atomically. Assume that all passed elements are well-ordered.
|
422
|
+
const insertIndex = focusableElements.findIndex(
|
423
|
+
e => (e.compareDocumentPosition(filteredElements[0]) & Node.DOCUMENT_POSITION_PRECEDING) > 0
|
424
|
+
)
|
425
|
+
focusableElements.splice(insertIndex === -1 ? focusableElements.length : insertIndex, 0, ...filteredElements)
|
426
|
+
for (const element of filteredElements) {
|
427
|
+
// Set tabindex="-1" on all tabbable elements, but save the original
|
428
|
+
// value in case we need to disable the behavior
|
429
|
+
if (!savedTabIndex.has(element)) {
|
430
|
+
savedTabIndex.set(element, element.getAttribute('tabindex'))
|
431
|
+
}
|
432
|
+
element.setAttribute('tabindex', '-1')
|
433
|
+
}
|
434
|
+
|
435
|
+
if (!currentFocusedElement) {
|
436
|
+
updateFocusedElement(getFirstFocusableElement())
|
437
|
+
}
|
438
|
+
}
|
439
|
+
|
440
|
+
function endFocusManagement(...elements: HTMLElement[]) {
|
441
|
+
for (const element of elements) {
|
442
|
+
const focusableElementIndex = focusableElements.indexOf(element)
|
443
|
+
if (focusableElementIndex >= 0) {
|
444
|
+
focusableElements.splice(focusableElementIndex, 1)
|
445
|
+
}
|
446
|
+
const savedIndex = savedTabIndex.get(element)
|
447
|
+
if (savedIndex !== undefined) {
|
448
|
+
if (savedIndex === null) {
|
449
|
+
element.removeAttribute('tabindex')
|
450
|
+
} else {
|
451
|
+
element.setAttribute('tabindex', savedIndex)
|
452
|
+
}
|
453
|
+
savedTabIndex.delete(element)
|
454
|
+
}
|
455
|
+
|
456
|
+
// If removing the last-focused element, move focus to the first element in the list.
|
457
|
+
if (element === currentFocusedElement) {
|
458
|
+
const nextElementToFocus = getFirstFocusableElement()
|
459
|
+
updateFocusedElement(nextElementToFocus)
|
460
|
+
}
|
461
|
+
}
|
462
|
+
}
|
463
|
+
|
464
|
+
// Take all tabbable elements within container under management
|
465
|
+
beginFocusManagement(...iterateFocusableElements(container))
|
466
|
+
|
467
|
+
// Open the first tabbable element for tabbing
|
468
|
+
updateFocusedElement(getFirstFocusableElement())
|
469
|
+
|
470
|
+
// If the DOM structure of the container changes, make sure we keep our state up-to-date
|
471
|
+
// with respect to the focusable elements cache and its order
|
472
|
+
const observer = new MutationObserver(mutations => {
|
473
|
+
// Perform all removals first, in case element order has simply changed
|
474
|
+
for (const mutation of mutations) {
|
475
|
+
for (const removedNode of mutation.removedNodes) {
|
476
|
+
if (removedNode instanceof HTMLElement) {
|
477
|
+
endFocusManagement(...iterateFocusableElements(removedNode))
|
478
|
+
}
|
479
|
+
}
|
480
|
+
}
|
481
|
+
for (const mutation of mutations) {
|
482
|
+
for (const addedNode of mutation.addedNodes) {
|
483
|
+
if (addedNode instanceof HTMLElement) {
|
484
|
+
beginFocusManagement(...iterateFocusableElements(addedNode))
|
485
|
+
}
|
486
|
+
}
|
487
|
+
}
|
488
|
+
})
|
489
|
+
|
490
|
+
observer.observe(container, {
|
491
|
+
subtree: true,
|
492
|
+
childList: true
|
493
|
+
})
|
494
|
+
|
495
|
+
const controller = new AbortController()
|
496
|
+
const signal = settings?.abortSignal ?? controller.signal
|
497
|
+
|
498
|
+
signal.addEventListener('abort', () => {
|
499
|
+
// Clean up any modifications
|
500
|
+
endFocusManagement(...focusableElements)
|
501
|
+
})
|
502
|
+
|
503
|
+
let elementIndexFocusedByClick: number | undefined = undefined
|
504
|
+
container.addEventListener(
|
505
|
+
'mousedown',
|
506
|
+
event => {
|
507
|
+
// Since focusin is only called when focus changes, we need to make sure the clicked
|
508
|
+
// element isn't already focused.
|
509
|
+
if (event.target instanceof HTMLElement && event.target !== document.activeElement) {
|
510
|
+
elementIndexFocusedByClick = focusableElements.indexOf(event.target)
|
511
|
+
}
|
512
|
+
},
|
513
|
+
{signal}
|
514
|
+
)
|
515
|
+
|
516
|
+
if (activeDescendantControl) {
|
517
|
+
container.addEventListener('focusin', event => {
|
518
|
+
if (event.target instanceof HTMLElement && focusableElements.includes(event.target)) {
|
519
|
+
// Move focus to the activeDescendantControl if one of the descendants is focused
|
520
|
+
activeDescendantControl.focus()
|
521
|
+
updateFocusedElement(event.target)
|
522
|
+
}
|
523
|
+
})
|
524
|
+
container.addEventListener(
|
525
|
+
'mousemove',
|
526
|
+
({target}) => {
|
527
|
+
if (!(target instanceof Node)) {
|
528
|
+
return
|
529
|
+
}
|
530
|
+
|
531
|
+
const focusableElement = focusableElements.find(element => element.contains(target))
|
532
|
+
|
533
|
+
if (focusableElement) {
|
534
|
+
updateFocusedElement(focusableElement)
|
535
|
+
}
|
536
|
+
},
|
537
|
+
{signal, capture: true}
|
538
|
+
)
|
539
|
+
|
540
|
+
// Listeners specifically on the controlling element
|
541
|
+
activeDescendantControl.addEventListener('focusin', () => {
|
542
|
+
// Focus moved into the active descendant input. Activate current or first descendant.
|
543
|
+
if (!currentFocusedElement) {
|
544
|
+
updateFocusedElement(getFirstFocusableElement())
|
545
|
+
} else {
|
546
|
+
setActiveDescendant(undefined, currentFocusedElement)
|
547
|
+
}
|
548
|
+
})
|
549
|
+
activeDescendantControl.addEventListener('focusout', () => {
|
550
|
+
clearActiveDescendant()
|
551
|
+
})
|
552
|
+
} else {
|
553
|
+
// This is called whenever focus enters an element in the container
|
554
|
+
container.addEventListener(
|
555
|
+
'focusin',
|
556
|
+
event => {
|
557
|
+
if (event.target instanceof HTMLElement) {
|
558
|
+
// If a click initiated the focus movement, we always want to set our internal state
|
559
|
+
// to reflect the clicked element as the currently focused one.
|
560
|
+
if (elementIndexFocusedByClick !== undefined) {
|
561
|
+
if (elementIndexFocusedByClick >= 0) {
|
562
|
+
if (focusableElements[elementIndexFocusedByClick] !== currentFocusedElement) {
|
563
|
+
updateFocusedElement(focusableElements[elementIndexFocusedByClick])
|
564
|
+
}
|
565
|
+
}
|
566
|
+
elementIndexFocusedByClick = undefined
|
567
|
+
} else {
|
568
|
+
// Set tab indexes and internal state based on the focus handling strategy
|
569
|
+
if (focusInStrategy === 'previous') {
|
570
|
+
updateFocusedElement(event.target)
|
571
|
+
} else if (focusInStrategy === 'closest' || focusInStrategy === 'first') {
|
572
|
+
if (event.relatedTarget instanceof Element && !container.contains(event.relatedTarget)) {
|
573
|
+
// Regardless of the previously focused element, if we're coming from outside the
|
574
|
+
// container, put focus onto the first encountered element (from above, it's The
|
575
|
+
// first element of the container; from below, it's the last). If the
|
576
|
+
// focusInStrategy is set to "first", lastKeyboardFocusDirection will always
|
577
|
+
// be undefined.
|
578
|
+
const targetElementIndex = lastKeyboardFocusDirection === 'previous' ? focusableElements.length - 1 : 0
|
579
|
+
const targetElement = focusableElements[targetElementIndex] as HTMLElement | undefined
|
580
|
+
targetElement?.focus()
|
581
|
+
return
|
582
|
+
} else {
|
583
|
+
updateFocusedElement(event.target)
|
584
|
+
}
|
585
|
+
} else if (typeof focusInStrategy === 'function') {
|
586
|
+
if (event.relatedTarget instanceof Element && !container.contains(event.relatedTarget)) {
|
587
|
+
const elementToFocus = focusInStrategy(event.relatedTarget)
|
588
|
+
const requestedFocusElementIndex = elementToFocus ? focusableElements.indexOf(elementToFocus) : -1
|
589
|
+
if (requestedFocusElementIndex >= 0 && elementToFocus instanceof HTMLElement) {
|
590
|
+
// Since we are calling focus() this handler will run again synchronously. Therefore,
|
591
|
+
// we don't want to let this invocation finish since it will clobber the value of
|
592
|
+
// currentFocusedElement.
|
593
|
+
elementToFocus.focus()
|
594
|
+
return
|
595
|
+
} else {
|
596
|
+
// eslint-disable-next-line no-console
|
597
|
+
console.warn('Element requested is not a known focusable element.')
|
598
|
+
}
|
599
|
+
} else {
|
600
|
+
updateFocusedElement(event.target)
|
601
|
+
}
|
602
|
+
}
|
603
|
+
}
|
604
|
+
}
|
605
|
+
lastKeyboardFocusDirection = undefined
|
606
|
+
},
|
607
|
+
{signal}
|
608
|
+
)
|
609
|
+
}
|
610
|
+
|
611
|
+
const keyboardEventRecipient = activeDescendantControl ?? container
|
612
|
+
|
613
|
+
// If the strategy is "closest", we need to capture the direction that the user
|
614
|
+
// is trying to move focus before our focusin handler is executed.
|
615
|
+
let lastKeyboardFocusDirection: Direction | undefined = undefined
|
616
|
+
if (focusInStrategy === 'closest') {
|
617
|
+
document.addEventListener(
|
618
|
+
'keydown',
|
619
|
+
event => {
|
620
|
+
if (event.key === 'Tab') {
|
621
|
+
lastKeyboardFocusDirection = getDirection(event)
|
622
|
+
}
|
623
|
+
},
|
624
|
+
{signal, capture: true}
|
625
|
+
)
|
626
|
+
}
|
627
|
+
|
628
|
+
function getCurrentFocusedIndex() {
|
629
|
+
if (!currentFocusedElement) {
|
630
|
+
return 0
|
631
|
+
}
|
632
|
+
|
633
|
+
const focusedIndex = focusableElements.indexOf(currentFocusedElement)
|
634
|
+
const fallbackIndex = currentFocusedElement === container ? -1 : 0
|
635
|
+
|
636
|
+
return focusedIndex !== -1 ? focusedIndex : fallbackIndex
|
637
|
+
}
|
638
|
+
|
639
|
+
// "keydown" is the event that triggers DOM focus change, so that is what we use here
|
640
|
+
keyboardEventRecipient.addEventListener(
|
641
|
+
'keydown',
|
642
|
+
event => {
|
643
|
+
if (event.key in KEY_TO_DIRECTION) {
|
644
|
+
const keyBit = KEY_TO_BIT[event.key as keyof typeof KEY_TO_BIT]
|
645
|
+
// Check if the pressed key (keyBit) is one that is being used for focus (bindKeys)
|
646
|
+
if (
|
647
|
+
!event.defaultPrevented &&
|
648
|
+
(keyBit & bindKeys) > 0 &&
|
649
|
+
!shouldIgnoreFocusHandling(event, document.activeElement)
|
650
|
+
) {
|
651
|
+
// Moving forward or backward?
|
652
|
+
const direction = getDirection(event)
|
653
|
+
|
654
|
+
let nextElementToFocus: HTMLElement | undefined = undefined
|
655
|
+
|
656
|
+
// If there is a custom function that retrieves the next focusable element, try calling that first.
|
657
|
+
if (settings?.getNextFocusable) {
|
658
|
+
nextElementToFocus = settings.getNextFocusable(direction, document.activeElement ?? undefined, event)
|
659
|
+
}
|
660
|
+
if (!nextElementToFocus) {
|
661
|
+
const lastFocusedIndex = getCurrentFocusedIndex()
|
662
|
+
let nextFocusedIndex = lastFocusedIndex
|
663
|
+
if (direction === 'previous') {
|
664
|
+
nextFocusedIndex -= 1
|
665
|
+
} else if (direction === 'start') {
|
666
|
+
nextFocusedIndex = 0
|
667
|
+
} else if (direction === 'next') {
|
668
|
+
nextFocusedIndex += 1
|
669
|
+
} else {
|
670
|
+
// end
|
671
|
+
nextFocusedIndex = focusableElements.length - 1
|
672
|
+
}
|
673
|
+
|
674
|
+
if (nextFocusedIndex < 0) {
|
675
|
+
// Tab should never cause focus to wrap. Use focusTrap for that behavior.
|
676
|
+
if (focusOutBehavior === 'wrap' && event.key !== 'Tab') {
|
677
|
+
nextFocusedIndex = focusableElements.length - 1
|
678
|
+
} else {
|
679
|
+
nextFocusedIndex = 0
|
680
|
+
}
|
681
|
+
}
|
682
|
+
if (nextFocusedIndex >= focusableElements.length) {
|
683
|
+
if (focusOutBehavior === 'wrap' && event.key !== 'Tab') {
|
684
|
+
nextFocusedIndex = 0
|
685
|
+
} else {
|
686
|
+
nextFocusedIndex = focusableElements.length - 1
|
687
|
+
}
|
688
|
+
}
|
689
|
+
if (lastFocusedIndex !== nextFocusedIndex) {
|
690
|
+
nextElementToFocus = focusableElements[nextFocusedIndex]
|
691
|
+
}
|
692
|
+
}
|
693
|
+
|
694
|
+
if (activeDescendantControl) {
|
695
|
+
updateFocusedElement(nextElementToFocus || currentFocusedElement, true)
|
696
|
+
} else if (nextElementToFocus) {
|
697
|
+
lastKeyboardFocusDirection = direction
|
698
|
+
|
699
|
+
// updateFocusedElement will be called implicitly when focus moves, as long as the event isn't prevented somehow
|
700
|
+
nextElementToFocus.focus()
|
701
|
+
}
|
702
|
+
// Tab should always allow escaping from this container, so only
|
703
|
+
// preventDefault if tab key press already resulted in a focus movement
|
704
|
+
if (event.key !== 'Tab' || nextElementToFocus) {
|
705
|
+
event.preventDefault()
|
706
|
+
}
|
707
|
+
}
|
708
|
+
}
|
709
|
+
},
|
710
|
+
{signal}
|
711
|
+
)
|
712
|
+
return controller
|
713
|
+
}
|