@manakind/ui-core 0.40.0 → 0.41.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/dist/radio-group/radio-group.css +6 -0
- package/dist/radio-group/radio-group.d.ts +7 -1
- package/dist/radio-group/radio-group.d.ts.map +1 -1
- package/dist/radio-group/radio-group.js +3 -2
- package/dist/radio-group/radio-group.js.map +1 -1
- package/dist/segment-group/segment-group.css +20 -0
- package/package.json +1 -1
|
@@ -32,6 +32,12 @@
|
|
|
32
32
|
}
|
|
33
33
|
}
|
|
34
34
|
|
|
35
|
+
/* A Field's hint, as a Field's sits between its label and its control. */
|
|
36
|
+
& .ds-radio-group__hint {
|
|
37
|
+
color: var(--ds-field-hint-text);
|
|
38
|
+
font-size: var(--ds-field-hint-font-size);
|
|
39
|
+
}
|
|
40
|
+
|
|
35
41
|
/* The hint text of a Field: a choice's description reads as the hint under a label. */
|
|
36
42
|
& .ds-radio-group__description {
|
|
37
43
|
grid-column: 2;
|
|
@@ -48,6 +48,12 @@ type RadioGroupName = {
|
|
|
48
48
|
export type RadioGroupProps = RadioGroupName & {
|
|
49
49
|
/** The choices, in order. */
|
|
50
50
|
items: RadioGroupItem[];
|
|
51
|
+
/**
|
|
52
|
+
* A sentence about the whole choice, between the label and the choices in
|
|
53
|
+
* a Field's hint text, as a Field's hint sits between its label and its
|
|
54
|
+
* control. It is the group's accessible description.
|
|
55
|
+
*/
|
|
56
|
+
hint?: ReactNode;
|
|
51
57
|
/**
|
|
52
58
|
* `list` (default) sets a radio beside each label, one under the other.
|
|
53
59
|
* `cards` sets each choice on a card, its `visual` above its label, in a
|
|
@@ -126,6 +132,6 @@ export type RadioGroupProps = RadioGroupName & {
|
|
|
126
132
|
* A few short choices that switch a view are a `SegmentGroup`; a long list
|
|
127
133
|
* is a `Select`.
|
|
128
134
|
*/
|
|
129
|
-
export declare function RadioGroup({ label, items, value, defaultValue, onValueChange, disabled, name, appearance, className, 'aria-label': ariaLabel, }: RadioGroupProps): import("react/jsx-runtime").JSX.Element;
|
|
135
|
+
export declare function RadioGroup({ label, items, hint, value, defaultValue, onValueChange, disabled, name, appearance, className, 'aria-label': ariaLabel, }: RadioGroupProps): import("react/jsx-runtime").JSX.Element;
|
|
130
136
|
export {};
|
|
131
137
|
//# sourceMappingURL=radio-group.d.ts.map
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"radio-group.d.ts","sourceRoot":"","sources":["../../src/radio-group/radio-group.tsx"],"names":[],"mappings":"AACA,OAAO,EAAE,KAAK,SAAS,EAAiB,MAAM,OAAO,CAAC;AACtD,OAAO,mBAAmB,CAAC;AAI3B,MAAM,WAAW,cAAc;IAC7B,0EAA0E;IAC1E,KAAK,EAAE,MAAM,CAAC;IACd,gEAAgE;IAChE,KAAK,EAAE,MAAM,CAAC;IACd;;;;;;OAMG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,4DAA4D;IAC5D,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB;;;;OAIG;IACH,MAAM,CAAC,EAAE,SAAS,CAAC;CACpB;AAED;;;;GAIG;AACH,MAAM,MAAM,oBAAoB,GAAG,MAAM,GAAG,OAAO,GAAG,OAAO,CAAC;AAE9D;;;GAGG;AACH,KAAK,cAAc,GACf;IACE,0DAA0D;IAC1D,KAAK,EAAE,SAAS,CAAC;IACjB;;;OAGG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB,GACD;IACE,KAAK,CAAC,EAAE,SAAS,CAAC;IAClB,mGAAmG;IACnG,YAAY,EAAE,MAAM,CAAC;CACtB,CAAC;AAEN,MAAM,MAAM,eAAe,GAAG,cAAc,GAAG;IAC7C,6BAA6B;IAC7B,KAAK,EAAE,cAAc,EAAE,CAAC;IACxB;;;;;;;;OAQG;IACH,UAAU,CAAC,EAAE,oBAAoB,CAAC;IAClC;;;OAGG;IACH,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,uCAAuC;IACvC,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,qFAAqF;IACrF,aAAa,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IACxC,uEAAuE;IACvE,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,mEAAmE;IACnE,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,yDAAyD;IACzD,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmDG;AACH,wBAAgB,UAAU,CAAC,EACzB,KAAK,EACL,KAAK,EACL,KAAK,EACL,YAAY,EACZ,aAAa,EACb,QAAQ,EACR,IAAI,EACJ,UAAmB,EACnB,SAAS,EACT,YAAY,EAAE,SAAS,GACxB,EAAE,eAAe,
|
|
1
|
+
{"version":3,"file":"radio-group.d.ts","sourceRoot":"","sources":["../../src/radio-group/radio-group.tsx"],"names":[],"mappings":"AACA,OAAO,EAAE,KAAK,SAAS,EAAiB,MAAM,OAAO,CAAC;AACtD,OAAO,mBAAmB,CAAC;AAI3B,MAAM,WAAW,cAAc;IAC7B,0EAA0E;IAC1E,KAAK,EAAE,MAAM,CAAC;IACd,gEAAgE;IAChE,KAAK,EAAE,MAAM,CAAC;IACd;;;;;;OAMG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,4DAA4D;IAC5D,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB;;;;OAIG;IACH,MAAM,CAAC,EAAE,SAAS,CAAC;CACpB;AAED;;;;GAIG;AACH,MAAM,MAAM,oBAAoB,GAAG,MAAM,GAAG,OAAO,GAAG,OAAO,CAAC;AAE9D;;;GAGG;AACH,KAAK,cAAc,GACf;IACE,0DAA0D;IAC1D,KAAK,EAAE,SAAS,CAAC;IACjB;;;OAGG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB,GACD;IACE,KAAK,CAAC,EAAE,SAAS,CAAC;IAClB,mGAAmG;IACnG,YAAY,EAAE,MAAM,CAAC;CACtB,CAAC;AAEN,MAAM,MAAM,eAAe,GAAG,cAAc,GAAG;IAC7C,6BAA6B;IAC7B,KAAK,EAAE,cAAc,EAAE,CAAC;IACxB;;;;OAIG;IACH,IAAI,CAAC,EAAE,SAAS,CAAC;IACjB;;;;;;;;OAQG;IACH,UAAU,CAAC,EAAE,oBAAoB,CAAC;IAClC;;;OAGG;IACH,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,uCAAuC;IACvC,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,qFAAqF;IACrF,aAAa,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IACxC,uEAAuE;IACvE,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,mEAAmE;IACnE,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,yDAAyD;IACzD,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmDG;AACH,wBAAgB,UAAU,CAAC,EACzB,KAAK,EACL,KAAK,EACL,IAAI,EACJ,KAAK,EACL,YAAY,EACZ,aAAa,EACb,QAAQ,EACR,IAAI,EACJ,UAAmB,EACnB,SAAS,EACT,YAAY,EAAE,SAAS,GACxB,EAAE,eAAe,2CA4EjB"}
|
|
@@ -56,11 +56,12 @@ import { cx } from '../cx';
|
|
|
56
56
|
* A few short choices that switch a view are a `SegmentGroup`; a long list
|
|
57
57
|
* is a `Select`.
|
|
58
58
|
*/
|
|
59
|
-
export function RadioGroup({ label, items, value, defaultValue, onValueChange, disabled, name, appearance = 'list', className, 'aria-label': ariaLabel, }) {
|
|
59
|
+
export function RadioGroup({ label, items, hint, value, defaultValue, onValueChange, disabled, name, appearance = 'list', className, 'aria-label': ariaLabel, }) {
|
|
60
60
|
const cards = appearance === 'cards';
|
|
61
61
|
const list = appearance === 'list';
|
|
62
62
|
const rootRef = useRef(null);
|
|
63
63
|
const descriptionId = useId();
|
|
64
|
+
const hintId = hint ? `${descriptionId}-hint` : undefined;
|
|
64
65
|
const handleValueChange = radioGroupChangeHandler(rootRef, value, onValueChange);
|
|
65
66
|
const visibleLabel = renderVisibleLabel(ArkRadioGroup.Label, {
|
|
66
67
|
label,
|
|
@@ -78,6 +79,6 @@ export function RadioGroup({ label, items, value, defaultValue, onValueChange, d
|
|
|
78
79
|
return (_jsxs(ArkRadioGroup.Item, { value: item.value, disabled: item.disabled, className: "ds-radio-group__item", children: [marker(item), _jsx(ArkRadioGroup.ItemText, { className: "ds-radio-group__text", children: item.label }), describedBy && (_jsx("span", { id: describedBy, className: "ds-radio-group__description", children: item.description })), _jsx(ArkRadioGroup.ItemHiddenInput, { "aria-describedby": describedBy })] }, item.value));
|
|
79
80
|
};
|
|
80
81
|
const choices = list ? (items.map(renderItem)) : (_jsx("div", { className: `ds-radio-group__${appearance}`, children: items.map(renderItem) }));
|
|
81
|
-
return (_jsxs(ArkRadioGroup.Root, { ref: rootRef, className: cx('ds-radio-group', !list && `ds-radio-group--${appearance}`, className), value: value, defaultValue: defaultValue, onValueChange: handleValueChange, disabled: disabled, name: name, orientation: "vertical", "aria-label": ariaLabel, children: [visibleLabel, choices] }));
|
|
82
|
+
return (_jsxs(ArkRadioGroup.Root, { ref: rootRef, className: cx('ds-radio-group', !list && `ds-radio-group--${appearance}`, className), value: value, defaultValue: defaultValue, onValueChange: handleValueChange, disabled: disabled, name: name, orientation: "vertical", "aria-label": ariaLabel, "aria-describedby": hintId, children: [visibleLabel, hint && (_jsx("span", { id: hintId, className: "ds-radio-group__hint", children: hint })), choices] }));
|
|
82
83
|
}
|
|
83
84
|
//# sourceMappingURL=radio-group.js.map
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"radio-group.js","sourceRoot":"","sources":["../../src/radio-group/radio-group.tsx"],"names":[],"mappings":"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","sourcesContent":["import { RadioGroup as ArkRadioGroup } from '@ark-ui/react/radio-group';\nimport { type ReactNode, useId, useRef } from 'react';\nimport './radio-group.css';\nimport { radioGroupChangeHandler, renderVisibleLabel } from '../ark-native-input';\nimport { cx } from '../cx';\n\nexport interface RadioGroupItem {\n /** Stable value reported by `onValueChange` and compared with `value`. */\n value: string;\n /** Text beside the radio. The whole row is its click target. */\n label: string;\n /**\n * A sentence under the label saying what the choice means, in the muted\n * hint text of a Field. The radio's accessible description; its name\n * stays the label alone. A list group shows it; a cards group, which\n * shows `visual` instead, and a chips group, which shows the label\n * alone, ignore it.\n */\n description?: string;\n /** Individually disable this choice without removing it. */\n disabled?: boolean;\n /**\n * A picture of the choice, above its label on a `cards` group: a swatch,\n * a badge, a preview. Decorative: the label names the choice. A `list`\n * or `chips` group ignores it.\n */\n visual?: ReactNode;\n}\n\n/**\n * `list` (default) sets radios one under the other; `cards` sets each choice\n * on a card in a wrapping grid; `chips` sets each choice on a chip in a\n * wrapping row.\n */\nexport type RadioGroupAppearance = 'list' | 'cards' | 'chips';\n\n/**\n * A radio group has to have a name, expressed as a union so an unnamed group\n * is a compile error rather than an axe finding, as `SegmentGroup` does.\n */\ntype RadioGroupName =\n | {\n /** Visible label, above the choices, naming the group. */\n label: ReactNode;\n /**\n * A different accessible name when the visible label alone would not\n * say what the choice is. Keep the visible words in it.\n */\n 'aria-label'?: string;\n }\n | {\n label?: undefined;\n /** Accessible name when a heading or a section title around it already says what the choice is. */\n 'aria-label': string;\n };\n\nexport type RadioGroupProps = RadioGroupName & {\n /** The choices, in order. */\n items: RadioGroupItem[];\n /**\n * `list` (default) sets a radio beside each label, one under the other.\n * `cards` sets each choice on a card, its `visual` above its label, in a\n * grid that fills the width and wraps; the chosen card carries a heavier\n * ring instead of a radio. For choices told apart by how they look, such\n * as colours or themes. `chips` sets each label on a chip, in a row that\n * wraps; the chosen chip fills with the primary's tint instead of a radio.\n * For a few short choices in a form, read at a glance.\n */\n appearance?: RadioGroupAppearance;\n /**\n * Controlled value. `null` is controlled with nothing chosen; `undefined`\n * leaves the component to own its value from `defaultValue` onward.\n */\n value?: string | null;\n /** Initial value when uncontrolled. */\n defaultValue?: string;\n /** Fired with the newly chosen value. Choosing the chosen one again does nothing. */\n onValueChange?: (value: string) => void;\n /** Disable every choice. The chosen one keeps showing which is set. */\n disabled?: boolean;\n /** Name for native form participation through the radio inputs. */\n name?: string;\n /** Extra class names appended after `ds-radio-group`. */\n className?: string;\n};\n\n/**\n * One choice among several, as a column of radios, built on Ark UI's\n * RadioGroup: a filter's period, a setting with a handful of options whose\n * labels are worth reading side by side.\n *\n * Ark owns the behaviour: native radio inputs carry the state, the arrow keys\n * move the choice and Tab leaves the group in one step. This wrapper\n * contributes `ds-` classes, the `--ds-radio-group-*` bindings and a flat\n * `items` API.\n *\n * ```tsx\n * <RadioGroup\n * aria-label=\"Scheduled in\"\n * items={[\n * { value: 'any', label: 'Any time' },\n * { value: 'this-week', label: 'This week' },\n * ]}\n * value={when}\n * onValueChange={setWhen}\n * />\n * ```\n *\n * A choice whose label alone would not say what it does takes a\n * `description`, a sentence set under the label and read as the radio's\n * description:\n *\n * ```tsx\n * <RadioGroup\n * label=\"Completing a task\"\n * items={[\n * {\n * value: 'archive',\n * label: 'Archive',\n * description: 'Done tasks leave the list and stay searchable.',\n * },\n * {\n * value: 'keep',\n * label: 'Keep in place',\n * description: 'Done tasks stay where they are, struck through.',\n * },\n * ]}\n * value={mode}\n * onValueChange={setMode}\n * />\n * ```\n *\n * Choices told apart by how they look (a colour, a theme) take\n * `appearance=\"cards\"`, each with a `visual`. A few short choices in a\n * form, whose labels may run to several words, take `appearance=\"chips\"`.\n * A few short choices that switch a view are a `SegmentGroup`; a long list\n * is a `Select`.\n */\nexport function RadioGroup({\n label,\n items,\n value,\n defaultValue,\n onValueChange,\n disabled,\n name,\n appearance = 'list',\n className,\n 'aria-label': ariaLabel,\n}: RadioGroupProps) {\n const cards = appearance === 'cards';\n const list = appearance === 'list';\n const rootRef = useRef<HTMLDivElement>(null);\n const descriptionId = useId();\n\n const handleValueChange = radioGroupChangeHandler(rootRef, value, onValueChange);\n\n const visibleLabel = renderVisibleLabel(ArkRadioGroup.Label, {\n label,\n ariaLabel,\n className: 'ds-radio-group__label',\n });\n\n const marker = (item: RadioGroupItem) => {\n if (cards) {\n return (\n <span className=\"ds-radio-group__visual\" aria-hidden>\n {item.visual}\n </span>\n );\n }\n return list ? <ArkRadioGroup.ItemControl className=\"ds-radio-group__control\" /> : null;\n };\n const renderItem = (item: RadioGroupItem, index: number) => {\n const describedBy = list && item.description ? `${descriptionId}-${index}` : undefined;\n return (\n <ArkRadioGroup.Item\n key={item.value}\n value={item.value}\n disabled={item.disabled}\n className=\"ds-radio-group__item\"\n >\n {marker(item)}\n <ArkRadioGroup.ItemText className=\"ds-radio-group__text\">\n {item.label}\n </ArkRadioGroup.ItemText>\n {describedBy && (\n <span id={describedBy} className=\"ds-radio-group__description\">\n {item.description}\n </span>\n )}\n <ArkRadioGroup.ItemHiddenInput aria-describedby={describedBy} />\n </ArkRadioGroup.Item>\n );\n };\n\n const choices = list ? (\n items.map(renderItem)\n ) : (\n <div className={`ds-radio-group__${appearance}`}>{items.map(renderItem)}</div>\n );\n\n return (\n <ArkRadioGroup.Root\n ref={rootRef}\n className={cx('ds-radio-group', !list && `ds-radio-group--${appearance}`, className)}\n value={value}\n defaultValue={defaultValue}\n onValueChange={handleValueChange}\n disabled={disabled}\n name={name}\n orientation=\"vertical\"\n aria-label={ariaLabel}\n >\n {visibleLabel}\n {choices}\n </ArkRadioGroup.Root>\n );\n}\n"]}
|
|
1
|
+
{"version":3,"file":"radio-group.js","sourceRoot":"","sources":["../../src/radio-group/radio-group.tsx"],"names":[],"mappings":"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","sourcesContent":["import { RadioGroup as ArkRadioGroup } from '@ark-ui/react/radio-group';\nimport { type ReactNode, useId, useRef } from 'react';\nimport './radio-group.css';\nimport { radioGroupChangeHandler, renderVisibleLabel } from '../ark-native-input';\nimport { cx } from '../cx';\n\nexport interface RadioGroupItem {\n /** Stable value reported by `onValueChange` and compared with `value`. */\n value: string;\n /** Text beside the radio. The whole row is its click target. */\n label: string;\n /**\n * A sentence under the label saying what the choice means, in the muted\n * hint text of a Field. The radio's accessible description; its name\n * stays the label alone. A list group shows it; a cards group, which\n * shows `visual` instead, and a chips group, which shows the label\n * alone, ignore it.\n */\n description?: string;\n /** Individually disable this choice without removing it. */\n disabled?: boolean;\n /**\n * A picture of the choice, above its label on a `cards` group: a swatch,\n * a badge, a preview. Decorative: the label names the choice. A `list`\n * or `chips` group ignores it.\n */\n visual?: ReactNode;\n}\n\n/**\n * `list` (default) sets radios one under the other; `cards` sets each choice\n * on a card in a wrapping grid; `chips` sets each choice on a chip in a\n * wrapping row.\n */\nexport type RadioGroupAppearance = 'list' | 'cards' | 'chips';\n\n/**\n * A radio group has to have a name, expressed as a union so an unnamed group\n * is a compile error rather than an axe finding, as `SegmentGroup` does.\n */\ntype RadioGroupName =\n | {\n /** Visible label, above the choices, naming the group. */\n label: ReactNode;\n /**\n * A different accessible name when the visible label alone would not\n * say what the choice is. Keep the visible words in it.\n */\n 'aria-label'?: string;\n }\n | {\n label?: undefined;\n /** Accessible name when a heading or a section title around it already says what the choice is. */\n 'aria-label': string;\n };\n\nexport type RadioGroupProps = RadioGroupName & {\n /** The choices, in order. */\n items: RadioGroupItem[];\n /**\n * A sentence about the whole choice, between the label and the choices in\n * a Field's hint text, as a Field's hint sits between its label and its\n * control. It is the group's accessible description.\n */\n hint?: ReactNode;\n /**\n * `list` (default) sets a radio beside each label, one under the other.\n * `cards` sets each choice on a card, its `visual` above its label, in a\n * grid that fills the width and wraps; the chosen card carries a heavier\n * ring instead of a radio. For choices told apart by how they look, such\n * as colours or themes. `chips` sets each label on a chip, in a row that\n * wraps; the chosen chip fills with the primary's tint instead of a radio.\n * For a few short choices in a form, read at a glance.\n */\n appearance?: RadioGroupAppearance;\n /**\n * Controlled value. `null` is controlled with nothing chosen; `undefined`\n * leaves the component to own its value from `defaultValue` onward.\n */\n value?: string | null;\n /** Initial value when uncontrolled. */\n defaultValue?: string;\n /** Fired with the newly chosen value. Choosing the chosen one again does nothing. */\n onValueChange?: (value: string) => void;\n /** Disable every choice. The chosen one keeps showing which is set. */\n disabled?: boolean;\n /** Name for native form participation through the radio inputs. */\n name?: string;\n /** Extra class names appended after `ds-radio-group`. */\n className?: string;\n};\n\n/**\n * One choice among several, as a column of radios, built on Ark UI's\n * RadioGroup: a filter's period, a setting with a handful of options whose\n * labels are worth reading side by side.\n *\n * Ark owns the behaviour: native radio inputs carry the state, the arrow keys\n * move the choice and Tab leaves the group in one step. This wrapper\n * contributes `ds-` classes, the `--ds-radio-group-*` bindings and a flat\n * `items` API.\n *\n * ```tsx\n * <RadioGroup\n * aria-label=\"Scheduled in\"\n * items={[\n * { value: 'any', label: 'Any time' },\n * { value: 'this-week', label: 'This week' },\n * ]}\n * value={when}\n * onValueChange={setWhen}\n * />\n * ```\n *\n * A choice whose label alone would not say what it does takes a\n * `description`, a sentence set under the label and read as the radio's\n * description:\n *\n * ```tsx\n * <RadioGroup\n * label=\"Completing a task\"\n * items={[\n * {\n * value: 'archive',\n * label: 'Archive',\n * description: 'Done tasks leave the list and stay searchable.',\n * },\n * {\n * value: 'keep',\n * label: 'Keep in place',\n * description: 'Done tasks stay where they are, struck through.',\n * },\n * ]}\n * value={mode}\n * onValueChange={setMode}\n * />\n * ```\n *\n * Choices told apart by how they look (a colour, a theme) take\n * `appearance=\"cards\"`, each with a `visual`. A few short choices in a\n * form, whose labels may run to several words, take `appearance=\"chips\"`.\n * A few short choices that switch a view are a `SegmentGroup`; a long list\n * is a `Select`.\n */\nexport function RadioGroup({\n label,\n items,\n hint,\n value,\n defaultValue,\n onValueChange,\n disabled,\n name,\n appearance = 'list',\n className,\n 'aria-label': ariaLabel,\n}: RadioGroupProps) {\n const cards = appearance === 'cards';\n const list = appearance === 'list';\n const rootRef = useRef<HTMLDivElement>(null);\n const descriptionId = useId();\n const hintId = hint ? `${descriptionId}-hint` : undefined;\n\n const handleValueChange = radioGroupChangeHandler(rootRef, value, onValueChange);\n\n const visibleLabel = renderVisibleLabel(ArkRadioGroup.Label, {\n label,\n ariaLabel,\n className: 'ds-radio-group__label',\n });\n\n const marker = (item: RadioGroupItem) => {\n if (cards) {\n return (\n <span className=\"ds-radio-group__visual\" aria-hidden>\n {item.visual}\n </span>\n );\n }\n return list ? <ArkRadioGroup.ItemControl className=\"ds-radio-group__control\" /> : null;\n };\n const renderItem = (item: RadioGroupItem, index: number) => {\n const describedBy = list && item.description ? `${descriptionId}-${index}` : undefined;\n return (\n <ArkRadioGroup.Item\n key={item.value}\n value={item.value}\n disabled={item.disabled}\n className=\"ds-radio-group__item\"\n >\n {marker(item)}\n <ArkRadioGroup.ItemText className=\"ds-radio-group__text\">\n {item.label}\n </ArkRadioGroup.ItemText>\n {describedBy && (\n <span id={describedBy} className=\"ds-radio-group__description\">\n {item.description}\n </span>\n )}\n <ArkRadioGroup.ItemHiddenInput aria-describedby={describedBy} />\n </ArkRadioGroup.Item>\n );\n };\n\n const choices = list ? (\n items.map(renderItem)\n ) : (\n <div className={`ds-radio-group__${appearance}`}>{items.map(renderItem)}</div>\n );\n\n return (\n <ArkRadioGroup.Root\n ref={rootRef}\n className={cx('ds-radio-group', !list && `ds-radio-group--${appearance}`, className)}\n value={value}\n defaultValue={defaultValue}\n onValueChange={handleValueChange}\n disabled={disabled}\n name={name}\n orientation=\"vertical\"\n aria-label={ariaLabel}\n aria-describedby={hintId}\n >\n {visibleLabel}\n {hint && (\n <span id={hintId} className=\"ds-radio-group__hint\">\n {hint}\n </span>\n )}\n {choices}\n </ArkRadioGroup.Root>\n );\n}\n"]}
|
|
@@ -204,4 +204,24 @@
|
|
|
204
204
|
--_segment-group-padding-inline: var(--ds-segment-group-dense-padding-inline);
|
|
205
205
|
}
|
|
206
206
|
}
|
|
207
|
+
|
|
208
|
+
/*
|
|
209
|
+
* Forced colours paint the checked segment's fill over with the system's
|
|
210
|
+
* colours, so every segment looks the same. The checked one draws a ring in
|
|
211
|
+
* the text colour inside its edge instead; focus, which moves the choice,
|
|
212
|
+
* keeps its own ring outside. The custom field loses its box-shadow there,
|
|
213
|
+
* so its border thickens, the padding giving back what it takes.
|
|
214
|
+
*/
|
|
215
|
+
@media (forced-colors: active) {
|
|
216
|
+
.ds-segment-group__item[data-state="checked"]:not([data-focus-visible]) {
|
|
217
|
+
outline: 2px solid currentColor;
|
|
218
|
+
outline-offset: -2px;
|
|
219
|
+
}
|
|
220
|
+
|
|
221
|
+
.ds-segment-group__custom[data-state="checked"] {
|
|
222
|
+
border-width: 2px;
|
|
223
|
+
padding: calc(var(--_segment-group-padding-block) - 1px)
|
|
224
|
+
calc(var(--_segment-group-padding-inline) - 1px);
|
|
225
|
+
}
|
|
226
|
+
}
|
|
207
227
|
}
|