@f-ewald/components 1.38.0 → 1.40.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/README.md +48 -0
- package/custom-elements.json +1052 -131
- package/dist/address-autocomplete.js +2 -2
- package/dist/address-autocomplete.js.map +1 -1
- package/dist/app-shell.js +4 -4
- package/dist/app-shell.js.map +1 -1
- package/dist/app-sidebar.js +2 -2
- package/dist/app-sidebar.js.map +1 -1
- package/dist/audio-player.js +1 -1
- package/dist/audio-player.js.map +1 -1
- package/dist/autocomplete-input.js +2 -2
- package/dist/autocomplete-input.js.map +1 -1
- package/dist/breadcrumb-nav.d.ts +69 -0
- package/dist/breadcrumb-nav.d.ts.map +1 -0
- package/dist/breadcrumb-nav.js +235 -0
- package/dist/breadcrumb-nav.js.map +1 -0
- package/dist/button-group.js +2 -2
- package/dist/button-group.js.map +1 -1
- package/dist/calendar-day.js +3 -3
- package/dist/calendar-day.js.map +1 -1
- package/dist/calendar-month.d.ts.map +1 -1
- package/dist/calendar-month.js +4 -1
- package/dist/calendar-month.js.map +1 -1
- package/dist/calendar-week.js +4 -4
- package/dist/calendar-week.js.map +1 -1
- package/dist/chat-message.js +1 -1
- package/dist/chat-message.js.map +1 -1
- package/dist/comment-composer.js +1 -1
- package/dist/comment-composer.js.map +1 -1
- package/dist/confirm-dialog.d.ts.map +1 -1
- package/dist/confirm-dialog.js +5 -2
- package/dist/confirm-dialog.js.map +1 -1
- package/dist/content-divider.js +1 -1
- package/dist/content-divider.js.map +1 -1
- package/dist/cron-schedule.d.ts.map +1 -1
- package/dist/cron-schedule.js +6 -5
- package/dist/cron-schedule.js.map +1 -1
- package/dist/data-table.d.ts.map +1 -1
- package/dist/data-table.js +3 -2
- package/dist/data-table.js.map +1 -1
- package/dist/dropdown-button.d.ts.map +1 -1
- package/dist/dropdown-button.js +4 -2
- package/dist/dropdown-button.js.map +1 -1
- package/dist/editable-text.js +1 -1
- package/dist/editable-text.js.map +1 -1
- package/dist/empty-state.d.ts +42 -0
- package/dist/empty-state.d.ts.map +1 -0
- package/dist/empty-state.js +172 -0
- package/dist/empty-state.js.map +1 -0
- package/dist/form-field.js +1 -1
- package/dist/form-field.js.map +1 -1
- package/dist/form-select.js +3 -3
- package/dist/form-select.js.map +1 -1
- package/dist/frame-box.js +1 -1
- package/dist/frame-box.js.map +1 -1
- package/dist/fullscreen-button.js +1 -1
- package/dist/fullscreen-button.js.map +1 -1
- package/dist/icons.d.ts +2 -0
- package/dist/icons.d.ts.map +1 -1
- package/dist/icons.js +2 -0
- package/dist/icons.js.map +1 -1
- package/dist/index.d.ts +6 -1
- package/dist/index.d.ts.map +1 -1
- package/dist/index.js +6 -1
- package/dist/index.js.map +1 -1
- package/dist/kanban-card.js +1 -1
- package/dist/kanban-card.js.map +1 -1
- package/dist/kanban-column.js +3 -3
- package/dist/kanban-column.js.map +1 -1
- package/dist/kbd-hint.d.ts.map +1 -1
- package/dist/kbd-hint.js +2 -1
- package/dist/kbd-hint.js.map +1 -1
- package/dist/link-card.js +1 -1
- package/dist/link-card.js.map +1 -1
- package/dist/markdown-view.js +3 -3
- package/dist/markdown-view.js.map +1 -1
- package/dist/modal-dialog.js +1 -1
- package/dist/modal-dialog.js.map +1 -1
- package/dist/multi-select.js +5 -5
- package/dist/multi-select.js.map +1 -1
- package/dist/pagination-nav.d.ts.map +1 -1
- package/dist/pagination-nav.js +5 -1
- package/dist/pagination-nav.js.map +1 -1
- package/dist/photo-gallery.js +1 -1
- package/dist/photo-gallery.js.map +1 -1
- package/dist/popover-panel.d.ts.map +1 -1
- package/dist/popover-panel.js +4 -2
- package/dist/popover-panel.js.map +1 -1
- package/dist/progress-bar.d.ts.map +1 -1
- package/dist/progress-bar.js +1 -0
- package/dist/progress-bar.js.map +1 -1
- package/dist/radio-cards.js +1 -1
- package/dist/radio-cards.js.map +1 -1
- package/dist/radio-pills.js +1 -1
- package/dist/radio-pills.js.map +1 -1
- package/dist/reveal-button.js +1 -1
- package/dist/reveal-button.js.map +1 -1
- package/dist/scroll-to-bottom.js +1 -1
- package/dist/scroll-to-bottom.js.map +1 -1
- package/dist/scroll-to-top.js +1 -1
- package/dist/scroll-to-top.js.map +1 -1
- package/dist/skip-link.d.ts +30 -0
- package/dist/skip-link.d.ts.map +1 -0
- package/dist/skip-link.js +136 -0
- package/dist/skip-link.js.map +1 -0
- package/dist/slide-panel.js +1 -1
- package/dist/slide-panel.js.map +1 -1
- package/dist/spec-list.d.ts +49 -0
- package/dist/spec-list.d.ts.map +1 -0
- package/dist/spec-list.js +168 -0
- package/dist/spec-list.js.map +1 -0
- package/dist/stat-meter.d.ts.map +1 -1
- package/dist/stat-meter.js +1 -0
- package/dist/stat-meter.js.map +1 -1
- package/dist/tab-bar.js +1 -1
- package/dist/tab-bar.js.map +1 -1
- package/dist/text-area.js +1 -1
- package/dist/text-area.js.map +1 -1
- package/dist/tile-grid.js +1 -1
- package/dist/tile-grid.js.map +1 -1
- package/dist/tokens.css +42 -1
- package/dist/tokens.d.ts +50 -0
- package/dist/tokens.d.ts.map +1 -1
- package/dist/tokens.js +132 -0
- package/dist/tokens.js.map +1 -1
- package/dist/tree-view.js +2 -2
- package/dist/tree-view.js.map +1 -1
- package/dist/ui-admonition.js +1 -1
- package/dist/ui-admonition.js.map +1 -1
- package/dist/ui-button.js +1 -1
- package/dist/ui-button.js.map +1 -1
- package/dist/ui-checkbox.d.ts +10 -1
- package/dist/ui-checkbox.d.ts.map +1 -1
- package/dist/ui-checkbox.js +11 -2
- package/dist/ui-checkbox.js.map +1 -1
- package/dist/video-player.js +1 -1
- package/dist/video-player.js.map +1 -1
- package/dist/vote-control.d.ts +40 -0
- package/dist/vote-control.d.ts.map +1 -0
- package/dist/vote-control.js +311 -0
- package/dist/vote-control.js.map +1 -0
- package/docs/address-autocomplete.md +1 -0
- package/docs/app-shell.md +1 -0
- package/docs/app-sidebar.md +1 -0
- package/docs/audio-player.md +1 -0
- package/docs/autocomplete-input.md +1 -0
- package/docs/breadcrumb-nav.md +70 -0
- package/docs/button-group.md +1 -0
- package/docs/calendar-day.md +1 -0
- package/docs/calendar-month.md +1 -0
- package/docs/calendar-week.md +1 -0
- package/docs/chat-message.md +1 -0
- package/docs/comment-composer.md +1 -0
- package/docs/confirm-dialog.md +1 -0
- package/docs/content-divider.md +1 -0
- package/docs/cron-schedule.md +2 -0
- package/docs/data-table.md +2 -0
- package/docs/design-language.md +57 -5
- package/docs/dropdown-button.md +1 -0
- package/docs/editable-text.md +1 -0
- package/docs/empty-state.md +55 -0
- package/docs/form-field.md +1 -0
- package/docs/form-select.md +1 -0
- package/docs/frame-box.md +1 -0
- package/docs/fullscreen-button.md +1 -0
- package/docs/icons.md +1 -0
- package/docs/kanban-card.md +1 -0
- package/docs/kanban-column.md +1 -0
- package/docs/kbd-hint.md +1 -0
- package/docs/link-card.md +1 -0
- package/docs/markdown-view.md +1 -0
- package/docs/modal-dialog.md +1 -0
- package/docs/multi-select.md +1 -0
- package/docs/pagination-nav.md +2 -0
- package/docs/photo-gallery.md +1 -0
- package/docs/popover-panel.md +1 -0
- package/docs/progress-bar.md +1 -0
- package/docs/radio-cards.md +1 -0
- package/docs/radio-pills.md +1 -0
- package/docs/reveal-button.md +1 -0
- package/docs/scroll-to-bottom.md +1 -0
- package/docs/scroll-to-top.md +1 -0
- package/docs/skip-link.md +54 -0
- package/docs/slide-panel.md +1 -0
- package/docs/spec-list.md +71 -0
- package/docs/stat-meter.md +1 -0
- package/docs/tab-bar.md +1 -0
- package/docs/text-area.md +1 -0
- package/docs/tile-grid.md +1 -0
- package/docs/tree-view.md +1 -0
- package/docs/ui-admonition.md +1 -0
- package/docs/ui-button.md +1 -0
- package/docs/ui-checkbox.md +13 -2
- package/docs/video-player.md +1 -0
- package/docs/vote-control.md +73 -0
- package/llms.txt +210 -49
- package/package.json +1 -1
package/llms.txt
CHANGED
|
@@ -15,11 +15,14 @@ Theming: components use `var(--ui-*, <fallback>)` custom properties, so they
|
|
|
15
15
|
render correctly with zero external CSS. Override any `--ui-*` property on
|
|
16
16
|
`:root` (or an ancestor) to retheme, or import the optional
|
|
17
17
|
`@f-ewald/components/tokens.css` stylesheet as a starting point. That
|
|
18
|
-
stylesheet also ships
|
|
18
|
+
stylesheet also ships five named themes, selected with a `data-theme`
|
|
19
19
|
attribute on `<html>` (mutually exclusive): `"dark"`/`"light"` force one of
|
|
20
20
|
the two flat palettes over the OS preference, `"gradient"` glosses buttons and
|
|
21
|
-
toasts,
|
|
22
|
-
with hairline rings over a blue accent
|
|
21
|
+
toasts, `"metro"` squares every tokenized corner and replaces drop shadows
|
|
22
|
+
with hairline rings over a blue accent, and `"blueprint"` restyles the palette
|
|
23
|
+
as a monospace spec sheet — ink on paper, one pure-blue accent, square corners,
|
|
24
|
+
uppercase micro-labels, tabular figures, and 1.5px hairline rules in place of
|
|
25
|
+
shadows.
|
|
23
26
|
|
|
24
27
|
## Icons
|
|
25
28
|
|
|
@@ -54,6 +57,7 @@ table to pick the icon matching a use case, for consistency across apps:
|
|
|
54
57
|
| `iconCpuChip` | 18px | System, hardware, or technical/processing content. |
|
|
55
58
|
| `iconCurrencyDollar` | 16px | Monetary values, pricing, or billing-related content. |
|
|
56
59
|
| `iconDocument` | 18px | A generic file/document icon, e.g. tile-grid's default file icon. |
|
|
60
|
+
| `iconEllipsisHorizontal` | 16px | Collapsed items in an inline sequence, e.g. breadcrumb-nav's truncated middle. |
|
|
57
61
|
| `iconEllipsisVertical` | 16px | An overflow ("kebab") menu trigger, e.g. dropdown-button's icon variant. |
|
|
58
62
|
| `iconExclamationCircle` | 16px | Error states, e.g. the error variant of toast-notification. |
|
|
59
63
|
| `iconExclamationTriangle` | 16px | Warning states, e.g. the warning variant of toast-notification. |
|
|
@@ -141,7 +145,7 @@ Import: `import "@f-ewald/components/address-autocomplete.js";`
|
|
|
141
145
|
|
|
142
146
|
Properties: `value` (attribute `value`) : string, default ""; `placeholder` (attribute `placeholder`) : string, default ""; `required` (attribute `required`) : boolean, default false; `disabled` (attribute `disabled`) : boolean, default false; `clearable` (attribute `clearable`) : boolean, default false; `types` (attribute `types`) : string, default "address"; `endpoint` (attribute `endpoint`) : string, default "https://api.mapbox.com/search/geocode/v6/forward"; `accessToken` (attribute `access-token`) : string, default ""; `bbox` (attribute `bbox`) : string, default ""; `proximity` (attribute `proximity`) : string, default ""; `debounce` (attribute `debounce`) : number, default 300; `minLength` (attribute `min-length`) : number, default 3; `suggestions` (JS property only) : AddressSuggestion[] | null, default null; `selectedSuggestion` (JS property only) : AddressSuggestion | null, default —
|
|
143
147
|
Events: `address-select`, `input`
|
|
144
|
-
CSS custom properties: `--ui-border`, `--ui-danger`, `--ui-focus-ring`, `--ui-font`, `--ui-font-size`, `--ui-font-size-sm`, `--ui-font-size-xs`, `--ui-font-weight-regular`, `--ui-line-height-tight`, `--ui-primary`, `--ui-radius-sm`, `--ui-shadow`, `--ui-surface`, `--ui-surface-muted`, `--ui-text`, `--ui-text-muted`
|
|
148
|
+
CSS custom properties: `--ui-border`, `--ui-border-width`, `--ui-danger`, `--ui-focus-ring`, `--ui-font`, `--ui-font-size`, `--ui-font-size-sm`, `--ui-font-size-xs`, `--ui-font-weight-regular`, `--ui-line-height-tight`, `--ui-primary`, `--ui-radius-sm`, `--ui-shadow`, `--ui-surface`, `--ui-surface-muted`, `--ui-text`, `--ui-text-muted`
|
|
145
149
|
|
|
146
150
|
Example:
|
|
147
151
|
```html
|
|
@@ -222,7 +226,7 @@ Import: `import "@f-ewald/components/app-shell.js";`
|
|
|
222
226
|
|
|
223
227
|
Properties: `sidebarOpen` (attribute `sidebar-open`) : boolean, default false; `sidebarMode` (attribute `sidebar-mode`) : "overlay" | "push", default "overlay"; `sidebarWidth` (attribute `sidebar-width`) : "full" | "icon", default "full"; `detailOpen` (attribute `detail-open`) : boolean, default false; `detailWidth` (attribute `detail-width`) : "compact" | "comfortable", default "compact"; `noTopbar` (attribute `no-topbar`) : boolean, default false
|
|
224
228
|
Events: `sidebar-toggle`, `detail-close`
|
|
225
|
-
CSS custom properties: `--ui-border`, `--ui-focus-ring`, `--ui-font-size-sm`, `--ui-line-height-tight`, `--ui-on-accent`, `--ui-overlay`, `--ui-radius-sm`, `--ui-shadow`, `--ui-shadow-lg`, `--ui-surface`, `--ui-surface-muted`, `--ui-text-muted`, `--ui-tooltip`
|
|
229
|
+
CSS custom properties: `--ui-border`, `--ui-border-width`, `--ui-focus-ring`, `--ui-font-size-sm`, `--ui-line-height-tight`, `--ui-on-accent`, `--ui-overlay`, `--ui-radius-sm`, `--ui-shadow`, `--ui-shadow-lg`, `--ui-surface`, `--ui-surface-muted`, `--ui-text-muted`, `--ui-tooltip`
|
|
226
230
|
|
|
227
231
|
Example:
|
|
228
232
|
```html
|
|
@@ -265,7 +269,7 @@ Import: `import "@f-ewald/components/app-sidebar.js";`
|
|
|
265
269
|
|
|
266
270
|
Properties: `collapsed` (attribute `collapsed`) : boolean, default false
|
|
267
271
|
Events: none
|
|
268
|
-
CSS custom properties: `--ui-border`, `--ui-focus-ring`, `--ui-font`, `--ui-font-size-sm`, `--ui-font-size-xs`, `--ui-font-weight-medium`, `--ui-font-weight-semibold`, `--ui-line-height-tight`, `--ui-primary`, `--ui-radius-sm`, `--ui-surface`, `--ui-surface-muted`, `--ui-text`, `--ui-text-muted`, `--ui-tracking-wide`
|
|
272
|
+
CSS custom properties: `--ui-border`, `--ui-border-width`, `--ui-focus-ring`, `--ui-font`, `--ui-font-size-sm`, `--ui-font-size-xs`, `--ui-font-weight-medium`, `--ui-font-weight-semibold`, `--ui-line-height-tight`, `--ui-primary`, `--ui-radius-sm`, `--ui-surface`, `--ui-surface-muted`, `--ui-text`, `--ui-text-muted`, `--ui-tracking-wide`
|
|
269
273
|
|
|
270
274
|
Example:
|
|
271
275
|
```html
|
|
@@ -294,7 +298,7 @@ Import: `import "@f-ewald/components/audio-player.js";`
|
|
|
294
298
|
|
|
295
299
|
Properties: `src` (attribute `src`) : string, default ""; `label` (attribute `label`) : string, default "Audio player"; `loop` (attribute `loop`) : boolean, default false; `preload` (attribute `preload`) : "none" | "metadata" | "auto", default "metadata"
|
|
296
300
|
Events: `play`, `pause`, `ended`
|
|
297
|
-
CSS custom properties: `--ui-border`, `--ui-danger`, `--ui-font`, `--ui-font-size-sm`, `--ui-radius`, `--ui-surface`, `--ui-text-muted`
|
|
301
|
+
CSS custom properties: `--ui-border`, `--ui-border-width`, `--ui-danger`, `--ui-font`, `--ui-font-size-sm`, `--ui-radius`, `--ui-surface`, `--ui-text-muted`
|
|
298
302
|
|
|
299
303
|
Example:
|
|
300
304
|
```html
|
|
@@ -364,7 +368,7 @@ Import: `import "@f-ewald/components/autocomplete-input.js";`
|
|
|
364
368
|
|
|
365
369
|
Properties: `value` (attribute `value`) : string, default ""; `placeholder` (attribute `placeholder`) : string, default ""; `required` (attribute `required`) : boolean, default false; `disabled` (attribute `disabled`) : boolean, default false; `clearable` (attribute `clearable`) : boolean, default false; `endpoint` (attribute `endpoint`) : string, default ""; `queryParam` (attribute `query-param`) : string, default "q"; `debounce` (attribute `debounce`) : number, default 300; `minLength` (attribute `min-length`) : number, default 3; `options` (JS property only) : AutocompleteOption[] | null, default null; `selectedOption` (JS property only) : AutocompleteOption | null, default —
|
|
366
370
|
Events: `option-select`, `input`
|
|
367
|
-
CSS custom properties: `--ui-border`, `--ui-danger`, `--ui-focus-ring`, `--ui-font`, `--ui-font-size`, `--ui-font-size-sm`, `--ui-font-size-xs`, `--ui-font-weight-regular`, `--ui-line-height-tight`, `--ui-primary`, `--ui-radius-sm`, `--ui-shadow`, `--ui-surface`, `--ui-surface-muted`, `--ui-text`, `--ui-text-muted`
|
|
371
|
+
CSS custom properties: `--ui-border`, `--ui-border-width`, `--ui-danger`, `--ui-focus-ring`, `--ui-font`, `--ui-font-size`, `--ui-font-size-sm`, `--ui-font-size-xs`, `--ui-font-weight-regular`, `--ui-line-height-tight`, `--ui-primary`, `--ui-radius-sm`, `--ui-shadow`, `--ui-surface`, `--ui-surface-muted`, `--ui-text`, `--ui-text-muted`
|
|
368
372
|
|
|
369
373
|
Example:
|
|
370
374
|
```html
|
|
@@ -383,6 +387,43 @@ Example:
|
|
|
383
387
|
</script>
|
|
384
388
|
```
|
|
385
389
|
|
|
390
|
+
## <breadcrumb-nav>
|
|
391
|
+
|
|
392
|
+
A breadcrumb trail: a `<nav aria-label="Breadcrumb">` wrapping an ordered
|
|
393
|
+
list, with chevron separators and the current page rendered as plain,
|
|
394
|
+
non-interactive text. Designed to drop into `page-header`'s `breadcrumb`
|
|
395
|
+
slot, but usable on its own anywhere a trail is needed.
|
|
396
|
+
|
|
397
|
+
The last `items` entry is always treated as the current page: it renders as
|
|
398
|
+
text with `aria-current="page"` even if it carries an `href`. Middle entries
|
|
399
|
+
without an `href` render as plain text too; only middle entries with an
|
|
400
|
+
`href` are real anchors.
|
|
401
|
+
|
|
402
|
+
When `max-visible` is greater than zero and the trail is longer than that,
|
|
403
|
+
the middle collapses behind an overflow button that always keeps the first
|
|
404
|
+
and current crumbs visible; activating it toggles `expanded` to reveal the
|
|
405
|
+
hidden crumbs in place.
|
|
406
|
+
|
|
407
|
+
Import: `import "@f-ewald/components/breadcrumb-nav.js";`
|
|
408
|
+
|
|
409
|
+
Properties: `items` (attribute `items`) : BreadcrumbItem[], default []; `maxVisible` (attribute `max-visible`) : number, default 0; `expanded` (attribute `expanded`) : boolean, default false
|
|
410
|
+
Events: `breadcrumb-navigate`
|
|
411
|
+
CSS custom properties: `--ui-focus-ring`, `--ui-font`, `--ui-font-size-sm`, `--ui-font-weight-medium`, `--ui-font-weight-regular`, `--ui-line-height-glyph`, `--ui-line-height-tight`, `--ui-radius-sm`, `--ui-text`, `--ui-text-muted`
|
|
412
|
+
|
|
413
|
+
Example:
|
|
414
|
+
```html
|
|
415
|
+
<breadcrumb-nav></breadcrumb-nav>
|
|
416
|
+
<script type="module">
|
|
417
|
+
const trail = document.querySelector("breadcrumb-nav");
|
|
418
|
+
trail.items = [
|
|
419
|
+
{ label: "Home", href: "/" },
|
|
420
|
+
{ label: "Settings", href: "/settings" },
|
|
421
|
+
{ label: "Members" },
|
|
422
|
+
];
|
|
423
|
+
trail.addEventListener("breadcrumb-navigate", (e) => console.log(e.detail.item.label, e.detail.index));
|
|
424
|
+
</script>
|
|
425
|
+
```
|
|
426
|
+
|
|
386
427
|
## <button-group>
|
|
387
428
|
|
|
388
429
|
Single-select segmented control — a strip of buttons joined into one
|
|
@@ -406,7 +447,7 @@ Import: `import "@f-ewald/components/button-group.js";`
|
|
|
406
447
|
|
|
407
448
|
Properties: `options` (JS property only) : ButtonGroupOption[], default []; `value` (attribute `value`) : string, default ""; `disabled` (attribute `disabled`) : boolean, default false; `iconOnly` (attribute `icon-only`) : boolean, default false; `size` (attribute `size`) : "sm" | "md", default "md"
|
|
408
449
|
Events: `change`
|
|
409
|
-
CSS custom properties: `--ui-border`, `--ui-button-background`, `--ui-button-highlight`, `--ui-button-secondary-background`, `--ui-button-secondary-background-active`, `--ui-button-secondary-surface-muted`, `--ui-button-text-shadow`, `--ui-focus-ring`, `--ui-font`, `--ui-font-size-sm`, `--ui-font-size-xs`, `--ui-font-weight-medium`, `--ui-line-height-tight`, `--ui-on-accent`, `--ui-primary`, `--ui-radius-sm`, `--ui-surface-muted`, `--ui-text`
|
|
450
|
+
CSS custom properties: `--ui-border`, `--ui-border-width`, `--ui-button-background`, `--ui-button-highlight`, `--ui-button-secondary-background`, `--ui-button-secondary-background-active`, `--ui-button-secondary-surface-muted`, `--ui-button-text-shadow`, `--ui-focus-ring`, `--ui-font`, `--ui-font-size-sm`, `--ui-font-size-xs`, `--ui-font-weight-medium`, `--ui-line-height-tight`, `--ui-on-accent`, `--ui-primary`, `--ui-radius-sm`, `--ui-surface-muted`, `--ui-text`
|
|
410
451
|
|
|
411
452
|
Example:
|
|
412
453
|
```html
|
|
@@ -440,7 +481,7 @@ Import: `import "@f-ewald/components/calendar-day.js";`
|
|
|
440
481
|
|
|
441
482
|
Properties: `date` (attribute `date`) : string, default —; `timeMarker` (attribute `time-marker`) : boolean, default false; `minWidth` (attribute `min-width`) : string, default ""
|
|
442
483
|
Events: none
|
|
443
|
-
CSS custom properties: `--ui-border`, `--ui-danger`, `--ui-focus-ring`, `--ui-font`, `--ui-font-size-lg`, `--ui-font-size-sm`, `--ui-font-size-xs`, `--ui-font-weight-medium`, `--ui-font-weight-regular`, `--ui-font-weight-semibold`, `--ui-hover-overlay`, `--ui-info`, `--ui-line-height-tight`, `--ui-on-accent`, `--ui-primary`, `--ui-radius-pill`, `--ui-radius-sm`, `--ui-success`, `--ui-surface`, `--ui-surface-muted`, `--ui-text`, `--ui-text-muted`, `--ui-warning`
|
|
484
|
+
CSS custom properties: `--ui-border`, `--ui-border-width`, `--ui-danger`, `--ui-focus-ring`, `--ui-font`, `--ui-font-size-lg`, `--ui-font-size-sm`, `--ui-font-size-xs`, `--ui-font-weight-medium`, `--ui-font-weight-regular`, `--ui-font-weight-semibold`, `--ui-hover-overlay`, `--ui-info`, `--ui-line-height-tight`, `--ui-on-accent`, `--ui-primary`, `--ui-radius-pill`, `--ui-radius-sm`, `--ui-success`, `--ui-surface`, `--ui-surface-muted`, `--ui-text`, `--ui-text-muted`, `--ui-warning`
|
|
444
485
|
|
|
445
486
|
Example:
|
|
446
487
|
```html
|
|
@@ -504,7 +545,7 @@ Import: `import "@f-ewald/components/calendar-month.js";`
|
|
|
504
545
|
|
|
505
546
|
Properties: `year` (attribute `year`) : number, default —; `month` (attribute `month`) : number, default 1
|
|
506
547
|
Events: none
|
|
507
|
-
CSS custom properties: `--ui-border`, `--ui-danger`, `--ui-focus-ring`, `--ui-font`, `--ui-font-size-lg`, `--ui-font-size-sm`, `--ui-font-size-xs`, `--ui-font-weight-bold`, `--ui-font-weight-medium`, `--ui-font-weight-regular`, `--ui-font-weight-semibold`, `--ui-hover-overlay`, `--ui-info`, `--ui-line-height-tight`, `--ui-primary`, `--ui-radius-sm`, `--ui-success`, `--ui-surface`, `--ui-surface-muted`, `--ui-text`, `--ui-text-muted`, `--ui-warning`
|
|
548
|
+
CSS custom properties: `--ui-border`, `--ui-border-width`, `--ui-danger`, `--ui-focus-ring`, `--ui-font`, `--ui-font-size-lg`, `--ui-font-size-sm`, `--ui-font-size-xs`, `--ui-font-weight-bold`, `--ui-font-weight-medium`, `--ui-font-weight-regular`, `--ui-font-weight-semibold`, `--ui-hover-overlay`, `--ui-info`, `--ui-line-height-tight`, `--ui-primary`, `--ui-radius-sm`, `--ui-success`, `--ui-surface`, `--ui-surface-muted`, `--ui-text`, `--ui-text-muted`, `--ui-warning`
|
|
508
549
|
|
|
509
550
|
Example:
|
|
510
551
|
```html
|
|
@@ -545,7 +586,7 @@ Import: `import "@f-ewald/components/calendar-week.js";`
|
|
|
545
586
|
|
|
546
587
|
Properties: `date` (attribute `date`) : string, default —
|
|
547
588
|
Events: none
|
|
548
|
-
CSS custom properties: `--ui-border`, `--ui-danger`, `--ui-focus-ring`, `--ui-font`, `--ui-font-size-lg`, `--ui-font-size-sm`, `--ui-font-size-xs`, `--ui-font-weight-medium`, `--ui-font-weight-regular`, `--ui-font-weight-semibold`, `--ui-hover-overlay`, `--ui-info`, `--ui-primary`, `--ui-radius-sm`, `--ui-success`, `--ui-surface`, `--ui-text`, `--ui-text-muted`, `--ui-warning`
|
|
589
|
+
CSS custom properties: `--ui-border`, `--ui-border-width`, `--ui-danger`, `--ui-focus-ring`, `--ui-font`, `--ui-font-size-lg`, `--ui-font-size-sm`, `--ui-font-size-xs`, `--ui-font-weight-medium`, `--ui-font-weight-regular`, `--ui-font-weight-semibold`, `--ui-hover-overlay`, `--ui-info`, `--ui-primary`, `--ui-radius-sm`, `--ui-success`, `--ui-surface`, `--ui-text`, `--ui-text-muted`, `--ui-warning`
|
|
549
590
|
|
|
550
591
|
Example:
|
|
551
592
|
```html
|
|
@@ -626,7 +667,7 @@ Import: `import "@f-ewald/components/chat-message.js";`
|
|
|
626
667
|
|
|
627
668
|
Properties: `role` (attribute `role`) : ChatMessageRole, default "agent"; `variant` (attribute `variant`) : ChatMessageVariant, default "normal"; `author` (attribute `author`) : string, default ""; `timestamp` (attribute `timestamp`) : string | null, default null; `summary` (attribute `summary`) : string, default ""; `collapsible` (attribute `collapsible`) : boolean, default false; `collapsed` (attribute `collapsed`) : boolean, default false
|
|
628
669
|
Events: `toggle`
|
|
629
|
-
CSS custom properties: `--ui-border`, `--ui-focus-ring`, `--ui-font`, `--ui-font-mono`, `--ui-font-size`, `--ui-font-size-sm`, `--ui-font-weight-semibold`, `--ui-line-height-normal`, `--ui-primary`, `--ui-radius`, `--ui-radius-sm`, `--ui-surface`, `--ui-text`, `--ui-text-muted`
|
|
670
|
+
CSS custom properties: `--ui-border`, `--ui-border-width`, `--ui-focus-ring`, `--ui-font`, `--ui-font-mono`, `--ui-font-size`, `--ui-font-size-sm`, `--ui-font-weight-semibold`, `--ui-line-height-normal`, `--ui-primary`, `--ui-radius`, `--ui-radius-sm`, `--ui-surface`, `--ui-text`, `--ui-text-muted`
|
|
630
671
|
|
|
631
672
|
Example:
|
|
632
673
|
```html
|
|
@@ -689,7 +730,7 @@ Import: `import "@f-ewald/components/comment-composer.js";`
|
|
|
689
730
|
|
|
690
731
|
Properties: `value` (attribute `value`) : string, default ""; `placeholder` (attribute `placeholder`) : string, default "Add a comment…"; `label` (attribute `label`) : string, default "Comment"; `rows` (attribute `rows`) : number, default 4; `submitLabel` (attribute `submit-label`) : string, default "Submit"; `cancelLabel` (attribute `cancel-label`) : string, default "Cancel"; `disabled` (attribute `disabled`) : boolean, default false
|
|
691
732
|
Events: `cancel`, `submit`
|
|
692
|
-
CSS custom properties: `--ui-border`, `--ui-focus-ring`, `--ui-font`, `--ui-font-size`, `--ui-line-height-normal`, `--ui-radius`, `--ui-radius-sm`, `--ui-surface`, `--ui-text`
|
|
733
|
+
CSS custom properties: `--ui-border`, `--ui-border-width`, `--ui-focus-ring`, `--ui-font`, `--ui-font-size`, `--ui-line-height-normal`, `--ui-radius`, `--ui-radius-sm`, `--ui-surface`, `--ui-text`
|
|
693
734
|
|
|
694
735
|
Example:
|
|
695
736
|
```html
|
|
@@ -714,7 +755,7 @@ Import: `import "@f-ewald/components/confirm-dialog.js";`
|
|
|
714
755
|
|
|
715
756
|
Properties: `open` (attribute `open`) : boolean, default false; `confirmLabel` (attribute `confirm-label`) : string, default "Delete"; `cancelLabel` (attribute `cancel-label`) : string, default "Cancel"; `danger` (attribute `danger`) : boolean, default true; `busy` (attribute `busy`) : boolean, default false; `error` (attribute `error`) : string | null, default null; `size` (attribute `size`) : "sm" | "md", default "md"
|
|
716
757
|
Events: `confirm`, `cancel`
|
|
717
|
-
CSS custom properties: `--ui-border`, `--ui-button-background`, `--ui-button-background-active`, `--ui-button-background-hover`, `--ui-button-border`, `--ui-button-danger-background`, `--ui-button-danger-background-active`, `--ui-button-danger-background-hover`, `--ui-button-danger-border`, `--ui-button-highlight`, `--ui-button-secondary-background`, `--ui-button-secondary-background-active`, `--ui-button-secondary-background-hover`, `--ui-button-secondary-border`, `--ui-button-secondary-border-hover`, `--ui-button-text-shadow`, `--ui-danger`, `--ui-danger-hover`, `--ui-focus-ring`, `--ui-font`, `--ui-font-size`, `--ui-font-size-sm`, `--ui-font-size-xs`, `--ui-font-weight-medium`, `--ui-line-height-normal`, `--ui-line-height-tight`, `--ui-on-accent`, `--ui-overlay`, `--ui-primary`, `--ui-primary-hover`, `--ui-radius`, `--ui-radius-sm`, `--ui-shadow-lg`, `--ui-surface`, `--ui-text`, `--ui-text-muted`
|
|
758
|
+
CSS custom properties: `--ui-border`, `--ui-border-width`, `--ui-button-background`, `--ui-button-background-active`, `--ui-button-background-hover`, `--ui-button-border`, `--ui-button-danger-background`, `--ui-button-danger-background-active`, `--ui-button-danger-background-hover`, `--ui-button-danger-border`, `--ui-button-highlight`, `--ui-button-secondary-background`, `--ui-button-secondary-background-active`, `--ui-button-secondary-background-hover`, `--ui-button-secondary-border`, `--ui-button-secondary-border-hover`, `--ui-button-text-shadow`, `--ui-danger`, `--ui-danger-hover`, `--ui-focus-ring`, `--ui-font`, `--ui-font-size`, `--ui-font-size-sm`, `--ui-font-size-xs`, `--ui-font-weight-medium`, `--ui-line-height-normal`, `--ui-line-height-tight`, `--ui-on-accent`, `--ui-overlay`, `--ui-primary`, `--ui-primary-hover`, `--ui-radius`, `--ui-radius-sm`, `--ui-shadow-lg`, `--ui-surface`, `--ui-text`, `--ui-text-muted`
|
|
718
759
|
|
|
719
760
|
Example:
|
|
720
761
|
```html
|
|
@@ -741,7 +782,7 @@ Import: `import "@f-ewald/components/content-divider.js";`
|
|
|
741
782
|
|
|
742
783
|
Properties: `label` (attribute `label`) : string, default ""
|
|
743
784
|
Events: none
|
|
744
|
-
CSS custom properties: `--ui-border`, `--ui-font`, `--ui-font-size-sm`, `--ui-font-weight-medium`, `--ui-line-height-tight`, `--ui-text-muted`
|
|
785
|
+
CSS custom properties: `--ui-border`, `--ui-border-width`, `--ui-font`, `--ui-font-size-sm`, `--ui-font-weight-medium`, `--ui-line-height-tight`, `--ui-text-muted`
|
|
745
786
|
|
|
746
787
|
Example:
|
|
747
788
|
```html
|
|
@@ -814,7 +855,7 @@ Import: `import "@f-ewald/components/cron-schedule.js";`
|
|
|
814
855
|
|
|
815
856
|
Properties: `value` (attribute `value`) : string, default "0 * * * *"; `label` (attribute `label`) : string, default ""; `disabled` (attribute `disabled`) : boolean, default false; `open` (attribute `open`) : boolean, default false; `description` (JS property only) : string, default —
|
|
816
857
|
Events: `change`
|
|
817
|
-
CSS custom properties: `--ui-border`, `--ui-focus-ring`, `--ui-font`, `--ui-font-mono`, `--ui-font-size-sm`, `--ui-font-size-xs`, `--ui-font-weight-medium`, `--ui-line-height-tight`, `--ui-primary`, `--ui-radius`, `--ui-radius-sm`, `--ui-shadow-lg`, `--ui-surface`, `--ui-surface-muted`, `--ui-text`, `--ui-text-muted`, `--ui-tracking-wide`
|
|
858
|
+
CSS custom properties: `--ui-border`, `--ui-border-width`, `--ui-focus-ring`, `--ui-font`, `--ui-font-mono`, `--ui-font-size-sm`, `--ui-font-size-xs`, `--ui-font-weight-medium`, `--ui-label-transform`, `--ui-line-height-tight`, `--ui-primary`, `--ui-radius`, `--ui-radius-sm`, `--ui-shadow-lg`, `--ui-surface`, `--ui-surface-muted`, `--ui-text`, `--ui-text-muted`, `--ui-tracking-wide`
|
|
818
859
|
|
|
819
860
|
Example:
|
|
820
861
|
```html
|
|
@@ -843,7 +884,7 @@ Import: `import "@f-ewald/components/data-table.js";`
|
|
|
843
884
|
|
|
844
885
|
Properties: `columns` (JS property only) : DataTableColumn[], default []; `rows` (JS property only) : unknown[], default []; `rowKey` (JS property only) : (row: unknown, index: number) => string | number, default —; `renderCell` (JS property only) : (row: unknown, key: string) => unknown, default —; `rowHref` (JS property only) : ((row: unknown) => string | null) | null, default null; `rowLabel` (JS property only) : ((row: unknown) => string) | null, default null
|
|
845
886
|
Events: none
|
|
846
|
-
CSS custom properties: `--ui-border`, `--ui-focus-ring`, `--ui-font`, `--ui-font-size-sm`, `--ui-font-weight-semibold`, `--ui-surface-muted`, `--ui-text`, `--ui-text-muted`
|
|
887
|
+
CSS custom properties: `--ui-border`, `--ui-border-width`, `--ui-focus-ring`, `--ui-font`, `--ui-font-size-sm`, `--ui-font-weight-semibold`, `--ui-label-transform`, `--ui-surface-muted`, `--ui-text`, `--ui-text-muted`
|
|
847
888
|
|
|
848
889
|
Example:
|
|
849
890
|
```html
|
|
@@ -928,7 +969,7 @@ Import: `import "@f-ewald/components/dropdown-button.js";`
|
|
|
928
969
|
|
|
929
970
|
Properties: `label` (attribute `label`) : string, default ""; `options` (JS property only) : DropdownOption[], default []; `disabled` (attribute `disabled`) : boolean, default false; `variant` (attribute `variant`) : DropdownButtonVariant, default "text"; `icon` (JS property only) : TemplateResult | null, default null; `size` (attribute `size`) : "sm" | "md", default "md"; `circular` (attribute `circular`) : boolean, default false
|
|
930
971
|
Events: `select`
|
|
931
|
-
CSS custom properties: `--ui-border`, `--ui-button-background`, `--ui-button-background-active`, `--ui-button-background-hover`, `--ui-button-border`, `--ui-button-highlight`, `--ui-button-text-shadow`, `--ui-danger`, `--ui-danger-hover`, `--ui-focus-ring`, `--ui-font`, `--ui-font-size-sm`, `--ui-font-size-xs`, `--ui-font-weight-medium`, `--ui-line-height-tight`, `--ui-on-accent`, `--ui-primary`, `--ui-primary-hover`, `--ui-radius-circle`, `--ui-radius-sm`, `--ui-shadow`, `--ui-surface`, `--ui-surface-muted`, `--ui-text`, `--ui-text-muted`
|
|
972
|
+
CSS custom properties: `--ui-border`, `--ui-border-width`, `--ui-button-background`, `--ui-button-background-active`, `--ui-button-background-hover`, `--ui-button-border`, `--ui-button-highlight`, `--ui-button-text-shadow`, `--ui-danger`, `--ui-danger-hover`, `--ui-focus-ring`, `--ui-font`, `--ui-font-size-sm`, `--ui-font-size-xs`, `--ui-font-weight-medium`, `--ui-line-height-tight`, `--ui-on-accent`, `--ui-primary`, `--ui-primary-hover`, `--ui-radius-circle`, `--ui-radius-sm`, `--ui-shadow`, `--ui-surface`, `--ui-surface-muted`, `--ui-text`, `--ui-text-muted`
|
|
932
973
|
|
|
933
974
|
Example:
|
|
934
975
|
```html
|
|
@@ -963,7 +1004,7 @@ Import: `import "@f-ewald/components/editable-text.js";`
|
|
|
963
1004
|
|
|
964
1005
|
Properties: `value` (attribute `value`) : string, default ""; `multiline` (attribute `multiline`) : boolean, default false; `placeholder` (attribute `placeholder`) : string, default ""; `readonly` (attribute `readonly`) : boolean, default false; `label` (attribute `label`) : string, default ""
|
|
965
1006
|
Events: `change`
|
|
966
|
-
CSS custom properties: `--ui-border`, `--ui-focus-ring`, `--ui-primary`, `--ui-radius-sm`, `--ui-surface`, `--ui-surface-muted`, `--ui-text-muted`
|
|
1007
|
+
CSS custom properties: `--ui-border`, `--ui-border-width`, `--ui-focus-ring`, `--ui-primary`, `--ui-radius-sm`, `--ui-surface`, `--ui-surface-muted`, `--ui-text-muted`
|
|
967
1008
|
|
|
968
1009
|
Example:
|
|
969
1010
|
```html
|
|
@@ -971,6 +1012,30 @@ Example:
|
|
|
971
1012
|
<editable-text multiline placeholder="Add a description…" label="Description"></editable-text>
|
|
972
1013
|
```
|
|
973
1014
|
|
|
1015
|
+
## <empty-state>
|
|
1016
|
+
|
|
1017
|
+
A centered placeholder for an empty list, an empty panel, or a zero-result
|
|
1018
|
+
search: an optional leading glyph, a heading, a supporting line (or richer
|
|
1019
|
+
slotted body), and an optional call-to-action row. Purely presentational —
|
|
1020
|
+
it carries no interactive state of its own and no ARIA `role`; it is a
|
|
1021
|
+
region of content, not a live status. Every optional part collapses
|
|
1022
|
+
completely when absent, reserving no layout space.
|
|
1023
|
+
|
|
1024
|
+
Import: `import "@f-ewald/components/empty-state.js";`
|
|
1025
|
+
|
|
1026
|
+
Properties: `heading` (attribute `heading`) : string, default ""; `description` (attribute `description`) : string, default ""; `size` (attribute `size`) : "sm" | "md", default "md"
|
|
1027
|
+
Events: none
|
|
1028
|
+
CSS custom properties: `--ui-font`, `--ui-font-size`, `--ui-font-size-lg`, `--ui-font-size-sm`, `--ui-font-weight-regular`, `--ui-font-weight-semibold`, `--ui-line-height-normal`, `--ui-line-height-tight`, `--ui-text`, `--ui-text-muted`
|
|
1029
|
+
|
|
1030
|
+
Example:
|
|
1031
|
+
```html
|
|
1032
|
+
<empty-state heading="No results found" description="Try adjusting your search or filters.">
|
|
1033
|
+
<span slot="icon">...</span>
|
|
1034
|
+
<ui-button slot="actions" variant="primary">Clear filters</ui-button>
|
|
1035
|
+
</empty-state>
|
|
1036
|
+
<empty-state size="sm" heading="No pinned items"></empty-state>
|
|
1037
|
+
```
|
|
1038
|
+
|
|
974
1039
|
## <form-actions>
|
|
975
1040
|
|
|
976
1041
|
Form footer button bar with a fixed action order for internal apps: the
|
|
@@ -1024,7 +1089,7 @@ Import: `import "@f-ewald/components/form-field.js";`
|
|
|
1024
1089
|
|
|
1025
1090
|
Properties: `label` (attribute `label`) : string, default ""; `hint` (attribute `hint`) : string, default ""; `error` (attribute `error`) : string, default ""; `required` (attribute `required`) : boolean, default false; `floatingLabel` (attribute `floating-label`) : boolean, default false
|
|
1026
1091
|
Events: none
|
|
1027
|
-
CSS custom properties: `--ui-border`, `--ui-danger`, `--ui-focus-ring`, `--ui-font`, `--ui-font-size`, `--ui-font-size-sm`, `--ui-font-size-xs`, `--ui-font-weight-medium`, `--ui-font-weight-regular`, `--ui-line-height-normal`, `--ui-line-height-tight`, `--ui-primary`, `--ui-radius-sm`, `--ui-surface`, `--ui-text`, `--ui-text-muted`
|
|
1092
|
+
CSS custom properties: `--ui-border`, `--ui-border-width`, `--ui-danger`, `--ui-focus-ring`, `--ui-font`, `--ui-font-size`, `--ui-font-size-sm`, `--ui-font-size-xs`, `--ui-font-weight-medium`, `--ui-font-weight-regular`, `--ui-line-height-normal`, `--ui-line-height-tight`, `--ui-primary`, `--ui-radius-sm`, `--ui-surface`, `--ui-text`, `--ui-text-muted`
|
|
1028
1093
|
|
|
1029
1094
|
Example:
|
|
1030
1095
|
```html
|
|
@@ -1068,7 +1133,7 @@ Import: `import "@f-ewald/components/form-select.js";`
|
|
|
1068
1133
|
|
|
1069
1134
|
Properties: `options` (JS property only) : SelectOption[], default []; `value` (attribute `value`) : string, default ""; `label` (attribute `label`) : string, default ""; `disabled` (attribute `disabled`) : boolean, default false; `searchable` (attribute `searchable`) : boolean, default false
|
|
1070
1135
|
Events: `change`
|
|
1071
|
-
CSS custom properties: `--ui-border`, `--ui-focus-ring`, `--ui-font`, `--ui-font-size`, `--ui-font-weight-semibold`, `--ui-line-height-tight`, `--ui-primary`, `--ui-radius-pill`, `--ui-radius-sm`, `--ui-shadow`, `--ui-surface`, `--ui-surface-muted`, `--ui-text`, `--ui-text-muted`
|
|
1136
|
+
CSS custom properties: `--ui-border`, `--ui-border-width`, `--ui-focus-ring`, `--ui-font`, `--ui-font-size`, `--ui-font-weight-semibold`, `--ui-line-height-tight`, `--ui-primary`, `--ui-radius-pill`, `--ui-radius-sm`, `--ui-shadow`, `--ui-surface`, `--ui-surface-muted`, `--ui-text`, `--ui-text-muted`
|
|
1072
1137
|
|
|
1073
1138
|
Example:
|
|
1074
1139
|
```html
|
|
@@ -1100,7 +1165,7 @@ Import: `import "@f-ewald/components/frame-box.js";`
|
|
|
1100
1165
|
|
|
1101
1166
|
Properties: `label` (attribute `label`) : string, default ""
|
|
1102
1167
|
Events: none
|
|
1103
|
-
CSS custom properties: `--ui-border`, `--ui-font`, `--ui-font-size-xs`, `--ui-font-weight-semibold`, `--ui-radius`, `--ui-surface`, `--ui-text-muted`, `--ui-tracking-wide`
|
|
1168
|
+
CSS custom properties: `--ui-border`, `--ui-border-width`, `--ui-font`, `--ui-font-size-xs`, `--ui-font-weight-semibold`, `--ui-radius`, `--ui-surface`, `--ui-text-muted`, `--ui-tracking-wide`
|
|
1104
1169
|
|
|
1105
1170
|
Example:
|
|
1106
1171
|
```html
|
|
@@ -1128,7 +1193,7 @@ Import: `import "@f-ewald/components/fullscreen-button.js";`
|
|
|
1128
1193
|
|
|
1129
1194
|
Properties: `target` (JS property only) : HTMLElement | null, default null; `enterLabel` (attribute `enter-label`) : string, default "Enter full screen"; `exitLabel` (attribute `exit-label`) : string, default "Exit full screen"
|
|
1130
1195
|
Events: `fullscreen-change`
|
|
1131
|
-
CSS custom properties: `--ui-border`, `--ui-button-highlight`, `--ui-button-secondary-`, `--ui-button-secondary-background`, `--ui-button-secondary-background-active`, `--ui-button-secondary-background-hover`, `--ui-button-secondary-border`, `--ui-button-secondary-border-hover`, `--ui-focus-ring`, `--ui-line-height-glyph`, `--ui-radius-sm`, `--ui-shadow`, `--ui-surface`, `--ui-surface-muted`, `--ui-text`, `--ui-text-muted`
|
|
1196
|
+
CSS custom properties: `--ui-border`, `--ui-border-width`, `--ui-button-highlight`, `--ui-button-secondary-`, `--ui-button-secondary-background`, `--ui-button-secondary-background-active`, `--ui-button-secondary-background-hover`, `--ui-button-secondary-border`, `--ui-button-secondary-border-hover`, `--ui-focus-ring`, `--ui-line-height-glyph`, `--ui-radius-sm`, `--ui-shadow`, `--ui-surface`, `--ui-surface-muted`, `--ui-text`, `--ui-text-muted`
|
|
1132
1197
|
|
|
1133
1198
|
Example:
|
|
1134
1199
|
```html
|
|
@@ -1284,7 +1349,7 @@ Import: `import "@f-ewald/components/kanban-card.js";`
|
|
|
1284
1349
|
|
|
1285
1350
|
Properties: `ticket` (attribute `ticket`) : string, default ""; `heading` (attribute `heading`) : string, default ""
|
|
1286
1351
|
Events: none
|
|
1287
|
-
CSS custom properties: `--ui-border`, `--ui-focus-ring`, `--ui-font`, `--ui-font-size`, `--ui-font-size-sm`, `--ui-font-weight-medium`, `--ui-highlight`, `--ui-line-height-tight`, `--ui-primary`, `--ui-radius`, `--ui-shadow`, `--ui-surface`, `--ui-text`, `--ui-text-muted`
|
|
1352
|
+
CSS custom properties: `--ui-border`, `--ui-border-width`, `--ui-focus-ring`, `--ui-font`, `--ui-font-size`, `--ui-font-size-sm`, `--ui-font-weight-medium`, `--ui-highlight`, `--ui-line-height-tight`, `--ui-primary`, `--ui-radius`, `--ui-shadow`, `--ui-surface`, `--ui-text`, `--ui-text-muted`
|
|
1288
1353
|
|
|
1289
1354
|
Example:
|
|
1290
1355
|
```html
|
|
@@ -1304,7 +1369,7 @@ Import: `import "@f-ewald/components/kanban-column.js";`
|
|
|
1304
1369
|
|
|
1305
1370
|
Properties: `heading` (attribute `heading`) : string, default ""; `count` (attribute `count`) : number, default 0; `dragover` (attribute `dragover`) : boolean, default false; `empty` (attribute `empty`) : boolean, default false
|
|
1306
1371
|
Events: none
|
|
1307
|
-
CSS custom properties: `--ui-border`, `--ui-font`, `--ui-font-size`, `--ui-font-size-sm`, `--ui-font-size-xs`, `--ui-font-weight-medium`, `--ui-font-weight-semibold`, `--ui-line-height-glyph`, `--ui-line-height-tight`, `--ui-primary`, `--ui-radius`, `--ui-radius-pill`, `--ui-radius-sm`, `--ui-surface`, `--ui-surface-muted`, `--ui-text`, `--ui-text-muted`
|
|
1372
|
+
CSS custom properties: `--ui-border`, `--ui-border-width`, `--ui-font`, `--ui-font-size`, `--ui-font-size-sm`, `--ui-font-size-xs`, `--ui-font-weight-medium`, `--ui-font-weight-semibold`, `--ui-line-height-glyph`, `--ui-line-height-tight`, `--ui-primary`, `--ui-radius`, `--ui-radius-pill`, `--ui-radius-sm`, `--ui-surface`, `--ui-surface-muted`, `--ui-text`, `--ui-text-muted`
|
|
1308
1373
|
|
|
1309
1374
|
Example:
|
|
1310
1375
|
```html
|
|
@@ -1322,7 +1387,7 @@ Import: `import "@f-ewald/components/kbd-hint.js";`
|
|
|
1322
1387
|
|
|
1323
1388
|
Properties: `keys` (attribute `keys`) : string, default ""; `platform` (attribute `platform`) : KbdPlatform, default "auto"
|
|
1324
1389
|
Events: none
|
|
1325
|
-
CSS custom properties: `--ui-font-mono`, `--ui-font-size-xs`, `--ui-line-height-glyph`, `--ui-radius-sm`
|
|
1390
|
+
CSS custom properties: `--ui-border-width`, `--ui-font-mono`, `--ui-font-size-xs`, `--ui-line-height-glyph`, `--ui-radius-sm`
|
|
1326
1391
|
|
|
1327
1392
|
Example:
|
|
1328
1393
|
```html
|
|
@@ -1342,7 +1407,7 @@ Import: `import "@f-ewald/components/link-card.js";`
|
|
|
1342
1407
|
|
|
1343
1408
|
Properties: `heading` (attribute `heading`) : string, default ""; `description` (attribute `description`) : string, default ""; `href` (attribute `href`) : string, default ""; `logo` (attribute `logo`) : string, default ""; `status` (attribute `status`) : LinkCardStatus, default ""
|
|
1344
1409
|
Events: none
|
|
1345
|
-
CSS custom properties: `--ui-border`, `--ui-danger`, `--ui-focus-ring`, `--ui-font`, `--ui-font-size`, `--ui-font-size-lg`, `--ui-font-weight-semibold`, `--ui-line-height-normal`, `--ui-line-height-tight`, `--ui-radius`, `--ui-radius-pill`, `--ui-shadow`, `--ui-success`, `--ui-surface`, `--ui-surface-muted`, `--ui-text`, `--ui-text-muted`
|
|
1410
|
+
CSS custom properties: `--ui-border`, `--ui-border-width`, `--ui-danger`, `--ui-focus-ring`, `--ui-font`, `--ui-font-size`, `--ui-font-size-lg`, `--ui-font-weight-semibold`, `--ui-line-height-normal`, `--ui-line-height-tight`, `--ui-radius`, `--ui-radius-pill`, `--ui-shadow`, `--ui-success`, `--ui-surface`, `--ui-surface-muted`, `--ui-text`, `--ui-text-muted`
|
|
1346
1411
|
|
|
1347
1412
|
Example:
|
|
1348
1413
|
```html
|
|
@@ -1567,7 +1632,7 @@ Import: `import "@f-ewald/components/markdown-view.js";`
|
|
|
1567
1632
|
|
|
1568
1633
|
Properties: `markdown` (attribute `markdown`) : string, default ""
|
|
1569
1634
|
Events: none
|
|
1570
|
-
CSS custom properties: `--ui-border`, `--ui-font`, `--ui-font-mono`, `--ui-font-size`, `--ui-font-size-lg`, `--ui-font-size-sm`, `--ui-font-weight-semibold`, `--ui-line-height-normal`, `--ui-line-height-tight`, `--ui-primary`, `--ui-primary-hover`, `--ui-radius-sm`, `--ui-surface-muted`, `--ui-text`, `--ui-text-muted`
|
|
1635
|
+
CSS custom properties: `--ui-border`, `--ui-border-width`, `--ui-font`, `--ui-font-mono`, `--ui-font-size`, `--ui-font-size-lg`, `--ui-font-size-sm`, `--ui-font-weight-semibold`, `--ui-line-height-normal`, `--ui-line-height-tight`, `--ui-primary`, `--ui-primary-hover`, `--ui-radius-sm`, `--ui-surface-muted`, `--ui-text`, `--ui-text-muted`
|
|
1571
1636
|
|
|
1572
1637
|
Example:
|
|
1573
1638
|
```html
|
|
@@ -1607,7 +1672,7 @@ Import: `import "@f-ewald/components/modal-dialog.js";`
|
|
|
1607
1672
|
|
|
1608
1673
|
Properties: `open` (attribute `open`) : boolean, default false; `heading` (attribute `heading`) : string, default ""; `size` (attribute `size`) : ModalDialogSize, default "default"; `dismissible` (attribute `dismissible`) : boolean, default false
|
|
1609
1674
|
Events: `panel-close`
|
|
1610
|
-
CSS custom properties: `--ui-border`, `--ui-focus-ring`, `--ui-font`, `--ui-font-size-lg`, `--ui-font-weight-semibold`, `--ui-line-height-tight`, `--ui-overlay`, `--ui-radius`, `--ui-radius-sm`, `--ui-shadow-lg`, `--ui-surface`, `--ui-surface-muted`, `--ui-text`, `--ui-text-muted`
|
|
1675
|
+
CSS custom properties: `--ui-border`, `--ui-border-width`, `--ui-focus-ring`, `--ui-font`, `--ui-font-size-lg`, `--ui-font-weight-semibold`, `--ui-line-height-tight`, `--ui-overlay`, `--ui-radius`, `--ui-radius-sm`, `--ui-shadow-lg`, `--ui-surface`, `--ui-surface-muted`, `--ui-text`, `--ui-text-muted`
|
|
1611
1676
|
|
|
1612
1677
|
Example:
|
|
1613
1678
|
```html
|
|
@@ -1662,7 +1727,7 @@ Import: `import "@f-ewald/components/multi-select.js";`
|
|
|
1662
1727
|
|
|
1663
1728
|
Properties: `options` (JS property only) : MultiSelectOption[], default []; `values` (JS property only) : string[], default []; `name` (attribute `name`) : string, default ""; `label` (attribute `label`) : string, default ""; `placeholder` (attribute `placeholder`) : string, default "Select options"; `disabled` (attribute `disabled`) : boolean, default false; `required` (attribute `required`) : boolean, default false; `searchable` (attribute `searchable`) : boolean, default false; `max` (attribute `max`) : number, default 0; `variant` (attribute `variant`) : MultiSelectVariant, default "dropdown"; `visibleRows` (attribute `visible-rows`) : number, default 5; `showChips` (attribute `show-chips`) : boolean, default false
|
|
1664
1729
|
Events: `change`
|
|
1665
|
-
CSS custom properties: `--ui-border`, `--ui-danger`, `--ui-focus-ring`, `--ui-font`, `--ui-font-size`, `--ui-font-size-sm`, `--ui-font-weight-medium`, `--ui-font-weight-semibold`, `--ui-line-height-tight`, `--ui-primary`, `--ui-radius`, `--ui-radius-pill`, `--ui-radius-sm`, `--ui-shadow`, `--ui-surface`, `--ui-surface-muted`, `--ui-text`, `--ui-text-muted`
|
|
1730
|
+
CSS custom properties: `--ui-border`, `--ui-border-width`, `--ui-danger`, `--ui-focus-ring`, `--ui-font`, `--ui-font-size`, `--ui-font-size-sm`, `--ui-font-weight-medium`, `--ui-font-weight-semibold`, `--ui-line-height-tight`, `--ui-primary`, `--ui-radius`, `--ui-radius-pill`, `--ui-radius-sm`, `--ui-shadow`, `--ui-surface`, `--ui-surface-muted`, `--ui-text`, `--ui-text-muted`
|
|
1666
1731
|
|
|
1667
1732
|
Example:
|
|
1668
1733
|
```html
|
|
@@ -1734,7 +1799,7 @@ Import: `import "@f-ewald/components/pagination-nav.js";`
|
|
|
1734
1799
|
|
|
1735
1800
|
Properties: `currentPage` (attribute `current-page`) : number, default 1; `totalPages` (attribute `total-pages`) : number, default 1
|
|
1736
1801
|
Events: `page-change`
|
|
1737
|
-
CSS custom properties: `--ui-border`, `--ui-button-highlight`, `--ui-button-secondary-`, `--ui-button-secondary-background`, `--ui-button-secondary-background-active`, `--ui-button-secondary-border`, `--ui-button-secondary-border-hover`, `--ui-button-secondary-surface-muted`, `--ui-focus-ring`, `--ui-font`, `--ui-font-size-sm`, `--ui-font-weight-medium`, `--ui-line-height-tight`, `--ui-radius-sm`, `--ui-surface-muted`, `--ui-text`, `--ui-text-muted`
|
|
1802
|
+
CSS custom properties: `--ui-border`, `--ui-border-width`, `--ui-button-highlight`, `--ui-button-secondary-`, `--ui-button-secondary-background`, `--ui-button-secondary-background-active`, `--ui-button-secondary-border`, `--ui-button-secondary-border-hover`, `--ui-button-secondary-surface-muted`, `--ui-focus-ring`, `--ui-font`, `--ui-font-size-sm`, `--ui-font-weight-medium`, `--ui-line-height-tight`, `--ui-numeric`, `--ui-radius-sm`, `--ui-surface-muted`, `--ui-text`, `--ui-text-muted`
|
|
1738
1803
|
|
|
1739
1804
|
Example:
|
|
1740
1805
|
```html
|
|
@@ -1786,7 +1851,7 @@ Import: `import "@f-ewald/components/photo-gallery.js";`
|
|
|
1786
1851
|
|
|
1787
1852
|
Properties: `currentIndex` (attribute `current-index`) : number, default 0; `delay` (attribute `delay`) : number, default 0; `showControls` (attribute `show-controls`) : boolean, default true; `showCounter` (attribute `show-counter`) : boolean, default false; `showIndicators` (attribute `show-indicators`) : boolean, default false; `showAutoplayControl` (attribute `show-autoplay-control`) : boolean, default true; `paused` (attribute `paused`) : boolean, default false; `aspectRatio` (attribute `aspect-ratio`) : string, default "16 / 9"; `objectFit` (attribute `object-fit`) : PhotoGalleryObjectFit, default "cover"
|
|
1788
1853
|
Events: `slide-change`
|
|
1789
|
-
CSS custom properties: `--ui-border`, `--ui-focus-ring`, `--ui-font`, `--ui-font-size`, `--ui-font-size-sm`, `--ui-line-height-normal`, `--ui-line-height-tight`, `--ui-on-accent`, `--ui-overlay`, `--ui-primary`, `--ui-radius`, `--ui-radius-pill`, `--ui-radius-sm`, `--ui-surface`, `--ui-surface-muted`, `--ui-text`, `--ui-text-muted`
|
|
1854
|
+
CSS custom properties: `--ui-border`, `--ui-border-width`, `--ui-focus-ring`, `--ui-font`, `--ui-font-size`, `--ui-font-size-sm`, `--ui-line-height-normal`, `--ui-line-height-tight`, `--ui-on-accent`, `--ui-overlay`, `--ui-primary`, `--ui-radius`, `--ui-radius-pill`, `--ui-radius-sm`, `--ui-surface`, `--ui-surface-muted`, `--ui-text`, `--ui-text-muted`
|
|
1790
1855
|
|
|
1791
1856
|
Example:
|
|
1792
1857
|
```html
|
|
@@ -1826,7 +1891,7 @@ Import: `import "@f-ewald/components/popover-panel.js";`
|
|
|
1826
1891
|
|
|
1827
1892
|
Properties: `open` (attribute `open`) : boolean, default false; `heading` (attribute `heading`) : string, default ""; `centered` (attribute `centered`) : boolean, default false
|
|
1828
1893
|
Events: `panel-close`
|
|
1829
|
-
CSS custom properties: `--ui-border`, `--ui-focus-ring`, `--ui-font`, `--ui-font-size-lg`, `--ui-font-weight-semibold`, `--ui-line-height-tight`, `--ui-overlay`, `--ui-radius`, `--ui-radius-sm`, `--ui-shadow-lg`, `--ui-surface`, `--ui-surface-muted`, `--ui-text`, `--ui-text-muted`
|
|
1894
|
+
CSS custom properties: `--ui-border`, `--ui-border-width`, `--ui-focus-ring`, `--ui-font`, `--ui-font-size-lg`, `--ui-font-weight-semibold`, `--ui-line-height-tight`, `--ui-overlay`, `--ui-radius`, `--ui-radius-sm`, `--ui-shadow-lg`, `--ui-surface`, `--ui-surface-muted`, `--ui-text`, `--ui-text-muted`
|
|
1830
1895
|
|
|
1831
1896
|
Example:
|
|
1832
1897
|
```html
|
|
@@ -1880,7 +1945,7 @@ Import: `import "@f-ewald/components/progress-bar.js";`
|
|
|
1880
1945
|
|
|
1881
1946
|
Properties: `value` (attribute `value`) : number, default 0; `max` (attribute `max`) : number, default 100; `label` (attribute `label`) : string, default ""; `color` (attribute `color`) : string, default ""; `trackColor` (attribute `track-color`) : string, default ""
|
|
1882
1947
|
Events: none
|
|
1883
|
-
CSS custom properties: `--ui-button-accent`, `--ui-font`, `--ui-font-size-sm`, `--ui-primary`, `--ui-radius-sm`, `--ui-surface-muted`, `--ui-text-muted`
|
|
1948
|
+
CSS custom properties: `--ui-button-accent`, `--ui-font`, `--ui-font-size-sm`, `--ui-numeric`, `--ui-primary`, `--ui-radius-sm`, `--ui-surface-muted`, `--ui-text-muted`
|
|
1884
1949
|
|
|
1885
1950
|
Example:
|
|
1886
1951
|
```html
|
|
@@ -1921,7 +1986,7 @@ Import: `import "@f-ewald/components/radio-cards.js";`
|
|
|
1921
1986
|
|
|
1922
1987
|
Properties: `options` (JS property only) : RadioCardOption[], default []; `value` (attribute `value`) : string, default ""; `disabled` (attribute `disabled`) : boolean, default false; `layout` (attribute `layout`) : "vertical" | "horizontal" | "mixed", default "mixed"; `hideInput` (attribute `hide-input`) : boolean, default false
|
|
1923
1988
|
Events: `change`
|
|
1924
|
-
CSS custom properties: `--ui-border`, `--ui-button-accent`, `--ui-button-highlight`, `--ui-button-secondary-background`, `--ui-button-secondary-background-hover`, `--ui-button-secondary-border`, `--ui-button-secondary-border-hover`, `--ui-button-secondary-surface-muted`, `--ui-focus-ring`, `--ui-font`, `--ui-font-size-sm`, `--ui-font-weight-regular`, `--ui-font-weight-semibold`, `--ui-primary`, `--ui-radius-sm`, `--ui-surface`, `--ui-surface-muted`, `--ui-text`, `--ui-text-muted`
|
|
1989
|
+
CSS custom properties: `--ui-border`, `--ui-border-width`, `--ui-button-accent`, `--ui-button-highlight`, `--ui-button-secondary-background`, `--ui-button-secondary-background-hover`, `--ui-button-secondary-border`, `--ui-button-secondary-border-hover`, `--ui-button-secondary-surface-muted`, `--ui-focus-ring`, `--ui-font`, `--ui-font-size-sm`, `--ui-font-weight-regular`, `--ui-font-weight-semibold`, `--ui-primary`, `--ui-radius-sm`, `--ui-surface`, `--ui-surface-muted`, `--ui-text`, `--ui-text-muted`
|
|
1925
1990
|
|
|
1926
1991
|
Example:
|
|
1927
1992
|
```html
|
|
@@ -1955,7 +2020,7 @@ Import: `import "@f-ewald/components/radio-pills.js";`
|
|
|
1955
2020
|
|
|
1956
2021
|
Properties: `options` (JS property only) : RadioPillOption[], default []; `value` (attribute `value`) : string, default ""; `disabled` (attribute `disabled`) : boolean, default false
|
|
1957
2022
|
Events: `change`
|
|
1958
|
-
CSS custom properties: `--ui-border`, `--ui-button-accent`, `--ui-button-highlight`, `--ui-button-secondary-surface-muted`, `--ui-focus-ring`, `--ui-font`, `--ui-font-size-sm`, `--ui-line-height-tight`, `--ui-primary`, `--ui-radius-pill`, `--ui-surface-muted`, `--ui-text`
|
|
2023
|
+
CSS custom properties: `--ui-border`, `--ui-border-width`, `--ui-button-accent`, `--ui-button-highlight`, `--ui-button-secondary-surface-muted`, `--ui-focus-ring`, `--ui-font`, `--ui-font-size-sm`, `--ui-line-height-tight`, `--ui-primary`, `--ui-radius-pill`, `--ui-surface-muted`, `--ui-text`
|
|
1959
2024
|
|
|
1960
2025
|
Example:
|
|
1961
2026
|
```html
|
|
@@ -2027,7 +2092,7 @@ Import: `import "@f-ewald/components/reveal-button.js";`
|
|
|
2027
2092
|
|
|
2028
2093
|
Properties: `label` (attribute `label`) : string, default "Reveal hidden content"; `disabled` (attribute `disabled`) : boolean, default false; `size` (attribute `size`) : "sm" | "md", default "md"
|
|
2029
2094
|
Events: none
|
|
2030
|
-
CSS custom properties: `--ui-button-background`, `--ui-button-background-active`, `--ui-button-background-hover`, `--ui-button-border`, `--ui-button-highlight`, `--ui-button-text-shadow`, `--ui-focus-ring`, `--ui-font`, `--ui-font-size-sm`, `--ui-font-size-xs`, `--ui-font-weight-medium`, `--ui-line-height-tight`, `--ui-on-accent`, `--ui-primary`, `--ui-primary-hover`, `--ui-radius-sm`
|
|
2095
|
+
CSS custom properties: `--ui-border-width`, `--ui-button-background`, `--ui-button-background-active`, `--ui-button-background-hover`, `--ui-button-border`, `--ui-button-highlight`, `--ui-button-text-shadow`, `--ui-focus-ring`, `--ui-font`, `--ui-font-size-sm`, `--ui-font-size-xs`, `--ui-font-weight-medium`, `--ui-line-height-tight`, `--ui-on-accent`, `--ui-primary`, `--ui-primary-hover`, `--ui-radius-sm`
|
|
2031
2096
|
|
|
2032
2097
|
Example:
|
|
2033
2098
|
```html
|
|
@@ -2114,7 +2179,7 @@ Import: `import "@f-ewald/components/scroll-to-bottom.js";`
|
|
|
2114
2179
|
|
|
2115
2180
|
Properties: `target` (JS property only) : HTMLElement | null, default null; `threshold` (attribute `threshold`) : number, default 200; `label` (attribute `label`) : string, default "Scroll to bottom"
|
|
2116
2181
|
Events: `scroll-to-bottom-triggered`
|
|
2117
|
-
CSS custom properties: `--ui-border`, `--ui-button-highlight`, `--ui-button-secondary-`, `--ui-button-secondary-background`, `--ui-button-secondary-background-active`, `--ui-button-secondary-background-hover`, `--ui-button-secondary-border`, `--ui-button-secondary-border-hover`, `--ui-focus-ring`, `--ui-font`, `--ui-font-size-sm`, `--ui-font-weight-medium`, `--ui-line-height-tight`, `--ui-radius-sm`, `--ui-shadow`, `--ui-surface`, `--ui-surface-muted`, `--ui-text`, `--ui-text-muted`
|
|
2182
|
+
CSS custom properties: `--ui-border`, `--ui-border-width`, `--ui-button-highlight`, `--ui-button-secondary-`, `--ui-button-secondary-background`, `--ui-button-secondary-background-active`, `--ui-button-secondary-background-hover`, `--ui-button-secondary-border`, `--ui-button-secondary-border-hover`, `--ui-focus-ring`, `--ui-font`, `--ui-font-size-sm`, `--ui-font-weight-medium`, `--ui-line-height-tight`, `--ui-radius-sm`, `--ui-shadow`, `--ui-surface`, `--ui-surface-muted`, `--ui-text`, `--ui-text-muted`
|
|
2118
2183
|
|
|
2119
2184
|
Example:
|
|
2120
2185
|
```html
|
|
@@ -2155,13 +2220,38 @@ Import: `import "@f-ewald/components/scroll-to-top.js";`
|
|
|
2155
2220
|
|
|
2156
2221
|
Properties: `target` (JS property only) : HTMLElement | null, default null; `threshold` (attribute `threshold`) : number, default 200; `label` (attribute `label`) : string, default "Scroll to top"
|
|
2157
2222
|
Events: `scroll-to-top-triggered`
|
|
2158
|
-
CSS custom properties: `--ui-border`, `--ui-button-highlight`, `--ui-button-secondary-`, `--ui-button-secondary-background`, `--ui-button-secondary-background-active`, `--ui-button-secondary-background-hover`, `--ui-button-secondary-border`, `--ui-button-secondary-border-hover`, `--ui-focus-ring`, `--ui-font`, `--ui-font-size-sm`, `--ui-font-weight-medium`, `--ui-line-height-tight`, `--ui-radius-sm`, `--ui-shadow`, `--ui-surface`, `--ui-surface-muted`, `--ui-text`, `--ui-text-muted`
|
|
2223
|
+
CSS custom properties: `--ui-border`, `--ui-border-width`, `--ui-button-highlight`, `--ui-button-secondary-`, `--ui-button-secondary-background`, `--ui-button-secondary-background-active`, `--ui-button-secondary-background-hover`, `--ui-button-secondary-border`, `--ui-button-secondary-border-hover`, `--ui-focus-ring`, `--ui-font`, `--ui-font-size-sm`, `--ui-font-weight-medium`, `--ui-line-height-tight`, `--ui-radius-sm`, `--ui-shadow`, `--ui-surface`, `--ui-surface-muted`, `--ui-text`, `--ui-text-muted`
|
|
2159
2224
|
|
|
2160
2225
|
Example:
|
|
2161
2226
|
```html
|
|
2162
2227
|
<scroll-to-top></scroll-to-top>
|
|
2163
2228
|
```
|
|
2164
2229
|
|
|
2230
|
+
## <skip-link>
|
|
2231
|
+
|
|
2232
|
+
"Skip to main content" bypass link — the package's first pure
|
|
2233
|
+
accessibility-utility component. It renders a real `<a>` that stays
|
|
2234
|
+
visually hidden (but in the focus order) until it receives keyboard focus,
|
|
2235
|
+
then pins itself to the top-left of the viewport as a solid, high-contrast
|
|
2236
|
+
block so a keyboard or screen-reader user can jump straight past repeated
|
|
2237
|
+
page chrome to the main content. It needs no JavaScript beyond the element
|
|
2238
|
+
upgrade — the anchor's native in-page navigation does the rest.
|
|
2239
|
+
|
|
2240
|
+
Place it as the very first focusable element on the page, before the app
|
|
2241
|
+
chrome, and point `href` at the `id` of the main content region.
|
|
2242
|
+
|
|
2243
|
+
Import: `import "@f-ewald/components/skip-link.js";`
|
|
2244
|
+
|
|
2245
|
+
Properties: `href` (attribute `href`) : string, default "#main"; `label` (attribute `label`) : string, default "Skip to main content"
|
|
2246
|
+
Events: none
|
|
2247
|
+
CSS custom properties: `--ui-focus-ring`, `--ui-font`, `--ui-font-size-sm`, `--ui-font-weight-medium`, `--ui-line-height-tight`, `--ui-on-accent`, `--ui-radius-sm`, `--ui-shadow`, `--ui-text`
|
|
2248
|
+
|
|
2249
|
+
Example:
|
|
2250
|
+
```html
|
|
2251
|
+
<skip-link href="#main"></skip-link>
|
|
2252
|
+
<skip-link href="#results" label="Jump to results"></skip-link>
|
|
2253
|
+
```
|
|
2254
|
+
|
|
2165
2255
|
## <slide-panel>
|
|
2166
2256
|
|
|
2167
2257
|
Generic sliding panel shell. Handles positioning, open/close animation,
|
|
@@ -2175,7 +2265,7 @@ Import: `import "@f-ewald/components/slide-panel.js";`
|
|
|
2175
2265
|
|
|
2176
2266
|
Properties: `open` (attribute `open`) : boolean, default false; `heading` (attribute `heading`) : string, default ""
|
|
2177
2267
|
Events: `panel-close`
|
|
2178
|
-
CSS custom properties: `--ui-border`, `--ui-focus-ring`, `--ui-font`, `--ui-font-size-lg`, `--ui-font-weight-semibold`, `--ui-line-height-tight`, `--ui-radius`, `--ui-radius-pill`, `--ui-radius-sm`, `--ui-shadow-lg`, `--ui-surface`, `--ui-surface-muted`, `--ui-text`, `--ui-text-muted`
|
|
2268
|
+
CSS custom properties: `--ui-border`, `--ui-border-width`, `--ui-focus-ring`, `--ui-font`, `--ui-font-size-lg`, `--ui-font-weight-semibold`, `--ui-line-height-tight`, `--ui-radius`, `--ui-radius-pill`, `--ui-radius-sm`, `--ui-shadow-lg`, `--ui-surface`, `--ui-surface-muted`, `--ui-text`, `--ui-text-muted`
|
|
2179
2269
|
|
|
2180
2270
|
Example:
|
|
2181
2271
|
```html
|
|
@@ -2184,6 +2274,44 @@ Example:
|
|
|
2184
2274
|
</slide-panel>
|
|
2185
2275
|
```
|
|
2186
2276
|
|
|
2277
|
+
## <spec-list>
|
|
2278
|
+
|
|
2279
|
+
A key/value specification sheet — the "spec sheet" block on a product page:
|
|
2280
|
+
an uppercase, muted, wide-tracked key column against a value column,
|
|
2281
|
+
separated by hairline rules. It describes ONE record's attributes, which is
|
|
2282
|
+
what sets it apart from `data-table` (many records, many columns, sorting);
|
|
2283
|
+
`spec-list` is not tabular and renders a real `<dl>`/`<dt>`/`<dd>` structure.
|
|
2284
|
+
|
|
2285
|
+
Feed it the `items` array for the plain data path, or slot your own
|
|
2286
|
+
`<div><dt>…</dt><dd>…</dd></div>` groups when a value needs a link, a
|
|
2287
|
+
`status-pill`, or other markup. Slotted content takes precedence over
|
|
2288
|
+
`items`; with neither, nothing is rendered.
|
|
2289
|
+
|
|
2290
|
+
Import: `import "@f-ewald/components/spec-list.js";`
|
|
2291
|
+
|
|
2292
|
+
Properties: `items` (attribute `items`) : SpecListItem[], default []; `layout` (attribute `layout`) : "auto" | "stacked", default "auto"; `dividers` (attribute `dividers`) : boolean, default true; `caption` (attribute `caption`) : string, default ""
|
|
2293
|
+
Events: none
|
|
2294
|
+
CSS custom properties: `--ui-border`, `--ui-border-width`, `--ui-font`, `--ui-font-size`, `--ui-font-size-sm`, `--ui-font-weight-medium`, `--ui-label-transform`, `--ui-line-height-normal`, `--ui-text`, `--ui-text-muted`, `--ui-tracking-wide`
|
|
2295
|
+
|
|
2296
|
+
Example:
|
|
2297
|
+
```html
|
|
2298
|
+
<spec-list caption="Specifications"></spec-list>
|
|
2299
|
+
<script type="module">
|
|
2300
|
+
document.querySelector("spec-list").items = [
|
|
2301
|
+
{ label: "Material", value: "Anodized aluminum" },
|
|
2302
|
+
{ label: "Weight", value: "1.2 kg" },
|
|
2303
|
+
{ label: "Warranty", value: "2 years" },
|
|
2304
|
+
];
|
|
2305
|
+
</script>
|
|
2306
|
+
|
|
2307
|
+
<!-- Or slot your own groups when a value needs a link, a status-pill, or other
|
|
2308
|
+
markup. `dividers` defaults to true; turn it off via the property, since a
|
|
2309
|
+
`dividers="false"` attribute still parses as a truthy boolean. -->
|
|
2310
|
+
<spec-list layout="stacked" id="sheet">
|
|
2311
|
+
<div><dt>Homepage</dt><dd><a href="https://example.com">example.com</a></dd></div>
|
|
2312
|
+
</spec-list>
|
|
2313
|
+
```
|
|
2314
|
+
|
|
2187
2315
|
## <split-hero>
|
|
2188
2316
|
|
|
2189
2317
|
Full-viewport split layout: a user-supplied photo fills one half, the
|
|
@@ -2222,7 +2350,7 @@ Import: `import "@f-ewald/components/stat-meter.js";`
|
|
|
2222
2350
|
|
|
2223
2351
|
Properties: `label` (attribute `label`) : string, default ""; `percent` (attribute `percent`) : number | null, default null; `color` (attribute `color`) : string, default ""; `trackColor` (attribute `track-color`) : string, default ""
|
|
2224
2352
|
Events: none
|
|
2225
|
-
CSS custom properties: `--ui-font`, `--ui-font-size-sm`, `--ui-font-weight-medium`, `--ui-font-weight-semibold`, `--ui-radius-pill`, `--ui-success`, `--ui-surface-muted`, `--ui-text`, `--ui-text-muted`, `--ui-tracking-wide`
|
|
2353
|
+
CSS custom properties: `--ui-font`, `--ui-font-size-sm`, `--ui-font-weight-medium`, `--ui-font-weight-semibold`, `--ui-label-transform`, `--ui-radius-pill`, `--ui-success`, `--ui-surface-muted`, `--ui-text`, `--ui-text-muted`, `--ui-tracking-wide`
|
|
2226
2354
|
|
|
2227
2355
|
Example:
|
|
2228
2356
|
```html
|
|
@@ -2292,7 +2420,7 @@ Import: `import "@f-ewald/components/tab-bar.js";`
|
|
|
2292
2420
|
|
|
2293
2421
|
Properties: `label` (attribute `label`) : string, default ""
|
|
2294
2422
|
Events: `change`
|
|
2295
|
-
CSS custom properties: `--ui-border`, `--ui-focus-ring`, `--ui-font`, `--ui-font-size-sm`, `--ui-font-weight-medium`, `--ui-font-weight-semibold`, `--ui-line-height-tight`, `--ui-primary`, `--ui-radius-sm`, `--ui-text`, `--ui-text-muted`
|
|
2423
|
+
CSS custom properties: `--ui-border`, `--ui-border-width`, `--ui-focus-ring`, `--ui-font`, `--ui-font-size-sm`, `--ui-font-weight-medium`, `--ui-font-weight-semibold`, `--ui-line-height-tight`, `--ui-primary`, `--ui-radius-sm`, `--ui-text`, `--ui-text-muted`
|
|
2296
2424
|
|
|
2297
2425
|
Example:
|
|
2298
2426
|
```html
|
|
@@ -2337,7 +2465,7 @@ Import: `import "@f-ewald/components/text-area.js";`
|
|
|
2337
2465
|
|
|
2338
2466
|
Properties: `value` (attribute `value`) : string, default ""; `rows` (attribute `rows`) : number, default 4; `placeholder` (attribute `placeholder`) : string, default ""; `readonly` (attribute `readonly`) : boolean, default false; `disabled` (attribute `disabled`) : boolean, default false
|
|
2339
2467
|
Events: `input`, `change`
|
|
2340
|
-
CSS custom properties: `--ui-border`, `--ui-danger`, `--ui-focus-ring`, `--ui-font`, `--ui-font-size`, `--ui-font-size-sm`, `--ui-font-size-xs`, `--ui-font-weight-regular`, `--ui-line-height-normal`, `--ui-line-height-tight`, `--ui-primary`, `--ui-radius-sm`, `--ui-surface`, `--ui-surface-muted`, `--ui-text`, `--ui-text-muted`
|
|
2468
|
+
CSS custom properties: `--ui-border`, `--ui-border-width`, `--ui-danger`, `--ui-focus-ring`, `--ui-font`, `--ui-font-size`, `--ui-font-size-sm`, `--ui-font-size-xs`, `--ui-font-weight-regular`, `--ui-line-height-normal`, `--ui-line-height-tight`, `--ui-primary`, `--ui-radius-sm`, `--ui-surface`, `--ui-surface-muted`, `--ui-text`, `--ui-text-muted`
|
|
2341
2469
|
|
|
2342
2470
|
Example:
|
|
2343
2471
|
```html
|
|
@@ -2368,7 +2496,7 @@ Import: `import "@f-ewald/components/tile-grid.js";`
|
|
|
2368
2496
|
|
|
2369
2497
|
Properties: `items` (JS property only) : unknown[], default []; `itemKey` (JS property only) : (item: unknown, index: number) => string | number, default —; `renderTile` (JS property only) : (item: unknown) => unknown, default —; `itemHref` (JS property only) : ((item: unknown) => string | null) | null, default null; `fileIcon` (attribute `file-icon`) : boolean, default false
|
|
2370
2498
|
Events: none
|
|
2371
|
-
CSS custom properties: `--ui-border`, `--ui-focus-ring`, `--ui-font`, `--ui-font-size-sm`, `--ui-radius`, `--ui-surface-muted`, `--ui-text`, `--ui-text-muted`
|
|
2499
|
+
CSS custom properties: `--ui-border`, `--ui-border-width`, `--ui-focus-ring`, `--ui-font`, `--ui-font-size-sm`, `--ui-radius`, `--ui-surface-muted`, `--ui-text`, `--ui-text-muted`
|
|
2372
2500
|
|
|
2373
2501
|
Example:
|
|
2374
2502
|
```html
|
|
@@ -2565,7 +2693,7 @@ Import: `import "@f-ewald/components/tree-view.js";`
|
|
|
2565
2693
|
|
|
2566
2694
|
Properties: `nodes` (JS property only) : TreeNode[], default []; `renderNode` (JS property only) : (node: TreeNode) => unknown, default —; `defaultExpanded` (attribute `default-expanded`) : boolean, default false; `lines` (attribute `lines`) : boolean, default false
|
|
2567
2695
|
Events: `node-click`
|
|
2568
|
-
CSS custom properties: `--ui-border`, `--ui-focus-ring`, `--ui-font`, `--ui-font-size-sm`, `--ui-radius-sm`, `--ui-surface-muted`, `--ui-text`, `--ui-text-muted`
|
|
2696
|
+
CSS custom properties: `--ui-border`, `--ui-border-width`, `--ui-focus-ring`, `--ui-font`, `--ui-font-size-sm`, `--ui-radius-sm`, `--ui-surface-muted`, `--ui-text`, `--ui-text-muted`
|
|
2569
2697
|
|
|
2570
2698
|
Example:
|
|
2571
2699
|
```html
|
|
@@ -2599,7 +2727,7 @@ Import: `import "@f-ewald/components/ui-admonition.js";`
|
|
|
2599
2727
|
|
|
2600
2728
|
Properties: `variant` (attribute `variant`) : AdmonitionVariant, default "info"; `icon` (JS property only) : TemplateResult | null, default null
|
|
2601
2729
|
Events: none
|
|
2602
|
-
CSS custom properties: `--ui-danger`, `--ui-font`, `--ui-font-size-sm`, `--ui-info`, `--ui-line-height-normal`, `--ui-radius`, `--ui-success`, `--ui-surface`, `--ui-text`, `--ui-text-muted`, `--ui-warning`
|
|
2730
|
+
CSS custom properties: `--ui-border-width`, `--ui-danger`, `--ui-font`, `--ui-font-size-sm`, `--ui-info`, `--ui-line-height-normal`, `--ui-radius`, `--ui-success`, `--ui-surface`, `--ui-text`, `--ui-text-muted`, `--ui-warning`
|
|
2603
2731
|
|
|
2604
2732
|
Example:
|
|
2605
2733
|
```html
|
|
@@ -2668,7 +2796,7 @@ Import: `import "@f-ewald/components/ui-button.js";`
|
|
|
2668
2796
|
|
|
2669
2797
|
Properties: `variant` (attribute `variant`) : ButtonVariant, default "primary"; `size` (attribute `size`) : "sm" | "md", default "md"; `pill` (attribute `pill`) : boolean, default false; `ai` (attribute `ai`) : boolean, default false; `href` (attribute `href`) : string | null, default null; `type` (attribute `type`) : "button" | "submit" | "reset", default "button"; `disabled` (attribute `disabled`) : boolean, default false; `busy` (attribute `busy`) : boolean, default false
|
|
2670
2798
|
Events: none
|
|
2671
|
-
CSS custom properties: `--ui-ai-1`, `--ui-ai-2`, `--ui-ai-3`, `--ui-ai-4`, `--ui-border`, `--ui-button-background`, `--ui-button-background-active`, `--ui-button-background-hover`, `--ui-button-border`, `--ui-button-danger-background`, `--ui-button-danger-background-active`, `--ui-button-danger-background-hover`, `--ui-button-danger-border`, `--ui-button-highlight`, `--ui-button-secondary-`, `--ui-button-secondary-background`, `--ui-button-secondary-background-active`, `--ui-button-secondary-background-hover`, `--ui-button-secondary-border`, `--ui-button-secondary-border-hover`, `--ui-button-text-shadow`, `--ui-danger`, `--ui-danger-hover`, `--ui-focus-ring`, `--ui-font`, `--ui-font-size-sm`, `--ui-font-size-xs`, `--ui-font-weight-medium`, `--ui-line-height-tight`, `--ui-on-accent`, `--ui-primary`, `--ui-primary-hover`, `--ui-radius-pill`, `--ui-radius-sm`, `--ui-text`, `--ui-text-muted`
|
|
2799
|
+
CSS custom properties: `--ui-ai-1`, `--ui-ai-2`, `--ui-ai-3`, `--ui-ai-4`, `--ui-border`, `--ui-border-width`, `--ui-button-background`, `--ui-button-background-active`, `--ui-button-background-hover`, `--ui-button-border`, `--ui-button-danger-background`, `--ui-button-danger-background-active`, `--ui-button-danger-background-hover`, `--ui-button-danger-border`, `--ui-button-highlight`, `--ui-button-secondary-`, `--ui-button-secondary-background`, `--ui-button-secondary-background-active`, `--ui-button-secondary-background-hover`, `--ui-button-secondary-border`, `--ui-button-secondary-border-hover`, `--ui-button-text-shadow`, `--ui-danger`, `--ui-danger-hover`, `--ui-focus-ring`, `--ui-font`, `--ui-font-size-sm`, `--ui-font-size-xs`, `--ui-font-weight-medium`, `--ui-line-height-tight`, `--ui-on-accent`, `--ui-primary`, `--ui-primary-hover`, `--ui-radius-pill`, `--ui-radius-sm`, `--ui-text`, `--ui-text-muted`
|
|
2672
2800
|
|
|
2673
2801
|
Example:
|
|
2674
2802
|
```html
|
|
@@ -2697,6 +2825,13 @@ renders between the box and the label, inside the same clickable `<label>`
|
|
|
2697
2825
|
— for a row that pairs a checkbox with an icon/swatch and needs the whole
|
|
2698
2826
|
row, icon included, to stay one click target.
|
|
2699
2827
|
|
|
2828
|
+
The label is the default slot, with the `label` property as its fallback.
|
|
2829
|
+
Slot it instead of setting the property when it needs its own markup or
|
|
2830
|
+
styling — a link, an emphasized word — since a property renders inside this
|
|
2831
|
+
component's shadow DOM and cannot be reached from outside. Either way the
|
|
2832
|
+
label sits inside the native `<label>`, so it stays clickable and still
|
|
2833
|
+
names the checkbox for assistive technology.
|
|
2834
|
+
|
|
2700
2835
|
Import: `import "@f-ewald/components/ui-checkbox.js";`
|
|
2701
2836
|
|
|
2702
2837
|
Properties: `checked` (attribute `checked`) : boolean, default false; `indeterminate` (attribute `indeterminate`) : boolean, default false; `disabled` (attribute `disabled`) : boolean, default false; `required` (attribute `required`) : boolean, default false; `name` (attribute `name`) : string, default ""; `label` (attribute `label`) : string, default ""; `icon` (JS property only) : TemplateResult | null, default null; `iconSize` (attribute `iconSize`) : number, default 14
|
|
@@ -2707,6 +2842,8 @@ Example:
|
|
|
2707
2842
|
```html
|
|
2708
2843
|
<ui-checkbox label="Subscribe to updates"></ui-checkbox>
|
|
2709
2844
|
<ui-checkbox name="terms" label="I agree to the terms" required></ui-checkbox>
|
|
2845
|
+
<!-- Slot the label when it needs its own markup; it overrides the property -->
|
|
2846
|
+
<ui-checkbox name="beta">Enable <strong>beta</strong> features</ui-checkbox>
|
|
2710
2847
|
<!-- .icon is set programmatically (a pre-rendered TemplateResult), not an attribute -->
|
|
2711
2848
|
<ui-checkbox label="Show list view"></ui-checkbox>
|
|
2712
2849
|
```
|
|
@@ -2744,7 +2881,7 @@ Import: `import "@f-ewald/components/video-player.js";`
|
|
|
2744
2881
|
|
|
2745
2882
|
Properties: `src` (attribute `src`) : string, default ""; `poster` (attribute `poster`) : string, default ""; `label` (attribute `label`) : string, default "Video player"; `loop` (attribute `loop`) : boolean, default false; `preload` (attribute `preload`) : "none" | "metadata" | "auto", default "metadata"
|
|
2746
2883
|
Events: `play`, `pause`, `ended`
|
|
2747
|
-
CSS custom properties: `--ui-border`, `--ui-danger`, `--ui-font`, `--ui-font-size-sm`, `--ui-radius`, `--ui-surface`, `--ui-text-muted`
|
|
2884
|
+
CSS custom properties: `--ui-border`, `--ui-border-width`, `--ui-danger`, `--ui-font`, `--ui-font-size-sm`, `--ui-radius`, `--ui-surface`, `--ui-text-muted`
|
|
2748
2885
|
|
|
2749
2886
|
Example:
|
|
2750
2887
|
```html
|
|
@@ -2755,6 +2892,30 @@ Example:
|
|
|
2755
2892
|
></video-player>
|
|
2756
2893
|
```
|
|
2757
2894
|
|
|
2895
|
+
## <vote-control>
|
|
2896
|
+
|
|
2897
|
+
An up/down vote widget with a live score readout — the "vote an entry up or
|
|
2898
|
+
down toward a promotion threshold" pattern from a public register site,
|
|
2899
|
+
where one member casts a single vote that can be changed or withdrawn at any
|
|
2900
|
+
time. Two native `<button>`s flank a score; the button matching the user's
|
|
2901
|
+
own cast `vote` reads as pressed (`aria-pressed`), and clicking it again
|
|
2902
|
+
withdraws the vote. Set an optional `target` to render a thin progress meter
|
|
2903
|
+
toward the promotion threshold beneath (vertical) or beside (horizontal) the
|
|
2904
|
+
buttons.
|
|
2905
|
+
|
|
2906
|
+
Import: `import "@f-ewald/components/vote-control.js";`
|
|
2907
|
+
|
|
2908
|
+
Properties: `value` (attribute `value`) : number, default 0; `vote` (attribute `vote`) : "up" | "down" | null, default null; `disabled` (attribute `disabled`) : boolean, default false; `orientation` (attribute `orientation`) : "vertical" | "horizontal", default "vertical"; `target` (attribute `target`) : number, default 0; `label` (attribute `label`) : string, default "Vote"
|
|
2909
|
+
Events: `vote-change`
|
|
2910
|
+
CSS custom properties: `--ui-border`, `--ui-border-width`, `--ui-button-accent`, `--ui-danger`, `--ui-focus-ring`, `--ui-font`, `--ui-font-size-lg`, `--ui-font-size-xs`, `--ui-font-weight-medium`, `--ui-font-weight-semibold`, `--ui-label-transform`, `--ui-line-height-tight`, `--ui-numeric`, `--ui-primary`, `--ui-radius`, `--ui-radius-pill`, `--ui-radius-sm`, `--ui-success`, `--ui-surface`, `--ui-surface-muted`, `--ui-text`, `--ui-text-muted`, `--ui-tracking-wide`
|
|
2911
|
+
|
|
2912
|
+
Example:
|
|
2913
|
+
```html
|
|
2914
|
+
<vote-control value="7" target="10" label="Vote for this entry"></vote-control>
|
|
2915
|
+
<vote-control orientation="horizontal" value="42" target="50"></vote-control>
|
|
2916
|
+
<vote-control value="3" disabled></vote-control>
|
|
2917
|
+
```
|
|
2918
|
+
|
|
2758
2919
|
## <weight-bar-chart>
|
|
2759
2920
|
|
|
2760
2921
|
Sorted horizontal bar chart of labeled weights (normalized fractions
|