@fusion.dev/helix 0.147.0 → 0.148.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 +4297 -489
- package/dist/announcement/root/announcement-root.css.js +1 -1
- package/dist/blockquote/root/blockquote-root.css.js +1 -1
- package/dist/blockquote/root/blockquote-root.d.ts +8 -2
- package/dist/button-group/root/button-group-root.css.js +10 -1
- package/dist/button-group/root/button-group-root.d.ts +29 -7
- package/dist/button-group/root/button-group-root.js +19 -0
- package/dist/canvas/node/canvas-node.css.js +6 -6
- package/dist/canvas/node/canvas-node.d.ts +5 -0
- package/dist/canvas/root/canvas-root.css.js +6 -2
- package/dist/canvas/root/canvas-root.d.ts +6 -0
- package/dist/card/root/card-root.css.js +3 -3
- package/dist/card/root/card-root.d.ts +4 -0
- package/dist/code-block/root/code-block-root.css.js +17 -9
- package/dist/code-block/root/code-block-root.d.ts +7 -0
- package/dist/combobox/root/combobox-root.js +2 -0
- package/dist/description-list/item/description-list-item.css.js +1 -1
- package/dist/description-list/item/description-list-item.d.ts +1 -0
- package/dist/description-list/root/description-list-root.css.js +2 -1
- package/dist/description-list/root/description-list-root.d.ts +12 -0
- package/dist/description-list/root/description-list-root.js +7 -0
- package/dist/divider/root/divider-root.css.js +3 -4
- package/dist/divider/root/divider-root.d.ts +3 -0
- package/dist/element-events.generated.js +1 -0
- package/dist/format-date/root/format-date-root.css.js +1 -1
- package/dist/format-date/root/format-date-root.d.ts +0 -1
- package/dist/format-date/root/format-date-root.js +0 -1
- package/dist/listbox/root/listbox-root.css.js +4 -1
- package/dist/listbox/root/listbox-root.d.ts +2 -0
- package/dist/listbox/root/listbox-root.js +1 -0
- package/dist/map/root/map-root.css.js +10 -6
- package/dist/map/root/map-root.d.ts +10 -0
- package/dist/notifications/root/notifications-root.css.js +1 -1
- package/dist/notifications/root/notifications-root.d.ts +4 -1
- package/dist/pagination/root/pagination-root.css.js +7 -7
- package/dist/pagination/root/pagination-root.d.ts +14 -0
- package/dist/pagination/size/pagination-size.css.js +1 -1
- package/dist/pagination/size/pagination-size.d.ts +3 -0
- package/dist/pagination/summary/pagination-summary.css.js +1 -1
- package/dist/pagination/summary/pagination-summary.d.ts +3 -0
- package/dist/qr-code/root/qr-code-root.css.js +1 -1
- package/dist/qr-code/root/qr-code-root.d.ts +3 -0
- package/dist/sandbox/preview/sandbox-preview.d.ts +9 -1
- package/dist/sandbox/preview/sandbox-preview.js +1 -1
- package/dist/select/root/select-root.css.js +4 -1
- package/dist/select/root/select-root.js +2 -0
- package/dist/shared/viewport/viewport.css.js +1 -1
- package/dist/speed-dial/group/speed-dial-group.css.d.ts +1 -0
- package/dist/speed-dial/group/speed-dial-group.css.js +2 -0
- package/dist/speed-dial/group/speed-dial-group.d.ts +27 -0
- package/dist/speed-dial/group/speed-dial-group.js +16 -0
- package/dist/speed-dial/index.d.ts +1 -0
- package/dist/speed-dial/index.js +1 -0
- package/dist/speed-dial/item/speed-dial-item.css.js +1 -1
- package/dist/speed-dial/item/speed-dial-item.d.ts +1 -0
- package/dist/speed-dial/root/speed-dial-root.css.js +1 -1
- package/dist/splitter/root/splitter-root.css.js +15 -7
- package/dist/splitter/root/splitter-root.d.ts +4 -0
- package/dist/table/cell/table-cell.css.js +1 -1
- package/dist/table/root/table-root.css.js +1 -1
- package/dist/table/row/table-row.css.js +1 -1
- package/dist/time-picker/root/time-picker-root.css.js +9 -4
- package/dist/time-picker/root/time-picker-root.d.ts +6 -0
- package/dist/toast/item/toast-item.css.js +9 -6
- package/dist/toast/item/toast-item.d.ts +10 -0
- package/dist/toolbar/root/toolbar-root.css.js +1 -1
- package/dist/toolbar/root/toolbar-root.d.ts +9 -0
- package/dist/toolbar/root/toolbar-root.js +4 -0
- package/lint.json +1 -1
- package/package.json +6 -6
- package/types/jsx.d.ts +1809 -176
- package/types/svelte.d.ts +1 -0
- package/types/vue.d.ts +505 -44
package/types/jsx.d.ts
CHANGED
|
@@ -202,6 +202,7 @@ import type {
|
|
|
202
202
|
HelixSortedEvent,
|
|
203
203
|
HelixSparkline,
|
|
204
204
|
HelixSpeedDial,
|
|
205
|
+
HelixSpeedDialGroup,
|
|
205
206
|
HelixSpeedDialItem,
|
|
206
207
|
HelixSplitEvent,
|
|
207
208
|
HelixSplitter,
|
|
@@ -873,6 +874,22 @@ would catch. */
|
|
|
873
874
|
Read once when the announcement is first rendered, as `Toast` reads its
|
|
874
875
|
own. The clock stops while the pointer or focus is on the announcement. */
|
|
875
876
|
duration?: (HelixAnnouncement["duration"]) | undefined;
|
|
877
|
+
/** The key that moves focus to the announcement's first control, and back
|
|
878
|
+
to where it was, written as keys joined by `+`, such as `F6` or `Alt+A`.
|
|
879
|
+
|
|
880
|
+
F6 by default, the key React Aria's regions answer to. Empty turns it
|
|
881
|
+
off. With several announcements, the first one in the page takes focus. */
|
|
882
|
+
hotkey?: (HelixAnnouncement["hotkey"]) | undefined;
|
|
883
|
+
/** The name of the announcement's region, which screen readers list among
|
|
884
|
+
the page's landmarks. Translate it with the rest of your interface.
|
|
885
|
+
|
|
886
|
+
Empty leaves the announcement no region. */
|
|
887
|
+
label?: (HelixAnnouncement["label"]) | undefined;
|
|
888
|
+
/** Whether the announcement waits its turn behind the queued announcements
|
|
889
|
+
before it in the same parent, showing when the last of them is removed.
|
|
890
|
+
|
|
891
|
+
Off by default, so every announcement on a page shows at once. */
|
|
892
|
+
queued?: (HelixAnnouncement["queued"]) | undefined;
|
|
876
893
|
/** The band's color.
|
|
877
894
|
|
|
878
895
|
Paint only: unlike `Callout`, no value here draws a mark, changes the label,
|
|
@@ -937,6 +954,22 @@ would catch. */
|
|
|
937
954
|
Read once when the announcement is first rendered, as `Toast` reads its
|
|
938
955
|
own. The clock stops while the pointer or focus is on the announcement. */
|
|
939
956
|
"prop:duration"?: (HelixAnnouncement["duration"]) | undefined;
|
|
957
|
+
/** The key that moves focus to the announcement's first control, and back
|
|
958
|
+
to where it was, written as keys joined by `+`, such as `F6` or `Alt+A`.
|
|
959
|
+
|
|
960
|
+
F6 by default, the key React Aria's regions answer to. Empty turns it
|
|
961
|
+
off. With several announcements, the first one in the page takes focus. */
|
|
962
|
+
"prop:hotkey"?: (HelixAnnouncement["hotkey"]) | undefined;
|
|
963
|
+
/** The name of the announcement's region, which screen readers list among
|
|
964
|
+
the page's landmarks. Translate it with the rest of your interface.
|
|
965
|
+
|
|
966
|
+
Empty leaves the announcement no region. */
|
|
967
|
+
"prop:label"?: (HelixAnnouncement["label"]) | undefined;
|
|
968
|
+
/** Whether the announcement waits its turn behind the queued announcements
|
|
969
|
+
before it in the same parent, showing when the last of them is removed.
|
|
970
|
+
|
|
971
|
+
Off by default, so every announcement on a page shows at once. */
|
|
972
|
+
"prop:queued"?: (HelixAnnouncement["queued"]) | undefined;
|
|
940
973
|
/** The band's color.
|
|
941
974
|
|
|
942
975
|
Paint only: unlike `Callout`, no value here draws a mark, changes the label,
|
|
@@ -2422,13 +2455,35 @@ second scale stack among themselves. */
|
|
|
2422
2455
|
};
|
|
2423
2456
|
|
|
2424
2457
|
export type HelixBlockquoteProps = {
|
|
2425
|
-
/**
|
|
2458
|
+
/** Who said it, and where, as words, such as "Maria Lopez, operations
|
|
2459
|
+
manager". The `attribution` slot replaces them, for markup such as a link.
|
|
2460
|
+
|
|
2461
|
+
Words are served with the figure they name, where a server cannot see a
|
|
2462
|
+
slotted attribution. */
|
|
2463
|
+
attribution?: (HelixBlockquote["attribution"]) | undefined;
|
|
2464
|
+
/** The URL of the source the passage came from. Who said it goes in
|
|
2465
|
+
`attribution`: a `cite` with words in it warns once, with the runtime kind
|
|
2466
|
+
`cite-not-url`. */
|
|
2426
2467
|
cite?: (HelixBlockquote["cite"]) | undefined;
|
|
2468
|
+
/** Whether to draw an opening quotation mark before the passage, in the
|
|
2469
|
+
element's language. Leave the marks out of the text. */
|
|
2470
|
+
marks?: (HelixBlockquote["marks"]) | undefined;
|
|
2427
2471
|
};
|
|
2428
2472
|
|
|
2429
2473
|
export type HelixBlockquoteSolidJsProps = {
|
|
2430
|
-
/**
|
|
2474
|
+
/** Who said it, and where, as words, such as "Maria Lopez, operations
|
|
2475
|
+
manager". The `attribution` slot replaces them, for markup such as a link.
|
|
2476
|
+
|
|
2477
|
+
Words are served with the figure they name, where a server cannot see a
|
|
2478
|
+
slotted attribution. */
|
|
2479
|
+
"prop:attribution"?: (HelixBlockquote["attribution"]) | undefined;
|
|
2480
|
+
/** The URL of the source the passage came from. Who said it goes in
|
|
2481
|
+
`attribution`: a `cite` with words in it warns once, with the runtime kind
|
|
2482
|
+
`cite-not-url`. */
|
|
2431
2483
|
"prop:cite"?: (HelixBlockquote["cite"]) | undefined;
|
|
2484
|
+
/** Whether to draw an opening quotation mark before the passage, in the
|
|
2485
|
+
element's language. Leave the marks out of the text. */
|
|
2486
|
+
"prop:marks"?: (HelixBlockquote["marks"]) | undefined;
|
|
2432
2487
|
|
|
2433
2488
|
/** Set the innerHTML of the element */
|
|
2434
2489
|
innerHTML?: (string) | undefined;
|
|
@@ -2578,7 +2633,20 @@ attribute would put the whole path into the markup twice. */
|
|
|
2578
2633
|
textContent?: (string | number) | undefined;
|
|
2579
2634
|
};
|
|
2580
2635
|
|
|
2636
|
+
/** `HelixButtonGroup` component event */
|
|
2637
|
+
export type HelixButtonGroupElementEvent<E = Event> = TypedEvent<
|
|
2638
|
+
HelixButtonGroup,
|
|
2639
|
+
E
|
|
2640
|
+
>;
|
|
2641
|
+
/** `helix-before-change` event type */
|
|
2642
|
+
export type HelixButtonGroupHelixBeforeChangeElementEvent =
|
|
2643
|
+
HelixButtonGroupElementEvent<HelixBeforeChangeEvent>;
|
|
2644
|
+
|
|
2581
2645
|
export type HelixButtonGroupProps = {
|
|
2646
|
+
/** The size of every button in the group: their height, text, padding and
|
|
2647
|
+
icons, from the density steps. Unset, the buttons take the size of the
|
|
2648
|
+
region around the group. */
|
|
2649
|
+
size?: (HelixButtonGroup["size"]) | undefined;
|
|
2582
2650
|
/** Whether the buttons are one bar or a spaced row.
|
|
2583
2651
|
|
|
2584
2652
|
Joined by default: one control made of parts, sharing borders, reading as a
|
|
@@ -2612,9 +2680,38 @@ buttons sharing edges as one shape, and a wrapped row carries the corners of
|
|
|
2612
2680
|
a first row into a second. Stacked, the same three keep one shape and one
|
|
2613
2681
|
column. */
|
|
2614
2682
|
orientation?: (HelixButtonGroup["orientation"]) | undefined;
|
|
2683
|
+
/** Whether the buttons stay pressed: `single` keeps one pressed at a time and
|
|
2684
|
+
`multiple` any number. Unset, they are action buttons, each its own tab
|
|
2685
|
+
stop, as before.
|
|
2686
|
+
|
|
2687
|
+
Optional, so the attribute is absent until a consumer writes it. */
|
|
2688
|
+
"selection-mode"?: (HelixButtonGroup["selectionMode"]) | undefined;
|
|
2689
|
+
/** Whether the buttons stay pressed: `single` keeps one pressed at a time and
|
|
2690
|
+
`multiple` any number. Unset, they are action buttons, each its own tab
|
|
2691
|
+
stop, as before.
|
|
2692
|
+
|
|
2693
|
+
Optional, so the attribute is absent until a consumer writes it. */
|
|
2694
|
+
selectionMode?: (HelixButtonGroup["selectionMode"]) | undefined;
|
|
2695
|
+
/** The values of the pressed buttons, comma separated, in a selection mode.
|
|
2696
|
+
A button's own `value` names it, so a value holds no comma.
|
|
2697
|
+
|
|
2698
|
+
The attribute is the seed, and a press changes the property, which does
|
|
2699
|
+
not reflect, as a native control's `value` does not. */
|
|
2700
|
+
value?: (HelixButtonGroup["value"]) | undefined;
|
|
2701
|
+
|
|
2702
|
+
/** Fired after a press changes `value`, in a selection mode. */
|
|
2703
|
+
onchange?: ((e: HelixButtonGroupElementEvent) => void) | undefined;
|
|
2704
|
+
/** Fired before a press changes `value`, with the value it would leave in `detail.value`. Cancelable: call `preventDefault()` to keep the buttons as they are. */
|
|
2705
|
+
"onhelix-before-change"?: ((
|
|
2706
|
+
e: HelixButtonGroupHelixBeforeChangeElementEvent,
|
|
2707
|
+
) => void) | undefined;
|
|
2615
2708
|
};
|
|
2616
2709
|
|
|
2617
2710
|
export type HelixButtonGroupSolidJsProps = {
|
|
2711
|
+
/** The size of every button in the group: their height, text, padding and
|
|
2712
|
+
icons, from the density steps. Unset, the buttons take the size of the
|
|
2713
|
+
region around the group. */
|
|
2714
|
+
"prop:size"?: (HelixButtonGroup["size"]) | undefined;
|
|
2618
2715
|
/** Whether the buttons are one bar or a spaced row.
|
|
2619
2716
|
|
|
2620
2717
|
Joined by default: one control made of parts, sharing borders, reading as a
|
|
@@ -2648,6 +2745,30 @@ buttons sharing edges as one shape, and a wrapped row carries the corners of
|
|
|
2648
2745
|
a first row into a second. Stacked, the same three keep one shape and one
|
|
2649
2746
|
column. */
|
|
2650
2747
|
"prop:orientation"?: (HelixButtonGroup["orientation"]) | undefined;
|
|
2748
|
+
/** Whether the buttons stay pressed: `single` keeps one pressed at a time and
|
|
2749
|
+
`multiple` any number. Unset, they are action buttons, each its own tab
|
|
2750
|
+
stop, as before.
|
|
2751
|
+
|
|
2752
|
+
Optional, so the attribute is absent until a consumer writes it. */
|
|
2753
|
+
"attr:selection-mode"?: (HelixButtonGroup["selectionMode"]) | undefined;
|
|
2754
|
+
/** Whether the buttons stay pressed: `single` keeps one pressed at a time and
|
|
2755
|
+
`multiple` any number. Unset, they are action buttons, each its own tab
|
|
2756
|
+
stop, as before.
|
|
2757
|
+
|
|
2758
|
+
Optional, so the attribute is absent until a consumer writes it. */
|
|
2759
|
+
"prop:selectionMode"?: (HelixButtonGroup["selectionMode"]) | undefined;
|
|
2760
|
+
/** The values of the pressed buttons, comma separated, in a selection mode.
|
|
2761
|
+
A button's own `value` names it, so a value holds no comma.
|
|
2762
|
+
|
|
2763
|
+
The attribute is the seed, and a press changes the property, which does
|
|
2764
|
+
not reflect, as a native control's `value` does not. */
|
|
2765
|
+
"prop:value"?: (HelixButtonGroup["value"]) | undefined;
|
|
2766
|
+
/** Fired after a press changes `value`, in a selection mode. */
|
|
2767
|
+
"on:change"?: ((e: HelixButtonGroupElementEvent) => void) | undefined;
|
|
2768
|
+
/** Fired before a press changes `value`, with the value it would leave in `detail.value`. Cancelable: call `preventDefault()` to keep the buttons as they are. */
|
|
2769
|
+
"on:helix-before-change"?: ((
|
|
2770
|
+
e: HelixButtonGroupHelixBeforeChangeElementEvent,
|
|
2771
|
+
) => void) | undefined;
|
|
2651
2772
|
|
|
2652
2773
|
/** Set the innerHTML of the element */
|
|
2653
2774
|
innerHTML?: (string) | undefined;
|
|
@@ -3827,6 +3948,20 @@ as the list.
|
|
|
3827
3948
|
The list is joined the way the page's language joins one, "Second and
|
|
3828
3949
|
Third", rather than with a comma this component chose. */
|
|
3829
3950
|
leadsToLabel?: (HelixCanvas["leadsToLabel"]) | undefined;
|
|
3951
|
+
/** What screen readers hear after a key moves a card, with `{name}` for the
|
|
3952
|
+
card and `{x}` and `{y}` for where it now is, in the document's units.
|
|
3953
|
+
|
|
3954
|
+
**A move a reader cannot see has to be said.** Shift with an arrow moved
|
|
3955
|
+
the card and said nothing, so a reader moving one by keys could not tell
|
|
3956
|
+
whether it had moved, or how far. */
|
|
3957
|
+
"moved-label"?: (HelixCanvas["movedLabel"]) | undefined;
|
|
3958
|
+
/** What screen readers hear after a key moves a card, with `{name}` for the
|
|
3959
|
+
card and `{x}` and `{y}` for where it now is, in the document's units.
|
|
3960
|
+
|
|
3961
|
+
**A move a reader cannot see has to be said.** Shift with an arrow moved
|
|
3962
|
+
the card and said nothing, so a reader moving one by keys could not tell
|
|
3963
|
+
whether it had moved, or how far. */
|
|
3964
|
+
movedLabel?: (HelixCanvas["movedLabel"]) | undefined;
|
|
3830
3965
|
/** The order the arrow keys and screen readers move through the cards:
|
|
3831
3966
|
`spatial` or `edges`.
|
|
3832
3967
|
|
|
@@ -3867,6 +4002,14 @@ walk the cards. */
|
|
|
3867
4002
|
/** The text announced when a connection's end is picked up, with `{from}` and
|
|
3868
4003
|
`{to}`. */
|
|
3869
4004
|
reconnectingLabel?: (HelixCanvas["reconnectingLabel"]) | undefined;
|
|
4005
|
+
/** What screen readers hear after a key resizes a card, with `{name}` for the
|
|
4006
|
+
card and `{width}` and `{height}` for its new size, in the document's
|
|
4007
|
+
units. */
|
|
4008
|
+
"resized-label"?: (HelixCanvas["resizedLabel"]) | undefined;
|
|
4009
|
+
/** What screen readers hear after a key resizes a card, with `{name}` for the
|
|
4010
|
+
card and `{width}` and `{height}` for its new size, in the document's
|
|
4011
|
+
units. */
|
|
4012
|
+
resizedLabel?: (HelixCanvas["resizedLabel"]) | undefined;
|
|
3870
4013
|
/** The names of the selected cards and connections, comma separated. Empty
|
|
3871
4014
|
when nothing is selected.
|
|
3872
4015
|
|
|
@@ -3887,6 +4030,43 @@ on its board across cards and connections both, and may not hold a comma.
|
|
|
3887
4030
|
|
|
3888
4031
|
Written to select from outside, and read to act on the selection. */
|
|
3889
4032
|
selected?: (HelixCanvas["selected"]) | undefined;
|
|
4033
|
+
/** What a selected card or connection adds to what screen readers hear on
|
|
4034
|
+
it, before its tone and its connections. Empty adds nothing.
|
|
4035
|
+
|
|
4036
|
+
A card is an article and a connection a button, and neither has a selected
|
|
4037
|
+
state for `aria-selected` to carry, so the state is said in words. */
|
|
4038
|
+
"selected-label"?: (HelixCanvas["selectedLabel"]) | undefined;
|
|
4039
|
+
/** What a selected card or connection adds to what screen readers hear on
|
|
4040
|
+
it, before its tone and its connections. Empty adds nothing.
|
|
4041
|
+
|
|
4042
|
+
A card is an article and a connection a button, and neither has a selected
|
|
4043
|
+
state for `aria-selected` to carry, so the state is said in words. */
|
|
4044
|
+
selectedLabel?: (HelixCanvas["selectedLabel"]) | undefined;
|
|
4045
|
+
/** What screen readers hear after the selection grows or shrinks, with
|
|
4046
|
+
`{count}` for how many cards and connections are selected: by Space, a
|
|
4047
|
+
click with Shift, Command or Control, Command or Control with A, a box
|
|
4048
|
+
drawn across the board, or Escape.
|
|
4049
|
+
|
|
4050
|
+
A selection of one made by arriving on a card or clicking it is not said,
|
|
4051
|
+
since the card is. */
|
|
4052
|
+
"selection-label"?: (HelixCanvas["selectionLabel"]) | undefined;
|
|
4053
|
+
/** What screen readers hear after the selection grows or shrinks, with
|
|
4054
|
+
`{count}` for how many cards and connections are selected: by Space, a
|
|
4055
|
+
click with Shift, Command or Control, Command or Control with A, a box
|
|
4056
|
+
drawn across the board, or Escape.
|
|
4057
|
+
|
|
4058
|
+
A selection of one made by arriving on a card or clicking it is not said,
|
|
4059
|
+
since the card is. */
|
|
4060
|
+
selectionLabel?: (HelixCanvas["selectionLabel"]) | undefined;
|
|
4061
|
+
/** Snaps the cards a reader moves or resizes to a multiple of this many of the
|
|
4062
|
+
document's units, such as `32` to land on the lines `grid` draws.
|
|
4063
|
+
|
|
4064
|
+
**A drag lets go on the nearest line and a key goes to the next one.**
|
|
4065
|
+
Shift with an arrow moves a card to the next line that way, rather than
|
|
4066
|
+
by its step of 16, and Alt with an arrow moves its bottom right corner
|
|
4067
|
+
the same way. A group moves with what it carries, so a card inside one
|
|
4068
|
+
keeps its place in it. Absent, cards land where they are let go. */
|
|
4069
|
+
snap?: (HelixCanvas["snap"]) | undefined;
|
|
3890
4070
|
/** The text announced when a connection is stopped before it is requested. */
|
|
3891
4071
|
"stopped-label"?: (HelixCanvas["stoppedLabel"]) | undefined;
|
|
3892
4072
|
/** The text announced when a connection is stopped before it is requested. */
|
|
@@ -3909,6 +4089,12 @@ red is "blocked" on one board and "urgent" on the next. A reader who can
|
|
|
3909
4089
|
see the board is told by the color; this is how a reader who cannot is
|
|
3910
4090
|
told the same. A tone left out is not read. */
|
|
3911
4091
|
toneLabels?: (HelixCanvas["toneLabels"]) | undefined;
|
|
4092
|
+
/** What screen readers hear after a zoom button or key, with `{zoom}` for the
|
|
4093
|
+
zoom as a percentage, written the way the page's language writes one. */
|
|
4094
|
+
"zoomed-label"?: (HelixCanvas["zoomedLabel"]) | undefined;
|
|
4095
|
+
/** What screen readers hear after a zoom button or key, with `{zoom}` for the
|
|
4096
|
+
zoom as a percentage, written the way the page's language writes one. */
|
|
4097
|
+
zoomedLabel?: (HelixCanvas["zoomedLabel"]) | undefined;
|
|
3912
4098
|
/** The board's current view: the document's point at the middle of the view,
|
|
3913
4099
|
and the zoom.
|
|
3914
4100
|
|
|
@@ -4199,6 +4385,20 @@ as the list.
|
|
|
4199
4385
|
The list is joined the way the page's language joins one, "Second and
|
|
4200
4386
|
Third", rather than with a comma this component chose. */
|
|
4201
4387
|
"prop:leadsToLabel"?: (HelixCanvas["leadsToLabel"]) | undefined;
|
|
4388
|
+
/** What screen readers hear after a key moves a card, with `{name}` for the
|
|
4389
|
+
card and `{x}` and `{y}` for where it now is, in the document's units.
|
|
4390
|
+
|
|
4391
|
+
**A move a reader cannot see has to be said.** Shift with an arrow moved
|
|
4392
|
+
the card and said nothing, so a reader moving one by keys could not tell
|
|
4393
|
+
whether it had moved, or how far. */
|
|
4394
|
+
"attr:moved-label"?: (HelixCanvas["movedLabel"]) | undefined;
|
|
4395
|
+
/** What screen readers hear after a key moves a card, with `{name}` for the
|
|
4396
|
+
card and `{x}` and `{y}` for where it now is, in the document's units.
|
|
4397
|
+
|
|
4398
|
+
**A move a reader cannot see has to be said.** Shift with an arrow moved
|
|
4399
|
+
the card and said nothing, so a reader moving one by keys could not tell
|
|
4400
|
+
whether it had moved, or how far. */
|
|
4401
|
+
"prop:movedLabel"?: (HelixCanvas["movedLabel"]) | undefined;
|
|
4202
4402
|
/** The order the arrow keys and screen readers move through the cards:
|
|
4203
4403
|
`spatial` or `edges`.
|
|
4204
4404
|
|
|
@@ -4239,6 +4439,14 @@ walk the cards. */
|
|
|
4239
4439
|
/** The text announced when a connection's end is picked up, with `{from}` and
|
|
4240
4440
|
`{to}`. */
|
|
4241
4441
|
"prop:reconnectingLabel"?: (HelixCanvas["reconnectingLabel"]) | undefined;
|
|
4442
|
+
/** What screen readers hear after a key resizes a card, with `{name}` for the
|
|
4443
|
+
card and `{width}` and `{height}` for its new size, in the document's
|
|
4444
|
+
units. */
|
|
4445
|
+
"attr:resized-label"?: (HelixCanvas["resizedLabel"]) | undefined;
|
|
4446
|
+
/** What screen readers hear after a key resizes a card, with `{name}` for the
|
|
4447
|
+
card and `{width}` and `{height}` for its new size, in the document's
|
|
4448
|
+
units. */
|
|
4449
|
+
"prop:resizedLabel"?: (HelixCanvas["resizedLabel"]) | undefined;
|
|
4242
4450
|
/** The names of the selected cards and connections, comma separated. Empty
|
|
4243
4451
|
when nothing is selected.
|
|
4244
4452
|
|
|
@@ -4259,6 +4467,43 @@ on its board across cards and connections both, and may not hold a comma.
|
|
|
4259
4467
|
|
|
4260
4468
|
Written to select from outside, and read to act on the selection. */
|
|
4261
4469
|
"prop:selected"?: (HelixCanvas["selected"]) | undefined;
|
|
4470
|
+
/** What a selected card or connection adds to what screen readers hear on
|
|
4471
|
+
it, before its tone and its connections. Empty adds nothing.
|
|
4472
|
+
|
|
4473
|
+
A card is an article and a connection a button, and neither has a selected
|
|
4474
|
+
state for `aria-selected` to carry, so the state is said in words. */
|
|
4475
|
+
"attr:selected-label"?: (HelixCanvas["selectedLabel"]) | undefined;
|
|
4476
|
+
/** What a selected card or connection adds to what screen readers hear on
|
|
4477
|
+
it, before its tone and its connections. Empty adds nothing.
|
|
4478
|
+
|
|
4479
|
+
A card is an article and a connection a button, and neither has a selected
|
|
4480
|
+
state for `aria-selected` to carry, so the state is said in words. */
|
|
4481
|
+
"prop:selectedLabel"?: (HelixCanvas["selectedLabel"]) | undefined;
|
|
4482
|
+
/** What screen readers hear after the selection grows or shrinks, with
|
|
4483
|
+
`{count}` for how many cards and connections are selected: by Space, a
|
|
4484
|
+
click with Shift, Command or Control, Command or Control with A, a box
|
|
4485
|
+
drawn across the board, or Escape.
|
|
4486
|
+
|
|
4487
|
+
A selection of one made by arriving on a card or clicking it is not said,
|
|
4488
|
+
since the card is. */
|
|
4489
|
+
"attr:selection-label"?: (HelixCanvas["selectionLabel"]) | undefined;
|
|
4490
|
+
/** What screen readers hear after the selection grows or shrinks, with
|
|
4491
|
+
`{count}` for how many cards and connections are selected: by Space, a
|
|
4492
|
+
click with Shift, Command or Control, Command or Control with A, a box
|
|
4493
|
+
drawn across the board, or Escape.
|
|
4494
|
+
|
|
4495
|
+
A selection of one made by arriving on a card or clicking it is not said,
|
|
4496
|
+
since the card is. */
|
|
4497
|
+
"prop:selectionLabel"?: (HelixCanvas["selectionLabel"]) | undefined;
|
|
4498
|
+
/** Snaps the cards a reader moves or resizes to a multiple of this many of the
|
|
4499
|
+
document's units, such as `32` to land on the lines `grid` draws.
|
|
4500
|
+
|
|
4501
|
+
**A drag lets go on the nearest line and a key goes to the next one.**
|
|
4502
|
+
Shift with an arrow moves a card to the next line that way, rather than
|
|
4503
|
+
by its step of 16, and Alt with an arrow moves its bottom right corner
|
|
4504
|
+
the same way. A group moves with what it carries, so a card inside one
|
|
4505
|
+
keeps its place in it. Absent, cards land where they are let go. */
|
|
4506
|
+
"prop:snap"?: (HelixCanvas["snap"]) | undefined;
|
|
4262
4507
|
/** The text announced when a connection is stopped before it is requested. */
|
|
4263
4508
|
"attr:stopped-label"?: (HelixCanvas["stoppedLabel"]) | undefined;
|
|
4264
4509
|
/** The text announced when a connection is stopped before it is requested. */
|
|
@@ -4281,6 +4526,12 @@ red is "blocked" on one board and "urgent" on the next. A reader who can
|
|
|
4281
4526
|
see the board is told by the color; this is how a reader who cannot is
|
|
4282
4527
|
told the same. A tone left out is not read. */
|
|
4283
4528
|
"prop:toneLabels"?: (HelixCanvas["toneLabels"]) | undefined;
|
|
4529
|
+
/** What screen readers hear after a zoom button or key, with `{zoom}` for the
|
|
4530
|
+
zoom as a percentage, written the way the page's language writes one. */
|
|
4531
|
+
"attr:zoomed-label"?: (HelixCanvas["zoomedLabel"]) | undefined;
|
|
4532
|
+
/** What screen readers hear after a zoom button or key, with `{zoom}` for the
|
|
4533
|
+
zoom as a percentage, written the way the page's language writes one. */
|
|
4534
|
+
"prop:zoomedLabel"?: (HelixCanvas["zoomedLabel"]) | undefined;
|
|
4284
4535
|
/** The board's current view: the document's point at the middle of the view,
|
|
4285
4536
|
and the zoom.
|
|
4286
4537
|
|
|
@@ -6576,16 +6827,18 @@ block lays out. Not for a diff, whose files each scroll on their own. */
|
|
|
6576
6827
|
"expand-label"?: (HelixCodeBlock["expandLabel"]) | undefined;
|
|
6577
6828
|
/** The expand button's words while the cap hides lines. */
|
|
6578
6829
|
expandLabel?: (HelixCodeBlock["expandLabel"]) | undefined;
|
|
6579
|
-
/** The block's name, usually a file name
|
|
6830
|
+
/** The block's name, usually a file name, drawn in the header.
|
|
6580
6831
|
|
|
6581
|
-
|
|
6582
|
-
|
|
6832
|
+
Absent, the block is named by `language` where there is one. In a diff,
|
|
6833
|
+
each file is named from the patch, and this names a patch that carries no
|
|
6834
|
+
name of its own. */
|
|
6583
6835
|
label?: (HelixCodeBlock["label"]) | undefined;
|
|
6584
6836
|
/** The language the code is written in, such as `ts` or `css`, handed to
|
|
6585
6837
|
`highlight` as its second argument.
|
|
6586
6838
|
|
|
6587
|
-
|
|
6588
|
-
|
|
6839
|
+
A block with no `label` is named by it, in the header and on the copy
|
|
6840
|
+
button, as a docs site names a snippet by its language. Absent hands
|
|
6841
|
+
`highlight` an empty string and names nothing. */
|
|
6589
6842
|
language?: (HelixCodeBlock["language"]) | undefined;
|
|
6590
6843
|
/** Whether the lines are numbered in a gutter beside the code.
|
|
6591
6844
|
|
|
@@ -6715,16 +6968,18 @@ block lays out. Not for a diff, whose files each scroll on their own. */
|
|
|
6715
6968
|
"attr:expand-label"?: (HelixCodeBlock["expandLabel"]) | undefined;
|
|
6716
6969
|
/** The expand button's words while the cap hides lines. */
|
|
6717
6970
|
"prop:expandLabel"?: (HelixCodeBlock["expandLabel"]) | undefined;
|
|
6718
|
-
/** The block's name, usually a file name
|
|
6971
|
+
/** The block's name, usually a file name, drawn in the header.
|
|
6719
6972
|
|
|
6720
|
-
|
|
6721
|
-
|
|
6973
|
+
Absent, the block is named by `language` where there is one. In a diff,
|
|
6974
|
+
each file is named from the patch, and this names a patch that carries no
|
|
6975
|
+
name of its own. */
|
|
6722
6976
|
"prop:label"?: (HelixCodeBlock["label"]) | undefined;
|
|
6723
6977
|
/** The language the code is written in, such as `ts` or `css`, handed to
|
|
6724
6978
|
`highlight` as its second argument.
|
|
6725
6979
|
|
|
6726
|
-
|
|
6727
|
-
|
|
6980
|
+
A block with no `label` is named by it, in the header and on the copy
|
|
6981
|
+
button, as a docs site names a snippet by its language. Absent hands
|
|
6982
|
+
`highlight` an empty string and names nothing. */
|
|
6728
6983
|
"prop:language"?: (HelixCodeBlock["language"]) | undefined;
|
|
6729
6984
|
/** Whether the lines are numbered in a gutter beside the code.
|
|
6730
6985
|
|
|
@@ -8091,12 +8346,19 @@ leaves the field or presses Enter with nothing highlighted, and text that
|
|
|
8091
8346
|
names an option takes that option. Unlike `creatable`, no event asks
|
|
8092
8347
|
first and no option is expected to be added: the value is the text. */
|
|
8093
8348
|
allowsCustomValue?: (HelixCombobox["allowsCustomValue"]) | undefined;
|
|
8094
|
-
/** What the browser may autofill
|
|
8349
|
+
/** What the browser may autofill, as a platform token such as `country`.
|
|
8095
8350
|
|
|
8096
8351
|
**Defaults to `off`, which is not the platform's default and is the
|
|
8097
8352
|
point.** The field filters a list rather than collecting a value, so a
|
|
8098
8353
|
browser offering to fill it with a saved address is competing for the same
|
|
8099
|
-
keystrokes as the listbox. A consumer who wants autofill can still ask.
|
|
8354
|
+
keystrokes as the listbox. A consumer who wants autofill can still ask.
|
|
8355
|
+
|
|
8356
|
+
Set, a combobox whose answer is one of its options keeps a hidden native
|
|
8357
|
+
`<select>` with the same options for the browser to fill, as React Aria's
|
|
8358
|
+
combobox and Select do, and the option the browser picks, by its value or
|
|
8359
|
+
its words, becomes the value. The text field itself stays `off`, so the
|
|
8360
|
+
browser fills the answer and not the filter. With `allows-custom-value`
|
|
8361
|
+
the token goes on the text field, whose words are the answer. */
|
|
8100
8362
|
autocomplete?: (HelixCombobox["autocomplete"]) | undefined;
|
|
8101
8363
|
/** Whether the user can add a value that is not in the list.
|
|
8102
8364
|
|
|
@@ -8135,12 +8397,14 @@ every keystroke. See Listbox's `filter-delay`. */
|
|
|
8135
8397
|
/** The list's name, read by screen readers. The list has no visible name. */
|
|
8136
8398
|
listLabel?: (HelixCombobox["listLabel"]) | undefined;
|
|
8137
8399
|
/** What the list says when its options could not be loaded, such as after a
|
|
8138
|
-
request to a server fails. Empty
|
|
8139
|
-
|
|
8400
|
+
request to a server fails. Empty, null or no attribute is no error, so
|
|
8401
|
+
removing the attribute clears it. Passed to the list, which shows it
|
|
8402
|
+
under any options there are and tells screen readers. */
|
|
8140
8403
|
"load-error"?: (HelixCombobox["loadError"]) | undefined;
|
|
8141
8404
|
/** What the list says when its options could not be loaded, such as after a
|
|
8142
|
-
request to a server fails. Empty
|
|
8143
|
-
|
|
8405
|
+
request to a server fails. Empty, null or no attribute is no error, so
|
|
8406
|
+
removing the attribute clears it. Passed to the list, which shows it
|
|
8407
|
+
under any options there are and tells screen readers. */
|
|
8144
8408
|
loadError?: (HelixCombobox["loadError"]) | undefined;
|
|
8145
8409
|
/** Whether the options are still loading.
|
|
8146
8410
|
|
|
@@ -8223,6 +8487,12 @@ two. */
|
|
|
8223
8487
|
options. `{count}` is the count, and `Intl.PluralRules` picks between the
|
|
8224
8488
|
two. */
|
|
8225
8489
|
resultsLabel?: (HelixCombobox["resultsLabel"]) | undefined;
|
|
8490
|
+
/** What VoiceOver hears for a chosen option, as the highlight reaches it and
|
|
8491
|
+
once it is chosen, on Apple devices. `{name}` is the option's words. */
|
|
8492
|
+
"selected-label"?: (HelixCombobox["selectedLabel"]) | undefined;
|
|
8493
|
+
/** What VoiceOver hears for a chosen option, as the highlight reaches it and
|
|
8494
|
+
once it is chosen, on Apple devices. `{name}` is the option's words. */
|
|
8495
|
+
selectedLabel?: (HelixCombobox["selectedLabel"]) | undefined;
|
|
8226
8496
|
/** Whether the field completes the word as the user types.
|
|
8227
8497
|
|
|
8228
8498
|
`suggest` rather than `autocomplete`, which is a real HTML attribute this
|
|
@@ -8387,12 +8657,19 @@ leaves the field or presses Enter with nothing highlighted, and text that
|
|
|
8387
8657
|
names an option takes that option. Unlike `creatable`, no event asks
|
|
8388
8658
|
first and no option is expected to be added: the value is the text. */
|
|
8389
8659
|
"prop:allowsCustomValue"?: (HelixCombobox["allowsCustomValue"]) | undefined;
|
|
8390
|
-
/** What the browser may autofill
|
|
8660
|
+
/** What the browser may autofill, as a platform token such as `country`.
|
|
8391
8661
|
|
|
8392
8662
|
**Defaults to `off`, which is not the platform's default and is the
|
|
8393
8663
|
point.** The field filters a list rather than collecting a value, so a
|
|
8394
8664
|
browser offering to fill it with a saved address is competing for the same
|
|
8395
|
-
keystrokes as the listbox. A consumer who wants autofill can still ask.
|
|
8665
|
+
keystrokes as the listbox. A consumer who wants autofill can still ask.
|
|
8666
|
+
|
|
8667
|
+
Set, a combobox whose answer is one of its options keeps a hidden native
|
|
8668
|
+
`<select>` with the same options for the browser to fill, as React Aria's
|
|
8669
|
+
combobox and Select do, and the option the browser picks, by its value or
|
|
8670
|
+
its words, becomes the value. The text field itself stays `off`, so the
|
|
8671
|
+
browser fills the answer and not the filter. With `allows-custom-value`
|
|
8672
|
+
the token goes on the text field, whose words are the answer. */
|
|
8396
8673
|
"prop:autocomplete"?: (HelixCombobox["autocomplete"]) | undefined;
|
|
8397
8674
|
/** Whether the user can add a value that is not in the list.
|
|
8398
8675
|
|
|
@@ -8431,12 +8708,14 @@ every keystroke. See Listbox's `filter-delay`. */
|
|
|
8431
8708
|
/** The list's name, read by screen readers. The list has no visible name. */
|
|
8432
8709
|
"prop:listLabel"?: (HelixCombobox["listLabel"]) | undefined;
|
|
8433
8710
|
/** What the list says when its options could not be loaded, such as after a
|
|
8434
|
-
request to a server fails. Empty
|
|
8435
|
-
|
|
8711
|
+
request to a server fails. Empty, null or no attribute is no error, so
|
|
8712
|
+
removing the attribute clears it. Passed to the list, which shows it
|
|
8713
|
+
under any options there are and tells screen readers. */
|
|
8436
8714
|
"attr:load-error"?: (HelixCombobox["loadError"]) | undefined;
|
|
8437
8715
|
/** What the list says when its options could not be loaded, such as after a
|
|
8438
|
-
request to a server fails. Empty
|
|
8439
|
-
|
|
8716
|
+
request to a server fails. Empty, null or no attribute is no error, so
|
|
8717
|
+
removing the attribute clears it. Passed to the list, which shows it
|
|
8718
|
+
under any options there are and tells screen readers. */
|
|
8440
8719
|
"prop:loadError"?: (HelixCombobox["loadError"]) | undefined;
|
|
8441
8720
|
/** Whether the options are still loading.
|
|
8442
8721
|
|
|
@@ -8519,6 +8798,12 @@ two. */
|
|
|
8519
8798
|
options. `{count}` is the count, and `Intl.PluralRules` picks between the
|
|
8520
8799
|
two. */
|
|
8521
8800
|
"prop:resultsLabel"?: (HelixCombobox["resultsLabel"]) | undefined;
|
|
8801
|
+
/** What VoiceOver hears for a chosen option, as the highlight reaches it and
|
|
8802
|
+
once it is chosen, on Apple devices. `{name}` is the option's words. */
|
|
8803
|
+
"attr:selected-label"?: (HelixCombobox["selectedLabel"]) | undefined;
|
|
8804
|
+
/** What VoiceOver hears for a chosen option, as the highlight reaches it and
|
|
8805
|
+
once it is chosen, on Apple devices. `{name}` is the option's words. */
|
|
8806
|
+
"prop:selectedLabel"?: (HelixCombobox["selectedLabel"]) | undefined;
|
|
8522
8807
|
/** Whether the field completes the word as the user types.
|
|
8523
8808
|
|
|
8524
8809
|
`suggest` rather than `autocomplete`, which is a real HTML attribute this
|
|
@@ -8652,12 +8937,14 @@ with: one key, said once. */
|
|
|
8652
8937
|
/** Accessible name for the overlay, which has no visible heading. */
|
|
8653
8938
|
label?: (HelixCommand["label"]) | undefined;
|
|
8654
8939
|
/** What the list says when its commands could not be loaded, such as after a
|
|
8655
|
-
request to a server fails. Empty
|
|
8656
|
-
|
|
8940
|
+
request to a server fails. Empty, null or no attribute is no error, so
|
|
8941
|
+
removing the attribute clears it. Passed to the list, which shows it
|
|
8942
|
+
under any commands there are and tells screen readers. */
|
|
8657
8943
|
"load-error"?: (HelixCommand["loadError"]) | undefined;
|
|
8658
8944
|
/** What the list says when its commands could not be loaded, such as after a
|
|
8659
|
-
request to a server fails. Empty
|
|
8660
|
-
|
|
8945
|
+
request to a server fails. Empty, null or no attribute is no error, so
|
|
8946
|
+
removing the attribute clears it. Passed to the list, which shows it
|
|
8947
|
+
under any commands there are and tells screen readers. */
|
|
8661
8948
|
loadError?: (HelixCommand["loadError"]) | undefined;
|
|
8662
8949
|
/** Whether the commands are still loading, for a palette that asks a server
|
|
8663
8950
|
for them as the user types.
|
|
@@ -8748,12 +9035,14 @@ with: one key, said once. */
|
|
|
8748
9035
|
/** Accessible name for the overlay, which has no visible heading. */
|
|
8749
9036
|
"prop:label"?: (HelixCommand["label"]) | undefined;
|
|
8750
9037
|
/** What the list says when its commands could not be loaded, such as after a
|
|
8751
|
-
request to a server fails. Empty
|
|
8752
|
-
|
|
9038
|
+
request to a server fails. Empty, null or no attribute is no error, so
|
|
9039
|
+
removing the attribute clears it. Passed to the list, which shows it
|
|
9040
|
+
under any commands there are and tells screen readers. */
|
|
8753
9041
|
"attr:load-error"?: (HelixCommand["loadError"]) | undefined;
|
|
8754
9042
|
/** What the list says when its commands could not be loaded, such as after a
|
|
8755
|
-
request to a server fails. Empty
|
|
8756
|
-
|
|
9043
|
+
request to a server fails. Empty, null or no attribute is no error, so
|
|
9044
|
+
removing the attribute clears it. Passed to the list, which shows it
|
|
9045
|
+
under any commands there are and tells screen readers. */
|
|
8757
9046
|
"prop:loadError"?: (HelixCommand["loadError"]) | undefined;
|
|
8758
9047
|
/** Whether the commands are still loading, for a palette that asks a server
|
|
8759
9048
|
for them as the user types.
|
|
@@ -11260,6 +11549,10 @@ item finds them once it runs, and the served markup wraps them until then. */
|
|
|
11260
11549
|
};
|
|
11261
11550
|
|
|
11262
11551
|
export type HelixDescriptionListProps = {
|
|
11552
|
+
/** Draws a rule between one pair and the next, in the middle of the gap, as
|
|
11553
|
+
a details panel with many rows often does. Off by default, where space
|
|
11554
|
+
alone separates the pairs. */
|
|
11555
|
+
divided?: (HelixDescriptionList["divided"]) | undefined;
|
|
11263
11556
|
/** Where the values sit, beside their labels.
|
|
11264
11557
|
|
|
11265
11558
|
Absent, each value starts right after the label column. `between` sets it on
|
|
@@ -11304,6 +11597,10 @@ makes the list a named group. */
|
|
|
11304
11597
|
};
|
|
11305
11598
|
|
|
11306
11599
|
export type HelixDescriptionListSolidJsProps = {
|
|
11600
|
+
/** Draws a rule between one pair and the next, in the middle of the gap, as
|
|
11601
|
+
a details panel with many rows often does. Off by default, where space
|
|
11602
|
+
alone separates the pairs. */
|
|
11603
|
+
"prop:divided"?: (HelixDescriptionList["divided"]) | undefined;
|
|
11307
11604
|
/** Where the values sit, beside their labels.
|
|
11308
11605
|
|
|
11309
11606
|
Absent, each value starts right after the label column. `between` sets it on
|
|
@@ -11691,20 +11988,23 @@ Absent is the middle. `start` and `end` move it toward one end, with a
|
|
|
11691
11988
|
short length of line, `--divider-content-offset`, kept before or after it.
|
|
11692
11989
|
A divider with nothing set into it is one line whatever this says. */
|
|
11693
11990
|
contentPlacement?: (HelixDivider["contentPlacement"]) | undefined;
|
|
11694
|
-
/** Whether screen readers announce the line as a separator
|
|
11695
|
-
|
|
11696
|
-
|
|
11697
|
-
|
|
11698
|
-
|
|
11699
|
-
|
|
11700
|
-
|
|
11701
|
-
An opt-in, not a `decorative` opt-out, because a boolean attribute cannot
|
|
11702
|
-
be turned off: `decorative="false"` parses as `true`, which would put the
|
|
11703
|
-
quiet default out of reach from HTML and leave it settable only as a
|
|
11704
|
-
property. An opt-in is absent by default, which every reflected property
|
|
11705
|
-
here has to be. */
|
|
11991
|
+
/** Whether screen readers announce the line as a separator, which they now do
|
|
11992
|
+
by default.
|
|
11993
|
+
|
|
11994
|
+
It dates from when the line was decorative by default. It is still read,
|
|
11995
|
+
and it wins over `decorative`, so a divider written with it stays a
|
|
11996
|
+
separator. */
|
|
11706
11997
|
announced?: (HelixDivider["announced"]) | undefined;
|
|
11707
|
-
/**
|
|
11998
|
+
/** Takes the line out of the accessibility tree, for a rule that separates
|
|
11999
|
+
nothing: one under a heading, or between the facts of a byline.
|
|
12000
|
+
|
|
12001
|
+
Absent, the line is a separator, as `<hr>` is. Radix Separator's opt-out
|
|
12002
|
+
has the same name. It turns the role off because a boolean attribute that
|
|
12003
|
+
is on by default cannot be turned off from HTML. */
|
|
12004
|
+
decorative?: (HelixDivider["decorative"]) | undefined;
|
|
12005
|
+
/** The direction the line runs: `horizontal` or `vertical`.
|
|
12006
|
+
|
|
12007
|
+
Unset is horizontal, or across the toolbar the divider sits in. */
|
|
11708
12008
|
orientation?: (HelixDivider["orientation"]) | undefined;
|
|
11709
12009
|
};
|
|
11710
12010
|
|
|
@@ -11721,20 +12021,23 @@ Absent is the middle. `start` and `end` move it toward one end, with a
|
|
|
11721
12021
|
short length of line, `--divider-content-offset`, kept before or after it.
|
|
11722
12022
|
A divider with nothing set into it is one line whatever this says. */
|
|
11723
12023
|
"prop:contentPlacement"?: (HelixDivider["contentPlacement"]) | undefined;
|
|
11724
|
-
/** Whether screen readers announce the line as a separator
|
|
11725
|
-
|
|
11726
|
-
|
|
11727
|
-
|
|
11728
|
-
|
|
11729
|
-
|
|
11730
|
-
|
|
11731
|
-
An opt-in, not a `decorative` opt-out, because a boolean attribute cannot
|
|
11732
|
-
be turned off: `decorative="false"` parses as `true`, which would put the
|
|
11733
|
-
quiet default out of reach from HTML and leave it settable only as a
|
|
11734
|
-
property. An opt-in is absent by default, which every reflected property
|
|
11735
|
-
here has to be. */
|
|
12024
|
+
/** Whether screen readers announce the line as a separator, which they now do
|
|
12025
|
+
by default.
|
|
12026
|
+
|
|
12027
|
+
It dates from when the line was decorative by default. It is still read,
|
|
12028
|
+
and it wins over `decorative`, so a divider written with it stays a
|
|
12029
|
+
separator. */
|
|
11736
12030
|
"prop:announced"?: (HelixDivider["announced"]) | undefined;
|
|
11737
|
-
/**
|
|
12031
|
+
/** Takes the line out of the accessibility tree, for a rule that separates
|
|
12032
|
+
nothing: one under a heading, or between the facts of a byline.
|
|
12033
|
+
|
|
12034
|
+
Absent, the line is a separator, as `<hr>` is. Radix Separator's opt-out
|
|
12035
|
+
has the same name. It turns the role off because a boolean attribute that
|
|
12036
|
+
is on by default cannot be turned off from HTML. */
|
|
12037
|
+
"prop:decorative"?: (HelixDivider["decorative"]) | undefined;
|
|
12038
|
+
/** The direction the line runs: `horizontal` or `vertical`.
|
|
12039
|
+
|
|
12040
|
+
Unset is horizontal, or across the toolbar the divider sits in. */
|
|
11738
12041
|
"prop:orientation"?: (HelixDivider["orientation"]) | undefined;
|
|
11739
12042
|
|
|
11740
12043
|
/** Set the innerHTML of the element */
|
|
@@ -13747,6 +14050,14 @@ few characters and a date is not. */
|
|
|
13747
14050
|
elapsed?: (HelixFormatDate["elapsed"]) | undefined;
|
|
13748
14051
|
/** How the era is written, such as AD, where a date is shown. */
|
|
13749
14052
|
era?: (HelixFormatDate["era"]) | undefined;
|
|
14053
|
+
/** Draws each field of a date in a part of its own: `weekday`, `day`,
|
|
14054
|
+
`month`, `year`, `era`, `hour`, `minute`, `second`, `day-period` and
|
|
14055
|
+
`time-zone-name`, so `::part(year)` can set the year apart.
|
|
14056
|
+
|
|
14057
|
+
Off by default, which draws the date as one run of text, as Shoelace and
|
|
14058
|
+
Web Awesome do. An `elapsed` or `relative` reading is one phrase either
|
|
14059
|
+
way. */
|
|
14060
|
+
fields?: (HelixFormatDate["fields"]) | undefined;
|
|
13750
14061
|
/** Draws an `elapsed` or `relative` reading once and leaves it, where it
|
|
13751
14062
|
would otherwise move on as it goes stale.
|
|
13752
14063
|
|
|
@@ -13853,6 +14164,14 @@ few characters and a date is not. */
|
|
|
13853
14164
|
"prop:elapsed"?: (HelixFormatDate["elapsed"]) | undefined;
|
|
13854
14165
|
/** How the era is written, such as AD, where a date is shown. */
|
|
13855
14166
|
"prop:era"?: (HelixFormatDate["era"]) | undefined;
|
|
14167
|
+
/** Draws each field of a date in a part of its own: `weekday`, `day`,
|
|
14168
|
+
`month`, `year`, `era`, `hour`, `minute`, `second`, `day-period` and
|
|
14169
|
+
`time-zone-name`, so `::part(year)` can set the year apart.
|
|
14170
|
+
|
|
14171
|
+
Off by default, which draws the date as one run of text, as Shoelace and
|
|
14172
|
+
Web Awesome do. An `elapsed` or `relative` reading is one phrase either
|
|
14173
|
+
way. */
|
|
14174
|
+
"prop:fields"?: (HelixFormatDate["fields"]) | undefined;
|
|
13856
14175
|
/** Draws an `elapsed` or `relative` reading once and leaves it, where it
|
|
13857
14176
|
would otherwise move on as it goes stale.
|
|
13858
14177
|
|
|
@@ -14786,6 +15105,14 @@ calendar heatmap does: a week is a column, so the strip reads along the
|
|
|
14786
15105
|
line in weeks, from the right on a right-to-left page, and top to bottom in
|
|
14787
15106
|
days. */
|
|
14788
15107
|
rows?: (HelixHeatmap["rows"]) | undefined;
|
|
15108
|
+
/** What the readout adds for a selected cell, under `selection-mode`, after
|
|
15109
|
+
where the cell stands: "Day 1: 0 (1 of 14, selected)". Empty adds
|
|
15110
|
+
nothing. */
|
|
15111
|
+
"selected-label"?: (HelixHeatmap["selectedLabel"]) | undefined;
|
|
15112
|
+
/** What the readout adds for a selected cell, under `selection-mode`, after
|
|
15113
|
+
where the cell stands: "Day 1: 0 (1 of 14, selected)". Empty adds
|
|
15114
|
+
nothing. */
|
|
15115
|
+
selectedLabel?: (HelixHeatmap["selectedLabel"]) | undefined;
|
|
14789
15116
|
/** What the `selection` part says after the selection changes, with `{count}` for
|
|
14790
15117
|
how many cells are selected. */
|
|
14791
15118
|
"selection-label"?: (HelixHeatmap["selectionLabel"]) | undefined;
|
|
@@ -14937,6 +15264,14 @@ calendar heatmap does: a week is a column, so the strip reads along the
|
|
|
14937
15264
|
line in weeks, from the right on a right-to-left page, and top to bottom in
|
|
14938
15265
|
days. */
|
|
14939
15266
|
"prop:rows"?: (HelixHeatmap["rows"]) | undefined;
|
|
15267
|
+
/** What the readout adds for a selected cell, under `selection-mode`, after
|
|
15268
|
+
where the cell stands: "Day 1: 0 (1 of 14, selected)". Empty adds
|
|
15269
|
+
nothing. */
|
|
15270
|
+
"attr:selected-label"?: (HelixHeatmap["selectedLabel"]) | undefined;
|
|
15271
|
+
/** What the readout adds for a selected cell, under `selection-mode`, after
|
|
15272
|
+
where the cell stands: "Day 1: 0 (1 of 14, selected)". Empty adds
|
|
15273
|
+
nothing. */
|
|
15274
|
+
"prop:selectedLabel"?: (HelixHeatmap["selectedLabel"]) | undefined;
|
|
14940
15275
|
/** What the `selection` part says after the selection changes, with `{count}` for
|
|
14941
15276
|
how many cells are selected. */
|
|
14942
15277
|
"attr:selection-label"?: (HelixHeatmap["selectionLabel"]) | undefined;
|
|
@@ -17721,12 +18056,16 @@ and this one was the English a form in another language still spoke in
|
|
|
17721
18056
|
the bubble it raises on submit: `feedback` replaces the message under
|
|
17722
18057
|
the field and does not reach that one. */
|
|
17723
18058
|
valueMissingMessage?: (HelixListbox["valueMissingMessage"]) | undefined;
|
|
17724
|
-
/** What
|
|
18059
|
+
/** What a browser's autofill may choose, as a platform token such as
|
|
18060
|
+
`country` or `cc-exp-month`, as a native `<select>` takes it.
|
|
17725
18061
|
|
|
17726
|
-
|
|
17727
|
-
|
|
17728
|
-
|
|
17729
|
-
|
|
18062
|
+
Set, the list draws a hidden native `<select>` with the same options for
|
|
18063
|
+
the browser to fill, as React Aria's `HiddenSelect` does, and a fill
|
|
18064
|
+
chooses the option. `off`, the default, draws none.
|
|
18065
|
+
|
|
18066
|
+
**The filter field is never filled.** It narrows the list rather than
|
|
18067
|
+
collecting a value, so a browser offering it a saved address competes
|
|
18068
|
+
with the reader for the same keystrokes: it is always `off`. */
|
|
17730
18069
|
autocomplete?: (HelixListbox["autocomplete"]) | undefined;
|
|
17731
18070
|
/** The filter text the list starts with, when `filter` is not set. */
|
|
17732
18071
|
"default-filter"?: (HelixListbox["defaultFilter"]) | undefined;
|
|
@@ -17766,14 +18105,27 @@ act on the list the reader expects. */
|
|
|
17766
18105
|
"filter-label"?: (HelixListbox["filterLabel"]) | undefined;
|
|
17767
18106
|
/** Placeholder text for the filter field. */
|
|
17768
18107
|
filterLabel?: (HelixListbox["filterLabel"]) | undefined;
|
|
18108
|
+
/** How the options are laid out, which the arrow keys follow: `stack`, one
|
|
18109
|
+
under another, or `grid`, in rows and columns, as React Aria's `ListBox`
|
|
18110
|
+
lays out cards or photos. With `grid`, Up and Down move within a column,
|
|
18111
|
+
and Left and Right along the list, mirrored right to left.
|
|
18112
|
+
|
|
18113
|
+
The columns are the stylesheet's: the styled tier draws them at
|
|
18114
|
+
`--listbox-column-min-inline-size` or wider, and a headless list lays out
|
|
18115
|
+
`::part(items)` as it likes, since the keys read where each option is
|
|
18116
|
+
drawn. A list of `items` stays a stack. Left out, the list is a stack,
|
|
18117
|
+
and the host carries no attribute for it. */
|
|
18118
|
+
layout?: (HelixListbox["layout"]) | undefined;
|
|
17769
18119
|
/** What the list says when its options could not be loaded, such as after a
|
|
17770
|
-
request to a server fails. Empty is no error
|
|
18120
|
+
request to a server fails. Empty, null or no attribute is no error, so
|
|
18121
|
+
removing the attribute clears it.
|
|
17771
18122
|
|
|
17772
18123
|
Set, it shows under any options there are, in place of `empty-text` and
|
|
17773
18124
|
`loading-text`, and a screen reader hears it. Clear it when you ask again. */
|
|
17774
18125
|
"load-error"?: (HelixListbox["loadError"]) | undefined;
|
|
17775
18126
|
/** What the list says when its options could not be loaded, such as after a
|
|
17776
|
-
request to a server fails. Empty is no error
|
|
18127
|
+
request to a server fails. Empty, null or no attribute is no error, so
|
|
18128
|
+
removing the attribute clears it.
|
|
17777
18129
|
|
|
17778
18130
|
Set, it shows under any options there are, in place of `empty-text` and
|
|
17779
18131
|
`loading-text`, and a screen reader hears it. Clear it when you ask again. */
|
|
@@ -17817,6 +18169,12 @@ options. `{count}` is the count.
|
|
|
17817
18169
|
pair: a language with more forms than two picks the one for its `one` and
|
|
17818
18170
|
writes the rest here. */
|
|
17819
18171
|
resultsLabel?: (HelixListbox["resultsLabel"]) | undefined;
|
|
18172
|
+
/** What VoiceOver hears as the highlight reaches a chosen option from the
|
|
18173
|
+
filter field, on Apple devices. `{name}` is the option's words. */
|
|
18174
|
+
"selected-label"?: (HelixListbox["selectedLabel"]) | undefined;
|
|
18175
|
+
/** What VoiceOver hears as the highlight reaches a chosen option from the
|
|
18176
|
+
filter field, on Apple devices. `{name}` is the option's words. */
|
|
18177
|
+
selectedLabel?: (HelixListbox["selectedLabel"]) | undefined;
|
|
17820
18178
|
/** Whether the control is disabled and cannot be used.
|
|
17821
18179
|
|
|
17822
18180
|
Reflected, because the styled tier selects on it, and mirrored to
|
|
@@ -17843,6 +18201,23 @@ imperatively later, and nothing is hydrating by then.
|
|
|
17843
18201
|
|
|
17844
18202
|
Here rather than on each control. */
|
|
17845
18203
|
name?: (HelixListbox["name"]) | undefined;
|
|
18204
|
+
/** The options as data, for a list too long to draw whole: each a value,
|
|
18205
|
+
which is also its words, or a record with a `value`, a `label` and
|
|
18206
|
+
`disabled`. Set, the list draws only the options in sight, and the ones
|
|
18207
|
+
you write as children are not read.
|
|
18208
|
+
|
|
18209
|
+
**Every option is still reachable.** The keyboard, the typeahead, the
|
|
18210
|
+
filter and the value work over the whole set, and the option the keyboard
|
|
18211
|
+
is on is drawn wherever it is, so a screen reader is told about it. Each
|
|
18212
|
+
drawn option says its place in the set (`aria-posinset`, `aria-setsize`).
|
|
18213
|
+
React Aria virtualizes a `ListBox` with its `Virtualizer`; this is core's
|
|
18214
|
+
`VirtualizeController`.
|
|
18215
|
+
|
|
18216
|
+
**The list needs a height to scroll in**: the styled tier's
|
|
18217
|
+
`--listbox-max-block-size`, or a `max-block-size` on `::part(items)` in the
|
|
18218
|
+
headless tier. Import the Option family as well, whose elements are drawn.
|
|
18219
|
+
A server sends the list empty, and the options are drawn once it hydrates. */
|
|
18220
|
+
items?: (HelixListbox["items"]) | undefined;
|
|
17846
18221
|
/** Which option is chosen, as an index, or `-1` where none is.
|
|
17847
18222
|
|
|
17848
18223
|
`<select>`'s own pair, and this control is what stands in for one. The
|
|
@@ -17931,12 +18306,16 @@ and this one was the English a form in another language still spoke in
|
|
|
17931
18306
|
the bubble it raises on submit: `feedback` replaces the message under
|
|
17932
18307
|
the field and does not reach that one. */
|
|
17933
18308
|
"prop:valueMissingMessage"?: (HelixListbox["valueMissingMessage"]) | undefined;
|
|
17934
|
-
/** What
|
|
18309
|
+
/** What a browser's autofill may choose, as a platform token such as
|
|
18310
|
+
`country` or `cc-exp-month`, as a native `<select>` takes it.
|
|
17935
18311
|
|
|
17936
|
-
|
|
17937
|
-
|
|
17938
|
-
|
|
17939
|
-
|
|
18312
|
+
Set, the list draws a hidden native `<select>` with the same options for
|
|
18313
|
+
the browser to fill, as React Aria's `HiddenSelect` does, and a fill
|
|
18314
|
+
chooses the option. `off`, the default, draws none.
|
|
18315
|
+
|
|
18316
|
+
**The filter field is never filled.** It narrows the list rather than
|
|
18317
|
+
collecting a value, so a browser offering it a saved address competes
|
|
18318
|
+
with the reader for the same keystrokes: it is always `off`. */
|
|
17940
18319
|
"prop:autocomplete"?: (HelixListbox["autocomplete"]) | undefined;
|
|
17941
18320
|
/** The filter text the list starts with, when `filter` is not set. */
|
|
17942
18321
|
"attr:default-filter"?: (HelixListbox["defaultFilter"]) | undefined;
|
|
@@ -17976,14 +18355,27 @@ act on the list the reader expects. */
|
|
|
17976
18355
|
"attr:filter-label"?: (HelixListbox["filterLabel"]) | undefined;
|
|
17977
18356
|
/** Placeholder text for the filter field. */
|
|
17978
18357
|
"prop:filterLabel"?: (HelixListbox["filterLabel"]) | undefined;
|
|
18358
|
+
/** How the options are laid out, which the arrow keys follow: `stack`, one
|
|
18359
|
+
under another, or `grid`, in rows and columns, as React Aria's `ListBox`
|
|
18360
|
+
lays out cards or photos. With `grid`, Up and Down move within a column,
|
|
18361
|
+
and Left and Right along the list, mirrored right to left.
|
|
18362
|
+
|
|
18363
|
+
The columns are the stylesheet's: the styled tier draws them at
|
|
18364
|
+
`--listbox-column-min-inline-size` or wider, and a headless list lays out
|
|
18365
|
+
`::part(items)` as it likes, since the keys read where each option is
|
|
18366
|
+
drawn. A list of `items` stays a stack. Left out, the list is a stack,
|
|
18367
|
+
and the host carries no attribute for it. */
|
|
18368
|
+
"prop:layout"?: (HelixListbox["layout"]) | undefined;
|
|
17979
18369
|
/** What the list says when its options could not be loaded, such as after a
|
|
17980
|
-
request to a server fails. Empty is no error
|
|
18370
|
+
request to a server fails. Empty, null or no attribute is no error, so
|
|
18371
|
+
removing the attribute clears it.
|
|
17981
18372
|
|
|
17982
18373
|
Set, it shows under any options there are, in place of `empty-text` and
|
|
17983
18374
|
`loading-text`, and a screen reader hears it. Clear it when you ask again. */
|
|
17984
18375
|
"attr:load-error"?: (HelixListbox["loadError"]) | undefined;
|
|
17985
18376
|
/** What the list says when its options could not be loaded, such as after a
|
|
17986
|
-
request to a server fails. Empty is no error
|
|
18377
|
+
request to a server fails. Empty, null or no attribute is no error, so
|
|
18378
|
+
removing the attribute clears it.
|
|
17987
18379
|
|
|
17988
18380
|
Set, it shows under any options there are, in place of `empty-text` and
|
|
17989
18381
|
`loading-text`, and a screen reader hears it. Clear it when you ask again. */
|
|
@@ -18027,6 +18419,12 @@ options. `{count}` is the count.
|
|
|
18027
18419
|
pair: a language with more forms than two picks the one for its `one` and
|
|
18028
18420
|
writes the rest here. */
|
|
18029
18421
|
"prop:resultsLabel"?: (HelixListbox["resultsLabel"]) | undefined;
|
|
18422
|
+
/** What VoiceOver hears as the highlight reaches a chosen option from the
|
|
18423
|
+
filter field, on Apple devices. `{name}` is the option's words. */
|
|
18424
|
+
"attr:selected-label"?: (HelixListbox["selectedLabel"]) | undefined;
|
|
18425
|
+
/** What VoiceOver hears as the highlight reaches a chosen option from the
|
|
18426
|
+
filter field, on Apple devices. `{name}` is the option's words. */
|
|
18427
|
+
"prop:selectedLabel"?: (HelixListbox["selectedLabel"]) | undefined;
|
|
18030
18428
|
/** Whether the control is disabled and cannot be used.
|
|
18031
18429
|
|
|
18032
18430
|
Reflected, because the styled tier selects on it, and mirrored to
|
|
@@ -18053,6 +18451,23 @@ imperatively later, and nothing is hydrating by then.
|
|
|
18053
18451
|
|
|
18054
18452
|
Here rather than on each control. */
|
|
18055
18453
|
"prop:name"?: (HelixListbox["name"]) | undefined;
|
|
18454
|
+
/** The options as data, for a list too long to draw whole: each a value,
|
|
18455
|
+
which is also its words, or a record with a `value`, a `label` and
|
|
18456
|
+
`disabled`. Set, the list draws only the options in sight, and the ones
|
|
18457
|
+
you write as children are not read.
|
|
18458
|
+
|
|
18459
|
+
**Every option is still reachable.** The keyboard, the typeahead, the
|
|
18460
|
+
filter and the value work over the whole set, and the option the keyboard
|
|
18461
|
+
is on is drawn wherever it is, so a screen reader is told about it. Each
|
|
18462
|
+
drawn option says its place in the set (`aria-posinset`, `aria-setsize`).
|
|
18463
|
+
React Aria virtualizes a `ListBox` with its `Virtualizer`; this is core's
|
|
18464
|
+
`VirtualizeController`.
|
|
18465
|
+
|
|
18466
|
+
**The list needs a height to scroll in**: the styled tier's
|
|
18467
|
+
`--listbox-max-block-size`, or a `max-block-size` on `::part(items)` in the
|
|
18468
|
+
headless tier. Import the Option family as well, whose elements are drawn.
|
|
18469
|
+
A server sends the list empty, and the options are drawn once it hydrates. */
|
|
18470
|
+
"prop:items"?: (HelixListbox["items"]) | undefined;
|
|
18056
18471
|
/** Which option is chosen, as an index, or `-1` where none is.
|
|
18057
18472
|
|
|
18058
18473
|
`<select>`'s own pair, and this control is what stands in for one. The
|
|
@@ -20901,6 +21316,20 @@ say that without the component knowing what a row looks like. */
|
|
|
20901
21316
|
loadingText?: (HelixNotifications["loadingText"]) | undefined;
|
|
20902
21317
|
/** The feed's name, read by screen readers. */
|
|
20903
21318
|
label?: (HelixNotifications["label"]) | undefined;
|
|
21319
|
+
/** What the feed says when a page of it could not be loaded, such as after a
|
|
21320
|
+
request to a server fails. Empty, null or no attribute is no error, so
|
|
21321
|
+
removing the attribute clears it.
|
|
21322
|
+
|
|
21323
|
+
Set, it shows under the rows there are, in place of `empty-text` and
|
|
21324
|
+
`loading-text`, and a screen reader hears it. Clear it when you ask again. */
|
|
21325
|
+
"load-error"?: (HelixNotifications["loadError"]) | undefined;
|
|
21326
|
+
/** What the feed says when a page of it could not be loaded, such as after a
|
|
21327
|
+
request to a server fails. Empty, null or no attribute is no error, so
|
|
21328
|
+
removing the attribute clears it.
|
|
21329
|
+
|
|
21330
|
+
Set, it shows under the rows there are, in place of `empty-text` and
|
|
21331
|
+
`loading-text`, and a screen reader hears it. Clear it when you ask again. */
|
|
21332
|
+
loadError?: (HelixNotifications["loadError"]) | undefined;
|
|
20904
21333
|
/** Whether to draw a button after the list that asks for the next page, by
|
|
20905
21334
|
sending `helix-load-more`. Take it off once there is nothing more. */
|
|
20906
21335
|
"load-more"?: (HelixNotifications["loadMore"]) | undefined;
|
|
@@ -20953,6 +21382,20 @@ say that without the component knowing what a row looks like. */
|
|
|
20953
21382
|
"prop:loadingText"?: (HelixNotifications["loadingText"]) | undefined;
|
|
20954
21383
|
/** The feed's name, read by screen readers. */
|
|
20955
21384
|
"prop:label"?: (HelixNotifications["label"]) | undefined;
|
|
21385
|
+
/** What the feed says when a page of it could not be loaded, such as after a
|
|
21386
|
+
request to a server fails. Empty, null or no attribute is no error, so
|
|
21387
|
+
removing the attribute clears it.
|
|
21388
|
+
|
|
21389
|
+
Set, it shows under the rows there are, in place of `empty-text` and
|
|
21390
|
+
`loading-text`, and a screen reader hears it. Clear it when you ask again. */
|
|
21391
|
+
"attr:load-error"?: (HelixNotifications["loadError"]) | undefined;
|
|
21392
|
+
/** What the feed says when a page of it could not be loaded, such as after a
|
|
21393
|
+
request to a server fails. Empty, null or no attribute is no error, so
|
|
21394
|
+
removing the attribute clears it.
|
|
21395
|
+
|
|
21396
|
+
Set, it shows under the rows there are, in place of `empty-text` and
|
|
21397
|
+
`loading-text`, and a screen reader hears it. Clear it when you ask again. */
|
|
21398
|
+
"prop:loadError"?: (HelixNotifications["loadError"]) | undefined;
|
|
20956
21399
|
/** Whether to draw a button after the list that asks for the next page, by
|
|
20957
21400
|
sending `helix-load-more`. Take it off once there is nothing more. */
|
|
20958
21401
|
"bool:load-more"?: (HelixNotifications["loadMore"]) | undefined;
|
|
@@ -25794,6 +26237,14 @@ and this one was the English a form in another language still spoke in
|
|
|
25794
26237
|
the bubble it raises on submit: `feedback` replaces the message under
|
|
25795
26238
|
the field and does not reach that one. */
|
|
25796
26239
|
valueMissingMessage?: (HelixSelect["valueMissingMessage"]) | undefined;
|
|
26240
|
+
/** What a browser's autofill may fill in, as a platform token such as
|
|
26241
|
+
`country` or `cc-exp-month`, as on a native `<select>`.
|
|
26242
|
+
|
|
26243
|
+
Set, the select keeps a hidden native `<select>` with the same options for
|
|
26244
|
+
the browser to fill, as React Aria's `HiddenSelect` does, and takes the
|
|
26245
|
+
option the browser picks, by its value or its words, as the value. Empty
|
|
26246
|
+
draws no hidden select, and a browser fills nothing. */
|
|
26247
|
+
autocomplete?: (HelixSelect["autocomplete"]) | undefined;
|
|
25797
26248
|
/** The text shown when no options match the filter. */
|
|
25798
26249
|
"empty-text"?: (HelixSelect["emptyText"]) | undefined;
|
|
25799
26250
|
/** The text shown when no options match the filter. */
|
|
@@ -26017,6 +26468,14 @@ and this one was the English a form in another language still spoke in
|
|
|
26017
26468
|
the bubble it raises on submit: `feedback` replaces the message under
|
|
26018
26469
|
the field and does not reach that one. */
|
|
26019
26470
|
"prop:valueMissingMessage"?: (HelixSelect["valueMissingMessage"]) | undefined;
|
|
26471
|
+
/** What a browser's autofill may fill in, as a platform token such as
|
|
26472
|
+
`country` or `cc-exp-month`, as on a native `<select>`.
|
|
26473
|
+
|
|
26474
|
+
Set, the select keeps a hidden native `<select>` with the same options for
|
|
26475
|
+
the browser to fill, as React Aria's `HiddenSelect` does, and takes the
|
|
26476
|
+
option the browser picks, by its value or its words, as the value. Empty
|
|
26477
|
+
draws no hidden select, and a browser fills nothing. */
|
|
26478
|
+
"prop:autocomplete"?: (HelixSelect["autocomplete"]) | undefined;
|
|
26020
26479
|
/** The text shown when no options match the filter. */
|
|
26021
26480
|
"attr:empty-text"?: (HelixSelect["emptyText"]) | undefined;
|
|
26022
26481
|
/** The text shown when no options match the filter. */
|
|
@@ -27022,6 +27481,21 @@ not. */
|
|
|
27022
27481
|
textContent?: (string | number) | undefined;
|
|
27023
27482
|
};
|
|
27024
27483
|
|
|
27484
|
+
export type HelixSpeedDialGroupProps = {
|
|
27485
|
+
/** The group's name, drawn above its actions and read by screen readers. */
|
|
27486
|
+
label?: (HelixSpeedDialGroup["label"]) | undefined;
|
|
27487
|
+
};
|
|
27488
|
+
|
|
27489
|
+
export type HelixSpeedDialGroupSolidJsProps = {
|
|
27490
|
+
/** The group's name, drawn above its actions and read by screen readers. */
|
|
27491
|
+
"prop:label"?: (HelixSpeedDialGroup["label"]) | undefined;
|
|
27492
|
+
|
|
27493
|
+
/** Set the innerHTML of the element */
|
|
27494
|
+
innerHTML?: (string) | undefined;
|
|
27495
|
+
/** Set the textContent of the element */
|
|
27496
|
+
textContent?: (string | number) | undefined;
|
|
27497
|
+
};
|
|
27498
|
+
|
|
27025
27499
|
/** `HelixSpeedDialItem` component event */
|
|
27026
27500
|
export type HelixSpeedDialItemElementEvent<E = Event> = TypedEvent<
|
|
27027
27501
|
HelixSpeedDialItem,
|
|
@@ -27034,6 +27508,10 @@ export type HelixSpeedDialItemHelixSelectElementEvent =
|
|
|
27034
27508
|
export type HelixSpeedDialItemProps = {
|
|
27035
27509
|
/** Whether the action is disabled, so it cannot be chosen. */
|
|
27036
27510
|
disabled?: (HelixSpeedDialItem["disabled"]) | undefined;
|
|
27511
|
+
/** The action's keyboard shortcut as a chord, such as `mod+s`, carried as
|
|
27512
|
+
`aria-keyshortcuts` and drawn after the name. `mod` is Command on an Apple
|
|
27513
|
+
keyboard and Control elsewhere. Showing a shortcut does not bind it. */
|
|
27514
|
+
shortcut?: (HelixSpeedDialItem["shortcut"]) | undefined;
|
|
27037
27515
|
/** The action's value, sent in `helix-select` when the action is chosen. */
|
|
27038
27516
|
value?: (HelixSpeedDialItem["value"]) | undefined;
|
|
27039
27517
|
|
|
@@ -27044,6 +27522,10 @@ export type HelixSpeedDialItemProps = {
|
|
|
27044
27522
|
export type HelixSpeedDialItemSolidJsProps = {
|
|
27045
27523
|
/** Whether the action is disabled, so it cannot be chosen. */
|
|
27046
27524
|
"prop:disabled"?: (HelixSpeedDialItem["disabled"]) | undefined;
|
|
27525
|
+
/** The action's keyboard shortcut as a chord, such as `mod+s`, carried as
|
|
27526
|
+
`aria-keyshortcuts` and drawn after the name. `mod` is Command on an Apple
|
|
27527
|
+
keyboard and Control elsewhere. Showing a shortcut does not bind it. */
|
|
27528
|
+
"prop:shortcut"?: (HelixSpeedDialItem["shortcut"]) | undefined;
|
|
27047
27529
|
/** The action's value, sent in `helix-select` when the action is chosen. */
|
|
27048
27530
|
"prop:value"?: (HelixSpeedDialItem["value"]) | undefined;
|
|
27049
27531
|
/** The action was chosen. Cancelable: cancel it to keep the dial open. */
|
|
@@ -27098,8 +27580,32 @@ the resolved state for stylesheets, which is what the mirror is for. */
|
|
|
27098
27580
|
open?: (HelixSpeedDial["open"]) | undefined;
|
|
27099
27581
|
/** Accessible name for the trigger and the set of actions it opens. */
|
|
27100
27582
|
label?: (HelixSpeedDial["label"]) | undefined;
|
|
27583
|
+
/** The description the trigger gives under `open-on="long-press"`, saying how
|
|
27584
|
+
its actions are reached.
|
|
27585
|
+
|
|
27586
|
+
A slotted trigger is described by the dial, which carries the words as
|
|
27587
|
+
its own label for that: a Helix button's inner control at once, and a
|
|
27588
|
+
plain element of yours once a reader reaches it, after hydration, unless
|
|
27589
|
+
you described or labeled it yourself. */
|
|
27590
|
+
"long-press-label"?: (HelixSpeedDial["longPressLabel"]) | undefined;
|
|
27591
|
+
/** The description the trigger gives under `open-on="long-press"`, saying how
|
|
27592
|
+
its actions are reached.
|
|
27593
|
+
|
|
27594
|
+
A slotted trigger is described by the dial, which carries the words as
|
|
27595
|
+
its own label for that: a Helix button's inner control at once, and a
|
|
27596
|
+
plain element of yours once a reader reaches it, after hydration, unless
|
|
27597
|
+
you described or labeled it yourself. */
|
|
27598
|
+
longPressLabel?: (HelixSpeedDial["longPressLabel"]) | undefined;
|
|
27101
27599
|
/** Space between the trigger and the actions, in pixels. */
|
|
27102
27600
|
offset?: (HelixSpeedDial["offset"]) | undefined;
|
|
27601
|
+
/** What opens the dial. `click` opens it on a press of the trigger. Under
|
|
27602
|
+
`long-press`, a press is the trigger's own action, and the dial opens on a
|
|
27603
|
+
press held for half a second, or on Alt+Down or Alt+Up. */
|
|
27604
|
+
"open-on"?: (HelixSpeedDial["openOn"]) | undefined;
|
|
27605
|
+
/** What opens the dial. `click` opens it on a press of the trigger. Under
|
|
27606
|
+
`long-press`, a press is the trigger's own action, and the dial opens on a
|
|
27607
|
+
press held for half a second, or on Alt+Down or Alt+Up. */
|
|
27608
|
+
openOn?: (HelixSpeedDial["openOn"]) | undefined;
|
|
27103
27609
|
/** The direction the actions open in. They move to another side if that side
|
|
27104
27610
|
does not fit.
|
|
27105
27611
|
|
|
@@ -27146,8 +27652,32 @@ the resolved state for stylesheets, which is what the mirror is for. */
|
|
|
27146
27652
|
"prop:open"?: (HelixSpeedDial["open"]) | undefined;
|
|
27147
27653
|
/** Accessible name for the trigger and the set of actions it opens. */
|
|
27148
27654
|
"prop:label"?: (HelixSpeedDial["label"]) | undefined;
|
|
27655
|
+
/** The description the trigger gives under `open-on="long-press"`, saying how
|
|
27656
|
+
its actions are reached.
|
|
27657
|
+
|
|
27658
|
+
A slotted trigger is described by the dial, which carries the words as
|
|
27659
|
+
its own label for that: a Helix button's inner control at once, and a
|
|
27660
|
+
plain element of yours once a reader reaches it, after hydration, unless
|
|
27661
|
+
you described or labeled it yourself. */
|
|
27662
|
+
"attr:long-press-label"?: (HelixSpeedDial["longPressLabel"]) | undefined;
|
|
27663
|
+
/** The description the trigger gives under `open-on="long-press"`, saying how
|
|
27664
|
+
its actions are reached.
|
|
27665
|
+
|
|
27666
|
+
A slotted trigger is described by the dial, which carries the words as
|
|
27667
|
+
its own label for that: a Helix button's inner control at once, and a
|
|
27668
|
+
plain element of yours once a reader reaches it, after hydration, unless
|
|
27669
|
+
you described or labeled it yourself. */
|
|
27670
|
+
"prop:longPressLabel"?: (HelixSpeedDial["longPressLabel"]) | undefined;
|
|
27149
27671
|
/** Space between the trigger and the actions, in pixels. */
|
|
27150
27672
|
"prop:offset"?: (HelixSpeedDial["offset"]) | undefined;
|
|
27673
|
+
/** What opens the dial. `click` opens it on a press of the trigger. Under
|
|
27674
|
+
`long-press`, a press is the trigger's own action, and the dial opens on a
|
|
27675
|
+
press held for half a second, or on Alt+Down or Alt+Up. */
|
|
27676
|
+
"attr:open-on"?: (HelixSpeedDial["openOn"]) | undefined;
|
|
27677
|
+
/** What opens the dial. `click` opens it on a press of the trigger. Under
|
|
27678
|
+
`long-press`, a press is the trigger's own action, and the dial opens on a
|
|
27679
|
+
press held for half a second, or on Alt+Down or Alt+Up. */
|
|
27680
|
+
"prop:openOn"?: (HelixSpeedDial["openOn"]) | undefined;
|
|
27151
27681
|
/** The direction the actions open in. They move to another side if that side
|
|
27152
27682
|
does not fit.
|
|
27153
27683
|
|
|
@@ -27337,7 +27867,7 @@ The arrow keys move by `step` and do not snap. */
|
|
|
27337
27867
|
"onhelix-collapse"?: ((e: HelixSplitterHelixCollapseElementEvent) => void) | undefined;
|
|
27338
27868
|
/** Fired after the divider settles somewhere new, with the new position. */
|
|
27339
27869
|
"onhelix-resized"?: ((e: HelixSplitterHelixResizedElementEvent) => void) | undefined;
|
|
27340
|
-
/** Fired each time
|
|
27870
|
+
/** Fired each time the divider moves, as a range input does: on each step of a drag, and before `helix-resized` for a key, a double click or a corner. Read `position` for where it is now. */
|
|
27341
27871
|
oninput?: ((e: HelixSplitterElementEvent) => void) | undefined;
|
|
27342
27872
|
};
|
|
27343
27873
|
|
|
@@ -27489,7 +28019,7 @@ The arrow keys move by `step` and do not snap. */
|
|
|
27489
28019
|
"on:helix-collapse"?: ((e: HelixSplitterHelixCollapseElementEvent) => void) | undefined;
|
|
27490
28020
|
/** Fired after the divider settles somewhere new, with the new position. */
|
|
27491
28021
|
"on:helix-resized"?: ((e: HelixSplitterHelixResizedElementEvent) => void) | undefined;
|
|
27492
|
-
/** Fired each time
|
|
28022
|
+
/** Fired each time the divider moves, as a range input does: on each step of a drag, and before `helix-resized` for a key, a double click or a corner. Read `position` for where it is now. */
|
|
27493
28023
|
"on:input"?: ((e: HelixSplitterElementEvent) => void) | undefined;
|
|
27494
28024
|
|
|
27495
28025
|
/** Set the innerHTML of the element */
|
|
@@ -28522,6 +29052,14 @@ is set. */
|
|
|
28522
29052
|
"descending-label"?: (HelixTable["descendingLabel"]) | undefined;
|
|
28523
29053
|
/** The word for a descending sort, in `sorted-label`. */
|
|
28524
29054
|
descendingLabel?: (HelixTable["descendingLabel"]) | undefined;
|
|
29055
|
+
/** Makes the table a grid: one tab stop, and the arrow keys, Home, End and the
|
|
29056
|
+
Page keys move focus between its cells, the headings included. Enter moves
|
|
29057
|
+
into a cell's controls, and Tab leaves the table.
|
|
29058
|
+
|
|
29059
|
+
Off by default, where the table is a static `table` and Tab reaches each
|
|
29060
|
+
link and control in it. On, the table writes a `tabindex` onto each of its
|
|
29061
|
+
cells, which is the one way a cell of your markup can take focus. */
|
|
29062
|
+
grid?: (HelixTable["grid"]) | undefined;
|
|
28525
29063
|
/** Accessible name for the table.
|
|
28526
29064
|
|
|
28527
29065
|
An `aria-label` or `aria-labelledby` on the host names the table too, and
|
|
@@ -28643,6 +29181,14 @@ is set. */
|
|
|
28643
29181
|
"attr:descending-label"?: (HelixTable["descendingLabel"]) | undefined;
|
|
28644
29182
|
/** The word for a descending sort, in `sorted-label`. */
|
|
28645
29183
|
"prop:descendingLabel"?: (HelixTable["descendingLabel"]) | undefined;
|
|
29184
|
+
/** Makes the table a grid: one tab stop, and the arrow keys, Home, End and the
|
|
29185
|
+
Page keys move focus between its cells, the headings included. Enter moves
|
|
29186
|
+
into a cell's controls, and Tab leaves the table.
|
|
29187
|
+
|
|
29188
|
+
Off by default, where the table is a static `table` and Tab reaches each
|
|
29189
|
+
link and control in it. On, the table writes a `tabindex` onto each of its
|
|
29190
|
+
cells, which is the one way a cell of your markup can take focus. */
|
|
29191
|
+
"prop:grid"?: (HelixTable["grid"]) | undefined;
|
|
28646
29192
|
/** Accessible name for the table.
|
|
28647
29193
|
|
|
28648
29194
|
An `aria-label` or `aria-labelledby` on the host names the table too, and
|
|
@@ -31769,6 +32315,9 @@ Written by the group, like `selected`, so no attribute. */
|
|
|
31769
32315
|
};
|
|
31770
32316
|
|
|
31771
32317
|
export type HelixToolbarProps = {
|
|
32318
|
+
/** The size of every control in the toolbar: their height, icons, boxes and
|
|
32319
|
+
tags. Unset is the small size, as a toolbar is dense by nature. */
|
|
32320
|
+
size?: (HelixToolbar["size"]) | undefined;
|
|
31772
32321
|
/** The toolbar's name, read by screen readers.
|
|
31773
32322
|
|
|
31774
32323
|
An `aria-label` or `aria-labelledby` on the host names the toolbar too,
|
|
@@ -31785,6 +32334,9 @@ wrap around from one end to the other. */
|
|
|
31785
32334
|
};
|
|
31786
32335
|
|
|
31787
32336
|
export type HelixToolbarSolidJsProps = {
|
|
32337
|
+
/** The size of every control in the toolbar: their height, icons, boxes and
|
|
32338
|
+
tags. Unset is the small size, as a toolbar is dense by nature. */
|
|
32339
|
+
"prop:size"?: (HelixToolbar["size"]) | undefined;
|
|
31788
32340
|
/** The toolbar's name, read by screen readers.
|
|
31789
32341
|
|
|
31790
32342
|
An `aria-label` or `aria-labelledby` on the host names the toolbar too,
|
|
@@ -34748,6 +35300,19 @@ export type CustomElements = {
|
|
|
34748
35300
|
*
|
|
34749
35301
|
* Read once when the announcement is first rendered, as `Toast` reads its
|
|
34750
35302
|
* own. The clock stops while the pointer or focus is on the announcement.
|
|
35303
|
+
* - `hotkey`: The key that moves focus to the announcement's first control, and back
|
|
35304
|
+
* to where it was, written as keys joined by `+`, such as `F6` or `Alt+A`.
|
|
35305
|
+
*
|
|
35306
|
+
* F6 by default, the key React Aria's regions answer to. Empty turns it
|
|
35307
|
+
* off. With several announcements, the first one in the page takes focus.
|
|
35308
|
+
* - `label`: The name of the announcement's region, which screen readers list among
|
|
35309
|
+
* the page's landmarks. Translate it with the rest of your interface.
|
|
35310
|
+
*
|
|
35311
|
+
* Empty leaves the announcement no region.
|
|
35312
|
+
* - `queued`: Whether the announcement waits its turn behind the queued announcements
|
|
35313
|
+
* before it in the same parent, showing when the last of them is removed.
|
|
35314
|
+
*
|
|
35315
|
+
* Off by default, so every announcement on a page shows at once.
|
|
34751
35316
|
* - `tone`: The band's color.
|
|
34752
35317
|
*
|
|
34753
35318
|
* Paint only: unlike `Callout`, no value here draws a mark, changes the label,
|
|
@@ -34837,6 +35402,7 @@ export type CustomElements = {
|
|
|
34837
35402
|
* These can be used to apply styling when a component is in a given state.
|
|
34838
35403
|
*
|
|
34839
35404
|
* - `paused`: The clock `duration` started is stopped, while the pointer or focus is on the announcement or the page is hidden.
|
|
35405
|
+
* - `waiting`: The announcement is `queued` behind another, and renders nothing until that one is removed.
|
|
34840
35406
|
* - `settled`: Set one frame after the first render. Transitions wait for it, so an element does not animate its own arrival.
|
|
34841
35407
|
*/
|
|
34842
35408
|
"helix-announcement": Partial<
|
|
@@ -35168,6 +35734,9 @@ export type CustomElements = {
|
|
|
35168
35734
|
*
|
|
35169
35735
|
* A column's heading is the cell's name in every row, so the first row
|
|
35170
35736
|
* answers for the column.
|
|
35737
|
+
* - `columnName(cell: number) => string`: The heading of the column at this place in a row: a cell's name is its
|
|
35738
|
+
* column's heading, read from the first row that has a cell there, so a
|
|
35739
|
+
* short first row does not lose the heading. `''` where no row has one.
|
|
35171
35740
|
*
|
|
35172
35741
|
* ## CSS Custom Properties
|
|
35173
35742
|
*
|
|
@@ -36081,6 +36650,9 @@ export type CustomElements = {
|
|
|
36081
36650
|
*
|
|
36082
36651
|
* A column's heading is the cell's name in every row, so the first row
|
|
36083
36652
|
* answers for the column.
|
|
36653
|
+
* - `columnName(cell: number) => string`: The heading of the column at this place in a row: a cell's name is its
|
|
36654
|
+
* column's heading, read from the first row that has a cell there, so a
|
|
36655
|
+
* short first row does not lose the heading. `''` where no row has one.
|
|
36084
36656
|
*
|
|
36085
36657
|
* ## CSS Custom Properties
|
|
36086
36658
|
*
|
|
@@ -36150,14 +36722,24 @@ export type CustomElements = {
|
|
|
36150
36722
|
|
|
36151
36723
|
/**
|
|
36152
36724
|
* Set in the display face, larger than body text, to mark a change of voice. No
|
|
36153
|
-
* quotation marks are drawn, because the size and spacing already
|
|
36154
|
-
* passage apart.
|
|
36725
|
+
* quotation marks are drawn by default, because the size and spacing already
|
|
36726
|
+
* set the passage apart. `marks` draws one large opening mark over the passage,
|
|
36727
|
+
* as a pull quote sets it, in the element's language.
|
|
36155
36728
|
*
|
|
36156
36729
|
* ## Attributes & Properties
|
|
36157
36730
|
*
|
|
36158
36731
|
* Component attributes and properties that can be applied to the element or by using JavaScript.
|
|
36159
36732
|
*
|
|
36160
|
-
* - `
|
|
36733
|
+
* - `attribution`: Who said it, and where, as words, such as "Maria Lopez, operations
|
|
36734
|
+
* manager". The `attribution` slot replaces them, for markup such as a link.
|
|
36735
|
+
*
|
|
36736
|
+
* Words are served with the figure they name, where a server cannot see a
|
|
36737
|
+
* slotted attribution.
|
|
36738
|
+
* - `cite`: The URL of the source the passage came from. Who said it goes in
|
|
36739
|
+
* `attribution`: a `cite` with words in it warns once, with the runtime kind
|
|
36740
|
+
* `cite-not-url`.
|
|
36741
|
+
* - `marks`: Whether to draw an opening quotation mark before the passage, in the
|
|
36742
|
+
* element's language. Leave the marks out of the text.
|
|
36161
36743
|
* - `whenSettled`: Resolves a frame after the first update, when transitions are switched on.
|
|
36162
36744
|
*
|
|
36163
36745
|
* **Named `whenSettled` because `settled` is taken four times over**, by
|
|
@@ -36184,28 +36766,33 @@ export type CustomElements = {
|
|
|
36184
36766
|
* Areas where markup can be added to the component.
|
|
36185
36767
|
*
|
|
36186
36768
|
* - `(default)`: The quoted passage.
|
|
36187
|
-
* - `attribution`: Who said it, and where.
|
|
36769
|
+
* - `attribution`: Who said it, and where. Replaces the words of `attribution`.
|
|
36188
36770
|
*
|
|
36189
36771
|
* ## CSS Custom Properties
|
|
36190
36772
|
*
|
|
36191
36773
|
* CSS variables available for styling the component.
|
|
36192
36774
|
*
|
|
36193
36775
|
* - `--blockquote-attribution-color`: The color of the attribution.
|
|
36776
|
+
* - `--blockquote-attribution-font-family`: The typeface of the attribution, the page's by default.
|
|
36777
|
+
* - `--blockquote-attribution-font-weight`: The weight of the attribution, the page's by default.
|
|
36194
36778
|
* - `--blockquote-attribution-size`: The font size of the attribution.
|
|
36195
36779
|
* - `--blockquote-color`: The color of the quoted passage.
|
|
36196
36780
|
* - `--blockquote-font-family`: The typeface of the quoted passage, the display face by default.
|
|
36197
36781
|
* - `--blockquote-font-weight`: The weight of the quoted passage, medium by default.
|
|
36198
36782
|
* - `--blockquote-gap`: The space between the passage and its attribution.
|
|
36783
|
+
* - `--blockquote-letter-spacing`: The letter spacing of the quoted passage, the tight tracking by default.
|
|
36199
36784
|
* - `--blockquote-line-height`: The line height of the quoted passage, the tight leading by default.
|
|
36785
|
+
* - `--blockquote-mark-color`: The color of the mark `marks` draws, the subtle foreground by default.
|
|
36786
|
+
* - `--blockquote-mark-size`: The font size of the mark `marks` draws.
|
|
36200
36787
|
* - `--blockquote-size`: The font size of the quoted passage.
|
|
36201
36788
|
*
|
|
36202
36789
|
* ## CSS Parts
|
|
36203
36790
|
*
|
|
36204
36791
|
* Custom selectors for styling elements within the component.
|
|
36205
36792
|
*
|
|
36206
|
-
* - `attribution`: The
|
|
36793
|
+
* - `attribution`: The caption carrying the source.
|
|
36207
36794
|
* - `blockquote`: The quotation.
|
|
36208
|
-
* - `figure`: The
|
|
36795
|
+
* - `figure`: The figure holding the quotation and its attribution, a `<div>` with `role="figure"` while the attribution has words.
|
|
36209
36796
|
*
|
|
36210
36797
|
* ## CSS States
|
|
36211
36798
|
*
|
|
@@ -36408,18 +36995,28 @@ export type CustomElements = {
|
|
|
36408
36995
|
* Joins the buttons into one shape: the outer corners keep their radius, the
|
|
36409
36996
|
* inner corners lose it, and adjacent borders collapse into one line.
|
|
36410
36997
|
*
|
|
36411
|
-
*
|
|
36412
|
-
*
|
|
36413
|
-
*
|
|
36414
|
-
*
|
|
36998
|
+
* A Helix button's corners are on the control inside its shadow root, where
|
|
36999
|
+
* this component's styles cannot reach, so the group flattens them through the
|
|
37000
|
+
* button's own `--button-radius-*` hooks. A native `<button>` and your own
|
|
37001
|
+
* anchor styled with `data-button` join through rules in the base layer,
|
|
37002
|
+
* because a page rule setting their radius would beat any rule in here.
|
|
37003
|
+
*
|
|
37004
|
+
* The buttons take their height from the region, so `size` makes every
|
|
37005
|
+
* button in the group smaller or larger together, as `data-density` on the
|
|
37006
|
+
* group does, and a button's own size still wins. A native `<button>` in a
|
|
37007
|
+
* sized group takes the height and the text size.
|
|
36415
37008
|
*
|
|
36416
|
-
*
|
|
36417
|
-
* group
|
|
37009
|
+
* With `selection-mode`, a pressed button takes the solid fill:
|
|
37010
|
+
* `--button-group-pressed-background-color` behind it and
|
|
37011
|
+
* `--button-group-pressed-color` for its words, set on the group or above it.
|
|
36418
37012
|
*
|
|
36419
37013
|
* ## Attributes & Properties
|
|
36420
37014
|
*
|
|
36421
37015
|
* Component attributes and properties that can be applied to the element or by using JavaScript.
|
|
36422
37016
|
*
|
|
37017
|
+
* - `size`: The size of every button in the group: their height, text, padding and
|
|
37018
|
+
* icons, from the density steps. Unset, the buttons take the size of the
|
|
37019
|
+
* region around the group.
|
|
36423
37020
|
* - `variant`: Whether the buttons are one bar or a spaced row.
|
|
36424
37021
|
*
|
|
36425
37022
|
* Joined by default: one control made of parts, sharing borders, reading as a
|
|
@@ -36450,6 +37047,16 @@ export type CustomElements = {
|
|
|
36450
37047
|
* buttons sharing edges as one shape, and a wrapped row carries the corners of
|
|
36451
37048
|
* a first row into a second. Stacked, the same three keep one shape and one
|
|
36452
37049
|
* column.
|
|
37050
|
+
* - `selection-mode`/`selectionMode`: Whether the buttons stay pressed: `single` keeps one pressed at a time and
|
|
37051
|
+
* `multiple` any number. Unset, they are action buttons, each its own tab
|
|
37052
|
+
* stop, as before.
|
|
37053
|
+
*
|
|
37054
|
+
* Optional, so the attribute is absent until a consumer writes it.
|
|
37055
|
+
* - `value`: The values of the pressed buttons, comma separated, in a selection mode.
|
|
37056
|
+
* A button's own `value` names it, so a value holds no comma.
|
|
37057
|
+
*
|
|
37058
|
+
* The attribute is the seed, and a press changes the property, which does
|
|
37059
|
+
* not reflect, as a native control's `value` does not.
|
|
36453
37060
|
* - `whenSettled`: Resolves a frame after the first update, when transitions are switched on.
|
|
36454
37061
|
*
|
|
36455
37062
|
* **Named `whenSettled` because `settled` is taken four times over**, by
|
|
@@ -36471,6 +37078,13 @@ export type CustomElements = {
|
|
|
36471
37078
|
* browser harness's awaits it alone: a browser always runs the frame, and a
|
|
36472
37079
|
* timer beside it was a bet on how long one takes, which a busy run lost. (property only) (readonly)
|
|
36473
37080
|
*
|
|
37081
|
+
* ## Events
|
|
37082
|
+
*
|
|
37083
|
+
* Events that will be emitted by the component.
|
|
37084
|
+
*
|
|
37085
|
+
* - `change`: Fired after a press changes `value`, in a selection mode.
|
|
37086
|
+
* - `helix-before-change`: Fired before a press changes `value`, with the value it would leave in `detail.value`. Cancelable: call `preventDefault()` to keep the buttons as they are.
|
|
37087
|
+
*
|
|
36474
37088
|
* ## Slots
|
|
36475
37089
|
*
|
|
36476
37090
|
* Areas where markup can be added to the component.
|
|
@@ -36482,6 +37096,10 @@ export type CustomElements = {
|
|
|
36482
37096
|
* CSS variables available for styling the component.
|
|
36483
37097
|
*
|
|
36484
37098
|
* - `--button-group-gap`: Space between the buttons, when `spaced`.
|
|
37099
|
+
* - `--button-group-pressed-background-color`: Fill behind a pressed button, in a selection mode. Defaults to the foreground color.
|
|
37100
|
+
* - `--button-group-pressed-border-color`: Edge of a pressed button, in a selection mode. Defaults to its fill.
|
|
37101
|
+
* - `--button-group-pressed-color`: Words and icons of a pressed button, in a selection mode. Defaults to the background color.
|
|
37102
|
+
* - `--button-group-pressed`: Written on the control inside each toggle button of a group with `selection-mode`: `1` while it is pressed and `0` while it is not. Read it in a `::part(button)` rule to draw the pressed look.
|
|
36485
37103
|
*
|
|
36486
37104
|
* ## CSS States
|
|
36487
37105
|
*
|
|
@@ -37032,6 +37650,9 @@ export type CustomElements = {
|
|
|
37032
37650
|
* Before the board places it, the card sits in normal flow. Without JavaScript,
|
|
37033
37651
|
* the page shows the cards' text in the order it was written.
|
|
37034
37652
|
*
|
|
37653
|
+
* On a touch screen, the points and corners of the card with focus take a
|
|
37654
|
+
* reach 44 pixels across, so a finger can start a connection from one.
|
|
37655
|
+
*
|
|
37035
37656
|
* ## Attributes & Properties
|
|
37036
37657
|
*
|
|
37037
37658
|
* Component attributes and properties that can be applied to the element or by using JavaScript.
|
|
@@ -37140,7 +37761,9 @@ export type CustomElements = {
|
|
|
37140
37761
|
* - `--canvas-move-inset`: The distance between the move handle and the card's corner.
|
|
37141
37762
|
* - `--canvas-node-background-color`: The card's background.
|
|
37142
37763
|
* - `--canvas-node-color`: A color for the card that carries no meaning, such as a hex color from a document. Use it when no tone fits.
|
|
37764
|
+
* - `--canvas-node-font-size`: The size of the card's text.
|
|
37143
37765
|
* - `--canvas-node-padding`: The space between the card's edge and its content.
|
|
37766
|
+
* - `--canvas-node-radius`: The card's corners. A `shape` draws its own.
|
|
37144
37767
|
* - `--canvas-node-shadow`: The shadow under the card, set by `separation="elevated"`.
|
|
37145
37768
|
*
|
|
37146
37769
|
* ## CSS Parts
|
|
@@ -37319,6 +37942,12 @@ export type CustomElements = {
|
|
|
37319
37942
|
*
|
|
37320
37943
|
* The list is joined the way the page's language joins one, "Second and
|
|
37321
37944
|
* Third", rather than with a comma this component chose.
|
|
37945
|
+
* - `moved-label`/`movedLabel`: What screen readers hear after a key moves a card, with `{name}` for the
|
|
37946
|
+
* card and `{x}` and `{y}` for where it now is, in the document's units.
|
|
37947
|
+
*
|
|
37948
|
+
* **A move a reader cannot see has to be said.** Shift with an arrow moved
|
|
37949
|
+
* the card and said nothing, so a reader moving one by keys could not tell
|
|
37950
|
+
* whether it had moved, or how far.
|
|
37322
37951
|
* - `order`: The order the arrow keys and screen readers move through the cards:
|
|
37323
37952
|
* `spatial` or `edges`.
|
|
37324
37953
|
*
|
|
@@ -37344,6 +37973,9 @@ export type CustomElements = {
|
|
|
37344
37973
|
* walk the cards.
|
|
37345
37974
|
* - `reconnecting-label`/`reconnectingLabel`: The text announced when a connection's end is picked up, with `{from}` and
|
|
37346
37975
|
* `{to}`.
|
|
37976
|
+
* - `resized-label`/`resizedLabel`: What screen readers hear after a key resizes a card, with `{name}` for the
|
|
37977
|
+
* card and `{width}` and `{height}` for its new size, in the document's
|
|
37978
|
+
* units.
|
|
37347
37979
|
* - `selected`: The names of the selected cards and connections, comma separated. Empty
|
|
37348
37980
|
* when nothing is selected.
|
|
37349
37981
|
*
|
|
@@ -37363,6 +37995,26 @@ export type CustomElements = {
|
|
|
37363
37995
|
* on its board across cards and connections both, and may not hold a comma.
|
|
37364
37996
|
*
|
|
37365
37997
|
* Written to select from outside, and read to act on the selection.
|
|
37998
|
+
* - `selected-label`/`selectedLabel`: What a selected card or connection adds to what screen readers hear on
|
|
37999
|
+
* it, before its tone and its connections. Empty adds nothing.
|
|
38000
|
+
*
|
|
38001
|
+
* A card is an article and a connection a button, and neither has a selected
|
|
38002
|
+
* state for `aria-selected` to carry, so the state is said in words.
|
|
38003
|
+
* - `selection-label`/`selectionLabel`: What screen readers hear after the selection grows or shrinks, with
|
|
38004
|
+
* `{count}` for how many cards and connections are selected: by Space, a
|
|
38005
|
+
* click with Shift, Command or Control, Command or Control with A, a box
|
|
38006
|
+
* drawn across the board, or Escape.
|
|
38007
|
+
*
|
|
38008
|
+
* A selection of one made by arriving on a card or clicking it is not said,
|
|
38009
|
+
* since the card is.
|
|
38010
|
+
* - `snap`: Snaps the cards a reader moves or resizes to a multiple of this many of the
|
|
38011
|
+
* document's units, such as `32` to land on the lines `grid` draws.
|
|
38012
|
+
*
|
|
38013
|
+
* **A drag lets go on the nearest line and a key goes to the next one.**
|
|
38014
|
+
* Shift with an arrow moves a card to the next line that way, rather than
|
|
38015
|
+
* by its step of 16, and Alt with an arrow moves its bottom right corner
|
|
38016
|
+
* the same way. A group moves with what it carries, so a card inside one
|
|
38017
|
+
* keeps its place in it. Absent, cards land where they are let go.
|
|
37366
38018
|
* - `stopped-label`/`stoppedLabel`: The text announced when a connection is stopped before it is requested.
|
|
37367
38019
|
* - `tone-labels`/`toneLabels`: What each tone means on this board, in words read out with the cards and
|
|
37368
38020
|
* connections in it, such as `{"danger": "Blocked", "success": "Done"}`.
|
|
@@ -37372,6 +38024,8 @@ export type CustomElements = {
|
|
|
37372
38024
|
* red is "blocked" on one board and "urgent" on the next. A reader who can
|
|
37373
38025
|
* see the board is told by the color; this is how a reader who cannot is
|
|
37374
38026
|
* told the same. A tone left out is not read.
|
|
38027
|
+
* - `zoomed-label`/`zoomedLabel`: What screen readers hear after a zoom button or key, with `{zoom}` for the
|
|
38028
|
+
* zoom as a percentage, written the way the page's language writes one.
|
|
37375
38029
|
* - `view`: The board's current view: the document's point at the middle of the view,
|
|
37376
38030
|
* and the zoom.
|
|
37377
38031
|
*
|
|
@@ -37428,7 +38082,14 @@ export type CustomElements = {
|
|
|
37428
38082
|
* - `(default)`: The board's `helix-canvas-node` and `helix-canvas-edge` elements, drawn on the plane.
|
|
37429
38083
|
* - `empty`: Content shown when the document has no nodes.
|
|
37430
38084
|
* - `footer`: Content below the board.
|
|
38085
|
+
* - `fullscreen-icon`: Replaces the glyph inside the fullscreen button.
|
|
37431
38086
|
* - `header`: Content above the board.
|
|
38087
|
+
* - `pan-down-icon`: Replaces the glyph inside the pan down button.
|
|
38088
|
+
* - `pan-end-icon`: Replaces the glyph inside the button that pans toward the end of a line of text.
|
|
38089
|
+
* - `pan-start-icon`: Replaces the glyph inside the button that pans toward the start of a line of text.
|
|
38090
|
+
* - `pan-up-icon`: Replaces the glyph inside the pan up button.
|
|
38091
|
+
* - `zoom-in-icon`: Replaces the glyph inside the zoom-in button.
|
|
38092
|
+
* - `zoom-out-icon`: Replaces the glyph inside the zoom-out button.
|
|
37432
38093
|
*
|
|
37433
38094
|
* ## Methods
|
|
37434
38095
|
*
|
|
@@ -37463,11 +38124,17 @@ export type CustomElements = {
|
|
|
37463
38124
|
* - `--canvas-background-color`: The background behind the board.
|
|
37464
38125
|
* - `--canvas-block-size`: The height of the frame.
|
|
37465
38126
|
* - `--canvas-border-color`: The color of the frame's edge.
|
|
38127
|
+
* - `--canvas-connect-color`: The color of a connection being drawn, and of the card it will arrive at and that card's points.
|
|
37466
38128
|
* - `--canvas-edge-color`: The color of a connection with no tone. Set it in one edge's `style` to color only that edge.
|
|
37467
38129
|
* - `--canvas-edge-target-width`: The width of the area a pointer can press on a connection, which is wider than the drawn line.
|
|
38130
|
+
* - `--canvas-edge-width`: The width of a connection's line. A selected or focused connection is drawn at twice it.
|
|
37468
38131
|
* - `--canvas-grid-size`: The spacing of the grid lines or dots, in the document's units, so it scales with the zoom.
|
|
37469
38132
|
* - `--canvas-handle-size`: The size of the ends of a selected connection. A card's connection points use the same property.
|
|
38133
|
+
* - `--canvas-label-color`: The color of the label on a connection.
|
|
37470
38134
|
* - `--canvas-label-editor-inline-size`: The width of the field for editing a label.
|
|
38135
|
+
* - `--canvas-label-font-size`: The size of the label on a connection.
|
|
38136
|
+
* - `--canvas-radius`: The frame's corners.
|
|
38137
|
+
* - `--canvas-selected-color`: The color of what is selected: a card's outline, its corners and its move handle, a connection and its ends, and the box drawn to select.
|
|
37471
38138
|
* - `--viewport-control-background-color`: The background of the pan and zoom buttons. `Map` uses the same property.
|
|
37472
38139
|
*
|
|
37473
38140
|
* ## CSS Parts
|
|
@@ -37645,8 +38312,12 @@ export type CustomElements = {
|
|
|
37645
38312
|
* - `--card-background-color`: Surface behind the card.
|
|
37646
38313
|
* - `--card-border-color`: Border color of the surface.
|
|
37647
38314
|
* - `--card-border-width`: Width of the surface's edge. Follows `--helix-border-surface`, which is a hairline unless your theme sets another width. The edge is what sets the surface apart.
|
|
38315
|
+
* - `--card-color`: Color of the card's text. Muted by default, so the header reads as the card's own voice.
|
|
37648
38316
|
* - `--card-gap`: Space between the regions, and between a header or footer and its actions.
|
|
38317
|
+
* - `--card-heading-color`: Color of the header, and of a `Text` heading anywhere in the card. The foreground by default.
|
|
38318
|
+
* - `--card-line-height`: Line height of the card's text. The normal leading by default.
|
|
37649
38319
|
* - `--card-media-block-size`: Height of the media region. Defaults to `auto`, which follows an image's own proportions. A chart has no height of its own, so set one here for a chart.
|
|
38320
|
+
* - `--card-media-fit`: How a slotted picture fills the media region, as `object-fit`. `cover` by default; `contain` shows all of a logo or a screenshot.
|
|
37650
38321
|
* - `--card-media-size`: Width of the media column when horizontal.
|
|
37651
38322
|
* - `--card-padding`: Inset applied to each region.
|
|
37652
38323
|
* - `--card-radius`: Corner radius of the surface.
|
|
@@ -39045,15 +39716,17 @@ export type CustomElements = {
|
|
|
39045
39716
|
* the button is drawn only while the cap hides something, measured as the
|
|
39046
39717
|
* block lays out. Not for a diff, whose files each scroll on their own.
|
|
39047
39718
|
* - `expand-label`/`expandLabel`: The expand button's words while the cap hides lines.
|
|
39048
|
-
* - `label`: The block's name, usually a file name
|
|
39719
|
+
* - `label`: The block's name, usually a file name, drawn in the header.
|
|
39049
39720
|
*
|
|
39050
|
-
*
|
|
39051
|
-
*
|
|
39721
|
+
* Absent, the block is named by `language` where there is one. In a diff,
|
|
39722
|
+
* each file is named from the patch, and this names a patch that carries no
|
|
39723
|
+
* name of its own.
|
|
39052
39724
|
* - `language`: The language the code is written in, such as `ts` or `css`, handed to
|
|
39053
39725
|
* `highlight` as its second argument.
|
|
39054
39726
|
*
|
|
39055
|
-
*
|
|
39056
|
-
*
|
|
39727
|
+
* A block with no `label` is named by it, in the header and on the copy
|
|
39728
|
+
* button, as a docs site names a snippet by its language. Absent hands
|
|
39729
|
+
* `highlight` an empty string and names nothing.
|
|
39057
39730
|
* - `line-numbers`/`lineNumbers`: Whether the lines are numbered in a gutter beside the code.
|
|
39058
39731
|
*
|
|
39059
39732
|
* The numbers are hidden from the accessibility tree and are not part of a
|
|
@@ -39136,14 +39809,21 @@ export type CustomElements = {
|
|
|
39136
39809
|
*
|
|
39137
39810
|
* CSS variables available for styling the component.
|
|
39138
39811
|
*
|
|
39812
|
+
* - `--code-block-added-color`: The color a diff's added lines are tinted in and their `+` is drawn in. The success color by default.
|
|
39139
39813
|
* - `--code-block-backdrop`: A backdrop filter for the block and its header, for a translucent background.
|
|
39140
39814
|
* - `--code-block-background-color`: The background behind the code. Set it for a block that sits on a surface other than the page background.
|
|
39141
39815
|
* - `--code-block-border-color`: The line around the block and its header.
|
|
39816
|
+
* - `--code-block-color`: The color of the code. A highlighter's own colors win on the tokens it colors.
|
|
39142
39817
|
* - `--code-block-expand-color`: The color of the button under a capped block that shows every line.
|
|
39818
|
+
* - `--code-block-font-family`: The typeface of the code and its line numbers. The mono face by default.
|
|
39819
|
+
* - `--code-block-font-size`: The size of the code and its line numbers.
|
|
39143
39820
|
* - `--code-block-gutter-color`: The color of the line numbers.
|
|
39144
39821
|
* - `--code-block-header-background-color`: The background behind the name. The default is `surface-raised`.
|
|
39822
|
+
* - `--code-block-label-color`: The color of the name in the header.
|
|
39823
|
+
* - `--code-block-line-height`: The line height of the code and its line numbers, as a number or a length.
|
|
39145
39824
|
* - `--code-block-max-block-size`: The tallest the code grows before it scrolls, or until `expandable`'s button shows every line. The default is no limit.
|
|
39146
39825
|
* - `--code-block-radius`: The corner radius of the header's top and the block's bottom, which form one shape.
|
|
39826
|
+
* - `--code-block-removed-color`: The color a diff's removed lines are tinted in and their `-` is drawn in. The danger color by default.
|
|
39147
39827
|
*
|
|
39148
39828
|
* ## CSS Parts
|
|
39149
39829
|
*
|
|
@@ -39176,7 +39856,7 @@ export type CustomElements = {
|
|
|
39176
39856
|
* - `gutter`: The line numbers beside the code, shown when `line-numbers` is set.
|
|
39177
39857
|
* - `header`: The bar that holds the name and the copy button, shown when there is a name.
|
|
39178
39858
|
* - `hunk`: In a diff, a `@@` line saying where the lines under it are.
|
|
39179
|
-
* - `label`: The
|
|
39859
|
+
* - `label`: The block's name: its `label`, or its `language` where it has no label.
|
|
39180
39860
|
* - `marker`: In a diff, the `+`, `-`, or space that starts a line.
|
|
39181
39861
|
* - `new`: In a split diff, the new version's `<pre>`.
|
|
39182
39862
|
* - `number`: In a diff, a line number.
|
|
@@ -40031,12 +40711,19 @@ export type CustomElements = {
|
|
|
40031
40711
|
* leaves the field or presses Enter with nothing highlighted, and text that
|
|
40032
40712
|
* names an option takes that option. Unlike `creatable`, no event asks
|
|
40033
40713
|
* first and no option is expected to be added: the value is the text.
|
|
40034
|
-
* - `autocomplete`: What the browser may autofill
|
|
40714
|
+
* - `autocomplete`: What the browser may autofill, as a platform token such as `country`.
|
|
40035
40715
|
*
|
|
40036
40716
|
* **Defaults to `off`, which is not the platform's default and is the
|
|
40037
40717
|
* point.** The field filters a list rather than collecting a value, so a
|
|
40038
40718
|
* browser offering to fill it with a saved address is competing for the same
|
|
40039
40719
|
* keystrokes as the listbox. A consumer who wants autofill can still ask.
|
|
40720
|
+
*
|
|
40721
|
+
* Set, a combobox whose answer is one of its options keeps a hidden native
|
|
40722
|
+
* `<select>` with the same options for the browser to fill, as React Aria's
|
|
40723
|
+
* combobox and Select do, and the option the browser picks, by its value or
|
|
40724
|
+
* its words, becomes the value. The text field itself stays `off`, so the
|
|
40725
|
+
* browser fills the answer and not the filter. With `allows-custom-value`
|
|
40726
|
+
* the token goes on the text field, whose words are the answer.
|
|
40040
40727
|
* - `creatable`: Whether the user can add a value that is not in the list.
|
|
40041
40728
|
*
|
|
40042
40729
|
* The row appears while what is typed matches no option's words exactly, so
|
|
@@ -40055,8 +40742,9 @@ export type CustomElements = {
|
|
|
40055
40742
|
* every keystroke. See Listbox's `filter-delay`.
|
|
40056
40743
|
* - `list-label`/`listLabel`: The list's name, read by screen readers. The list has no visible name.
|
|
40057
40744
|
* - `load-error`/`loadError`: What the list says when its options could not be loaded, such as after a
|
|
40058
|
-
* request to a server fails. Empty
|
|
40059
|
-
*
|
|
40745
|
+
* request to a server fails. Empty, null or no attribute is no error, so
|
|
40746
|
+
* removing the attribute clears it. Passed to the list, which shows it
|
|
40747
|
+
* under any options there are and tells screen readers.
|
|
40060
40748
|
* - `loading`: Whether the options are still loading.
|
|
40061
40749
|
*
|
|
40062
40750
|
* Passed straight to the list, which is where the rows are and so where the
|
|
@@ -40100,6 +40788,8 @@ export type CustomElements = {
|
|
|
40100
40788
|
* - `results-label`/`resultsLabel`: What a screen reader hears when typing leaves any other number of
|
|
40101
40789
|
* options. `{count}` is the count, and `Intl.PluralRules` picks between the
|
|
40102
40790
|
* two.
|
|
40791
|
+
* - `selected-label`/`selectedLabel`: What VoiceOver hears for a chosen option, as the highlight reaches it and
|
|
40792
|
+
* once it is chosen, on Apple devices. `{name}` is the option's words.
|
|
40103
40793
|
* - `suggest`: Whether the field completes the word as the user types.
|
|
40104
40794
|
*
|
|
40105
40795
|
* `suggest` rather than `autocomplete`, which is a real HTML attribute this
|
|
@@ -40302,6 +40992,7 @@ export type CustomElements = {
|
|
|
40302
40992
|
* - `listbox-loading`: Shown while the options are loading.
|
|
40303
40993
|
* - `listbox-search`: The region holding the field that narrows the list.
|
|
40304
40994
|
* - `listbox-search-field`: The filter field inside that region.
|
|
40995
|
+
* - `live`: The region VoiceOver hears the highlight, the count and a choice from on Apple devices, drawn once there is one to say. Visually hidden in the styled tier.
|
|
40305
40996
|
* - `rest`: The count of choices held beyond `max-tags`. A `<button>` with `expandable`, a `<span>` without it.
|
|
40306
40997
|
* - `surface`: The floating panel.
|
|
40307
40998
|
* - `tag`: One chosen option.
|
|
@@ -40317,8 +41008,10 @@ export type CustomElements = {
|
|
|
40317
41008
|
*
|
|
40318
41009
|
* These can be used to apply styling when a component is in a given state.
|
|
40319
41010
|
*
|
|
41011
|
+
* - `blank`: While nothing is chosen.
|
|
40320
41012
|
* - `error`: While `load-error` is set.
|
|
40321
41013
|
* - `invalid`: The control has an error to show, from the browser's validation or from your `feedback`.
|
|
41014
|
+
* - `loading`: While `loading` is set.
|
|
40322
41015
|
* - `no-results`: What was typed hid every option of a list that has some.
|
|
40323
41016
|
* - `open`: While the list is open.
|
|
40324
41017
|
* - `settled`: Set one frame after the first render. Transitions wait for it, so an element does not animate its own arrival.
|
|
@@ -40363,8 +41056,9 @@ export type CustomElements = {
|
|
|
40363
41056
|
* with: one key, said once.
|
|
40364
41057
|
* - `label`: Accessible name for the overlay, which has no visible heading.
|
|
40365
41058
|
* - `load-error`/`loadError`: What the list says when its commands could not be loaded, such as after a
|
|
40366
|
-
* request to a server fails. Empty
|
|
40367
|
-
*
|
|
41059
|
+
* request to a server fails. Empty, null or no attribute is no error, so
|
|
41060
|
+
* removing the attribute clears it. Passed to the list, which shows it
|
|
41061
|
+
* under any commands there are and tells screen readers.
|
|
40368
41062
|
* - `loading`: Whether the commands are still loading, for a palette that asks a server
|
|
40369
41063
|
* for them as the user types.
|
|
40370
41064
|
*
|
|
@@ -41881,6 +42575,7 @@ export type CustomElements = {
|
|
|
41881
42575
|
* CSS variables available for styling the component.
|
|
41882
42576
|
*
|
|
41883
42577
|
* - `--description-list-actions-gap`: The space between the value and the controls in `actions`.
|
|
42578
|
+
* - `--description-list-item-align`: How a label and its value line up beside each other, as `align-items`. Defaults to `baseline`; `center` suits a value taller than a line, such as an avatar.
|
|
41884
42579
|
* - `--description-list-item-gap`: The space between a label and its value when the label sits over it.
|
|
41885
42580
|
* - `--description-list-label-color`: The color of a label.
|
|
41886
42581
|
* - `--description-list-label-font-size`: The size of a label's text.
|
|
@@ -41891,6 +42586,7 @@ export type CustomElements = {
|
|
|
41891
42586
|
*
|
|
41892
42587
|
* Custom selectors for styling elements within the component.
|
|
41893
42588
|
*
|
|
42589
|
+
* - `actions`: The box after the value inside its `<dd>`, holding the `actions` slot.
|
|
41894
42590
|
* - `label`: The `<dt>`, holding the label.
|
|
41895
42591
|
* - `value`: The `<dd>`, holding the value.
|
|
41896
42592
|
*
|
|
@@ -41898,6 +42594,7 @@ export type CustomElements = {
|
|
|
41898
42594
|
*
|
|
41899
42595
|
* These can be used to apply styling when a component is in a given state.
|
|
41900
42596
|
*
|
|
42597
|
+
* - `several`: The values are several `<dd>` elements of your own, so the item draws no `value` part.
|
|
41901
42598
|
* - `settled`: Set one frame after the first render. Transitions wait for it, so an element does not animate its own arrival.
|
|
41902
42599
|
*/
|
|
41903
42600
|
"helix-description-list-item": Partial<
|
|
@@ -41921,10 +42618,16 @@ export type CustomElements = {
|
|
|
41921
42618
|
* wide as its widest pair, labels sit on the start edge, and values sit on the
|
|
41922
42619
|
* end edge in tabular figures, as in a set of totals.
|
|
41923
42620
|
*
|
|
42621
|
+
* **For a rule between pairs, set `divided`.** The rule sits in the middle of
|
|
42622
|
+
* the gap, so the pairs keep the same room on either side of it.
|
|
42623
|
+
*
|
|
41924
42624
|
* ## Attributes & Properties
|
|
41925
42625
|
*
|
|
41926
42626
|
* Component attributes and properties that can be applied to the element or by using JavaScript.
|
|
41927
42627
|
*
|
|
42628
|
+
* - `divided`: Draws a rule between one pair and the next, in the middle of the gap, as
|
|
42629
|
+
* a details panel with many rows often does. Off by default, where space
|
|
42630
|
+
* alone separates the pairs.
|
|
41928
42631
|
* - `justify`: Where the values sit, beside their labels.
|
|
41929
42632
|
*
|
|
41930
42633
|
* Absent, each value starts right after the label column. `between` sets it on
|
|
@@ -42002,7 +42705,10 @@ export type CustomElements = {
|
|
|
42002
42705
|
* CSS variables available for styling the component.
|
|
42003
42706
|
*
|
|
42004
42707
|
* - `--description-list-column-gap`: The space between the column of labels and the column of values, with `direction="row"`.
|
|
42708
|
+
* - `--description-list-divider-color`: The color of the rule between pairs, with `divided`.
|
|
42709
|
+
* - `--description-list-divider-width`: The thickness of the rule between pairs, with `divided`.
|
|
42005
42710
|
* - `--description-list-gap`: Space between one pair and the next. The default is smaller with `direction="row"` than when stacked. Setting this property replaces both defaults.
|
|
42711
|
+
* - `--description-list-label-width`: The width of the column of labels, with `direction="row"`. Defaults to the width of the longest label; set a length such as `10rem` to line up several lists.
|
|
42006
42712
|
*
|
|
42007
42713
|
* ## CSS Parts
|
|
42008
42714
|
*
|
|
@@ -42248,19 +42954,21 @@ export type CustomElements = {
|
|
|
42248
42954
|
* Absent is the middle. `start` and `end` move it toward one end, with a
|
|
42249
42955
|
* short length of line, `--divider-content-offset`, kept before or after it.
|
|
42250
42956
|
* A divider with nothing set into it is one line whatever this says.
|
|
42251
|
-
* - `announced`: Whether screen readers announce the line as a separator
|
|
42252
|
-
*
|
|
42253
|
-
*
|
|
42254
|
-
*
|
|
42255
|
-
*
|
|
42256
|
-
*
|
|
42257
|
-
*
|
|
42258
|
-
*
|
|
42259
|
-
*
|
|
42260
|
-
*
|
|
42261
|
-
*
|
|
42262
|
-
*
|
|
42957
|
+
* - `announced`: Whether screen readers announce the line as a separator, which they now do
|
|
42958
|
+
* by default.
|
|
42959
|
+
*
|
|
42960
|
+
* It dates from when the line was decorative by default. It is still read,
|
|
42961
|
+
* and it wins over `decorative`, so a divider written with it stays a
|
|
42962
|
+
* separator.
|
|
42963
|
+
* - `decorative`: Takes the line out of the accessibility tree, for a rule that separates
|
|
42964
|
+
* nothing: one under a heading, or between the facts of a byline.
|
|
42965
|
+
*
|
|
42966
|
+
* Absent, the line is a separator, as `<hr>` is. Radix Separator's opt-out
|
|
42967
|
+
* has the same name. It turns the role off because a boolean attribute that
|
|
42968
|
+
* is on by default cannot be turned off from HTML.
|
|
42263
42969
|
* - `orientation`: The direction the line runs: `horizontal` or `vertical`.
|
|
42970
|
+
*
|
|
42971
|
+
* Unset is horizontal, or across the toolbar the divider sits in.
|
|
42264
42972
|
* - `whenSettled`: Resolves a frame after the first update, when transitions are switched on.
|
|
42265
42973
|
*
|
|
42266
42974
|
* **Named `whenSettled` because `settled` is taken four times over**, by
|
|
@@ -42294,6 +43002,9 @@ export type CustomElements = {
|
|
|
42294
43002
|
*
|
|
42295
43003
|
* - `--divider-color`: The color of the line.
|
|
42296
43004
|
* - `--divider-content-color`: The color of the content set into the line.
|
|
43005
|
+
* - `--divider-content-font-family`: The typeface of the content set into the line. The sans face by default.
|
|
43006
|
+
* - `--divider-content-font-size`: The size of the content set into the line. The `xs` step by default.
|
|
43007
|
+
* - `--divider-content-font-weight`: The weight of the content set into the line. The weight around the divider by default.
|
|
42297
43008
|
* - `--divider-content-gap`: The space either side of the content set into the line.
|
|
42298
43009
|
* - `--divider-content-offset`: The length of line before the content under `content-placement="start"`, or after it under `end`.
|
|
42299
43010
|
* - `--divider-length`: The length of a vertical line. A horizontal line takes the divider's width.
|
|
@@ -42313,6 +43024,7 @@ export type CustomElements = {
|
|
|
42313
43024
|
*
|
|
42314
43025
|
* These can be used to apply styling when a component is in a given state.
|
|
42315
43026
|
*
|
|
43027
|
+
* - `vertical`: The line runs vertically: `orientation="vertical"`, or no `orientation` inside a horizontal toolbar.
|
|
42316
43028
|
* - `settled`: Set one frame after the first render. Transitions wait for it, so an element does not animate its own arrival.
|
|
42317
43029
|
*/
|
|
42318
43030
|
"helix-divider": Partial<
|
|
@@ -42553,6 +43265,9 @@ export type CustomElements = {
|
|
|
42553
43265
|
*
|
|
42554
43266
|
* A column's heading is the cell's name in every row, so the first row
|
|
42555
43267
|
* answers for the column.
|
|
43268
|
+
* - `columnName(cell: number) => string`: The heading of the column at this place in a row: a cell's name is its
|
|
43269
|
+
* column's heading, read from the first row that has a cell there, so a
|
|
43270
|
+
* short first row does not lose the heading. `''` where no row has one.
|
|
42556
43271
|
* - `showsReading(at: number) => boolean`: Whether the slice at this place is drawn, which a slice a legend hid is
|
|
42557
43272
|
* not. The keys pass over it, as the ring closes over it.
|
|
42558
43273
|
*
|
|
@@ -43078,7 +43793,7 @@ export type CustomElements = {
|
|
|
43078
43793
|
*
|
|
43079
43794
|
* - `(default)`: The message: why the region is empty, and what to do about it.
|
|
43080
43795
|
* - `actions`: The action that would put something in the region.
|
|
43081
|
-
* - `heading`: The heading, which names what is missing.
|
|
43796
|
+
* - `heading`: The heading, which names what is missing. A heading element, such as an `<h3>`, keeps its level; any other element is read as a heading at `heading-level`. Replaces the one `heading` draws.
|
|
43082
43797
|
* - `icon`: An icon above the heading.
|
|
43083
43798
|
*
|
|
43084
43799
|
* ## CSS Custom Properties
|
|
@@ -43100,7 +43815,7 @@ export type CustomElements = {
|
|
|
43100
43815
|
*
|
|
43101
43816
|
* Custom selectors for styling elements within the component.
|
|
43102
43817
|
*
|
|
43103
|
-
* - `heading`: The heading
|
|
43818
|
+
* - `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.
|
|
43104
43819
|
* - `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.
|
|
43105
43820
|
*
|
|
43106
43821
|
* ## CSS States
|
|
@@ -44281,6 +44996,13 @@ export type CustomElements = {
|
|
|
44281
44996
|
* this is and a stylesheet has a reason to know: a compact reading is a fixed
|
|
44282
44997
|
* few characters and a date is not.
|
|
44283
44998
|
* - `era`: How the era is written, such as AD, where a date is shown.
|
|
44999
|
+
* - `fields`: Draws each field of a date in a part of its own: `weekday`, `day`,
|
|
45000
|
+
* `month`, `year`, `era`, `hour`, `minute`, `second`, `day-period` and
|
|
45001
|
+
* `time-zone-name`, so `::part(year)` can set the year apart.
|
|
45002
|
+
*
|
|
45003
|
+
* Off by default, which draws the date as one run of text, as Shoelace and
|
|
45004
|
+
* Web Awesome do. An `elapsed` or `relative` reading is one phrase either
|
|
45005
|
+
* way.
|
|
44284
45006
|
* - `frozen`: Draws an `elapsed` or `relative` reading once and leaves it, where it
|
|
44285
45007
|
* would otherwise move on as it goes stale.
|
|
44286
45008
|
*
|
|
@@ -44346,12 +45068,24 @@ export type CustomElements = {
|
|
|
44346
45068
|
*
|
|
44347
45069
|
* Custom selectors for styling elements within the component.
|
|
44348
45070
|
*
|
|
45071
|
+
* - `day`: The day of the month, with `fields`.
|
|
45072
|
+
* - `day-period`: AM or PM, or the locale's word for the part of the day, with `fields`.
|
|
45073
|
+
* - `era`: The era, such as AD, with `fields` and `era`.
|
|
45074
|
+
* - `hour`: The hour, with `fields`.
|
|
45075
|
+
* - `minute`: The minute, with `fields`.
|
|
45076
|
+
* - `month`: The month, with `fields`.
|
|
45077
|
+
* - `second`: The second, with `fields`.
|
|
44349
45078
|
* - `time`: The `<time>` element that holds the formatted text.
|
|
45079
|
+
* - `time-zone-name`: The time zone's name, with `fields`, where `time-zone-name` or a `long` or `full` `time-style` shows it.
|
|
45080
|
+
* - `weekday`: The day of the week, with `fields`.
|
|
45081
|
+
* - `year`: The year, with `fields`.
|
|
44350
45082
|
*
|
|
44351
45083
|
* ## CSS States
|
|
44352
45084
|
*
|
|
44353
45085
|
* These can be used to apply styling when a component is in a given state.
|
|
44354
45086
|
*
|
|
45087
|
+
* - `future`: An `elapsed` or `relative` reading of a moment still to come, such as "in 3 hours".
|
|
45088
|
+
* - `past`: An `elapsed` or `relative` reading of a moment gone, such as "3 hours ago".
|
|
44355
45089
|
* - `settled`: Set one frame after the first render. Transitions wait for it, so an element does not animate its own arrival.
|
|
44356
45090
|
*/
|
|
44357
45091
|
"helix-format-date": Partial<
|
|
@@ -44534,7 +45268,14 @@ export type CustomElements = {
|
|
|
44534
45268
|
* - `(default)`: The renderer's box, which the drawing is made in.
|
|
44535
45269
|
* - `filter-icon`: The icon in the search field. Defaults to a magnifying glass.
|
|
44536
45270
|
* - `footer`: Content below the graph.
|
|
45271
|
+
* - `fullscreen-icon`: Replaces the glyph inside the fullscreen button.
|
|
44537
45272
|
* - `header`: Content above the graph.
|
|
45273
|
+
* - `pan-down-icon`: Replaces the glyph inside the pan down button.
|
|
45274
|
+
* - `pan-end-icon`: Replaces the glyph inside the button that pans toward the end of a line of text.
|
|
45275
|
+
* - `pan-start-icon`: Replaces the glyph inside the button that pans toward the start of a line of text.
|
|
45276
|
+
* - `pan-up-icon`: Replaces the glyph inside the pan up button.
|
|
45277
|
+
* - `zoom-in-icon`: Replaces the glyph inside the zoom-in button.
|
|
45278
|
+
* - `zoom-out-icon`: Replaces the glyph inside the zoom-out button.
|
|
44538
45279
|
*
|
|
44539
45280
|
* ## Methods
|
|
44540
45281
|
*
|
|
@@ -44633,9 +45374,14 @@ export type CustomElements = {
|
|
|
44633
45374
|
*
|
|
44634
45375
|
* These can be used to apply styling when a component is in a given state.
|
|
44635
45376
|
*
|
|
45377
|
+
* - `empty`: The list holds no notes: the graph has none, or a search or the groups hid them all.
|
|
44636
45378
|
* - `fullscreen`: The graph fills the screen.
|
|
44637
45379
|
* - `idle`: The user has been still long enough for the header and footer to fade.
|
|
45380
|
+
* - `local`: The drawing shows the selected note's local graph, with `depth`.
|
|
45381
|
+
* - `panel-open`: A graph with `no-panel` has the search and the list open over the drawing.
|
|
44638
45382
|
* - `ready`: The graph has been drawn whole, after `helix-graph-ready`.
|
|
45383
|
+
* - `searching`: The search field holds words, and the list holds only the notes they find.
|
|
45384
|
+
* - `selected`: A note is selected, in the list or in the drawing.
|
|
44639
45385
|
* - `sharing`: The page keeps the plain wheel and one finger, with `gestures="cooperative"` or while a graph with `gestures="activate"` waits to be pressed.
|
|
44640
45386
|
* - `using`: A graph with `gestures="activate"` has been pressed and has the gestures.
|
|
44641
45387
|
* - `settled`: Set one frame after the first render. Transitions wait for it, so an element does not animate its own arrival.
|
|
@@ -44822,6 +45568,9 @@ export type CustomElements = {
|
|
|
44822
45568
|
* calendar heatmap does: a week is a column, so the strip reads along the
|
|
44823
45569
|
* line in weeks, from the right on a right-to-left page, and top to bottom in
|
|
44824
45570
|
* days.
|
|
45571
|
+
* - `selected-label`/`selectedLabel`: What the readout adds for a selected cell, under `selection-mode`, after
|
|
45572
|
+
* where the cell stands: "Day 1: 0 (1 of 14, selected)". Empty adds
|
|
45573
|
+
* nothing.
|
|
44825
45574
|
* - `selection-label`/`selectionLabel`: What the `selection` part says after the selection changes, with `{count}` for
|
|
44826
45575
|
* how many cells are selected.
|
|
44827
45576
|
* - `selection-mode`/`selectionMode`: How many cells a reader can select: `single` or `multiple`.
|
|
@@ -44972,6 +45721,9 @@ export type CustomElements = {
|
|
|
44972
45721
|
*
|
|
44973
45722
|
* A column's heading is the cell's name in every row, so the first row
|
|
44974
45723
|
* answers for the column.
|
|
45724
|
+
* - `columnName(cell: number) => string`: The heading of the column at this place in a row: a cell's name is its
|
|
45725
|
+
* column's heading, read from the first row that has a cell there, so a
|
|
45726
|
+
* short first row does not lose the heading. `''` where no row has one.
|
|
44975
45727
|
* - `pageFrom(at: number, forward: boolean) => number | undefined`: Where PageUp or PageDown goes from the drawn cell at `at`: the same day a
|
|
44976
45728
|
* month on or back, by the dates the rows' headers carry. Undefined where
|
|
44977
45729
|
* they carry none, and the keys move four columns.
|
|
@@ -46762,6 +47514,9 @@ export type CustomElements = {
|
|
|
46762
47514
|
*
|
|
46763
47515
|
* A column's heading is the cell's name in every row, so the first row
|
|
46764
47516
|
* answers for the column.
|
|
47517
|
+
* - `columnName(cell: number) => string`: The heading of the column at this place in a row: a cell's name is its
|
|
47518
|
+
* column's heading, read from the first row that has a cell there, so a
|
|
47519
|
+
* short first row does not lose the heading. `''` where no row has one.
|
|
46765
47520
|
*
|
|
46766
47521
|
* ## CSS Custom Properties
|
|
46767
47522
|
*
|
|
@@ -47107,12 +47862,16 @@ export type CustomElements = {
|
|
|
47107
47862
|
* and this one was the English a form in another language still spoke in
|
|
47108
47863
|
* the bubble it raises on submit: `feedback` replaces the message under
|
|
47109
47864
|
* the field and does not reach that one.
|
|
47110
|
-
* - `autocomplete`: What
|
|
47865
|
+
* - `autocomplete`: What a browser's autofill may choose, as a platform token such as
|
|
47866
|
+
* `country` or `cc-exp-month`, as a native `<select>` takes it.
|
|
47111
47867
|
*
|
|
47112
|
-
*
|
|
47113
|
-
*
|
|
47114
|
-
*
|
|
47115
|
-
*
|
|
47868
|
+
* Set, the list draws a hidden native `<select>` with the same options for
|
|
47869
|
+
* the browser to fill, as React Aria's `HiddenSelect` does, and a fill
|
|
47870
|
+
* chooses the option. `off`, the default, draws none.
|
|
47871
|
+
*
|
|
47872
|
+
* **The filter field is never filled.** It narrows the list rather than
|
|
47873
|
+
* collecting a value, so a browser offering it a saved address competes
|
|
47874
|
+
* with the reader for the same keystrokes: it is always `off`.
|
|
47116
47875
|
* - `default-filter`/`defaultFilter`: The filter text the list starts with, when `filter` is not set.
|
|
47117
47876
|
* - `filter`: The text the list is filtered by, if any.
|
|
47118
47877
|
*
|
|
@@ -47134,8 +47893,19 @@ export type CustomElements = {
|
|
|
47134
47893
|
* letter. Enter and the arrow keys filter at once on what is typed, so they
|
|
47135
47894
|
* act on the list the reader expects.
|
|
47136
47895
|
* - `filter-label`/`filterLabel`: Placeholder text for the filter field.
|
|
47896
|
+
* - `layout`: How the options are laid out, which the arrow keys follow: `stack`, one
|
|
47897
|
+
* under another, or `grid`, in rows and columns, as React Aria's `ListBox`
|
|
47898
|
+
* lays out cards or photos. With `grid`, Up and Down move within a column,
|
|
47899
|
+
* and Left and Right along the list, mirrored right to left.
|
|
47900
|
+
*
|
|
47901
|
+
* The columns are the stylesheet's: the styled tier draws them at
|
|
47902
|
+
* `--listbox-column-min-inline-size` or wider, and a headless list lays out
|
|
47903
|
+
* `::part(items)` as it likes, since the keys read where each option is
|
|
47904
|
+
* drawn. A list of `items` stays a stack. Left out, the list is a stack,
|
|
47905
|
+
* and the host carries no attribute for it.
|
|
47137
47906
|
* - `load-error`/`loadError`: What the list says when its options could not be loaded, such as after a
|
|
47138
|
-
* request to a server fails. Empty is no error
|
|
47907
|
+
* request to a server fails. Empty, null or no attribute is no error, so
|
|
47908
|
+
* removing the attribute clears it.
|
|
47139
47909
|
*
|
|
47140
47910
|
* Set, it shows under any options there are, in place of `empty-text` and
|
|
47141
47911
|
* `loading-text`, and a screen reader hears it. Clear it when you ask again.
|
|
@@ -47158,6 +47928,8 @@ export type CustomElements = {
|
|
|
47158
47928
|
* **Two sentences, chosen by `Intl.PluralRules`**, which is Data Table's
|
|
47159
47929
|
* pair: a language with more forms than two picks the one for its `one` and
|
|
47160
47930
|
* writes the rest here.
|
|
47931
|
+
* - `selected-label`/`selectedLabel`: What VoiceOver hears as the highlight reaches a chosen option from the
|
|
47932
|
+
* filter field, on Apple devices. `{name}` is the option's words.
|
|
47161
47933
|
* - `disabled`: Whether the control is disabled and cannot be used.
|
|
47162
47934
|
*
|
|
47163
47935
|
* Reflected, because the styled tier selects on it, and mirrored to
|
|
@@ -47182,6 +47954,22 @@ export type CustomElements = {
|
|
|
47182
47954
|
* imperatively later, and nothing is hydrating by then.
|
|
47183
47955
|
*
|
|
47184
47956
|
* Here rather than on each control.
|
|
47957
|
+
* - `items`: The options as data, for a list too long to draw whole: each a value,
|
|
47958
|
+
* which is also its words, or a record with a `value`, a `label` and
|
|
47959
|
+
* `disabled`. Set, the list draws only the options in sight, and the ones
|
|
47960
|
+
* you write as children are not read.
|
|
47961
|
+
*
|
|
47962
|
+
* **Every option is still reachable.** The keyboard, the typeahead, the
|
|
47963
|
+
* filter and the value work over the whole set, and the option the keyboard
|
|
47964
|
+
* is on is drawn wherever it is, so a screen reader is told about it. Each
|
|
47965
|
+
* drawn option says its place in the set (`aria-posinset`, `aria-setsize`).
|
|
47966
|
+
* React Aria virtualizes a `ListBox` with its `Virtualizer`; this is core's
|
|
47967
|
+
* `VirtualizeController`.
|
|
47968
|
+
*
|
|
47969
|
+
* **The list needs a height to scroll in**: the styled tier's
|
|
47970
|
+
* `--listbox-max-block-size`, or a `max-block-size` on `::part(items)` in the
|
|
47971
|
+
* headless tier. Import the Option family as well, whose elements are drawn.
|
|
47972
|
+
* A server sends the list empty, and the options are drawn once it hydrates. (property only)
|
|
47185
47973
|
* - `selectedIndex`: Which option is chosen, as an index, or `-1` where none is.
|
|
47186
47974
|
*
|
|
47187
47975
|
* `<select>`'s own pair, and this control is what stands in for one. The
|
|
@@ -47302,10 +48090,8 @@ export type CustomElements = {
|
|
|
47302
48090
|
* read as a dial rather than scanned as a list, which is what Time Picker's
|
|
47303
48091
|
* wheels do with three of these.
|
|
47304
48092
|
*
|
|
47305
|
-
*
|
|
47306
|
-
*
|
|
47307
|
-
* which is not this list and is not guaranteed to be anything: measuring both
|
|
47308
|
-
* rects and moving by the difference needs no such assumption.
|
|
48093
|
+
* Measured by core's `centerInView`, or, for a list of `items`, by the
|
|
48094
|
+
* arithmetic, since the chosen option may not be drawn.
|
|
47309
48095
|
* - `requestFilter(next: string) => boolean`: Requests a new filter, and returns whether the request went through.
|
|
47310
48096
|
* - `formDisabledCallback(disabled: boolean) => void`: Called by the browser when an ancestor fieldset is disabled or enabled.
|
|
47311
48097
|
*
|
|
@@ -47354,6 +48140,7 @@ export type CustomElements = {
|
|
|
47354
48140
|
*
|
|
47355
48141
|
* - `--listbox-background-color`: The panel's fill. Set it to `transparent` when the list is already inside a panel.
|
|
47356
48142
|
* - `--listbox-border`: The panel's border, as a shorthand. Set it to `none` when the list is already inside a panel.
|
|
48143
|
+
* - `--listbox-column-min-inline-size`: How narrow a column may be with `layout="grid"`. As many columns as fit are drawn. Defaults to `8rem`.
|
|
47357
48144
|
* - `--listbox-error-color`: The color of the line shown while `load-error` is set.
|
|
47358
48145
|
* - `--listbox-max-block-size`: Maximum height of the list before it scrolls.
|
|
47359
48146
|
*
|
|
@@ -48260,8 +49047,20 @@ export type CustomElements = {
|
|
|
48260
49047
|
*
|
|
48261
49048
|
* - `(default)`: The element your renderer draws the map in, and the map's markers, routes, areas, positions, and points layers.
|
|
48262
49049
|
* - `attribution`: The map credit, which most tile licenses require.
|
|
49050
|
+
* - `face-north-icon`: Replaces the compass needle. It inherits `--map-needle-turn`, so `rotate: var(--map-needle-turn)` keeps it pointing north.
|
|
48263
49051
|
* - `footer`: Content below the map, such as a legend or a scale.
|
|
49052
|
+
* - `fullscreen-icon`: Replaces the glyph inside the fullscreen button.
|
|
48264
49053
|
* - `header`: Content above the map, such as a title or a search field.
|
|
49054
|
+
* - `layers-icon`: Replaces the glyph inside the layers button.
|
|
49055
|
+
* - `pan-down-icon`: Replaces the glyph inside the pan down button.
|
|
49056
|
+
* - `pan-end-icon`: Replaces the glyph inside the button that pans toward the end of a line of text.
|
|
49057
|
+
* - `pan-start-icon`: Replaces the glyph inside the button that pans toward the start of a line of text.
|
|
49058
|
+
* - `pan-up-icon`: Replaces the glyph inside the pan up button.
|
|
49059
|
+
* - `rotate-left-icon`: Replaces the glyph inside the rotate left button.
|
|
49060
|
+
* - `rotate-right-icon`: Replaces the glyph inside the rotate right button.
|
|
49061
|
+
* - `tilt-icon`: Replaces the "3D" inside the 3D button.
|
|
49062
|
+
* - `zoom-in-icon`: Replaces the glyph inside the zoom-in button.
|
|
49063
|
+
* - `zoom-out-icon`: Replaces the glyph inside the zoom-out button.
|
|
48265
49064
|
*
|
|
48266
49065
|
* ## Methods
|
|
48267
49066
|
*
|
|
@@ -48301,9 +49100,19 @@ export type CustomElements = {
|
|
|
48301
49100
|
*
|
|
48302
49101
|
* CSS variables available for styling the component.
|
|
48303
49102
|
*
|
|
49103
|
+
* - `--map-attribution-border-color`: The rule above the map credit, under the map.
|
|
49104
|
+
* - `--map-attribution-color`: The color of the map credit.
|
|
49105
|
+
* - `--map-attribution-font-size`: The size of the map credit's text.
|
|
48304
49106
|
* - `--map-background-color`: The color behind the map while tiles load.
|
|
48305
49107
|
* - `--map-block-size`: The frame's height, as a length. Ignored with `fill`, where the container decides it.
|
|
48306
49108
|
* - `--map-border-color`: The frame's border color.
|
|
49109
|
+
* - `--map-chosen-color`: The fill of the pressed 3D button and the ring around the chosen map type and each shown layer in the layers menu.
|
|
49110
|
+
* - `--map-layers-menu-gap`: The space between the map types and the layers in the layers menu.
|
|
49111
|
+
* - `--map-layers-menu-inline-size`: The width of the layers menu.
|
|
49112
|
+
* - `--map-layers-menu-padding`: The space inside the edge of the layers menu.
|
|
49113
|
+
* - `--map-needle-north-color`: The north half of the compass needle.
|
|
49114
|
+
* - `--map-needle-south-color`: The south half of the compass needle.
|
|
49115
|
+
* - `--map-radius`: The frame's corners.
|
|
48307
49116
|
* - `--viewport-control-background-color`: The background of the pan and zoom buttons. Canvas uses the same property.
|
|
48308
49117
|
* - `--map-needle-turn`: How far the needle turns to point north, as an angle. The frame writes it from `bearing`.
|
|
48309
49118
|
*
|
|
@@ -48352,8 +49161,11 @@ export type CustomElements = {
|
|
|
48352
49161
|
*
|
|
48353
49162
|
* - `fullscreen`: The map fills the screen.
|
|
48354
49163
|
* - `idle`: The user has been still long enough for the header and footer to fade.
|
|
49164
|
+
* - `layers-open`: The layers menu is open.
|
|
48355
49165
|
* - `ready`: The map has been drawn whole, after `helix-map-ready`.
|
|
49166
|
+
* - `rotated`: The map is turned away from north, by `bearing`.
|
|
48356
49167
|
* - `sharing`: The page keeps the plain wheel and one finger, with `gestures="cooperative"` or while a map with `gestures="activate"` waits to be pressed.
|
|
49168
|
+
* - `tilted`: The map is tilted by `pitch`, so it no longer looks straight down.
|
|
48357
49169
|
* - `using`: A map with `gestures="activate"` has been pressed and has the gestures.
|
|
48358
49170
|
* - `settled`: Set one frame after the first render. Transitions wait for it, so an element does not animate its own arrival.
|
|
48359
49171
|
*/
|
|
@@ -49635,6 +50447,16 @@ export type CustomElements = {
|
|
|
49635
50447
|
* - `body`: The label and the caption together.
|
|
49636
50448
|
* - `label`: What happened, on the first line.
|
|
49637
50449
|
* - `media`: The leading slot's box.
|
|
50450
|
+
* - `time-day`: Format Date's `day`, forwarded for a time drawn as fields. An elapsed time draws none.
|
|
50451
|
+
* - `time-day-period`: Format Date's `day-period`, forwarded for a time drawn as fields. An elapsed time draws none.
|
|
50452
|
+
* - `time-era`: Format Date's `era`, forwarded for a time drawn as fields. An elapsed time draws none.
|
|
50453
|
+
* - `time-hour`: Format Date's `hour`, forwarded for a time drawn as fields. An elapsed time draws none.
|
|
50454
|
+
* - `time-minute`: Format Date's `minute`, forwarded for a time drawn as fields. An elapsed time draws none.
|
|
50455
|
+
* - `time-month`: Format Date's `month`, forwarded for a time drawn as fields. An elapsed time draws none.
|
|
50456
|
+
* - `time-second`: Format Date's `second`, forwarded for a time drawn as fields. An elapsed time draws none.
|
|
50457
|
+
* - `time-time-zone-name`: Format Date's `time-zone-name`, forwarded for a time drawn as fields. An elapsed time draws none.
|
|
50458
|
+
* - `time-weekday`: Format Date's `weekday`, forwarded for a time drawn as fields. An elapsed time draws none.
|
|
50459
|
+
* - `time-year`: Format Date's `year`, forwarded for a time drawn as fields. An elapsed time draws none.
|
|
49638
50460
|
*
|
|
49639
50461
|
* ## CSS States
|
|
49640
50462
|
*
|
|
@@ -49670,6 +50492,12 @@ export type CustomElements = {
|
|
|
49670
50492
|
* say that without the component knowing what a row looks like.
|
|
49671
50493
|
* - `loading-text`/`loadingText`: The text shown and announced while the rows load.
|
|
49672
50494
|
* - `label`: The feed's name, read by screen readers.
|
|
50495
|
+
* - `load-error`/`loadError`: What the feed says when a page of it could not be loaded, such as after a
|
|
50496
|
+
* request to a server fails. Empty, null or no attribute is no error, so
|
|
50497
|
+
* removing the attribute clears it.
|
|
50498
|
+
*
|
|
50499
|
+
* Set, it shows under the rows there are, in place of `empty-text` and
|
|
50500
|
+
* `loading-text`, and a screen reader hears it. Clear it when you ask again.
|
|
49673
50501
|
* - `load-more`/`loadMore`: Whether to draw a button after the list that asks for the next page, by
|
|
49674
50502
|
* sending `helix-load-more`. Take it off once there is nothing more.
|
|
49675
50503
|
* - `load-more-label`/`loadMoreLabel`: The text of the `load-more` button.
|
|
@@ -49751,6 +50579,7 @@ export type CustomElements = {
|
|
|
49751
50579
|
*
|
|
49752
50580
|
* - `(default)`: The notifications.
|
|
49753
50581
|
* - `empty`: Replaces the words of `empty-text` in the `empty` part, such as a picture and a line of your own.
|
|
50582
|
+
* - `error`: Replaces the words of `load-error` in the `error` part, such as a line with a retry button.
|
|
49754
50583
|
* - `footer`: Below the list, for a link to everything.
|
|
49755
50584
|
* - `header`: Above the list, for a title and the mark-all control.
|
|
49756
50585
|
* - `loading`: Replaces the words of `loading-text` in the `loading` part, such as a loader.
|
|
@@ -49790,6 +50619,7 @@ export type CustomElements = {
|
|
|
49790
50619
|
*
|
|
49791
50620
|
* CSS variables available for styling the component.
|
|
49792
50621
|
*
|
|
50622
|
+
* - `--notifications-error-color`: The color of the `error` line.
|
|
49793
50623
|
* - `--notifications-max-block-size`: How tall the feed may get before the list scrolls.
|
|
49794
50624
|
* - `--notifications-media-column`: Width of the media column that every item keeps when any item in the feed has media.
|
|
49795
50625
|
* - `--notifications-padding-inline`: Space either side of the header and footer.
|
|
@@ -49799,8 +50629,9 @@ export type CustomElements = {
|
|
|
49799
50629
|
*
|
|
49800
50630
|
* Custom selectors for styling elements within the component.
|
|
49801
50631
|
*
|
|
50632
|
+
* - `error`: The line `load-error` shows under the rows, in the danger color.
|
|
49802
50633
|
* - `list`: The list itself.
|
|
49803
|
-
* - `live`: A copy of the empty and
|
|
50634
|
+
* - `live`: A copy of the empty, loading and error messages, in a live region that screen readers announce when they change. Visually hidden in the styled tier.
|
|
49804
50635
|
* - `mark-all`: The control that marks everything read.
|
|
49805
50636
|
* - `more`: The button after the list that asks for more, while `load-more` is set. It stays while the feed is loading, in a lighter color and `aria-disabled`, so focus stays on it.
|
|
49806
50637
|
* - `empty`: Shown when there is nothing in the feed.
|
|
@@ -49812,7 +50643,8 @@ export type CustomElements = {
|
|
|
49812
50643
|
*
|
|
49813
50644
|
* These can be used to apply styling when a component is in a given state.
|
|
49814
50645
|
*
|
|
49815
|
-
* - `empty`: While the feed holds no notification and is not loading. Never on the server, which cannot count the rows.
|
|
50646
|
+
* - `empty`: While the feed holds no notification and is not loading, and `load-error` is not set. Never on the server, which cannot count the rows.
|
|
50647
|
+
* - `error`: While `load-error` is set.
|
|
49816
50648
|
* - `loading`: While `loading` is set.
|
|
49817
50649
|
* - `media`: While a notification in the list holds something in its media slot, so every row keeps that column.
|
|
49818
50650
|
* - `settled`: Set one frame after the first render. Transitions wait for it, so an element does not animate its own arrival.
|
|
@@ -51049,10 +51881,24 @@ export type CustomElements = {
|
|
|
51049
51881
|
*
|
|
51050
51882
|
* CSS variables available for styling the component.
|
|
51051
51883
|
*
|
|
51884
|
+
* - `--pagination-current-border-color`: Edge of the page you are on.
|
|
51052
51885
|
* - `--pagination-current-color`: Fill behind the page you are on.
|
|
51886
|
+
* - `--pagination-current-font-weight`: Weight of the number of the page you are on.
|
|
51887
|
+
* - `--pagination-current-foreground-color`: Color of the number of the page you are on.
|
|
51888
|
+
* - `--pagination-disabled-foreground-color`: Color of a first, previous, next or last control with nowhere to go.
|
|
51889
|
+
* - `--pagination-disabled-opacity`: How faint a control with nowhere to go is drawn.
|
|
51890
|
+
* - `--pagination-ellipsis-foreground-color`: Color of the control that stands in for hidden pages.
|
|
51891
|
+
* - `--pagination-font-size`: Size of the numbers and the status text.
|
|
51892
|
+
* - `--pagination-font-weight`: Weight of the numbers and the status text.
|
|
51893
|
+
* - `--pagination-foreground-color`: Color of the numbers and the marks on every control.
|
|
51053
51894
|
* - `--pagination-gap`: Space between one control and the next.
|
|
51054
51895
|
* - `--pagination-hover-color`: Fill behind a control under the pointer.
|
|
51896
|
+
* - `--pagination-hover-foreground-color`: Color of a control's number or mark under the pointer.
|
|
51897
|
+
* - `--pagination-icon-size`: Size of the mark on a first, previous, next or last control, drawn or slotted.
|
|
51898
|
+
* - `--pagination-padding`: Space either side of a control's number or mark.
|
|
51899
|
+
* - `--pagination-radius`: Corner radius of every control in the row.
|
|
51055
51900
|
* - `--pagination-size`: The box every control in the row takes.
|
|
51901
|
+
* - `--pagination-status-foreground-color`: Color of the text that says which page you are on, in `compact`.
|
|
51056
51902
|
*
|
|
51057
51903
|
* ## CSS Parts
|
|
51058
51904
|
*
|
|
@@ -51221,6 +52067,13 @@ export type CustomElements = {
|
|
|
51221
52067
|
* string, as on a native control. The form does not submit while it is set.
|
|
51222
52068
|
* - `focus(options?: FocusOptions) => void`: Moves focus to the control, as focusing a native control does.
|
|
51223
52069
|
*
|
|
52070
|
+
* ## CSS Custom Properties
|
|
52071
|
+
*
|
|
52072
|
+
* CSS variables available for styling the component.
|
|
52073
|
+
*
|
|
52074
|
+
* - `--pagination-size`: Height of the select's trigger, the same hook that sizes every control in the page row.
|
|
52075
|
+
* - `--pagination-size-gap`: Space between the label and the select.
|
|
52076
|
+
*
|
|
51224
52077
|
* ## CSS Parts
|
|
51225
52078
|
*
|
|
51226
52079
|
* Custom selectors for styling elements within the component.
|
|
@@ -51243,6 +52096,7 @@ export type CustomElements = {
|
|
|
51243
52096
|
* - `control-listbox-loading`: The text shown while the options load.
|
|
51244
52097
|
* - `control-listbox-search`: The region that holds the filter field.
|
|
51245
52098
|
* - `control-listbox-search-field`: The filter field.
|
|
52099
|
+
* - `control-live`: The select's `live` part, the region a screen reader hears a choice made on the closed trigger from.
|
|
51246
52100
|
* - `control-surface`: The floating panel.
|
|
51247
52101
|
* - `control-trigger`: The closed control, which shows the chosen size.
|
|
51248
52102
|
* - `control-value`: The chosen size inside the trigger.
|
|
@@ -51314,6 +52168,13 @@ export type CustomElements = {
|
|
|
51314
52168
|
* browser harness's awaits it alone: a browser always runs the frame, and a
|
|
51315
52169
|
* timer beside it was a bet on how long one takes, which a busy run lost. (property only) (readonly)
|
|
51316
52170
|
*
|
|
52171
|
+
* ## CSS Custom Properties
|
|
52172
|
+
*
|
|
52173
|
+
* CSS variables available for styling the component.
|
|
52174
|
+
*
|
|
52175
|
+
* - `--pagination-font-size`: Size of the text, the same hook that sizes the page numbers.
|
|
52176
|
+
* - `--pagination-summary-foreground-color`: Color of the text.
|
|
52177
|
+
*
|
|
51317
52178
|
* ## CSS States
|
|
51318
52179
|
*
|
|
51319
52180
|
* These can be used to apply styling when a component is in a given state.
|
|
@@ -51992,7 +52853,8 @@ export type CustomElements = {
|
|
|
51992
52853
|
* - `toPng(size = 512) => Promise<Blob | null>`: The code as a PNG, `size` pixels square, drawn from `toSvg()`.
|
|
51993
52854
|
*
|
|
51994
52855
|
* `null` where no code is drawn.
|
|
51995
|
-
* - `download(filename = 'qr-code.png', size = 512) => Promise<void>`: Saves the code as a
|
|
52856
|
+
* - `download(filename = 'qr-code.png', size = 512) => Promise<void>`: Saves the code as a file named `filename`, `size` pixels square: an SVG
|
|
52857
|
+
* where the name ends in `.svg`, and a PNG otherwise.
|
|
51996
52858
|
*
|
|
51997
52859
|
* Call it from a press, since a browser lets a page start a download only
|
|
51998
52860
|
* in answer to one. Does nothing where no code is drawn.
|
|
@@ -52003,9 +52865,12 @@ export type CustomElements = {
|
|
|
52003
52865
|
*
|
|
52004
52866
|
* - `--qr-code-background-color`: The fill behind the modules, including the quiet zone and the logo's box.
|
|
52005
52867
|
* - `--qr-code-color`: Color of the dark modules. Defaults to the dark media ink, which is the same in both color schemes so the code scans.
|
|
52868
|
+
* - `--qr-code-fallback-padding`: The space around the fallback inside the square.
|
|
52006
52869
|
* - `--qr-code-finder-color`: Color of the three corner squares. Defaults to the color of the modules.
|
|
52007
52870
|
* - `--qr-code-logo-padding`: The clear space around the center logo.
|
|
52871
|
+
* - `--qr-code-logo-radius`: The corner radius of the logo's box.
|
|
52008
52872
|
* - `--qr-code-logo-size`: How much of the center a logo can cover. Defaults to `27%`, which `H` correction allows, because it can lose thirty percent.
|
|
52873
|
+
* - `--qr-code-radius`: The corner radius of the square.
|
|
52009
52874
|
* - `--qr-code-size`: How wide the square is. Defaults to `12rem`.
|
|
52010
52875
|
*
|
|
52011
52876
|
* ## CSS Parts
|
|
@@ -53587,6 +54452,9 @@ export type CustomElements = {
|
|
|
53587
54452
|
*
|
|
53588
54453
|
* A column's heading is the cell's name in every row, so the first row
|
|
53589
54454
|
* answers for the column.
|
|
54455
|
+
* - `columnName(cell: number) => string`: The heading of the column at this place in a row: a cell's name is its
|
|
54456
|
+
* column's heading, read from the first row that has a cell there, so a
|
|
54457
|
+
* short first row does not lose the heading. `''` where no row has one.
|
|
53590
54458
|
*
|
|
53591
54459
|
* ## CSS Custom Properties
|
|
53592
54460
|
*
|
|
@@ -53860,6 +54728,13 @@ export type CustomElements = {
|
|
|
53860
54728
|
* and this one was the English a form in another language still spoke in
|
|
53861
54729
|
* the bubble it raises on submit: `feedback` replaces the message under
|
|
53862
54730
|
* the field and does not reach that one.
|
|
54731
|
+
* - `autocomplete`: What a browser's autofill may fill in, as a platform token such as
|
|
54732
|
+
* `country` or `cc-exp-month`, as on a native `<select>`.
|
|
54733
|
+
*
|
|
54734
|
+
* Set, the select keeps a hidden native `<select>` with the same options for
|
|
54735
|
+
* the browser to fill, as React Aria's `HiddenSelect` does, and takes the
|
|
54736
|
+
* option the browser picks, by its value or its words, as the value. Empty
|
|
54737
|
+
* draws no hidden select, and a browser fills nothing.
|
|
53863
54738
|
* - `empty-text`/`emptyText`: The text shown when no options match the filter.
|
|
53864
54739
|
* - `filterable`: Whether the list can be narrowed by typing.
|
|
53865
54740
|
*
|
|
@@ -54093,6 +54968,7 @@ export type CustomElements = {
|
|
|
54093
54968
|
* - `listbox-loading`: The text shown while the options load.
|
|
54094
54969
|
* - `listbox-search`: The region that holds the filter field.
|
|
54095
54970
|
* - `listbox-search-field`: The filter field.
|
|
54971
|
+
* - `live`: The region a screen reader announces a choice made on the closed trigger from, drawn once there is one to say. Visually hidden in the styled tier.
|
|
54096
54972
|
* - `surface`: The floating panel.
|
|
54097
54973
|
* - `trigger`: The closed control, which shows the chosen value.
|
|
54098
54974
|
* - `value`: The chosen option's text inside the trigger.
|
|
@@ -54820,6 +55696,68 @@ export type CustomElements = {
|
|
|
54820
55696
|
HelixSparklineProps & BaseProps<HelixSparkline> & BaseEvents<HelixSparkline>
|
|
54821
55697
|
>;
|
|
54822
55698
|
|
|
55699
|
+
/**
|
|
55700
|
+
* A column of actions with its name above them, in the small muted words a
|
|
55701
|
+
* menu heads its sections with, lined up on the side the trigger is on. The
|
|
55702
|
+
* space between two groups is the space between two actions.
|
|
55703
|
+
*
|
|
55704
|
+
* ## Attributes & Properties
|
|
55705
|
+
*
|
|
55706
|
+
* Component attributes and properties that can be applied to the element or by using JavaScript.
|
|
55707
|
+
*
|
|
55708
|
+
* - `label`: The group's name, drawn above its actions and read by screen readers.
|
|
55709
|
+
* - `whenSettled`: Resolves a frame after the first update, when transitions are switched on.
|
|
55710
|
+
*
|
|
55711
|
+
* **Named `whenSettled` because `settled` is taken four times over**, by
|
|
55712
|
+
* Image, Splitter and both color controls, none of them about transitions. A
|
|
55713
|
+
* base class takes the name every subclass then cannot use.
|
|
55714
|
+
*
|
|
55715
|
+
* **The state it reports cannot be watched, which is why this exists.** A
|
|
55716
|
+
* custom state is deliberately not in the DOM, so there is no
|
|
55717
|
+
* `MutationObserver` equivalent for `ElementInternals.states`. Await this
|
|
55718
|
+
* instead.
|
|
55719
|
+
*
|
|
55720
|
+
* Separate from `updateComplete`, which resolves in the microtask checkpoint
|
|
55721
|
+
* the suppression is still active in. That is the distinction `readyToMove`
|
|
55722
|
+
* in `@fusion.dev/helix-testing` is written around.
|
|
55723
|
+
*
|
|
55724
|
+
* It never resolves where `requestAnimationFrame` never fires, which is a
|
|
55725
|
+
* server, a hidden tab, and happy-dom. Callers that must not hang there race
|
|
55726
|
+
* it against a timeout, as the happy-dom harness's `readyToMove` does. The
|
|
55727
|
+
* browser harness's awaits it alone: a browser always runs the frame, and a
|
|
55728
|
+
* timer beside it was a bet on how long one takes, which a busy run lost. (property only) (readonly)
|
|
55729
|
+
*
|
|
55730
|
+
* ## Slots
|
|
55731
|
+
*
|
|
55732
|
+
* Areas where markup can be added to the component.
|
|
55733
|
+
*
|
|
55734
|
+
* - `(default)`: The group's actions.
|
|
55735
|
+
* - `label`: The group's name, for content richer than the `label` text.
|
|
55736
|
+
*
|
|
55737
|
+
* ## CSS Custom Properties
|
|
55738
|
+
*
|
|
55739
|
+
* CSS variables available for styling the component.
|
|
55740
|
+
*
|
|
55741
|
+
* - `--speed-dial-group-label-color`: Color of the group's name.
|
|
55742
|
+
* - `--speed-dial-group-label-font-size`: Size of the group's name.
|
|
55743
|
+
*
|
|
55744
|
+
* ## CSS Parts
|
|
55745
|
+
*
|
|
55746
|
+
* Custom selectors for styling elements within the component.
|
|
55747
|
+
*
|
|
55748
|
+
* - `group`: The set, which carries the `group` role.
|
|
55749
|
+
* - `label`: The group's name, drawn above its actions while there is one.
|
|
55750
|
+
*
|
|
55751
|
+
* ## CSS States
|
|
55752
|
+
*
|
|
55753
|
+
* These can be used to apply styling when a component is in a given state.
|
|
55754
|
+
*
|
|
55755
|
+
* - `settled`: Set one frame after the first render. Transitions wait for it, so an element does not animate its own arrival.
|
|
55756
|
+
*/
|
|
55757
|
+
"helix-speed-dial-group": Partial<
|
|
55758
|
+
HelixSpeedDialGroupProps & BaseProps<HelixSpeedDialGroup> & BaseEvents<HelixSpeedDialGroup>
|
|
55759
|
+
>;
|
|
55760
|
+
|
|
54823
55761
|
/**
|
|
54824
55762
|
* Presentation only: a round mark the size of a small control, with the name on
|
|
54825
55763
|
* a chip beside it so it stays readable over whatever the dial floats over. The
|
|
@@ -54830,6 +55768,9 @@ export type CustomElements = {
|
|
|
54830
55768
|
* Component attributes and properties that can be applied to the element or by using JavaScript.
|
|
54831
55769
|
*
|
|
54832
55770
|
* - `disabled`: Whether the action is disabled, so it cannot be chosen.
|
|
55771
|
+
* - `shortcut`: The action's keyboard shortcut as a chord, such as `mod+s`, carried as
|
|
55772
|
+
* `aria-keyshortcuts` and drawn after the name. `mod` is Command on an Apple
|
|
55773
|
+
* keyboard and Control elsewhere. Showing a shortcut does not bind it.
|
|
54833
55774
|
* - `value`: The action's value, sent in `helix-select` when the action is chosen.
|
|
54834
55775
|
* - `active`: Whether the action has focus, which makes it the action the keyboard is on.
|
|
54835
55776
|
*
|
|
@@ -54870,6 +55811,7 @@ export type CustomElements = {
|
|
|
54870
55811
|
*
|
|
54871
55812
|
* - `(default)`: The action's name.
|
|
54872
55813
|
* - `icon`: The action's icon, the main way the action is recognized.
|
|
55814
|
+
* - `shortcut`: The action's keyboard shortcut, drawn after its name, such as a `Kbd`. It replaces the text drawn for `shortcut`, and is hidden from the name, which `aria-keyshortcuts` carries instead.
|
|
54873
55815
|
*
|
|
54874
55816
|
* ## Methods
|
|
54875
55817
|
*
|
|
@@ -54892,6 +55834,7 @@ export type CustomElements = {
|
|
|
54892
55834
|
* - `--speed-dial-label-background-color`: Fill of the chip holding the action's name.
|
|
54893
55835
|
* - `--speed-dial-label-color`: Color of the action's name.
|
|
54894
55836
|
* - `--speed-dial-label-font-size`: Size of the action's name.
|
|
55837
|
+
* - `--speed-dial-shortcut-color`: Color of the shortcut drawn after the action's name.
|
|
54895
55838
|
*
|
|
54896
55839
|
* ## CSS Parts
|
|
54897
55840
|
*
|
|
@@ -54900,6 +55843,7 @@ export type CustomElements = {
|
|
|
54900
55843
|
* - `icon`: The box that holds the icon.
|
|
54901
55844
|
* - `item`: The control for the action.
|
|
54902
55845
|
* - `label`: The action's name, beside the icon.
|
|
55846
|
+
* - `shortcut`: The box after the name that holds the shortcut, shown while `shortcut` is set or something is in the `shortcut` slot.
|
|
54903
55847
|
*
|
|
54904
55848
|
* ## CSS States
|
|
54905
55849
|
*
|
|
@@ -54940,7 +55884,17 @@ export type CustomElements = {
|
|
|
54940
55884
|
* last reader did rather than what the author wrote. `:state(open)` carries
|
|
54941
55885
|
* the resolved state for stylesheets, which is what the mirror is for.
|
|
54942
55886
|
* - `label`: Accessible name for the trigger and the set of actions it opens.
|
|
55887
|
+
* - `long-press-label`/`longPressLabel`: The description the trigger gives under `open-on="long-press"`, saying how
|
|
55888
|
+
* its actions are reached.
|
|
55889
|
+
*
|
|
55890
|
+
* A slotted trigger is described by the dial, which carries the words as
|
|
55891
|
+
* its own label for that: a Helix button's inner control at once, and a
|
|
55892
|
+
* plain element of yours once a reader reaches it, after hydration, unless
|
|
55893
|
+
* you described or labeled it yourself.
|
|
54943
55894
|
* - `offset`: Space between the trigger and the actions, in pixels.
|
|
55895
|
+
* - `open-on`/`openOn`: What opens the dial. `click` opens it on a press of the trigger. Under
|
|
55896
|
+
* `long-press`, a press is the trigger's own action, and the dial opens on a
|
|
55897
|
+
* press held for half a second, or on Alt+Down or Alt+Up.
|
|
54944
55898
|
* - `placement`: The direction the actions open in. They move to another side if that side
|
|
54945
55899
|
* does not fit.
|
|
54946
55900
|
*
|
|
@@ -55186,13 +56140,14 @@ export type CustomElements = {
|
|
|
55186
56140
|
* - `helix-before-resize`: Fired before the divider settles, and only when the gesture moved it. A press that moved nothing, a drag that came back, an arrow key with no room left, and a corner that moved only the other divider do not fire it. Cancelable: canceling it leaves the position to you and keeps the rest of the gesture, so a collapse the gesture reached still fires `helix-before-collapse`, which you can also cancel. A dragged divider stays where it was dropped until you set your own `position`.
|
|
55187
56141
|
* - `helix-collapse`: Fired after a pane shuts or reopens, with the side that is shut, or empty where both are open.
|
|
55188
56142
|
* - `helix-resized`: Fired after the divider settles somewhere new, with the new position.
|
|
55189
|
-
* - `input`: Fired each time
|
|
56143
|
+
* - `input`: Fired each time the divider moves, as a range input does: on each step of a drag, and before `helix-resized` for a key, a double click or a corner. Read `position` for where it is now.
|
|
55190
56144
|
*
|
|
55191
56145
|
* ## Slots
|
|
55192
56146
|
*
|
|
55193
56147
|
* Areas where markup can be added to the component.
|
|
55194
56148
|
*
|
|
55195
56149
|
* - `end`: The pane after the divider.
|
|
56150
|
+
* - `handle`: A mark drawn at the middle of the divider, such as a grip icon. It takes no focus and no pointer of its own: a press on it is a press on the divider.
|
|
55196
56151
|
* - `start`: The pane before the divider.
|
|
55197
56152
|
*
|
|
55198
56153
|
* ## Methods
|
|
@@ -55217,8 +56172,12 @@ export type CustomElements = {
|
|
|
55217
56172
|
* - `--splitter-drag-color`: Color of the line while it is being moved.
|
|
55218
56173
|
* - `--splitter-grip-color`: Color of the grip beside the line, when the grip is shown.
|
|
55219
56174
|
* - `--splitter-grip-length`: How far the grip runs along the divider.
|
|
56175
|
+
* - `--splitter-grip-thickness`: How thick the grip is, across the divider.
|
|
56176
|
+
* - `--splitter-handle-color`: Color of a mark slotted into `handle`.
|
|
55220
56177
|
* - `--splitter-hover-color`: Color of the divider's target under the pointer.
|
|
56178
|
+
* - `--splitter-hover-thickness`: How thick the line is under the pointer, with focus and while it moves.
|
|
55221
56179
|
* - `--splitter-target`: Width of the area you can drag.
|
|
56180
|
+
* - `--splitter-thickness`: How thick the line is at rest.
|
|
55222
56181
|
* - `--splitter-corner-at`: Where a nested splitter crosses this one, as a percentage.
|
|
55223
56182
|
* - `--splitter-position`: Where the divider sits, as a percentage of the box.
|
|
55224
56183
|
*
|
|
@@ -55235,7 +56194,9 @@ export type CustomElements = {
|
|
|
55235
56194
|
*
|
|
55236
56195
|
* These can be used to apply styling when a component is in a given state.
|
|
55237
56196
|
*
|
|
56197
|
+
* - `collapsed`: While a pane is shut. `data-collapsed` on the host says which.
|
|
55238
56198
|
* - `dragging`: While the pointer or a corner holds the divider.
|
|
56199
|
+
* - `vertical`: While the panes are one above the other, whether `orientation` says so or `auto` turned them.
|
|
55239
56200
|
* - `settled`: Set one frame after the first render. Transitions wait for it, so an element does not animate its own arrival.
|
|
55240
56201
|
*/
|
|
55241
56202
|
"helix-splitter": Partial<
|
|
@@ -56162,6 +57123,13 @@ export type CustomElements = {
|
|
|
56162
57123
|
* is set.
|
|
56163
57124
|
* - `default-sort`/`defaultSort`: The starting sort order, used until `sort` is set.
|
|
56164
57125
|
* - `descending-label`/`descendingLabel`: The word for a descending sort, in `sorted-label`.
|
|
57126
|
+
* - `grid`: Makes the table a grid: one tab stop, and the arrow keys, Home, End and the
|
|
57127
|
+
* Page keys move focus between its cells, the headings included. Enter moves
|
|
57128
|
+
* into a cell's controls, and Tab leaves the table.
|
|
57129
|
+
*
|
|
57130
|
+
* Off by default, where the table is a static `table` and Tab reaches each
|
|
57131
|
+
* link and control in it. On, the table writes a `tabindex` onto each of its
|
|
57132
|
+
* cells, which is the one way a cell of your markup can take focus.
|
|
56165
57133
|
* - `label`: Accessible name for the table.
|
|
56166
57134
|
*
|
|
56167
57135
|
* An `aria-label` or `aria-labelledby` on the host names the table too, and
|
|
@@ -56262,6 +57230,8 @@ export type CustomElements = {
|
|
|
56262
57230
|
* - `checkbox-mark-dash`: Added to `checkbox-mark` while it draws the dash, which it keeps until its box is checked.
|
|
56263
57231
|
* - `checkbox-mark-indeterminate`: Added to `checkbox-mark` while only some rows are selected.
|
|
56264
57232
|
* - `empty`: The text shown when there are no rows.
|
|
57233
|
+
* - `grid-end`: An empty box after the rows, in a `grid` table. Tab focuses it on its way out of the table, so the key leaves from the end.
|
|
57234
|
+
* - `grid-start`: An empty box before the rows, in a `grid` table. Shift with Tab focuses it on its way out of the table.
|
|
56265
57235
|
* - `head`: The row that holds the column headings. It has `display: contents`, so it takes no space of its own.
|
|
56266
57236
|
* - `loading`: The text shown while the rows are loading.
|
|
56267
57237
|
* - `select-all`: The heading that holds the checkbox that selects every row.
|
|
@@ -57973,12 +58943,18 @@ export type CustomElements = {
|
|
|
57973
58943
|
*
|
|
57974
58944
|
* CSS variables available for styling the component.
|
|
57975
58945
|
*
|
|
58946
|
+
* - `--time-picker-columns-gap`: The space between the wheels. None by default.
|
|
57976
58947
|
* - `--time-picker-feedback-color`: The color of the message under the times, while `feedback` is set.
|
|
58948
|
+
* - `--time-picker-hover-background-color`: Fill on a wheel's row under the pointer or the keyboard.
|
|
58949
|
+
* - `--time-picker-invalid-color`: The ring around the chosen time, or around the times while nothing is chosen, while the picker is invalid.
|
|
57977
58950
|
* - `--time-picker-list-block-size`: How tall the list is before it scrolls.
|
|
58951
|
+
* - `--time-picker-mark-radius`: The corners of the mark on a wheel's row.
|
|
57978
58952
|
* - `--time-picker-range-color`: Fill behind the times inside a range.
|
|
57979
58953
|
* - `--time-picker-row-size`: Height and minimum width of one row in a wheel.
|
|
57980
58954
|
* - `--time-picker-selected-color`: Fill on the chosen row of a wheel.
|
|
58955
|
+
* - `--time-picker-selected-foreground-color`: Ink on the chosen row of a wheel.
|
|
57981
58956
|
* - `--time-picker-wheel-block-size`: How tall a wheel is. Five rows by default.
|
|
58957
|
+
* - `--time-picker-wheel-mask`: The mask that fades a wheel toward its ends, as a `mask-image`. Set `none` for no fade.
|
|
57982
58958
|
*
|
|
57983
58959
|
* ## CSS Parts
|
|
57984
58960
|
*
|
|
@@ -58025,6 +59001,7 @@ export type CustomElements = {
|
|
|
58025
59001
|
*
|
|
58026
59002
|
* These can be used to apply styling when a component is in a given state.
|
|
58027
59003
|
*
|
|
59004
|
+
* - `blank`: While no time is chosen.
|
|
58028
59005
|
* - `invalid`: While `invalid` is set or `feedback` says what is wrong.
|
|
58029
59006
|
* - `settled`: Set one frame after the first render. Transitions wait for it, so an element does not animate its own arrival.
|
|
58030
59007
|
*/
|
|
@@ -58325,10 +59302,19 @@ export type CustomElements = {
|
|
|
58325
59302
|
*
|
|
58326
59303
|
* CSS variables available for styling the component.
|
|
58327
59304
|
*
|
|
59305
|
+
* - `--toast-background-color`: The panel's color. Follows `--helix-color-surface-overlay`.
|
|
58328
59306
|
* - `--toast-border-color`: Color of the panel's edge.
|
|
58329
59307
|
* - `--toast-border-width`: Width of the panel's edge. Follows `--helix-border-floating`, which is `0`, so the panel stands out by its shadow unless your theme sets a border.
|
|
59308
|
+
* - `--toast-color`: Color of the message's text.
|
|
59309
|
+
* - `--toast-description-color`: Color of the line in the `description` slot, under the heading.
|
|
59310
|
+
* - `--toast-dismiss-color`: Color of the dismiss control's mark at rest.
|
|
59311
|
+
* - `--toast-font-size`: Size of the message's text. The first line's controls and mark stay centered on it.
|
|
59312
|
+
* - `--toast-heading-weight`: Weight of the heading in the `heading` slot.
|
|
58330
59313
|
* - `--toast-item-padding`: Space between the message's edge and its contents.
|
|
59314
|
+
* - `--toast-radius`: Rounding of the panel's corners.
|
|
58331
59315
|
* - `--toast-shadow`: Shadow under the panel. Follows `--helix-shadow-floating`. A floating surface can sit over any content, so it has a shadow by default.
|
|
59316
|
+
* - `--toast-timer-size`: Thickness of the bar that counts down a timed message.
|
|
59317
|
+
* - `--toast-tone-color`: Color of the mark and the countdown bar. Unset, each `tone` takes its own color, so set it per tone, as in `helix-toast-item[tone="danger"]`.
|
|
58332
59318
|
* - `--toast-duration`: How long this message stays, in milliseconds, for a progress hint.
|
|
58333
59319
|
* - `--toast-swipe-x`: How far a swipe has moved the message across, in pixels, toward the right.
|
|
58334
59320
|
*
|
|
@@ -58855,10 +59841,16 @@ export type CustomElements = {
|
|
|
58855
59841
|
* The toolbar draws no frame of its own, so it does not add a second frame
|
|
58856
59842
|
* inside whatever already frames the bar.
|
|
58857
59843
|
*
|
|
59844
|
+
* Its controls are the small size, since a toolbar is dense by nature, and a
|
|
59845
|
+
* control added later takes it without being told. `size="md"` or `"lg"`
|
|
59846
|
+
* makes every control in it larger together.
|
|
59847
|
+
*
|
|
58858
59848
|
* ## Attributes & Properties
|
|
58859
59849
|
*
|
|
58860
59850
|
* Component attributes and properties that can be applied to the element or by using JavaScript.
|
|
58861
59851
|
*
|
|
59852
|
+
* - `size`: The size of every control in the toolbar: their height, icons, boxes and
|
|
59853
|
+
* tags. Unset is the small size, as a toolbar is dense by nature.
|
|
58862
59854
|
* - `label`: The toolbar's name, read by screen readers.
|
|
58863
59855
|
*
|
|
58864
59856
|
* An `aria-label` or `aria-labelledby` on the host names the toolbar too,
|
|
@@ -58916,6 +59908,9 @@ export type CustomElements = {
|
|
|
58916
59908
|
*
|
|
58917
59909
|
* These can be used to apply styling when a component is in a given state.
|
|
58918
59910
|
*
|
|
59911
|
+
* - `horizontal`: The controls run along a row, which is the default.
|
|
59912
|
+
* - `nested`: The toolbar is a group inside another toolbar, which owns the keys and the tab stop.
|
|
59913
|
+
* - `vertical`: The controls run down a column, under `orientation="vertical"`.
|
|
58919
59914
|
* - `settled`: Set one frame after the first render. Transitions wait for it, so an element does not animate its own arrival.
|
|
58920
59915
|
*/
|
|
58921
59916
|
"helix-toolbar": Partial<
|
|
@@ -60649,6 +61644,14 @@ export type CustomElements = {
|
|
|
60649
61644
|
*
|
|
60650
61645
|
* These can be used to apply styling when a component is in a given state.
|
|
60651
61646
|
*
|
|
61647
|
+
* - `ended`: Playback reached the end, until it starts again or the source changes.
|
|
61648
|
+
* - `error`: The source could not be played, and `failure` shows.
|
|
61649
|
+
* - `fullscreen`: The player fills the screen.
|
|
61650
|
+
* - `idle`: The video plays and the user has been still for `idle-delay`, so the bar hides.
|
|
61651
|
+
* - `muted`: The sound is off.
|
|
61652
|
+
* - `paused`: Playback is paused, which is where every player starts.
|
|
61653
|
+
* - `playing`: Playback runs, waiting for data included.
|
|
61654
|
+
* - `waiting`: Playback stopped to wait for more data, and `loading` shows.
|
|
60652
61655
|
* - `settled`: Set one frame after the first render. Transitions wait for it, so an element does not animate its own arrival.
|
|
60653
61656
|
*/
|
|
60654
61657
|
"helix-video": Partial<HelixVideoProps & BaseProps<HelixVideo> & BaseEvents<HelixVideo>>;
|
|
@@ -61090,6 +62093,19 @@ export type CustomElementsSolidJs = {
|
|
|
61090
62093
|
*
|
|
61091
62094
|
* Read once when the announcement is first rendered, as `Toast` reads its
|
|
61092
62095
|
* own. The clock stops while the pointer or focus is on the announcement.
|
|
62096
|
+
* - `hotkey`: The key that moves focus to the announcement's first control, and back
|
|
62097
|
+
* to where it was, written as keys joined by `+`, such as `F6` or `Alt+A`.
|
|
62098
|
+
*
|
|
62099
|
+
* F6 by default, the key React Aria's regions answer to. Empty turns it
|
|
62100
|
+
* off. With several announcements, the first one in the page takes focus.
|
|
62101
|
+
* - `label`: The name of the announcement's region, which screen readers list among
|
|
62102
|
+
* the page's landmarks. Translate it with the rest of your interface.
|
|
62103
|
+
*
|
|
62104
|
+
* Empty leaves the announcement no region.
|
|
62105
|
+
* - `queued`: Whether the announcement waits its turn behind the queued announcements
|
|
62106
|
+
* before it in the same parent, showing when the last of them is removed.
|
|
62107
|
+
*
|
|
62108
|
+
* Off by default, so every announcement on a page shows at once.
|
|
61093
62109
|
* - `tone`: The band's color.
|
|
61094
62110
|
*
|
|
61095
62111
|
* Paint only: unlike `Callout`, no value here draws a mark, changes the label,
|
|
@@ -61179,6 +62195,7 @@ export type CustomElementsSolidJs = {
|
|
|
61179
62195
|
* These can be used to apply styling when a component is in a given state.
|
|
61180
62196
|
*
|
|
61181
62197
|
* - `paused`: The clock `duration` started is stopped, while the pointer or focus is on the announcement or the page is hidden.
|
|
62198
|
+
* - `waiting`: The announcement is `queued` behind another, and renders nothing until that one is removed.
|
|
61182
62199
|
* - `settled`: Set one frame after the first render. Transitions wait for it, so an element does not animate its own arrival.
|
|
61183
62200
|
*/
|
|
61184
62201
|
"helix-announcement": Partial<
|
|
@@ -61516,6 +62533,9 @@ export type CustomElementsSolidJs = {
|
|
|
61516
62533
|
*
|
|
61517
62534
|
* A column's heading is the cell's name in every row, so the first row
|
|
61518
62535
|
* answers for the column.
|
|
62536
|
+
* - `columnName(cell: number) => string`: The heading of the column at this place in a row: a cell's name is its
|
|
62537
|
+
* column's heading, read from the first row that has a cell there, so a
|
|
62538
|
+
* short first row does not lose the heading. `''` where no row has one.
|
|
61519
62539
|
*
|
|
61520
62540
|
* ## CSS Custom Properties
|
|
61521
62541
|
*
|
|
@@ -62445,6 +63465,9 @@ export type CustomElementsSolidJs = {
|
|
|
62445
63465
|
*
|
|
62446
63466
|
* A column's heading is the cell's name in every row, so the first row
|
|
62447
63467
|
* answers for the column.
|
|
63468
|
+
* - `columnName(cell: number) => string`: The heading of the column at this place in a row: a cell's name is its
|
|
63469
|
+
* column's heading, read from the first row that has a cell there, so a
|
|
63470
|
+
* short first row does not lose the heading. `''` where no row has one.
|
|
62448
63471
|
*
|
|
62449
63472
|
* ## CSS Custom Properties
|
|
62450
63473
|
*
|
|
@@ -62517,14 +63540,24 @@ export type CustomElementsSolidJs = {
|
|
|
62517
63540
|
|
|
62518
63541
|
/**
|
|
62519
63542
|
* Set in the display face, larger than body text, to mark a change of voice. No
|
|
62520
|
-
* quotation marks are drawn, because the size and spacing already
|
|
62521
|
-
* passage apart.
|
|
63543
|
+
* quotation marks are drawn by default, because the size and spacing already
|
|
63544
|
+
* set the passage apart. `marks` draws one large opening mark over the passage,
|
|
63545
|
+
* as a pull quote sets it, in the element's language.
|
|
62522
63546
|
*
|
|
62523
63547
|
* ## Attributes & Properties
|
|
62524
63548
|
*
|
|
62525
63549
|
* Component attributes and properties that can be applied to the element or by using JavaScript.
|
|
62526
63550
|
*
|
|
62527
|
-
* - `
|
|
63551
|
+
* - `attribution`: Who said it, and where, as words, such as "Maria Lopez, operations
|
|
63552
|
+
* manager". The `attribution` slot replaces them, for markup such as a link.
|
|
63553
|
+
*
|
|
63554
|
+
* Words are served with the figure they name, where a server cannot see a
|
|
63555
|
+
* slotted attribution.
|
|
63556
|
+
* - `cite`: The URL of the source the passage came from. Who said it goes in
|
|
63557
|
+
* `attribution`: a `cite` with words in it warns once, with the runtime kind
|
|
63558
|
+
* `cite-not-url`.
|
|
63559
|
+
* - `marks`: Whether to draw an opening quotation mark before the passage, in the
|
|
63560
|
+
* element's language. Leave the marks out of the text.
|
|
62528
63561
|
* - `whenSettled`: Resolves a frame after the first update, when transitions are switched on.
|
|
62529
63562
|
*
|
|
62530
63563
|
* **Named `whenSettled` because `settled` is taken four times over**, by
|
|
@@ -62551,28 +63584,33 @@ export type CustomElementsSolidJs = {
|
|
|
62551
63584
|
* Areas where markup can be added to the component.
|
|
62552
63585
|
*
|
|
62553
63586
|
* - `(default)`: The quoted passage.
|
|
62554
|
-
* - `attribution`: Who said it, and where.
|
|
63587
|
+
* - `attribution`: Who said it, and where. Replaces the words of `attribution`.
|
|
62555
63588
|
*
|
|
62556
63589
|
* ## CSS Custom Properties
|
|
62557
63590
|
*
|
|
62558
63591
|
* CSS variables available for styling the component.
|
|
62559
63592
|
*
|
|
62560
63593
|
* - `--blockquote-attribution-color`: The color of the attribution.
|
|
63594
|
+
* - `--blockquote-attribution-font-family`: The typeface of the attribution, the page's by default.
|
|
63595
|
+
* - `--blockquote-attribution-font-weight`: The weight of the attribution, the page's by default.
|
|
62561
63596
|
* - `--blockquote-attribution-size`: The font size of the attribution.
|
|
62562
63597
|
* - `--blockquote-color`: The color of the quoted passage.
|
|
62563
63598
|
* - `--blockquote-font-family`: The typeface of the quoted passage, the display face by default.
|
|
62564
63599
|
* - `--blockquote-font-weight`: The weight of the quoted passage, medium by default.
|
|
62565
63600
|
* - `--blockquote-gap`: The space between the passage and its attribution.
|
|
63601
|
+
* - `--blockquote-letter-spacing`: The letter spacing of the quoted passage, the tight tracking by default.
|
|
62566
63602
|
* - `--blockquote-line-height`: The line height of the quoted passage, the tight leading by default.
|
|
63603
|
+
* - `--blockquote-mark-color`: The color of the mark `marks` draws, the subtle foreground by default.
|
|
63604
|
+
* - `--blockquote-mark-size`: The font size of the mark `marks` draws.
|
|
62567
63605
|
* - `--blockquote-size`: The font size of the quoted passage.
|
|
62568
63606
|
*
|
|
62569
63607
|
* ## CSS Parts
|
|
62570
63608
|
*
|
|
62571
63609
|
* Custom selectors for styling elements within the component.
|
|
62572
63610
|
*
|
|
62573
|
-
* - `attribution`: The
|
|
63611
|
+
* - `attribution`: The caption carrying the source.
|
|
62574
63612
|
* - `blockquote`: The quotation.
|
|
62575
|
-
* - `figure`: The
|
|
63613
|
+
* - `figure`: The figure holding the quotation and its attribution, a `<div>` with `role="figure"` while the attribution has words.
|
|
62576
63614
|
*
|
|
62577
63615
|
* ## CSS States
|
|
62578
63616
|
*
|
|
@@ -62784,18 +63822,28 @@ export type CustomElementsSolidJs = {
|
|
|
62784
63822
|
* Joins the buttons into one shape: the outer corners keep their radius, the
|
|
62785
63823
|
* inner corners lose it, and adjacent borders collapse into one line.
|
|
62786
63824
|
*
|
|
62787
|
-
*
|
|
62788
|
-
*
|
|
62789
|
-
*
|
|
62790
|
-
*
|
|
63825
|
+
* A Helix button's corners are on the control inside its shadow root, where
|
|
63826
|
+
* this component's styles cannot reach, so the group flattens them through the
|
|
63827
|
+
* button's own `--button-radius-*` hooks. A native `<button>` and your own
|
|
63828
|
+
* anchor styled with `data-button` join through rules in the base layer,
|
|
63829
|
+
* because a page rule setting their radius would beat any rule in here.
|
|
63830
|
+
*
|
|
63831
|
+
* The buttons take their height from the region, so `size` makes every
|
|
63832
|
+
* button in the group smaller or larger together, as `data-density` on the
|
|
63833
|
+
* group does, and a button's own size still wins. A native `<button>` in a
|
|
63834
|
+
* sized group takes the height and the text size.
|
|
62791
63835
|
*
|
|
62792
|
-
*
|
|
62793
|
-
* group
|
|
63836
|
+
* With `selection-mode`, a pressed button takes the solid fill:
|
|
63837
|
+
* `--button-group-pressed-background-color` behind it and
|
|
63838
|
+
* `--button-group-pressed-color` for its words, set on the group or above it.
|
|
62794
63839
|
*
|
|
62795
63840
|
* ## Attributes & Properties
|
|
62796
63841
|
*
|
|
62797
63842
|
* Component attributes and properties that can be applied to the element or by using JavaScript.
|
|
62798
63843
|
*
|
|
63844
|
+
* - `size`: The size of every button in the group: their height, text, padding and
|
|
63845
|
+
* icons, from the density steps. Unset, the buttons take the size of the
|
|
63846
|
+
* region around the group.
|
|
62799
63847
|
* - `variant`: Whether the buttons are one bar or a spaced row.
|
|
62800
63848
|
*
|
|
62801
63849
|
* Joined by default: one control made of parts, sharing borders, reading as a
|
|
@@ -62826,6 +63874,16 @@ export type CustomElementsSolidJs = {
|
|
|
62826
63874
|
* buttons sharing edges as one shape, and a wrapped row carries the corners of
|
|
62827
63875
|
* a first row into a second. Stacked, the same three keep one shape and one
|
|
62828
63876
|
* column.
|
|
63877
|
+
* - `selection-mode`/`selectionMode`: Whether the buttons stay pressed: `single` keeps one pressed at a time and
|
|
63878
|
+
* `multiple` any number. Unset, they are action buttons, each its own tab
|
|
63879
|
+
* stop, as before.
|
|
63880
|
+
*
|
|
63881
|
+
* Optional, so the attribute is absent until a consumer writes it.
|
|
63882
|
+
* - `value`: The values of the pressed buttons, comma separated, in a selection mode.
|
|
63883
|
+
* A button's own `value` names it, so a value holds no comma.
|
|
63884
|
+
*
|
|
63885
|
+
* The attribute is the seed, and a press changes the property, which does
|
|
63886
|
+
* not reflect, as a native control's `value` does not.
|
|
62829
63887
|
* - `whenSettled`: Resolves a frame after the first update, when transitions are switched on.
|
|
62830
63888
|
*
|
|
62831
63889
|
* **Named `whenSettled` because `settled` is taken four times over**, by
|
|
@@ -62847,6 +63905,13 @@ export type CustomElementsSolidJs = {
|
|
|
62847
63905
|
* browser harness's awaits it alone: a browser always runs the frame, and a
|
|
62848
63906
|
* timer beside it was a bet on how long one takes, which a busy run lost. (property only) (readonly)
|
|
62849
63907
|
*
|
|
63908
|
+
* ## Events
|
|
63909
|
+
*
|
|
63910
|
+
* Events that will be emitted by the component.
|
|
63911
|
+
*
|
|
63912
|
+
* - `change`: Fired after a press changes `value`, in a selection mode.
|
|
63913
|
+
* - `helix-before-change`: Fired before a press changes `value`, with the value it would leave in `detail.value`. Cancelable: call `preventDefault()` to keep the buttons as they are.
|
|
63914
|
+
*
|
|
62850
63915
|
* ## Slots
|
|
62851
63916
|
*
|
|
62852
63917
|
* Areas where markup can be added to the component.
|
|
@@ -62858,6 +63923,10 @@ export type CustomElementsSolidJs = {
|
|
|
62858
63923
|
* CSS variables available for styling the component.
|
|
62859
63924
|
*
|
|
62860
63925
|
* - `--button-group-gap`: Space between the buttons, when `spaced`.
|
|
63926
|
+
* - `--button-group-pressed-background-color`: Fill behind a pressed button, in a selection mode. Defaults to the foreground color.
|
|
63927
|
+
* - `--button-group-pressed-border-color`: Edge of a pressed button, in a selection mode. Defaults to its fill.
|
|
63928
|
+
* - `--button-group-pressed-color`: Words and icons of a pressed button, in a selection mode. Defaults to the background color.
|
|
63929
|
+
* - `--button-group-pressed`: Written on the control inside each toggle button of a group with `selection-mode`: `1` while it is pressed and `0` while it is not. Read it in a `::part(button)` rule to draw the pressed look.
|
|
62861
63930
|
*
|
|
62862
63931
|
* ## CSS States
|
|
62863
63932
|
*
|
|
@@ -63420,6 +64489,9 @@ export type CustomElementsSolidJs = {
|
|
|
63420
64489
|
* Before the board places it, the card sits in normal flow. Without JavaScript,
|
|
63421
64490
|
* the page shows the cards' text in the order it was written.
|
|
63422
64491
|
*
|
|
64492
|
+
* On a touch screen, the points and corners of the card with focus take a
|
|
64493
|
+
* reach 44 pixels across, so a finger can start a connection from one.
|
|
64494
|
+
*
|
|
63423
64495
|
* ## Attributes & Properties
|
|
63424
64496
|
*
|
|
63425
64497
|
* Component attributes and properties that can be applied to the element or by using JavaScript.
|
|
@@ -63528,7 +64600,9 @@ export type CustomElementsSolidJs = {
|
|
|
63528
64600
|
* - `--canvas-move-inset`: The distance between the move handle and the card's corner.
|
|
63529
64601
|
* - `--canvas-node-background-color`: The card's background.
|
|
63530
64602
|
* - `--canvas-node-color`: A color for the card that carries no meaning, such as a hex color from a document. Use it when no tone fits.
|
|
64603
|
+
* - `--canvas-node-font-size`: The size of the card's text.
|
|
63531
64604
|
* - `--canvas-node-padding`: The space between the card's edge and its content.
|
|
64605
|
+
* - `--canvas-node-radius`: The card's corners. A `shape` draws its own.
|
|
63532
64606
|
* - `--canvas-node-shadow`: The shadow under the card, set by `separation="elevated"`.
|
|
63533
64607
|
*
|
|
63534
64608
|
* ## CSS Parts
|
|
@@ -63710,6 +64784,12 @@ export type CustomElementsSolidJs = {
|
|
|
63710
64784
|
*
|
|
63711
64785
|
* The list is joined the way the page's language joins one, "Second and
|
|
63712
64786
|
* Third", rather than with a comma this component chose.
|
|
64787
|
+
* - `moved-label`/`movedLabel`: What screen readers hear after a key moves a card, with `{name}` for the
|
|
64788
|
+
* card and `{x}` and `{y}` for where it now is, in the document's units.
|
|
64789
|
+
*
|
|
64790
|
+
* **A move a reader cannot see has to be said.** Shift with an arrow moved
|
|
64791
|
+
* the card and said nothing, so a reader moving one by keys could not tell
|
|
64792
|
+
* whether it had moved, or how far.
|
|
63713
64793
|
* - `order`: The order the arrow keys and screen readers move through the cards:
|
|
63714
64794
|
* `spatial` or `edges`.
|
|
63715
64795
|
*
|
|
@@ -63735,6 +64815,9 @@ export type CustomElementsSolidJs = {
|
|
|
63735
64815
|
* walk the cards.
|
|
63736
64816
|
* - `reconnecting-label`/`reconnectingLabel`: The text announced when a connection's end is picked up, with `{from}` and
|
|
63737
64817
|
* `{to}`.
|
|
64818
|
+
* - `resized-label`/`resizedLabel`: What screen readers hear after a key resizes a card, with `{name}` for the
|
|
64819
|
+
* card and `{width}` and `{height}` for its new size, in the document's
|
|
64820
|
+
* units.
|
|
63738
64821
|
* - `selected`: The names of the selected cards and connections, comma separated. Empty
|
|
63739
64822
|
* when nothing is selected.
|
|
63740
64823
|
*
|
|
@@ -63754,6 +64837,26 @@ export type CustomElementsSolidJs = {
|
|
|
63754
64837
|
* on its board across cards and connections both, and may not hold a comma.
|
|
63755
64838
|
*
|
|
63756
64839
|
* Written to select from outside, and read to act on the selection.
|
|
64840
|
+
* - `selected-label`/`selectedLabel`: What a selected card or connection adds to what screen readers hear on
|
|
64841
|
+
* it, before its tone and its connections. Empty adds nothing.
|
|
64842
|
+
*
|
|
64843
|
+
* A card is an article and a connection a button, and neither has a selected
|
|
64844
|
+
* state for `aria-selected` to carry, so the state is said in words.
|
|
64845
|
+
* - `selection-label`/`selectionLabel`: What screen readers hear after the selection grows or shrinks, with
|
|
64846
|
+
* `{count}` for how many cards and connections are selected: by Space, a
|
|
64847
|
+
* click with Shift, Command or Control, Command or Control with A, a box
|
|
64848
|
+
* drawn across the board, or Escape.
|
|
64849
|
+
*
|
|
64850
|
+
* A selection of one made by arriving on a card or clicking it is not said,
|
|
64851
|
+
* since the card is.
|
|
64852
|
+
* - `snap`: Snaps the cards a reader moves or resizes to a multiple of this many of the
|
|
64853
|
+
* document's units, such as `32` to land on the lines `grid` draws.
|
|
64854
|
+
*
|
|
64855
|
+
* **A drag lets go on the nearest line and a key goes to the next one.**
|
|
64856
|
+
* Shift with an arrow moves a card to the next line that way, rather than
|
|
64857
|
+
* by its step of 16, and Alt with an arrow moves its bottom right corner
|
|
64858
|
+
* the same way. A group moves with what it carries, so a card inside one
|
|
64859
|
+
* keeps its place in it. Absent, cards land where they are let go.
|
|
63757
64860
|
* - `stopped-label`/`stoppedLabel`: The text announced when a connection is stopped before it is requested.
|
|
63758
64861
|
* - `tone-labels`/`toneLabels`: What each tone means on this board, in words read out with the cards and
|
|
63759
64862
|
* connections in it, such as `{"danger": "Blocked", "success": "Done"}`.
|
|
@@ -63763,6 +64866,8 @@ export type CustomElementsSolidJs = {
|
|
|
63763
64866
|
* red is "blocked" on one board and "urgent" on the next. A reader who can
|
|
63764
64867
|
* see the board is told by the color; this is how a reader who cannot is
|
|
63765
64868
|
* told the same. A tone left out is not read.
|
|
64869
|
+
* - `zoomed-label`/`zoomedLabel`: What screen readers hear after a zoom button or key, with `{zoom}` for the
|
|
64870
|
+
* zoom as a percentage, written the way the page's language writes one.
|
|
63766
64871
|
* - `view`: The board's current view: the document's point at the middle of the view,
|
|
63767
64872
|
* and the zoom.
|
|
63768
64873
|
*
|
|
@@ -63819,7 +64924,14 @@ export type CustomElementsSolidJs = {
|
|
|
63819
64924
|
* - `(default)`: The board's `helix-canvas-node` and `helix-canvas-edge` elements, drawn on the plane.
|
|
63820
64925
|
* - `empty`: Content shown when the document has no nodes.
|
|
63821
64926
|
* - `footer`: Content below the board.
|
|
64927
|
+
* - `fullscreen-icon`: Replaces the glyph inside the fullscreen button.
|
|
63822
64928
|
* - `header`: Content above the board.
|
|
64929
|
+
* - `pan-down-icon`: Replaces the glyph inside the pan down button.
|
|
64930
|
+
* - `pan-end-icon`: Replaces the glyph inside the button that pans toward the end of a line of text.
|
|
64931
|
+
* - `pan-start-icon`: Replaces the glyph inside the button that pans toward the start of a line of text.
|
|
64932
|
+
* - `pan-up-icon`: Replaces the glyph inside the pan up button.
|
|
64933
|
+
* - `zoom-in-icon`: Replaces the glyph inside the zoom-in button.
|
|
64934
|
+
* - `zoom-out-icon`: Replaces the glyph inside the zoom-out button.
|
|
63823
64935
|
*
|
|
63824
64936
|
* ## Methods
|
|
63825
64937
|
*
|
|
@@ -63854,11 +64966,17 @@ export type CustomElementsSolidJs = {
|
|
|
63854
64966
|
* - `--canvas-background-color`: The background behind the board.
|
|
63855
64967
|
* - `--canvas-block-size`: The height of the frame.
|
|
63856
64968
|
* - `--canvas-border-color`: The color of the frame's edge.
|
|
64969
|
+
* - `--canvas-connect-color`: The color of a connection being drawn, and of the card it will arrive at and that card's points.
|
|
63857
64970
|
* - `--canvas-edge-color`: The color of a connection with no tone. Set it in one edge's `style` to color only that edge.
|
|
63858
64971
|
* - `--canvas-edge-target-width`: The width of the area a pointer can press on a connection, which is wider than the drawn line.
|
|
64972
|
+
* - `--canvas-edge-width`: The width of a connection's line. A selected or focused connection is drawn at twice it.
|
|
63859
64973
|
* - `--canvas-grid-size`: The spacing of the grid lines or dots, in the document's units, so it scales with the zoom.
|
|
63860
64974
|
* - `--canvas-handle-size`: The size of the ends of a selected connection. A card's connection points use the same property.
|
|
64975
|
+
* - `--canvas-label-color`: The color of the label on a connection.
|
|
63861
64976
|
* - `--canvas-label-editor-inline-size`: The width of the field for editing a label.
|
|
64977
|
+
* - `--canvas-label-font-size`: The size of the label on a connection.
|
|
64978
|
+
* - `--canvas-radius`: The frame's corners.
|
|
64979
|
+
* - `--canvas-selected-color`: The color of what is selected: a card's outline, its corners and its move handle, a connection and its ends, and the box drawn to select.
|
|
63862
64980
|
* - `--viewport-control-background-color`: The background of the pan and zoom buttons. `Map` uses the same property.
|
|
63863
64981
|
*
|
|
63864
64982
|
* ## CSS Parts
|
|
@@ -64039,8 +65157,12 @@ export type CustomElementsSolidJs = {
|
|
|
64039
65157
|
* - `--card-background-color`: Surface behind the card.
|
|
64040
65158
|
* - `--card-border-color`: Border color of the surface.
|
|
64041
65159
|
* - `--card-border-width`: Width of the surface's edge. Follows `--helix-border-surface`, which is a hairline unless your theme sets another width. The edge is what sets the surface apart.
|
|
65160
|
+
* - `--card-color`: Color of the card's text. Muted by default, so the header reads as the card's own voice.
|
|
64042
65161
|
* - `--card-gap`: Space between the regions, and between a header or footer and its actions.
|
|
65162
|
+
* - `--card-heading-color`: Color of the header, and of a `Text` heading anywhere in the card. The foreground by default.
|
|
65163
|
+
* - `--card-line-height`: Line height of the card's text. The normal leading by default.
|
|
64043
65164
|
* - `--card-media-block-size`: Height of the media region. Defaults to `auto`, which follows an image's own proportions. A chart has no height of its own, so set one here for a chart.
|
|
65165
|
+
* - `--card-media-fit`: How a slotted picture fills the media region, as `object-fit`. `cover` by default; `contain` shows all of a logo or a screenshot.
|
|
64044
65166
|
* - `--card-media-size`: Width of the media column when horizontal.
|
|
64045
65167
|
* - `--card-padding`: Inset applied to each region.
|
|
64046
65168
|
* - `--card-radius`: Corner radius of the surface.
|
|
@@ -65458,15 +66580,17 @@ export type CustomElementsSolidJs = {
|
|
|
65458
66580
|
* the button is drawn only while the cap hides something, measured as the
|
|
65459
66581
|
* block lays out. Not for a diff, whose files each scroll on their own.
|
|
65460
66582
|
* - `expand-label`/`expandLabel`: The expand button's words while the cap hides lines.
|
|
65461
|
-
* - `label`: The block's name, usually a file name
|
|
66583
|
+
* - `label`: The block's name, usually a file name, drawn in the header.
|
|
65462
66584
|
*
|
|
65463
|
-
*
|
|
65464
|
-
*
|
|
66585
|
+
* Absent, the block is named by `language` where there is one. In a diff,
|
|
66586
|
+
* each file is named from the patch, and this names a patch that carries no
|
|
66587
|
+
* name of its own.
|
|
65465
66588
|
* - `language`: The language the code is written in, such as `ts` or `css`, handed to
|
|
65466
66589
|
* `highlight` as its second argument.
|
|
65467
66590
|
*
|
|
65468
|
-
*
|
|
65469
|
-
*
|
|
66591
|
+
* A block with no `label` is named by it, in the header and on the copy
|
|
66592
|
+
* button, as a docs site names a snippet by its language. Absent hands
|
|
66593
|
+
* `highlight` an empty string and names nothing.
|
|
65470
66594
|
* - `line-numbers`/`lineNumbers`: Whether the lines are numbered in a gutter beside the code.
|
|
65471
66595
|
*
|
|
65472
66596
|
* The numbers are hidden from the accessibility tree and are not part of a
|
|
@@ -65549,14 +66673,21 @@ export type CustomElementsSolidJs = {
|
|
|
65549
66673
|
*
|
|
65550
66674
|
* CSS variables available for styling the component.
|
|
65551
66675
|
*
|
|
66676
|
+
* - `--code-block-added-color`: The color a diff's added lines are tinted in and their `+` is drawn in. The success color by default.
|
|
65552
66677
|
* - `--code-block-backdrop`: A backdrop filter for the block and its header, for a translucent background.
|
|
65553
66678
|
* - `--code-block-background-color`: The background behind the code. Set it for a block that sits on a surface other than the page background.
|
|
65554
66679
|
* - `--code-block-border-color`: The line around the block and its header.
|
|
66680
|
+
* - `--code-block-color`: The color of the code. A highlighter's own colors win on the tokens it colors.
|
|
65555
66681
|
* - `--code-block-expand-color`: The color of the button under a capped block that shows every line.
|
|
66682
|
+
* - `--code-block-font-family`: The typeface of the code and its line numbers. The mono face by default.
|
|
66683
|
+
* - `--code-block-font-size`: The size of the code and its line numbers.
|
|
65556
66684
|
* - `--code-block-gutter-color`: The color of the line numbers.
|
|
65557
66685
|
* - `--code-block-header-background-color`: The background behind the name. The default is `surface-raised`.
|
|
66686
|
+
* - `--code-block-label-color`: The color of the name in the header.
|
|
66687
|
+
* - `--code-block-line-height`: The line height of the code and its line numbers, as a number or a length.
|
|
65558
66688
|
* - `--code-block-max-block-size`: The tallest the code grows before it scrolls, or until `expandable`'s button shows every line. The default is no limit.
|
|
65559
66689
|
* - `--code-block-radius`: The corner radius of the header's top and the block's bottom, which form one shape.
|
|
66690
|
+
* - `--code-block-removed-color`: The color a diff's removed lines are tinted in and their `-` is drawn in. The danger color by default.
|
|
65560
66691
|
*
|
|
65561
66692
|
* ## CSS Parts
|
|
65562
66693
|
*
|
|
@@ -65589,7 +66720,7 @@ export type CustomElementsSolidJs = {
|
|
|
65589
66720
|
* - `gutter`: The line numbers beside the code, shown when `line-numbers` is set.
|
|
65590
66721
|
* - `header`: The bar that holds the name and the copy button, shown when there is a name.
|
|
65591
66722
|
* - `hunk`: In a diff, a `@@` line saying where the lines under it are.
|
|
65592
|
-
* - `label`: The
|
|
66723
|
+
* - `label`: The block's name: its `label`, or its `language` where it has no label.
|
|
65593
66724
|
* - `marker`: In a diff, the `+`, `-`, or space that starts a line.
|
|
65594
66725
|
* - `new`: In a split diff, the new version's `<pre>`.
|
|
65595
66726
|
* - `number`: In a diff, a line number.
|
|
@@ -66455,12 +67586,19 @@ export type CustomElementsSolidJs = {
|
|
|
66455
67586
|
* leaves the field or presses Enter with nothing highlighted, and text that
|
|
66456
67587
|
* names an option takes that option. Unlike `creatable`, no event asks
|
|
66457
67588
|
* first and no option is expected to be added: the value is the text.
|
|
66458
|
-
* - `autocomplete`: What the browser may autofill
|
|
67589
|
+
* - `autocomplete`: What the browser may autofill, as a platform token such as `country`.
|
|
66459
67590
|
*
|
|
66460
67591
|
* **Defaults to `off`, which is not the platform's default and is the
|
|
66461
67592
|
* point.** The field filters a list rather than collecting a value, so a
|
|
66462
67593
|
* browser offering to fill it with a saved address is competing for the same
|
|
66463
67594
|
* keystrokes as the listbox. A consumer who wants autofill can still ask.
|
|
67595
|
+
*
|
|
67596
|
+
* Set, a combobox whose answer is one of its options keeps a hidden native
|
|
67597
|
+
* `<select>` with the same options for the browser to fill, as React Aria's
|
|
67598
|
+
* combobox and Select do, and the option the browser picks, by its value or
|
|
67599
|
+
* its words, becomes the value. The text field itself stays `off`, so the
|
|
67600
|
+
* browser fills the answer and not the filter. With `allows-custom-value`
|
|
67601
|
+
* the token goes on the text field, whose words are the answer.
|
|
66464
67602
|
* - `creatable`: Whether the user can add a value that is not in the list.
|
|
66465
67603
|
*
|
|
66466
67604
|
* The row appears while what is typed matches no option's words exactly, so
|
|
@@ -66479,8 +67617,9 @@ export type CustomElementsSolidJs = {
|
|
|
66479
67617
|
* every keystroke. See Listbox's `filter-delay`.
|
|
66480
67618
|
* - `list-label`/`listLabel`: The list's name, read by screen readers. The list has no visible name.
|
|
66481
67619
|
* - `load-error`/`loadError`: What the list says when its options could not be loaded, such as after a
|
|
66482
|
-
* request to a server fails. Empty
|
|
66483
|
-
*
|
|
67620
|
+
* request to a server fails. Empty, null or no attribute is no error, so
|
|
67621
|
+
* removing the attribute clears it. Passed to the list, which shows it
|
|
67622
|
+
* under any options there are and tells screen readers.
|
|
66484
67623
|
* - `loading`: Whether the options are still loading.
|
|
66485
67624
|
*
|
|
66486
67625
|
* Passed straight to the list, which is where the rows are and so where the
|
|
@@ -66524,6 +67663,8 @@ export type CustomElementsSolidJs = {
|
|
|
66524
67663
|
* - `results-label`/`resultsLabel`: What a screen reader hears when typing leaves any other number of
|
|
66525
67664
|
* options. `{count}` is the count, and `Intl.PluralRules` picks between the
|
|
66526
67665
|
* two.
|
|
67666
|
+
* - `selected-label`/`selectedLabel`: What VoiceOver hears for a chosen option, as the highlight reaches it and
|
|
67667
|
+
* once it is chosen, on Apple devices. `{name}` is the option's words.
|
|
66527
67668
|
* - `suggest`: Whether the field completes the word as the user types.
|
|
66528
67669
|
*
|
|
66529
67670
|
* `suggest` rather than `autocomplete`, which is a real HTML attribute this
|
|
@@ -66726,6 +67867,7 @@ export type CustomElementsSolidJs = {
|
|
|
66726
67867
|
* - `listbox-loading`: Shown while the options are loading.
|
|
66727
67868
|
* - `listbox-search`: The region holding the field that narrows the list.
|
|
66728
67869
|
* - `listbox-search-field`: The filter field inside that region.
|
|
67870
|
+
* - `live`: The region VoiceOver hears the highlight, the count and a choice from on Apple devices, drawn once there is one to say. Visually hidden in the styled tier.
|
|
66729
67871
|
* - `rest`: The count of choices held beyond `max-tags`. A `<button>` with `expandable`, a `<span>` without it.
|
|
66730
67872
|
* - `surface`: The floating panel.
|
|
66731
67873
|
* - `tag`: One chosen option.
|
|
@@ -66741,8 +67883,10 @@ export type CustomElementsSolidJs = {
|
|
|
66741
67883
|
*
|
|
66742
67884
|
* These can be used to apply styling when a component is in a given state.
|
|
66743
67885
|
*
|
|
67886
|
+
* - `blank`: While nothing is chosen.
|
|
66744
67887
|
* - `error`: While `load-error` is set.
|
|
66745
67888
|
* - `invalid`: The control has an error to show, from the browser's validation or from your `feedback`.
|
|
67889
|
+
* - `loading`: While `loading` is set.
|
|
66746
67890
|
* - `no-results`: What was typed hid every option of a list that has some.
|
|
66747
67891
|
* - `open`: While the list is open.
|
|
66748
67892
|
* - `settled`: Set one frame after the first render. Transitions wait for it, so an element does not animate its own arrival.
|
|
@@ -66790,8 +67934,9 @@ export type CustomElementsSolidJs = {
|
|
|
66790
67934
|
* with: one key, said once.
|
|
66791
67935
|
* - `label`: Accessible name for the overlay, which has no visible heading.
|
|
66792
67936
|
* - `load-error`/`loadError`: What the list says when its commands could not be loaded, such as after a
|
|
66793
|
-
* request to a server fails. Empty
|
|
66794
|
-
*
|
|
67937
|
+
* request to a server fails. Empty, null or no attribute is no error, so
|
|
67938
|
+
* removing the attribute clears it. Passed to the list, which shows it
|
|
67939
|
+
* under any commands there are and tells screen readers.
|
|
66795
67940
|
* - `loading`: Whether the commands are still loading, for a palette that asks a server
|
|
66796
67941
|
* for them as the user types.
|
|
66797
67942
|
*
|
|
@@ -68323,6 +69468,7 @@ export type CustomElementsSolidJs = {
|
|
|
68323
69468
|
* CSS variables available for styling the component.
|
|
68324
69469
|
*
|
|
68325
69470
|
* - `--description-list-actions-gap`: The space between the value and the controls in `actions`.
|
|
69471
|
+
* - `--description-list-item-align`: How a label and its value line up beside each other, as `align-items`. Defaults to `baseline`; `center` suits a value taller than a line, such as an avatar.
|
|
68326
69472
|
* - `--description-list-item-gap`: The space between a label and its value when the label sits over it.
|
|
68327
69473
|
* - `--description-list-label-color`: The color of a label.
|
|
68328
69474
|
* - `--description-list-label-font-size`: The size of a label's text.
|
|
@@ -68333,6 +69479,7 @@ export type CustomElementsSolidJs = {
|
|
|
68333
69479
|
*
|
|
68334
69480
|
* Custom selectors for styling elements within the component.
|
|
68335
69481
|
*
|
|
69482
|
+
* - `actions`: The box after the value inside its `<dd>`, holding the `actions` slot.
|
|
68336
69483
|
* - `label`: The `<dt>`, holding the label.
|
|
68337
69484
|
* - `value`: The `<dd>`, holding the value.
|
|
68338
69485
|
*
|
|
@@ -68340,6 +69487,7 @@ export type CustomElementsSolidJs = {
|
|
|
68340
69487
|
*
|
|
68341
69488
|
* These can be used to apply styling when a component is in a given state.
|
|
68342
69489
|
*
|
|
69490
|
+
* - `several`: The values are several `<dd>` elements of your own, so the item draws no `value` part.
|
|
68343
69491
|
* - `settled`: Set one frame after the first render. Transitions wait for it, so an element does not animate its own arrival.
|
|
68344
69492
|
*/
|
|
68345
69493
|
"helix-description-list-item": Partial<
|
|
@@ -68364,10 +69512,16 @@ export type CustomElementsSolidJs = {
|
|
|
68364
69512
|
* wide as its widest pair, labels sit on the start edge, and values sit on the
|
|
68365
69513
|
* end edge in tabular figures, as in a set of totals.
|
|
68366
69514
|
*
|
|
69515
|
+
* **For a rule between pairs, set `divided`.** The rule sits in the middle of
|
|
69516
|
+
* the gap, so the pairs keep the same room on either side of it.
|
|
69517
|
+
*
|
|
68367
69518
|
* ## Attributes & Properties
|
|
68368
69519
|
*
|
|
68369
69520
|
* Component attributes and properties that can be applied to the element or by using JavaScript.
|
|
68370
69521
|
*
|
|
69522
|
+
* - `divided`: Draws a rule between one pair and the next, in the middle of the gap, as
|
|
69523
|
+
* a details panel with many rows often does. Off by default, where space
|
|
69524
|
+
* alone separates the pairs.
|
|
68371
69525
|
* - `justify`: Where the values sit, beside their labels.
|
|
68372
69526
|
*
|
|
68373
69527
|
* Absent, each value starts right after the label column. `between` sets it on
|
|
@@ -68445,7 +69599,10 @@ export type CustomElementsSolidJs = {
|
|
|
68445
69599
|
* CSS variables available for styling the component.
|
|
68446
69600
|
*
|
|
68447
69601
|
* - `--description-list-column-gap`: The space between the column of labels and the column of values, with `direction="row"`.
|
|
69602
|
+
* - `--description-list-divider-color`: The color of the rule between pairs, with `divided`.
|
|
69603
|
+
* - `--description-list-divider-width`: The thickness of the rule between pairs, with `divided`.
|
|
68448
69604
|
* - `--description-list-gap`: Space between one pair and the next. The default is smaller with `direction="row"` than when stacked. Setting this property replaces both defaults.
|
|
69605
|
+
* - `--description-list-label-width`: The width of the column of labels, with `direction="row"`. Defaults to the width of the longest label; set a length such as `10rem` to line up several lists.
|
|
68449
69606
|
*
|
|
68450
69607
|
* ## CSS Parts
|
|
68451
69608
|
*
|
|
@@ -68697,19 +69854,21 @@ export type CustomElementsSolidJs = {
|
|
|
68697
69854
|
* Absent is the middle. `start` and `end` move it toward one end, with a
|
|
68698
69855
|
* short length of line, `--divider-content-offset`, kept before or after it.
|
|
68699
69856
|
* A divider with nothing set into it is one line whatever this says.
|
|
68700
|
-
* - `announced`: Whether screen readers announce the line as a separator
|
|
68701
|
-
*
|
|
68702
|
-
*
|
|
68703
|
-
*
|
|
68704
|
-
*
|
|
68705
|
-
*
|
|
68706
|
-
*
|
|
68707
|
-
*
|
|
68708
|
-
*
|
|
68709
|
-
*
|
|
68710
|
-
*
|
|
68711
|
-
*
|
|
69857
|
+
* - `announced`: Whether screen readers announce the line as a separator, which they now do
|
|
69858
|
+
* by default.
|
|
69859
|
+
*
|
|
69860
|
+
* It dates from when the line was decorative by default. It is still read,
|
|
69861
|
+
* and it wins over `decorative`, so a divider written with it stays a
|
|
69862
|
+
* separator.
|
|
69863
|
+
* - `decorative`: Takes the line out of the accessibility tree, for a rule that separates
|
|
69864
|
+
* nothing: one under a heading, or between the facts of a byline.
|
|
69865
|
+
*
|
|
69866
|
+
* Absent, the line is a separator, as `<hr>` is. Radix Separator's opt-out
|
|
69867
|
+
* has the same name. It turns the role off because a boolean attribute that
|
|
69868
|
+
* is on by default cannot be turned off from HTML.
|
|
68712
69869
|
* - `orientation`: The direction the line runs: `horizontal` or `vertical`.
|
|
69870
|
+
*
|
|
69871
|
+
* Unset is horizontal, or across the toolbar the divider sits in.
|
|
68713
69872
|
* - `whenSettled`: Resolves a frame after the first update, when transitions are switched on.
|
|
68714
69873
|
*
|
|
68715
69874
|
* **Named `whenSettled` because `settled` is taken four times over**, by
|
|
@@ -68743,6 +69902,9 @@ export type CustomElementsSolidJs = {
|
|
|
68743
69902
|
*
|
|
68744
69903
|
* - `--divider-color`: The color of the line.
|
|
68745
69904
|
* - `--divider-content-color`: The color of the content set into the line.
|
|
69905
|
+
* - `--divider-content-font-family`: The typeface of the content set into the line. The sans face by default.
|
|
69906
|
+
* - `--divider-content-font-size`: The size of the content set into the line. The `xs` step by default.
|
|
69907
|
+
* - `--divider-content-font-weight`: The weight of the content set into the line. The weight around the divider by default.
|
|
68746
69908
|
* - `--divider-content-gap`: The space either side of the content set into the line.
|
|
68747
69909
|
* - `--divider-content-offset`: The length of line before the content under `content-placement="start"`, or after it under `end`.
|
|
68748
69910
|
* - `--divider-length`: The length of a vertical line. A horizontal line takes the divider's width.
|
|
@@ -68762,6 +69924,7 @@ export type CustomElementsSolidJs = {
|
|
|
68762
69924
|
*
|
|
68763
69925
|
* These can be used to apply styling when a component is in a given state.
|
|
68764
69926
|
*
|
|
69927
|
+
* - `vertical`: The line runs vertically: `orientation="vertical"`, or no `orientation` inside a horizontal toolbar.
|
|
68765
69928
|
* - `settled`: Set one frame after the first render. Transitions wait for it, so an element does not animate its own arrival.
|
|
68766
69929
|
*/
|
|
68767
69930
|
"helix-divider": Partial<
|
|
@@ -69005,6 +70168,9 @@ export type CustomElementsSolidJs = {
|
|
|
69005
70168
|
*
|
|
69006
70169
|
* A column's heading is the cell's name in every row, so the first row
|
|
69007
70170
|
* answers for the column.
|
|
70171
|
+
* - `columnName(cell: number) => string`: The heading of the column at this place in a row: a cell's name is its
|
|
70172
|
+
* column's heading, read from the first row that has a cell there, so a
|
|
70173
|
+
* short first row does not lose the heading. `''` where no row has one.
|
|
69008
70174
|
* - `showsReading(at: number) => boolean`: Whether the slice at this place is drawn, which a slice a legend hid is
|
|
69009
70175
|
* not. The keys pass over it, as the ring closes over it.
|
|
69010
70176
|
*
|
|
@@ -69542,7 +70708,7 @@ export type CustomElementsSolidJs = {
|
|
|
69542
70708
|
*
|
|
69543
70709
|
* - `(default)`: The message: why the region is empty, and what to do about it.
|
|
69544
70710
|
* - `actions`: The action that would put something in the region.
|
|
69545
|
-
* - `heading`: The heading, which names what is missing.
|
|
70711
|
+
* - `heading`: The heading, which names what is missing. A heading element, such as an `<h3>`, keeps its level; any other element is read as a heading at `heading-level`. Replaces the one `heading` draws.
|
|
69546
70712
|
* - `icon`: An icon above the heading.
|
|
69547
70713
|
*
|
|
69548
70714
|
* ## CSS Custom Properties
|
|
@@ -69564,7 +70730,7 @@ export type CustomElementsSolidJs = {
|
|
|
69564
70730
|
*
|
|
69565
70731
|
* Custom selectors for styling elements within the component.
|
|
69566
70732
|
*
|
|
69567
|
-
* - `heading`: The heading
|
|
70733
|
+
* - `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.
|
|
69568
70734
|
* - `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.
|
|
69569
70735
|
*
|
|
69570
70736
|
* ## CSS States
|
|
@@ -70770,6 +71936,13 @@ export type CustomElementsSolidJs = {
|
|
|
70770
71936
|
* this is and a stylesheet has a reason to know: a compact reading is a fixed
|
|
70771
71937
|
* few characters and a date is not.
|
|
70772
71938
|
* - `era`: How the era is written, such as AD, where a date is shown.
|
|
71939
|
+
* - `fields`: Draws each field of a date in a part of its own: `weekday`, `day`,
|
|
71940
|
+
* `month`, `year`, `era`, `hour`, `minute`, `second`, `day-period` and
|
|
71941
|
+
* `time-zone-name`, so `::part(year)` can set the year apart.
|
|
71942
|
+
*
|
|
71943
|
+
* Off by default, which draws the date as one run of text, as Shoelace and
|
|
71944
|
+
* Web Awesome do. An `elapsed` or `relative` reading is one phrase either
|
|
71945
|
+
* way.
|
|
70773
71946
|
* - `frozen`: Draws an `elapsed` or `relative` reading once and leaves it, where it
|
|
70774
71947
|
* would otherwise move on as it goes stale.
|
|
70775
71948
|
*
|
|
@@ -70835,12 +72008,24 @@ export type CustomElementsSolidJs = {
|
|
|
70835
72008
|
*
|
|
70836
72009
|
* Custom selectors for styling elements within the component.
|
|
70837
72010
|
*
|
|
72011
|
+
* - `day`: The day of the month, with `fields`.
|
|
72012
|
+
* - `day-period`: AM or PM, or the locale's word for the part of the day, with `fields`.
|
|
72013
|
+
* - `era`: The era, such as AD, with `fields` and `era`.
|
|
72014
|
+
* - `hour`: The hour, with `fields`.
|
|
72015
|
+
* - `minute`: The minute, with `fields`.
|
|
72016
|
+
* - `month`: The month, with `fields`.
|
|
72017
|
+
* - `second`: The second, with `fields`.
|
|
70838
72018
|
* - `time`: The `<time>` element that holds the formatted text.
|
|
72019
|
+
* - `time-zone-name`: The time zone's name, with `fields`, where `time-zone-name` or a `long` or `full` `time-style` shows it.
|
|
72020
|
+
* - `weekday`: The day of the week, with `fields`.
|
|
72021
|
+
* - `year`: The year, with `fields`.
|
|
70839
72022
|
*
|
|
70840
72023
|
* ## CSS States
|
|
70841
72024
|
*
|
|
70842
72025
|
* These can be used to apply styling when a component is in a given state.
|
|
70843
72026
|
*
|
|
72027
|
+
* - `future`: An `elapsed` or `relative` reading of a moment still to come, such as "in 3 hours".
|
|
72028
|
+
* - `past`: An `elapsed` or `relative` reading of a moment gone, such as "3 hours ago".
|
|
70844
72029
|
* - `settled`: Set one frame after the first render. Transitions wait for it, so an element does not animate its own arrival.
|
|
70845
72030
|
*/
|
|
70846
72031
|
"helix-format-date": Partial<
|
|
@@ -71026,7 +72211,14 @@ export type CustomElementsSolidJs = {
|
|
|
71026
72211
|
* - `(default)`: The renderer's box, which the drawing is made in.
|
|
71027
72212
|
* - `filter-icon`: The icon in the search field. Defaults to a magnifying glass.
|
|
71028
72213
|
* - `footer`: Content below the graph.
|
|
72214
|
+
* - `fullscreen-icon`: Replaces the glyph inside the fullscreen button.
|
|
71029
72215
|
* - `header`: Content above the graph.
|
|
72216
|
+
* - `pan-down-icon`: Replaces the glyph inside the pan down button.
|
|
72217
|
+
* - `pan-end-icon`: Replaces the glyph inside the button that pans toward the end of a line of text.
|
|
72218
|
+
* - `pan-start-icon`: Replaces the glyph inside the button that pans toward the start of a line of text.
|
|
72219
|
+
* - `pan-up-icon`: Replaces the glyph inside the pan up button.
|
|
72220
|
+
* - `zoom-in-icon`: Replaces the glyph inside the zoom-in button.
|
|
72221
|
+
* - `zoom-out-icon`: Replaces the glyph inside the zoom-out button.
|
|
71030
72222
|
*
|
|
71031
72223
|
* ## Methods
|
|
71032
72224
|
*
|
|
@@ -71125,9 +72317,14 @@ export type CustomElementsSolidJs = {
|
|
|
71125
72317
|
*
|
|
71126
72318
|
* These can be used to apply styling when a component is in a given state.
|
|
71127
72319
|
*
|
|
72320
|
+
* - `empty`: The list holds no notes: the graph has none, or a search or the groups hid them all.
|
|
71128
72321
|
* - `fullscreen`: The graph fills the screen.
|
|
71129
72322
|
* - `idle`: The user has been still long enough for the header and footer to fade.
|
|
72323
|
+
* - `local`: The drawing shows the selected note's local graph, with `depth`.
|
|
72324
|
+
* - `panel-open`: A graph with `no-panel` has the search and the list open over the drawing.
|
|
71130
72325
|
* - `ready`: The graph has been drawn whole, after `helix-graph-ready`.
|
|
72326
|
+
* - `searching`: The search field holds words, and the list holds only the notes they find.
|
|
72327
|
+
* - `selected`: A note is selected, in the list or in the drawing.
|
|
71131
72328
|
* - `sharing`: The page keeps the plain wheel and one finger, with `gestures="cooperative"` or while a graph with `gestures="activate"` waits to be pressed.
|
|
71132
72329
|
* - `using`: A graph with `gestures="activate"` has been pressed and has the gestures.
|
|
71133
72330
|
* - `settled`: Set one frame after the first render. Transitions wait for it, so an element does not animate its own arrival.
|
|
@@ -71321,6 +72518,9 @@ export type CustomElementsSolidJs = {
|
|
|
71321
72518
|
* calendar heatmap does: a week is a column, so the strip reads along the
|
|
71322
72519
|
* line in weeks, from the right on a right-to-left page, and top to bottom in
|
|
71323
72520
|
* days.
|
|
72521
|
+
* - `selected-label`/`selectedLabel`: What the readout adds for a selected cell, under `selection-mode`, after
|
|
72522
|
+
* where the cell stands: "Day 1: 0 (1 of 14, selected)". Empty adds
|
|
72523
|
+
* nothing.
|
|
71324
72524
|
* - `selection-label`/`selectionLabel`: What the `selection` part says after the selection changes, with `{count}` for
|
|
71325
72525
|
* how many cells are selected.
|
|
71326
72526
|
* - `selection-mode`/`selectionMode`: How many cells a reader can select: `single` or `multiple`.
|
|
@@ -71471,6 +72671,9 @@ export type CustomElementsSolidJs = {
|
|
|
71471
72671
|
*
|
|
71472
72672
|
* A column's heading is the cell's name in every row, so the first row
|
|
71473
72673
|
* answers for the column.
|
|
72674
|
+
* - `columnName(cell: number) => string`: The heading of the column at this place in a row: a cell's name is its
|
|
72675
|
+
* column's heading, read from the first row that has a cell there, so a
|
|
72676
|
+
* short first row does not lose the heading. `''` where no row has one.
|
|
71474
72677
|
* - `pageFrom(at: number, forward: boolean) => number | undefined`: Where PageUp or PageDown goes from the drawn cell at `at`: the same day a
|
|
71475
72678
|
* month on or back, by the dates the rows' headers carry. Undefined where
|
|
71476
72679
|
* they carry none, and the keys move four columns.
|
|
@@ -73290,6 +74493,9 @@ export type CustomElementsSolidJs = {
|
|
|
73290
74493
|
*
|
|
73291
74494
|
* A column's heading is the cell's name in every row, so the first row
|
|
73292
74495
|
* answers for the column.
|
|
74496
|
+
* - `columnName(cell: number) => string`: The heading of the column at this place in a row: a cell's name is its
|
|
74497
|
+
* column's heading, read from the first row that has a cell there, so a
|
|
74498
|
+
* short first row does not lose the heading. `''` where no row has one.
|
|
73293
74499
|
*
|
|
73294
74500
|
* ## CSS Custom Properties
|
|
73295
74501
|
*
|
|
@@ -73643,12 +74849,16 @@ export type CustomElementsSolidJs = {
|
|
|
73643
74849
|
* and this one was the English a form in another language still spoke in
|
|
73644
74850
|
* the bubble it raises on submit: `feedback` replaces the message under
|
|
73645
74851
|
* the field and does not reach that one.
|
|
73646
|
-
* - `autocomplete`: What
|
|
74852
|
+
* - `autocomplete`: What a browser's autofill may choose, as a platform token such as
|
|
74853
|
+
* `country` or `cc-exp-month`, as a native `<select>` takes it.
|
|
73647
74854
|
*
|
|
73648
|
-
*
|
|
73649
|
-
*
|
|
73650
|
-
*
|
|
73651
|
-
*
|
|
74855
|
+
* Set, the list draws a hidden native `<select>` with the same options for
|
|
74856
|
+
* the browser to fill, as React Aria's `HiddenSelect` does, and a fill
|
|
74857
|
+
* chooses the option. `off`, the default, draws none.
|
|
74858
|
+
*
|
|
74859
|
+
* **The filter field is never filled.** It narrows the list rather than
|
|
74860
|
+
* collecting a value, so a browser offering it a saved address competes
|
|
74861
|
+
* with the reader for the same keystrokes: it is always `off`.
|
|
73652
74862
|
* - `default-filter`/`defaultFilter`: The filter text the list starts with, when `filter` is not set.
|
|
73653
74863
|
* - `filter`: The text the list is filtered by, if any.
|
|
73654
74864
|
*
|
|
@@ -73670,8 +74880,19 @@ export type CustomElementsSolidJs = {
|
|
|
73670
74880
|
* letter. Enter and the arrow keys filter at once on what is typed, so they
|
|
73671
74881
|
* act on the list the reader expects.
|
|
73672
74882
|
* - `filter-label`/`filterLabel`: Placeholder text for the filter field.
|
|
74883
|
+
* - `layout`: How the options are laid out, which the arrow keys follow: `stack`, one
|
|
74884
|
+
* under another, or `grid`, in rows and columns, as React Aria's `ListBox`
|
|
74885
|
+
* lays out cards or photos. With `grid`, Up and Down move within a column,
|
|
74886
|
+
* and Left and Right along the list, mirrored right to left.
|
|
74887
|
+
*
|
|
74888
|
+
* The columns are the stylesheet's: the styled tier draws them at
|
|
74889
|
+
* `--listbox-column-min-inline-size` or wider, and a headless list lays out
|
|
74890
|
+
* `::part(items)` as it likes, since the keys read where each option is
|
|
74891
|
+
* drawn. A list of `items` stays a stack. Left out, the list is a stack,
|
|
74892
|
+
* and the host carries no attribute for it.
|
|
73673
74893
|
* - `load-error`/`loadError`: What the list says when its options could not be loaded, such as after a
|
|
73674
|
-
* request to a server fails. Empty is no error
|
|
74894
|
+
* request to a server fails. Empty, null or no attribute is no error, so
|
|
74895
|
+
* removing the attribute clears it.
|
|
73675
74896
|
*
|
|
73676
74897
|
* Set, it shows under any options there are, in place of `empty-text` and
|
|
73677
74898
|
* `loading-text`, and a screen reader hears it. Clear it when you ask again.
|
|
@@ -73694,6 +74915,8 @@ export type CustomElementsSolidJs = {
|
|
|
73694
74915
|
* **Two sentences, chosen by `Intl.PluralRules`**, which is Data Table's
|
|
73695
74916
|
* pair: a language with more forms than two picks the one for its `one` and
|
|
73696
74917
|
* writes the rest here.
|
|
74918
|
+
* - `selected-label`/`selectedLabel`: What VoiceOver hears as the highlight reaches a chosen option from the
|
|
74919
|
+
* filter field, on Apple devices. `{name}` is the option's words.
|
|
73697
74920
|
* - `disabled`: Whether the control is disabled and cannot be used.
|
|
73698
74921
|
*
|
|
73699
74922
|
* Reflected, because the styled tier selects on it, and mirrored to
|
|
@@ -73718,6 +74941,22 @@ export type CustomElementsSolidJs = {
|
|
|
73718
74941
|
* imperatively later, and nothing is hydrating by then.
|
|
73719
74942
|
*
|
|
73720
74943
|
* Here rather than on each control.
|
|
74944
|
+
* - `items`: The options as data, for a list too long to draw whole: each a value,
|
|
74945
|
+
* which is also its words, or a record with a `value`, a `label` and
|
|
74946
|
+
* `disabled`. Set, the list draws only the options in sight, and the ones
|
|
74947
|
+
* you write as children are not read.
|
|
74948
|
+
*
|
|
74949
|
+
* **Every option is still reachable.** The keyboard, the typeahead, the
|
|
74950
|
+
* filter and the value work over the whole set, and the option the keyboard
|
|
74951
|
+
* is on is drawn wherever it is, so a screen reader is told about it. Each
|
|
74952
|
+
* drawn option says its place in the set (`aria-posinset`, `aria-setsize`).
|
|
74953
|
+
* React Aria virtualizes a `ListBox` with its `Virtualizer`; this is core's
|
|
74954
|
+
* `VirtualizeController`.
|
|
74955
|
+
*
|
|
74956
|
+
* **The list needs a height to scroll in**: the styled tier's
|
|
74957
|
+
* `--listbox-max-block-size`, or a `max-block-size` on `::part(items)` in the
|
|
74958
|
+
* headless tier. Import the Option family as well, whose elements are drawn.
|
|
74959
|
+
* A server sends the list empty, and the options are drawn once it hydrates. (property only)
|
|
73721
74960
|
* - `selectedIndex`: Which option is chosen, as an index, or `-1` where none is.
|
|
73722
74961
|
*
|
|
73723
74962
|
* `<select>`'s own pair, and this control is what stands in for one. The
|
|
@@ -73838,10 +75077,8 @@ export type CustomElementsSolidJs = {
|
|
|
73838
75077
|
* read as a dial rather than scanned as a list, which is what Time Picker's
|
|
73839
75078
|
* wheels do with three of these.
|
|
73840
75079
|
*
|
|
73841
|
-
*
|
|
73842
|
-
*
|
|
73843
|
-
* which is not this list and is not guaranteed to be anything: measuring both
|
|
73844
|
-
* rects and moving by the difference needs no such assumption.
|
|
75080
|
+
* Measured by core's `centerInView`, or, for a list of `items`, by the
|
|
75081
|
+
* arithmetic, since the chosen option may not be drawn.
|
|
73845
75082
|
* - `requestFilter(next: string) => boolean`: Requests a new filter, and returns whether the request went through.
|
|
73846
75083
|
* - `formDisabledCallback(disabled: boolean) => void`: Called by the browser when an ancestor fieldset is disabled or enabled.
|
|
73847
75084
|
*
|
|
@@ -73890,6 +75127,7 @@ export type CustomElementsSolidJs = {
|
|
|
73890
75127
|
*
|
|
73891
75128
|
* - `--listbox-background-color`: The panel's fill. Set it to `transparent` when the list is already inside a panel.
|
|
73892
75129
|
* - `--listbox-border`: The panel's border, as a shorthand. Set it to `none` when the list is already inside a panel.
|
|
75130
|
+
* - `--listbox-column-min-inline-size`: How narrow a column may be with `layout="grid"`. As many columns as fit are drawn. Defaults to `8rem`.
|
|
73893
75131
|
* - `--listbox-error-color`: The color of the line shown while `load-error` is set.
|
|
73894
75132
|
* - `--listbox-max-block-size`: Maximum height of the list before it scrolls.
|
|
73895
75133
|
*
|
|
@@ -74826,8 +76064,20 @@ export type CustomElementsSolidJs = {
|
|
|
74826
76064
|
*
|
|
74827
76065
|
* - `(default)`: The element your renderer draws the map in, and the map's markers, routes, areas, positions, and points layers.
|
|
74828
76066
|
* - `attribution`: The map credit, which most tile licenses require.
|
|
76067
|
+
* - `face-north-icon`: Replaces the compass needle. It inherits `--map-needle-turn`, so `rotate: var(--map-needle-turn)` keeps it pointing north.
|
|
74829
76068
|
* - `footer`: Content below the map, such as a legend or a scale.
|
|
76069
|
+
* - `fullscreen-icon`: Replaces the glyph inside the fullscreen button.
|
|
74830
76070
|
* - `header`: Content above the map, such as a title or a search field.
|
|
76071
|
+
* - `layers-icon`: Replaces the glyph inside the layers button.
|
|
76072
|
+
* - `pan-down-icon`: Replaces the glyph inside the pan down button.
|
|
76073
|
+
* - `pan-end-icon`: Replaces the glyph inside the button that pans toward the end of a line of text.
|
|
76074
|
+
* - `pan-start-icon`: Replaces the glyph inside the button that pans toward the start of a line of text.
|
|
76075
|
+
* - `pan-up-icon`: Replaces the glyph inside the pan up button.
|
|
76076
|
+
* - `rotate-left-icon`: Replaces the glyph inside the rotate left button.
|
|
76077
|
+
* - `rotate-right-icon`: Replaces the glyph inside the rotate right button.
|
|
76078
|
+
* - `tilt-icon`: Replaces the "3D" inside the 3D button.
|
|
76079
|
+
* - `zoom-in-icon`: Replaces the glyph inside the zoom-in button.
|
|
76080
|
+
* - `zoom-out-icon`: Replaces the glyph inside the zoom-out button.
|
|
74831
76081
|
*
|
|
74832
76082
|
* ## Methods
|
|
74833
76083
|
*
|
|
@@ -74867,9 +76117,19 @@ export type CustomElementsSolidJs = {
|
|
|
74867
76117
|
*
|
|
74868
76118
|
* CSS variables available for styling the component.
|
|
74869
76119
|
*
|
|
76120
|
+
* - `--map-attribution-border-color`: The rule above the map credit, under the map.
|
|
76121
|
+
* - `--map-attribution-color`: The color of the map credit.
|
|
76122
|
+
* - `--map-attribution-font-size`: The size of the map credit's text.
|
|
74870
76123
|
* - `--map-background-color`: The color behind the map while tiles load.
|
|
74871
76124
|
* - `--map-block-size`: The frame's height, as a length. Ignored with `fill`, where the container decides it.
|
|
74872
76125
|
* - `--map-border-color`: The frame's border color.
|
|
76126
|
+
* - `--map-chosen-color`: The fill of the pressed 3D button and the ring around the chosen map type and each shown layer in the layers menu.
|
|
76127
|
+
* - `--map-layers-menu-gap`: The space between the map types and the layers in the layers menu.
|
|
76128
|
+
* - `--map-layers-menu-inline-size`: The width of the layers menu.
|
|
76129
|
+
* - `--map-layers-menu-padding`: The space inside the edge of the layers menu.
|
|
76130
|
+
* - `--map-needle-north-color`: The north half of the compass needle.
|
|
76131
|
+
* - `--map-needle-south-color`: The south half of the compass needle.
|
|
76132
|
+
* - `--map-radius`: The frame's corners.
|
|
74873
76133
|
* - `--viewport-control-background-color`: The background of the pan and zoom buttons. Canvas uses the same property.
|
|
74874
76134
|
* - `--map-needle-turn`: How far the needle turns to point north, as an angle. The frame writes it from `bearing`.
|
|
74875
76135
|
*
|
|
@@ -74918,8 +76178,11 @@ export type CustomElementsSolidJs = {
|
|
|
74918
76178
|
*
|
|
74919
76179
|
* - `fullscreen`: The map fills the screen.
|
|
74920
76180
|
* - `idle`: The user has been still long enough for the header and footer to fade.
|
|
76181
|
+
* - `layers-open`: The layers menu is open.
|
|
74921
76182
|
* - `ready`: The map has been drawn whole, after `helix-map-ready`.
|
|
76183
|
+
* - `rotated`: The map is turned away from north, by `bearing`.
|
|
74922
76184
|
* - `sharing`: The page keeps the plain wheel and one finger, with `gestures="cooperative"` or while a map with `gestures="activate"` waits to be pressed.
|
|
76185
|
+
* - `tilted`: The map is tilted by `pitch`, so it no longer looks straight down.
|
|
74923
76186
|
* - `using`: A map with `gestures="activate"` has been pressed and has the gestures.
|
|
74924
76187
|
* - `settled`: Set one frame after the first render. Transitions wait for it, so an element does not animate its own arrival.
|
|
74925
76188
|
*/
|
|
@@ -76231,6 +77494,16 @@ export type CustomElementsSolidJs = {
|
|
|
76231
77494
|
* - `body`: The label and the caption together.
|
|
76232
77495
|
* - `label`: What happened, on the first line.
|
|
76233
77496
|
* - `media`: The leading slot's box.
|
|
77497
|
+
* - `time-day`: Format Date's `day`, forwarded for a time drawn as fields. An elapsed time draws none.
|
|
77498
|
+
* - `time-day-period`: Format Date's `day-period`, forwarded for a time drawn as fields. An elapsed time draws none.
|
|
77499
|
+
* - `time-era`: Format Date's `era`, forwarded for a time drawn as fields. An elapsed time draws none.
|
|
77500
|
+
* - `time-hour`: Format Date's `hour`, forwarded for a time drawn as fields. An elapsed time draws none.
|
|
77501
|
+
* - `time-minute`: Format Date's `minute`, forwarded for a time drawn as fields. An elapsed time draws none.
|
|
77502
|
+
* - `time-month`: Format Date's `month`, forwarded for a time drawn as fields. An elapsed time draws none.
|
|
77503
|
+
* - `time-second`: Format Date's `second`, forwarded for a time drawn as fields. An elapsed time draws none.
|
|
77504
|
+
* - `time-time-zone-name`: Format Date's `time-zone-name`, forwarded for a time drawn as fields. An elapsed time draws none.
|
|
77505
|
+
* - `time-weekday`: Format Date's `weekday`, forwarded for a time drawn as fields. An elapsed time draws none.
|
|
77506
|
+
* - `time-year`: Format Date's `year`, forwarded for a time drawn as fields. An elapsed time draws none.
|
|
76234
77507
|
*
|
|
76235
77508
|
* ## CSS States
|
|
76236
77509
|
*
|
|
@@ -76269,6 +77542,12 @@ export type CustomElementsSolidJs = {
|
|
|
76269
77542
|
* say that without the component knowing what a row looks like.
|
|
76270
77543
|
* - `loading-text`/`loadingText`: The text shown and announced while the rows load.
|
|
76271
77544
|
* - `label`: The feed's name, read by screen readers.
|
|
77545
|
+
* - `load-error`/`loadError`: What the feed says when a page of it could not be loaded, such as after a
|
|
77546
|
+
* request to a server fails. Empty, null or no attribute is no error, so
|
|
77547
|
+
* removing the attribute clears it.
|
|
77548
|
+
*
|
|
77549
|
+
* Set, it shows under the rows there are, in place of `empty-text` and
|
|
77550
|
+
* `loading-text`, and a screen reader hears it. Clear it when you ask again.
|
|
76272
77551
|
* - `load-more`/`loadMore`: Whether to draw a button after the list that asks for the next page, by
|
|
76273
77552
|
* sending `helix-load-more`. Take it off once there is nothing more.
|
|
76274
77553
|
* - `load-more-label`/`loadMoreLabel`: The text of the `load-more` button.
|
|
@@ -76350,6 +77629,7 @@ export type CustomElementsSolidJs = {
|
|
|
76350
77629
|
*
|
|
76351
77630
|
* - `(default)`: The notifications.
|
|
76352
77631
|
* - `empty`: Replaces the words of `empty-text` in the `empty` part, such as a picture and a line of your own.
|
|
77632
|
+
* - `error`: Replaces the words of `load-error` in the `error` part, such as a line with a retry button.
|
|
76353
77633
|
* - `footer`: Below the list, for a link to everything.
|
|
76354
77634
|
* - `header`: Above the list, for a title and the mark-all control.
|
|
76355
77635
|
* - `loading`: Replaces the words of `loading-text` in the `loading` part, such as a loader.
|
|
@@ -76389,6 +77669,7 @@ export type CustomElementsSolidJs = {
|
|
|
76389
77669
|
*
|
|
76390
77670
|
* CSS variables available for styling the component.
|
|
76391
77671
|
*
|
|
77672
|
+
* - `--notifications-error-color`: The color of the `error` line.
|
|
76392
77673
|
* - `--notifications-max-block-size`: How tall the feed may get before the list scrolls.
|
|
76393
77674
|
* - `--notifications-media-column`: Width of the media column that every item keeps when any item in the feed has media.
|
|
76394
77675
|
* - `--notifications-padding-inline`: Space either side of the header and footer.
|
|
@@ -76398,8 +77679,9 @@ export type CustomElementsSolidJs = {
|
|
|
76398
77679
|
*
|
|
76399
77680
|
* Custom selectors for styling elements within the component.
|
|
76400
77681
|
*
|
|
77682
|
+
* - `error`: The line `load-error` shows under the rows, in the danger color.
|
|
76401
77683
|
* - `list`: The list itself.
|
|
76402
|
-
* - `live`: A copy of the empty and
|
|
77684
|
+
* - `live`: A copy of the empty, loading and error messages, in a live region that screen readers announce when they change. Visually hidden in the styled tier.
|
|
76403
77685
|
* - `mark-all`: The control that marks everything read.
|
|
76404
77686
|
* - `more`: The button after the list that asks for more, while `load-more` is set. It stays while the feed is loading, in a lighter color and `aria-disabled`, so focus stays on it.
|
|
76405
77687
|
* - `empty`: Shown when there is nothing in the feed.
|
|
@@ -76411,7 +77693,8 @@ export type CustomElementsSolidJs = {
|
|
|
76411
77693
|
*
|
|
76412
77694
|
* These can be used to apply styling when a component is in a given state.
|
|
76413
77695
|
*
|
|
76414
|
-
* - `empty`: While the feed holds no notification and is not loading. Never on the server, which cannot count the rows.
|
|
77696
|
+
* - `empty`: While the feed holds no notification and is not loading, and `load-error` is not set. Never on the server, which cannot count the rows.
|
|
77697
|
+
* - `error`: While `load-error` is set.
|
|
76415
77698
|
* - `loading`: While `loading` is set.
|
|
76416
77699
|
* - `media`: While a notification in the list holds something in its media slot, so every row keeps that column.
|
|
76417
77700
|
* - `settled`: Set one frame after the first render. Transitions wait for it, so an element does not animate its own arrival.
|
|
@@ -77671,10 +78954,24 @@ export type CustomElementsSolidJs = {
|
|
|
77671
78954
|
*
|
|
77672
78955
|
* CSS variables available for styling the component.
|
|
77673
78956
|
*
|
|
78957
|
+
* - `--pagination-current-border-color`: Edge of the page you are on.
|
|
77674
78958
|
* - `--pagination-current-color`: Fill behind the page you are on.
|
|
78959
|
+
* - `--pagination-current-font-weight`: Weight of the number of the page you are on.
|
|
78960
|
+
* - `--pagination-current-foreground-color`: Color of the number of the page you are on.
|
|
78961
|
+
* - `--pagination-disabled-foreground-color`: Color of a first, previous, next or last control with nowhere to go.
|
|
78962
|
+
* - `--pagination-disabled-opacity`: How faint a control with nowhere to go is drawn.
|
|
78963
|
+
* - `--pagination-ellipsis-foreground-color`: Color of the control that stands in for hidden pages.
|
|
78964
|
+
* - `--pagination-font-size`: Size of the numbers and the status text.
|
|
78965
|
+
* - `--pagination-font-weight`: Weight of the numbers and the status text.
|
|
78966
|
+
* - `--pagination-foreground-color`: Color of the numbers and the marks on every control.
|
|
77675
78967
|
* - `--pagination-gap`: Space between one control and the next.
|
|
77676
78968
|
* - `--pagination-hover-color`: Fill behind a control under the pointer.
|
|
78969
|
+
* - `--pagination-hover-foreground-color`: Color of a control's number or mark under the pointer.
|
|
78970
|
+
* - `--pagination-icon-size`: Size of the mark on a first, previous, next or last control, drawn or slotted.
|
|
78971
|
+
* - `--pagination-padding`: Space either side of a control's number or mark.
|
|
78972
|
+
* - `--pagination-radius`: Corner radius of every control in the row.
|
|
77677
78973
|
* - `--pagination-size`: The box every control in the row takes.
|
|
78974
|
+
* - `--pagination-status-foreground-color`: Color of the text that says which page you are on, in `compact`.
|
|
77678
78975
|
*
|
|
77679
78976
|
* ## CSS Parts
|
|
77680
78977
|
*
|
|
@@ -77846,6 +79143,13 @@ export type CustomElementsSolidJs = {
|
|
|
77846
79143
|
* string, as on a native control. The form does not submit while it is set.
|
|
77847
79144
|
* - `focus(options?: FocusOptions) => void`: Moves focus to the control, as focusing a native control does.
|
|
77848
79145
|
*
|
|
79146
|
+
* ## CSS Custom Properties
|
|
79147
|
+
*
|
|
79148
|
+
* CSS variables available for styling the component.
|
|
79149
|
+
*
|
|
79150
|
+
* - `--pagination-size`: Height of the select's trigger, the same hook that sizes every control in the page row.
|
|
79151
|
+
* - `--pagination-size-gap`: Space between the label and the select.
|
|
79152
|
+
*
|
|
77849
79153
|
* ## CSS Parts
|
|
77850
79154
|
*
|
|
77851
79155
|
* Custom selectors for styling elements within the component.
|
|
@@ -77868,6 +79172,7 @@ export type CustomElementsSolidJs = {
|
|
|
77868
79172
|
* - `control-listbox-loading`: The text shown while the options load.
|
|
77869
79173
|
* - `control-listbox-search`: The region that holds the filter field.
|
|
77870
79174
|
* - `control-listbox-search-field`: The filter field.
|
|
79175
|
+
* - `control-live`: The select's `live` part, the region a screen reader hears a choice made on the closed trigger from.
|
|
77871
79176
|
* - `control-surface`: The floating panel.
|
|
77872
79177
|
* - `control-trigger`: The closed control, which shows the chosen size.
|
|
77873
79178
|
* - `control-value`: The chosen size inside the trigger.
|
|
@@ -77942,6 +79247,13 @@ export type CustomElementsSolidJs = {
|
|
|
77942
79247
|
* browser harness's awaits it alone: a browser always runs the frame, and a
|
|
77943
79248
|
* timer beside it was a bet on how long one takes, which a busy run lost. (property only) (readonly)
|
|
77944
79249
|
*
|
|
79250
|
+
* ## CSS Custom Properties
|
|
79251
|
+
*
|
|
79252
|
+
* CSS variables available for styling the component.
|
|
79253
|
+
*
|
|
79254
|
+
* - `--pagination-font-size`: Size of the text, the same hook that sizes the page numbers.
|
|
79255
|
+
* - `--pagination-summary-foreground-color`: Color of the text.
|
|
79256
|
+
*
|
|
77945
79257
|
* ## CSS States
|
|
77946
79258
|
*
|
|
77947
79259
|
* These can be used to apply styling when a component is in a given state.
|
|
@@ -78632,7 +79944,8 @@ export type CustomElementsSolidJs = {
|
|
|
78632
79944
|
* - `toPng(size = 512) => Promise<Blob | null>`: The code as a PNG, `size` pixels square, drawn from `toSvg()`.
|
|
78633
79945
|
*
|
|
78634
79946
|
* `null` where no code is drawn.
|
|
78635
|
-
* - `download(filename = 'qr-code.png', size = 512) => Promise<void>`: Saves the code as a
|
|
79947
|
+
* - `download(filename = 'qr-code.png', size = 512) => Promise<void>`: Saves the code as a file named `filename`, `size` pixels square: an SVG
|
|
79948
|
+
* where the name ends in `.svg`, and a PNG otherwise.
|
|
78636
79949
|
*
|
|
78637
79950
|
* Call it from a press, since a browser lets a page start a download only
|
|
78638
79951
|
* in answer to one. Does nothing where no code is drawn.
|
|
@@ -78643,9 +79956,12 @@ export type CustomElementsSolidJs = {
|
|
|
78643
79956
|
*
|
|
78644
79957
|
* - `--qr-code-background-color`: The fill behind the modules, including the quiet zone and the logo's box.
|
|
78645
79958
|
* - `--qr-code-color`: Color of the dark modules. Defaults to the dark media ink, which is the same in both color schemes so the code scans.
|
|
79959
|
+
* - `--qr-code-fallback-padding`: The space around the fallback inside the square.
|
|
78646
79960
|
* - `--qr-code-finder-color`: Color of the three corner squares. Defaults to the color of the modules.
|
|
78647
79961
|
* - `--qr-code-logo-padding`: The clear space around the center logo.
|
|
79962
|
+
* - `--qr-code-logo-radius`: The corner radius of the logo's box.
|
|
78648
79963
|
* - `--qr-code-logo-size`: How much of the center a logo can cover. Defaults to `27%`, which `H` correction allows, because it can lose thirty percent.
|
|
79964
|
+
* - `--qr-code-radius`: The corner radius of the square.
|
|
78649
79965
|
* - `--qr-code-size`: How wide the square is. Defaults to `12rem`.
|
|
78650
79966
|
*
|
|
78651
79967
|
* ## CSS Parts
|
|
@@ -80264,6 +81580,9 @@ export type CustomElementsSolidJs = {
|
|
|
80264
81580
|
*
|
|
80265
81581
|
* A column's heading is the cell's name in every row, so the first row
|
|
80266
81582
|
* answers for the column.
|
|
81583
|
+
* - `columnName(cell: number) => string`: The heading of the column at this place in a row: a cell's name is its
|
|
81584
|
+
* column's heading, read from the first row that has a cell there, so a
|
|
81585
|
+
* short first row does not lose the heading. `''` where no row has one.
|
|
80267
81586
|
*
|
|
80268
81587
|
* ## CSS Custom Properties
|
|
80269
81588
|
*
|
|
@@ -80543,6 +81862,13 @@ export type CustomElementsSolidJs = {
|
|
|
80543
81862
|
* and this one was the English a form in another language still spoke in
|
|
80544
81863
|
* the bubble it raises on submit: `feedback` replaces the message under
|
|
80545
81864
|
* the field and does not reach that one.
|
|
81865
|
+
* - `autocomplete`: What a browser's autofill may fill in, as a platform token such as
|
|
81866
|
+
* `country` or `cc-exp-month`, as on a native `<select>`.
|
|
81867
|
+
*
|
|
81868
|
+
* Set, the select keeps a hidden native `<select>` with the same options for
|
|
81869
|
+
* the browser to fill, as React Aria's `HiddenSelect` does, and takes the
|
|
81870
|
+
* option the browser picks, by its value or its words, as the value. Empty
|
|
81871
|
+
* draws no hidden select, and a browser fills nothing.
|
|
80546
81872
|
* - `empty-text`/`emptyText`: The text shown when no options match the filter.
|
|
80547
81873
|
* - `filterable`: Whether the list can be narrowed by typing.
|
|
80548
81874
|
*
|
|
@@ -80776,6 +82102,7 @@ export type CustomElementsSolidJs = {
|
|
|
80776
82102
|
* - `listbox-loading`: The text shown while the options load.
|
|
80777
82103
|
* - `listbox-search`: The region that holds the filter field.
|
|
80778
82104
|
* - `listbox-search-field`: The filter field.
|
|
82105
|
+
* - `live`: The region a screen reader announces a choice made on the closed trigger from, drawn once there is one to say. Visually hidden in the styled tier.
|
|
80779
82106
|
* - `surface`: The floating panel.
|
|
80780
82107
|
* - `trigger`: The closed control, which shows the chosen value.
|
|
80781
82108
|
* - `value`: The chosen option's text inside the trigger.
|
|
@@ -81518,6 +82845,71 @@ export type CustomElementsSolidJs = {
|
|
|
81518
82845
|
BaseEvents<HelixSparkline>
|
|
81519
82846
|
>;
|
|
81520
82847
|
|
|
82848
|
+
/**
|
|
82849
|
+
* A column of actions with its name above them, in the small muted words a
|
|
82850
|
+
* menu heads its sections with, lined up on the side the trigger is on. The
|
|
82851
|
+
* space between two groups is the space between two actions.
|
|
82852
|
+
*
|
|
82853
|
+
* ## Attributes & Properties
|
|
82854
|
+
*
|
|
82855
|
+
* Component attributes and properties that can be applied to the element or by using JavaScript.
|
|
82856
|
+
*
|
|
82857
|
+
* - `label`: The group's name, drawn above its actions and read by screen readers.
|
|
82858
|
+
* - `whenSettled`: Resolves a frame after the first update, when transitions are switched on.
|
|
82859
|
+
*
|
|
82860
|
+
* **Named `whenSettled` because `settled` is taken four times over**, by
|
|
82861
|
+
* Image, Splitter and both color controls, none of them about transitions. A
|
|
82862
|
+
* base class takes the name every subclass then cannot use.
|
|
82863
|
+
*
|
|
82864
|
+
* **The state it reports cannot be watched, which is why this exists.** A
|
|
82865
|
+
* custom state is deliberately not in the DOM, so there is no
|
|
82866
|
+
* `MutationObserver` equivalent for `ElementInternals.states`. Await this
|
|
82867
|
+
* instead.
|
|
82868
|
+
*
|
|
82869
|
+
* Separate from `updateComplete`, which resolves in the microtask checkpoint
|
|
82870
|
+
* the suppression is still active in. That is the distinction `readyToMove`
|
|
82871
|
+
* in `@fusion.dev/helix-testing` is written around.
|
|
82872
|
+
*
|
|
82873
|
+
* It never resolves where `requestAnimationFrame` never fires, which is a
|
|
82874
|
+
* server, a hidden tab, and happy-dom. Callers that must not hang there race
|
|
82875
|
+
* it against a timeout, as the happy-dom harness's `readyToMove` does. The
|
|
82876
|
+
* browser harness's awaits it alone: a browser always runs the frame, and a
|
|
82877
|
+
* timer beside it was a bet on how long one takes, which a busy run lost. (property only) (readonly)
|
|
82878
|
+
*
|
|
82879
|
+
* ## Slots
|
|
82880
|
+
*
|
|
82881
|
+
* Areas where markup can be added to the component.
|
|
82882
|
+
*
|
|
82883
|
+
* - `(default)`: The group's actions.
|
|
82884
|
+
* - `label`: The group's name, for content richer than the `label` text.
|
|
82885
|
+
*
|
|
82886
|
+
* ## CSS Custom Properties
|
|
82887
|
+
*
|
|
82888
|
+
* CSS variables available for styling the component.
|
|
82889
|
+
*
|
|
82890
|
+
* - `--speed-dial-group-label-color`: Color of the group's name.
|
|
82891
|
+
* - `--speed-dial-group-label-font-size`: Size of the group's name.
|
|
82892
|
+
*
|
|
82893
|
+
* ## CSS Parts
|
|
82894
|
+
*
|
|
82895
|
+
* Custom selectors for styling elements within the component.
|
|
82896
|
+
*
|
|
82897
|
+
* - `group`: The set, which carries the `group` role.
|
|
82898
|
+
* - `label`: The group's name, drawn above its actions while there is one.
|
|
82899
|
+
*
|
|
82900
|
+
* ## CSS States
|
|
82901
|
+
*
|
|
82902
|
+
* These can be used to apply styling when a component is in a given state.
|
|
82903
|
+
*
|
|
82904
|
+
* - `settled`: Set one frame after the first render. Transitions wait for it, so an element does not animate its own arrival.
|
|
82905
|
+
*/
|
|
82906
|
+
"helix-speed-dial-group": Partial<
|
|
82907
|
+
HelixSpeedDialGroupProps &
|
|
82908
|
+
HelixSpeedDialGroupSolidJsProps &
|
|
82909
|
+
BaseProps<HelixSpeedDialGroup> &
|
|
82910
|
+
BaseEvents<HelixSpeedDialGroup>
|
|
82911
|
+
>;
|
|
82912
|
+
|
|
81521
82913
|
/**
|
|
81522
82914
|
* Presentation only: a round mark the size of a small control, with the name on
|
|
81523
82915
|
* a chip beside it so it stays readable over whatever the dial floats over. The
|
|
@@ -81528,6 +82920,9 @@ export type CustomElementsSolidJs = {
|
|
|
81528
82920
|
* Component attributes and properties that can be applied to the element or by using JavaScript.
|
|
81529
82921
|
*
|
|
81530
82922
|
* - `disabled`: Whether the action is disabled, so it cannot be chosen.
|
|
82923
|
+
* - `shortcut`: The action's keyboard shortcut as a chord, such as `mod+s`, carried as
|
|
82924
|
+
* `aria-keyshortcuts` and drawn after the name. `mod` is Command on an Apple
|
|
82925
|
+
* keyboard and Control elsewhere. Showing a shortcut does not bind it.
|
|
81531
82926
|
* - `value`: The action's value, sent in `helix-select` when the action is chosen.
|
|
81532
82927
|
* - `active`: Whether the action has focus, which makes it the action the keyboard is on.
|
|
81533
82928
|
*
|
|
@@ -81568,6 +82963,7 @@ export type CustomElementsSolidJs = {
|
|
|
81568
82963
|
*
|
|
81569
82964
|
* - `(default)`: The action's name.
|
|
81570
82965
|
* - `icon`: The action's icon, the main way the action is recognized.
|
|
82966
|
+
* - `shortcut`: The action's keyboard shortcut, drawn after its name, such as a `Kbd`. It replaces the text drawn for `shortcut`, and is hidden from the name, which `aria-keyshortcuts` carries instead.
|
|
81571
82967
|
*
|
|
81572
82968
|
* ## Methods
|
|
81573
82969
|
*
|
|
@@ -81590,6 +82986,7 @@ export type CustomElementsSolidJs = {
|
|
|
81590
82986
|
* - `--speed-dial-label-background-color`: Fill of the chip holding the action's name.
|
|
81591
82987
|
* - `--speed-dial-label-color`: Color of the action's name.
|
|
81592
82988
|
* - `--speed-dial-label-font-size`: Size of the action's name.
|
|
82989
|
+
* - `--speed-dial-shortcut-color`: Color of the shortcut drawn after the action's name.
|
|
81593
82990
|
*
|
|
81594
82991
|
* ## CSS Parts
|
|
81595
82992
|
*
|
|
@@ -81598,6 +82995,7 @@ export type CustomElementsSolidJs = {
|
|
|
81598
82995
|
* - `icon`: The box that holds the icon.
|
|
81599
82996
|
* - `item`: The control for the action.
|
|
81600
82997
|
* - `label`: The action's name, beside the icon.
|
|
82998
|
+
* - `shortcut`: The box after the name that holds the shortcut, shown while `shortcut` is set or something is in the `shortcut` slot.
|
|
81601
82999
|
*
|
|
81602
83000
|
* ## CSS States
|
|
81603
83001
|
*
|
|
@@ -81641,7 +83039,17 @@ export type CustomElementsSolidJs = {
|
|
|
81641
83039
|
* last reader did rather than what the author wrote. `:state(open)` carries
|
|
81642
83040
|
* the resolved state for stylesheets, which is what the mirror is for.
|
|
81643
83041
|
* - `label`: Accessible name for the trigger and the set of actions it opens.
|
|
83042
|
+
* - `long-press-label`/`longPressLabel`: The description the trigger gives under `open-on="long-press"`, saying how
|
|
83043
|
+
* its actions are reached.
|
|
83044
|
+
*
|
|
83045
|
+
* A slotted trigger is described by the dial, which carries the words as
|
|
83046
|
+
* its own label for that: a Helix button's inner control at once, and a
|
|
83047
|
+
* plain element of yours once a reader reaches it, after hydration, unless
|
|
83048
|
+
* you described or labeled it yourself.
|
|
81644
83049
|
* - `offset`: Space between the trigger and the actions, in pixels.
|
|
83050
|
+
* - `open-on`/`openOn`: What opens the dial. `click` opens it on a press of the trigger. Under
|
|
83051
|
+
* `long-press`, a press is the trigger's own action, and the dial opens on a
|
|
83052
|
+
* press held for half a second, or on Alt+Down or Alt+Up.
|
|
81645
83053
|
* - `placement`: The direction the actions open in. They move to another side if that side
|
|
81646
83054
|
* does not fit.
|
|
81647
83055
|
*
|
|
@@ -81890,13 +83298,14 @@ export type CustomElementsSolidJs = {
|
|
|
81890
83298
|
* - `helix-before-resize`: Fired before the divider settles, and only when the gesture moved it. A press that moved nothing, a drag that came back, an arrow key with no room left, and a corner that moved only the other divider do not fire it. Cancelable: canceling it leaves the position to you and keeps the rest of the gesture, so a collapse the gesture reached still fires `helix-before-collapse`, which you can also cancel. A dragged divider stays where it was dropped until you set your own `position`.
|
|
81891
83299
|
* - `helix-collapse`: Fired after a pane shuts or reopens, with the side that is shut, or empty where both are open.
|
|
81892
83300
|
* - `helix-resized`: Fired after the divider settles somewhere new, with the new position.
|
|
81893
|
-
* - `input`: Fired each time
|
|
83301
|
+
* - `input`: Fired each time the divider moves, as a range input does: on each step of a drag, and before `helix-resized` for a key, a double click or a corner. Read `position` for where it is now.
|
|
81894
83302
|
*
|
|
81895
83303
|
* ## Slots
|
|
81896
83304
|
*
|
|
81897
83305
|
* Areas where markup can be added to the component.
|
|
81898
83306
|
*
|
|
81899
83307
|
* - `end`: The pane after the divider.
|
|
83308
|
+
* - `handle`: A mark drawn at the middle of the divider, such as a grip icon. It takes no focus and no pointer of its own: a press on it is a press on the divider.
|
|
81900
83309
|
* - `start`: The pane before the divider.
|
|
81901
83310
|
*
|
|
81902
83311
|
* ## Methods
|
|
@@ -81921,8 +83330,12 @@ export type CustomElementsSolidJs = {
|
|
|
81921
83330
|
* - `--splitter-drag-color`: Color of the line while it is being moved.
|
|
81922
83331
|
* - `--splitter-grip-color`: Color of the grip beside the line, when the grip is shown.
|
|
81923
83332
|
* - `--splitter-grip-length`: How far the grip runs along the divider.
|
|
83333
|
+
* - `--splitter-grip-thickness`: How thick the grip is, across the divider.
|
|
83334
|
+
* - `--splitter-handle-color`: Color of a mark slotted into `handle`.
|
|
81924
83335
|
* - `--splitter-hover-color`: Color of the divider's target under the pointer.
|
|
83336
|
+
* - `--splitter-hover-thickness`: How thick the line is under the pointer, with focus and while it moves.
|
|
81925
83337
|
* - `--splitter-target`: Width of the area you can drag.
|
|
83338
|
+
* - `--splitter-thickness`: How thick the line is at rest.
|
|
81926
83339
|
* - `--splitter-corner-at`: Where a nested splitter crosses this one, as a percentage.
|
|
81927
83340
|
* - `--splitter-position`: Where the divider sits, as a percentage of the box.
|
|
81928
83341
|
*
|
|
@@ -81939,7 +83352,9 @@ export type CustomElementsSolidJs = {
|
|
|
81939
83352
|
*
|
|
81940
83353
|
* These can be used to apply styling when a component is in a given state.
|
|
81941
83354
|
*
|
|
83355
|
+
* - `collapsed`: While a pane is shut. `data-collapsed` on the host says which.
|
|
81942
83356
|
* - `dragging`: While the pointer or a corner holds the divider.
|
|
83357
|
+
* - `vertical`: While the panes are one above the other, whether `orientation` says so or `auto` turned them.
|
|
81943
83358
|
* - `settled`: Set one frame after the first render. Transitions wait for it, so an element does not animate its own arrival.
|
|
81944
83359
|
*/
|
|
81945
83360
|
"helix-splitter": Partial<
|
|
@@ -82890,6 +84305,13 @@ export type CustomElementsSolidJs = {
|
|
|
82890
84305
|
* is set.
|
|
82891
84306
|
* - `default-sort`/`defaultSort`: The starting sort order, used until `sort` is set.
|
|
82892
84307
|
* - `descending-label`/`descendingLabel`: The word for a descending sort, in `sorted-label`.
|
|
84308
|
+
* - `grid`: Makes the table a grid: one tab stop, and the arrow keys, Home, End and the
|
|
84309
|
+
* Page keys move focus between its cells, the headings included. Enter moves
|
|
84310
|
+
* into a cell's controls, and Tab leaves the table.
|
|
84311
|
+
*
|
|
84312
|
+
* Off by default, where the table is a static `table` and Tab reaches each
|
|
84313
|
+
* link and control in it. On, the table writes a `tabindex` onto each of its
|
|
84314
|
+
* cells, which is the one way a cell of your markup can take focus.
|
|
82893
84315
|
* - `label`: Accessible name for the table.
|
|
82894
84316
|
*
|
|
82895
84317
|
* An `aria-label` or `aria-labelledby` on the host names the table too, and
|
|
@@ -82990,6 +84412,8 @@ export type CustomElementsSolidJs = {
|
|
|
82990
84412
|
* - `checkbox-mark-dash`: Added to `checkbox-mark` while it draws the dash, which it keeps until its box is checked.
|
|
82991
84413
|
* - `checkbox-mark-indeterminate`: Added to `checkbox-mark` while only some rows are selected.
|
|
82992
84414
|
* - `empty`: The text shown when there are no rows.
|
|
84415
|
+
* - `grid-end`: An empty box after the rows, in a `grid` table. Tab focuses it on its way out of the table, so the key leaves from the end.
|
|
84416
|
+
* - `grid-start`: An empty box before the rows, in a `grid` table. Shift with Tab focuses it on its way out of the table.
|
|
82993
84417
|
* - `head`: The row that holds the column headings. It has `display: contents`, so it takes no space of its own.
|
|
82994
84418
|
* - `loading`: The text shown while the rows are loading.
|
|
82995
84419
|
* - `select-all`: The heading that holds the checkbox that selects every row.
|
|
@@ -84729,12 +86153,18 @@ export type CustomElementsSolidJs = {
|
|
|
84729
86153
|
*
|
|
84730
86154
|
* CSS variables available for styling the component.
|
|
84731
86155
|
*
|
|
86156
|
+
* - `--time-picker-columns-gap`: The space between the wheels. None by default.
|
|
84732
86157
|
* - `--time-picker-feedback-color`: The color of the message under the times, while `feedback` is set.
|
|
86158
|
+
* - `--time-picker-hover-background-color`: Fill on a wheel's row under the pointer or the keyboard.
|
|
86159
|
+
* - `--time-picker-invalid-color`: The ring around the chosen time, or around the times while nothing is chosen, while the picker is invalid.
|
|
84733
86160
|
* - `--time-picker-list-block-size`: How tall the list is before it scrolls.
|
|
86161
|
+
* - `--time-picker-mark-radius`: The corners of the mark on a wheel's row.
|
|
84734
86162
|
* - `--time-picker-range-color`: Fill behind the times inside a range.
|
|
84735
86163
|
* - `--time-picker-row-size`: Height and minimum width of one row in a wheel.
|
|
84736
86164
|
* - `--time-picker-selected-color`: Fill on the chosen row of a wheel.
|
|
86165
|
+
* - `--time-picker-selected-foreground-color`: Ink on the chosen row of a wheel.
|
|
84737
86166
|
* - `--time-picker-wheel-block-size`: How tall a wheel is. Five rows by default.
|
|
86167
|
+
* - `--time-picker-wheel-mask`: The mask that fades a wheel toward its ends, as a `mask-image`. Set `none` for no fade.
|
|
84738
86168
|
*
|
|
84739
86169
|
* ## CSS Parts
|
|
84740
86170
|
*
|
|
@@ -84781,6 +86211,7 @@ export type CustomElementsSolidJs = {
|
|
|
84781
86211
|
*
|
|
84782
86212
|
* These can be used to apply styling when a component is in a given state.
|
|
84783
86213
|
*
|
|
86214
|
+
* - `blank`: While no time is chosen.
|
|
84784
86215
|
* - `invalid`: While `invalid` is set or `feedback` says what is wrong.
|
|
84785
86216
|
* - `settled`: Set one frame after the first render. Transitions wait for it, so an element does not animate its own arrival.
|
|
84786
86217
|
*/
|
|
@@ -85093,10 +86524,19 @@ export type CustomElementsSolidJs = {
|
|
|
85093
86524
|
*
|
|
85094
86525
|
* CSS variables available for styling the component.
|
|
85095
86526
|
*
|
|
86527
|
+
* - `--toast-background-color`: The panel's color. Follows `--helix-color-surface-overlay`.
|
|
85096
86528
|
* - `--toast-border-color`: Color of the panel's edge.
|
|
85097
86529
|
* - `--toast-border-width`: Width of the panel's edge. Follows `--helix-border-floating`, which is `0`, so the panel stands out by its shadow unless your theme sets a border.
|
|
86530
|
+
* - `--toast-color`: Color of the message's text.
|
|
86531
|
+
* - `--toast-description-color`: Color of the line in the `description` slot, under the heading.
|
|
86532
|
+
* - `--toast-dismiss-color`: Color of the dismiss control's mark at rest.
|
|
86533
|
+
* - `--toast-font-size`: Size of the message's text. The first line's controls and mark stay centered on it.
|
|
86534
|
+
* - `--toast-heading-weight`: Weight of the heading in the `heading` slot.
|
|
85098
86535
|
* - `--toast-item-padding`: Space between the message's edge and its contents.
|
|
86536
|
+
* - `--toast-radius`: Rounding of the panel's corners.
|
|
85099
86537
|
* - `--toast-shadow`: Shadow under the panel. Follows `--helix-shadow-floating`. A floating surface can sit over any content, so it has a shadow by default.
|
|
86538
|
+
* - `--toast-timer-size`: Thickness of the bar that counts down a timed message.
|
|
86539
|
+
* - `--toast-tone-color`: Color of the mark and the countdown bar. Unset, each `tone` takes its own color, so set it per tone, as in `helix-toast-item[tone="danger"]`.
|
|
85100
86540
|
* - `--toast-duration`: How long this message stays, in milliseconds, for a progress hint.
|
|
85101
86541
|
* - `--toast-swipe-x`: How far a swipe has moved the message across, in pixels, toward the right.
|
|
85102
86542
|
*
|
|
@@ -85637,10 +87077,16 @@ export type CustomElementsSolidJs = {
|
|
|
85637
87077
|
* The toolbar draws no frame of its own, so it does not add a second frame
|
|
85638
87078
|
* inside whatever already frames the bar.
|
|
85639
87079
|
*
|
|
87080
|
+
* Its controls are the small size, since a toolbar is dense by nature, and a
|
|
87081
|
+
* control added later takes it without being told. `size="md"` or `"lg"`
|
|
87082
|
+
* makes every control in it larger together.
|
|
87083
|
+
*
|
|
85640
87084
|
* ## Attributes & Properties
|
|
85641
87085
|
*
|
|
85642
87086
|
* Component attributes and properties that can be applied to the element or by using JavaScript.
|
|
85643
87087
|
*
|
|
87088
|
+
* - `size`: The size of every control in the toolbar: their height, icons, boxes and
|
|
87089
|
+
* tags. Unset is the small size, as a toolbar is dense by nature.
|
|
85644
87090
|
* - `label`: The toolbar's name, read by screen readers.
|
|
85645
87091
|
*
|
|
85646
87092
|
* An `aria-label` or `aria-labelledby` on the host names the toolbar too,
|
|
@@ -85698,6 +87144,9 @@ export type CustomElementsSolidJs = {
|
|
|
85698
87144
|
*
|
|
85699
87145
|
* These can be used to apply styling when a component is in a given state.
|
|
85700
87146
|
*
|
|
87147
|
+
* - `horizontal`: The controls run along a row, which is the default.
|
|
87148
|
+
* - `nested`: The toolbar is a group inside another toolbar, which owns the keys and the tab stop.
|
|
87149
|
+
* - `vertical`: The controls run down a column, under `orientation="vertical"`.
|
|
85701
87150
|
* - `settled`: Set one frame after the first render. Transitions wait for it, so an element does not animate its own arrival.
|
|
85702
87151
|
*/
|
|
85703
87152
|
"helix-toolbar": Partial<
|
|
@@ -87461,6 +88910,14 @@ export type CustomElementsSolidJs = {
|
|
|
87461
88910
|
*
|
|
87462
88911
|
* These can be used to apply styling when a component is in a given state.
|
|
87463
88912
|
*
|
|
88913
|
+
* - `ended`: Playback reached the end, until it starts again or the source changes.
|
|
88914
|
+
* - `error`: The source could not be played, and `failure` shows.
|
|
88915
|
+
* - `fullscreen`: The player fills the screen.
|
|
88916
|
+
* - `idle`: The video plays and the user has been still for `idle-delay`, so the bar hides.
|
|
88917
|
+
* - `muted`: The sound is off.
|
|
88918
|
+
* - `paused`: Playback is paused, which is where every player starts.
|
|
88919
|
+
* - `playing`: Playback runs, waiting for data included.
|
|
88920
|
+
* - `waiting`: Playback stopped to wait for more data, and `loading` shows.
|
|
87464
88921
|
* - `settled`: Set one frame after the first render. Transitions wait for it, so an element does not animate its own arrival.
|
|
87465
88922
|
*/
|
|
87466
88923
|
"helix-video": Partial<
|
|
@@ -87750,6 +89207,10 @@ export type CustomCssProperties = {
|
|
|
87750
89207
|
"--chart-bar-wash"?: (string) | undefined;
|
|
87751
89208
|
/** The color of the attribution. */
|
|
87752
89209
|
"--blockquote-attribution-color"?: (string) | undefined;
|
|
89210
|
+
/** The typeface of the attribution, the page's by default. */
|
|
89211
|
+
"--blockquote-attribution-font-family"?: (string) | undefined;
|
|
89212
|
+
/** The weight of the attribution, the page's by default. */
|
|
89213
|
+
"--blockquote-attribution-font-weight"?: (string) | undefined;
|
|
87753
89214
|
/** The font size of the attribution. */
|
|
87754
89215
|
"--blockquote-attribution-size"?: (string) | undefined;
|
|
87755
89216
|
/** The color of the quoted passage. */
|
|
@@ -87760,8 +89221,14 @@ export type CustomCssProperties = {
|
|
|
87760
89221
|
"--blockquote-font-weight"?: (string) | undefined;
|
|
87761
89222
|
/** The space between the passage and its attribution. */
|
|
87762
89223
|
"--blockquote-gap"?: (string) | undefined;
|
|
89224
|
+
/** The letter spacing of the quoted passage, the tight tracking by default. */
|
|
89225
|
+
"--blockquote-letter-spacing"?: (string) | undefined;
|
|
87763
89226
|
/** The line height of the quoted passage, the tight leading by default. */
|
|
87764
89227
|
"--blockquote-line-height"?: (string) | undefined;
|
|
89228
|
+
/** The color of the mark `marks` draws, the subtle foreground by default. */
|
|
89229
|
+
"--blockquote-mark-color"?: (string) | undefined;
|
|
89230
|
+
/** The font size of the mark `marks` draws. */
|
|
89231
|
+
"--blockquote-mark-size"?: (string) | undefined;
|
|
87765
89232
|
/** The font size of the quoted passage. */
|
|
87766
89233
|
"--blockquote-size"?: (string) | undefined;
|
|
87767
89234
|
/** Inline padding of a control slotted into a crumb, matching the steps either side of it. */
|
|
@@ -87790,6 +89257,14 @@ export type CustomCssProperties = {
|
|
|
87790
89257
|
"--breadcrumbs-split-fill"?: (string) | undefined;
|
|
87791
89258
|
/** Space between the buttons, when `spaced`. */
|
|
87792
89259
|
"--button-group-gap"?: (string) | undefined;
|
|
89260
|
+
/** Fill behind a pressed button, in a selection mode. Defaults to the foreground color. */
|
|
89261
|
+
"--button-group-pressed-background-color"?: (string) | undefined;
|
|
89262
|
+
/** Edge of a pressed button, in a selection mode. Defaults to its fill. */
|
|
89263
|
+
"--button-group-pressed-border-color"?: (string) | undefined;
|
|
89264
|
+
/** Words and icons of a pressed button, in a selection mode. Defaults to the background color. */
|
|
89265
|
+
"--button-group-pressed-color"?: (string) | undefined;
|
|
89266
|
+
/** Written on the control inside each toggle button of a group with `selection-mode`: `1` while it is pressed and `0` while it is not. Read it in a `::part(button)` rule to draw the pressed look. */
|
|
89267
|
+
"--button-group-pressed"?: (string) | undefined;
|
|
87793
89268
|
/** Fill behind the button, in every state. */
|
|
87794
89269
|
"--button-background-color"?: (string) | undefined;
|
|
87795
89270
|
/** Fill behind the button under the pointer. Without it, `--button-background-color` also applies on hover. */
|
|
@@ -87854,8 +89329,12 @@ export type CustomCssProperties = {
|
|
|
87854
89329
|
"--canvas-node-background-color"?: (string) | undefined;
|
|
87855
89330
|
/** A color for the card that carries no meaning, such as a hex color from a document. Use it when no tone fits. */
|
|
87856
89331
|
"--canvas-node-color"?: (string) | undefined;
|
|
89332
|
+
/** The size of the card's text. */
|
|
89333
|
+
"--canvas-node-font-size"?: (string) | undefined;
|
|
87857
89334
|
/** The space between the card's edge and its content. */
|
|
87858
89335
|
"--canvas-node-padding"?: (string) | undefined;
|
|
89336
|
+
/** The card's corners. A `shape` draws its own. */
|
|
89337
|
+
"--canvas-node-radius"?: (string) | undefined;
|
|
87859
89338
|
/** The shadow under the card, set by `separation="elevated"`. */
|
|
87860
89339
|
"--canvas-node-shadow"?: (string) | undefined;
|
|
87861
89340
|
/** The background behind the board. */
|
|
@@ -87864,14 +89343,26 @@ export type CustomCssProperties = {
|
|
|
87864
89343
|
"--canvas-block-size"?: (string) | undefined;
|
|
87865
89344
|
/** The color of the frame's edge. */
|
|
87866
89345
|
"--canvas-border-color"?: (string) | undefined;
|
|
89346
|
+
/** The color of a connection being drawn, and of the card it will arrive at and that card's points. */
|
|
89347
|
+
"--canvas-connect-color"?: (string) | undefined;
|
|
87867
89348
|
/** The color of a connection with no tone. Set it in one edge's `style` to color only that edge. */
|
|
87868
89349
|
"--canvas-edge-color"?: (string) | undefined;
|
|
87869
89350
|
/** The width of the area a pointer can press on a connection, which is wider than the drawn line. */
|
|
87870
89351
|
"--canvas-edge-target-width"?: (string) | undefined;
|
|
89352
|
+
/** The width of a connection's line. A selected or focused connection is drawn at twice it. */
|
|
89353
|
+
"--canvas-edge-width"?: (string) | undefined;
|
|
87871
89354
|
/** The spacing of the grid lines or dots, in the document's units, so it scales with the zoom. */
|
|
87872
89355
|
"--canvas-grid-size"?: (string) | undefined;
|
|
89356
|
+
/** The color of the label on a connection. */
|
|
89357
|
+
"--canvas-label-color"?: (string) | undefined;
|
|
87873
89358
|
/** The width of the field for editing a label. */
|
|
87874
89359
|
"--canvas-label-editor-inline-size"?: (string) | undefined;
|
|
89360
|
+
/** The size of the label on a connection. */
|
|
89361
|
+
"--canvas-label-font-size"?: (string) | undefined;
|
|
89362
|
+
/** The frame's corners. */
|
|
89363
|
+
"--canvas-radius"?: (string) | undefined;
|
|
89364
|
+
/** The color of what is selected: a card's outline, its corners and its move handle, a connection and its ends, and the box drawn to select. */
|
|
89365
|
+
"--canvas-selected-color"?: (string) | undefined;
|
|
87875
89366
|
/** The background of the pan and zoom buttons. `Map` uses the same property. */
|
|
87876
89367
|
"--viewport-control-background-color"?: (string) | undefined;
|
|
87877
89368
|
/** How the regions pack when the card is stretched taller than its content. `start` by default, so the slack is at the bottom; `space-between` puts a footer on the floor. */
|
|
@@ -87884,10 +89375,18 @@ export type CustomCssProperties = {
|
|
|
87884
89375
|
"--card-border-color"?: (string) | undefined;
|
|
87885
89376
|
/** Width of the surface's edge. Follows `--helix-border-surface`, which is a hairline unless your theme sets another width. The edge is what sets the surface apart. */
|
|
87886
89377
|
"--card-border-width"?: (string) | undefined;
|
|
89378
|
+
/** Color of the card's text. Muted by default, so the header reads as the card's own voice. */
|
|
89379
|
+
"--card-color"?: (string) | undefined;
|
|
87887
89380
|
/** Space between the regions, and between a header or footer and its actions. */
|
|
87888
89381
|
"--card-gap"?: (string) | undefined;
|
|
89382
|
+
/** Color of the header, and of a `Text` heading anywhere in the card. The foreground by default. */
|
|
89383
|
+
"--card-heading-color"?: (string) | undefined;
|
|
89384
|
+
/** Line height of the card's text. The normal leading by default. */
|
|
89385
|
+
"--card-line-height"?: (string) | undefined;
|
|
87889
89386
|
/** Height of the media region. Defaults to `auto`, which follows an image's own proportions. A chart has no height of its own, so set one here for a chart. */
|
|
87890
89387
|
"--card-media-block-size"?: (string) | undefined;
|
|
89388
|
+
/** How a slotted picture fills the media region, as `object-fit`. `cover` by default; `contain` shows all of a logo or a screenshot. */
|
|
89389
|
+
"--card-media-fit"?: (string) | undefined;
|
|
87891
89390
|
/** Width of the media column when horizontal. */
|
|
87892
89391
|
"--card-media-size"?: (string) | undefined;
|
|
87893
89392
|
/** Inset applied to each region. */
|
|
@@ -87974,22 +89473,36 @@ export type CustomCssProperties = {
|
|
|
87974
89473
|
"--checkbox-mark-color"?: (string) | undefined;
|
|
87975
89474
|
/** The width and height of the box. */
|
|
87976
89475
|
"--checkbox-size"?: (string) | undefined;
|
|
89476
|
+
/** The color a diff's added lines are tinted in and their `+` is drawn in. The success color by default. */
|
|
89477
|
+
"--code-block-added-color"?: (string) | undefined;
|
|
87977
89478
|
/** A backdrop filter for the block and its header, for a translucent background. */
|
|
87978
89479
|
"--code-block-backdrop"?: (string) | undefined;
|
|
87979
89480
|
/** The background behind the code. Set it for a block that sits on a surface other than the page background. */
|
|
87980
89481
|
"--code-block-background-color"?: (string) | undefined;
|
|
87981
89482
|
/** The line around the block and its header. */
|
|
87982
89483
|
"--code-block-border-color"?: (string) | undefined;
|
|
89484
|
+
/** The color of the code. A highlighter's own colors win on the tokens it colors. */
|
|
89485
|
+
"--code-block-color"?: (string) | undefined;
|
|
87983
89486
|
/** The color of the button under a capped block that shows every line. */
|
|
87984
89487
|
"--code-block-expand-color"?: (string) | undefined;
|
|
89488
|
+
/** The typeface of the code and its line numbers. The mono face by default. */
|
|
89489
|
+
"--code-block-font-family"?: (string) | undefined;
|
|
89490
|
+
/** The size of the code and its line numbers. */
|
|
89491
|
+
"--code-block-font-size"?: (string) | undefined;
|
|
87985
89492
|
/** The color of the line numbers. */
|
|
87986
89493
|
"--code-block-gutter-color"?: (string) | undefined;
|
|
87987
89494
|
/** The background behind the name. The default is `surface-raised`. */
|
|
87988
89495
|
"--code-block-header-background-color"?: (string) | undefined;
|
|
89496
|
+
/** The color of the name in the header. */
|
|
89497
|
+
"--code-block-label-color"?: (string) | undefined;
|
|
89498
|
+
/** The line height of the code and its line numbers, as a number or a length. */
|
|
89499
|
+
"--code-block-line-height"?: (string) | undefined;
|
|
87989
89500
|
/** The tallest the code grows before it scrolls, or until `expandable`'s button shows every line. The default is no limit. */
|
|
87990
89501
|
"--code-block-max-block-size"?: (string) | undefined;
|
|
87991
89502
|
/** The corner radius of the header's top and the block's bottom, which form one shape. */
|
|
87992
89503
|
"--code-block-radius"?: (string) | undefined;
|
|
89504
|
+
/** The color a diff's removed lines are tinted in and their `-` is drawn in. The danger color by default. */
|
|
89505
|
+
"--code-block-removed-color"?: (string) | undefined;
|
|
87993
89506
|
/** Fill behind the fragment. Defaults to the foreground color at 6%, which looks the same on a light page and a dark one. */
|
|
87994
89507
|
"--code-background-color"?: (string) | undefined;
|
|
87995
89508
|
/** The fragment's typeface. Defaults to the mono face. */
|
|
@@ -88182,6 +89695,8 @@ export type CustomCssProperties = {
|
|
|
88182
89695
|
"--date-picker-column-count"?: (string) | undefined;
|
|
88183
89696
|
/** The space between the value and the controls in `actions`. */
|
|
88184
89697
|
"--description-list-actions-gap"?: (string) | undefined;
|
|
89698
|
+
/** How a label and its value line up beside each other, as `align-items`. Defaults to `baseline`; `center` suits a value taller than a line, such as an avatar. */
|
|
89699
|
+
"--description-list-item-align"?: (string) | undefined;
|
|
88185
89700
|
/** The space between a label and its value when the label sits over it. */
|
|
88186
89701
|
"--description-list-item-gap"?: (string) | undefined;
|
|
88187
89702
|
/** The color of a label. */
|
|
@@ -88194,8 +89709,14 @@ export type CustomCssProperties = {
|
|
|
88194
89709
|
"--description-list-value-color"?: (string) | undefined;
|
|
88195
89710
|
/** The space between the column of labels and the column of values, with `direction="row"`. */
|
|
88196
89711
|
"--description-list-column-gap"?: (string) | undefined;
|
|
89712
|
+
/** The color of the rule between pairs, with `divided`. */
|
|
89713
|
+
"--description-list-divider-color"?: (string) | undefined;
|
|
89714
|
+
/** The thickness of the rule between pairs, with `divided`. */
|
|
89715
|
+
"--description-list-divider-width"?: (string) | undefined;
|
|
88197
89716
|
/** Space between one pair and the next. The default is smaller with `direction="row"` than when stacked. Setting this property replaces both defaults. */
|
|
88198
89717
|
"--description-list-gap"?: (string) | undefined;
|
|
89718
|
+
/** The width of the column of labels, with `direction="row"`. Defaults to the width of the longest label; set a length such as `10rem` to line up several lists. */
|
|
89719
|
+
"--description-list-label-width"?: (string) | undefined;
|
|
88199
89720
|
/** The panel's fill. Follows `--helix-color-surface-overlay`. */
|
|
88200
89721
|
"--dialog-background-color"?: (string) | undefined;
|
|
88201
89722
|
/** Color of the panel's edge. */
|
|
@@ -88222,6 +89743,12 @@ export type CustomCssProperties = {
|
|
|
88222
89743
|
"--divider-color"?: (string) | undefined;
|
|
88223
89744
|
/** The color of the content set into the line. */
|
|
88224
89745
|
"--divider-content-color"?: (string) | undefined;
|
|
89746
|
+
/** The typeface of the content set into the line. The sans face by default. */
|
|
89747
|
+
"--divider-content-font-family"?: (string) | undefined;
|
|
89748
|
+
/** The size of the content set into the line. The `xs` step by default. */
|
|
89749
|
+
"--divider-content-font-size"?: (string) | undefined;
|
|
89750
|
+
/** The weight of the content set into the line. The weight around the divider by default. */
|
|
89751
|
+
"--divider-content-font-weight"?: (string) | undefined;
|
|
88225
89752
|
/** The space either side of the content set into the line. */
|
|
88226
89753
|
"--divider-content-gap"?: (string) | undefined;
|
|
88227
89754
|
/** The length of line before the content under `content-placement="start"`, or after it under `end`. */
|
|
@@ -88626,6 +90153,8 @@ export type CustomCssProperties = {
|
|
|
88626
90153
|
"--listbox-background-color"?: (string) | undefined;
|
|
88627
90154
|
/** The panel's border, as a shorthand. Set it to `none` when the list is already inside a panel. */
|
|
88628
90155
|
"--listbox-border"?: (string) | undefined;
|
|
90156
|
+
/** How narrow a column may be with `layout="grid"`. As many columns as fit are drawn. Defaults to `8rem`. */
|
|
90157
|
+
"--listbox-column-min-inline-size"?: (string) | undefined;
|
|
88629
90158
|
/** The color of the line shown while `load-error` is set. */
|
|
88630
90159
|
"--listbox-error-color"?: (string) | undefined;
|
|
88631
90160
|
/** Maximum height of the list before it scrolls. */
|
|
@@ -88676,12 +90205,32 @@ export type CustomCssProperties = {
|
|
|
88676
90205
|
"--map-position-fill"?: (string) | undefined;
|
|
88677
90206
|
/** The point's width. */
|
|
88678
90207
|
"--map-position-size"?: (string) | undefined;
|
|
90208
|
+
/** The rule above the map credit, under the map. */
|
|
90209
|
+
"--map-attribution-border-color"?: (string) | undefined;
|
|
90210
|
+
/** The color of the map credit. */
|
|
90211
|
+
"--map-attribution-color"?: (string) | undefined;
|
|
90212
|
+
/** The size of the map credit's text. */
|
|
90213
|
+
"--map-attribution-font-size"?: (string) | undefined;
|
|
88679
90214
|
/** The color behind the map while tiles load. */
|
|
88680
90215
|
"--map-background-color"?: (string) | undefined;
|
|
88681
90216
|
/** The frame's height, as a length. Ignored with `fill`, where the container decides it. */
|
|
88682
90217
|
"--map-block-size"?: (string) | undefined;
|
|
88683
90218
|
/** The frame's border color. */
|
|
88684
90219
|
"--map-border-color"?: (string) | undefined;
|
|
90220
|
+
/** The fill of the pressed 3D button and the ring around the chosen map type and each shown layer in the layers menu. */
|
|
90221
|
+
"--map-chosen-color"?: (string) | undefined;
|
|
90222
|
+
/** The space between the map types and the layers in the layers menu. */
|
|
90223
|
+
"--map-layers-menu-gap"?: (string) | undefined;
|
|
90224
|
+
/** The width of the layers menu. */
|
|
90225
|
+
"--map-layers-menu-inline-size"?: (string) | undefined;
|
|
90226
|
+
/** The space inside the edge of the layers menu. */
|
|
90227
|
+
"--map-layers-menu-padding"?: (string) | undefined;
|
|
90228
|
+
/** The north half of the compass needle. */
|
|
90229
|
+
"--map-needle-north-color"?: (string) | undefined;
|
|
90230
|
+
/** The south half of the compass needle. */
|
|
90231
|
+
"--map-needle-south-color"?: (string) | undefined;
|
|
90232
|
+
/** The frame's corners. */
|
|
90233
|
+
"--map-radius"?: (string) | undefined;
|
|
88685
90234
|
/** How far the needle turns to point north, as an angle. The frame writes it from `bearing`. */
|
|
88686
90235
|
"--map-needle-turn"?: (string) | undefined;
|
|
88687
90236
|
/** The color of the casing under the route. */
|
|
@@ -88858,6 +90407,8 @@ export type CustomCssProperties = {
|
|
|
88858
90407
|
"--notifications-unread-offset"?: (string) | undefined;
|
|
88859
90408
|
/** Corner radius of the unread mark, which can turn it into a dot. */
|
|
88860
90409
|
"--notifications-unread-radius"?: (string) | undefined;
|
|
90410
|
+
/** The color of the `error` line. */
|
|
90411
|
+
"--notifications-error-color"?: (string) | undefined;
|
|
88861
90412
|
/** How tall the feed may get before the list scrolls. */
|
|
88862
90413
|
"--notifications-max-block-size"?: (string) | undefined;
|
|
88863
90414
|
/** Width of the media column that every item keeps when any item in the feed has media. */
|
|
@@ -88948,14 +90499,46 @@ export type CustomCssProperties = {
|
|
|
88948
90499
|
"--outline-rail"?: (string) | undefined;
|
|
88949
90500
|
/** The color of the line down the leading edge. */
|
|
88950
90501
|
"--outline-rule-color"?: (string) | undefined;
|
|
90502
|
+
/** Edge of the page you are on. */
|
|
90503
|
+
"--pagination-current-border-color"?: (string) | undefined;
|
|
88951
90504
|
/** Fill behind the page you are on. */
|
|
88952
90505
|
"--pagination-current-color"?: (string) | undefined;
|
|
90506
|
+
/** Weight of the number of the page you are on. */
|
|
90507
|
+
"--pagination-current-font-weight"?: (string) | undefined;
|
|
90508
|
+
/** Color of the number of the page you are on. */
|
|
90509
|
+
"--pagination-current-foreground-color"?: (string) | undefined;
|
|
90510
|
+
/** Color of a first, previous, next or last control with nowhere to go. */
|
|
90511
|
+
"--pagination-disabled-foreground-color"?: (string) | undefined;
|
|
90512
|
+
/** How faint a control with nowhere to go is drawn. */
|
|
90513
|
+
"--pagination-disabled-opacity"?: (string) | undefined;
|
|
90514
|
+
/** Color of the control that stands in for hidden pages. */
|
|
90515
|
+
"--pagination-ellipsis-foreground-color"?: (string) | undefined;
|
|
90516
|
+
/** Size of the numbers and the status text. */
|
|
90517
|
+
"--pagination-font-size"?: (string) | undefined;
|
|
90518
|
+
/** Weight of the numbers and the status text. */
|
|
90519
|
+
"--pagination-font-weight"?: (string) | undefined;
|
|
90520
|
+
/** Color of the numbers and the marks on every control. */
|
|
90521
|
+
"--pagination-foreground-color"?: (string) | undefined;
|
|
88953
90522
|
/** Space between one control and the next. */
|
|
88954
90523
|
"--pagination-gap"?: (string) | undefined;
|
|
88955
90524
|
/** Fill behind a control under the pointer. */
|
|
88956
90525
|
"--pagination-hover-color"?: (string) | undefined;
|
|
90526
|
+
/** Color of a control's number or mark under the pointer. */
|
|
90527
|
+
"--pagination-hover-foreground-color"?: (string) | undefined;
|
|
90528
|
+
/** Size of the mark on a first, previous, next or last control, drawn or slotted. */
|
|
90529
|
+
"--pagination-icon-size"?: (string) | undefined;
|
|
90530
|
+
/** Space either side of a control's number or mark. */
|
|
90531
|
+
"--pagination-padding"?: (string) | undefined;
|
|
90532
|
+
/** Corner radius of every control in the row. */
|
|
90533
|
+
"--pagination-radius"?: (string) | undefined;
|
|
88957
90534
|
/** The box every control in the row takes. */
|
|
88958
90535
|
"--pagination-size"?: (string) | undefined;
|
|
90536
|
+
/** Color of the text that says which page you are on, in `compact`. */
|
|
90537
|
+
"--pagination-status-foreground-color"?: (string) | undefined;
|
|
90538
|
+
/** Space between the label and the select. */
|
|
90539
|
+
"--pagination-size-gap"?: (string) | undefined;
|
|
90540
|
+
/** Color of the text. */
|
|
90541
|
+
"--pagination-summary-foreground-color"?: (string) | undefined;
|
|
88959
90542
|
/** The color of the caret drawn in an empty box. Without it, the character color applies. */
|
|
88960
90543
|
"--pin-input-caret-color"?: (string) | undefined;
|
|
88961
90544
|
/** Fill behind each box. */
|
|
@@ -89024,12 +90607,18 @@ export type CustomCssProperties = {
|
|
|
89024
90607
|
"--qr-code-background-color"?: (string) | undefined;
|
|
89025
90608
|
/** Color of the dark modules. Defaults to the dark media ink, which is the same in both color schemes so the code scans. */
|
|
89026
90609
|
"--qr-code-color"?: (string) | undefined;
|
|
90610
|
+
/** The space around the fallback inside the square. */
|
|
90611
|
+
"--qr-code-fallback-padding"?: (string) | undefined;
|
|
89027
90612
|
/** Color of the three corner squares. Defaults to the color of the modules. */
|
|
89028
90613
|
"--qr-code-finder-color"?: (string) | undefined;
|
|
89029
90614
|
/** The clear space around the center logo. */
|
|
89030
90615
|
"--qr-code-logo-padding"?: (string) | undefined;
|
|
90616
|
+
/** The corner radius of the logo's box. */
|
|
90617
|
+
"--qr-code-logo-radius"?: (string) | undefined;
|
|
89031
90618
|
/** How much of the center a logo can cover. Defaults to `27%`, which `H` correction allows, because it can lose thirty percent. */
|
|
89032
90619
|
"--qr-code-logo-size"?: (string) | undefined;
|
|
90620
|
+
/** The corner radius of the square. */
|
|
90621
|
+
"--qr-code-radius"?: (string) | undefined;
|
|
89033
90622
|
/** How wide the square is. Defaults to `12rem`. */
|
|
89034
90623
|
"--qr-code-size"?: (string) | undefined;
|
|
89035
90624
|
/** Color of the quoted text. */
|
|
@@ -89274,6 +90863,10 @@ export type CustomCssProperties = {
|
|
|
89274
90863
|
"--sparkline-readout-font-size"?: (string) | undefined;
|
|
89275
90864
|
/** Thickness of the line, overriding `weight`. */
|
|
89276
90865
|
"--sparkline-width"?: (string) | undefined;
|
|
90866
|
+
/** Color of the group's name. */
|
|
90867
|
+
"--speed-dial-group-label-color"?: (string) | undefined;
|
|
90868
|
+
/** Size of the group's name. */
|
|
90869
|
+
"--speed-dial-group-label-font-size"?: (string) | undefined;
|
|
89277
90870
|
/** Fill of the round icon. */
|
|
89278
90871
|
"--speed-dial-item-background-color"?: (string) | undefined;
|
|
89279
90872
|
/** Color of the icon. */
|
|
@@ -89290,6 +90883,8 @@ export type CustomCssProperties = {
|
|
|
89290
90883
|
"--speed-dial-label-color"?: (string) | undefined;
|
|
89291
90884
|
/** Size of the action's name. */
|
|
89292
90885
|
"--speed-dial-label-font-size"?: (string) | undefined;
|
|
90886
|
+
/** Color of the shortcut drawn after the action's name. */
|
|
90887
|
+
"--speed-dial-shortcut-color"?: (string) | undefined;
|
|
89293
90888
|
/** Fill of the trigger the dial draws when none is slotted. */
|
|
89294
90889
|
"--speed-dial-background-color"?: (string) | undefined;
|
|
89295
90890
|
/** Color of that trigger's icon. */
|
|
@@ -89314,10 +90909,18 @@ export type CustomCssProperties = {
|
|
|
89314
90909
|
"--splitter-grip-color"?: (string) | undefined;
|
|
89315
90910
|
/** How far the grip runs along the divider. */
|
|
89316
90911
|
"--splitter-grip-length"?: (string) | undefined;
|
|
90912
|
+
/** How thick the grip is, across the divider. */
|
|
90913
|
+
"--splitter-grip-thickness"?: (string) | undefined;
|
|
90914
|
+
/** Color of a mark slotted into `handle`. */
|
|
90915
|
+
"--splitter-handle-color"?: (string) | undefined;
|
|
89317
90916
|
/** Color of the divider's target under the pointer. */
|
|
89318
90917
|
"--splitter-hover-color"?: (string) | undefined;
|
|
90918
|
+
/** How thick the line is under the pointer, with focus and while it moves. */
|
|
90919
|
+
"--splitter-hover-thickness"?: (string) | undefined;
|
|
89319
90920
|
/** Width of the area you can drag. */
|
|
89320
90921
|
"--splitter-target"?: (string) | undefined;
|
|
90922
|
+
/** How thick the line is at rest. */
|
|
90923
|
+
"--splitter-thickness"?: (string) | undefined;
|
|
89321
90924
|
/** Where a nested splitter crosses this one, as a percentage. */
|
|
89322
90925
|
"--splitter-corner-at"?: (string) | undefined;
|
|
89323
90926
|
/** Where the divider sits, as a percentage of the box. */
|
|
@@ -89472,18 +91075,30 @@ export type CustomCssProperties = {
|
|
|
89472
91075
|
"--time-input-segment-placeholder-color"?: (string) | undefined;
|
|
89473
91076
|
/** Shadow under the panel. Defaults to `--helix-shadow-floating`, because the panel can sit over any content. */
|
|
89474
91077
|
"--time-input-shadow"?: (string) | undefined;
|
|
91078
|
+
/** The space between the wheels. None by default. */
|
|
91079
|
+
"--time-picker-columns-gap"?: (string) | undefined;
|
|
89475
91080
|
/** The color of the message under the times, while `feedback` is set. */
|
|
89476
91081
|
"--time-picker-feedback-color"?: (string) | undefined;
|
|
91082
|
+
/** Fill on a wheel's row under the pointer or the keyboard. */
|
|
91083
|
+
"--time-picker-hover-background-color"?: (string) | undefined;
|
|
91084
|
+
/** The ring around the chosen time, or around the times while nothing is chosen, while the picker is invalid. */
|
|
91085
|
+
"--time-picker-invalid-color"?: (string) | undefined;
|
|
89477
91086
|
/** How tall the list is before it scrolls. */
|
|
89478
91087
|
"--time-picker-list-block-size"?: (string) | undefined;
|
|
91088
|
+
/** The corners of the mark on a wheel's row. */
|
|
91089
|
+
"--time-picker-mark-radius"?: (string) | undefined;
|
|
89479
91090
|
/** Fill behind the times inside a range. */
|
|
89480
91091
|
"--time-picker-range-color"?: (string) | undefined;
|
|
89481
91092
|
/** Height and minimum width of one row in a wheel. */
|
|
89482
91093
|
"--time-picker-row-size"?: (string) | undefined;
|
|
89483
91094
|
/** Fill on the chosen row of a wheel. */
|
|
89484
91095
|
"--time-picker-selected-color"?: (string) | undefined;
|
|
91096
|
+
/** Ink on the chosen row of a wheel. */
|
|
91097
|
+
"--time-picker-selected-foreground-color"?: (string) | undefined;
|
|
89485
91098
|
/** How tall a wheel is. Five rows by default. */
|
|
89486
91099
|
"--time-picker-wheel-block-size"?: (string) | undefined;
|
|
91100
|
+
/** The mask that fades a wheel toward its ends, as a `mask-image`. Set `none` for no fade. */
|
|
91101
|
+
"--time-picker-wheel-mask"?: (string) | undefined;
|
|
89487
91102
|
/** The color of the heading. */
|
|
89488
91103
|
"--timeline-group-heading-color"?: (string) | undefined;
|
|
89489
91104
|
/** How round the mark is. Zero is a square, and half its size is a disc. */
|
|
@@ -89494,14 +91109,32 @@ export type CustomCssProperties = {
|
|
|
89494
91109
|
"--timeline-rail-size"?: (string) | undefined;
|
|
89495
91110
|
/** Space between one entry and the next. */
|
|
89496
91111
|
"--timeline-gap"?: (string) | undefined;
|
|
91112
|
+
/** The panel's color. Follows `--helix-color-surface-overlay`. */
|
|
91113
|
+
"--toast-background-color"?: (string) | undefined;
|
|
89497
91114
|
/** Color of the panel's edge. */
|
|
89498
91115
|
"--toast-border-color"?: (string) | undefined;
|
|
89499
91116
|
/** Width of the panel's edge. Follows `--helix-border-floating`, which is `0`, so the panel stands out by its shadow unless your theme sets a border. */
|
|
89500
91117
|
"--toast-border-width"?: (string) | undefined;
|
|
91118
|
+
/** Color of the message's text. */
|
|
91119
|
+
"--toast-color"?: (string) | undefined;
|
|
91120
|
+
/** Color of the line in the `description` slot, under the heading. */
|
|
91121
|
+
"--toast-description-color"?: (string) | undefined;
|
|
91122
|
+
/** Color of the dismiss control's mark at rest. */
|
|
91123
|
+
"--toast-dismiss-color"?: (string) | undefined;
|
|
91124
|
+
/** Size of the message's text. The first line's controls and mark stay centered on it. */
|
|
91125
|
+
"--toast-font-size"?: (string) | undefined;
|
|
91126
|
+
/** Weight of the heading in the `heading` slot. */
|
|
91127
|
+
"--toast-heading-weight"?: (string) | undefined;
|
|
89501
91128
|
/** Space between the message's edge and its contents. */
|
|
89502
91129
|
"--toast-item-padding"?: (string) | undefined;
|
|
91130
|
+
/** Rounding of the panel's corners. */
|
|
91131
|
+
"--toast-radius"?: (string) | undefined;
|
|
89503
91132
|
/** Shadow under the panel. Follows `--helix-shadow-floating`. A floating surface can sit over any content, so it has a shadow by default. */
|
|
89504
91133
|
"--toast-shadow"?: (string) | undefined;
|
|
91134
|
+
/** Thickness of the bar that counts down a timed message. */
|
|
91135
|
+
"--toast-timer-size"?: (string) | undefined;
|
|
91136
|
+
/** Color of the mark and the countdown bar. Unset, each `tone` takes its own color, so set it per tone, as in `helix-toast-item[tone="danger"]`. */
|
|
91137
|
+
"--toast-tone-color"?: (string) | undefined;
|
|
89505
91138
|
/** How long this message stays, in milliseconds, for a progress hint. */
|
|
89506
91139
|
"--toast-duration"?: (string) | undefined;
|
|
89507
91140
|
/** How far a swipe has moved the message across, in pixels, toward the right. */
|