@fusion.dev/helix 0.153.0 → 0.155.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/custom-elements.json +2611 -115
- package/dist/badge/root/badge-root.css.js +1 -1
- package/dist/badge/root/badge-root.d.ts +1 -0
- package/dist/breadcrumbs/breadcrumb/breadcrumb.css.js +5 -1
- package/dist/card/root/card-root.css.js +3 -1
- package/dist/code/root/code-root.css.js +2 -2
- package/dist/code/root/code-root.d.ts +1 -0
- package/dist/code-block/root/code-block-root.css.js +4 -1
- package/dist/code-block/root/code-block-root.d.ts +1 -0
- package/dist/color-picker/root/color-picker-root.css.js +1 -1
- package/dist/date-picker/root/date-picker-root.css.js +1 -1
- package/dist/element-events.generated.js +2 -1
- package/dist/icon/root/icon-root.css.js +8 -1
- package/dist/icon/root/icon-root.d.ts +38 -1
- package/dist/icon/root/icon-root.js +17 -0
- package/dist/quote/root/quote-root.css.js +1 -1
- package/dist/skeleton/root/skeleton-root.css.js +11 -7
- package/dist/skeleton/root/skeleton-root.d.ts +18 -2
- package/dist/skeleton/root/skeleton-root.js +11 -0
- package/dist/slider/root/slider-root.css.js +4 -3
- package/dist/slider/root/slider-root.d.ts +1 -0
- package/dist/speed-dial/item/speed-dial-item.css.js +1 -1
- package/dist/speed-dial/root/speed-dial-root.css.js +1 -1
- package/dist/stat/root/stat-root.css.js +1 -1
- package/dist/tabs/root/tabs-root.css.js +5 -1
- package/dist/tabs/root/tabs-root.d.ts +3 -0
- package/dist/tabs/tab/tab.css.js +1 -1
- package/dist/tabs/tab/tab.d.ts +2 -0
- package/dist/tag/root/tag-root.d.ts +5 -0
- package/dist/toggle/root/toggle-root.css.js +1 -1
- package/lint.json +1 -1
- package/package.json +6 -6
- package/types/jsx.d.ts +1203 -152
- package/types/vue.d.ts +330 -43
- package/types/words.d.ts +39 -1
package/types/jsx.d.ts
CHANGED
|
@@ -2945,6 +2945,15 @@ element's language. Leave the marks out of the text. */
|
|
|
2945
2945
|
textContent?: (string | number) | undefined;
|
|
2946
2946
|
};
|
|
2947
2947
|
|
|
2948
|
+
/** `HelixBreadcrumb` component event */
|
|
2949
|
+
export type HelixBreadcrumbElementEvent<E = Event> = TypedEvent<
|
|
2950
|
+
HelixBreadcrumb,
|
|
2951
|
+
E
|
|
2952
|
+
>;
|
|
2953
|
+
/** `helix-select` event type */
|
|
2954
|
+
export type HelixBreadcrumbHelixSelectElementEvent =
|
|
2955
|
+
HelixBreadcrumbElementEvent<HelixSelectEvent>;
|
|
2956
|
+
|
|
2948
2957
|
export type HelixBreadcrumbProps = {
|
|
2949
2958
|
/** Marks this item as the page you are on. */
|
|
2950
2959
|
current?: (HelixBreadcrumb["current"]) | undefined;
|
|
@@ -2972,6 +2981,9 @@ The consumer's decision. */
|
|
|
2972
2981
|
rel?: (HelixBreadcrumb["rel"]) | undefined;
|
|
2973
2982
|
/** Where the link opens. Use it for a crumb that leaves the site. */
|
|
2974
2983
|
target?: (HelixBreadcrumb["target"]) | undefined;
|
|
2984
|
+
|
|
2985
|
+
/** A plain press on the crumb's link, with its `href` as the value, before the browser follows it. Cancelable: cancel it to keep the browser from following, as a client-side router does. */
|
|
2986
|
+
"onhelix-select"?: ((e: HelixBreadcrumbHelixSelectElementEvent) => void) | undefined;
|
|
2975
2987
|
};
|
|
2976
2988
|
|
|
2977
2989
|
export type HelixBreadcrumbSolidJsProps = {
|
|
@@ -3001,6 +3013,8 @@ The consumer's decision. */
|
|
|
3001
3013
|
"prop:rel"?: (HelixBreadcrumb["rel"]) | undefined;
|
|
3002
3014
|
/** Where the link opens. Use it for a crumb that leaves the site. */
|
|
3003
3015
|
"prop:target"?: (HelixBreadcrumb["target"]) | undefined;
|
|
3016
|
+
/** A plain press on the crumb's link, with its `href` as the value, before the browser follows it. Cancelable: cancel it to keep the browser from following, as a client-side router does. */
|
|
3017
|
+
"on:helix-select"?: ((e: HelixBreadcrumbHelixSelectElementEvent) => void) | undefined;
|
|
3004
3018
|
|
|
3005
3019
|
/** Set the innerHTML of the element */
|
|
3006
3020
|
innerHTML?: (string) | undefined;
|
|
@@ -5170,12 +5184,6 @@ twice what this says once.
|
|
|
5170
5184
|
Reflected and undefaulted, so a card that has not asked reads as a card
|
|
5171
5185
|
with no attribute on it and the stylesheet only describes the departure. */
|
|
5172
5186
|
mediaPlacement?: (HelixCard["mediaPlacement"]) | undefined;
|
|
5173
|
-
/** */
|
|
5174
|
-
"aria-labelledby"?: unknown;
|
|
5175
|
-
/** */
|
|
5176
|
-
undefined?: unknown;
|
|
5177
|
-
/** */
|
|
5178
|
-
"aria-label"?: unknown;
|
|
5179
5187
|
};
|
|
5180
5188
|
|
|
5181
5189
|
export type HelixCardSolidJsProps = {
|
|
@@ -5258,12 +5266,6 @@ twice what this says once.
|
|
|
5258
5266
|
Reflected and undefaulted, so a card that has not asked reads as a card
|
|
5259
5267
|
with no attribute on it and the stylesheet only describes the departure. */
|
|
5260
5268
|
"prop:mediaPlacement"?: (HelixCard["mediaPlacement"]) | undefined;
|
|
5261
|
-
/** */
|
|
5262
|
-
"attr:aria-labelledby"?: unknown;
|
|
5263
|
-
/** */
|
|
5264
|
-
"prop:undefined"?: unknown;
|
|
5265
|
-
/** */
|
|
5266
|
-
"attr:aria-label"?: unknown;
|
|
5267
5269
|
|
|
5268
5270
|
/** Set the innerHTML of the element */
|
|
5269
5271
|
innerHTML?: (string) | undefined;
|
|
@@ -7377,6 +7379,22 @@ significant in code and a wrapped line reads as two. For prose-like code, such a
|
|
|
7377
7379
|
a log line, a wrap reads better than a scroll. Line numbers keep the lines
|
|
7378
7380
|
unwrapped, since a wrapped line would take one number and several rows. */
|
|
7379
7381
|
wrap?: (HelixCodeBlock["wrap"]) | undefined;
|
|
7382
|
+
/** The name of a block that scrolls, which is a tab stop while it does.
|
|
7383
|
+
|
|
7384
|
+
Where the block has a name, the scroller says it too, such as "Code,
|
|
7385
|
+
app.ts", as `code-name-label` puts it. */
|
|
7386
|
+
"code-label"?: (HelixCodeBlock["codeLabel"]) | undefined;
|
|
7387
|
+
/** The name of a block that scrolls, which is a tab stop while it does.
|
|
7388
|
+
|
|
7389
|
+
Where the block has a name, the scroller says it too, such as "Code,
|
|
7390
|
+
app.ts", as `code-name-label` puts it. */
|
|
7391
|
+
codeLabel?: (HelixCodeBlock["codeLabel"]) | undefined;
|
|
7392
|
+
/** The name of a block that scrolls, where the block has a name. `{code}` is
|
|
7393
|
+
`code-label` and `{name}` the block's name. */
|
|
7394
|
+
"code-name-label"?: (HelixCodeBlock["codeNameLabel"]) | undefined;
|
|
7395
|
+
/** The name of a block that scrolls, where the block has a name. `{code}` is
|
|
7396
|
+
`code-label` and `{name}` the block's name. */
|
|
7397
|
+
codeNameLabel?: (HelixCodeBlock["codeNameLabel"]) | undefined;
|
|
7380
7398
|
/** The expand button's words while the block shows every line. */
|
|
7381
7399
|
"collapse-label"?: (HelixCodeBlock["collapseLabel"]) | undefined;
|
|
7382
7400
|
/** The expand button's words while the block shows every line. */
|
|
@@ -7524,6 +7542,22 @@ significant in code and a wrapped line reads as two. For prose-like code, such a
|
|
|
7524
7542
|
a log line, a wrap reads better than a scroll. Line numbers keep the lines
|
|
7525
7543
|
unwrapped, since a wrapped line would take one number and several rows. */
|
|
7526
7544
|
"prop:wrap"?: (HelixCodeBlock["wrap"]) | undefined;
|
|
7545
|
+
/** The name of a block that scrolls, which is a tab stop while it does.
|
|
7546
|
+
|
|
7547
|
+
Where the block has a name, the scroller says it too, such as "Code,
|
|
7548
|
+
app.ts", as `code-name-label` puts it. */
|
|
7549
|
+
"attr:code-label"?: (HelixCodeBlock["codeLabel"]) | undefined;
|
|
7550
|
+
/** The name of a block that scrolls, which is a tab stop while it does.
|
|
7551
|
+
|
|
7552
|
+
Where the block has a name, the scroller says it too, such as "Code,
|
|
7553
|
+
app.ts", as `code-name-label` puts it. */
|
|
7554
|
+
"prop:codeLabel"?: (HelixCodeBlock["codeLabel"]) | undefined;
|
|
7555
|
+
/** The name of a block that scrolls, where the block has a name. `{code}` is
|
|
7556
|
+
`code-label` and `{name}` the block's name. */
|
|
7557
|
+
"attr:code-name-label"?: (HelixCodeBlock["codeNameLabel"]) | undefined;
|
|
7558
|
+
/** The name of a block that scrolls, where the block has a name. `{code}` is
|
|
7559
|
+
`code-label` and `{name}` the block's name. */
|
|
7560
|
+
"prop:codeNameLabel"?: (HelixCodeBlock["codeNameLabel"]) | undefined;
|
|
7527
7561
|
/** The expand button's words while the block shows every line. */
|
|
7528
7562
|
"attr:collapse-label"?: (HelixCodeBlock["collapseLabel"]) | undefined;
|
|
7529
7563
|
/** The expand button's words while the block shows every line. */
|
|
@@ -7809,7 +7843,8 @@ Passed to the panel, whose square, hue ramp and presets say the color's
|
|
|
7809
7843
|
name, and read by the swatch in `swatch`, which says it before the value.
|
|
7810
7844
|
Color Picker lists the keys. */
|
|
7811
7845
|
colorWords?: (HelixColorInput["colorWords"]) | undefined;
|
|
7812
|
-
/** The syntax the value is written in: `hex`, `rgb`,
|
|
7846
|
+
/** The syntax the value is written in: `hex`, `rgb`, `hsl`, `oklch`, or
|
|
7847
|
+
`hsb`, as Color Picker's `format`.
|
|
7813
7848
|
|
|
7814
7849
|
**Undefaulted, because it reflects.** The two together stamp an attribute
|
|
7815
7850
|
onto every host anybody renders, including the ones nobody configured: the
|
|
@@ -8029,7 +8064,8 @@ Passed to the panel, whose square, hue ramp and presets say the color's
|
|
|
8029
8064
|
name, and read by the swatch in `swatch`, which says it before the value.
|
|
8030
8065
|
Color Picker lists the keys. */
|
|
8031
8066
|
"prop:colorWords"?: (HelixColorInput["colorWords"]) | undefined;
|
|
8032
|
-
/** The syntax the value is written in: `hex`, `rgb`,
|
|
8067
|
+
/** The syntax the value is written in: `hex`, `rgb`, `hsl`, `oklch`, or
|
|
8068
|
+
`hsb`, as Color Picker's `format`.
|
|
8033
8069
|
|
|
8034
8070
|
**Undefaulted, because it reflects.** The two together stamp an attribute
|
|
8035
8071
|
onto every host anybody renders, including the ones nobody configured: the
|
|
@@ -8218,8 +8254,9 @@ language hears its own rather than English between its own labels. */
|
|
|
8218
8254
|
brightnessLabel?: (HelixColorPicker["brightnessLabel"]) | undefined;
|
|
8219
8255
|
/** Whether the picker shows a number field for each channel of the color, as
|
|
8220
8256
|
React Aria's ColorField does with `channel`: red, green and blue for hex
|
|
8221
|
-
and rgb, hue, saturation and lightness for hsl,
|
|
8222
|
-
|
|
8257
|
+
and rgb, hue, saturation and lightness for hsl, hue, saturation and
|
|
8258
|
+
brightness for hsb, lightness, chroma and hue for oklch, and the opacity
|
|
8259
|
+
with `alpha`.
|
|
8223
8260
|
|
|
8224
8261
|
For a reader who has the numbers from a brand guide, and for a keyboard,
|
|
8225
8262
|
where typing 128 is quicker than holding an arrow key. The fields follow
|
|
@@ -8227,13 +8264,20 @@ the syntax the format toggle sets. */
|
|
|
8227
8264
|
"channel-fields"?: (HelixColorPicker["channelFields"]) | undefined;
|
|
8228
8265
|
/** Whether the picker shows a number field for each channel of the color, as
|
|
8229
8266
|
React Aria's ColorField does with `channel`: red, green and blue for hex
|
|
8230
|
-
and rgb, hue, saturation and lightness for hsl,
|
|
8231
|
-
|
|
8267
|
+
and rgb, hue, saturation and lightness for hsl, hue, saturation and
|
|
8268
|
+
brightness for hsb, lightness, chroma and hue for oklch, and the opacity
|
|
8269
|
+
with `alpha`.
|
|
8232
8270
|
|
|
8233
8271
|
For a reader who has the numbers from a brand guide, and for a keyboard,
|
|
8234
8272
|
where typing 128 is quicker than holding an arrow key. The fields follow
|
|
8235
8273
|
the syntax the format toggle sets. */
|
|
8236
8274
|
channelFields?: (HelixColorPicker["channelFields"]) | undefined;
|
|
8275
|
+
/** What the chroma channel's field is called, in `channel-fields` with
|
|
8276
|
+
oklch. */
|
|
8277
|
+
"chroma-label"?: (HelixColorPicker["chromaLabel"]) | undefined;
|
|
8278
|
+
/** What the chroma channel's field is called, in `channel-fields` with
|
|
8279
|
+
oklch. */
|
|
8280
|
+
chromaLabel?: (HelixColorPicker["chromaLabel"]) | undefined;
|
|
8237
8281
|
/** The words a color's name is spoken in, as JSON keyed by their English,
|
|
8238
8282
|
such as `{"red": "rot", "vibrant": "kräftiges"}`.
|
|
8239
8283
|
|
|
@@ -8274,10 +8318,16 @@ the color. */
|
|
|
8274
8318
|
"eyedropper-label"?: (HelixColorPicker["eyedropperLabel"]) | undefined;
|
|
8275
8319
|
/** What the eyedropper is called. */
|
|
8276
8320
|
eyedropperLabel?: (HelixColorPicker["eyedropperLabel"]) | undefined;
|
|
8277
|
-
/** The syntax the value is written in: `hex`, `rgb`,
|
|
8321
|
+
/** The syntax the value is written in: `hex`, `rgb`, `hsl`, `oklch`, or
|
|
8322
|
+
`hsb`.
|
|
8278
8323
|
|
|
8279
8324
|
Only what is written. Everything is read whatever this says, so a picker on
|
|
8280
|
-
`hex` still takes an `rgb()` handed to it and stores the
|
|
8325
|
+
`hex` still takes an `rgb()` or an `oklch()` handed to it and stores the
|
|
8326
|
+
hex for it. `oklch` writes the sRGB color the picker holds, such as
|
|
8327
|
+
`oklch(62.8% 0.258 29.2)`; a color outside sRGB that is handed in is
|
|
8328
|
+
clipped to it. `hsb` writes the picker's own model, `hsb(0, 100%, 100%)`,
|
|
8329
|
+
as React Aria's and Zag's color strings do. It is not CSS, so the toggle
|
|
8330
|
+
walks the other four. */
|
|
8281
8331
|
format?: (HelixColorPicker["format"]) | undefined;
|
|
8282
8332
|
/** What the syntax toggle is called, with `{format}` filled in. */
|
|
8283
8333
|
"format-label"?: (HelixColorPicker["formatLabel"]) | undefined;
|
|
@@ -8287,15 +8337,21 @@ Only what is written. Everything is read whatever this says, so a picker on
|
|
|
8287
8337
|
"green-label"?: (HelixColorPicker["greenLabel"]) | undefined;
|
|
8288
8338
|
/** What the green channel's field is called, in `channel-fields`. */
|
|
8289
8339
|
greenLabel?: (HelixColorPicker["greenLabel"]) | undefined;
|
|
8340
|
+
/** Help under the picker, such as what the color is used for. The `hint`
|
|
8341
|
+
slot takes richer content. */
|
|
8342
|
+
hint?: (HelixColorPicker["hint"]) | undefined;
|
|
8290
8343
|
/** What the hue channel is called. */
|
|
8291
8344
|
"hue-label"?: (HelixColorPicker["hueLabel"]) | undefined;
|
|
8292
8345
|
/** What the hue channel is called. */
|
|
8293
8346
|
hueLabel?: (HelixColorPicker["hueLabel"]) | undefined;
|
|
8347
|
+
/** The name above the picker, such as "Brand color". The picker is then a
|
|
8348
|
+
group with this name. The `label` slot takes richer content. */
|
|
8349
|
+
label?: (HelixColorPicker["label"]) | undefined;
|
|
8294
8350
|
/** What the lightness channel's field is called, in `channel-fields` with
|
|
8295
|
-
hsl. */
|
|
8351
|
+
hsl and oklch. */
|
|
8296
8352
|
"lightness-label"?: (HelixColorPicker["lightnessLabel"]) | undefined;
|
|
8297
8353
|
/** What the lightness channel's field is called, in `channel-fields` with
|
|
8298
|
-
hsl. */
|
|
8354
|
+
hsl and oklch. */
|
|
8299
8355
|
lightnessLabel?: (HelixColorPicker["lightnessLabel"]) | undefined;
|
|
8300
8356
|
/** Hides the eyedropper. Without it, the eyedropper appears in browsers that
|
|
8301
8357
|
support one. */
|
|
@@ -8578,8 +8634,9 @@ language hears its own rather than English between its own labels. */
|
|
|
8578
8634
|
"prop:brightnessLabel"?: (HelixColorPicker["brightnessLabel"]) | undefined;
|
|
8579
8635
|
/** Whether the picker shows a number field for each channel of the color, as
|
|
8580
8636
|
React Aria's ColorField does with `channel`: red, green and blue for hex
|
|
8581
|
-
and rgb, hue, saturation and lightness for hsl,
|
|
8582
|
-
|
|
8637
|
+
and rgb, hue, saturation and lightness for hsl, hue, saturation and
|
|
8638
|
+
brightness for hsb, lightness, chroma and hue for oklch, and the opacity
|
|
8639
|
+
with `alpha`.
|
|
8583
8640
|
|
|
8584
8641
|
For a reader who has the numbers from a brand guide, and for a keyboard,
|
|
8585
8642
|
where typing 128 is quicker than holding an arrow key. The fields follow
|
|
@@ -8587,13 +8644,20 @@ the syntax the format toggle sets. */
|
|
|
8587
8644
|
"bool:channel-fields"?: (HelixColorPicker["channelFields"]) | undefined;
|
|
8588
8645
|
/** Whether the picker shows a number field for each channel of the color, as
|
|
8589
8646
|
React Aria's ColorField does with `channel`: red, green and blue for hex
|
|
8590
|
-
and rgb, hue, saturation and lightness for hsl,
|
|
8591
|
-
|
|
8647
|
+
and rgb, hue, saturation and lightness for hsl, hue, saturation and
|
|
8648
|
+
brightness for hsb, lightness, chroma and hue for oklch, and the opacity
|
|
8649
|
+
with `alpha`.
|
|
8592
8650
|
|
|
8593
8651
|
For a reader who has the numbers from a brand guide, and for a keyboard,
|
|
8594
8652
|
where typing 128 is quicker than holding an arrow key. The fields follow
|
|
8595
8653
|
the syntax the format toggle sets. */
|
|
8596
8654
|
"prop:channelFields"?: (HelixColorPicker["channelFields"]) | undefined;
|
|
8655
|
+
/** What the chroma channel's field is called, in `channel-fields` with
|
|
8656
|
+
oklch. */
|
|
8657
|
+
"attr:chroma-label"?: (HelixColorPicker["chromaLabel"]) | undefined;
|
|
8658
|
+
/** What the chroma channel's field is called, in `channel-fields` with
|
|
8659
|
+
oklch. */
|
|
8660
|
+
"prop:chromaLabel"?: (HelixColorPicker["chromaLabel"]) | undefined;
|
|
8597
8661
|
/** The words a color's name is spoken in, as JSON keyed by their English,
|
|
8598
8662
|
such as `{"red": "rot", "vibrant": "kräftiges"}`.
|
|
8599
8663
|
|
|
@@ -8634,10 +8698,16 @@ the color. */
|
|
|
8634
8698
|
"attr:eyedropper-label"?: (HelixColorPicker["eyedropperLabel"]) | undefined;
|
|
8635
8699
|
/** What the eyedropper is called. */
|
|
8636
8700
|
"prop:eyedropperLabel"?: (HelixColorPicker["eyedropperLabel"]) | undefined;
|
|
8637
|
-
/** The syntax the value is written in: `hex`, `rgb`,
|
|
8701
|
+
/** The syntax the value is written in: `hex`, `rgb`, `hsl`, `oklch`, or
|
|
8702
|
+
`hsb`.
|
|
8638
8703
|
|
|
8639
8704
|
Only what is written. Everything is read whatever this says, so a picker on
|
|
8640
|
-
`hex` still takes an `rgb()` handed to it and stores the
|
|
8705
|
+
`hex` still takes an `rgb()` or an `oklch()` handed to it and stores the
|
|
8706
|
+
hex for it. `oklch` writes the sRGB color the picker holds, such as
|
|
8707
|
+
`oklch(62.8% 0.258 29.2)`; a color outside sRGB that is handed in is
|
|
8708
|
+
clipped to it. `hsb` writes the picker's own model, `hsb(0, 100%, 100%)`,
|
|
8709
|
+
as React Aria's and Zag's color strings do. It is not CSS, so the toggle
|
|
8710
|
+
walks the other four. */
|
|
8641
8711
|
"prop:format"?: (HelixColorPicker["format"]) | undefined;
|
|
8642
8712
|
/** What the syntax toggle is called, with `{format}` filled in. */
|
|
8643
8713
|
"attr:format-label"?: (HelixColorPicker["formatLabel"]) | undefined;
|
|
@@ -8647,15 +8717,21 @@ Only what is written. Everything is read whatever this says, so a picker on
|
|
|
8647
8717
|
"attr:green-label"?: (HelixColorPicker["greenLabel"]) | undefined;
|
|
8648
8718
|
/** What the green channel's field is called, in `channel-fields`. */
|
|
8649
8719
|
"prop:greenLabel"?: (HelixColorPicker["greenLabel"]) | undefined;
|
|
8720
|
+
/** Help under the picker, such as what the color is used for. The `hint`
|
|
8721
|
+
slot takes richer content. */
|
|
8722
|
+
"prop:hint"?: (HelixColorPicker["hint"]) | undefined;
|
|
8650
8723
|
/** What the hue channel is called. */
|
|
8651
8724
|
"attr:hue-label"?: (HelixColorPicker["hueLabel"]) | undefined;
|
|
8652
8725
|
/** What the hue channel is called. */
|
|
8653
8726
|
"prop:hueLabel"?: (HelixColorPicker["hueLabel"]) | undefined;
|
|
8727
|
+
/** The name above the picker, such as "Brand color". The picker is then a
|
|
8728
|
+
group with this name. The `label` slot takes richer content. */
|
|
8729
|
+
"prop:label"?: (HelixColorPicker["label"]) | undefined;
|
|
8654
8730
|
/** What the lightness channel's field is called, in `channel-fields` with
|
|
8655
|
-
hsl. */
|
|
8731
|
+
hsl and oklch. */
|
|
8656
8732
|
"attr:lightness-label"?: (HelixColorPicker["lightnessLabel"]) | undefined;
|
|
8657
8733
|
/** What the lightness channel's field is called, in `channel-fields` with
|
|
8658
|
-
hsl. */
|
|
8734
|
+
hsl and oklch. */
|
|
8659
8735
|
"prop:lightnessLabel"?: (HelixColorPicker["lightnessLabel"]) | undefined;
|
|
8660
8736
|
/** Hides the eyedropper. Without it, the eyedropper appears in browsers that
|
|
8661
8737
|
support one. */
|
|
@@ -11903,15 +11979,22 @@ speaks it. Unset is the sentence registered for the page's language, then
|
|
|
11903
11979
|
the English. `{mode}` is `single`, `range` or `multiple`, so each can have
|
|
11904
11980
|
its own sentence. */
|
|
11905
11981
|
badInputMessage?: (HelixDatePicker["badInputMessage"]) | undefined;
|
|
11906
|
-
/** The calendar the heading, the days, and the months are written in
|
|
11907
|
-
|
|
11908
|
-
|
|
11909
|
-
|
|
11910
|
-
|
|
11911
|
-
`
|
|
11912
|
-
|
|
11913
|
-
|
|
11914
|
-
|
|
11982
|
+
/** The calendar the heading, the days, and the months are written in.
|
|
11983
|
+
|
|
11984
|
+
`gregory`, `buddhist`, `japanese`, `roc`, and `iso8601` are the five
|
|
11985
|
+
whose months are the Gregorian months. Absent is the locale's own where
|
|
11986
|
+
it is one of the five, such as `buddhist` for `th-TH` or `japanese` for
|
|
11987
|
+
`ja-JP-u-ca-japanese`, and `gregory` for every other, such as `persian`
|
|
11988
|
+
for `fa-IR`.
|
|
11989
|
+
|
|
11990
|
+
`persian`, `hebrew`, `islamic-umalqura`, `islamic-civil`, `ethiopic`,
|
|
11991
|
+
`coptic`, and `indian` draw a calendar with months of its own, as React
|
|
11992
|
+
Aria's calendars do: each grid is one of that calendar's months, the
|
|
11993
|
+
Hebrew leap month and Ethiopia's five-day thirteenth month included, and
|
|
11994
|
+
Previous, Next and the page keys move by those months. `month` and
|
|
11995
|
+
`helix-navigate` then name a month by its first day, `YYYY-MM-DD`. The
|
|
11996
|
+
heading stays text, as the months and years views are drawn in Gregorian
|
|
11997
|
+
months only. The value is `YYYY-MM-DD` in every calendar. */
|
|
11915
11998
|
calendar?: (HelixDatePicker["calendar"]) | undefined;
|
|
11916
11999
|
/** The month to open on when `month` is not set. */
|
|
11917
12000
|
"default-month"?: (HelixDatePicker["defaultMonth"]) | undefined;
|
|
@@ -11970,8 +12053,9 @@ its days. */
|
|
|
11970
12053
|
min?: (HelixDatePicker["min"]) | undefined;
|
|
11971
12054
|
/** How many dates can be held at once. */
|
|
11972
12055
|
mode?: (HelixDatePicker["mode"]) | undefined;
|
|
11973
|
-
/** The month shown, as `YYYY-MM
|
|
11974
|
-
|
|
12056
|
+
/** The month shown, as `YYYY-MM`, or as its first day, `YYYY-MM-DD`, under a
|
|
12057
|
+
`calendar` with months of its own. When it is not set, it follows
|
|
12058
|
+
`value`, then the current month.
|
|
11975
12059
|
|
|
11976
12060
|
Separate from `value` on purpose, so paging selects nothing and a consumer
|
|
11977
12061
|
can drive the view. Reading gives the month on show; writing sets it, and
|
|
@@ -12073,6 +12157,22 @@ date including the one already chosen. */
|
|
|
12073
12157
|
"step-mismatch-message"?: (HelixDatePicker["stepMismatchMessage"]) | undefined;
|
|
12074
12158
|
/** The validation message for a date that `step` skips. */
|
|
12075
12159
|
stepMismatchMessage?: (HelixDatePicker["stepMismatchMessage"]) | undefined;
|
|
12160
|
+
/** The time zone today is read in, such as `America/New_York`, as React
|
|
12161
|
+
Aria's `today(timeZone)` reads it. Empty is the reader's own.
|
|
12162
|
+
|
|
12163
|
+
Dates are plain `YYYY-MM-DD` and carry no zone, so this moves only today:
|
|
12164
|
+
the day marked `aria-current` and `day-today`, and the month a picker
|
|
12165
|
+
with no value opens on. A desk in Tokyo booking for an office in New York
|
|
12166
|
+
sets `America/New_York`, and today is the office's. */
|
|
12167
|
+
"time-zone"?: (HelixDatePicker["timeZone"]) | undefined;
|
|
12168
|
+
/** The time zone today is read in, such as `America/New_York`, as React
|
|
12169
|
+
Aria's `today(timeZone)` reads it. Empty is the reader's own.
|
|
12170
|
+
|
|
12171
|
+
Dates are plain `YYYY-MM-DD` and carry no zone, so this moves only today:
|
|
12172
|
+
the day marked `aria-current` and `day-today`, and the month a picker
|
|
12173
|
+
with no value opens on. A desk in Tokyo booking for an office in New York
|
|
12174
|
+
sets `America/New_York`, and today is the office's. */
|
|
12175
|
+
timeZone?: (HelixDatePicker["timeZone"]) | undefined;
|
|
12076
12176
|
/** The validation message for a date that `disable-dates` or `disable-days`
|
|
12077
12177
|
bars. */
|
|
12078
12178
|
"unavailable-message"?: (HelixDatePicker["unavailableMessage"]) | undefined;
|
|
@@ -12210,15 +12310,22 @@ speaks it. Unset is the sentence registered for the page's language, then
|
|
|
12210
12310
|
the English. `{mode}` is `single`, `range` or `multiple`, so each can have
|
|
12211
12311
|
its own sentence. */
|
|
12212
12312
|
"prop:badInputMessage"?: (HelixDatePicker["badInputMessage"]) | undefined;
|
|
12213
|
-
/** The calendar the heading, the days, and the months are written in
|
|
12214
|
-
|
|
12215
|
-
|
|
12216
|
-
|
|
12217
|
-
|
|
12218
|
-
`
|
|
12219
|
-
|
|
12220
|
-
|
|
12221
|
-
|
|
12313
|
+
/** The calendar the heading, the days, and the months are written in.
|
|
12314
|
+
|
|
12315
|
+
`gregory`, `buddhist`, `japanese`, `roc`, and `iso8601` are the five
|
|
12316
|
+
whose months are the Gregorian months. Absent is the locale's own where
|
|
12317
|
+
it is one of the five, such as `buddhist` for `th-TH` or `japanese` for
|
|
12318
|
+
`ja-JP-u-ca-japanese`, and `gregory` for every other, such as `persian`
|
|
12319
|
+
for `fa-IR`.
|
|
12320
|
+
|
|
12321
|
+
`persian`, `hebrew`, `islamic-umalqura`, `islamic-civil`, `ethiopic`,
|
|
12322
|
+
`coptic`, and `indian` draw a calendar with months of its own, as React
|
|
12323
|
+
Aria's calendars do: each grid is one of that calendar's months, the
|
|
12324
|
+
Hebrew leap month and Ethiopia's five-day thirteenth month included, and
|
|
12325
|
+
Previous, Next and the page keys move by those months. `month` and
|
|
12326
|
+
`helix-navigate` then name a month by its first day, `YYYY-MM-DD`. The
|
|
12327
|
+
heading stays text, as the months and years views are drawn in Gregorian
|
|
12328
|
+
months only. The value is `YYYY-MM-DD` in every calendar. */
|
|
12222
12329
|
"prop:calendar"?: (HelixDatePicker["calendar"]) | undefined;
|
|
12223
12330
|
/** The month to open on when `month` is not set. */
|
|
12224
12331
|
"attr:default-month"?: (HelixDatePicker["defaultMonth"]) | undefined;
|
|
@@ -12277,8 +12384,9 @@ its days. */
|
|
|
12277
12384
|
"prop:min"?: (HelixDatePicker["min"]) | undefined;
|
|
12278
12385
|
/** How many dates can be held at once. */
|
|
12279
12386
|
"prop:mode"?: (HelixDatePicker["mode"]) | undefined;
|
|
12280
|
-
/** The month shown, as `YYYY-MM
|
|
12281
|
-
|
|
12387
|
+
/** The month shown, as `YYYY-MM`, or as its first day, `YYYY-MM-DD`, under a
|
|
12388
|
+
`calendar` with months of its own. When it is not set, it follows
|
|
12389
|
+
`value`, then the current month.
|
|
12282
12390
|
|
|
12283
12391
|
Separate from `value` on purpose, so paging selects nothing and a consumer
|
|
12284
12392
|
can drive the view. Reading gives the month on show; writing sets it, and
|
|
@@ -12380,6 +12488,22 @@ date including the one already chosen. */
|
|
|
12380
12488
|
"attr:step-mismatch-message"?: (HelixDatePicker["stepMismatchMessage"]) | undefined;
|
|
12381
12489
|
/** The validation message for a date that `step` skips. */
|
|
12382
12490
|
"prop:stepMismatchMessage"?: (HelixDatePicker["stepMismatchMessage"]) | undefined;
|
|
12491
|
+
/** The time zone today is read in, such as `America/New_York`, as React
|
|
12492
|
+
Aria's `today(timeZone)` reads it. Empty is the reader's own.
|
|
12493
|
+
|
|
12494
|
+
Dates are plain `YYYY-MM-DD` and carry no zone, so this moves only today:
|
|
12495
|
+
the day marked `aria-current` and `day-today`, and the month a picker
|
|
12496
|
+
with no value opens on. A desk in Tokyo booking for an office in New York
|
|
12497
|
+
sets `America/New_York`, and today is the office's. */
|
|
12498
|
+
"attr:time-zone"?: (HelixDatePicker["timeZone"]) | undefined;
|
|
12499
|
+
/** The time zone today is read in, such as `America/New_York`, as React
|
|
12500
|
+
Aria's `today(timeZone)` reads it. Empty is the reader's own.
|
|
12501
|
+
|
|
12502
|
+
Dates are plain `YYYY-MM-DD` and carry no zone, so this moves only today:
|
|
12503
|
+
the day marked `aria-current` and `day-today`, and the month a picker
|
|
12504
|
+
with no value opens on. A desk in Tokyo booking for an office in New York
|
|
12505
|
+
sets `America/New_York`, and today is the office's. */
|
|
12506
|
+
"prop:timeZone"?: (HelixDatePicker["timeZone"]) | undefined;
|
|
12383
12507
|
/** The validation message for a date that `disable-dates` or `disable-days`
|
|
12384
12508
|
bars. */
|
|
12385
12509
|
"attr:unavailable-message"?: (HelixDatePicker["unavailableMessage"]) | undefined;
|
|
@@ -17073,6 +17197,31 @@ invoker without an id in the same tree needs. */
|
|
|
17073
17197
|
export type HelixIconElementEvent<E = Event> = TypedEvent<HelixIcon, E>;
|
|
17074
17198
|
|
|
17075
17199
|
export type HelixIconProps = {
|
|
17200
|
+
/** A motion that draws the eye or says work is going on: `spin` turns the
|
|
17201
|
+
glyph without end, `pulse` fades it in and out, and `beat` swells it.
|
|
17202
|
+
|
|
17203
|
+
Absent is still. Reduced motion stills every one of them. */
|
|
17204
|
+
animation?: (HelixIcon["animation"]) | undefined;
|
|
17205
|
+
/** Whether the box takes the glyph's own proportions, its height from
|
|
17206
|
+
`--icon-size` and its width from the glyph's box.
|
|
17207
|
+
|
|
17208
|
+
Absent is a square, which lines icons up in a column. */
|
|
17209
|
+
"auto-width"?: (HelixIcon["autoWidth"]) | undefined;
|
|
17210
|
+
/** Whether the box takes the glyph's own proportions, its height from
|
|
17211
|
+
`--icon-size` and its width from the glyph's box.
|
|
17212
|
+
|
|
17213
|
+
Absent is a square, which lines icons up in a column. */
|
|
17214
|
+
autoWidth?: (HelixIcon["autoWidth"]) | undefined;
|
|
17215
|
+
/** Mirrors the glyph across an axis: `x` left to right, `y` top to bottom,
|
|
17216
|
+
`both` across both.
|
|
17217
|
+
|
|
17218
|
+
Absent draws it as it is. On a right-to-left page, `mirror` is the flip
|
|
17219
|
+
that follows the direction. */
|
|
17220
|
+
flip?: (HelixIcon["flip"]) | undefined;
|
|
17221
|
+
/** Turns the glyph clockwise by 90, 180 or 270 degrees.
|
|
17222
|
+
|
|
17223
|
+
Absent draws it upright. `--icon-rotate` turns it by any other angle. */
|
|
17224
|
+
rotate?: (HelixIcon["rotate"]) | undefined;
|
|
17076
17225
|
/** The icon's name, read by screen readers. Set it for an icon that is not
|
|
17077
17226
|
decorative. */
|
|
17078
17227
|
label?: (HelixIcon["label"]) | undefined;
|
|
@@ -17096,6 +17245,11 @@ the value instead.
|
|
|
17096
17245
|
A name written `prefix:name` asks the library registered under that
|
|
17097
17246
|
prefix. */
|
|
17098
17247
|
name?: (HelixIcon["name"]) | undefined;
|
|
17248
|
+
/** The URL of an SVG file to draw, fetched once a page and drawn in
|
|
17249
|
+
`currentColor` where the file does not color its shapes.
|
|
17250
|
+
|
|
17251
|
+
Wins over `name`; `icon` wins over both. Absent draws `name`. */
|
|
17252
|
+
src?: (HelixIcon["src"]) | undefined;
|
|
17099
17253
|
/** The icon to draw, as an object you import.
|
|
17100
17254
|
|
|
17101
17255
|
**The scalable door, and the one this library uses internally.** An icon is
|
|
@@ -17110,13 +17264,38 @@ frameworks set properties and plain markup cannot, which is what `name` is
|
|
|
17110
17264
|
for. Set both and this wins, the value being the more specific statement. */
|
|
17111
17265
|
icon?: (HelixIcon["icon"]) | undefined;
|
|
17112
17266
|
|
|
17113
|
-
/** `name` matches no registered icon and no library answers it, so nothing is drawn. */
|
|
17267
|
+
/** `name` matches no registered icon and no library answers it, or `src` is no SVG, so nothing is drawn. */
|
|
17114
17268
|
onerror?: ((e: HelixIconElementEvent) => void) | undefined;
|
|
17115
|
-
/** A glyph a library gave later for `name` is drawn. */
|
|
17269
|
+
/** A glyph a library gave later for `name`, or the file at `src`, is drawn. */
|
|
17116
17270
|
onload?: ((e: HelixIconElementEvent) => void) | undefined;
|
|
17117
17271
|
};
|
|
17118
17272
|
|
|
17119
17273
|
export type HelixIconSolidJsProps = {
|
|
17274
|
+
/** A motion that draws the eye or says work is going on: `spin` turns the
|
|
17275
|
+
glyph without end, `pulse` fades it in and out, and `beat` swells it.
|
|
17276
|
+
|
|
17277
|
+
Absent is still. Reduced motion stills every one of them. */
|
|
17278
|
+
"prop:animation"?: (HelixIcon["animation"]) | undefined;
|
|
17279
|
+
/** Whether the box takes the glyph's own proportions, its height from
|
|
17280
|
+
`--icon-size` and its width from the glyph's box.
|
|
17281
|
+
|
|
17282
|
+
Absent is a square, which lines icons up in a column. */
|
|
17283
|
+
"bool:auto-width"?: (HelixIcon["autoWidth"]) | undefined;
|
|
17284
|
+
/** Whether the box takes the glyph's own proportions, its height from
|
|
17285
|
+
`--icon-size` and its width from the glyph's box.
|
|
17286
|
+
|
|
17287
|
+
Absent is a square, which lines icons up in a column. */
|
|
17288
|
+
"prop:autoWidth"?: (HelixIcon["autoWidth"]) | undefined;
|
|
17289
|
+
/** Mirrors the glyph across an axis: `x` left to right, `y` top to bottom,
|
|
17290
|
+
`both` across both.
|
|
17291
|
+
|
|
17292
|
+
Absent draws it as it is. On a right-to-left page, `mirror` is the flip
|
|
17293
|
+
that follows the direction. */
|
|
17294
|
+
"prop:flip"?: (HelixIcon["flip"]) | undefined;
|
|
17295
|
+
/** Turns the glyph clockwise by 90, 180 or 270 degrees.
|
|
17296
|
+
|
|
17297
|
+
Absent draws it upright. `--icon-rotate` turns it by any other angle. */
|
|
17298
|
+
"prop:rotate"?: (HelixIcon["rotate"]) | undefined;
|
|
17120
17299
|
/** The icon's name, read by screen readers. Set it for an icon that is not
|
|
17121
17300
|
decorative. */
|
|
17122
17301
|
"prop:label"?: (HelixIcon["label"]) | undefined;
|
|
@@ -17140,6 +17319,11 @@ the value instead.
|
|
|
17140
17319
|
A name written `prefix:name` asks the library registered under that
|
|
17141
17320
|
prefix. */
|
|
17142
17321
|
"prop:name"?: (HelixIcon["name"]) | undefined;
|
|
17322
|
+
/** The URL of an SVG file to draw, fetched once a page and drawn in
|
|
17323
|
+
`currentColor` where the file does not color its shapes.
|
|
17324
|
+
|
|
17325
|
+
Wins over `name`; `icon` wins over both. Absent draws `name`. */
|
|
17326
|
+
"prop:src"?: (HelixIcon["src"]) | undefined;
|
|
17143
17327
|
/** The icon to draw, as an object you import.
|
|
17144
17328
|
|
|
17145
17329
|
**The scalable door, and the one this library uses internally.** An icon is
|
|
@@ -17153,9 +17337,9 @@ consumer's own drawings.
|
|
|
17153
17337
|
frameworks set properties and plain markup cannot, which is what `name` is
|
|
17154
17338
|
for. Set both and this wins, the value being the more specific statement. */
|
|
17155
17339
|
"prop:icon"?: (HelixIcon["icon"]) | undefined;
|
|
17156
|
-
/** `name` matches no registered icon and no library answers it, so nothing is drawn. */
|
|
17340
|
+
/** `name` matches no registered icon and no library answers it, or `src` is no SVG, so nothing is drawn. */
|
|
17157
17341
|
"on:error"?: ((e: HelixIconElementEvent) => void) | undefined;
|
|
17158
|
-
/** A glyph a library gave later for `name` is drawn. */
|
|
17342
|
+
/** A glyph a library gave later for `name`, or the file at `src`, is drawn. */
|
|
17159
17343
|
"on:load"?: ((e: HelixIconElementEvent) => void) | undefined;
|
|
17160
17344
|
|
|
17161
17345
|
/** Set the innerHTML of the element */
|
|
@@ -25940,11 +26124,39 @@ which is what makes it read as dots rather than as a softened square code. */
|
|
|
25940
26124
|
export type HelixQuoteProps = {
|
|
25941
26125
|
/** URL identifying where the quotation came from. */
|
|
25942
26126
|
cite?: (HelixQuote["cite"]) | undefined;
|
|
26127
|
+
/** Whether to leave the quotation marks off, for a quotation set where the
|
|
26128
|
+
page draws its own.
|
|
26129
|
+
|
|
26130
|
+
Negative, because the marks are on by default and a boolean attribute is
|
|
26131
|
+
true whenever it is present. Reflected, because a stylesheet takes the
|
|
26132
|
+
marks off on it. */
|
|
26133
|
+
"no-marks"?: (HelixQuote["noMarks"]) | undefined;
|
|
26134
|
+
/** Whether to leave the quotation marks off, for a quotation set where the
|
|
26135
|
+
page draws its own.
|
|
26136
|
+
|
|
26137
|
+
Negative, because the marks are on by default and a boolean attribute is
|
|
26138
|
+
true whenever it is present. Reflected, because a stylesheet takes the
|
|
26139
|
+
marks off on it. */
|
|
26140
|
+
noMarks?: (HelixQuote["noMarks"]) | undefined;
|
|
25943
26141
|
};
|
|
25944
26142
|
|
|
25945
26143
|
export type HelixQuoteSolidJsProps = {
|
|
25946
26144
|
/** URL identifying where the quotation came from. */
|
|
25947
26145
|
"prop:cite"?: (HelixQuote["cite"]) | undefined;
|
|
26146
|
+
/** Whether to leave the quotation marks off, for a quotation set where the
|
|
26147
|
+
page draws its own.
|
|
26148
|
+
|
|
26149
|
+
Negative, because the marks are on by default and a boolean attribute is
|
|
26150
|
+
true whenever it is present. Reflected, because a stylesheet takes the
|
|
26151
|
+
marks off on it. */
|
|
26152
|
+
"bool:no-marks"?: (HelixQuote["noMarks"]) | undefined;
|
|
26153
|
+
/** Whether to leave the quotation marks off, for a quotation set where the
|
|
26154
|
+
page draws its own.
|
|
26155
|
+
|
|
26156
|
+
Negative, because the marks are on by default and a boolean attribute is
|
|
26157
|
+
true whenever it is present. Reflected, because a stylesheet takes the
|
|
26158
|
+
marks off on it. */
|
|
26159
|
+
"prop:noMarks"?: (HelixQuote["noMarks"]) | undefined;
|
|
25948
26160
|
|
|
25949
26161
|
/** Set the innerHTML of the element */
|
|
25950
26162
|
innerHTML?: (string) | undefined;
|
|
@@ -28307,6 +28519,18 @@ the stop moves on the trigger inside the shadow root, as Button's does.
|
|
|
28307
28519
|
No attribute, because it is coordination between elements rather than
|
|
28308
28520
|
anything a consumer sets. */
|
|
28309
28521
|
focusable?: (HelixSelect["focusable"]) | undefined;
|
|
28522
|
+
/** The options as data, for a list too long to draw whole: each a value,
|
|
28523
|
+
which is also its words, or a record with a `value`, a `label` and
|
|
28524
|
+
`disabled`. Passed to the list, which draws only the options in sight,
|
|
28525
|
+
as Listbox's `items` does. Set, the options you write as children are
|
|
28526
|
+
not read.
|
|
28527
|
+
|
|
28528
|
+
The trigger shows the chosen options' labels, the letters and the Left
|
|
28529
|
+
and Right keys on the closed trigger choose over the whole set, and a
|
|
28530
|
+
chosen value whose option leaves `items` drops out of `value`.
|
|
28531
|
+
`value-content` is not called for `items`. Import the Option family as
|
|
28532
|
+
well, whose elements are drawn. */
|
|
28533
|
+
items?: (HelixSelect["items"]) | undefined;
|
|
28310
28534
|
/** What the trigger shows for the chosen options: a function given them, in
|
|
28311
28535
|
the order they appear, that returns text, an element or a Lit template.
|
|
28312
28536
|
|
|
@@ -28542,6 +28766,18 @@ the stop moves on the trigger inside the shadow root, as Button's does.
|
|
|
28542
28766
|
No attribute, because it is coordination between elements rather than
|
|
28543
28767
|
anything a consumer sets. */
|
|
28544
28768
|
"prop:focusable"?: (HelixSelect["focusable"]) | undefined;
|
|
28769
|
+
/** The options as data, for a list too long to draw whole: each a value,
|
|
28770
|
+
which is also its words, or a record with a `value`, a `label` and
|
|
28771
|
+
`disabled`. Passed to the list, which draws only the options in sight,
|
|
28772
|
+
as Listbox's `items` does. Set, the options you write as children are
|
|
28773
|
+
not read.
|
|
28774
|
+
|
|
28775
|
+
The trigger shows the chosen options' labels, the letters and the Left
|
|
28776
|
+
and Right keys on the closed trigger choose over the whole set, and a
|
|
28777
|
+
chosen value whose option leaves `items` drops out of `value`.
|
|
28778
|
+
`value-content` is not called for `items`. Import the Option family as
|
|
28779
|
+
well, whose elements are drawn. */
|
|
28780
|
+
"prop:items"?: (HelixSelect["items"]) | undefined;
|
|
28545
28781
|
/** What the trigger shows for the chosen options: a function given them, in
|
|
28546
28782
|
the order they appear, that returns text, an element or a Lit template.
|
|
28547
28783
|
|
|
@@ -28591,6 +28827,11 @@ fade the fill in and out, or `none` to sit still.
|
|
|
28591
28827
|
|
|
28592
28828
|
Reduced motion stills both. */
|
|
28593
28829
|
effect?: (HelixSkeleton["effect"]) | undefined;
|
|
28830
|
+
/** How many lines of text the placeholder stands for, with `shape="text"`.
|
|
28831
|
+
|
|
28832
|
+
Absent, or 1, is one line. Reflected, because the stylesheet sizes a
|
|
28833
|
+
paragraph by it. */
|
|
28834
|
+
lines?: (HelixSkeleton["lines"]) | undefined;
|
|
28594
28835
|
/** The shape of the placeholder: `text`, `circle`, or a block when unset.
|
|
28595
28836
|
|
|
28596
28837
|
Unset is a block, which is what most missing things are. A block is the
|
|
@@ -28616,6 +28857,11 @@ fade the fill in and out, or `none` to sit still.
|
|
|
28616
28857
|
|
|
28617
28858
|
Reduced motion stills both. */
|
|
28618
28859
|
"prop:effect"?: (HelixSkeleton["effect"]) | undefined;
|
|
28860
|
+
/** How many lines of text the placeholder stands for, with `shape="text"`.
|
|
28861
|
+
|
|
28862
|
+
Absent, or 1, is one line. Reflected, because the stylesheet sizes a
|
|
28863
|
+
paragraph by it. */
|
|
28864
|
+
"prop:lines"?: (HelixSkeleton["lines"]) | undefined;
|
|
28619
28865
|
/** The shape of the placeholder: `text`, `circle`, or a block when unset.
|
|
28620
28866
|
|
|
28621
28867
|
Unset is a block, which is what most missing things are. A block is the
|
|
@@ -28817,9 +29063,11 @@ between its thumbs and ignores it. */
|
|
|
28817
29063
|
origin?: (HelixSlider["origin"]) | undefined;
|
|
28818
29064
|
/** Adds a second thumb, so the value is a pair.
|
|
28819
29065
|
|
|
28820
|
-
The pair is one string, `"10,50"`, which is what
|
|
28821
|
-
`MixinControllerValue`
|
|
28822
|
-
|
|
29066
|
+
The pair is one string, `"10,50"`, which is what `value` and
|
|
29067
|
+
`MixinControllerValue` hold. A form receives two entries under the name,
|
|
29068
|
+
`price=10&price=50`, as React Aria's two thumbs send theirs.
|
|
29069
|
+
`valueAsNumber` reads the lower of the two, since a range has no single
|
|
29070
|
+
number. */
|
|
28823
29071
|
range?: (HelixSlider["range"]) | undefined;
|
|
28824
29072
|
/** How the readout joins a range's two values, with `{start}` and `{end}`
|
|
28825
29073
|
filled in. Write it in the page's language, such as `{start} bis {end}`. */
|
|
@@ -28827,12 +29075,34 @@ filled in. Write it in the page's language, such as `{start} bis {end}`. */
|
|
|
28827
29075
|
/** How the readout joins a range's two values, with `{start}` and `{end}`
|
|
28828
29076
|
filled in. Write it in the page's language, such as `{start} bis {end}`. */
|
|
28829
29077
|
rangeText?: (HelixSlider["rangeText"]) | undefined;
|
|
29078
|
+
/** Whether a reader can see and focus the value and cannot change it. A
|
|
29079
|
+
read-only slider still submits its value.
|
|
29080
|
+
|
|
29081
|
+
React Aria's `isReadOnly`. Each thumb stays a tab stop and says
|
|
29082
|
+
`aria-readonly`. The arrow keys, the page keys, Home, End, and a drag
|
|
29083
|
+
leave the value where it is. A script can still set `value`. */
|
|
29084
|
+
readonly?: (HelixSlider["readOnly"]) | undefined;
|
|
29085
|
+
/** Whether a reader can see and focus the value and cannot change it. A
|
|
29086
|
+
read-only slider still submits its value.
|
|
29087
|
+
|
|
29088
|
+
React Aria's `isReadOnly`. Each thumb stays a tab stop and says
|
|
29089
|
+
`aria-readonly`. The arrow keys, the page keys, Home, End, and a drag
|
|
29090
|
+
leave the value where it is. A script can still set `value`. */
|
|
29091
|
+
readOnly?: (HelixSlider["readOnly"]) | undefined;
|
|
28830
29092
|
/** Shows the chosen value beside the track. */
|
|
28831
29093
|
"show-value"?: (HelixSlider["showValue"]) | undefined;
|
|
28832
29094
|
/** Shows the chosen value beside the track. */
|
|
28833
29095
|
showValue?: (HelixSlider["showValue"]) | undefined;
|
|
28834
29096
|
/** How far one press of an arrow key moves the thumb. */
|
|
28835
29097
|
step?: (HelixSlider["step"]) | undefined;
|
|
29098
|
+
/** The name of a thumb between a range's first and last, read after the
|
|
29099
|
+
slider's label, with `{index}` filled in: its place, counted from 1. The
|
|
29100
|
+
first is `minimum-label` and the last `maximum-label`. */
|
|
29101
|
+
"thumb-label"?: (HelixSlider["thumbLabel"]) | undefined;
|
|
29102
|
+
/** The name of a thumb between a range's first and last, read after the
|
|
29103
|
+
slider's label, with `{index}` filled in: its place, counted from 1. The
|
|
29104
|
+
first is `minimum-label` and the last `maximum-label`. */
|
|
29105
|
+
thumbLabel?: (HelixSlider["thumbLabel"]) | undefined;
|
|
28836
29106
|
/** Whether each thumb shows its value in a bubble beside it, as Web
|
|
28837
29107
|
Awesome's `with-tooltip`. The styled slider shows the bubbles while the
|
|
28838
29108
|
slider is under the pointer or holds focus. They repeat what each thumb
|
|
@@ -29021,9 +29291,11 @@ between its thumbs and ignores it. */
|
|
|
29021
29291
|
"prop:origin"?: (HelixSlider["origin"]) | undefined;
|
|
29022
29292
|
/** Adds a second thumb, so the value is a pair.
|
|
29023
29293
|
|
|
29024
|
-
The pair is one string, `"10,50"`, which is what
|
|
29025
|
-
`MixinControllerValue`
|
|
29026
|
-
|
|
29294
|
+
The pair is one string, `"10,50"`, which is what `value` and
|
|
29295
|
+
`MixinControllerValue` hold. A form receives two entries under the name,
|
|
29296
|
+
`price=10&price=50`, as React Aria's two thumbs send theirs.
|
|
29297
|
+
`valueAsNumber` reads the lower of the two, since a range has no single
|
|
29298
|
+
number. */
|
|
29027
29299
|
"prop:range"?: (HelixSlider["range"]) | undefined;
|
|
29028
29300
|
/** How the readout joins a range's two values, with `{start}` and `{end}`
|
|
29029
29301
|
filled in. Write it in the page's language, such as `{start} bis {end}`. */
|
|
@@ -29031,12 +29303,34 @@ filled in. Write it in the page's language, such as `{start} bis {end}`. */
|
|
|
29031
29303
|
/** How the readout joins a range's two values, with `{start}` and `{end}`
|
|
29032
29304
|
filled in. Write it in the page's language, such as `{start} bis {end}`. */
|
|
29033
29305
|
"prop:rangeText"?: (HelixSlider["rangeText"]) | undefined;
|
|
29306
|
+
/** Whether a reader can see and focus the value and cannot change it. A
|
|
29307
|
+
read-only slider still submits its value.
|
|
29308
|
+
|
|
29309
|
+
React Aria's `isReadOnly`. Each thumb stays a tab stop and says
|
|
29310
|
+
`aria-readonly`. The arrow keys, the page keys, Home, End, and a drag
|
|
29311
|
+
leave the value where it is. A script can still set `value`. */
|
|
29312
|
+
"bool:readonly"?: (HelixSlider["readOnly"]) | undefined;
|
|
29313
|
+
/** Whether a reader can see and focus the value and cannot change it. A
|
|
29314
|
+
read-only slider still submits its value.
|
|
29315
|
+
|
|
29316
|
+
React Aria's `isReadOnly`. Each thumb stays a tab stop and says
|
|
29317
|
+
`aria-readonly`. The arrow keys, the page keys, Home, End, and a drag
|
|
29318
|
+
leave the value where it is. A script can still set `value`. */
|
|
29319
|
+
"prop:readOnly"?: (HelixSlider["readOnly"]) | undefined;
|
|
29034
29320
|
/** Shows the chosen value beside the track. */
|
|
29035
29321
|
"bool:show-value"?: (HelixSlider["showValue"]) | undefined;
|
|
29036
29322
|
/** Shows the chosen value beside the track. */
|
|
29037
29323
|
"prop:showValue"?: (HelixSlider["showValue"]) | undefined;
|
|
29038
29324
|
/** How far one press of an arrow key moves the thumb. */
|
|
29039
29325
|
"prop:step"?: (HelixSlider["step"]) | undefined;
|
|
29326
|
+
/** The name of a thumb between a range's first and last, read after the
|
|
29327
|
+
slider's label, with `{index}` filled in: its place, counted from 1. The
|
|
29328
|
+
first is `minimum-label` and the last `maximum-label`. */
|
|
29329
|
+
"attr:thumb-label"?: (HelixSlider["thumbLabel"]) | undefined;
|
|
29330
|
+
/** The name of a thumb between a range's first and last, read after the
|
|
29331
|
+
slider's label, with `{index}` filled in: its place, counted from 1. The
|
|
29332
|
+
first is `minimum-label` and the last `maximum-label`. */
|
|
29333
|
+
"prop:thumbLabel"?: (HelixSlider["thumbLabel"]) | undefined;
|
|
29040
29334
|
/** Whether each thumb shows its value in a bubble beside it, as Web
|
|
29041
29335
|
Awesome's `with-tooltip`. The styled slider shows the bubbles while the
|
|
29042
29336
|
slider is under the pointer or holds focus. They repeat what each thumb
|
|
@@ -29495,10 +29789,20 @@ export type HelixSpeedDialItemHelixSelectElementEvent =
|
|
|
29495
29789
|
export type HelixSpeedDialItemProps = {
|
|
29496
29790
|
/** Whether the action is disabled, so it cannot be chosen. */
|
|
29497
29791
|
disabled?: (HelixSpeedDialItem["disabled"]) | undefined;
|
|
29792
|
+
/** Whether the link downloads the file when the action is chosen. Only
|
|
29793
|
+
meaningful beside an `href`, and only for a file served from the page's
|
|
29794
|
+
origin. */
|
|
29795
|
+
download?: (HelixSpeedDialItem["download"]) | undefined;
|
|
29796
|
+
/** The URL the action links to. Setting it draws the action as a link. */
|
|
29797
|
+
href?: (HelixSpeedDialItem["href"]) | undefined;
|
|
29798
|
+
/** The link's `rel`. Set it whenever you set `target="_blank"`. */
|
|
29799
|
+
rel?: (HelixSpeedDialItem["rel"]) | undefined;
|
|
29498
29800
|
/** The action's keyboard shortcut as a chord, such as `mod+s`, carried as
|
|
29499
29801
|
`aria-keyshortcuts` and drawn after the name. `mod` is Command on an Apple
|
|
29500
29802
|
keyboard and Control elsewhere. Showing a shortcut does not bind it. */
|
|
29501
29803
|
shortcut?: (HelixSpeedDialItem["shortcut"]) | undefined;
|
|
29804
|
+
/** Where the link opens, such as `_blank` for a new tab. */
|
|
29805
|
+
target?: (HelixSpeedDialItem["target"]) | undefined;
|
|
29502
29806
|
/** The action's value, sent in `helix-select` when the action is chosen. */
|
|
29503
29807
|
value?: (HelixSpeedDialItem["value"]) | undefined;
|
|
29504
29808
|
|
|
@@ -29509,10 +29813,20 @@ keyboard and Control elsewhere. Showing a shortcut does not bind it. */
|
|
|
29509
29813
|
export type HelixSpeedDialItemSolidJsProps = {
|
|
29510
29814
|
/** Whether the action is disabled, so it cannot be chosen. */
|
|
29511
29815
|
"prop:disabled"?: (HelixSpeedDialItem["disabled"]) | undefined;
|
|
29816
|
+
/** Whether the link downloads the file when the action is chosen. Only
|
|
29817
|
+
meaningful beside an `href`, and only for a file served from the page's
|
|
29818
|
+
origin. */
|
|
29819
|
+
"prop:download"?: (HelixSpeedDialItem["download"]) | undefined;
|
|
29820
|
+
/** The URL the action links to. Setting it draws the action as a link. */
|
|
29821
|
+
"prop:href"?: (HelixSpeedDialItem["href"]) | undefined;
|
|
29822
|
+
/** The link's `rel`. Set it whenever you set `target="_blank"`. */
|
|
29823
|
+
"prop:rel"?: (HelixSpeedDialItem["rel"]) | undefined;
|
|
29512
29824
|
/** The action's keyboard shortcut as a chord, such as `mod+s`, carried as
|
|
29513
29825
|
`aria-keyshortcuts` and drawn after the name. `mod` is Command on an Apple
|
|
29514
29826
|
keyboard and Control elsewhere. Showing a shortcut does not bind it. */
|
|
29515
29827
|
"prop:shortcut"?: (HelixSpeedDialItem["shortcut"]) | undefined;
|
|
29828
|
+
/** Where the link opens, such as `_blank` for a new tab. */
|
|
29829
|
+
"prop:target"?: (HelixSpeedDialItem["target"]) | undefined;
|
|
29516
29830
|
/** The action's value, sent in `helix-select` when the action is chosen. */
|
|
29517
29831
|
"prop:value"?: (HelixSpeedDialItem["value"]) | undefined;
|
|
29518
29832
|
/** The action was chosen. Cancelable: cancel it to keep the dial open. */
|
|
@@ -29585,13 +29899,17 @@ you described or labeled it yourself. */
|
|
|
29585
29899
|
longPressLabel?: (HelixSpeedDial["longPressLabel"]) | undefined;
|
|
29586
29900
|
/** Space between the trigger and the actions, in pixels. */
|
|
29587
29901
|
offset?: (HelixSpeedDial["offset"]) | undefined;
|
|
29588
|
-
/** What opens the dial. `click` opens it on a press of the trigger.
|
|
29589
|
-
|
|
29590
|
-
|
|
29902
|
+
/** What opens the dial. `click` opens it on a press of the trigger. `hover`
|
|
29903
|
+
also opens it while a mouse rests on the trigger, and closes it once the
|
|
29904
|
+
mouse has left. Under `long-press`, a press is the trigger's own action,
|
|
29905
|
+
and the dial opens on a press held for half a second, or on Alt+Down or
|
|
29906
|
+
Alt+Up. */
|
|
29591
29907
|
"open-on"?: (HelixSpeedDial["openOn"]) | undefined;
|
|
29592
|
-
/** What opens the dial. `click` opens it on a press of the trigger.
|
|
29593
|
-
|
|
29594
|
-
|
|
29908
|
+
/** What opens the dial. `click` opens it on a press of the trigger. `hover`
|
|
29909
|
+
also opens it while a mouse rests on the trigger, and closes it once the
|
|
29910
|
+
mouse has left. Under `long-press`, a press is the trigger's own action,
|
|
29911
|
+
and the dial opens on a press held for half a second, or on Alt+Down or
|
|
29912
|
+
Alt+Up. */
|
|
29595
29913
|
openOn?: (HelixSpeedDial["openOn"]) | undefined;
|
|
29596
29914
|
/** The direction the actions open in. They move to another side if that side
|
|
29597
29915
|
does not fit.
|
|
@@ -29657,13 +29975,17 @@ you described or labeled it yourself. */
|
|
|
29657
29975
|
"prop:longPressLabel"?: (HelixSpeedDial["longPressLabel"]) | undefined;
|
|
29658
29976
|
/** Space between the trigger and the actions, in pixels. */
|
|
29659
29977
|
"prop:offset"?: (HelixSpeedDial["offset"]) | undefined;
|
|
29660
|
-
/** What opens the dial. `click` opens it on a press of the trigger.
|
|
29661
|
-
|
|
29662
|
-
|
|
29978
|
+
/** What opens the dial. `click` opens it on a press of the trigger. `hover`
|
|
29979
|
+
also opens it while a mouse rests on the trigger, and closes it once the
|
|
29980
|
+
mouse has left. Under `long-press`, a press is the trigger's own action,
|
|
29981
|
+
and the dial opens on a press held for half a second, or on Alt+Down or
|
|
29982
|
+
Alt+Up. */
|
|
29663
29983
|
"attr:open-on"?: (HelixSpeedDial["openOn"]) | undefined;
|
|
29664
|
-
/** What opens the dial. `click` opens it on a press of the trigger.
|
|
29665
|
-
|
|
29666
|
-
|
|
29984
|
+
/** What opens the dial. `click` opens it on a press of the trigger. `hover`
|
|
29985
|
+
also opens it while a mouse rests on the trigger, and closes it once the
|
|
29986
|
+
mouse has left. Under `long-press`, a press is the trigger's own action,
|
|
29987
|
+
and the dial opens on a press held for half a second, or on Alt+Down or
|
|
29988
|
+
Alt+Up. */
|
|
29667
29989
|
"prop:openOn"?: (HelixSpeedDial["openOn"]) | undefined;
|
|
29668
29990
|
/** The direction the actions open in. They move to another side if that side
|
|
29669
29991
|
does not fit.
|
|
@@ -30031,7 +30353,10 @@ figures compared one against another keep their own widths. */
|
|
|
30031
30353
|
columns?: (HelixStatGroup["columns"]) | undefined;
|
|
30032
30354
|
/** Draws a rule between the figures, in addition to the space. */
|
|
30033
30355
|
divided?: (HelixStatGroup["divided"]) | undefined;
|
|
30034
|
-
/** Accessible name for the group.
|
|
30356
|
+
/** Accessible name for the group, which makes it a group.
|
|
30357
|
+
|
|
30358
|
+
Absent leaves the stats with no group around them, unless `aria-label` or
|
|
30359
|
+
`aria-labelledby` names it. */
|
|
30035
30360
|
label?: (HelixStatGroup["label"]) | undefined;
|
|
30036
30361
|
};
|
|
30037
30362
|
|
|
@@ -30045,7 +30370,10 @@ figures compared one against another keep their own widths. */
|
|
|
30045
30370
|
"prop:columns"?: (HelixStatGroup["columns"]) | undefined;
|
|
30046
30371
|
/** Draws a rule between the figures, in addition to the space. */
|
|
30047
30372
|
"prop:divided"?: (HelixStatGroup["divided"]) | undefined;
|
|
30048
|
-
/** Accessible name for the group.
|
|
30373
|
+
/** Accessible name for the group, which makes it a group.
|
|
30374
|
+
|
|
30375
|
+
Absent leaves the stats with no group around them, unless `aria-label` or
|
|
30376
|
+
`aria-labelledby` names it. */
|
|
30049
30377
|
"prop:label"?: (HelixStatGroup["label"]) | undefined;
|
|
30050
30378
|
|
|
30051
30379
|
/** Set the innerHTML of the element */
|
|
@@ -30081,6 +30409,29 @@ reports a hydration mismatch. The absent attribute is the column, which the
|
|
|
30081
30409
|
stylesheet reads as the base case, and the server spec asserts the host
|
|
30082
30410
|
carries nothing nobody wrote. */
|
|
30083
30411
|
direction?: (HelixStat["direction"]) | undefined;
|
|
30412
|
+
/** `Intl.NumberFormat` options `value` is written with, such as
|
|
30413
|
+
`{"notation":"compact"}` for `1.2M` or `{"style":"percent"}` for `98%`,
|
|
30414
|
+
written as JSON in the attribute.
|
|
30415
|
+
|
|
30416
|
+
Absent writes the number as the locale writes any number. */
|
|
30417
|
+
"format-options"?: (HelixStat["formatOptions"]) | undefined;
|
|
30418
|
+
/** `Intl.NumberFormat` options `value` is written with, such as
|
|
30419
|
+
`{"notation":"compact"}` for `1.2M` or `{"style":"percent"}` for `98%`,
|
|
30420
|
+
written as JSON in the attribute.
|
|
30421
|
+
|
|
30422
|
+
Absent writes the number as the locale writes any number. */
|
|
30423
|
+
formatOptions?: (HelixStat["formatOptions"]) | undefined;
|
|
30424
|
+
/** The locale `value` is written in, such as `de` for `1.234.567`.
|
|
30425
|
+
|
|
30426
|
+
Absent reads the nearest `lang`, then the runtime's own. Set it on a page
|
|
30427
|
+
rendered on a server, so the server and the browser write the figure
|
|
30428
|
+
alike. */
|
|
30429
|
+
locale?: (HelixStat["locale"]) | undefined;
|
|
30430
|
+
/** The figure as a number, written with `format-options` in `locale` in
|
|
30431
|
+
place of a slotted value.
|
|
30432
|
+
|
|
30433
|
+
Absent leaves the figure to the slot. */
|
|
30434
|
+
value?: (HelixStat["value"]) | undefined;
|
|
30084
30435
|
};
|
|
30085
30436
|
|
|
30086
30437
|
export type HelixStatSolidJsProps = {
|
|
@@ -30110,6 +30461,29 @@ reports a hydration mismatch. The absent attribute is the column, which the
|
|
|
30110
30461
|
stylesheet reads as the base case, and the server spec asserts the host
|
|
30111
30462
|
carries nothing nobody wrote. */
|
|
30112
30463
|
"prop:direction"?: (HelixStat["direction"]) | undefined;
|
|
30464
|
+
/** `Intl.NumberFormat` options `value` is written with, such as
|
|
30465
|
+
`{"notation":"compact"}` for `1.2M` or `{"style":"percent"}` for `98%`,
|
|
30466
|
+
written as JSON in the attribute.
|
|
30467
|
+
|
|
30468
|
+
Absent writes the number as the locale writes any number. */
|
|
30469
|
+
"attr:format-options"?: (HelixStat["formatOptions"]) | undefined;
|
|
30470
|
+
/** `Intl.NumberFormat` options `value` is written with, such as
|
|
30471
|
+
`{"notation":"compact"}` for `1.2M` or `{"style":"percent"}` for `98%`,
|
|
30472
|
+
written as JSON in the attribute.
|
|
30473
|
+
|
|
30474
|
+
Absent writes the number as the locale writes any number. */
|
|
30475
|
+
"prop:formatOptions"?: (HelixStat["formatOptions"]) | undefined;
|
|
30476
|
+
/** The locale `value` is written in, such as `de` for `1.234.567`.
|
|
30477
|
+
|
|
30478
|
+
Absent reads the nearest `lang`, then the runtime's own. Set it on a page
|
|
30479
|
+
rendered on a server, so the server and the browser write the figure
|
|
30480
|
+
alike. */
|
|
30481
|
+
"prop:locale"?: (HelixStat["locale"]) | undefined;
|
|
30482
|
+
/** The figure as a number, written with `format-options` in `locale` in
|
|
30483
|
+
place of a slotted value.
|
|
30484
|
+
|
|
30485
|
+
Absent leaves the figure to the slot. */
|
|
30486
|
+
"prop:value"?: (HelixStat["value"]) | undefined;
|
|
30113
30487
|
|
|
30114
30488
|
/** Set the innerHTML of the element */
|
|
30115
30489
|
innerHTML?: (string) | undefined;
|
|
@@ -30147,6 +30521,16 @@ Ignored once `active` is written. */
|
|
|
30147
30521
|
|
|
30148
30522
|
Ignored once `active` is written. */
|
|
30149
30523
|
defaultActive?: (HelixSteps["defaultActive"]) | undefined;
|
|
30524
|
+
/** Whether the arrow keys move focus between the stages' names, along the
|
|
30525
|
+
way the steps run. Off by default, so the arrows keep scrolling the page. */
|
|
30526
|
+
arrows?: (HelixSteps["arrows"]) | undefined;
|
|
30527
|
+
/** What marks a stage `complete`.
|
|
30528
|
+
|
|
30529
|
+
Absent, you do: each step's `complete` is yours, because a reader who
|
|
30530
|
+
steps back has finished more stages than the one they are on. `passed`
|
|
30531
|
+
marks every stage before the one a reader moves to, and leaves the marks
|
|
30532
|
+
when they go back. */
|
|
30533
|
+
completion?: (HelixSteps["completion"]) | undefined;
|
|
30150
30534
|
/** The sequence's name, read by screen readers.
|
|
30151
30535
|
|
|
30152
30536
|
A list of stages is a landmark a reader arrives at out of order, so it
|
|
@@ -30221,6 +30605,16 @@ Ignored once `active` is written. */
|
|
|
30221
30605
|
|
|
30222
30606
|
Ignored once `active` is written. */
|
|
30223
30607
|
"prop:defaultActive"?: (HelixSteps["defaultActive"]) | undefined;
|
|
30608
|
+
/** Whether the arrow keys move focus between the stages' names, along the
|
|
30609
|
+
way the steps run. Off by default, so the arrows keep scrolling the page. */
|
|
30610
|
+
"prop:arrows"?: (HelixSteps["arrows"]) | undefined;
|
|
30611
|
+
/** What marks a stage `complete`.
|
|
30612
|
+
|
|
30613
|
+
Absent, you do: each step's `complete` is yours, because a reader who
|
|
30614
|
+
steps back has finished more stages than the one they are on. `passed`
|
|
30615
|
+
marks every stage before the one a reader moves to, and leaves the marks
|
|
30616
|
+
when they go back. */
|
|
30617
|
+
"prop:completion"?: (HelixSteps["completion"]) | undefined;
|
|
30224
30618
|
/** The sequence's name, read by screen readers.
|
|
30225
30619
|
|
|
30226
30620
|
A list of stages is a landmark a reader arrives at out of order, so it
|
|
@@ -31542,6 +31936,12 @@ panels and tells a screen reader the list is vertical.
|
|
|
31542
31936
|
|
|
31543
31937
|
Optional, so the resting row writes no attribute onto the host. */
|
|
31544
31938
|
orientation?: (HelixTabs["orientation"]) | undefined;
|
|
31939
|
+
/** Whether a strip with more tabs than fit shows a button at each end it can
|
|
31940
|
+
scroll toward. */
|
|
31941
|
+
"scroll-controls"?: (HelixTabs["scrollControls"]) | undefined;
|
|
31942
|
+
/** Whether a strip with more tabs than fit shows a button at each end it can
|
|
31943
|
+
scroll toward. */
|
|
31944
|
+
scrollControls?: (HelixTabs["scrollControls"]) | undefined;
|
|
31545
31945
|
/** How the row of tabs is drawn.
|
|
31546
31946
|
|
|
31547
31947
|
Unset is a raised pill on the selected tab with nothing behind the row,
|
|
@@ -31611,6 +32011,12 @@ panels and tells a screen reader the list is vertical.
|
|
|
31611
32011
|
|
|
31612
32012
|
Optional, so the resting row writes no attribute onto the host. */
|
|
31613
32013
|
"prop:orientation"?: (HelixTabs["orientation"]) | undefined;
|
|
32014
|
+
/** Whether a strip with more tabs than fit shows a button at each end it can
|
|
32015
|
+
scroll toward. */
|
|
32016
|
+
"bool:scroll-controls"?: (HelixTabs["scrollControls"]) | undefined;
|
|
32017
|
+
/** Whether a strip with more tabs than fit shows a button at each end it can
|
|
32018
|
+
scroll toward. */
|
|
32019
|
+
"prop:scrollControls"?: (HelixTabs["scrollControls"]) | undefined;
|
|
31614
32020
|
/** How the row of tabs is drawn.
|
|
31615
32021
|
|
|
31616
32022
|
Unset is a raised pill on the selected tab with nothing behind the row,
|
|
@@ -31651,11 +32057,38 @@ consumer's server markup does not already have. */
|
|
|
31651
32057
|
|
|
31652
32058
|
/** `HelixTab` component event */
|
|
31653
32059
|
export type HelixTabElementEvent<E = Event> = TypedEvent<HelixTab, E>;
|
|
32060
|
+
/** `helix-dismiss` event type */
|
|
32061
|
+
export type HelixTabHelixDismissElementEvent =
|
|
32062
|
+
HelixTabElementEvent<HelixDismissEvent>;
|
|
31654
32063
|
/** `helix-select` event type */
|
|
31655
32064
|
export type HelixTabHelixSelectElementEvent =
|
|
31656
32065
|
HelixTabElementEvent<HelixSelectEvent>;
|
|
31657
32066
|
|
|
31658
32067
|
export type HelixTabProps = {
|
|
32068
|
+
/** Whether the element shows a control that dismisses it. */
|
|
32069
|
+
dismissible?: (HelixTab["dismissible"]) | undefined;
|
|
32070
|
+
/** The dismiss control's label, read by screen readers.
|
|
32071
|
+
|
|
32072
|
+
`attribute` is spelled out because Lit lowercases a property name to
|
|
32073
|
+
derive one rather than dash-casing it, so this would otherwise be
|
|
32074
|
+
reachable only as `dismisslabel`, which nobody would guess and no linter
|
|
32075
|
+
would catch.
|
|
32076
|
+
|
|
32077
|
+
A word property: register it for a locale under the host's key. A family
|
|
32078
|
+
that names the control otherwise, such as Tag's `Remove {label}`,
|
|
32079
|
+
declares its own English with `@words` above the override. */
|
|
32080
|
+
"dismiss-label"?: (HelixTab["dismissLabel"]) | undefined;
|
|
32081
|
+
/** The dismiss control's label, read by screen readers.
|
|
32082
|
+
|
|
32083
|
+
`attribute` is spelled out because Lit lowercases a property name to
|
|
32084
|
+
derive one rather than dash-casing it, so this would otherwise be
|
|
32085
|
+
reachable only as `dismisslabel`, which nobody would guess and no linter
|
|
32086
|
+
would catch.
|
|
32087
|
+
|
|
32088
|
+
A word property: register it for a locale under the host's key. A family
|
|
32089
|
+
that names the control otherwise, such as Tag's `Remove {label}`,
|
|
32090
|
+
declares its own English with `@words` above the override. */
|
|
32091
|
+
dismissLabel?: (HelixTab["dismissLabel"]) | undefined;
|
|
31659
32092
|
/** Whether the item is disabled and cannot be chosen. */
|
|
31660
32093
|
disabled?: (HelixTab["disabled"]) | undefined;
|
|
31661
32094
|
/** Whether the item is selected.
|
|
@@ -31675,11 +32108,37 @@ of tabs that are pages of a site. */
|
|
|
31675
32108
|
/** Where the link opens, such as `_blank`, for a tab with an `href`. */
|
|
31676
32109
|
target?: (HelixTab["target"]) | undefined;
|
|
31677
32110
|
|
|
32111
|
+
/** A `dismissible` tab was asked to close. The tab does not remove itself, so remove it and its panel in response. Cancelable. */
|
|
32112
|
+
"onhelix-dismiss"?: ((e: HelixTabHelixDismissElementEvent) => void) | undefined;
|
|
31678
32113
|
/** Fired when the tab is chosen. Cancelable: canceling it stops the change and leaves the decision to you. */
|
|
31679
32114
|
"onhelix-select"?: ((e: HelixTabHelixSelectElementEvent) => void) | undefined;
|
|
31680
32115
|
};
|
|
31681
32116
|
|
|
31682
32117
|
export type HelixTabSolidJsProps = {
|
|
32118
|
+
/** Whether the element shows a control that dismisses it. */
|
|
32119
|
+
"prop:dismissible"?: (HelixTab["dismissible"]) | undefined;
|
|
32120
|
+
/** The dismiss control's label, read by screen readers.
|
|
32121
|
+
|
|
32122
|
+
`attribute` is spelled out because Lit lowercases a property name to
|
|
32123
|
+
derive one rather than dash-casing it, so this would otherwise be
|
|
32124
|
+
reachable only as `dismisslabel`, which nobody would guess and no linter
|
|
32125
|
+
would catch.
|
|
32126
|
+
|
|
32127
|
+
A word property: register it for a locale under the host's key. A family
|
|
32128
|
+
that names the control otherwise, such as Tag's `Remove {label}`,
|
|
32129
|
+
declares its own English with `@words` above the override. */
|
|
32130
|
+
"attr:dismiss-label"?: (HelixTab["dismissLabel"]) | undefined;
|
|
32131
|
+
/** The dismiss control's label, read by screen readers.
|
|
32132
|
+
|
|
32133
|
+
`attribute` is spelled out because Lit lowercases a property name to
|
|
32134
|
+
derive one rather than dash-casing it, so this would otherwise be
|
|
32135
|
+
reachable only as `dismisslabel`, which nobody would guess and no linter
|
|
32136
|
+
would catch.
|
|
32137
|
+
|
|
32138
|
+
A word property: register it for a locale under the host's key. A family
|
|
32139
|
+
that names the control otherwise, such as Tag's `Remove {label}`,
|
|
32140
|
+
declares its own English with `@words` above the override. */
|
|
32141
|
+
"prop:dismissLabel"?: (HelixTab["dismissLabel"]) | undefined;
|
|
31683
32142
|
/** Whether the item is disabled and cannot be chosen. */
|
|
31684
32143
|
"prop:disabled"?: (HelixTab["disabled"]) | undefined;
|
|
31685
32144
|
/** Whether the item is selected.
|
|
@@ -31698,6 +32157,8 @@ of tabs that are pages of a site. */
|
|
|
31698
32157
|
"prop:rel"?: (HelixTab["rel"]) | undefined;
|
|
31699
32158
|
/** Where the link opens, such as `_blank`, for a tab with an `href`. */
|
|
31700
32159
|
"prop:target"?: (HelixTab["target"]) | undefined;
|
|
32160
|
+
/** A `dismissible` tab was asked to close. The tab does not remove itself, so remove it and its panel in response. Cancelable. */
|
|
32161
|
+
"on:helix-dismiss"?: ((e: HelixTabHelixDismissElementEvent) => void) | undefined;
|
|
31701
32162
|
/** Fired when the tab is chosen. Cancelable: canceling it stops the change and leaves the decision to you. */
|
|
31702
32163
|
"on:helix-select"?: ((e: HelixTabHelixSelectElementEvent) => void) | undefined;
|
|
31703
32164
|
|
|
@@ -31717,6 +32178,14 @@ export type HelixTagGroupHelixDismissElementEvent =
|
|
|
31717
32178
|
HelixTagGroupElementEvent<HelixDismissEvent>;
|
|
31718
32179
|
|
|
31719
32180
|
export type HelixTagGroupProps = {
|
|
32181
|
+
/** Keeps at least one tag selected once one is, as React Aria's
|
|
32182
|
+
`disallowEmptySelection`: a press or a key that would leave none selected
|
|
32183
|
+
is refused. Removing the last selected tag still takes it out of `value`. */
|
|
32184
|
+
"disallow-empty-selection"?: (HelixTagGroup["disallowEmptySelection"]) | undefined;
|
|
32185
|
+
/** Keeps at least one tag selected once one is, as React Aria's
|
|
32186
|
+
`disallowEmptySelection`: a press or a key that would leave none selected
|
|
32187
|
+
is refused. Removing the last selected tag still takes it out of `value`. */
|
|
32188
|
+
disallowEmptySelection?: (HelixTagGroup["disallowEmptySelection"]) | undefined;
|
|
31720
32189
|
/** The words the group shows and says once its last tag is removed, where
|
|
31721
32190
|
nothing is in the `empty` slot. */
|
|
31722
32191
|
"empty-label"?: (HelixTagGroup["emptyLabel"]) | undefined;
|
|
@@ -31726,6 +32195,20 @@ nothing is in the `empty` slot. */
|
|
|
31726
32195
|
/** The name of the set, such as "Filters", which a screen reader announces
|
|
31727
32196
|
before its tags. */
|
|
31728
32197
|
label?: (HelixTagGroup["label"]) | undefined;
|
|
32198
|
+
/** What a press, Space, or a move does to the tags already selected.
|
|
32199
|
+
`toggle`, the default, keeps them: a press adds or takes out the tag, and
|
|
32200
|
+
the arrow keys move focus alone. `replace` selects the tag alone, as a
|
|
32201
|
+
file list does, and the arrow keys carry the selection with focus.
|
|
32202
|
+
Control or Command with a press or Space adds or takes out one tag in
|
|
32203
|
+
`multiple`, and with an arrow moves focus without selecting. */
|
|
32204
|
+
"selection-behavior"?: (HelixTagGroup["selectionBehavior"]) | undefined;
|
|
32205
|
+
/** What a press, Space, or a move does to the tags already selected.
|
|
32206
|
+
`toggle`, the default, keeps them: a press adds or takes out the tag, and
|
|
32207
|
+
the arrow keys move focus alone. `replace` selects the tag alone, as a
|
|
32208
|
+
file list does, and the arrow keys carry the selection with focus.
|
|
32209
|
+
Control or Command with a press or Space adds or takes out one tag in
|
|
32210
|
+
`multiple`, and with an arrow moves focus without selecting. */
|
|
32211
|
+
selectionBehavior?: (HelixTagGroup["selectionBehavior"]) | undefined;
|
|
31729
32212
|
/** How many tags a reader can select: `single`, `multiple`, or none.
|
|
31730
32213
|
|
|
31731
32214
|
Absent selects nothing, and the tags carry no selected state at all. */
|
|
@@ -31752,6 +32235,14 @@ words where it has none. */
|
|
|
31752
32235
|
};
|
|
31753
32236
|
|
|
31754
32237
|
export type HelixTagGroupSolidJsProps = {
|
|
32238
|
+
/** Keeps at least one tag selected once one is, as React Aria's
|
|
32239
|
+
`disallowEmptySelection`: a press or a key that would leave none selected
|
|
32240
|
+
is refused. Removing the last selected tag still takes it out of `value`. */
|
|
32241
|
+
"bool:disallow-empty-selection"?: (HelixTagGroup["disallowEmptySelection"]) | undefined;
|
|
32242
|
+
/** Keeps at least one tag selected once one is, as React Aria's
|
|
32243
|
+
`disallowEmptySelection`: a press or a key that would leave none selected
|
|
32244
|
+
is refused. Removing the last selected tag still takes it out of `value`. */
|
|
32245
|
+
"prop:disallowEmptySelection"?: (HelixTagGroup["disallowEmptySelection"]) | undefined;
|
|
31755
32246
|
/** The words the group shows and says once its last tag is removed, where
|
|
31756
32247
|
nothing is in the `empty` slot. */
|
|
31757
32248
|
"attr:empty-label"?: (HelixTagGroup["emptyLabel"]) | undefined;
|
|
@@ -31761,6 +32252,20 @@ nothing is in the `empty` slot. */
|
|
|
31761
32252
|
/** The name of the set, such as "Filters", which a screen reader announces
|
|
31762
32253
|
before its tags. */
|
|
31763
32254
|
"prop:label"?: (HelixTagGroup["label"]) | undefined;
|
|
32255
|
+
/** What a press, Space, or a move does to the tags already selected.
|
|
32256
|
+
`toggle`, the default, keeps them: a press adds or takes out the tag, and
|
|
32257
|
+
the arrow keys move focus alone. `replace` selects the tag alone, as a
|
|
32258
|
+
file list does, and the arrow keys carry the selection with focus.
|
|
32259
|
+
Control or Command with a press or Space adds or takes out one tag in
|
|
32260
|
+
`multiple`, and with an arrow moves focus without selecting. */
|
|
32261
|
+
"attr:selection-behavior"?: (HelixTagGroup["selectionBehavior"]) | undefined;
|
|
32262
|
+
/** What a press, Space, or a move does to the tags already selected.
|
|
32263
|
+
`toggle`, the default, keeps them: a press adds or takes out the tag, and
|
|
32264
|
+
the arrow keys move focus alone. `replace` selects the tag alone, as a
|
|
32265
|
+
file list does, and the arrow keys carry the selection with focus.
|
|
32266
|
+
Control or Command with a press or Space adds or takes out one tag in
|
|
32267
|
+
`multiple`, and with an arrow moves focus without selecting. */
|
|
32268
|
+
"prop:selectionBehavior"?: (HelixTagGroup["selectionBehavior"]) | undefined;
|
|
31764
32269
|
/** How many tags a reader can select: `single`, `multiple`, or none.
|
|
31765
32270
|
|
|
31766
32271
|
Absent selects nothing, and the tags carry no selected state at all. */
|
|
@@ -35643,6 +36148,18 @@ refused, in a `reorderable` tree. */
|
|
|
35643
36148
|
An `aria-label` or `aria-labelledby` on the host names the tree too, and
|
|
35644
36149
|
wins over this. */
|
|
35645
36150
|
label?: (HelixTree["label"]) | undefined;
|
|
36151
|
+
/** What screen readers hear when an item moves into another branch, in a
|
|
36152
|
+
`reorderable` tree. `{name}` is the item's words, `{parent}` the words of
|
|
36153
|
+
the branch it moved into, or the tree's `label` for the top level,
|
|
36154
|
+
`{position}` its place there, counting from 1, and `{count}` the number of
|
|
36155
|
+
items there. */
|
|
36156
|
+
"moved-into-label"?: (HelixTree["movedIntoLabel"]) | undefined;
|
|
36157
|
+
/** What screen readers hear when an item moves into another branch, in a
|
|
36158
|
+
`reorderable` tree. `{name}` is the item's words, `{parent}` the words of
|
|
36159
|
+
the branch it moved into, or the tree's `label` for the top level,
|
|
36160
|
+
`{position}` its place there, counting from 1, and `{count}` the number of
|
|
36161
|
+
items there. */
|
|
36162
|
+
movedIntoLabel?: (HelixTree["movedIntoLabel"]) | undefined;
|
|
35646
36163
|
/** What screen readers hear each time an item moves, in a `reorderable`
|
|
35647
36164
|
tree. `{name}` is the item's words, `{position}` its place among its
|
|
35648
36165
|
siblings, counting from 1, and `{count}` the number of siblings. */
|
|
@@ -35817,6 +36334,18 @@ refused, in a `reorderable` tree. */
|
|
|
35817
36334
|
An `aria-label` or `aria-labelledby` on the host names the tree too, and
|
|
35818
36335
|
wins over this. */
|
|
35819
36336
|
"prop:label"?: (HelixTree["label"]) | undefined;
|
|
36337
|
+
/** What screen readers hear when an item moves into another branch, in a
|
|
36338
|
+
`reorderable` tree. `{name}` is the item's words, `{parent}` the words of
|
|
36339
|
+
the branch it moved into, or the tree's `label` for the top level,
|
|
36340
|
+
`{position}` its place there, counting from 1, and `{count}` the number of
|
|
36341
|
+
items there. */
|
|
36342
|
+
"attr:moved-into-label"?: (HelixTree["movedIntoLabel"]) | undefined;
|
|
36343
|
+
/** What screen readers hear when an item moves into another branch, in a
|
|
36344
|
+
`reorderable` tree. `{name}` is the item's words, `{parent}` the words of
|
|
36345
|
+
the branch it moved into, or the tree's `label` for the top level,
|
|
36346
|
+
`{position}` its place there, counting from 1, and `{count}` the number of
|
|
36347
|
+
items there. */
|
|
36348
|
+
"prop:movedIntoLabel"?: (HelixTree["movedIntoLabel"]) | undefined;
|
|
35820
36349
|
/** What screen readers hear each time an item moves, in a `reorderable`
|
|
35821
36350
|
tree. `{name}` is the item's words, `{position}` its place among its
|
|
35822
36351
|
siblings, counting from 1, and `{count}` the number of siblings. */
|
|
@@ -37645,6 +38174,7 @@ export type CustomElements = {
|
|
|
37645
38174
|
*
|
|
37646
38175
|
* These can be used to apply styling when a component is in a given state.
|
|
37647
38176
|
*
|
|
38177
|
+
* - `closing`: While the item has closed and its content is still drawn, until the content part's animations end.
|
|
37648
38178
|
* - `open`: While the item is open.
|
|
37649
38179
|
* - `settled`: Set one frame after the first render. Transitions wait for it, so an element does not animate its own arrival.
|
|
37650
38180
|
*/
|
|
@@ -38869,6 +39399,7 @@ export type CustomElements = {
|
|
|
38869
39399
|
* Areas where markup can be added to the component.
|
|
38870
39400
|
*
|
|
38871
39401
|
* - `(default)`: The element being decorated.
|
|
39402
|
+
* - `icon`: An icon inside the mark, before the count, or the whole mark when there is no value. Hidden from screen readers.
|
|
38872
39403
|
*
|
|
38873
39404
|
* ## CSS Custom Properties
|
|
38874
39405
|
*
|
|
@@ -38879,6 +39410,7 @@ export type CustomElements = {
|
|
|
38879
39410
|
* - `--badge-color`: The color of the count, to pair with a fill set through `--badge-background-color`.
|
|
38880
39411
|
* - `--badge-font-weight`: The weight of the count.
|
|
38881
39412
|
* - `--badge-gap`: The space between the content and the count under `placement="inline"`.
|
|
39413
|
+
* - `--badge-icon-size`: The size of an icon in the `icon` slot. The count's own size by default.
|
|
38882
39414
|
* - `--badge-offset`: Pulls the mark in from the corner, along both axes.
|
|
38883
39415
|
* - `--badge-radius`: How far the indicator's corners are rounded.
|
|
38884
39416
|
* - `--badge-ring-color`: The color of the ring between the indicator and what is behind it.
|
|
@@ -38887,7 +39419,8 @@ export type CustomElements = {
|
|
|
38887
39419
|
*
|
|
38888
39420
|
* Custom selectors for styling elements within the component.
|
|
38889
39421
|
*
|
|
38890
|
-
* - `
|
|
39422
|
+
* - `icon`: The slot the icon arrives through, inside the indicator. A slot draws no box, so it passes inherited properties, such as color, to the icon.
|
|
39423
|
+
* - `indicator`: The count, or the dot when there is no value. Carries `data-dot` when there is no value, `data-single` when the count is one character, and `data-blank` when the value is zero.
|
|
38891
39424
|
*
|
|
38892
39425
|
* ## CSS States
|
|
38893
39426
|
*
|
|
@@ -38895,7 +39428,8 @@ export type CustomElements = {
|
|
|
38895
39428
|
*
|
|
38896
39429
|
* - `blank`: The value is zero, so there is no mark.
|
|
38897
39430
|
* - `capped`: The count is past `max`, so the mark shows `{max}+`.
|
|
38898
|
-
* - `dot`: There is no value, so the mark is a dot.
|
|
39431
|
+
* - `dot`: There is no value and no icon, so the mark is a dot.
|
|
39432
|
+
* - `has-icon`: Something is slotted into `icon`, so it is drawn inside the mark.
|
|
38899
39433
|
* - `settled`: Set one frame after the first render. Transitions wait for it, so an element does not animate its own arrival.
|
|
38900
39434
|
*/
|
|
38901
39435
|
"helix-badge": Partial<HelixBadgeProps & BaseProps<HelixBadge> & BaseEvents<HelixBadge>>;
|
|
@@ -39510,6 +40044,12 @@ export type CustomElements = {
|
|
|
39510
40044
|
* browser harness's awaits it alone: a browser always runs the frame, and a
|
|
39511
40045
|
* timer beside it was a bet on how long one takes, which a busy run lost. (property only) (readonly)
|
|
39512
40046
|
*
|
|
40047
|
+
* ## Events
|
|
40048
|
+
*
|
|
40049
|
+
* Events that will be emitted by the component.
|
|
40050
|
+
*
|
|
40051
|
+
* - `helix-select`: A plain press on the crumb's link, with its `href` as the value, before the browser follows it. Cancelable: cancel it to keep the browser from following, as a client-side router does.
|
|
40052
|
+
*
|
|
39513
40053
|
* ## Slots
|
|
39514
40054
|
*
|
|
39515
40055
|
* Areas where markup can be added to the component.
|
|
@@ -39537,6 +40077,8 @@ export type CustomElements = {
|
|
|
39537
40077
|
* Custom selectors for styling elements within the component.
|
|
39538
40078
|
*
|
|
39539
40079
|
* - `separator`: The separator preceding the item.
|
|
40080
|
+
* - `expand`: The button after the first crumb of a folded slotted trail, which shows the folded crumbs.
|
|
40081
|
+
* - `fold-separator`: The chevron before that button.
|
|
39540
40082
|
* - `link`: The crumb itself, which is an `<a>` where `href` is set.
|
|
39541
40083
|
* - `separator-mark`: The chevron between crumbs, shown when no separator is slotted.
|
|
39542
40084
|
*
|
|
@@ -39544,7 +40086,9 @@ export type CustomElements = {
|
|
|
39544
40086
|
*
|
|
39545
40087
|
* These can be used to apply styling when a component is in a given state.
|
|
39546
40088
|
*
|
|
40089
|
+
* - `current`: While the crumb is the current page, marked `current` or the last of a trail with none marked.
|
|
39547
40090
|
* - `end`: While the `end` slot holds something, so a stylesheet can join the label and what follows it into one control.
|
|
40091
|
+
* - `folded`: While a trail longer than its `max-items` has folded the crumb away. It takes no room.
|
|
39548
40092
|
* - `settled`: Set one frame after the first render. Transitions wait for it, so an element does not animate its own arrival.
|
|
39549
40093
|
*/
|
|
39550
40094
|
"helix-breadcrumb": Partial<
|
|
@@ -39628,6 +40172,8 @@ export type CustomElements = {
|
|
|
39628
40172
|
* - `crumb`: Each crumb drawn from `items`.
|
|
39629
40173
|
* - `crumb-collapsed`: The crumb that holds the folded middle of a trail longer than `max-items`.
|
|
39630
40174
|
* - `crumb-current`: The crumb drawn from `items` for the current page.
|
|
40175
|
+
* - `crumb-expand`: The fold button a crumb draws after the first crumb of a folded slotted trail. A trail drawn from `items` draws its fold as a crumb of its own, `crumb-collapsed`, so this one is never drawn there.
|
|
40176
|
+
* - `crumb-fold-separator`: The chevron before that button.
|
|
39631
40177
|
* - `crumb-link`: The link, or the current page's words, of a crumb drawn from `items`.
|
|
39632
40178
|
* - `crumb-separator`: The separator before a crumb drawn from `items`.
|
|
39633
40179
|
* - `crumb-separator-mark`: The chevron before a crumb drawn from `items`.
|
|
@@ -39756,6 +40302,7 @@ export type CustomElements = {
|
|
|
39756
40302
|
*
|
|
39757
40303
|
* These can be used to apply styling when a component is in a given state.
|
|
39758
40304
|
*
|
|
40305
|
+
* - `pressed`: While a group with `selection-mode` has a button pressed.
|
|
39759
40306
|
* - `settled`: Set one frame after the first render. Transitions wait for it, so an element does not animate its own arrival.
|
|
39760
40307
|
*/
|
|
39761
40308
|
"helix-button-group": Partial<
|
|
@@ -40931,8 +41478,6 @@ export type CustomElements = {
|
|
|
40931
41478
|
*
|
|
40932
41479
|
* Reflected and undefaulted, so a card that has not asked reads as a card
|
|
40933
41480
|
* with no attribute on it and the stylesheet only describes the departure.
|
|
40934
|
-
* - `aria-labelledby`/`undefined`: undefined
|
|
40935
|
-
* - `aria-label`/`undefined`: undefined
|
|
40936
41481
|
* - `whenSettled`: Resolves a frame after the first update, when transitions are switched on.
|
|
40937
41482
|
*
|
|
40938
41483
|
* **Named `whenSettled` because `settled` is taken four times over**, by
|
|
@@ -40965,6 +41510,14 @@ export type CustomElements = {
|
|
|
40965
41510
|
* - `header-actions`: Controls for the whole card at the end of the header's line, such as a menu.
|
|
40966
41511
|
* - `media`: Image, video, or chart that runs edge to edge, outside the inset.
|
|
40967
41512
|
*
|
|
41513
|
+
* ## Methods
|
|
41514
|
+
*
|
|
41515
|
+
* Methods that can be called to access component functionality.
|
|
41516
|
+
*
|
|
41517
|
+
* - `attributeChangedCallback(name: string, old: string | null, value: string | null) => void`: Called by the browser when an observed attribute changes. A name written
|
|
41518
|
+
* or taken off asks for an update, because it decides whether the card is a
|
|
41519
|
+
* group and whether its heading names it.
|
|
41520
|
+
*
|
|
40968
41521
|
* ## CSS Custom Properties
|
|
40969
41522
|
*
|
|
40970
41523
|
* CSS variables available for styling the component.
|
|
@@ -42378,6 +42931,12 @@ export type CustomElements = {
|
|
|
42378
42931
|
* significant in code and a wrapped line reads as two. For prose-like code, such as a long command or
|
|
42379
42932
|
* a log line, a wrap reads better than a scroll. Line numbers keep the lines
|
|
42380
42933
|
* unwrapped, since a wrapped line would take one number and several rows.
|
|
42934
|
+
* - `code-label`/`codeLabel`: The name of a block that scrolls, which is a tab stop while it does.
|
|
42935
|
+
*
|
|
42936
|
+
* Where the block has a name, the scroller says it too, such as "Code,
|
|
42937
|
+
* app.ts", as `code-name-label` puts it.
|
|
42938
|
+
* - `code-name-label`/`codeNameLabel`: The name of a block that scrolls, where the block has a name. `{code}` is
|
|
42939
|
+
* `code-label` and `{name}` the block's name.
|
|
42381
42940
|
* - `collapse-label`/`collapseLabel`: The expand button's words while the block shows every line.
|
|
42382
42941
|
* - `copied-label`/`copiedLabel`: The copy button's name and tooltip text after a copy.
|
|
42383
42942
|
* - `copy-label`/`copyLabel`: The copy button's name and tooltip text before a copy.
|
|
@@ -42696,7 +43255,8 @@ export type CustomElements = {
|
|
|
42696
43255
|
* Passed to the panel, whose square, hue ramp and presets say the color's
|
|
42697
43256
|
* name, and read by the swatch in `swatch`, which says it before the value.
|
|
42698
43257
|
* Color Picker lists the keys.
|
|
42699
|
-
* - `format`: The syntax the value is written in: `hex`, `rgb`,
|
|
43258
|
+
* - `format`: The syntax the value is written in: `hex`, `rgb`, `hsl`, `oklch`, or
|
|
43259
|
+
* `hsb`, as Color Picker's `format`.
|
|
42700
43260
|
*
|
|
42701
43261
|
* **Undefaulted, because it reflects.** The two together stamp an attribute
|
|
42702
43262
|
* onto every host anybody renders, including the ones nobody configured: the
|
|
@@ -42913,6 +43473,8 @@ export type CustomElements = {
|
|
|
42913
43473
|
* - `picker-channel-marker-label`: The value a mark stands at, when `marker-labels` is set.
|
|
42914
43474
|
* - `picker-channel-markers`: The row of marks along the track.
|
|
42915
43475
|
* - `picker-channel-output`: The current value, shown beside the track.
|
|
43476
|
+
* - `picker-channel-thumb`: A ramp's thumb box, which holds no content in a picker.
|
|
43477
|
+
* - `picker-channel-thumbs`: The layer over a ramp's track that holds its thumb box.
|
|
42916
43478
|
* - `picker-channel-tooltip`: A ramp's value in a bubble, where a ramp shows one.
|
|
42917
43479
|
* - `picker-channel-tooltips`: The layer over a ramp's track that holds its bubble.
|
|
42918
43480
|
* - `picker-channels`: The channel sliders beside the sample.
|
|
@@ -42937,7 +43499,9 @@ export type CustomElements = {
|
|
|
42937
43499
|
* - `picker-grid-brightness`: The range input for the square's vertical axis.
|
|
42938
43500
|
* - `picker-grid-handle`: The mark showing where in the square the color sits.
|
|
42939
43501
|
* - `picker-grid-saturation`: The range input for the square's horizontal axis.
|
|
43502
|
+
* - `picker-hint`: The picker's own help, which the field's `hint` stands in for here, so it stays hidden.
|
|
42940
43503
|
* - `picker-icon`: An icon drawn by the picker.
|
|
43504
|
+
* - `picker-label`: The picker's own name, which the field's `label` stands in for here, so it stays hidden.
|
|
42941
43505
|
* - `picker-sample`: A chip of the current color. Pressing it copies the value.
|
|
42942
43506
|
* - `picker-swatch`: One preset.
|
|
42943
43507
|
* - `picker-swatches`: The row of presets.
|
|
@@ -43024,12 +43588,15 @@ export type CustomElements = {
|
|
|
43024
43588
|
* language hears its own rather than English between its own labels.
|
|
43025
43589
|
* - `channel-fields`/`channelFields`: Whether the picker shows a number field for each channel of the color, as
|
|
43026
43590
|
* React Aria's ColorField does with `channel`: red, green and blue for hex
|
|
43027
|
-
* and rgb, hue, saturation and lightness for hsl,
|
|
43028
|
-
*
|
|
43591
|
+
* and rgb, hue, saturation and lightness for hsl, hue, saturation and
|
|
43592
|
+
* brightness for hsb, lightness, chroma and hue for oklch, and the opacity
|
|
43593
|
+
* with `alpha`.
|
|
43029
43594
|
*
|
|
43030
43595
|
* For a reader who has the numbers from a brand guide, and for a keyboard,
|
|
43031
43596
|
* where typing 128 is quicker than holding an arrow key. The fields follow
|
|
43032
43597
|
* the syntax the format toggle sets.
|
|
43598
|
+
* - `chroma-label`/`chromaLabel`: What the chroma channel's field is called, in `channel-fields` with
|
|
43599
|
+
* oklch.
|
|
43033
43600
|
* - `color-words`/`colorWords`: The words a color's name is spoken in, as JSON keyed by their English,
|
|
43034
43601
|
* such as `{"red": "rot", "vibrant": "kräftiges"}`.
|
|
43035
43602
|
*
|
|
@@ -43046,15 +43613,25 @@ export type CustomElements = {
|
|
|
43046
43613
|
* - `copy-label`/`copyLabel`: The name of the sample, which copies the value. `{value}` is replaced with
|
|
43047
43614
|
* the color.
|
|
43048
43615
|
* - `eyedropper-label`/`eyedropperLabel`: What the eyedropper is called.
|
|
43049
|
-
* - `format`: The syntax the value is written in: `hex`, `rgb`,
|
|
43616
|
+
* - `format`: The syntax the value is written in: `hex`, `rgb`, `hsl`, `oklch`, or
|
|
43617
|
+
* `hsb`.
|
|
43050
43618
|
*
|
|
43051
43619
|
* Only what is written. Everything is read whatever this says, so a picker on
|
|
43052
|
-
* `hex` still takes an `rgb()` handed to it and stores the
|
|
43620
|
+
* `hex` still takes an `rgb()` or an `oklch()` handed to it and stores the
|
|
43621
|
+
* hex for it. `oklch` writes the sRGB color the picker holds, such as
|
|
43622
|
+
* `oklch(62.8% 0.258 29.2)`; a color outside sRGB that is handed in is
|
|
43623
|
+
* clipped to it. `hsb` writes the picker's own model, `hsb(0, 100%, 100%)`,
|
|
43624
|
+
* as React Aria's and Zag's color strings do. It is not CSS, so the toggle
|
|
43625
|
+
* walks the other four.
|
|
43053
43626
|
* - `format-label`/`formatLabel`: What the syntax toggle is called, with `{format}` filled in.
|
|
43054
43627
|
* - `green-label`/`greenLabel`: What the green channel's field is called, in `channel-fields`.
|
|
43628
|
+
* - `hint`: Help under the picker, such as what the color is used for. The `hint`
|
|
43629
|
+
* slot takes richer content.
|
|
43055
43630
|
* - `hue-label`/`hueLabel`: What the hue channel is called.
|
|
43631
|
+
* - `label`: The name above the picker, such as "Brand color". The picker is then a
|
|
43632
|
+
* group with this name. The `label` slot takes richer content.
|
|
43056
43633
|
* - `lightness-label`/`lightnessLabel`: What the lightness channel's field is called, in `channel-fields` with
|
|
43057
|
-
* hsl.
|
|
43634
|
+
* hsl and oklch.
|
|
43058
43635
|
* - `no-eyedropper`/`noEyedropper`: Hides the eyedropper. Without it, the eyedropper appears in browsers that
|
|
43059
43636
|
* support one.
|
|
43060
43637
|
* - `no-format`/`noFormat`: Hides the syntax toggle, so the format cannot be changed.
|
|
@@ -43209,6 +43786,8 @@ export type CustomElements = {
|
|
|
43209
43786
|
* Areas where markup can be added to the component.
|
|
43210
43787
|
*
|
|
43211
43788
|
* - `eyedropper-icon`: The icon on the eyedropper button, usually a dropper.
|
|
43789
|
+
* - `hint`: Help under the picker, for content richer than the `hint` text.
|
|
43790
|
+
* - `label`: The name above the picker, for content richer than the `label` text.
|
|
43212
43791
|
*
|
|
43213
43792
|
* ## Methods
|
|
43214
43793
|
*
|
|
@@ -43307,6 +43886,8 @@ export type CustomElements = {
|
|
|
43307
43886
|
* - `channel-marker-label`: The value a mark stands at, when `marker-labels` is set.
|
|
43308
43887
|
* - `channel-markers`: The row of marks along the track.
|
|
43309
43888
|
* - `channel-output`: The current value, shown beside the track.
|
|
43889
|
+
* - `channel-thumb`: A ramp's thumb box, which holds no content in a picker.
|
|
43890
|
+
* - `channel-thumbs`: The layer over a ramp's track that holds its thumb box.
|
|
43310
43891
|
* - `channel-tooltip`: A ramp's value in a bubble, where a ramp shows one.
|
|
43311
43892
|
* - `channel-tooltips`: The layer over a ramp's track that holds its bubble.
|
|
43312
43893
|
* - `channels`: The ramps beside the sample.
|
|
@@ -43330,6 +43911,8 @@ export type CustomElements = {
|
|
|
43330
43911
|
* - `grid`: The saturation and brightness square. Draw the mark that shows where the color sits with `::part(grid)::after` in your stylesheet. The square carries the two channels as `--color-picker-saturation` and `--color-picker-brightness`, and this tier ships no CSS.
|
|
43331
43912
|
* - `grid-brightness`: The range input for the square's vertical axis.
|
|
43332
43913
|
* - `grid-saturation`: The range input for the square's horizontal axis.
|
|
43914
|
+
* - `hint`: The help under the picker, while `hint` is set or the `hint` slot has content.
|
|
43915
|
+
* - `label`: The name above the picker, while `label` is set or the `label` slot has content.
|
|
43333
43916
|
* - `sample`: A chip of the current color. Pressing it copies the value.
|
|
43334
43917
|
* - `swatch`: One preset, an option in the `swatches` listbox.
|
|
43335
43918
|
* - `swatches`: The row of presets, a listbox.
|
|
@@ -43341,7 +43924,10 @@ export type CustomElements = {
|
|
|
43341
43924
|
*
|
|
43342
43925
|
* These can be used to apply styling when a component is in a given state.
|
|
43343
43926
|
*
|
|
43927
|
+
* - `copied`: The moment after the sample copies the value, while it says `copied-label`.
|
|
43928
|
+
* - `dragging`: While a pointer drags the square's handle.
|
|
43344
43929
|
* - `invalid`: While `invalid` is set or `feedback` says what is wrong.
|
|
43930
|
+
* - `sampling`: While the eyedropper is open over the screen.
|
|
43345
43931
|
* - `settled`: Set one frame after the first render. Transitions wait for it, so an element does not animate its own arrival.
|
|
43346
43932
|
*/
|
|
43347
43933
|
"helix-color-picker": Partial<
|
|
@@ -44923,6 +45509,7 @@ export type CustomElements = {
|
|
|
44923
45509
|
* - `picker-day-outside`: A day from a neighboring month. Applied with `picker-day`.
|
|
44924
45510
|
* - `picker-day-selected`: The chosen day, or either end of a chosen range. Applied with `picker-day`.
|
|
44925
45511
|
* - `picker-day-today`: Today. Applied with `picker-day`.
|
|
45512
|
+
* - `picker-day-weekend`: A day of the weekend where the calendar's language is spoken, beside `picker-day`.
|
|
44926
45513
|
* - `picker-feedback`: The calendar's own message, under it, while the calendar's `feedback` is set.
|
|
44927
45514
|
* - `picker-grid`: The grid of days.
|
|
44928
45515
|
* - `picker-header`: The month name and its controls.
|
|
@@ -45008,15 +45595,22 @@ export type CustomElements = {
|
|
|
45008
45595
|
* speaks it. Unset is the sentence registered for the page's language, then
|
|
45009
45596
|
* the English. `{mode}` is `single`, `range` or `multiple`, so each can have
|
|
45010
45597
|
* its own sentence.
|
|
45011
|
-
* - `calendar`: The calendar the heading, the days, and the months are written in
|
|
45012
|
-
*
|
|
45013
|
-
*
|
|
45014
|
-
*
|
|
45015
|
-
*
|
|
45016
|
-
* `
|
|
45017
|
-
*
|
|
45018
|
-
*
|
|
45019
|
-
*
|
|
45598
|
+
* - `calendar`: The calendar the heading, the days, and the months are written in.
|
|
45599
|
+
*
|
|
45600
|
+
* `gregory`, `buddhist`, `japanese`, `roc`, and `iso8601` are the five
|
|
45601
|
+
* whose months are the Gregorian months. Absent is the locale's own where
|
|
45602
|
+
* it is one of the five, such as `buddhist` for `th-TH` or `japanese` for
|
|
45603
|
+
* `ja-JP-u-ca-japanese`, and `gregory` for every other, such as `persian`
|
|
45604
|
+
* for `fa-IR`.
|
|
45605
|
+
*
|
|
45606
|
+
* `persian`, `hebrew`, `islamic-umalqura`, `islamic-civil`, `ethiopic`,
|
|
45607
|
+
* `coptic`, and `indian` draw a calendar with months of its own, as React
|
|
45608
|
+
* Aria's calendars do: each grid is one of that calendar's months, the
|
|
45609
|
+
* Hebrew leap month and Ethiopia's five-day thirteenth month included, and
|
|
45610
|
+
* Previous, Next and the page keys move by those months. `month` and
|
|
45611
|
+
* `helix-navigate` then name a month by its first day, `YYYY-MM-DD`. The
|
|
45612
|
+
* heading stays text, as the months and years views are drawn in Gregorian
|
|
45613
|
+
* months only. The value is `YYYY-MM-DD` in every calendar.
|
|
45020
45614
|
* - `default-month`/`defaultMonth`: The month to open on when `month` is not set.
|
|
45021
45615
|
* - `disable-dates`/`disableDates`: Dates that cannot be chosen, as `YYYY-MM-DD`, separated by commas or
|
|
45022
45616
|
* spaces.
|
|
@@ -45042,8 +45636,9 @@ export type CustomElements = {
|
|
|
45042
45636
|
* its days.
|
|
45043
45637
|
* - `min`: Earliest selectable date, as `YYYY-MM-DD`.
|
|
45044
45638
|
* - `mode`: How many dates can be held at once.
|
|
45045
|
-
* - `month`: The month shown, as `YYYY-MM
|
|
45046
|
-
*
|
|
45639
|
+
* - `month`: The month shown, as `YYYY-MM`, or as its first day, `YYYY-MM-DD`, under a
|
|
45640
|
+
* `calendar` with months of its own. When it is not set, it follows
|
|
45641
|
+
* `value`, then the current month.
|
|
45047
45642
|
*
|
|
45048
45643
|
* Separate from `value` on purpose, so paging selects nothing and a consumer
|
|
45049
45644
|
* can drive the view. Reading gives the month on show; writing sets it, and
|
|
@@ -45090,6 +45685,13 @@ export type CustomElements = {
|
|
|
45090
45685
|
* treated as one rather than as an error: a step of zero would block every
|
|
45091
45686
|
* date including the one already chosen.
|
|
45092
45687
|
* - `step-mismatch-message`/`stepMismatchMessage`: The validation message for a date that `step` skips.
|
|
45688
|
+
* - `time-zone`/`timeZone`: The time zone today is read in, such as `America/New_York`, as React
|
|
45689
|
+
* Aria's `today(timeZone)` reads it. Empty is the reader's own.
|
|
45690
|
+
*
|
|
45691
|
+
* Dates are plain `YYYY-MM-DD` and carry no zone, so this moves only today:
|
|
45692
|
+
* the day marked `aria-current` and `day-today`, and the month a picker
|
|
45693
|
+
* with no value opens on. A desk in Tokyo booking for an office in New York
|
|
45694
|
+
* sets `America/New_York`, and today is the office's.
|
|
45093
45695
|
* - `unavailable-message`/`unavailableMessage`: The validation message for a date that `disable-dates` or `disable-days`
|
|
45094
45696
|
* bars.
|
|
45095
45697
|
* - `value-missing-message`/`valueMissingMessage`: The validation message for a required date picker with no date chosen.
|
|
@@ -45190,6 +45792,8 @@ export type CustomElements = {
|
|
|
45190
45792
|
*
|
|
45191
45793
|
* Areas where markup can be added to the component.
|
|
45192
45794
|
*
|
|
45795
|
+
* - `footer`: Content under the calendar, such as buttons for today or a common range.
|
|
45796
|
+
* - `header`: Content above the calendar, such as a note on what the date is for.
|
|
45193
45797
|
* - `next-icon`: The glyph on the control that moves forward a month, usually a caret.
|
|
45194
45798
|
* - `previous-icon`: The glyph on the control that moves back a month, usually a caret.
|
|
45195
45799
|
*
|
|
@@ -45283,6 +45887,7 @@ export type CustomElements = {
|
|
|
45283
45887
|
* - `day-outside`: A day from a neighboring month, filling the grid out, beside `day`.
|
|
45284
45888
|
* - `day-selected`: The chosen day, or either end of a chosen range, beside `day`.
|
|
45285
45889
|
* - `day-today`: Today, beside `day`.
|
|
45890
|
+
* - `day-weekend`: A day of the weekend where the calendar's language is spoken, beside `day`: Saturday and Sunday in `en-US`, Friday and Saturday in `ar-EG`.
|
|
45286
45891
|
* - `feedback`: The message under the calendar, while `feedback` is set.
|
|
45287
45892
|
* - `grid`: The grid of days.
|
|
45288
45893
|
* - `header`: The month name and its controls.
|
|
@@ -45301,7 +45906,7 @@ export type CustomElements = {
|
|
|
45301
45906
|
* - `previous`: The control that moves to the previous month.
|
|
45302
45907
|
* - `previous-mark`: The glyph on the previous month control, where none is slotted.
|
|
45303
45908
|
* - `week`: One row of days.
|
|
45304
|
-
* - `weekday`: A column header naming a day of the week.
|
|
45909
|
+
* - `weekday`: A column header naming a day of the week. It shows the short name and says the full one.
|
|
45305
45910
|
*
|
|
45306
45911
|
* ## CSS States
|
|
45307
45912
|
*
|
|
@@ -46640,13 +47245,18 @@ export type CustomElements = {
|
|
|
46640
47245
|
*
|
|
46641
47246
|
* Custom selectors for styling elements within the component.
|
|
46642
47247
|
*
|
|
47248
|
+
* - `actions`: The slot the actions arrive through. A slot draws no box, so it passes inherited properties to the actions; `display: flex` lays them out in a row.
|
|
46643
47249
|
* - `heading`: The heading at `heading-level`: the one `heading` draws while nothing is slotted into `heading`, or the one around a slotted element that is no heading.
|
|
47250
|
+
* - `icon`: The slot the icon arrives through, drawing no box, as `actions` does.
|
|
46644
47251
|
* - `live`: A copy of the heading and the message, in a live region that screen readers announce when the view appears. Visually hidden in the styled tier.
|
|
47252
|
+
* - `message`: The slot the message arrives through, drawing no box, as `actions` does.
|
|
46645
47253
|
*
|
|
46646
47254
|
* ## CSS States
|
|
46647
47255
|
*
|
|
46648
47256
|
* These can be used to apply styling when a component is in a given state.
|
|
46649
47257
|
*
|
|
47258
|
+
* - `has-actions`: Something is slotted into `actions`.
|
|
47259
|
+
* - `has-icon`: Something is slotted into `icon`.
|
|
46650
47260
|
* - `settled`: Set one frame after the first render. Transitions wait for it, so an element does not animate its own arrival.
|
|
46651
47261
|
*/
|
|
46652
47262
|
"helix-empty": Partial<HelixEmptyProps & BaseProps<HelixEmpty> & BaseEvents<HelixEmpty>>;
|
|
@@ -49016,10 +49626,33 @@ export type CustomElements = {
|
|
|
49016
49626
|
* Inside a button, `--icon-size` is set in `em`, so the icon scales with the
|
|
49017
49627
|
* button.
|
|
49018
49628
|
*
|
|
49629
|
+
* **The glyph turns, flips and moves inside its own box**, so the line around
|
|
49630
|
+
* it keeps its place: `rotate` turns it by a quarter, a half or three
|
|
49631
|
+
* quarters, `--icon-rotate` by any angle, `flip` mirrors it across either
|
|
49632
|
+
* axis, and `animation` spins, pulses or beats it, as Web Awesome's icon does.
|
|
49633
|
+
* Reduced motion stills every animation. `auto-width` gives the box the
|
|
49634
|
+
* glyph's own proportions, for a mark wider than it is tall.
|
|
49635
|
+
*
|
|
49019
49636
|
* ## Attributes & Properties
|
|
49020
49637
|
*
|
|
49021
49638
|
* Component attributes and properties that can be applied to the element or by using JavaScript.
|
|
49022
49639
|
*
|
|
49640
|
+
* - `animation`: A motion that draws the eye or says work is going on: `spin` turns the
|
|
49641
|
+
* glyph without end, `pulse` fades it in and out, and `beat` swells it.
|
|
49642
|
+
*
|
|
49643
|
+
* Absent is still. Reduced motion stills every one of them.
|
|
49644
|
+
* - `auto-width`/`autoWidth`: Whether the box takes the glyph's own proportions, its height from
|
|
49645
|
+
* `--icon-size` and its width from the glyph's box.
|
|
49646
|
+
*
|
|
49647
|
+
* Absent is a square, which lines icons up in a column.
|
|
49648
|
+
* - `flip`: Mirrors the glyph across an axis: `x` left to right, `y` top to bottom,
|
|
49649
|
+
* `both` across both.
|
|
49650
|
+
*
|
|
49651
|
+
* Absent draws it as it is. On a right-to-left page, `mirror` is the flip
|
|
49652
|
+
* that follows the direction.
|
|
49653
|
+
* - `rotate`: Turns the glyph clockwise by 90, 180 or 270 degrees.
|
|
49654
|
+
*
|
|
49655
|
+
* Absent draws it upright. `--icon-rotate` turns it by any other angle.
|
|
49023
49656
|
* - `label`: The icon's name, read by screen readers. Set it for an icon that is not
|
|
49024
49657
|
* decorative.
|
|
49025
49658
|
* - `mirror`: Flips the glyph on a right-to-left page. Use it for an arrow that means
|
|
@@ -49040,6 +49673,10 @@ export type CustomElements = {
|
|
|
49040
49673
|
*
|
|
49041
49674
|
* A name written `prefix:name` asks the library registered under that
|
|
49042
49675
|
* prefix.
|
|
49676
|
+
* - `src`: The URL of an SVG file to draw, fetched once a page and drawn in
|
|
49677
|
+
* `currentColor` where the file does not color its shapes.
|
|
49678
|
+
*
|
|
49679
|
+
* Wins over `name`; `icon` wins over both. Absent draws `name`.
|
|
49043
49680
|
* - `icon`: The icon to draw, as an object you import.
|
|
49044
49681
|
*
|
|
49045
49682
|
* **The scalable door, and the one this library uses internally.** An icon is
|
|
@@ -49077,8 +49714,8 @@ export type CustomElements = {
|
|
|
49077
49714
|
*
|
|
49078
49715
|
* Events that will be emitted by the component.
|
|
49079
49716
|
*
|
|
49080
|
-
* - `error`: `name` matches no registered icon and no library answers it, so nothing is drawn.
|
|
49081
|
-
* - `load`: A glyph a library gave later for `name` is drawn.
|
|
49717
|
+
* - `error`: `name` matches no registered icon and no library answers it, or `src` is no SVG, so nothing is drawn.
|
|
49718
|
+
* - `load`: A glyph a library gave later for `name`, or the file at `src`, is drawn.
|
|
49082
49719
|
*
|
|
49083
49720
|
* ## Methods
|
|
49084
49721
|
*
|
|
@@ -49092,7 +49729,9 @@ export type CustomElements = {
|
|
|
49092
49729
|
*
|
|
49093
49730
|
* CSS variables available for styling the component.
|
|
49094
49731
|
*
|
|
49095
|
-
* - `--icon-
|
|
49732
|
+
* - `--icon-animation-duration`: How long one turn, pulse or beat of `animation` takes.
|
|
49733
|
+
* - `--icon-rotate`: An angle the glyph is turned by, such as `45deg`. `rotate` wins over it.
|
|
49734
|
+
* - `--icon-size`: The width and height of the icon's box. The height alone under `auto-width`.
|
|
49096
49735
|
*
|
|
49097
49736
|
* ## CSS Parts
|
|
49098
49737
|
*
|
|
@@ -53191,6 +53830,7 @@ export type CustomElements = {
|
|
|
53191
53830
|
*
|
|
53192
53831
|
* These can be used to apply styling when a component is in a given state.
|
|
53193
53832
|
*
|
|
53833
|
+
* - `open`: While a megamenu or another disclosure among the destinations is open.
|
|
53194
53834
|
* - `settled`: Set one frame after the first render. Transitions wait for it, so an element does not animate its own arrival.
|
|
53195
53835
|
*/
|
|
53196
53836
|
"helix-navigation": Partial<
|
|
@@ -55989,6 +56629,12 @@ export type CustomElements = {
|
|
|
55989
56629
|
* Component attributes and properties that can be applied to the element or by using JavaScript.
|
|
55990
56630
|
*
|
|
55991
56631
|
* - `cite`: URL identifying where the quotation came from.
|
|
56632
|
+
* - `no-marks`/`noMarks`: Whether to leave the quotation marks off, for a quotation set where the
|
|
56633
|
+
* page draws its own.
|
|
56634
|
+
*
|
|
56635
|
+
* Negative, because the marks are on by default and a boolean attribute is
|
|
56636
|
+
* true whenever it is present. Reflected, because a stylesheet takes the
|
|
56637
|
+
* marks off on it.
|
|
55992
56638
|
* - `whenSettled`: Resolves a frame after the first update, when transitions are switched on.
|
|
55993
56639
|
*
|
|
55994
56640
|
* **Named `whenSettled` because `settled` is taken four times over**, by
|
|
@@ -57966,6 +58612,17 @@ export type CustomElements = {
|
|
|
57966
58612
|
*
|
|
57967
58613
|
* No attribute, because it is coordination between elements rather than
|
|
57968
58614
|
* anything a consumer sets. (property only)
|
|
58615
|
+
* - `items`: The options as data, for a list too long to draw whole: each a value,
|
|
58616
|
+
* which is also its words, or a record with a `value`, a `label` and
|
|
58617
|
+
* `disabled`. Passed to the list, which draws only the options in sight,
|
|
58618
|
+
* as Listbox's `items` does. Set, the options you write as children are
|
|
58619
|
+
* not read.
|
|
58620
|
+
*
|
|
58621
|
+
* The trigger shows the chosen options' labels, the letters and the Left
|
|
58622
|
+
* and Right keys on the closed trigger choose over the whole set, and a
|
|
58623
|
+
* chosen value whose option leaves `items` drops out of `value`.
|
|
58624
|
+
* `value-content` is not called for `items`. Import the Option family as
|
|
58625
|
+
* well, whose elements are drawn. (property only)
|
|
57969
58626
|
* - `valueContent`: What the trigger shows for the chosen options: a function given them, in
|
|
57970
58627
|
* the order they appear, that returns text, an element or a Lit template.
|
|
57971
58628
|
*
|
|
@@ -58147,6 +58804,8 @@ export type CustomElements = {
|
|
|
58147
58804
|
*
|
|
58148
58805
|
* - `invalid`: The control has an error to show, from the browser's validation or from your `feedback`.
|
|
58149
58806
|
* - `open`: While the list is open.
|
|
58807
|
+
* - `placed-bottom`: While the open list sits below the trigger.
|
|
58808
|
+
* - `placed-top`: While the open list sits above the trigger, where there was no room below.
|
|
58150
58809
|
* - `settled`: Set one frame after the first render. Transitions wait for it, so an element does not animate its own arrival.
|
|
58151
58810
|
*/
|
|
58152
58811
|
"helix-select": Partial<
|
|
@@ -58161,6 +58820,11 @@ export type CustomElements = {
|
|
|
58161
58820
|
* Around content with `loading`, the skeleton takes the content's box and
|
|
58162
58821
|
* paints over it, and the content is hidden until `loading` is taken off.
|
|
58163
58822
|
*
|
|
58823
|
+
* **`lines` draws a paragraph.** With `shape="text"` and `lines="3"`, one
|
|
58824
|
+
* element stands in for three lines of text: each line a `skeleton` part one
|
|
58825
|
+
* `em` tall, spaced a body line height apart, and the last one shorter, as the end
|
|
58826
|
+
* of a paragraph is.
|
|
58827
|
+
*
|
|
58164
58828
|
* ## Attributes & Properties
|
|
58165
58829
|
*
|
|
58166
58830
|
* Component attributes and properties that can be applied to the element or by using JavaScript.
|
|
@@ -58169,6 +58833,10 @@ export type CustomElements = {
|
|
|
58169
58833
|
* fade the fill in and out, or `none` to sit still.
|
|
58170
58834
|
*
|
|
58171
58835
|
* Reduced motion stills both.
|
|
58836
|
+
* - `lines`: How many lines of text the placeholder stands for, with `shape="text"`.
|
|
58837
|
+
*
|
|
58838
|
+
* Absent, or 1, is one line. Reflected, because the stylesheet sizes a
|
|
58839
|
+
* paragraph by it.
|
|
58172
58840
|
* - `shape`: The shape of the placeholder: `text`, `circle`, or a block when unset.
|
|
58173
58841
|
*
|
|
58174
58842
|
* Unset is a block, which is what most missing things are. A block is the
|
|
@@ -58217,6 +58885,7 @@ export type CustomElements = {
|
|
|
58217
58885
|
* - `--skeleton-block-size`: The height of the block shape, which is the shape when `shape` is unset. Defaults to the control height.
|
|
58218
58886
|
* - `--skeleton-color`: The placeholder's fill.
|
|
58219
58887
|
* - `--skeleton-duration`: How long one sweep or one pulse takes.
|
|
58888
|
+
* - `--skeleton-last-line-size`: The width of the last line of a `lines` paragraph. Defaults to 60%.
|
|
58220
58889
|
* - `--skeleton-radius`: The corner of the block shape.
|
|
58221
58890
|
* - `--skeleton-sheen-color`: The highlight the sweep carries across the fill.
|
|
58222
58891
|
* - `--skeleton-size`: The diameter of the circle shape.
|
|
@@ -58226,8 +58895,10 @@ export type CustomElements = {
|
|
|
58226
58895
|
* Custom selectors for styling elements within the component.
|
|
58227
58896
|
*
|
|
58228
58897
|
* - `content`: The box around the content, hidden while `loading`.
|
|
58898
|
+
* - `line`: Each line of a `lines` paragraph, which is also a `skeleton` part.
|
|
58899
|
+
* - `lines`: The column holding a `lines` paragraph, drawn only for `shape="text"` with two or more lines.
|
|
58229
58900
|
* - `sheen`: The highlight swept across the shape. Hidden for `effect="pulse"` and `effect="none"`.
|
|
58230
|
-
* - `skeleton`: The placeholder shape.
|
|
58901
|
+
* - `skeleton`: The placeholder shape, or each line of a `lines` paragraph.
|
|
58231
58902
|
*
|
|
58232
58903
|
* ## CSS States
|
|
58233
58904
|
*
|
|
@@ -58414,13 +59085,24 @@ export type CustomElements = {
|
|
|
58414
59085
|
* between its thumbs and ignores it.
|
|
58415
59086
|
* - `range`: Adds a second thumb, so the value is a pair.
|
|
58416
59087
|
*
|
|
58417
|
-
* The pair is one string, `"10,50"`, which is what
|
|
58418
|
-
* `MixinControllerValue`
|
|
58419
|
-
*
|
|
59088
|
+
* The pair is one string, `"10,50"`, which is what `value` and
|
|
59089
|
+
* `MixinControllerValue` hold. A form receives two entries under the name,
|
|
59090
|
+
* `price=10&price=50`, as React Aria's two thumbs send theirs.
|
|
59091
|
+
* `valueAsNumber` reads the lower of the two, since a range has no single
|
|
59092
|
+
* number.
|
|
58420
59093
|
* - `range-text`/`rangeText`: How the readout joins a range's two values, with `{start}` and `{end}`
|
|
58421
59094
|
* filled in. Write it in the page's language, such as `{start} bis {end}`.
|
|
59095
|
+
* - `readonly`/`readOnly`: Whether a reader can see and focus the value and cannot change it. A
|
|
59096
|
+
* read-only slider still submits its value.
|
|
59097
|
+
*
|
|
59098
|
+
* React Aria's `isReadOnly`. Each thumb stays a tab stop and says
|
|
59099
|
+
* `aria-readonly`. The arrow keys, the page keys, Home, End, and a drag
|
|
59100
|
+
* leave the value where it is. A script can still set `value`.
|
|
58422
59101
|
* - `show-value`/`showValue`: Shows the chosen value beside the track.
|
|
58423
59102
|
* - `step`: How far one press of an arrow key moves the thumb.
|
|
59103
|
+
* - `thumb-label`/`thumbLabel`: The name of a thumb between a range's first and last, read after the
|
|
59104
|
+
* slider's label, with `{index}` filled in: its place, counted from 1. The
|
|
59105
|
+
* first is `minimum-label` and the last `maximum-label`.
|
|
58424
59106
|
* - `tooltip`: Whether each thumb shows its value in a bubble beside it, as Web
|
|
58425
59107
|
* Awesome's `with-tooltip`. The styled slider shows the bubbles while the
|
|
58426
59108
|
* slider is under the pointer or holds focus. They repeat what each thumb
|
|
@@ -58496,6 +59178,8 @@ export type CustomElements = {
|
|
|
58496
59178
|
* - `feedback`: The message that says what is wrong, for content richer than a string. It shows while there is a message.
|
|
58497
59179
|
* - `hint`: Help under the control, for content richer than the `hint` text.
|
|
58498
59180
|
* - `label`: The label, for content richer than the `label` text.
|
|
59181
|
+
* - `thumb`: Content drawn on the thumb, such as a glyph: a single slider's thumb, or a range's lower one. It is decoration, hidden from a screen reader.
|
|
59182
|
+
* - `thumb-end`: Content drawn on a range's upper thumb.
|
|
58499
59183
|
*
|
|
58500
59184
|
* ## Methods
|
|
58501
59185
|
*
|
|
@@ -58568,6 +59252,7 @@ export type CustomElements = {
|
|
|
58568
59252
|
* - `--slider-length`: The length of a vertical track. It defaults to nine rem and applies only when `orientation` is `vertical`. A horizontal track takes the width of its row.
|
|
58569
59253
|
* - `--slider-marker-color`: The color of the marks along the track.
|
|
58570
59254
|
* - `--slider-thumb-color`: The color of the thumb.
|
|
59255
|
+
* - `--slider-thumb-content-color`: The color of content in the `thumb` and `thumb-end` slots, drawn on the thumb.
|
|
58571
59256
|
* - `--slider-thumb-length`: The thumb's size along the track. It follows `--slider-thumb-size` unless you set it, and setting one of the two makes the thumb an oval.
|
|
58572
59257
|
* - `--slider-thumb-radius`: The thumb's corner radius. It is fully round by default, so a thumb with two different dimensions is a capsule unless you change it.
|
|
58573
59258
|
* - `--slider-thumb-ring-color`: The color of the ring between the thumb and the track. Set it for a slider that sits on a surface other than the page background.
|
|
@@ -58577,7 +59262,7 @@ export type CustomElements = {
|
|
|
58577
59262
|
* - `--slider-track-color`: The color of the unfilled part of the track.
|
|
58578
59263
|
* - `--slider-track-image`: An image for the whole track, such as a gradient for a slider whose value is a color.
|
|
58579
59264
|
* - `--slider-track-size`: The thickness of the track. It matches the progress bar's size by default.
|
|
58580
|
-
* - `--slider-at`: Where a bubble's thumb is, as a fraction of the track, 0 to 1. Set on each `tooltip` part.
|
|
59265
|
+
* - `--slider-at`: Where a bubble's or a thumb box's thumb is, as a fraction of the track, 0 to 1. Set on each `tooltip` and `thumb` part.
|
|
58581
59266
|
* - `--slider-fraction`: The value as a fraction of the range, 0 to 1.
|
|
58582
59267
|
* - `--slider-from`: Where the filled span starts, as a fraction of the track, 0 to 1: a range's lower thumb, or a single thumb's `origin`.
|
|
58583
59268
|
* - `--slider-marker-at`: Where one marker sits, as a percentage of the track.
|
|
@@ -58587,7 +59272,7 @@ export type CustomElements = {
|
|
|
58587
59272
|
*
|
|
58588
59273
|
* Custom selectors for styling elements within the component.
|
|
58589
59274
|
*
|
|
58590
|
-
* - `control`: The range input.
|
|
59275
|
+
* - `control`: The range input, one per thumb. On a range each carries `data-thumb`, `start`, `middle`, or `end`, and `data-index`, its place from the lowest.
|
|
58591
59276
|
* - `feedback`: The error message under the track.
|
|
58592
59277
|
* - `field`: The row that holds the control and its readout.
|
|
58593
59278
|
* - `hint`: The help text under the track, shown while there is no error.
|
|
@@ -58596,7 +59281,9 @@ export type CustomElements = {
|
|
|
58596
59281
|
* - `marker-label`: The value a mark stands at, when `marker-labels` is set.
|
|
58597
59282
|
* - `markers`: The row of marks along the track.
|
|
58598
59283
|
* - `output`: The current value, shown beside the track.
|
|
58599
|
-
* - `
|
|
59284
|
+
* - `thumb`: One thumb's own box over the track, which holds the `thumb` or `thumb-end` slot. It carries `data-thumb` on a range, `start`, `middle`, or `end`, and `--slider-at`, where its thumb is as a fraction of the track. Draw your own thumb here and hide the native one, or leave it empty.
|
|
59285
|
+
* - `thumbs`: The layer over the track that holds each `thumb`. It is `hidden` until a thumb slot has content, and then `[part="field"]` carries `data-thumbs`.
|
|
59286
|
+
* - `tooltip`: One thumb's value in a bubble beside it, under `tooltip`. It carries `data-thumb` on a range, `start`, `middle`, or `end`, and `--slider-at`, where its thumb is as a fraction of the track.
|
|
58600
59287
|
* - `tooltips`: The layer over the track that holds the bubbles, under `tooltip`.
|
|
58601
59288
|
*
|
|
58602
59289
|
* ## CSS States
|
|
@@ -58938,9 +59625,15 @@ export type CustomElements = {
|
|
|
58938
59625
|
* Component attributes and properties that can be applied to the element or by using JavaScript.
|
|
58939
59626
|
*
|
|
58940
59627
|
* - `disabled`: Whether the action is disabled, so it cannot be chosen.
|
|
59628
|
+
* - `download`: Whether the link downloads the file when the action is chosen. Only
|
|
59629
|
+
* meaningful beside an `href`, and only for a file served from the page's
|
|
59630
|
+
* origin.
|
|
59631
|
+
* - `href`: The URL the action links to. Setting it draws the action as a link.
|
|
59632
|
+
* - `rel`: The link's `rel`. Set it whenever you set `target="_blank"`.
|
|
58941
59633
|
* - `shortcut`: The action's keyboard shortcut as a chord, such as `mod+s`, carried as
|
|
58942
59634
|
* `aria-keyshortcuts` and drawn after the name. `mod` is Command on an Apple
|
|
58943
59635
|
* keyboard and Control elsewhere. Showing a shortcut does not bind it.
|
|
59636
|
+
* - `target`: Where the link opens, such as `_blank` for a new tab.
|
|
58944
59637
|
* - `value`: The action's value, sent in `helix-select` when the action is chosen.
|
|
58945
59638
|
* - `active`: Whether the action has focus, which makes it the action the keyboard is on.
|
|
58946
59639
|
*
|
|
@@ -59011,7 +59704,7 @@ export type CustomElements = {
|
|
|
59011
59704
|
* Custom selectors for styling elements within the component.
|
|
59012
59705
|
*
|
|
59013
59706
|
* - `icon`: The box that holds the icon.
|
|
59014
|
-
* - `item`: The control for the action.
|
|
59707
|
+
* - `item`: The control for the action, which is an `<a>` where `href` is set.
|
|
59015
59708
|
* - `label`: The action's name, beside the icon.
|
|
59016
59709
|
* - `shortcut`: The box after the name that holds the shortcut, shown while `shortcut` is set or something is in the `shortcut` slot.
|
|
59017
59710
|
*
|
|
@@ -59062,9 +59755,11 @@ export type CustomElements = {
|
|
|
59062
59755
|
* plain element of yours once a reader reaches it, after hydration, unless
|
|
59063
59756
|
* you described or labeled it yourself.
|
|
59064
59757
|
* - `offset`: Space between the trigger and the actions, in pixels.
|
|
59065
|
-
* - `open-on`/`openOn`: What opens the dial. `click` opens it on a press of the trigger.
|
|
59066
|
-
*
|
|
59067
|
-
*
|
|
59758
|
+
* - `open-on`/`openOn`: What opens the dial. `click` opens it on a press of the trigger. `hover`
|
|
59759
|
+
* also opens it while a mouse rests on the trigger, and closes it once the
|
|
59760
|
+
* mouse has left. Under `long-press`, a press is the trigger's own action,
|
|
59761
|
+
* and the dial opens on a press held for half a second, or on Alt+Down or
|
|
59762
|
+
* Alt+Up.
|
|
59068
59763
|
* - `placement`: The direction the actions open in. They move to another side if that side
|
|
59069
59764
|
* does not fit.
|
|
59070
59765
|
*
|
|
@@ -59105,6 +59800,7 @@ export type CustomElements = {
|
|
|
59105
59800
|
* Areas where markup can be added to the component.
|
|
59106
59801
|
*
|
|
59107
59802
|
* - `(default)`: The actions.
|
|
59803
|
+
* - `icon`: Replaces the plus on the button the dial draws when no trigger is slotted, such as with a pencil for a dial of ways to write.
|
|
59108
59804
|
* - `trigger`: The control that opens the actions. Without one, a button named by `label` is drawn.
|
|
59109
59805
|
*
|
|
59110
59806
|
* ## Methods
|
|
@@ -59395,7 +60091,10 @@ export type CustomElements = {
|
|
|
59395
60091
|
* with its rule; and a count is what a set of facts read across wants, where
|
|
59396
60092
|
* figures compared one against another keep their own widths.
|
|
59397
60093
|
* - `divided`: Draws a rule between the figures, in addition to the space.
|
|
59398
|
-
* - `label`: Accessible name for the group.
|
|
60094
|
+
* - `label`: Accessible name for the group, which makes it a group.
|
|
60095
|
+
*
|
|
60096
|
+
* Absent leaves the stats with no group around them, unless `aria-label` or
|
|
60097
|
+
* `aria-labelledby` names it.
|
|
59399
60098
|
* - `whenSettled`: Resolves a frame after the first update, when transitions are switched on.
|
|
59400
60099
|
*
|
|
59401
60100
|
* **Named `whenSettled` because `settled` is taken four times over**, by
|
|
@@ -59423,6 +60122,14 @@ export type CustomElements = {
|
|
|
59423
60122
|
*
|
|
59424
60123
|
* - `(default)`: The stats.
|
|
59425
60124
|
*
|
|
60125
|
+
* ## Methods
|
|
60126
|
+
*
|
|
60127
|
+
* Methods that can be called to access component functionality.
|
|
60128
|
+
*
|
|
60129
|
+
* - `attributeChangedCallback(name: string, old: string | null, value: string | null) => void`: Called by the browser when an observed attribute changes. A name written
|
|
60130
|
+
* or taken off asks for an update, because it decides whether the stats are
|
|
60131
|
+
* a group.
|
|
60132
|
+
*
|
|
59426
60133
|
* ## CSS Custom Properties
|
|
59427
60134
|
*
|
|
59428
60135
|
* CSS variables available for styling the component.
|
|
@@ -59474,6 +60181,20 @@ export type CustomElements = {
|
|
|
59474
60181
|
* reports a hydration mismatch. The absent attribute is the column, which the
|
|
59475
60182
|
* stylesheet reads as the base case, and the server spec asserts the host
|
|
59476
60183
|
* carries nothing nobody wrote.
|
|
60184
|
+
* - `format-options`/`formatOptions`: `Intl.NumberFormat` options `value` is written with, such as
|
|
60185
|
+
* `{"notation":"compact"}` for `1.2M` or `{"style":"percent"}` for `98%`,
|
|
60186
|
+
* written as JSON in the attribute.
|
|
60187
|
+
*
|
|
60188
|
+
* Absent writes the number as the locale writes any number.
|
|
60189
|
+
* - `locale`: The locale `value` is written in, such as `de` for `1.234.567`.
|
|
60190
|
+
*
|
|
60191
|
+
* Absent reads the nearest `lang`, then the runtime's own. Set it on a page
|
|
60192
|
+
* rendered on a server, so the server and the browser write the figure
|
|
60193
|
+
* alike.
|
|
60194
|
+
* - `value`: The figure as a number, written with `format-options` in `locale` in
|
|
60195
|
+
* place of a slotted value.
|
|
60196
|
+
*
|
|
60197
|
+
* Absent leaves the figure to the slot.
|
|
59477
60198
|
* - `whenSettled`: Resolves a frame after the first update, when transitions are switched on.
|
|
59478
60199
|
*
|
|
59479
60200
|
* **Named `whenSettled` because `settled` is taken four times over**, by
|
|
@@ -59521,11 +60242,17 @@ export type CustomElements = {
|
|
|
59521
60242
|
* Custom selectors for styling elements within the component.
|
|
59522
60243
|
*
|
|
59523
60244
|
* - `value`: The slot the value is written in. A slot draws no box, so it takes the inherited properties, such as color and font, and passes them to the value.
|
|
60245
|
+
* - `label`: The slot the label arrives through, drawing no box, as `value` does.
|
|
60246
|
+
* - `trend`: The slot the trend arrives through, drawing no box, as `value` does.
|
|
60247
|
+
* - `unit`: The slot the unit arrives through, drawing no box, as `value` does.
|
|
59524
60248
|
*
|
|
59525
60249
|
* ## CSS States
|
|
59526
60250
|
*
|
|
59527
60251
|
* These can be used to apply styling when a component is in a given state.
|
|
59528
60252
|
*
|
|
60253
|
+
* - `has-label`: Something is slotted into `label`.
|
|
60254
|
+
* - `has-trend`: Something is slotted into `trend`.
|
|
60255
|
+
* - `has-unit`: Something is slotted into `unit`.
|
|
59529
60256
|
* - `settled`: Set one frame after the first render. Transitions wait for it, so an element does not animate its own arrival.
|
|
59530
60257
|
*/
|
|
59531
60258
|
"helix-stat": Partial<HelixStatProps & BaseProps<HelixStat> & BaseEvents<HelixStat>>;
|
|
@@ -59554,6 +60281,14 @@ export type CustomElements = {
|
|
|
59554
60281
|
* - `default-active`/`defaultActive`: The `value` of the item declared current in markup.
|
|
59555
60282
|
*
|
|
59556
60283
|
* Ignored once `active` is written.
|
|
60284
|
+
* - `arrows`: Whether the arrow keys move focus between the stages' names, along the
|
|
60285
|
+
* way the steps run. Off by default, so the arrows keep scrolling the page.
|
|
60286
|
+
* - `completion`: What marks a stage `complete`.
|
|
60287
|
+
*
|
|
60288
|
+
* Absent, you do: each step's `complete` is yours, because a reader who
|
|
60289
|
+
* steps back has finished more stages than the one they are on. `passed`
|
|
60290
|
+
* marks every stage before the one a reader moves to, and leaves the marks
|
|
60291
|
+
* when they go back.
|
|
59557
60292
|
* - `label`: The sequence's name, read by screen readers.
|
|
59558
60293
|
*
|
|
59559
60294
|
* A list of stages is a landmark a reader arrives at out of order, so it
|
|
@@ -59641,6 +60376,10 @@ export type CustomElements = {
|
|
|
59641
60376
|
* does. Returns whether it moved: not past the last stage, not into a stage
|
|
59642
60377
|
* `linear` holds out of reach, and not where a listener refused.
|
|
59643
60378
|
* - `previous() => boolean`: Moves to the stage before, as Ark UI's `goToPrevStep` does. Returns whether it moved.
|
|
60379
|
+
* - `reset() => boolean`: Goes back to the first stage that can be gone to, and clears `complete`
|
|
60380
|
+
* and the invalid mark from every stage, as Ark UI's `resetStep` does.
|
|
60381
|
+
* Returns whether it moved: a listener can refuse the move with
|
|
60382
|
+
* `helix-before-activate`, and the stages then keep their marks.
|
|
59644
60383
|
*
|
|
59645
60384
|
* ## CSS Custom Properties
|
|
59646
60385
|
*
|
|
@@ -59738,6 +60477,8 @@ export type CustomElements = {
|
|
|
59738
60477
|
*
|
|
59739
60478
|
* Methods that can be called to access component functionality.
|
|
59740
60479
|
*
|
|
60480
|
+
* - `focus(options?: FocusOptions) => void`: Puts focus on the step's name, the control a reader presses, as a
|
|
60481
|
+
* `focus()` on a native control would.
|
|
59741
60482
|
* - `select() => void`: Fires `helix-select` for the step, unless the step is `disabled` or a
|
|
59742
60483
|
* linear sequence has it out of reach.
|
|
59743
60484
|
*
|
|
@@ -59763,6 +60504,7 @@ export type CustomElements = {
|
|
|
59763
60504
|
* These can be used to apply styling when a component is in a given state.
|
|
59764
60505
|
*
|
|
59765
60506
|
* - `invalid`: The sequence's `validate` last answered that this stage is not valid.
|
|
60507
|
+
* - `locked`: A `linear` sequence holds this stage out of reach until the stages before it are finished.
|
|
59766
60508
|
* - `settled`: Set one frame after the first render. Transitions wait for it, so an element does not animate its own arrival.
|
|
59767
60509
|
*/
|
|
59768
60510
|
"helix-step": Partial<HelixStepProps & BaseProps<HelixStep> & BaseEvents<HelixStep>>;
|
|
@@ -60673,6 +61415,8 @@ export type CustomElements = {
|
|
|
60673
61415
|
* panels and tells a screen reader the list is vertical.
|
|
60674
61416
|
*
|
|
60675
61417
|
* Optional, so the resting row writes no attribute onto the host.
|
|
61418
|
+
* - `scroll-controls`/`scrollControls`: Whether a strip with more tabs than fit shows a button at each end it can
|
|
61419
|
+
* scroll toward.
|
|
60676
61420
|
* - `variant`: How the row of tabs is drawn.
|
|
60677
61421
|
*
|
|
60678
61422
|
* Unset is a raised pill on the selected tab with nothing behind the row,
|
|
@@ -60755,6 +61499,7 @@ export type CustomElements = {
|
|
|
60755
61499
|
* - `--tabs-indicator-shadow`: The shadow under the mark, which the pill and `segmented` draw.
|
|
60756
61500
|
* - `--tabs-indicator-thickness`: The height of the bar under `underlined`.
|
|
60757
61501
|
* - `--tabs-rule-color`: The color of the rule under the row in `underlined`.
|
|
61502
|
+
* - `--tabs-scroll-background-color`: The fill behind the scroll buttons, over the tabs that pass under them.
|
|
60758
61503
|
*
|
|
60759
61504
|
* ## CSS Parts
|
|
60760
61505
|
*
|
|
@@ -60762,6 +61507,8 @@ export type CustomElements = {
|
|
|
60762
61507
|
*
|
|
60763
61508
|
* - `indicator`: The mark that moves to the selected tab. It carries the selected tab's place and size as `--indicator-x`, `--indicator-y`, `--indicator-inline-size` and `--indicator-block-size`.
|
|
60764
61509
|
* - `panels`: The panel container.
|
|
61510
|
+
* - `scroll-end`: The button that scrolls the strip toward its end, shown under `scroll-controls` while there is more that way. It holds to the end of the strip.
|
|
61511
|
+
* - `scroll-start`: The button that scrolls the strip toward its start, shown under `scroll-controls` while there is more that way. It holds to the start of the strip.
|
|
60765
61512
|
* - `tabs`: The tab list.
|
|
60766
61513
|
*
|
|
60767
61514
|
* ## CSS States
|
|
@@ -60782,6 +61529,17 @@ export type CustomElements = {
|
|
|
60782
61529
|
*
|
|
60783
61530
|
* Component attributes and properties that can be applied to the element or by using JavaScript.
|
|
60784
61531
|
*
|
|
61532
|
+
* - `dismissible`: Whether the element shows a control that dismisses it.
|
|
61533
|
+
* - `dismiss-label`/`dismissLabel`: The dismiss control's label, read by screen readers.
|
|
61534
|
+
*
|
|
61535
|
+
* `attribute` is spelled out because Lit lowercases a property name to
|
|
61536
|
+
* derive one rather than dash-casing it, so this would otherwise be
|
|
61537
|
+
* reachable only as `dismisslabel`, which nobody would guess and no linter
|
|
61538
|
+
* would catch.
|
|
61539
|
+
*
|
|
61540
|
+
* A word property: register it for a locale under the host's key. A family
|
|
61541
|
+
* that names the control otherwise, such as Tag's `Remove {label}`,
|
|
61542
|
+
* declares its own English with `@words` above the override.
|
|
60785
61543
|
* - `disabled`: Whether the item is disabled and cannot be chosen.
|
|
60786
61544
|
* - `selected`: Whether the item is selected.
|
|
60787
61545
|
*
|
|
@@ -60819,6 +61577,7 @@ export type CustomElements = {
|
|
|
60819
61577
|
*
|
|
60820
61578
|
* Events that will be emitted by the component.
|
|
60821
61579
|
*
|
|
61580
|
+
* - `helix-dismiss`: A `dismissible` tab was asked to close. The tab does not remove itself, so remove it and its panel in response. Cancelable.
|
|
60822
61581
|
* - `helix-select`: Fired when the tab is chosen. Cancelable: canceling it stops the change and leaves the decision to you.
|
|
60823
61582
|
*
|
|
60824
61583
|
* ## Slots
|
|
@@ -60831,6 +61590,7 @@ export type CustomElements = {
|
|
|
60831
61590
|
*
|
|
60832
61591
|
* Methods that can be called to access component functionality.
|
|
60833
61592
|
*
|
|
61593
|
+
* - `dismiss() => boolean`: Fires `helix-dismiss`, and returns `false` if a listener cancels it.
|
|
60834
61594
|
* - `focusItem() => void`: Moves focus to the item's control, for the set's arrow keys.
|
|
60835
61595
|
*
|
|
60836
61596
|
* The set drives the keys and cannot reach the control itself, which is
|
|
@@ -60848,6 +61608,7 @@ export type CustomElements = {
|
|
|
60848
61608
|
* - `--tabs-tab-block-size`: The height of a tab. `segmented` sizes its tabs to the track and does not read it.
|
|
60849
61609
|
* - `--tabs-tab-color`: The label color of a tab that is not current.
|
|
60850
61610
|
* - `--tabs-tab-disabled-opacity`: How faint a disabled tab is drawn.
|
|
61611
|
+
* - `--tabs-tab-dismiss-color`: The color of the mark that closes a `dismissible` tab.
|
|
60851
61612
|
* - `--tabs-tab-font-size`: The size of a tab's label.
|
|
60852
61613
|
* - `--tabs-tab-font-weight`: The weight of a tab's label.
|
|
60853
61614
|
* - `--tabs-tab-hover-background-color`: The wash under the pointer.
|
|
@@ -60861,6 +61622,7 @@ export type CustomElements = {
|
|
|
60861
61622
|
*
|
|
60862
61623
|
* Custom selectors for styling elements within the component.
|
|
60863
61624
|
*
|
|
61625
|
+
* - `dismiss`: The mark a pointer presses to close a `dismissible` tab.
|
|
60864
61626
|
* - `tab`: The tab itself.
|
|
60865
61627
|
*
|
|
60866
61628
|
* ## CSS States
|
|
@@ -60881,10 +61643,19 @@ export type CustomElements = {
|
|
|
60881
61643
|
*
|
|
60882
61644
|
* Component attributes and properties that can be applied to the element or by using JavaScript.
|
|
60883
61645
|
*
|
|
61646
|
+
* - `disallow-empty-selection`/`disallowEmptySelection`: Keeps at least one tag selected once one is, as React Aria's
|
|
61647
|
+
* `disallowEmptySelection`: a press or a key that would leave none selected
|
|
61648
|
+
* is refused. Removing the last selected tag still takes it out of `value`.
|
|
60884
61649
|
* - `empty-label`/`emptyLabel`: The words the group shows and says once its last tag is removed, where
|
|
60885
61650
|
* nothing is in the `empty` slot.
|
|
60886
61651
|
* - `label`: The name of the set, such as "Filters", which a screen reader announces
|
|
60887
61652
|
* before its tags.
|
|
61653
|
+
* - `selection-behavior`/`selectionBehavior`: What a press, Space, or a move does to the tags already selected.
|
|
61654
|
+
* `toggle`, the default, keeps them: a press adds or takes out the tag, and
|
|
61655
|
+
* the arrow keys move focus alone. `replace` selects the tag alone, as a
|
|
61656
|
+
* file list does, and the arrow keys carry the selection with focus.
|
|
61657
|
+
* Control or Command with a press or Space adds or takes out one tag in
|
|
61658
|
+
* `multiple`, and with an arrow moves focus without selecting.
|
|
60888
61659
|
* - `selection-mode`/`selectionMode`: How many tags a reader can select: `single`, `multiple`, or none.
|
|
60889
61660
|
*
|
|
60890
61661
|
* Absent selects nothing, and the tags carry no selected state at all.
|
|
@@ -60956,6 +61727,11 @@ export type CustomElements = {
|
|
|
60956
61727
|
* Seven tones. The fill is a tint of the status color made with `color-mix`, so
|
|
60957
61728
|
* when a theme changes its status colors, the tints change with them.
|
|
60958
61729
|
*
|
|
61730
|
+
* A tag takes its height from the region it is in, as the controls beside it
|
|
61731
|
+
* do: `data-density="sm"`, `md`, or `lg` on the tag or on any element around
|
|
61732
|
+
* it sets `--helix-size-tag` to the small, resting, or large step, so a row of
|
|
61733
|
+
* tags and buttons stays one height. `shape="pill"` rounds its ends.
|
|
61734
|
+
*
|
|
60959
61735
|
* ## Attributes & Properties
|
|
60960
61736
|
*
|
|
60961
61737
|
* Component attributes and properties that can be applied to the element or by using JavaScript.
|
|
@@ -63072,6 +63848,8 @@ export type CustomElements = {
|
|
|
63072
63848
|
* Areas where markup can be added to the component.
|
|
63073
63849
|
*
|
|
63074
63850
|
* - `(default)`: The item's label.
|
|
63851
|
+
* - `end`: Content after the label, such as a count or a shortcut.
|
|
63852
|
+
* - `start`: Content before the label, such as an icon.
|
|
63075
63853
|
*
|
|
63076
63854
|
* ## Methods
|
|
63077
63855
|
*
|
|
@@ -63973,6 +64751,11 @@ export type CustomElements = {
|
|
|
63973
64751
|
*
|
|
63974
64752
|
* An `aria-label` or `aria-labelledby` on the host names the tree too, and
|
|
63975
64753
|
* wins over this.
|
|
64754
|
+
* - `moved-into-label`/`movedIntoLabel`: What screen readers hear when an item moves into another branch, in a
|
|
64755
|
+
* `reorderable` tree. `{name}` is the item's words, `{parent}` the words of
|
|
64756
|
+
* the branch it moved into, or the tree's `label` for the top level,
|
|
64757
|
+
* `{position}` its place there, counting from 1, and `{count}` the number of
|
|
64758
|
+
* items there.
|
|
63976
64759
|
* - `moved-label`/`movedLabel`: What screen readers hear each time an item moves, in a `reorderable`
|
|
63977
64760
|
* tree. `{name}` is the item's words, `{position}` its place among its
|
|
63978
64761
|
* siblings, counting from 1, and `{count}` the number of siblings.
|
|
@@ -65294,6 +66077,7 @@ export type CustomElementsSolidJs = {
|
|
|
65294
66077
|
*
|
|
65295
66078
|
* These can be used to apply styling when a component is in a given state.
|
|
65296
66079
|
*
|
|
66080
|
+
* - `closing`: While the item has closed and its content is still drawn, until the content part's animations end.
|
|
65297
66081
|
* - `open`: While the item is open.
|
|
65298
66082
|
* - `settled`: Set one frame after the first render. Transitions wait for it, so an element does not animate its own arrival.
|
|
65299
66083
|
*/
|
|
@@ -66541,6 +67325,7 @@ export type CustomElementsSolidJs = {
|
|
|
66541
67325
|
* Areas where markup can be added to the component.
|
|
66542
67326
|
*
|
|
66543
67327
|
* - `(default)`: The element being decorated.
|
|
67328
|
+
* - `icon`: An icon inside the mark, before the count, or the whole mark when there is no value. Hidden from screen readers.
|
|
66544
67329
|
*
|
|
66545
67330
|
* ## CSS Custom Properties
|
|
66546
67331
|
*
|
|
@@ -66551,6 +67336,7 @@ export type CustomElementsSolidJs = {
|
|
|
66551
67336
|
* - `--badge-color`: The color of the count, to pair with a fill set through `--badge-background-color`.
|
|
66552
67337
|
* - `--badge-font-weight`: The weight of the count.
|
|
66553
67338
|
* - `--badge-gap`: The space between the content and the count under `placement="inline"`.
|
|
67339
|
+
* - `--badge-icon-size`: The size of an icon in the `icon` slot. The count's own size by default.
|
|
66554
67340
|
* - `--badge-offset`: Pulls the mark in from the corner, along both axes.
|
|
66555
67341
|
* - `--badge-radius`: How far the indicator's corners are rounded.
|
|
66556
67342
|
* - `--badge-ring-color`: The color of the ring between the indicator and what is behind it.
|
|
@@ -66559,7 +67345,8 @@ export type CustomElementsSolidJs = {
|
|
|
66559
67345
|
*
|
|
66560
67346
|
* Custom selectors for styling elements within the component.
|
|
66561
67347
|
*
|
|
66562
|
-
* - `
|
|
67348
|
+
* - `icon`: The slot the icon arrives through, inside the indicator. A slot draws no box, so it passes inherited properties, such as color, to the icon.
|
|
67349
|
+
* - `indicator`: The count, or the dot when there is no value. Carries `data-dot` when there is no value, `data-single` when the count is one character, and `data-blank` when the value is zero.
|
|
66563
67350
|
*
|
|
66564
67351
|
* ## CSS States
|
|
66565
67352
|
*
|
|
@@ -66567,7 +67354,8 @@ export type CustomElementsSolidJs = {
|
|
|
66567
67354
|
*
|
|
66568
67355
|
* - `blank`: The value is zero, so there is no mark.
|
|
66569
67356
|
* - `capped`: The count is past `max`, so the mark shows `{max}+`.
|
|
66570
|
-
* - `dot`: There is no value, so the mark is a dot.
|
|
67357
|
+
* - `dot`: There is no value and no icon, so the mark is a dot.
|
|
67358
|
+
* - `has-icon`: Something is slotted into `icon`, so it is drawn inside the mark.
|
|
66571
67359
|
* - `settled`: Set one frame after the first render. Transitions wait for it, so an element does not animate its own arrival.
|
|
66572
67360
|
*/
|
|
66573
67361
|
"helix-badge": Partial<
|
|
@@ -67193,6 +67981,12 @@ export type CustomElementsSolidJs = {
|
|
|
67193
67981
|
* browser harness's awaits it alone: a browser always runs the frame, and a
|
|
67194
67982
|
* timer beside it was a bet on how long one takes, which a busy run lost. (property only) (readonly)
|
|
67195
67983
|
*
|
|
67984
|
+
* ## Events
|
|
67985
|
+
*
|
|
67986
|
+
* Events that will be emitted by the component.
|
|
67987
|
+
*
|
|
67988
|
+
* - `helix-select`: A plain press on the crumb's link, with its `href` as the value, before the browser follows it. Cancelable: cancel it to keep the browser from following, as a client-side router does.
|
|
67989
|
+
*
|
|
67196
67990
|
* ## Slots
|
|
67197
67991
|
*
|
|
67198
67992
|
* Areas where markup can be added to the component.
|
|
@@ -67220,6 +68014,8 @@ export type CustomElementsSolidJs = {
|
|
|
67220
68014
|
* Custom selectors for styling elements within the component.
|
|
67221
68015
|
*
|
|
67222
68016
|
* - `separator`: The separator preceding the item.
|
|
68017
|
+
* - `expand`: The button after the first crumb of a folded slotted trail, which shows the folded crumbs.
|
|
68018
|
+
* - `fold-separator`: The chevron before that button.
|
|
67223
68019
|
* - `link`: The crumb itself, which is an `<a>` where `href` is set.
|
|
67224
68020
|
* - `separator-mark`: The chevron between crumbs, shown when no separator is slotted.
|
|
67225
68021
|
*
|
|
@@ -67227,7 +68023,9 @@ export type CustomElementsSolidJs = {
|
|
|
67227
68023
|
*
|
|
67228
68024
|
* These can be used to apply styling when a component is in a given state.
|
|
67229
68025
|
*
|
|
68026
|
+
* - `current`: While the crumb is the current page, marked `current` or the last of a trail with none marked.
|
|
67230
68027
|
* - `end`: While the `end` slot holds something, so a stylesheet can join the label and what follows it into one control.
|
|
68028
|
+
* - `folded`: While a trail longer than its `max-items` has folded the crumb away. It takes no room.
|
|
67231
68029
|
* - `settled`: Set one frame after the first render. Transitions wait for it, so an element does not animate its own arrival.
|
|
67232
68030
|
*/
|
|
67233
68031
|
"helix-breadcrumb": Partial<
|
|
@@ -67314,6 +68112,8 @@ export type CustomElementsSolidJs = {
|
|
|
67314
68112
|
* - `crumb`: Each crumb drawn from `items`.
|
|
67315
68113
|
* - `crumb-collapsed`: The crumb that holds the folded middle of a trail longer than `max-items`.
|
|
67316
68114
|
* - `crumb-current`: The crumb drawn from `items` for the current page.
|
|
68115
|
+
* - `crumb-expand`: The fold button a crumb draws after the first crumb of a folded slotted trail. A trail drawn from `items` draws its fold as a crumb of its own, `crumb-collapsed`, so this one is never drawn there.
|
|
68116
|
+
* - `crumb-fold-separator`: The chevron before that button.
|
|
67317
68117
|
* - `crumb-link`: The link, or the current page's words, of a crumb drawn from `items`.
|
|
67318
68118
|
* - `crumb-separator`: The separator before a crumb drawn from `items`.
|
|
67319
68119
|
* - `crumb-separator-mark`: The chevron before a crumb drawn from `items`.
|
|
@@ -67445,6 +68245,7 @@ export type CustomElementsSolidJs = {
|
|
|
67445
68245
|
*
|
|
67446
68246
|
* These can be used to apply styling when a component is in a given state.
|
|
67447
68247
|
*
|
|
68248
|
+
* - `pressed`: While a group with `selection-mode` has a button pressed.
|
|
67448
68249
|
* - `settled`: Set one frame after the first render. Transitions wait for it, so an element does not animate its own arrival.
|
|
67449
68250
|
*/
|
|
67450
68251
|
"helix-button-group": Partial<
|
|
@@ -68638,8 +69439,6 @@ export type CustomElementsSolidJs = {
|
|
|
68638
69439
|
*
|
|
68639
69440
|
* Reflected and undefaulted, so a card that has not asked reads as a card
|
|
68640
69441
|
* with no attribute on it and the stylesheet only describes the departure.
|
|
68641
|
-
* - `aria-labelledby`/`undefined`: undefined
|
|
68642
|
-
* - `aria-label`/`undefined`: undefined
|
|
68643
69442
|
* - `whenSettled`: Resolves a frame after the first update, when transitions are switched on.
|
|
68644
69443
|
*
|
|
68645
69444
|
* **Named `whenSettled` because `settled` is taken four times over**, by
|
|
@@ -68672,6 +69471,14 @@ export type CustomElementsSolidJs = {
|
|
|
68672
69471
|
* - `header-actions`: Controls for the whole card at the end of the header's line, such as a menu.
|
|
68673
69472
|
* - `media`: Image, video, or chart that runs edge to edge, outside the inset.
|
|
68674
69473
|
*
|
|
69474
|
+
* ## Methods
|
|
69475
|
+
*
|
|
69476
|
+
* Methods that can be called to access component functionality.
|
|
69477
|
+
*
|
|
69478
|
+
* - `attributeChangedCallback(name: string, old: string | null, value: string | null) => void`: Called by the browser when an observed attribute changes. A name written
|
|
69479
|
+
* or taken off asks for an update, because it decides whether the card is a
|
|
69480
|
+
* group and whether its heading names it.
|
|
69481
|
+
*
|
|
68675
69482
|
* ## CSS Custom Properties
|
|
68676
69483
|
*
|
|
68677
69484
|
* CSS variables available for styling the component.
|
|
@@ -70104,6 +70911,12 @@ export type CustomElementsSolidJs = {
|
|
|
70104
70911
|
* significant in code and a wrapped line reads as two. For prose-like code, such as a long command or
|
|
70105
70912
|
* a log line, a wrap reads better than a scroll. Line numbers keep the lines
|
|
70106
70913
|
* unwrapped, since a wrapped line would take one number and several rows.
|
|
70914
|
+
* - `code-label`/`codeLabel`: The name of a block that scrolls, which is a tab stop while it does.
|
|
70915
|
+
*
|
|
70916
|
+
* Where the block has a name, the scroller says it too, such as "Code,
|
|
70917
|
+
* app.ts", as `code-name-label` puts it.
|
|
70918
|
+
* - `code-name-label`/`codeNameLabel`: The name of a block that scrolls, where the block has a name. `{code}` is
|
|
70919
|
+
* `code-label` and `{name}` the block's name.
|
|
70107
70920
|
* - `collapse-label`/`collapseLabel`: The expand button's words while the block shows every line.
|
|
70108
70921
|
* - `copied-label`/`copiedLabel`: The copy button's name and tooltip text after a copy.
|
|
70109
70922
|
* - `copy-label`/`copyLabel`: The copy button's name and tooltip text before a copy.
|
|
@@ -70427,7 +71240,8 @@ export type CustomElementsSolidJs = {
|
|
|
70427
71240
|
* Passed to the panel, whose square, hue ramp and presets say the color's
|
|
70428
71241
|
* name, and read by the swatch in `swatch`, which says it before the value.
|
|
70429
71242
|
* Color Picker lists the keys.
|
|
70430
|
-
* - `format`: The syntax the value is written in: `hex`, `rgb`,
|
|
71243
|
+
* - `format`: The syntax the value is written in: `hex`, `rgb`, `hsl`, `oklch`, or
|
|
71244
|
+
* `hsb`, as Color Picker's `format`.
|
|
70431
71245
|
*
|
|
70432
71246
|
* **Undefaulted, because it reflects.** The two together stamp an attribute
|
|
70433
71247
|
* onto every host anybody renders, including the ones nobody configured: the
|
|
@@ -70644,6 +71458,8 @@ export type CustomElementsSolidJs = {
|
|
|
70644
71458
|
* - `picker-channel-marker-label`: The value a mark stands at, when `marker-labels` is set.
|
|
70645
71459
|
* - `picker-channel-markers`: The row of marks along the track.
|
|
70646
71460
|
* - `picker-channel-output`: The current value, shown beside the track.
|
|
71461
|
+
* - `picker-channel-thumb`: A ramp's thumb box, which holds no content in a picker.
|
|
71462
|
+
* - `picker-channel-thumbs`: The layer over a ramp's track that holds its thumb box.
|
|
70647
71463
|
* - `picker-channel-tooltip`: A ramp's value in a bubble, where a ramp shows one.
|
|
70648
71464
|
* - `picker-channel-tooltips`: The layer over a ramp's track that holds its bubble.
|
|
70649
71465
|
* - `picker-channels`: The channel sliders beside the sample.
|
|
@@ -70668,7 +71484,9 @@ export type CustomElementsSolidJs = {
|
|
|
70668
71484
|
* - `picker-grid-brightness`: The range input for the square's vertical axis.
|
|
70669
71485
|
* - `picker-grid-handle`: The mark showing where in the square the color sits.
|
|
70670
71486
|
* - `picker-grid-saturation`: The range input for the square's horizontal axis.
|
|
71487
|
+
* - `picker-hint`: The picker's own help, which the field's `hint` stands in for here, so it stays hidden.
|
|
70671
71488
|
* - `picker-icon`: An icon drawn by the picker.
|
|
71489
|
+
* - `picker-label`: The picker's own name, which the field's `label` stands in for here, so it stays hidden.
|
|
70672
71490
|
* - `picker-sample`: A chip of the current color. Pressing it copies the value.
|
|
70673
71491
|
* - `picker-swatch`: One preset.
|
|
70674
71492
|
* - `picker-swatches`: The row of presets.
|
|
@@ -70758,12 +71576,15 @@ export type CustomElementsSolidJs = {
|
|
|
70758
71576
|
* language hears its own rather than English between its own labels.
|
|
70759
71577
|
* - `channel-fields`/`channelFields`: Whether the picker shows a number field for each channel of the color, as
|
|
70760
71578
|
* React Aria's ColorField does with `channel`: red, green and blue for hex
|
|
70761
|
-
* and rgb, hue, saturation and lightness for hsl,
|
|
70762
|
-
*
|
|
71579
|
+
* and rgb, hue, saturation and lightness for hsl, hue, saturation and
|
|
71580
|
+
* brightness for hsb, lightness, chroma and hue for oklch, and the opacity
|
|
71581
|
+
* with `alpha`.
|
|
70763
71582
|
*
|
|
70764
71583
|
* For a reader who has the numbers from a brand guide, and for a keyboard,
|
|
70765
71584
|
* where typing 128 is quicker than holding an arrow key. The fields follow
|
|
70766
71585
|
* the syntax the format toggle sets.
|
|
71586
|
+
* - `chroma-label`/`chromaLabel`: What the chroma channel's field is called, in `channel-fields` with
|
|
71587
|
+
* oklch.
|
|
70767
71588
|
* - `color-words`/`colorWords`: The words a color's name is spoken in, as JSON keyed by their English,
|
|
70768
71589
|
* such as `{"red": "rot", "vibrant": "kräftiges"}`.
|
|
70769
71590
|
*
|
|
@@ -70780,15 +71601,25 @@ export type CustomElementsSolidJs = {
|
|
|
70780
71601
|
* - `copy-label`/`copyLabel`: The name of the sample, which copies the value. `{value}` is replaced with
|
|
70781
71602
|
* the color.
|
|
70782
71603
|
* - `eyedropper-label`/`eyedropperLabel`: What the eyedropper is called.
|
|
70783
|
-
* - `format`: The syntax the value is written in: `hex`, `rgb`,
|
|
71604
|
+
* - `format`: The syntax the value is written in: `hex`, `rgb`, `hsl`, `oklch`, or
|
|
71605
|
+
* `hsb`.
|
|
70784
71606
|
*
|
|
70785
71607
|
* Only what is written. Everything is read whatever this says, so a picker on
|
|
70786
|
-
* `hex` still takes an `rgb()` handed to it and stores the
|
|
71608
|
+
* `hex` still takes an `rgb()` or an `oklch()` handed to it and stores the
|
|
71609
|
+
* hex for it. `oklch` writes the sRGB color the picker holds, such as
|
|
71610
|
+
* `oklch(62.8% 0.258 29.2)`; a color outside sRGB that is handed in is
|
|
71611
|
+
* clipped to it. `hsb` writes the picker's own model, `hsb(0, 100%, 100%)`,
|
|
71612
|
+
* as React Aria's and Zag's color strings do. It is not CSS, so the toggle
|
|
71613
|
+
* walks the other four.
|
|
70787
71614
|
* - `format-label`/`formatLabel`: What the syntax toggle is called, with `{format}` filled in.
|
|
70788
71615
|
* - `green-label`/`greenLabel`: What the green channel's field is called, in `channel-fields`.
|
|
71616
|
+
* - `hint`: Help under the picker, such as what the color is used for. The `hint`
|
|
71617
|
+
* slot takes richer content.
|
|
70789
71618
|
* - `hue-label`/`hueLabel`: What the hue channel is called.
|
|
71619
|
+
* - `label`: The name above the picker, such as "Brand color". The picker is then a
|
|
71620
|
+
* group with this name. The `label` slot takes richer content.
|
|
70790
71621
|
* - `lightness-label`/`lightnessLabel`: What the lightness channel's field is called, in `channel-fields` with
|
|
70791
|
-
* hsl.
|
|
71622
|
+
* hsl and oklch.
|
|
70792
71623
|
* - `no-eyedropper`/`noEyedropper`: Hides the eyedropper. Without it, the eyedropper appears in browsers that
|
|
70793
71624
|
* support one.
|
|
70794
71625
|
* - `no-format`/`noFormat`: Hides the syntax toggle, so the format cannot be changed.
|
|
@@ -70943,6 +71774,8 @@ export type CustomElementsSolidJs = {
|
|
|
70943
71774
|
* Areas where markup can be added to the component.
|
|
70944
71775
|
*
|
|
70945
71776
|
* - `eyedropper-icon`: The icon on the eyedropper button, usually a dropper.
|
|
71777
|
+
* - `hint`: Help under the picker, for content richer than the `hint` text.
|
|
71778
|
+
* - `label`: The name above the picker, for content richer than the `label` text.
|
|
70946
71779
|
*
|
|
70947
71780
|
* ## Methods
|
|
70948
71781
|
*
|
|
@@ -71041,6 +71874,8 @@ export type CustomElementsSolidJs = {
|
|
|
71041
71874
|
* - `channel-marker-label`: The value a mark stands at, when `marker-labels` is set.
|
|
71042
71875
|
* - `channel-markers`: The row of marks along the track.
|
|
71043
71876
|
* - `channel-output`: The current value, shown beside the track.
|
|
71877
|
+
* - `channel-thumb`: A ramp's thumb box, which holds no content in a picker.
|
|
71878
|
+
* - `channel-thumbs`: The layer over a ramp's track that holds its thumb box.
|
|
71044
71879
|
* - `channel-tooltip`: A ramp's value in a bubble, where a ramp shows one.
|
|
71045
71880
|
* - `channel-tooltips`: The layer over a ramp's track that holds its bubble.
|
|
71046
71881
|
* - `channels`: The ramps beside the sample.
|
|
@@ -71064,6 +71899,8 @@ export type CustomElementsSolidJs = {
|
|
|
71064
71899
|
* - `grid`: The saturation and brightness square. Draw the mark that shows where the color sits with `::part(grid)::after` in your stylesheet. The square carries the two channels as `--color-picker-saturation` and `--color-picker-brightness`, and this tier ships no CSS.
|
|
71065
71900
|
* - `grid-brightness`: The range input for the square's vertical axis.
|
|
71066
71901
|
* - `grid-saturation`: The range input for the square's horizontal axis.
|
|
71902
|
+
* - `hint`: The help under the picker, while `hint` is set or the `hint` slot has content.
|
|
71903
|
+
* - `label`: The name above the picker, while `label` is set or the `label` slot has content.
|
|
71067
71904
|
* - `sample`: A chip of the current color. Pressing it copies the value.
|
|
71068
71905
|
* - `swatch`: One preset, an option in the `swatches` listbox.
|
|
71069
71906
|
* - `swatches`: The row of presets, a listbox.
|
|
@@ -71075,7 +71912,10 @@ export type CustomElementsSolidJs = {
|
|
|
71075
71912
|
*
|
|
71076
71913
|
* These can be used to apply styling when a component is in a given state.
|
|
71077
71914
|
*
|
|
71915
|
+
* - `copied`: The moment after the sample copies the value, while it says `copied-label`.
|
|
71916
|
+
* - `dragging`: While a pointer drags the square's handle.
|
|
71078
71917
|
* - `invalid`: While `invalid` is set or `feedback` says what is wrong.
|
|
71918
|
+
* - `sampling`: While the eyedropper is open over the screen.
|
|
71079
71919
|
* - `settled`: Set one frame after the first render. Transitions wait for it, so an element does not animate its own arrival.
|
|
71080
71920
|
*/
|
|
71081
71921
|
"helix-color-picker": Partial<
|
|
@@ -72672,6 +73512,7 @@ export type CustomElementsSolidJs = {
|
|
|
72672
73512
|
* - `picker-day-outside`: A day from a neighboring month. Applied with `picker-day`.
|
|
72673
73513
|
* - `picker-day-selected`: The chosen day, or either end of a chosen range. Applied with `picker-day`.
|
|
72674
73514
|
* - `picker-day-today`: Today. Applied with `picker-day`.
|
|
73515
|
+
* - `picker-day-weekend`: A day of the weekend where the calendar's language is spoken, beside `picker-day`.
|
|
72675
73516
|
* - `picker-feedback`: The calendar's own message, under it, while the calendar's `feedback` is set.
|
|
72676
73517
|
* - `picker-grid`: The grid of days.
|
|
72677
73518
|
* - `picker-header`: The month name and its controls.
|
|
@@ -72760,15 +73601,22 @@ export type CustomElementsSolidJs = {
|
|
|
72760
73601
|
* speaks it. Unset is the sentence registered for the page's language, then
|
|
72761
73602
|
* the English. `{mode}` is `single`, `range` or `multiple`, so each can have
|
|
72762
73603
|
* its own sentence.
|
|
72763
|
-
* - `calendar`: The calendar the heading, the days, and the months are written in
|
|
72764
|
-
*
|
|
72765
|
-
*
|
|
72766
|
-
*
|
|
72767
|
-
*
|
|
72768
|
-
* `
|
|
72769
|
-
*
|
|
72770
|
-
*
|
|
72771
|
-
*
|
|
73604
|
+
* - `calendar`: The calendar the heading, the days, and the months are written in.
|
|
73605
|
+
*
|
|
73606
|
+
* `gregory`, `buddhist`, `japanese`, `roc`, and `iso8601` are the five
|
|
73607
|
+
* whose months are the Gregorian months. Absent is the locale's own where
|
|
73608
|
+
* it is one of the five, such as `buddhist` for `th-TH` or `japanese` for
|
|
73609
|
+
* `ja-JP-u-ca-japanese`, and `gregory` for every other, such as `persian`
|
|
73610
|
+
* for `fa-IR`.
|
|
73611
|
+
*
|
|
73612
|
+
* `persian`, `hebrew`, `islamic-umalqura`, `islamic-civil`, `ethiopic`,
|
|
73613
|
+
* `coptic`, and `indian` draw a calendar with months of its own, as React
|
|
73614
|
+
* Aria's calendars do: each grid is one of that calendar's months, the
|
|
73615
|
+
* Hebrew leap month and Ethiopia's five-day thirteenth month included, and
|
|
73616
|
+
* Previous, Next and the page keys move by those months. `month` and
|
|
73617
|
+
* `helix-navigate` then name a month by its first day, `YYYY-MM-DD`. The
|
|
73618
|
+
* heading stays text, as the months and years views are drawn in Gregorian
|
|
73619
|
+
* months only. The value is `YYYY-MM-DD` in every calendar.
|
|
72772
73620
|
* - `default-month`/`defaultMonth`: The month to open on when `month` is not set.
|
|
72773
73621
|
* - `disable-dates`/`disableDates`: Dates that cannot be chosen, as `YYYY-MM-DD`, separated by commas or
|
|
72774
73622
|
* spaces.
|
|
@@ -72794,8 +73642,9 @@ export type CustomElementsSolidJs = {
|
|
|
72794
73642
|
* its days.
|
|
72795
73643
|
* - `min`: Earliest selectable date, as `YYYY-MM-DD`.
|
|
72796
73644
|
* - `mode`: How many dates can be held at once.
|
|
72797
|
-
* - `month`: The month shown, as `YYYY-MM
|
|
72798
|
-
*
|
|
73645
|
+
* - `month`: The month shown, as `YYYY-MM`, or as its first day, `YYYY-MM-DD`, under a
|
|
73646
|
+
* `calendar` with months of its own. When it is not set, it follows
|
|
73647
|
+
* `value`, then the current month.
|
|
72799
73648
|
*
|
|
72800
73649
|
* Separate from `value` on purpose, so paging selects nothing and a consumer
|
|
72801
73650
|
* can drive the view. Reading gives the month on show; writing sets it, and
|
|
@@ -72842,6 +73691,13 @@ export type CustomElementsSolidJs = {
|
|
|
72842
73691
|
* treated as one rather than as an error: a step of zero would block every
|
|
72843
73692
|
* date including the one already chosen.
|
|
72844
73693
|
* - `step-mismatch-message`/`stepMismatchMessage`: The validation message for a date that `step` skips.
|
|
73694
|
+
* - `time-zone`/`timeZone`: The time zone today is read in, such as `America/New_York`, as React
|
|
73695
|
+
* Aria's `today(timeZone)` reads it. Empty is the reader's own.
|
|
73696
|
+
*
|
|
73697
|
+
* Dates are plain `YYYY-MM-DD` and carry no zone, so this moves only today:
|
|
73698
|
+
* the day marked `aria-current` and `day-today`, and the month a picker
|
|
73699
|
+
* with no value opens on. A desk in Tokyo booking for an office in New York
|
|
73700
|
+
* sets `America/New_York`, and today is the office's.
|
|
72845
73701
|
* - `unavailable-message`/`unavailableMessage`: The validation message for a date that `disable-dates` or `disable-days`
|
|
72846
73702
|
* bars.
|
|
72847
73703
|
* - `value-missing-message`/`valueMissingMessage`: The validation message for a required date picker with no date chosen.
|
|
@@ -72942,6 +73798,8 @@ export type CustomElementsSolidJs = {
|
|
|
72942
73798
|
*
|
|
72943
73799
|
* Areas where markup can be added to the component.
|
|
72944
73800
|
*
|
|
73801
|
+
* - `footer`: Content under the calendar, such as buttons for today or a common range.
|
|
73802
|
+
* - `header`: Content above the calendar, such as a note on what the date is for.
|
|
72945
73803
|
* - `next-icon`: The glyph on the control that moves forward a month, usually a caret.
|
|
72946
73804
|
* - `previous-icon`: The glyph on the control that moves back a month, usually a caret.
|
|
72947
73805
|
*
|
|
@@ -73035,6 +73893,7 @@ export type CustomElementsSolidJs = {
|
|
|
73035
73893
|
* - `day-outside`: A day from a neighboring month, filling the grid out, beside `day`.
|
|
73036
73894
|
* - `day-selected`: The chosen day, or either end of a chosen range, beside `day`.
|
|
73037
73895
|
* - `day-today`: Today, beside `day`.
|
|
73896
|
+
* - `day-weekend`: A day of the weekend where the calendar's language is spoken, beside `day`: Saturday and Sunday in `en-US`, Friday and Saturday in `ar-EG`.
|
|
73038
73897
|
* - `feedback`: The message under the calendar, while `feedback` is set.
|
|
73039
73898
|
* - `grid`: The grid of days.
|
|
73040
73899
|
* - `header`: The month name and its controls.
|
|
@@ -73053,7 +73912,7 @@ export type CustomElementsSolidJs = {
|
|
|
73053
73912
|
* - `previous`: The control that moves to the previous month.
|
|
73054
73913
|
* - `previous-mark`: The glyph on the previous month control, where none is slotted.
|
|
73055
73914
|
* - `week`: One row of days.
|
|
73056
|
-
* - `weekday`: A column header naming a day of the week.
|
|
73915
|
+
* - `weekday`: A column header naming a day of the week. It shows the short name and says the full one.
|
|
73057
73916
|
*
|
|
73058
73917
|
* ## CSS States
|
|
73059
73918
|
*
|
|
@@ -74417,13 +75276,18 @@ export type CustomElementsSolidJs = {
|
|
|
74417
75276
|
*
|
|
74418
75277
|
* Custom selectors for styling elements within the component.
|
|
74419
75278
|
*
|
|
75279
|
+
* - `actions`: The slot the actions arrive through. A slot draws no box, so it passes inherited properties to the actions; `display: flex` lays them out in a row.
|
|
74420
75280
|
* - `heading`: The heading at `heading-level`: the one `heading` draws while nothing is slotted into `heading`, or the one around a slotted element that is no heading.
|
|
75281
|
+
* - `icon`: The slot the icon arrives through, drawing no box, as `actions` does.
|
|
74421
75282
|
* - `live`: A copy of the heading and the message, in a live region that screen readers announce when the view appears. Visually hidden in the styled tier.
|
|
75283
|
+
* - `message`: The slot the message arrives through, drawing no box, as `actions` does.
|
|
74422
75284
|
*
|
|
74423
75285
|
* ## CSS States
|
|
74424
75286
|
*
|
|
74425
75287
|
* These can be used to apply styling when a component is in a given state.
|
|
74426
75288
|
*
|
|
75289
|
+
* - `has-actions`: Something is slotted into `actions`.
|
|
75290
|
+
* - `has-icon`: Something is slotted into `icon`.
|
|
74427
75291
|
* - `settled`: Set one frame after the first render. Transitions wait for it, so an element does not animate its own arrival.
|
|
74428
75292
|
*/
|
|
74429
75293
|
"helix-empty": Partial<
|
|
@@ -76834,10 +77698,33 @@ export type CustomElementsSolidJs = {
|
|
|
76834
77698
|
* Inside a button, `--icon-size` is set in `em`, so the icon scales with the
|
|
76835
77699
|
* button.
|
|
76836
77700
|
*
|
|
77701
|
+
* **The glyph turns, flips and moves inside its own box**, so the line around
|
|
77702
|
+
* it keeps its place: `rotate` turns it by a quarter, a half or three
|
|
77703
|
+
* quarters, `--icon-rotate` by any angle, `flip` mirrors it across either
|
|
77704
|
+
* axis, and `animation` spins, pulses or beats it, as Web Awesome's icon does.
|
|
77705
|
+
* Reduced motion stills every animation. `auto-width` gives the box the
|
|
77706
|
+
* glyph's own proportions, for a mark wider than it is tall.
|
|
77707
|
+
*
|
|
76837
77708
|
* ## Attributes & Properties
|
|
76838
77709
|
*
|
|
76839
77710
|
* Component attributes and properties that can be applied to the element or by using JavaScript.
|
|
76840
77711
|
*
|
|
77712
|
+
* - `animation`: A motion that draws the eye or says work is going on: `spin` turns the
|
|
77713
|
+
* glyph without end, `pulse` fades it in and out, and `beat` swells it.
|
|
77714
|
+
*
|
|
77715
|
+
* Absent is still. Reduced motion stills every one of them.
|
|
77716
|
+
* - `auto-width`/`autoWidth`: Whether the box takes the glyph's own proportions, its height from
|
|
77717
|
+
* `--icon-size` and its width from the glyph's box.
|
|
77718
|
+
*
|
|
77719
|
+
* Absent is a square, which lines icons up in a column.
|
|
77720
|
+
* - `flip`: Mirrors the glyph across an axis: `x` left to right, `y` top to bottom,
|
|
77721
|
+
* `both` across both.
|
|
77722
|
+
*
|
|
77723
|
+
* Absent draws it as it is. On a right-to-left page, `mirror` is the flip
|
|
77724
|
+
* that follows the direction.
|
|
77725
|
+
* - `rotate`: Turns the glyph clockwise by 90, 180 or 270 degrees.
|
|
77726
|
+
*
|
|
77727
|
+
* Absent draws it upright. `--icon-rotate` turns it by any other angle.
|
|
76841
77728
|
* - `label`: The icon's name, read by screen readers. Set it for an icon that is not
|
|
76842
77729
|
* decorative.
|
|
76843
77730
|
* - `mirror`: Flips the glyph on a right-to-left page. Use it for an arrow that means
|
|
@@ -76858,6 +77745,10 @@ export type CustomElementsSolidJs = {
|
|
|
76858
77745
|
*
|
|
76859
77746
|
* A name written `prefix:name` asks the library registered under that
|
|
76860
77747
|
* prefix.
|
|
77748
|
+
* - `src`: The URL of an SVG file to draw, fetched once a page and drawn in
|
|
77749
|
+
* `currentColor` where the file does not color its shapes.
|
|
77750
|
+
*
|
|
77751
|
+
* Wins over `name`; `icon` wins over both. Absent draws `name`.
|
|
76861
77752
|
* - `icon`: The icon to draw, as an object you import.
|
|
76862
77753
|
*
|
|
76863
77754
|
* **The scalable door, and the one this library uses internally.** An icon is
|
|
@@ -76895,8 +77786,8 @@ export type CustomElementsSolidJs = {
|
|
|
76895
77786
|
*
|
|
76896
77787
|
* Events that will be emitted by the component.
|
|
76897
77788
|
*
|
|
76898
|
-
* - `error`: `name` matches no registered icon and no library answers it, so nothing is drawn.
|
|
76899
|
-
* - `load`: A glyph a library gave later for `name` is drawn.
|
|
77789
|
+
* - `error`: `name` matches no registered icon and no library answers it, or `src` is no SVG, so nothing is drawn.
|
|
77790
|
+
* - `load`: A glyph a library gave later for `name`, or the file at `src`, is drawn.
|
|
76900
77791
|
*
|
|
76901
77792
|
* ## Methods
|
|
76902
77793
|
*
|
|
@@ -76910,7 +77801,9 @@ export type CustomElementsSolidJs = {
|
|
|
76910
77801
|
*
|
|
76911
77802
|
* CSS variables available for styling the component.
|
|
76912
77803
|
*
|
|
76913
|
-
* - `--icon-
|
|
77804
|
+
* - `--icon-animation-duration`: How long one turn, pulse or beat of `animation` takes.
|
|
77805
|
+
* - `--icon-rotate`: An angle the glyph is turned by, such as `45deg`. `rotate` wins over it.
|
|
77806
|
+
* - `--icon-size`: The width and height of the icon's box. The height alone under `auto-width`.
|
|
76914
77807
|
*
|
|
76915
77808
|
* ## CSS Parts
|
|
76916
77809
|
*
|
|
@@ -81094,6 +81987,7 @@ export type CustomElementsSolidJs = {
|
|
|
81094
81987
|
*
|
|
81095
81988
|
* These can be used to apply styling when a component is in a given state.
|
|
81096
81989
|
*
|
|
81990
|
+
* - `open`: While a megamenu or another disclosure among the destinations is open.
|
|
81097
81991
|
* - `settled`: Set one frame after the first render. Transitions wait for it, so an element does not animate its own arrival.
|
|
81098
81992
|
*/
|
|
81099
81993
|
"helix-navigation": Partial<
|
|
@@ -83945,6 +84839,12 @@ export type CustomElementsSolidJs = {
|
|
|
83945
84839
|
* Component attributes and properties that can be applied to the element or by using JavaScript.
|
|
83946
84840
|
*
|
|
83947
84841
|
* - `cite`: URL identifying where the quotation came from.
|
|
84842
|
+
* - `no-marks`/`noMarks`: Whether to leave the quotation marks off, for a quotation set where the
|
|
84843
|
+
* page draws its own.
|
|
84844
|
+
*
|
|
84845
|
+
* Negative, because the marks are on by default and a boolean attribute is
|
|
84846
|
+
* true whenever it is present. Reflected, because a stylesheet takes the
|
|
84847
|
+
* marks off on it.
|
|
83948
84848
|
* - `whenSettled`: Resolves a frame after the first update, when transitions are switched on.
|
|
83949
84849
|
*
|
|
83950
84850
|
* **Named `whenSettled` because `settled` is taken four times over**, by
|
|
@@ -85962,6 +86862,17 @@ export type CustomElementsSolidJs = {
|
|
|
85962
86862
|
*
|
|
85963
86863
|
* No attribute, because it is coordination between elements rather than
|
|
85964
86864
|
* anything a consumer sets. (property only)
|
|
86865
|
+
* - `items`: The options as data, for a list too long to draw whole: each a value,
|
|
86866
|
+
* which is also its words, or a record with a `value`, a `label` and
|
|
86867
|
+
* `disabled`. Passed to the list, which draws only the options in sight,
|
|
86868
|
+
* as Listbox's `items` does. Set, the options you write as children are
|
|
86869
|
+
* not read.
|
|
86870
|
+
*
|
|
86871
|
+
* The trigger shows the chosen options' labels, the letters and the Left
|
|
86872
|
+
* and Right keys on the closed trigger choose over the whole set, and a
|
|
86873
|
+
* chosen value whose option leaves `items` drops out of `value`.
|
|
86874
|
+
* `value-content` is not called for `items`. Import the Option family as
|
|
86875
|
+
* well, whose elements are drawn. (property only)
|
|
85965
86876
|
* - `valueContent`: What the trigger shows for the chosen options: a function given them, in
|
|
85966
86877
|
* the order they appear, that returns text, an element or a Lit template.
|
|
85967
86878
|
*
|
|
@@ -86143,6 +87054,8 @@ export type CustomElementsSolidJs = {
|
|
|
86143
87054
|
*
|
|
86144
87055
|
* - `invalid`: The control has an error to show, from the browser's validation or from your `feedback`.
|
|
86145
87056
|
* - `open`: While the list is open.
|
|
87057
|
+
* - `placed-bottom`: While the open list sits below the trigger.
|
|
87058
|
+
* - `placed-top`: While the open list sits above the trigger, where there was no room below.
|
|
86146
87059
|
* - `settled`: Set one frame after the first render. Transitions wait for it, so an element does not animate its own arrival.
|
|
86147
87060
|
*/
|
|
86148
87061
|
"helix-select": Partial<
|
|
@@ -86160,6 +87073,11 @@ export type CustomElementsSolidJs = {
|
|
|
86160
87073
|
* Around content with `loading`, the skeleton takes the content's box and
|
|
86161
87074
|
* paints over it, and the content is hidden until `loading` is taken off.
|
|
86162
87075
|
*
|
|
87076
|
+
* **`lines` draws a paragraph.** With `shape="text"` and `lines="3"`, one
|
|
87077
|
+
* element stands in for three lines of text: each line a `skeleton` part one
|
|
87078
|
+
* `em` tall, spaced a body line height apart, and the last one shorter, as the end
|
|
87079
|
+
* of a paragraph is.
|
|
87080
|
+
*
|
|
86163
87081
|
* ## Attributes & Properties
|
|
86164
87082
|
*
|
|
86165
87083
|
* Component attributes and properties that can be applied to the element or by using JavaScript.
|
|
@@ -86168,6 +87086,10 @@ export type CustomElementsSolidJs = {
|
|
|
86168
87086
|
* fade the fill in and out, or `none` to sit still.
|
|
86169
87087
|
*
|
|
86170
87088
|
* Reduced motion stills both.
|
|
87089
|
+
* - `lines`: How many lines of text the placeholder stands for, with `shape="text"`.
|
|
87090
|
+
*
|
|
87091
|
+
* Absent, or 1, is one line. Reflected, because the stylesheet sizes a
|
|
87092
|
+
* paragraph by it.
|
|
86171
87093
|
* - `shape`: The shape of the placeholder: `text`, `circle`, or a block when unset.
|
|
86172
87094
|
*
|
|
86173
87095
|
* Unset is a block, which is what most missing things are. A block is the
|
|
@@ -86216,6 +87138,7 @@ export type CustomElementsSolidJs = {
|
|
|
86216
87138
|
* - `--skeleton-block-size`: The height of the block shape, which is the shape when `shape` is unset. Defaults to the control height.
|
|
86217
87139
|
* - `--skeleton-color`: The placeholder's fill.
|
|
86218
87140
|
* - `--skeleton-duration`: How long one sweep or one pulse takes.
|
|
87141
|
+
* - `--skeleton-last-line-size`: The width of the last line of a `lines` paragraph. Defaults to 60%.
|
|
86219
87142
|
* - `--skeleton-radius`: The corner of the block shape.
|
|
86220
87143
|
* - `--skeleton-sheen-color`: The highlight the sweep carries across the fill.
|
|
86221
87144
|
* - `--skeleton-size`: The diameter of the circle shape.
|
|
@@ -86225,8 +87148,10 @@ export type CustomElementsSolidJs = {
|
|
|
86225
87148
|
* Custom selectors for styling elements within the component.
|
|
86226
87149
|
*
|
|
86227
87150
|
* - `content`: The box around the content, hidden while `loading`.
|
|
87151
|
+
* - `line`: Each line of a `lines` paragraph, which is also a `skeleton` part.
|
|
87152
|
+
* - `lines`: The column holding a `lines` paragraph, drawn only for `shape="text"` with two or more lines.
|
|
86228
87153
|
* - `sheen`: The highlight swept across the shape. Hidden for `effect="pulse"` and `effect="none"`.
|
|
86229
|
-
* - `skeleton`: The placeholder shape.
|
|
87154
|
+
* - `skeleton`: The placeholder shape, or each line of a `lines` paragraph.
|
|
86230
87155
|
*
|
|
86231
87156
|
* ## CSS States
|
|
86232
87157
|
*
|
|
@@ -86419,13 +87344,24 @@ export type CustomElementsSolidJs = {
|
|
|
86419
87344
|
* between its thumbs and ignores it.
|
|
86420
87345
|
* - `range`: Adds a second thumb, so the value is a pair.
|
|
86421
87346
|
*
|
|
86422
|
-
* The pair is one string, `"10,50"`, which is what
|
|
86423
|
-
* `MixinControllerValue`
|
|
86424
|
-
*
|
|
87347
|
+
* The pair is one string, `"10,50"`, which is what `value` and
|
|
87348
|
+
* `MixinControllerValue` hold. A form receives two entries under the name,
|
|
87349
|
+
* `price=10&price=50`, as React Aria's two thumbs send theirs.
|
|
87350
|
+
* `valueAsNumber` reads the lower of the two, since a range has no single
|
|
87351
|
+
* number.
|
|
86425
87352
|
* - `range-text`/`rangeText`: How the readout joins a range's two values, with `{start}` and `{end}`
|
|
86426
87353
|
* filled in. Write it in the page's language, such as `{start} bis {end}`.
|
|
87354
|
+
* - `readonly`/`readOnly`: Whether a reader can see and focus the value and cannot change it. A
|
|
87355
|
+
* read-only slider still submits its value.
|
|
87356
|
+
*
|
|
87357
|
+
* React Aria's `isReadOnly`. Each thumb stays a tab stop and says
|
|
87358
|
+
* `aria-readonly`. The arrow keys, the page keys, Home, End, and a drag
|
|
87359
|
+
* leave the value where it is. A script can still set `value`.
|
|
86427
87360
|
* - `show-value`/`showValue`: Shows the chosen value beside the track.
|
|
86428
87361
|
* - `step`: How far one press of an arrow key moves the thumb.
|
|
87362
|
+
* - `thumb-label`/`thumbLabel`: The name of a thumb between a range's first and last, read after the
|
|
87363
|
+
* slider's label, with `{index}` filled in: its place, counted from 1. The
|
|
87364
|
+
* first is `minimum-label` and the last `maximum-label`.
|
|
86429
87365
|
* - `tooltip`: Whether each thumb shows its value in a bubble beside it, as Web
|
|
86430
87366
|
* Awesome's `with-tooltip`. The styled slider shows the bubbles while the
|
|
86431
87367
|
* slider is under the pointer or holds focus. They repeat what each thumb
|
|
@@ -86501,6 +87437,8 @@ export type CustomElementsSolidJs = {
|
|
|
86501
87437
|
* - `feedback`: The message that says what is wrong, for content richer than a string. It shows while there is a message.
|
|
86502
87438
|
* - `hint`: Help under the control, for content richer than the `hint` text.
|
|
86503
87439
|
* - `label`: The label, for content richer than the `label` text.
|
|
87440
|
+
* - `thumb`: Content drawn on the thumb, such as a glyph: a single slider's thumb, or a range's lower one. It is decoration, hidden from a screen reader.
|
|
87441
|
+
* - `thumb-end`: Content drawn on a range's upper thumb.
|
|
86504
87442
|
*
|
|
86505
87443
|
* ## Methods
|
|
86506
87444
|
*
|
|
@@ -86573,6 +87511,7 @@ export type CustomElementsSolidJs = {
|
|
|
86573
87511
|
* - `--slider-length`: The length of a vertical track. It defaults to nine rem and applies only when `orientation` is `vertical`. A horizontal track takes the width of its row.
|
|
86574
87512
|
* - `--slider-marker-color`: The color of the marks along the track.
|
|
86575
87513
|
* - `--slider-thumb-color`: The color of the thumb.
|
|
87514
|
+
* - `--slider-thumb-content-color`: The color of content in the `thumb` and `thumb-end` slots, drawn on the thumb.
|
|
86576
87515
|
* - `--slider-thumb-length`: The thumb's size along the track. It follows `--slider-thumb-size` unless you set it, and setting one of the two makes the thumb an oval.
|
|
86577
87516
|
* - `--slider-thumb-radius`: The thumb's corner radius. It is fully round by default, so a thumb with two different dimensions is a capsule unless you change it.
|
|
86578
87517
|
* - `--slider-thumb-ring-color`: The color of the ring between the thumb and the track. Set it for a slider that sits on a surface other than the page background.
|
|
@@ -86582,7 +87521,7 @@ export type CustomElementsSolidJs = {
|
|
|
86582
87521
|
* - `--slider-track-color`: The color of the unfilled part of the track.
|
|
86583
87522
|
* - `--slider-track-image`: An image for the whole track, such as a gradient for a slider whose value is a color.
|
|
86584
87523
|
* - `--slider-track-size`: The thickness of the track. It matches the progress bar's size by default.
|
|
86585
|
-
* - `--slider-at`: Where a bubble's thumb is, as a fraction of the track, 0 to 1. Set on each `tooltip` part.
|
|
87524
|
+
* - `--slider-at`: Where a bubble's or a thumb box's thumb is, as a fraction of the track, 0 to 1. Set on each `tooltip` and `thumb` part.
|
|
86586
87525
|
* - `--slider-fraction`: The value as a fraction of the range, 0 to 1.
|
|
86587
87526
|
* - `--slider-from`: Where the filled span starts, as a fraction of the track, 0 to 1: a range's lower thumb, or a single thumb's `origin`.
|
|
86588
87527
|
* - `--slider-marker-at`: Where one marker sits, as a percentage of the track.
|
|
@@ -86592,7 +87531,7 @@ export type CustomElementsSolidJs = {
|
|
|
86592
87531
|
*
|
|
86593
87532
|
* Custom selectors for styling elements within the component.
|
|
86594
87533
|
*
|
|
86595
|
-
* - `control`: The range input.
|
|
87534
|
+
* - `control`: The range input, one per thumb. On a range each carries `data-thumb`, `start`, `middle`, or `end`, and `data-index`, its place from the lowest.
|
|
86596
87535
|
* - `feedback`: The error message under the track.
|
|
86597
87536
|
* - `field`: The row that holds the control and its readout.
|
|
86598
87537
|
* - `hint`: The help text under the track, shown while there is no error.
|
|
@@ -86601,7 +87540,9 @@ export type CustomElementsSolidJs = {
|
|
|
86601
87540
|
* - `marker-label`: The value a mark stands at, when `marker-labels` is set.
|
|
86602
87541
|
* - `markers`: The row of marks along the track.
|
|
86603
87542
|
* - `output`: The current value, shown beside the track.
|
|
86604
|
-
* - `
|
|
87543
|
+
* - `thumb`: One thumb's own box over the track, which holds the `thumb` or `thumb-end` slot. It carries `data-thumb` on a range, `start`, `middle`, or `end`, and `--slider-at`, where its thumb is as a fraction of the track. Draw your own thumb here and hide the native one, or leave it empty.
|
|
87544
|
+
* - `thumbs`: The layer over the track that holds each `thumb`. It is `hidden` until a thumb slot has content, and then `[part="field"]` carries `data-thumbs`.
|
|
87545
|
+
* - `tooltip`: One thumb's value in a bubble beside it, under `tooltip`. It carries `data-thumb` on a range, `start`, `middle`, or `end`, and `--slider-at`, where its thumb is as a fraction of the track.
|
|
86605
87546
|
* - `tooltips`: The layer over the track that holds the bubbles, under `tooltip`.
|
|
86606
87547
|
*
|
|
86607
87548
|
* ## CSS States
|
|
@@ -86952,9 +87893,15 @@ export type CustomElementsSolidJs = {
|
|
|
86952
87893
|
* Component attributes and properties that can be applied to the element or by using JavaScript.
|
|
86953
87894
|
*
|
|
86954
87895
|
* - `disabled`: Whether the action is disabled, so it cannot be chosen.
|
|
87896
|
+
* - `download`: Whether the link downloads the file when the action is chosen. Only
|
|
87897
|
+
* meaningful beside an `href`, and only for a file served from the page's
|
|
87898
|
+
* origin.
|
|
87899
|
+
* - `href`: The URL the action links to. Setting it draws the action as a link.
|
|
87900
|
+
* - `rel`: The link's `rel`. Set it whenever you set `target="_blank"`.
|
|
86955
87901
|
* - `shortcut`: The action's keyboard shortcut as a chord, such as `mod+s`, carried as
|
|
86956
87902
|
* `aria-keyshortcuts` and drawn after the name. `mod` is Command on an Apple
|
|
86957
87903
|
* keyboard and Control elsewhere. Showing a shortcut does not bind it.
|
|
87904
|
+
* - `target`: Where the link opens, such as `_blank` for a new tab.
|
|
86958
87905
|
* - `value`: The action's value, sent in `helix-select` when the action is chosen.
|
|
86959
87906
|
* - `active`: Whether the action has focus, which makes it the action the keyboard is on.
|
|
86960
87907
|
*
|
|
@@ -87025,7 +87972,7 @@ export type CustomElementsSolidJs = {
|
|
|
87025
87972
|
* Custom selectors for styling elements within the component.
|
|
87026
87973
|
*
|
|
87027
87974
|
* - `icon`: The box that holds the icon.
|
|
87028
|
-
* - `item`: The control for the action.
|
|
87975
|
+
* - `item`: The control for the action, which is an `<a>` where `href` is set.
|
|
87029
87976
|
* - `label`: The action's name, beside the icon.
|
|
87030
87977
|
* - `shortcut`: The box after the name that holds the shortcut, shown while `shortcut` is set or something is in the `shortcut` slot.
|
|
87031
87978
|
*
|
|
@@ -87079,9 +88026,11 @@ export type CustomElementsSolidJs = {
|
|
|
87079
88026
|
* plain element of yours once a reader reaches it, after hydration, unless
|
|
87080
88027
|
* you described or labeled it yourself.
|
|
87081
88028
|
* - `offset`: Space between the trigger and the actions, in pixels.
|
|
87082
|
-
* - `open-on`/`openOn`: What opens the dial. `click` opens it on a press of the trigger.
|
|
87083
|
-
*
|
|
87084
|
-
*
|
|
88029
|
+
* - `open-on`/`openOn`: What opens the dial. `click` opens it on a press of the trigger. `hover`
|
|
88030
|
+
* also opens it while a mouse rests on the trigger, and closes it once the
|
|
88031
|
+
* mouse has left. Under `long-press`, a press is the trigger's own action,
|
|
88032
|
+
* and the dial opens on a press held for half a second, or on Alt+Down or
|
|
88033
|
+
* Alt+Up.
|
|
87085
88034
|
* - `placement`: The direction the actions open in. They move to another side if that side
|
|
87086
88035
|
* does not fit.
|
|
87087
88036
|
*
|
|
@@ -87122,6 +88071,7 @@ export type CustomElementsSolidJs = {
|
|
|
87122
88071
|
* Areas where markup can be added to the component.
|
|
87123
88072
|
*
|
|
87124
88073
|
* - `(default)`: The actions.
|
|
88074
|
+
* - `icon`: Replaces the plus on the button the dial draws when no trigger is slotted, such as with a pencil for a dial of ways to write.
|
|
87125
88075
|
* - `trigger`: The control that opens the actions. Without one, a button named by `label` is drawn.
|
|
87126
88076
|
*
|
|
87127
88077
|
* ## Methods
|
|
@@ -87418,7 +88368,10 @@ export type CustomElementsSolidJs = {
|
|
|
87418
88368
|
* with its rule; and a count is what a set of facts read across wants, where
|
|
87419
88369
|
* figures compared one against another keep their own widths.
|
|
87420
88370
|
* - `divided`: Draws a rule between the figures, in addition to the space.
|
|
87421
|
-
* - `label`: Accessible name for the group.
|
|
88371
|
+
* - `label`: Accessible name for the group, which makes it a group.
|
|
88372
|
+
*
|
|
88373
|
+
* Absent leaves the stats with no group around them, unless `aria-label` or
|
|
88374
|
+
* `aria-labelledby` names it.
|
|
87422
88375
|
* - `whenSettled`: Resolves a frame after the first update, when transitions are switched on.
|
|
87423
88376
|
*
|
|
87424
88377
|
* **Named `whenSettled` because `settled` is taken four times over**, by
|
|
@@ -87446,6 +88399,14 @@ export type CustomElementsSolidJs = {
|
|
|
87446
88399
|
*
|
|
87447
88400
|
* - `(default)`: The stats.
|
|
87448
88401
|
*
|
|
88402
|
+
* ## Methods
|
|
88403
|
+
*
|
|
88404
|
+
* Methods that can be called to access component functionality.
|
|
88405
|
+
*
|
|
88406
|
+
* - `attributeChangedCallback(name: string, old: string | null, value: string | null) => void`: Called by the browser when an observed attribute changes. A name written
|
|
88407
|
+
* or taken off asks for an update, because it decides whether the stats are
|
|
88408
|
+
* a group.
|
|
88409
|
+
*
|
|
87449
88410
|
* ## CSS Custom Properties
|
|
87450
88411
|
*
|
|
87451
88412
|
* CSS variables available for styling the component.
|
|
@@ -87500,6 +88461,20 @@ export type CustomElementsSolidJs = {
|
|
|
87500
88461
|
* reports a hydration mismatch. The absent attribute is the column, which the
|
|
87501
88462
|
* stylesheet reads as the base case, and the server spec asserts the host
|
|
87502
88463
|
* carries nothing nobody wrote.
|
|
88464
|
+
* - `format-options`/`formatOptions`: `Intl.NumberFormat` options `value` is written with, such as
|
|
88465
|
+
* `{"notation":"compact"}` for `1.2M` or `{"style":"percent"}` for `98%`,
|
|
88466
|
+
* written as JSON in the attribute.
|
|
88467
|
+
*
|
|
88468
|
+
* Absent writes the number as the locale writes any number.
|
|
88469
|
+
* - `locale`: The locale `value` is written in, such as `de` for `1.234.567`.
|
|
88470
|
+
*
|
|
88471
|
+
* Absent reads the nearest `lang`, then the runtime's own. Set it on a page
|
|
88472
|
+
* rendered on a server, so the server and the browser write the figure
|
|
88473
|
+
* alike.
|
|
88474
|
+
* - `value`: The figure as a number, written with `format-options` in `locale` in
|
|
88475
|
+
* place of a slotted value.
|
|
88476
|
+
*
|
|
88477
|
+
* Absent leaves the figure to the slot.
|
|
87503
88478
|
* - `whenSettled`: Resolves a frame after the first update, when transitions are switched on.
|
|
87504
88479
|
*
|
|
87505
88480
|
* **Named `whenSettled` because `settled` is taken four times over**, by
|
|
@@ -87547,11 +88522,17 @@ export type CustomElementsSolidJs = {
|
|
|
87547
88522
|
* Custom selectors for styling elements within the component.
|
|
87548
88523
|
*
|
|
87549
88524
|
* - `value`: The slot the value is written in. A slot draws no box, so it takes the inherited properties, such as color and font, and passes them to the value.
|
|
88525
|
+
* - `label`: The slot the label arrives through, drawing no box, as `value` does.
|
|
88526
|
+
* - `trend`: The slot the trend arrives through, drawing no box, as `value` does.
|
|
88527
|
+
* - `unit`: The slot the unit arrives through, drawing no box, as `value` does.
|
|
87550
88528
|
*
|
|
87551
88529
|
* ## CSS States
|
|
87552
88530
|
*
|
|
87553
88531
|
* These can be used to apply styling when a component is in a given state.
|
|
87554
88532
|
*
|
|
88533
|
+
* - `has-label`: Something is slotted into `label`.
|
|
88534
|
+
* - `has-trend`: Something is slotted into `trend`.
|
|
88535
|
+
* - `has-unit`: Something is slotted into `unit`.
|
|
87555
88536
|
* - `settled`: Set one frame after the first render. Transitions wait for it, so an element does not animate its own arrival.
|
|
87556
88537
|
*/
|
|
87557
88538
|
"helix-stat": Partial<
|
|
@@ -87582,6 +88563,14 @@ export type CustomElementsSolidJs = {
|
|
|
87582
88563
|
* - `default-active`/`defaultActive`: The `value` of the item declared current in markup.
|
|
87583
88564
|
*
|
|
87584
88565
|
* Ignored once `active` is written.
|
|
88566
|
+
* - `arrows`: Whether the arrow keys move focus between the stages' names, along the
|
|
88567
|
+
* way the steps run. Off by default, so the arrows keep scrolling the page.
|
|
88568
|
+
* - `completion`: What marks a stage `complete`.
|
|
88569
|
+
*
|
|
88570
|
+
* Absent, you do: each step's `complete` is yours, because a reader who
|
|
88571
|
+
* steps back has finished more stages than the one they are on. `passed`
|
|
88572
|
+
* marks every stage before the one a reader moves to, and leaves the marks
|
|
88573
|
+
* when they go back.
|
|
87585
88574
|
* - `label`: The sequence's name, read by screen readers.
|
|
87586
88575
|
*
|
|
87587
88576
|
* A list of stages is a landmark a reader arrives at out of order, so it
|
|
@@ -87669,6 +88658,10 @@ export type CustomElementsSolidJs = {
|
|
|
87669
88658
|
* does. Returns whether it moved: not past the last stage, not into a stage
|
|
87670
88659
|
* `linear` holds out of reach, and not where a listener refused.
|
|
87671
88660
|
* - `previous() => boolean`: Moves to the stage before, as Ark UI's `goToPrevStep` does. Returns whether it moved.
|
|
88661
|
+
* - `reset() => boolean`: Goes back to the first stage that can be gone to, and clears `complete`
|
|
88662
|
+
* and the invalid mark from every stage, as Ark UI's `resetStep` does.
|
|
88663
|
+
* Returns whether it moved: a listener can refuse the move with
|
|
88664
|
+
* `helix-before-activate`, and the stages then keep their marks.
|
|
87672
88665
|
*
|
|
87673
88666
|
* ## CSS Custom Properties
|
|
87674
88667
|
*
|
|
@@ -87771,6 +88764,8 @@ export type CustomElementsSolidJs = {
|
|
|
87771
88764
|
*
|
|
87772
88765
|
* Methods that can be called to access component functionality.
|
|
87773
88766
|
*
|
|
88767
|
+
* - `focus(options?: FocusOptions) => void`: Puts focus on the step's name, the control a reader presses, as a
|
|
88768
|
+
* `focus()` on a native control would.
|
|
87774
88769
|
* - `select() => void`: Fires `helix-select` for the step, unless the step is `disabled` or a
|
|
87775
88770
|
* linear sequence has it out of reach.
|
|
87776
88771
|
*
|
|
@@ -87796,6 +88791,7 @@ export type CustomElementsSolidJs = {
|
|
|
87796
88791
|
* These can be used to apply styling when a component is in a given state.
|
|
87797
88792
|
*
|
|
87798
88793
|
* - `invalid`: The sequence's `validate` last answered that this stage is not valid.
|
|
88794
|
+
* - `locked`: A `linear` sequence holds this stage out of reach until the stages before it are finished.
|
|
87799
88795
|
* - `settled`: Set one frame after the first render. Transitions wait for it, so an element does not animate its own arrival.
|
|
87800
88796
|
*/
|
|
87801
88797
|
"helix-step": Partial<
|
|
@@ -88728,6 +89724,8 @@ export type CustomElementsSolidJs = {
|
|
|
88728
89724
|
* panels and tells a screen reader the list is vertical.
|
|
88729
89725
|
*
|
|
88730
89726
|
* Optional, so the resting row writes no attribute onto the host.
|
|
89727
|
+
* - `scroll-controls`/`scrollControls`: Whether a strip with more tabs than fit shows a button at each end it can
|
|
89728
|
+
* scroll toward.
|
|
88731
89729
|
* - `variant`: How the row of tabs is drawn.
|
|
88732
89730
|
*
|
|
88733
89731
|
* Unset is a raised pill on the selected tab with nothing behind the row,
|
|
@@ -88810,6 +89808,7 @@ export type CustomElementsSolidJs = {
|
|
|
88810
89808
|
* - `--tabs-indicator-shadow`: The shadow under the mark, which the pill and `segmented` draw.
|
|
88811
89809
|
* - `--tabs-indicator-thickness`: The height of the bar under `underlined`.
|
|
88812
89810
|
* - `--tabs-rule-color`: The color of the rule under the row in `underlined`.
|
|
89811
|
+
* - `--tabs-scroll-background-color`: The fill behind the scroll buttons, over the tabs that pass under them.
|
|
88813
89812
|
*
|
|
88814
89813
|
* ## CSS Parts
|
|
88815
89814
|
*
|
|
@@ -88817,6 +89816,8 @@ export type CustomElementsSolidJs = {
|
|
|
88817
89816
|
*
|
|
88818
89817
|
* - `indicator`: The mark that moves to the selected tab. It carries the selected tab's place and size as `--indicator-x`, `--indicator-y`, `--indicator-inline-size` and `--indicator-block-size`.
|
|
88819
89818
|
* - `panels`: The panel container.
|
|
89819
|
+
* - `scroll-end`: The button that scrolls the strip toward its end, shown under `scroll-controls` while there is more that way. It holds to the end of the strip.
|
|
89820
|
+
* - `scroll-start`: The button that scrolls the strip toward its start, shown under `scroll-controls` while there is more that way. It holds to the start of the strip.
|
|
88820
89821
|
* - `tabs`: The tab list.
|
|
88821
89822
|
*
|
|
88822
89823
|
* ## CSS States
|
|
@@ -88839,6 +89840,17 @@ export type CustomElementsSolidJs = {
|
|
|
88839
89840
|
*
|
|
88840
89841
|
* Component attributes and properties that can be applied to the element or by using JavaScript.
|
|
88841
89842
|
*
|
|
89843
|
+
* - `dismissible`: Whether the element shows a control that dismisses it.
|
|
89844
|
+
* - `dismiss-label`/`dismissLabel`: The dismiss control's label, read by screen readers.
|
|
89845
|
+
*
|
|
89846
|
+
* `attribute` is spelled out because Lit lowercases a property name to
|
|
89847
|
+
* derive one rather than dash-casing it, so this would otherwise be
|
|
89848
|
+
* reachable only as `dismisslabel`, which nobody would guess and no linter
|
|
89849
|
+
* would catch.
|
|
89850
|
+
*
|
|
89851
|
+
* A word property: register it for a locale under the host's key. A family
|
|
89852
|
+
* that names the control otherwise, such as Tag's `Remove {label}`,
|
|
89853
|
+
* declares its own English with `@words` above the override.
|
|
88842
89854
|
* - `disabled`: Whether the item is disabled and cannot be chosen.
|
|
88843
89855
|
* - `selected`: Whether the item is selected.
|
|
88844
89856
|
*
|
|
@@ -88876,6 +89888,7 @@ export type CustomElementsSolidJs = {
|
|
|
88876
89888
|
*
|
|
88877
89889
|
* Events that will be emitted by the component.
|
|
88878
89890
|
*
|
|
89891
|
+
* - `helix-dismiss`: A `dismissible` tab was asked to close. The tab does not remove itself, so remove it and its panel in response. Cancelable.
|
|
88879
89892
|
* - `helix-select`: Fired when the tab is chosen. Cancelable: canceling it stops the change and leaves the decision to you.
|
|
88880
89893
|
*
|
|
88881
89894
|
* ## Slots
|
|
@@ -88888,6 +89901,7 @@ export type CustomElementsSolidJs = {
|
|
|
88888
89901
|
*
|
|
88889
89902
|
* Methods that can be called to access component functionality.
|
|
88890
89903
|
*
|
|
89904
|
+
* - `dismiss() => boolean`: Fires `helix-dismiss`, and returns `false` if a listener cancels it.
|
|
88891
89905
|
* - `focusItem() => void`: Moves focus to the item's control, for the set's arrow keys.
|
|
88892
89906
|
*
|
|
88893
89907
|
* The set drives the keys and cannot reach the control itself, which is
|
|
@@ -88905,6 +89919,7 @@ export type CustomElementsSolidJs = {
|
|
|
88905
89919
|
* - `--tabs-tab-block-size`: The height of a tab. `segmented` sizes its tabs to the track and does not read it.
|
|
88906
89920
|
* - `--tabs-tab-color`: The label color of a tab that is not current.
|
|
88907
89921
|
* - `--tabs-tab-disabled-opacity`: How faint a disabled tab is drawn.
|
|
89922
|
+
* - `--tabs-tab-dismiss-color`: The color of the mark that closes a `dismissible` tab.
|
|
88908
89923
|
* - `--tabs-tab-font-size`: The size of a tab's label.
|
|
88909
89924
|
* - `--tabs-tab-font-weight`: The weight of a tab's label.
|
|
88910
89925
|
* - `--tabs-tab-hover-background-color`: The wash under the pointer.
|
|
@@ -88918,6 +89933,7 @@ export type CustomElementsSolidJs = {
|
|
|
88918
89933
|
*
|
|
88919
89934
|
* Custom selectors for styling elements within the component.
|
|
88920
89935
|
*
|
|
89936
|
+
* - `dismiss`: The mark a pointer presses to close a `dismissible` tab.
|
|
88921
89937
|
* - `tab`: The tab itself.
|
|
88922
89938
|
*
|
|
88923
89939
|
* ## CSS States
|
|
@@ -88940,10 +89956,19 @@ export type CustomElementsSolidJs = {
|
|
|
88940
89956
|
*
|
|
88941
89957
|
* Component attributes and properties that can be applied to the element or by using JavaScript.
|
|
88942
89958
|
*
|
|
89959
|
+
* - `disallow-empty-selection`/`disallowEmptySelection`: Keeps at least one tag selected once one is, as React Aria's
|
|
89960
|
+
* `disallowEmptySelection`: a press or a key that would leave none selected
|
|
89961
|
+
* is refused. Removing the last selected tag still takes it out of `value`.
|
|
88943
89962
|
* - `empty-label`/`emptyLabel`: The words the group shows and says once its last tag is removed, where
|
|
88944
89963
|
* nothing is in the `empty` slot.
|
|
88945
89964
|
* - `label`: The name of the set, such as "Filters", which a screen reader announces
|
|
88946
89965
|
* before its tags.
|
|
89966
|
+
* - `selection-behavior`/`selectionBehavior`: What a press, Space, or a move does to the tags already selected.
|
|
89967
|
+
* `toggle`, the default, keeps them: a press adds or takes out the tag, and
|
|
89968
|
+
* the arrow keys move focus alone. `replace` selects the tag alone, as a
|
|
89969
|
+
* file list does, and the arrow keys carry the selection with focus.
|
|
89970
|
+
* Control or Command with a press or Space adds or takes out one tag in
|
|
89971
|
+
* `multiple`, and with an arrow moves focus without selecting.
|
|
88947
89972
|
* - `selection-mode`/`selectionMode`: How many tags a reader can select: `single`, `multiple`, or none.
|
|
88948
89973
|
*
|
|
88949
89974
|
* Absent selects nothing, and the tags carry no selected state at all.
|
|
@@ -89018,6 +90043,11 @@ export type CustomElementsSolidJs = {
|
|
|
89018
90043
|
* Seven tones. The fill is a tint of the status color made with `color-mix`, so
|
|
89019
90044
|
* when a theme changes its status colors, the tints change with them.
|
|
89020
90045
|
*
|
|
90046
|
+
* A tag takes its height from the region it is in, as the controls beside it
|
|
90047
|
+
* do: `data-density="sm"`, `md`, or `lg` on the tag or on any element around
|
|
90048
|
+
* it sets `--helix-size-tag` to the small, resting, or large step, so a row of
|
|
90049
|
+
* tags and buttons stays one height. `shape="pill"` rounds its ends.
|
|
90050
|
+
*
|
|
89021
90051
|
* ## Attributes & Properties
|
|
89022
90052
|
*
|
|
89023
90053
|
* Component attributes and properties that can be applied to the element or by using JavaScript.
|
|
@@ -91167,6 +92197,8 @@ export type CustomElementsSolidJs = {
|
|
|
91167
92197
|
* Areas where markup can be added to the component.
|
|
91168
92198
|
*
|
|
91169
92199
|
* - `(default)`: The item's label.
|
|
92200
|
+
* - `end`: Content after the label, such as a count or a shortcut.
|
|
92201
|
+
* - `start`: Content before the label, such as an icon.
|
|
91170
92202
|
*
|
|
91171
92203
|
* ## Methods
|
|
91172
92204
|
*
|
|
@@ -92085,6 +93117,11 @@ export type CustomElementsSolidJs = {
|
|
|
92085
93117
|
*
|
|
92086
93118
|
* An `aria-label` or `aria-labelledby` on the host names the tree too, and
|
|
92087
93119
|
* wins over this.
|
|
93120
|
+
* - `moved-into-label`/`movedIntoLabel`: What screen readers hear when an item moves into another branch, in a
|
|
93121
|
+
* `reorderable` tree. `{name}` is the item's words, `{parent}` the words of
|
|
93122
|
+
* the branch it moved into, or the tree's `label` for the top level,
|
|
93123
|
+
* `{position}` its place there, counting from 1, and `{count}` the number of
|
|
93124
|
+
* items there.
|
|
92088
93125
|
* - `moved-label`/`movedLabel`: What screen readers hear each time an item moves, in a `reorderable`
|
|
92089
93126
|
* tree. `{name}` is the item's words, `{position}` its place among its
|
|
92090
93127
|
* siblings, counting from 1, and `{count}` the number of siblings.
|
|
@@ -93386,6 +94423,8 @@ export type CustomCssProperties = {
|
|
|
93386
94423
|
"--badge-font-weight"?: (string) | undefined;
|
|
93387
94424
|
/** The space between the content and the count under `placement="inline"`. */
|
|
93388
94425
|
"--badge-gap"?: (string) | undefined;
|
|
94426
|
+
/** The size of an icon in the `icon` slot. The count's own size by default. */
|
|
94427
|
+
"--badge-icon-size"?: (string) | undefined;
|
|
93389
94428
|
/** Pulls the mark in from the corner, along both axes. */
|
|
93390
94429
|
"--badge-offset"?: (string) | undefined;
|
|
93391
94430
|
/** How far the indicator's corners are rounded. */
|
|
@@ -94246,7 +95285,11 @@ export type CustomCssProperties = {
|
|
|
94246
95285
|
"--heatmap-rows"?: (string) | undefined;
|
|
94247
95286
|
/** The tone of the cell it is set on. The component writes it, and the stylesheet that paints the cell reads it. */
|
|
94248
95287
|
"--heatmap-tone"?: (string) | undefined;
|
|
94249
|
-
/**
|
|
95288
|
+
/** How long one turn, pulse or beat of `animation` takes. */
|
|
95289
|
+
"--icon-animation-duration"?: (string) | undefined;
|
|
95290
|
+
/** An angle the glyph is turned by, such as `45deg`. `rotate` wins over it. */
|
|
95291
|
+
"--icon-rotate"?: (string) | undefined;
|
|
95292
|
+
/** The width and height of the icon's box. The height alone under `auto-width`. */
|
|
94250
95293
|
"--icon-size"?: (string) | undefined;
|
|
94251
95294
|
/** The aspect ratio of the box, such as `16 / 9`. */
|
|
94252
95295
|
"--image-aspect"?: (string) | undefined;
|
|
@@ -95052,6 +96095,8 @@ export type CustomCssProperties = {
|
|
|
95052
96095
|
"--skeleton-color"?: (string) | undefined;
|
|
95053
96096
|
/** How long one sweep or one pulse takes. */
|
|
95054
96097
|
"--skeleton-duration"?: (string) | undefined;
|
|
96098
|
+
/** The width of the last line of a `lines` paragraph. Defaults to 60%. */
|
|
96099
|
+
"--skeleton-last-line-size"?: (string) | undefined;
|
|
95055
96100
|
/** The corner of the block shape. */
|
|
95056
96101
|
"--skeleton-radius"?: (string) | undefined;
|
|
95057
96102
|
/** The highlight the sweep carries across the fill. */
|
|
@@ -95088,6 +96133,8 @@ export type CustomCssProperties = {
|
|
|
95088
96133
|
"--slider-marker-color"?: (string) | undefined;
|
|
95089
96134
|
/** The color of the thumb. */
|
|
95090
96135
|
"--slider-thumb-color"?: (string) | undefined;
|
|
96136
|
+
/** The color of content in the `thumb` and `thumb-end` slots, drawn on the thumb. */
|
|
96137
|
+
"--slider-thumb-content-color"?: (string) | undefined;
|
|
95091
96138
|
/** The thumb's size along the track. It follows `--slider-thumb-size` unless you set it, and setting one of the two makes the thumb an oval. */
|
|
95092
96139
|
"--slider-thumb-length"?: (string) | undefined;
|
|
95093
96140
|
/** The thumb's corner radius. It is fully round by default, so a thumb with two different dimensions is a capsule unless you change it. */
|
|
@@ -95106,7 +96153,7 @@ export type CustomCssProperties = {
|
|
|
95106
96153
|
"--slider-track-image"?: (string) | undefined;
|
|
95107
96154
|
/** The thickness of the track. It matches the progress bar's size by default. */
|
|
95108
96155
|
"--slider-track-size"?: (string) | undefined;
|
|
95109
|
-
/** Where a bubble's thumb is, as a fraction of the track, 0 to 1. Set on each `tooltip` part. */
|
|
96156
|
+
/** Where a bubble's or a thumb box's thumb is, as a fraction of the track, 0 to 1. Set on each `tooltip` and `thumb` part. */
|
|
95110
96157
|
"--slider-at"?: (string) | undefined;
|
|
95111
96158
|
/** The value as a fraction of the range, 0 to 1. */
|
|
95112
96159
|
"--slider-fraction"?: (string) | undefined;
|
|
@@ -95308,12 +96355,16 @@ export type CustomCssProperties = {
|
|
|
95308
96355
|
"--tabs-indicator-thickness"?: (string) | undefined;
|
|
95309
96356
|
/** The color of the rule under the row in `underlined`. */
|
|
95310
96357
|
"--tabs-rule-color"?: (string) | undefined;
|
|
96358
|
+
/** The fill behind the scroll buttons, over the tabs that pass under them. */
|
|
96359
|
+
"--tabs-scroll-background-color"?: (string) | undefined;
|
|
95311
96360
|
/** The height of a tab. `segmented` sizes its tabs to the track and does not read it. */
|
|
95312
96361
|
"--tabs-tab-block-size"?: (string) | undefined;
|
|
95313
96362
|
/** The label color of a tab that is not current. */
|
|
95314
96363
|
"--tabs-tab-color"?: (string) | undefined;
|
|
95315
96364
|
/** How faint a disabled tab is drawn. */
|
|
95316
96365
|
"--tabs-tab-disabled-opacity"?: (string) | undefined;
|
|
96366
|
+
/** The color of the mark that closes a `dismissible` tab. */
|
|
96367
|
+
"--tabs-tab-dismiss-color"?: (string) | undefined;
|
|
95317
96368
|
/** The size of a tab's label. */
|
|
95318
96369
|
"--tabs-tab-font-size"?: (string) | undefined;
|
|
95319
96370
|
/** The weight of a tab's label. */
|