@f-ewald/components 1.27.3 → 1.29.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 +2 -0
- package/custom-elements.json +460 -9
- package/dist/fullscreen-button.d.ts +43 -0
- package/dist/fullscreen-button.d.ts.map +1 -0
- package/dist/fullscreen-button.js +172 -0
- package/dist/fullscreen-button.js.map +1 -0
- package/dist/icons.d.ts +1 -1
- package/dist/icons.d.ts.map +1 -1
- package/dist/icons.js +1 -1
- package/dist/icons.js.map +1 -1
- package/dist/index.d.ts +3 -1
- package/dist/index.d.ts.map +1 -1
- package/dist/index.js +2 -0
- package/dist/index.js.map +1 -1
- package/dist/percent-bar-chart.d.ts.map +1 -1
- package/dist/percent-bar-chart.js +9 -2
- package/dist/percent-bar-chart.js.map +1 -1
- package/dist/radio-cards.d.ts +5 -1
- package/dist/radio-cards.d.ts.map +1 -1
- package/dist/radio-cards.js +19 -2
- package/dist/radio-cards.js.map +1 -1
- package/dist/scroll-dots.d.ts +54 -0
- package/dist/scroll-dots.d.ts.map +1 -0
- package/dist/scroll-dots.js +178 -0
- package/dist/scroll-dots.js.map +1 -0
- package/dist/scroll-to-bottom.d.ts +6 -0
- package/dist/scroll-to-bottom.d.ts.map +1 -1
- package/dist/scroll-to-bottom.js +31 -7
- package/dist/scroll-to-bottom.js.map +1 -1
- package/dist/scroll-to-top.d.ts +6 -0
- package/dist/scroll-to-top.d.ts.map +1 -1
- package/dist/scroll-to-top.js +31 -7
- package/dist/scroll-to-top.js.map +1 -1
- package/dist/timeline-container.d.ts +21 -5
- package/dist/timeline-container.d.ts.map +1 -1
- package/dist/timeline-container.js +35 -7
- package/dist/timeline-container.js.map +1 -1
- package/dist/timeline-entry.d.ts +32 -0
- package/dist/timeline-entry.d.ts.map +1 -1
- package/dist/timeline-entry.js +130 -3
- package/dist/timeline-entry.js.map +1 -1
- package/dist/tokens.css +4 -0
- package/dist/tokens.d.ts.map +1 -1
- package/dist/tokens.js +11 -0
- package/dist/tokens.js.map +1 -1
- package/dist/ui-button.d.ts +24 -0
- package/dist/ui-button.d.ts.map +1 -1
- package/dist/ui-button.js +122 -1
- package/dist/ui-button.js.map +1 -1
- package/dist/weight-bar-chart.js +2 -2
- package/dist/weight-bar-chart.js.map +1 -1
- package/docs/design-language.md +19 -0
- package/docs/fullscreen-button.md +70 -0
- package/docs/icons.md +1 -1
- package/docs/radio-cards.md +6 -1
- package/docs/scroll-dots.md +65 -0
- package/docs/scroll-to-bottom.md +15 -0
- package/docs/scroll-to-top.md +15 -0
- package/docs/timeline-container.md +30 -6
- package/docs/timeline-entry.md +18 -0
- package/docs/ui-button.md +28 -0
- package/docs/weight-bar-chart.md +1 -0
- package/llms.txt +159 -16
- package/package.json +1 -1
package/llms.txt
CHANGED
|
@@ -72,7 +72,7 @@ table to pick the icon matching a use case, for consistency across apps:
|
|
|
72
72
|
| `iconQueueList` | 16px | Queues, backlogs, or ordered work-item lists. |
|
|
73
73
|
| `iconShieldCheck` | 16px | Verified, secure, or trusted states. |
|
|
74
74
|
| `iconShieldExclamation` | 16px | Security warnings, or at-risk/compromised states. |
|
|
75
|
-
| `iconSparkles` | 16px |
|
|
75
|
+
| `iconSparkles` | 16px | An AI-powered action (pairs with ui-button's `ai` ring), a gradient-theme toggle, or a decorative/enhanced visual style. |
|
|
76
76
|
| `iconSpeakerWave` | 18px | An unmuted volume control, e.g. audio-player/video-player's mute toggle. |
|
|
77
77
|
| `iconSpeakerXMark` | 18px | A muted volume state; pair with iconSpeakerWave for the unmuted state. |
|
|
78
78
|
| `iconSquares2x2` | 18px | A grid or kanban-view toggle, or to represent card/tile layouts. |
|
|
@@ -982,6 +982,37 @@ Example:
|
|
|
982
982
|
</frame-box>
|
|
983
983
|
```
|
|
984
984
|
|
|
985
|
+
## <fullscreen-button>
|
|
986
|
+
|
|
987
|
+
Toggles fullscreen presentation of the page, or of a given `target` element.
|
|
988
|
+
|
|
989
|
+
The icon and accessible name track the *actual* fullscreen state rather than
|
|
990
|
+
this button's own clicks, because fullscreen can be left without touching it
|
|
991
|
+
— Escape, or the browser's own chrome — which would otherwise leave the
|
|
992
|
+
button showing the wrong affordance.
|
|
993
|
+
|
|
994
|
+
The control is styled as a square icon-sized `ui-button` `secondary` variant
|
|
995
|
+
(2rem, `--ui-radius-sm` corners, the `--ui-button-secondary-*` background and
|
|
996
|
+
border tokens, so a gradient theme carries over) layered over an opaque
|
|
997
|
+
`--ui-surface` base and an elevation shadow, since it normally floats above
|
|
998
|
+
the content it expands.
|
|
999
|
+
|
|
1000
|
+
Import: `import "@f-ewald/components/fullscreen-button.js";`
|
|
1001
|
+
|
|
1002
|
+
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"
|
|
1003
|
+
Events: `fullscreen-change`
|
|
1004
|
+
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`
|
|
1005
|
+
|
|
1006
|
+
Example:
|
|
1007
|
+
```html
|
|
1008
|
+
<fullscreen-button></fullscreen-button>
|
|
1009
|
+
<script type="module">
|
|
1010
|
+
const button = document.querySelector('fullscreen-button');
|
|
1011
|
+
button.target = document.querySelector('#deck'); // omit for the whole page
|
|
1012
|
+
button.addEventListener('fullscreen-change', (e) => console.log(e.detail.active));
|
|
1013
|
+
</script>
|
|
1014
|
+
```
|
|
1015
|
+
|
|
985
1016
|
## <gallery-item>
|
|
986
1017
|
|
|
987
1018
|
Declarative image metadata consumed by a parent `photo-gallery`.
|
|
@@ -1721,13 +1752,17 @@ The selected card's border/radio dot read `--ui-button-accent` (a solid
|
|
|
1721
1752
|
stand-in, since `border-color`/`accent-color` can't render a gradient),
|
|
1722
1753
|
and its background reads the shared `--ui-button-secondary-surface-muted`
|
|
1723
1754
|
plus `--ui-button-highlight`, so a gradient theme tints it consistently
|
|
1724
|
-
with `button-group`/`pagination-nav`'s equivalents.
|
|
1755
|
+
with `button-group`/`pagination-nav`'s equivalents. That shared value is
|
|
1756
|
+
tuned for small controls, so a card — with far more area — blends it 45%
|
|
1757
|
+
toward `--ui-surface` rather than taking a second token: the tint stays
|
|
1758
|
+
the same hue and gradient, just lighter on light themes (and
|
|
1759
|
+
correspondingly deeper on dark ones) than on a button.
|
|
1725
1760
|
|
|
1726
1761
|
Import: `import "@f-ewald/components/radio-cards.js";`
|
|
1727
1762
|
|
|
1728
1763
|
Properties: `options` (JS property only) : RadioCardOption[], default []; `value` (attribute `value`) : string, default ""; `disabled` (attribute `disabled`) : boolean, default false
|
|
1729
1764
|
Events: `change`
|
|
1730
|
-
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-font-weight-regular`, `--ui-font-weight-semibold`, `--ui-primary`, `--ui-radius-sm`, `--ui-surface-muted`, `--ui-text`, `--ui-text-muted`
|
|
1765
|
+
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-font-weight-regular`, `--ui-font-weight-semibold`, `--ui-primary`, `--ui-radius-sm`, `--ui-surface`, `--ui-surface-muted`, `--ui-text`, `--ui-text-muted`
|
|
1731
1766
|
|
|
1732
1767
|
Example:
|
|
1733
1768
|
```html
|
|
@@ -1857,6 +1892,44 @@ Example:
|
|
|
1857
1892
|
<roman-numeral value="2004"></roman-numeral>
|
|
1858
1893
|
```
|
|
1859
1894
|
|
|
1895
|
+
## <scroll-dots>
|
|
1896
|
+
|
|
1897
|
+
Vertical section navigator for a long scrolled page or a slide deck: one dot
|
|
1898
|
+
per section, the active one drawn as an elongated rounded bar rather than a
|
|
1899
|
+
dot, which is the only cue needed to read position at a glance.
|
|
1900
|
+
|
|
1901
|
+
Controlled, like `pagination-nav`: it owns no scroll behavior and never
|
|
1902
|
+
reads the scroll position. The consumer sets `active` and moves the page in
|
|
1903
|
+
response to `dot-select` — what counts as the active section differs too much
|
|
1904
|
+
between a snapped deck and an ordinary long page to bake in.
|
|
1905
|
+
|
|
1906
|
+
Positioning is also the consumer's, since a rail is normally fixed into a
|
|
1907
|
+
reserved gutter that only the page knows the width of.
|
|
1908
|
+
|
|
1909
|
+
The dots use the same lighter-on-top gradient as `map-circle`/`map-pin`,
|
|
1910
|
+
derived from a single base `color` — a rail beside a map reads as the same
|
|
1911
|
+
family of marks as the pins on it.
|
|
1912
|
+
|
|
1913
|
+
Import: `import "@f-ewald/components/scroll-dots.js";`
|
|
1914
|
+
|
|
1915
|
+
Properties: `items` (JS property only) : ScrollDotsItem[], default []; `active` (attribute `active`) : number, default 0; `color` (attribute `color`) : string, default ""; `label` (attribute `label`) : string, default ""
|
|
1916
|
+
Events: `dot-select`
|
|
1917
|
+
CSS custom properties: `--ui-focus-ring`, `--ui-primary`, `--ui-text-muted`
|
|
1918
|
+
|
|
1919
|
+
Example:
|
|
1920
|
+
```html
|
|
1921
|
+
<scroll-dots label="Journey stops"></scroll-dots>
|
|
1922
|
+
<script type="module">
|
|
1923
|
+
const rail = document.querySelector('scroll-dots');
|
|
1924
|
+
rail.items = ['Intro', 'Freiburg', 'Berkeley', { label: 'Credits', muted: true }];
|
|
1925
|
+
rail.active = 0;
|
|
1926
|
+
rail.addEventListener('dot-select', (e) => {
|
|
1927
|
+
rail.active = e.detail.index;
|
|
1928
|
+
sections[e.detail.index].scrollIntoView({ behavior: 'smooth', block: 'start' });
|
|
1929
|
+
});
|
|
1930
|
+
</script>
|
|
1931
|
+
```
|
|
1932
|
+
|
|
1860
1933
|
## <scroll-to-bottom>
|
|
1861
1934
|
|
|
1862
1935
|
Overlay button that appears once the page (or a given `target` container)
|
|
@@ -1872,11 +1945,17 @@ auto; position: relative`, so the button stays pinned to that container's
|
|
|
1872
1945
|
own visible corner as its content scrolls, rather than floating over the
|
|
1873
1946
|
whole page.
|
|
1874
1947
|
|
|
1948
|
+
The control is styled as a standard secondary button (ui-button's
|
|
1949
|
+
`secondary` variant: 2rem tall, `--ui-radius-sm` corners, the
|
|
1950
|
+
`--ui-button-secondary-*` background/border tokens, so a gradient theme
|
|
1951
|
+
carries over) rather than a pill, layered over an opaque `--ui-surface`
|
|
1952
|
+
base and an elevation shadow, since it floats above scrolled content.
|
|
1953
|
+
|
|
1875
1954
|
Import: `import "@f-ewald/components/scroll-to-bottom.js";`
|
|
1876
1955
|
|
|
1877
1956
|
Properties: `target` (JS property only) : HTMLElement | null, default null; `threshold` (attribute `threshold`) : number, default 200; `label` (attribute `label`) : string, default "Scroll to bottom"
|
|
1878
1957
|
Events: `scroll-to-bottom-triggered`
|
|
1879
|
-
CSS custom properties: `--ui-border`, `--ui-focus-ring`, `--ui-font`, `--ui-font-size-sm`, `--ui-font-weight-medium`, `--ui-line-height-tight`, `--ui-shadow`, `--ui-surface`, `--ui-surface-muted`, `--ui-text`
|
|
1958
|
+
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`
|
|
1880
1959
|
|
|
1881
1960
|
Example:
|
|
1882
1961
|
```html
|
|
@@ -1907,11 +1986,17 @@ auto; position: relative`, so the button stays pinned to that container's
|
|
|
1907
1986
|
own visible corner as its content scrolls, rather than floating over the
|
|
1908
1987
|
whole page.
|
|
1909
1988
|
|
|
1989
|
+
The control is styled as a standard secondary button (ui-button's
|
|
1990
|
+
`secondary` variant: 2rem tall, `--ui-radius-sm` corners, the
|
|
1991
|
+
`--ui-button-secondary-*` background/border tokens, so a gradient theme
|
|
1992
|
+
carries over) rather than a pill, layered over an opaque `--ui-surface`
|
|
1993
|
+
base and an elevation shadow, since it floats above scrolled content.
|
|
1994
|
+
|
|
1910
1995
|
Import: `import "@f-ewald/components/scroll-to-top.js";`
|
|
1911
1996
|
|
|
1912
1997
|
Properties: `target` (JS property only) : HTMLElement | null, default null; `threshold` (attribute `threshold`) : number, default 200; `label` (attribute `label`) : string, default "Scroll to top"
|
|
1913
1998
|
Events: `scroll-to-top-triggered`
|
|
1914
|
-
CSS custom properties: `--ui-border`, `--ui-focus-ring`, `--ui-font`, `--ui-font-size-sm`, `--ui-font-weight-medium`, `--ui-line-height-tight`, `--ui-shadow`, `--ui-surface`, `--ui-surface-muted`, `--ui-text`
|
|
1999
|
+
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`
|
|
1915
2000
|
|
|
1916
2001
|
Example:
|
|
1917
2002
|
```html
|
|
@@ -2141,15 +2226,25 @@ Example:
|
|
|
2141
2226
|
|
|
2142
2227
|
## <timeline-container>
|
|
2143
2228
|
|
|
2144
|
-
Vertical timeline: a
|
|
2145
|
-
|
|
2146
|
-
|
|
2147
|
-
|
|
2148
|
-
|
|
2229
|
+
Vertical timeline: a connecting line runs down the entries and each slotted
|
|
2230
|
+
`timeline-entry` places a dot on it. This is a thin layout and semantics
|
|
2231
|
+
wrapper — the entries draw the line segments and dots themselves, so the
|
|
2232
|
+
container adds no gap between them (a gap would break the line). Exposed to
|
|
2233
|
+
assistive technology as a list of events.
|
|
2234
|
+
|
|
2235
|
+
`layout` chooses where the line runs. `left` (the default) puts it down the
|
|
2236
|
+
left edge with each entry's label inline beside its headline. `alternating`
|
|
2237
|
+
centers it and gives each entry three columns — label, line, body — with the
|
|
2238
|
+
two sides swapping on every second entry, for a presentation timeline rather
|
|
2239
|
+
than an event log.
|
|
2240
|
+
|
|
2241
|
+
The layout is pushed onto each entry rather than read from here, because a
|
|
2242
|
+
shadow-DOM child cannot style itself against an ancestor portably —
|
|
2243
|
+
`:host-context()` is Chromium-only.
|
|
2149
2244
|
|
|
2150
2245
|
Import: `import "@f-ewald/components/timeline-container.js";`
|
|
2151
2246
|
|
|
2152
|
-
Properties:
|
|
2247
|
+
Properties: `layout` (attribute `layout`) : TimelineLayout, default "left"
|
|
2153
2248
|
Events: none
|
|
2154
2249
|
CSS custom properties: none
|
|
2155
2250
|
|
|
@@ -2169,6 +2264,18 @@ Example:
|
|
|
2169
2264
|
<chat-message role="user" author="Freddy">Ship it.</chat-message>
|
|
2170
2265
|
</timeline-entry>
|
|
2171
2266
|
</timeline-container>
|
|
2267
|
+
|
|
2268
|
+
<!-- A presentation timeline: centered line, label and body swapping sides. -->
|
|
2269
|
+
<timeline-container layout="alternating">
|
|
2270
|
+
<timeline-entry label="1987">
|
|
2271
|
+
<span slot="headline">Where it started</span>
|
|
2272
|
+
A first stop, with the label on the left.
|
|
2273
|
+
</timeline-entry>
|
|
2274
|
+
<timeline-entry label="2004">
|
|
2275
|
+
<span slot="headline">The question</span>
|
|
2276
|
+
The second entry mirrors the first.
|
|
2277
|
+
</timeline-entry>
|
|
2278
|
+
</timeline-container>
|
|
2172
2279
|
```
|
|
2173
2280
|
|
|
2174
2281
|
## <timeline-entry>
|
|
@@ -2184,6 +2291,19 @@ exactly at the first and last dots. Only meaningful inside a
|
|
|
2184
2291
|
timestamp prop (e.g. `chat-message`'s `timestamp`) should leave it unset —
|
|
2185
2292
|
setting both renders the same time twice.
|
|
2186
2293
|
|
|
2294
|
+
`label` is a free-text alternative for a timeline whose axis is not a wall
|
|
2295
|
+
clock — a year, an era, a phase. It wins over `datetime` when both are set.
|
|
2296
|
+
Slot `label` instead when it needs its own styling, since a property is
|
|
2297
|
+
rendered inside this component's shadow DOM and cannot be reached from
|
|
2298
|
+
outside.
|
|
2299
|
+
|
|
2300
|
+
`alternating` is set by `timeline-container` and should not be set by hand:
|
|
2301
|
+
it switches the entry to three columns — label, line, body — with the sides
|
|
2302
|
+
swapping on every second entry. The entry fills whatever height it is given,
|
|
2303
|
+
so the line spans it rather than only its content — do not override the
|
|
2304
|
+
host's `display` from outside, since a light-DOM rule beats the `:host`
|
|
2305
|
+
declaration this relies on.
|
|
2306
|
+
|
|
2187
2307
|
The dot's `color` types the entry using the shared status-pill palette —
|
|
2188
2308
|
`primary` by default, plus `neutral`, `info`, `success`, `warning`, and
|
|
2189
2309
|
`danger`.
|
|
@@ -2197,9 +2317,9 @@ effect while `running` is set.
|
|
|
2197
2317
|
|
|
2198
2318
|
Import: `import "@f-ewald/components/timeline-entry.js";`
|
|
2199
2319
|
|
|
2200
|
-
Properties: `datetime` (attribute `datetime`) : string | null, default null; `color` (attribute `color`) : StatusPillColor, default "primary"; `compact` (attribute `compact`) : boolean, default false; `running` (attribute `running`) : boolean, default false
|
|
2320
|
+
Properties: `datetime` (attribute `datetime`) : string | null, default null; `label` (attribute `label`) : string | null, default null; `alternating` (attribute `alternating`) : boolean, default false; `color` (attribute `color`) : StatusPillColor, default "primary"; `compact` (attribute `compact`) : boolean, default false; `running` (attribute `running`) : boolean, default false
|
|
2201
2321
|
Events: none
|
|
2202
|
-
CSS custom properties: `--ui-border`, `--ui-danger`, `--ui-font`, `--ui-font-size`, `--ui-font-size-sm`, `--ui-font-weight-semibold`, `--ui-info`, `--ui-line-height-normal`, `--ui-line-height-tight`, `--ui-primary`, `--ui-success`, `--ui-surface`, `--ui-text`, `--ui-text-muted`, `--ui-warning`
|
|
2322
|
+
CSS custom properties: `--ui-border`, `--ui-danger`, `--ui-font`, `--ui-font-size`, `--ui-font-size-lg`, `--ui-font-size-sm`, `--ui-font-weight-medium`, `--ui-font-weight-semibold`, `--ui-info`, `--ui-line-height-normal`, `--ui-line-height-tight`, `--ui-primary`, `--ui-success`, `--ui-surface`, `--ui-text`, `--ui-text-muted`, `--ui-tracking-wide`, `--ui-warning`
|
|
2203
2323
|
|
|
2204
2324
|
Example:
|
|
2205
2325
|
```html
|
|
@@ -2330,11 +2450,33 @@ background/border read the equivalent `--ui-button-secondary-*` tokens
|
|
|
2330
2450
|
transparent/bordered look, so it can be themed into a matching (e.g.
|
|
2331
2451
|
white-to-gray) gradient too.
|
|
2332
2452
|
|
|
2453
|
+
`ai` is an orthogonal modifier rather than a fourth variant: it leaves the
|
|
2454
|
+
variant's fill (flat or gradient-themed) untouched and only adds an
|
|
2455
|
+
animated multi-hue ring *outside* the button box — a crisp masked edge
|
|
2456
|
+
plus a blurred bloom behind it that fades out to transparent, so the ring
|
|
2457
|
+
melts into the page instead of ending on a hard line. Both layers are
|
|
2458
|
+
masked into a donut, so nothing is ever painted over the background or
|
|
2459
|
+
label. The ring's four stops are the `--ui-ai-1`…`--ui-ai-4` tokens. It
|
|
2460
|
+
sweeps slowly at rest, faster on hover and while `busy`, holds still while
|
|
2461
|
+
disabled or under `prefers-reduced-motion`, and drops the bloom for a
|
|
2462
|
+
solid `CanvasText` ring in forced-colors mode. The bloom reaches about
|
|
2463
|
+
`0.5rem` past the control, so give an AI button that much clearance from
|
|
2464
|
+
its neighbors and avoid `overflow: hidden` ancestors that would clip it.
|
|
2465
|
+
|
|
2466
|
+
Do not combine `ai` with `pill` under the gradient theme
|
|
2467
|
+
(`data-theme="gradient"`). That theme defines a button through a darker
|
|
2468
|
+
`--ui-button-border` edge plus a glossy top highlight; a pill's
|
|
2469
|
+
fully-rounded silhouette runs flush against the ring around its entire
|
|
2470
|
+
outline, so that border and gloss read as the inner edge of the rainbow
|
|
2471
|
+
rather than as the button's own shape, and the vertical gradient fill
|
|
2472
|
+
stops reading as a gradient at all. Use `ai` with the default
|
|
2473
|
+
`--ui-radius-sm` corners there, and keep `ai` + `pill` for the flat theme.
|
|
2474
|
+
|
|
2333
2475
|
Import: `import "@f-ewald/components/ui-button.js";`
|
|
2334
2476
|
|
|
2335
|
-
Properties: `variant` (attribute `variant`) : ButtonVariant, default "primary"; `size` (attribute `size`) : "sm" | "md", default "md"; `pill` (attribute `pill`) : 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
|
|
2477
|
+
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
|
|
2336
2478
|
Events: none
|
|
2337
|
-
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-`, `--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-sm`, `--ui-text`, `--ui-text-muted`
|
|
2479
|
+
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-sm`, `--ui-text`, `--ui-text-muted`
|
|
2338
2480
|
|
|
2339
2481
|
Example:
|
|
2340
2482
|
```html
|
|
@@ -2344,6 +2486,7 @@ Example:
|
|
|
2344
2486
|
</ui-button>
|
|
2345
2487
|
<ui-button variant="danger">Delete</ui-button>
|
|
2346
2488
|
<ui-button variant="secondary" href="/properties?edit=42">Edit</ui-button>
|
|
2489
|
+
<ui-button variant="primary" ai>Ask AI</ui-button>
|
|
2347
2490
|
```
|
|
2348
2491
|
|
|
2349
2492
|
## <ui-checkbox>
|
|
@@ -2433,7 +2576,7 @@ Import: `import "@f-ewald/components/weight-bar-chart.js";`
|
|
|
2433
2576
|
|
|
2434
2577
|
Properties: `items` (JS property only) : WeightBarItem[], default []
|
|
2435
2578
|
Events: none
|
|
2436
|
-
CSS custom properties: `--ui-font`, `--ui-font-size-sm`, `--ui-primary`, `--ui-surface-muted`, `--ui-text`, `--ui-text-muted`
|
|
2579
|
+
CSS custom properties: `--ui-font`, `--ui-font-size-sm`, `--ui-primary`, `--ui-radius-sm`, `--ui-surface-muted`, `--ui-text`, `--ui-text-muted`
|
|
2437
2580
|
|
|
2438
2581
|
Example:
|
|
2439
2582
|
```html
|