@calcifer-design/ui 0.3.0 → 0.5.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/components/Breadcrumb/Breadcrumb.d.ts +24 -0
- package/dist/components/Breadcrumb/Breadcrumb.js +48 -0
- package/dist/components/Breadcrumb/Breadcrumb.module.js +10 -0
- package/dist/components/Breadcrumb/Breadcrumb_module.css +49 -0
- package/dist/components/CardList/CardList.d.ts +30 -0
- package/dist/components/CardList/CardList.js +35 -0
- package/dist/components/CardList/CardList.module.js +7 -0
- package/dist/components/CardList/CardList_module.css +20 -0
- package/dist/components/Checkbox/Checkbox.d.ts +23 -0
- package/dist/components/Checkbox/Checkbox.js +33 -0
- package/dist/components/Checkbox/Checkbox.module.js +6 -0
- package/dist/components/Checkbox/Checkbox_module.css +16 -0
- package/dist/components/DatePicker/Calendar.d.ts +19 -0
- package/dist/components/DatePicker/Calendar.js +207 -0
- package/dist/components/DatePicker/DatePicker.d.ts +72 -0
- package/dist/components/DatePicker/DatePicker.js +116 -0
- package/dist/components/DatePicker/DatePicker.module.js +14 -0
- package/dist/components/DatePicker/DatePicker_module.css +112 -0
- package/dist/components/DatePicker/calendarDate.d.ts +46 -0
- package/dist/components/DatePicker/calendarDate.js +117 -0
- package/dist/components/Descriptions/Descriptions.d.ts +25 -0
- package/dist/components/Descriptions/Descriptions.js +44 -0
- package/dist/components/Descriptions/Descriptions.module.js +8 -0
- package/dist/components/Descriptions/Descriptions_module.css +47 -0
- package/dist/components/Field/Field.d.ts +118 -0
- package/dist/components/Field/Field.js +90 -0
- package/dist/components/Field/PickerField.d.ts +41 -0
- package/dist/components/Field/PickerField.js +115 -0
- package/dist/components/Field/PickerField.module.js +8 -0
- package/dist/components/Field/PickerField_module.css +36 -0
- package/dist/components/FilterBar/FilterBar.d.ts +55 -0
- package/dist/components/FilterBar/FilterBar.js +138 -0
- package/dist/components/FilterBar/FilterBar.module.js +13 -0
- package/dist/components/FilterBar/FilterBar_module.css +98 -0
- package/dist/components/Form/Form.d.ts +48 -0
- package/dist/components/Form/Form.js +38 -0
- package/dist/components/Form/Form.module.js +5 -0
- package/dist/components/Form/FormContext.d.ts +15 -0
- package/dist/components/Form/FormContext.js +20 -0
- package/dist/components/Form/Form_module.css +6 -0
- package/dist/components/PageShell/PageShell.d.ts +27 -0
- package/dist/components/PageShell/PageShell.js +35 -0
- package/dist/components/PageShell/PageShell.module.js +9 -0
- package/dist/components/PageShell/PageShell_module.css +56 -0
- package/dist/components/RadioGroup/RadioGroup.d.ts +35 -0
- package/dist/components/RadioGroup/RadioGroup.js +64 -0
- package/dist/components/RadioGroup/RadioGroup.module.js +6 -0
- package/dist/components/RadioGroup/RadioGroup_module.css +13 -0
- package/dist/components/Segmented/Segmented.d.ts +49 -0
- package/dist/components/Segmented/Segmented.js +55 -0
- package/dist/components/Segmented/Segmented.module.js +7 -0
- package/dist/components/Segmented/Segmented_module.css +75 -0
- package/dist/components/Select/Select.d.ts +42 -0
- package/dist/components/Select/Select.js +90 -0
- package/dist/components/Select/Select.module.js +9 -0
- package/dist/components/Select/Select_module.css +70 -0
- package/dist/components/Steps/Steps.d.ts +30 -0
- package/dist/components/Steps/Steps.js +63 -0
- package/dist/components/Steps/Steps.module.js +10 -0
- package/dist/components/Steps/Steps_module.css +126 -0
- package/dist/components/Switch/Switch.d.ts +23 -0
- package/dist/components/Switch/Switch.js +25 -0
- package/dist/components/Switch/Switch.module.js +6 -0
- package/dist/components/Switch/Switch_module.css +41 -0
- package/dist/components/TextArea/TextArea.d.ts +16 -0
- package/dist/components/TextArea/TextArea.js +28 -0
- package/dist/components/TextArea/TextArea.module.js +5 -0
- package/dist/components/TextArea/TextArea_module.css +12 -0
- package/dist/components/TextInput/TextInput.d.ts +17 -0
- package/dist/components/TextInput/TextInput.js +18 -0
- package/dist/components/TimePicker/TimePicker.d.ts +19 -0
- package/dist/components/TimePicker/TimePicker.js +17 -0
- package/dist/components/Timeline/Timeline.d.ts +39 -0
- package/dist/components/Timeline/Timeline.js +109 -0
- package/dist/components/Timeline/Timeline.module.js +12 -0
- package/dist/components/Timeline/Timeline_module.css +99 -0
- package/dist/components/Toolbar/InsideToolbarContext.d.ts +6 -0
- package/dist/components/Toolbar/InsideToolbarContext.js +3 -0
- package/dist/components/Toolbar/Toolbar.d.ts +46 -0
- package/dist/components/Toolbar/Toolbar.js +43 -0
- package/dist/components/Toolbar/Toolbar.module.js +7 -0
- package/dist/components/Toolbar/Toolbar_module.css +26 -0
- package/dist/components/Tree/Tree.d.ts +81 -0
- package/dist/components/Tree/Tree.js +232 -0
- package/dist/components/Tree/Tree.module.js +12 -0
- package/dist/components/Tree/Tree_module.css +124 -0
- package/dist/components/Tree/treeIndex.d.ts +23 -0
- package/dist/components/Tree/treeIndex.js +33 -0
- package/dist/components/TreeSelect/TreeSelect.d.ts +61 -0
- package/dist/components/TreeSelect/TreeSelect.js +117 -0
- package/dist/components/TreeSelect/TreeSelect.module.js +7 -0
- package/dist/components/TreeSelect/TreeSelect_module.css +22 -0
- package/dist/components/Upload/Upload.d.ts +66 -0
- package/dist/components/Upload/Upload.js +287 -0
- package/dist/components/Upload/Upload.module.js +12 -0
- package/dist/components/Upload/Upload_module.css +96 -0
- package/dist/components/ViewField/ViewField.d.ts +26 -0
- package/dist/components/ViewField/ViewField.js +29 -0
- package/dist/components/ViewField/ViewField.module.js +6 -0
- package/dist/components/ViewField/ViewField_module.css +17 -0
- package/dist/hooks/useFormReset.d.ts +10 -0
- package/dist/hooks/useFormReset.js +34 -0
- package/dist/icons/CalendarIcon.d.ts +2 -0
- package/dist/icons/CalendarIcon.js +26 -0
- package/dist/icons/CheckIcon.d.ts +6 -0
- package/dist/icons/CheckIcon.js +17 -0
- package/dist/icons/ChevronDownIcon.d.ts +6 -0
- package/dist/icons/ChevronDownIcon.js +17 -0
- package/dist/icons/MinusIcon.d.ts +5 -0
- package/dist/icons/MinusIcon.js +16 -0
- package/dist/index.d.ts +46 -0
- package/dist/index.js +23 -0
- package/dist/styles/field.module.js +15 -0
- package/dist/styles/field_module.css +133 -0
- package/dist/styles/pair.module.js +6 -0
- package/dist/styles/pair_module.css +18 -0
- package/dist/styles/popup_module.css +6 -0
- package/package.json +2 -2
|
@@ -0,0 +1,90 @@
|
|
|
1
|
+
import { Fragment, jsx, jsxs } from "react/jsx-runtime";
|
|
2
|
+
import { Field } from "@base-ui/react/field";
|
|
3
|
+
import { createContext, useContext } from "react";
|
|
4
|
+
import field_module from "../../styles/field.module.js";
|
|
5
|
+
import { useInsideForm } from "../Form/FormContext.js";
|
|
6
|
+
const FieldRequiredContext = /*#__PURE__*/ createContext(false);
|
|
7
|
+
function useFieldRequired() {
|
|
8
|
+
return useContext(FieldRequiredContext);
|
|
9
|
+
}
|
|
10
|
+
function FieldMessages({ description, descriptionId, error, errorId }) {
|
|
11
|
+
const hasDescription = null != description && false !== description;
|
|
12
|
+
const insideForm = useInsideForm();
|
|
13
|
+
return /*#__PURE__*/ jsxs(Fragment, {
|
|
14
|
+
children: [
|
|
15
|
+
hasDescription ? /*#__PURE__*/ jsx(Field.Description, {
|
|
16
|
+
id: descriptionId,
|
|
17
|
+
className: field_module.description,
|
|
18
|
+
children: description
|
|
19
|
+
}) : null,
|
|
20
|
+
void 0 === error ? null : /*#__PURE__*/ jsx(Field.Error, {
|
|
21
|
+
id: errorId,
|
|
22
|
+
className: field_module.error,
|
|
23
|
+
match: true,
|
|
24
|
+
children: error
|
|
25
|
+
}),
|
|
26
|
+
void 0 === error && insideForm ? /*#__PURE__*/ jsx(Field.Error, {
|
|
27
|
+
id: errorId,
|
|
28
|
+
className: field_module.error
|
|
29
|
+
}) : null
|
|
30
|
+
]
|
|
31
|
+
});
|
|
32
|
+
}
|
|
33
|
+
function RequiredMark({ when }) {
|
|
34
|
+
return when ? /*#__PURE__*/ jsx("span", {
|
|
35
|
+
className: field_module.required,
|
|
36
|
+
"aria-hidden": "true"
|
|
37
|
+
}) : null;
|
|
38
|
+
}
|
|
39
|
+
function Field_Field({ label, name, description, error, required = false, disabled = false, children }) {
|
|
40
|
+
return /*#__PURE__*/ jsxs(Field.Root, {
|
|
41
|
+
className: field_module.frame,
|
|
42
|
+
name: name,
|
|
43
|
+
disabled: disabled,
|
|
44
|
+
invalid: void 0 !== error,
|
|
45
|
+
children: [
|
|
46
|
+
/*#__PURE__*/ jsxs(Field.Label, {
|
|
47
|
+
className: field_module.label,
|
|
48
|
+
children: [
|
|
49
|
+
label,
|
|
50
|
+
/*#__PURE__*/ jsx(RequiredMark, {
|
|
51
|
+
when: required
|
|
52
|
+
})
|
|
53
|
+
]
|
|
54
|
+
}),
|
|
55
|
+
/*#__PURE__*/ jsx(FieldRequiredContext.Provider, {
|
|
56
|
+
value: required,
|
|
57
|
+
children: children
|
|
58
|
+
}),
|
|
59
|
+
/*#__PURE__*/ jsx(FieldMessages, {
|
|
60
|
+
description: description,
|
|
61
|
+
error: error
|
|
62
|
+
})
|
|
63
|
+
]
|
|
64
|
+
});
|
|
65
|
+
}
|
|
66
|
+
function InlineField({ label, name, description, error, required = false, disabled = false, children }) {
|
|
67
|
+
return /*#__PURE__*/ jsxs(Field.Root, {
|
|
68
|
+
className: field_module.inlineFrame,
|
|
69
|
+
name: name,
|
|
70
|
+
disabled: disabled,
|
|
71
|
+
invalid: void 0 !== error,
|
|
72
|
+
children: [
|
|
73
|
+
/*#__PURE__*/ jsxs(Field.Label, {
|
|
74
|
+
className: field_module.optionLabel,
|
|
75
|
+
children: [
|
|
76
|
+
children,
|
|
77
|
+
label,
|
|
78
|
+
/*#__PURE__*/ jsx(RequiredMark, {
|
|
79
|
+
when: required
|
|
80
|
+
})
|
|
81
|
+
]
|
|
82
|
+
}),
|
|
83
|
+
/*#__PURE__*/ jsx(FieldMessages, {
|
|
84
|
+
description: description,
|
|
85
|
+
error: error
|
|
86
|
+
})
|
|
87
|
+
]
|
|
88
|
+
});
|
|
89
|
+
}
|
|
90
|
+
export { FieldMessages, Field_Field as Field, InlineField, RequiredMark, useFieldRequired };
|
|
@@ -0,0 +1,41 @@
|
|
|
1
|
+
import { Field as BaseField } from '@base-ui/react/field';
|
|
2
|
+
import { Popover as BasePopover } from '@base-ui/react/popover';
|
|
3
|
+
import { type ReactNode } from 'react';
|
|
4
|
+
import { type FieldFrameProps } from './Field.js';
|
|
5
|
+
export interface PickerFieldProps extends FieldFrameProps {
|
|
6
|
+
/** Submitted through the hidden input and given to `Form`. `null` is nothing chosen. */
|
|
7
|
+
value: string | null;
|
|
8
|
+
/** The trigger's words: the value as it reads, or the placeholder. */
|
|
9
|
+
valueText: string;
|
|
10
|
+
/** Sits at the end of the trigger. */
|
|
11
|
+
icon: ReactNode;
|
|
12
|
+
/** Added to the icon's wrapper, for a picker whose icon reacts to the popup. */
|
|
13
|
+
iconClassName?: string;
|
|
14
|
+
/** Joins the trigger's accessible name when the field is `required`. */
|
|
15
|
+
requiredWord: string;
|
|
16
|
+
/** What `Form` asks before it submits: the message to refuse with, or `null`. */
|
|
17
|
+
validate: () => string | null;
|
|
18
|
+
/** Called after a native reset of the surrounding form. */
|
|
19
|
+
onReset: () => void;
|
|
20
|
+
/** Shows a button that clears the value, while there is one. */
|
|
21
|
+
clearable: boolean;
|
|
22
|
+
clearLabel: string;
|
|
23
|
+
/** Focus goes to the trigger after this, as the button is about to go. */
|
|
24
|
+
onClear: () => void;
|
|
25
|
+
onBlur?: () => void;
|
|
26
|
+
onTriggerKeyDown?: BaseField.Control.Props['onKeyDown'];
|
|
27
|
+
open: boolean;
|
|
28
|
+
onOpenChange: (open: boolean) => void;
|
|
29
|
+
modal?: BasePopover.Root.Props['modal'];
|
|
30
|
+
/** The popover's `Portal` and all it holds, which is each picker's own. */
|
|
31
|
+
children: ReactNode;
|
|
32
|
+
}
|
|
33
|
+
/**
|
|
34
|
+
* The frame `DatePicker` and `TreeSelect` share: a button that opens a popover, a clear button
|
|
35
|
+
* beside it, and a value that travels in a hidden input. Internal: not exported from `src/index.ts`.
|
|
36
|
+
*
|
|
37
|
+
* The trigger is the frame's `Field.Control`, holding the value as a button's `value`. That one
|
|
38
|
+
* element gets the name, the description, `aria-invalid`, `Form`'s focus and the clearing of a
|
|
39
|
+
* `Form` error as any Base UI control does, none of which a hidden input could use.
|
|
40
|
+
*/
|
|
41
|
+
export declare function PickerField({ label, name, description, error, required, disabled, value, valueText, icon, iconClassName, requiredWord, validate, onReset, clearable, clearLabel, onClear, onBlur, onTriggerKeyDown, open, onOpenChange, modal, children, }: PickerFieldProps): import("react").JSX.Element;
|
|
@@ -0,0 +1,115 @@
|
|
|
1
|
+
import { jsx, jsxs } from "react/jsx-runtime";
|
|
2
|
+
import { Field } from "@base-ui/react/field";
|
|
3
|
+
import { Popover } from "@base-ui/react/popover";
|
|
4
|
+
import { useId, useRef } from "react";
|
|
5
|
+
import { useFormReset } from "../../hooks/useFormReset.js";
|
|
6
|
+
import { CloseIcon } from "../../icons/CloseIcon.js";
|
|
7
|
+
import field_module from "../../styles/field.module.js";
|
|
8
|
+
import { useFormValue } from "../Form/FormContext.js";
|
|
9
|
+
import { IconButton } from "../IconButton/IconButton.js";
|
|
10
|
+
import { FieldMessages, RequiredMark } from "./Field.js";
|
|
11
|
+
import PickerField_module from "./PickerField.module.js";
|
|
12
|
+
function PickerField({ label, name, description, error, required = false, disabled = false, value, valueText, icon, iconClassName, requiredWord, validate, onReset, clearable, clearLabel, onClear, onBlur, onTriggerKeyDown, open, onOpenChange, modal, children }) {
|
|
13
|
+
const labelId = useId();
|
|
14
|
+
const valueId = useId();
|
|
15
|
+
const requiredId = useId();
|
|
16
|
+
const triggerRef = useRef(null);
|
|
17
|
+
const hiddenInputRef = useRef(null);
|
|
18
|
+
useFormValue(disabled ? void 0 : name, value);
|
|
19
|
+
useFormReset(hiddenInputRef, onReset);
|
|
20
|
+
return /*#__PURE__*/ jsxs(Field.Root, {
|
|
21
|
+
className: field_module.frame,
|
|
22
|
+
name: name,
|
|
23
|
+
disabled: disabled,
|
|
24
|
+
invalid: void 0 !== error,
|
|
25
|
+
validate: validate,
|
|
26
|
+
children: [
|
|
27
|
+
/*#__PURE__*/ jsxs(Field.Label, {
|
|
28
|
+
id: labelId,
|
|
29
|
+
className: field_module.label,
|
|
30
|
+
nativeLabel: false,
|
|
31
|
+
render: /*#__PURE__*/ jsx("span", {}),
|
|
32
|
+
children: [
|
|
33
|
+
label,
|
|
34
|
+
/*#__PURE__*/ jsx(RequiredMark, {
|
|
35
|
+
when: required
|
|
36
|
+
})
|
|
37
|
+
]
|
|
38
|
+
}),
|
|
39
|
+
/*#__PURE__*/ jsxs("div", {
|
|
40
|
+
className: PickerField_module.row,
|
|
41
|
+
children: [
|
|
42
|
+
/*#__PURE__*/ jsxs(Popover.Root, {
|
|
43
|
+
open: open,
|
|
44
|
+
onOpenChange: onOpenChange,
|
|
45
|
+
modal: modal,
|
|
46
|
+
children: [
|
|
47
|
+
/*#__PURE__*/ jsxs(Popover.Trigger, {
|
|
48
|
+
ref: triggerRef,
|
|
49
|
+
disabled: disabled,
|
|
50
|
+
render: /*#__PURE__*/ jsx(Field.Control, {
|
|
51
|
+
className: [
|
|
52
|
+
field_module.control,
|
|
53
|
+
PickerField_module.trigger
|
|
54
|
+
].join(' '),
|
|
55
|
+
value: value ?? '',
|
|
56
|
+
onBlur: onBlur,
|
|
57
|
+
onKeyDown: onTriggerKeyDown,
|
|
58
|
+
"aria-labelledby": [
|
|
59
|
+
labelId,
|
|
60
|
+
required ? requiredId : null,
|
|
61
|
+
valueId
|
|
62
|
+
].filter(Boolean).join(' '),
|
|
63
|
+
render: /*#__PURE__*/ jsx("button", {
|
|
64
|
+
type: "button"
|
|
65
|
+
})
|
|
66
|
+
}),
|
|
67
|
+
children: [
|
|
68
|
+
/*#__PURE__*/ jsx("span", {
|
|
69
|
+
id: valueId,
|
|
70
|
+
className: PickerField_module.value,
|
|
71
|
+
"data-placeholder": null === value ? '' : void 0,
|
|
72
|
+
children: valueText
|
|
73
|
+
}),
|
|
74
|
+
/*#__PURE__*/ jsx("span", {
|
|
75
|
+
className: [
|
|
76
|
+
PickerField_module.icon,
|
|
77
|
+
iconClassName
|
|
78
|
+
].filter(Boolean).join(' '),
|
|
79
|
+
children: icon
|
|
80
|
+
})
|
|
81
|
+
]
|
|
82
|
+
}),
|
|
83
|
+
children
|
|
84
|
+
]
|
|
85
|
+
}),
|
|
86
|
+
clearable && null !== value && !disabled ? /*#__PURE__*/ jsx(IconButton, {
|
|
87
|
+
label: clearLabel,
|
|
88
|
+
onClick: ()=>{
|
|
89
|
+
onClear();
|
|
90
|
+
triggerRef.current?.focus();
|
|
91
|
+
},
|
|
92
|
+
children: /*#__PURE__*/ jsx(CloseIcon, {})
|
|
93
|
+
}) : null
|
|
94
|
+
]
|
|
95
|
+
}),
|
|
96
|
+
required ? /*#__PURE__*/ jsx("span", {
|
|
97
|
+
id: requiredId,
|
|
98
|
+
hidden: true,
|
|
99
|
+
children: requiredWord
|
|
100
|
+
}) : null,
|
|
101
|
+
/*#__PURE__*/ jsx("input", {
|
|
102
|
+
ref: hiddenInputRef,
|
|
103
|
+
type: "hidden",
|
|
104
|
+
name: name,
|
|
105
|
+
value: value ?? '',
|
|
106
|
+
disabled: disabled
|
|
107
|
+
}),
|
|
108
|
+
/*#__PURE__*/ jsx(FieldMessages, {
|
|
109
|
+
description: description,
|
|
110
|
+
error: error
|
|
111
|
+
})
|
|
112
|
+
]
|
|
113
|
+
});
|
|
114
|
+
}
|
|
115
|
+
export { PickerField };
|
|
@@ -0,0 +1,36 @@
|
|
|
1
|
+
.row-nA5dt {
|
|
2
|
+
align-items: center;
|
|
3
|
+
gap: var(--space-2);
|
|
4
|
+
display: flex;
|
|
5
|
+
}
|
|
6
|
+
|
|
7
|
+
.trigger-EkNQz {
|
|
8
|
+
justify-content: space-between;
|
|
9
|
+
gap: var(--space-3);
|
|
10
|
+
text-align: start;
|
|
11
|
+
cursor: pointer;
|
|
12
|
+
flex: 1;
|
|
13
|
+
min-width: 0;
|
|
14
|
+
}
|
|
15
|
+
|
|
16
|
+
.value-iJ2rA {
|
|
17
|
+
white-space: nowrap;
|
|
18
|
+
text-overflow: ellipsis;
|
|
19
|
+
overflow: hidden;
|
|
20
|
+
}
|
|
21
|
+
|
|
22
|
+
.value-iJ2rA[data-placeholder] {
|
|
23
|
+
color: var(--color-text-muted);
|
|
24
|
+
}
|
|
25
|
+
|
|
26
|
+
.icon-fNz5y {
|
|
27
|
+
color: var(--color-text-muted);
|
|
28
|
+
flex: none;
|
|
29
|
+
display: inline-flex;
|
|
30
|
+
}
|
|
31
|
+
|
|
32
|
+
.icon-fNz5y > svg {
|
|
33
|
+
width: 1rem;
|
|
34
|
+
height: 1rem;
|
|
35
|
+
}
|
|
36
|
+
|
|
@@ -0,0 +1,55 @@
|
|
|
1
|
+
import { type ReactNode } from 'react';
|
|
2
|
+
export interface FilterBarFilter {
|
|
3
|
+
/** What `onRemoveFilter` reports. */
|
|
4
|
+
id: string;
|
|
5
|
+
/** The chip's text, and the end of its remove button's name. */
|
|
6
|
+
label: string;
|
|
7
|
+
}
|
|
8
|
+
export interface FilterBarLabels {
|
|
9
|
+
/** Names the list of chips. */
|
|
10
|
+
activeFilters: string;
|
|
11
|
+
/** The name of one chip's remove button. */
|
|
12
|
+
removeFilter: (label: string) => string;
|
|
13
|
+
/** The words on the button that clears every filter. */
|
|
14
|
+
clearAll: string;
|
|
15
|
+
/** Shown beside the chips, and announced when the count changes. */
|
|
16
|
+
resultCount: (count: number) => string;
|
|
17
|
+
}
|
|
18
|
+
interface FilterBarBaseProps {
|
|
19
|
+
/** The filter controls, each with its own label: a `Select`, a `DatePicker`, a `Segmented`. */
|
|
20
|
+
children?: ReactNode;
|
|
21
|
+
/** Shown as chips, in this order. Which filters are on, and what they do, is the app's. */
|
|
22
|
+
activeFilters?: FilterBarFilter[];
|
|
23
|
+
/** One filter's `id`. Each chip has a named remove button while this is given. */
|
|
24
|
+
onRemoveFilter?: (id: string) => void;
|
|
25
|
+
/** A button clears all the chips while this is given and there are chips to clear. */
|
|
26
|
+
onClearAll?: () => void;
|
|
27
|
+
/** Shown beside the chips and announced politely when it changes, not when first shown. */
|
|
28
|
+
resultCount?: number;
|
|
29
|
+
/** The words the bar says itself, for an app that is not in English. */
|
|
30
|
+
labels?: Partial<FilterBarLabels>;
|
|
31
|
+
}
|
|
32
|
+
interface FilterBarWithSearch extends FilterBarBaseProps {
|
|
33
|
+
/** Controlled, like the filters: the bar holds no filter state of its own. */
|
|
34
|
+
searchValue: string;
|
|
35
|
+
onSearchChange: (value: string) => void;
|
|
36
|
+
/** The search input's visible label and accessible name. */
|
|
37
|
+
searchLabel: string;
|
|
38
|
+
}
|
|
39
|
+
interface FilterBarWithoutSearch extends FilterBarBaseProps {
|
|
40
|
+
searchValue?: undefined;
|
|
41
|
+
onSearchChange?: undefined;
|
|
42
|
+
searchLabel?: undefined;
|
|
43
|
+
}
|
|
44
|
+
export type FilterBarProps = FilterBarWithSearch | FilterBarWithoutSearch;
|
|
45
|
+
/**
|
|
46
|
+
* The row above a results list: a search, slots for filter controls, the active filters as chips
|
|
47
|
+
* and the count. It holds no filter logic, and only says what the app asked for.
|
|
48
|
+
*
|
|
49
|
+
* Focus does not go with what it was on. A removed chip hands it to the next chip, else the one
|
|
50
|
+
* before; when no chip is left, or Clear all has gone, it passes to the first thing here that can
|
|
51
|
+
* take it, usually the search, and at the last to the bar itself. It waits as long as the app takes
|
|
52
|
+
* to remove the chip, and lets go if the user moves on first.
|
|
53
|
+
*/
|
|
54
|
+
export declare function FilterBar({ searchValue, onSearchChange, searchLabel, children, activeFilters, onRemoveFilter, onClearAll, resultCount, labels, }: FilterBarProps): import("react").JSX.Element;
|
|
55
|
+
export {};
|
|
@@ -0,0 +1,138 @@
|
|
|
1
|
+
import { jsx, jsxs } from "react/jsx-runtime";
|
|
2
|
+
import { useLayoutEffect, useRef, useState } from "react";
|
|
3
|
+
import { CloseIcon } from "../../icons/CloseIcon.js";
|
|
4
|
+
import { Button } from "../Button/Button.js";
|
|
5
|
+
import { Field } from "../Field/Field.js";
|
|
6
|
+
import { LiveRegion } from "../LiveRegion/LiveRegion.js";
|
|
7
|
+
import { Tag } from "../Tag/Tag.js";
|
|
8
|
+
import { TextInput } from "../TextInput/TextInput.js";
|
|
9
|
+
import FilterBar_module from "./FilterBar.module.js";
|
|
10
|
+
const DEFAULT_LABELS = {
|
|
11
|
+
activeFilters: 'Active filters',
|
|
12
|
+
removeFilter: (label)=>`Remove filter ${label}`,
|
|
13
|
+
clearAll: 'Clear all',
|
|
14
|
+
resultCount: (count)=>`${count} ${1 === count ? 'result' : 'results'}`
|
|
15
|
+
};
|
|
16
|
+
const FOCUSABLE = 'input:not([disabled],[type="hidden"]),button:not([disabled]),select:not([disabled]),textarea:not([disabled]),a[href],[tabindex="0"]';
|
|
17
|
+
function FilterBar({ searchValue, onSearchChange, searchLabel, children, activeFilters = [], onRemoveFilter, onClearAll, resultCount, labels }) {
|
|
18
|
+
const words = {
|
|
19
|
+
...DEFAULT_LABELS,
|
|
20
|
+
...labels
|
|
21
|
+
};
|
|
22
|
+
const rootRef = useRef(null);
|
|
23
|
+
const removeButtons = useRef(new Map());
|
|
24
|
+
const focusedPart = useRef(null);
|
|
25
|
+
const previousFilters = useRef(activeFilters);
|
|
26
|
+
const hasClearAll = void 0 !== onClearAll && activeFilters.length > 0;
|
|
27
|
+
const [announcement, setAnnouncement] = useState('');
|
|
28
|
+
const [announcedCount, setAnnouncedCount] = useState(resultCount);
|
|
29
|
+
if (resultCount !== announcedCount) {
|
|
30
|
+
setAnnouncedCount(resultCount);
|
|
31
|
+
setAnnouncement(void 0 === resultCount ? '' : words.resultCount(resultCount));
|
|
32
|
+
}
|
|
33
|
+
useLayoutEffect(()=>{
|
|
34
|
+
const part = focusedPart.current;
|
|
35
|
+
const earlier = previousFilters.current;
|
|
36
|
+
previousFilters.current = activeFilters;
|
|
37
|
+
if (null === part) return;
|
|
38
|
+
const { filterId } = part;
|
|
39
|
+
if (null === filterId ? hasClearAll : removeButtons.current.has(filterId)) return;
|
|
40
|
+
const position = earlier.findIndex((filter)=>filter.id === filterId);
|
|
41
|
+
const survivor = [
|
|
42
|
+
...earlier.slice(position + 1),
|
|
43
|
+
...earlier.slice(0, position).reverse()
|
|
44
|
+
].map((filter)=>removeButtons.current.get(filter.id)).find((button)=>void 0 !== button);
|
|
45
|
+
const root = rootRef.current;
|
|
46
|
+
focusedPart.current = null;
|
|
47
|
+
(survivor ?? root?.querySelector(FOCUSABLE) ?? root)?.focus();
|
|
48
|
+
});
|
|
49
|
+
const hasSummary = activeFilters.length > 0 || void 0 !== resultCount;
|
|
50
|
+
return /*#__PURE__*/ jsxs("div", {
|
|
51
|
+
ref: rootRef,
|
|
52
|
+
className: FilterBar_module.root,
|
|
53
|
+
tabIndex: -1,
|
|
54
|
+
children: [
|
|
55
|
+
void 0 !== onSearchChange || children ? /*#__PURE__*/ jsxs("div", {
|
|
56
|
+
className: FilterBar_module.controls,
|
|
57
|
+
children: [
|
|
58
|
+
void 0 === onSearchChange ? null : /*#__PURE__*/ jsx("div", {
|
|
59
|
+
className: FilterBar_module.search,
|
|
60
|
+
children: /*#__PURE__*/ jsx(Field, {
|
|
61
|
+
label: searchLabel,
|
|
62
|
+
children: /*#__PURE__*/ jsx(TextInput, {
|
|
63
|
+
type: "search",
|
|
64
|
+
value: searchValue,
|
|
65
|
+
onValueChange: (value)=>onSearchChange(value)
|
|
66
|
+
})
|
|
67
|
+
})
|
|
68
|
+
}),
|
|
69
|
+
children
|
|
70
|
+
]
|
|
71
|
+
}) : null,
|
|
72
|
+
hasSummary ? /*#__PURE__*/ jsxs("div", {
|
|
73
|
+
className: FilterBar_module.summary,
|
|
74
|
+
children: [
|
|
75
|
+
void 0 === resultCount ? null : /*#__PURE__*/ jsx("span", {
|
|
76
|
+
className: FilterBar_module.count,
|
|
77
|
+
children: words.resultCount(resultCount)
|
|
78
|
+
}),
|
|
79
|
+
activeFilters.length > 0 ? /*#__PURE__*/ jsx("ul", {
|
|
80
|
+
role: "list",
|
|
81
|
+
className: FilterBar_module.chips,
|
|
82
|
+
"aria-label": words.activeFilters,
|
|
83
|
+
children: activeFilters.map((filter)=>/*#__PURE__*/ jsx("li", {
|
|
84
|
+
className: FilterBar_module.chip,
|
|
85
|
+
children: /*#__PURE__*/ jsxs(Tag, {
|
|
86
|
+
children: [
|
|
87
|
+
/*#__PURE__*/ jsx("span", {
|
|
88
|
+
className: FilterBar_module.chipLabel,
|
|
89
|
+
children: filter.label
|
|
90
|
+
}),
|
|
91
|
+
void 0 === onRemoveFilter ? null : /*#__PURE__*/ jsx("button", {
|
|
92
|
+
ref: (element)=>{
|
|
93
|
+
if (null !== element) removeButtons.current.set(filter.id, element);
|
|
94
|
+
return ()=>{
|
|
95
|
+
removeButtons.current.delete(filter.id);
|
|
96
|
+
};
|
|
97
|
+
},
|
|
98
|
+
type: "button",
|
|
99
|
+
className: FilterBar_module.remove,
|
|
100
|
+
"aria-label": words.removeFilter(filter.label),
|
|
101
|
+
onClick: ()=>onRemoveFilter(filter.id),
|
|
102
|
+
onFocus: ()=>{
|
|
103
|
+
focusedPart.current = {
|
|
104
|
+
filterId: filter.id
|
|
105
|
+
};
|
|
106
|
+
},
|
|
107
|
+
onBlur: ()=>{
|
|
108
|
+
focusedPart.current = null;
|
|
109
|
+
},
|
|
110
|
+
children: /*#__PURE__*/ jsx(CloseIcon, {})
|
|
111
|
+
})
|
|
112
|
+
]
|
|
113
|
+
})
|
|
114
|
+
}, filter.id))
|
|
115
|
+
}) : null,
|
|
116
|
+
hasClearAll ? /*#__PURE__*/ jsx(Button, {
|
|
117
|
+
variant: "ghost",
|
|
118
|
+
size: "sm",
|
|
119
|
+
onClick: ()=>onClearAll(),
|
|
120
|
+
onFocus: ()=>{
|
|
121
|
+
focusedPart.current = {
|
|
122
|
+
filterId: null
|
|
123
|
+
};
|
|
124
|
+
},
|
|
125
|
+
onBlur: ()=>{
|
|
126
|
+
focusedPart.current = null;
|
|
127
|
+
},
|
|
128
|
+
children: words.clearAll
|
|
129
|
+
}) : null
|
|
130
|
+
]
|
|
131
|
+
}) : null,
|
|
132
|
+
/*#__PURE__*/ jsx(LiveRegion, {
|
|
133
|
+
message: announcement
|
|
134
|
+
})
|
|
135
|
+
]
|
|
136
|
+
});
|
|
137
|
+
}
|
|
138
|
+
export { FilterBar };
|
|
@@ -0,0 +1,13 @@
|
|
|
1
|
+
import "./FilterBar_module.css";
|
|
2
|
+
const FilterBar_module = {
|
|
3
|
+
root: "root-qnTXQ",
|
|
4
|
+
controls: "controls-UYZLG",
|
|
5
|
+
search: "search-tu3RA",
|
|
6
|
+
summary: "summary-CSd_P",
|
|
7
|
+
count: "count-dGqXH",
|
|
8
|
+
chips: "chips-BHcAD",
|
|
9
|
+
chip: "chip-wCX2N",
|
|
10
|
+
chipLabel: "chipLabel-lhx4e",
|
|
11
|
+
remove: "remove-RNUMA"
|
|
12
|
+
};
|
|
13
|
+
export default FilterBar_module;
|
|
@@ -0,0 +1,98 @@
|
|
|
1
|
+
.root-qnTXQ {
|
|
2
|
+
gap: var(--space-3);
|
|
3
|
+
flex-direction: column;
|
|
4
|
+
min-width: 0;
|
|
5
|
+
display: flex;
|
|
6
|
+
}
|
|
7
|
+
|
|
8
|
+
.controls-UYZLG {
|
|
9
|
+
align-items: flex-end;
|
|
10
|
+
gap: var(--space-3);
|
|
11
|
+
flex-wrap: wrap;
|
|
12
|
+
display: flex;
|
|
13
|
+
}
|
|
14
|
+
|
|
15
|
+
.controls-UYZLG > * {
|
|
16
|
+
min-width: 0;
|
|
17
|
+
max-width: 100%;
|
|
18
|
+
}
|
|
19
|
+
|
|
20
|
+
.search-tu3RA {
|
|
21
|
+
flex: 16rem;
|
|
22
|
+
}
|
|
23
|
+
|
|
24
|
+
.summary-CSd_P {
|
|
25
|
+
align-items: center;
|
|
26
|
+
gap: var(--space-2);
|
|
27
|
+
flex-wrap: wrap;
|
|
28
|
+
display: flex;
|
|
29
|
+
}
|
|
30
|
+
|
|
31
|
+
.count-dGqXH {
|
|
32
|
+
color: var(--color-text-muted);
|
|
33
|
+
font-size: var(--text-sm);
|
|
34
|
+
line-height: var(--leading-snug);
|
|
35
|
+
}
|
|
36
|
+
|
|
37
|
+
.chips-BHcAD {
|
|
38
|
+
gap: var(--space-2);
|
|
39
|
+
flex-wrap: wrap;
|
|
40
|
+
min-width: 0;
|
|
41
|
+
margin: 0;
|
|
42
|
+
padding: 0;
|
|
43
|
+
list-style: none;
|
|
44
|
+
display: flex;
|
|
45
|
+
}
|
|
46
|
+
|
|
47
|
+
.chip-wCX2N {
|
|
48
|
+
min-width: 0;
|
|
49
|
+
max-width: 100%;
|
|
50
|
+
}
|
|
51
|
+
|
|
52
|
+
.chipLabel-lhx4e {
|
|
53
|
+
min-width: 0;
|
|
54
|
+
padding-block: var(--space-1);
|
|
55
|
+
white-space: normal;
|
|
56
|
+
overflow-wrap: anywhere;
|
|
57
|
+
}
|
|
58
|
+
|
|
59
|
+
.remove-RNUMA {
|
|
60
|
+
width: 1.5rem;
|
|
61
|
+
height: 1.5rem;
|
|
62
|
+
border-radius: var(--radius-full);
|
|
63
|
+
color: var(--color-text-muted);
|
|
64
|
+
cursor: pointer;
|
|
65
|
+
transition-property: background-color, color;
|
|
66
|
+
transition-duration: var(--motion-duration-1);
|
|
67
|
+
transition-timing-function: var(--motion-ease);
|
|
68
|
+
-webkit-tap-highlight-color: transparent;
|
|
69
|
+
background: none;
|
|
70
|
+
border: 0;
|
|
71
|
+
flex: none;
|
|
72
|
+
justify-content: center;
|
|
73
|
+
align-items: center;
|
|
74
|
+
margin-inline-start: var(--space-1);
|
|
75
|
+
padding: 0;
|
|
76
|
+
display: inline-flex;
|
|
77
|
+
position: relative;
|
|
78
|
+
}
|
|
79
|
+
|
|
80
|
+
.remove-RNUMA:after {
|
|
81
|
+
--remove-reach: calc(var(--space-2) * -1);
|
|
82
|
+
content: "";
|
|
83
|
+
inset: var(--remove-reach);
|
|
84
|
+
position: absolute;
|
|
85
|
+
}
|
|
86
|
+
|
|
87
|
+
.remove-RNUMA > svg {
|
|
88
|
+
width: .875rem;
|
|
89
|
+
height: .875rem;
|
|
90
|
+
}
|
|
91
|
+
|
|
92
|
+
@media (hover: hover) {
|
|
93
|
+
.remove-RNUMA:hover {
|
|
94
|
+
background: var(--color-surface-3);
|
|
95
|
+
color: var(--color-text);
|
|
96
|
+
}
|
|
97
|
+
}
|
|
98
|
+
|
|
@@ -0,0 +1,48 @@
|
|
|
1
|
+
import { type ReactNode } from 'react';
|
|
2
|
+
export interface FormProps<Values extends object = Record<string, unknown>> {
|
|
3
|
+
/**
|
|
4
|
+
* The values as a plain object keyed by field `name`, once nothing is invalid. A text control
|
|
5
|
+
* or a `Select` gives a string, `''` when empty; a `RadioGroup` a string or `null`; `Checkbox`
|
|
6
|
+
* and `Switch` a boolean; `DatePicker` a `YYYY-MM-DD` string or `null`; `TreeSelect` a node's `id`
|
|
7
|
+
* or `null`; and `Upload` an array of `File`s, empty when none is chosen and an array even without
|
|
8
|
+
* `multiple`. A disabled control is left out, as a browser leaves it out, and so is an input that
|
|
9
|
+
* is not one of the library's: a raw `<input name>` has no field frame to report through. The
|
|
10
|
+
* browser's own submit never happens, so `Form` takes no `action`.
|
|
11
|
+
*/
|
|
12
|
+
onSubmit: (values: Values) => void;
|
|
13
|
+
/**
|
|
14
|
+
* Messages keyed by field `name`, typically from a server. Each shows on the matching control,
|
|
15
|
+
* marks it invalid and goes away when that control's value changes. While one is showing the
|
|
16
|
+
* form does not submit: submitting moves focus to the first such control instead, so a message
|
|
17
|
+
* the user cannot fix by editing that field belongs in an `Alert`. Pass a new object to set them
|
|
18
|
+
* again; an object with the same messages, as an inline literal makes on every render, does not
|
|
19
|
+
* bring back one that was cleared, until the form has been submitted since.
|
|
20
|
+
*
|
|
21
|
+
* So the parent must drop an entry once a submit succeeds: a stale one comes back on its next
|
|
22
|
+
* render, and then blocks the following submit.
|
|
23
|
+
*
|
|
24
|
+
* A disabled control shows no message and does not stop the submit, which is Base UI's rule.
|
|
25
|
+
*/
|
|
26
|
+
errors?: Record<string, string>;
|
|
27
|
+
/**
|
|
28
|
+
* Leave this on. `false` hands validation to the browser's bubble, which cannot report on the
|
|
29
|
+
* hidden inputs `Select`, `Checkbox`, `RadioGroup` and `Switch` submit with: `required` on one
|
|
30
|
+
* of those then blocks the submit with nothing on screen. On, `required` and the other
|
|
31
|
+
* constraints still block, and the message shows on the control's own frame.
|
|
32
|
+
*/
|
|
33
|
+
noValidate?: boolean;
|
|
34
|
+
children: ReactNode;
|
|
35
|
+
/** Lets a submit button outside the form point at it with `form`. */
|
|
36
|
+
id?: string;
|
|
37
|
+
'aria-label'?: string;
|
|
38
|
+
'aria-labelledby'?: string;
|
|
39
|
+
}
|
|
40
|
+
/**
|
|
41
|
+
* Collects values, shows validation messages and moves focus to the first invalid control. Every
|
|
42
|
+
* field frame in the library works inside it; no field needs telling.
|
|
43
|
+
*
|
|
44
|
+
* A `type="reset"` button does not reset every control here: messages stay, and a `Select` or a
|
|
45
|
+
* `Checkbox` keeps its state where a text input does not. To start over, remount the form with a
|
|
46
|
+
* new `key`, which is the supported way and clears all of it.
|
|
47
|
+
*/
|
|
48
|
+
export declare function Form<Values extends object = Record<string, unknown>>({ onSubmit, errors, noValidate, children, id, 'aria-label': ariaLabel, 'aria-labelledby': ariaLabelledBy, }: FormProps<Values>): import("react").JSX.Element;
|