@fusion.dev/helix 0.160.0 → 0.162.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 +5183 -526
- package/dist/aura/root/aura-root.d.ts +0 -49
- package/dist/aura/root/aura-root.js +2 -16
- package/dist/chat/message/chat-message.css.js +1 -1
- package/dist/chat/root/chat-root.css.js +6 -1
- package/dist/code-block/root/code-block-root.css.js +10 -3
- package/dist/code-block/root/code-block-root.d.ts +4 -10
- package/dist/code-block/root/code-block-root.js +0 -8
- package/dist/element-events.generated.js +5 -0
- package/dist/index.d.ts +1 -0
- package/dist/index.js +1 -0
- package/dist/strands/index.d.ts +2 -0
- package/dist/strands/index.js +2 -0
- package/dist/strands/palette.d.ts +42 -0
- package/dist/strands/palette.js +24 -0
- package/dist/strands/path.d.ts +89 -0
- package/dist/strands/path.js +153 -0
- package/dist/strands/renderer.d.ts +84 -0
- package/dist/strands/renderer.js +255 -0
- package/dist/strands/root/strands-root.css.d.ts +1 -0
- package/dist/strands/root/strands-root.css.js +8 -0
- package/dist/strands/root/strands-root.d.ts +230 -0
- package/dist/strands/root/strands-root.js +466 -0
- package/dist/strands/shader.d.ts +22 -0
- package/dist/strands/shader.js +198 -0
- package/dist/strands/stop/strands-stop.css.d.ts +1 -0
- package/dist/strands/stop/strands-stop.css.js +2 -0
- package/dist/strands/stop/strands-stop.d.ts +44 -0
- package/dist/strands/stop/strands-stop.js +29 -0
- package/dist/table/root/table-root.css.js +2 -1
- package/dist/table/row/table-row.css.js +8 -2
- package/dist/table/row/table-row.d.ts +2 -0
- package/dist/timeline/item/timeline-item.css.js +5 -1
- package/dist/video-playlist/root/video-playlist-root.css.js +1 -1
- package/dist/video-playlist/root/video-playlist-root.d.ts +2 -0
- package/dist/virtual-list/root/virtual-list-root.css.js +1 -1
- package/dist/virtual-list/root/virtual-list-root.d.ts +1 -0
- package/lint.json +1 -1
- package/package.json +6 -6
- package/types/jsx.d.ts +1206 -66
- package/types/svelte.d.ts +2 -0
- package/types/vue.d.ts +314 -12
- package/types/words.d.ts +79 -0
package/types/jsx.d.ts
CHANGED
|
@@ -213,6 +213,9 @@ import type {
|
|
|
213
213
|
HelixStatGroup,
|
|
214
214
|
HelixStep,
|
|
215
215
|
HelixSteps,
|
|
216
|
+
HelixStrands,
|
|
217
|
+
HelixStrandsFallbackEvent,
|
|
218
|
+
HelixStrandsStop,
|
|
216
219
|
HelixSwitch,
|
|
217
220
|
HelixTab,
|
|
218
221
|
HelixTabPanel,
|
|
@@ -4528,6 +4531,10 @@ what the controls drive rather than the mechanism. */
|
|
|
4528
4531
|
/** The name of the group of controls, read by screen readers, which names
|
|
4529
4532
|
what the controls drive rather than the mechanism. */
|
|
4530
4533
|
controlsLabel?: (HelixCanvas["controlsLabel"]) | undefined;
|
|
4534
|
+
/** What screen readers hear after a copy, with `{count}` for the cards copied. */
|
|
4535
|
+
"copied-label"?: (HelixCanvas["copiedLabel"]) | undefined;
|
|
4536
|
+
/** What screen readers hear after a copy, with `{count}` for the cards copied. */
|
|
4537
|
+
copiedLabel?: (HelixCanvas["copiedLabel"]) | undefined;
|
|
4531
4538
|
/** The board's name where `label` is empty. */
|
|
4532
4539
|
"fallback-label"?: (HelixCanvas["fallbackLabel"]) | undefined;
|
|
4533
4540
|
/** The board's name where `label` is empty. */
|
|
@@ -4615,6 +4622,10 @@ walk the cards. */
|
|
|
4615
4622
|
/** The text announced when a connection's end is picked up, with `{from}` and
|
|
4616
4623
|
`{to}`. */
|
|
4617
4624
|
reconnectingLabel?: (HelixCanvas["reconnectingLabel"]) | undefined;
|
|
4625
|
+
/** What screen readers hear after a move or a resize is made again. */
|
|
4626
|
+
"redone-label"?: (HelixCanvas["redoneLabel"]) | undefined;
|
|
4627
|
+
/** What screen readers hear after a move or a resize is made again. */
|
|
4628
|
+
redoneLabel?: (HelixCanvas["redoneLabel"]) | undefined;
|
|
4618
4629
|
/** What screen readers hear after a key resizes a card, with `{name}` for the
|
|
4619
4630
|
card and `{width}` and `{height}` for its new size, in the document's
|
|
4620
4631
|
units. */
|
|
@@ -4717,6 +4728,10 @@ told the same. A tone left out is not read. */
|
|
|
4717
4728
|
"two-finger-hint-label"?: (HelixCanvas["twoFingerHintLabel"]) | undefined;
|
|
4718
4729
|
/** The hint shown when one finger swipes over the board with `gestures="cooperative"`. */
|
|
4719
4730
|
twoFingerHintLabel?: (HelixCanvas["twoFingerHintLabel"]) | undefined;
|
|
4731
|
+
/** What screen readers hear after a move or a resize is undone. */
|
|
4732
|
+
"undone-label"?: (HelixCanvas["undoneLabel"]) | undefined;
|
|
4733
|
+
/** What screen readers hear after a move or a resize is undone. */
|
|
4734
|
+
undoneLabel?: (HelixCanvas["undoneLabel"]) | undefined;
|
|
4720
4735
|
/** The line shown while the board, with `gestures="activate"`, has the gestures. */
|
|
4721
4736
|
"using-label"?: (HelixCanvas["usingLabel"]) | undefined;
|
|
4722
4737
|
/** The line shown while the board, with `gestures="activate"`, has the gestures. */
|
|
@@ -4972,6 +4987,10 @@ what the controls drive rather than the mechanism. */
|
|
|
4972
4987
|
/** The name of the group of controls, read by screen readers, which names
|
|
4973
4988
|
what the controls drive rather than the mechanism. */
|
|
4974
4989
|
"prop:controlsLabel"?: (HelixCanvas["controlsLabel"]) | undefined;
|
|
4990
|
+
/** What screen readers hear after a copy, with `{count}` for the cards copied. */
|
|
4991
|
+
"attr:copied-label"?: (HelixCanvas["copiedLabel"]) | undefined;
|
|
4992
|
+
/** What screen readers hear after a copy, with `{count}` for the cards copied. */
|
|
4993
|
+
"prop:copiedLabel"?: (HelixCanvas["copiedLabel"]) | undefined;
|
|
4975
4994
|
/** The board's name where `label` is empty. */
|
|
4976
4995
|
"attr:fallback-label"?: (HelixCanvas["fallbackLabel"]) | undefined;
|
|
4977
4996
|
/** The board's name where `label` is empty. */
|
|
@@ -5059,6 +5078,10 @@ walk the cards. */
|
|
|
5059
5078
|
/** The text announced when a connection's end is picked up, with `{from}` and
|
|
5060
5079
|
`{to}`. */
|
|
5061
5080
|
"prop:reconnectingLabel"?: (HelixCanvas["reconnectingLabel"]) | undefined;
|
|
5081
|
+
/** What screen readers hear after a move or a resize is made again. */
|
|
5082
|
+
"attr:redone-label"?: (HelixCanvas["redoneLabel"]) | undefined;
|
|
5083
|
+
/** What screen readers hear after a move or a resize is made again. */
|
|
5084
|
+
"prop:redoneLabel"?: (HelixCanvas["redoneLabel"]) | undefined;
|
|
5062
5085
|
/** What screen readers hear after a key resizes a card, with `{name}` for the
|
|
5063
5086
|
card and `{width}` and `{height}` for its new size, in the document's
|
|
5064
5087
|
units. */
|
|
@@ -5161,6 +5184,10 @@ told the same. A tone left out is not read. */
|
|
|
5161
5184
|
"attr:two-finger-hint-label"?: (HelixCanvas["twoFingerHintLabel"]) | undefined;
|
|
5162
5185
|
/** The hint shown when one finger swipes over the board with `gestures="cooperative"`. */
|
|
5163
5186
|
"prop:twoFingerHintLabel"?: (HelixCanvas["twoFingerHintLabel"]) | undefined;
|
|
5187
|
+
/** What screen readers hear after a move or a resize is undone. */
|
|
5188
|
+
"attr:undone-label"?: (HelixCanvas["undoneLabel"]) | undefined;
|
|
5189
|
+
/** What screen readers hear after a move or a resize is undone. */
|
|
5190
|
+
"prop:undoneLabel"?: (HelixCanvas["undoneLabel"]) | undefined;
|
|
5164
5191
|
/** The line shown while the board, with `gestures="activate"`, has the gestures. */
|
|
5165
5192
|
"attr:using-label"?: (HelixCanvas["usingLabel"]) | undefined;
|
|
5166
5193
|
/** The line shown while the board, with `gestures="activate"`, has the gestures. */
|
|
@@ -6790,6 +6817,10 @@ is the way back, and that is a part inside the shadow tree where a
|
|
|
6790
6817
|
stylesheet can already reach it. Measured rather than assumed: `label,
|
|
6791
6818
|
pinned` after upgrade against `label` from the server. */
|
|
6792
6819
|
pinned?: (HelixChat["pinned"]) | undefined;
|
|
6820
|
+
/** The words on the button that returns to the newest turn, where `resume` is empty. */
|
|
6821
|
+
"resume-label"?: (HelixChat["resumeLabel"]) | undefined;
|
|
6822
|
+
/** The words on the button that returns to the newest turn, where `resume` is empty. */
|
|
6823
|
+
resumeLabel?: (HelixChat["resumeLabel"]) | undefined;
|
|
6793
6824
|
/** How near the bottom still counts as being at it, in pixels.
|
|
6794
6825
|
|
|
6795
6826
|
A hook rather than a constant, because the right number depends on how tall
|
|
@@ -6950,6 +6981,10 @@ is the way back, and that is a part inside the shadow tree where a
|
|
|
6950
6981
|
stylesheet can already reach it. Measured rather than assumed: `label,
|
|
6951
6982
|
pinned` after upgrade against `label` from the server. */
|
|
6952
6983
|
"prop:pinned"?: (HelixChat["pinned"]) | undefined;
|
|
6984
|
+
/** The words on the button that returns to the newest turn, where `resume` is empty. */
|
|
6985
|
+
"attr:resume-label"?: (HelixChat["resumeLabel"]) | undefined;
|
|
6986
|
+
/** The words on the button that returns to the newest turn, where `resume` is empty. */
|
|
6987
|
+
"prop:resumeLabel"?: (HelixChat["resumeLabel"]) | undefined;
|
|
6953
6988
|
/** How near the bottom still counts as being at it, in pixels.
|
|
6954
6989
|
|
|
6955
6990
|
A hook rather than a constant, because the right number depends on how tall
|
|
@@ -7616,14 +7651,19 @@ Here rather than on each control. */
|
|
|
7616
7651
|
textContent?: (string | number) | undefined;
|
|
7617
7652
|
};
|
|
7618
7653
|
|
|
7619
|
-
|
|
7620
|
-
|
|
7654
|
+
/** `HelixCodeBlock` component event */
|
|
7655
|
+
export type HelixCodeBlockElementEvent<E = Event> = TypedEvent<
|
|
7656
|
+
HelixCodeBlock,
|
|
7657
|
+
E
|
|
7658
|
+
>;
|
|
7659
|
+
/** `helix-before-toggle` event type */
|
|
7660
|
+
export type HelixCodeBlockHelixBeforeToggleElementEvent =
|
|
7661
|
+
HelixCodeBlockElementEvent<HelixBeforeToggleEvent>;
|
|
7662
|
+
/** `helix-toggle` event type */
|
|
7663
|
+
export type HelixCodeBlockHelixToggleElementEvent =
|
|
7664
|
+
HelixCodeBlockElementEvent<HelixToggleEvent>;
|
|
7621
7665
|
|
|
7622
|
-
|
|
7623
|
-
significant in code and a wrapped line reads as two. For prose-like code, such as a long command or
|
|
7624
|
-
a log line, a wrap reads better than a scroll. Line numbers keep the lines
|
|
7625
|
-
unwrapped, since a wrapped line would take one number and several rows. */
|
|
7626
|
-
wrap?: (HelixCodeBlock["wrap"]) | undefined;
|
|
7666
|
+
export type HelixCodeBlockProps = {
|
|
7627
7667
|
/** The name of a block that scrolls, which is a tab stop while it does.
|
|
7628
7668
|
|
|
7629
7669
|
Where the block has a name, the scroller says it too, such as "Code,
|
|
@@ -7709,6 +7749,14 @@ copy, which takes the code alone. Reflected, because the stylesheet lays
|
|
|
7709
7749
|
the gutter out beside the code. A diff numbers its lines from its hunks
|
|
7710
7750
|
whether or not this is set. */
|
|
7711
7751
|
lineNumbers?: (HelixCodeBlock["lineNumbers"]) | undefined;
|
|
7752
|
+
/** The lines to mark, as numbers and ranges counted from 1, such as `2, 4-6`.
|
|
7753
|
+
Each run is drawn as a band behind its lines. Not for a diff, which marks
|
|
7754
|
+
its own changes. */
|
|
7755
|
+
"mark-lines"?: (HelixCodeBlock["markLines"]) | undefined;
|
|
7756
|
+
/** The lines to mark, as numbers and ranges counted from 1, such as `2, 4-6`.
|
|
7757
|
+
Each run is drawn as a band behind its lines. Not for a diff, which marks
|
|
7758
|
+
its own changes. */
|
|
7759
|
+
markLines?: (HelixCodeBlock["markLines"]) | undefined;
|
|
7712
7760
|
/** Whether to leave the copy button off.
|
|
7713
7761
|
|
|
7714
7762
|
Negative, which is not a style choice. A boolean attribute is true whenever
|
|
@@ -7755,6 +7803,22 @@ Absent is unified, each removal above its replacement, which fits any
|
|
|
7755
7803
|
width. `split` sets the old version beside the new one. Optional rather
|
|
7756
7804
|
than defaulted, so the host carries no attribute the consumer did not write. */
|
|
7757
7805
|
variant?: (HelixCodeBlock["variant"]) | undefined;
|
|
7806
|
+
/** Whether long lines wrap. Without it they scroll.
|
|
7807
|
+
|
|
7808
|
+
Off by default, so long lines scroll, because a line break can be
|
|
7809
|
+
significant in code and a wrapped line reads as two. For prose-like code,
|
|
7810
|
+
such as a long command or a log line, a wrap reads better than a scroll.
|
|
7811
|
+
With `line-numbers`, each number stands beside the line it numbers
|
|
7812
|
+
however many rows that line takes. Reflected, because the stylesheet
|
|
7813
|
+
wraps the lines. */
|
|
7814
|
+
wrap?: (HelixCodeBlock["wrap"]) | undefined;
|
|
7815
|
+
/** The wrap button's name, which it keeps whether it is pressed or not. */
|
|
7816
|
+
"wrap-label"?: (HelixCodeBlock["wrapLabel"]) | undefined;
|
|
7817
|
+
/** The wrap button's name, which it keeps whether it is pressed or not. */
|
|
7818
|
+
wrapLabel?: (HelixCodeBlock["wrapLabel"]) | undefined;
|
|
7819
|
+
/** Whether the header has a button that wraps the lines and unwraps them. The
|
|
7820
|
+
block draws a header for it even with no name. */
|
|
7821
|
+
wrappable?: (HelixCodeBlock["wrappable"]) | undefined;
|
|
7758
7822
|
/** Turns the code into highlighted markup, which the block draws in place of
|
|
7759
7823
|
the plain text.
|
|
7760
7824
|
|
|
@@ -7777,16 +7841,16 @@ in the slot, so the copy button copies it as written and a reader without
|
|
|
7777
7841
|
the script still has it. Not called on a server, which has no code to
|
|
7778
7842
|
read, nor for a diff. */
|
|
7779
7843
|
highlight?: (HelixCodeBlock["highlight"]) | undefined;
|
|
7844
|
+
|
|
7845
|
+
/** The wrap button was pressed, with the `wrap` it asks for in `detail.checked`. Cancelable: cancel it to keep the lines as they are. */
|
|
7846
|
+
"onhelix-before-toggle"?: ((
|
|
7847
|
+
e: HelixCodeBlockHelixBeforeToggleElementEvent,
|
|
7848
|
+
) => void) | undefined;
|
|
7849
|
+
/** Fired after the wrap button changed `wrap`, with the new value in `detail.checked`. */
|
|
7850
|
+
"onhelix-toggle"?: ((e: HelixCodeBlockHelixToggleElementEvent) => void) | undefined;
|
|
7780
7851
|
};
|
|
7781
7852
|
|
|
7782
7853
|
export type HelixCodeBlockSolidJsProps = {
|
|
7783
|
-
/** Whether long lines wrap.
|
|
7784
|
-
|
|
7785
|
-
Off by default, so long lines scroll, because a line break can be
|
|
7786
|
-
significant in code and a wrapped line reads as two. For prose-like code, such as a long command or
|
|
7787
|
-
a log line, a wrap reads better than a scroll. Line numbers keep the lines
|
|
7788
|
-
unwrapped, since a wrapped line would take one number and several rows. */
|
|
7789
|
-
"prop:wrap"?: (HelixCodeBlock["wrap"]) | undefined;
|
|
7790
7854
|
/** The name of a block that scrolls, which is a tab stop while it does.
|
|
7791
7855
|
|
|
7792
7856
|
Where the block has a name, the scroller says it too, such as "Code,
|
|
@@ -7872,6 +7936,14 @@ copy, which takes the code alone. Reflected, because the stylesheet lays
|
|
|
7872
7936
|
the gutter out beside the code. A diff numbers its lines from its hunks
|
|
7873
7937
|
whether or not this is set. */
|
|
7874
7938
|
"prop:lineNumbers"?: (HelixCodeBlock["lineNumbers"]) | undefined;
|
|
7939
|
+
/** The lines to mark, as numbers and ranges counted from 1, such as `2, 4-6`.
|
|
7940
|
+
Each run is drawn as a band behind its lines. Not for a diff, which marks
|
|
7941
|
+
its own changes. */
|
|
7942
|
+
"attr:mark-lines"?: (HelixCodeBlock["markLines"]) | undefined;
|
|
7943
|
+
/** The lines to mark, as numbers and ranges counted from 1, such as `2, 4-6`.
|
|
7944
|
+
Each run is drawn as a band behind its lines. Not for a diff, which marks
|
|
7945
|
+
its own changes. */
|
|
7946
|
+
"prop:markLines"?: (HelixCodeBlock["markLines"]) | undefined;
|
|
7875
7947
|
/** Whether to leave the copy button off.
|
|
7876
7948
|
|
|
7877
7949
|
Negative, which is not a style choice. A boolean attribute is true whenever
|
|
@@ -7918,6 +7990,22 @@ Absent is unified, each removal above its replacement, which fits any
|
|
|
7918
7990
|
width. `split` sets the old version beside the new one. Optional rather
|
|
7919
7991
|
than defaulted, so the host carries no attribute the consumer did not write. */
|
|
7920
7992
|
"prop:variant"?: (HelixCodeBlock["variant"]) | undefined;
|
|
7993
|
+
/** Whether long lines wrap. Without it they scroll.
|
|
7994
|
+
|
|
7995
|
+
Off by default, so long lines scroll, because a line break can be
|
|
7996
|
+
significant in code and a wrapped line reads as two. For prose-like code,
|
|
7997
|
+
such as a long command or a log line, a wrap reads better than a scroll.
|
|
7998
|
+
With `line-numbers`, each number stands beside the line it numbers
|
|
7999
|
+
however many rows that line takes. Reflected, because the stylesheet
|
|
8000
|
+
wraps the lines. */
|
|
8001
|
+
"prop:wrap"?: (HelixCodeBlock["wrap"]) | undefined;
|
|
8002
|
+
/** The wrap button's name, which it keeps whether it is pressed or not. */
|
|
8003
|
+
"attr:wrap-label"?: (HelixCodeBlock["wrapLabel"]) | undefined;
|
|
8004
|
+
/** The wrap button's name, which it keeps whether it is pressed or not. */
|
|
8005
|
+
"prop:wrapLabel"?: (HelixCodeBlock["wrapLabel"]) | undefined;
|
|
8006
|
+
/** Whether the header has a button that wraps the lines and unwraps them. The
|
|
8007
|
+
block draws a header for it even with no name. */
|
|
8008
|
+
"prop:wrappable"?: (HelixCodeBlock["wrappable"]) | undefined;
|
|
7921
8009
|
/** Turns the code into highlighted markup, which the block draws in place of
|
|
7922
8010
|
the plain text.
|
|
7923
8011
|
|
|
@@ -7940,6 +8028,12 @@ in the slot, so the copy button copies it as written and a reader without
|
|
|
7940
8028
|
the script still has it. Not called on a server, which has no code to
|
|
7941
8029
|
read, nor for a diff. */
|
|
7942
8030
|
"prop:highlight"?: (HelixCodeBlock["highlight"]) | undefined;
|
|
8031
|
+
/** The wrap button was pressed, with the `wrap` it asks for in `detail.checked`. Cancelable: cancel it to keep the lines as they are. */
|
|
8032
|
+
"on:helix-before-toggle"?: ((
|
|
8033
|
+
e: HelixCodeBlockHelixBeforeToggleElementEvent,
|
|
8034
|
+
) => void) | undefined;
|
|
8035
|
+
/** Fired after the wrap button changed `wrap`, with the new value in `detail.checked`. */
|
|
8036
|
+
"on:helix-toggle"?: ((e: HelixCodeBlockHelixToggleElementEvent) => void) | undefined;
|
|
7943
8037
|
|
|
7944
8038
|
/** Set the innerHTML of the element */
|
|
7945
8039
|
innerHTML?: (string) | undefined;
|
|
@@ -31682,6 +31776,22 @@ consumer's to set. */
|
|
|
31682
31776
|
"corner-label"?: (HelixSplitter["cornerLabel"]) | undefined;
|
|
31683
31777
|
/** The name of the handle where two dividers cross, read by screen readers. */
|
|
31684
31778
|
cornerLabel?: (HelixSplitter["cornerLabel"]) | undefined;
|
|
31779
|
+
/** What the handle where two dividers cross says it is set to, both dividers
|
|
31780
|
+
at once: `{across}` is where the divider that runs down stands, and
|
|
31781
|
+
`{down}` where the one that runs across stands, each a percentage.
|
|
31782
|
+
|
|
31783
|
+
**Both, because the handle moves both**, and a number names one: the
|
|
31784
|
+
handle's `aria-valuenow` is the divider its `aria-orientation` names, and
|
|
31785
|
+
these words are the whole of where it is. */
|
|
31786
|
+
"corner-value-label"?: (HelixSplitter["cornerValueLabel"]) | undefined;
|
|
31787
|
+
/** What the handle where two dividers cross says it is set to, both dividers
|
|
31788
|
+
at once: `{across}` is where the divider that runs down stands, and
|
|
31789
|
+
`{down}` where the one that runs across stands, each a percentage.
|
|
31790
|
+
|
|
31791
|
+
**Both, because the handle moves both**, and a number names one: the
|
|
31792
|
+
handle's `aria-valuenow` is the divider its `aria-orientation` names, and
|
|
31793
|
+
these words are the whole of where it is. */
|
|
31794
|
+
cornerValueLabel?: (HelixSplitter["cornerValueLabel"]) | undefined;
|
|
31685
31795
|
/** Which pane starts shut, when `collapsed` is not set. */
|
|
31686
31796
|
"default-collapsed"?: (HelixSplitter["defaultCollapsed"]) | undefined;
|
|
31687
31797
|
/** Which pane starts shut, when `collapsed` is not set. */
|
|
@@ -31838,6 +31948,22 @@ consumer's to set. */
|
|
|
31838
31948
|
"attr:corner-label"?: (HelixSplitter["cornerLabel"]) | undefined;
|
|
31839
31949
|
/** The name of the handle where two dividers cross, read by screen readers. */
|
|
31840
31950
|
"prop:cornerLabel"?: (HelixSplitter["cornerLabel"]) | undefined;
|
|
31951
|
+
/** What the handle where two dividers cross says it is set to, both dividers
|
|
31952
|
+
at once: `{across}` is where the divider that runs down stands, and
|
|
31953
|
+
`{down}` where the one that runs across stands, each a percentage.
|
|
31954
|
+
|
|
31955
|
+
**Both, because the handle moves both**, and a number names one: the
|
|
31956
|
+
handle's `aria-valuenow` is the divider its `aria-orientation` names, and
|
|
31957
|
+
these words are the whole of where it is. */
|
|
31958
|
+
"attr:corner-value-label"?: (HelixSplitter["cornerValueLabel"]) | undefined;
|
|
31959
|
+
/** What the handle where two dividers cross says it is set to, both dividers
|
|
31960
|
+
at once: `{across}` is where the divider that runs down stands, and
|
|
31961
|
+
`{down}` where the one that runs across stands, each a percentage.
|
|
31962
|
+
|
|
31963
|
+
**Both, because the handle moves both**, and a number names one: the
|
|
31964
|
+
handle's `aria-valuenow` is the divider its `aria-orientation` names, and
|
|
31965
|
+
these words are the whole of where it is. */
|
|
31966
|
+
"prop:cornerValueLabel"?: (HelixSplitter["cornerValueLabel"]) | undefined;
|
|
31841
31967
|
/** Which pane starts shut, when `collapsed` is not set. */
|
|
31842
31968
|
"attr:default-collapsed"?: (HelixSplitter["defaultCollapsed"]) | undefined;
|
|
31843
31969
|
/** Which pane starts shut, when `collapsed` is not set. */
|
|
@@ -32345,6 +32471,121 @@ with `linear`. Ark UI's skippable step. */
|
|
|
32345
32471
|
textContent?: (string | number) | undefined;
|
|
32346
32472
|
};
|
|
32347
32473
|
|
|
32474
|
+
/** `HelixStrands` component event */
|
|
32475
|
+
export type HelixStrandsElementEvent<E = Event> = TypedEvent<HelixStrands, E>;
|
|
32476
|
+
/** `helix-strands-fallback` event type */
|
|
32477
|
+
export type HelixStrandsHelixStrandsFallbackElementEvent =
|
|
32478
|
+
HelixStrandsElementEvent<HelixStrandsFallbackEvent>;
|
|
32479
|
+
|
|
32480
|
+
export type HelixStrandsProps = {
|
|
32481
|
+
/** Where the form sits across the box, as a share of the width: the fan's
|
|
32482
|
+
bend or the ribbon's axis. `0` is the left edge and `1` the right. A wave
|
|
32483
|
+
crosses the whole width and does not read it. Unset, a fan bends at `0.4`
|
|
32484
|
+
and a ribbon runs down the middle.
|
|
32485
|
+
|
|
32486
|
+
**A share rather than a length**, so the ribbon keeps its place when the
|
|
32487
|
+
box changes shape. Read inside a box only; in `travel` each stop has its
|
|
32488
|
+
own. */
|
|
32489
|
+
at?: (HelixStrands["at"]) | undefined;
|
|
32490
|
+
/** How many strands the ribbon has, from `0`, sixty, to `1`, three hundred and
|
|
32491
|
+
forty. Clamped to that range. */
|
|
32492
|
+
density?: (HelixStrands["density"]) | undefined;
|
|
32493
|
+
/** Overall brightness, as a multiplier on the light. */
|
|
32494
|
+
gain?: (HelixStrands["gain"]) | undefined;
|
|
32495
|
+
/** The share of strands drawn out of focus where the ribbon is wide, from `0`,
|
|
32496
|
+
every strand sharp, to `1`, every one soft. Clamped to that range. A tight
|
|
32497
|
+
form, such as a fan's bend or a wave, stays sharp whatever this says. */
|
|
32498
|
+
softness?: (HelixStrands["softness"]) | undefined;
|
|
32499
|
+
/** How fast the ribbon moves, as a multiplier on time. `0` holds it still. */
|
|
32500
|
+
speed?: (HelixStrands["speed"]) | undefined;
|
|
32501
|
+
/** How wide the ribbon is, as a multiplier on each form's own width. */
|
|
32502
|
+
spread?: (HelixStrands["spread"]) | undefined;
|
|
32503
|
+
/** Whether the ribbon is laid down the whole page, so scrolling travels along
|
|
32504
|
+
it.
|
|
32505
|
+
|
|
32506
|
+
Reflected because the stylesheet selects on it: in `travel` the host fixes
|
|
32507
|
+
itself to the viewport, behind the page. */
|
|
32508
|
+
travel?: (HelixStrands["travel"]) | undefined;
|
|
32509
|
+
/** The form the ribbon takes. When it is not set, the form is `ribbon`. In
|
|
32510
|
+
`travel`, the form of every stretch no stop claims. */
|
|
32511
|
+
variant?: (HelixStrands["variant"]) | undefined;
|
|
32512
|
+
|
|
32513
|
+
/** Fired each time the element stops drawing its ribbon and shows its gradient, with the reason. */
|
|
32514
|
+
"onhelix-strands-fallback"?: ((
|
|
32515
|
+
e: HelixStrandsHelixStrandsFallbackElementEvent,
|
|
32516
|
+
) => void) | undefined;
|
|
32517
|
+
};
|
|
32518
|
+
|
|
32519
|
+
export type HelixStrandsSolidJsProps = {
|
|
32520
|
+
/** Where the form sits across the box, as a share of the width: the fan's
|
|
32521
|
+
bend or the ribbon's axis. `0` is the left edge and `1` the right. A wave
|
|
32522
|
+
crosses the whole width and does not read it. Unset, a fan bends at `0.4`
|
|
32523
|
+
and a ribbon runs down the middle.
|
|
32524
|
+
|
|
32525
|
+
**A share rather than a length**, so the ribbon keeps its place when the
|
|
32526
|
+
box changes shape. Read inside a box only; in `travel` each stop has its
|
|
32527
|
+
own. */
|
|
32528
|
+
"prop:at"?: (HelixStrands["at"]) | undefined;
|
|
32529
|
+
/** How many strands the ribbon has, from `0`, sixty, to `1`, three hundred and
|
|
32530
|
+
forty. Clamped to that range. */
|
|
32531
|
+
"prop:density"?: (HelixStrands["density"]) | undefined;
|
|
32532
|
+
/** Overall brightness, as a multiplier on the light. */
|
|
32533
|
+
"prop:gain"?: (HelixStrands["gain"]) | undefined;
|
|
32534
|
+
/** The share of strands drawn out of focus where the ribbon is wide, from `0`,
|
|
32535
|
+
every strand sharp, to `1`, every one soft. Clamped to that range. A tight
|
|
32536
|
+
form, such as a fan's bend or a wave, stays sharp whatever this says. */
|
|
32537
|
+
"prop:softness"?: (HelixStrands["softness"]) | undefined;
|
|
32538
|
+
/** How fast the ribbon moves, as a multiplier on time. `0` holds it still. */
|
|
32539
|
+
"prop:speed"?: (HelixStrands["speed"]) | undefined;
|
|
32540
|
+
/** How wide the ribbon is, as a multiplier on each form's own width. */
|
|
32541
|
+
"prop:spread"?: (HelixStrands["spread"]) | undefined;
|
|
32542
|
+
/** Whether the ribbon is laid down the whole page, so scrolling travels along
|
|
32543
|
+
it.
|
|
32544
|
+
|
|
32545
|
+
Reflected because the stylesheet selects on it: in `travel` the host fixes
|
|
32546
|
+
itself to the viewport, behind the page. */
|
|
32547
|
+
"prop:travel"?: (HelixStrands["travel"]) | undefined;
|
|
32548
|
+
/** The form the ribbon takes. When it is not set, the form is `ribbon`. In
|
|
32549
|
+
`travel`, the form of every stretch no stop claims. */
|
|
32550
|
+
"prop:variant"?: (HelixStrands["variant"]) | undefined;
|
|
32551
|
+
/** Fired each time the element stops drawing its ribbon and shows its gradient, with the reason. */
|
|
32552
|
+
"on:helix-strands-fallback"?: ((
|
|
32553
|
+
e: HelixStrandsHelixStrandsFallbackElementEvent,
|
|
32554
|
+
) => void) | undefined;
|
|
32555
|
+
|
|
32556
|
+
/** Set the innerHTML of the element */
|
|
32557
|
+
innerHTML?: (string) | undefined;
|
|
32558
|
+
/** Set the textContent of the element */
|
|
32559
|
+
textContent?: (string | number) | undefined;
|
|
32560
|
+
};
|
|
32561
|
+
|
|
32562
|
+
export type HelixStrandsStopProps = {
|
|
32563
|
+
/** Where the form sits across the page, as a share of the width: the fan's
|
|
32564
|
+
bend or the ribbon's axis. A wave crosses the whole width and does not
|
|
32565
|
+
read it. Unset, a fan bends at `0.4` and a ribbon runs down the middle. */
|
|
32566
|
+
at?: (HelixStrandsStop["at"]) | undefined;
|
|
32567
|
+
/** The id of the element the form is pinned to, in the same tree as the stop. */
|
|
32568
|
+
for?: (HelixStrandsStop["for"]) | undefined;
|
|
32569
|
+
/** The form the ribbon takes at the element. When it is not set, the form is `ribbon`. */
|
|
32570
|
+
variant?: (HelixStrandsStop["variant"]) | undefined;
|
|
32571
|
+
};
|
|
32572
|
+
|
|
32573
|
+
export type HelixStrandsStopSolidJsProps = {
|
|
32574
|
+
/** Where the form sits across the page, as a share of the width: the fan's
|
|
32575
|
+
bend or the ribbon's axis. A wave crosses the whole width and does not
|
|
32576
|
+
read it. Unset, a fan bends at `0.4` and a ribbon runs down the middle. */
|
|
32577
|
+
"prop:at"?: (HelixStrandsStop["at"]) | undefined;
|
|
32578
|
+
/** The id of the element the form is pinned to, in the same tree as the stop. */
|
|
32579
|
+
"prop:for"?: (HelixStrandsStop["for"]) | undefined;
|
|
32580
|
+
/** The form the ribbon takes at the element. When it is not set, the form is `ribbon`. */
|
|
32581
|
+
"prop:variant"?: (HelixStrandsStop["variant"]) | undefined;
|
|
32582
|
+
|
|
32583
|
+
/** Set the innerHTML of the element */
|
|
32584
|
+
innerHTML?: (string) | undefined;
|
|
32585
|
+
/** Set the textContent of the element */
|
|
32586
|
+
textContent?: (string | number) | undefined;
|
|
32587
|
+
};
|
|
32588
|
+
|
|
32348
32589
|
/** `HelixSwitch` component event */
|
|
32349
32590
|
export type HelixSwitchElementEvent<E = Event> = TypedEvent<HelixSwitch, E>;
|
|
32350
32591
|
/** `helix-before-toggle` event type */
|
|
@@ -33057,6 +33298,12 @@ export type HelixTableElementEvent<E = Event> = TypedEvent<HelixTable, E>;
|
|
|
33057
33298
|
/** `helix-before-reorder` event type */
|
|
33058
33299
|
export type HelixTableHelixBeforeReorderElementEvent =
|
|
33059
33300
|
HelixTableElementEvent<HelixBeforeReorderEvent>;
|
|
33301
|
+
/** `helix-before-toggle` event type */
|
|
33302
|
+
export type HelixTableHelixBeforeToggleElementEvent =
|
|
33303
|
+
HelixTableElementEvent<HelixBeforeToggleEvent>;
|
|
33304
|
+
/** `helix-load-more` event type */
|
|
33305
|
+
export type HelixTableHelixLoadMoreElementEvent =
|
|
33306
|
+
HelixTableElementEvent<HelixLoadMoreEvent>;
|
|
33060
33307
|
/** `helix-reorder` event type */
|
|
33061
33308
|
export type HelixTableHelixReorderElementEvent =
|
|
33062
33309
|
HelixTableElementEvent<HelixReorderEvent>;
|
|
@@ -33072,6 +33319,9 @@ export type HelixTableHelixSortElementEvent =
|
|
|
33072
33319
|
/** `helix-sorted` event type */
|
|
33073
33320
|
export type HelixTableHelixSortedElementEvent =
|
|
33074
33321
|
HelixTableElementEvent<HelixSortedEvent>;
|
|
33322
|
+
/** `helix-toggle` event type */
|
|
33323
|
+
export type HelixTableHelixToggleElementEvent =
|
|
33324
|
+
HelixTableElementEvent<HelixToggleEvent>;
|
|
33075
33325
|
|
|
33076
33326
|
export type HelixTableProps = {
|
|
33077
33327
|
/** The text shown and announced when there are no rows and none are loading. */
|
|
@@ -33127,6 +33377,12 @@ and a list here would be a second way to say what that says. This table's
|
|
|
33127
33377
|
cells are markup, and a table written as rows of cells with no column
|
|
33128
33378
|
declared in it has nowhere else to be sized from. */
|
|
33129
33379
|
columns?: (HelixTable["columns"]) | undefined;
|
|
33380
|
+
/** The keys of the rows whose rows are shown at the start, separated by
|
|
33381
|
+
commas. Used until `expanded` is set. */
|
|
33382
|
+
"default-expanded"?: (HelixTable["defaultExpanded"]) | undefined;
|
|
33383
|
+
/** The keys of the rows whose rows are shown at the start, separated by
|
|
33384
|
+
commas. Used until `expanded` is set. */
|
|
33385
|
+
defaultExpanded?: (HelixTable["defaultExpanded"]) | undefined;
|
|
33130
33386
|
/** The keys selected at the start, separated by commas. Used until `selected`
|
|
33131
33387
|
is set. */
|
|
33132
33388
|
"default-selected"?: (HelixTable["defaultSelected"]) | undefined;
|
|
@@ -33161,6 +33417,18 @@ While it is set, a line after the rows shows it, or your own content in the
|
|
|
33161
33417
|
`error` slot, in place of the empty and loading lines, and the live region
|
|
33162
33418
|
says it. */
|
|
33163
33419
|
errorText?: (HelixTable["errorText"]) | undefined;
|
|
33420
|
+
/** The name of the heading over the disclosure buttons. */
|
|
33421
|
+
"expand-column-label"?: (HelixTable["expandColumnLabel"]) | undefined;
|
|
33422
|
+
/** The name of the heading over the disclosure buttons. */
|
|
33423
|
+
expandColumnLabel?: (HelixTable["expandColumnLabel"]) | undefined;
|
|
33424
|
+
/** The keys of the rows whose rows are shown, separated by commas, in a table
|
|
33425
|
+
whose rows nest. A press on a row's disclosure button asks first, and
|
|
33426
|
+
`default-expanded` seeds what this element then owns. */
|
|
33427
|
+
expanded?: (HelixTable["expanded"]) | undefined;
|
|
33428
|
+
/** The name of a row's disclosure button. `{row}` is the words of the row's first cell. */
|
|
33429
|
+
"expand-row-label"?: (HelixTable["expandRowLabel"]) | undefined;
|
|
33430
|
+
/** The name of a row's disclosure button. `{row}` is the words of the row's first cell. */
|
|
33431
|
+
expandRowLabel?: (HelixTable["expandRowLabel"]) | undefined;
|
|
33164
33432
|
/** The table's name where neither `label` nor an `aria-label` or
|
|
33165
33433
|
`aria-labelledby` on the host gives it one. */
|
|
33166
33434
|
"fallback-label"?: (HelixTable["fallbackLabel"]) | undefined;
|
|
@@ -33180,6 +33448,12 @@ cells, which is the one way a cell of your markup can take focus. */
|
|
|
33180
33448
|
An `aria-label` or `aria-labelledby` on the host names the table too, and
|
|
33181
33449
|
wins over this. */
|
|
33182
33450
|
label?: (HelixTable["label"]) | undefined;
|
|
33451
|
+
/** Sends `helix-load-more` once the end of the table comes within a screen
|
|
33452
|
+
of view, so you can add the next rows as a reader nears them. */
|
|
33453
|
+
"load-more"?: (HelixTable["loadMore"]) | undefined;
|
|
33454
|
+
/** Sends `helix-load-more` once the end of the table comes within a screen
|
|
33455
|
+
of view, so you can add the next rows as a reader nears them. */
|
|
33456
|
+
loadMore?: (HelixTable["loadMore"]) | undefined;
|
|
33183
33457
|
/** What screen readers hear each time a key moves a held row, in a
|
|
33184
33458
|
`reorderable` table. `{name}` is the row's words, `{position}` the place it
|
|
33185
33459
|
would go, counting from 1, and `{count}` the number of rows. */
|
|
@@ -33214,6 +33488,12 @@ table moves no row itself: you move your rows on `helix-reorder`. */
|
|
|
33214
33488
|
"select-all-label"?: (HelixTable["selectAllLabel"]) | undefined;
|
|
33215
33489
|
/** The name of the checkbox in the heading that selects every row. */
|
|
33216
33490
|
selectAllLabel?: (HelixTable["selectAllLabel"]) | undefined;
|
|
33491
|
+
/** The name of the heading over the checkboxes under
|
|
33492
|
+
`selection-mode="single"`, where it holds no checkbox of its own. */
|
|
33493
|
+
"select-column-label"?: (HelixTable["selectColumnLabel"]) | undefined;
|
|
33494
|
+
/** The name of the heading over the checkboxes under
|
|
33495
|
+
`selection-mode="single"`, where it holds no checkbox of its own. */
|
|
33496
|
+
selectColumnLabel?: (HelixTable["selectColumnLabel"]) | undefined;
|
|
33217
33497
|
/** The keys of the selected rows, separated by commas.
|
|
33218
33498
|
|
|
33219
33499
|
A reader's press fires `helix-select` first, and refusing it leaves the
|
|
@@ -33230,6 +33510,20 @@ rows are chosen, written in the locale, and a language that needs plural
|
|
|
33230
33510
|
forms writes them: `{count, plural, one {# wybrany} few {# wybrane} many
|
|
33231
33511
|
{# wybranych} other {# wybranego}}`. */
|
|
33232
33512
|
selectedLabel?: (HelixTable["selectedLabel"]) | undefined;
|
|
33513
|
+
/** What a press on a row, or in a `grid` table a key that moves to one, does
|
|
33514
|
+
to the rows already selected: `toggle`, the default, leaves them to the
|
|
33515
|
+
checkboxes, and `replace` selects the row alone. */
|
|
33516
|
+
"selection-behavior"?: (HelixTable["selectionBehavior"]) | undefined;
|
|
33517
|
+
/** What a press on a row, or in a `grid` table a key that moves to one, does
|
|
33518
|
+
to the rows already selected: `toggle`, the default, leaves them to the
|
|
33519
|
+
checkboxes, and `replace` selects the row alone. */
|
|
33520
|
+
selectionBehavior?: (HelixTable["selectionBehavior"]) | undefined;
|
|
33521
|
+
/** How many rows a `selectable` table selects: `multiple`, the default, or
|
|
33522
|
+
`single`, one at a time. */
|
|
33523
|
+
"selection-mode"?: (HelixTable["selectionMode"]) | undefined;
|
|
33524
|
+
/** How many rows a `selectable` table selects: `multiple`, the default, or
|
|
33525
|
+
`single`, one at a time. */
|
|
33526
|
+
selectionMode?: (HelixTable["selectionMode"]) | undefined;
|
|
33233
33527
|
/** The name of a row's checkbox. `{row}` is replaced with the words of the
|
|
33234
33528
|
row's first cell. */
|
|
33235
33529
|
"select-row-label"?: (HelixTable["selectRowLabel"]) | undefined;
|
|
@@ -33263,6 +33557,12 @@ order has its whole sentence. `{order}` is the deprecated
|
|
|
33263
33557
|
"onhelix-before-reorder"?: ((
|
|
33264
33558
|
e: HelixTableHelixBeforeReorderElementEvent,
|
|
33265
33559
|
) => void) | undefined;
|
|
33560
|
+
/** Fired from a row when its disclosure button is pressed, with whether it would be open in `detail.checked`. Cancelable: cancel it to keep the row as it is. */
|
|
33561
|
+
"onhelix-before-toggle"?: ((
|
|
33562
|
+
e: HelixTableHelixBeforeToggleElementEvent,
|
|
33563
|
+
) => void) | undefined;
|
|
33564
|
+
/** Fired, in a table with `load-more`, when the end of the table comes within a screen of view, once for each number of rows. */
|
|
33565
|
+
"onhelix-load-more"?: ((e: HelixTableHelixLoadMoreElementEvent) => void) | undefined;
|
|
33266
33566
|
/** Fired after `helix-before-reorder` when nobody canceled it. Move your rows to the order in `keys`. Cancelable: cancel it to say the move did not happen. */
|
|
33267
33567
|
"onhelix-reorder"?: ((e: HelixTableHelixReorderElementEvent) => void) | undefined;
|
|
33268
33568
|
/** The selection is about to change. The event carries every selected key, separated by commas. Cancelable: cancel it to keep the current selection. */
|
|
@@ -33273,6 +33573,8 @@ order has its whole sentence. `{order}` is the deprecated
|
|
|
33273
33573
|
"onhelix-sort"?: ((e: HelixTableHelixSortElementEvent) => void) | undefined;
|
|
33274
33574
|
/** Fired after the sort order changes, with the new order. */
|
|
33275
33575
|
"onhelix-sorted"?: ((e: HelixTableHelixSortedElementEvent) => void) | undefined;
|
|
33576
|
+
/** Fired from a row once the rows under it are shown or hidden, with whether it is open in `detail.checked`. */
|
|
33577
|
+
"onhelix-toggle"?: ((e: HelixTableHelixToggleElementEvent) => void) | undefined;
|
|
33276
33578
|
};
|
|
33277
33579
|
|
|
33278
33580
|
export type HelixTableSolidJsProps = {
|
|
@@ -33329,6 +33631,12 @@ and a list here would be a second way to say what that says. This table's
|
|
|
33329
33631
|
cells are markup, and a table written as rows of cells with no column
|
|
33330
33632
|
declared in it has nowhere else to be sized from. */
|
|
33331
33633
|
"prop:columns"?: (HelixTable["columns"]) | undefined;
|
|
33634
|
+
/** The keys of the rows whose rows are shown at the start, separated by
|
|
33635
|
+
commas. Used until `expanded` is set. */
|
|
33636
|
+
"attr:default-expanded"?: (HelixTable["defaultExpanded"]) | undefined;
|
|
33637
|
+
/** The keys of the rows whose rows are shown at the start, separated by
|
|
33638
|
+
commas. Used until `expanded` is set. */
|
|
33639
|
+
"prop:defaultExpanded"?: (HelixTable["defaultExpanded"]) | undefined;
|
|
33332
33640
|
/** The keys selected at the start, separated by commas. Used until `selected`
|
|
33333
33641
|
is set. */
|
|
33334
33642
|
"attr:default-selected"?: (HelixTable["defaultSelected"]) | undefined;
|
|
@@ -33363,6 +33671,18 @@ While it is set, a line after the rows shows it, or your own content in the
|
|
|
33363
33671
|
`error` slot, in place of the empty and loading lines, and the live region
|
|
33364
33672
|
says it. */
|
|
33365
33673
|
"prop:errorText"?: (HelixTable["errorText"]) | undefined;
|
|
33674
|
+
/** The name of the heading over the disclosure buttons. */
|
|
33675
|
+
"attr:expand-column-label"?: (HelixTable["expandColumnLabel"]) | undefined;
|
|
33676
|
+
/** The name of the heading over the disclosure buttons. */
|
|
33677
|
+
"prop:expandColumnLabel"?: (HelixTable["expandColumnLabel"]) | undefined;
|
|
33678
|
+
/** The keys of the rows whose rows are shown, separated by commas, in a table
|
|
33679
|
+
whose rows nest. A press on a row's disclosure button asks first, and
|
|
33680
|
+
`default-expanded` seeds what this element then owns. */
|
|
33681
|
+
"prop:expanded"?: (HelixTable["expanded"]) | undefined;
|
|
33682
|
+
/** The name of a row's disclosure button. `{row}` is the words of the row's first cell. */
|
|
33683
|
+
"attr:expand-row-label"?: (HelixTable["expandRowLabel"]) | undefined;
|
|
33684
|
+
/** The name of a row's disclosure button. `{row}` is the words of the row's first cell. */
|
|
33685
|
+
"prop:expandRowLabel"?: (HelixTable["expandRowLabel"]) | undefined;
|
|
33366
33686
|
/** The table's name where neither `label` nor an `aria-label` or
|
|
33367
33687
|
`aria-labelledby` on the host gives it one. */
|
|
33368
33688
|
"attr:fallback-label"?: (HelixTable["fallbackLabel"]) | undefined;
|
|
@@ -33382,6 +33702,12 @@ cells, which is the one way a cell of your markup can take focus. */
|
|
|
33382
33702
|
An `aria-label` or `aria-labelledby` on the host names the table too, and
|
|
33383
33703
|
wins over this. */
|
|
33384
33704
|
"prop:label"?: (HelixTable["label"]) | undefined;
|
|
33705
|
+
/** Sends `helix-load-more` once the end of the table comes within a screen
|
|
33706
|
+
of view, so you can add the next rows as a reader nears them. */
|
|
33707
|
+
"bool:load-more"?: (HelixTable["loadMore"]) | undefined;
|
|
33708
|
+
/** Sends `helix-load-more` once the end of the table comes within a screen
|
|
33709
|
+
of view, so you can add the next rows as a reader nears them. */
|
|
33710
|
+
"prop:loadMore"?: (HelixTable["loadMore"]) | undefined;
|
|
33385
33711
|
/** What screen readers hear each time a key moves a held row, in a
|
|
33386
33712
|
`reorderable` table. `{name}` is the row's words, `{position}` the place it
|
|
33387
33713
|
would go, counting from 1, and `{count}` the number of rows. */
|
|
@@ -33416,6 +33742,12 @@ table moves no row itself: you move your rows on `helix-reorder`. */
|
|
|
33416
33742
|
"attr:select-all-label"?: (HelixTable["selectAllLabel"]) | undefined;
|
|
33417
33743
|
/** The name of the checkbox in the heading that selects every row. */
|
|
33418
33744
|
"prop:selectAllLabel"?: (HelixTable["selectAllLabel"]) | undefined;
|
|
33745
|
+
/** The name of the heading over the checkboxes under
|
|
33746
|
+
`selection-mode="single"`, where it holds no checkbox of its own. */
|
|
33747
|
+
"attr:select-column-label"?: (HelixTable["selectColumnLabel"]) | undefined;
|
|
33748
|
+
/** The name of the heading over the checkboxes under
|
|
33749
|
+
`selection-mode="single"`, where it holds no checkbox of its own. */
|
|
33750
|
+
"prop:selectColumnLabel"?: (HelixTable["selectColumnLabel"]) | undefined;
|
|
33419
33751
|
/** The keys of the selected rows, separated by commas.
|
|
33420
33752
|
|
|
33421
33753
|
A reader's press fires `helix-select` first, and refusing it leaves the
|
|
@@ -33432,6 +33764,20 @@ rows are chosen, written in the locale, and a language that needs plural
|
|
|
33432
33764
|
forms writes them: `{count, plural, one {# wybrany} few {# wybrane} many
|
|
33433
33765
|
{# wybranych} other {# wybranego}}`. */
|
|
33434
33766
|
"prop:selectedLabel"?: (HelixTable["selectedLabel"]) | undefined;
|
|
33767
|
+
/** What a press on a row, or in a `grid` table a key that moves to one, does
|
|
33768
|
+
to the rows already selected: `toggle`, the default, leaves them to the
|
|
33769
|
+
checkboxes, and `replace` selects the row alone. */
|
|
33770
|
+
"attr:selection-behavior"?: (HelixTable["selectionBehavior"]) | undefined;
|
|
33771
|
+
/** What a press on a row, or in a `grid` table a key that moves to one, does
|
|
33772
|
+
to the rows already selected: `toggle`, the default, leaves them to the
|
|
33773
|
+
checkboxes, and `replace` selects the row alone. */
|
|
33774
|
+
"prop:selectionBehavior"?: (HelixTable["selectionBehavior"]) | undefined;
|
|
33775
|
+
/** How many rows a `selectable` table selects: `multiple`, the default, or
|
|
33776
|
+
`single`, one at a time. */
|
|
33777
|
+
"attr:selection-mode"?: (HelixTable["selectionMode"]) | undefined;
|
|
33778
|
+
/** How many rows a `selectable` table selects: `multiple`, the default, or
|
|
33779
|
+
`single`, one at a time. */
|
|
33780
|
+
"prop:selectionMode"?: (HelixTable["selectionMode"]) | undefined;
|
|
33435
33781
|
/** The name of a row's checkbox. `{row}` is replaced with the words of the
|
|
33436
33782
|
row's first cell. */
|
|
33437
33783
|
"attr:select-row-label"?: (HelixTable["selectRowLabel"]) | undefined;
|
|
@@ -33464,6 +33810,12 @@ order has its whole sentence. `{order}` is the deprecated
|
|
|
33464
33810
|
"on:helix-before-reorder"?: ((
|
|
33465
33811
|
e: HelixTableHelixBeforeReorderElementEvent,
|
|
33466
33812
|
) => void) | undefined;
|
|
33813
|
+
/** Fired from a row when its disclosure button is pressed, with whether it would be open in `detail.checked`. Cancelable: cancel it to keep the row as it is. */
|
|
33814
|
+
"on:helix-before-toggle"?: ((
|
|
33815
|
+
e: HelixTableHelixBeforeToggleElementEvent,
|
|
33816
|
+
) => void) | undefined;
|
|
33817
|
+
/** Fired, in a table with `load-more`, when the end of the table comes within a screen of view, once for each number of rows. */
|
|
33818
|
+
"on:helix-load-more"?: ((e: HelixTableHelixLoadMoreElementEvent) => void) | undefined;
|
|
33467
33819
|
/** Fired after `helix-before-reorder` when nobody canceled it. Move your rows to the order in `keys`. Cancelable: cancel it to say the move did not happen. */
|
|
33468
33820
|
"on:helix-reorder"?: ((e: HelixTableHelixReorderElementEvent) => void) | undefined;
|
|
33469
33821
|
/** The selection is about to change. The event carries every selected key, separated by commas. Cancelable: cancel it to keep the current selection. */
|
|
@@ -33474,6 +33826,8 @@ order has its whole sentence. `{order}` is the deprecated
|
|
|
33474
33826
|
"on:helix-sort"?: ((e: HelixTableHelixSortElementEvent) => void) | undefined;
|
|
33475
33827
|
/** Fired after the sort order changes, with the new order. */
|
|
33476
33828
|
"on:helix-sorted"?: ((e: HelixTableHelixSortedElementEvent) => void) | undefined;
|
|
33829
|
+
/** Fired from a row once the rows under it are shown or hidden, with whether it is open in `detail.checked`. */
|
|
33830
|
+
"on:helix-toggle"?: ((e: HelixTableHelixToggleElementEvent) => void) | undefined;
|
|
33477
33831
|
|
|
33478
33832
|
/** Set the innerHTML of the element */
|
|
33479
33833
|
innerHTML?: (string) | undefined;
|
|
@@ -33492,6 +33846,10 @@ reached. */
|
|
|
33492
33846
|
/** The URL a press on the row follows, which makes the whole row a link.
|
|
33493
33847
|
Empty, the default, leaves presses to the row's cells. */
|
|
33494
33848
|
href?: (HelixTableRow["href"]) | undefined;
|
|
33849
|
+
/** The key of the row this one sits under, in a table whose rows nest: that
|
|
33850
|
+
row's `value`, or its place among the rows where it has none. Empty, the
|
|
33851
|
+
default, is a row at the top. */
|
|
33852
|
+
parent?: (HelixTableRow["parent"]) | undefined;
|
|
33495
33853
|
/** The `rel` of the row's link. You set it yourself, as on an anchor. */
|
|
33496
33854
|
rel?: (HelixTableRow["rel"]) | undefined;
|
|
33497
33855
|
/** Where the row's link opens, such as `_blank`. */
|
|
@@ -33512,6 +33870,10 @@ reached. */
|
|
|
33512
33870
|
/** The URL a press on the row follows, which makes the whole row a link.
|
|
33513
33871
|
Empty, the default, leaves presses to the row's cells. */
|
|
33514
33872
|
"prop:href"?: (HelixTableRow["href"]) | undefined;
|
|
33873
|
+
/** The key of the row this one sits under, in a table whose rows nest: that
|
|
33874
|
+
row's `value`, or its place among the rows where it has none. Empty, the
|
|
33875
|
+
default, is a row at the top. */
|
|
33876
|
+
"prop:parent"?: (HelixTableRow["parent"]) | undefined;
|
|
33515
33877
|
/** The `rel` of the row's link. You set it yourself, as on an anchor. */
|
|
33516
33878
|
"prop:rel"?: (HelixTableRow["rel"]) | undefined;
|
|
33517
33879
|
/** Where the row's link opens, such as `_blank`. */
|
|
@@ -36281,13 +36643,35 @@ Whatever `<time>` accepts, which is a date, a time, both, a duration or a
|
|
|
36281
36643
|
week. Unset, the label is written as it was given and nothing claims to
|
|
36282
36644
|
know what instant it names. */
|
|
36283
36645
|
datetime?: (HelixTimelineItem["datetime"]) | undefined;
|
|
36646
|
+
/** Marks an event that has not happened yet, such as one that is scheduled.
|
|
36647
|
+
The mark is the open circle, and a screen reader hears `pending-label`. */
|
|
36648
|
+
pending?: (HelixTimelineItem["pending"]) | undefined;
|
|
36649
|
+
/** What a screen reader hears for an entry that is `pending`. */
|
|
36650
|
+
"pending-label"?: (HelixTimelineItem["pendingLabel"]) | undefined;
|
|
36651
|
+
/** What a screen reader hears for an entry that is `pending`. */
|
|
36652
|
+
pendingLabel?: (HelixTimelineItem["pendingLabel"]) | undefined;
|
|
36284
36653
|
/** Writes the time as how long ago it was, or how long until it, from
|
|
36285
36654
|
`datetime`, where the `time` slot is empty: `long` ("3 hours ago"),
|
|
36286
36655
|
`short` ("3 hr. ago") or `narrow` ("3h ago"). Set with no value, it is
|
|
36287
36656
|
`long`. The words move on as they go stale. */
|
|
36288
36657
|
relative?: (HelixTimelineItem["relative"]) | undefined;
|
|
36289
|
-
/** The kind of event. It sets the color of the mark and
|
|
36658
|
+
/** The kind of event. It sets the color of the mark, and a screen reader
|
|
36659
|
+
hears it as the word `tone-labels` gives it. */
|
|
36290
36660
|
tone?: (HelixTimelineItem["tone"]) | undefined;
|
|
36661
|
+
/** What a screen reader is told this entry's tone is, such as "Failed".
|
|
36662
|
+
Absent is the tone's word in `tone-labels`. */
|
|
36663
|
+
"tone-label"?: (HelixTimelineItem["toneLabel"]) | undefined;
|
|
36664
|
+
/** What a screen reader is told this entry's tone is, such as "Failed".
|
|
36665
|
+
Absent is the tone's word in `tone-labels`. */
|
|
36666
|
+
toneLabel?: (HelixTimelineItem["toneLabel"]) | undefined;
|
|
36667
|
+
/** What a screen reader is told each tone is, by the tone's name, written as
|
|
36668
|
+
JSON in the attribute: `tone-labels='{"danger":"Failed"}'`. A tone with no
|
|
36669
|
+
word is not read, which is `neutral` and `primary` in English. */
|
|
36670
|
+
"tone-labels"?: (HelixTimelineItem["toneLabels"]) | undefined;
|
|
36671
|
+
/** What a screen reader is told each tone is, by the tone's name, written as
|
|
36672
|
+
JSON in the attribute: `tone-labels='{"danger":"Failed"}'`. A tone with no
|
|
36673
|
+
word is not read, which is `neutral` and `primary` in English. */
|
|
36674
|
+
toneLabels?: (HelixTimelineItem["toneLabels"]) | undefined;
|
|
36291
36675
|
};
|
|
36292
36676
|
|
|
36293
36677
|
export type HelixTimelineItemSolidJsProps = {
|
|
@@ -36298,13 +36682,35 @@ Whatever `<time>` accepts, which is a date, a time, both, a duration or a
|
|
|
36298
36682
|
week. Unset, the label is written as it was given and nothing claims to
|
|
36299
36683
|
know what instant it names. */
|
|
36300
36684
|
"prop:datetime"?: (HelixTimelineItem["datetime"]) | undefined;
|
|
36685
|
+
/** Marks an event that has not happened yet, such as one that is scheduled.
|
|
36686
|
+
The mark is the open circle, and a screen reader hears `pending-label`. */
|
|
36687
|
+
"prop:pending"?: (HelixTimelineItem["pending"]) | undefined;
|
|
36688
|
+
/** What a screen reader hears for an entry that is `pending`. */
|
|
36689
|
+
"attr:pending-label"?: (HelixTimelineItem["pendingLabel"]) | undefined;
|
|
36690
|
+
/** What a screen reader hears for an entry that is `pending`. */
|
|
36691
|
+
"prop:pendingLabel"?: (HelixTimelineItem["pendingLabel"]) | undefined;
|
|
36301
36692
|
/** Writes the time as how long ago it was, or how long until it, from
|
|
36302
36693
|
`datetime`, where the `time` slot is empty: `long` ("3 hours ago"),
|
|
36303
36694
|
`short` ("3 hr. ago") or `narrow` ("3h ago"). Set with no value, it is
|
|
36304
36695
|
`long`. The words move on as they go stale. */
|
|
36305
36696
|
"prop:relative"?: (HelixTimelineItem["relative"]) | undefined;
|
|
36306
|
-
/** The kind of event. It sets the color of the mark and
|
|
36697
|
+
/** The kind of event. It sets the color of the mark, and a screen reader
|
|
36698
|
+
hears it as the word `tone-labels` gives it. */
|
|
36307
36699
|
"prop:tone"?: (HelixTimelineItem["tone"]) | undefined;
|
|
36700
|
+
/** What a screen reader is told this entry's tone is, such as "Failed".
|
|
36701
|
+
Absent is the tone's word in `tone-labels`. */
|
|
36702
|
+
"attr:tone-label"?: (HelixTimelineItem["toneLabel"]) | undefined;
|
|
36703
|
+
/** What a screen reader is told this entry's tone is, such as "Failed".
|
|
36704
|
+
Absent is the tone's word in `tone-labels`. */
|
|
36705
|
+
"prop:toneLabel"?: (HelixTimelineItem["toneLabel"]) | undefined;
|
|
36706
|
+
/** What a screen reader is told each tone is, by the tone's name, written as
|
|
36707
|
+
JSON in the attribute: `tone-labels='{"danger":"Failed"}'`. A tone with no
|
|
36708
|
+
word is not read, which is `neutral` and `primary` in English. */
|
|
36709
|
+
"attr:tone-labels"?: (HelixTimelineItem["toneLabels"]) | undefined;
|
|
36710
|
+
/** What a screen reader is told each tone is, by the tone's name, written as
|
|
36711
|
+
JSON in the attribute: `tone-labels='{"danger":"Failed"}'`. A tone with no
|
|
36712
|
+
word is not read, which is `neutral` and `primary` in English. */
|
|
36713
|
+
"prop:toneLabels"?: (HelixTimelineItem["toneLabels"]) | undefined;
|
|
36308
36714
|
|
|
36309
36715
|
/** Set the innerHTML of the element */
|
|
36310
36716
|
innerHTML?: (string) | undefined;
|
|
@@ -38692,6 +39098,13 @@ Written by the playlist rather than by the entry, the way an option's
|
|
|
38692
39098
|
selection is: an entry that made itself current would be a second answer to
|
|
38693
39099
|
which one is playing. */
|
|
38694
39100
|
current?: (HelixVideoPlaylistItem["current"]) | undefined;
|
|
39101
|
+
/** Whether the entry holds the playlist's tab stop. Unset, every entry is in
|
|
39102
|
+
the tab order, which is what a server renders.
|
|
39103
|
+
|
|
39104
|
+
**Written by the playlist, with no attribute, and it reaches the button.**
|
|
39105
|
+
The playlist gives the stop to the entry a reader last focused, or to the
|
|
39106
|
+
current one, and the arrow keys reach the rest. */
|
|
39107
|
+
focusable?: (HelixVideoPlaylistItem["focusable"]) | undefined;
|
|
38695
39108
|
|
|
38696
39109
|
/** The entry was chosen. Cancelable: cancel it to keep the current entry. */
|
|
38697
39110
|
"onhelix-select"?: ((e: HelixVideoPlaylistItemHelixSelectElementEvent) => void) | undefined;
|
|
@@ -38718,6 +39131,13 @@ Written by the playlist rather than by the entry, the way an option's
|
|
|
38718
39131
|
selection is: an entry that made itself current would be a second answer to
|
|
38719
39132
|
which one is playing. */
|
|
38720
39133
|
"prop:current"?: (HelixVideoPlaylistItem["current"]) | undefined;
|
|
39134
|
+
/** Whether the entry holds the playlist's tab stop. Unset, every entry is in
|
|
39135
|
+
the tab order, which is what a server renders.
|
|
39136
|
+
|
|
39137
|
+
**Written by the playlist, with no attribute, and it reaches the button.**
|
|
39138
|
+
The playlist gives the stop to the entry a reader last focused, or to the
|
|
39139
|
+
current one, and the arrow keys reach the rest. */
|
|
39140
|
+
"prop:focusable"?: (HelixVideoPlaylistItem["focusable"]) | undefined;
|
|
38721
39141
|
/** The entry was chosen. Cancelable: cancel it to keep the current entry. */
|
|
38722
39142
|
"on:helix-select"?: ((
|
|
38723
39143
|
e: HelixVideoPlaylistItemHelixSelectElementEvent,
|
|
@@ -38809,8 +39229,20 @@ Ignored once `active` is written. */
|
|
|
38809
39229
|
|
|
38810
39230
|
Ignored once `active` is written. */
|
|
38811
39231
|
defaultActive?: (HelixVideoPlaylist["defaultActive"]) | undefined;
|
|
39232
|
+
/** What the playlist says while it has no entries. The `empty` slot replaces it. */
|
|
39233
|
+
"empty-label"?: (HelixVideoPlaylist["emptyLabel"]) | undefined;
|
|
39234
|
+
/** What the playlist says while it has no entries. The `empty` slot replaces it. */
|
|
39235
|
+
emptyLabel?: (HelixVideoPlaylist["emptyLabel"]) | undefined;
|
|
38812
39236
|
/** The list's name, read by screen readers. */
|
|
38813
39237
|
label?: (HelixVideoPlaylist["label"]) | undefined;
|
|
39238
|
+
/** Stays on an entry when its clip ends, where the playlist would otherwise
|
|
39239
|
+
play the next one. The player's controls, a press, and `next()` still
|
|
39240
|
+
move. `repeat="one"` still plays the entry again. */
|
|
39241
|
+
"no-advance"?: (HelixVideoPlaylist["noAdvance"]) | undefined;
|
|
39242
|
+
/** Stays on an entry when its clip ends, where the playlist would otherwise
|
|
39243
|
+
play the next one. The player's controls, a press, and `next()` still
|
|
39244
|
+
move. `repeat="one"` still plays the entry again. */
|
|
39245
|
+
noAdvance?: (HelixVideoPlaylist["noAdvance"]) | undefined;
|
|
38814
39246
|
/** What the live region says when the playlist moves to another entry.
|
|
38815
39247
|
`{title}` is the entry's name.
|
|
38816
39248
|
|
|
@@ -38840,7 +39272,7 @@ arrives or leaves, so previous goes back through what has played. */
|
|
|
38840
39272
|
|
|
38841
39273
|
/** The current entry changed. The playlist already holds the new entry when this is sent, and `detail.previous` is the entry it left. `currentEntry` is the entry itself, with its `src`, `poster` and name. */
|
|
38842
39274
|
"onhelix-activate"?: ((e: HelixVideoPlaylistHelixActivateElementEvent) => void) | undefined;
|
|
38843
|
-
/** The current entry is about to change. Cancelable: cancel it to keep the current entry. */
|
|
39275
|
+
/** The current entry is about to change, and `detail.cause` says why: `press`, `next`, `previous`, `ended`, or `removed`. Cancelable: cancel it to keep the current entry. */
|
|
38844
39276
|
"onhelix-before-activate"?: ((
|
|
38845
39277
|
e: HelixVideoPlaylistHelixBeforeActivateElementEvent,
|
|
38846
39278
|
) => void) | undefined;
|
|
@@ -38866,8 +39298,20 @@ Ignored once `active` is written. */
|
|
|
38866
39298
|
|
|
38867
39299
|
Ignored once `active` is written. */
|
|
38868
39300
|
"prop:defaultActive"?: (HelixVideoPlaylist["defaultActive"]) | undefined;
|
|
39301
|
+
/** What the playlist says while it has no entries. The `empty` slot replaces it. */
|
|
39302
|
+
"attr:empty-label"?: (HelixVideoPlaylist["emptyLabel"]) | undefined;
|
|
39303
|
+
/** What the playlist says while it has no entries. The `empty` slot replaces it. */
|
|
39304
|
+
"prop:emptyLabel"?: (HelixVideoPlaylist["emptyLabel"]) | undefined;
|
|
38869
39305
|
/** The list's name, read by screen readers. */
|
|
38870
39306
|
"prop:label"?: (HelixVideoPlaylist["label"]) | undefined;
|
|
39307
|
+
/** Stays on an entry when its clip ends, where the playlist would otherwise
|
|
39308
|
+
play the next one. The player's controls, a press, and `next()` still
|
|
39309
|
+
move. `repeat="one"` still plays the entry again. */
|
|
39310
|
+
"bool:no-advance"?: (HelixVideoPlaylist["noAdvance"]) | undefined;
|
|
39311
|
+
/** Stays on an entry when its clip ends, where the playlist would otherwise
|
|
39312
|
+
play the next one. The player's controls, a press, and `next()` still
|
|
39313
|
+
move. `repeat="one"` still plays the entry again. */
|
|
39314
|
+
"prop:noAdvance"?: (HelixVideoPlaylist["noAdvance"]) | undefined;
|
|
38871
39315
|
/** What the live region says when the playlist moves to another entry.
|
|
38872
39316
|
`{title}` is the entry's name.
|
|
38873
39317
|
|
|
@@ -38898,7 +39342,7 @@ arrives or leaves, so previous goes back through what has played. */
|
|
|
38898
39342
|
"on:helix-activate"?: ((
|
|
38899
39343
|
e: HelixVideoPlaylistHelixActivateElementEvent,
|
|
38900
39344
|
) => void) | undefined;
|
|
38901
|
-
/** The current entry is about to change. Cancelable: cancel it to keep the current entry. */
|
|
39345
|
+
/** The current entry is about to change, and `detail.cause` says why: `press`, `next`, `previous`, `ended`, or `removed`. Cancelable: cancel it to keep the current entry. */
|
|
38902
39346
|
"on:helix-before-activate"?: ((
|
|
38903
39347
|
e: HelixVideoPlaylistHelixBeforeActivateElementEvent,
|
|
38904
39348
|
) => void) | undefined;
|
|
@@ -39938,6 +40382,12 @@ export type HelixVirtualListProps = {
|
|
|
39938
40382
|
items out as a grid of that many equal columns, windowed a line at a
|
|
39939
40383
|
time, with Left and Right moving along a line. */
|
|
39940
40384
|
columns?: (HelixVirtualList["columns"]) | undefined;
|
|
40385
|
+
/** The keys of the items a reader cannot choose or move to, separated by
|
|
40386
|
+
commas, as `value` writes keys. Their rows carry `aria-disabled`. */
|
|
40387
|
+
"disabled-keys"?: (HelixVirtualList["disabledKeys"]) | undefined;
|
|
40388
|
+
/** The keys of the items a reader cannot choose or move to, separated by
|
|
40389
|
+
commas, as `value` writes keys. Their rows carry `aria-disabled`. */
|
|
40390
|
+
disabledKeys?: (HelixVirtualList["disabledKeys"]) | undefined;
|
|
39941
40391
|
/** The text of the row shown when there are no items and none are loading,
|
|
39942
40392
|
where the `empty` slot is empty. Empty, the default, shows no row. */
|
|
39943
40393
|
"empty-label"?: (HelixVirtualList["emptyLabel"]) | undefined;
|
|
@@ -39952,6 +40402,11 @@ right whenever the rows really are one height and is the cheaper of the two. */
|
|
|
39952
40402
|
/** The id of the script element that holds the items as JSON. `items` wins
|
|
39953
40403
|
where both are set. */
|
|
39954
40404
|
for?: (HelixVirtualList["for"]) | undefined;
|
|
40405
|
+
/** The space between two rows, and between two columns in a grid, in
|
|
40406
|
+
pixels. The list counts it in each row's place, so a gap does not walk
|
|
40407
|
+
the rows away from the scroll position the way a margin on each row
|
|
40408
|
+
would. */
|
|
40409
|
+
gap?: (HelixVirtualList["gap"]) | undefined;
|
|
39955
40410
|
/** The field of each item that is its key in `value`, as a key or a path of
|
|
39956
40411
|
keys. Empty reads a string or a number item as its own key, and any
|
|
39957
40412
|
other item by its place in the set. */
|
|
@@ -39987,6 +40442,22 @@ disagree with itself; measuring is what a set of genuinely different
|
|
|
39987
40442
|
heights needs and costs a read of each row as it renders. A list of
|
|
39988
40443
|
one-line rows should leave this alone. */
|
|
39989
40444
|
measured?: (HelixVirtualList["measured"]) | undefined;
|
|
40445
|
+
/** The narrowest a column of a grid may be, in pixels. Set, the list lays
|
|
40446
|
+
out as many columns as fit the box at that width, at least one, and
|
|
40447
|
+
follows the box as it resizes, which `columns` then does not decide. */
|
|
40448
|
+
"min-column-width"?: (HelixVirtualList["minColumnWidth"] | `${number}`) | undefined;
|
|
40449
|
+
/** The narrowest a column of a grid may be, in pixels. Set, the list lays
|
|
40450
|
+
out as many columns as fit the box at that width, at least one, and
|
|
40451
|
+
follows the box as it resizes, which `columns` then does not decide. */
|
|
40452
|
+
minColumnWidth?: (HelixVirtualList["minColumnWidth"]) | undefined;
|
|
40453
|
+
/** What a press does to the items already chosen: `toggle` adds or takes out
|
|
40454
|
+
the item, and `replace` selects it alone and lets the arrow keys carry the
|
|
40455
|
+
selection, with Control or Command adding or taking out one item. */
|
|
40456
|
+
"selection-behavior"?: (HelixVirtualList["selectionBehavior"]) | undefined;
|
|
40457
|
+
/** What a press does to the items already chosen: `toggle` adds or takes out
|
|
40458
|
+
the item, and `replace` selects it alone and lets the arrow keys carry the
|
|
40459
|
+
selection, with Control or Command adding or taking out one item. */
|
|
40460
|
+
selectionBehavior?: (HelixVirtualList["selectionBehavior"]) | undefined;
|
|
39990
40461
|
/** Makes the list a list box a reader chooses from: `single` selects one
|
|
39991
40462
|
item, and `multiple` any number. Unset is a list a reader reads. */
|
|
39992
40463
|
"selection-mode"?: (HelixVirtualList["selectionMode"]) | undefined;
|
|
@@ -40041,6 +40512,12 @@ export type HelixVirtualListSolidJsProps = {
|
|
|
40041
40512
|
items out as a grid of that many equal columns, windowed a line at a
|
|
40042
40513
|
time, with Left and Right moving along a line. */
|
|
40043
40514
|
"prop:columns"?: (HelixVirtualList["columns"]) | undefined;
|
|
40515
|
+
/** The keys of the items a reader cannot choose or move to, separated by
|
|
40516
|
+
commas, as `value` writes keys. Their rows carry `aria-disabled`. */
|
|
40517
|
+
"attr:disabled-keys"?: (HelixVirtualList["disabledKeys"]) | undefined;
|
|
40518
|
+
/** The keys of the items a reader cannot choose or move to, separated by
|
|
40519
|
+
commas, as `value` writes keys. Their rows carry `aria-disabled`. */
|
|
40520
|
+
"prop:disabledKeys"?: (HelixVirtualList["disabledKeys"]) | undefined;
|
|
40044
40521
|
/** The text of the row shown when there are no items and none are loading,
|
|
40045
40522
|
where the `empty` slot is empty. Empty, the default, shows no row. */
|
|
40046
40523
|
"attr:empty-label"?: (HelixVirtualList["emptyLabel"]) | undefined;
|
|
@@ -40055,6 +40532,11 @@ right whenever the rows really are one height and is the cheaper of the two. */
|
|
|
40055
40532
|
/** The id of the script element that holds the items as JSON. `items` wins
|
|
40056
40533
|
where both are set. */
|
|
40057
40534
|
"prop:for"?: (HelixVirtualList["for"]) | undefined;
|
|
40535
|
+
/** The space between two rows, and between two columns in a grid, in
|
|
40536
|
+
pixels. The list counts it in each row's place, so a gap does not walk
|
|
40537
|
+
the rows away from the scroll position the way a margin on each row
|
|
40538
|
+
would. */
|
|
40539
|
+
"prop:gap"?: (HelixVirtualList["gap"]) | undefined;
|
|
40058
40540
|
/** The field of each item that is its key in `value`, as a key or a path of
|
|
40059
40541
|
keys. Empty reads a string or a number item as its own key, and any
|
|
40060
40542
|
other item by its place in the set. */
|
|
@@ -40090,6 +40572,22 @@ disagree with itself; measuring is what a set of genuinely different
|
|
|
40090
40572
|
heights needs and costs a read of each row as it renders. A list of
|
|
40091
40573
|
one-line rows should leave this alone. */
|
|
40092
40574
|
"prop:measured"?: (HelixVirtualList["measured"]) | undefined;
|
|
40575
|
+
/** The narrowest a column of a grid may be, in pixels. Set, the list lays
|
|
40576
|
+
out as many columns as fit the box at that width, at least one, and
|
|
40577
|
+
follows the box as it resizes, which `columns` then does not decide. */
|
|
40578
|
+
"attr:min-column-width"?: (HelixVirtualList["minColumnWidth"] | `${number}`) | undefined;
|
|
40579
|
+
/** The narrowest a column of a grid may be, in pixels. Set, the list lays
|
|
40580
|
+
out as many columns as fit the box at that width, at least one, and
|
|
40581
|
+
follows the box as it resizes, which `columns` then does not decide. */
|
|
40582
|
+
"prop:minColumnWidth"?: (HelixVirtualList["minColumnWidth"]) | undefined;
|
|
40583
|
+
/** What a press does to the items already chosen: `toggle` adds or takes out
|
|
40584
|
+
the item, and `replace` selects it alone and lets the arrow keys carry the
|
|
40585
|
+
selection, with Control or Command adding or taking out one item. */
|
|
40586
|
+
"attr:selection-behavior"?: (HelixVirtualList["selectionBehavior"]) | undefined;
|
|
40587
|
+
/** What a press does to the items already chosen: `toggle` adds or takes out
|
|
40588
|
+
the item, and `replace` selects it alone and lets the arrow keys carry the
|
|
40589
|
+
selection, with Control or Command adding or taking out one item. */
|
|
40590
|
+
"prop:selectionBehavior"?: (HelixVirtualList["selectionBehavior"]) | undefined;
|
|
40093
40591
|
/** Makes the list a list box a reader chooses from: `single` selects one
|
|
40094
40592
|
item, and `multiple` any number. Unset is a list a reader reads. */
|
|
40095
40593
|
"attr:selection-mode"?: (HelixVirtualList["selectionMode"]) | undefined;
|
|
@@ -43289,6 +43787,7 @@ export type CustomElements = {
|
|
|
43289
43787
|
* this, so a reader hears the ends first and what the line says after.
|
|
43290
43788
|
* - `controls-label`/`controlsLabel`: The name of the group of controls, read by screen readers, which names
|
|
43291
43789
|
* what the controls drive rather than the mechanism.
|
|
43790
|
+
* - `copied-label`/`copiedLabel`: What screen readers hear after a copy, with `{count}` for the cards copied.
|
|
43292
43791
|
* - `fallback-label`/`fallbackLabel`: The board's name where `label` is empty.
|
|
43293
43792
|
* - `label`: The accessible name for the board. Required.
|
|
43294
43793
|
*
|
|
@@ -43334,6 +43833,7 @@ export type CustomElements = {
|
|
|
43334
43833
|
* walk the cards.
|
|
43335
43834
|
* - `reconnecting-label`/`reconnectingLabel`: The text announced when a connection's end is picked up, with `{from}` and
|
|
43336
43835
|
* `{to}`.
|
|
43836
|
+
* - `redone-label`/`redoneLabel`: What screen readers hear after a move or a resize is made again.
|
|
43337
43837
|
* - `resized-label`/`resizedLabel`: What screen readers hear after a key resizes a card, with `{name}` for the
|
|
43338
43838
|
* card and `{width}` and `{height}` for its new size, in the document's
|
|
43339
43839
|
* units.
|
|
@@ -43391,6 +43891,7 @@ export type CustomElements = {
|
|
|
43391
43891
|
* see the board is told by the color; this is how a reader who cannot is
|
|
43392
43892
|
* told the same. A tone left out is not read.
|
|
43393
43893
|
* - `two-finger-hint-label`/`twoFingerHintLabel`: The hint shown when one finger swipes over the board with `gestures="cooperative"`.
|
|
43894
|
+
* - `undone-label`/`undoneLabel`: What screen readers hear after a move or a resize is undone.
|
|
43394
43895
|
* - `using-label`/`usingLabel`: The line shown while the board, with `gestures="activate"`, has the gestures.
|
|
43395
43896
|
* - `wheel-hint-label`/`wheelHintLabel`: The hint shown when the wheel scrolls past the board with
|
|
43396
43897
|
* `gestures="cooperative"`. `{key}` is ⌘ on a Mac and Ctrl elsewhere.
|
|
@@ -43472,6 +43973,11 @@ export type CustomElements = {
|
|
|
43472
43973
|
*
|
|
43473
43974
|
* What a reader landing on a card off the edge of the view gets, and what a
|
|
43474
43975
|
* page's own search or outline can call to take a reader to one.
|
|
43976
|
+
* - `undo() => boolean`: Puts the cards of the last move or resize back where they stood, asking
|
|
43977
|
+
* with `helix-before-move` first. Returns whether anything moved: false
|
|
43978
|
+
* with nothing to undo, or when the request was refused.
|
|
43979
|
+
* - `redo() => boolean`: Makes the last move or resize `undo` took back again, asking with
|
|
43980
|
+
* `helix-before-move` first. Returns whether anything moved.
|
|
43475
43981
|
* - `toJsonCanvas() => CanvasDocument`: The board as a JSON Canvas document, for saving it.
|
|
43476
43982
|
*
|
|
43477
43983
|
* What each card holds is the consumer's DOM, so a card comes back as a card
|
|
@@ -44457,6 +44963,7 @@ export type CustomElements = {
|
|
|
44457
44963
|
* is the way back, and that is a part inside the shadow tree where a
|
|
44458
44964
|
* stylesheet can already reach it. Measured rather than assumed: `label,
|
|
44459
44965
|
* pinned` after upgrade against `label` from the server.
|
|
44966
|
+
* - `resume-label`/`resumeLabel`: The words on the button that returns to the newest turn, where `resume` is empty.
|
|
44460
44967
|
* - `threshold`: How near the bottom still counts as being at it, in pixels.
|
|
44461
44968
|
*
|
|
44462
44969
|
* A hook rather than a constant, because the right number depends on how tall
|
|
@@ -44585,6 +45092,8 @@ export type CustomElements = {
|
|
|
44585
45092
|
* - `message-state`: The state text of a turn from `turns`, when there is one to show.
|
|
44586
45093
|
* - `message-time`: The time of a turn from `turns`.
|
|
44587
45094
|
* - `resume`: The control shown while the user is scrolled away from the bottom.
|
|
45095
|
+
* - `resume-button`: The button the `resume` region shows when nothing is slotted into it.
|
|
45096
|
+
* - `resume-mark`: The arrow on the default `resume-button`.
|
|
44588
45097
|
* - `status`: The status region, outside the log.
|
|
44589
45098
|
* - `turn`: The wrapper around the message drawn for one turn from `turns`.
|
|
44590
45099
|
* - `typing`: The words that say who is typing, in the status band, while `typing` names someone.
|
|
@@ -45111,18 +45620,13 @@ export type CustomElements = {
|
|
|
45111
45620
|
*
|
|
45112
45621
|
* Long lines scroll by default. Set `wrap` to wrap them instead, for prose-like
|
|
45113
45622
|
* code such as a long command, and set `--code-block-max-block-size` to cap the
|
|
45114
|
-
* height of a long file, which then scrolls.
|
|
45623
|
+
* height of a long file, which then scrolls. A line `mark-lines` names takes a
|
|
45624
|
+
* band in the primary color, with an edge at its start.
|
|
45115
45625
|
*
|
|
45116
45626
|
* ## Attributes & Properties
|
|
45117
45627
|
*
|
|
45118
45628
|
* Component attributes and properties that can be applied to the element or by using JavaScript.
|
|
45119
45629
|
*
|
|
45120
|
-
* - `wrap`: Whether long lines wrap.
|
|
45121
|
-
*
|
|
45122
|
-
* Off by default, so long lines scroll, because a line break can be
|
|
45123
|
-
* significant in code and a wrapped line reads as two. For prose-like code, such as a long command or
|
|
45124
|
-
* a log line, a wrap reads better than a scroll. Line numbers keep the lines
|
|
45125
|
-
* unwrapped, since a wrapped line would take one number and several rows.
|
|
45126
45630
|
* - `code-label`/`codeLabel`: The name of a block that scrolls, which is a tab stop while it does.
|
|
45127
45631
|
*
|
|
45128
45632
|
* Where the block has a name, the scroller says it too, such as "Code,
|
|
@@ -45166,6 +45670,9 @@ export type CustomElements = {
|
|
|
45166
45670
|
* copy, which takes the code alone. Reflected, because the stylesheet lays
|
|
45167
45671
|
* the gutter out beside the code. A diff numbers its lines from its hunks
|
|
45168
45672
|
* whether or not this is set.
|
|
45673
|
+
* - `mark-lines`/`markLines`: The lines to mark, as numbers and ranges counted from 1, such as `2, 4-6`.
|
|
45674
|
+
* Each run is drawn as a band behind its lines. Not for a diff, which marks
|
|
45675
|
+
* its own changes.
|
|
45169
45676
|
* - `no-copy`/`noCopy`: Whether to leave the copy button off.
|
|
45170
45677
|
*
|
|
45171
45678
|
* Negative, which is not a style choice. A boolean attribute is true whenever
|
|
@@ -45190,6 +45697,17 @@ export type CustomElements = {
|
|
|
45190
45697
|
* Absent is unified, each removal above its replacement, which fits any
|
|
45191
45698
|
* width. `split` sets the old version beside the new one. Optional rather
|
|
45192
45699
|
* than defaulted, so the host carries no attribute the consumer did not write.
|
|
45700
|
+
* - `wrap`: Whether long lines wrap. Without it they scroll.
|
|
45701
|
+
*
|
|
45702
|
+
* Off by default, so long lines scroll, because a line break can be
|
|
45703
|
+
* significant in code and a wrapped line reads as two. For prose-like code,
|
|
45704
|
+
* such as a long command or a log line, a wrap reads better than a scroll.
|
|
45705
|
+
* With `line-numbers`, each number stands beside the line it numbers
|
|
45706
|
+
* however many rows that line takes. Reflected, because the stylesheet
|
|
45707
|
+
* wraps the lines.
|
|
45708
|
+
* - `wrap-label`/`wrapLabel`: The wrap button's name, which it keeps whether it is pressed or not.
|
|
45709
|
+
* - `wrappable`: Whether the header has a button that wraps the lines and unwraps them. The
|
|
45710
|
+
* block draws a header for it even with no name.
|
|
45193
45711
|
* - `highlight`: Turns the code into highlighted markup, which the block draws in place of
|
|
45194
45712
|
* the plain text.
|
|
45195
45713
|
*
|
|
@@ -45232,11 +45750,21 @@ export type CustomElements = {
|
|
|
45232
45750
|
* browser harness's awaits it alone: a browser always runs the frame, and a
|
|
45233
45751
|
* timer beside it was a bet on how long one takes, which a busy run lost. (property only) (readonly)
|
|
45234
45752
|
*
|
|
45753
|
+
* ## Events
|
|
45754
|
+
*
|
|
45755
|
+
* Events that will be emitted by the component.
|
|
45756
|
+
*
|
|
45757
|
+
* - `helix-before-toggle`: The wrap button was pressed, with the `wrap` it asks for in `detail.checked`. Cancelable: cancel it to keep the lines as they are.
|
|
45758
|
+
* - `helix-toggle`: Fired after the wrap button changed `wrap`, with the new value in `detail.checked`.
|
|
45759
|
+
*
|
|
45235
45760
|
* ## Slots
|
|
45236
45761
|
*
|
|
45237
45762
|
* Areas where markup can be added to the component.
|
|
45238
45763
|
*
|
|
45239
45764
|
* - `(default)`: The code.
|
|
45765
|
+
* - `actions`: Controls for the block, in the header before the copy button.
|
|
45766
|
+
* - `copied-icon`: The copy button's icon after a copy. Defaults to a check mark.
|
|
45767
|
+
* - `copy-icon`: The copy button's icon before a copy. Defaults to a clipboard.
|
|
45240
45768
|
*
|
|
45241
45769
|
* ## CSS Custom Properties
|
|
45242
45770
|
*
|
|
@@ -45254,14 +45782,21 @@ export type CustomElements = {
|
|
|
45254
45782
|
* - `--code-block-header-background-color`: The background behind the name. The default is `surface-raised`.
|
|
45255
45783
|
* - `--code-block-label-color`: The color of the name in the header.
|
|
45256
45784
|
* - `--code-block-line-height`: The line height of the code and its line numbers, as a number or a length.
|
|
45785
|
+
* - `--code-block-mark-color`: The band behind the lines `mark-lines` names. The primary color at a wash by default.
|
|
45786
|
+
* - `--code-block-mark-edge-color`: The edge at the start of a band behind marked lines. The primary color by default.
|
|
45257
45787
|
* - `--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.
|
|
45258
45788
|
* - `--code-block-radius`: The corner radius of the header's top and the block's bottom, which form one shape.
|
|
45259
45789
|
* - `--code-block-removed-color`: The color a diff's removed lines are tinted in and their `-` is drawn in. The danger color by default.
|
|
45790
|
+
* - `--code-block-line-size`: Written by the block on each `number` in a `wrap` block with `line-numbers`: how tall the line it numbers is laid out. Do not set it.
|
|
45791
|
+
* - `--code-block-mark-inline-size`: Written by the block on each `mark`: how wide the code is, scrolled part included. Do not set it.
|
|
45792
|
+
* - `--code-block-mark-size`: Written by the block on each `mark`: how tall its run of lines is. Do not set it.
|
|
45793
|
+
* - `--code-block-mark-start`: Written by the block on each `mark`: how far down the code its run of lines starts. Do not set it.
|
|
45260
45794
|
*
|
|
45261
45795
|
* ## CSS Parts
|
|
45262
45796
|
*
|
|
45263
45797
|
* Custom selectors for styling elements within the component.
|
|
45264
45798
|
*
|
|
45799
|
+
* - `actions`: The box in the header that holds the `actions` slot, drawn while something is slotted there.
|
|
45265
45800
|
* - `added`: In a diff, a line only the new version has, an `<ins>`.
|
|
45266
45801
|
* - `block`: The scrolling `<pre>`.
|
|
45267
45802
|
* - `code`: The `<code>` inside it.
|
|
@@ -45290,13 +45825,15 @@ export type CustomElements = {
|
|
|
45290
45825
|
* - `header`: The bar that holds the name and the copy button, shown when there is a name.
|
|
45291
45826
|
* - `hunk`: In a diff, a `@@` line saying where the lines under it are.
|
|
45292
45827
|
* - `label`: The block's name: its `label`, or its `language` where it has no label.
|
|
45828
|
+
* - `mark`: The band behind a run of lines `mark-lines` names. The block writes where the run is laid out into `--code-block-mark-start`, `--code-block-mark-size`, and `--code-block-mark-inline-size` on it. Hidden from the accessibility tree.
|
|
45293
45829
|
* - `marker`: In a diff, the `+`, `-`, or space that starts a line.
|
|
45294
45830
|
* - `new`: In a split diff, the new version's `<pre>`.
|
|
45295
|
-
* - `number`: In a diff, a line number.
|
|
45831
|
+
* - `number`: In a diff, a line number. In a `wrap` block with `line-numbers`, one line's number in the gutter, which the block makes as tall as the line it numbers through `--code-block-line-size`.
|
|
45296
45832
|
* - `old`: In a split diff, the old version's `<pre>`.
|
|
45297
45833
|
* - `removed`: In a diff, a line only the old version has, a `<del>`.
|
|
45298
45834
|
* - `split`: In a split diff, the two versions side by side.
|
|
45299
45835
|
* - `text`: In a diff, a line's code.
|
|
45836
|
+
* - `wrap-toggle`: The button in the header that wraps the lines and unwraps them, drawn when `wrappable` is set.
|
|
45300
45837
|
*
|
|
45301
45838
|
* ## CSS States
|
|
45302
45839
|
*
|
|
@@ -51138,14 +51675,15 @@ export type CustomElements = {
|
|
|
51138
51675
|
* - `pan(to: ViewportWay) => void`: Pans the view one step in a direction.
|
|
51139
51676
|
* - `zoom(by: number) => void`: Zooms the view one step: `1` zooms in and `-1` zooms out.
|
|
51140
51677
|
* - `toggleFullscreen() => void`: Turns fullscreen on or off.
|
|
51141
|
-
* - `requestActive(next: string) => boolean`: Requests a new current item, and returns whether the change was applied.
|
|
51678
|
+
* - `requestActive(next: string, cause?: string) => boolean`: Requests a new current item, and returns whether the change was applied.
|
|
51142
51679
|
*
|
|
51143
51680
|
* Announces before it acts, so `preventDefault()` on the `helix-before-activate` is
|
|
51144
51681
|
* a refusal and nothing moves. Unlike a native control, nothing has moved
|
|
51145
51682
|
* by the time this runs, so refusing is simply not writing: there is
|
|
51146
51683
|
* nothing to put back. Nobody refusing means the set updates itself,
|
|
51147
51684
|
* whether or not a consumer declared `active`, a declared property being a
|
|
51148
|
-
* seed and a correction.
|
|
51685
|
+
* seed and a correction. `cause` says why, where the family names its
|
|
51686
|
+
* causes, and reaches the event as `detail.cause`.
|
|
51149
51687
|
* - `drawn(whole = true) => void`: Says the graph has been drawn whole, or with `false`, that it no longer
|
|
51150
51688
|
* is. Called by `connectGraph` once its layout has settled; a page drawing
|
|
51151
51689
|
* its own graph calls it when that graph is finished. The first call after
|
|
@@ -53114,14 +53652,15 @@ export type CustomElements = {
|
|
|
53114
53652
|
*
|
|
53115
53653
|
* Methods that can be called to access component functionality.
|
|
53116
53654
|
*
|
|
53117
|
-
* - `requestActive(next: string) => boolean`: Requests a new current item, and returns whether the change was applied.
|
|
53655
|
+
* - `requestActive(next: string, cause?: string) => boolean`: Requests a new current item, and returns whether the change was applied.
|
|
53118
53656
|
*
|
|
53119
53657
|
* Announces before it acts, so `preventDefault()` on the `helix-before-activate` is
|
|
53120
53658
|
* a refusal and nothing moves. Unlike a native control, nothing has moved
|
|
53121
53659
|
* by the time this runs, so refusing is simply not writing: there is
|
|
53122
53660
|
* nothing to put back. Nobody refusing means the set updates itself,
|
|
53123
53661
|
* whether or not a consumer declared `active`, a declared property being a
|
|
53124
|
-
* seed and a correction.
|
|
53662
|
+
* seed and a correction. `cause` says why, where the family names its
|
|
53663
|
+
* causes, and reaches the event as `detail.cause`.
|
|
53125
53664
|
* - `requestOpen(next: boolean) => boolean`: Requests that the element open or close, and returns whether the change
|
|
53126
53665
|
* was applied.
|
|
53127
53666
|
*
|
|
@@ -62530,6 +63069,13 @@ export type CustomElements = {
|
|
|
62530
63069
|
* only whoever put it there knows that, which is the same reason `min` is a
|
|
62531
63070
|
* consumer's to set.
|
|
62532
63071
|
* - `corner-label`/`cornerLabel`: The name of the handle where two dividers cross, read by screen readers.
|
|
63072
|
+
* - `corner-value-label`/`cornerValueLabel`: What the handle where two dividers cross says it is set to, both dividers
|
|
63073
|
+
* at once: `{across}` is where the divider that runs down stands, and
|
|
63074
|
+
* `{down}` where the one that runs across stands, each a percentage.
|
|
63075
|
+
*
|
|
63076
|
+
* **Both, because the handle moves both**, and a number names one: the
|
|
63077
|
+
* handle's `aria-valuenow` is the divider its `aria-orientation` names, and
|
|
63078
|
+
* these words are the whole of where it is.
|
|
62533
63079
|
* - `default-collapsed`/`defaultCollapsed`: Which pane starts shut, when `collapsed` is not set.
|
|
62534
63080
|
* - `default-position`/`defaultPosition`: Where the divider starts, when `position` is not set.
|
|
62535
63081
|
* - `label`: The divider's name, read by screen readers.
|
|
@@ -62982,14 +63528,15 @@ export type CustomElements = {
|
|
|
62982
63528
|
*
|
|
62983
63529
|
* Methods that can be called to access component functionality.
|
|
62984
63530
|
*
|
|
62985
|
-
* - `requestActive(next: string) => boolean`: Requests a new current item, and returns whether the change was applied.
|
|
63531
|
+
* - `requestActive(next: string, cause?: string) => boolean`: Requests a new current item, and returns whether the change was applied.
|
|
62986
63532
|
*
|
|
62987
63533
|
* Announces before it acts, so `preventDefault()` on the `helix-before-activate` is
|
|
62988
63534
|
* a refusal and nothing moves. Unlike a native control, nothing has moved
|
|
62989
63535
|
* by the time this runs, so refusing is simply not writing: there is
|
|
62990
63536
|
* nothing to put back. Nobody refusing means the set updates itself,
|
|
62991
63537
|
* whether or not a consumer declared `active`, a declared property being a
|
|
62992
|
-
* seed and a correction.
|
|
63538
|
+
* seed and a correction. `cause` says why, where the family names its
|
|
63539
|
+
* causes, and reaches the event as `detail.cause`.
|
|
62993
63540
|
* - `next() => boolean`: Moves to the next stage that can be gone to, as Ark UI's `goToNextStep`
|
|
62994
63541
|
* does. Returns whether it moved: not past the last stage, not into a stage
|
|
62995
63542
|
* `linear` holds out of reach, and not where a listener refused.
|
|
@@ -63127,6 +63674,188 @@ export type CustomElements = {
|
|
|
63127
63674
|
*/
|
|
63128
63675
|
"helix-step": Partial<HelixStepProps & BaseProps<HelixStep> & BaseEvents<HelixStep>>;
|
|
63129
63676
|
|
|
63677
|
+
/**
|
|
63678
|
+
* Hundreds of thin strands are drawn as one ribbon, and the light they add
|
|
63679
|
+
* together is bloomed, so where they converge the ribbon burns hot. The ribbon
|
|
63680
|
+
* moves on its own all the time: it sways and breathes, its strands wave and
|
|
63681
|
+
* roll over one another, and light runs along them.
|
|
63682
|
+
*
|
|
63683
|
+
* Its palette comes from the tokens. The strands are `--helix-color-primary`,
|
|
63684
|
+
* a few are `--helix-color-info` for depth, and the page they light is
|
|
63685
|
+
* `--helix-color-background`. On a light page the light becomes ink, because
|
|
63686
|
+
* light added to near-white cannot be seen.
|
|
63687
|
+
*
|
|
63688
|
+
* **Three forms, set with `variant`.** `fan` is a tight, bright bend with its
|
|
63689
|
+
* arms opening to the right. `ribbon`, the default, is a broad, soft ribbon in
|
|
63690
|
+
* long curves. `waves` is sharp strands crossing the full width.
|
|
63691
|
+
*
|
|
63692
|
+
* **In its own box, by default.** The element fills the box it is given, the
|
|
63693
|
+
* way an image does, and `at` places the fan's bend or the ribbon's axis across
|
|
63694
|
+
* it. Content placed inside sits over the ribbon, in the `content` part.
|
|
63695
|
+
*
|
|
63696
|
+
* **Down the whole page, with `travel`.** The element fixes itself behind the
|
|
63697
|
+
* page, on `--helix-layer-beneath`, and lays one ribbon from the top of the page to the
|
|
63698
|
+
* bottom, so scrolling travels along it. Put `helix-strands-stop` elements
|
|
63699
|
+
* inside to pin a form to a section: each names an element with `for` and says
|
|
63700
|
+
* which form the ribbon takes there. Between stops the ribbon fills the gap in
|
|
63701
|
+
* its own `variant`, and between two waves it turns off screen so each wave
|
|
63702
|
+
* reads alone. Set `z-index` on the element to move it.
|
|
63703
|
+
*
|
|
63704
|
+
* The ribbon stops moving in these cases:
|
|
63705
|
+
* - `prefers-reduced-motion` is set. The element shows one still frame, and in
|
|
63706
|
+
* `travel` still follows the scroll, without easing.
|
|
63707
|
+
* - The element is off screen or in a background tab.
|
|
63708
|
+
*
|
|
63709
|
+
* It shows a gradient from the same tokens in these cases, and matches
|
|
63710
|
+
* `:state(fallback)` and sends `helix-strands-fallback` with the reason:
|
|
63711
|
+
* - The renderer draws on the CPU, such as a headless browser or a machine with
|
|
63712
|
+
* no usable GPU.
|
|
63713
|
+
* - There is no WebGL, or the browser took the drawing context back.
|
|
63714
|
+
*
|
|
63715
|
+
* Strands is styled only and has behavior, as `Aura` does: its behavior is
|
|
63716
|
+
* drawing to a canvas, so there is no structure for a headless version to hold.
|
|
63717
|
+
*
|
|
63718
|
+
* ## Attributes & Properties
|
|
63719
|
+
*
|
|
63720
|
+
* Component attributes and properties that can be applied to the element or by using JavaScript.
|
|
63721
|
+
*
|
|
63722
|
+
* - `at`: Where the form sits across the box, as a share of the width: the fan's
|
|
63723
|
+
* bend or the ribbon's axis. `0` is the left edge and `1` the right. A wave
|
|
63724
|
+
* crosses the whole width and does not read it. Unset, a fan bends at `0.4`
|
|
63725
|
+
* and a ribbon runs down the middle.
|
|
63726
|
+
*
|
|
63727
|
+
* **A share rather than a length**, so the ribbon keeps its place when the
|
|
63728
|
+
* box changes shape. Read inside a box only; in `travel` each stop has its
|
|
63729
|
+
* own.
|
|
63730
|
+
* - `density`: How many strands the ribbon has, from `0`, sixty, to `1`, three hundred and
|
|
63731
|
+
* forty. Clamped to that range.
|
|
63732
|
+
* - `gain`: Overall brightness, as a multiplier on the light.
|
|
63733
|
+
* - `softness`: The share of strands drawn out of focus where the ribbon is wide, from `0`,
|
|
63734
|
+
* every strand sharp, to `1`, every one soft. Clamped to that range. A tight
|
|
63735
|
+
* form, such as a fan's bend or a wave, stays sharp whatever this says.
|
|
63736
|
+
* - `speed`: How fast the ribbon moves, as a multiplier on time. `0` holds it still.
|
|
63737
|
+
* - `spread`: How wide the ribbon is, as a multiplier on each form's own width.
|
|
63738
|
+
* - `travel`: Whether the ribbon is laid down the whole page, so scrolling travels along
|
|
63739
|
+
* it.
|
|
63740
|
+
*
|
|
63741
|
+
* Reflected because the stylesheet selects on it: in `travel` the host fixes
|
|
63742
|
+
* itself to the viewport, behind the page.
|
|
63743
|
+
* - `variant`: The form the ribbon takes. When it is not set, the form is `ribbon`. In
|
|
63744
|
+
* `travel`, the form of every stretch no stop claims.
|
|
63745
|
+
* - `whenSettled`: Resolves a frame after the first update, when transitions are switched on.
|
|
63746
|
+
*
|
|
63747
|
+
* **Named `whenSettled` because `settled` is taken four times over**, by
|
|
63748
|
+
* Image, Splitter and both color controls, none of them about transitions. A
|
|
63749
|
+
* base class takes the name every subclass then cannot use.
|
|
63750
|
+
*
|
|
63751
|
+
* **The state it reports cannot be watched, which is why this exists.** A
|
|
63752
|
+
* custom state is deliberately not in the DOM, so there is no
|
|
63753
|
+
* `MutationObserver` equivalent for `ElementInternals.states`. Await this
|
|
63754
|
+
* instead.
|
|
63755
|
+
*
|
|
63756
|
+
* Separate from `updateComplete`, which resolves in the microtask checkpoint
|
|
63757
|
+
* the suppression is still active in. That is the distinction `readyToMove`
|
|
63758
|
+
* in `@fusion.dev/helix-testing` is written around.
|
|
63759
|
+
*
|
|
63760
|
+
* It never resolves where `requestAnimationFrame` never fires, which is a
|
|
63761
|
+
* server, a hidden tab, and happy-dom. Callers that must not hang there race
|
|
63762
|
+
* it against a timeout, as the happy-dom harness's `readyToMove` does. The
|
|
63763
|
+
* browser harness's awaits it alone: a browser always runs the frame, and a
|
|
63764
|
+
* timer beside it was a bet on how long one takes, which a busy run lost. (property only) (readonly)
|
|
63765
|
+
*
|
|
63766
|
+
* ## Events
|
|
63767
|
+
*
|
|
63768
|
+
* Events that will be emitted by the component.
|
|
63769
|
+
*
|
|
63770
|
+
* - `helix-strands-fallback`: Fired each time the element stops drawing its ribbon and shows its gradient, with the reason.
|
|
63771
|
+
*
|
|
63772
|
+
* ## Slots
|
|
63773
|
+
*
|
|
63774
|
+
* Areas where markup can be added to the component.
|
|
63775
|
+
*
|
|
63776
|
+
* - `(default)`: Content drawn over the ribbon, such as a heading, and the `helix-strands-stop` elements that pin its forms in `travel`.
|
|
63777
|
+
*
|
|
63778
|
+
* ## CSS Custom Properties
|
|
63779
|
+
*
|
|
63780
|
+
* CSS variables available for styling the component.
|
|
63781
|
+
*
|
|
63782
|
+
* - `--strands-glow`: The color of most strands. Defaults to `--helix-color-primary`.
|
|
63783
|
+
* - `--strands-ground`: The page the light is added to. Defaults to `--helix-color-background`.
|
|
63784
|
+
* - `--strands-peak`: The hottest strands, and on a light page the ink the light darkens toward. Defaults to `--helix-color-primary-hover` on a dark page and `--helix-color-primary-active` on a light one.
|
|
63785
|
+
* - `--strands-tint`: The color of a few strands, for depth. Defaults to `--helix-color-info`.
|
|
63786
|
+
*
|
|
63787
|
+
* ## CSS Parts
|
|
63788
|
+
*
|
|
63789
|
+
* Custom selectors for styling elements within the component.
|
|
63790
|
+
*
|
|
63791
|
+
* - `canvas`: The surface the ribbon draws into.
|
|
63792
|
+
* - `content`: The box over the ribbon that holds the content. It covers the element.
|
|
63793
|
+
*
|
|
63794
|
+
* ## CSS States
|
|
63795
|
+
*
|
|
63796
|
+
* These can be used to apply styling when a component is in a given state.
|
|
63797
|
+
*
|
|
63798
|
+
* - `fallback`: The element shows its gradient: the renderer draws on the CPU, there is no WebGL, or the browser took the context back. Cleared once the ribbon draws again.
|
|
63799
|
+
* - `settled`: Set one frame after the first render. Transitions wait for it, so an element does not animate its own arrival.
|
|
63800
|
+
*/
|
|
63801
|
+
"helix-strands": Partial<
|
|
63802
|
+
HelixStrandsProps & BaseProps<HelixStrands> & BaseEvents<HelixStrands>
|
|
63803
|
+
>;
|
|
63804
|
+
|
|
63805
|
+
/**
|
|
63806
|
+
* Placed inside a `helix-strands` with `travel`, a stop names an element with
|
|
63807
|
+
* `for` and says which form the ribbon takes when the page reaches it: a `fan`
|
|
63808
|
+
* bending through it, a `ribbon` passing through `at`, or `waves` crossing at
|
|
63809
|
+
* its top edge. The stops are read in page order, whatever order they are
|
|
63810
|
+
* written in, and a stop naming no element is skipped.
|
|
63811
|
+
*
|
|
63812
|
+
* A stop draws nothing itself and is never shown.
|
|
63813
|
+
*
|
|
63814
|
+
* **Every property is reflected**, because the parent watches its stops'
|
|
63815
|
+
* attributes to lay the ribbon out again: a change made from script reaches the
|
|
63816
|
+
* page as a change made in markup does. None has a default, so a stop writes
|
|
63817
|
+
* nothing it was not given.
|
|
63818
|
+
*
|
|
63819
|
+
* ## Attributes & Properties
|
|
63820
|
+
*
|
|
63821
|
+
* Component attributes and properties that can be applied to the element or by using JavaScript.
|
|
63822
|
+
*
|
|
63823
|
+
* - `at`: Where the form sits across the page, as a share of the width: the fan's
|
|
63824
|
+
* bend or the ribbon's axis. A wave crosses the whole width and does not
|
|
63825
|
+
* read it. Unset, a fan bends at `0.4` and a ribbon runs down the middle.
|
|
63826
|
+
* - `for`: The id of the element the form is pinned to, in the same tree as the stop.
|
|
63827
|
+
* - `variant`: The form the ribbon takes at the element. When it is not set, the form is `ribbon`.
|
|
63828
|
+
* - `whenSettled`: Resolves a frame after the first update, when transitions are switched on.
|
|
63829
|
+
*
|
|
63830
|
+
* **Named `whenSettled` because `settled` is taken four times over**, by
|
|
63831
|
+
* Image, Splitter and both color controls, none of them about transitions. A
|
|
63832
|
+
* base class takes the name every subclass then cannot use.
|
|
63833
|
+
*
|
|
63834
|
+
* **The state it reports cannot be watched, which is why this exists.** A
|
|
63835
|
+
* custom state is deliberately not in the DOM, so there is no
|
|
63836
|
+
* `MutationObserver` equivalent for `ElementInternals.states`. Await this
|
|
63837
|
+
* instead.
|
|
63838
|
+
*
|
|
63839
|
+
* Separate from `updateComplete`, which resolves in the microtask checkpoint
|
|
63840
|
+
* the suppression is still active in. That is the distinction `readyToMove`
|
|
63841
|
+
* in `@fusion.dev/helix-testing` is written around.
|
|
63842
|
+
*
|
|
63843
|
+
* It never resolves where `requestAnimationFrame` never fires, which is a
|
|
63844
|
+
* server, a hidden tab, and happy-dom. Callers that must not hang there race
|
|
63845
|
+
* it against a timeout, as the happy-dom harness's `readyToMove` does. The
|
|
63846
|
+
* browser harness's awaits it alone: a browser always runs the frame, and a
|
|
63847
|
+
* timer beside it was a bet on how long one takes, which a busy run lost. (property only) (readonly)
|
|
63848
|
+
*
|
|
63849
|
+
* ## CSS States
|
|
63850
|
+
*
|
|
63851
|
+
* These can be used to apply styling when a component is in a given state.
|
|
63852
|
+
*
|
|
63853
|
+
* - `settled`: Set one frame after the first render. Transitions wait for it, so an element does not animate its own arrival.
|
|
63854
|
+
*/
|
|
63855
|
+
"helix-strands-stop": Partial<
|
|
63856
|
+
HelixStrandsStopProps & BaseProps<HelixStrandsStop> & BaseEvents<HelixStrandsStop>
|
|
63857
|
+
>;
|
|
63858
|
+
|
|
63130
63859
|
/**
|
|
63131
63860
|
* A thumb moves along a track. The switch is the one place in Helix where color
|
|
63132
63861
|
* means "on". A checkbox has a tick, and a switch has no mark, so the fill is
|
|
@@ -63683,6 +64412,8 @@ export type CustomElements = {
|
|
|
63683
64412
|
* and a list here would be a second way to say what that says. This table's
|
|
63684
64413
|
* cells are markup, and a table written as rows of cells with no column
|
|
63685
64414
|
* declared in it has nowhere else to be sized from.
|
|
64415
|
+
* - `default-expanded`/`defaultExpanded`: The keys of the rows whose rows are shown at the start, separated by
|
|
64416
|
+
* commas. Used until `expanded` is set.
|
|
63686
64417
|
* - `default-selected`/`defaultSelected`: The keys selected at the start, separated by commas. Used until `selected`
|
|
63687
64418
|
* is set.
|
|
63688
64419
|
* - `default-sort`/`defaultSort`: The starting sort order, used until `sort` is set.
|
|
@@ -63695,6 +64426,11 @@ export type CustomElements = {
|
|
|
63695
64426
|
* While it is set, a line after the rows shows it, or your own content in the
|
|
63696
64427
|
* `error` slot, in place of the empty and loading lines, and the live region
|
|
63697
64428
|
* says it.
|
|
64429
|
+
* - `expand-column-label`/`expandColumnLabel`: The name of the heading over the disclosure buttons.
|
|
64430
|
+
* - `expanded`: The keys of the rows whose rows are shown, separated by commas, in a table
|
|
64431
|
+
* whose rows nest. A press on a row's disclosure button asks first, and
|
|
64432
|
+
* `default-expanded` seeds what this element then owns.
|
|
64433
|
+
* - `expand-row-label`/`expandRowLabel`: The name of a row's disclosure button. `{row}` is the words of the row's first cell.
|
|
63698
64434
|
* - `fallback-label`/`fallbackLabel`: The table's name where neither `label` nor an `aria-label` or
|
|
63699
64435
|
* `aria-labelledby` on the host gives it one.
|
|
63700
64436
|
* - `grid`: Makes the table a grid: one tab stop, and the arrow keys, Home, End and the
|
|
@@ -63708,6 +64444,8 @@ export type CustomElements = {
|
|
|
63708
64444
|
*
|
|
63709
64445
|
* An `aria-label` or `aria-labelledby` on the host names the table too, and
|
|
63710
64446
|
* wins over this.
|
|
64447
|
+
* - `load-more`/`loadMore`: Sends `helix-load-more` once the end of the table comes within a screen
|
|
64448
|
+
* of view, so you can add the next rows as a reader nears them.
|
|
63711
64449
|
* - `moved-label`/`movedLabel`: What screen readers hear each time a key moves a held row, in a
|
|
63712
64450
|
* `reorderable` table. `{name}` is the row's words, `{position}` the place it
|
|
63713
64451
|
* would go, counting from 1, and `{count}` the number of rows.
|
|
@@ -63721,6 +64459,8 @@ export type CustomElements = {
|
|
|
63721
64459
|
* - `selectable`: Adds a column of checkboxes for selecting rows. Each row is known by its
|
|
63722
64460
|
* `value`, and by its place among the rows as written where it has none.
|
|
63723
64461
|
* - `select-all-label`/`selectAllLabel`: The name of the checkbox in the heading that selects every row.
|
|
64462
|
+
* - `select-column-label`/`selectColumnLabel`: The name of the heading over the checkboxes under
|
|
64463
|
+
* `selection-mode="single"`, where it holds no checkbox of its own.
|
|
63724
64464
|
* - `selected`: The keys of the selected rows, separated by commas.
|
|
63725
64465
|
*
|
|
63726
64466
|
* A reader's press fires `helix-select` first, and refusing it leaves the
|
|
@@ -63730,6 +64470,11 @@ export type CustomElements = {
|
|
|
63730
64470
|
* rows are chosen, written in the locale, and a language that needs plural
|
|
63731
64471
|
* forms writes them: `{count, plural, one {# wybrany} few {# wybrane} many
|
|
63732
64472
|
* {# wybranych} other {# wybranego}}`.
|
|
64473
|
+
* - `selection-behavior`/`selectionBehavior`: What a press on a row, or in a `grid` table a key that moves to one, does
|
|
64474
|
+
* to the rows already selected: `toggle`, the default, leaves them to the
|
|
64475
|
+
* checkboxes, and `replace` selects the row alone.
|
|
64476
|
+
* - `selection-mode`/`selectionMode`: How many rows a `selectable` table selects: `multiple`, the default, or
|
|
64477
|
+
* `single`, one at a time.
|
|
63733
64478
|
* - `select-row-label`/`selectRowLabel`: The name of a row's checkbox. `{row}` is replaced with the words of the
|
|
63734
64479
|
* row's first cell.
|
|
63735
64480
|
* - `sort`: The sort order, as `field:direction`, where `field` is a sortable column's
|
|
@@ -63771,11 +64516,14 @@ export type CustomElements = {
|
|
|
63771
64516
|
* Events that will be emitted by the component.
|
|
63772
64517
|
*
|
|
63773
64518
|
* - `helix-before-reorder`: Fired when a row is dropped at a new place, in a `reorderable` table, with every row's key in the new order. Cancelable: cancel it to keep the row where it is.
|
|
64519
|
+
* - `helix-before-toggle`: Fired from a row when its disclosure button is pressed, with whether it would be open in `detail.checked`. Cancelable: cancel it to keep the row as it is.
|
|
64520
|
+
* - `helix-load-more`: Fired, in a table with `load-more`, when the end of the table comes within a screen of view, once for each number of rows.
|
|
63774
64521
|
* - `helix-reorder`: Fired after `helix-before-reorder` when nobody canceled it. Move your rows to the order in `keys`. Cancelable: cancel it to say the move did not happen.
|
|
63775
64522
|
* - `helix-select`: The selection is about to change. The event carries every selected key, separated by commas. Cancelable: cancel it to keep the current selection.
|
|
63776
64523
|
* - `helix-selected`: Fired after the selection changes, with every selected key, separated by commas.
|
|
63777
64524
|
* - `helix-sort`: A different sort order was requested, as `field:direction`, or empty for the order the rows were written in. Cancelable: cancel it to keep the current order.
|
|
63778
64525
|
* - `helix-sorted`: Fired after the sort order changes, with the new order.
|
|
64526
|
+
* - `helix-toggle`: Fired from a row once the rows under it are shown or hidden, with whether it is open in `detail.checked`.
|
|
63779
64527
|
*
|
|
63780
64528
|
* ## Slots
|
|
63781
64529
|
*
|
|
@@ -63832,6 +64580,7 @@ export type CustomElements = {
|
|
|
63832
64580
|
* - `checkbox-mark-indeterminate`: Added to `checkbox-mark` while only some rows are selected.
|
|
63833
64581
|
* - `empty`: The text shown when there are no rows.
|
|
63834
64582
|
* - `error`: The line shown after the rows while `error-text` is set, in place of the empty and loading text.
|
|
64583
|
+
* - `expand-head`: The heading over the disclosure buttons, in a table whose rows nest.
|
|
63835
64584
|
* - `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.
|
|
63836
64585
|
* - `grid-start`: An empty box before the rows, in a `grid` table. Shift with Tab focuses it on its way out of the table.
|
|
63837
64586
|
* - `grip-head`: The heading over the row grips, in a `reorderable` table.
|
|
@@ -63867,6 +64616,9 @@ export type CustomElements = {
|
|
|
63867
64616
|
* reached.
|
|
63868
64617
|
* - `href`: The URL a press on the row follows, which makes the whole row a link.
|
|
63869
64618
|
* Empty, the default, leaves presses to the row's cells.
|
|
64619
|
+
* - `parent`: The key of the row this one sits under, in a table whose rows nest: that
|
|
64620
|
+
* row's `value`, or its place among the rows where it has none. Empty, the
|
|
64621
|
+
* default, is a row at the top.
|
|
63870
64622
|
* - `rel`: The `rel` of the row's link. You set it yourself, as on an anchor.
|
|
63871
64623
|
* - `target`: Where the row's link opens, such as `_blank`.
|
|
63872
64624
|
* - `value`: The key the table's `selected` lists this row by. Left empty, the row is
|
|
@@ -63905,10 +64657,13 @@ export type CustomElements = {
|
|
|
63905
64657
|
* - `--table-dragging-opacity`: The opacity of a row being moved, in a `reorderable` table.
|
|
63906
64658
|
* - `--table-drop-indicator-color`: The color of the line where a moved row would land.
|
|
63907
64659
|
* - `--table-drop-indicator-size`: The thickness of the line where a moved row would land.
|
|
64660
|
+
* - `--table-expand-color`: The color of a row's disclosure button, in a table whose rows nest.
|
|
63908
64661
|
* - `--table-grip-color`: The color of a row's grip, in a `reorderable` table.
|
|
63909
64662
|
* - `--table-grip-disabled-opacity`: The opacity of a row's grip while a sort decides the order.
|
|
64663
|
+
* - `--table-indent`: How far each step of depth sets a nested row's disclosure cell in.
|
|
63910
64664
|
* - `--table-row-disabled-opacity`: The opacity of the cells of a `disabled` row.
|
|
63911
64665
|
* - `--table-row-hover-background-color`: The wash across the cells of a row with `href` under the pointer.
|
|
64666
|
+
* - `--table-row-level`: Written by the row on its `expand` cell: how deep the row sits, from 1. Do not set it.
|
|
63912
64667
|
*
|
|
63913
64668
|
* ## CSS Parts
|
|
63914
64669
|
*
|
|
@@ -63925,6 +64680,9 @@ export type CustomElements = {
|
|
|
63925
64680
|
* - `checkbox-mark-checked`: Added to `checkbox-mark` while its box is checked.
|
|
63926
64681
|
* - `checkbox-mark-dash`: Added to `checkbox-mark` while it draws the dash, which it keeps until its box is checked.
|
|
63927
64682
|
* - `checkbox-mark-indeterminate`: Added to `checkbox-mark` while only some rows are selected.
|
|
64683
|
+
* - `expand`: The cell that holds the row's disclosure button, in a table whose rows nest. It carries `--table-row-level`, the row's depth from 1.
|
|
64684
|
+
* - `expand-button`: The button that shows and hides the rows under this one.
|
|
64685
|
+
* - `expand-mark`: The caret on the disclosure button, which points along the line, turned down by the styled tier while the row is open.
|
|
63928
64686
|
* - `grip`: The cell that holds the row's grip, in a `reorderable` table.
|
|
63929
64687
|
* - `grip-button`: The button that moves the row.
|
|
63930
64688
|
* - `grip-mark`: The icon on the grip.
|
|
@@ -63938,6 +64696,7 @@ export type CustomElements = {
|
|
|
63938
64696
|
* - `dragging`: The row is being moved, in a `reorderable` table.
|
|
63939
64697
|
* - `drop-after`: The row being moved goes after this one when it is dropped.
|
|
63940
64698
|
* - `drop-before`: The row being moved goes before this one when it is dropped.
|
|
64699
|
+
* - `expanded`: While the rows under this one are shown.
|
|
63941
64700
|
* - `link`: While the row has `href` and is not `disabled`, so a press on it follows the link.
|
|
63942
64701
|
* - `selected`: While the row is selected, in a `selectable` table.
|
|
63943
64702
|
* - `settled`: Set one frame after the first render. Transitions wait for it, so an element does not animate its own arrival.
|
|
@@ -64134,14 +64893,15 @@ export type CustomElements = {
|
|
|
64134
64893
|
*
|
|
64135
64894
|
* Methods that can be called to access component functionality.
|
|
64136
64895
|
*
|
|
64137
|
-
* - `requestActive(next: string) => boolean`: Requests a new current item, and returns whether the change was applied.
|
|
64896
|
+
* - `requestActive(next: string, cause?: string) => boolean`: Requests a new current item, and returns whether the change was applied.
|
|
64138
64897
|
*
|
|
64139
64898
|
* Announces before it acts, so `preventDefault()` on the `helix-before-activate` is
|
|
64140
64899
|
* a refusal and nothing moves. Unlike a native control, nothing has moved
|
|
64141
64900
|
* by the time this runs, so refusing is simply not writing: there is
|
|
64142
64901
|
* nothing to put back. Nobody refusing means the set updates itself,
|
|
64143
64902
|
* whether or not a consumer declared `active`, a declared property being a
|
|
64144
|
-
* seed and a correction.
|
|
64903
|
+
* seed and a correction. `cause` says why, where the family names its
|
|
64904
|
+
* causes, and reaches the event as `detail.cause`.
|
|
64145
64905
|
*
|
|
64146
64906
|
* ## CSS Custom Properties
|
|
64147
64907
|
*
|
|
@@ -65850,11 +66610,20 @@ export type CustomElements = {
|
|
|
65850
66610
|
* Whatever `<time>` accepts, which is a date, a time, both, a duration or a
|
|
65851
66611
|
* week. Unset, the label is written as it was given and nothing claims to
|
|
65852
66612
|
* know what instant it names.
|
|
66613
|
+
* - `pending`: Marks an event that has not happened yet, such as one that is scheduled.
|
|
66614
|
+
* The mark is the open circle, and a screen reader hears `pending-label`.
|
|
66615
|
+
* - `pending-label`/`pendingLabel`: What a screen reader hears for an entry that is `pending`.
|
|
65853
66616
|
* - `relative`: Writes the time as how long ago it was, or how long until it, from
|
|
65854
66617
|
* `datetime`, where the `time` slot is empty: `long` ("3 hours ago"),
|
|
65855
66618
|
* `short` ("3 hr. ago") or `narrow` ("3h ago"). Set with no value, it is
|
|
65856
66619
|
* `long`. The words move on as they go stale.
|
|
65857
|
-
* - `tone`: The kind of event. It sets the color of the mark and
|
|
66620
|
+
* - `tone`: The kind of event. It sets the color of the mark, and a screen reader
|
|
66621
|
+
* hears it as the word `tone-labels` gives it.
|
|
66622
|
+
* - `tone-label`/`toneLabel`: What a screen reader is told this entry's tone is, such as "Failed".
|
|
66623
|
+
* Absent is the tone's word in `tone-labels`.
|
|
66624
|
+
* - `tone-labels`/`toneLabels`: What a screen reader is told each tone is, by the tone's name, written as
|
|
66625
|
+
* JSON in the attribute: `tone-labels='{"danger":"Failed"}'`. A tone with no
|
|
66626
|
+
* word is not read, which is `neutral` and `primary` in English.
|
|
65858
66627
|
* - `whenSettled`: Resolves a frame after the first update, when transitions are switched on.
|
|
65859
66628
|
*
|
|
65860
66629
|
* **Named `whenSettled` because `settled` is taken four times over**, by
|
|
@@ -65881,7 +66650,7 @@ export type CustomElements = {
|
|
|
65881
66650
|
* Areas where markup can be added to the component.
|
|
65882
66651
|
*
|
|
65883
66652
|
* - `(default)`: What happened.
|
|
65884
|
-
* - `marker`: The mark on the line. Defaults to a dot, which is the slot's fallback content.
|
|
66653
|
+
* - `marker`: The mark on the line. Defaults to a dot, which is the slot's fallback content. A mark you slot is read as the tone's word, where the entry has one.
|
|
65885
66654
|
* - `time`: When it happened, written the way you want it shown.
|
|
65886
66655
|
*
|
|
65887
66656
|
* ## CSS Custom Properties
|
|
@@ -65902,7 +66671,7 @@ export type CustomElements = {
|
|
|
65902
66671
|
*
|
|
65903
66672
|
* - `content`: What happened, and the time above it.
|
|
65904
66673
|
* - `dot`: The dot drawn when no marker is slotted.
|
|
65905
|
-
* - `marker`: The mark on the line.
|
|
66674
|
+
* - `marker`: The mark on the line. An image named by the tone's word, and by `pending-label`, where either applies.
|
|
65906
66675
|
* - `rail`: The column that holds the mark and the line. Draw the two halves of the line with `::part(rail)::before` and `::part(rail)::after` in your stylesheet. This tier ships no CSS and renders no extra box for the line.
|
|
65907
66676
|
* - `time`: When it happened.
|
|
65908
66677
|
*
|
|
@@ -67617,14 +68386,15 @@ export type CustomElements = {
|
|
|
67617
68386
|
*
|
|
67618
68387
|
* Methods that can be called to access component functionality.
|
|
67619
68388
|
*
|
|
67620
|
-
* - `requestActive(next: string) => boolean`: Requests a new current item, and returns whether the change was applied.
|
|
68389
|
+
* - `requestActive(next: string, cause?: string) => boolean`: Requests a new current item, and returns whether the change was applied.
|
|
67621
68390
|
*
|
|
67622
68391
|
* Announces before it acts, so `preventDefault()` on the `helix-before-activate` is
|
|
67623
68392
|
* a refusal and nothing moves. Unlike a native control, nothing has moved
|
|
67624
68393
|
* by the time this runs, so refusing is simply not writing: there is
|
|
67625
68394
|
* nothing to put back. Nobody refusing means the set updates itself,
|
|
67626
68395
|
* whether or not a consumer declared `active`, a declared property being a
|
|
67627
|
-
* seed and a correction.
|
|
68396
|
+
* seed and a correction. `cause` says why, where the family names its
|
|
68397
|
+
* causes, and reaches the event as `detail.cause`.
|
|
67628
68398
|
*
|
|
67629
68399
|
* ## CSS Custom Properties
|
|
67630
68400
|
*
|
|
@@ -67814,6 +68584,12 @@ export type CustomElements = {
|
|
|
67814
68584
|
* Written by the playlist rather than by the entry, the way an option's
|
|
67815
68585
|
* selection is: an entry that made itself current would be a second answer to
|
|
67816
68586
|
* which one is playing. (property only)
|
|
68587
|
+
* - `focusable`: Whether the entry holds the playlist's tab stop. Unset, every entry is in
|
|
68588
|
+
* the tab order, which is what a server renders.
|
|
68589
|
+
*
|
|
68590
|
+
* **Written by the playlist, with no attribute, and it reaches the button.**
|
|
68591
|
+
* The playlist gives the stop to the entry a reader last focused, or to the
|
|
68592
|
+
* current one, and the arrow keys reach the rest. (property only)
|
|
67817
68593
|
* - `text`: The entry's name: its own text, without the content in its named slots.
|
|
67818
68594
|
*
|
|
67819
68595
|
* `textContent` takes the whole subtree: a row with a duration in `meta`
|
|
@@ -67855,6 +68631,7 @@ export type CustomElements = {
|
|
|
67855
68631
|
* Areas where markup can be added to the component.
|
|
67856
68632
|
*
|
|
67857
68633
|
* - `(default)`: The entry's name.
|
|
68634
|
+
* - `indicator`: A mark shown on the entry that is playing, such as an equalizer icon. Rendered only while the entry is current.
|
|
67858
68635
|
* - `media`: A thumbnail. Defaults to an image of `poster`.
|
|
67859
68636
|
* - `meta`: Content after the name, such as a duration or a date.
|
|
67860
68637
|
*
|
|
@@ -67889,6 +68666,7 @@ export type CustomElements = {
|
|
|
67889
68666
|
* Custom selectors for styling elements within the component.
|
|
67890
68667
|
*
|
|
67891
68668
|
* - `container`: The list item that holds the button.
|
|
68669
|
+
* - `indicator`: The `indicator` slot, at the end of the row, rendered only while the entry is playing. It draws no box until you give it one.
|
|
67892
68670
|
* - `item`: The row, which is a button.
|
|
67893
68671
|
* - `item-current`: Added to `item` for the entry that is playing.
|
|
67894
68672
|
* - `label`: The name and the content after it.
|
|
@@ -68029,7 +68807,11 @@ export type CustomElements = {
|
|
|
68029
68807
|
* - `default-active`/`defaultActive`: The `value` of the item declared current in markup.
|
|
68030
68808
|
*
|
|
68031
68809
|
* Ignored once `active` is written.
|
|
68810
|
+
* - `empty-label`/`emptyLabel`: What the playlist says while it has no entries. The `empty` slot replaces it.
|
|
68032
68811
|
* - `label`: The list's name, read by screen readers.
|
|
68812
|
+
* - `no-advance`/`noAdvance`: Stays on an entry when its clip ends, where the playlist would otherwise
|
|
68813
|
+
* play the next one. The player's controls, a press, and `next()` still
|
|
68814
|
+
* move. `repeat="one"` still plays the entry again.
|
|
68033
68815
|
* - `playing-label`/`playingLabel`: What the live region says when the playlist moves to another entry.
|
|
68034
68816
|
* `{title}` is the entry's name.
|
|
68035
68817
|
*
|
|
@@ -68078,7 +68860,7 @@ export type CustomElements = {
|
|
|
68078
68860
|
* Events that will be emitted by the component.
|
|
68079
68861
|
*
|
|
68080
68862
|
* - `helix-activate`: The current entry changed. The playlist already holds the new entry when this is sent, and `detail.previous` is the entry it left. `currentEntry` is the entry itself, with its `src`, `poster` and name.
|
|
68081
|
-
* - `helix-before-activate`: The current entry is about to change. Cancelable: cancel it to keep the current entry.
|
|
68863
|
+
* - `helix-before-activate`: The current entry is about to change, and `detail.cause` says why: `press`, `next`, `previous`, `ended`, or `removed`. Cancelable: cancel it to keep the current entry.
|
|
68082
68864
|
* - `helix-end`: The last entry finished playing, and the playlist stopped there. Not sent while `repeat` is set.
|
|
68083
68865
|
*
|
|
68084
68866
|
* ## Slots
|
|
@@ -68086,20 +68868,22 @@ export type CustomElements = {
|
|
|
68086
68868
|
* Areas where markup can be added to the component.
|
|
68087
68869
|
*
|
|
68088
68870
|
* - `(default)`: The entries.
|
|
68871
|
+
* - `empty`: Shown while the playlist has no entries. Defaults to `empty-label`.
|
|
68089
68872
|
* - `player`: The player that plays the entries.
|
|
68090
68873
|
*
|
|
68091
68874
|
* ## Methods
|
|
68092
68875
|
*
|
|
68093
68876
|
* Methods that can be called to access component functionality.
|
|
68094
68877
|
*
|
|
68095
|
-
* - `requestActive(next: string) => boolean`: Requests a new current item, and returns whether the change was applied.
|
|
68878
|
+
* - `requestActive(next: string, cause?: string) => boolean`: Requests a new current item, and returns whether the change was applied.
|
|
68096
68879
|
*
|
|
68097
68880
|
* Announces before it acts, so `preventDefault()` on the `helix-before-activate` is
|
|
68098
68881
|
* a refusal and nothing moves. Unlike a native control, nothing has moved
|
|
68099
68882
|
* by the time this runs, so refusing is simply not writing: there is
|
|
68100
68883
|
* nothing to put back. Nobody refusing means the set updates itself,
|
|
68101
68884
|
* whether or not a consumer declared `active`, a declared property being a
|
|
68102
|
-
* seed and a correction.
|
|
68885
|
+
* seed and a correction. `cause` says why, where the family names its
|
|
68886
|
+
* causes, and reaches the event as `detail.cause`.
|
|
68103
68887
|
* - `next() => void`: Moves to the next entry and plays it, as the player's next control does.
|
|
68104
68888
|
* Follows `shuffle`, goes round under `repeat="all"`, and stays on the last
|
|
68105
68889
|
* entry otherwise.
|
|
@@ -68110,6 +68894,8 @@ export type CustomElements = {
|
|
|
68110
68894
|
*
|
|
68111
68895
|
* CSS variables available for styling the component.
|
|
68112
68896
|
*
|
|
68897
|
+
* - `--video-playlist-empty-color`: The color of the words shown while there are no entries.
|
|
68898
|
+
* - `--video-playlist-empty-padding`: The space around the words shown while there are no entries.
|
|
68113
68899
|
* - `--video-playlist-gap`: The space between the player and the list.
|
|
68114
68900
|
* - `--video-playlist-items-gap`: The space between the entries.
|
|
68115
68901
|
* - `--video-playlist-layout`: The grid columns for the player and the list.
|
|
@@ -68119,6 +68905,7 @@ export type CustomElements = {
|
|
|
68119
68905
|
*
|
|
68120
68906
|
* Custom selectors for styling elements within the component.
|
|
68121
68907
|
*
|
|
68908
|
+
* - `empty`: The box that holds the `empty` slot, drawn while there are no entries.
|
|
68122
68909
|
* - `items`: The list of entries.
|
|
68123
68910
|
* - `live`: A live region that says which entry plays after the playlist moves.
|
|
68124
68911
|
* - `player`: The region that holds the player.
|
|
@@ -68587,6 +69374,8 @@ export type CustomElements = {
|
|
|
68587
69374
|
* - `columns`: How many items a line holds. One, the default, is a list; more lays the
|
|
68588
69375
|
* items out as a grid of that many equal columns, windowed a line at a
|
|
68589
69376
|
* time, with Left and Right moving along a line.
|
|
69377
|
+
* - `disabled-keys`/`disabledKeys`: The keys of the items a reader cannot choose or move to, separated by
|
|
69378
|
+
* commas, as `value` writes keys. Their rows carry `aria-disabled`.
|
|
68590
69379
|
* - `empty-label`/`emptyLabel`: The text of the row shown when there are no items and none are loading,
|
|
68591
69380
|
* where the `empty` slot is empty. Empty, the default, shows no row.
|
|
68592
69381
|
* - `estimate`: The height of one row, in pixels, used to find the row at a scroll offset.
|
|
@@ -68595,6 +69384,10 @@ export type CustomElements = {
|
|
|
68595
69384
|
* right whenever the rows really are one height and is the cheaper of the two.
|
|
68596
69385
|
* - `for`: The id of the script element that holds the items as JSON. `items` wins
|
|
68597
69386
|
* where both are set.
|
|
69387
|
+
* - `gap`: The space between two rows, and between two columns in a grid, in
|
|
69388
|
+
* pixels. The list counts it in each row's place, so a gap does not walk
|
|
69389
|
+
* the rows away from the scroll position the way a margin on each row
|
|
69390
|
+
* would.
|
|
68598
69391
|
* - `key-field`/`keyField`: The field of each item that is its key in `value`, as a key or a path of
|
|
68599
69392
|
* keys. Empty reads a string or a number item as its own key, and any
|
|
68600
69393
|
* other item by its place in the set.
|
|
@@ -68619,6 +69412,12 @@ export type CustomElements = {
|
|
|
68619
69412
|
* disagree with itself; measuring is what a set of genuinely different
|
|
68620
69413
|
* heights needs and costs a read of each row as it renders. A list of
|
|
68621
69414
|
* one-line rows should leave this alone.
|
|
69415
|
+
* - `min-column-width`/`minColumnWidth`: The narrowest a column of a grid may be, in pixels. Set, the list lays
|
|
69416
|
+
* out as many columns as fit the box at that width, at least one, and
|
|
69417
|
+
* follows the box as it resizes, which `columns` then does not decide.
|
|
69418
|
+
* - `selection-behavior`/`selectionBehavior`: What a press does to the items already chosen: `toggle` adds or takes out
|
|
69419
|
+
* the item, and `replace` selects it alone and lets the arrow keys carry the
|
|
69420
|
+
* selection, with Control or Command adding or taking out one item.
|
|
68622
69421
|
* - `selection-mode`/`selectionMode`: Makes the list a list box a reader chooses from: `single` selects one
|
|
68623
69422
|
* item, and `multiple` any number. Unset is a list a reader reads.
|
|
68624
69423
|
* - `text-field`/`textField`: The field of each item that typing matches, as a key or a path of keys
|
|
@@ -68696,6 +69495,7 @@ export type CustomElements = {
|
|
|
68696
69495
|
* CSS variables available for styling the component.
|
|
68697
69496
|
*
|
|
68698
69497
|
* - `--virtual-list-block-size`: How tall the scrolling box is.
|
|
69498
|
+
* - `--virtual-list-disabled-opacity`: How faint a row `disabled-keys` names is drawn.
|
|
68699
69499
|
* - `--virtual-list-empty-color`: The color of the text in the row shown when there are no items.
|
|
68700
69500
|
* - `--virtual-list-empty-padding`: The space around the text in the row shown when there are no items.
|
|
68701
69501
|
* - `--virtual-list-loading-color`: The color of the text in the row drawn while `loading` is set.
|
|
@@ -71930,6 +72730,7 @@ export type CustomElementsSolidJs = {
|
|
|
71930
72730
|
* this, so a reader hears the ends first and what the line says after.
|
|
71931
72731
|
* - `controls-label`/`controlsLabel`: The name of the group of controls, read by screen readers, which names
|
|
71932
72732
|
* what the controls drive rather than the mechanism.
|
|
72733
|
+
* - `copied-label`/`copiedLabel`: What screen readers hear after a copy, with `{count}` for the cards copied.
|
|
71933
72734
|
* - `fallback-label`/`fallbackLabel`: The board's name where `label` is empty.
|
|
71934
72735
|
* - `label`: The accessible name for the board. Required.
|
|
71935
72736
|
*
|
|
@@ -71975,6 +72776,7 @@ export type CustomElementsSolidJs = {
|
|
|
71975
72776
|
* walk the cards.
|
|
71976
72777
|
* - `reconnecting-label`/`reconnectingLabel`: The text announced when a connection's end is picked up, with `{from}` and
|
|
71977
72778
|
* `{to}`.
|
|
72779
|
+
* - `redone-label`/`redoneLabel`: What screen readers hear after a move or a resize is made again.
|
|
71978
72780
|
* - `resized-label`/`resizedLabel`: What screen readers hear after a key resizes a card, with `{name}` for the
|
|
71979
72781
|
* card and `{width}` and `{height}` for its new size, in the document's
|
|
71980
72782
|
* units.
|
|
@@ -72032,6 +72834,7 @@ export type CustomElementsSolidJs = {
|
|
|
72032
72834
|
* see the board is told by the color; this is how a reader who cannot is
|
|
72033
72835
|
* told the same. A tone left out is not read.
|
|
72034
72836
|
* - `two-finger-hint-label`/`twoFingerHintLabel`: The hint shown when one finger swipes over the board with `gestures="cooperative"`.
|
|
72837
|
+
* - `undone-label`/`undoneLabel`: What screen readers hear after a move or a resize is undone.
|
|
72035
72838
|
* - `using-label`/`usingLabel`: The line shown while the board, with `gestures="activate"`, has the gestures.
|
|
72036
72839
|
* - `wheel-hint-label`/`wheelHintLabel`: The hint shown when the wheel scrolls past the board with
|
|
72037
72840
|
* `gestures="cooperative"`. `{key}` is ⌘ on a Mac and Ctrl elsewhere.
|
|
@@ -72113,6 +72916,11 @@ export type CustomElementsSolidJs = {
|
|
|
72113
72916
|
*
|
|
72114
72917
|
* What a reader landing on a card off the edge of the view gets, and what a
|
|
72115
72918
|
* page's own search or outline can call to take a reader to one.
|
|
72919
|
+
* - `undo() => boolean`: Puts the cards of the last move or resize back where they stood, asking
|
|
72920
|
+
* with `helix-before-move` first. Returns whether anything moved: false
|
|
72921
|
+
* with nothing to undo, or when the request was refused.
|
|
72922
|
+
* - `redo() => boolean`: Makes the last move or resize `undo` took back again, asking with
|
|
72923
|
+
* `helix-before-move` first. Returns whether anything moved.
|
|
72116
72924
|
* - `toJsonCanvas() => CanvasDocument`: The board as a JSON Canvas document, for saving it.
|
|
72117
72925
|
*
|
|
72118
72926
|
* What each card holds is the consumer's DOM, so a card comes back as a card
|
|
@@ -73112,6 +73920,7 @@ export type CustomElementsSolidJs = {
|
|
|
73112
73920
|
* is the way back, and that is a part inside the shadow tree where a
|
|
73113
73921
|
* stylesheet can already reach it. Measured rather than assumed: `label,
|
|
73114
73922
|
* pinned` after upgrade against `label` from the server.
|
|
73923
|
+
* - `resume-label`/`resumeLabel`: The words on the button that returns to the newest turn, where `resume` is empty.
|
|
73115
73924
|
* - `threshold`: How near the bottom still counts as being at it, in pixels.
|
|
73116
73925
|
*
|
|
73117
73926
|
* A hook rather than a constant, because the right number depends on how tall
|
|
@@ -73240,6 +74049,8 @@ export type CustomElementsSolidJs = {
|
|
|
73240
74049
|
* - `message-state`: The state text of a turn from `turns`, when there is one to show.
|
|
73241
74050
|
* - `message-time`: The time of a turn from `turns`.
|
|
73242
74051
|
* - `resume`: The control shown while the user is scrolled away from the bottom.
|
|
74052
|
+
* - `resume-button`: The button the `resume` region shows when nothing is slotted into it.
|
|
74053
|
+
* - `resume-mark`: The arrow on the default `resume-button`.
|
|
73243
74054
|
* - `status`: The status region, outside the log.
|
|
73244
74055
|
* - `turn`: The wrapper around the message drawn for one turn from `turns`.
|
|
73245
74056
|
* - `typing`: The words that say who is typing, in the status band, while `typing` names someone.
|
|
@@ -73774,18 +74585,13 @@ export type CustomElementsSolidJs = {
|
|
|
73774
74585
|
*
|
|
73775
74586
|
* Long lines scroll by default. Set `wrap` to wrap them instead, for prose-like
|
|
73776
74587
|
* code such as a long command, and set `--code-block-max-block-size` to cap the
|
|
73777
|
-
* height of a long file, which then scrolls.
|
|
74588
|
+
* height of a long file, which then scrolls. A line `mark-lines` names takes a
|
|
74589
|
+
* band in the primary color, with an edge at its start.
|
|
73778
74590
|
*
|
|
73779
74591
|
* ## Attributes & Properties
|
|
73780
74592
|
*
|
|
73781
74593
|
* Component attributes and properties that can be applied to the element or by using JavaScript.
|
|
73782
74594
|
*
|
|
73783
|
-
* - `wrap`: Whether long lines wrap.
|
|
73784
|
-
*
|
|
73785
|
-
* Off by default, so long lines scroll, because a line break can be
|
|
73786
|
-
* significant in code and a wrapped line reads as two. For prose-like code, such as a long command or
|
|
73787
|
-
* a log line, a wrap reads better than a scroll. Line numbers keep the lines
|
|
73788
|
-
* unwrapped, since a wrapped line would take one number and several rows.
|
|
73789
74595
|
* - `code-label`/`codeLabel`: The name of a block that scrolls, which is a tab stop while it does.
|
|
73790
74596
|
*
|
|
73791
74597
|
* Where the block has a name, the scroller says it too, such as "Code,
|
|
@@ -73829,6 +74635,9 @@ export type CustomElementsSolidJs = {
|
|
|
73829
74635
|
* copy, which takes the code alone. Reflected, because the stylesheet lays
|
|
73830
74636
|
* the gutter out beside the code. A diff numbers its lines from its hunks
|
|
73831
74637
|
* whether or not this is set.
|
|
74638
|
+
* - `mark-lines`/`markLines`: The lines to mark, as numbers and ranges counted from 1, such as `2, 4-6`.
|
|
74639
|
+
* Each run is drawn as a band behind its lines. Not for a diff, which marks
|
|
74640
|
+
* its own changes.
|
|
73832
74641
|
* - `no-copy`/`noCopy`: Whether to leave the copy button off.
|
|
73833
74642
|
*
|
|
73834
74643
|
* Negative, which is not a style choice. A boolean attribute is true whenever
|
|
@@ -73853,6 +74662,17 @@ export type CustomElementsSolidJs = {
|
|
|
73853
74662
|
* Absent is unified, each removal above its replacement, which fits any
|
|
73854
74663
|
* width. `split` sets the old version beside the new one. Optional rather
|
|
73855
74664
|
* than defaulted, so the host carries no attribute the consumer did not write.
|
|
74665
|
+
* - `wrap`: Whether long lines wrap. Without it they scroll.
|
|
74666
|
+
*
|
|
74667
|
+
* Off by default, so long lines scroll, because a line break can be
|
|
74668
|
+
* significant in code and a wrapped line reads as two. For prose-like code,
|
|
74669
|
+
* such as a long command or a log line, a wrap reads better than a scroll.
|
|
74670
|
+
* With `line-numbers`, each number stands beside the line it numbers
|
|
74671
|
+
* however many rows that line takes. Reflected, because the stylesheet
|
|
74672
|
+
* wraps the lines.
|
|
74673
|
+
* - `wrap-label`/`wrapLabel`: The wrap button's name, which it keeps whether it is pressed or not.
|
|
74674
|
+
* - `wrappable`: Whether the header has a button that wraps the lines and unwraps them. The
|
|
74675
|
+
* block draws a header for it even with no name.
|
|
73856
74676
|
* - `highlight`: Turns the code into highlighted markup, which the block draws in place of
|
|
73857
74677
|
* the plain text.
|
|
73858
74678
|
*
|
|
@@ -73895,11 +74715,21 @@ export type CustomElementsSolidJs = {
|
|
|
73895
74715
|
* browser harness's awaits it alone: a browser always runs the frame, and a
|
|
73896
74716
|
* timer beside it was a bet on how long one takes, which a busy run lost. (property only) (readonly)
|
|
73897
74717
|
*
|
|
74718
|
+
* ## Events
|
|
74719
|
+
*
|
|
74720
|
+
* Events that will be emitted by the component.
|
|
74721
|
+
*
|
|
74722
|
+
* - `helix-before-toggle`: The wrap button was pressed, with the `wrap` it asks for in `detail.checked`. Cancelable: cancel it to keep the lines as they are.
|
|
74723
|
+
* - `helix-toggle`: Fired after the wrap button changed `wrap`, with the new value in `detail.checked`.
|
|
74724
|
+
*
|
|
73898
74725
|
* ## Slots
|
|
73899
74726
|
*
|
|
73900
74727
|
* Areas where markup can be added to the component.
|
|
73901
74728
|
*
|
|
73902
74729
|
* - `(default)`: The code.
|
|
74730
|
+
* - `actions`: Controls for the block, in the header before the copy button.
|
|
74731
|
+
* - `copied-icon`: The copy button's icon after a copy. Defaults to a check mark.
|
|
74732
|
+
* - `copy-icon`: The copy button's icon before a copy. Defaults to a clipboard.
|
|
73903
74733
|
*
|
|
73904
74734
|
* ## CSS Custom Properties
|
|
73905
74735
|
*
|
|
@@ -73917,14 +74747,21 @@ export type CustomElementsSolidJs = {
|
|
|
73917
74747
|
* - `--code-block-header-background-color`: The background behind the name. The default is `surface-raised`.
|
|
73918
74748
|
* - `--code-block-label-color`: The color of the name in the header.
|
|
73919
74749
|
* - `--code-block-line-height`: The line height of the code and its line numbers, as a number or a length.
|
|
74750
|
+
* - `--code-block-mark-color`: The band behind the lines `mark-lines` names. The primary color at a wash by default.
|
|
74751
|
+
* - `--code-block-mark-edge-color`: The edge at the start of a band behind marked lines. The primary color by default.
|
|
73920
74752
|
* - `--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.
|
|
73921
74753
|
* - `--code-block-radius`: The corner radius of the header's top and the block's bottom, which form one shape.
|
|
73922
74754
|
* - `--code-block-removed-color`: The color a diff's removed lines are tinted in and their `-` is drawn in. The danger color by default.
|
|
74755
|
+
* - `--code-block-line-size`: Written by the block on each `number` in a `wrap` block with `line-numbers`: how tall the line it numbers is laid out. Do not set it.
|
|
74756
|
+
* - `--code-block-mark-inline-size`: Written by the block on each `mark`: how wide the code is, scrolled part included. Do not set it.
|
|
74757
|
+
* - `--code-block-mark-size`: Written by the block on each `mark`: how tall its run of lines is. Do not set it.
|
|
74758
|
+
* - `--code-block-mark-start`: Written by the block on each `mark`: how far down the code its run of lines starts. Do not set it.
|
|
73923
74759
|
*
|
|
73924
74760
|
* ## CSS Parts
|
|
73925
74761
|
*
|
|
73926
74762
|
* Custom selectors for styling elements within the component.
|
|
73927
74763
|
*
|
|
74764
|
+
* - `actions`: The box in the header that holds the `actions` slot, drawn while something is slotted there.
|
|
73928
74765
|
* - `added`: In a diff, a line only the new version has, an `<ins>`.
|
|
73929
74766
|
* - `block`: The scrolling `<pre>`.
|
|
73930
74767
|
* - `code`: The `<code>` inside it.
|
|
@@ -73953,13 +74790,15 @@ export type CustomElementsSolidJs = {
|
|
|
73953
74790
|
* - `header`: The bar that holds the name and the copy button, shown when there is a name.
|
|
73954
74791
|
* - `hunk`: In a diff, a `@@` line saying where the lines under it are.
|
|
73955
74792
|
* - `label`: The block's name: its `label`, or its `language` where it has no label.
|
|
74793
|
+
* - `mark`: The band behind a run of lines `mark-lines` names. The block writes where the run is laid out into `--code-block-mark-start`, `--code-block-mark-size`, and `--code-block-mark-inline-size` on it. Hidden from the accessibility tree.
|
|
73956
74794
|
* - `marker`: In a diff, the `+`, `-`, or space that starts a line.
|
|
73957
74795
|
* - `new`: In a split diff, the new version's `<pre>`.
|
|
73958
|
-
* - `number`: In a diff, a line number.
|
|
74796
|
+
* - `number`: In a diff, a line number. In a `wrap` block with `line-numbers`, one line's number in the gutter, which the block makes as tall as the line it numbers through `--code-block-line-size`.
|
|
73959
74797
|
* - `old`: In a split diff, the old version's `<pre>`.
|
|
73960
74798
|
* - `removed`: In a diff, a line only the old version has, a `<del>`.
|
|
73961
74799
|
* - `split`: In a split diff, the two versions side by side.
|
|
73962
74800
|
* - `text`: In a diff, a line's code.
|
|
74801
|
+
* - `wrap-toggle`: The button in the header that wraps the lines and unwraps them, drawn when `wrappable` is set.
|
|
73963
74802
|
*
|
|
73964
74803
|
* ## CSS States
|
|
73965
74804
|
*
|
|
@@ -79880,14 +80719,15 @@ export type CustomElementsSolidJs = {
|
|
|
79880
80719
|
* - `pan(to: ViewportWay) => void`: Pans the view one step in a direction.
|
|
79881
80720
|
* - `zoom(by: number) => void`: Zooms the view one step: `1` zooms in and `-1` zooms out.
|
|
79882
80721
|
* - `toggleFullscreen() => void`: Turns fullscreen on or off.
|
|
79883
|
-
* - `requestActive(next: string) => boolean`: Requests a new current item, and returns whether the change was applied.
|
|
80722
|
+
* - `requestActive(next: string, cause?: string) => boolean`: Requests a new current item, and returns whether the change was applied.
|
|
79884
80723
|
*
|
|
79885
80724
|
* Announces before it acts, so `preventDefault()` on the `helix-before-activate` is
|
|
79886
80725
|
* a refusal and nothing moves. Unlike a native control, nothing has moved
|
|
79887
80726
|
* by the time this runs, so refusing is simply not writing: there is
|
|
79888
80727
|
* nothing to put back. Nobody refusing means the set updates itself,
|
|
79889
80728
|
* whether or not a consumer declared `active`, a declared property being a
|
|
79890
|
-
* seed and a correction.
|
|
80729
|
+
* seed and a correction. `cause` says why, where the family names its
|
|
80730
|
+
* causes, and reaches the event as `detail.cause`.
|
|
79891
80731
|
* - `drawn(whole = true) => void`: Says the graph has been drawn whole, or with `false`, that it no longer
|
|
79892
80732
|
* is. Called by `connectGraph` once its layout has settled; a page drawing
|
|
79893
80733
|
* its own graph calls it when that graph is finished. The first call after
|
|
@@ -81889,14 +82729,15 @@ export type CustomElementsSolidJs = {
|
|
|
81889
82729
|
*
|
|
81890
82730
|
* Methods that can be called to access component functionality.
|
|
81891
82731
|
*
|
|
81892
|
-
* - `requestActive(next: string) => boolean`: Requests a new current item, and returns whether the change was applied.
|
|
82732
|
+
* - `requestActive(next: string, cause?: string) => boolean`: Requests a new current item, and returns whether the change was applied.
|
|
81893
82733
|
*
|
|
81894
82734
|
* Announces before it acts, so `preventDefault()` on the `helix-before-activate` is
|
|
81895
82735
|
* a refusal and nothing moves. Unlike a native control, nothing has moved
|
|
81896
82736
|
* by the time this runs, so refusing is simply not writing: there is
|
|
81897
82737
|
* nothing to put back. Nobody refusing means the set updates itself,
|
|
81898
82738
|
* whether or not a consumer declared `active`, a declared property being a
|
|
81899
|
-
* seed and a correction.
|
|
82739
|
+
* seed and a correction. `cause` says why, where the family names its
|
|
82740
|
+
* causes, and reaches the event as `detail.cause`.
|
|
81900
82741
|
* - `requestOpen(next: boolean) => boolean`: Requests that the element open or close, and returns whether the change
|
|
81901
82742
|
* was applied.
|
|
81902
82743
|
*
|
|
@@ -91487,6 +92328,13 @@ export type CustomElementsSolidJs = {
|
|
|
91487
92328
|
* only whoever put it there knows that, which is the same reason `min` is a
|
|
91488
92329
|
* consumer's to set.
|
|
91489
92330
|
* - `corner-label`/`cornerLabel`: The name of the handle where two dividers cross, read by screen readers.
|
|
92331
|
+
* - `corner-value-label`/`cornerValueLabel`: What the handle where two dividers cross says it is set to, both dividers
|
|
92332
|
+
* at once: `{across}` is where the divider that runs down stands, and
|
|
92333
|
+
* `{down}` where the one that runs across stands, each a percentage.
|
|
92334
|
+
*
|
|
92335
|
+
* **Both, because the handle moves both**, and a number names one: the
|
|
92336
|
+
* handle's `aria-valuenow` is the divider its `aria-orientation` names, and
|
|
92337
|
+
* these words are the whole of where it is.
|
|
91490
92338
|
* - `default-collapsed`/`defaultCollapsed`: Which pane starts shut, when `collapsed` is not set.
|
|
91491
92339
|
* - `default-position`/`defaultPosition`: Where the divider starts, when `position` is not set.
|
|
91492
92340
|
* - `label`: The divider's name, read by screen readers.
|
|
@@ -91947,14 +92795,15 @@ export type CustomElementsSolidJs = {
|
|
|
91947
92795
|
*
|
|
91948
92796
|
* Methods that can be called to access component functionality.
|
|
91949
92797
|
*
|
|
91950
|
-
* - `requestActive(next: string) => boolean`: Requests a new current item, and returns whether the change was applied.
|
|
92798
|
+
* - `requestActive(next: string, cause?: string) => boolean`: Requests a new current item, and returns whether the change was applied.
|
|
91951
92799
|
*
|
|
91952
92800
|
* Announces before it acts, so `preventDefault()` on the `helix-before-activate` is
|
|
91953
92801
|
* a refusal and nothing moves. Unlike a native control, nothing has moved
|
|
91954
92802
|
* by the time this runs, so refusing is simply not writing: there is
|
|
91955
92803
|
* nothing to put back. Nobody refusing means the set updates itself,
|
|
91956
92804
|
* whether or not a consumer declared `active`, a declared property being a
|
|
91957
|
-
* seed and a correction.
|
|
92805
|
+
* seed and a correction. `cause` says why, where the family names its
|
|
92806
|
+
* causes, and reaches the event as `detail.cause`.
|
|
91958
92807
|
* - `next() => boolean`: Moves to the next stage that can be gone to, as Ark UI's `goToNextStep`
|
|
91959
92808
|
* does. Returns whether it moved: not past the last stage, not into a stage
|
|
91960
92809
|
* `linear` holds out of reach, and not where a listener refused.
|
|
@@ -92099,6 +92948,194 @@ export type CustomElementsSolidJs = {
|
|
|
92099
92948
|
HelixStepProps & HelixStepSolidJsProps & BaseProps<HelixStep> & BaseEvents<HelixStep>
|
|
92100
92949
|
>;
|
|
92101
92950
|
|
|
92951
|
+
/**
|
|
92952
|
+
* Hundreds of thin strands are drawn as one ribbon, and the light they add
|
|
92953
|
+
* together is bloomed, so where they converge the ribbon burns hot. The ribbon
|
|
92954
|
+
* moves on its own all the time: it sways and breathes, its strands wave and
|
|
92955
|
+
* roll over one another, and light runs along them.
|
|
92956
|
+
*
|
|
92957
|
+
* Its palette comes from the tokens. The strands are `--helix-color-primary`,
|
|
92958
|
+
* a few are `--helix-color-info` for depth, and the page they light is
|
|
92959
|
+
* `--helix-color-background`. On a light page the light becomes ink, because
|
|
92960
|
+
* light added to near-white cannot be seen.
|
|
92961
|
+
*
|
|
92962
|
+
* **Three forms, set with `variant`.** `fan` is a tight, bright bend with its
|
|
92963
|
+
* arms opening to the right. `ribbon`, the default, is a broad, soft ribbon in
|
|
92964
|
+
* long curves. `waves` is sharp strands crossing the full width.
|
|
92965
|
+
*
|
|
92966
|
+
* **In its own box, by default.** The element fills the box it is given, the
|
|
92967
|
+
* way an image does, and `at` places the fan's bend or the ribbon's axis across
|
|
92968
|
+
* it. Content placed inside sits over the ribbon, in the `content` part.
|
|
92969
|
+
*
|
|
92970
|
+
* **Down the whole page, with `travel`.** The element fixes itself behind the
|
|
92971
|
+
* page, on `--helix-layer-beneath`, and lays one ribbon from the top of the page to the
|
|
92972
|
+
* bottom, so scrolling travels along it. Put `helix-strands-stop` elements
|
|
92973
|
+
* inside to pin a form to a section: each names an element with `for` and says
|
|
92974
|
+
* which form the ribbon takes there. Between stops the ribbon fills the gap in
|
|
92975
|
+
* its own `variant`, and between two waves it turns off screen so each wave
|
|
92976
|
+
* reads alone. Set `z-index` on the element to move it.
|
|
92977
|
+
*
|
|
92978
|
+
* The ribbon stops moving in these cases:
|
|
92979
|
+
* - `prefers-reduced-motion` is set. The element shows one still frame, and in
|
|
92980
|
+
* `travel` still follows the scroll, without easing.
|
|
92981
|
+
* - The element is off screen or in a background tab.
|
|
92982
|
+
*
|
|
92983
|
+
* It shows a gradient from the same tokens in these cases, and matches
|
|
92984
|
+
* `:state(fallback)` and sends `helix-strands-fallback` with the reason:
|
|
92985
|
+
* - The renderer draws on the CPU, such as a headless browser or a machine with
|
|
92986
|
+
* no usable GPU.
|
|
92987
|
+
* - There is no WebGL, or the browser took the drawing context back.
|
|
92988
|
+
*
|
|
92989
|
+
* Strands is styled only and has behavior, as `Aura` does: its behavior is
|
|
92990
|
+
* drawing to a canvas, so there is no structure for a headless version to hold.
|
|
92991
|
+
*
|
|
92992
|
+
* ## Attributes & Properties
|
|
92993
|
+
*
|
|
92994
|
+
* Component attributes and properties that can be applied to the element or by using JavaScript.
|
|
92995
|
+
*
|
|
92996
|
+
* - `at`: Where the form sits across the box, as a share of the width: the fan's
|
|
92997
|
+
* bend or the ribbon's axis. `0` is the left edge and `1` the right. A wave
|
|
92998
|
+
* crosses the whole width and does not read it. Unset, a fan bends at `0.4`
|
|
92999
|
+
* and a ribbon runs down the middle.
|
|
93000
|
+
*
|
|
93001
|
+
* **A share rather than a length**, so the ribbon keeps its place when the
|
|
93002
|
+
* box changes shape. Read inside a box only; in `travel` each stop has its
|
|
93003
|
+
* own.
|
|
93004
|
+
* - `density`: How many strands the ribbon has, from `0`, sixty, to `1`, three hundred and
|
|
93005
|
+
* forty. Clamped to that range.
|
|
93006
|
+
* - `gain`: Overall brightness, as a multiplier on the light.
|
|
93007
|
+
* - `softness`: The share of strands drawn out of focus where the ribbon is wide, from `0`,
|
|
93008
|
+
* every strand sharp, to `1`, every one soft. Clamped to that range. A tight
|
|
93009
|
+
* form, such as a fan's bend or a wave, stays sharp whatever this says.
|
|
93010
|
+
* - `speed`: How fast the ribbon moves, as a multiplier on time. `0` holds it still.
|
|
93011
|
+
* - `spread`: How wide the ribbon is, as a multiplier on each form's own width.
|
|
93012
|
+
* - `travel`: Whether the ribbon is laid down the whole page, so scrolling travels along
|
|
93013
|
+
* it.
|
|
93014
|
+
*
|
|
93015
|
+
* Reflected because the stylesheet selects on it: in `travel` the host fixes
|
|
93016
|
+
* itself to the viewport, behind the page.
|
|
93017
|
+
* - `variant`: The form the ribbon takes. When it is not set, the form is `ribbon`. In
|
|
93018
|
+
* `travel`, the form of every stretch no stop claims.
|
|
93019
|
+
* - `whenSettled`: Resolves a frame after the first update, when transitions are switched on.
|
|
93020
|
+
*
|
|
93021
|
+
* **Named `whenSettled` because `settled` is taken four times over**, by
|
|
93022
|
+
* Image, Splitter and both color controls, none of them about transitions. A
|
|
93023
|
+
* base class takes the name every subclass then cannot use.
|
|
93024
|
+
*
|
|
93025
|
+
* **The state it reports cannot be watched, which is why this exists.** A
|
|
93026
|
+
* custom state is deliberately not in the DOM, so there is no
|
|
93027
|
+
* `MutationObserver` equivalent for `ElementInternals.states`. Await this
|
|
93028
|
+
* instead.
|
|
93029
|
+
*
|
|
93030
|
+
* Separate from `updateComplete`, which resolves in the microtask checkpoint
|
|
93031
|
+
* the suppression is still active in. That is the distinction `readyToMove`
|
|
93032
|
+
* in `@fusion.dev/helix-testing` is written around.
|
|
93033
|
+
*
|
|
93034
|
+
* It never resolves where `requestAnimationFrame` never fires, which is a
|
|
93035
|
+
* server, a hidden tab, and happy-dom. Callers that must not hang there race
|
|
93036
|
+
* it against a timeout, as the happy-dom harness's `readyToMove` does. The
|
|
93037
|
+
* browser harness's awaits it alone: a browser always runs the frame, and a
|
|
93038
|
+
* timer beside it was a bet on how long one takes, which a busy run lost. (property only) (readonly)
|
|
93039
|
+
*
|
|
93040
|
+
* ## Events
|
|
93041
|
+
*
|
|
93042
|
+
* Events that will be emitted by the component.
|
|
93043
|
+
*
|
|
93044
|
+
* - `helix-strands-fallback`: Fired each time the element stops drawing its ribbon and shows its gradient, with the reason.
|
|
93045
|
+
*
|
|
93046
|
+
* ## Slots
|
|
93047
|
+
*
|
|
93048
|
+
* Areas where markup can be added to the component.
|
|
93049
|
+
*
|
|
93050
|
+
* - `(default)`: Content drawn over the ribbon, such as a heading, and the `helix-strands-stop` elements that pin its forms in `travel`.
|
|
93051
|
+
*
|
|
93052
|
+
* ## CSS Custom Properties
|
|
93053
|
+
*
|
|
93054
|
+
* CSS variables available for styling the component.
|
|
93055
|
+
*
|
|
93056
|
+
* - `--strands-glow`: The color of most strands. Defaults to `--helix-color-primary`.
|
|
93057
|
+
* - `--strands-ground`: The page the light is added to. Defaults to `--helix-color-background`.
|
|
93058
|
+
* - `--strands-peak`: The hottest strands, and on a light page the ink the light darkens toward. Defaults to `--helix-color-primary-hover` on a dark page and `--helix-color-primary-active` on a light one.
|
|
93059
|
+
* - `--strands-tint`: The color of a few strands, for depth. Defaults to `--helix-color-info`.
|
|
93060
|
+
*
|
|
93061
|
+
* ## CSS Parts
|
|
93062
|
+
*
|
|
93063
|
+
* Custom selectors for styling elements within the component.
|
|
93064
|
+
*
|
|
93065
|
+
* - `canvas`: The surface the ribbon draws into.
|
|
93066
|
+
* - `content`: The box over the ribbon that holds the content. It covers the element.
|
|
93067
|
+
*
|
|
93068
|
+
* ## CSS States
|
|
93069
|
+
*
|
|
93070
|
+
* These can be used to apply styling when a component is in a given state.
|
|
93071
|
+
*
|
|
93072
|
+
* - `fallback`: The element shows its gradient: the renderer draws on the CPU, there is no WebGL, or the browser took the context back. Cleared once the ribbon draws again.
|
|
93073
|
+
* - `settled`: Set one frame after the first render. Transitions wait for it, so an element does not animate its own arrival.
|
|
93074
|
+
*/
|
|
93075
|
+
"helix-strands": Partial<
|
|
93076
|
+
HelixStrandsProps &
|
|
93077
|
+
HelixStrandsSolidJsProps &
|
|
93078
|
+
BaseProps<HelixStrands> &
|
|
93079
|
+
BaseEvents<HelixStrands>
|
|
93080
|
+
>;
|
|
93081
|
+
|
|
93082
|
+
/**
|
|
93083
|
+
* Placed inside a `helix-strands` with `travel`, a stop names an element with
|
|
93084
|
+
* `for` and says which form the ribbon takes when the page reaches it: a `fan`
|
|
93085
|
+
* bending through it, a `ribbon` passing through `at`, or `waves` crossing at
|
|
93086
|
+
* its top edge. The stops are read in page order, whatever order they are
|
|
93087
|
+
* written in, and a stop naming no element is skipped.
|
|
93088
|
+
*
|
|
93089
|
+
* A stop draws nothing itself and is never shown.
|
|
93090
|
+
*
|
|
93091
|
+
* **Every property is reflected**, because the parent watches its stops'
|
|
93092
|
+
* attributes to lay the ribbon out again: a change made from script reaches the
|
|
93093
|
+
* page as a change made in markup does. None has a default, so a stop writes
|
|
93094
|
+
* nothing it was not given.
|
|
93095
|
+
*
|
|
93096
|
+
* ## Attributes & Properties
|
|
93097
|
+
*
|
|
93098
|
+
* Component attributes and properties that can be applied to the element or by using JavaScript.
|
|
93099
|
+
*
|
|
93100
|
+
* - `at`: Where the form sits across the page, as a share of the width: the fan's
|
|
93101
|
+
* bend or the ribbon's axis. A wave crosses the whole width and does not
|
|
93102
|
+
* read it. Unset, a fan bends at `0.4` and a ribbon runs down the middle.
|
|
93103
|
+
* - `for`: The id of the element the form is pinned to, in the same tree as the stop.
|
|
93104
|
+
* - `variant`: The form the ribbon takes at the element. When it is not set, the form is `ribbon`.
|
|
93105
|
+
* - `whenSettled`: Resolves a frame after the first update, when transitions are switched on.
|
|
93106
|
+
*
|
|
93107
|
+
* **Named `whenSettled` because `settled` is taken four times over**, by
|
|
93108
|
+
* Image, Splitter and both color controls, none of them about transitions. A
|
|
93109
|
+
* base class takes the name every subclass then cannot use.
|
|
93110
|
+
*
|
|
93111
|
+
* **The state it reports cannot be watched, which is why this exists.** A
|
|
93112
|
+
* custom state is deliberately not in the DOM, so there is no
|
|
93113
|
+
* `MutationObserver` equivalent for `ElementInternals.states`. Await this
|
|
93114
|
+
* instead.
|
|
93115
|
+
*
|
|
93116
|
+
* Separate from `updateComplete`, which resolves in the microtask checkpoint
|
|
93117
|
+
* the suppression is still active in. That is the distinction `readyToMove`
|
|
93118
|
+
* in `@fusion.dev/helix-testing` is written around.
|
|
93119
|
+
*
|
|
93120
|
+
* It never resolves where `requestAnimationFrame` never fires, which is a
|
|
93121
|
+
* server, a hidden tab, and happy-dom. Callers that must not hang there race
|
|
93122
|
+
* it against a timeout, as the happy-dom harness's `readyToMove` does. The
|
|
93123
|
+
* browser harness's awaits it alone: a browser always runs the frame, and a
|
|
93124
|
+
* timer beside it was a bet on how long one takes, which a busy run lost. (property only) (readonly)
|
|
93125
|
+
*
|
|
93126
|
+
* ## CSS States
|
|
93127
|
+
*
|
|
93128
|
+
* These can be used to apply styling when a component is in a given state.
|
|
93129
|
+
*
|
|
93130
|
+
* - `settled`: Set one frame after the first render. Transitions wait for it, so an element does not animate its own arrival.
|
|
93131
|
+
*/
|
|
93132
|
+
"helix-strands-stop": Partial<
|
|
93133
|
+
HelixStrandsStopProps &
|
|
93134
|
+
HelixStrandsStopSolidJsProps &
|
|
93135
|
+
BaseProps<HelixStrandsStop> &
|
|
93136
|
+
BaseEvents<HelixStrandsStop>
|
|
93137
|
+
>;
|
|
93138
|
+
|
|
92102
93139
|
/**
|
|
92103
93140
|
* A thumb moves along a track. The switch is the one place in Helix where color
|
|
92104
93141
|
* means "on". A checkbox has a tick, and a switch has no mark, so the fill is
|
|
@@ -92664,6 +93701,8 @@ export type CustomElementsSolidJs = {
|
|
|
92664
93701
|
* and a list here would be a second way to say what that says. This table's
|
|
92665
93702
|
* cells are markup, and a table written as rows of cells with no column
|
|
92666
93703
|
* declared in it has nowhere else to be sized from.
|
|
93704
|
+
* - `default-expanded`/`defaultExpanded`: The keys of the rows whose rows are shown at the start, separated by
|
|
93705
|
+
* commas. Used until `expanded` is set.
|
|
92667
93706
|
* - `default-selected`/`defaultSelected`: The keys selected at the start, separated by commas. Used until `selected`
|
|
92668
93707
|
* is set.
|
|
92669
93708
|
* - `default-sort`/`defaultSort`: The starting sort order, used until `sort` is set.
|
|
@@ -92676,6 +93715,11 @@ export type CustomElementsSolidJs = {
|
|
|
92676
93715
|
* While it is set, a line after the rows shows it, or your own content in the
|
|
92677
93716
|
* `error` slot, in place of the empty and loading lines, and the live region
|
|
92678
93717
|
* says it.
|
|
93718
|
+
* - `expand-column-label`/`expandColumnLabel`: The name of the heading over the disclosure buttons.
|
|
93719
|
+
* - `expanded`: The keys of the rows whose rows are shown, separated by commas, in a table
|
|
93720
|
+
* whose rows nest. A press on a row's disclosure button asks first, and
|
|
93721
|
+
* `default-expanded` seeds what this element then owns.
|
|
93722
|
+
* - `expand-row-label`/`expandRowLabel`: The name of a row's disclosure button. `{row}` is the words of the row's first cell.
|
|
92679
93723
|
* - `fallback-label`/`fallbackLabel`: The table's name where neither `label` nor an `aria-label` or
|
|
92680
93724
|
* `aria-labelledby` on the host gives it one.
|
|
92681
93725
|
* - `grid`: Makes the table a grid: one tab stop, and the arrow keys, Home, End and the
|
|
@@ -92689,6 +93733,8 @@ export type CustomElementsSolidJs = {
|
|
|
92689
93733
|
*
|
|
92690
93734
|
* An `aria-label` or `aria-labelledby` on the host names the table too, and
|
|
92691
93735
|
* wins over this.
|
|
93736
|
+
* - `load-more`/`loadMore`: Sends `helix-load-more` once the end of the table comes within a screen
|
|
93737
|
+
* of view, so you can add the next rows as a reader nears them.
|
|
92692
93738
|
* - `moved-label`/`movedLabel`: What screen readers hear each time a key moves a held row, in a
|
|
92693
93739
|
* `reorderable` table. `{name}` is the row's words, `{position}` the place it
|
|
92694
93740
|
* would go, counting from 1, and `{count}` the number of rows.
|
|
@@ -92702,6 +93748,8 @@ export type CustomElementsSolidJs = {
|
|
|
92702
93748
|
* - `selectable`: Adds a column of checkboxes for selecting rows. Each row is known by its
|
|
92703
93749
|
* `value`, and by its place among the rows as written where it has none.
|
|
92704
93750
|
* - `select-all-label`/`selectAllLabel`: The name of the checkbox in the heading that selects every row.
|
|
93751
|
+
* - `select-column-label`/`selectColumnLabel`: The name of the heading over the checkboxes under
|
|
93752
|
+
* `selection-mode="single"`, where it holds no checkbox of its own.
|
|
92705
93753
|
* - `selected`: The keys of the selected rows, separated by commas.
|
|
92706
93754
|
*
|
|
92707
93755
|
* A reader's press fires `helix-select` first, and refusing it leaves the
|
|
@@ -92711,6 +93759,11 @@ export type CustomElementsSolidJs = {
|
|
|
92711
93759
|
* rows are chosen, written in the locale, and a language that needs plural
|
|
92712
93760
|
* forms writes them: `{count, plural, one {# wybrany} few {# wybrane} many
|
|
92713
93761
|
* {# wybranych} other {# wybranego}}`.
|
|
93762
|
+
* - `selection-behavior`/`selectionBehavior`: What a press on a row, or in a `grid` table a key that moves to one, does
|
|
93763
|
+
* to the rows already selected: `toggle`, the default, leaves them to the
|
|
93764
|
+
* checkboxes, and `replace` selects the row alone.
|
|
93765
|
+
* - `selection-mode`/`selectionMode`: How many rows a `selectable` table selects: `multiple`, the default, or
|
|
93766
|
+
* `single`, one at a time.
|
|
92714
93767
|
* - `select-row-label`/`selectRowLabel`: The name of a row's checkbox. `{row}` is replaced with the words of the
|
|
92715
93768
|
* row's first cell.
|
|
92716
93769
|
* - `sort`: The sort order, as `field:direction`, where `field` is a sortable column's
|
|
@@ -92752,11 +93805,14 @@ export type CustomElementsSolidJs = {
|
|
|
92752
93805
|
* Events that will be emitted by the component.
|
|
92753
93806
|
*
|
|
92754
93807
|
* - `helix-before-reorder`: Fired when a row is dropped at a new place, in a `reorderable` table, with every row's key in the new order. Cancelable: cancel it to keep the row where it is.
|
|
93808
|
+
* - `helix-before-toggle`: Fired from a row when its disclosure button is pressed, with whether it would be open in `detail.checked`. Cancelable: cancel it to keep the row as it is.
|
|
93809
|
+
* - `helix-load-more`: Fired, in a table with `load-more`, when the end of the table comes within a screen of view, once for each number of rows.
|
|
92755
93810
|
* - `helix-reorder`: Fired after `helix-before-reorder` when nobody canceled it. Move your rows to the order in `keys`. Cancelable: cancel it to say the move did not happen.
|
|
92756
93811
|
* - `helix-select`: The selection is about to change. The event carries every selected key, separated by commas. Cancelable: cancel it to keep the current selection.
|
|
92757
93812
|
* - `helix-selected`: Fired after the selection changes, with every selected key, separated by commas.
|
|
92758
93813
|
* - `helix-sort`: A different sort order was requested, as `field:direction`, or empty for the order the rows were written in. Cancelable: cancel it to keep the current order.
|
|
92759
93814
|
* - `helix-sorted`: Fired after the sort order changes, with the new order.
|
|
93815
|
+
* - `helix-toggle`: Fired from a row once the rows under it are shown or hidden, with whether it is open in `detail.checked`.
|
|
92760
93816
|
*
|
|
92761
93817
|
* ## Slots
|
|
92762
93818
|
*
|
|
@@ -92813,6 +93869,7 @@ export type CustomElementsSolidJs = {
|
|
|
92813
93869
|
* - `checkbox-mark-indeterminate`: Added to `checkbox-mark` while only some rows are selected.
|
|
92814
93870
|
* - `empty`: The text shown when there are no rows.
|
|
92815
93871
|
* - `error`: The line shown after the rows while `error-text` is set, in place of the empty and loading text.
|
|
93872
|
+
* - `expand-head`: The heading over the disclosure buttons, in a table whose rows nest.
|
|
92816
93873
|
* - `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.
|
|
92817
93874
|
* - `grid-start`: An empty box before the rows, in a `grid` table. Shift with Tab focuses it on its way out of the table.
|
|
92818
93875
|
* - `grip-head`: The heading over the row grips, in a `reorderable` table.
|
|
@@ -92853,6 +93910,9 @@ export type CustomElementsSolidJs = {
|
|
|
92853
93910
|
* reached.
|
|
92854
93911
|
* - `href`: The URL a press on the row follows, which makes the whole row a link.
|
|
92855
93912
|
* Empty, the default, leaves presses to the row's cells.
|
|
93913
|
+
* - `parent`: The key of the row this one sits under, in a table whose rows nest: that
|
|
93914
|
+
* row's `value`, or its place among the rows where it has none. Empty, the
|
|
93915
|
+
* default, is a row at the top.
|
|
92856
93916
|
* - `rel`: The `rel` of the row's link. You set it yourself, as on an anchor.
|
|
92857
93917
|
* - `target`: Where the row's link opens, such as `_blank`.
|
|
92858
93918
|
* - `value`: The key the table's `selected` lists this row by. Left empty, the row is
|
|
@@ -92891,10 +93951,13 @@ export type CustomElementsSolidJs = {
|
|
|
92891
93951
|
* - `--table-dragging-opacity`: The opacity of a row being moved, in a `reorderable` table.
|
|
92892
93952
|
* - `--table-drop-indicator-color`: The color of the line where a moved row would land.
|
|
92893
93953
|
* - `--table-drop-indicator-size`: The thickness of the line where a moved row would land.
|
|
93954
|
+
* - `--table-expand-color`: The color of a row's disclosure button, in a table whose rows nest.
|
|
92894
93955
|
* - `--table-grip-color`: The color of a row's grip, in a `reorderable` table.
|
|
92895
93956
|
* - `--table-grip-disabled-opacity`: The opacity of a row's grip while a sort decides the order.
|
|
93957
|
+
* - `--table-indent`: How far each step of depth sets a nested row's disclosure cell in.
|
|
92896
93958
|
* - `--table-row-disabled-opacity`: The opacity of the cells of a `disabled` row.
|
|
92897
93959
|
* - `--table-row-hover-background-color`: The wash across the cells of a row with `href` under the pointer.
|
|
93960
|
+
* - `--table-row-level`: Written by the row on its `expand` cell: how deep the row sits, from 1. Do not set it.
|
|
92898
93961
|
*
|
|
92899
93962
|
* ## CSS Parts
|
|
92900
93963
|
*
|
|
@@ -92911,6 +93974,9 @@ export type CustomElementsSolidJs = {
|
|
|
92911
93974
|
* - `checkbox-mark-checked`: Added to `checkbox-mark` while its box is checked.
|
|
92912
93975
|
* - `checkbox-mark-dash`: Added to `checkbox-mark` while it draws the dash, which it keeps until its box is checked.
|
|
92913
93976
|
* - `checkbox-mark-indeterminate`: Added to `checkbox-mark` while only some rows are selected.
|
|
93977
|
+
* - `expand`: The cell that holds the row's disclosure button, in a table whose rows nest. It carries `--table-row-level`, the row's depth from 1.
|
|
93978
|
+
* - `expand-button`: The button that shows and hides the rows under this one.
|
|
93979
|
+
* - `expand-mark`: The caret on the disclosure button, which points along the line, turned down by the styled tier while the row is open.
|
|
92914
93980
|
* - `grip`: The cell that holds the row's grip, in a `reorderable` table.
|
|
92915
93981
|
* - `grip-button`: The button that moves the row.
|
|
92916
93982
|
* - `grip-mark`: The icon on the grip.
|
|
@@ -92924,6 +93990,7 @@ export type CustomElementsSolidJs = {
|
|
|
92924
93990
|
* - `dragging`: The row is being moved, in a `reorderable` table.
|
|
92925
93991
|
* - `drop-after`: The row being moved goes after this one when it is dropped.
|
|
92926
93992
|
* - `drop-before`: The row being moved goes before this one when it is dropped.
|
|
93993
|
+
* - `expanded`: While the rows under this one are shown.
|
|
92927
93994
|
* - `link`: While the row has `href` and is not `disabled`, so a press on it follows the link.
|
|
92928
93995
|
* - `selected`: While the row is selected, in a `selectable` table.
|
|
92929
93996
|
* - `settled`: Set one frame after the first render. Transitions wait for it, so an element does not animate its own arrival.
|
|
@@ -93126,14 +94193,15 @@ export type CustomElementsSolidJs = {
|
|
|
93126
94193
|
*
|
|
93127
94194
|
* Methods that can be called to access component functionality.
|
|
93128
94195
|
*
|
|
93129
|
-
* - `requestActive(next: string) => boolean`: Requests a new current item, and returns whether the change was applied.
|
|
94196
|
+
* - `requestActive(next: string, cause?: string) => boolean`: Requests a new current item, and returns whether the change was applied.
|
|
93130
94197
|
*
|
|
93131
94198
|
* Announces before it acts, so `preventDefault()` on the `helix-before-activate` is
|
|
93132
94199
|
* a refusal and nothing moves. Unlike a native control, nothing has moved
|
|
93133
94200
|
* by the time this runs, so refusing is simply not writing: there is
|
|
93134
94201
|
* nothing to put back. Nobody refusing means the set updates itself,
|
|
93135
94202
|
* whether or not a consumer declared `active`, a declared property being a
|
|
93136
|
-
* seed and a correction.
|
|
94203
|
+
* seed and a correction. `cause` says why, where the family names its
|
|
94204
|
+
* causes, and reaches the event as `detail.cause`.
|
|
93137
94205
|
*
|
|
93138
94206
|
* ## CSS Custom Properties
|
|
93139
94207
|
*
|
|
@@ -94865,11 +95933,20 @@ export type CustomElementsSolidJs = {
|
|
|
94865
95933
|
* Whatever `<time>` accepts, which is a date, a time, both, a duration or a
|
|
94866
95934
|
* week. Unset, the label is written as it was given and nothing claims to
|
|
94867
95935
|
* know what instant it names.
|
|
95936
|
+
* - `pending`: Marks an event that has not happened yet, such as one that is scheduled.
|
|
95937
|
+
* The mark is the open circle, and a screen reader hears `pending-label`.
|
|
95938
|
+
* - `pending-label`/`pendingLabel`: What a screen reader hears for an entry that is `pending`.
|
|
94868
95939
|
* - `relative`: Writes the time as how long ago it was, or how long until it, from
|
|
94869
95940
|
* `datetime`, where the `time` slot is empty: `long` ("3 hours ago"),
|
|
94870
95941
|
* `short` ("3 hr. ago") or `narrow` ("3h ago"). Set with no value, it is
|
|
94871
95942
|
* `long`. The words move on as they go stale.
|
|
94872
|
-
* - `tone`: The kind of event. It sets the color of the mark and
|
|
95943
|
+
* - `tone`: The kind of event. It sets the color of the mark, and a screen reader
|
|
95944
|
+
* hears it as the word `tone-labels` gives it.
|
|
95945
|
+
* - `tone-label`/`toneLabel`: What a screen reader is told this entry's tone is, such as "Failed".
|
|
95946
|
+
* Absent is the tone's word in `tone-labels`.
|
|
95947
|
+
* - `tone-labels`/`toneLabels`: What a screen reader is told each tone is, by the tone's name, written as
|
|
95948
|
+
* JSON in the attribute: `tone-labels='{"danger":"Failed"}'`. A tone with no
|
|
95949
|
+
* word is not read, which is `neutral` and `primary` in English.
|
|
94873
95950
|
* - `whenSettled`: Resolves a frame after the first update, when transitions are switched on.
|
|
94874
95951
|
*
|
|
94875
95952
|
* **Named `whenSettled` because `settled` is taken four times over**, by
|
|
@@ -94896,7 +95973,7 @@ export type CustomElementsSolidJs = {
|
|
|
94896
95973
|
* Areas where markup can be added to the component.
|
|
94897
95974
|
*
|
|
94898
95975
|
* - `(default)`: What happened.
|
|
94899
|
-
* - `marker`: The mark on the line. Defaults to a dot, which is the slot's fallback content.
|
|
95976
|
+
* - `marker`: The mark on the line. Defaults to a dot, which is the slot's fallback content. A mark you slot is read as the tone's word, where the entry has one.
|
|
94900
95977
|
* - `time`: When it happened, written the way you want it shown.
|
|
94901
95978
|
*
|
|
94902
95979
|
* ## CSS Custom Properties
|
|
@@ -94917,7 +95994,7 @@ export type CustomElementsSolidJs = {
|
|
|
94917
95994
|
*
|
|
94918
95995
|
* - `content`: What happened, and the time above it.
|
|
94919
95996
|
* - `dot`: The dot drawn when no marker is slotted.
|
|
94920
|
-
* - `marker`: The mark on the line.
|
|
95997
|
+
* - `marker`: The mark on the line. An image named by the tone's word, and by `pending-label`, where either applies.
|
|
94921
95998
|
* - `rail`: The column that holds the mark and the line. Draw the two halves of the line with `::part(rail)::before` and `::part(rail)::after` in your stylesheet. This tier ships no CSS and renders no extra box for the line.
|
|
94922
95999
|
* - `time`: When it happened.
|
|
94923
96000
|
*
|
|
@@ -96666,14 +97743,15 @@ export type CustomElementsSolidJs = {
|
|
|
96666
97743
|
*
|
|
96667
97744
|
* Methods that can be called to access component functionality.
|
|
96668
97745
|
*
|
|
96669
|
-
* - `requestActive(next: string) => boolean`: Requests a new current item, and returns whether the change was applied.
|
|
97746
|
+
* - `requestActive(next: string, cause?: string) => boolean`: Requests a new current item, and returns whether the change was applied.
|
|
96670
97747
|
*
|
|
96671
97748
|
* Announces before it acts, so `preventDefault()` on the `helix-before-activate` is
|
|
96672
97749
|
* a refusal and nothing moves. Unlike a native control, nothing has moved
|
|
96673
97750
|
* by the time this runs, so refusing is simply not writing: there is
|
|
96674
97751
|
* nothing to put back. Nobody refusing means the set updates itself,
|
|
96675
97752
|
* whether or not a consumer declared `active`, a declared property being a
|
|
96676
|
-
* seed and a correction.
|
|
97753
|
+
* seed and a correction. `cause` says why, where the family names its
|
|
97754
|
+
* causes, and reaches the event as `detail.cause`.
|
|
96677
97755
|
*
|
|
96678
97756
|
* ## CSS Custom Properties
|
|
96679
97757
|
*
|
|
@@ -96870,6 +97948,12 @@ export type CustomElementsSolidJs = {
|
|
|
96870
97948
|
* Written by the playlist rather than by the entry, the way an option's
|
|
96871
97949
|
* selection is: an entry that made itself current would be a second answer to
|
|
96872
97950
|
* which one is playing. (property only)
|
|
97951
|
+
* - `focusable`: Whether the entry holds the playlist's tab stop. Unset, every entry is in
|
|
97952
|
+
* the tab order, which is what a server renders.
|
|
97953
|
+
*
|
|
97954
|
+
* **Written by the playlist, with no attribute, and it reaches the button.**
|
|
97955
|
+
* The playlist gives the stop to the entry a reader last focused, or to the
|
|
97956
|
+
* current one, and the arrow keys reach the rest. (property only)
|
|
96873
97957
|
* - `text`: The entry's name: its own text, without the content in its named slots.
|
|
96874
97958
|
*
|
|
96875
97959
|
* `textContent` takes the whole subtree: a row with a duration in `meta`
|
|
@@ -96911,6 +97995,7 @@ export type CustomElementsSolidJs = {
|
|
|
96911
97995
|
* Areas where markup can be added to the component.
|
|
96912
97996
|
*
|
|
96913
97997
|
* - `(default)`: The entry's name.
|
|
97998
|
+
* - `indicator`: A mark shown on the entry that is playing, such as an equalizer icon. Rendered only while the entry is current.
|
|
96914
97999
|
* - `media`: A thumbnail. Defaults to an image of `poster`.
|
|
96915
98000
|
* - `meta`: Content after the name, such as a duration or a date.
|
|
96916
98001
|
*
|
|
@@ -96945,6 +98030,7 @@ export type CustomElementsSolidJs = {
|
|
|
96945
98030
|
* Custom selectors for styling elements within the component.
|
|
96946
98031
|
*
|
|
96947
98032
|
* - `container`: The list item that holds the button.
|
|
98033
|
+
* - `indicator`: The `indicator` slot, at the end of the row, rendered only while the entry is playing. It draws no box until you give it one.
|
|
96948
98034
|
* - `item`: The row, which is a button.
|
|
96949
98035
|
* - `item-current`: Added to `item` for the entry that is playing.
|
|
96950
98036
|
* - `label`: The name and the content after it.
|
|
@@ -97091,7 +98177,11 @@ export type CustomElementsSolidJs = {
|
|
|
97091
98177
|
* - `default-active`/`defaultActive`: The `value` of the item declared current in markup.
|
|
97092
98178
|
*
|
|
97093
98179
|
* Ignored once `active` is written.
|
|
98180
|
+
* - `empty-label`/`emptyLabel`: What the playlist says while it has no entries. The `empty` slot replaces it.
|
|
97094
98181
|
* - `label`: The list's name, read by screen readers.
|
|
98182
|
+
* - `no-advance`/`noAdvance`: Stays on an entry when its clip ends, where the playlist would otherwise
|
|
98183
|
+
* play the next one. The player's controls, a press, and `next()` still
|
|
98184
|
+
* move. `repeat="one"` still plays the entry again.
|
|
97095
98185
|
* - `playing-label`/`playingLabel`: What the live region says when the playlist moves to another entry.
|
|
97096
98186
|
* `{title}` is the entry's name.
|
|
97097
98187
|
*
|
|
@@ -97140,7 +98230,7 @@ export type CustomElementsSolidJs = {
|
|
|
97140
98230
|
* Events that will be emitted by the component.
|
|
97141
98231
|
*
|
|
97142
98232
|
* - `helix-activate`: The current entry changed. The playlist already holds the new entry when this is sent, and `detail.previous` is the entry it left. `currentEntry` is the entry itself, with its `src`, `poster` and name.
|
|
97143
|
-
* - `helix-before-activate`: The current entry is about to change. Cancelable: cancel it to keep the current entry.
|
|
98233
|
+
* - `helix-before-activate`: The current entry is about to change, and `detail.cause` says why: `press`, `next`, `previous`, `ended`, or `removed`. Cancelable: cancel it to keep the current entry.
|
|
97144
98234
|
* - `helix-end`: The last entry finished playing, and the playlist stopped there. Not sent while `repeat` is set.
|
|
97145
98235
|
*
|
|
97146
98236
|
* ## Slots
|
|
@@ -97148,20 +98238,22 @@ export type CustomElementsSolidJs = {
|
|
|
97148
98238
|
* Areas where markup can be added to the component.
|
|
97149
98239
|
*
|
|
97150
98240
|
* - `(default)`: The entries.
|
|
98241
|
+
* - `empty`: Shown while the playlist has no entries. Defaults to `empty-label`.
|
|
97151
98242
|
* - `player`: The player that plays the entries.
|
|
97152
98243
|
*
|
|
97153
98244
|
* ## Methods
|
|
97154
98245
|
*
|
|
97155
98246
|
* Methods that can be called to access component functionality.
|
|
97156
98247
|
*
|
|
97157
|
-
* - `requestActive(next: string) => boolean`: Requests a new current item, and returns whether the change was applied.
|
|
98248
|
+
* - `requestActive(next: string, cause?: string) => boolean`: Requests a new current item, and returns whether the change was applied.
|
|
97158
98249
|
*
|
|
97159
98250
|
* Announces before it acts, so `preventDefault()` on the `helix-before-activate` is
|
|
97160
98251
|
* a refusal and nothing moves. Unlike a native control, nothing has moved
|
|
97161
98252
|
* by the time this runs, so refusing is simply not writing: there is
|
|
97162
98253
|
* nothing to put back. Nobody refusing means the set updates itself,
|
|
97163
98254
|
* whether or not a consumer declared `active`, a declared property being a
|
|
97164
|
-
* seed and a correction.
|
|
98255
|
+
* seed and a correction. `cause` says why, where the family names its
|
|
98256
|
+
* causes, and reaches the event as `detail.cause`.
|
|
97165
98257
|
* - `next() => void`: Moves to the next entry and plays it, as the player's next control does.
|
|
97166
98258
|
* Follows `shuffle`, goes round under `repeat="all"`, and stays on the last
|
|
97167
98259
|
* entry otherwise.
|
|
@@ -97172,6 +98264,8 @@ export type CustomElementsSolidJs = {
|
|
|
97172
98264
|
*
|
|
97173
98265
|
* CSS variables available for styling the component.
|
|
97174
98266
|
*
|
|
98267
|
+
* - `--video-playlist-empty-color`: The color of the words shown while there are no entries.
|
|
98268
|
+
* - `--video-playlist-empty-padding`: The space around the words shown while there are no entries.
|
|
97175
98269
|
* - `--video-playlist-gap`: The space between the player and the list.
|
|
97176
98270
|
* - `--video-playlist-items-gap`: The space between the entries.
|
|
97177
98271
|
* - `--video-playlist-layout`: The grid columns for the player and the list.
|
|
@@ -97181,6 +98275,7 @@ export type CustomElementsSolidJs = {
|
|
|
97181
98275
|
*
|
|
97182
98276
|
* Custom selectors for styling elements within the component.
|
|
97183
98277
|
*
|
|
98278
|
+
* - `empty`: The box that holds the `empty` slot, drawn while there are no entries.
|
|
97184
98279
|
* - `items`: The list of entries.
|
|
97185
98280
|
* - `live`: A live region that says which entry plays after the playlist moves.
|
|
97186
98281
|
* - `player`: The region that holds the player.
|
|
@@ -97657,6 +98752,8 @@ export type CustomElementsSolidJs = {
|
|
|
97657
98752
|
* - `columns`: How many items a line holds. One, the default, is a list; more lays the
|
|
97658
98753
|
* items out as a grid of that many equal columns, windowed a line at a
|
|
97659
98754
|
* time, with Left and Right moving along a line.
|
|
98755
|
+
* - `disabled-keys`/`disabledKeys`: The keys of the items a reader cannot choose or move to, separated by
|
|
98756
|
+
* commas, as `value` writes keys. Their rows carry `aria-disabled`.
|
|
97660
98757
|
* - `empty-label`/`emptyLabel`: The text of the row shown when there are no items and none are loading,
|
|
97661
98758
|
* where the `empty` slot is empty. Empty, the default, shows no row.
|
|
97662
98759
|
* - `estimate`: The height of one row, in pixels, used to find the row at a scroll offset.
|
|
@@ -97665,6 +98762,10 @@ export type CustomElementsSolidJs = {
|
|
|
97665
98762
|
* right whenever the rows really are one height and is the cheaper of the two.
|
|
97666
98763
|
* - `for`: The id of the script element that holds the items as JSON. `items` wins
|
|
97667
98764
|
* where both are set.
|
|
98765
|
+
* - `gap`: The space between two rows, and between two columns in a grid, in
|
|
98766
|
+
* pixels. The list counts it in each row's place, so a gap does not walk
|
|
98767
|
+
* the rows away from the scroll position the way a margin on each row
|
|
98768
|
+
* would.
|
|
97668
98769
|
* - `key-field`/`keyField`: The field of each item that is its key in `value`, as a key or a path of
|
|
97669
98770
|
* keys. Empty reads a string or a number item as its own key, and any
|
|
97670
98771
|
* other item by its place in the set.
|
|
@@ -97689,6 +98790,12 @@ export type CustomElementsSolidJs = {
|
|
|
97689
98790
|
* disagree with itself; measuring is what a set of genuinely different
|
|
97690
98791
|
* heights needs and costs a read of each row as it renders. A list of
|
|
97691
98792
|
* one-line rows should leave this alone.
|
|
98793
|
+
* - `min-column-width`/`minColumnWidth`: The narrowest a column of a grid may be, in pixels. Set, the list lays
|
|
98794
|
+
* out as many columns as fit the box at that width, at least one, and
|
|
98795
|
+
* follows the box as it resizes, which `columns` then does not decide.
|
|
98796
|
+
* - `selection-behavior`/`selectionBehavior`: What a press does to the items already chosen: `toggle` adds or takes out
|
|
98797
|
+
* the item, and `replace` selects it alone and lets the arrow keys carry the
|
|
98798
|
+
* selection, with Control or Command adding or taking out one item.
|
|
97692
98799
|
* - `selection-mode`/`selectionMode`: Makes the list a list box a reader chooses from: `single` selects one
|
|
97693
98800
|
* item, and `multiple` any number. Unset is a list a reader reads.
|
|
97694
98801
|
* - `text-field`/`textField`: The field of each item that typing matches, as a key or a path of keys
|
|
@@ -97766,6 +98873,7 @@ export type CustomElementsSolidJs = {
|
|
|
97766
98873
|
* CSS variables available for styling the component.
|
|
97767
98874
|
*
|
|
97768
98875
|
* - `--virtual-list-block-size`: How tall the scrolling box is.
|
|
98876
|
+
* - `--virtual-list-disabled-opacity`: How faint a row `disabled-keys` names is drawn.
|
|
97769
98877
|
* - `--virtual-list-empty-color`: The color of the text in the row shown when there are no items.
|
|
97770
98878
|
* - `--virtual-list-empty-padding`: The space around the text in the row shown when there are no items.
|
|
97771
98879
|
* - `--virtual-list-loading-color`: The color of the text in the row drawn while `loading` is set.
|
|
@@ -98237,12 +99345,24 @@ export type CustomCssProperties = {
|
|
|
98237
99345
|
"--code-block-label-color"?: (string) | undefined;
|
|
98238
99346
|
/** The line height of the code and its line numbers, as a number or a length. */
|
|
98239
99347
|
"--code-block-line-height"?: (string) | undefined;
|
|
99348
|
+
/** The band behind the lines `mark-lines` names. The primary color at a wash by default. */
|
|
99349
|
+
"--code-block-mark-color"?: (string) | undefined;
|
|
99350
|
+
/** The edge at the start of a band behind marked lines. The primary color by default. */
|
|
99351
|
+
"--code-block-mark-edge-color"?: (string) | undefined;
|
|
98240
99352
|
/** The tallest the code grows before it scrolls, or until `expandable`'s button shows every line. The default is no limit. */
|
|
98241
99353
|
"--code-block-max-block-size"?: (string) | undefined;
|
|
98242
99354
|
/** The corner radius of the header's top and the block's bottom, which form one shape. */
|
|
98243
99355
|
"--code-block-radius"?: (string) | undefined;
|
|
98244
99356
|
/** The color a diff's removed lines are tinted in and their `-` is drawn in. The danger color by default. */
|
|
98245
99357
|
"--code-block-removed-color"?: (string) | undefined;
|
|
99358
|
+
/** Written by the block on each `number` in a `wrap` block with `line-numbers`: how tall the line it numbers is laid out. Do not set it. */
|
|
99359
|
+
"--code-block-line-size"?: (string) | undefined;
|
|
99360
|
+
/** Written by the block on each `mark`: how wide the code is, scrolled part included. Do not set it. */
|
|
99361
|
+
"--code-block-mark-inline-size"?: (string) | undefined;
|
|
99362
|
+
/** Written by the block on each `mark`: how tall its run of lines is. Do not set it. */
|
|
99363
|
+
"--code-block-mark-size"?: (string) | undefined;
|
|
99364
|
+
/** Written by the block on each `mark`: how far down the code its run of lines starts. Do not set it. */
|
|
99365
|
+
"--code-block-mark-start"?: (string) | undefined;
|
|
98246
99366
|
/** Fill behind the fragment. Defaults to the foreground color at 6%, which looks the same on a light page and a dark one. */
|
|
98247
99367
|
"--code-background-color"?: (string) | undefined;
|
|
98248
99368
|
/** The fragment's typeface. Defaults to the mono face. */
|
|
@@ -99791,6 +100911,14 @@ export type CustomCssProperties = {
|
|
|
99791
100911
|
"--steps-progress-track-color"?: (string) | undefined;
|
|
99792
100912
|
/** How far through the sequence is, as a percentage, written on the `progress` part. */
|
|
99793
100913
|
"--steps-progress"?: (string) | undefined;
|
|
100914
|
+
/** The color of most strands. Defaults to `--helix-color-primary`. */
|
|
100915
|
+
"--strands-glow"?: (string) | undefined;
|
|
100916
|
+
/** The page the light is added to. Defaults to `--helix-color-background`. */
|
|
100917
|
+
"--strands-ground"?: (string) | undefined;
|
|
100918
|
+
/** The hottest strands, and on a light page the ink the light darkens toward. Defaults to `--helix-color-primary-hover` on a dark page and `--helix-color-primary-active` on a light one. */
|
|
100919
|
+
"--strands-peak"?: (string) | undefined;
|
|
100920
|
+
/** The color of a few strands, for depth. Defaults to `--helix-color-info`. */
|
|
100921
|
+
"--strands-tint"?: (string) | undefined;
|
|
99794
100922
|
/** Height of the track. The width follows it. */
|
|
99795
100923
|
"--switch-block-size"?: (string) | undefined;
|
|
99796
100924
|
/** Color of the icon on the thumb. Without it, the icon is muted while off and takes the on color while on. */
|
|
@@ -99833,14 +100961,20 @@ export type CustomCssProperties = {
|
|
|
99833
100961
|
"--table-drop-indicator-color"?: (string) | undefined;
|
|
99834
100962
|
/** The thickness of the line where a moved row would land. */
|
|
99835
100963
|
"--table-drop-indicator-size"?: (string) | undefined;
|
|
100964
|
+
/** The color of a row's disclosure button, in a table whose rows nest. */
|
|
100965
|
+
"--table-expand-color"?: (string) | undefined;
|
|
99836
100966
|
/** The color of a row's grip, in a `reorderable` table. */
|
|
99837
100967
|
"--table-grip-color"?: (string) | undefined;
|
|
99838
100968
|
/** The opacity of a row's grip while a sort decides the order. */
|
|
99839
100969
|
"--table-grip-disabled-opacity"?: (string) | undefined;
|
|
100970
|
+
/** How far each step of depth sets a nested row's disclosure cell in. */
|
|
100971
|
+
"--table-indent"?: (string) | undefined;
|
|
99840
100972
|
/** The opacity of the cells of a `disabled` row. */
|
|
99841
100973
|
"--table-row-disabled-opacity"?: (string) | undefined;
|
|
99842
100974
|
/** The wash across the cells of a row with `href` under the pointer. */
|
|
99843
100975
|
"--table-row-hover-background-color"?: (string) | undefined;
|
|
100976
|
+
/** Written by the row on its `expand` cell: how deep the row sits, from 1. Do not set it. */
|
|
100977
|
+
"--table-row-level"?: (string) | undefined;
|
|
99844
100978
|
/** The space between the tab row and the panel's content. */
|
|
99845
100979
|
"--tabs-panel-padding-block-start"?: (string) | undefined;
|
|
99846
100980
|
/** The space between tabs. */
|
|
@@ -100199,6 +101333,10 @@ export type CustomCssProperties = {
|
|
|
100199
101333
|
"--video-playlist-menu-poster"?: (string) | undefined;
|
|
100200
101334
|
/** The size of the trigger's icon. */
|
|
100201
101335
|
"--video-playlist-menu-size"?: (string) | undefined;
|
|
101336
|
+
/** The color of the words shown while there are no entries. */
|
|
101337
|
+
"--video-playlist-empty-color"?: (string) | undefined;
|
|
101338
|
+
/** The space around the words shown while there are no entries. */
|
|
101339
|
+
"--video-playlist-empty-padding"?: (string) | undefined;
|
|
100202
101340
|
/** The space between the player and the list. */
|
|
100203
101341
|
"--video-playlist-gap"?: (string) | undefined;
|
|
100204
101342
|
/** The space between the entries. */
|
|
@@ -100229,6 +101367,8 @@ export type CustomCssProperties = {
|
|
|
100229
101367
|
"--video-progress"?: (string) | undefined;
|
|
100230
101368
|
/** How tall the scrolling box is. */
|
|
100231
101369
|
"--virtual-list-block-size"?: (string) | undefined;
|
|
101370
|
+
/** How faint a row `disabled-keys` names is drawn. */
|
|
101371
|
+
"--virtual-list-disabled-opacity"?: (string) | undefined;
|
|
100232
101372
|
/** The color of the text in the row shown when there are no items. */
|
|
100233
101373
|
"--virtual-list-empty-color"?: (string) | undefined;
|
|
100234
101374
|
/** The space around the text in the row shown when there are no items. */
|