@enablo/swirlcn-ui 0.0.0-stage → 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/LICENSE +21 -0
- package/README.md +30 -2
- package/dist/chunk-3DJWDNQL.js +77 -0
- package/dist/chunk-7XUCETA6.js +447 -0
- package/dist/chunk-KZESIYUN.js +18 -0
- package/dist/flip.d.ts +98 -0
- package/dist/flip.js +158 -0
- package/dist/fonts/Inter-italic.var.woff2 +0 -0
- package/dist/fonts/Inter.var.woff2 +0 -0
- package/dist/fonts/OFL.txt +96 -0
- package/dist/index.d.ts +2459 -0
- package/dist/index.js +8439 -0
- package/dist/server.d.ts +144 -0
- package/dist/server.js +88 -0
- package/dist/spacing-BQaEPbUv.d.ts +59 -0
- package/dist/theme.css +146 -0
- package/package.json +84 -3
- package/src/components/accordion.tsx +102 -0
- package/src/components/action-list.tsx +294 -0
- package/src/components/alert-dialog.tsx +155 -0
- package/src/components/autocomplete.tsx +313 -0
- package/src/components/avatar.tsx +258 -0
- package/src/components/badge.tsx +100 -0
- package/src/components/banner.tsx +112 -0
- package/src/components/button-group.tsx +87 -0
- package/src/components/button.tsx +362 -0
- package/src/components/card.tsx +186 -0
- package/src/components/carousel.tsx +245 -0
- package/src/components/checkbox.tsx +125 -0
- package/src/components/chip.tsx +153 -0
- package/src/components/color-input.tsx +98 -0
- package/src/components/data-cell.tsx +230 -0
- package/src/components/date-input.tsx +223 -0
- package/src/components/date-picker.tsx +276 -0
- package/src/components/description-list.tsx +97 -0
- package/src/components/dialog.tsx +405 -0
- package/src/components/empty-state.tsx +63 -0
- package/src/components/file-chip.tsx +206 -0
- package/src/components/file-uploader.tsx +148 -0
- package/src/components/flip-app-header.tsx +104 -0
- package/src/components/flip-brand.tsx +77 -0
- package/src/components/flip-theme.tsx +95 -0
- package/src/components/form-control.tsx +397 -0
- package/src/components/form-group.tsx +26 -0
- package/src/components/heading.tsx +70 -0
- package/src/components/icon.tsx +119 -0
- package/src/components/image-grid.tsx +285 -0
- package/src/components/inline-notification.tsx +167 -0
- package/src/components/inline-status.tsx +100 -0
- package/src/components/input.tsx +390 -0
- package/src/components/label.tsx +28 -0
- package/src/components/lightbox.tsx +314 -0
- package/src/components/link.tsx +46 -0
- package/src/components/list.tsx +40 -0
- package/src/components/menu.tsx +530 -0
- package/src/components/option-list.tsx +582 -0
- package/src/components/pagination.tsx +336 -0
- package/src/components/popover.tsx +194 -0
- package/src/components/progress.tsx +158 -0
- package/src/components/radio-group.tsx +136 -0
- package/src/components/resource-list.tsx +686 -0
- package/src/components/search.tsx +127 -0
- package/src/components/select.tsx +456 -0
- package/src/components/separator.tsx +93 -0
- package/src/components/skeleton-box.tsx +63 -0
- package/src/components/skeleton-text.tsx +66 -0
- package/src/components/spinner.tsx +83 -0
- package/src/components/stack.tsx +86 -0
- package/src/components/status-indicator.tsx +31 -0
- package/src/components/switch.tsx +90 -0
- package/src/components/table.tsx +242 -0
- package/src/components/tabs.tsx +147 -0
- package/src/components/tag.tsx +169 -0
- package/src/components/text.tsx +126 -0
- package/src/components/textarea.tsx +130 -0
- package/src/components/theme-provider.tsx +115 -0
- package/src/components/thumbnail.tsx +250 -0
- package/src/components/time-input.tsx +123 -0
- package/src/components/toast.tsx +217 -0
- package/src/components/toggle-group.tsx +124 -0
- package/src/components/toolbar.tsx +105 -0
- package/src/components/tooltip.tsx +97 -0
- package/src/components/tree-navigation.tsx +194 -0
- package/src/components/tree-view.tsx +292 -0
- package/src/flip.ts +12 -0
- package/src/index.ts +317 -0
- package/src/lib/date-mask.ts +176 -0
- package/src/lib/field-context.ts +86 -0
- package/src/lib/flip-app-script.ts +38 -0
- package/src/lib/flip-host.ts +84 -0
- package/src/lib/flip-theme-css.ts +90 -0
- package/src/lib/focus.ts +18 -0
- package/src/lib/glyphs.ts +137 -0
- package/src/lib/spacing.ts +93 -0
- package/src/lib/theme-context.ts +27 -0
- package/src/lib/theme-script.ts +49 -0
- package/src/lib/use-mobile.ts +17 -0
- package/src/lib/utils.ts +28 -0
- package/src/server.ts +20 -0
- package/src/styles/fonts/Inter-italic.var.woff2 +0 -0
- package/src/styles/fonts/Inter.var.woff2 +0 -0
- package/src/styles/fonts/OFL.txt +96 -0
- package/src/styles/theme.css +146 -0
|
@@ -0,0 +1,686 @@
|
|
|
1
|
+
import * as React from "react";
|
|
2
|
+
import { cn } from "../lib/utils";
|
|
3
|
+
import { Glyph } from "../lib/glyphs";
|
|
4
|
+
import { gap, type SwirlSpacing } from "../lib/spacing";
|
|
5
|
+
import { Button } from "./button";
|
|
6
|
+
import { InlineError } from "./inline-status";
|
|
7
|
+
import { Separator } from "./separator";
|
|
8
|
+
import { Spinner } from "./spinner";
|
|
9
|
+
|
|
10
|
+
/* ---------------------------------------------------------------- context */
|
|
11
|
+
|
|
12
|
+
interface Drag {
|
|
13
|
+
value: string;
|
|
14
|
+
from: number;
|
|
15
|
+
/** Item values in their previewed order, shown with CSS `order`. */
|
|
16
|
+
order: string[];
|
|
17
|
+
}
|
|
18
|
+
|
|
19
|
+
interface ResourceListContextValue {
|
|
20
|
+
semantics: "grid" | "list";
|
|
21
|
+
allowDrag: boolean;
|
|
22
|
+
drag: Drag | null;
|
|
23
|
+
startDrag: (value: string) => void;
|
|
24
|
+
moveDrag: (step: -1 | 1) => void;
|
|
25
|
+
pointerDrag: (clientY: number) => void;
|
|
26
|
+
endDrag: () => void;
|
|
27
|
+
}
|
|
28
|
+
|
|
29
|
+
const ResourceListContext = React.createContext<ResourceListContextValue | null>(null);
|
|
30
|
+
|
|
31
|
+
/** The element in each item that takes focus: its button, link or row. */
|
|
32
|
+
const CONTENT = "[data-resource-list-content]";
|
|
33
|
+
const FOCUSABLE_IN_CONTROL =
|
|
34
|
+
"[data-resource-list-control] :is(button, a[href], input, select, textarea, [tabindex])";
|
|
35
|
+
|
|
36
|
+
/**
|
|
37
|
+
* Makes item `index` the grid's one tab stop. Controls in other rows leave
|
|
38
|
+
* the tab order too, as in Swirl: a row's menu is reached from its row.
|
|
39
|
+
*/
|
|
40
|
+
function setTabStop(list: HTMLElement, index: number) {
|
|
41
|
+
const contents = Array.from(list.querySelectorAll<HTMLElement>(CONTENT));
|
|
42
|
+
contents.forEach((el, i) => {
|
|
43
|
+
el.setAttribute("tabindex", i === index ? "0" : "-1");
|
|
44
|
+
const row = el.closest(`[${ITEM}]`) ?? el.parentElement;
|
|
45
|
+
row
|
|
46
|
+
?.querySelectorAll<HTMLElement>(FOCUSABLE_IN_CONTROL)
|
|
47
|
+
.forEach((control) => control.setAttribute("tabindex", i === index ? "0" : "-1"));
|
|
48
|
+
});
|
|
49
|
+
}
|
|
50
|
+
const ITEM = "data-resource-list-item";
|
|
51
|
+
|
|
52
|
+
const space = (s: SwirlSpacing | undefined) => (s === undefined ? undefined : `var(--s-space-${s})`);
|
|
53
|
+
|
|
54
|
+
/* ------------------------------------------------------------------- list */
|
|
55
|
+
|
|
56
|
+
export interface ResourceListItemDrop {
|
|
57
|
+
value: string;
|
|
58
|
+
oldIndex: number;
|
|
59
|
+
newIndex: number;
|
|
60
|
+
}
|
|
61
|
+
|
|
62
|
+
export interface ResourceListProps extends React.ComponentProps<"div"> {
|
|
63
|
+
/** Accessible name of the list. */
|
|
64
|
+
label?: string;
|
|
65
|
+
/**
|
|
66
|
+
* `grid` (default) makes the list one tab stop, with the arrow keys, Home
|
|
67
|
+
* and End moving between items, as Swirl's does. `list` is a plain list in
|
|
68
|
+
* which every item is its own tab stop.
|
|
69
|
+
*/
|
|
70
|
+
semantics?: "grid" | "list";
|
|
71
|
+
/** Space between items. */
|
|
72
|
+
spacing?: SwirlSpacing;
|
|
73
|
+
padding?: SwirlSpacing;
|
|
74
|
+
paddingBlockStart?: SwirlSpacing;
|
|
75
|
+
paddingBlockEnd?: SwirlSpacing;
|
|
76
|
+
/** Defaults to 8. */
|
|
77
|
+
paddingInlineStart?: SwirlSpacing;
|
|
78
|
+
/** Defaults to 8. */
|
|
79
|
+
paddingInlineEnd?: SwirlSpacing;
|
|
80
|
+
/**
|
|
81
|
+
* Show a drag handle on each item, to reorder by pointer or keyboard
|
|
82
|
+
* (Space to grab, arrows to move, Space to drop, Escape to cancel). Items
|
|
83
|
+
* need a `value`. The list doesn't reorder its children: apply
|
|
84
|
+
* `onItemDrop` to your data.
|
|
85
|
+
*/
|
|
86
|
+
allowDrag?: boolean;
|
|
87
|
+
onItemDrop?: (drop: ResourceListItemDrop) => void;
|
|
88
|
+
assistiveTextItemGrabbed?: string;
|
|
89
|
+
assistiveTextItemMoving?: string;
|
|
90
|
+
assistiveTextItemMoved?: string;
|
|
91
|
+
}
|
|
92
|
+
|
|
93
|
+
/**
|
|
94
|
+
* Swirl's resource list: rows for people, files and other things, each with
|
|
95
|
+
* media, a label, a description, meta text, badges and a control.
|
|
96
|
+
*
|
|
97
|
+
* <ResourceList label="Members">
|
|
98
|
+
* <ResourceListItem label="Ada Lovelace" description="Admin"
|
|
99
|
+
* media={<Avatar label="Ada Lovelace" size="l" />} />
|
|
100
|
+
* </ResourceList>
|
|
101
|
+
*/
|
|
102
|
+
export function ResourceList({
|
|
103
|
+
label,
|
|
104
|
+
semantics = "grid",
|
|
105
|
+
spacing = "0",
|
|
106
|
+
padding,
|
|
107
|
+
paddingBlockStart,
|
|
108
|
+
paddingBlockEnd,
|
|
109
|
+
paddingInlineStart,
|
|
110
|
+
paddingInlineEnd,
|
|
111
|
+
allowDrag = false,
|
|
112
|
+
onItemDrop,
|
|
113
|
+
assistiveTextItemGrabbed = "Item grabbed. Use arrow keys to move item up or down. Use spacebar to save position.",
|
|
114
|
+
assistiveTextItemMoving = "Current position:",
|
|
115
|
+
assistiveTextItemMoved = "Item moved. New position:",
|
|
116
|
+
className,
|
|
117
|
+
style,
|
|
118
|
+
onKeyDown,
|
|
119
|
+
onFocus,
|
|
120
|
+
children,
|
|
121
|
+
...props
|
|
122
|
+
}: ResourceListProps) {
|
|
123
|
+
const ref = React.useRef<HTMLDivElement>(null);
|
|
124
|
+
const [drag, setDrag] = React.useState<Drag | null>(null);
|
|
125
|
+
const [assistiveText, setAssistiveText] = React.useState("");
|
|
126
|
+
const focused = React.useRef(0);
|
|
127
|
+
|
|
128
|
+
const contents = () => Array.from(ref.current?.querySelectorAll<HTMLElement>(CONTENT) ?? []);
|
|
129
|
+
const itemValues = () =>
|
|
130
|
+
Array.from(ref.current?.querySelectorAll<HTMLElement>(`[${ITEM}]`) ?? []).map(
|
|
131
|
+
(el) => el.getAttribute(ITEM)!,
|
|
132
|
+
);
|
|
133
|
+
|
|
134
|
+
// In a grid only one item is a tab stop. Keep that true as items come and go.
|
|
135
|
+
React.useEffect(() => {
|
|
136
|
+
const list = ref.current;
|
|
137
|
+
if (!list || semantics !== "grid") return;
|
|
138
|
+
const sync = () => {
|
|
139
|
+
if (focused.current >= list.querySelectorAll(CONTENT).length) focused.current = 0;
|
|
140
|
+
setTabStop(list, focused.current);
|
|
141
|
+
};
|
|
142
|
+
sync();
|
|
143
|
+
const observer = new MutationObserver(sync);
|
|
144
|
+
observer.observe(list, { childList: true, subtree: true });
|
|
145
|
+
return () => observer.disconnect();
|
|
146
|
+
}, [semantics]);
|
|
147
|
+
|
|
148
|
+
const focusAt = (index: number) => {
|
|
149
|
+
const all = contents();
|
|
150
|
+
const target = all[index];
|
|
151
|
+
if (!target) return;
|
|
152
|
+
if (ref.current) setTabStop(ref.current, index);
|
|
153
|
+
focused.current = index;
|
|
154
|
+
target.focus();
|
|
155
|
+
};
|
|
156
|
+
|
|
157
|
+
const focusItem = (value: string) =>
|
|
158
|
+
requestAnimationFrame(() => {
|
|
159
|
+
const el = ref.current?.querySelector<HTMLElement>(`[${ITEM}="${CSS.escape(value)}"] ${CONTENT}`);
|
|
160
|
+
const index = el ? contents().indexOf(el) : -1;
|
|
161
|
+
if (index >= 0) focusAt(index);
|
|
162
|
+
ref.current
|
|
163
|
+
?.querySelector<HTMLElement>(`[${ITEM}="${CSS.escape(value)}"] [data-drag-handle]`)
|
|
164
|
+
?.focus();
|
|
165
|
+
});
|
|
166
|
+
|
|
167
|
+
const endDrag = () => {
|
|
168
|
+
if (!drag) return;
|
|
169
|
+
setDrag(null);
|
|
170
|
+
const newIndex = drag.order.indexOf(drag.value);
|
|
171
|
+
setAssistiveText(`${assistiveTextItemMoved} ${newIndex + 1}`);
|
|
172
|
+
onItemDrop?.({ value: drag.value, oldIndex: drag.from, newIndex });
|
|
173
|
+
focusItem(drag.value);
|
|
174
|
+
};
|
|
175
|
+
|
|
176
|
+
const context: ResourceListContextValue = {
|
|
177
|
+
semantics,
|
|
178
|
+
allowDrag,
|
|
179
|
+
drag,
|
|
180
|
+
startDrag: (value) => {
|
|
181
|
+
const order = itemValues();
|
|
182
|
+
setDrag({ value, from: order.indexOf(value), order });
|
|
183
|
+
setAssistiveText(assistiveTextItemGrabbed);
|
|
184
|
+
},
|
|
185
|
+
moveDrag: (step) => {
|
|
186
|
+
if (!drag) return;
|
|
187
|
+
const to = drag.order.indexOf(drag.value) + step;
|
|
188
|
+
if (to < 0 || to >= drag.order.length) return;
|
|
189
|
+
const order = drag.order.filter((v) => v !== drag.value);
|
|
190
|
+
order.splice(to, 0, drag.value);
|
|
191
|
+
setDrag({ ...drag, order });
|
|
192
|
+
setAssistiveText(`${assistiveTextItemMoving} ${to + 1}`);
|
|
193
|
+
},
|
|
194
|
+
pointerDrag: (clientY) => {
|
|
195
|
+
if (!drag || !ref.current) return;
|
|
196
|
+
const others = drag.order.filter((v) => v !== drag.value);
|
|
197
|
+
// Slot the item after every other item whose middle is above the pointer.
|
|
198
|
+
const to = others.filter((v) => {
|
|
199
|
+
const el = ref.current!.querySelector(`[${ITEM}="${CSS.escape(v)}"]`);
|
|
200
|
+
if (!el) return false;
|
|
201
|
+
const rect = el.getBoundingClientRect();
|
|
202
|
+
return rect.top + rect.height / 2 < clientY;
|
|
203
|
+
}).length;
|
|
204
|
+
if (drag.order.indexOf(drag.value) === to) return;
|
|
205
|
+
others.splice(to, 0, drag.value);
|
|
206
|
+
setDrag({ ...drag, order: others });
|
|
207
|
+
},
|
|
208
|
+
endDrag,
|
|
209
|
+
};
|
|
210
|
+
|
|
211
|
+
return (
|
|
212
|
+
<ResourceListContext.Provider value={context}>
|
|
213
|
+
<span className="sr-only" role="alert">
|
|
214
|
+
{assistiveText}
|
|
215
|
+
</span>
|
|
216
|
+
<div
|
|
217
|
+
style={{
|
|
218
|
+
paddingBlockStart: space(paddingBlockStart ?? padding),
|
|
219
|
+
paddingBlockEnd: space(paddingBlockEnd ?? padding),
|
|
220
|
+
paddingInlineStart: space(paddingInlineStart ?? padding ?? "8"),
|
|
221
|
+
paddingInlineEnd: space(paddingInlineEnd ?? padding ?? "8"),
|
|
222
|
+
...style,
|
|
223
|
+
}}
|
|
224
|
+
className={cn("w-full", className)}
|
|
225
|
+
>
|
|
226
|
+
<div
|
|
227
|
+
ref={ref}
|
|
228
|
+
role={semantics}
|
|
229
|
+
aria-label={label}
|
|
230
|
+
className={cn("flex w-full flex-col", gap(spacing))}
|
|
231
|
+
onFocus={(event) => {
|
|
232
|
+
onFocus?.(event);
|
|
233
|
+
// Focus anywhere in a row, its control included, makes that row the tab stop.
|
|
234
|
+
const row = (event.target as HTMLElement).closest(`[${ITEM}]`);
|
|
235
|
+
const content = row?.querySelector<HTMLElement>(CONTENT) ?? (event.target as HTMLElement);
|
|
236
|
+
const index = contents().indexOf(content);
|
|
237
|
+
if (index >= 0 && semantics === "grid" && ref.current) {
|
|
238
|
+
setTabStop(ref.current, index);
|
|
239
|
+
focused.current = index;
|
|
240
|
+
}
|
|
241
|
+
}}
|
|
242
|
+
onKeyDown={(event) => {
|
|
243
|
+
onKeyDown?.(event);
|
|
244
|
+
if (event.defaultPrevented || semantics !== "grid" || drag) return;
|
|
245
|
+
const all = contents();
|
|
246
|
+
const current = all.indexOf(document.activeElement as HTMLElement);
|
|
247
|
+
if (current < 0) return;
|
|
248
|
+
const target = {
|
|
249
|
+
ArrowDown: (current + 1) % all.length,
|
|
250
|
+
ArrowUp: current === 0 ? all.length - 1 : current - 1,
|
|
251
|
+
Home: 0,
|
|
252
|
+
End: all.length - 1,
|
|
253
|
+
}[event.key];
|
|
254
|
+
if (target === undefined) return;
|
|
255
|
+
event.preventDefault();
|
|
256
|
+
focusAt(target);
|
|
257
|
+
}}
|
|
258
|
+
{...props}
|
|
259
|
+
>
|
|
260
|
+
{children}
|
|
261
|
+
</div>
|
|
262
|
+
</div>
|
|
263
|
+
</ResourceListContext.Provider>
|
|
264
|
+
);
|
|
265
|
+
}
|
|
266
|
+
|
|
267
|
+
function useResourceList() {
|
|
268
|
+
return React.useContext(ResourceListContext) ?? {
|
|
269
|
+
semantics: "list" as const,
|
|
270
|
+
allowDrag: false,
|
|
271
|
+
drag: null,
|
|
272
|
+
startDrag: () => {},
|
|
273
|
+
moveDrag: () => {},
|
|
274
|
+
pointerDrag: () => {},
|
|
275
|
+
endDrag: () => {},
|
|
276
|
+
};
|
|
277
|
+
}
|
|
278
|
+
|
|
279
|
+
/** A row's role: a grid row, or a list item. */
|
|
280
|
+
function useRowRoles() {
|
|
281
|
+
const { semantics } = useResourceList();
|
|
282
|
+
return semantics === "grid"
|
|
283
|
+
? ({ host: "row", cell: "gridcell" } as const)
|
|
284
|
+
: ({ host: "listitem", cell: undefined } as const);
|
|
285
|
+
}
|
|
286
|
+
|
|
287
|
+
/* ------------------------------------------------------------------- item */
|
|
288
|
+
|
|
289
|
+
export interface ResourceListItemProps
|
|
290
|
+
extends Omit<React.ComponentProps<"div">, "children" | "onChange"> {
|
|
291
|
+
label: React.ReactNode;
|
|
292
|
+
description?: React.ReactNode;
|
|
293
|
+
/** Shown before the label, such as an avatar or a thumbnail. */
|
|
294
|
+
media?: React.ReactNode;
|
|
295
|
+
/** Short text on the right, such as a date. */
|
|
296
|
+
meta?: React.ReactNode;
|
|
297
|
+
/** Badges on the right, under `meta`. */
|
|
298
|
+
badges?: React.ReactNode;
|
|
299
|
+
/**
|
|
300
|
+
* A control on the right, such as a menu button. With `meta` or `badges`
|
|
301
|
+
* it shows on hover or focus, on devices that can hover.
|
|
302
|
+
*/
|
|
303
|
+
control?: React.ReactNode;
|
|
304
|
+
/** Makes the row a link. */
|
|
305
|
+
href?: string;
|
|
306
|
+
target?: string;
|
|
307
|
+
rel?: string;
|
|
308
|
+
onClick?: React.MouseEventHandler<HTMLElement>;
|
|
309
|
+
/** Whether the row is a button or link. Defaults to true. */
|
|
310
|
+
interactive?: boolean;
|
|
311
|
+
/** Show a checkbox and make the row toggle it. */
|
|
312
|
+
selectable?: boolean;
|
|
313
|
+
checked?: boolean;
|
|
314
|
+
onCheckedChange?: (checked: boolean) => void;
|
|
315
|
+
disabled?: boolean;
|
|
316
|
+
/** Highlight the row, as for the current page. */
|
|
317
|
+
active?: boolean;
|
|
318
|
+
compact?: boolean;
|
|
319
|
+
labelWeight?: "medium" | "semibold" | "bold";
|
|
320
|
+
/** Let the label wrap instead of truncating; `labelWrapMaxLines` clamps it. */
|
|
321
|
+
labelWrap?: boolean;
|
|
322
|
+
labelWrapMaxLines?: number;
|
|
323
|
+
descriptionWrap?: boolean;
|
|
324
|
+
alignItems?: React.CSSProperties["alignItems"];
|
|
325
|
+
/** Identifies the item, for dragging. */
|
|
326
|
+
value?: string;
|
|
327
|
+
/** Accessible name, when the label alone isn't enough. */
|
|
328
|
+
"aria-label"?: string;
|
|
329
|
+
"aria-current"?: React.AriaAttributes["aria-current"];
|
|
330
|
+
dragHandleLabel?: string;
|
|
331
|
+
dragHandleDescription?: string;
|
|
332
|
+
}
|
|
333
|
+
|
|
334
|
+
/** A row in a `ResourceList`. */
|
|
335
|
+
export function ResourceListItem({
|
|
336
|
+
label,
|
|
337
|
+
description,
|
|
338
|
+
media,
|
|
339
|
+
meta,
|
|
340
|
+
badges,
|
|
341
|
+
control,
|
|
342
|
+
href,
|
|
343
|
+
target,
|
|
344
|
+
rel,
|
|
345
|
+
onClick,
|
|
346
|
+
interactive = true,
|
|
347
|
+
selectable = false,
|
|
348
|
+
checked = false,
|
|
349
|
+
onCheckedChange,
|
|
350
|
+
disabled = false,
|
|
351
|
+
active = false,
|
|
352
|
+
compact = false,
|
|
353
|
+
labelWeight = "medium",
|
|
354
|
+
labelWrap = false,
|
|
355
|
+
labelWrapMaxLines,
|
|
356
|
+
descriptionWrap = false,
|
|
357
|
+
alignItems,
|
|
358
|
+
value: valueProp,
|
|
359
|
+
"aria-label": ariaLabel,
|
|
360
|
+
"aria-current": ariaCurrent,
|
|
361
|
+
dragHandleLabel = "Move item",
|
|
362
|
+
dragHandleDescription = "Press spacebar to toggle grab",
|
|
363
|
+
className,
|
|
364
|
+
style,
|
|
365
|
+
...props
|
|
366
|
+
}: ResourceListItemProps) {
|
|
367
|
+
const list = useResourceList();
|
|
368
|
+
const roles = useRowRoles();
|
|
369
|
+
const id = React.useId();
|
|
370
|
+
const value = valueProp ?? id;
|
|
371
|
+
const isInteractive = interactive || selectable;
|
|
372
|
+
const Tag = !isInteractive ? "div" : href && !selectable ? "a" : "button";
|
|
373
|
+
const isDisabled = disabled && !href;
|
|
374
|
+
const showMeta = meta !== undefined || badges !== undefined;
|
|
375
|
+
const hideControl = control !== undefined && showMeta;
|
|
376
|
+
const dragging = list.drag?.value === value;
|
|
377
|
+
const order = list.drag ? list.drag.order.indexOf(value) : undefined;
|
|
378
|
+
const descriptionId = `${id}-description`;
|
|
379
|
+
|
|
380
|
+
return (
|
|
381
|
+
<div
|
|
382
|
+
role={roles.host}
|
|
383
|
+
{...{ [ITEM]: value }}
|
|
384
|
+
className="relative block w-full"
|
|
385
|
+
style={{ order }}
|
|
386
|
+
{...props}
|
|
387
|
+
>
|
|
388
|
+
<div
|
|
389
|
+
role={roles.cell}
|
|
390
|
+
className={cn(
|
|
391
|
+
"group/item relative flex w-full gap-3 overflow-hidden rounded-sm px-2 py-3",
|
|
392
|
+
compact && "p-2",
|
|
393
|
+
isInteractive && !isDisabled && "cursor-pointer hover:bg-state-hovered active:bg-state-pressed",
|
|
394
|
+
active && "bg-state-hovered",
|
|
395
|
+
// Focus shows on the whole row, while the button inside takes it.
|
|
396
|
+
"has-[[data-resource-list-content]:focus-visible]:z-1 has-[[data-resource-list-content]:focus-visible]:bg-state-hovered",
|
|
397
|
+
"has-[[data-resource-list-content]:focus-visible]:outline-2 has-[[data-resource-list-content]:focus-visible]:outline-focus",
|
|
398
|
+
"has-[[data-resource-list-content]:focus-visible]:outline-solid",
|
|
399
|
+
dragging &&
|
|
400
|
+
"z-1 rounded-s bg-state-pressed shadow-[0_0.0625rem_0.125rem_rgba(25,26,28,0.08),0_0.25rem_2rem_rgba(25,26,28,0.16)] hover:bg-state-pressed",
|
|
401
|
+
className,
|
|
402
|
+
)}
|
|
403
|
+
style={style}
|
|
404
|
+
>
|
|
405
|
+
<Tag
|
|
406
|
+
data-resource-list-content=""
|
|
407
|
+
{...(Tag === "a" ? { href, target, rel: rel ?? (target === "_blank" ? "noreferrer" : undefined) } : {})}
|
|
408
|
+
{...(Tag === "button" ? { type: "button" as const, disabled: isDisabled } : {})}
|
|
409
|
+
{...(Tag === "div" ? { tabIndex: list.semantics === "grid" ? -1 : undefined } : {})}
|
|
410
|
+
role={selectable ? "checkbox" : undefined}
|
|
411
|
+
aria-checked={selectable ? checked : undefined}
|
|
412
|
+
aria-disabled={isDisabled || undefined}
|
|
413
|
+
aria-current={ariaCurrent}
|
|
414
|
+
aria-label={ariaLabel}
|
|
415
|
+
aria-labelledby={ariaLabel ? undefined : `${id}-label`}
|
|
416
|
+
aria-describedby={description ? descriptionId : undefined}
|
|
417
|
+
onClick={(event: React.MouseEvent<HTMLElement>) => {
|
|
418
|
+
onClick?.(event);
|
|
419
|
+
if (!event.defaultPrevented && selectable && !isDisabled) onCheckedChange?.(!checked);
|
|
420
|
+
}}
|
|
421
|
+
style={{ alignItems }}
|
|
422
|
+
className={cn(
|
|
423
|
+
"m-0 flex w-full min-w-0 items-start gap-3 border-0 bg-transparent p-0 text-left text-inherit text-foreground no-underline outline-none",
|
|
424
|
+
"leading-5 desktop:leading-6",
|
|
425
|
+
isInteractive ? "cursor-pointer disabled:cursor-default" : "",
|
|
426
|
+
selectable && "pl-10 md:pl-[3.25rem]",
|
|
427
|
+
list.allowDrag && "pl-12 desktop:pl-10",
|
|
428
|
+
)}
|
|
429
|
+
>
|
|
430
|
+
{media !== undefined && <span className="inline-flex shrink-0">{media}</span>}
|
|
431
|
+
<span
|
|
432
|
+
className={cn(
|
|
433
|
+
"relative flex h-full min-h-12 min-w-0 flex-col justify-center pr-4",
|
|
434
|
+
compact && "min-h-8",
|
|
435
|
+
selectable && "pr-2 md:pr-4",
|
|
436
|
+
)}
|
|
437
|
+
>
|
|
438
|
+
<span
|
|
439
|
+
id={`${id}-label`}
|
|
440
|
+
className={cn(
|
|
441
|
+
"text-base leading-6 desktop:text-sm desktop:leading-5",
|
|
442
|
+
labelWrap || labelWrapMaxLines ? "whitespace-normal" : "truncate",
|
|
443
|
+
labelWrapMaxLines && "overflow-hidden [display:-webkit-box] [-webkit-box-orient:vertical]",
|
|
444
|
+
labelWeight === "medium" && "font-medium",
|
|
445
|
+
labelWeight === "semibold" && "font-semibold",
|
|
446
|
+
labelWeight === "bold" && "font-bold",
|
|
447
|
+
)}
|
|
448
|
+
style={labelWrapMaxLines ? { WebkitLineClamp: labelWrapMaxLines } : undefined}
|
|
449
|
+
>
|
|
450
|
+
{label}
|
|
451
|
+
</span>
|
|
452
|
+
{description !== undefined && (
|
|
453
|
+
<span
|
|
454
|
+
id={descriptionId}
|
|
455
|
+
className={cn("text-sm leading-5 text-subdued", descriptionWrap ? "whitespace-normal" : "truncate")}
|
|
456
|
+
>
|
|
457
|
+
{description}
|
|
458
|
+
</span>
|
|
459
|
+
)}
|
|
460
|
+
</span>
|
|
461
|
+
</Tag>
|
|
462
|
+
|
|
463
|
+
{selectable && (
|
|
464
|
+
<span
|
|
465
|
+
aria-hidden
|
|
466
|
+
className={cn(
|
|
467
|
+
"pointer-events-none absolute top-1/2 left-3.5 flex size-[1.125rem] -translate-y-1/2 items-center justify-center rounded-s border-2",
|
|
468
|
+
isDisabled
|
|
469
|
+
? checked
|
|
470
|
+
? "border-disabled bg-disabled text-on-status"
|
|
471
|
+
: "border-disabled bg-transparent"
|
|
472
|
+
: checked
|
|
473
|
+
? "border-[var(--s-icon-highlight)] bg-[var(--s-icon-highlight)] text-on-status"
|
|
474
|
+
: "border-icon-default",
|
|
475
|
+
)}
|
|
476
|
+
>
|
|
477
|
+
{checked && <Glyph name="checkStrong" className="size-[1.0625rem]" />}
|
|
478
|
+
</span>
|
|
479
|
+
)}
|
|
480
|
+
|
|
481
|
+
{showMeta && (
|
|
482
|
+
<span
|
|
483
|
+
className={cn(
|
|
484
|
+
"flex flex-col items-end gap-0.5 text-sm text-subdued",
|
|
485
|
+
meta !== undefined ? "self-start" : "self-center",
|
|
486
|
+
hideControl &&
|
|
487
|
+
"[@media(hover:hover)]:-mr-4 [@media(hover:hover)]:pr-4 [@media(hover:hover)]:transition-[margin] [@media(hover:hover)]:duration-100",
|
|
488
|
+
hideControl &&
|
|
489
|
+
"[@media(hover:hover)]:group-focus-within/item:mr-0 [@media(hover:hover)]:group-focus-within/item:pr-0 [@media(hover:hover)]:group-hover/item:mr-0 [@media(hover:hover)]:group-hover/item:pr-0",
|
|
490
|
+
)}
|
|
491
|
+
>
|
|
492
|
+
{meta !== undefined && (
|
|
493
|
+
<span className="mt-0.5 leading-6 whitespace-nowrap desktop:mt-1 desktop:leading-5">{meta}</span>
|
|
494
|
+
)}
|
|
495
|
+
{badges !== undefined && <span className="inline-flex w-max">{badges}</span>}
|
|
496
|
+
</span>
|
|
497
|
+
)}
|
|
498
|
+
|
|
499
|
+
{control !== undefined && (
|
|
500
|
+
<span
|
|
501
|
+
data-resource-list-control=""
|
|
502
|
+
onClick={(event) => event.stopPropagation()}
|
|
503
|
+
className={cn(
|
|
504
|
+
"self-center",
|
|
505
|
+
// With meta or badges, the control waits for hover or focus where hovering is possible.
|
|
506
|
+
hideControl &&
|
|
507
|
+
cn(
|
|
508
|
+
"[@media(hover:hover)]:pointer-events-none [@media(hover:hover)]:absolute [@media(hover:hover)]:top-1/2 [@media(hover:hover)]:right-2",
|
|
509
|
+
"[@media(hover:hover)]:-translate-y-1/2 [@media(hover:hover)]:opacity-0 [@media(hover:hover)]:transition-opacity [@media(hover:hover)]:duration-100",
|
|
510
|
+
"[@media(hover:hover)]:group-focus-within/item:pointer-events-auto [@media(hover:hover)]:group-focus-within/item:static [@media(hover:hover)]:group-focus-within/item:-my-1 [@media(hover:hover)]:group-focus-within/item:translate-y-0 [@media(hover:hover)]:group-focus-within/item:opacity-100",
|
|
511
|
+
"[@media(hover:hover)]:group-hover/item:pointer-events-auto [@media(hover:hover)]:group-hover/item:static [@media(hover:hover)]:group-hover/item:-my-1 [@media(hover:hover)]:group-hover/item:translate-y-0 [@media(hover:hover)]:group-hover/item:opacity-100",
|
|
512
|
+
),
|
|
513
|
+
)}
|
|
514
|
+
>
|
|
515
|
+
{control}
|
|
516
|
+
</span>
|
|
517
|
+
)}
|
|
518
|
+
</div>
|
|
519
|
+
|
|
520
|
+
{list.allowDrag && (
|
|
521
|
+
<button
|
|
522
|
+
type="button"
|
|
523
|
+
data-drag-handle=""
|
|
524
|
+
aria-label={`${dragHandleLabel} "${typeof label === "string" ? label : ""}"`}
|
|
525
|
+
aria-description={dragHandleDescription}
|
|
526
|
+
className={cn(
|
|
527
|
+
"absolute top-1/2 left-1 z-1 m-0 inline-flex shrink-0 -translate-y-1/2 border-0 bg-transparent p-2 text-icon-default",
|
|
528
|
+
"cursor-grab active:cursor-grabbing outline-focus focus:not-focus-visible:outline-none focus-visible:outline-2 focus-visible:outline-solid",
|
|
529
|
+
"[&>svg]:size-6 desktop:[&>svg]:size-4",
|
|
530
|
+
)}
|
|
531
|
+
onKeyDown={(event) => {
|
|
532
|
+
if (event.key === " " || event.key === "Enter") {
|
|
533
|
+
event.preventDefault();
|
|
534
|
+
if (dragging) list.endDrag();
|
|
535
|
+
else list.startDrag(value);
|
|
536
|
+
} else if (dragging && (event.key === "ArrowDown" || event.key === "ArrowUp")) {
|
|
537
|
+
event.preventDefault();
|
|
538
|
+
list.moveDrag(event.key === "ArrowDown" ? 1 : -1);
|
|
539
|
+
} else if (dragging && event.key === "Escape") {
|
|
540
|
+
event.preventDefault();
|
|
541
|
+
list.endDrag();
|
|
542
|
+
}
|
|
543
|
+
}}
|
|
544
|
+
onPointerDown={(event) => {
|
|
545
|
+
if (event.button !== 0) return;
|
|
546
|
+
event.preventDefault();
|
|
547
|
+
event.currentTarget.setPointerCapture(event.pointerId);
|
|
548
|
+
list.startDrag(value);
|
|
549
|
+
}}
|
|
550
|
+
onPointerMove={(event) => {
|
|
551
|
+
if (dragging) list.pointerDrag(event.clientY);
|
|
552
|
+
}}
|
|
553
|
+
onPointerUp={() => {
|
|
554
|
+
if (dragging) list.endDrag();
|
|
555
|
+
}}
|
|
556
|
+
>
|
|
557
|
+
<Glyph name="dragHandle" />
|
|
558
|
+
</button>
|
|
559
|
+
)}
|
|
560
|
+
</div>
|
|
561
|
+
);
|
|
562
|
+
}
|
|
563
|
+
|
|
564
|
+
/* ---------------------------------------------------------------- section */
|
|
565
|
+
|
|
566
|
+
export interface ResourceListSectionProps extends React.ComponentProps<"div"> {
|
|
567
|
+
label: React.ReactNode;
|
|
568
|
+
/** Draw a rule above the section. */
|
|
569
|
+
hasSeparator?: boolean;
|
|
570
|
+
separatorSpacing?: React.ComponentProps<typeof Separator>["spacing"];
|
|
571
|
+
/** Space between the section's items. */
|
|
572
|
+
spacing?: SwirlSpacing;
|
|
573
|
+
}
|
|
574
|
+
|
|
575
|
+
/** A labelled group of items in a `ResourceList`. */
|
|
576
|
+
export function ResourceListSection({
|
|
577
|
+
label,
|
|
578
|
+
hasSeparator = false,
|
|
579
|
+
separatorSpacing = "4",
|
|
580
|
+
spacing = "0",
|
|
581
|
+
className,
|
|
582
|
+
children,
|
|
583
|
+
...props
|
|
584
|
+
}: ResourceListSectionProps) {
|
|
585
|
+
const { semantics } = useResourceList();
|
|
586
|
+
const id = React.useId();
|
|
587
|
+
const grid = semantics === "grid";
|
|
588
|
+
return (
|
|
589
|
+
<div className={cn("block w-full", className)} {...props}>
|
|
590
|
+
{hasSeparator && <Separator spacing={separatorSpacing} />}
|
|
591
|
+
<div role={grid ? "rowgroup" : "listitem"} aria-labelledby={`${id}-label`}>
|
|
592
|
+
<span
|
|
593
|
+
id={`${id}-label`}
|
|
594
|
+
className="flex p-2 text-base leading-6 font-medium text-subdued desktop:text-sm desktop:leading-5"
|
|
595
|
+
>
|
|
596
|
+
{label}
|
|
597
|
+
</span>
|
|
598
|
+
<div role={grid ? undefined : "list"} className={cn("flex flex-col", gap(spacing))}>
|
|
599
|
+
{children}
|
|
600
|
+
</div>
|
|
601
|
+
</div>
|
|
602
|
+
</div>
|
|
603
|
+
);
|
|
604
|
+
}
|
|
605
|
+
|
|
606
|
+
/* -------------------------------------------------------------- file item */
|
|
607
|
+
|
|
608
|
+
export interface ResourceListFileItemProps extends React.ComponentProps<"div"> {
|
|
609
|
+
label: React.ReactNode;
|
|
610
|
+
/** Such as the file's size. Hidden while there's an error. */
|
|
611
|
+
description?: React.ReactNode;
|
|
612
|
+
errorMessage?: React.ReactNode;
|
|
613
|
+
/** Defaults to a file icon. */
|
|
614
|
+
icon?: React.ReactNode;
|
|
615
|
+
/** Show a spinner, as while uploading. */
|
|
616
|
+
loading?: boolean;
|
|
617
|
+
/** Show a button that removes the file; it calls `onRemove`. */
|
|
618
|
+
removable?: boolean;
|
|
619
|
+
onRemove?: () => void;
|
|
620
|
+
removeButtonLabel?: string;
|
|
621
|
+
}
|
|
622
|
+
|
|
623
|
+
/** A file in a `ResourceList`, such as an upload, with an error, a spinner or a remove button. */
|
|
624
|
+
export function ResourceListFileItem({
|
|
625
|
+
label,
|
|
626
|
+
description,
|
|
627
|
+
errorMessage,
|
|
628
|
+
icon,
|
|
629
|
+
loading = false,
|
|
630
|
+
removable = false,
|
|
631
|
+
onRemove,
|
|
632
|
+
removeButtonLabel = "Remove file",
|
|
633
|
+
className,
|
|
634
|
+
...props
|
|
635
|
+
}: ResourceListFileItemProps) {
|
|
636
|
+
const roles = useRowRoles();
|
|
637
|
+
const showError = Boolean(errorMessage);
|
|
638
|
+
const showSpinner = !showError && loading;
|
|
639
|
+
const showRemove = removable && !showSpinner;
|
|
640
|
+
return (
|
|
641
|
+
<div role={roles.host} className="block w-full" {...props}>
|
|
642
|
+
<div
|
|
643
|
+
role={roles.cell}
|
|
644
|
+
data-resource-list-content=""
|
|
645
|
+
tabIndex={roles.cell ? -1 : undefined}
|
|
646
|
+
className={cn(
|
|
647
|
+
"relative flex w-full items-center gap-3 bg-background px-4 py-3 leading-6",
|
|
648
|
+
"outline-none focus-visible:bg-background-hovered",
|
|
649
|
+
"desktop:p-3 desktop:text-sm desktop:leading-5",
|
|
650
|
+
className,
|
|
651
|
+
)}
|
|
652
|
+
>
|
|
653
|
+
<span className="inline-flex size-6 shrink-0 text-[var(--s-icon-highlight)] desktop:size-5 [&>svg]:size-full">
|
|
654
|
+
{icon ?? <Glyph name="file" />}
|
|
655
|
+
</span>
|
|
656
|
+
<span
|
|
657
|
+
className={cn(
|
|
658
|
+
"relative flex min-h-[2.875rem] min-w-0 grow flex-col justify-center",
|
|
659
|
+
"after:absolute after:inset-x-0 after:-bottom-3 after:h-px after:bg-border after:content-['']",
|
|
660
|
+
(showSpinner || showRemove) && "pr-[calc(0.75rem+2.5rem)]",
|
|
661
|
+
)}
|
|
662
|
+
>
|
|
663
|
+
<span className="truncate font-medium">{label}</span>
|
|
664
|
+
{!showError && description !== undefined && (
|
|
665
|
+
<span className="mt-0.5 truncate text-sm leading-5 text-subdued">{description}</span>
|
|
666
|
+
)}
|
|
667
|
+
{showError && (
|
|
668
|
+
<span aria-live="polite" className="mt-0.5">
|
|
669
|
+
<InlineError size="s" message={errorMessage} />
|
|
670
|
+
</span>
|
|
671
|
+
)}
|
|
672
|
+
</span>
|
|
673
|
+
{showSpinner && (
|
|
674
|
+
<span className="absolute top-1/2 right-6 inline-flex -translate-y-1/2">
|
|
675
|
+
<Spinner size="s" label="Loading" />
|
|
676
|
+
</span>
|
|
677
|
+
)}
|
|
678
|
+
{showRemove && (
|
|
679
|
+
<span className="absolute top-1/2 right-4 inline-flex -translate-y-1/2">
|
|
680
|
+
<Button hideLabel label={removeButtonLabel} icon={<Glyph name="close" />} onClick={onRemove} />
|
|
681
|
+
</span>
|
|
682
|
+
)}
|
|
683
|
+
</div>
|
|
684
|
+
</div>
|
|
685
|
+
);
|
|
686
|
+
}
|