@fluentui/react-tabster 9.3.3 → 9.3.5
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/CHANGELOG.json +63 -1
- package/CHANGELOG.md +23 -2
- package/lib/focus/constants.js +0 -2
- package/lib/focus/constants.js.map +1 -1
- package/lib/focus/createCustomFocusIndicatorStyle.js +0 -1
- package/lib/focus/createCustomFocusIndicatorStyle.js.map +1 -1
- package/lib/focus/createFocusOutlineStyle.js +2 -5
- package/lib/focus/createFocusOutlineStyle.js.map +1 -1
- package/lib/focus/focusVisiblePolyfill.js +8 -20
- package/lib/focus/focusVisiblePolyfill.js.map +1 -1
- package/lib/focus/focusWithinPolyfill.js +8 -15
- package/lib/focus/focusWithinPolyfill.js.map +1 -1
- package/lib/hooks/useArrowNavigationGroup.js +0 -7
- package/lib/hooks/useArrowNavigationGroup.js.map +1 -1
- package/lib/hooks/useFocusFinders.js +2 -3
- package/lib/hooks/useFocusFinders.js.map +1 -1
- package/lib/hooks/useFocusVisible.js.map +1 -1
- package/lib/hooks/useFocusWithin.js +0 -1
- package/lib/hooks/useFocusWithin.js.map +1 -1
- package/lib/hooks/useFocusableGroup.js +0 -7
- package/lib/hooks/useFocusableGroup.js.map +1 -1
- package/lib/hooks/useKeyboardNavAttribute.js +0 -5
- package/lib/hooks/useKeyboardNavAttribute.js.map +1 -1
- package/lib/hooks/useModalAttributes.js +2 -4
- package/lib/hooks/useModalAttributes.js.map +1 -1
- package/lib/hooks/useTabster.js +0 -2
- package/lib/hooks/useTabster.js.map +1 -1
- package/lib/hooks/useTabsterAttributes.js +0 -1
- package/lib/hooks/useTabsterAttributes.js.map +1 -1
- package/lib/index.js.map +1 -1
- package/lib-commonjs/focus/constants.js +0 -2
- package/lib-commonjs/focus/constants.js.map +1 -1
- package/lib-commonjs/focus/createCustomFocusIndicatorStyle.js +0 -4
- package/lib-commonjs/focus/createCustomFocusIndicatorStyle.js.map +1 -1
- package/lib-commonjs/focus/createFocusOutlineStyle.js +2 -11
- package/lib-commonjs/focus/createFocusOutlineStyle.js.map +1 -1
- package/lib-commonjs/focus/focusVisiblePolyfill.js +8 -24
- package/lib-commonjs/focus/focusVisiblePolyfill.js.map +1 -1
- package/lib-commonjs/focus/focusWithinPolyfill.js +8 -19
- package/lib-commonjs/focus/focusWithinPolyfill.js.map +1 -1
- package/lib-commonjs/focus/index.js +0 -5
- package/lib-commonjs/focus/index.js.map +1 -1
- package/lib-commonjs/hooks/index.js +0 -9
- package/lib-commonjs/hooks/index.js.map +1 -1
- package/lib-commonjs/hooks/useArrowNavigationGroup.js +0 -12
- package/lib-commonjs/hooks/useArrowNavigationGroup.js.map +1 -1
- package/lib-commonjs/hooks/useFocusFinders.js +2 -7
- package/lib-commonjs/hooks/useFocusFinders.js.map +1 -1
- package/lib-commonjs/hooks/useFocusVisible.js +0 -5
- package/lib-commonjs/hooks/useFocusVisible.js.map +1 -1
- package/lib-commonjs/hooks/useFocusWithin.js +0 -6
- package/lib-commonjs/hooks/useFocusWithin.js.map +1 -1
- package/lib-commonjs/hooks/useFocusableGroup.js +0 -12
- package/lib-commonjs/hooks/useFocusableGroup.js.map +1 -1
- package/lib-commonjs/hooks/useKeyboardNavAttribute.js +0 -11
- package/lib-commonjs/hooks/useKeyboardNavAttribute.js.map +1 -1
- package/lib-commonjs/hooks/useModalAttributes.js +2 -10
- package/lib-commonjs/hooks/useModalAttributes.js.map +1 -1
- package/lib-commonjs/hooks/useTabster.js +0 -8
- package/lib-commonjs/hooks/useTabster.js.map +1 -1
- package/lib-commonjs/hooks/useTabsterAttributes.js +0 -5
- package/lib-commonjs/hooks/useTabsterAttributes.js.map +1 -1
- package/lib-commonjs/index.js +0 -6
- package/lib-commonjs/index.js.map +1 -1
- package/package.json +7 -7
@@ -5,32 +5,25 @@ import { useTabster } from './useTabster';
|
|
5
5
|
* A hook that returns the necessary tabster attributes to support groupping.
|
6
6
|
* @param options - Options to configure keyboard navigation
|
7
7
|
*/
|
8
|
-
|
9
8
|
export const useFocusableGroup = options => {
|
10
9
|
const tabster = useTabster();
|
11
|
-
|
12
10
|
if (tabster) {
|
13
11
|
getGroupper(tabster);
|
14
12
|
}
|
15
|
-
|
16
13
|
return useTabsterAttributes({
|
17
14
|
groupper: {
|
18
15
|
tabbability: getTabbability(options === null || options === void 0 ? void 0 : options.tabBehavior)
|
19
16
|
}
|
20
17
|
});
|
21
18
|
};
|
22
|
-
|
23
19
|
const getTabbability = tabBehavior => {
|
24
20
|
switch (tabBehavior) {
|
25
21
|
case 'unlimited':
|
26
22
|
return Types.GroupperTabbabilities.Unlimited;
|
27
|
-
|
28
23
|
case 'limited':
|
29
24
|
return Types.GroupperTabbabilities.Limited;
|
30
|
-
|
31
25
|
case 'limited-trap-focus':
|
32
26
|
return Types.GroupperTabbabilities.LimitedTrapFocus;
|
33
|
-
|
34
27
|
default:
|
35
28
|
return undefined;
|
36
29
|
}
|
@@ -1 +1 @@
|
|
1
|
-
{"version":3,"
|
1
|
+
{"version":3,"mappings":"AAAA,SAASA,KAAK,EAAEC,WAAW,QAAQ,SAAS;AAC5C,SAASC,oBAAoB,QAAQ,wBAAwB;AAC7D,SAASC,UAAU,QAAQ,cAAc;AASzC;;;;AAIA,OAAO,MAAMC,iBAAiB,GAAIC,OAAkC,IAA+B;EACjG,MAAMC,OAAO,GAAGH,UAAU,EAAE;EAE5B,IAAIG,OAAO,EAAE;IACXL,WAAW,CAACK,OAAO,CAAC;;EAGtB,OAAOJ,oBAAoB,CAAC;IAC1BK,QAAQ,EAAE;MACRC,WAAW,EAAEC,cAAc,CAACJ,OAAO,aAAPA,OAAO,uBAAPA,OAAO,CAAEK,WAAW;;GAEnD,CAAC;AACJ,CAAC;AAED,MAAMD,cAAc,GAClBC,WAAqD,IACZ;EACzC,QAAQA,WAAW;IACjB,KAAK,WAAW;MACd,OAAOV,KAAK,CAACW,qBAAqB,CAACC,SAAS;IAC9C,KAAK,SAAS;MACZ,OAAOZ,KAAK,CAACW,qBAAqB,CAACE,OAAO;IAC5C,KAAK,oBAAoB;MACvB,OAAOb,KAAK,CAACW,qBAAqB,CAACG,gBAAgB;IACrD;MACE,OAAOC,SAAS;EAAC;AAEvB,CAAC","names":["Types","getGroupper","useTabsterAttributes","useTabster","useFocusableGroup","options","tabster","groupper","tabbability","getTabbability","tabBehavior","GroupperTabbabilities","Unlimited","Limited","LimitedTrapFocus","undefined"],"sourceRoot":"../src/","sources":["packages/react-components/react-tabster/src/hooks/useFocusableGroup.ts"],"sourcesContent":["import { Types, getGroupper } from 'tabster';\nimport { useTabsterAttributes } from './useTabsterAttributes';\nimport { useTabster } from './useTabster';\n\nexport interface UseFocusableGroupOptions {\n /**\n * Behavior for the Tab key.\n */\n tabBehavior?: 'unlimited' | 'limited' | 'limited-trap-focus';\n}\n\n/**\n * A hook that returns the necessary tabster attributes to support groupping.\n * @param options - Options to configure keyboard navigation\n */\nexport const useFocusableGroup = (options?: UseFocusableGroupOptions): Types.TabsterDOMAttribute => {\n const tabster = useTabster();\n\n if (tabster) {\n getGroupper(tabster);\n }\n\n return useTabsterAttributes({\n groupper: {\n tabbability: getTabbability(options?.tabBehavior),\n },\n });\n};\n\nconst getTabbability = (\n tabBehavior?: UseFocusableGroupOptions['tabBehavior'],\n): Types.GroupperTabbability | undefined => {\n switch (tabBehavior) {\n case 'unlimited':\n return Types.GroupperTabbabilities.Unlimited;\n case 'limited':\n return Types.GroupperTabbabilities.Limited;\n case 'limited-trap-focus':\n return Types.GroupperTabbabilities.LimitedTrapFocus;\n default:\n return undefined;\n }\n};\n"]}
|
@@ -7,7 +7,6 @@ import { useFluent_unstable as useFluent } from '@fluentui/react-shared-contexts
|
|
7
7
|
* attribute to a referenced element to ensure keyboard navigation awareness
|
8
8
|
* synced to keyborg logic without having to cause a re-render on react tree.
|
9
9
|
*/
|
10
|
-
|
11
10
|
export function useKeyboardNavAttribute() {
|
12
11
|
const {
|
13
12
|
targetDocument
|
@@ -17,23 +16,19 @@ export function useKeyboardNavAttribute() {
|
|
17
16
|
useEffect(() => {
|
18
17
|
if (keyborg) {
|
19
18
|
setBooleanAttribute(ref, KEYBOARD_NAV_ATTRIBUTE, keyborg.isNavigatingWithKeyboard());
|
20
|
-
|
21
19
|
const cb = next => {
|
22
20
|
setBooleanAttribute(ref, KEYBOARD_NAV_ATTRIBUTE, next);
|
23
21
|
};
|
24
|
-
|
25
22
|
keyborg.subscribe(cb);
|
26
23
|
return () => keyborg.unsubscribe(cb);
|
27
24
|
}
|
28
25
|
}, [keyborg]);
|
29
26
|
return ref;
|
30
27
|
}
|
31
|
-
|
32
28
|
function setBooleanAttribute(elementRef, attribute, value) {
|
33
29
|
if (!elementRef.current) {
|
34
30
|
return;
|
35
31
|
}
|
36
|
-
|
37
32
|
if (value) {
|
38
33
|
elementRef.current.setAttribute(attribute, '');
|
39
34
|
} else {
|
@@ -1 +1 @@
|
|
1
|
-
{"version":3,"
|
1
|
+
{"version":3,"mappings":"AAAA,SAASA,aAAa,QAAQ,SAAS;AACvC,SAASC,SAAS,EAAEC,OAAO,EAAEC,MAAM,QAAQ,OAAO;AAClD,SAASC,sBAAsB,QAAQ,oBAAoB;AAC3D,SAASC,kBAAkB,IAAIC,SAAS,QAAQ,iCAAiC;AAIjF;;;;;AAKA,OAAM,SAAUC,uBAAuB;EACrC,MAAM;IAAEC;EAAc,CAAE,GAAGF,SAAS,EAAE;EACtC,MAAMG,OAAO,GAAGP,OAAO,CAAC,MAAMM,cAAc,IAAIR,aAAa,CAACQ,cAAc,CAACE,WAAY,CAAC,EAAE,CAACF,cAAc,CAAC,CAAC;EAC7G,MAAMG,GAAG,GAAGR,MAAM,CAAI,IAAI,CAAC;EAC3BF,SAAS,CAAC,MAAK;IACb,IAAIQ,OAAO,EAAE;MACXG,mBAAmB,CAACD,GAAG,EAAEP,sBAAsB,EAAEK,OAAO,CAACI,wBAAwB,EAAE,CAAC;MACpF,MAAMC,EAAE,GAAoBC,IAAI,IAAG;QACjCH,mBAAmB,CAACD,GAAG,EAAEP,sBAAsB,EAAEW,IAAI,CAAC;MACxD,CAAC;MACDN,OAAO,CAACO,SAAS,CAACF,EAAE,CAAC;MACrB,OAAO,MAAML,OAAO,CAACQ,WAAW,CAACH,EAAE,CAAC;;EAExC,CAAC,EAAE,CAACL,OAAO,CAAC,CAAC;EACb,OAAOE,GAAG;AACZ;AAEA,SAASC,mBAAmB,CAACM,UAAkC,EAAEC,SAAiB,EAAEC,KAAc;EAChG,IAAI,CAACF,UAAU,CAACG,OAAO,EAAE;IACvB;;EAEF,IAAID,KAAK,EAAE;IACTF,UAAU,CAACG,OAAO,CAACC,YAAY,CAACH,SAAS,EAAE,EAAE,CAAC;GAC/C,MAAM;IACLD,UAAU,CAACG,OAAO,CAACE,eAAe,CAACJ,SAAS,CAAC;;AAEjD","names":["createKeyborg","useEffect","useMemo","useRef","KEYBOARD_NAV_ATTRIBUTE","useFluent_unstable","useFluent","useKeyboardNavAttribute","targetDocument","keyborg","defaultView","ref","setBooleanAttribute","isNavigatingWithKeyboard","cb","next","subscribe","unsubscribe","elementRef","attribute","value","current","setAttribute","removeAttribute"],"sourceRoot":"../src/","sources":["packages/react-components/react-tabster/src/hooks/useKeyboardNavAttribute.ts"],"sourcesContent":["import { createKeyborg } from 'keyborg';\nimport { useEffect, useMemo, useRef } from 'react';\nimport { KEYBOARD_NAV_ATTRIBUTE } from '../focus/constants';\nimport { useFluent_unstable as useFluent } from '@fluentui/react-shared-contexts';\nimport type { KeyborgCallback } from 'keyborg';\nimport type { RefObject } from 'react';\n\n/**\n * Instantiates [keyborg](https://github.com/microsoft/keyborg) and adds `data-keyboard-nav`\n * attribute to a referenced element to ensure keyboard navigation awareness\n * synced to keyborg logic without having to cause a re-render on react tree.\n */\nexport function useKeyboardNavAttribute<E extends HTMLElement>() {\n const { targetDocument } = useFluent();\n const keyborg = useMemo(() => targetDocument && createKeyborg(targetDocument.defaultView!), [targetDocument]);\n const ref = useRef<E>(null);\n useEffect(() => {\n if (keyborg) {\n setBooleanAttribute(ref, KEYBOARD_NAV_ATTRIBUTE, keyborg.isNavigatingWithKeyboard());\n const cb: KeyborgCallback = next => {\n setBooleanAttribute(ref, KEYBOARD_NAV_ATTRIBUTE, next);\n };\n keyborg.subscribe(cb);\n return () => keyborg.unsubscribe(cb);\n }\n }, [keyborg]);\n return ref;\n}\n\nfunction setBooleanAttribute(elementRef: RefObject<HTMLElement>, attribute: string, value: boolean) {\n if (!elementRef.current) {\n return;\n }\n if (value) {\n elementRef.current.setAttribute(attribute, '');\n } else {\n elementRef.current.removeAttribute(attribute);\n }\n}\n"]}
|
@@ -9,20 +9,18 @@ import { useTabster } from './useTabster';
|
|
9
9
|
*
|
10
10
|
* @returns DOM attributes to apply to the modal element and its trigger
|
11
11
|
*/
|
12
|
-
|
13
12
|
export const useModalAttributes = (options = {}) => {
|
14
13
|
const {
|
15
14
|
trapFocus,
|
16
15
|
alwaysFocusable,
|
17
16
|
legacyTrapFocus
|
18
17
|
} = options;
|
19
|
-
const tabster = useTabster();
|
20
|
-
|
18
|
+
const tabster = useTabster();
|
19
|
+
// Initializes the modalizer and deloser APIs
|
21
20
|
if (tabster) {
|
22
21
|
getModalizer(tabster);
|
23
22
|
getDeloser(tabster);
|
24
23
|
}
|
25
|
-
|
26
24
|
const id = useId('modal-');
|
27
25
|
const modalAttributes = useTabsterAttributes({
|
28
26
|
deloser: {},
|
@@ -1 +1 @@
|
|
1
|
-
{"version":3,"
|
1
|
+
{"version":3,"mappings":"AAAA,SAASA,KAAK,QAAQ,2BAA2B;AACjD,SAASC,oBAAoB,QAAQ,wBAAwB;AAC7D,SAASC,UAAU,EAAEC,YAAY,QAA+B,SAAS;AACzE,SAASC,UAAU,QAAQ,cAAc;AAyBzC;;;;;;;AAOA,OAAO,MAAMC,kBAAkB,GAAG,CAChCC,UAAqC,EAAE,KACuE;EAC9G,MAAM;IAAEC,SAAS;IAAEC,eAAe;IAAEC;EAAe,CAAE,GAAGH,OAAO;EAC/D,MAAMI,OAAO,GAAGN,UAAU,EAAE;EAC5B;EACA,IAAIM,OAAO,EAAE;IACXP,YAAY,CAACO,OAAO,CAAC;IACrBR,UAAU,CAACQ,OAAO,CAAC;;EAGrB,MAAMC,EAAE,GAAGX,KAAK,CAAC,QAAQ,CAAC;EAC1B,MAAMY,eAAe,GAAGX,oBAAoB,CAAC;IAC3CY,OAAO,EAAE,EAAE;IACXC,SAAS,EAAE;MACTH,EAAE;MACFI,kBAAkB,EAAE,CAACR,SAAS;MAC9BS,kBAAkB,EAAER,eAAe;MACnCS,SAAS,EAAER;;GAEd,CAAC;EAEF,MAAMS,iBAAiB,GAAGjB,oBAAoB,CAAC;IAC7CY,OAAO,EAAE;GACV,CAAC;EAEF,OAAO;IAAED,eAAe;IAAEM;EAAiB,CAAE;AAC/C,CAAC","names":["useId","useTabsterAttributes","getDeloser","getModalizer","useTabster","useModalAttributes","options","trapFocus","alwaysFocusable","legacyTrapFocus","tabster","id","modalAttributes","deloser","modalizer","isOthersAccessible","isAlwaysAccessible","isTrapped","triggerAttributes"],"sourceRoot":"../src/","sources":["packages/react-components/react-tabster/src/hooks/useModalAttributes.ts"],"sourcesContent":["import { useId } from '@fluentui/react-utilities';\nimport { useTabsterAttributes } from './useTabsterAttributes';\nimport { getDeloser, getModalizer, Types as TabsterTypes } from 'tabster';\nimport { useTabster } from './useTabster';\n\nexport interface UseModalAttributesOptions {\n /**\n * Traps focus inside the elements the attributes are applied.\n * Prefer this to `legacyTrapFocus`\n * it forbids users to tab out of the focus trap into the actual browser.\n */\n trapFocus?: boolean;\n\n /**\n * Traps focus inside the elements the attributes are applied.\n * This prop enables legacy behavior to match previous versions of Fluent and is not\n * recommended for general use.\n * Enabling `legacyTrapFocus` prevents users from tabbing out of the focus trap and into\n * the actual browser. Prefer using `trapFocus` instead of this prop.\n */\n legacyTrapFocus?: boolean;\n\n /**\n * Always reachabled in Tab order\n */\n alwaysFocusable?: boolean;\n}\n\n/**\n * Applies modal dialog behaviour through DOM attributes\n * Modal element will focus trap and hide other content on the page\n * The trigger element will be focused if focus is lost after the modal element is removed\n *\n * @returns DOM attributes to apply to the modal element and its trigger\n */\nexport const useModalAttributes = (\n options: UseModalAttributesOptions = {},\n): { modalAttributes: TabsterTypes.TabsterDOMAttribute; triggerAttributes: TabsterTypes.TabsterDOMAttribute } => {\n const { trapFocus, alwaysFocusable, legacyTrapFocus } = options;\n const tabster = useTabster();\n // Initializes the modalizer and deloser APIs\n if (tabster) {\n getModalizer(tabster);\n getDeloser(tabster);\n }\n\n const id = useId('modal-');\n const modalAttributes = useTabsterAttributes({\n deloser: {},\n modalizer: {\n id,\n isOthersAccessible: !trapFocus,\n isAlwaysAccessible: alwaysFocusable,\n isTrapped: legacyTrapFocus,\n },\n });\n\n const triggerAttributes = useTabsterAttributes({\n deloser: {},\n });\n\n return { modalAttributes, triggerAttributes };\n};\n"]}
|
package/lib/hooks/useTabster.js
CHANGED
@@ -9,7 +9,6 @@ import { useIsomorphicLayoutEffect } from '@fluentui/react-utilities';
|
|
9
9
|
* @internal
|
10
10
|
* @returns Tabster core instance
|
11
11
|
*/
|
12
|
-
|
13
12
|
export const useTabster = () => {
|
14
13
|
const {
|
15
14
|
targetDocument
|
@@ -19,7 +18,6 @@ export const useTabster = () => {
|
|
19
18
|
if (!defaultView) {
|
20
19
|
return null;
|
21
20
|
}
|
22
|
-
|
23
21
|
return createTabster(defaultView, {
|
24
22
|
autoRoot: {},
|
25
23
|
controlTab: false
|
@@ -1 +1 @@
|
|
1
|
-
{"version":3,"
|
1
|
+
{"version":3,"mappings":"AAAA,OAAO,KAAKA,KAAK,MAAM,OAAO;AAC9B,SAASC,kBAAkB,IAAIC,SAAS,QAAQ,iCAAiC;AACjF,SAASC,aAAa,EAAEC,cAAc,QAA+B,SAAS;AAC9E,SAASC,yBAAyB,QAAQ,2BAA2B;AAErE;;;;;;;AAOA,OAAO,MAAMC,UAAU,GAAG,MAAsC;EAC9D,MAAM;IAAEC;EAAc,CAAE,GAAGL,SAAS,EAAE;EAEtC,MAAMM,WAAW,GAAG,eAAc,aAAdD,cAAc,uBAAdA,cAAc,CAAEC,WAAW,KAAIC,SAAS;EAC5D,MAAMC,OAAO,GAAGV,KAAK,CAACW,OAAO,CAAC,MAAK;IACjC,IAAI,CAACH,WAAW,EAAE;MAChB,OAAO,IAAI;;IAGb,OAAOL,aAAa,CAACK,WAAW,EAAE;MAAEI,QAAQ,EAAE,EAAE;MAAEC,UAAU,EAAE;IAAK,CAAE,CAAC;EACxE,CAAC,EAAE,CAACL,WAAW,CAAC,CAAC;EAEjBH,yBAAyB,CAAC,MAAK;IAC7B,OAAO,MAAK;MACV,IAAIK,OAAO,EAAE;QACXN,cAAc,CAACM,OAAO,CAAC;;IAE3B,CAAC;EACH,CAAC,EAAE,CAACA,OAAO,CAAC,CAAC;EAEb,OAAOA,OAAO;AAChB,CAAC","names":["React","useFluent_unstable","useFluent","createTabster","disposeTabster","useIsomorphicLayoutEffect","useTabster","targetDocument","defaultView","undefined","tabster","useMemo","autoRoot","controlTab"],"sourceRoot":"../src/","sources":["packages/react-components/react-tabster/src/hooks/useTabster.ts"],"sourcesContent":["import * as React from 'react';\nimport { useFluent_unstable as useFluent } from '@fluentui/react-shared-contexts';\nimport { createTabster, disposeTabster, Types as TabsterTypes } from 'tabster';\nimport { useIsomorphicLayoutEffect } from '@fluentui/react-utilities';\n\n/**\n * Tries to get a tabster instance on the current window or creates a new one\n * Since Tabster is single instance only, feel free to call this hook to ensure Tabster exists if necessary\n *\n * @internal\n * @returns Tabster core instance\n */\nexport const useTabster = (): TabsterTypes.TabsterCore | null => {\n const { targetDocument } = useFluent();\n\n const defaultView = targetDocument?.defaultView || undefined;\n const tabster = React.useMemo(() => {\n if (!defaultView) {\n return null;\n }\n\n return createTabster(defaultView, { autoRoot: {}, controlTab: false });\n }, [defaultView]);\n\n useIsomorphicLayoutEffect(() => {\n return () => {\n if (tabster) {\n disposeTabster(tabster);\n }\n };\n }, [tabster]);\n\n return tabster;\n};\n"]}
|
@@ -4,7 +4,6 @@ import { useTabster } from './useTabster';
|
|
4
4
|
* @internal
|
5
5
|
* Hook that returns tabster attributes while ensuring tabster exists
|
6
6
|
*/
|
7
|
-
|
8
7
|
export const useTabsterAttributes = props => {
|
9
8
|
// A tabster instance is not necessary to generate tabster attributes
|
10
9
|
// but calling the hook will ensure that a tabster instance exists internally and avoids consumers doing the same
|
@@ -1 +1 @@
|
|
1
|
-
{"version":3,"
|
1
|
+
{"version":3,"mappings":"AAAA,SAASA,mBAAmB,QAA+B,SAAS;AACpE,SAASC,UAAU,QAAQ,cAAc;AAEzC;;;;AAIA,OAAO,MAAMC,oBAAoB,GAAIC,KAAyC,IAAsC;EAClH;EACA;EACAF,UAAU,EAAE;EAEZ,OAAOD,mBAAmB,CAACG,KAAK,CAAC;AACnC,CAAC","names":["getTabsterAttribute","useTabster","useTabsterAttributes","props"],"sourceRoot":"../src/","sources":["packages/react-components/react-tabster/src/hooks/useTabsterAttributes.ts"],"sourcesContent":["import { getTabsterAttribute, Types as TabsterTypes } from 'tabster';\nimport { useTabster } from './useTabster';\n\n/**\n * @internal\n * Hook that returns tabster attributes while ensuring tabster exists\n */\nexport const useTabsterAttributes = (props: TabsterTypes.TabsterAttributeProps): TabsterTypes.TabsterDOMAttribute => {\n // A tabster instance is not necessary to generate tabster attributes\n // but calling the hook will ensure that a tabster instance exists internally and avoids consumers doing the same\n useTabster();\n\n return getTabsterAttribute(props);\n};\n"]}
|
package/lib/index.js.map
CHANGED
@@ -1 +1 @@
|
|
1
|
-
{"version":3,"
|
1
|
+
{"version":3,"mappings":"AAAA,SACEA,uBAAuB,EACvBC,iBAAiB,EACjBC,eAAe,EACfC,eAAe,EACfC,cAAc,EACdC,uBAAuB,EACvBC,kBAAkB,EAClBC,oBAAoB,QACf,eAAe;AAOtB,SAASC,+BAA+B,EAAEC,uBAAuB,QAAQ,eAAe;AASxF,SAASC,yBAAyB,QAAQ,eAAe","names":["useArrowNavigationGroup","useFocusableGroup","useFocusFinders","useFocusVisible","useFocusWithin","useKeyboardNavAttribute","useModalAttributes","useTabsterAttributes","createCustomFocusIndicatorStyle","createFocusOutlineStyle","applyFocusVisiblePolyfill"],"sourceRoot":"../src/","sources":["packages/react-components/react-tabster/src/index.ts"],"sourcesContent":["export {\n useArrowNavigationGroup,\n useFocusableGroup,\n useFocusFinders,\n useFocusVisible,\n useFocusWithin,\n useKeyboardNavAttribute,\n useModalAttributes,\n useTabsterAttributes,\n} from './hooks/index';\nexport type {\n UseArrowNavigationGroupOptions,\n UseFocusableGroupOptions,\n UseModalAttributesOptions,\n} from './hooks/index';\n\nexport { createCustomFocusIndicatorStyle, createFocusOutlineStyle } from './focus/index';\n\nexport type {\n CreateCustomFocusIndicatorStyleOptions,\n CreateFocusOutlineStyleOptions,\n FocusOutlineOffset,\n FocusOutlineStyleOptions,\n} from './focus/index';\n\nexport { applyFocusVisiblePolyfill } from './focus/index';\n"]}
|
@@ -9,12 +9,10 @@ exports.KEYBOARD_NAV_SELECTOR = `:global([${exports.KEYBOARD_NAV_ATTRIBUTE}])`;
|
|
9
9
|
/**
|
10
10
|
* @internal
|
11
11
|
*/
|
12
|
-
|
13
12
|
exports.FOCUS_VISIBLE_ATTR = 'data-fui-focus-visible';
|
14
13
|
/**
|
15
14
|
* @internal
|
16
15
|
*/
|
17
|
-
|
18
16
|
exports.FOCUS_WITHIN_ATTR = 'data-fui-focus-within';
|
19
17
|
exports.defaultOptions = {
|
20
18
|
style: {},
|
@@ -1 +1 @@
|
|
1
|
-
{"version":3,"
|
1
|
+
{"version":3,"mappings":";;;;;;AAAaA,8BAAsB,GAAG,mBAA4B;AACrDA,6BAAqB,GAAG,YAAYA,8BAAsB,IAAa;AAEpF;;;AAGaA,0BAAkB,GAAG,wBAAwB;AAE1D;;;AAGaA,yBAAiB,GAAG,uBAAuB;AAC3CA,sBAAc,GAAG;EAC5BC,KAAK,EAAE,EAAE;EACTC,QAAQ,EAAE;CACF","names":["exports","style","selector"],"sourceRoot":"../src/","sources":["packages/react-components/react-tabster/src/focus/constants.ts"],"sourcesContent":["export const KEYBOARD_NAV_ATTRIBUTE = 'data-keyboard-nav' as const;\nexport const KEYBOARD_NAV_SELECTOR = `:global([${KEYBOARD_NAV_ATTRIBUTE}])` as const;\n\n/**\n * @internal\n */\nexport const FOCUS_VISIBLE_ATTR = 'data-fui-focus-visible';\n\n/**\n * @internal\n */\nexport const FOCUS_WITHIN_ATTR = 'data-fui-focus-within';\nexport const defaultOptions = {\n style: {},\n selector: 'focus',\n} as const;\n"]}
|
@@ -4,7 +4,6 @@ Object.defineProperty(exports, "__esModule", {
|
|
4
4
|
value: true
|
5
5
|
});
|
6
6
|
exports.createCustomFocusIndicatorStyle = void 0;
|
7
|
-
|
8
7
|
const constants_1 = /*#__PURE__*/require("./constants");
|
9
8
|
/**
|
10
9
|
* Creates a style for @see makeStyles that includes the necessary selectors for focus.
|
@@ -13,8 +12,6 @@ const constants_1 = /*#__PURE__*/require("./constants");
|
|
13
12
|
* @param style - styling applied on focus, defaults to @see getDefaultFocusOutlineStyles
|
14
13
|
* @param options - Configure the style of the focus outline
|
15
14
|
*/
|
16
|
-
|
17
|
-
|
18
15
|
function createCustomFocusIndicatorStyle(style, {
|
19
16
|
selector = constants_1.defaultOptions.selector,
|
20
17
|
enableOutline = false
|
@@ -34,6 +31,5 @@ function createCustomFocusIndicatorStyle(style, {
|
|
34
31
|
})
|
35
32
|
};
|
36
33
|
}
|
37
|
-
|
38
34
|
exports.createCustomFocusIndicatorStyle = createCustomFocusIndicatorStyle;
|
39
35
|
//# sourceMappingURL=createCustomFocusIndicatorStyle.js.map
|
@@ -1 +1 @@
|
|
1
|
-
{"version":3,"
|
1
|
+
{"version":3,"mappings":";;;;;;AAAA;AAiBA;;;;;;;AAOA,SAAgBA,+BAA+B,CAC7CC,KAAa,EACb;EACEC,QAAQ,GAAGC,0BAAc,CAACD,QAAQ;EAClCE,aAAa,GAAG;AAAK,IACqBD,0BAAc;EAE1D,OAAO;IACL,QAAQ,EAAE;MACRE,YAAY,EAAED,aAAa,GAAGE,SAAS,GAAG;KAC3C;IACD,gBAAgB,EAAE;MAChBD,YAAY,EAAED,aAAa,GAAGE,SAAS,GAAG;KAC3C;IAED,IAAIJ,QAAQ,KAAK,OAAO,IAAI;MAC1B,CAAC,KAAKC,8BAAkB,GAAG,GAAGF;KAC/B,CAAC;IACF,IAAIC,QAAQ,KAAK,cAAc,IAAI;MACjC,CAAC,KAAKC,6BAAiB,KAAKD,QAAQ,EAAE,GAAGD;KAC1C;GACF;AACH;AAtBAM","names":["createCustomFocusIndicatorStyle","style","selector","constants_1","enableOutline","outlineStyle","undefined","exports"],"sourceRoot":"../src/","sources":["packages/react-components/react-tabster/src/focus/createCustomFocusIndicatorStyle.ts"],"sourcesContent":["import { defaultOptions, FOCUS_VISIBLE_ATTR, FOCUS_WITHIN_ATTR } from './constants';\nimport { makeResetStyles } from '@griffel/react';\nimport type { GriffelStyle } from '@griffel/react';\n\n// TODO: Use the type directly from @griffel/react\n// https://github.com/microsoft/griffel/pull/278\ntype GriffelResetStyle = Parameters<typeof makeResetStyles>[0];\n\nexport interface CreateCustomFocusIndicatorStyleOptions {\n selector?: 'focus' | 'focus-within';\n /**\n * Enables the browser default outline style\n * @default false\n */\n enableOutline?: boolean;\n}\n\n/**\n * Creates a style for @see makeStyles that includes the necessary selectors for focus.\n * Should be used only when @see createFocusOutlineStyle does not fit requirements\n *\n * @param style - styling applied on focus, defaults to @see getDefaultFocusOutlineStyles\n * @param options - Configure the style of the focus outline\n */\nexport function createCustomFocusIndicatorStyle<TStyle extends GriffelStyle | GriffelResetStyle>(\n style: TStyle,\n {\n selector = defaultOptions.selector,\n enableOutline = false,\n }: CreateCustomFocusIndicatorStyleOptions = defaultOptions,\n): TStyle extends GriffelStyle ? GriffelStyle : GriffelResetStyle {\n return {\n ':focus': {\n outlineStyle: enableOutline ? undefined : 'none',\n },\n ':focus-visible': {\n outlineStyle: enableOutline ? undefined : 'none',\n },\n\n ...(selector === 'focus' && {\n [`&[${FOCUS_VISIBLE_ATTR}]`]: style,\n }),\n ...(selector === 'focus-within' && {\n [`&[${FOCUS_WITHIN_ATTR}]:${selector}`]: style,\n }),\n };\n}\n"]}
|
@@ -4,13 +4,9 @@ Object.defineProperty(exports, "__esModule", {
|
|
4
4
|
value: true
|
5
5
|
});
|
6
6
|
exports.createFocusOutlineStyle = void 0;
|
7
|
-
|
8
7
|
const react_theme_1 = /*#__PURE__*/require("@fluentui/react-theme");
|
9
|
-
|
10
8
|
const react_1 = /*#__PURE__*/require("@griffel/react");
|
11
|
-
|
12
9
|
const createCustomFocusIndicatorStyle_1 = /*#__PURE__*/require("./createCustomFocusIndicatorStyle");
|
13
|
-
|
14
10
|
const constants_1 = /*#__PURE__*/require("./constants");
|
15
11
|
/**
|
16
12
|
* NOTE: the element with the focus outline needs to have `position: relative` so that the
|
@@ -19,11 +15,8 @@ const constants_1 = /*#__PURE__*/require("./constants");
|
|
19
15
|
* @param options - Configures the style of the focus outline
|
20
16
|
* @returns focus outline styles object
|
21
17
|
*/
|
22
|
-
|
23
|
-
|
24
18
|
const getFocusOutlineStyles = options => {
|
25
19
|
var _a, _b, _c, _d;
|
26
|
-
|
27
20
|
const {
|
28
21
|
outlineRadius,
|
29
22
|
outlineColor,
|
@@ -34,7 +27,8 @@ const getFocusOutlineStyles = options => {
|
|
34
27
|
const outlineOffsetBottom = ((_b = outlineOffset) === null || _b === void 0 ? void 0 : _b.bottom) || outlineOffset;
|
35
28
|
const outlineOffsetLeft = ((_c = outlineOffset) === null || _c === void 0 ? void 0 : _c.left) || outlineOffset;
|
36
29
|
const outlineOffsetRight = ((_d = outlineOffset) === null || _d === void 0 ? void 0 : _d.right) || outlineOffset;
|
37
|
-
return {
|
30
|
+
return {
|
31
|
+
...react_1.shorthands.borderColor('transparent'),
|
38
32
|
'::after': {
|
39
33
|
content: '""',
|
40
34
|
position: 'absolute',
|
@@ -58,8 +52,6 @@ const getFocusOutlineStyles = options => {
|
|
58
52
|
* @param options - Configure the style of the focus outline
|
59
53
|
* @returns focus outline styles object for @see makeStyles
|
60
54
|
*/
|
61
|
-
|
62
|
-
|
63
55
|
const createFocusOutlineStyle = ({
|
64
56
|
selector = constants_1.defaultOptions.selector,
|
65
57
|
style = constants_1.defaultOptions.style
|
@@ -72,6 +64,5 @@ const createFocusOutlineStyle = ({
|
|
72
64
|
}), {
|
73
65
|
selector
|
74
66
|
});
|
75
|
-
|
76
67
|
exports.createFocusOutlineStyle = createFocusOutlineStyle;
|
77
68
|
//# sourceMappingURL=createFocusOutlineStyle.js.map
|
@@ -1 +1 @@
|
|
1
|
-
{"version":3,"
|
1
|
+
{"version":3,"mappings":";;;;;;AAAA;AACA;AAEA;AAIA;AAiBA;;;;;;;AAOA,MAAMA,qBAAqB,GAAIC,OAAiC,IAAkB;;EAChF,MAAM;IAAEC,aAAa;IAAEC,YAAY;IAAEC,aAAa;IAAEC;EAAY,CAAE,GAAGJ,OAAO;EAE5E,MAAMK,gBAAgB,GAAG,OAACF,aAAoC,0CAAEG,GAAG,KAAIH,aAAa;EACpF,MAAMI,mBAAmB,GAAG,OAACJ,aAAoC,0CAAEK,MAAM,KAAIL,aAAa;EAC1F,MAAMM,iBAAiB,GAAG,OAACN,aAAoC,0CAAEO,IAAI,KAAIP,aAAa;EACtF,MAAMQ,kBAAkB,GAAG,OAACR,aAAoC,0CAAES,KAAK,KAAIT,aAAa;EAExF,OAAO;IACL,GAAGU,kBAAU,CAACC,WAAW,CAAC,aAAa,CAAC;IACxC,SAAS,EAAE;MACTC,OAAO,EAAE,IAAI;MACbC,QAAQ,EAAE,UAAU;MACpBC,aAAa,EAAE,MAAM;MACrBC,MAAM,EAAE,CAAC;MAET,GAAGL,kBAAU,CAACM,WAAW,CAAC,OAAO,CAAC;MAClC,GAAGN,kBAAU,CAACO,WAAW,CAAChB,YAAY,CAAC;MACvC,GAAGS,kBAAU,CAACQ,YAAY,CAACpB,aAAa,CAAC;MACzC,GAAGY,kBAAU,CAACC,WAAW,CAACZ,YAAY,CAAC;MAEvCI,GAAG,EAAE,CAACH,aAAa,GAAG,IAAIC,YAAY,EAAE,GAAG,cAAcA,YAAY,MAAMC,gBAAgB,GAAG;MAC9FG,MAAM,EAAE,CAACL,aAAa,GAAG,IAAIC,YAAY,EAAE,GAAG,cAAcA,YAAY,MAAMG,mBAAmB,GAAG;MACpGG,IAAI,EAAE,CAACP,aAAa,GAAG,IAAIC,YAAY,EAAE,GAAG,cAAcA,YAAY,MAAMK,iBAAiB,GAAG;MAChGG,KAAK,EAAE,CAACT,aAAa,GAAG,IAAIC,YAAY,EAAE,GAAG,cAAcA,YAAY,MAAMO,kBAAkB;;GAElG;AACH,CAAC;AAED;;;;;;;AAOO,MAAMW,uBAAuB,GAAG,CAAC;EACtCC,QAAQ,GAAGC,0BAAc,CAACD,QAAQ;EAClCE,KAAK,GAAGD,0BAAc,CAACC;AAAK,IACMD,0BAAc,KAChDE,iEAA+B,CAC7B3B,qBAAqB,CAAC;EACpBG,YAAY,EAAEyB,oBAAM,CAACC,iBAAiB;EACtC3B,aAAa,EAAE0B,oBAAM,CAACE,kBAAkB;EACxC;EACAzB,YAAY,EAAE,KAAK;EACnB,GAAGqB;CACJ,CAAC,EACF;EAAEF;AAAQ,CAAE,CACb;AAbUO,+BAAuB","names":["getFocusOutlineStyles","options","outlineRadius","outlineColor","outlineOffset","outlineWidth","outlineOffsetTop","top","outlineOffsetBottom","bottom","outlineOffsetLeft","left","outlineOffsetRight","right","react_1","borderColor","content","position","pointerEvents","zIndex","borderStyle","borderWidth","borderRadius","createFocusOutlineStyle","selector","constants_1","style","createCustomFocusIndicatorStyle_1","react_theme_1","colorStrokeFocus2","borderRadiusMedium","exports"],"sourceRoot":"../src/","sources":["packages/react-components/react-tabster/src/focus/createFocusOutlineStyle.ts"],"sourcesContent":["import { tokens } from '@fluentui/react-theme';\nimport { shorthands } from '@griffel/react';\nimport type { GriffelStyle } from '@griffel/react';\nimport {\n createCustomFocusIndicatorStyle,\n CreateCustomFocusIndicatorStyleOptions,\n} from './createCustomFocusIndicatorStyle';\nimport { defaultOptions } from './constants';\n\nexport type FocusOutlineOffset = Record<'top' | 'bottom' | 'left' | 'right', string>;\nexport type FocusOutlineStyleOptions = {\n /**\n * Only property not supported by the native CSS `outline`, if this is no longer needed\n * we can just go native instead\n */\n outlineRadius: string;\n outlineColor: string;\n outlineWidth: string;\n outlineOffset?: string | FocusOutlineOffset;\n};\nexport interface CreateFocusOutlineStyleOptions extends CreateCustomFocusIndicatorStyleOptions {\n style?: Partial<FocusOutlineStyleOptions>;\n}\n\n/**\n * NOTE: the element with the focus outline needs to have `position: relative` so that the\n * pseudo element can be properly positioned.\n *\n * @param options - Configures the style of the focus outline\n * @returns focus outline styles object\n */\nconst getFocusOutlineStyles = (options: FocusOutlineStyleOptions): GriffelStyle => {\n const { outlineRadius, outlineColor, outlineOffset, outlineWidth } = options;\n\n const outlineOffsetTop = (outlineOffset as FocusOutlineOffset)?.top || outlineOffset;\n const outlineOffsetBottom = (outlineOffset as FocusOutlineOffset)?.bottom || outlineOffset;\n const outlineOffsetLeft = (outlineOffset as FocusOutlineOffset)?.left || outlineOffset;\n const outlineOffsetRight = (outlineOffset as FocusOutlineOffset)?.right || outlineOffset;\n\n return {\n ...shorthands.borderColor('transparent'),\n '::after': {\n content: '\"\"',\n position: 'absolute',\n pointerEvents: 'none',\n zIndex: 1,\n\n ...shorthands.borderStyle('solid'),\n ...shorthands.borderWidth(outlineWidth),\n ...shorthands.borderRadius(outlineRadius),\n ...shorthands.borderColor(outlineColor),\n\n top: !outlineOffset ? `-${outlineWidth}` : `calc(0px - ${outlineWidth} - ${outlineOffsetTop})`,\n bottom: !outlineOffset ? `-${outlineWidth}` : `calc(0px - ${outlineWidth} - ${outlineOffsetBottom})`,\n left: !outlineOffset ? `-${outlineWidth}` : `calc(0px - ${outlineWidth} - ${outlineOffsetLeft})`,\n right: !outlineOffset ? `-${outlineWidth}` : `calc(0px - ${outlineWidth} - ${outlineOffsetRight})`,\n },\n };\n};\n\n/**\n * NOTE: The element with the focus outline needs to have `position: relative` so that the\n * pseudo element can be properly positioned.\n *\n * @param options - Configure the style of the focus outline\n * @returns focus outline styles object for @see makeStyles\n */\nexport const createFocusOutlineStyle = ({\n selector = defaultOptions.selector,\n style = defaultOptions.style,\n}: CreateFocusOutlineStyleOptions = defaultOptions): GriffelStyle =>\n createCustomFocusIndicatorStyle(\n getFocusOutlineStyles({\n outlineColor: tokens.colorStrokeFocus2,\n outlineRadius: tokens.borderRadiusMedium,\n // FIXME: tokens.strokeWidthThick causes some weird bugs\n outlineWidth: '2px',\n ...style,\n }),\n { selector },\n );\n"]}
|
@@ -4,50 +4,43 @@ Object.defineProperty(exports, "__esModule", {
|
|
4
4
|
value: true
|
5
5
|
});
|
6
6
|
exports.applyFocusVisiblePolyfill = void 0;
|
7
|
-
|
8
7
|
const keyborg_1 = /*#__PURE__*/require("keyborg");
|
9
|
-
|
10
8
|
const constants_1 = /*#__PURE__*/require("./constants");
|
11
9
|
/**
|
12
10
|
* @internal
|
13
11
|
* @param scope - Applies the ponyfill to all DOM children
|
14
12
|
* @param win - window
|
15
13
|
*/
|
16
|
-
|
17
|
-
|
18
14
|
function applyFocusVisiblePolyfill(scope, win) {
|
19
15
|
if (alreadyInScope(scope)) {
|
20
16
|
// Focus visible polyfill already applied at this scope
|
21
17
|
return () => undefined;
|
22
18
|
}
|
23
|
-
|
24
19
|
const state = {
|
25
20
|
current: undefined
|
26
21
|
};
|
27
|
-
const keyborg = keyborg_1.createKeyborg(win);
|
28
|
-
|
22
|
+
const keyborg = keyborg_1.createKeyborg(win);
|
23
|
+
// When navigation mode changes remove the focus-visible selector
|
29
24
|
keyborg.subscribe(isNavigatingWithKeyboard => {
|
30
25
|
if (!isNavigatingWithKeyboard && state.current) {
|
31
26
|
removeFocusVisibleClass(state.current);
|
32
27
|
state.current = undefined;
|
33
28
|
}
|
34
|
-
});
|
29
|
+
});
|
30
|
+
// Keyborg's focusin event is delegated so it's only registered once on the window
|
35
31
|
// and contains metadata about the focus event
|
36
|
-
|
37
32
|
const keyborgListener = e => {
|
38
33
|
if (state.current) {
|
39
34
|
removeFocusVisibleClass(state.current);
|
40
35
|
state.current = undefined;
|
41
36
|
}
|
42
|
-
|
43
37
|
if (keyborg.isNavigatingWithKeyboard() && isHTMLElement(e.target) && e.target) {
|
44
38
|
// Griffel can't create chained global styles so use the parent element for now
|
45
39
|
state.current = e.target;
|
46
40
|
applyFocusVisibleClass(state.current);
|
47
41
|
}
|
48
|
-
};
|
49
|
-
|
50
|
-
|
42
|
+
};
|
43
|
+
// Make sure that when focus leaves the scope, the focus visible class is removed
|
51
44
|
const blurListener = e => {
|
52
45
|
if (!e.relatedTarget || isHTMLElement(e.relatedTarget) && !scope.contains(e.relatedTarget)) {
|
53
46
|
if (state.current) {
|
@@ -56,11 +49,10 @@ function applyFocusVisiblePolyfill(scope, win) {
|
|
56
49
|
}
|
57
50
|
}
|
58
51
|
};
|
59
|
-
|
60
52
|
scope.addEventListener(keyborg_1.KEYBORG_FOCUSIN, keyborgListener);
|
61
53
|
scope.addEventListener('focusout', blurListener);
|
62
|
-
scope.focusVisible = true;
|
63
|
-
|
54
|
+
scope.focusVisible = true;
|
55
|
+
// Return disposer
|
64
56
|
return () => {
|
65
57
|
scope.removeEventListener(keyborg_1.KEYBORG_FOCUSIN, keyborgListener);
|
66
58
|
scope.removeEventListener('focusout', blurListener);
|
@@ -68,34 +60,26 @@ function applyFocusVisiblePolyfill(scope, win) {
|
|
68
60
|
keyborg_1.disposeKeyborg(keyborg);
|
69
61
|
};
|
70
62
|
}
|
71
|
-
|
72
63
|
exports.applyFocusVisiblePolyfill = applyFocusVisiblePolyfill;
|
73
|
-
|
74
64
|
function applyFocusVisibleClass(el) {
|
75
65
|
el.setAttribute(constants_1.FOCUS_VISIBLE_ATTR, '');
|
76
66
|
}
|
77
|
-
|
78
67
|
function removeFocusVisibleClass(el) {
|
79
68
|
el.removeAttribute(constants_1.FOCUS_VISIBLE_ATTR);
|
80
69
|
}
|
81
|
-
|
82
70
|
function isHTMLElement(target) {
|
83
71
|
if (!target) {
|
84
72
|
return false;
|
85
73
|
}
|
86
|
-
|
87
74
|
return Boolean(target && typeof target === 'object' && 'classList' in target && 'contains' in target);
|
88
75
|
}
|
89
|
-
|
90
76
|
function alreadyInScope(el) {
|
91
77
|
if (!el) {
|
92
78
|
return false;
|
93
79
|
}
|
94
|
-
|
95
80
|
if (el.focusVisible) {
|
96
81
|
return true;
|
97
82
|
}
|
98
|
-
|
99
83
|
return alreadyInScope(el === null || el === void 0 ? void 0 : el.parentElement);
|
100
84
|
}
|
101
85
|
//# sourceMappingURL=focusVisiblePolyfill.js.map
|
@@ -1 +1 @@
|
|
1
|
-
{"version":3,"
|
1
|
+
{"version":3,"mappings":";;;;;;AAAA;AACA;AAoBA;;;;;AAKA,SAAgBA,yBAAyB,CAACC,KAAkB,EAAEC,GAAW;EACvE,IAAIC,cAAc,CAACF,KAAK,CAAC,EAAE;IACzB;IACA,OAAO,MAAMG,SAAS;;EAGxB,MAAMC,KAAK,GAAsB;IAC/BC,OAAO,EAAEF;GACV;EAED,MAAMG,OAAO,GAAGC,uBAAa,CAACN,GAAG,CAAC;EAElC;EACAK,OAAO,CAACE,SAAS,CAACC,wBAAwB,IAAG;IAC3C,IAAI,CAACA,wBAAwB,IAAIL,KAAK,CAACC,OAAO,EAAE;MAC9CK,uBAAuB,CAACN,KAAK,CAACC,OAAO,CAAC;MACtCD,KAAK,CAACC,OAAO,GAAGF,SAAS;;EAE7B,CAAC,CAAC;EAEF;EACA;EACA,MAAMQ,eAAe,GAAIC,CAAsB,IAAI;IACjD,IAAIR,KAAK,CAACC,OAAO,EAAE;MACjBK,uBAAuB,CAACN,KAAK,CAACC,OAAO,CAAC;MACtCD,KAAK,CAACC,OAAO,GAAGF,SAAS;;IAG3B,IAAIG,OAAO,CAACG,wBAAwB,EAAE,IAAII,aAAa,CAACD,CAAC,CAACE,MAAM,CAAC,IAAIF,CAAC,CAACE,MAAM,EAAE;MAC7E;MACAV,KAAK,CAACC,OAAO,GAAGO,CAAC,CAACE,MAAM;MACxBC,sBAAsB,CAACX,KAAK,CAACC,OAAO,CAAC;;EAEzC,CAAC;EAED;EACA,MAAMW,YAAY,GAAIJ,CAAa,IAAI;IACrC,IAAI,CAACA,CAAC,CAACK,aAAa,IAAKJ,aAAa,CAACD,CAAC,CAACK,aAAa,CAAC,IAAI,CAACjB,KAAK,CAACkB,QAAQ,CAACN,CAAC,CAACK,aAAa,CAAE,EAAE;MAC5F,IAAIb,KAAK,CAACC,OAAO,EAAE;QACjBK,uBAAuB,CAACN,KAAK,CAACC,OAAO,CAAC;QACtCD,KAAK,CAACC,OAAO,GAAGF,SAAS;;;EAG/B,CAAC;EAEDH,KAAK,CAACmB,gBAAgB,CAACZ,yBAAe,EAAEI,eAAmC,CAAC;EAC5EX,KAAK,CAACmB,gBAAgB,CAAC,UAAU,EAAEH,YAAY,CAAC;EAC/ChB,KAA0C,CAACoB,YAAY,GAAG,IAAI;EAE/D;EACA,OAAO,MAAK;IACVpB,KAAK,CAACqB,mBAAmB,CAACd,yBAAe,EAAEI,eAAmC,CAAC;IAC/EX,KAAK,CAACqB,mBAAmB,CAAC,UAAU,EAAEL,YAAY,CAAC;IACnD,OAAQhB,KAA0C,CAACoB,YAAY;IAC/Db,wBAAc,CAACD,OAAO,CAAC;EACzB,CAAC;AACH;AAxDAgB;AA0DA,SAASP,sBAAsB,CAACQ,EAAe;EAC7CA,EAAE,CAACC,YAAY,CAACC,8BAAkB,EAAE,EAAE,CAAC;AACzC;AAEA,SAASf,uBAAuB,CAACa,EAAe;EAC9CA,EAAE,CAACG,eAAe,CAACD,8BAAkB,CAAC;AACxC;AAEA,SAASZ,aAAa,CAACC,MAA0B;EAC/C,IAAI,CAACA,MAAM,EAAE;IACX,OAAO,KAAK;;EAEd,OAAOa,OAAO,CAACb,MAAM,IAAI,OAAOA,MAAM,KAAK,QAAQ,IAAI,WAAW,IAAIA,MAAM,IAAI,UAAU,IAAIA,MAAM,CAAC;AACvG;AAEA,SAASZ,cAAc,CAACqB,EAAkC;EACxD,IAAI,CAACA,EAAE,EAAE;IACP,OAAO,KAAK;;EAGd,IAAKA,EAAuC,CAACH,YAAY,EAAE;IACzD,OAAO,IAAI;;EAGb,OAAOlB,cAAc,CAACqB,EAAE,aAAFA,EAAE,uBAAFA,EAAE,CAAEK,aAAa,CAAC;AAC1C","names":["applyFocusVisiblePolyfill","scope","win","alreadyInScope","undefined","state","current","keyborg","keyborg_1","subscribe","isNavigatingWithKeyboard","removeFocusVisibleClass","keyborgListener","e","isHTMLElement","target","applyFocusVisibleClass","blurListener","relatedTarget","contains","addEventListener","focusVisible","removeEventListener","exports","el","setAttribute","constants_1","removeAttribute","Boolean","parentElement"],"sourceRoot":"../src/","sources":["packages/react-components/react-tabster/src/focus/focusVisiblePolyfill.ts"],"sourcesContent":["import { KEYBORG_FOCUSIN, KeyborgFocusInEvent, createKeyborg, disposeKeyborg } from 'keyborg';\nimport { FOCUS_VISIBLE_ATTR } from './constants';\n\n/**\n * Because `addEventListener` type override falls back to 2nd definition (evt name is unknown string literal)\n * evt is being typed as a base class of MouseEvent -> `Event`.\n * This type is used to override `listener` calls to make TS happy\n */\ntype ListenerOverride = (evt: Event) => void;\n\ntype FocusVisibleState = {\n /**\n * Current element with focus visible in state\n */\n current: HTMLElement | undefined;\n};\n\ntype HTMLElementWithFocusVisibleScope = {\n focusVisible: boolean | undefined;\n} & HTMLElement;\n\n/**\n * @internal\n * @param scope - Applies the ponyfill to all DOM children\n * @param win - window\n */\nexport function applyFocusVisiblePolyfill(scope: HTMLElement, win: Window): () => void {\n if (alreadyInScope(scope)) {\n // Focus visible polyfill already applied at this scope\n return () => undefined;\n }\n\n const state: FocusVisibleState = {\n current: undefined,\n };\n\n const keyborg = createKeyborg(win);\n\n // When navigation mode changes remove the focus-visible selector\n keyborg.subscribe(isNavigatingWithKeyboard => {\n if (!isNavigatingWithKeyboard && state.current) {\n removeFocusVisibleClass(state.current);\n state.current = undefined;\n }\n });\n\n // Keyborg's focusin event is delegated so it's only registered once on the window\n // and contains metadata about the focus event\n const keyborgListener = (e: KeyborgFocusInEvent) => {\n if (state.current) {\n removeFocusVisibleClass(state.current);\n state.current = undefined;\n }\n\n if (keyborg.isNavigatingWithKeyboard() && isHTMLElement(e.target) && e.target) {\n // Griffel can't create chained global styles so use the parent element for now\n state.current = e.target;\n applyFocusVisibleClass(state.current);\n }\n };\n\n // Make sure that when focus leaves the scope, the focus visible class is removed\n const blurListener = (e: FocusEvent) => {\n if (!e.relatedTarget || (isHTMLElement(e.relatedTarget) && !scope.contains(e.relatedTarget))) {\n if (state.current) {\n removeFocusVisibleClass(state.current);\n state.current = undefined;\n }\n }\n };\n\n scope.addEventListener(KEYBORG_FOCUSIN, keyborgListener as ListenerOverride);\n scope.addEventListener('focusout', blurListener);\n (scope as HTMLElementWithFocusVisibleScope).focusVisible = true;\n\n // Return disposer\n return () => {\n scope.removeEventListener(KEYBORG_FOCUSIN, keyborgListener as ListenerOverride);\n scope.removeEventListener('focusout', blurListener);\n delete (scope as HTMLElementWithFocusVisibleScope).focusVisible;\n disposeKeyborg(keyborg);\n };\n}\n\nfunction applyFocusVisibleClass(el: HTMLElement) {\n el.setAttribute(FOCUS_VISIBLE_ATTR, '');\n}\n\nfunction removeFocusVisibleClass(el: HTMLElement) {\n el.removeAttribute(FOCUS_VISIBLE_ATTR);\n}\n\nfunction isHTMLElement(target: EventTarget | null): target is HTMLElement {\n if (!target) {\n return false;\n }\n return Boolean(target && typeof target === 'object' && 'classList' in target && 'contains' in target);\n}\n\nfunction alreadyInScope(el: HTMLElement | null | undefined): boolean {\n if (!el) {\n return false;\n }\n\n if ((el as HTMLElementWithFocusVisibleScope).focusVisible) {\n return true;\n }\n\n return alreadyInScope(el?.parentElement);\n}\n"]}
|
@@ -4,66 +4,55 @@ Object.defineProperty(exports, "__esModule", {
|
|
4
4
|
value: true
|
5
5
|
});
|
6
6
|
exports.applyFocusWithinPolyfill = void 0;
|
7
|
-
|
8
7
|
const keyborg_1 = /*#__PURE__*/require("keyborg");
|
9
|
-
|
10
8
|
const constants_1 = /*#__PURE__*/require("./constants");
|
11
9
|
/**
|
12
10
|
* A ponyfill that allows `:focus-within` to support visibility based on keyboard/mouse navigation
|
13
11
|
* like `:focus-visible` https://github.com/WICG/focus-visible/issues/151
|
14
12
|
* @returns ref to the element that uses `:focus-within` styles
|
15
13
|
*/
|
16
|
-
|
17
|
-
|
18
14
|
function applyFocusWithinPolyfill(element, win) {
|
19
|
-
const keyborg = keyborg_1.createKeyborg(win);
|
20
|
-
|
15
|
+
const keyborg = keyborg_1.createKeyborg(win);
|
16
|
+
// When navigation mode changes to mouse, remove the focus-within selector
|
21
17
|
keyborg.subscribe(isNavigatingWithKeyboard => {
|
22
18
|
if (!isNavigatingWithKeyboard) {
|
23
19
|
removeFocusWithinClass(element);
|
24
20
|
}
|
25
|
-
});
|
21
|
+
});
|
22
|
+
// Keyborg's focusin event is delegated so it's only registered once on the window
|
26
23
|
// and contains metadata about the focus event
|
27
|
-
|
28
24
|
const keyborgListener = e => {
|
29
25
|
if (keyborg.isNavigatingWithKeyboard() && isHTMLElement(e.target)) {
|
30
26
|
// Griffel can't create chained global styles so use the parent element for now
|
31
27
|
applyFocusWithinClass(element);
|
32
28
|
}
|
33
|
-
};
|
34
|
-
|
35
|
-
|
29
|
+
};
|
30
|
+
// Make sure that when focus leaves the scope, the focus within class is removed
|
36
31
|
const blurListener = e => {
|
37
32
|
if (!e.relatedTarget || isHTMLElement(e.relatedTarget) && !element.contains(e.relatedTarget)) {
|
38
33
|
removeFocusWithinClass(element);
|
39
34
|
}
|
40
35
|
};
|
41
|
-
|
42
36
|
element.addEventListener(keyborg_1.KEYBORG_FOCUSIN, keyborgListener);
|
43
|
-
element.addEventListener('focusout', blurListener);
|
44
|
-
|
37
|
+
element.addEventListener('focusout', blurListener);
|
38
|
+
// Return disposer
|
45
39
|
return () => {
|
46
40
|
element.removeEventListener(keyborg_1.KEYBORG_FOCUSIN, keyborgListener);
|
47
41
|
element.removeEventListener('focusout', blurListener);
|
48
42
|
keyborg_1.disposeKeyborg(keyborg);
|
49
43
|
};
|
50
44
|
}
|
51
|
-
|
52
45
|
exports.applyFocusWithinPolyfill = applyFocusWithinPolyfill;
|
53
|
-
|
54
46
|
function applyFocusWithinClass(el) {
|
55
47
|
el.setAttribute(constants_1.FOCUS_WITHIN_ATTR, '');
|
56
48
|
}
|
57
|
-
|
58
49
|
function removeFocusWithinClass(el) {
|
59
50
|
el.removeAttribute(constants_1.FOCUS_WITHIN_ATTR);
|
60
51
|
}
|
61
|
-
|
62
52
|
function isHTMLElement(target) {
|
63
53
|
if (!target) {
|
64
54
|
return false;
|
65
55
|
}
|
66
|
-
|
67
56
|
return Boolean(target && typeof target === 'object' && 'classList' in target && 'contains' in target);
|
68
57
|
}
|
69
58
|
//# sourceMappingURL=focusWithinPolyfill.js.map
|