@fluentui/react-card 0.0.0-nightly-20230502-0418.1 → 0.0.0-nightly-20230504-0417.1
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 +17 -17
- package/CHANGELOG.md +11 -11
- package/dist/index.d.ts +389 -0
- package/lib/Card.js +2 -0
- package/lib/Card.js.map +1 -0
- package/lib/CardFooter.js +2 -0
- package/lib/CardFooter.js.map +1 -0
- package/lib/CardHeader.js +2 -0
- package/lib/CardHeader.js.map +1 -0
- package/lib/CardPreview.js +2 -0
- package/lib/CardPreview.js.map +1 -0
- package/lib/components/Card/Card.js +16 -0
- package/lib/components/Card/Card.js.map +1 -0
- package/lib/components/Card/Card.types.js +2 -0
- package/lib/components/Card/Card.types.js.map +1 -0
- package/lib/components/Card/CardContext.js +25 -0
- package/lib/components/Card/CardContext.js.map +1 -0
- package/lib/components/Card/index.js +7 -0
- package/lib/components/Card/index.js.map +1 -0
- package/lib/components/Card/renderCard.js +16 -0
- package/lib/components/Card/renderCard.js.map +1 -0
- package/lib/components/Card/useCard.js +101 -0
- package/lib/components/Card/useCard.js.map +1 -0
- package/lib/components/Card/useCardContextValue.js +8 -0
- package/lib/components/Card/useCardContextValue.js.map +1 -0
- package/lib/components/Card/useCardSelectable.js +116 -0
- package/lib/components/Card/useCardSelectable.js.map +1 -0
- package/lib/components/Card/useCardStyles.styles.js +395 -0
- package/lib/components/Card/useCardStyles.styles.js.map +1 -0
- package/lib/components/CardFooter/CardFooter.js +14 -0
- package/lib/components/CardFooter/CardFooter.js.map +1 -0
- package/lib/components/CardFooter/CardFooter.types.js +2 -0
- package/lib/components/CardFooter/CardFooter.types.js.map +1 -0
- package/lib/components/CardFooter/index.js +6 -0
- package/lib/components/CardFooter/index.js.map +1 -0
- package/lib/components/CardFooter/renderCardFooter.js +13 -0
- package/lib/components/CardFooter/renderCardFooter.js.map +1 -0
- package/lib/components/CardFooter/useCardFooter.js +28 -0
- package/lib/components/CardFooter/useCardFooter.js.map +1 -0
- package/lib/components/CardFooter/useCardFooterStyles.styles.js +33 -0
- package/lib/components/CardFooter/useCardFooterStyles.styles.js.map +1 -0
- package/lib/components/CardHeader/CardHeader.js +14 -0
- package/lib/components/CardHeader/CardHeader.js.map +1 -0
- package/lib/components/CardHeader/CardHeader.types.js +2 -0
- package/lib/components/CardHeader/CardHeader.types.js.map +1 -0
- package/lib/components/CardHeader/index.js +6 -0
- package/lib/components/CardHeader/index.js.map +1 -0
- package/lib/components/CardHeader/renderCardHeader.js +13 -0
- package/lib/components/CardHeader/renderCardHeader.js.map +1 -0
- package/lib/components/CardHeader/useCardHeader.js +61 -0
- package/lib/components/CardHeader/useCardHeader.js.map +1 -0
- package/lib/components/CardHeader/useCardHeaderStyles.styles.js +68 -0
- package/lib/components/CardHeader/useCardHeaderStyles.styles.js.map +1 -0
- package/lib/components/CardPreview/CardPreview.js +14 -0
- package/lib/components/CardPreview/CardPreview.js.map +1 -0
- package/lib/components/CardPreview/CardPreview.types.js +2 -0
- package/lib/components/CardPreview/CardPreview.types.js.map +1 -0
- package/lib/components/CardPreview/index.js +6 -0
- package/lib/components/CardPreview/index.js.map +1 -0
- package/lib/components/CardPreview/renderCardPreview.js +13 -0
- package/lib/components/CardPreview/renderCardPreview.js.map +1 -0
- package/lib/components/CardPreview/useCardPreview.js +58 -0
- package/lib/components/CardPreview/useCardPreview.js.map +1 -0
- package/lib/components/CardPreview/useCardPreviewStyles.styles.js +37 -0
- package/lib/components/CardPreview/useCardPreviewStyles.styles.js.map +1 -0
- package/lib/index.js +6 -0
- package/lib/index.js.map +1 -0
- package/package.json +8 -8
- package/.swcrc +0 -30
@@ -0,0 +1,101 @@
|
|
1
|
+
import * as React from 'react';
|
2
|
+
import { getNativeElementProps, useMergedRefs } from '@fluentui/react-utilities';
|
3
|
+
import { useFocusableGroup, useFocusWithin } from '@fluentui/react-tabster';
|
4
|
+
import { useCardSelectable } from './useCardSelectable';
|
5
|
+
import { cardContextDefaultValue } from './CardContext';
|
6
|
+
const focusMap = {
|
7
|
+
off: undefined,
|
8
|
+
'no-tab': 'limited-trap-focus',
|
9
|
+
'tab-exit': 'limited',
|
10
|
+
'tab-only': 'unlimited'
|
11
|
+
};
|
12
|
+
/**
|
13
|
+
* Create the state for interactive cards.
|
14
|
+
*
|
15
|
+
* This internal hook defines if the card is interactive
|
16
|
+
* and control focus properties based on that.
|
17
|
+
*
|
18
|
+
* @param props - props from this instance of Card
|
19
|
+
*/
|
20
|
+
const useCardInteractive = ({
|
21
|
+
focusMode = 'off',
|
22
|
+
...props
|
23
|
+
}) => {
|
24
|
+
const interactive = ['onClick', 'onDoubleClick', 'onMouseUp', 'onMouseDown', 'onPointerUp', 'onPointerDown', 'onTouchStart', 'onTouchEnd', 'onDragStart', 'onDragEnd'].some(prop => props[prop]);
|
25
|
+
const groupperAttrs = useFocusableGroup({
|
26
|
+
tabBehavior: focusMap[interactive ? 'no-tab' : focusMode]
|
27
|
+
});
|
28
|
+
const interactiveFocusAttributes = {
|
29
|
+
...groupperAttrs,
|
30
|
+
tabIndex: 0
|
31
|
+
};
|
32
|
+
return {
|
33
|
+
interactive,
|
34
|
+
focusAttributes: focusMode === 'off' ? null : interactiveFocusAttributes
|
35
|
+
};
|
36
|
+
};
|
37
|
+
/**
|
38
|
+
* Create the state required to render Card.
|
39
|
+
*
|
40
|
+
* The returned state can be modified with hooks such as useCardStyles_unstable,
|
41
|
+
* before being passed to renderCard_unstable.
|
42
|
+
*
|
43
|
+
* @param props - props from this instance of Card
|
44
|
+
* @param ref - reference to the root element of Card
|
45
|
+
*/
|
46
|
+
export const useCard_unstable = (props, ref) => {
|
47
|
+
const {
|
48
|
+
appearance = 'filled',
|
49
|
+
orientation = 'vertical',
|
50
|
+
size = 'medium'
|
51
|
+
} = props;
|
52
|
+
const [referenceId, setReferenceId] = React.useState(cardContextDefaultValue.selectableA11yProps.referenceId);
|
53
|
+
const [referenceLabel, setReferenceLabel] = React.useState(cardContextDefaultValue.selectableA11yProps.referenceId);
|
54
|
+
const cardBaseRef = useFocusWithin();
|
55
|
+
const {
|
56
|
+
selectable,
|
57
|
+
selected,
|
58
|
+
selectableCardProps,
|
59
|
+
selectFocused,
|
60
|
+
checkboxSlot,
|
61
|
+
floatingActionSlot
|
62
|
+
} = useCardSelectable(props, {
|
63
|
+
referenceId,
|
64
|
+
referenceLabel
|
65
|
+
}, cardBaseRef);
|
66
|
+
const cardRef = useMergedRefs(cardBaseRef, ref);
|
67
|
+
const {
|
68
|
+
interactive,
|
69
|
+
focusAttributes
|
70
|
+
} = useCardInteractive(props);
|
71
|
+
return {
|
72
|
+
appearance,
|
73
|
+
orientation,
|
74
|
+
size,
|
75
|
+
interactive,
|
76
|
+
selectable,
|
77
|
+
selectFocused,
|
78
|
+
selected,
|
79
|
+
selectableA11yProps: {
|
80
|
+
setReferenceId,
|
81
|
+
referenceId,
|
82
|
+
referenceLabel,
|
83
|
+
setReferenceLabel
|
84
|
+
},
|
85
|
+
components: {
|
86
|
+
root: 'div',
|
87
|
+
floatingAction: 'div',
|
88
|
+
checkbox: 'input'
|
89
|
+
},
|
90
|
+
root: getNativeElementProps('div', {
|
91
|
+
ref: cardRef,
|
92
|
+
role: 'group',
|
93
|
+
...focusAttributes,
|
94
|
+
...props,
|
95
|
+
...selectableCardProps
|
96
|
+
}),
|
97
|
+
floatingAction: floatingActionSlot,
|
98
|
+
checkbox: checkboxSlot
|
99
|
+
};
|
100
|
+
};
|
101
|
+
//# sourceMappingURL=useCard.js.map
|
@@ -0,0 +1 @@
|
|
1
|
+
{"version":3,"names":["React","getNativeElementProps","useMergedRefs","useFocusableGroup","useFocusWithin","useCardSelectable","cardContextDefaultValue","focusMap","off","undefined","useCardInteractive","focusMode","props","interactive","some","prop","groupperAttrs","tabBehavior","interactiveFocusAttributes","tabIndex","focusAttributes","useCard_unstable","ref","appearance","orientation","size","referenceId","setReferenceId","useState","selectableA11yProps","referenceLabel","setReferenceLabel","cardBaseRef","selectable","selected","selectableCardProps","selectFocused","checkboxSlot","floatingActionSlot","cardRef","components","root","floatingAction","checkbox","role"],"sources":["../../../src/components/Card/useCard.ts"],"sourcesContent":["import * as React from 'react';\nimport { getNativeElementProps, useMergedRefs } from '@fluentui/react-utilities';\nimport { useFocusableGroup, useFocusWithin } from '@fluentui/react-tabster';\n\nimport type { CardProps, CardState } from './Card.types';\nimport { useCardSelectable } from './useCardSelectable';\nimport { cardContextDefaultValue } from './CardContext';\n\nconst focusMap = {\n off: undefined,\n 'no-tab': 'limited-trap-focus',\n 'tab-exit': 'limited',\n 'tab-only': 'unlimited',\n} as const;\n\n/**\n * Create the state for interactive cards.\n *\n * This internal hook defines if the card is interactive\n * and control focus properties based on that.\n *\n * @param props - props from this instance of Card\n */\nconst useCardInteractive = ({ focusMode = 'off', ...props }: CardProps) => {\n const interactive = (\n [\n 'onClick',\n 'onDoubleClick',\n 'onMouseUp',\n 'onMouseDown',\n 'onPointerUp',\n 'onPointerDown',\n 'onTouchStart',\n 'onTouchEnd',\n 'onDragStart',\n 'onDragEnd',\n ] as (keyof React.HTMLAttributes<HTMLElement>)[]\n ).some(prop => props[prop]);\n\n const groupperAttrs = useFocusableGroup({\n tabBehavior: focusMap[interactive ? 'no-tab' : focusMode],\n });\n\n const interactiveFocusAttributes = {\n ...groupperAttrs,\n tabIndex: 0,\n };\n\n return {\n interactive,\n focusAttributes: focusMode === 'off' ? null : interactiveFocusAttributes,\n };\n};\n\n/**\n * Create the state required to render Card.\n *\n * The returned state can be modified with hooks such as useCardStyles_unstable,\n * before being passed to renderCard_unstable.\n *\n * @param props - props from this instance of Card\n * @param ref - reference to the root element of Card\n */\nexport const useCard_unstable = (props: CardProps, ref: React.Ref<HTMLDivElement>): CardState => {\n const { appearance = 'filled', orientation = 'vertical', size = 'medium' } = props;\n\n const [referenceId, setReferenceId] = React.useState(cardContextDefaultValue.selectableA11yProps.referenceId);\n const [referenceLabel, setReferenceLabel] = React.useState(cardContextDefaultValue.selectableA11yProps.referenceId);\n\n const cardBaseRef = useFocusWithin<HTMLDivElement>();\n const { selectable, selected, selectableCardProps, selectFocused, checkboxSlot, floatingActionSlot } =\n useCardSelectable(props, { referenceId, referenceLabel }, cardBaseRef);\n\n const cardRef = useMergedRefs(cardBaseRef, ref);\n\n const { interactive, focusAttributes } = useCardInteractive(props);\n\n return {\n appearance,\n orientation,\n size,\n interactive,\n selectable,\n selectFocused,\n selected,\n selectableA11yProps: {\n setReferenceId,\n referenceId,\n referenceLabel,\n setReferenceLabel,\n },\n\n components: {\n root: 'div',\n floatingAction: 'div',\n checkbox: 'input',\n },\n\n root: getNativeElementProps('div', {\n ref: cardRef,\n role: 'group',\n ...focusAttributes,\n ...props,\n ...selectableCardProps,\n }),\n\n floatingAction: floatingActionSlot,\n checkbox: checkboxSlot,\n };\n};\n"],"mappings":"AAAA,YAAYA,KAAA,MAAW;AACvB,SAASC,qBAAqB,EAAEC,aAAa,QAAQ;AACrD,SAASC,iBAAiB,EAAEC,cAAc,QAAQ;AAGlD,SAASC,iBAAiB,QAAQ;AAClC,SAASC,uBAAuB,QAAQ;AAExC,MAAMC,QAAA,GAAW;EACfC,GAAA,EAAKC,SAAA;EACL,UAAU;EACV,YAAY;EACZ,YAAY;AACd;AAEA;;;;;;;;AAQA,MAAMC,kBAAA,GAAqBA,CAAC;EAAEC,SAAA,GAAY;EAAO,GAAGC;AAAA,CAAkB,KAAK;EACzE,MAAMC,WAAA,GAAc,CAEhB,WACA,iBACA,aACA,eACA,eACA,iBACA,gBACA,cACA,eACA,YACD,CACDC,IAAI,CAACC,IAAA,IAAQH,KAAK,CAACG,IAAA,CAAK;EAE1B,MAAMC,aAAA,GAAgBb,iBAAA,CAAkB;IACtCc,WAAA,EAAaV,QAAQ,CAACM,WAAA,GAAc,WAAWF,SAAS;EAC1D;EAEA,MAAMO,0BAAA,GAA6B;IACjC,GAAGF,aAAa;IAChBG,QAAA,EAAU;EACZ;EAEA,OAAO;IACLN,WAAA;IACAO,eAAA,EAAiBT,SAAA,KAAc,QAAQ,IAAI,GAAGO;EAChD;AACF;AAEA;;;;;;;;;AASA,OAAO,MAAMG,gBAAA,GAAmBA,CAACT,KAAA,EAAkBU,GAAA,KAA8C;EAC/F,MAAM;IAAEC,UAAA,GAAa;IAAUC,WAAA,GAAc;IAAYC,IAAA,GAAO;EAAQ,CAAE,GAAGb,KAAA;EAE7E,MAAM,CAACc,WAAA,EAAaC,cAAA,CAAe,GAAG3B,KAAA,CAAM4B,QAAQ,CAACtB,uBAAA,CAAwBuB,mBAAmB,CAACH,WAAW;EAC5G,MAAM,CAACI,cAAA,EAAgBC,iBAAA,CAAkB,GAAG/B,KAAA,CAAM4B,QAAQ,CAACtB,uBAAA,CAAwBuB,mBAAmB,CAACH,WAAW;EAElH,MAAMM,WAAA,GAAc5B,cAAA;EACpB,MAAM;IAAE6B,UAAA;IAAYC,QAAA;IAAUC,mBAAA;IAAqBC,aAAA;IAAeC,YAAA;IAAcC;EAAkB,CAAE,GAClGjC,iBAAA,CAAkBO,KAAA,EAAO;IAAEc,WAAA;IAAaI;EAAe,GAAGE,WAAA;EAE5D,MAAMO,OAAA,GAAUrC,aAAA,CAAc8B,WAAA,EAAaV,GAAA;EAE3C,MAAM;IAAET,WAAA;IAAaO;EAAe,CAAE,GAAGV,kBAAA,CAAmBE,KAAA;EAE5D,OAAO;IACLW,UAAA;IACAC,WAAA;IACAC,IAAA;IACAZ,WAAA;IACAoB,UAAA;IACAG,aAAA;IACAF,QAAA;IACAL,mBAAA,EAAqB;MACnBF,cAAA;MACAD,WAAA;MACAI,cAAA;MACAC;IACF;IAEAS,UAAA,EAAY;MACVC,IAAA,EAAM;MACNC,cAAA,EAAgB;MAChBC,QAAA,EAAU;IACZ;IAEAF,IAAA,EAAMxC,qBAAA,CAAsB,OAAO;MACjCqB,GAAA,EAAKiB,OAAA;MACLK,IAAA,EAAM;MACN,GAAGxB,eAAe;MAClB,GAAGR,KAAK;MACR,GAAGuB;IACL;IAEAO,cAAA,EAAgBJ,kBAAA;IAChBK,QAAA,EAAUN;EACZ;AACF"}
|
@@ -0,0 +1 @@
|
|
1
|
+
{"version":3,"names":["useCardContextValue","selectableA11yProps"],"sources":["../../../src/components/Card/useCardContextValue.ts"],"sourcesContent":["import type { CardContextValue, CardState } from './Card.types';\n\nexport function useCardContextValue({ selectableA11yProps }: CardState): CardContextValue {\n return { selectableA11yProps };\n}\n"],"mappings":"AAEA,OAAO,SAASA,oBAAoB;EAAEC;AAAmB,CAAa,EAAoB;EACxF,OAAO;IAAEA;EAAoB;AAC/B"}
|
@@ -0,0 +1,116 @@
|
|
1
|
+
import * as React from 'react';
|
2
|
+
import { mergeCallbacks, resolveShorthand } from '@fluentui/react-utilities';
|
3
|
+
import { Enter } from '@fluentui/keyboard-keys';
|
4
|
+
import { useFocusFinders } from '@fluentui/react-tabster';
|
5
|
+
/**
|
6
|
+
* @internal
|
7
|
+
*
|
8
|
+
* Create the state related to selectable cards.
|
9
|
+
*
|
10
|
+
* This internal hook controls all the logic for selectable cards and is
|
11
|
+
* intended to be used alongside with useCard_unstable.
|
12
|
+
*
|
13
|
+
* @param props - props from this instance of Card
|
14
|
+
* @param a11yProps - accessibility props shared between elements of the card
|
15
|
+
* @param ref - reference to the root element of Card
|
16
|
+
*/
|
17
|
+
export const useCardSelectable = (props, {
|
18
|
+
referenceLabel,
|
19
|
+
referenceId
|
20
|
+
}, cardRef) => {
|
21
|
+
const {
|
22
|
+
checkbox = {},
|
23
|
+
selected,
|
24
|
+
defaultSelected,
|
25
|
+
onSelectionChange,
|
26
|
+
floatingAction,
|
27
|
+
onClick,
|
28
|
+
onKeyDown
|
29
|
+
} = props;
|
30
|
+
const {
|
31
|
+
findAllFocusable
|
32
|
+
} = useFocusFinders();
|
33
|
+
const checkboxRef = React.useRef(null);
|
34
|
+
const isSelectable = [selected, defaultSelected, onSelectionChange].some(prop => typeof prop !== 'undefined');
|
35
|
+
const [isCardSelected, setIsCardSelected] = React.useState(false);
|
36
|
+
const [isSelectFocused, setIsSelectFocused] = React.useState(false);
|
37
|
+
const shouldRestrictTriggerAction = React.useCallback(event => {
|
38
|
+
if (!cardRef.current) {
|
39
|
+
return false;
|
40
|
+
}
|
41
|
+
const focusableElements = findAllFocusable(cardRef.current);
|
42
|
+
const target = event.target;
|
43
|
+
const isElementInFocusableGroup = focusableElements.some(element => element.contains(target));
|
44
|
+
const isCheckboxSlot = (checkboxRef === null || checkboxRef === void 0 ? void 0 : checkboxRef.current) === target;
|
45
|
+
return isElementInFocusableGroup && !isCheckboxSlot;
|
46
|
+
}, [cardRef, findAllFocusable]);
|
47
|
+
const onChangeHandler = React.useCallback(event => {
|
48
|
+
if (shouldRestrictTriggerAction(event)) {
|
49
|
+
return;
|
50
|
+
}
|
51
|
+
const newCheckedValue = !isCardSelected;
|
52
|
+
setIsCardSelected(newCheckedValue);
|
53
|
+
if (onSelectionChange) {
|
54
|
+
onSelectionChange(event, {
|
55
|
+
selected: newCheckedValue
|
56
|
+
});
|
57
|
+
}
|
58
|
+
}, [onSelectionChange, isCardSelected, shouldRestrictTriggerAction]);
|
59
|
+
const onKeyDownHandler = React.useCallback(event => {
|
60
|
+
if ([Enter].includes(event.key)) {
|
61
|
+
event.preventDefault();
|
62
|
+
onChangeHandler(event);
|
63
|
+
}
|
64
|
+
}, [onChangeHandler]);
|
65
|
+
const checkboxSlot = React.useMemo(() => {
|
66
|
+
if (!isSelectable || floatingAction) {
|
67
|
+
return;
|
68
|
+
}
|
69
|
+
const selectableCheckboxProps = {};
|
70
|
+
if (referenceId) {
|
71
|
+
selectableCheckboxProps['aria-labelledby'] = referenceId;
|
72
|
+
} else if (referenceLabel) {
|
73
|
+
selectableCheckboxProps['aria-label'] = referenceLabel;
|
74
|
+
}
|
75
|
+
return resolveShorthand(checkbox, {
|
76
|
+
defaultProps: {
|
77
|
+
ref: checkboxRef,
|
78
|
+
type: 'checkbox',
|
79
|
+
checked: isCardSelected,
|
80
|
+
onChange: event => onChangeHandler(event),
|
81
|
+
onFocus: () => setIsSelectFocused(true),
|
82
|
+
onBlur: () => setIsSelectFocused(false),
|
83
|
+
...selectableCheckboxProps
|
84
|
+
}
|
85
|
+
});
|
86
|
+
}, [checkbox, floatingAction, isCardSelected, isSelectable, onChangeHandler, referenceId, referenceLabel]);
|
87
|
+
const floatingActionSlot = React.useMemo(() => {
|
88
|
+
if (!floatingAction) {
|
89
|
+
return;
|
90
|
+
}
|
91
|
+
return resolveShorthand(floatingAction, {
|
92
|
+
defaultProps: {
|
93
|
+
ref: checkboxRef
|
94
|
+
}
|
95
|
+
});
|
96
|
+
}, [floatingAction]);
|
97
|
+
const selectableCardProps = React.useMemo(() => {
|
98
|
+
if (!isSelectable) {
|
99
|
+
return null;
|
100
|
+
}
|
101
|
+
return {
|
102
|
+
onClick: mergeCallbacks(onClick, onChangeHandler),
|
103
|
+
onKeyDown: mergeCallbacks(onKeyDown, onKeyDownHandler)
|
104
|
+
};
|
105
|
+
}, [isSelectable, onChangeHandler, onClick, onKeyDown, onKeyDownHandler]);
|
106
|
+
React.useEffect(() => setIsCardSelected(Boolean(defaultSelected !== null && defaultSelected !== void 0 ? defaultSelected : selected)), [defaultSelected, selected, setIsCardSelected]);
|
107
|
+
return {
|
108
|
+
selected: isCardSelected,
|
109
|
+
selectable: isSelectable,
|
110
|
+
selectFocused: isSelectFocused,
|
111
|
+
selectableCardProps,
|
112
|
+
checkboxSlot,
|
113
|
+
floatingActionSlot
|
114
|
+
};
|
115
|
+
};
|
116
|
+
//# sourceMappingURL=useCardSelectable.js.map
|
@@ -0,0 +1 @@
|
|
1
|
+
{"version":3,"names":["React","mergeCallbacks","resolveShorthand","Enter","useFocusFinders","useCardSelectable","props","referenceLabel","referenceId","cardRef","checkbox","selected","defaultSelected","onSelectionChange","floatingAction","onClick","onKeyDown","findAllFocusable","checkboxRef","useRef","isSelectable","some","prop","isCardSelected","setIsCardSelected","useState","isSelectFocused","setIsSelectFocused","shouldRestrictTriggerAction","useCallback","event","current","focusableElements","target","isElementInFocusableGroup","element","contains","isCheckboxSlot","onChangeHandler","newCheckedValue","onKeyDownHandler","includes","key","preventDefault","checkboxSlot","useMemo","selectableCheckboxProps","defaultProps","ref","type","checked","onChange","onFocus","onBlur","floatingActionSlot","selectableCardProps","useEffect","Boolean","selectable","selectFocused"],"sources":["../../../src/components/Card/useCardSelectable.ts"],"sourcesContent":["import * as React from 'react';\nimport { mergeCallbacks, resolveShorthand } from '@fluentui/react-utilities';\nimport { Enter } from '@fluentui/keyboard-keys';\nimport { useFocusFinders } from '@fluentui/react-tabster';\n\nimport type { CardContextValue, CardOnSelectionChangeEvent, CardProps, CardSlots } from './Card.types';\n\n/**\n * @internal\n *\n * Create the state related to selectable cards.\n *\n * This internal hook controls all the logic for selectable cards and is\n * intended to be used alongside with useCard_unstable.\n *\n * @param props - props from this instance of Card\n * @param a11yProps - accessibility props shared between elements of the card\n * @param ref - reference to the root element of Card\n */\nexport const useCardSelectable = (\n props: CardProps,\n { referenceLabel, referenceId }: Pick<CardContextValue['selectableA11yProps'], 'referenceId' | 'referenceLabel'>,\n cardRef: React.RefObject<HTMLDivElement>,\n) => {\n const { checkbox = {}, selected, defaultSelected, onSelectionChange, floatingAction, onClick, onKeyDown } = props;\n\n const { findAllFocusable } = useFocusFinders();\n\n const checkboxRef = React.useRef<HTMLInputElement>(null);\n\n const isSelectable = [selected, defaultSelected, onSelectionChange].some(prop => typeof prop !== 'undefined');\n\n const [isCardSelected, setIsCardSelected] = React.useState(false);\n const [isSelectFocused, setIsSelectFocused] = React.useState(false);\n\n const shouldRestrictTriggerAction = React.useCallback(\n (event: CardOnSelectionChangeEvent) => {\n if (!cardRef.current) {\n return false;\n }\n\n const focusableElements = findAllFocusable(cardRef.current);\n const target = event.target as HTMLElement;\n const isElementInFocusableGroup = focusableElements.some(element => element.contains(target));\n const isCheckboxSlot = checkboxRef?.current === target;\n\n return isElementInFocusableGroup && !isCheckboxSlot;\n },\n [cardRef, findAllFocusable],\n );\n\n const onChangeHandler = React.useCallback(\n (event: CardOnSelectionChangeEvent) => {\n if (shouldRestrictTriggerAction(event)) {\n return;\n }\n\n const newCheckedValue = !isCardSelected;\n\n setIsCardSelected(newCheckedValue);\n\n if (onSelectionChange) {\n onSelectionChange(event, { selected: newCheckedValue });\n }\n },\n [onSelectionChange, isCardSelected, shouldRestrictTriggerAction],\n );\n\n const onKeyDownHandler = React.useCallback(\n (event: React.KeyboardEvent<HTMLElement>) => {\n if ([Enter].includes(event.key)) {\n event.preventDefault();\n onChangeHandler(event);\n }\n },\n [onChangeHandler],\n );\n\n const checkboxSlot = React.useMemo(() => {\n if (!isSelectable || floatingAction) {\n return;\n }\n\n const selectableCheckboxProps: CardSlots['checkbox'] = {};\n\n if (referenceId) {\n selectableCheckboxProps['aria-labelledby'] = referenceId;\n } else if (referenceLabel) {\n selectableCheckboxProps['aria-label'] = referenceLabel;\n }\n\n return resolveShorthand(checkbox, {\n defaultProps: {\n ref: checkboxRef,\n type: 'checkbox',\n checked: isCardSelected,\n onChange: (event: React.ChangeEvent<HTMLInputElement>) => onChangeHandler(event),\n onFocus: () => setIsSelectFocused(true),\n onBlur: () => setIsSelectFocused(false),\n ...selectableCheckboxProps,\n },\n });\n }, [checkbox, floatingAction, isCardSelected, isSelectable, onChangeHandler, referenceId, referenceLabel]);\n\n const floatingActionSlot = React.useMemo(() => {\n if (!floatingAction) {\n return;\n }\n\n return resolveShorthand(floatingAction, {\n defaultProps: {\n ref: checkboxRef,\n },\n });\n }, [floatingAction]);\n\n const selectableCardProps = React.useMemo(() => {\n if (!isSelectable) {\n return null;\n }\n\n return {\n onClick: mergeCallbacks(onClick, onChangeHandler),\n onKeyDown: mergeCallbacks(onKeyDown, onKeyDownHandler),\n };\n }, [isSelectable, onChangeHandler, onClick, onKeyDown, onKeyDownHandler]);\n\n React.useEffect(\n () => setIsCardSelected(Boolean(defaultSelected ?? selected)),\n [defaultSelected, selected, setIsCardSelected],\n );\n\n return {\n selected: isCardSelected,\n selectable: isSelectable,\n selectFocused: isSelectFocused,\n selectableCardProps,\n checkboxSlot,\n floatingActionSlot,\n };\n};\n"],"mappings":"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"}
|