@fusion.dev/helix-headless 0.176.1 → 0.177.1
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 +1383 -766
- package/dist/area-chart/root/area-chart-root.d.ts +18 -1
- package/dist/area-chart/root/area-chart-root.js +2 -2
- package/dist/avatar/root/avatar-root.d.ts +1 -1
- package/dist/avatar/root/avatar-root.js +1 -1
- package/dist/bar-chart/root/bar-chart-root.d.ts +19 -1
- package/dist/bar-chart/root/bar-chart-root.js +2 -2
- package/dist/button/root/button-root.js +1 -0
- package/dist/canvas/node/canvas-node.js +1 -1
- package/dist/canvas/root/canvas-root.d.ts +5 -1
- package/dist/canvas/root/canvas-root.js +9 -1
- package/dist/chat/composer/chat-composer.d.ts +1 -1
- package/dist/chat/composer/chat-composer.js +1 -1
- package/dist/color-picker/root/color-picker-root.d.ts +10 -0
- package/dist/color-picker/root/color-picker-root.js +20 -13
- package/dist/combobox/root/combobox-root.d.ts +13 -0
- package/dist/combobox/root/combobox-root.js +16 -4
- package/dist/donut-chart/root/donut-chart-root.d.ts +37 -2
- package/dist/donut-chart/root/donut-chart-root.js +22 -8
- package/dist/element-events.generated.js +2 -0
- package/dist/file-input/root/file-input-root.d.ts +3 -2
- package/dist/file-input/root/file-input-root.js +5 -2
- package/dist/graph/root/graph-root.d.ts +28 -3
- package/dist/graph/root/graph-root.js +38 -3
- package/dist/heatmap/root/heatmap-root.d.ts +28 -5
- package/dist/heatmap/root/heatmap-root.js +7 -2
- package/dist/line-chart/root/line-chart-root.d.ts +18 -1
- package/dist/line-chart/root/line-chart-root.js +2 -2
- package/dist/loader/root/loader-root.d.ts +15 -0
- package/dist/loader/root/loader-root.js +28 -6
- package/dist/pin-input/root/pin-input-root.js +1 -0
- package/dist/rating/root/rating-root.d.ts +2 -1
- package/dist/rating/root/rating-root.js +8 -2
- package/dist/scatter-chart/root/scatter-chart-root.d.ts +29 -6
- package/dist/scatter-chart/root/scatter-chart-root.js +18 -3
- package/dist/select/root/select-root.d.ts +4 -1
- package/dist/select/root/select-root.js +1 -0
- package/dist/sparkline/root/sparkline-root.d.ts +29 -4
- package/dist/sparkline/root/sparkline-root.js +8 -1
- package/dist/tag/group/tag-group.d.ts +4 -3
- package/dist/tag/group/tag-group.js +6 -5
- package/dist/tag/root/tag-root.js +2 -1
- package/dist/time-input/root/time-input-root.d.ts +7 -1
- package/dist/time-input/root/time-input-root.js +6 -3
- package/dist/tree/item/tree-item.d.ts +4 -4
- package/dist/tree/item/tree-item.js +5 -1
- package/lint.json +1 -1
- package/package.json +5 -5
- package/types/jsx.d.ts +688 -382
- package/types/vue.d.ts +101 -22
- package/types/words.d.ts +26 -2
package/types/jsx.d.ts
CHANGED
|
@@ -5071,7 +5071,7 @@ Here rather than on each control. */
|
|
|
5071
5071
|
"onhelix-typing"?: ((
|
|
5072
5072
|
e: HelixHeadlessChatComposerHelixTypingElementEvent,
|
|
5073
5073
|
) => void) | undefined;
|
|
5074
|
-
/** The user changed the text. Read it from `value`, for a typing indicator or a saved draft.
|
|
5074
|
+
/** The user changed the text. Read it from `value`, for a typing indicator or a saved draft. Bubbles and is composed, as a native field's is. */
|
|
5075
5075
|
oninput?: ((e: HelixHeadlessChatComposerElementEvent) => void) | undefined;
|
|
5076
5076
|
};
|
|
5077
5077
|
|
|
@@ -5162,7 +5162,7 @@ Here rather than on each control. */
|
|
|
5162
5162
|
"on:helix-typing"?: ((
|
|
5163
5163
|
e: HelixHeadlessChatComposerHelixTypingElementEvent,
|
|
5164
5164
|
) => void) | undefined;
|
|
5165
|
-
/** The user changed the text. Read it from `value`, for a typing indicator or a saved draft.
|
|
5165
|
+
/** The user changed the text. Read it from `value`, for a typing indicator or a saved draft. Bubbles and is composed, as a native field's is. */
|
|
5166
5166
|
"on:input"?: ((e: HelixHeadlessChatComposerElementEvent) => void) | undefined;
|
|
5167
5167
|
|
|
5168
5168
|
/** Set the innerHTML of the element */
|
|
@@ -12420,6 +12420,18 @@ Unset is horizontal, or across the toolbar the divider sits in. */
|
|
|
12420
12420
|
textContent?: (string | number) | undefined;
|
|
12421
12421
|
};
|
|
12422
12422
|
|
|
12423
|
+
/** `HelixHeadlessDonutChart` component event */
|
|
12424
|
+
export type HelixHeadlessDonutChartElementEvent<E = Event> = TypedEvent<
|
|
12425
|
+
HelixHeadlessDonutChart,
|
|
12426
|
+
E
|
|
12427
|
+
>;
|
|
12428
|
+
/** `helix-reading-change` event type */
|
|
12429
|
+
export type HelixHeadlessDonutChartHelixReadingChangeElementEvent =
|
|
12430
|
+
HelixHeadlessDonutChartElementEvent<HelixReadingChangeEvent>;
|
|
12431
|
+
/** `helix-reading-press` event type */
|
|
12432
|
+
export type HelixHeadlessDonutChartHelixReadingPressElementEvent =
|
|
12433
|
+
HelixHeadlessDonutChartElementEvent<HelixReadingPressEvent>;
|
|
12434
|
+
|
|
12423
12435
|
export type HelixHeadlessDonutChartProps = {
|
|
12424
12436
|
/** The size of the hole in the middle of the ring.
|
|
12425
12437
|
|
|
@@ -12485,6 +12497,25 @@ rotation that puts the first slice at nine o'clock, the aspect ratio of a
|
|
|
12485
12497
|
box that is no longer square, and where the middle sits once the bottom of
|
|
12486
12498
|
the circle is not drawn. */
|
|
12487
12499
|
sweep?: (HelixHeadlessDonutChart["sweep"]) | undefined;
|
|
12500
|
+
/** The words shown in place of the drawing when the table has no readings,
|
|
12501
|
+
and the fallback of the `empty` slot. */
|
|
12502
|
+
"empty-text"?: (HelixHeadlessDonutChart["emptyText"]) | undefined;
|
|
12503
|
+
/** The words shown in place of the drawing when the table has no readings,
|
|
12504
|
+
and the fallback of the `empty` slot. */
|
|
12505
|
+
emptyText?: (HelixHeadlessDonutChart["emptyText"]) | undefined;
|
|
12506
|
+
/** Whether the readings are still on their way. The chart shows
|
|
12507
|
+
`loading-text` in place of an empty drawing until it has readings.
|
|
12508
|
+
|
|
12509
|
+
Reflected, so a stylesheet can treat the chart while it waits. A chart
|
|
12510
|
+
that already has readings keeps drawing them, so a refresh does not
|
|
12511
|
+
blank it. */
|
|
12512
|
+
loading?: (HelixHeadlessDonutChart["loading"]) | undefined;
|
|
12513
|
+
/** The words shown in place of the drawing while `loading` is set and
|
|
12514
|
+
there are no readings yet, and the fallback of the `loading` slot. */
|
|
12515
|
+
"loading-text"?: (HelixHeadlessDonutChart["loadingText"]) | undefined;
|
|
12516
|
+
/** The words shown in place of the drawing while `loading` is set and
|
|
12517
|
+
there are no readings yet, and the fallback of the `loading` slot. */
|
|
12518
|
+
loadingText?: (HelixHeadlessDonutChart["loadingText"]) | undefined;
|
|
12488
12519
|
/** The id of the table to read.
|
|
12489
12520
|
|
|
12490
12521
|
Names a table in the same tree, so a chart inside another component's
|
|
@@ -12544,6 +12575,15 @@ frame, and the summary, the keys and the readout are then the whole of
|
|
|
12544
12575
|
what a screen reader is given. Set a new object to redraw: the chart
|
|
12545
12576
|
does not look inside the one it has. */
|
|
12546
12577
|
data?: (HelixHeadlessDonutChart["data"]) | undefined;
|
|
12578
|
+
|
|
12579
|
+
/** The slice shown moved, or was put away: `index` is the slice's row, or `-1` for none, with its `label` and the `pointerType` that moved it. */
|
|
12580
|
+
"onhelix-reading-change"?: ((
|
|
12581
|
+
e: HelixHeadlessDonutChartHelixReadingChangeElementEvent,
|
|
12582
|
+
) => void) | undefined;
|
|
12583
|
+
/** A slice was clicked, tapped, or pressed with Enter or Space, with the same detail as `helix-reading-change`. */
|
|
12584
|
+
"onhelix-reading-press"?: ((
|
|
12585
|
+
e: HelixHeadlessDonutChartHelixReadingPressElementEvent,
|
|
12586
|
+
) => void) | undefined;
|
|
12547
12587
|
};
|
|
12548
12588
|
|
|
12549
12589
|
export type HelixHeadlessDonutChartSolidJsProps = {
|
|
@@ -12611,6 +12651,25 @@ rotation that puts the first slice at nine o'clock, the aspect ratio of a
|
|
|
12611
12651
|
box that is no longer square, and where the middle sits once the bottom of
|
|
12612
12652
|
the circle is not drawn. */
|
|
12613
12653
|
"prop:sweep"?: (HelixHeadlessDonutChart["sweep"]) | undefined;
|
|
12654
|
+
/** The words shown in place of the drawing when the table has no readings,
|
|
12655
|
+
and the fallback of the `empty` slot. */
|
|
12656
|
+
"attr:empty-text"?: (HelixHeadlessDonutChart["emptyText"]) | undefined;
|
|
12657
|
+
/** The words shown in place of the drawing when the table has no readings,
|
|
12658
|
+
and the fallback of the `empty` slot. */
|
|
12659
|
+
"prop:emptyText"?: (HelixHeadlessDonutChart["emptyText"]) | undefined;
|
|
12660
|
+
/** Whether the readings are still on their way. The chart shows
|
|
12661
|
+
`loading-text` in place of an empty drawing until it has readings.
|
|
12662
|
+
|
|
12663
|
+
Reflected, so a stylesheet can treat the chart while it waits. A chart
|
|
12664
|
+
that already has readings keeps drawing them, so a refresh does not
|
|
12665
|
+
blank it. */
|
|
12666
|
+
"prop:loading"?: (HelixHeadlessDonutChart["loading"]) | undefined;
|
|
12667
|
+
/** The words shown in place of the drawing while `loading` is set and
|
|
12668
|
+
there are no readings yet, and the fallback of the `loading` slot. */
|
|
12669
|
+
"attr:loading-text"?: (HelixHeadlessDonutChart["loadingText"]) | undefined;
|
|
12670
|
+
/** The words shown in place of the drawing while `loading` is set and
|
|
12671
|
+
there are no readings yet, and the fallback of the `loading` slot. */
|
|
12672
|
+
"prop:loadingText"?: (HelixHeadlessDonutChart["loadingText"]) | undefined;
|
|
12614
12673
|
/** The id of the table to read.
|
|
12615
12674
|
|
|
12616
12675
|
Names a table in the same tree, so a chart inside another component's
|
|
@@ -12670,6 +12729,14 @@ frame, and the summary, the keys and the readout are then the whole of
|
|
|
12670
12729
|
what a screen reader is given. Set a new object to redraw: the chart
|
|
12671
12730
|
does not look inside the one it has. */
|
|
12672
12731
|
"prop:data"?: (HelixHeadlessDonutChart["data"]) | undefined;
|
|
12732
|
+
/** The slice shown moved, or was put away: `index` is the slice's row, or `-1` for none, with its `label` and the `pointerType` that moved it. */
|
|
12733
|
+
"on:helix-reading-change"?: ((
|
|
12734
|
+
e: HelixHeadlessDonutChartHelixReadingChangeElementEvent,
|
|
12735
|
+
) => void) | undefined;
|
|
12736
|
+
/** A slice was clicked, tapped, or pressed with Enter or Space, with the same detail as `helix-reading-change`. */
|
|
12737
|
+
"on:helix-reading-press"?: ((
|
|
12738
|
+
e: HelixHeadlessDonutChartHelixReadingPressElementEvent,
|
|
12739
|
+
) => void) | undefined;
|
|
12673
12740
|
|
|
12674
12741
|
/** Set the innerHTML of the element */
|
|
12675
12742
|
innerHTML?: (string) | undefined;
|
|
@@ -14906,6 +14973,14 @@ own, since the fallback name is the same word. Empty leaves the role. */
|
|
|
14906
14973
|
"selected-label"?: (HelixHeadlessGraph["selectedLabel"]) | undefined;
|
|
14907
14974
|
/** How the selected note is described in the list. */
|
|
14908
14975
|
selectedLabel?: (HelixHeadlessGraph["selectedLabel"]) | undefined;
|
|
14976
|
+
/** What screen readers hear after a reader selects a note, in the list or in
|
|
14977
|
+
the drawing, with `{note}` for its name and `{count}` for how many notes
|
|
14978
|
+
the list then holds, written with `count-label`. */
|
|
14979
|
+
"selection-label"?: (HelixHeadlessGraph["selectionLabel"]) | undefined;
|
|
14980
|
+
/** What screen readers hear after a reader selects a note, in the list or in
|
|
14981
|
+
the drawing, with `{note}` for its name and `{count}` for how many notes
|
|
14982
|
+
the list then holds, written with `count-label`. */
|
|
14983
|
+
selectionLabel?: (HelixHeadlessGraph["selectionLabel"]) | undefined;
|
|
14909
14984
|
/** The hint shown when one finger swipes over the graph with `gestures="cooperative"`. */
|
|
14910
14985
|
"two-finger-hint-label"?: (HelixHeadlessGraph["twoFingerHintLabel"]) | undefined;
|
|
14911
14986
|
/** The hint shown when one finger swipes over the graph with `gestures="cooperative"`. */
|
|
@@ -15237,6 +15312,14 @@ own, since the fallback name is the same word. Empty leaves the role. */
|
|
|
15237
15312
|
"attr:selected-label"?: (HelixHeadlessGraph["selectedLabel"]) | undefined;
|
|
15238
15313
|
/** How the selected note is described in the list. */
|
|
15239
15314
|
"prop:selectedLabel"?: (HelixHeadlessGraph["selectedLabel"]) | undefined;
|
|
15315
|
+
/** What screen readers hear after a reader selects a note, in the list or in
|
|
15316
|
+
the drawing, with `{note}` for its name and `{count}` for how many notes
|
|
15317
|
+
the list then holds, written with `count-label`. */
|
|
15318
|
+
"attr:selection-label"?: (HelixHeadlessGraph["selectionLabel"]) | undefined;
|
|
15319
|
+
/** What screen readers hear after a reader selects a note, in the list or in
|
|
15320
|
+
the drawing, with `{note}` for its name and `{count}` for how many notes
|
|
15321
|
+
the list then holds, written with `count-label`. */
|
|
15322
|
+
"prop:selectionLabel"?: (HelixHeadlessGraph["selectionLabel"]) | undefined;
|
|
15240
15323
|
/** The hint shown when one finger swipes over the graph with `gestures="cooperative"`. */
|
|
15241
15324
|
"attr:two-finger-hint-label"?: (HelixHeadlessGraph["twoFingerHintLabel"]) | undefined;
|
|
15242
15325
|
/** The hint shown when one finger swipes over the graph with `gestures="cooperative"`. */
|
|
@@ -15609,8 +15692,9 @@ no order in it. */
|
|
|
15609
15692
|
/** The name the `overview` gives the total of the readings drawn,
|
|
15610
15693
|
`{totalLabel}` in `overview-label`. */
|
|
15611
15694
|
totalLabel?: (HelixHeadlessHeatmap["totalLabel"]) | undefined;
|
|
15612
|
-
/** The selected cells, by
|
|
15613
|
-
`2026-06-11`,
|
|
15695
|
+
/** The selected cells, separated by commas: each by the date its row's
|
|
15696
|
+
header carries in a `<time datetime>`, such as `2026-06-11`, or by the
|
|
15697
|
+
header's words where it carries none.
|
|
15614
15698
|
|
|
15615
15699
|
Set it to start with cells selected. Written by a press or a key under
|
|
15616
15700
|
`selection-mode`. */
|
|
@@ -15815,8 +15899,9 @@ no order in it. */
|
|
|
15815
15899
|
/** The name the `overview` gives the total of the readings drawn,
|
|
15816
15900
|
`{totalLabel}` in `overview-label`. */
|
|
15817
15901
|
"prop:totalLabel"?: (HelixHeadlessHeatmap["totalLabel"]) | undefined;
|
|
15818
|
-
/** The selected cells, by
|
|
15819
|
-
`2026-06-11`,
|
|
15902
|
+
/** The selected cells, separated by commas: each by the date its row's
|
|
15903
|
+
header carries in a `<time datetime>`, such as `2026-06-11`, or by the
|
|
15904
|
+
header's words where it carries none.
|
|
15820
15905
|
|
|
15821
15906
|
Set it to start with cells selected. Written by a press or a key under
|
|
15822
15907
|
`selection-mode`. */
|
|
@@ -19288,6 +19373,10 @@ loader is on the page.
|
|
|
19288
19373
|
Names an element in the same tree. In React it arrives as a property, the
|
|
19289
19374
|
way `Tooltip.for` does. */
|
|
19290
19375
|
for?: (HelixHeadlessLoader["for"]) | undefined;
|
|
19376
|
+
/** Whether no work is in progress. The loader draws nothing of its own, has
|
|
19377
|
+
no role, and marks no region busy, and what is in the `content` slot
|
|
19378
|
+
shows. Clearing it starts `delay` again. */
|
|
19379
|
+
idle?: (HelixHeadlessLoader["idle"]) | undefined;
|
|
19291
19380
|
/** The loader's name, announced by screen readers while the work is in
|
|
19292
19381
|
progress. */
|
|
19293
19382
|
label?: (HelixHeadlessLoader["label"]) | undefined;
|
|
@@ -19306,6 +19395,10 @@ loader is on the page.
|
|
|
19306
19395
|
Names an element in the same tree. In React it arrives as a property, the
|
|
19307
19396
|
way `Tooltip.for` does. */
|
|
19308
19397
|
"prop:for"?: (HelixHeadlessLoader["for"]) | undefined;
|
|
19398
|
+
/** Whether no work is in progress. The loader draws nothing of its own, has
|
|
19399
|
+
no role, and marks no region busy, and what is in the `content` slot
|
|
19400
|
+
shows. Clearing it starts `delay` again. */
|
|
19401
|
+
"prop:idle"?: (HelixHeadlessLoader["idle"]) | undefined;
|
|
19309
19402
|
/** The loader's name, announced by screen readers while the work is in
|
|
19310
19403
|
progress. */
|
|
19311
19404
|
"prop:label"?: (HelixHeadlessLoader["label"]) | undefined;
|
|
@@ -27790,6 +27883,18 @@ cannot be written in an attribute. */
|
|
|
27790
27883
|
textContent?: (string | number) | undefined;
|
|
27791
27884
|
};
|
|
27792
27885
|
|
|
27886
|
+
/** `HelixHeadlessSparkline` component event */
|
|
27887
|
+
export type HelixHeadlessSparklineElementEvent<E = Event> = TypedEvent<
|
|
27888
|
+
HelixHeadlessSparkline,
|
|
27889
|
+
E
|
|
27890
|
+
>;
|
|
27891
|
+
/** `helix-reading-change` event type */
|
|
27892
|
+
export type HelixHeadlessSparklineHelixReadingChangeElementEvent =
|
|
27893
|
+
HelixHeadlessSparklineElementEvent<HelixReadingChangeEvent>;
|
|
27894
|
+
/** `helix-reading-press` event type */
|
|
27895
|
+
export type HelixHeadlessSparklineHelixReadingPressElementEvent =
|
|
27896
|
+
HelixHeadlessSparklineElementEvent<HelixReadingPressEvent>;
|
|
27897
|
+
|
|
27793
27898
|
export type HelixHeadlessSparklineProps = {
|
|
27794
27899
|
/** How the line is drawn from one reading to the next.
|
|
27795
27900
|
|
|
@@ -27915,6 +28020,15 @@ with `values={[1240, 1318]}`. The attribute is the form to prefer, because
|
|
|
27915
28020
|
a string is what survives React's hydration where an array property does
|
|
27916
28021
|
not. */
|
|
27917
28022
|
values?: (HelixHeadlessSparkline["values"]) | undefined;
|
|
28023
|
+
|
|
28024
|
+
/** The reading shown moved, or was put away: `index` is the reading, or `-1` for none, with its row's `label` from a table and the `pointerType` that moved it. */
|
|
28025
|
+
"onhelix-reading-change"?: ((
|
|
28026
|
+
e: HelixHeadlessSparklineHelixReadingChangeElementEvent,
|
|
28027
|
+
) => void) | undefined;
|
|
28028
|
+
/** A reading was clicked, tapped, or pressed with Enter or Space, with the same detail as `helix-reading-change`. */
|
|
28029
|
+
"onhelix-reading-press"?: ((
|
|
28030
|
+
e: HelixHeadlessSparklineHelixReadingPressElementEvent,
|
|
28031
|
+
) => void) | undefined;
|
|
27918
28032
|
};
|
|
27919
28033
|
|
|
27920
28034
|
export type HelixHeadlessSparklineSolidJsProps = {
|
|
@@ -28042,6 +28156,14 @@ with `values={[1240, 1318]}`. The attribute is the form to prefer, because
|
|
|
28042
28156
|
a string is what survives React's hydration where an array property does
|
|
28043
28157
|
not. */
|
|
28044
28158
|
"prop:values"?: (HelixHeadlessSparkline["values"]) | undefined;
|
|
28159
|
+
/** The reading shown moved, or was put away: `index` is the reading, or `-1` for none, with its row's `label` from a table and the `pointerType` that moved it. */
|
|
28160
|
+
"on:helix-reading-change"?: ((
|
|
28161
|
+
e: HelixHeadlessSparklineHelixReadingChangeElementEvent,
|
|
28162
|
+
) => void) | undefined;
|
|
28163
|
+
/** A reading was clicked, tapped, or pressed with Enter or Space, with the same detail as `helix-reading-change`. */
|
|
28164
|
+
"on:helix-reading-press"?: ((
|
|
28165
|
+
e: HelixHeadlessSparklineHelixReadingPressElementEvent,
|
|
28166
|
+
) => void) | undefined;
|
|
28045
28167
|
|
|
28046
28168
|
/** Set the innerHTML of the element */
|
|
28047
28169
|
innerHTML?: (string) | undefined;
|
|
@@ -30757,8 +30879,9 @@ Absent selects nothing, and the tags carry no selected state at all. */
|
|
|
30757
30879
|
|
|
30758
30880
|
Absent selects nothing, and the tags carry no selected state at all. */
|
|
30759
30881
|
selectionMode?: (HelixHeadlessTagGroup["selectionMode"]) | undefined;
|
|
30760
|
-
/** The selected tags' values, separated by commas
|
|
30761
|
-
space.
|
|
30882
|
+
/** The selected tags' values, separated by commas with no space, as Toggle
|
|
30883
|
+
Group and Table write theirs, since a value may hold a space. A value
|
|
30884
|
+
written with a space after each comma is read the same way.
|
|
30762
30885
|
|
|
30763
30886
|
Set it to start with tags selected. A tag's value is its `value`, or its
|
|
30764
30887
|
words where it has none. */
|
|
@@ -30816,8 +30939,9 @@ Absent selects nothing, and the tags carry no selected state at all. */
|
|
|
30816
30939
|
|
|
30817
30940
|
Absent selects nothing, and the tags carry no selected state at all. */
|
|
30818
30941
|
"prop:selectionMode"?: (HelixHeadlessTagGroup["selectionMode"]) | undefined;
|
|
30819
|
-
/** The selected tags' values, separated by commas
|
|
30820
|
-
space.
|
|
30942
|
+
/** The selected tags' values, separated by commas with no space, as Toggle
|
|
30943
|
+
Group and Table write theirs, since a value may hold a space. A value
|
|
30944
|
+
written with a space after each comma is read the same way.
|
|
30821
30945
|
|
|
30822
30946
|
Set it to start with tags selected. A tag's value is its `value`, or its
|
|
30823
30947
|
words where it has none. */
|
|
@@ -31543,10 +31667,22 @@ never something this element would refuse to read back. */
|
|
|
31543
31667
|
/** The message shown when `disable-times` bars a time. */
|
|
31544
31668
|
unavailableMessage?: (HelixHeadlessTimeInput["unavailableMessage"]) | undefined;
|
|
31545
31669
|
/** The message for text that is no time, where `bad-input-message` is not
|
|
31546
|
-
set. `{mode}` is `single`, `range`, or `multiple`,
|
|
31670
|
+
set. `{mode}` is `single`, `range`, or `multiple`, `{example}` is a time
|
|
31671
|
+
written as the field writes one, `2:30 PM` in `en-US` and `14:30` in
|
|
31672
|
+
`de-DE`, and `{shape}` is `HH:mm`, or `HH:mm:ss` with `seconds`.
|
|
31673
|
+
|
|
31674
|
+
**The default names a time the field reads back.** It said "Enter a time
|
|
31675
|
+
as HH:mm." to a reader whose field showed `2:30 PM`, and a pattern token
|
|
31676
|
+
is words for a developer. */
|
|
31547
31677
|
"unreadable-message"?: (HelixHeadlessTimeInput["unreadableMessage"]) | undefined;
|
|
31548
31678
|
/** The message for text that is no time, where `bad-input-message` is not
|
|
31549
|
-
set. `{mode}` is `single`, `range`, or `multiple`,
|
|
31679
|
+
set. `{mode}` is `single`, `range`, or `multiple`, `{example}` is a time
|
|
31680
|
+
written as the field writes one, `2:30 PM` in `en-US` and `14:30` in
|
|
31681
|
+
`de-DE`, and `{shape}` is `HH:mm`, or `HH:mm:ss` with `seconds`.
|
|
31682
|
+
|
|
31683
|
+
**The default names a time the field reads back.** It said "Enter a time
|
|
31684
|
+
as HH:mm." to a reader whose field showed `2:30 PM`, and a pattern token
|
|
31685
|
+
is words for a developer. */
|
|
31550
31686
|
unreadableMessage?: (HelixHeadlessTimeInput["unreadableMessage"]) | undefined;
|
|
31551
31687
|
/** Whether the panel shows one list of times or a column for each part of the
|
|
31552
31688
|
time.
|
|
@@ -31939,10 +32075,22 @@ never something this element would refuse to read back. */
|
|
|
31939
32075
|
/** The message shown when `disable-times` bars a time. */
|
|
31940
32076
|
"prop:unavailableMessage"?: (HelixHeadlessTimeInput["unavailableMessage"]) | undefined;
|
|
31941
32077
|
/** The message for text that is no time, where `bad-input-message` is not
|
|
31942
|
-
set. `{mode}` is `single`, `range`, or `multiple`,
|
|
32078
|
+
set. `{mode}` is `single`, `range`, or `multiple`, `{example}` is a time
|
|
32079
|
+
written as the field writes one, `2:30 PM` in `en-US` and `14:30` in
|
|
32080
|
+
`de-DE`, and `{shape}` is `HH:mm`, or `HH:mm:ss` with `seconds`.
|
|
32081
|
+
|
|
32082
|
+
**The default names a time the field reads back.** It said "Enter a time
|
|
32083
|
+
as HH:mm." to a reader whose field showed `2:30 PM`, and a pattern token
|
|
32084
|
+
is words for a developer. */
|
|
31943
32085
|
"attr:unreadable-message"?: (HelixHeadlessTimeInput["unreadableMessage"]) | undefined;
|
|
31944
32086
|
/** The message for text that is no time, where `bad-input-message` is not
|
|
31945
|
-
set. `{mode}` is `single`, `range`, or `multiple`,
|
|
32087
|
+
set. `{mode}` is `single`, `range`, or `multiple`, `{example}` is a time
|
|
32088
|
+
written as the field writes one, `2:30 PM` in `en-US` and `14:30` in
|
|
32089
|
+
`de-DE`, and `{shape}` is `HH:mm`, or `HH:mm:ss` with `seconds`.
|
|
32090
|
+
|
|
32091
|
+
**The default names a time the field reads back.** It said "Enter a time
|
|
32092
|
+
as HH:mm." to a reader whose field showed `2:30 PM`, and a pattern token
|
|
32093
|
+
is words for a developer. */
|
|
31946
32094
|
"prop:unreadableMessage"?: (HelixHeadlessTimeInput["unreadableMessage"]) | undefined;
|
|
31947
32095
|
/** Whether the panel shows one list of times or a column for each part of the
|
|
31948
32096
|
time.
|
|
@@ -37608,6 +37756,18 @@ export type CustomElements = {
|
|
|
37608
37756
|
* there until readings arrive. The `empty` and `loading` slots take markup in
|
|
37609
37757
|
* their place, such as a link to add the first reading.
|
|
37610
37758
|
*
|
|
37759
|
+
* **Keyboard.** The plot is one tab stop.
|
|
37760
|
+
*
|
|
37761
|
+
* | Key | What it does |
|
|
37762
|
+
* |---|---|
|
|
37763
|
+
* | Tab | Moves focus to the plot and shows the first reading. |
|
|
37764
|
+
* | Right, Left | Moves to the next or the previous reading. On a right-to-left page, Left moves to the next. |
|
|
37765
|
+
* | Down, Up | Moves among the series of the reading. With one series, moves to the next or the previous reading. |
|
|
37766
|
+
* | Home, End | Moves to the first or the last reading. |
|
|
37767
|
+
* | Page Down, Page Up | Moves a tenth of the readings on or back. |
|
|
37768
|
+
* | Enter, Space | Presses the reading shown, which sends `helix-reading-press`. |
|
|
37769
|
+
* | Escape | Puts the reading and its tooltip away. |
|
|
37770
|
+
*
|
|
37611
37771
|
* ## Attributes & Properties
|
|
37612
37772
|
*
|
|
37613
37773
|
* Component attributes and properties that can be applied to the element or by using JavaScript.
|
|
@@ -37688,12 +37848,6 @@ export type CustomElements = {
|
|
|
37688
37848
|
* Set it to the words of the page's language, such as `{position} von
|
|
37689
37849
|
* {count}`, or to nothing to say no position. A slice or a series a
|
|
37690
37850
|
* legend hid is not counted.
|
|
37691
|
-
* - `pointer`: Finds the reading nearest the pointer, so the tooltip can sit on it.
|
|
37692
|
-
*
|
|
37693
|
-
* Public for the same reason `series` and `named` are: a protected member
|
|
37694
|
-
* cannot be cast onto across unrelated classes, so it would be invisible to
|
|
37695
|
-
* every chart that needs it. Reading where a pointer is resting is a fair
|
|
37696
|
-
* thing to ask a chart anyway. (property only) (readonly)
|
|
37697
37851
|
* - `data`: The readings as data, in the shape of a table, where the page has no
|
|
37698
37852
|
* table to point `for` at. `for` wins where both are set.
|
|
37699
37853
|
*
|
|
@@ -37732,21 +37886,6 @@ export type CustomElements = {
|
|
|
37732
37886
|
* names an element, and the chart is a generic around its plot: written
|
|
37733
37887
|
* on the host, the name reached nobody. The plot takes it, as Heatmap's
|
|
37734
37888
|
* strip always did. (property only) (readonly)
|
|
37735
|
-
* - `readingsKnown`: Whether the readings have been looked for: false on the server and
|
|
37736
|
-
* while hydrating, where no table is resolved and no data is read. A
|
|
37737
|
-
* chart says it has no readings only once this is true. (property only) (readonly)
|
|
37738
|
-
* - `sourceRows`: Every row of the table, with each cell's text and number.
|
|
37739
|
-
*
|
|
37740
|
-
* This is where a tooltip's content comes from, and it is deliberately not
|
|
37741
|
-
* `series`. A chart draws numbers; a reader resting a pointer on one wants
|
|
37742
|
-
* what the table says, which is `$128k` and not `128000`, and often wants
|
|
37743
|
-
* the column beside it that nothing plotted at all.
|
|
37744
|
-
*
|
|
37745
|
-
* **Not `rows`.** It is the source table's rows, and `rows` on a chart is a
|
|
37746
|
-
* name a chart wants for itself: `helix-heatmap` takes `rows="7"` to mean a
|
|
37747
|
-
* calendar week, and declaring that against a base class whose `rows` is a
|
|
37748
|
-
* `Row[]` getter is a type error at best. Name the member for what it holds
|
|
37749
|
-
* rather than for the shortest word available. (property only) (readonly)
|
|
37750
37889
|
* - `plottedColumns`: The positions of the cells in a row that hold numbers, in table order.
|
|
37751
37890
|
*
|
|
37752
37891
|
* The same test `readSeries` applies when it drops a column of notes: a
|
|
@@ -37792,8 +37931,6 @@ export type CustomElements = {
|
|
|
37792
37931
|
*
|
|
37793
37932
|
* Methods that can be called to access component functionality.
|
|
37794
37933
|
*
|
|
37795
|
-
* - `attributeChangedCallback(name: string, old: string | null, value: string | null) => void`: Called by the browser when an observed attribute changes. A new
|
|
37796
|
-
* `aria-label` asks for an update, because it names the plot.
|
|
37797
37934
|
* - `seriesOf(cell: number) => number | undefined`: The palette slot for the cell at this position in a row.
|
|
37798
37935
|
*
|
|
37799
37936
|
* **A cell's place in its row is not its series' depth, and the tooltip
|
|
@@ -37846,9 +37983,10 @@ export type CustomElements = {
|
|
|
37846
37983
|
* - `live`: The readout: a polite live region that says the reading the keys moved to. Hide it visually.
|
|
37847
37984
|
* - `loading`: The words in place of the drawing while `loading` is set and there are no readings: the `loading` slot, falling back to `loading-text`.
|
|
37848
37985
|
* - `mark`: The invisible point the tooltip is anchored to.
|
|
37849
|
-
* - `plot`: The drawing, which takes focus to be read by key.
|
|
37986
|
+
* - `plot`: The drawing, which takes focus to be read by key. With nothing to draw, a group named as the chart is, holding the `empty` or `loading` part.
|
|
37850
37987
|
* - `summary`: The total and each part's share at the latest reading, written as a sentence for screen readers.
|
|
37851
37988
|
* - `svg`: The drawing surface the bands sit on.
|
|
37989
|
+
* - `table`: The readings as a table, for a screen reader, rendered only where they were drawn from `data`. Hide it visually.
|
|
37852
37990
|
* - `tick`: One number on the axis, placed with `inset-block-start` at its level.
|
|
37853
37991
|
* - `tooltip`: The bubble, forwarded from `Tooltip`.
|
|
37854
37992
|
* - `tooltip-anchor`: The `Tooltip` element itself.
|
|
@@ -37871,6 +38009,9 @@ export type CustomElements = {
|
|
|
37871
38009
|
*
|
|
37872
38010
|
* These can be used to apply styling when a component is in a given state.
|
|
37873
38011
|
*
|
|
38012
|
+
* - `active`: While a reading is shown, under the pointer or the keys, with its tooltip open.
|
|
38013
|
+
* - `empty`: While the `empty` part stands in the plot.
|
|
38014
|
+
* - `loading`: While the `loading` part stands in the plot.
|
|
37874
38015
|
* - `settled`: Set one frame after the first render. Transitions wait for it, so an element does not animate its own arrival.
|
|
37875
38016
|
*/
|
|
37876
38017
|
"helix-headless-area-chart": Partial<
|
|
@@ -38065,7 +38206,7 @@ export type CustomElements = {
|
|
|
38065
38206
|
*
|
|
38066
38207
|
* Areas where markup can be added to the component.
|
|
38067
38208
|
*
|
|
38068
|
-
* - `(default)`: Shown when there is no usable image, in place of the initials.
|
|
38209
|
+
* - `(default)`: Shown when there is no usable image, in place of the initials. Hidden from assistive technology when the avatar has a `name`, which the host announces.
|
|
38069
38210
|
*
|
|
38070
38211
|
* ## CSS Parts
|
|
38071
38212
|
*
|
|
@@ -38251,6 +38392,19 @@ export type CustomElements = {
|
|
|
38251
38392
|
* there until readings arrive. The `empty` and `loading` slots take markup in
|
|
38252
38393
|
* their place, such as a link to add the first reading.
|
|
38253
38394
|
*
|
|
38395
|
+
* **Keyboard.** The plot is one tab stop.
|
|
38396
|
+
*
|
|
38397
|
+
* | Key | What it does |
|
|
38398
|
+
* |---|---|
|
|
38399
|
+
* | Tab | Moves focus to the plot and shows the first reading. |
|
|
38400
|
+
* | Right, Left | Moves to the next or the previous reading. On a right-to-left page, Left moves to the next. |
|
|
38401
|
+
* | Down, Up | Moves among the series of the reading. With one series, moves to the next or the previous reading. |
|
|
38402
|
+
* | Down, Up under `orientation="horizontal"` | Moves to the next or the previous reading, and Right and Left move among the series. |
|
|
38403
|
+
* | Home, End | Moves to the first or the last reading. |
|
|
38404
|
+
* | Page Down, Page Up | Moves a tenth of the readings on or back. |
|
|
38405
|
+
* | Enter, Space | Presses the reading shown, which sends `helix-reading-press`. |
|
|
38406
|
+
* | Escape | Puts the reading and its tooltip away. |
|
|
38407
|
+
*
|
|
38254
38408
|
* ## Attributes & Properties
|
|
38255
38409
|
*
|
|
38256
38410
|
* Component attributes and properties that can be applied to the element or by using JavaScript.
|
|
@@ -38390,12 +38544,6 @@ export type CustomElements = {
|
|
|
38390
38544
|
* Set it to the words of the page's language, such as `{position} von
|
|
38391
38545
|
* {count}`, or to nothing to say no position. A slice or a series a
|
|
38392
38546
|
* legend hid is not counted.
|
|
38393
|
-
* - `pointer`: Finds the reading nearest the pointer, so the tooltip can sit on it.
|
|
38394
|
-
*
|
|
38395
|
-
* Public for the same reason `series` and `named` are: a protected member
|
|
38396
|
-
* cannot be cast onto across unrelated classes, so it would be invisible to
|
|
38397
|
-
* every chart that needs it. Reading where a pointer is resting is a fair
|
|
38398
|
-
* thing to ask a chart anyway. (property only) (readonly)
|
|
38399
38547
|
* - `data`: The readings as data, in the shape of a table, where the page has no
|
|
38400
38548
|
* table to point `for` at. `for` wins where both are set.
|
|
38401
38549
|
*
|
|
@@ -38434,21 +38582,6 @@ export type CustomElements = {
|
|
|
38434
38582
|
* names an element, and the chart is a generic around its plot: written
|
|
38435
38583
|
* on the host, the name reached nobody. The plot takes it, as Heatmap's
|
|
38436
38584
|
* strip always did. (property only) (readonly)
|
|
38437
|
-
* - `readingsKnown`: Whether the readings have been looked for: false on the server and
|
|
38438
|
-
* while hydrating, where no table is resolved and no data is read. A
|
|
38439
|
-
* chart says it has no readings only once this is true. (property only) (readonly)
|
|
38440
|
-
* - `sourceRows`: Every row of the table, with each cell's text and number.
|
|
38441
|
-
*
|
|
38442
|
-
* This is where a tooltip's content comes from, and it is deliberately not
|
|
38443
|
-
* `series`. A chart draws numbers; a reader resting a pointer on one wants
|
|
38444
|
-
* what the table says, which is `$128k` and not `128000`, and often wants
|
|
38445
|
-
* the column beside it that nothing plotted at all.
|
|
38446
|
-
*
|
|
38447
|
-
* **Not `rows`.** It is the source table's rows, and `rows` on a chart is a
|
|
38448
|
-
* name a chart wants for itself: `helix-heatmap` takes `rows="7"` to mean a
|
|
38449
|
-
* calendar week, and declaring that against a base class whose `rows` is a
|
|
38450
|
-
* `Row[]` getter is a type error at best. Name the member for what it holds
|
|
38451
|
-
* rather than for the shortest word available. (property only) (readonly)
|
|
38452
38585
|
* - `plottedColumns`: The positions of the cells in a row that hold numbers, in table order.
|
|
38453
38586
|
*
|
|
38454
38587
|
* The same test `readSeries` applies when it drops a column of notes: a
|
|
@@ -38494,8 +38627,6 @@ export type CustomElements = {
|
|
|
38494
38627
|
*
|
|
38495
38628
|
* Methods that can be called to access component functionality.
|
|
38496
38629
|
*
|
|
38497
|
-
* - `attributeChangedCallback(name: string, old: string | null, value: string | null) => void`: Called by the browser when an observed attribute changes. A new
|
|
38498
|
-
* `aria-label` asks for an update, because it names the plot.
|
|
38499
38630
|
* - `seriesOf(cell: number) => number | undefined`: The palette slot for the cell at this position in a row.
|
|
38500
38631
|
*
|
|
38501
38632
|
* **A cell's place in its row is not its series' depth, and the tooltip
|
|
@@ -38554,9 +38685,10 @@ export type CustomElements = {
|
|
|
38554
38685
|
* - `live`: The readout: a polite live region that says the reading the keys moved to. Hide it visually.
|
|
38555
38686
|
* - `loading`: The words in place of the drawing while `loading` is set and there are no readings: the `loading` slot, falling back to `loading-text`.
|
|
38556
38687
|
* - `mark`: The invisible point the tooltip is anchored to.
|
|
38557
|
-
* - `plot`: The drawing, which takes focus to be read by key.
|
|
38688
|
+
* - `plot`: The drawing, which takes focus to be read by key. With nothing to draw, a group named as the chart is, holding the `empty` or `loading` part.
|
|
38558
38689
|
* - `summary`: The chart's name and each series' highest reading, written as a sentence for screen readers. Hide it visually.
|
|
38559
38690
|
* - `svg`: The drawing surface the bars and lines sit on.
|
|
38691
|
+
* - `table`: The readings as a table, for a screen reader, rendered only where they were drawn from `data`. Hide it visually.
|
|
38560
38692
|
* - `tick`: One number on an axis.
|
|
38561
38693
|
* - `tooltip`: The tooltip bubble, forwarded from `Tooltip`.
|
|
38562
38694
|
* - `tooltip-anchor`: The `Tooltip` element itself.
|
|
@@ -38579,6 +38711,9 @@ export type CustomElements = {
|
|
|
38579
38711
|
*
|
|
38580
38712
|
* These can be used to apply styling when a component is in a given state.
|
|
38581
38713
|
*
|
|
38714
|
+
* - `active`: While a reading is shown, under the pointer or the keys, with its tooltip open.
|
|
38715
|
+
* - `empty`: While the `empty` part stands in the plot.
|
|
38716
|
+
* - `loading`: While the `loading` part stands in the plot.
|
|
38582
38717
|
* - `settled`: Set one frame after the first render. Transitions wait for it, so an element does not animate its own arrival.
|
|
38583
38718
|
*/
|
|
38584
38719
|
"helix-headless-bar-chart": Partial<
|
|
@@ -39738,7 +39873,11 @@ export type CustomElements = {
|
|
|
39738
39873
|
* double click zooms out.
|
|
39739
39874
|
*
|
|
39740
39875
|
* Keyboard behavior:
|
|
39741
|
-
* - One card holds the board's tab stop
|
|
39876
|
+
* - One card holds the board's tab stop, and the board itself leaves the tab
|
|
39877
|
+
* order while a card can hold it. Escape on a card goes back out to the
|
|
39878
|
+
* board, where the arrow keys pan it.
|
|
39879
|
+
* - Plus and minus zoom the board, on the board and on a card or a
|
|
39880
|
+
* connection.
|
|
39742
39881
|
* - The arrow keys move through the cards in reading order. The card you land
|
|
39743
39882
|
* on scrolls into view, and its connections are announced with it.
|
|
39744
39883
|
* - The card you land on is selected. Control or Command with an arrow key,
|
|
@@ -40759,7 +40898,7 @@ export type CustomElements = {
|
|
|
40759
40898
|
*
|
|
40760
40899
|
* - `helix-send`: Fired when the user sends their turn, and cancelable.
|
|
40761
40900
|
* - `helix-typing`: The user started or stopped writing, with `typing` saying which, as the composer's `typing` does.
|
|
40762
|
-
* - `input`: The user changed the text. Read it from `value`, for a typing indicator or a saved draft.
|
|
40901
|
+
* - `input`: The user changed the text. Read it from `value`, for a typing indicator or a saved draft. Bubbles and is composed, as a native field's is.
|
|
40763
40902
|
*
|
|
40764
40903
|
* ## Slots
|
|
40765
40904
|
*
|
|
@@ -40819,6 +40958,8 @@ export type CustomElements = {
|
|
|
40819
40958
|
* - `setCustomValidity(message: string) => void`: Marks the control invalid with `message`, or clears that with an empty
|
|
40820
40959
|
* string, as on a native control. The form does not submit while it is set.
|
|
40821
40960
|
* - `focus(options?: FocusOptions) => void`: Moves focus to the control, as focusing a native control does.
|
|
40961
|
+
* - `formAssociatedCallback(form: HTMLFormElement | null) => void`: Called by the browser when the control's form changes: watches the new
|
|
40962
|
+
* form's `checkValidity()`, as connecting does for the form it starts in.
|
|
40822
40963
|
*
|
|
40823
40964
|
* ## CSS Parts
|
|
40824
40965
|
*
|
|
@@ -41428,6 +41569,8 @@ export type CustomElements = {
|
|
|
41428
41569
|
* - `setCustomValidity(message: string) => void`: Marks the control invalid with `message`, or clears that with an empty
|
|
41429
41570
|
* string, as on a native control. The form does not submit while it is set.
|
|
41430
41571
|
* - `focus(options?: FocusOptions) => void`: Moves focus to the control, as focusing a native control does.
|
|
41572
|
+
* - `formAssociatedCallback(form: HTMLFormElement | null) => void`: Called by the browser when the control's form changes: watches the new
|
|
41573
|
+
* form's `checkValidity()`, as connecting does for the form it starts in.
|
|
41431
41574
|
*
|
|
41432
41575
|
* ## CSS Parts
|
|
41433
41576
|
*
|
|
@@ -41687,6 +41830,8 @@ export type CustomElements = {
|
|
|
41687
41830
|
* - `setCustomValidity(message: string) => void`: Marks the control invalid with `message`, or clears that with an empty
|
|
41688
41831
|
* string, as on a native control. The form does not submit while it is set.
|
|
41689
41832
|
* - `focus(options?: FocusOptions) => void`: Moves focus to the control, as focusing a native control does.
|
|
41833
|
+
* - `formAssociatedCallback(form: HTMLFormElement | null) => void`: Called by the browser when the control's form changes: watches the new
|
|
41834
|
+
* form's `checkValidity()`, as connecting does for the form it starts in.
|
|
41690
41835
|
*
|
|
41691
41836
|
* ## CSS Parts
|
|
41692
41837
|
*
|
|
@@ -42382,6 +42527,8 @@ export type CustomElements = {
|
|
|
42382
42527
|
* and shows the browser's message at the control.
|
|
42383
42528
|
* - `setCustomValidity(message: string) => void`: Marks the control invalid with `message`, or clears that with an empty
|
|
42384
42529
|
* string, as on a native control. The form does not submit while it is set.
|
|
42530
|
+
* - `formAssociatedCallback(form: HTMLFormElement | null) => void`: Called by the browser when the control's form changes: watches the new
|
|
42531
|
+
* form's `checkValidity()`, as connecting does for the form it starts in.
|
|
42385
42532
|
*
|
|
42386
42533
|
* ## CSS Custom Properties
|
|
42387
42534
|
*
|
|
@@ -42795,6 +42942,8 @@ export type CustomElements = {
|
|
|
42795
42942
|
* and shows the browser's message at the control.
|
|
42796
42943
|
* - `setCustomValidity(message: string) => void`: Marks the control invalid with `message`, or clears that with an empty
|
|
42797
42944
|
* string, as on a native control. The form does not submit while it is set.
|
|
42945
|
+
* - `formAssociatedCallback(form: HTMLFormElement | null) => void`: Called by the browser when the control's form changes: watches the new
|
|
42946
|
+
* form's `checkValidity()`, as connecting does for the form it starts in.
|
|
42798
42947
|
*
|
|
42799
42948
|
* ## CSS Custom Properties
|
|
42800
42949
|
*
|
|
@@ -43233,6 +43382,8 @@ export type CustomElements = {
|
|
|
43233
43382
|
* - `setCustomValidity(message: string) => void`: Marks the control invalid with `message`, or clears that with an empty
|
|
43234
43383
|
* string, as on a native control. The form does not submit while it is set.
|
|
43235
43384
|
* - `focus(options?: FocusOptions) => void`: Moves focus to the control, as focusing a native control does.
|
|
43385
|
+
* - `formAssociatedCallback(form: HTMLFormElement | null) => void`: Called by the browser when the control's form changes: watches the new
|
|
43386
|
+
* form's `checkValidity()`, as connecting does for the form it starts in.
|
|
43236
43387
|
*
|
|
43237
43388
|
* ## CSS Parts
|
|
43238
43389
|
*
|
|
@@ -43709,7 +43860,8 @@ export type CustomElements = {
|
|
|
43709
43860
|
*
|
|
43710
43861
|
* Methods that can be called to access component functionality.
|
|
43711
43862
|
*
|
|
43712
|
-
* - `formAssociatedCallback(form: HTMLFormElement | null) => void`: Called by the browser when the
|
|
43863
|
+
* - `formAssociatedCallback(form: HTMLFormElement | null) => void`: Called by the browser when the control's form changes: watches the new
|
|
43864
|
+
* form's `checkValidity()`, as connecting does for the form it starts in.
|
|
43713
43865
|
* - `formDisabledCallback(disabled: boolean) => void`: Called by the browser when an ancestor fieldset is disabled or enabled.
|
|
43714
43866
|
*
|
|
43715
43867
|
* **The argument is the effective state, and taking it whole is what latched
|
|
@@ -44715,6 +44867,8 @@ export type CustomElements = {
|
|
|
44715
44867
|
* and shows the browser's message at the control.
|
|
44716
44868
|
* - `setCustomValidity(message: string) => void`: Marks the control invalid with `message`, or clears that with an empty
|
|
44717
44869
|
* string, as on a native control. The form does not submit while it is set.
|
|
44870
|
+
* - `formAssociatedCallback(form: HTMLFormElement | null) => void`: Called by the browser when the control's form changes: watches the new
|
|
44871
|
+
* form's `checkValidity()`, as connecting does for the form it starts in.
|
|
44718
44872
|
*
|
|
44719
44873
|
* ## CSS Parts
|
|
44720
44874
|
*
|
|
@@ -45142,6 +45296,8 @@ export type CustomElements = {
|
|
|
45142
45296
|
* and shows the browser's message at the control.
|
|
45143
45297
|
* - `setCustomValidity(message: string) => void`: Marks the control invalid with `message`, or clears that with an empty
|
|
45144
45298
|
* string, as on a native control. The form does not submit while it is set.
|
|
45299
|
+
* - `formAssociatedCallback(form: HTMLFormElement | null) => void`: Called by the browser when the control's form changes: watches the new
|
|
45300
|
+
* form's `checkValidity()`, as connecting does for the form it starts in.
|
|
45145
45301
|
*
|
|
45146
45302
|
* ## CSS Custom Properties
|
|
45147
45303
|
*
|
|
@@ -45683,6 +45839,27 @@ export type CustomElements = {
|
|
|
45683
45839
|
* follows, the `live` part says the slice in words, and Escape puts the
|
|
45684
45840
|
* tooltip away.
|
|
45685
45841
|
*
|
|
45842
|
+
* **A tap shows the slice under it**, and keeps it until a tap lands
|
|
45843
|
+
* elsewhere. `helix-reading-change` says each move of the slice shown, by
|
|
45844
|
+
* pointer, tap or key, and `helix-reading-press` says a slice was clicked,
|
|
45845
|
+
* tapped, or pressed with Enter or Space, for a page that opens what a slice
|
|
45846
|
+
* stands for. `index` is the slice's row in the table.
|
|
45847
|
+
*
|
|
45848
|
+
* **A chart with nothing to draw says so.** A table with no readings shows
|
|
45849
|
+
* `empty-text`, "No readings", in the plot, and `loading` shows `loading-text`
|
|
45850
|
+
* there until readings arrive. The `empty` and `loading` slots take markup in
|
|
45851
|
+
* their place.
|
|
45852
|
+
*
|
|
45853
|
+
* **Keyboard.** The plot is one tab stop.
|
|
45854
|
+
*
|
|
45855
|
+
* | Key | What it does |
|
|
45856
|
+
* |---|---|
|
|
45857
|
+
* | Tab | Moves focus to the plot and shows the first slice. |
|
|
45858
|
+
* | Any arrow | Right and Down move to the next slice, Left and Up to the previous. On a right-to-left page, Left moves to the next. |
|
|
45859
|
+
* | Home, End | Moves to the first or the last slice. |
|
|
45860
|
+
* | Enter, Space | Presses the slice shown, which sends `helix-reading-press`. |
|
|
45861
|
+
* | Escape | Puts the slice and its tooltip away. |
|
|
45862
|
+
*
|
|
45686
45863
|
* ## Attributes & Properties
|
|
45687
45864
|
*
|
|
45688
45865
|
* Component attributes and properties that can be applied to the element or by using JavaScript.
|
|
@@ -45740,6 +45917,16 @@ export type CustomElements = {
|
|
|
45740
45917
|
* rotation that puts the first slice at nine o'clock, the aspect ratio of a
|
|
45741
45918
|
* box that is no longer square, and where the middle sits once the bottom of
|
|
45742
45919
|
* the circle is not drawn.
|
|
45920
|
+
* - `empty-text`/`emptyText`: The words shown in place of the drawing when the table has no readings,
|
|
45921
|
+
* and the fallback of the `empty` slot.
|
|
45922
|
+
* - `loading`: Whether the readings are still on their way. The chart shows
|
|
45923
|
+
* `loading-text` in place of an empty drawing until it has readings.
|
|
45924
|
+
*
|
|
45925
|
+
* Reflected, so a stylesheet can treat the chart while it waits. A chart
|
|
45926
|
+
* that already has readings keeps drawing them, so a refresh does not
|
|
45927
|
+
* blank it.
|
|
45928
|
+
* - `loading-text`/`loadingText`: The words shown in place of the drawing while `loading` is set and
|
|
45929
|
+
* there are no readings yet, and the fallback of the `loading` slot.
|
|
45743
45930
|
* - `for`: The id of the table to read.
|
|
45744
45931
|
*
|
|
45745
45932
|
* Names a table in the same tree, so a chart inside another component's
|
|
@@ -45768,12 +45955,6 @@ export type CustomElements = {
|
|
|
45768
45955
|
*
|
|
45769
45956
|
* The mixin counts the table's rows, and a row with no amount draws no
|
|
45770
45957
|
* slice, so a key stepping by rows would land on a slice that is not there. (property only) (readonly)
|
|
45771
|
-
* - `pointer`: Finds the reading nearest the pointer, so the tooltip can sit on it.
|
|
45772
|
-
*
|
|
45773
|
-
* Public for the same reason `series` and `named` are: a protected member
|
|
45774
|
-
* cannot be cast onto across unrelated classes, so it would be invisible to
|
|
45775
|
-
* every chart that needs it. Reading where a pointer is resting is a fair
|
|
45776
|
-
* thing to ask a chart anyway. (property only) (readonly)
|
|
45777
45958
|
* - `data`: The readings as data, in the shape of a table, where the page has no
|
|
45778
45959
|
* table to point `for` at. `for` wins where both are set.
|
|
45779
45960
|
*
|
|
@@ -45812,21 +45993,6 @@ export type CustomElements = {
|
|
|
45812
45993
|
* names an element, and the chart is a generic around its plot: written
|
|
45813
45994
|
* on the host, the name reached nobody. The plot takes it, as Heatmap's
|
|
45814
45995
|
* strip always did. (property only) (readonly)
|
|
45815
|
-
* - `readingsKnown`: Whether the readings have been looked for: false on the server and
|
|
45816
|
-
* while hydrating, where no table is resolved and no data is read. A
|
|
45817
|
-
* chart says it has no readings only once this is true. (property only) (readonly)
|
|
45818
|
-
* - `sourceRows`: Every row of the table, with each cell's text and number.
|
|
45819
|
-
*
|
|
45820
|
-
* This is where a tooltip's content comes from, and it is deliberately not
|
|
45821
|
-
* `series`. A chart draws numbers; a reader resting a pointer on one wants
|
|
45822
|
-
* what the table says, which is `$128k` and not `128000`, and often wants
|
|
45823
|
-
* the column beside it that nothing plotted at all.
|
|
45824
|
-
*
|
|
45825
|
-
* **Not `rows`.** It is the source table's rows, and `rows` on a chart is a
|
|
45826
|
-
* name a chart wants for itself: `helix-heatmap` takes `rows="7"` to mean a
|
|
45827
|
-
* calendar week, and declaring that against a base class whose `rows` is a
|
|
45828
|
-
* `Row[]` getter is a type error at best. Name the member for what it holds
|
|
45829
|
-
* rather than for the shortest word available. (property only) (readonly)
|
|
45830
45996
|
* - `plottedColumns`: The positions of the cells in a row that hold numbers, in table order.
|
|
45831
45997
|
*
|
|
45832
45998
|
* The same test `readSeries` applies when it drops a column of notes: a
|
|
@@ -45853,11 +46019,20 @@ export type CustomElements = {
|
|
|
45853
46019
|
* browser harness's awaits it alone: a browser always runs the frame, and a
|
|
45854
46020
|
* timer beside it was a bet on how long one takes, which a busy run lost. (property only) (readonly)
|
|
45855
46021
|
*
|
|
46022
|
+
* ## Events
|
|
46023
|
+
*
|
|
46024
|
+
* Events that will be emitted by the component.
|
|
46025
|
+
*
|
|
46026
|
+
* - `helix-reading-change`: The slice shown moved, or was put away: `index` is the slice's row, or `-1` for none, with its `label` and the `pointerType` that moved it.
|
|
46027
|
+
* - `helix-reading-press`: A slice was clicked, tapped, or pressed with Enter or Space, with the same detail as `helix-reading-change`.
|
|
46028
|
+
*
|
|
45856
46029
|
* ## Slots
|
|
45857
46030
|
*
|
|
45858
46031
|
* Areas where markup can be added to the component.
|
|
45859
46032
|
*
|
|
45860
46033
|
* - `(default)`: Content in the middle of the ring, usually a total. It is read by screen readers, while the ring itself is hidden from them.
|
|
46034
|
+
* - `empty`: Content shown in place of the ring when the table has no readings. Falls back to `empty-text`.
|
|
46035
|
+
* - `loading`: Content shown in place of the ring while `loading` is set and there are no readings yet. Falls back to `loading-text`.
|
|
45861
46036
|
*
|
|
45862
46037
|
* ## Methods
|
|
45863
46038
|
*
|
|
@@ -45868,8 +46043,6 @@ export type CustomElements = {
|
|
|
45868
46043
|
* no series the keys could move to.
|
|
45869
46044
|
* - `showsReading(at: number) => boolean`: Whether the slice at this place is drawn, which a slice a legend hid is
|
|
45870
46045
|
* not. The keys pass over it, as the ring closes over it.
|
|
45871
|
-
* - `attributeChangedCallback(name: string, old: string | null, value: string | null) => void`: Called by the browser when an observed attribute changes. A new
|
|
45872
|
-
* `aria-label` asks for an update, because it names the plot.
|
|
45873
46046
|
* - `showsSeries(name: string) => boolean`: Whether the series of this name is drawn, which it is unless a legend
|
|
45874
46047
|
* reading the same table hid it.
|
|
45875
46048
|
*
|
|
@@ -45898,14 +46071,17 @@ export type CustomElements = {
|
|
|
45898
46071
|
* Custom selectors for styling elements within the component.
|
|
45899
46072
|
*
|
|
45900
46073
|
* - `center`: The middle of the ring, holding whatever is slotted.
|
|
46074
|
+
* - `empty`: The words in place of the ring when the table has no readings: the `empty` slot, falling back to `empty-text`. Not drawn while the table cannot be read yet, on the server and during hydration.
|
|
45901
46075
|
* - `live`: The readout: a polite live region that says the slice the keys moved to. Hide it visually.
|
|
46076
|
+
* - `loading`: The words in place of the ring while `loading` is set and there are no readings: the `loading` slot, falling back to `loading-text`.
|
|
45902
46077
|
* - `mark`: The invisible point the tooltip is anchored to.
|
|
45903
|
-
* - `plot`: The drawing, which takes focus to be read by key.
|
|
46078
|
+
* - `plot`: The drawing, which takes focus to be read by key. With nothing to draw, a group named as the chart is, holding the `empty` or `loading` part.
|
|
45904
46079
|
* - `segment`: One slice.
|
|
45905
46080
|
* - `segment-active`: The slice under the pointer. Set alongside `segment`.
|
|
45906
46081
|
* - `segment-edge`: One slice as a closed shape, used to draw its outline.
|
|
45907
46082
|
* - `slice-label`: One slice's share, written on the slice under `slice-labels`. Placed with `left` and `top`, or `inset-inline-start` and `top` on a half ring, and carries its series color as `--chart-series`.
|
|
45908
46083
|
* - `summary`: The chart's name and each slice's share, written as a sentence for screen readers. Hide it visually.
|
|
46084
|
+
* - `table`: The readings as a table, for a screen reader, rendered only where they were drawn from `data`. Hide it visually.
|
|
45909
46085
|
* - `tooltip`: The bubble, forwarded from `Tooltip`.
|
|
45910
46086
|
* - `tooltip-anchor`: The `Tooltip` element itself.
|
|
45911
46087
|
* - `tooltip-arrow`: The bubble's point, forwarded from `Tooltip`.
|
|
@@ -45928,6 +46104,9 @@ export type CustomElements = {
|
|
|
45928
46104
|
*
|
|
45929
46105
|
* These can be used to apply styling when a component is in a given state.
|
|
45930
46106
|
*
|
|
46107
|
+
* - `active`: While a slice is shown, under the pointer or the keys, with its tooltip open.
|
|
46108
|
+
* - `empty`: While the `empty` part stands in place of the ring.
|
|
46109
|
+
* - `loading`: While the `loading` part stands in place of the ring.
|
|
45931
46110
|
* - `settled`: Set one frame after the first render. Transitions wait for it, so an element does not animate its own arrival.
|
|
45932
46111
|
*/
|
|
45933
46112
|
"helix-headless-donut-chart": Partial<
|
|
@@ -46783,8 +46962,9 @@ export type CustomElements = {
|
|
|
46783
46962
|
*
|
|
46784
46963
|
* Not through `commit`, and that is the point of the split: a reset is the
|
|
46785
46964
|
* form's decision and there is nothing here for a listener to refuse. What it
|
|
46786
|
-
* owes is the report
|
|
46787
|
-
* `
|
|
46965
|
+
* owes is the report to the form, and no `input` or `change`: a native file
|
|
46966
|
+
* input sends neither on `form.reset()`, measured in Chromium, where this
|
|
46967
|
+
* sent both.
|
|
46788
46968
|
* - `formDisabledCallback(disabled: boolean) => void`: Called by the browser when an ancestor fieldset is disabled or enabled.
|
|
46789
46969
|
*
|
|
46790
46970
|
* **The argument is the effective state, and taking it whole is what latched
|
|
@@ -46824,6 +47004,8 @@ export type CustomElements = {
|
|
|
46824
47004
|
* and shows the browser's message at the control.
|
|
46825
47005
|
* - `setCustomValidity(message: string) => void`: Marks the control invalid with `message`, or clears that with an empty
|
|
46826
47006
|
* string, as on a native control. The form does not submit while it is set.
|
|
47007
|
+
* - `formAssociatedCallback(form: HTMLFormElement | null) => void`: Called by the browser when the control's form changes: watches the new
|
|
47008
|
+
* form's `checkValidity()`, as connecting does for the form it starts in.
|
|
46827
47009
|
*
|
|
46828
47010
|
* ## CSS Parts
|
|
46829
47011
|
*
|
|
@@ -47783,6 +47965,8 @@ export type CustomElements = {
|
|
|
47783
47965
|
* and shows the browser's message at the control.
|
|
47784
47966
|
* - `setCustomValidity(message: string) => void`: Marks the control invalid with `message`, or clears that with an empty
|
|
47785
47967
|
* string, as on a native control. The form does not submit while it is set.
|
|
47968
|
+
* - `formAssociatedCallback(form: HTMLFormElement | null) => void`: Called by the browser when the control's form changes: watches the new
|
|
47969
|
+
* form's `checkValidity()`, as connecting does for the form it starts in.
|
|
47786
47970
|
*
|
|
47787
47971
|
* ## CSS Parts
|
|
47788
47972
|
*
|
|
@@ -48029,7 +48213,9 @@ export type CustomElements = {
|
|
|
48029
48213
|
*
|
|
48030
48214
|
* Set `legend` to name the groups over the drawing, each a button that shows
|
|
48031
48215
|
* or hides its notes. `hiddenGroups` holds the groups turned off, and the
|
|
48032
|
-
* list holds only what the drawing shows.
|
|
48216
|
+
* list holds only what the drawing shows. The legend is a toolbar and one tab
|
|
48217
|
+
* stop: the arrow keys, Home, End and a group's first letters move between
|
|
48218
|
+
* its buttons, and Space or Enter presses one.
|
|
48033
48219
|
*
|
|
48034
48220
|
* `nodes` and `links` are properties, never markup: a graph of ten thousand
|
|
48035
48221
|
* notes as ten thousand elements would cost what the renderer exists to save.
|
|
@@ -48079,6 +48265,9 @@ export type CustomElements = {
|
|
|
48079
48265
|
* own, since the fallback name is the same word. Empty leaves the role.
|
|
48080
48266
|
* - `search-label`/`searchLabel`: The search field's name.
|
|
48081
48267
|
* - `selected-label`/`selectedLabel`: How the selected note is described in the list.
|
|
48268
|
+
* - `selection-label`/`selectionLabel`: What screen readers hear after a reader selects a note, in the list or in
|
|
48269
|
+
* the drawing, with `{note}` for its name and `{count}` for how many notes
|
|
48270
|
+
* the list then holds, written with `count-label`.
|
|
48082
48271
|
* - `two-finger-hint-label`/`twoFingerHintLabel`: The hint shown when one finger swipes over the graph with `gestures="cooperative"`.
|
|
48083
48272
|
* - `using-label`/`usingLabel`: The line shown while the graph, with `gestures="activate"`, has the gestures.
|
|
48084
48273
|
* - `wheel-hint-label`/`wheelHintLabel`: The hint shown when the wheel scrolls past the graph with
|
|
@@ -48267,18 +48456,10 @@ export type CustomElements = {
|
|
|
48267
48456
|
* **Said once the drawing has moved, and only then.** The frame asks and
|
|
48268
48457
|
* the renderer moves, so a frame with nothing to answer it says nothing: a
|
|
48269
48458
|
* move said that never happened is worse than silence.
|
|
48459
|
+
* - `requestActive(next: string, cause?: string) => boolean`: Asks for a note to be selected, and remembers the ask, so the selection is said once it lands.
|
|
48270
48460
|
* - `pan(to: ViewportWay) => void`: Pans the view one step in a direction.
|
|
48271
48461
|
* - `zoom(by: number) => void`: Zooms the view one step: `1` zooms in and `-1` zooms out.
|
|
48272
48462
|
* - `toggleFullscreen() => void`: Turns fullscreen on or off.
|
|
48273
|
-
* - `requestActive(next: string, cause?: string) => boolean`: Requests a new current item, and returns whether the change was applied.
|
|
48274
|
-
*
|
|
48275
|
-
* Announces before it acts, so `preventDefault()` on the `helix-before-activate` is
|
|
48276
|
-
* a refusal and nothing moves. Unlike a native control, nothing has moved
|
|
48277
|
-
* by the time this runs, so refusing is simply not writing: there is
|
|
48278
|
-
* nothing to put back. Nobody refusing means the set updates itself,
|
|
48279
|
-
* whether or not a consumer declared `active`, a declared property being a
|
|
48280
|
-
* seed and a correction. `cause` says why, where the family names its
|
|
48281
|
-
* causes, and reaches the event as `detail.cause`.
|
|
48282
48463
|
*
|
|
48283
48464
|
* ## CSS Parts
|
|
48284
48465
|
*
|
|
@@ -48297,7 +48478,7 @@ export type CustomElements = {
|
|
|
48297
48478
|
* - `gesture-hint`: Words over the graph for a moment when it lets a gesture pass to the page, such as how to zoom it.
|
|
48298
48479
|
* - `gesture-status`: The line shown while a graph with `gestures="activate"` has the gestures.
|
|
48299
48480
|
* - `header`: The strip above the graph.
|
|
48300
|
-
* - `legend`: The groups over the drawing, with `legend
|
|
48481
|
+
* - `legend`: The groups over the drawing, with `legend`: a toolbar of buttons, each showing or hiding its notes, which is one tab stop.
|
|
48301
48482
|
* - `legend-item`: One group in the legend, pressed while its notes are shown. Carries `data-tone` where every note in the group has the same tone, which colors the notes over the group's own color.
|
|
48302
48483
|
* - `legend-item-hidden`: A group in the legend whose notes are hidden.
|
|
48303
48484
|
* - `legend-swatch`: The mark in a group's color, before its name.
|
|
@@ -48383,11 +48564,25 @@ export type CustomElements = {
|
|
|
48383
48564
|
* `multiple` any number. Space, Enter or a press selects the cell the keys or
|
|
48384
48565
|
* the pointer rest on, or lets it go, and under `multiple` Shift with an arrow,
|
|
48385
48566
|
* Home, End, PageUp or PageDown takes in every cell from the last one pressed
|
|
48386
|
-
* to where the key went. `value` holds the selected days, by
|
|
48387
|
-
*
|
|
48567
|
+
* to where the key went. `value` holds the selected days, separated by
|
|
48568
|
+
* commas: each by its row's `<time datetime>`, such as `2026-06-11`, or by
|
|
48569
|
+
* its row's name where the row carries no date. A change asks with
|
|
48388
48570
|
* `helix-before-change` and tells with `change`, and the `selection` part says
|
|
48389
48571
|
* how many are selected, in `selection-label`.
|
|
48390
48572
|
*
|
|
48573
|
+
* **Keyboard.** The strip is one tab stop once it has cells.
|
|
48574
|
+
*
|
|
48575
|
+
* | Key | What it does |
|
|
48576
|
+
* |---|---|
|
|
48577
|
+
* | Tab | Moves focus to the strip and shows the first cell. |
|
|
48578
|
+
* | Down, Up | Moves to the next or the previous cell. |
|
|
48579
|
+
* | Right, Left | Moves a column on or back, a week with `rows="7"`. On a right-to-left page, Left moves on. |
|
|
48580
|
+
* | Home, End | Moves to the first or the last cell. |
|
|
48581
|
+
* | Page Down, Page Up | Moves a month on or back where the rows carry dates, and four columns otherwise. |
|
|
48582
|
+
* | Enter, Space | Selects the cell, or lets it go, under `selection-mode`. |
|
|
48583
|
+
* | Shift with an arrow, Home, End, Page Up or Page Down | Selects every cell from the last one pressed to where the key went, under `selection-mode="multiple"`. |
|
|
48584
|
+
* | Escape | Puts the cell's tooltip away. |
|
|
48585
|
+
*
|
|
48391
48586
|
* ## Attributes & Properties
|
|
48392
48587
|
*
|
|
48393
48588
|
* Component attributes and properties that can be applied to the element or by using JavaScript.
|
|
@@ -48458,8 +48653,9 @@ export type CustomElements = {
|
|
|
48458
48653
|
* no order in it.
|
|
48459
48654
|
* - `total-label`/`totalLabel`: The name the `overview` gives the total of the readings drawn,
|
|
48460
48655
|
* `{totalLabel}` in `overview-label`.
|
|
48461
|
-
* - `value`: The selected cells, by
|
|
48462
|
-
* `2026-06-11`,
|
|
48656
|
+
* - `value`: The selected cells, separated by commas: each by the date its row's
|
|
48657
|
+
* header carries in a `<time datetime>`, such as `2026-06-11`, or by the
|
|
48658
|
+
* header's words where it carries none.
|
|
48463
48659
|
*
|
|
48464
48660
|
* Set it to start with cells selected. Written by a press or a key under
|
|
48465
48661
|
* `selection-mode`.
|
|
@@ -48505,12 +48701,6 @@ export type CustomElements = {
|
|
|
48505
48701
|
*
|
|
48506
48702
|
* The mixin counts the table's rows, and a strip too narrow for all of them
|
|
48507
48703
|
* draws the newest, so a key stepping by rows would walk off the drawing. (property only) (readonly)
|
|
48508
|
-
* - `pointer`: Finds the reading nearest the pointer, so the tooltip can sit on it.
|
|
48509
|
-
*
|
|
48510
|
-
* Public for the same reason `series` and `named` are: a protected member
|
|
48511
|
-
* cannot be cast onto across unrelated classes, so it would be invisible to
|
|
48512
|
-
* every chart that needs it. Reading where a pointer is resting is a fair
|
|
48513
|
-
* thing to ask a chart anyway. (property only) (readonly)
|
|
48514
48704
|
* - `data`: The readings as data, in the shape of a table, where the page has no
|
|
48515
48705
|
* table to point `for` at. `for` wins where both are set.
|
|
48516
48706
|
*
|
|
@@ -48549,21 +48739,6 @@ export type CustomElements = {
|
|
|
48549
48739
|
* names an element, and the chart is a generic around its plot: written
|
|
48550
48740
|
* on the host, the name reached nobody. The plot takes it, as Heatmap's
|
|
48551
48741
|
* strip always did. (property only) (readonly)
|
|
48552
|
-
* - `readingsKnown`: Whether the readings have been looked for: false on the server and
|
|
48553
|
-
* while hydrating, where no table is resolved and no data is read. A
|
|
48554
|
-
* chart says it has no readings only once this is true. (property only) (readonly)
|
|
48555
|
-
* - `sourceRows`: Every row of the table, with each cell's text and number.
|
|
48556
|
-
*
|
|
48557
|
-
* This is where a tooltip's content comes from, and it is deliberately not
|
|
48558
|
-
* `series`. A chart draws numbers; a reader resting a pointer on one wants
|
|
48559
|
-
* what the table says, which is `$128k` and not `128000`, and often wants
|
|
48560
|
-
* the column beside it that nothing plotted at all.
|
|
48561
|
-
*
|
|
48562
|
-
* **Not `rows`.** It is the source table's rows, and `rows` on a chart is a
|
|
48563
|
-
* name a chart wants for itself: `helix-heatmap` takes `rows="7"` to mean a
|
|
48564
|
-
* calendar week, and declaring that against a base class whose `rows` is a
|
|
48565
|
-
* `Row[]` getter is a type error at best. Name the member for what it holds
|
|
48566
|
-
* rather than for the shortest word available. (property only) (readonly)
|
|
48567
48742
|
* - `plottedColumns`: The positions of the cells in a row that hold numbers, in table order.
|
|
48568
48743
|
*
|
|
48569
48744
|
* The same test `readSeries` applies when it drops a column of notes: a
|
|
@@ -48613,8 +48788,6 @@ export type CustomElements = {
|
|
|
48613
48788
|
* - `pageFrom(at: number, forward: boolean) => number | undefined`: Where PageUp or PageDown goes from the drawn cell at `at`: the same day a
|
|
48614
48789
|
* month on or back, by the dates the rows' headers carry. Undefined where
|
|
48615
48790
|
* they carry none, and the keys move four columns.
|
|
48616
|
-
* - `attributeChangedCallback(name: string, old: string | null, value: string | null) => void`: Called by the browser when an observed attribute changes. A new
|
|
48617
|
-
* `aria-label` asks for an update, because it names the plot.
|
|
48618
48791
|
* - `seriesOf(cell: number) => number | undefined`: The palette slot for the cell at this position in a row.
|
|
48619
48792
|
*
|
|
48620
48793
|
* **A cell's place in its row is not its series' depth, and the tooltip
|
|
@@ -48681,6 +48854,7 @@ export type CustomElements = {
|
|
|
48681
48854
|
* - `start`: The leading slot's box.
|
|
48682
48855
|
* - `strip`: The grid of cells, which takes focus to be read by key. It is named by the host's `aria-labelledby` or `aria-label`, then by `label`, then by the caption of the table.
|
|
48683
48856
|
* - `summary`: The middle slot's box.
|
|
48857
|
+
* - `table`: The readings as a table, for a screen reader, rendered only where they were drawn from `data`. Hide it visually.
|
|
48684
48858
|
* - `tooltip`: The bubble, forwarded from `Tooltip`.
|
|
48685
48859
|
* - `tooltip-anchor`: The `Tooltip` element itself.
|
|
48686
48860
|
* - `tooltip-arrow`: The bubble's point, forwarded from `Tooltip`.
|
|
@@ -48702,6 +48876,8 @@ export type CustomElements = {
|
|
|
48702
48876
|
*
|
|
48703
48877
|
* These can be used to apply styling when a component is in a given state.
|
|
48704
48878
|
*
|
|
48879
|
+
* - `active`: While a cell is shown, under the pointer or the keys, with its tooltip open.
|
|
48880
|
+
* - `empty`: While the `empty` part stands in place of the cells.
|
|
48705
48881
|
* - `settled`: Set one frame after the first render. Transitions wait for it, so an element does not animate its own arrival.
|
|
48706
48882
|
*/
|
|
48707
48883
|
"helix-headless-heatmap": Partial<
|
|
@@ -48908,7 +49084,8 @@ export type CustomElements = {
|
|
|
48908
49084
|
*
|
|
48909
49085
|
* Methods that can be called to access component functionality.
|
|
48910
49086
|
*
|
|
48911
|
-
* - `formAssociatedCallback(form: HTMLFormElement | null) => void`: Called by the browser when the
|
|
49087
|
+
* - `formAssociatedCallback(form: HTMLFormElement | null) => void`: Called by the browser when the control's form changes: watches the new
|
|
49088
|
+
* form's `checkValidity()`, as connecting does for the form it starts in.
|
|
48912
49089
|
* - `formDisabledCallback(disabled: boolean) => void`: Called by the browser when an ancestor fieldset is disabled or enabled.
|
|
48913
49090
|
*
|
|
48914
49091
|
* **The argument is the effective state, and taking it whole is what latched
|
|
@@ -49569,6 +49746,8 @@ export type CustomElements = {
|
|
|
49569
49746
|
* and shows the browser's message at the control.
|
|
49570
49747
|
* - `setCustomValidity(message: string) => void`: Marks the control invalid with `message`, or clears that with an empty
|
|
49571
49748
|
* string, as on a native control. The form does not submit while it is set.
|
|
49749
|
+
* - `formAssociatedCallback(form: HTMLFormElement | null) => void`: Called by the browser when the control's form changes: watches the new
|
|
49750
|
+
* form's `checkValidity()`, as connecting does for the form it starts in.
|
|
49572
49751
|
*
|
|
49573
49752
|
* ## CSS Parts
|
|
49574
49753
|
*
|
|
@@ -50233,6 +50412,18 @@ export type CustomElements = {
|
|
|
50233
50412
|
* there until readings arrive. The `empty` and `loading` slots take markup in
|
|
50234
50413
|
* their place, such as a link to add the first reading.
|
|
50235
50414
|
*
|
|
50415
|
+
* **Keyboard.** The plot is one tab stop.
|
|
50416
|
+
*
|
|
50417
|
+
* | Key | What it does |
|
|
50418
|
+
* |---|---|
|
|
50419
|
+
* | Tab | Moves focus to the plot and shows the first reading. |
|
|
50420
|
+
* | Right, Left | Moves to the next or the previous reading. On a right-to-left page, Left moves to the next. |
|
|
50421
|
+
* | Down, Up | Moves among the series of the reading. With one series, moves to the next or the previous reading. |
|
|
50422
|
+
* | Home, End | Moves to the first or the last reading. |
|
|
50423
|
+
* | Page Down, Page Up | Moves a tenth of the readings on or back. |
|
|
50424
|
+
* | Enter, Space | Presses the reading shown, which sends `helix-reading-press`. |
|
|
50425
|
+
* | Escape | Puts the reading and its tooltip away. |
|
|
50426
|
+
*
|
|
50236
50427
|
* ## Attributes & Properties
|
|
50237
50428
|
*
|
|
50238
50429
|
* Component attributes and properties that can be applied to the element or by using JavaScript.
|
|
@@ -50377,12 +50568,6 @@ export type CustomElements = {
|
|
|
50377
50568
|
* Set it to the words of the page's language, such as `{position} von
|
|
50378
50569
|
* {count}`, or to nothing to say no position. A slice or a series a
|
|
50379
50570
|
* legend hid is not counted.
|
|
50380
|
-
* - `pointer`: Finds the reading nearest the pointer, so the tooltip can sit on it.
|
|
50381
|
-
*
|
|
50382
|
-
* Public for the same reason `series` and `named` are: a protected member
|
|
50383
|
-
* cannot be cast onto across unrelated classes, so it would be invisible to
|
|
50384
|
-
* every chart that needs it. Reading where a pointer is resting is a fair
|
|
50385
|
-
* thing to ask a chart anyway. (property only) (readonly)
|
|
50386
50571
|
* - `data`: The readings as data, in the shape of a table, where the page has no
|
|
50387
50572
|
* table to point `for` at. `for` wins where both are set.
|
|
50388
50573
|
*
|
|
@@ -50421,21 +50606,6 @@ export type CustomElements = {
|
|
|
50421
50606
|
* names an element, and the chart is a generic around its plot: written
|
|
50422
50607
|
* on the host, the name reached nobody. The plot takes it, as Heatmap's
|
|
50423
50608
|
* strip always did. (property only) (readonly)
|
|
50424
|
-
* - `readingsKnown`: Whether the readings have been looked for: false on the server and
|
|
50425
|
-
* while hydrating, where no table is resolved and no data is read. A
|
|
50426
|
-
* chart says it has no readings only once this is true. (property only) (readonly)
|
|
50427
|
-
* - `sourceRows`: Every row of the table, with each cell's text and number.
|
|
50428
|
-
*
|
|
50429
|
-
* This is where a tooltip's content comes from, and it is deliberately not
|
|
50430
|
-
* `series`. A chart draws numbers; a reader resting a pointer on one wants
|
|
50431
|
-
* what the table says, which is `$128k` and not `128000`, and often wants
|
|
50432
|
-
* the column beside it that nothing plotted at all.
|
|
50433
|
-
*
|
|
50434
|
-
* **Not `rows`.** It is the source table's rows, and `rows` on a chart is a
|
|
50435
|
-
* name a chart wants for itself: `helix-heatmap` takes `rows="7"` to mean a
|
|
50436
|
-
* calendar week, and declaring that against a base class whose `rows` is a
|
|
50437
|
-
* `Row[]` getter is a type error at best. Name the member for what it holds
|
|
50438
|
-
* rather than for the shortest word available. (property only) (readonly)
|
|
50439
50609
|
* - `plottedColumns`: The positions of the cells in a row that hold numbers, in table order.
|
|
50440
50610
|
*
|
|
50441
50611
|
* The same test `readSeries` applies when it drops a column of notes: a
|
|
@@ -50481,8 +50651,6 @@ export type CustomElements = {
|
|
|
50481
50651
|
*
|
|
50482
50652
|
* Methods that can be called to access component functionality.
|
|
50483
50653
|
*
|
|
50484
|
-
* - `attributeChangedCallback(name: string, old: string | null, value: string | null) => void`: Called by the browser when an observed attribute changes. A new
|
|
50485
|
-
* `aria-label` asks for an update, because it names the plot.
|
|
50486
50654
|
* - `seriesOf(cell: number) => number | undefined`: The palette slot for the cell at this position in a row.
|
|
50487
50655
|
*
|
|
50488
50656
|
* **A cell's place in its row is not its series' depth, and the tooltip
|
|
@@ -50541,9 +50709,10 @@ export type CustomElements = {
|
|
|
50541
50709
|
* - `mark`: The invisible point the tooltip is anchored to.
|
|
50542
50710
|
* - `marker`: The mark on one reading, under `markers`, and on a reading with a blank on either side. Placed with `inset-inline-start` and `inset-block-start`, and carries its series color as `--chart-series`.
|
|
50543
50711
|
* - `marker-lone`: A `marker` on a reading with a blank on either side, which no line reaches. Set alongside `marker`.
|
|
50544
|
-
* - `plot`: The drawing, which takes focus to be read by key.
|
|
50712
|
+
* - `plot`: The drawing, which takes focus to be read by key. With nothing to draw, a group named as the chart is, holding the `empty` or `loading` part.
|
|
50545
50713
|
* - `summary`: The chart's name and each series' latest reading, written as a sentence for screen readers. Hide it visually.
|
|
50546
50714
|
* - `svg`: The drawing surface the lines and areas sit on.
|
|
50715
|
+
* - `table`: The readings as a table, for a screen reader, rendered only where they were drawn from `data`. Hide it visually.
|
|
50547
50716
|
* - `terminus`: The mark on one series' last reading.
|
|
50548
50717
|
* - `tick`: One number on the axis, placed with `inset-block-start` at its level.
|
|
50549
50718
|
* - `tooltip`: The bubble, forwarded from `Tooltip`.
|
|
@@ -50567,6 +50736,9 @@ export type CustomElements = {
|
|
|
50567
50736
|
*
|
|
50568
50737
|
* These can be used to apply styling when a component is in a given state.
|
|
50569
50738
|
*
|
|
50739
|
+
* - `active`: While a reading is shown, under the pointer or the keys, with its tooltip open.
|
|
50740
|
+
* - `empty`: While the `empty` part stands in the plot.
|
|
50741
|
+
* - `loading`: While the `loading` part stands in the plot.
|
|
50570
50742
|
* - `settled`: Set one frame after the first render. Transitions wait for it, so an element does not animate its own arrival.
|
|
50571
50743
|
*/
|
|
50572
50744
|
"helix-headless-line-chart": Partial<
|
|
@@ -51363,6 +51535,8 @@ export type CustomElements = {
|
|
|
51363
51535
|
* - `setCustomValidity(message: string) => void`: Marks the control invalid with `message`, or clears that with an empty
|
|
51364
51536
|
* string, as on a native control. The form does not submit while it is set.
|
|
51365
51537
|
* - `focus(options?: FocusOptions) => void`: Moves focus to the control, as focusing a native control does.
|
|
51538
|
+
* - `formAssociatedCallback(form: HTMLFormElement | null) => void`: Called by the browser when the control's form changes: watches the new
|
|
51539
|
+
* form's `checkValidity()`, as connecting does for the form it starts in.
|
|
51366
51540
|
*
|
|
51367
51541
|
* ## CSS Parts
|
|
51368
51542
|
*
|
|
@@ -51427,6 +51601,13 @@ export type CustomElements = {
|
|
|
51427
51601
|
* hidden, and silent, for that many milliseconds, and appears only if the work
|
|
51428
51602
|
* is still going. While it waits it carries `:state(waiting)`.
|
|
51429
51603
|
*
|
|
51604
|
+
* **The loader can stand in for what it wraps.** Put the content in the
|
|
51605
|
+
* `content` slot, such as a button or a card, and set `idle` while no work is
|
|
51606
|
+
* in progress. While the work runs, the content keeps its size and is hidden
|
|
51607
|
+
* and inert, and the ring draws over it. While `idle` is set, the loader draws
|
|
51608
|
+
* nothing of its own, has no role, and marks no region busy, so only the
|
|
51609
|
+
* content shows. Clearing `idle` starts `delay` again.
|
|
51610
|
+
*
|
|
51430
51611
|
* ## Attributes & Properties
|
|
51431
51612
|
*
|
|
51432
51613
|
* Component attributes and properties that can be applied to the element or by using JavaScript.
|
|
@@ -51441,6 +51622,9 @@ export type CustomElements = {
|
|
|
51441
51622
|
*
|
|
51442
51623
|
* Names an element in the same tree. In React it arrives as a property, the
|
|
51443
51624
|
* way `Tooltip.for` does.
|
|
51625
|
+
* - `idle`: Whether no work is in progress. The loader draws nothing of its own, has
|
|
51626
|
+
* no role, and marks no region busy, and what is in the `content` slot
|
|
51627
|
+
* shows. Clearing it starts `delay` again.
|
|
51444
51628
|
* - `label`: The loader's name, announced by screen readers while the work is in
|
|
51445
51629
|
* progress.
|
|
51446
51630
|
* - `whenSettled`: Resolves a frame after the first update, when transitions are switched on.
|
|
@@ -51469,11 +51653,13 @@ export type CustomElements = {
|
|
|
51469
51653
|
* Areas where markup can be added to the component.
|
|
51470
51654
|
*
|
|
51471
51655
|
* - `(default)`: An icon or logo that stays still at the center. Empty by default.
|
|
51656
|
+
* - `content`: What the loader stands in for while the work runs, such as a button. It keeps its size, hidden and inert, until `idle` is set.
|
|
51472
51657
|
*
|
|
51473
51658
|
* ## CSS Parts
|
|
51474
51659
|
*
|
|
51475
51660
|
* Custom selectors for styling elements within the component.
|
|
51476
51661
|
*
|
|
51662
|
+
* - `content`: The box that holds the `content` slot. Hidden while the work runs, and shown while `idle` is set.
|
|
51477
51663
|
* - `indicator`: The arc that turns.
|
|
51478
51664
|
* - `mark`: The region that holds the slotted content at the center.
|
|
51479
51665
|
* - `svg`: The rotating circle pair.
|
|
@@ -54459,6 +54645,8 @@ export type CustomElements = {
|
|
|
54459
54645
|
* and shows the browser's message at the control.
|
|
54460
54646
|
* - `setCustomValidity(message: string) => void`: Marks the control invalid with `message`, or clears that with an empty
|
|
54461
54647
|
* string, as on a native control. The form does not submit while it is set.
|
|
54648
|
+
* - `formAssociatedCallback(form: HTMLFormElement | null) => void`: Called by the browser when the control's form changes: watches the new
|
|
54649
|
+
* form's `checkValidity()`, as connecting does for the form it starts in.
|
|
54462
54650
|
*
|
|
54463
54651
|
* ## CSS Parts
|
|
54464
54652
|
*
|
|
@@ -55632,6 +55820,8 @@ export type CustomElements = {
|
|
|
55632
55820
|
* - `setCustomValidity(message: string) => void`: Marks the control invalid with `message`, or clears that with an empty
|
|
55633
55821
|
* string, as on a native control. The form does not submit while it is set.
|
|
55634
55822
|
* - `focus(options?: FocusOptions) => void`: Moves focus to the control, as focusing a native control does.
|
|
55823
|
+
* - `formAssociatedCallback(form: HTMLFormElement | null) => void`: Called by the browser when the control's form changes: watches the new
|
|
55824
|
+
* form's `checkValidity()`, as connecting does for the form it starts in.
|
|
55635
55825
|
*
|
|
55636
55826
|
* ## CSS Parts
|
|
55637
55827
|
*
|
|
@@ -56012,6 +56202,8 @@ export type CustomElements = {
|
|
|
56012
56202
|
* and shows the browser's message at the control.
|
|
56013
56203
|
* - `setCustomValidity(message: string) => void`: Marks the control invalid with `message`, or clears that with an empty
|
|
56014
56204
|
* string, as on a native control. The form does not submit while it is set.
|
|
56205
|
+
* - `formAssociatedCallback(form: HTMLFormElement | null) => void`: Called by the browser when the control's form changes: watches the new
|
|
56206
|
+
* form's `checkValidity()`, as connecting does for the form it starts in.
|
|
56015
56207
|
*
|
|
56016
56208
|
* ## CSS Parts
|
|
56017
56209
|
*
|
|
@@ -56867,6 +57059,8 @@ export type CustomElements = {
|
|
|
56867
57059
|
* - `setCustomValidity(message: string) => void`: Marks the control invalid with `message`, or clears that with an empty
|
|
56868
57060
|
* string, as on a native control. The form does not submit while it is set.
|
|
56869
57061
|
* - `focus(options?: FocusOptions) => void`: Moves focus to the control, as focusing a native control does.
|
|
57062
|
+
* - `formAssociatedCallback(form: HTMLFormElement | null) => void`: Called by the browser when the control's form changes: watches the new
|
|
57063
|
+
* form's `checkValidity()`, as connecting does for the form it starts in.
|
|
56870
57064
|
*
|
|
56871
57065
|
* ## CSS Parts
|
|
56872
57066
|
*
|
|
@@ -57051,7 +57245,8 @@ export type CustomElements = {
|
|
|
57051
57245
|
*
|
|
57052
57246
|
* Left and Right swap on a right-to-left page. The marks are a `radiogroup`
|
|
57053
57247
|
* named by `label`, and each score is a `radio` named by `option-label`, such
|
|
57054
|
-
* as "3 out of 5". A read-only rating is one `img` named by its
|
|
57248
|
+
* as "3 out of 5". A read-only rating is one `img` named by its label and
|
|
57249
|
+
* then its score, such as "Quality 3 out of 5".
|
|
57055
57250
|
*
|
|
57056
57251
|
* ## Attributes & Properties
|
|
57057
57252
|
*
|
|
@@ -57300,6 +57495,8 @@ export type CustomElements = {
|
|
|
57300
57495
|
* - `setCustomValidity(message: string) => void`: Marks the control invalid with `message`, or clears that with an empty
|
|
57301
57496
|
* string, as on a native control. The form does not submit while it is set.
|
|
57302
57497
|
* - `focus(options?: FocusOptions) => void`: Moves focus to the control, as focusing a native control does.
|
|
57498
|
+
* - `formAssociatedCallback(form: HTMLFormElement | null) => void`: Called by the browser when the control's form changes: watches the new
|
|
57499
|
+
* form's `checkValidity()`, as connecting does for the form it starts in.
|
|
57303
57500
|
*
|
|
57304
57501
|
* ## CSS Custom Properties
|
|
57305
57502
|
*
|
|
@@ -57359,10 +57556,10 @@ export type CustomElements = {
|
|
|
57359
57556
|
* readers.
|
|
57360
57557
|
*
|
|
57361
57558
|
* **The plot is read by key.** It takes focus, named by `label` or the caption.
|
|
57362
|
-
* The left and right arrows move from
|
|
57363
|
-
* and End go to the first and the last, and the up and down
|
|
57364
|
-
* the series of a row. The tooltip sits on that point, the
|
|
57365
|
-
* row in words, and Escape puts the tooltip away.
|
|
57559
|
+
* The left and right arrows move from point to point, left to right across
|
|
57560
|
+
* the plot, Home and End go to the first and the last, and the up and down
|
|
57561
|
+
* arrows move among the series of a row. The tooltip sits on that point, the
|
|
57562
|
+
* `live` part says the row in words, and Escape puts the tooltip away.
|
|
57366
57563
|
*
|
|
57367
57564
|
* Each point is a `<span>` placed by percentage over the drawing, as
|
|
57368
57565
|
* `LineChart` places its end points, so points stay round when the drawing
|
|
@@ -57389,6 +57586,18 @@ export type CustomElements = {
|
|
|
57389
57586
|
* there until readings arrive. The `empty` and `loading` slots take markup in
|
|
57390
57587
|
* their place, such as a link to add the first reading.
|
|
57391
57588
|
*
|
|
57589
|
+
* **Keyboard.** The plot is one tab stop.
|
|
57590
|
+
*
|
|
57591
|
+
* | Key | What it does |
|
|
57592
|
+
* |---|---|
|
|
57593
|
+
* | Tab | Moves focus to the plot and shows the first reading. |
|
|
57594
|
+
* | Right, Left | Moves to the next or the previous point, left to right across the plot. On a right-to-left page, Left moves to the next. |
|
|
57595
|
+
* | Down, Up | Moves among the series of the point. With one series, moves to the next or the previous point. |
|
|
57596
|
+
* | Home, End | Moves to the first or the last point. |
|
|
57597
|
+
* | Page Down, Page Up | Moves a tenth of the points on or back. |
|
|
57598
|
+
* | Enter, Space | Presses the point shown, which sends `helix-reading-press`. |
|
|
57599
|
+
* | Escape | Puts the point and its tooltip away. |
|
|
57600
|
+
*
|
|
57392
57601
|
* ## Attributes & Properties
|
|
57393
57602
|
*
|
|
57394
57603
|
* Component attributes and properties that can be applied to the element or by using JavaScript.
|
|
@@ -57458,12 +57667,6 @@ export type CustomElements = {
|
|
|
57458
57667
|
* Set it to the words of the page's language, such as `{position} von
|
|
57459
57668
|
* {count}`, or to nothing to say no position. A slice or a series a
|
|
57460
57669
|
* legend hid is not counted.
|
|
57461
|
-
* - `pointer`: Finds the reading nearest the pointer, so the tooltip can sit on it.
|
|
57462
|
-
*
|
|
57463
|
-
* Public for the same reason `series` and `named` are: a protected member
|
|
57464
|
-
* cannot be cast onto across unrelated classes, so it would be invisible to
|
|
57465
|
-
* every chart that needs it. Reading where a pointer is resting is a fair
|
|
57466
|
-
* thing to ask a chart anyway. (property only) (readonly)
|
|
57467
57670
|
* - `data`: The readings as data, in the shape of a table, where the page has no
|
|
57468
57671
|
* table to point `for` at. `for` wins where both are set.
|
|
57469
57672
|
*
|
|
@@ -57502,21 +57705,6 @@ export type CustomElements = {
|
|
|
57502
57705
|
* names an element, and the chart is a generic around its plot: written
|
|
57503
57706
|
* on the host, the name reached nobody. The plot takes it, as Heatmap's
|
|
57504
57707
|
* strip always did. (property only) (readonly)
|
|
57505
|
-
* - `readingsKnown`: Whether the readings have been looked for: false on the server and
|
|
57506
|
-
* while hydrating, where no table is resolved and no data is read. A
|
|
57507
|
-
* chart says it has no readings only once this is true. (property only) (readonly)
|
|
57508
|
-
* - `sourceRows`: Every row of the table, with each cell's text and number.
|
|
57509
|
-
*
|
|
57510
|
-
* This is where a tooltip's content comes from, and it is deliberately not
|
|
57511
|
-
* `series`. A chart draws numbers; a reader resting a pointer on one wants
|
|
57512
|
-
* what the table says, which is `$128k` and not `128000`, and often wants
|
|
57513
|
-
* the column beside it that nothing plotted at all.
|
|
57514
|
-
*
|
|
57515
|
-
* **Not `rows`.** It is the source table's rows, and `rows` on a chart is a
|
|
57516
|
-
* name a chart wants for itself: `helix-heatmap` takes `rows="7"` to mean a
|
|
57517
|
-
* calendar week, and declaring that against a base class whose `rows` is a
|
|
57518
|
-
* `Row[]` getter is a type error at best. Name the member for what it holds
|
|
57519
|
-
* rather than for the shortest word available. (property only) (readonly)
|
|
57520
57708
|
* - `plottedColumns`: The positions of the cells in a row that hold numbers, in table order.
|
|
57521
57709
|
*
|
|
57522
57710
|
* The same test `readSeries` applies when it drops a column of notes: a
|
|
@@ -57575,8 +57763,6 @@ export type CustomElements = {
|
|
|
57575
57763
|
* The across gets no dot at all rather than a shifted one. It is an axis and
|
|
57576
57764
|
* not a series: it has a scale under the plot with its name at the end of it,
|
|
57577
57765
|
* which is where a reader is told what it is.
|
|
57578
|
-
* - `attributeChangedCallback(name: string, old: string | null, value: string | null) => void`: Called by the browser when an observed attribute changes. A new
|
|
57579
|
-
* `aria-label` asks for an update, because it names the plot.
|
|
57580
57766
|
* - `showsSeries(name: string) => boolean`: Whether the series of this name is drawn, which it is unless a legend
|
|
57581
57767
|
* reading the same table hid it.
|
|
57582
57768
|
*
|
|
@@ -57613,11 +57799,12 @@ export type CustomElements = {
|
|
|
57613
57799
|
* - `loading`: The words in place of the drawing while `loading` is set and there are no readings: the `loading` slot, falling back to `loading-text`.
|
|
57614
57800
|
* - `mark`: The invisible point the tooltip is anchored to.
|
|
57615
57801
|
* - `plane`: The grid that holds the plot, both axes, and their names. It runs left to right on every page.
|
|
57616
|
-
* - `plot`: The drawing, which takes focus to be read by key.
|
|
57802
|
+
* - `plot`: The drawing, which takes focus to be read by key. With nothing to draw, a group named as the chart is, holding the `empty` or `loading` part.
|
|
57617
57803
|
* - `point`: One row, as a point.
|
|
57618
57804
|
* - `point-active`: A point in the row under the pointer. Set alongside `point`.
|
|
57619
57805
|
* - `summary`: The text that says how strongly the measures relate, for people who cannot see the points.
|
|
57620
57806
|
* - `svg`: The drawing surface the gridlines and the trend lines sit on.
|
|
57807
|
+
* - `table`: The readings as a table, for a screen reader, rendered only where they were drawn from `data`. Hide it visually.
|
|
57621
57808
|
* - `tooltip`: The bubble, forwarded from `Tooltip`.
|
|
57622
57809
|
* - `tooltip-anchor`: The `Tooltip` element itself.
|
|
57623
57810
|
* - `tooltip-arrow`: The bubble's point, forwarded from `Tooltip`.
|
|
@@ -57637,7 +57824,7 @@ export type CustomElements = {
|
|
|
57637
57824
|
* - `trend`: One series' line of best fit, under `trend`. Carries its series color as `--chart-series`.
|
|
57638
57825
|
* - `x-axis`: The values along the horizontal axis, under the plot.
|
|
57639
57826
|
* - `x-name`: The name of the horizontal measure.
|
|
57640
|
-
* - `x-tick`: One labeled value on the horizontal axis. Each axis has its own tick part, because `::part()` cannot tell which axis a tick is on.
|
|
57827
|
+
* - `x-tick`: One labeled value on the horizontal axis. Each axis has its own tick part, because `::part()` cannot tell which axis a tick is on. The one at the far edge carries `data-edge="end"`.
|
|
57641
57828
|
* - `y-axis`: The values along the vertical axis, beside the plot.
|
|
57642
57829
|
* - `y-name`: The name of the vertical measure.
|
|
57643
57830
|
* - `y-tick`: One labeled value on the vertical axis.
|
|
@@ -57646,6 +57833,9 @@ export type CustomElements = {
|
|
|
57646
57833
|
*
|
|
57647
57834
|
* These can be used to apply styling when a component is in a given state.
|
|
57648
57835
|
*
|
|
57836
|
+
* - `active`: While a reading is shown, under the pointer or the keys, with its tooltip open.
|
|
57837
|
+
* - `empty`: While the `empty` part stands in the plot.
|
|
57838
|
+
* - `loading`: While the `loading` part stands in the plot.
|
|
57649
57839
|
* - `settled`: Set one frame after the first render. Transitions wait for it, so an element does not animate its own arrival.
|
|
57650
57840
|
*/
|
|
57651
57841
|
"helix-headless-scatter-chart": Partial<
|
|
@@ -57807,7 +57997,9 @@ export type CustomElements = {
|
|
|
57807
57997
|
* place for focus to return to when the list closes.
|
|
57808
57998
|
*
|
|
57809
57999
|
* Your options stay in your light DOM and are slotted through into the listbox,
|
|
57810
|
-
* so the listbox looks through slots to find them.
|
|
58000
|
+
* so the listbox looks through slots to find them. Write them as `Option`,
|
|
58001
|
+
* group them in `Option.Group`, and divide them with `Option.Separator`.
|
|
58002
|
+
* Importing Select registers all three in the same tier. For a list too long to draw
|
|
57811
58003
|
* whole, set `items` instead: the list draws only the options in sight, as
|
|
57812
58004
|
* Listbox's `items` does, and the trigger, its keys and the form read the
|
|
57813
58005
|
* whole set.
|
|
@@ -58118,6 +58310,8 @@ export type CustomElements = {
|
|
|
58118
58310
|
* and shows the browser's message at the control.
|
|
58119
58311
|
* - `setCustomValidity(message: string) => void`: Marks the control invalid with `message`, or clears that with an empty
|
|
58120
58312
|
* string, as on a native control. The form does not submit while it is set.
|
|
58313
|
+
* - `formAssociatedCallback(form: HTMLFormElement | null) => void`: Called by the browser when the control's form changes: watches the new
|
|
58314
|
+
* form's `checkValidity()`, as connecting does for the form it starts in.
|
|
58121
58315
|
*
|
|
58122
58316
|
* ## CSS Custom Properties
|
|
58123
58317
|
*
|
|
@@ -58637,6 +58831,8 @@ export type CustomElements = {
|
|
|
58637
58831
|
* - `setCustomValidity(message: string) => void`: Marks the control invalid with `message`, or clears that with an empty
|
|
58638
58832
|
* string, as on a native control. The form does not submit while it is set.
|
|
58639
58833
|
* - `focus(options?: FocusOptions) => void`: Moves focus to the control, as focusing a native control does.
|
|
58834
|
+
* - `formAssociatedCallback(form: HTMLFormElement | null) => void`: Called by the browser when the control's form changes: watches the new
|
|
58835
|
+
* form's `checkValidity()`, as connecting does for the form it starts in.
|
|
58640
58836
|
*
|
|
58641
58837
|
* ## CSS Custom Properties
|
|
58642
58838
|
*
|
|
@@ -58700,6 +58896,10 @@ export type CustomElements = {
|
|
|
58700
58896
|
* the lowest, in `overview-label`: "From 12 to 20, highest 30, lowest 8". An
|
|
58701
58897
|
* `aria-label` on the element names it as `label` does.
|
|
58702
58898
|
*
|
|
58899
|
+
* `helix-reading-change` says each move of the reading, by pointer, tap or
|
|
58900
|
+
* key, and `helix-reading-press` says a reading was clicked, tapped, or pressed
|
|
58901
|
+
* with Enter or Space, as on every chart.
|
|
58902
|
+
*
|
|
58703
58903
|
* A pointer resting on the drawing shows the reading under it: the `cursor`
|
|
58704
58904
|
* part marks it and the `readout` part writes it. `marks` adds a mark on the
|
|
58705
58905
|
* highest and the lowest reading, and `range` draws a band between two values,
|
|
@@ -58714,6 +58914,17 @@ export type CustomElements = {
|
|
|
58714
58914
|
* the component computes and CSS cannot, so a stylesheet can draw the sparkline
|
|
58715
58915
|
* without measuring anything.
|
|
58716
58916
|
*
|
|
58917
|
+
* **Keyboard.** A sparkline with a `label` is one tab stop.
|
|
58918
|
+
*
|
|
58919
|
+
* | Key | What it does |
|
|
58920
|
+
* |---|---|
|
|
58921
|
+
* | Tab | Moves focus to the drawing and shows the first reading, where there is a `label`. |
|
|
58922
|
+
* | Any arrow | Right and Down move to the next reading, Left and Up to the previous. On a right-to-left page, Left moves to the next. |
|
|
58923
|
+
* | Home, End | Moves to the first or the last reading. |
|
|
58924
|
+
* | Page Down, Page Up | Moves a tenth of the readings on or back. |
|
|
58925
|
+
* | Enter, Space | Presses the reading shown, which sends `helix-reading-press`. |
|
|
58926
|
+
* | Escape | Puts the reading and its tooltip away. |
|
|
58927
|
+
*
|
|
58717
58928
|
* ## Attributes & Properties
|
|
58718
58929
|
*
|
|
58719
58930
|
* Component attributes and properties that can be applied to the element or by using JavaScript.
|
|
@@ -58818,8 +59029,6 @@ export type CustomElements = {
|
|
|
58818
59029
|
* with `values={[1240, 1318]}`. The attribute is the form to prefer, because
|
|
58819
59030
|
* a string is what survives React's hydration where an array property does
|
|
58820
59031
|
* not.
|
|
58821
|
-
* - `pointer`: Finds the reading a pointer or a key rests on, as it does for every
|
|
58822
|
-
* chart, so a sparkline is read the way they are. (property only) (readonly)
|
|
58823
59032
|
* - `named`: The drawing's name: an `aria-label` written on the sparkline, then `label`. (property only) (readonly)
|
|
58824
59033
|
* - `readings`: How many readings there are, which the pointer and the keys walk. (property only) (readonly)
|
|
58825
59034
|
* - `whenSettled`: Resolves a frame after the first update, when transitions are switched on.
|
|
@@ -58843,11 +59052,12 @@ export type CustomElements = {
|
|
|
58843
59052
|
* browser harness's awaits it alone: a browser always runs the frame, and a
|
|
58844
59053
|
* timer beside it was a bet on how long one takes, which a busy run lost. (property only) (readonly)
|
|
58845
59054
|
*
|
|
58846
|
-
* ##
|
|
59055
|
+
* ## Events
|
|
58847
59056
|
*
|
|
58848
|
-
*
|
|
59057
|
+
* Events that will be emitted by the component.
|
|
58849
59058
|
*
|
|
58850
|
-
* - `
|
|
59059
|
+
* - `helix-reading-change`: The reading shown moved, or was put away: `index` is the reading, or `-1` for none, with its row's `label` from a table and the `pointerType` that moved it.
|
|
59060
|
+
* - `helix-reading-press`: A reading was clicked, tapped, or pressed with Enter or Space, with the same detail as `helix-reading-change`.
|
|
58851
59061
|
*
|
|
58852
59062
|
* ## CSS Custom Properties
|
|
58853
59063
|
*
|
|
@@ -60174,6 +60384,8 @@ export type CustomElements = {
|
|
|
60174
60384
|
* - `setCustomValidity(message: string) => void`: Marks the control invalid with `message`, or clears that with an empty
|
|
60175
60385
|
* string, as on a native control. The form does not submit while it is set.
|
|
60176
60386
|
* - `focus(options?: FocusOptions) => void`: Moves focus to the control, as focusing a native control does.
|
|
60387
|
+
* - `formAssociatedCallback(form: HTMLFormElement | null) => void`: Called by the browser when the control's form changes: watches the new
|
|
60388
|
+
* form's `checkValidity()`, as connecting does for the form it starts in.
|
|
60177
60389
|
*
|
|
60178
60390
|
* ## CSS Parts
|
|
60179
60391
|
*
|
|
@@ -61440,8 +61652,9 @@ export type CustomElements = {
|
|
|
61440
61652
|
* - `selection-mode`/`selectionMode`: How many tags a reader can select: `single`, `multiple`, or none.
|
|
61441
61653
|
*
|
|
61442
61654
|
* Absent selects nothing, and the tags carry no selected state at all.
|
|
61443
|
-
* - `value`: The selected tags' values, separated by commas
|
|
61444
|
-
* space.
|
|
61655
|
+
* - `value`: The selected tags' values, separated by commas with no space, as Toggle
|
|
61656
|
+
* Group and Table write theirs, since a value may hold a space. A value
|
|
61657
|
+
* written with a space after each comma is read the same way.
|
|
61445
61658
|
*
|
|
61446
61659
|
* Set it to start with tags selected. A tag's value is its `value`, or its
|
|
61447
61660
|
* words where it has none.
|
|
@@ -61899,6 +62112,8 @@ export type CustomElements = {
|
|
|
61899
62112
|
* and shows the browser's message at the control.
|
|
61900
62113
|
* - `setCustomValidity(message: string) => void`: Marks the control invalid with `message`, or clears that with an empty
|
|
61901
62114
|
* string, as on a native control. The form does not submit while it is set.
|
|
62115
|
+
* - `formAssociatedCallback(form: HTMLFormElement | null) => void`: Called by the browser when the control's form changes: watches the new
|
|
62116
|
+
* form's `checkValidity()`, as connecting does for the form it starts in.
|
|
61902
62117
|
*
|
|
61903
62118
|
* ## CSS Parts
|
|
61904
62119
|
*
|
|
@@ -62039,7 +62254,13 @@ export type CustomElements = {
|
|
|
62039
62254
|
* - `trigger-label`/`triggerLabel`: The name of the button that opens the list, read by screen readers.
|
|
62040
62255
|
* - `unavailable-message`/`unavailableMessage`: The message shown when `disable-times` bars a time.
|
|
62041
62256
|
* - `unreadable-message`/`unreadableMessage`: The message for text that is no time, where `bad-input-message` is not
|
|
62042
|
-
* set. `{mode}` is `single`, `range`, or `multiple`,
|
|
62257
|
+
* set. `{mode}` is `single`, `range`, or `multiple`, `{example}` is a time
|
|
62258
|
+
* written as the field writes one, `2:30 PM` in `en-US` and `14:30` in
|
|
62259
|
+
* `de-DE`, and `{shape}` is `HH:mm`, or `HH:mm:ss` with `seconds`.
|
|
62260
|
+
*
|
|
62261
|
+
* **The default names a time the field reads back.** It said "Enter a time
|
|
62262
|
+
* as HH:mm." to a reader whose field showed `2:30 PM`, and a pattern token
|
|
62263
|
+
* is words for a developer.
|
|
62043
62264
|
* - `variant`: Whether the panel shows one list of times or a column for each part of the
|
|
62044
62265
|
* time.
|
|
62045
62266
|
*
|
|
@@ -62294,6 +62515,8 @@ export type CustomElements = {
|
|
|
62294
62515
|
* and shows the browser's message at the control.
|
|
62295
62516
|
* - `setCustomValidity(message: string) => void`: Marks the control invalid with `message`, or clears that with an empty
|
|
62296
62517
|
* string, as on a native control. The form does not submit while it is set.
|
|
62518
|
+
* - `formAssociatedCallback(form: HTMLFormElement | null) => void`: Called by the browser when the control's form changes: watches the new
|
|
62519
|
+
* form's `checkValidity()`, as connecting does for the form it starts in.
|
|
62297
62520
|
*
|
|
62298
62521
|
* ## CSS Parts
|
|
62299
62522
|
*
|
|
@@ -62777,6 +63000,8 @@ export type CustomElements = {
|
|
|
62777
63000
|
* and shows the browser's message at the control.
|
|
62778
63001
|
* - `setCustomValidity(message: string) => void`: Marks the control invalid with `message`, or clears that with an empty
|
|
62779
63002
|
* string, as on a native control. The form does not submit while it is set.
|
|
63003
|
+
* - `formAssociatedCallback(form: HTMLFormElement | null) => void`: Called by the browser when the control's form changes: watches the new
|
|
63004
|
+
* form's `checkValidity()`, as connecting does for the form it starts in.
|
|
62780
63005
|
*
|
|
62781
63006
|
* ## CSS Parts
|
|
62782
63007
|
*
|
|
@@ -63667,6 +63892,8 @@ export type CustomElements = {
|
|
|
63667
63892
|
* - `setCustomValidity(message: string) => void`: Marks the control invalid with `message`, or clears that with an empty
|
|
63668
63893
|
* string, as on a native control. The form does not submit while it is set.
|
|
63669
63894
|
* - `focus(options?: FocusOptions) => void`: Moves focus to the control, as focusing a native control does.
|
|
63895
|
+
* - `formAssociatedCallback(form: HTMLFormElement | null) => void`: Called by the browser when the control's form changes: watches the new
|
|
63896
|
+
* form's `checkValidity()`, as connecting does for the form it starts in.
|
|
63670
63897
|
*
|
|
63671
63898
|
* ## CSS Parts
|
|
63672
63899
|
*
|
|
@@ -64562,9 +64789,9 @@ export type CustomElements = {
|
|
|
64562
64789
|
* Each item is an element because it holds state: whether it is open, selected,
|
|
64563
64790
|
* and focused.
|
|
64564
64791
|
*
|
|
64565
|
-
* An item is a branch when
|
|
64566
|
-
*
|
|
64567
|
-
* appears on hydration.
|
|
64792
|
+
* An item is a branch when an item is slotted into `children`, with
|
|
64793
|
+
* `slot="children"` on each nested item. This is detected on the client, so
|
|
64794
|
+
* server-rendered markup shows a leaf and the twisty appears on hydration.
|
|
64568
64795
|
*
|
|
64569
64796
|
* **`href` makes the whole row a link**, rendered as an `<a>`. Enter, middle
|
|
64570
64797
|
* click, and the status bar then work anywhere on the row.
|
|
@@ -64686,7 +64913,7 @@ export type CustomElements = {
|
|
|
64686
64913
|
*
|
|
64687
64914
|
* Areas where markup can be added to the component.
|
|
64688
64915
|
*
|
|
64689
|
-
* - `(default)`: The item's label.
|
|
64916
|
+
* - `(default)`: The item's label. A nested item does not go here: give it `slot="children"`. In a development build, an item nested here is reported.
|
|
64690
64917
|
* - `chevron`: Replaces the expand and collapse mark of a branch, such as with your own icon.
|
|
64691
64918
|
* - `children`: Nested items, which make this a branch.
|
|
64692
64919
|
* - `end`: Content after the label, at the far side of the row, such as a count or a state.
|
|
@@ -66958,6 +67185,18 @@ export type CustomElementsSolidJs = {
|
|
|
66958
67185
|
* there until readings arrive. The `empty` and `loading` slots take markup in
|
|
66959
67186
|
* their place, such as a link to add the first reading.
|
|
66960
67187
|
*
|
|
67188
|
+
* **Keyboard.** The plot is one tab stop.
|
|
67189
|
+
*
|
|
67190
|
+
* | Key | What it does |
|
|
67191
|
+
* |---|---|
|
|
67192
|
+
* | Tab | Moves focus to the plot and shows the first reading. |
|
|
67193
|
+
* | Right, Left | Moves to the next or the previous reading. On a right-to-left page, Left moves to the next. |
|
|
67194
|
+
* | Down, Up | Moves among the series of the reading. With one series, moves to the next or the previous reading. |
|
|
67195
|
+
* | Home, End | Moves to the first or the last reading. |
|
|
67196
|
+
* | Page Down, Page Up | Moves a tenth of the readings on or back. |
|
|
67197
|
+
* | Enter, Space | Presses the reading shown, which sends `helix-reading-press`. |
|
|
67198
|
+
* | Escape | Puts the reading and its tooltip away. |
|
|
67199
|
+
*
|
|
66961
67200
|
* ## Attributes & Properties
|
|
66962
67201
|
*
|
|
66963
67202
|
* Component attributes and properties that can be applied to the element or by using JavaScript.
|
|
@@ -67038,12 +67277,6 @@ export type CustomElementsSolidJs = {
|
|
|
67038
67277
|
* Set it to the words of the page's language, such as `{position} von
|
|
67039
67278
|
* {count}`, or to nothing to say no position. A slice or a series a
|
|
67040
67279
|
* legend hid is not counted.
|
|
67041
|
-
* - `pointer`: Finds the reading nearest the pointer, so the tooltip can sit on it.
|
|
67042
|
-
*
|
|
67043
|
-
* Public for the same reason `series` and `named` are: a protected member
|
|
67044
|
-
* cannot be cast onto across unrelated classes, so it would be invisible to
|
|
67045
|
-
* every chart that needs it. Reading where a pointer is resting is a fair
|
|
67046
|
-
* thing to ask a chart anyway. (property only) (readonly)
|
|
67047
67280
|
* - `data`: The readings as data, in the shape of a table, where the page has no
|
|
67048
67281
|
* table to point `for` at. `for` wins where both are set.
|
|
67049
67282
|
*
|
|
@@ -67082,21 +67315,6 @@ export type CustomElementsSolidJs = {
|
|
|
67082
67315
|
* names an element, and the chart is a generic around its plot: written
|
|
67083
67316
|
* on the host, the name reached nobody. The plot takes it, as Heatmap's
|
|
67084
67317
|
* strip always did. (property only) (readonly)
|
|
67085
|
-
* - `readingsKnown`: Whether the readings have been looked for: false on the server and
|
|
67086
|
-
* while hydrating, where no table is resolved and no data is read. A
|
|
67087
|
-
* chart says it has no readings only once this is true. (property only) (readonly)
|
|
67088
|
-
* - `sourceRows`: Every row of the table, with each cell's text and number.
|
|
67089
|
-
*
|
|
67090
|
-
* This is where a tooltip's content comes from, and it is deliberately not
|
|
67091
|
-
* `series`. A chart draws numbers; a reader resting a pointer on one wants
|
|
67092
|
-
* what the table says, which is `$128k` and not `128000`, and often wants
|
|
67093
|
-
* the column beside it that nothing plotted at all.
|
|
67094
|
-
*
|
|
67095
|
-
* **Not `rows`.** It is the source table's rows, and `rows` on a chart is a
|
|
67096
|
-
* name a chart wants for itself: `helix-heatmap` takes `rows="7"` to mean a
|
|
67097
|
-
* calendar week, and declaring that against a base class whose `rows` is a
|
|
67098
|
-
* `Row[]` getter is a type error at best. Name the member for what it holds
|
|
67099
|
-
* rather than for the shortest word available. (property only) (readonly)
|
|
67100
67318
|
* - `plottedColumns`: The positions of the cells in a row that hold numbers, in table order.
|
|
67101
67319
|
*
|
|
67102
67320
|
* The same test `readSeries` applies when it drops a column of notes: a
|
|
@@ -67142,8 +67360,6 @@ export type CustomElementsSolidJs = {
|
|
|
67142
67360
|
*
|
|
67143
67361
|
* Methods that can be called to access component functionality.
|
|
67144
67362
|
*
|
|
67145
|
-
* - `attributeChangedCallback(name: string, old: string | null, value: string | null) => void`: Called by the browser when an observed attribute changes. A new
|
|
67146
|
-
* `aria-label` asks for an update, because it names the plot.
|
|
67147
67363
|
* - `seriesOf(cell: number) => number | undefined`: The palette slot for the cell at this position in a row.
|
|
67148
67364
|
*
|
|
67149
67365
|
* **A cell's place in its row is not its series' depth, and the tooltip
|
|
@@ -67196,9 +67412,10 @@ export type CustomElementsSolidJs = {
|
|
|
67196
67412
|
* - `live`: The readout: a polite live region that says the reading the keys moved to. Hide it visually.
|
|
67197
67413
|
* - `loading`: The words in place of the drawing while `loading` is set and there are no readings: the `loading` slot, falling back to `loading-text`.
|
|
67198
67414
|
* - `mark`: The invisible point the tooltip is anchored to.
|
|
67199
|
-
* - `plot`: The drawing, which takes focus to be read by key.
|
|
67415
|
+
* - `plot`: The drawing, which takes focus to be read by key. With nothing to draw, a group named as the chart is, holding the `empty` or `loading` part.
|
|
67200
67416
|
* - `summary`: The total and each part's share at the latest reading, written as a sentence for screen readers.
|
|
67201
67417
|
* - `svg`: The drawing surface the bands sit on.
|
|
67418
|
+
* - `table`: The readings as a table, for a screen reader, rendered only where they were drawn from `data`. Hide it visually.
|
|
67202
67419
|
* - `tick`: One number on the axis, placed with `inset-block-start` at its level.
|
|
67203
67420
|
* - `tooltip`: The bubble, forwarded from `Tooltip`.
|
|
67204
67421
|
* - `tooltip-anchor`: The `Tooltip` element itself.
|
|
@@ -67221,6 +67438,9 @@ export type CustomElementsSolidJs = {
|
|
|
67221
67438
|
*
|
|
67222
67439
|
* These can be used to apply styling when a component is in a given state.
|
|
67223
67440
|
*
|
|
67441
|
+
* - `active`: While a reading is shown, under the pointer or the keys, with its tooltip open.
|
|
67442
|
+
* - `empty`: While the `empty` part stands in the plot.
|
|
67443
|
+
* - `loading`: While the `loading` part stands in the plot.
|
|
67224
67444
|
* - `settled`: Set one frame after the first render. Transitions wait for it, so an element does not animate its own arrival.
|
|
67225
67445
|
*/
|
|
67226
67446
|
"helix-headless-area-chart": Partial<
|
|
@@ -67419,7 +67639,7 @@ export type CustomElementsSolidJs = {
|
|
|
67419
67639
|
*
|
|
67420
67640
|
* Areas where markup can be added to the component.
|
|
67421
67641
|
*
|
|
67422
|
-
* - `(default)`: Shown when there is no usable image, in place of the initials.
|
|
67642
|
+
* - `(default)`: Shown when there is no usable image, in place of the initials. Hidden from assistive technology when the avatar has a `name`, which the host announces.
|
|
67423
67643
|
*
|
|
67424
67644
|
* ## CSS Parts
|
|
67425
67645
|
*
|
|
@@ -67611,6 +67831,19 @@ export type CustomElementsSolidJs = {
|
|
|
67611
67831
|
* there until readings arrive. The `empty` and `loading` slots take markup in
|
|
67612
67832
|
* their place, such as a link to add the first reading.
|
|
67613
67833
|
*
|
|
67834
|
+
* **Keyboard.** The plot is one tab stop.
|
|
67835
|
+
*
|
|
67836
|
+
* | Key | What it does |
|
|
67837
|
+
* |---|---|
|
|
67838
|
+
* | Tab | Moves focus to the plot and shows the first reading. |
|
|
67839
|
+
* | Right, Left | Moves to the next or the previous reading. On a right-to-left page, Left moves to the next. |
|
|
67840
|
+
* | Down, Up | Moves among the series of the reading. With one series, moves to the next or the previous reading. |
|
|
67841
|
+
* | Down, Up under `orientation="horizontal"` | Moves to the next or the previous reading, and Right and Left move among the series. |
|
|
67842
|
+
* | Home, End | Moves to the first or the last reading. |
|
|
67843
|
+
* | Page Down, Page Up | Moves a tenth of the readings on or back. |
|
|
67844
|
+
* | Enter, Space | Presses the reading shown, which sends `helix-reading-press`. |
|
|
67845
|
+
* | Escape | Puts the reading and its tooltip away. |
|
|
67846
|
+
*
|
|
67614
67847
|
* ## Attributes & Properties
|
|
67615
67848
|
*
|
|
67616
67849
|
* Component attributes and properties that can be applied to the element or by using JavaScript.
|
|
@@ -67750,12 +67983,6 @@ export type CustomElementsSolidJs = {
|
|
|
67750
67983
|
* Set it to the words of the page's language, such as `{position} von
|
|
67751
67984
|
* {count}`, or to nothing to say no position. A slice or a series a
|
|
67752
67985
|
* legend hid is not counted.
|
|
67753
|
-
* - `pointer`: Finds the reading nearest the pointer, so the tooltip can sit on it.
|
|
67754
|
-
*
|
|
67755
|
-
* Public for the same reason `series` and `named` are: a protected member
|
|
67756
|
-
* cannot be cast onto across unrelated classes, so it would be invisible to
|
|
67757
|
-
* every chart that needs it. Reading where a pointer is resting is a fair
|
|
67758
|
-
* thing to ask a chart anyway. (property only) (readonly)
|
|
67759
67986
|
* - `data`: The readings as data, in the shape of a table, where the page has no
|
|
67760
67987
|
* table to point `for` at. `for` wins where both are set.
|
|
67761
67988
|
*
|
|
@@ -67794,21 +68021,6 @@ export type CustomElementsSolidJs = {
|
|
|
67794
68021
|
* names an element, and the chart is a generic around its plot: written
|
|
67795
68022
|
* on the host, the name reached nobody. The plot takes it, as Heatmap's
|
|
67796
68023
|
* strip always did. (property only) (readonly)
|
|
67797
|
-
* - `readingsKnown`: Whether the readings have been looked for: false on the server and
|
|
67798
|
-
* while hydrating, where no table is resolved and no data is read. A
|
|
67799
|
-
* chart says it has no readings only once this is true. (property only) (readonly)
|
|
67800
|
-
* - `sourceRows`: Every row of the table, with each cell's text and number.
|
|
67801
|
-
*
|
|
67802
|
-
* This is where a tooltip's content comes from, and it is deliberately not
|
|
67803
|
-
* `series`. A chart draws numbers; a reader resting a pointer on one wants
|
|
67804
|
-
* what the table says, which is `$128k` and not `128000`, and often wants
|
|
67805
|
-
* the column beside it that nothing plotted at all.
|
|
67806
|
-
*
|
|
67807
|
-
* **Not `rows`.** It is the source table's rows, and `rows` on a chart is a
|
|
67808
|
-
* name a chart wants for itself: `helix-heatmap` takes `rows="7"` to mean a
|
|
67809
|
-
* calendar week, and declaring that against a base class whose `rows` is a
|
|
67810
|
-
* `Row[]` getter is a type error at best. Name the member for what it holds
|
|
67811
|
-
* rather than for the shortest word available. (property only) (readonly)
|
|
67812
68024
|
* - `plottedColumns`: The positions of the cells in a row that hold numbers, in table order.
|
|
67813
68025
|
*
|
|
67814
68026
|
* The same test `readSeries` applies when it drops a column of notes: a
|
|
@@ -67854,8 +68066,6 @@ export type CustomElementsSolidJs = {
|
|
|
67854
68066
|
*
|
|
67855
68067
|
* Methods that can be called to access component functionality.
|
|
67856
68068
|
*
|
|
67857
|
-
* - `attributeChangedCallback(name: string, old: string | null, value: string | null) => void`: Called by the browser when an observed attribute changes. A new
|
|
67858
|
-
* `aria-label` asks for an update, because it names the plot.
|
|
67859
68069
|
* - `seriesOf(cell: number) => number | undefined`: The palette slot for the cell at this position in a row.
|
|
67860
68070
|
*
|
|
67861
68071
|
* **A cell's place in its row is not its series' depth, and the tooltip
|
|
@@ -67914,9 +68124,10 @@ export type CustomElementsSolidJs = {
|
|
|
67914
68124
|
* - `live`: The readout: a polite live region that says the reading the keys moved to. Hide it visually.
|
|
67915
68125
|
* - `loading`: The words in place of the drawing while `loading` is set and there are no readings: the `loading` slot, falling back to `loading-text`.
|
|
67916
68126
|
* - `mark`: The invisible point the tooltip is anchored to.
|
|
67917
|
-
* - `plot`: The drawing, which takes focus to be read by key.
|
|
68127
|
+
* - `plot`: The drawing, which takes focus to be read by key. With nothing to draw, a group named as the chart is, holding the `empty` or `loading` part.
|
|
67918
68128
|
* - `summary`: The chart's name and each series' highest reading, written as a sentence for screen readers. Hide it visually.
|
|
67919
68129
|
* - `svg`: The drawing surface the bars and lines sit on.
|
|
68130
|
+
* - `table`: The readings as a table, for a screen reader, rendered only where they were drawn from `data`. Hide it visually.
|
|
67920
68131
|
* - `tick`: One number on an axis.
|
|
67921
68132
|
* - `tooltip`: The tooltip bubble, forwarded from `Tooltip`.
|
|
67922
68133
|
* - `tooltip-anchor`: The `Tooltip` element itself.
|
|
@@ -67939,6 +68150,9 @@ export type CustomElementsSolidJs = {
|
|
|
67939
68150
|
*
|
|
67940
68151
|
* These can be used to apply styling when a component is in a given state.
|
|
67941
68152
|
*
|
|
68153
|
+
* - `active`: While a reading is shown, under the pointer or the keys, with its tooltip open.
|
|
68154
|
+
* - `empty`: While the `empty` part stands in the plot.
|
|
68155
|
+
* - `loading`: While the `loading` part stands in the plot.
|
|
67942
68156
|
* - `settled`: Set one frame after the first render. Transitions wait for it, so an element does not animate its own arrival.
|
|
67943
68157
|
*/
|
|
67944
68158
|
"helix-headless-bar-chart": Partial<
|
|
@@ -69113,7 +69327,11 @@ export type CustomElementsSolidJs = {
|
|
|
69113
69327
|
* double click zooms out.
|
|
69114
69328
|
*
|
|
69115
69329
|
* Keyboard behavior:
|
|
69116
|
-
* - One card holds the board's tab stop
|
|
69330
|
+
* - One card holds the board's tab stop, and the board itself leaves the tab
|
|
69331
|
+
* order while a card can hold it. Escape on a card goes back out to the
|
|
69332
|
+
* board, where the arrow keys pan it.
|
|
69333
|
+
* - Plus and minus zoom the board, on the board and on a card or a
|
|
69334
|
+
* connection.
|
|
69117
69335
|
* - The arrow keys move through the cards in reading order. The card you land
|
|
69118
69336
|
* on scrolls into view, and its connections are announced with it.
|
|
69119
69337
|
* - The card you land on is selected. Control or Command with an arrow key,
|
|
@@ -70143,7 +70361,7 @@ export type CustomElementsSolidJs = {
|
|
|
70143
70361
|
*
|
|
70144
70362
|
* - `helix-send`: Fired when the user sends their turn, and cancelable.
|
|
70145
70363
|
* - `helix-typing`: The user started or stopped writing, with `typing` saying which, as the composer's `typing` does.
|
|
70146
|
-
* - `input`: The user changed the text. Read it from `value`, for a typing indicator or a saved draft.
|
|
70364
|
+
* - `input`: The user changed the text. Read it from `value`, for a typing indicator or a saved draft. Bubbles and is composed, as a native field's is.
|
|
70147
70365
|
*
|
|
70148
70366
|
* ## Slots
|
|
70149
70367
|
*
|
|
@@ -70203,6 +70421,8 @@ export type CustomElementsSolidJs = {
|
|
|
70203
70421
|
* - `setCustomValidity(message: string) => void`: Marks the control invalid with `message`, or clears that with an empty
|
|
70204
70422
|
* string, as on a native control. The form does not submit while it is set.
|
|
70205
70423
|
* - `focus(options?: FocusOptions) => void`: Moves focus to the control, as focusing a native control does.
|
|
70424
|
+
* - `formAssociatedCallback(form: HTMLFormElement | null) => void`: Called by the browser when the control's form changes: watches the new
|
|
70425
|
+
* form's `checkValidity()`, as connecting does for the form it starts in.
|
|
70206
70426
|
*
|
|
70207
70427
|
* ## CSS Parts
|
|
70208
70428
|
*
|
|
@@ -70817,6 +71037,8 @@ export type CustomElementsSolidJs = {
|
|
|
70817
71037
|
* - `setCustomValidity(message: string) => void`: Marks the control invalid with `message`, or clears that with an empty
|
|
70818
71038
|
* string, as on a native control. The form does not submit while it is set.
|
|
70819
71039
|
* - `focus(options?: FocusOptions) => void`: Moves focus to the control, as focusing a native control does.
|
|
71040
|
+
* - `formAssociatedCallback(form: HTMLFormElement | null) => void`: Called by the browser when the control's form changes: watches the new
|
|
71041
|
+
* form's `checkValidity()`, as connecting does for the form it starts in.
|
|
70820
71042
|
*
|
|
70821
71043
|
* ## CSS Parts
|
|
70822
71044
|
*
|
|
@@ -71077,6 +71299,8 @@ export type CustomElementsSolidJs = {
|
|
|
71077
71299
|
* - `setCustomValidity(message: string) => void`: Marks the control invalid with `message`, or clears that with an empty
|
|
71078
71300
|
* string, as on a native control. The form does not submit while it is set.
|
|
71079
71301
|
* - `focus(options?: FocusOptions) => void`: Moves focus to the control, as focusing a native control does.
|
|
71302
|
+
* - `formAssociatedCallback(form: HTMLFormElement | null) => void`: Called by the browser when the control's form changes: watches the new
|
|
71303
|
+
* form's `checkValidity()`, as connecting does for the form it starts in.
|
|
71080
71304
|
*
|
|
71081
71305
|
* ## CSS Parts
|
|
71082
71306
|
*
|
|
@@ -71781,6 +72005,8 @@ export type CustomElementsSolidJs = {
|
|
|
71781
72005
|
* and shows the browser's message at the control.
|
|
71782
72006
|
* - `setCustomValidity(message: string) => void`: Marks the control invalid with `message`, or clears that with an empty
|
|
71783
72007
|
* string, as on a native control. The form does not submit while it is set.
|
|
72008
|
+
* - `formAssociatedCallback(form: HTMLFormElement | null) => void`: Called by the browser when the control's form changes: watches the new
|
|
72009
|
+
* form's `checkValidity()`, as connecting does for the form it starts in.
|
|
71784
72010
|
*
|
|
71785
72011
|
* ## CSS Custom Properties
|
|
71786
72012
|
*
|
|
@@ -72195,6 +72421,8 @@ export type CustomElementsSolidJs = {
|
|
|
72195
72421
|
* and shows the browser's message at the control.
|
|
72196
72422
|
* - `setCustomValidity(message: string) => void`: Marks the control invalid with `message`, or clears that with an empty
|
|
72197
72423
|
* string, as on a native control. The form does not submit while it is set.
|
|
72424
|
+
* - `formAssociatedCallback(form: HTMLFormElement | null) => void`: Called by the browser when the control's form changes: watches the new
|
|
72425
|
+
* form's `checkValidity()`, as connecting does for the form it starts in.
|
|
72198
72426
|
*
|
|
72199
72427
|
* ## CSS Custom Properties
|
|
72200
72428
|
*
|
|
@@ -72634,6 +72862,8 @@ export type CustomElementsSolidJs = {
|
|
|
72634
72862
|
* - `setCustomValidity(message: string) => void`: Marks the control invalid with `message`, or clears that with an empty
|
|
72635
72863
|
* string, as on a native control. The form does not submit while it is set.
|
|
72636
72864
|
* - `focus(options?: FocusOptions) => void`: Moves focus to the control, as focusing a native control does.
|
|
72865
|
+
* - `formAssociatedCallback(form: HTMLFormElement | null) => void`: Called by the browser when the control's form changes: watches the new
|
|
72866
|
+
* form's `checkValidity()`, as connecting does for the form it starts in.
|
|
72637
72867
|
*
|
|
72638
72868
|
* ## CSS Parts
|
|
72639
72869
|
*
|
|
@@ -73116,7 +73346,8 @@ export type CustomElementsSolidJs = {
|
|
|
73116
73346
|
*
|
|
73117
73347
|
* Methods that can be called to access component functionality.
|
|
73118
73348
|
*
|
|
73119
|
-
* - `formAssociatedCallback(form: HTMLFormElement | null) => void`: Called by the browser when the
|
|
73349
|
+
* - `formAssociatedCallback(form: HTMLFormElement | null) => void`: Called by the browser when the control's form changes: watches the new
|
|
73350
|
+
* form's `checkValidity()`, as connecting does for the form it starts in.
|
|
73120
73351
|
* - `formDisabledCallback(disabled: boolean) => void`: Called by the browser when an ancestor fieldset is disabled or enabled.
|
|
73121
73352
|
*
|
|
73122
73353
|
* **The argument is the effective state, and taking it whole is what latched
|
|
@@ -74126,6 +74357,8 @@ export type CustomElementsSolidJs = {
|
|
|
74126
74357
|
* and shows the browser's message at the control.
|
|
74127
74358
|
* - `setCustomValidity(message: string) => void`: Marks the control invalid with `message`, or clears that with an empty
|
|
74128
74359
|
* string, as on a native control. The form does not submit while it is set.
|
|
74360
|
+
* - `formAssociatedCallback(form: HTMLFormElement | null) => void`: Called by the browser when the control's form changes: watches the new
|
|
74361
|
+
* form's `checkValidity()`, as connecting does for the form it starts in.
|
|
74129
74362
|
*
|
|
74130
74363
|
* ## CSS Parts
|
|
74131
74364
|
*
|
|
@@ -74556,6 +74789,8 @@ export type CustomElementsSolidJs = {
|
|
|
74556
74789
|
* and shows the browser's message at the control.
|
|
74557
74790
|
* - `setCustomValidity(message: string) => void`: Marks the control invalid with `message`, or clears that with an empty
|
|
74558
74791
|
* string, as on a native control. The form does not submit while it is set.
|
|
74792
|
+
* - `formAssociatedCallback(form: HTMLFormElement | null) => void`: Called by the browser when the control's form changes: watches the new
|
|
74793
|
+
* form's `checkValidity()`, as connecting does for the form it starts in.
|
|
74559
74794
|
*
|
|
74560
74795
|
* ## CSS Custom Properties
|
|
74561
74796
|
*
|
|
@@ -75106,6 +75341,27 @@ export type CustomElementsSolidJs = {
|
|
|
75106
75341
|
* follows, the `live` part says the slice in words, and Escape puts the
|
|
75107
75342
|
* tooltip away.
|
|
75108
75343
|
*
|
|
75344
|
+
* **A tap shows the slice under it**, and keeps it until a tap lands
|
|
75345
|
+
* elsewhere. `helix-reading-change` says each move of the slice shown, by
|
|
75346
|
+
* pointer, tap or key, and `helix-reading-press` says a slice was clicked,
|
|
75347
|
+
* tapped, or pressed with Enter or Space, for a page that opens what a slice
|
|
75348
|
+
* stands for. `index` is the slice's row in the table.
|
|
75349
|
+
*
|
|
75350
|
+
* **A chart with nothing to draw says so.** A table with no readings shows
|
|
75351
|
+
* `empty-text`, "No readings", in the plot, and `loading` shows `loading-text`
|
|
75352
|
+
* there until readings arrive. The `empty` and `loading` slots take markup in
|
|
75353
|
+
* their place.
|
|
75354
|
+
*
|
|
75355
|
+
* **Keyboard.** The plot is one tab stop.
|
|
75356
|
+
*
|
|
75357
|
+
* | Key | What it does |
|
|
75358
|
+
* |---|---|
|
|
75359
|
+
* | Tab | Moves focus to the plot and shows the first slice. |
|
|
75360
|
+
* | Any arrow | Right and Down move to the next slice, Left and Up to the previous. On a right-to-left page, Left moves to the next. |
|
|
75361
|
+
* | Home, End | Moves to the first or the last slice. |
|
|
75362
|
+
* | Enter, Space | Presses the slice shown, which sends `helix-reading-press`. |
|
|
75363
|
+
* | Escape | Puts the slice and its tooltip away. |
|
|
75364
|
+
*
|
|
75109
75365
|
* ## Attributes & Properties
|
|
75110
75366
|
*
|
|
75111
75367
|
* Component attributes and properties that can be applied to the element or by using JavaScript.
|
|
@@ -75163,6 +75419,16 @@ export type CustomElementsSolidJs = {
|
|
|
75163
75419
|
* rotation that puts the first slice at nine o'clock, the aspect ratio of a
|
|
75164
75420
|
* box that is no longer square, and where the middle sits once the bottom of
|
|
75165
75421
|
* the circle is not drawn.
|
|
75422
|
+
* - `empty-text`/`emptyText`: The words shown in place of the drawing when the table has no readings,
|
|
75423
|
+
* and the fallback of the `empty` slot.
|
|
75424
|
+
* - `loading`: Whether the readings are still on their way. The chart shows
|
|
75425
|
+
* `loading-text` in place of an empty drawing until it has readings.
|
|
75426
|
+
*
|
|
75427
|
+
* Reflected, so a stylesheet can treat the chart while it waits. A chart
|
|
75428
|
+
* that already has readings keeps drawing them, so a refresh does not
|
|
75429
|
+
* blank it.
|
|
75430
|
+
* - `loading-text`/`loadingText`: The words shown in place of the drawing while `loading` is set and
|
|
75431
|
+
* there are no readings yet, and the fallback of the `loading` slot.
|
|
75166
75432
|
* - `for`: The id of the table to read.
|
|
75167
75433
|
*
|
|
75168
75434
|
* Names a table in the same tree, so a chart inside another component's
|
|
@@ -75191,12 +75457,6 @@ export type CustomElementsSolidJs = {
|
|
|
75191
75457
|
*
|
|
75192
75458
|
* The mixin counts the table's rows, and a row with no amount draws no
|
|
75193
75459
|
* slice, so a key stepping by rows would land on a slice that is not there. (property only) (readonly)
|
|
75194
|
-
* - `pointer`: Finds the reading nearest the pointer, so the tooltip can sit on it.
|
|
75195
|
-
*
|
|
75196
|
-
* Public for the same reason `series` and `named` are: a protected member
|
|
75197
|
-
* cannot be cast onto across unrelated classes, so it would be invisible to
|
|
75198
|
-
* every chart that needs it. Reading where a pointer is resting is a fair
|
|
75199
|
-
* thing to ask a chart anyway. (property only) (readonly)
|
|
75200
75460
|
* - `data`: The readings as data, in the shape of a table, where the page has no
|
|
75201
75461
|
* table to point `for` at. `for` wins where both are set.
|
|
75202
75462
|
*
|
|
@@ -75235,21 +75495,6 @@ export type CustomElementsSolidJs = {
|
|
|
75235
75495
|
* names an element, and the chart is a generic around its plot: written
|
|
75236
75496
|
* on the host, the name reached nobody. The plot takes it, as Heatmap's
|
|
75237
75497
|
* strip always did. (property only) (readonly)
|
|
75238
|
-
* - `readingsKnown`: Whether the readings have been looked for: false on the server and
|
|
75239
|
-
* while hydrating, where no table is resolved and no data is read. A
|
|
75240
|
-
* chart says it has no readings only once this is true. (property only) (readonly)
|
|
75241
|
-
* - `sourceRows`: Every row of the table, with each cell's text and number.
|
|
75242
|
-
*
|
|
75243
|
-
* This is where a tooltip's content comes from, and it is deliberately not
|
|
75244
|
-
* `series`. A chart draws numbers; a reader resting a pointer on one wants
|
|
75245
|
-
* what the table says, which is `$128k` and not `128000`, and often wants
|
|
75246
|
-
* the column beside it that nothing plotted at all.
|
|
75247
|
-
*
|
|
75248
|
-
* **Not `rows`.** It is the source table's rows, and `rows` on a chart is a
|
|
75249
|
-
* name a chart wants for itself: `helix-heatmap` takes `rows="7"` to mean a
|
|
75250
|
-
* calendar week, and declaring that against a base class whose `rows` is a
|
|
75251
|
-
* `Row[]` getter is a type error at best. Name the member for what it holds
|
|
75252
|
-
* rather than for the shortest word available. (property only) (readonly)
|
|
75253
75498
|
* - `plottedColumns`: The positions of the cells in a row that hold numbers, in table order.
|
|
75254
75499
|
*
|
|
75255
75500
|
* The same test `readSeries` applies when it drops a column of notes: a
|
|
@@ -75276,11 +75521,20 @@ export type CustomElementsSolidJs = {
|
|
|
75276
75521
|
* browser harness's awaits it alone: a browser always runs the frame, and a
|
|
75277
75522
|
* timer beside it was a bet on how long one takes, which a busy run lost. (property only) (readonly)
|
|
75278
75523
|
*
|
|
75524
|
+
* ## Events
|
|
75525
|
+
*
|
|
75526
|
+
* Events that will be emitted by the component.
|
|
75527
|
+
*
|
|
75528
|
+
* - `helix-reading-change`: The slice shown moved, or was put away: `index` is the slice's row, or `-1` for none, with its `label` and the `pointerType` that moved it.
|
|
75529
|
+
* - `helix-reading-press`: A slice was clicked, tapped, or pressed with Enter or Space, with the same detail as `helix-reading-change`.
|
|
75530
|
+
*
|
|
75279
75531
|
* ## Slots
|
|
75280
75532
|
*
|
|
75281
75533
|
* Areas where markup can be added to the component.
|
|
75282
75534
|
*
|
|
75283
75535
|
* - `(default)`: Content in the middle of the ring, usually a total. It is read by screen readers, while the ring itself is hidden from them.
|
|
75536
|
+
* - `empty`: Content shown in place of the ring when the table has no readings. Falls back to `empty-text`.
|
|
75537
|
+
* - `loading`: Content shown in place of the ring while `loading` is set and there are no readings yet. Falls back to `loading-text`.
|
|
75284
75538
|
*
|
|
75285
75539
|
* ## Methods
|
|
75286
75540
|
*
|
|
@@ -75291,8 +75545,6 @@ export type CustomElementsSolidJs = {
|
|
|
75291
75545
|
* no series the keys could move to.
|
|
75292
75546
|
* - `showsReading(at: number) => boolean`: Whether the slice at this place is drawn, which a slice a legend hid is
|
|
75293
75547
|
* not. The keys pass over it, as the ring closes over it.
|
|
75294
|
-
* - `attributeChangedCallback(name: string, old: string | null, value: string | null) => void`: Called by the browser when an observed attribute changes. A new
|
|
75295
|
-
* `aria-label` asks for an update, because it names the plot.
|
|
75296
75548
|
* - `showsSeries(name: string) => boolean`: Whether the series of this name is drawn, which it is unless a legend
|
|
75297
75549
|
* reading the same table hid it.
|
|
75298
75550
|
*
|
|
@@ -75321,14 +75573,17 @@ export type CustomElementsSolidJs = {
|
|
|
75321
75573
|
* Custom selectors for styling elements within the component.
|
|
75322
75574
|
*
|
|
75323
75575
|
* - `center`: The middle of the ring, holding whatever is slotted.
|
|
75576
|
+
* - `empty`: The words in place of the ring when the table has no readings: the `empty` slot, falling back to `empty-text`. Not drawn while the table cannot be read yet, on the server and during hydration.
|
|
75324
75577
|
* - `live`: The readout: a polite live region that says the slice the keys moved to. Hide it visually.
|
|
75578
|
+
* - `loading`: The words in place of the ring while `loading` is set and there are no readings: the `loading` slot, falling back to `loading-text`.
|
|
75325
75579
|
* - `mark`: The invisible point the tooltip is anchored to.
|
|
75326
|
-
* - `plot`: The drawing, which takes focus to be read by key.
|
|
75580
|
+
* - `plot`: The drawing, which takes focus to be read by key. With nothing to draw, a group named as the chart is, holding the `empty` or `loading` part.
|
|
75327
75581
|
* - `segment`: One slice.
|
|
75328
75582
|
* - `segment-active`: The slice under the pointer. Set alongside `segment`.
|
|
75329
75583
|
* - `segment-edge`: One slice as a closed shape, used to draw its outline.
|
|
75330
75584
|
* - `slice-label`: One slice's share, written on the slice under `slice-labels`. Placed with `left` and `top`, or `inset-inline-start` and `top` on a half ring, and carries its series color as `--chart-series`.
|
|
75331
75585
|
* - `summary`: The chart's name and each slice's share, written as a sentence for screen readers. Hide it visually.
|
|
75586
|
+
* - `table`: The readings as a table, for a screen reader, rendered only where they were drawn from `data`. Hide it visually.
|
|
75332
75587
|
* - `tooltip`: The bubble, forwarded from `Tooltip`.
|
|
75333
75588
|
* - `tooltip-anchor`: The `Tooltip` element itself.
|
|
75334
75589
|
* - `tooltip-arrow`: The bubble's point, forwarded from `Tooltip`.
|
|
@@ -75351,6 +75606,9 @@ export type CustomElementsSolidJs = {
|
|
|
75351
75606
|
*
|
|
75352
75607
|
* These can be used to apply styling when a component is in a given state.
|
|
75353
75608
|
*
|
|
75609
|
+
* - `active`: While a slice is shown, under the pointer or the keys, with its tooltip open.
|
|
75610
|
+
* - `empty`: While the `empty` part stands in place of the ring.
|
|
75611
|
+
* - `loading`: While the `loading` part stands in place of the ring.
|
|
75354
75612
|
* - `settled`: Set one frame after the first render. Transitions wait for it, so an element does not animate its own arrival.
|
|
75355
75613
|
*/
|
|
75356
75614
|
"helix-headless-donut-chart": Partial<
|
|
@@ -76217,8 +76475,9 @@ export type CustomElementsSolidJs = {
|
|
|
76217
76475
|
*
|
|
76218
76476
|
* Not through `commit`, and that is the point of the split: a reset is the
|
|
76219
76477
|
* form's decision and there is nothing here for a listener to refuse. What it
|
|
76220
|
-
* owes is the report
|
|
76221
|
-
* `
|
|
76478
|
+
* owes is the report to the form, and no `input` or `change`: a native file
|
|
76479
|
+
* input sends neither on `form.reset()`, measured in Chromium, where this
|
|
76480
|
+
* sent both.
|
|
76222
76481
|
* - `formDisabledCallback(disabled: boolean) => void`: Called by the browser when an ancestor fieldset is disabled or enabled.
|
|
76223
76482
|
*
|
|
76224
76483
|
* **The argument is the effective state, and taking it whole is what latched
|
|
@@ -76258,6 +76517,8 @@ export type CustomElementsSolidJs = {
|
|
|
76258
76517
|
* and shows the browser's message at the control.
|
|
76259
76518
|
* - `setCustomValidity(message: string) => void`: Marks the control invalid with `message`, or clears that with an empty
|
|
76260
76519
|
* string, as on a native control. The form does not submit while it is set.
|
|
76520
|
+
* - `formAssociatedCallback(form: HTMLFormElement | null) => void`: Called by the browser when the control's form changes: watches the new
|
|
76521
|
+
* form's `checkValidity()`, as connecting does for the form it starts in.
|
|
76261
76522
|
*
|
|
76262
76523
|
* ## CSS Parts
|
|
76263
76524
|
*
|
|
@@ -77224,6 +77485,8 @@ export type CustomElementsSolidJs = {
|
|
|
77224
77485
|
* and shows the browser's message at the control.
|
|
77225
77486
|
* - `setCustomValidity(message: string) => void`: Marks the control invalid with `message`, or clears that with an empty
|
|
77226
77487
|
* string, as on a native control. The form does not submit while it is set.
|
|
77488
|
+
* - `formAssociatedCallback(form: HTMLFormElement | null) => void`: Called by the browser when the control's form changes: watches the new
|
|
77489
|
+
* form's `checkValidity()`, as connecting does for the form it starts in.
|
|
77227
77490
|
*
|
|
77228
77491
|
* ## CSS Parts
|
|
77229
77492
|
*
|
|
@@ -77472,7 +77735,9 @@ export type CustomElementsSolidJs = {
|
|
|
77472
77735
|
*
|
|
77473
77736
|
* Set `legend` to name the groups over the drawing, each a button that shows
|
|
77474
77737
|
* or hides its notes. `hiddenGroups` holds the groups turned off, and the
|
|
77475
|
-
* list holds only what the drawing shows.
|
|
77738
|
+
* list holds only what the drawing shows. The legend is a toolbar and one tab
|
|
77739
|
+
* stop: the arrow keys, Home, End and a group's first letters move between
|
|
77740
|
+
* its buttons, and Space or Enter presses one.
|
|
77476
77741
|
*
|
|
77477
77742
|
* `nodes` and `links` are properties, never markup: a graph of ten thousand
|
|
77478
77743
|
* notes as ten thousand elements would cost what the renderer exists to save.
|
|
@@ -77522,6 +77787,9 @@ export type CustomElementsSolidJs = {
|
|
|
77522
77787
|
* own, since the fallback name is the same word. Empty leaves the role.
|
|
77523
77788
|
* - `search-label`/`searchLabel`: The search field's name.
|
|
77524
77789
|
* - `selected-label`/`selectedLabel`: How the selected note is described in the list.
|
|
77790
|
+
* - `selection-label`/`selectionLabel`: What screen readers hear after a reader selects a note, in the list or in
|
|
77791
|
+
* the drawing, with `{note}` for its name and `{count}` for how many notes
|
|
77792
|
+
* the list then holds, written with `count-label`.
|
|
77525
77793
|
* - `two-finger-hint-label`/`twoFingerHintLabel`: The hint shown when one finger swipes over the graph with `gestures="cooperative"`.
|
|
77526
77794
|
* - `using-label`/`usingLabel`: The line shown while the graph, with `gestures="activate"`, has the gestures.
|
|
77527
77795
|
* - `wheel-hint-label`/`wheelHintLabel`: The hint shown when the wheel scrolls past the graph with
|
|
@@ -77710,18 +77978,10 @@ export type CustomElementsSolidJs = {
|
|
|
77710
77978
|
* **Said once the drawing has moved, and only then.** The frame asks and
|
|
77711
77979
|
* the renderer moves, so a frame with nothing to answer it says nothing: a
|
|
77712
77980
|
* move said that never happened is worse than silence.
|
|
77981
|
+
* - `requestActive(next: string, cause?: string) => boolean`: Asks for a note to be selected, and remembers the ask, so the selection is said once it lands.
|
|
77713
77982
|
* - `pan(to: ViewportWay) => void`: Pans the view one step in a direction.
|
|
77714
77983
|
* - `zoom(by: number) => void`: Zooms the view one step: `1` zooms in and `-1` zooms out.
|
|
77715
77984
|
* - `toggleFullscreen() => void`: Turns fullscreen on or off.
|
|
77716
|
-
* - `requestActive(next: string, cause?: string) => boolean`: Requests a new current item, and returns whether the change was applied.
|
|
77717
|
-
*
|
|
77718
|
-
* Announces before it acts, so `preventDefault()` on the `helix-before-activate` is
|
|
77719
|
-
* a refusal and nothing moves. Unlike a native control, nothing has moved
|
|
77720
|
-
* by the time this runs, so refusing is simply not writing: there is
|
|
77721
|
-
* nothing to put back. Nobody refusing means the set updates itself,
|
|
77722
|
-
* whether or not a consumer declared `active`, a declared property being a
|
|
77723
|
-
* seed and a correction. `cause` says why, where the family names its
|
|
77724
|
-
* causes, and reaches the event as `detail.cause`.
|
|
77725
77985
|
*
|
|
77726
77986
|
* ## CSS Parts
|
|
77727
77987
|
*
|
|
@@ -77740,7 +78000,7 @@ export type CustomElementsSolidJs = {
|
|
|
77740
78000
|
* - `gesture-hint`: Words over the graph for a moment when it lets a gesture pass to the page, such as how to zoom it.
|
|
77741
78001
|
* - `gesture-status`: The line shown while a graph with `gestures="activate"` has the gestures.
|
|
77742
78002
|
* - `header`: The strip above the graph.
|
|
77743
|
-
* - `legend`: The groups over the drawing, with `legend
|
|
78003
|
+
* - `legend`: The groups over the drawing, with `legend`: a toolbar of buttons, each showing or hiding its notes, which is one tab stop.
|
|
77744
78004
|
* - `legend-item`: One group in the legend, pressed while its notes are shown. Carries `data-tone` where every note in the group has the same tone, which colors the notes over the group's own color.
|
|
77745
78005
|
* - `legend-item-hidden`: A group in the legend whose notes are hidden.
|
|
77746
78006
|
* - `legend-swatch`: The mark in a group's color, before its name.
|
|
@@ -77829,11 +78089,25 @@ export type CustomElementsSolidJs = {
|
|
|
77829
78089
|
* `multiple` any number. Space, Enter or a press selects the cell the keys or
|
|
77830
78090
|
* the pointer rest on, or lets it go, and under `multiple` Shift with an arrow,
|
|
77831
78091
|
* Home, End, PageUp or PageDown takes in every cell from the last one pressed
|
|
77832
|
-
* to where the key went. `value` holds the selected days, by
|
|
77833
|
-
*
|
|
78092
|
+
* to where the key went. `value` holds the selected days, separated by
|
|
78093
|
+
* commas: each by its row's `<time datetime>`, such as `2026-06-11`, or by
|
|
78094
|
+
* its row's name where the row carries no date. A change asks with
|
|
77834
78095
|
* `helix-before-change` and tells with `change`, and the `selection` part says
|
|
77835
78096
|
* how many are selected, in `selection-label`.
|
|
77836
78097
|
*
|
|
78098
|
+
* **Keyboard.** The strip is one tab stop once it has cells.
|
|
78099
|
+
*
|
|
78100
|
+
* | Key | What it does |
|
|
78101
|
+
* |---|---|
|
|
78102
|
+
* | Tab | Moves focus to the strip and shows the first cell. |
|
|
78103
|
+
* | Down, Up | Moves to the next or the previous cell. |
|
|
78104
|
+
* | Right, Left | Moves a column on or back, a week with `rows="7"`. On a right-to-left page, Left moves on. |
|
|
78105
|
+
* | Home, End | Moves to the first or the last cell. |
|
|
78106
|
+
* | Page Down, Page Up | Moves a month on or back where the rows carry dates, and four columns otherwise. |
|
|
78107
|
+
* | Enter, Space | Selects the cell, or lets it go, under `selection-mode`. |
|
|
78108
|
+
* | Shift with an arrow, Home, End, Page Up or Page Down | Selects every cell from the last one pressed to where the key went, under `selection-mode="multiple"`. |
|
|
78109
|
+
* | Escape | Puts the cell's tooltip away. |
|
|
78110
|
+
*
|
|
77837
78111
|
* ## Attributes & Properties
|
|
77838
78112
|
*
|
|
77839
78113
|
* Component attributes and properties that can be applied to the element or by using JavaScript.
|
|
@@ -77904,8 +78178,9 @@ export type CustomElementsSolidJs = {
|
|
|
77904
78178
|
* no order in it.
|
|
77905
78179
|
* - `total-label`/`totalLabel`: The name the `overview` gives the total of the readings drawn,
|
|
77906
78180
|
* `{totalLabel}` in `overview-label`.
|
|
77907
|
-
* - `value`: The selected cells, by
|
|
77908
|
-
* `2026-06-11`,
|
|
78181
|
+
* - `value`: The selected cells, separated by commas: each by the date its row's
|
|
78182
|
+
* header carries in a `<time datetime>`, such as `2026-06-11`, or by the
|
|
78183
|
+
* header's words where it carries none.
|
|
77909
78184
|
*
|
|
77910
78185
|
* Set it to start with cells selected. Written by a press or a key under
|
|
77911
78186
|
* `selection-mode`.
|
|
@@ -77951,12 +78226,6 @@ export type CustomElementsSolidJs = {
|
|
|
77951
78226
|
*
|
|
77952
78227
|
* The mixin counts the table's rows, and a strip too narrow for all of them
|
|
77953
78228
|
* draws the newest, so a key stepping by rows would walk off the drawing. (property only) (readonly)
|
|
77954
|
-
* - `pointer`: Finds the reading nearest the pointer, so the tooltip can sit on it.
|
|
77955
|
-
*
|
|
77956
|
-
* Public for the same reason `series` and `named` are: a protected member
|
|
77957
|
-
* cannot be cast onto across unrelated classes, so it would be invisible to
|
|
77958
|
-
* every chart that needs it. Reading where a pointer is resting is a fair
|
|
77959
|
-
* thing to ask a chart anyway. (property only) (readonly)
|
|
77960
78229
|
* - `data`: The readings as data, in the shape of a table, where the page has no
|
|
77961
78230
|
* table to point `for` at. `for` wins where both are set.
|
|
77962
78231
|
*
|
|
@@ -77995,21 +78264,6 @@ export type CustomElementsSolidJs = {
|
|
|
77995
78264
|
* names an element, and the chart is a generic around its plot: written
|
|
77996
78265
|
* on the host, the name reached nobody. The plot takes it, as Heatmap's
|
|
77997
78266
|
* strip always did. (property only) (readonly)
|
|
77998
|
-
* - `readingsKnown`: Whether the readings have been looked for: false on the server and
|
|
77999
|
-
* while hydrating, where no table is resolved and no data is read. A
|
|
78000
|
-
* chart says it has no readings only once this is true. (property only) (readonly)
|
|
78001
|
-
* - `sourceRows`: Every row of the table, with each cell's text and number.
|
|
78002
|
-
*
|
|
78003
|
-
* This is where a tooltip's content comes from, and it is deliberately not
|
|
78004
|
-
* `series`. A chart draws numbers; a reader resting a pointer on one wants
|
|
78005
|
-
* what the table says, which is `$128k` and not `128000`, and often wants
|
|
78006
|
-
* the column beside it that nothing plotted at all.
|
|
78007
|
-
*
|
|
78008
|
-
* **Not `rows`.** It is the source table's rows, and `rows` on a chart is a
|
|
78009
|
-
* name a chart wants for itself: `helix-heatmap` takes `rows="7"` to mean a
|
|
78010
|
-
* calendar week, and declaring that against a base class whose `rows` is a
|
|
78011
|
-
* `Row[]` getter is a type error at best. Name the member for what it holds
|
|
78012
|
-
* rather than for the shortest word available. (property only) (readonly)
|
|
78013
78267
|
* - `plottedColumns`: The positions of the cells in a row that hold numbers, in table order.
|
|
78014
78268
|
*
|
|
78015
78269
|
* The same test `readSeries` applies when it drops a column of notes: a
|
|
@@ -78059,8 +78313,6 @@ export type CustomElementsSolidJs = {
|
|
|
78059
78313
|
* - `pageFrom(at: number, forward: boolean) => number | undefined`: Where PageUp or PageDown goes from the drawn cell at `at`: the same day a
|
|
78060
78314
|
* month on or back, by the dates the rows' headers carry. Undefined where
|
|
78061
78315
|
* they carry none, and the keys move four columns.
|
|
78062
|
-
* - `attributeChangedCallback(name: string, old: string | null, value: string | null) => void`: Called by the browser when an observed attribute changes. A new
|
|
78063
|
-
* `aria-label` asks for an update, because it names the plot.
|
|
78064
78316
|
* - `seriesOf(cell: number) => number | undefined`: The palette slot for the cell at this position in a row.
|
|
78065
78317
|
*
|
|
78066
78318
|
* **A cell's place in its row is not its series' depth, and the tooltip
|
|
@@ -78127,6 +78379,7 @@ export type CustomElementsSolidJs = {
|
|
|
78127
78379
|
* - `start`: The leading slot's box.
|
|
78128
78380
|
* - `strip`: The grid of cells, which takes focus to be read by key. It is named by the host's `aria-labelledby` or `aria-label`, then by `label`, then by the caption of the table.
|
|
78129
78381
|
* - `summary`: The middle slot's box.
|
|
78382
|
+
* - `table`: The readings as a table, for a screen reader, rendered only where they were drawn from `data`. Hide it visually.
|
|
78130
78383
|
* - `tooltip`: The bubble, forwarded from `Tooltip`.
|
|
78131
78384
|
* - `tooltip-anchor`: The `Tooltip` element itself.
|
|
78132
78385
|
* - `tooltip-arrow`: The bubble's point, forwarded from `Tooltip`.
|
|
@@ -78148,6 +78401,8 @@ export type CustomElementsSolidJs = {
|
|
|
78148
78401
|
*
|
|
78149
78402
|
* These can be used to apply styling when a component is in a given state.
|
|
78150
78403
|
*
|
|
78404
|
+
* - `active`: While a cell is shown, under the pointer or the keys, with its tooltip open.
|
|
78405
|
+
* - `empty`: While the `empty` part stands in place of the cells.
|
|
78151
78406
|
* - `settled`: Set one frame after the first render. Transitions wait for it, so an element does not animate its own arrival.
|
|
78152
78407
|
*/
|
|
78153
78408
|
"helix-headless-heatmap": Partial<
|
|
@@ -78357,7 +78612,8 @@ export type CustomElementsSolidJs = {
|
|
|
78357
78612
|
*
|
|
78358
78613
|
* Methods that can be called to access component functionality.
|
|
78359
78614
|
*
|
|
78360
|
-
* - `formAssociatedCallback(form: HTMLFormElement | null) => void`: Called by the browser when the
|
|
78615
|
+
* - `formAssociatedCallback(form: HTMLFormElement | null) => void`: Called by the browser when the control's form changes: watches the new
|
|
78616
|
+
* form's `checkValidity()`, as connecting does for the form it starts in.
|
|
78361
78617
|
* - `formDisabledCallback(disabled: boolean) => void`: Called by the browser when an ancestor fieldset is disabled or enabled.
|
|
78362
78618
|
*
|
|
78363
78619
|
* **The argument is the effective state, and taking it whole is what latched
|
|
@@ -79025,6 +79281,8 @@ export type CustomElementsSolidJs = {
|
|
|
79025
79281
|
* and shows the browser's message at the control.
|
|
79026
79282
|
* - `setCustomValidity(message: string) => void`: Marks the control invalid with `message`, or clears that with an empty
|
|
79027
79283
|
* string, as on a native control. The form does not submit while it is set.
|
|
79284
|
+
* - `formAssociatedCallback(form: HTMLFormElement | null) => void`: Called by the browser when the control's form changes: watches the new
|
|
79285
|
+
* form's `checkValidity()`, as connecting does for the form it starts in.
|
|
79028
79286
|
*
|
|
79029
79287
|
* ## CSS Parts
|
|
79030
79288
|
*
|
|
@@ -79702,6 +79960,18 @@ export type CustomElementsSolidJs = {
|
|
|
79702
79960
|
* there until readings arrive. The `empty` and `loading` slots take markup in
|
|
79703
79961
|
* their place, such as a link to add the first reading.
|
|
79704
79962
|
*
|
|
79963
|
+
* **Keyboard.** The plot is one tab stop.
|
|
79964
|
+
*
|
|
79965
|
+
* | Key | What it does |
|
|
79966
|
+
* |---|---|
|
|
79967
|
+
* | Tab | Moves focus to the plot and shows the first reading. |
|
|
79968
|
+
* | Right, Left | Moves to the next or the previous reading. On a right-to-left page, Left moves to the next. |
|
|
79969
|
+
* | Down, Up | Moves among the series of the reading. With one series, moves to the next or the previous reading. |
|
|
79970
|
+
* | Home, End | Moves to the first or the last reading. |
|
|
79971
|
+
* | Page Down, Page Up | Moves a tenth of the readings on or back. |
|
|
79972
|
+
* | Enter, Space | Presses the reading shown, which sends `helix-reading-press`. |
|
|
79973
|
+
* | Escape | Puts the reading and its tooltip away. |
|
|
79974
|
+
*
|
|
79705
79975
|
* ## Attributes & Properties
|
|
79706
79976
|
*
|
|
79707
79977
|
* Component attributes and properties that can be applied to the element or by using JavaScript.
|
|
@@ -79846,12 +80116,6 @@ export type CustomElementsSolidJs = {
|
|
|
79846
80116
|
* Set it to the words of the page's language, such as `{position} von
|
|
79847
80117
|
* {count}`, or to nothing to say no position. A slice or a series a
|
|
79848
80118
|
* legend hid is not counted.
|
|
79849
|
-
* - `pointer`: Finds the reading nearest the pointer, so the tooltip can sit on it.
|
|
79850
|
-
*
|
|
79851
|
-
* Public for the same reason `series` and `named` are: a protected member
|
|
79852
|
-
* cannot be cast onto across unrelated classes, so it would be invisible to
|
|
79853
|
-
* every chart that needs it. Reading where a pointer is resting is a fair
|
|
79854
|
-
* thing to ask a chart anyway. (property only) (readonly)
|
|
79855
80119
|
* - `data`: The readings as data, in the shape of a table, where the page has no
|
|
79856
80120
|
* table to point `for` at. `for` wins where both are set.
|
|
79857
80121
|
*
|
|
@@ -79890,21 +80154,6 @@ export type CustomElementsSolidJs = {
|
|
|
79890
80154
|
* names an element, and the chart is a generic around its plot: written
|
|
79891
80155
|
* on the host, the name reached nobody. The plot takes it, as Heatmap's
|
|
79892
80156
|
* strip always did. (property only) (readonly)
|
|
79893
|
-
* - `readingsKnown`: Whether the readings have been looked for: false on the server and
|
|
79894
|
-
* while hydrating, where no table is resolved and no data is read. A
|
|
79895
|
-
* chart says it has no readings only once this is true. (property only) (readonly)
|
|
79896
|
-
* - `sourceRows`: Every row of the table, with each cell's text and number.
|
|
79897
|
-
*
|
|
79898
|
-
* This is where a tooltip's content comes from, and it is deliberately not
|
|
79899
|
-
* `series`. A chart draws numbers; a reader resting a pointer on one wants
|
|
79900
|
-
* what the table says, which is `$128k` and not `128000`, and often wants
|
|
79901
|
-
* the column beside it that nothing plotted at all.
|
|
79902
|
-
*
|
|
79903
|
-
* **Not `rows`.** It is the source table's rows, and `rows` on a chart is a
|
|
79904
|
-
* name a chart wants for itself: `helix-heatmap` takes `rows="7"` to mean a
|
|
79905
|
-
* calendar week, and declaring that against a base class whose `rows` is a
|
|
79906
|
-
* `Row[]` getter is a type error at best. Name the member for what it holds
|
|
79907
|
-
* rather than for the shortest word available. (property only) (readonly)
|
|
79908
80157
|
* - `plottedColumns`: The positions of the cells in a row that hold numbers, in table order.
|
|
79909
80158
|
*
|
|
79910
80159
|
* The same test `readSeries` applies when it drops a column of notes: a
|
|
@@ -79950,8 +80199,6 @@ export type CustomElementsSolidJs = {
|
|
|
79950
80199
|
*
|
|
79951
80200
|
* Methods that can be called to access component functionality.
|
|
79952
80201
|
*
|
|
79953
|
-
* - `attributeChangedCallback(name: string, old: string | null, value: string | null) => void`: Called by the browser when an observed attribute changes. A new
|
|
79954
|
-
* `aria-label` asks for an update, because it names the plot.
|
|
79955
80202
|
* - `seriesOf(cell: number) => number | undefined`: The palette slot for the cell at this position in a row.
|
|
79956
80203
|
*
|
|
79957
80204
|
* **A cell's place in its row is not its series' depth, and the tooltip
|
|
@@ -80010,9 +80257,10 @@ export type CustomElementsSolidJs = {
|
|
|
80010
80257
|
* - `mark`: The invisible point the tooltip is anchored to.
|
|
80011
80258
|
* - `marker`: The mark on one reading, under `markers`, and on a reading with a blank on either side. Placed with `inset-inline-start` and `inset-block-start`, and carries its series color as `--chart-series`.
|
|
80012
80259
|
* - `marker-lone`: A `marker` on a reading with a blank on either side, which no line reaches. Set alongside `marker`.
|
|
80013
|
-
* - `plot`: The drawing, which takes focus to be read by key.
|
|
80260
|
+
* - `plot`: The drawing, which takes focus to be read by key. With nothing to draw, a group named as the chart is, holding the `empty` or `loading` part.
|
|
80014
80261
|
* - `summary`: The chart's name and each series' latest reading, written as a sentence for screen readers. Hide it visually.
|
|
80015
80262
|
* - `svg`: The drawing surface the lines and areas sit on.
|
|
80263
|
+
* - `table`: The readings as a table, for a screen reader, rendered only where they were drawn from `data`. Hide it visually.
|
|
80016
80264
|
* - `terminus`: The mark on one series' last reading.
|
|
80017
80265
|
* - `tick`: One number on the axis, placed with `inset-block-start` at its level.
|
|
80018
80266
|
* - `tooltip`: The bubble, forwarded from `Tooltip`.
|
|
@@ -80036,6 +80284,9 @@ export type CustomElementsSolidJs = {
|
|
|
80036
80284
|
*
|
|
80037
80285
|
* These can be used to apply styling when a component is in a given state.
|
|
80038
80286
|
*
|
|
80287
|
+
* - `active`: While a reading is shown, under the pointer or the keys, with its tooltip open.
|
|
80288
|
+
* - `empty`: While the `empty` part stands in the plot.
|
|
80289
|
+
* - `loading`: While the `loading` part stands in the plot.
|
|
80039
80290
|
* - `settled`: Set one frame after the first render. Transitions wait for it, so an element does not animate its own arrival.
|
|
80040
80291
|
*/
|
|
80041
80292
|
"helix-headless-line-chart": Partial<
|
|
@@ -80841,6 +81092,8 @@ export type CustomElementsSolidJs = {
|
|
|
80841
81092
|
* - `setCustomValidity(message: string) => void`: Marks the control invalid with `message`, or clears that with an empty
|
|
80842
81093
|
* string, as on a native control. The form does not submit while it is set.
|
|
80843
81094
|
* - `focus(options?: FocusOptions) => void`: Moves focus to the control, as focusing a native control does.
|
|
81095
|
+
* - `formAssociatedCallback(form: HTMLFormElement | null) => void`: Called by the browser when the control's form changes: watches the new
|
|
81096
|
+
* form's `checkValidity()`, as connecting does for the form it starts in.
|
|
80844
81097
|
*
|
|
80845
81098
|
* ## CSS Parts
|
|
80846
81099
|
*
|
|
@@ -80908,6 +81161,13 @@ export type CustomElementsSolidJs = {
|
|
|
80908
81161
|
* hidden, and silent, for that many milliseconds, and appears only if the work
|
|
80909
81162
|
* is still going. While it waits it carries `:state(waiting)`.
|
|
80910
81163
|
*
|
|
81164
|
+
* **The loader can stand in for what it wraps.** Put the content in the
|
|
81165
|
+
* `content` slot, such as a button or a card, and set `idle` while no work is
|
|
81166
|
+
* in progress. While the work runs, the content keeps its size and is hidden
|
|
81167
|
+
* and inert, and the ring draws over it. While `idle` is set, the loader draws
|
|
81168
|
+
* nothing of its own, has no role, and marks no region busy, so only the
|
|
81169
|
+
* content shows. Clearing `idle` starts `delay` again.
|
|
81170
|
+
*
|
|
80911
81171
|
* ## Attributes & Properties
|
|
80912
81172
|
*
|
|
80913
81173
|
* Component attributes and properties that can be applied to the element or by using JavaScript.
|
|
@@ -80922,6 +81182,9 @@ export type CustomElementsSolidJs = {
|
|
|
80922
81182
|
*
|
|
80923
81183
|
* Names an element in the same tree. In React it arrives as a property, the
|
|
80924
81184
|
* way `Tooltip.for` does.
|
|
81185
|
+
* - `idle`: Whether no work is in progress. The loader draws nothing of its own, has
|
|
81186
|
+
* no role, and marks no region busy, and what is in the `content` slot
|
|
81187
|
+
* shows. Clearing it starts `delay` again.
|
|
80925
81188
|
* - `label`: The loader's name, announced by screen readers while the work is in
|
|
80926
81189
|
* progress.
|
|
80927
81190
|
* - `whenSettled`: Resolves a frame after the first update, when transitions are switched on.
|
|
@@ -80950,11 +81213,13 @@ export type CustomElementsSolidJs = {
|
|
|
80950
81213
|
* Areas where markup can be added to the component.
|
|
80951
81214
|
*
|
|
80952
81215
|
* - `(default)`: An icon or logo that stays still at the center. Empty by default.
|
|
81216
|
+
* - `content`: What the loader stands in for while the work runs, such as a button. It keeps its size, hidden and inert, until `idle` is set.
|
|
80953
81217
|
*
|
|
80954
81218
|
* ## CSS Parts
|
|
80955
81219
|
*
|
|
80956
81220
|
* Custom selectors for styling elements within the component.
|
|
80957
81221
|
*
|
|
81222
|
+
* - `content`: The box that holds the `content` slot. Hidden while the work runs, and shown while `idle` is set.
|
|
80958
81223
|
* - `indicator`: The arc that turns.
|
|
80959
81224
|
* - `mark`: The region that holds the slotted content at the center.
|
|
80960
81225
|
* - `svg`: The rotating circle pair.
|
|
@@ -83983,6 +84248,8 @@ export type CustomElementsSolidJs = {
|
|
|
83983
84248
|
* and shows the browser's message at the control.
|
|
83984
84249
|
* - `setCustomValidity(message: string) => void`: Marks the control invalid with `message`, or clears that with an empty
|
|
83985
84250
|
* string, as on a native control. The form does not submit while it is set.
|
|
84251
|
+
* - `formAssociatedCallback(form: HTMLFormElement | null) => void`: Called by the browser when the control's form changes: watches the new
|
|
84252
|
+
* form's `checkValidity()`, as connecting does for the form it starts in.
|
|
83986
84253
|
*
|
|
83987
84254
|
* ## CSS Parts
|
|
83988
84255
|
*
|
|
@@ -85167,6 +85434,8 @@ export type CustomElementsSolidJs = {
|
|
|
85167
85434
|
* - `setCustomValidity(message: string) => void`: Marks the control invalid with `message`, or clears that with an empty
|
|
85168
85435
|
* string, as on a native control. The form does not submit while it is set.
|
|
85169
85436
|
* - `focus(options?: FocusOptions) => void`: Moves focus to the control, as focusing a native control does.
|
|
85437
|
+
* - `formAssociatedCallback(form: HTMLFormElement | null) => void`: Called by the browser when the control's form changes: watches the new
|
|
85438
|
+
* form's `checkValidity()`, as connecting does for the form it starts in.
|
|
85170
85439
|
*
|
|
85171
85440
|
* ## CSS Parts
|
|
85172
85441
|
*
|
|
@@ -85549,6 +85818,8 @@ export type CustomElementsSolidJs = {
|
|
|
85549
85818
|
* and shows the browser's message at the control.
|
|
85550
85819
|
* - `setCustomValidity(message: string) => void`: Marks the control invalid with `message`, or clears that with an empty
|
|
85551
85820
|
* string, as on a native control. The form does not submit while it is set.
|
|
85821
|
+
* - `formAssociatedCallback(form: HTMLFormElement | null) => void`: Called by the browser when the control's form changes: watches the new
|
|
85822
|
+
* form's `checkValidity()`, as connecting does for the form it starts in.
|
|
85552
85823
|
*
|
|
85553
85824
|
* ## CSS Parts
|
|
85554
85825
|
*
|
|
@@ -86419,6 +86690,8 @@ export type CustomElementsSolidJs = {
|
|
|
86419
86690
|
* - `setCustomValidity(message: string) => void`: Marks the control invalid with `message`, or clears that with an empty
|
|
86420
86691
|
* string, as on a native control. The form does not submit while it is set.
|
|
86421
86692
|
* - `focus(options?: FocusOptions) => void`: Moves focus to the control, as focusing a native control does.
|
|
86693
|
+
* - `formAssociatedCallback(form: HTMLFormElement | null) => void`: Called by the browser when the control's form changes: watches the new
|
|
86694
|
+
* form's `checkValidity()`, as connecting does for the form it starts in.
|
|
86422
86695
|
*
|
|
86423
86696
|
* ## CSS Parts
|
|
86424
86697
|
*
|
|
@@ -86607,7 +86880,8 @@ export type CustomElementsSolidJs = {
|
|
|
86607
86880
|
*
|
|
86608
86881
|
* Left and Right swap on a right-to-left page. The marks are a `radiogroup`
|
|
86609
86882
|
* named by `label`, and each score is a `radio` named by `option-label`, such
|
|
86610
|
-
* as "3 out of 5". A read-only rating is one `img` named by its
|
|
86883
|
+
* as "3 out of 5". A read-only rating is one `img` named by its label and
|
|
86884
|
+
* then its score, such as "Quality 3 out of 5".
|
|
86611
86885
|
*
|
|
86612
86886
|
* ## Attributes & Properties
|
|
86613
86887
|
*
|
|
@@ -86856,6 +87130,8 @@ export type CustomElementsSolidJs = {
|
|
|
86856
87130
|
* - `setCustomValidity(message: string) => void`: Marks the control invalid with `message`, or clears that with an empty
|
|
86857
87131
|
* string, as on a native control. The form does not submit while it is set.
|
|
86858
87132
|
* - `focus(options?: FocusOptions) => void`: Moves focus to the control, as focusing a native control does.
|
|
87133
|
+
* - `formAssociatedCallback(form: HTMLFormElement | null) => void`: Called by the browser when the control's form changes: watches the new
|
|
87134
|
+
* form's `checkValidity()`, as connecting does for the form it starts in.
|
|
86859
87135
|
*
|
|
86860
87136
|
* ## CSS Custom Properties
|
|
86861
87137
|
*
|
|
@@ -86918,10 +87194,10 @@ export type CustomElementsSolidJs = {
|
|
|
86918
87194
|
* readers.
|
|
86919
87195
|
*
|
|
86920
87196
|
* **The plot is read by key.** It takes focus, named by `label` or the caption.
|
|
86921
|
-
* The left and right arrows move from
|
|
86922
|
-
* and End go to the first and the last, and the up and down
|
|
86923
|
-
* the series of a row. The tooltip sits on that point, the
|
|
86924
|
-
* row in words, and Escape puts the tooltip away.
|
|
87197
|
+
* The left and right arrows move from point to point, left to right across
|
|
87198
|
+
* the plot, Home and End go to the first and the last, and the up and down
|
|
87199
|
+
* arrows move among the series of a row. The tooltip sits on that point, the
|
|
87200
|
+
* `live` part says the row in words, and Escape puts the tooltip away.
|
|
86925
87201
|
*
|
|
86926
87202
|
* Each point is a `<span>` placed by percentage over the drawing, as
|
|
86927
87203
|
* `LineChart` places its end points, so points stay round when the drawing
|
|
@@ -86948,6 +87224,18 @@ export type CustomElementsSolidJs = {
|
|
|
86948
87224
|
* there until readings arrive. The `empty` and `loading` slots take markup in
|
|
86949
87225
|
* their place, such as a link to add the first reading.
|
|
86950
87226
|
*
|
|
87227
|
+
* **Keyboard.** The plot is one tab stop.
|
|
87228
|
+
*
|
|
87229
|
+
* | Key | What it does |
|
|
87230
|
+
* |---|---|
|
|
87231
|
+
* | Tab | Moves focus to the plot and shows the first reading. |
|
|
87232
|
+
* | Right, Left | Moves to the next or the previous point, left to right across the plot. On a right-to-left page, Left moves to the next. |
|
|
87233
|
+
* | Down, Up | Moves among the series of the point. With one series, moves to the next or the previous point. |
|
|
87234
|
+
* | Home, End | Moves to the first or the last point. |
|
|
87235
|
+
* | Page Down, Page Up | Moves a tenth of the points on or back. |
|
|
87236
|
+
* | Enter, Space | Presses the point shown, which sends `helix-reading-press`. |
|
|
87237
|
+
* | Escape | Puts the point and its tooltip away. |
|
|
87238
|
+
*
|
|
86951
87239
|
* ## Attributes & Properties
|
|
86952
87240
|
*
|
|
86953
87241
|
* Component attributes and properties that can be applied to the element or by using JavaScript.
|
|
@@ -87017,12 +87305,6 @@ export type CustomElementsSolidJs = {
|
|
|
87017
87305
|
* Set it to the words of the page's language, such as `{position} von
|
|
87018
87306
|
* {count}`, or to nothing to say no position. A slice or a series a
|
|
87019
87307
|
* legend hid is not counted.
|
|
87020
|
-
* - `pointer`: Finds the reading nearest the pointer, so the tooltip can sit on it.
|
|
87021
|
-
*
|
|
87022
|
-
* Public for the same reason `series` and `named` are: a protected member
|
|
87023
|
-
* cannot be cast onto across unrelated classes, so it would be invisible to
|
|
87024
|
-
* every chart that needs it. Reading where a pointer is resting is a fair
|
|
87025
|
-
* thing to ask a chart anyway. (property only) (readonly)
|
|
87026
87308
|
* - `data`: The readings as data, in the shape of a table, where the page has no
|
|
87027
87309
|
* table to point `for` at. `for` wins where both are set.
|
|
87028
87310
|
*
|
|
@@ -87061,21 +87343,6 @@ export type CustomElementsSolidJs = {
|
|
|
87061
87343
|
* names an element, and the chart is a generic around its plot: written
|
|
87062
87344
|
* on the host, the name reached nobody. The plot takes it, as Heatmap's
|
|
87063
87345
|
* strip always did. (property only) (readonly)
|
|
87064
|
-
* - `readingsKnown`: Whether the readings have been looked for: false on the server and
|
|
87065
|
-
* while hydrating, where no table is resolved and no data is read. A
|
|
87066
|
-
* chart says it has no readings only once this is true. (property only) (readonly)
|
|
87067
|
-
* - `sourceRows`: Every row of the table, with each cell's text and number.
|
|
87068
|
-
*
|
|
87069
|
-
* This is where a tooltip's content comes from, and it is deliberately not
|
|
87070
|
-
* `series`. A chart draws numbers; a reader resting a pointer on one wants
|
|
87071
|
-
* what the table says, which is `$128k` and not `128000`, and often wants
|
|
87072
|
-
* the column beside it that nothing plotted at all.
|
|
87073
|
-
*
|
|
87074
|
-
* **Not `rows`.** It is the source table's rows, and `rows` on a chart is a
|
|
87075
|
-
* name a chart wants for itself: `helix-heatmap` takes `rows="7"` to mean a
|
|
87076
|
-
* calendar week, and declaring that against a base class whose `rows` is a
|
|
87077
|
-
* `Row[]` getter is a type error at best. Name the member for what it holds
|
|
87078
|
-
* rather than for the shortest word available. (property only) (readonly)
|
|
87079
87346
|
* - `plottedColumns`: The positions of the cells in a row that hold numbers, in table order.
|
|
87080
87347
|
*
|
|
87081
87348
|
* The same test `readSeries` applies when it drops a column of notes: a
|
|
@@ -87134,8 +87401,6 @@ export type CustomElementsSolidJs = {
|
|
|
87134
87401
|
* The across gets no dot at all rather than a shifted one. It is an axis and
|
|
87135
87402
|
* not a series: it has a scale under the plot with its name at the end of it,
|
|
87136
87403
|
* which is where a reader is told what it is.
|
|
87137
|
-
* - `attributeChangedCallback(name: string, old: string | null, value: string | null) => void`: Called by the browser when an observed attribute changes. A new
|
|
87138
|
-
* `aria-label` asks for an update, because it names the plot.
|
|
87139
87404
|
* - `showsSeries(name: string) => boolean`: Whether the series of this name is drawn, which it is unless a legend
|
|
87140
87405
|
* reading the same table hid it.
|
|
87141
87406
|
*
|
|
@@ -87172,11 +87437,12 @@ export type CustomElementsSolidJs = {
|
|
|
87172
87437
|
* - `loading`: The words in place of the drawing while `loading` is set and there are no readings: the `loading` slot, falling back to `loading-text`.
|
|
87173
87438
|
* - `mark`: The invisible point the tooltip is anchored to.
|
|
87174
87439
|
* - `plane`: The grid that holds the plot, both axes, and their names. It runs left to right on every page.
|
|
87175
|
-
* - `plot`: The drawing, which takes focus to be read by key.
|
|
87440
|
+
* - `plot`: The drawing, which takes focus to be read by key. With nothing to draw, a group named as the chart is, holding the `empty` or `loading` part.
|
|
87176
87441
|
* - `point`: One row, as a point.
|
|
87177
87442
|
* - `point-active`: A point in the row under the pointer. Set alongside `point`.
|
|
87178
87443
|
* - `summary`: The text that says how strongly the measures relate, for people who cannot see the points.
|
|
87179
87444
|
* - `svg`: The drawing surface the gridlines and the trend lines sit on.
|
|
87445
|
+
* - `table`: The readings as a table, for a screen reader, rendered only where they were drawn from `data`. Hide it visually.
|
|
87180
87446
|
* - `tooltip`: The bubble, forwarded from `Tooltip`.
|
|
87181
87447
|
* - `tooltip-anchor`: The `Tooltip` element itself.
|
|
87182
87448
|
* - `tooltip-arrow`: The bubble's point, forwarded from `Tooltip`.
|
|
@@ -87196,7 +87462,7 @@ export type CustomElementsSolidJs = {
|
|
|
87196
87462
|
* - `trend`: One series' line of best fit, under `trend`. Carries its series color as `--chart-series`.
|
|
87197
87463
|
* - `x-axis`: The values along the horizontal axis, under the plot.
|
|
87198
87464
|
* - `x-name`: The name of the horizontal measure.
|
|
87199
|
-
* - `x-tick`: One labeled value on the horizontal axis. Each axis has its own tick part, because `::part()` cannot tell which axis a tick is on.
|
|
87465
|
+
* - `x-tick`: One labeled value on the horizontal axis. Each axis has its own tick part, because `::part()` cannot tell which axis a tick is on. The one at the far edge carries `data-edge="end"`.
|
|
87200
87466
|
* - `y-axis`: The values along the vertical axis, beside the plot.
|
|
87201
87467
|
* - `y-name`: The name of the vertical measure.
|
|
87202
87468
|
* - `y-tick`: One labeled value on the vertical axis.
|
|
@@ -87205,6 +87471,9 @@ export type CustomElementsSolidJs = {
|
|
|
87205
87471
|
*
|
|
87206
87472
|
* These can be used to apply styling when a component is in a given state.
|
|
87207
87473
|
*
|
|
87474
|
+
* - `active`: While a reading is shown, under the pointer or the keys, with its tooltip open.
|
|
87475
|
+
* - `empty`: While the `empty` part stands in the plot.
|
|
87476
|
+
* - `loading`: While the `loading` part stands in the plot.
|
|
87208
87477
|
* - `settled`: Set one frame after the first render. Transitions wait for it, so an element does not animate its own arrival.
|
|
87209
87478
|
*/
|
|
87210
87479
|
"helix-headless-scatter-chart": Partial<
|
|
@@ -87368,7 +87637,9 @@ export type CustomElementsSolidJs = {
|
|
|
87368
87637
|
* place for focus to return to when the list closes.
|
|
87369
87638
|
*
|
|
87370
87639
|
* Your options stay in your light DOM and are slotted through into the listbox,
|
|
87371
|
-
* so the listbox looks through slots to find them.
|
|
87640
|
+
* so the listbox looks through slots to find them. Write them as `Option`,
|
|
87641
|
+
* group them in `Option.Group`, and divide them with `Option.Separator`.
|
|
87642
|
+
* Importing Select registers all three in the same tier. For a list too long to draw
|
|
87372
87643
|
* whole, set `items` instead: the list draws only the options in sight, as
|
|
87373
87644
|
* Listbox's `items` does, and the trigger, its keys and the form read the
|
|
87374
87645
|
* whole set.
|
|
@@ -87679,6 +87950,8 @@ export type CustomElementsSolidJs = {
|
|
|
87679
87950
|
* and shows the browser's message at the control.
|
|
87680
87951
|
* - `setCustomValidity(message: string) => void`: Marks the control invalid with `message`, or clears that with an empty
|
|
87681
87952
|
* string, as on a native control. The form does not submit while it is set.
|
|
87953
|
+
* - `formAssociatedCallback(form: HTMLFormElement | null) => void`: Called by the browser when the control's form changes: watches the new
|
|
87954
|
+
* form's `checkValidity()`, as connecting does for the form it starts in.
|
|
87682
87955
|
*
|
|
87683
87956
|
* ## CSS Custom Properties
|
|
87684
87957
|
*
|
|
@@ -88207,6 +88480,8 @@ export type CustomElementsSolidJs = {
|
|
|
88207
88480
|
* - `setCustomValidity(message: string) => void`: Marks the control invalid with `message`, or clears that with an empty
|
|
88208
88481
|
* string, as on a native control. The form does not submit while it is set.
|
|
88209
88482
|
* - `focus(options?: FocusOptions) => void`: Moves focus to the control, as focusing a native control does.
|
|
88483
|
+
* - `formAssociatedCallback(form: HTMLFormElement | null) => void`: Called by the browser when the control's form changes: watches the new
|
|
88484
|
+
* form's `checkValidity()`, as connecting does for the form it starts in.
|
|
88210
88485
|
*
|
|
88211
88486
|
* ## CSS Custom Properties
|
|
88212
88487
|
*
|
|
@@ -88273,6 +88548,10 @@ export type CustomElementsSolidJs = {
|
|
|
88273
88548
|
* the lowest, in `overview-label`: "From 12 to 20, highest 30, lowest 8". An
|
|
88274
88549
|
* `aria-label` on the element names it as `label` does.
|
|
88275
88550
|
*
|
|
88551
|
+
* `helix-reading-change` says each move of the reading, by pointer, tap or
|
|
88552
|
+
* key, and `helix-reading-press` says a reading was clicked, tapped, or pressed
|
|
88553
|
+
* with Enter or Space, as on every chart.
|
|
88554
|
+
*
|
|
88276
88555
|
* A pointer resting on the drawing shows the reading under it: the `cursor`
|
|
88277
88556
|
* part marks it and the `readout` part writes it. `marks` adds a mark on the
|
|
88278
88557
|
* highest and the lowest reading, and `range` draws a band between two values,
|
|
@@ -88287,6 +88566,17 @@ export type CustomElementsSolidJs = {
|
|
|
88287
88566
|
* the component computes and CSS cannot, so a stylesheet can draw the sparkline
|
|
88288
88567
|
* without measuring anything.
|
|
88289
88568
|
*
|
|
88569
|
+
* **Keyboard.** A sparkline with a `label` is one tab stop.
|
|
88570
|
+
*
|
|
88571
|
+
* | Key | What it does |
|
|
88572
|
+
* |---|---|
|
|
88573
|
+
* | Tab | Moves focus to the drawing and shows the first reading, where there is a `label`. |
|
|
88574
|
+
* | Any arrow | Right and Down move to the next reading, Left and Up to the previous. On a right-to-left page, Left moves to the next. |
|
|
88575
|
+
* | Home, End | Moves to the first or the last reading. |
|
|
88576
|
+
* | Page Down, Page Up | Moves a tenth of the readings on or back. |
|
|
88577
|
+
* | Enter, Space | Presses the reading shown, which sends `helix-reading-press`. |
|
|
88578
|
+
* | Escape | Puts the reading and its tooltip away. |
|
|
88579
|
+
*
|
|
88290
88580
|
* ## Attributes & Properties
|
|
88291
88581
|
*
|
|
88292
88582
|
* Component attributes and properties that can be applied to the element or by using JavaScript.
|
|
@@ -88391,8 +88681,6 @@ export type CustomElementsSolidJs = {
|
|
|
88391
88681
|
* with `values={[1240, 1318]}`. The attribute is the form to prefer, because
|
|
88392
88682
|
* a string is what survives React's hydration where an array property does
|
|
88393
88683
|
* not.
|
|
88394
|
-
* - `pointer`: Finds the reading a pointer or a key rests on, as it does for every
|
|
88395
|
-
* chart, so a sparkline is read the way they are. (property only) (readonly)
|
|
88396
88684
|
* - `named`: The drawing's name: an `aria-label` written on the sparkline, then `label`. (property only) (readonly)
|
|
88397
88685
|
* - `readings`: How many readings there are, which the pointer and the keys walk. (property only) (readonly)
|
|
88398
88686
|
* - `whenSettled`: Resolves a frame after the first update, when transitions are switched on.
|
|
@@ -88416,11 +88704,12 @@ export type CustomElementsSolidJs = {
|
|
|
88416
88704
|
* browser harness's awaits it alone: a browser always runs the frame, and a
|
|
88417
88705
|
* timer beside it was a bet on how long one takes, which a busy run lost. (property only) (readonly)
|
|
88418
88706
|
*
|
|
88419
|
-
* ##
|
|
88707
|
+
* ## Events
|
|
88420
88708
|
*
|
|
88421
|
-
*
|
|
88709
|
+
* Events that will be emitted by the component.
|
|
88422
88710
|
*
|
|
88423
|
-
* - `
|
|
88711
|
+
* - `helix-reading-change`: The reading shown moved, or was put away: `index` is the reading, or `-1` for none, with its row's `label` from a table and the `pointerType` that moved it.
|
|
88712
|
+
* - `helix-reading-press`: A reading was clicked, tapped, or pressed with Enter or Space, with the same detail as `helix-reading-change`.
|
|
88424
88713
|
*
|
|
88425
88714
|
* ## CSS Custom Properties
|
|
88426
88715
|
*
|
|
@@ -89770,6 +90059,8 @@ export type CustomElementsSolidJs = {
|
|
|
89770
90059
|
* - `setCustomValidity(message: string) => void`: Marks the control invalid with `message`, or clears that with an empty
|
|
89771
90060
|
* string, as on a native control. The form does not submit while it is set.
|
|
89772
90061
|
* - `focus(options?: FocusOptions) => void`: Moves focus to the control, as focusing a native control does.
|
|
90062
|
+
* - `formAssociatedCallback(form: HTMLFormElement | null) => void`: Called by the browser when the control's form changes: watches the new
|
|
90063
|
+
* form's `checkValidity()`, as connecting does for the form it starts in.
|
|
89773
90064
|
*
|
|
89774
90065
|
* ## CSS Parts
|
|
89775
90066
|
*
|
|
@@ -91058,8 +91349,9 @@ export type CustomElementsSolidJs = {
|
|
|
91058
91349
|
* - `selection-mode`/`selectionMode`: How many tags a reader can select: `single`, `multiple`, or none.
|
|
91059
91350
|
*
|
|
91060
91351
|
* Absent selects nothing, and the tags carry no selected state at all.
|
|
91061
|
-
* - `value`: The selected tags' values, separated by commas
|
|
91062
|
-
* space.
|
|
91352
|
+
* - `value`: The selected tags' values, separated by commas with no space, as Toggle
|
|
91353
|
+
* Group and Table write theirs, since a value may hold a space. A value
|
|
91354
|
+
* written with a space after each comma is read the same way.
|
|
91063
91355
|
*
|
|
91064
91356
|
* Set it to start with tags selected. A tag's value is its `value`, or its
|
|
91065
91357
|
* words where it has none.
|
|
@@ -91523,6 +91815,8 @@ export type CustomElementsSolidJs = {
|
|
|
91523
91815
|
* and shows the browser's message at the control.
|
|
91524
91816
|
* - `setCustomValidity(message: string) => void`: Marks the control invalid with `message`, or clears that with an empty
|
|
91525
91817
|
* string, as on a native control. The form does not submit while it is set.
|
|
91818
|
+
* - `formAssociatedCallback(form: HTMLFormElement | null) => void`: Called by the browser when the control's form changes: watches the new
|
|
91819
|
+
* form's `checkValidity()`, as connecting does for the form it starts in.
|
|
91526
91820
|
*
|
|
91527
91821
|
* ## CSS Parts
|
|
91528
91822
|
*
|
|
@@ -91666,7 +91960,13 @@ export type CustomElementsSolidJs = {
|
|
|
91666
91960
|
* - `trigger-label`/`triggerLabel`: The name of the button that opens the list, read by screen readers.
|
|
91667
91961
|
* - `unavailable-message`/`unavailableMessage`: The message shown when `disable-times` bars a time.
|
|
91668
91962
|
* - `unreadable-message`/`unreadableMessage`: The message for text that is no time, where `bad-input-message` is not
|
|
91669
|
-
* set. `{mode}` is `single`, `range`, or `multiple`,
|
|
91963
|
+
* set. `{mode}` is `single`, `range`, or `multiple`, `{example}` is a time
|
|
91964
|
+
* written as the field writes one, `2:30 PM` in `en-US` and `14:30` in
|
|
91965
|
+
* `de-DE`, and `{shape}` is `HH:mm`, or `HH:mm:ss` with `seconds`.
|
|
91966
|
+
*
|
|
91967
|
+
* **The default names a time the field reads back.** It said "Enter a time
|
|
91968
|
+
* as HH:mm." to a reader whose field showed `2:30 PM`, and a pattern token
|
|
91969
|
+
* is words for a developer.
|
|
91670
91970
|
* - `variant`: Whether the panel shows one list of times or a column for each part of the
|
|
91671
91971
|
* time.
|
|
91672
91972
|
*
|
|
@@ -91921,6 +92221,8 @@ export type CustomElementsSolidJs = {
|
|
|
91921
92221
|
* and shows the browser's message at the control.
|
|
91922
92222
|
* - `setCustomValidity(message: string) => void`: Marks the control invalid with `message`, or clears that with an empty
|
|
91923
92223
|
* string, as on a native control. The form does not submit while it is set.
|
|
92224
|
+
* - `formAssociatedCallback(form: HTMLFormElement | null) => void`: Called by the browser when the control's form changes: watches the new
|
|
92225
|
+
* form's `checkValidity()`, as connecting does for the form it starts in.
|
|
91924
92226
|
*
|
|
91925
92227
|
* ## CSS Parts
|
|
91926
92228
|
*
|
|
@@ -92407,6 +92709,8 @@ export type CustomElementsSolidJs = {
|
|
|
92407
92709
|
* and shows the browser's message at the control.
|
|
92408
92710
|
* - `setCustomValidity(message: string) => void`: Marks the control invalid with `message`, or clears that with an empty
|
|
92409
92711
|
* string, as on a native control. The form does not submit while it is set.
|
|
92712
|
+
* - `formAssociatedCallback(form: HTMLFormElement | null) => void`: Called by the browser when the control's form changes: watches the new
|
|
92713
|
+
* form's `checkValidity()`, as connecting does for the form it starts in.
|
|
92410
92714
|
*
|
|
92411
92715
|
* ## CSS Parts
|
|
92412
92716
|
*
|
|
@@ -93309,6 +93613,8 @@ export type CustomElementsSolidJs = {
|
|
|
93309
93613
|
* - `setCustomValidity(message: string) => void`: Marks the control invalid with `message`, or clears that with an empty
|
|
93310
93614
|
* string, as on a native control. The form does not submit while it is set.
|
|
93311
93615
|
* - `focus(options?: FocusOptions) => void`: Moves focus to the control, as focusing a native control does.
|
|
93616
|
+
* - `formAssociatedCallback(form: HTMLFormElement | null) => void`: Called by the browser when the control's form changes: watches the new
|
|
93617
|
+
* form's `checkValidity()`, as connecting does for the form it starts in.
|
|
93312
93618
|
*
|
|
93313
93619
|
* ## CSS Parts
|
|
93314
93620
|
*
|
|
@@ -94220,9 +94526,9 @@ export type CustomElementsSolidJs = {
|
|
|
94220
94526
|
* Each item is an element because it holds state: whether it is open, selected,
|
|
94221
94527
|
* and focused.
|
|
94222
94528
|
*
|
|
94223
|
-
* An item is a branch when
|
|
94224
|
-
*
|
|
94225
|
-
* appears on hydration.
|
|
94529
|
+
* An item is a branch when an item is slotted into `children`, with
|
|
94530
|
+
* `slot="children"` on each nested item. This is detected on the client, so
|
|
94531
|
+
* server-rendered markup shows a leaf and the twisty appears on hydration.
|
|
94226
94532
|
*
|
|
94227
94533
|
* **`href` makes the whole row a link**, rendered as an `<a>`. Enter, middle
|
|
94228
94534
|
* click, and the status bar then work anywhere on the row.
|
|
@@ -94344,7 +94650,7 @@ export type CustomElementsSolidJs = {
|
|
|
94344
94650
|
*
|
|
94345
94651
|
* Areas where markup can be added to the component.
|
|
94346
94652
|
*
|
|
94347
|
-
* - `(default)`: The item's label.
|
|
94653
|
+
* - `(default)`: The item's label. A nested item does not go here: give it `slot="children"`. In a development build, an item nested here is reported.
|
|
94348
94654
|
* - `chevron`: Replaces the expand and collapse mark of a branch, such as with your own icon.
|
|
94349
94655
|
* - `children`: Nested items, which make this a branch.
|
|
94350
94656
|
* - `end`: Content after the label, at the far side of the row, such as a count or a state.
|