@fusion.dev/helix 0.177.2 → 0.179.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/custom-elements.json +967 -88
- package/dist/aura/root/aura-root.css.js +5 -1
- package/dist/aura/root/aura-root.d.ts +33 -2
- package/dist/aura/root/aura-root.js +32 -3
- package/dist/badge/root/badge-root.css.js +1 -1
- package/dist/element-events.generated.js +8 -2
- package/dist/graph/root/graph-root.css.js +4 -2
- package/dist/heatmap/root/heatmap-root.css.js +4 -3
- package/dist/legend/root/legend-root.css.js +1 -1
- package/dist/line-chart/root/line-chart-root.css.js +1 -1
- package/dist/map/marker/map-marker.css.js +1 -1
- package/dist/map/position/map-position.css.js +3 -1
- package/dist/meter/root/meter-root.css.js +1 -1
- package/dist/rating/root/rating-root.css.js +2 -1
- package/dist/scatter-chart/root/scatter-chart-root.css.js +1 -1
- package/dist/shared/chart/terminus.css.js +1 -1
- package/dist/skeleton/root/skeleton-root.css.js +1 -1
- package/dist/sparkline/root/sparkline-root.css.js +4 -1
- package/lint.json +1 -1
- package/package.json +6 -6
- package/types/jsx.d.ts +368 -64
- package/types/vue.d.ts +87 -19
- package/types/words.d.ts +27 -0
package/types/jsx.d.ts
CHANGED
|
@@ -1696,6 +1696,14 @@ hit-testable at rest, or it would swallow clicks meant for what is over it,
|
|
|
1696
1696
|
and an element that is not hit-testable never receives the `pointermove`
|
|
1697
1697
|
this listens for. Asking for the pointer is asking for the hit test. */
|
|
1698
1698
|
interactive?: (HelixAura["interactive"]) | undefined;
|
|
1699
|
+
/** Whether the aura draws its own control that pauses the field and starts it
|
|
1700
|
+
again, in its trailing corner. Absent draws none, for a page with a pause
|
|
1701
|
+
control of its own. */
|
|
1702
|
+
"pause-control"?: (HelixAura["pauseControl"]) | undefined;
|
|
1703
|
+
/** Whether the aura draws its own control that pauses the field and starts it
|
|
1704
|
+
again, in its trailing corner. Absent draws none, for a page with a pause
|
|
1705
|
+
control of its own. */
|
|
1706
|
+
pauseControl?: (HelixAura["pauseControl"]) | undefined;
|
|
1699
1707
|
/** Whether the field holds still on the frame it shows.
|
|
1700
1708
|
|
|
1701
1709
|
Set it from a pause control on your page, so a reader can stop the motion,
|
|
@@ -1703,6 +1711,14 @@ as WCAG 2.2.2 asks of anything that moves for more than five seconds. A
|
|
|
1703
1711
|
change to another property still repaints the frame. Clearing it starts
|
|
1704
1712
|
the field from where it stopped. */
|
|
1705
1713
|
paused?: (HelixAura["paused"]) | undefined;
|
|
1714
|
+
/** The pause control's name, read by screen readers. The control is a toggle
|
|
1715
|
+
and says it is pressed while the field is paused, so the name stays the
|
|
1716
|
+
same. */
|
|
1717
|
+
"pause-label"?: (HelixAura["pauseLabel"]) | undefined;
|
|
1718
|
+
/** The pause control's name, read by screen readers. The control is a toggle
|
|
1719
|
+
and says it is pressed while the field is paused, so the name stays the
|
|
1720
|
+
same. */
|
|
1721
|
+
pauseLabel?: (HelixAura["pauseLabel"]) | undefined;
|
|
1706
1722
|
/** How far the pointer reaches into the field, `0` upward.
|
|
1707
1723
|
|
|
1708
1724
|
Multiplied into the presence the pointer already fades in and out with, so
|
|
@@ -1773,6 +1789,8 @@ look, which is what `variant` is for by the rule the registry already
|
|
|
1773
1789
|
states. */
|
|
1774
1790
|
variant?: (HelixAura["variant"]) | undefined;
|
|
1775
1791
|
|
|
1792
|
+
/** Fired when the aura's own pause control pauses the field or starts it again. */
|
|
1793
|
+
onchange?: ((e: HelixAuraElementEvent) => void) | undefined;
|
|
1776
1794
|
/** Fired each time the aura stops drawing its shader and shows its gradient, with the reason. */
|
|
1777
1795
|
"onhelix-aura-fallback"?: ((e: HelixAuraHelixAuraFallbackElementEvent) => void) | undefined;
|
|
1778
1796
|
};
|
|
@@ -1815,6 +1833,14 @@ hit-testable at rest, or it would swallow clicks meant for what is over it,
|
|
|
1815
1833
|
and an element that is not hit-testable never receives the `pointermove`
|
|
1816
1834
|
this listens for. Asking for the pointer is asking for the hit test. */
|
|
1817
1835
|
"prop:interactive"?: (HelixAura["interactive"]) | undefined;
|
|
1836
|
+
/** Whether the aura draws its own control that pauses the field and starts it
|
|
1837
|
+
again, in its trailing corner. Absent draws none, for a page with a pause
|
|
1838
|
+
control of its own. */
|
|
1839
|
+
"bool:pause-control"?: (HelixAura["pauseControl"]) | undefined;
|
|
1840
|
+
/** Whether the aura draws its own control that pauses the field and starts it
|
|
1841
|
+
again, in its trailing corner. Absent draws none, for a page with a pause
|
|
1842
|
+
control of its own. */
|
|
1843
|
+
"prop:pauseControl"?: (HelixAura["pauseControl"]) | undefined;
|
|
1818
1844
|
/** Whether the field holds still on the frame it shows.
|
|
1819
1845
|
|
|
1820
1846
|
Set it from a pause control on your page, so a reader can stop the motion,
|
|
@@ -1822,6 +1848,14 @@ as WCAG 2.2.2 asks of anything that moves for more than five seconds. A
|
|
|
1822
1848
|
change to another property still repaints the frame. Clearing it starts
|
|
1823
1849
|
the field from where it stopped. */
|
|
1824
1850
|
"prop:paused"?: (HelixAura["paused"]) | undefined;
|
|
1851
|
+
/** The pause control's name, read by screen readers. The control is a toggle
|
|
1852
|
+
and says it is pressed while the field is paused, so the name stays the
|
|
1853
|
+
same. */
|
|
1854
|
+
"attr:pause-label"?: (HelixAura["pauseLabel"]) | undefined;
|
|
1855
|
+
/** The pause control's name, read by screen readers. The control is a toggle
|
|
1856
|
+
and says it is pressed while the field is paused, so the name stays the
|
|
1857
|
+
same. */
|
|
1858
|
+
"prop:pauseLabel"?: (HelixAura["pauseLabel"]) | undefined;
|
|
1825
1859
|
/** How far the pointer reaches into the field, `0` upward.
|
|
1826
1860
|
|
|
1827
1861
|
Multiplied into the presence the pointer already fades in and out with, so
|
|
@@ -1891,6 +1925,8 @@ Aurora, braid and caustics are not geometries; they are eleven names for a
|
|
|
1891
1925
|
look, which is what `variant` is for by the rule the registry already
|
|
1892
1926
|
states. */
|
|
1893
1927
|
"prop:variant"?: (HelixAura["variant"]) | undefined;
|
|
1928
|
+
/** Fired when the aura's own pause control pauses the field or starts it again. */
|
|
1929
|
+
"on:change"?: ((e: HelixAuraElementEvent) => void) | undefined;
|
|
1894
1930
|
/** Fired each time the aura stops drawing its shader and shows its gradient, with the reason. */
|
|
1895
1931
|
"on:helix-aura-fallback"?: ((
|
|
1896
1932
|
e: HelixAuraHelixAuraFallbackElementEvent,
|
|
@@ -16129,6 +16165,14 @@ an icon. */
|
|
|
16129
16165
|
/** The name of the clear button, read by screen readers. The button shows only
|
|
16130
16166
|
an icon. */
|
|
16131
16167
|
clearLabel?: (HelixFilterInput["clearLabel"]) | undefined;
|
|
16168
|
+
/** How long typing rests before `source` is asked, in milliseconds. A delay
|
|
16169
|
+
sends one request for a word in place of one for each letter. The arrow
|
|
16170
|
+
keys and Enter ask at once. `0` asks on every keystroke. */
|
|
16171
|
+
"filter-delay"?: (HelixFilterInput["filterDelay"] | `${number}`) | undefined;
|
|
16172
|
+
/** How long typing rests before `source` is asked, in milliseconds. A delay
|
|
16173
|
+
sends one request for a word in place of one for each letter. The arrow
|
|
16174
|
+
keys and Enter ask at once. `0` asks on every keystroke. */
|
|
16175
|
+
filterDelay?: (HelixFilterInput["filterDelay"]) | undefined;
|
|
16132
16176
|
/** Whether the panel narrows itself to the suggestions that hold the term
|
|
16133
16177
|
being typed, as React Aria's Autocomplete filters. Off, the panel shows
|
|
16134
16178
|
what you slot and you narrow it. */
|
|
@@ -16206,6 +16250,13 @@ imperatively later, and nothing is hydrating by then.
|
|
|
16206
16250
|
|
|
16207
16251
|
Here rather than on each control. */
|
|
16208
16252
|
name?: (HelixFilterInput["name"]) | undefined;
|
|
16253
|
+
/** Where the suggestions come from: a function given the term at the caret,
|
|
16254
|
+
the field it is a value of, the whole text, and an `AbortSignal`, which
|
|
16255
|
+
returns the suggestions or a promise of them. Each is a string, or a
|
|
16256
|
+
`value` with a `label` and `disabled`. The field draws them as options in
|
|
16257
|
+
the panel, beside any you slot. A property only, there being no way to
|
|
16258
|
+
write a function in markup. See the class description. */
|
|
16259
|
+
source?: (HelixFilterInput["source"]) | undefined;
|
|
16209
16260
|
|
|
16210
16261
|
/** Fired when the suggestions panel opens or closes, with `newState` and `oldState`. */
|
|
16211
16262
|
ontoggle?: ((e: HelixFilterInputToggleElementEvent) => void) | undefined;
|
|
@@ -16227,7 +16278,7 @@ Here rather than on each control. */
|
|
|
16227
16278
|
"onhelix-dismiss"?: ((e: HelixFilterInputHelixDismissElementEvent) => void) | undefined;
|
|
16228
16279
|
/** Fired when a filter changes, whether it was typed, picked, or removed. Cancelable: call `preventDefault()` to leave the text and the chip as they were. */
|
|
16229
16280
|
"onhelix-facet"?: ((e: HelixFilterInputHelixFacetElementEvent) => void) | undefined;
|
|
16230
|
-
/** Fired by an option in `suggestions` when it is chosen, and bubbles out of the field. Cancelable: call `preventDefault()` to stop other listeners acting on it. The field takes no action on
|
|
16281
|
+
/** Fired by an option in `suggestions` when it is chosen, and bubbles out of the field. Cancelable: call `preventDefault()` to stop other listeners acting on it. The field takes no action on an option you slotted, and you decide what it does. A suggestion from `source` is written over the term at the caret unless you cancel it. */
|
|
16231
16282
|
"onhelix-select"?: ((e: HelixFilterInputHelixSelectElementEvent) => void) | undefined;
|
|
16232
16283
|
/** Fired when the text changes. */
|
|
16233
16284
|
oninput?: ((e: HelixFilterInputElementEvent) => void) | undefined;
|
|
@@ -16375,6 +16426,14 @@ an icon. */
|
|
|
16375
16426
|
/** The name of the clear button, read by screen readers. The button shows only
|
|
16376
16427
|
an icon. */
|
|
16377
16428
|
"prop:clearLabel"?: (HelixFilterInput["clearLabel"]) | undefined;
|
|
16429
|
+
/** How long typing rests before `source` is asked, in milliseconds. A delay
|
|
16430
|
+
sends one request for a word in place of one for each letter. The arrow
|
|
16431
|
+
keys and Enter ask at once. `0` asks on every keystroke. */
|
|
16432
|
+
"attr:filter-delay"?: (HelixFilterInput["filterDelay"] | `${number}`) | undefined;
|
|
16433
|
+
/** How long typing rests before `source` is asked, in milliseconds. A delay
|
|
16434
|
+
sends one request for a word in place of one for each letter. The arrow
|
|
16435
|
+
keys and Enter ask at once. `0` asks on every keystroke. */
|
|
16436
|
+
"prop:filterDelay"?: (HelixFilterInput["filterDelay"]) | undefined;
|
|
16378
16437
|
/** Whether the panel narrows itself to the suggestions that hold the term
|
|
16379
16438
|
being typed, as React Aria's Autocomplete filters. Off, the panel shows
|
|
16380
16439
|
what you slot and you narrow it. */
|
|
@@ -16452,6 +16511,13 @@ imperatively later, and nothing is hydrating by then.
|
|
|
16452
16511
|
|
|
16453
16512
|
Here rather than on each control. */
|
|
16454
16513
|
"prop:name"?: (HelixFilterInput["name"]) | undefined;
|
|
16514
|
+
/** Where the suggestions come from: a function given the term at the caret,
|
|
16515
|
+
the field it is a value of, the whole text, and an `AbortSignal`, which
|
|
16516
|
+
returns the suggestions or a promise of them. Each is a string, or a
|
|
16517
|
+
`value` with a `label` and `disabled`. The field draws them as options in
|
|
16518
|
+
the panel, beside any you slot. A property only, there being no way to
|
|
16519
|
+
write a function in markup. See the class description. */
|
|
16520
|
+
"prop:source"?: (HelixFilterInput["source"]) | undefined;
|
|
16455
16521
|
/** Fired when the suggestions panel opens or closes, with `newState` and `oldState`. */
|
|
16456
16522
|
"on:toggle"?: ((e: HelixFilterInputToggleElementEvent) => void) | undefined;
|
|
16457
16523
|
/** Fired from the input when the user finishes editing the text. */
|
|
@@ -16472,7 +16538,7 @@ Here rather than on each control. */
|
|
|
16472
16538
|
"on:helix-dismiss"?: ((e: HelixFilterInputHelixDismissElementEvent) => void) | undefined;
|
|
16473
16539
|
/** Fired when a filter changes, whether it was typed, picked, or removed. Cancelable: call `preventDefault()` to leave the text and the chip as they were. */
|
|
16474
16540
|
"on:helix-facet"?: ((e: HelixFilterInputHelixFacetElementEvent) => void) | undefined;
|
|
16475
|
-
/** Fired by an option in `suggestions` when it is chosen, and bubbles out of the field. Cancelable: call `preventDefault()` to stop other listeners acting on it. The field takes no action on
|
|
16541
|
+
/** Fired by an option in `suggestions` when it is chosen, and bubbles out of the field. Cancelable: call `preventDefault()` to stop other listeners acting on it. The field takes no action on an option you slotted, and you decide what it does. A suggestion from `source` is written over the term at the caret unless you cancel it. */
|
|
16476
16542
|
"on:helix-select"?: ((e: HelixFilterInputHelixSelectElementEvent) => void) | undefined;
|
|
16477
16543
|
/** Fired when the text changes. */
|
|
16478
16544
|
"on:input"?: ((e: HelixFilterInputElementEvent) => void) | undefined;
|
|
@@ -17198,6 +17264,14 @@ or hides its notes. Drawn where the notes have two groups or more. */
|
|
|
17198
17264
|
"legend-label"?: (HelixGraph["legendLabel"]) | undefined;
|
|
17199
17265
|
/** The legend's name, read by screen readers. */
|
|
17200
17266
|
legendLabel?: (HelixGraph["legendLabel"]) | undefined;
|
|
17267
|
+
/** What screen readers hear when a walk along the links reaches a note that
|
|
17268
|
+
has no link to follow, or goes back to a note: `{note}` for its name and
|
|
17269
|
+
`{count}` for how many notes the list holds that it links to or from. */
|
|
17270
|
+
"link-count-label"?: (HelixGraph["linkCountLabel"]) | undefined;
|
|
17271
|
+
/** What screen readers hear when a walk along the links reaches a note that
|
|
17272
|
+
has no link to follow, or goes back to a note: `{note}` for its name and
|
|
17273
|
+
`{count}` for how many notes the list holds that it links to or from. */
|
|
17274
|
+
linkCountLabel?: (HelixGraph["linkCountLabel"]) | undefined;
|
|
17201
17275
|
/** How a note linked both to and from the selected one is described, with `{note}`. */
|
|
17202
17276
|
"linked-both-label"?: (HelixGraph["linkedBothLabel"]) | undefined;
|
|
17203
17277
|
/** How a note linked both to and from the selected one is described, with `{note}`. */
|
|
@@ -17277,6 +17351,16 @@ the list then holds, written with `count-label`. */
|
|
|
17277
17351
|
"using-label"?: (HelixGraph["usingLabel"]) | undefined;
|
|
17278
17352
|
/** The line shown while the graph, with `gestures="activate"`, has the gestures. */
|
|
17279
17353
|
usingLabel?: (HelixGraph["usingLabel"]) | undefined;
|
|
17354
|
+
/** What screen readers hear when a walk along the links moves to a note:
|
|
17355
|
+
`{note}` for its name, `{relation}` for how it stands to the note the
|
|
17356
|
+
step came from, such as "Linked from Roadmap", and `{index}` and `{count}`
|
|
17357
|
+
for its place among that note's links. */
|
|
17358
|
+
"walk-label"?: (HelixGraph["walkLabel"]) | undefined;
|
|
17359
|
+
/** What screen readers hear when a walk along the links moves to a note:
|
|
17360
|
+
`{note}` for its name, `{relation}` for how it stands to the note the
|
|
17361
|
+
step came from, such as "Linked from Roadmap", and `{index}` and `{count}`
|
|
17362
|
+
for its place among that note's links. */
|
|
17363
|
+
walkLabel?: (HelixGraph["walkLabel"]) | undefined;
|
|
17280
17364
|
/** The hint shown when the wheel scrolls past the graph with
|
|
17281
17365
|
`gestures="cooperative"`. `{key}` is ⌘ on a Mac and Ctrl elsewhere. */
|
|
17282
17366
|
"wheel-hint-label"?: (HelixGraph["wheelHintLabel"]) | undefined;
|
|
@@ -17320,7 +17404,7 @@ markup. */
|
|
|
17320
17404
|
"onhelix-graph-layout"?: ((e: HelixGraphHelixGraphLayoutElementEvent) => void) | undefined;
|
|
17321
17405
|
/** A pan button or arrow key was pressed. `connectGraph` moves the drawing, then calls `moved()`. */
|
|
17322
17406
|
"onhelix-graph-pan"?: ((e: HelixGraphHelixGraphPanElementEvent) => void) | undefined;
|
|
17323
|
-
/** The notes, the links, the selection, the depth or the gestures changed. Used by `connectGraph`; pages do not need to listen for it. */
|
|
17407
|
+
/** The notes, the links, the selection, the depth, the note the keys are on, or the gestures changed. Used by `connectGraph`; pages do not need to listen for it. */
|
|
17324
17408
|
"onhelix-graph-part-change"?: ((
|
|
17325
17409
|
e: HelixGraphHelixGraphPartChangeElementEvent,
|
|
17326
17410
|
) => void) | undefined;
|
|
@@ -17525,6 +17609,14 @@ or hides its notes. Drawn where the notes have two groups or more. */
|
|
|
17525
17609
|
"attr:legend-label"?: (HelixGraph["legendLabel"]) | undefined;
|
|
17526
17610
|
/** The legend's name, read by screen readers. */
|
|
17527
17611
|
"prop:legendLabel"?: (HelixGraph["legendLabel"]) | undefined;
|
|
17612
|
+
/** What screen readers hear when a walk along the links reaches a note that
|
|
17613
|
+
has no link to follow, or goes back to a note: `{note}` for its name and
|
|
17614
|
+
`{count}` for how many notes the list holds that it links to or from. */
|
|
17615
|
+
"attr:link-count-label"?: (HelixGraph["linkCountLabel"]) | undefined;
|
|
17616
|
+
/** What screen readers hear when a walk along the links reaches a note that
|
|
17617
|
+
has no link to follow, or goes back to a note: `{note}` for its name and
|
|
17618
|
+
`{count}` for how many notes the list holds that it links to or from. */
|
|
17619
|
+
"prop:linkCountLabel"?: (HelixGraph["linkCountLabel"]) | undefined;
|
|
17528
17620
|
/** How a note linked both to and from the selected one is described, with `{note}`. */
|
|
17529
17621
|
"attr:linked-both-label"?: (HelixGraph["linkedBothLabel"]) | undefined;
|
|
17530
17622
|
/** How a note linked both to and from the selected one is described, with `{note}`. */
|
|
@@ -17604,6 +17696,16 @@ the list then holds, written with `count-label`. */
|
|
|
17604
17696
|
"attr:using-label"?: (HelixGraph["usingLabel"]) | undefined;
|
|
17605
17697
|
/** The line shown while the graph, with `gestures="activate"`, has the gestures. */
|
|
17606
17698
|
"prop:usingLabel"?: (HelixGraph["usingLabel"]) | undefined;
|
|
17699
|
+
/** What screen readers hear when a walk along the links moves to a note:
|
|
17700
|
+
`{note}` for its name, `{relation}` for how it stands to the note the
|
|
17701
|
+
step came from, such as "Linked from Roadmap", and `{index}` and `{count}`
|
|
17702
|
+
for its place among that note's links. */
|
|
17703
|
+
"attr:walk-label"?: (HelixGraph["walkLabel"]) | undefined;
|
|
17704
|
+
/** What screen readers hear when a walk along the links moves to a note:
|
|
17705
|
+
`{note}` for its name, `{relation}` for how it stands to the note the
|
|
17706
|
+
step came from, such as "Linked from Roadmap", and `{index}` and `{count}`
|
|
17707
|
+
for its place among that note's links. */
|
|
17708
|
+
"prop:walkLabel"?: (HelixGraph["walkLabel"]) | undefined;
|
|
17607
17709
|
/** The hint shown when the wheel scrolls past the graph with
|
|
17608
17710
|
`gestures="cooperative"`. `{key}` is ⌘ on a Mac and Ctrl elsewhere. */
|
|
17609
17711
|
"attr:wheel-hint-label"?: (HelixGraph["wheelHintLabel"]) | undefined;
|
|
@@ -17646,7 +17748,7 @@ markup. */
|
|
|
17646
17748
|
"on:helix-graph-layout"?: ((e: HelixGraphHelixGraphLayoutElementEvent) => void) | undefined;
|
|
17647
17749
|
/** A pan button or arrow key was pressed. `connectGraph` moves the drawing, then calls `moved()`. */
|
|
17648
17750
|
"on:helix-graph-pan"?: ((e: HelixGraphHelixGraphPanElementEvent) => void) | undefined;
|
|
17649
|
-
/** The notes, the links, the selection, the depth or the gestures changed. Used by `connectGraph`; pages do not need to listen for it. */
|
|
17751
|
+
/** The notes, the links, the selection, the depth, the note the keys are on, or the gestures changed. Used by `connectGraph`; pages do not need to listen for it. */
|
|
17650
17752
|
"on:helix-graph-part-change"?: ((
|
|
17651
17753
|
e: HelixGraphHelixGraphPartChangeElementEvent,
|
|
17652
17754
|
) => void) | undefined;
|
|
@@ -17843,11 +17945,36 @@ export type HelixHeatmapElementEvent<E = Event> = TypedEvent<HelixHeatmap, E>;
|
|
|
17843
17945
|
/** `helix-before-change` event type */
|
|
17844
17946
|
export type HelixHeatmapHelixBeforeChangeElementEvent =
|
|
17845
17947
|
HelixHeatmapElementEvent<HelixBeforeChangeEvent>;
|
|
17948
|
+
/** `helix-reading-change` event type */
|
|
17949
|
+
export type HelixHeatmapHelixReadingChangeElementEvent =
|
|
17950
|
+
HelixHeatmapElementEvent<HelixReadingChangeEvent>;
|
|
17951
|
+
/** `helix-reading-press` event type */
|
|
17952
|
+
export type HelixHeatmapHelixReadingPressElementEvent =
|
|
17953
|
+
HelixHeatmapElementEvent<HelixReadingPressEvent>;
|
|
17846
17954
|
/** `helix-resize` event type */
|
|
17847
17955
|
export type HelixHeatmapHelixResizeElementEvent =
|
|
17848
17956
|
HelixHeatmapElementEvent<HelixResizeEvent>;
|
|
17849
17957
|
|
|
17850
17958
|
export type HelixHeatmapProps = {
|
|
17959
|
+
/** The words shown in place of the drawing when the table has no readings,
|
|
17960
|
+
and the fallback of the `empty` slot. */
|
|
17961
|
+
"empty-text"?: (HelixHeatmap["emptyText"]) | undefined;
|
|
17962
|
+
/** The words shown in place of the drawing when the table has no readings,
|
|
17963
|
+
and the fallback of the `empty` slot. */
|
|
17964
|
+
emptyText?: (HelixHeatmap["emptyText"]) | undefined;
|
|
17965
|
+
/** Whether the readings are still on their way. The chart shows
|
|
17966
|
+
`loading-text` in place of an empty drawing until it has readings.
|
|
17967
|
+
|
|
17968
|
+
Reflected, so a stylesheet can treat the chart while it waits. A chart
|
|
17969
|
+
that already has readings keeps drawing them, so a refresh does not
|
|
17970
|
+
blank it. */
|
|
17971
|
+
loading?: (HelixHeatmap["loading"]) | undefined;
|
|
17972
|
+
/** The words shown in place of the drawing while `loading` is set and
|
|
17973
|
+
there are no readings yet, and the fallback of the `loading` slot. */
|
|
17974
|
+
"loading-text"?: (HelixHeatmap["loadingText"]) | undefined;
|
|
17975
|
+
/** The words shown in place of the drawing while `loading` is set and
|
|
17976
|
+
there are no readings yet, and the fallback of the `loading` slot. */
|
|
17977
|
+
loadingText?: (HelixHeatmap["loadingText"]) | undefined;
|
|
17851
17978
|
/** The id of the table to read.
|
|
17852
17979
|
|
|
17853
17980
|
Names a table in the same tree, so a chart inside another component's
|
|
@@ -17890,16 +18017,6 @@ legend hid is not counted. */
|
|
|
17890
18017
|
/** The name the `overview` gives the busiest reading, `{busiestLabel}` in
|
|
17891
18018
|
`overview-label`. */
|
|
17892
18019
|
busiestLabel?: (HelixHeatmap["busiestLabel"]) | undefined;
|
|
17893
|
-
/** Shown when the table has no readings in it.
|
|
17894
|
-
|
|
17895
|
-
Never shown while the table cannot be read at all, which is a server render
|
|
17896
|
-
and the hydrating one after it: see `sourceKnown`. */
|
|
17897
|
-
"empty-text"?: (HelixHeatmap["emptyText"]) | undefined;
|
|
17898
|
-
/** Shown when the table has no readings in it.
|
|
17899
|
-
|
|
17900
|
-
Never shown while the table cannot be read at all, which is a server render
|
|
17901
|
-
and the hydrating one after it: see `sourceKnown`. */
|
|
17902
|
-
emptyText?: (HelixHeatmap["emptyText"]) | undefined;
|
|
17903
18020
|
/** Space between cells, in CSS pixels. It is a number for the same reason
|
|
17904
18021
|
`min-cell` is. */
|
|
17905
18022
|
gap?: (HelixHeatmap["gap"]) | undefined;
|
|
@@ -17957,13 +18074,9 @@ calendar heatmap does: a week is a column, so the strip reads along the
|
|
|
17957
18074
|
line in weeks, from the right on a right-to-left page, and top to bottom in
|
|
17958
18075
|
days. */
|
|
17959
18076
|
rows?: (HelixHeatmap["rows"]) | undefined;
|
|
17960
|
-
/** What the readout
|
|
17961
|
-
where the cell stands: "Day 1: 0 (1 of 14, selected)". Empty adds
|
|
17962
|
-
nothing. */
|
|
18077
|
+
/** What the readout added for a selected cell, under `selection-mode`. */
|
|
17963
18078
|
"selected-label"?: (HelixHeatmap["selectedLabel"]) | undefined;
|
|
17964
|
-
/** What the readout
|
|
17965
|
-
where the cell stands: "Day 1: 0 (1 of 14, selected)". Empty adds
|
|
17966
|
-
nothing. */
|
|
18079
|
+
/** What the readout added for a selected cell, under `selection-mode`. */
|
|
17967
18080
|
selectedLabel?: (HelixHeatmap["selectedLabel"]) | undefined;
|
|
17968
18081
|
/** What the `selection` part says after the selection changes. `{count}` is
|
|
17969
18082
|
how many cells are selected, written in the locale, and a language that
|
|
@@ -18050,11 +18163,38 @@ does not look inside the one it has. */
|
|
|
18050
18163
|
"onhelix-before-change"?: ((
|
|
18051
18164
|
e: HelixHeatmapHelixBeforeChangeElementEvent,
|
|
18052
18165
|
) => void) | undefined;
|
|
18166
|
+
/** The reading shown moved, or was put away: `index` is the row, or `-1` for none, with its `label`, the `series` the keys rest on, and the `pointerType` that moved it. */
|
|
18167
|
+
"onhelix-reading-change"?: ((
|
|
18168
|
+
e: HelixHeatmapHelixReadingChangeElementEvent,
|
|
18169
|
+
) => void) | undefined;
|
|
18170
|
+
/** A reading was clicked, tapped, or pressed with Enter or Space, with the same detail as `helix-reading-change`. */
|
|
18171
|
+
"onhelix-reading-press"?: ((
|
|
18172
|
+
e: HelixHeatmapHelixReadingPressElementEvent,
|
|
18173
|
+
) => void) | undefined;
|
|
18053
18174
|
/** Fired when the number of cells drawn changes, with the new number. */
|
|
18054
18175
|
"onhelix-resize"?: ((e: HelixHeatmapHelixResizeElementEvent) => void) | undefined;
|
|
18055
18176
|
};
|
|
18056
18177
|
|
|
18057
18178
|
export type HelixHeatmapSolidJsProps = {
|
|
18179
|
+
/** The words shown in place of the drawing when the table has no readings,
|
|
18180
|
+
and the fallback of the `empty` slot. */
|
|
18181
|
+
"attr:empty-text"?: (HelixHeatmap["emptyText"]) | undefined;
|
|
18182
|
+
/** The words shown in place of the drawing when the table has no readings,
|
|
18183
|
+
and the fallback of the `empty` slot. */
|
|
18184
|
+
"prop:emptyText"?: (HelixHeatmap["emptyText"]) | undefined;
|
|
18185
|
+
/** Whether the readings are still on their way. The chart shows
|
|
18186
|
+
`loading-text` in place of an empty drawing until it has readings.
|
|
18187
|
+
|
|
18188
|
+
Reflected, so a stylesheet can treat the chart while it waits. A chart
|
|
18189
|
+
that already has readings keeps drawing them, so a refresh does not
|
|
18190
|
+
blank it. */
|
|
18191
|
+
"prop:loading"?: (HelixHeatmap["loading"]) | undefined;
|
|
18192
|
+
/** The words shown in place of the drawing while `loading` is set and
|
|
18193
|
+
there are no readings yet, and the fallback of the `loading` slot. */
|
|
18194
|
+
"attr:loading-text"?: (HelixHeatmap["loadingText"]) | undefined;
|
|
18195
|
+
/** The words shown in place of the drawing while `loading` is set and
|
|
18196
|
+
there are no readings yet, and the fallback of the `loading` slot. */
|
|
18197
|
+
"prop:loadingText"?: (HelixHeatmap["loadingText"]) | undefined;
|
|
18058
18198
|
/** The id of the table to read.
|
|
18059
18199
|
|
|
18060
18200
|
Names a table in the same tree, so a chart inside another component's
|
|
@@ -18097,16 +18237,6 @@ legend hid is not counted. */
|
|
|
18097
18237
|
/** The name the `overview` gives the busiest reading, `{busiestLabel}` in
|
|
18098
18238
|
`overview-label`. */
|
|
18099
18239
|
"prop:busiestLabel"?: (HelixHeatmap["busiestLabel"]) | undefined;
|
|
18100
|
-
/** Shown when the table has no readings in it.
|
|
18101
|
-
|
|
18102
|
-
Never shown while the table cannot be read at all, which is a server render
|
|
18103
|
-
and the hydrating one after it: see `sourceKnown`. */
|
|
18104
|
-
"attr:empty-text"?: (HelixHeatmap["emptyText"]) | undefined;
|
|
18105
|
-
/** Shown when the table has no readings in it.
|
|
18106
|
-
|
|
18107
|
-
Never shown while the table cannot be read at all, which is a server render
|
|
18108
|
-
and the hydrating one after it: see `sourceKnown`. */
|
|
18109
|
-
"prop:emptyText"?: (HelixHeatmap["emptyText"]) | undefined;
|
|
18110
18240
|
/** Space between cells, in CSS pixels. It is a number for the same reason
|
|
18111
18241
|
`min-cell` is. */
|
|
18112
18242
|
"prop:gap"?: (HelixHeatmap["gap"]) | undefined;
|
|
@@ -18164,13 +18294,9 @@ calendar heatmap does: a week is a column, so the strip reads along the
|
|
|
18164
18294
|
line in weeks, from the right on a right-to-left page, and top to bottom in
|
|
18165
18295
|
days. */
|
|
18166
18296
|
"prop:rows"?: (HelixHeatmap["rows"]) | undefined;
|
|
18167
|
-
/** What the readout
|
|
18168
|
-
where the cell stands: "Day 1: 0 (1 of 14, selected)". Empty adds
|
|
18169
|
-
nothing. */
|
|
18297
|
+
/** What the readout added for a selected cell, under `selection-mode`. */
|
|
18170
18298
|
"attr:selected-label"?: (HelixHeatmap["selectedLabel"]) | undefined;
|
|
18171
|
-
/** What the readout
|
|
18172
|
-
where the cell stands: "Day 1: 0 (1 of 14, selected)". Empty adds
|
|
18173
|
-
nothing. */
|
|
18299
|
+
/** What the readout added for a selected cell, under `selection-mode`. */
|
|
18174
18300
|
"prop:selectedLabel"?: (HelixHeatmap["selectedLabel"]) | undefined;
|
|
18175
18301
|
/** What the `selection` part says after the selection changes. `{count}` is
|
|
18176
18302
|
how many cells are selected, written in the locale, and a language that
|
|
@@ -18256,6 +18382,14 @@ does not look inside the one it has. */
|
|
|
18256
18382
|
"on:helix-before-change"?: ((
|
|
18257
18383
|
e: HelixHeatmapHelixBeforeChangeElementEvent,
|
|
18258
18384
|
) => void) | undefined;
|
|
18385
|
+
/** The reading shown moved, or was put away: `index` is the row, or `-1` for none, with its `label`, the `series` the keys rest on, and the `pointerType` that moved it. */
|
|
18386
|
+
"on:helix-reading-change"?: ((
|
|
18387
|
+
e: HelixHeatmapHelixReadingChangeElementEvent,
|
|
18388
|
+
) => void) | undefined;
|
|
18389
|
+
/** A reading was clicked, tapped, or pressed with Enter or Space, with the same detail as `helix-reading-change`. */
|
|
18390
|
+
"on:helix-reading-press"?: ((
|
|
18391
|
+
e: HelixHeatmapHelixReadingPressElementEvent,
|
|
18392
|
+
) => void) | undefined;
|
|
18259
18393
|
/** Fired when the number of cells drawn changes, with the new number. */
|
|
18260
18394
|
"on:helix-resize"?: ((e: HelixHeatmapHelixResizeElementEvent) => void) | undefined;
|
|
18261
18395
|
|
|
@@ -43010,8 +43144,8 @@ export type CustomElements = {
|
|
|
43010
43144
|
* The shader stops drawing in these cases:
|
|
43011
43145
|
* - The element is off screen or in a background tab.
|
|
43012
43146
|
* - `prefers-reduced-motion` is set. The element shows one still frame.
|
|
43013
|
-
* - `paused` is set, from a pause control on your page
|
|
43014
|
-
* frame it shows.
|
|
43147
|
+
* - `paused` is set, from a pause control on your page or from the aura's own
|
|
43148
|
+
* under `pause-control`. The element holds the frame it shows.
|
|
43015
43149
|
* - The browser takes back the drawing context, on a GPU reset or past its
|
|
43016
43150
|
* limit of about sixteen contexts. The gradient shows until the context
|
|
43017
43151
|
* returns.
|
|
@@ -43035,6 +43169,13 @@ export type CustomElements = {
|
|
|
43035
43169
|
* changed while the aura draws, by a class, a style or the color mode,
|
|
43036
43170
|
* reaches the shader on the next frame.
|
|
43037
43171
|
*
|
|
43172
|
+
* **`pause-control` draws a control that stops the motion and starts it
|
|
43173
|
+
* again**, in the trailing corner of the field, as WCAG 2.2.2 asks of
|
|
43174
|
+
* anything that moves for more than five seconds. It is a toggle button named
|
|
43175
|
+
* by `pause-label`, which says it is pressed while the field is paused, and a
|
|
43176
|
+
* press sends `change`. A reader who asked for reduced motion sees no motion
|
|
43177
|
+
* and no control.
|
|
43178
|
+
*
|
|
43038
43179
|
* Where the gradient shows in place of the shader, the aura matches
|
|
43039
43180
|
* `:state(fallback)` and sends `helix-aura-fallback` with the reason.
|
|
43040
43181
|
*
|
|
@@ -43074,12 +43215,18 @@ export type CustomElements = {
|
|
|
43074
43215
|
* hit-testable at rest, or it would swallow clicks meant for what is over it,
|
|
43075
43216
|
* and an element that is not hit-testable never receives the `pointermove`
|
|
43076
43217
|
* this listens for. Asking for the pointer is asking for the hit test.
|
|
43218
|
+
* - `pause-control`/`pauseControl`: Whether the aura draws its own control that pauses the field and starts it
|
|
43219
|
+
* again, in its trailing corner. Absent draws none, for a page with a pause
|
|
43220
|
+
* control of its own.
|
|
43077
43221
|
* - `paused`: Whether the field holds still on the frame it shows.
|
|
43078
43222
|
*
|
|
43079
43223
|
* Set it from a pause control on your page, so a reader can stop the motion,
|
|
43080
43224
|
* as WCAG 2.2.2 asks of anything that moves for more than five seconds. A
|
|
43081
43225
|
* change to another property still repaints the frame. Clearing it starts
|
|
43082
43226
|
* the field from where it stopped.
|
|
43227
|
+
* - `pause-label`/`pauseLabel`: The pause control's name, read by screen readers. The control is a toggle
|
|
43228
|
+
* and says it is pressed while the field is paused, so the name stays the
|
|
43229
|
+
* same.
|
|
43083
43230
|
* - `reach`: How far the pointer reaches into the field, `0` upward.
|
|
43084
43231
|
*
|
|
43085
43232
|
* Multiplied into the presence the pointer already fades in and out with, so
|
|
@@ -43167,6 +43314,7 @@ export type CustomElements = {
|
|
|
43167
43314
|
*
|
|
43168
43315
|
* Events that will be emitted by the component.
|
|
43169
43316
|
*
|
|
43317
|
+
* - `change`: Fired when the aura's own pause control pauses the field or starts it again.
|
|
43170
43318
|
* - `helix-aura-fallback`: Fired each time the aura stops drawing its shader and shows its gradient, with the reason.
|
|
43171
43319
|
*
|
|
43172
43320
|
* ## Slots
|
|
@@ -43182,6 +43330,7 @@ export type CustomElements = {
|
|
|
43182
43330
|
* - `--aura-glow`: The bright stop of the ramp. Defaults to `--helix-color-primary`.
|
|
43183
43331
|
* - `--aura-ground`: The page the field fades into. Defaults to `--helix-color-background`.
|
|
43184
43332
|
* - `--aura-haze`: The faint stop between the ground and the glow. Defaults to `--helix-color-primary-subtle`.
|
|
43333
|
+
* - `--aura-pause-background-color`: The pause control's ground. Defaults to `--helix-color-surface-overlay`.
|
|
43185
43334
|
* - `--aura-peak`: The hottest stop, at the center of a shape. Defaults to `--helix-color-primary-active` on a light page and `--helix-color-foreground` on a dark one.
|
|
43186
43335
|
*
|
|
43187
43336
|
* ## CSS Parts
|
|
@@ -43190,6 +43339,8 @@ export type CustomElements = {
|
|
|
43190
43339
|
*
|
|
43191
43340
|
* - `canvas`: The surface the shader draws into.
|
|
43192
43341
|
* - `content`: The box over the field that holds the content. It covers the aura.
|
|
43342
|
+
* - `pause`: The control that pauses the field and starts it again, drawn under `pause-control`.
|
|
43343
|
+
* - `pause-mark`: The glyph on the pause control: pause while the field moves, play while it is paused.
|
|
43193
43344
|
*
|
|
43194
43345
|
* ## CSS States
|
|
43195
43346
|
*
|
|
@@ -44655,6 +44806,15 @@ export type CustomElements = {
|
|
|
44655
44806
|
*
|
|
44656
44807
|
* Methods that can be called to access component functionality.
|
|
44657
44808
|
*
|
|
44809
|
+
* - `click() => void`: Presses the button, as `click()` presses a native one: the command is sent,
|
|
44810
|
+
* the form submits or resets, and `helix-press` says `virtual`.
|
|
44811
|
+
*
|
|
44812
|
+
* **Passed to the inner control, because a click on the host reaches nothing
|
|
44813
|
+
* that acts.** The control in the shadow root is what answers a click, so
|
|
44814
|
+
* `click()` from a script, an automation or a test, dispatched on the host,
|
|
44815
|
+
* submitted nothing and sent no `helix-press`. The control's own click reaches
|
|
44816
|
+
* the host's listeners once, retargeted, as one from a native button does. A
|
|
44817
|
+
* disabled button does nothing, and a pending one refuses the press.
|
|
44658
44818
|
* - `formAssociatedCallback(form: HTMLFormElement | null) => void`: Called by the browser when the button's form changes.
|
|
44659
44819
|
* - `formDisabledCallback(disabled: boolean) => void`: Called by the browser when an ancestor fieldset is disabled or enabled.
|
|
44660
44820
|
*
|
|
@@ -48985,6 +49145,15 @@ export type CustomElements = {
|
|
|
48985
49145
|
*
|
|
48986
49146
|
* Methods that can be called to access component functionality.
|
|
48987
49147
|
*
|
|
49148
|
+
* - `click() => void`: Presses the button, as `click()` presses a native one: the command is sent,
|
|
49149
|
+
* the form submits or resets, and `helix-press` says `virtual`.
|
|
49150
|
+
*
|
|
49151
|
+
* **Passed to the inner control, because a click on the host reaches nothing
|
|
49152
|
+
* that acts.** The control in the shadow root is what answers a click, so
|
|
49153
|
+
* `click()` from a script, an automation or a test, dispatched on the host,
|
|
49154
|
+
* submitted nothing and sent no `helix-press`. The control's own click reaches
|
|
49155
|
+
* the host's listeners once, retargeted, as one from a native button does. A
|
|
49156
|
+
* disabled button does nothing, and a pending one refuses the press.
|
|
48988
49157
|
* - `formAssociatedCallback(form: HTMLFormElement | null) => void`: Called by the browser when the control's form changes: watches the new
|
|
48989
49158
|
* form's `checkValidity()`, as connecting does for the form it starts in.
|
|
48990
49159
|
* - `formDisabledCallback(disabled: boolean) => void`: Called by the browser when an ancestor fieldset is disabled or enabled.
|
|
@@ -51508,6 +51677,9 @@ export type CustomElements = {
|
|
|
51508
51677
|
*
|
|
51509
51678
|
* - `focusItem() => void`: Moves focus onto the row itself.
|
|
51510
51679
|
* - `select() => void`: Fires `helix-select` for this row.
|
|
51680
|
+
* - `click() => void`: Presses the row, as `click()` presses a native button: passed to the
|
|
51681
|
+
* control inside, which is what answers a click, so a script's `click()`
|
|
51682
|
+
* chooses the row, or follows its link, once.
|
|
51511
51683
|
*
|
|
51512
51684
|
* ## CSS Custom Properties
|
|
51513
51685
|
*
|
|
@@ -52595,6 +52767,9 @@ export type CustomElements = {
|
|
|
52595
52767
|
* them.
|
|
52596
52768
|
* - `clear-label`/`clearLabel`: The name of the clear button, read by screen readers. The button shows only
|
|
52597
52769
|
* an icon.
|
|
52770
|
+
* - `filter-delay`/`filterDelay`: How long typing rests before `source` is asked, in milliseconds. A delay
|
|
52771
|
+
* sends one request for a word in place of one for each letter. The arrow
|
|
52772
|
+
* keys and Enter ask at once. `0` asks on every keystroke.
|
|
52598
52773
|
* - `filter-suggestions`/`filterSuggestions`: Whether the panel narrows itself to the suggestions that hold the term
|
|
52599
52774
|
* being typed, as React Aria's Autocomplete filters. Off, the panel shows
|
|
52600
52775
|
* what you slot and you narrow it.
|
|
@@ -52643,6 +52818,12 @@ export type CustomElements = {
|
|
|
52643
52818
|
* imperatively later, and nothing is hydrating by then.
|
|
52644
52819
|
*
|
|
52645
52820
|
* Here rather than on each control.
|
|
52821
|
+
* - `source`: Where the suggestions come from: a function given the term at the caret,
|
|
52822
|
+
* the field it is a value of, the whole text, and an `AbortSignal`, which
|
|
52823
|
+
* returns the suggestions or a promise of them. Each is a string, or a
|
|
52824
|
+
* `value` with a `label` and `disabled`. The field draws them as options in
|
|
52825
|
+
* the panel, beside any you slot. A property only, there being no way to
|
|
52826
|
+
* write a function in markup. See the class description. (property only)
|
|
52646
52827
|
* - `selectionDirection`: The direction of the selection, named as on `<input>`.
|
|
52647
52828
|
*
|
|
52648
52829
|
* **Published for the reason `Input` publishes them, and this element needs
|
|
@@ -52700,7 +52881,7 @@ export type CustomElements = {
|
|
|
52700
52881
|
* - `helix-before-open`: Fired before the suggestions open. Cancelable: call `preventDefault()` to keep them closed.
|
|
52701
52882
|
* - `helix-dismiss`: Fired when the user removes a token with its remove button or with Backspace in an empty field. A `FilterChip` that names a declared field sends `helix-facet` instead. Cancelable: call `preventDefault()` to keep the token.
|
|
52702
52883
|
* - `helix-facet`: Fired when a filter changes, whether it was typed, picked, or removed. Cancelable: call `preventDefault()` to leave the text and the chip as they were.
|
|
52703
|
-
* - `helix-select`: Fired by an option in `suggestions` when it is chosen, and bubbles out of the field. Cancelable: call `preventDefault()` to stop other listeners acting on it. The field takes no action on
|
|
52884
|
+
* - `helix-select`: Fired by an option in `suggestions` when it is chosen, and bubbles out of the field. Cancelable: call `preventDefault()` to stop other listeners acting on it. The field takes no action on an option you slotted, and you decide what it does. A suggestion from `source` is written over the term at the caret unless you cancel it.
|
|
52704
52885
|
* - `input`: Fired when the text changes.
|
|
52705
52886
|
*
|
|
52706
52887
|
* ## Slots
|
|
@@ -52826,7 +53007,7 @@ export type CustomElements = {
|
|
|
52826
53007
|
* - `label`: The label above the field.
|
|
52827
53008
|
* - `lead`: The box before the text that holds the `start` slot.
|
|
52828
53009
|
* - `live`: The live region that says how many suggestions the open panel offers. It is rendered from the first time the panel opens with suggestions.
|
|
52829
|
-
* - `loading`: Shown in the panel while the suggestions load.
|
|
53010
|
+
* - `loading`: Shown in the panel while the suggestions load: while `loading` is set, or a request to `source` is out.
|
|
52830
53011
|
* - `rest`: The count of tokens that did not fit. It is a `<button>` with `expandable` and a `<span>` without it.
|
|
52831
53012
|
* - `surface`: The floating panel the suggestions sit in.
|
|
52832
53013
|
* - `tags`: The row the tokens sit in.
|
|
@@ -52836,7 +53017,7 @@ export type CustomElements = {
|
|
|
52836
53017
|
* These can be used to apply styling when a component is in a given state.
|
|
52837
53018
|
*
|
|
52838
53019
|
* - `invalid`: The field has an error to show, from the browser's validation or from your `feedback`.
|
|
52839
|
-
* - `loading`: While `loading` is set.
|
|
53020
|
+
* - `loading`: While `loading` is set, or a request to `source` is out.
|
|
52840
53021
|
* - `no-results`: `filter-suggestions` hid every suggestion, and `no-results-text` or the `no-results` slot says so.
|
|
52841
53022
|
* - `open`: The suggestions are open.
|
|
52842
53023
|
* - `settled`: Set one frame after the first render. Transitions wait for it, so an element does not animate its own arrival.
|
|
@@ -53238,6 +53419,9 @@ export type CustomElements = {
|
|
|
53238
53419
|
* - `legend`: Names the groups over the drawing, each a button in its color that shows
|
|
53239
53420
|
* or hides its notes. Drawn where the notes have two groups or more.
|
|
53240
53421
|
* - `legend-label`/`legendLabel`: The legend's name, read by screen readers.
|
|
53422
|
+
* - `link-count-label`/`linkCountLabel`: What screen readers hear when a walk along the links reaches a note that
|
|
53423
|
+
* has no link to follow, or goes back to a note: `{note}` for its name and
|
|
53424
|
+
* `{count}` for how many notes the list holds that it links to or from.
|
|
53241
53425
|
* - `linked-both-label`/`linkedBothLabel`: How a note linked both to and from the selected one is described, with `{note}`.
|
|
53242
53426
|
* - `linked-from-label`/`linkedFromLabel`: How a note the selected one links to is described, with `{note}`, the selected note's name.
|
|
53243
53427
|
* - `links-to-label`/`linksToLabel`: How a note that links to the selected one is described, with `{note}`.
|
|
@@ -53262,6 +53446,10 @@ export type CustomElements = {
|
|
|
53262
53446
|
* the list then holds, written with `count-label`.
|
|
53263
53447
|
* - `two-finger-hint-label`/`twoFingerHintLabel`: The hint shown when one finger swipes over the graph with `gestures="cooperative"`.
|
|
53264
53448
|
* - `using-label`/`usingLabel`: The line shown while the graph, with `gestures="activate"`, has the gestures.
|
|
53449
|
+
* - `walk-label`/`walkLabel`: What screen readers hear when a walk along the links moves to a note:
|
|
53450
|
+
* `{note}` for its name, `{relation}` for how it stands to the note the
|
|
53451
|
+
* step came from, such as "Linked from Roadmap", and `{index}` and `{count}`
|
|
53452
|
+
* for its place among that note's links.
|
|
53265
53453
|
* - `wheel-hint-label`/`wheelHintLabel`: The hint shown when the wheel scrolls past the graph with
|
|
53266
53454
|
* `gestures="cooperative"`. `{key}` is ⌘ on a Mac and Ctrl elsewhere.
|
|
53267
53455
|
* - `zoomed-in-label`/`zoomedInLabel`: What screen readers hear once the drawing has zoomed in, after `moved()`.
|
|
@@ -53309,7 +53497,7 @@ export type CustomElements = {
|
|
|
53309
53497
|
* - `helix-graph-filter`: A group in the legend was pressed, to show or hide its notes. The detail's `hidden` is every group that would be hidden. Cancelable: cancel it to keep the groups as they were, or to set `hiddenGroups` yourself.
|
|
53310
53498
|
* - `helix-graph-layout`: A layout settled, with where it put each note, sent by `laidOut()`. Keep the positions and pass them back as each note's `x` and `y`, and `z` where a renderer draws in three dimensions.
|
|
53311
53499
|
* - `helix-graph-pan`: A pan button or arrow key was pressed. `connectGraph` moves the drawing, then calls `moved()`.
|
|
53312
|
-
* - `helix-graph-part-change`: The notes, the links, the selection, the depth or the gestures changed. Used by `connectGraph`; pages do not need to listen for it.
|
|
53500
|
+
* - `helix-graph-part-change`: The notes, the links, the selection, the depth, the note the keys are on, or the gestures changed. Used by `connectGraph`; pages do not need to listen for it.
|
|
53313
53501
|
* - `helix-graph-ready`: The graph has been drawn whole, laid out and settled. Sent each time `drawn()` says it is drawn after it was not.
|
|
53314
53502
|
* - `helix-graph-signal`: Something passed between two notes, sent by `signal()`. Used by `connectGraph`; pages do not need to listen for it.
|
|
53315
53503
|
* - `helix-graph-zoom`: A zoom button or key was pressed. `connectGraph` zooms the drawing, then calls `moved()`.
|
|
@@ -53581,6 +53769,16 @@ export type CustomElements = {
|
|
|
53581
53769
|
*
|
|
53582
53770
|
* Component attributes and properties that can be applied to the element or by using JavaScript.
|
|
53583
53771
|
*
|
|
53772
|
+
* - `empty-text`/`emptyText`: The words shown in place of the drawing when the table has no readings,
|
|
53773
|
+
* and the fallback of the `empty` slot.
|
|
53774
|
+
* - `loading`: Whether the readings are still on their way. The chart shows
|
|
53775
|
+
* `loading-text` in place of an empty drawing until it has readings.
|
|
53776
|
+
*
|
|
53777
|
+
* Reflected, so a stylesheet can treat the chart while it waits. A chart
|
|
53778
|
+
* that already has readings keeps drawing them, so a refresh does not
|
|
53779
|
+
* blank it.
|
|
53780
|
+
* - `loading-text`/`loadingText`: The words shown in place of the drawing while `loading` is set and
|
|
53781
|
+
* there are no readings yet, and the fallback of the `loading` slot.
|
|
53584
53782
|
* - `for`: The id of the table to read.
|
|
53585
53783
|
*
|
|
53586
53784
|
* Names a table in the same tree, so a chart inside another component's
|
|
@@ -53607,10 +53805,6 @@ export type CustomElements = {
|
|
|
53607
53805
|
* legend hid is not counted.
|
|
53608
53806
|
* - `busiest-label`/`busiestLabel`: The name the `overview` gives the busiest reading, `{busiestLabel}` in
|
|
53609
53807
|
* `overview-label`.
|
|
53610
|
-
* - `empty-text`/`emptyText`: Shown when the table has no readings in it.
|
|
53611
|
-
*
|
|
53612
|
-
* Never shown while the table cannot be read at all, which is a server render
|
|
53613
|
-
* and the hydrating one after it: see `sourceKnown`.
|
|
53614
53808
|
* - `gap`: Space between cells, in CSS pixels. It is a number for the same reason
|
|
53615
53809
|
* `min-cell` is.
|
|
53616
53810
|
* - `min-cell`/`minCell`: The smallest a cell may get before the strip draws fewer of them, in CSS pixels.
|
|
@@ -53641,9 +53835,7 @@ export type CustomElements = {
|
|
|
53641
53835
|
* calendar heatmap does: a week is a column, so the strip reads along the
|
|
53642
53836
|
* line in weeks, from the right on a right-to-left page, and top to bottom in
|
|
53643
53837
|
* days.
|
|
53644
|
-
* - `selected-label`/`selectedLabel`: What the readout
|
|
53645
|
-
* where the cell stands: "Day 1: 0 (1 of 14, selected)". Empty adds
|
|
53646
|
-
* nothing.
|
|
53838
|
+
* - `selected-label`/`selectedLabel`: What the readout added for a selected cell, under `selection-mode`.
|
|
53647
53839
|
* - `selection-label`/`selectionLabel`: What the `selection` part says after the selection changes. `{count}` is
|
|
53648
53840
|
* how many cells are selected, written in the locale, and a language that
|
|
53649
53841
|
* needs plural forms writes them: `{count, plural, one {# wybrany} few
|
|
@@ -53762,6 +53954,8 @@ export type CustomElements = {
|
|
|
53762
53954
|
*
|
|
53763
53955
|
* - `change`: Fired once a press or a key has changed which cells are selected.
|
|
53764
53956
|
* - `helix-before-change`: Fired before a press or a key changes which cells are selected, with the `value` it would leave. Cancelable.
|
|
53957
|
+
* - `helix-reading-change`: The reading shown moved, or was put away: `index` is the row, or `-1` for none, with its `label`, the `series` the keys rest on, and the `pointerType` that moved it.
|
|
53958
|
+
* - `helix-reading-press`: A reading was clicked, tapped, or pressed with Enter or Space, with the same detail as `helix-reading-change`.
|
|
53765
53959
|
* - `helix-resize`: Fired when the number of cells drawn changes, with the new number.
|
|
53766
53960
|
*
|
|
53767
53961
|
* ## Slots
|
|
@@ -53771,6 +53965,8 @@ export type CustomElements = {
|
|
|
53771
53965
|
* - `end`: Below the strip, at the trailing edge.
|
|
53772
53966
|
* - `start`: Below the strip, at the leading edge.
|
|
53773
53967
|
* - `summary`: Below the strip, in the middle.
|
|
53968
|
+
* - `empty`: Content shown under the strip when the table has no readings, such as a link to add the first. Falls back to `empty-text`.
|
|
53969
|
+
* - `loading`: Content shown under the strip while `loading` is set and there are no readings yet. Falls back to `loading-text`.
|
|
53774
53970
|
*
|
|
53775
53971
|
* ## Methods
|
|
53776
53972
|
*
|
|
@@ -53862,9 +54058,12 @@ export type CustomElements = {
|
|
|
53862
54058
|
* - `tooltip-top`: The bubble while it is above the reading. Set alongside `tooltip`.
|
|
53863
54059
|
* - `tooltip-value`: A column's value inside the tooltip.
|
|
53864
54060
|
* - `cell-selected`: A cell that is selected, under `selection-mode`. Set alongside `cell`.
|
|
53865
|
-
* - `empty`:
|
|
54061
|
+
* - `empty`: The words under the strip 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, there being no document to resolve `for` in.
|
|
53866
54062
|
* - `end`: The trailing slot's box.
|
|
54063
|
+
* - `loading`: The words under the strip while `loading` is set and there are no readings: the `loading` slot, falling back to `loading-text`.
|
|
53867
54064
|
* - `overview`: The busiest reading and the total of the readings drawn, written as a sentence for screen readers, which describes the strip. Rendered once there are cells. Hide it visually.
|
|
54065
|
+
* - `plot`: The same element as `strip`, under the name every chart gives the drawing that takes focus.
|
|
54066
|
+
* - `row`: A column of cells, which a grid reads as a row, under `selection-mode`. It draws no box.
|
|
53868
54067
|
* - `selection`: A polite region that says how many cells are selected after a change, rendered from the first change. Hide it visually.
|
|
53869
54068
|
* - `start`: The leading slot's box.
|
|
53870
54069
|
* - `summary`: The middle slot's box.
|
|
@@ -53876,6 +54075,7 @@ export type CustomElements = {
|
|
|
53876
54075
|
*
|
|
53877
54076
|
* - `active`: While a cell is shown, under the pointer or the keys, with its tooltip open.
|
|
53878
54077
|
* - `empty`: While the `empty` part stands in place of the cells.
|
|
54078
|
+
* - `loading`: While the `loading` part stands in place of the cells.
|
|
53879
54079
|
* - `settled`: Set one frame after the first render. Transitions wait for it, so an element does not animate its own arrival.
|
|
53880
54080
|
*/
|
|
53881
54081
|
"helix-heatmap": Partial<
|
|
@@ -54115,6 +54315,15 @@ export type CustomElements = {
|
|
|
54115
54315
|
*
|
|
54116
54316
|
* Methods that can be called to access component functionality.
|
|
54117
54317
|
*
|
|
54318
|
+
* - `click() => void`: Presses the button, as `click()` presses a native one: the command is sent,
|
|
54319
|
+
* the form submits or resets, and `helix-press` says `virtual`.
|
|
54320
|
+
*
|
|
54321
|
+
* **Passed to the inner control, because a click on the host reaches nothing
|
|
54322
|
+
* that acts.** The control in the shadow root is what answers a click, so
|
|
54323
|
+
* `click()` from a script, an automation or a test, dispatched on the host,
|
|
54324
|
+
* submitted nothing and sent no `helix-press`. The control's own click reaches
|
|
54325
|
+
* the host's listeners once, retargeted, as one from a native button does. A
|
|
54326
|
+
* disabled button does nothing, and a pending one refuses the press.
|
|
54118
54327
|
* - `formAssociatedCallback(form: HTMLFormElement | null) => void`: Called by the browser when the control's form changes: watches the new
|
|
54119
54328
|
* form's `checkValidity()`, as connecting does for the form it starts in.
|
|
54120
54329
|
* - `formDisabledCallback(disabled: boolean) => void`: Called by the browser when an ancestor fieldset is disabled or enabled.
|
|
@@ -57972,6 +58181,9 @@ export type CustomElements = {
|
|
|
57972
58181
|
* `focus()` above already puts focus on the control inside the row rather than
|
|
57973
58182
|
* on the row, which is the whole of what moving here means.
|
|
57974
58183
|
* - `select() => void`: Chooses the row, the same as pressing it.
|
|
58184
|
+
* - `click() => void`: Presses the row, as `click()` presses a native button: passed to the
|
|
58185
|
+
* control inside, which is what answers a click, so a script's `click()`
|
|
58186
|
+
* chooses the row, or follows its link, once.
|
|
57975
58187
|
*
|
|
57976
58188
|
* ## CSS Custom Properties
|
|
57977
58189
|
*
|
|
@@ -64849,6 +65061,9 @@ export type CustomElements = {
|
|
|
64849
65061
|
* - `focus(options?: FocusOptions) => void`: Puts focus on the control inside the item.
|
|
64850
65062
|
* - `focusItem() => void`: Moves focus to the action. Part of `NavigableItem`, which the shared
|
|
64851
65063
|
* keyboard controller uses for the arrow keys.
|
|
65064
|
+
* - `click() => void`: Presses the action, as `click()` presses a native button: passed to the
|
|
65065
|
+
* control inside, which is what answers a click, so a script's `click()`
|
|
65066
|
+
* chooses the action and follows its link, once.
|
|
64852
65067
|
* - `select() => void`: Chooses the action, the same as pressing it.
|
|
64853
65068
|
*
|
|
64854
65069
|
* ## CSS Custom Properties
|
|
@@ -67071,6 +67286,9 @@ export type CustomElements = {
|
|
|
67071
67286
|
* disabled or a listener cancels the event.
|
|
67072
67287
|
* - `focus(options?: FocusOptions) => void`: Moves focus to the tab's control, the button or the link inside it, so a
|
|
67073
67288
|
* script can focus the tab the way it focuses a native one.
|
|
67289
|
+
* - `click() => void`: Presses the tab, as `click()` presses a native button: passed to the
|
|
67290
|
+
* control inside, which is what answers a click, so a script's `click()`
|
|
67291
|
+
* selects the tab, or follows its link, once.
|
|
67074
67292
|
*
|
|
67075
67293
|
* ## CSS Custom Properties
|
|
67076
67294
|
*
|
|
@@ -72607,8 +72825,8 @@ export type CustomElementsSolidJs = {
|
|
|
72607
72825
|
* The shader stops drawing in these cases:
|
|
72608
72826
|
* - The element is off screen or in a background tab.
|
|
72609
72827
|
* - `prefers-reduced-motion` is set. The element shows one still frame.
|
|
72610
|
-
* - `paused` is set, from a pause control on your page
|
|
72611
|
-
* frame it shows.
|
|
72828
|
+
* - `paused` is set, from a pause control on your page or from the aura's own
|
|
72829
|
+
* under `pause-control`. The element holds the frame it shows.
|
|
72612
72830
|
* - The browser takes back the drawing context, on a GPU reset or past its
|
|
72613
72831
|
* limit of about sixteen contexts. The gradient shows until the context
|
|
72614
72832
|
* returns.
|
|
@@ -72632,6 +72850,13 @@ export type CustomElementsSolidJs = {
|
|
|
72632
72850
|
* changed while the aura draws, by a class, a style or the color mode,
|
|
72633
72851
|
* reaches the shader on the next frame.
|
|
72634
72852
|
*
|
|
72853
|
+
* **`pause-control` draws a control that stops the motion and starts it
|
|
72854
|
+
* again**, in the trailing corner of the field, as WCAG 2.2.2 asks of
|
|
72855
|
+
* anything that moves for more than five seconds. It is a toggle button named
|
|
72856
|
+
* by `pause-label`, which says it is pressed while the field is paused, and a
|
|
72857
|
+
* press sends `change`. A reader who asked for reduced motion sees no motion
|
|
72858
|
+
* and no control.
|
|
72859
|
+
*
|
|
72635
72860
|
* Where the gradient shows in place of the shader, the aura matches
|
|
72636
72861
|
* `:state(fallback)` and sends `helix-aura-fallback` with the reason.
|
|
72637
72862
|
*
|
|
@@ -72671,12 +72896,18 @@ export type CustomElementsSolidJs = {
|
|
|
72671
72896
|
* hit-testable at rest, or it would swallow clicks meant for what is over it,
|
|
72672
72897
|
* and an element that is not hit-testable never receives the `pointermove`
|
|
72673
72898
|
* this listens for. Asking for the pointer is asking for the hit test.
|
|
72899
|
+
* - `pause-control`/`pauseControl`: Whether the aura draws its own control that pauses the field and starts it
|
|
72900
|
+
* again, in its trailing corner. Absent draws none, for a page with a pause
|
|
72901
|
+
* control of its own.
|
|
72674
72902
|
* - `paused`: Whether the field holds still on the frame it shows.
|
|
72675
72903
|
*
|
|
72676
72904
|
* Set it from a pause control on your page, so a reader can stop the motion,
|
|
72677
72905
|
* as WCAG 2.2.2 asks of anything that moves for more than five seconds. A
|
|
72678
72906
|
* change to another property still repaints the frame. Clearing it starts
|
|
72679
72907
|
* the field from where it stopped.
|
|
72908
|
+
* - `pause-label`/`pauseLabel`: The pause control's name, read by screen readers. The control is a toggle
|
|
72909
|
+
* and says it is pressed while the field is paused, so the name stays the
|
|
72910
|
+
* same.
|
|
72680
72911
|
* - `reach`: How far the pointer reaches into the field, `0` upward.
|
|
72681
72912
|
*
|
|
72682
72913
|
* Multiplied into the presence the pointer already fades in and out with, so
|
|
@@ -72764,6 +72995,7 @@ export type CustomElementsSolidJs = {
|
|
|
72764
72995
|
*
|
|
72765
72996
|
* Events that will be emitted by the component.
|
|
72766
72997
|
*
|
|
72998
|
+
* - `change`: Fired when the aura's own pause control pauses the field or starts it again.
|
|
72767
72999
|
* - `helix-aura-fallback`: Fired each time the aura stops drawing its shader and shows its gradient, with the reason.
|
|
72768
73000
|
*
|
|
72769
73001
|
* ## Slots
|
|
@@ -72779,6 +73011,7 @@ export type CustomElementsSolidJs = {
|
|
|
72779
73011
|
* - `--aura-glow`: The bright stop of the ramp. Defaults to `--helix-color-primary`.
|
|
72780
73012
|
* - `--aura-ground`: The page the field fades into. Defaults to `--helix-color-background`.
|
|
72781
73013
|
* - `--aura-haze`: The faint stop between the ground and the glow. Defaults to `--helix-color-primary-subtle`.
|
|
73014
|
+
* - `--aura-pause-background-color`: The pause control's ground. Defaults to `--helix-color-surface-overlay`.
|
|
72782
73015
|
* - `--aura-peak`: The hottest stop, at the center of a shape. Defaults to `--helix-color-primary-active` on a light page and `--helix-color-foreground` on a dark one.
|
|
72783
73016
|
*
|
|
72784
73017
|
* ## CSS Parts
|
|
@@ -72787,6 +73020,8 @@ export type CustomElementsSolidJs = {
|
|
|
72787
73020
|
*
|
|
72788
73021
|
* - `canvas`: The surface the shader draws into.
|
|
72789
73022
|
* - `content`: The box over the field that holds the content. It covers the aura.
|
|
73023
|
+
* - `pause`: The control that pauses the field and starts it again, drawn under `pause-control`.
|
|
73024
|
+
* - `pause-mark`: The glyph on the pause control: pause while the field moves, play while it is paused.
|
|
72790
73025
|
*
|
|
72791
73026
|
* ## CSS States
|
|
72792
73027
|
*
|
|
@@ -74280,6 +74515,15 @@ export type CustomElementsSolidJs = {
|
|
|
74280
74515
|
*
|
|
74281
74516
|
* Methods that can be called to access component functionality.
|
|
74282
74517
|
*
|
|
74518
|
+
* - `click() => void`: Presses the button, as `click()` presses a native one: the command is sent,
|
|
74519
|
+
* the form submits or resets, and `helix-press` says `virtual`.
|
|
74520
|
+
*
|
|
74521
|
+
* **Passed to the inner control, because a click on the host reaches nothing
|
|
74522
|
+
* that acts.** The control in the shadow root is what answers a click, so
|
|
74523
|
+
* `click()` from a script, an automation or a test, dispatched on the host,
|
|
74524
|
+
* submitted nothing and sent no `helix-press`. The control's own click reaches
|
|
74525
|
+
* the host's listeners once, retargeted, as one from a native button does. A
|
|
74526
|
+
* disabled button does nothing, and a pending one refuses the press.
|
|
74283
74527
|
* - `formAssociatedCallback(form: HTMLFormElement | null) => void`: Called by the browser when the button's form changes.
|
|
74284
74528
|
* - `formDisabledCallback(disabled: boolean) => void`: Called by the browser when an ancestor fieldset is disabled or enabled.
|
|
74285
74529
|
*
|
|
@@ -78661,6 +78905,15 @@ export type CustomElementsSolidJs = {
|
|
|
78661
78905
|
*
|
|
78662
78906
|
* Methods that can be called to access component functionality.
|
|
78663
78907
|
*
|
|
78908
|
+
* - `click() => void`: Presses the button, as `click()` presses a native one: the command is sent,
|
|
78909
|
+
* the form submits or resets, and `helix-press` says `virtual`.
|
|
78910
|
+
*
|
|
78911
|
+
* **Passed to the inner control, because a click on the host reaches nothing
|
|
78912
|
+
* that acts.** The control in the shadow root is what answers a click, so
|
|
78913
|
+
* `click()` from a script, an automation or a test, dispatched on the host,
|
|
78914
|
+
* submitted nothing and sent no `helix-press`. The control's own click reaches
|
|
78915
|
+
* the host's listeners once, retargeted, as one from a native button does. A
|
|
78916
|
+
* disabled button does nothing, and a pending one refuses the press.
|
|
78664
78917
|
* - `formAssociatedCallback(form: HTMLFormElement | null) => void`: Called by the browser when the control's form changes: watches the new
|
|
78665
78918
|
* form's `checkValidity()`, as connecting does for the form it starts in.
|
|
78666
78919
|
* - `formDisabledCallback(disabled: boolean) => void`: Called by the browser when an ancestor fieldset is disabled or enabled.
|
|
@@ -81212,6 +81465,9 @@ export type CustomElementsSolidJs = {
|
|
|
81212
81465
|
*
|
|
81213
81466
|
* - `focusItem() => void`: Moves focus onto the row itself.
|
|
81214
81467
|
* - `select() => void`: Fires `helix-select` for this row.
|
|
81468
|
+
* - `click() => void`: Presses the row, as `click()` presses a native button: passed to the
|
|
81469
|
+
* control inside, which is what answers a click, so a script's `click()`
|
|
81470
|
+
* chooses the row, or follows its link, once.
|
|
81215
81471
|
*
|
|
81216
81472
|
* ## CSS Custom Properties
|
|
81217
81473
|
*
|
|
@@ -82325,6 +82581,9 @@ export type CustomElementsSolidJs = {
|
|
|
82325
82581
|
* them.
|
|
82326
82582
|
* - `clear-label`/`clearLabel`: The name of the clear button, read by screen readers. The button shows only
|
|
82327
82583
|
* an icon.
|
|
82584
|
+
* - `filter-delay`/`filterDelay`: How long typing rests before `source` is asked, in milliseconds. A delay
|
|
82585
|
+
* sends one request for a word in place of one for each letter. The arrow
|
|
82586
|
+
* keys and Enter ask at once. `0` asks on every keystroke.
|
|
82328
82587
|
* - `filter-suggestions`/`filterSuggestions`: Whether the panel narrows itself to the suggestions that hold the term
|
|
82329
82588
|
* being typed, as React Aria's Autocomplete filters. Off, the panel shows
|
|
82330
82589
|
* what you slot and you narrow it.
|
|
@@ -82373,6 +82632,12 @@ export type CustomElementsSolidJs = {
|
|
|
82373
82632
|
* imperatively later, and nothing is hydrating by then.
|
|
82374
82633
|
*
|
|
82375
82634
|
* Here rather than on each control.
|
|
82635
|
+
* - `source`: Where the suggestions come from: a function given the term at the caret,
|
|
82636
|
+
* the field it is a value of, the whole text, and an `AbortSignal`, which
|
|
82637
|
+
* returns the suggestions or a promise of them. Each is a string, or a
|
|
82638
|
+
* `value` with a `label` and `disabled`. The field draws them as options in
|
|
82639
|
+
* the panel, beside any you slot. A property only, there being no way to
|
|
82640
|
+
* write a function in markup. See the class description. (property only)
|
|
82376
82641
|
* - `selectionDirection`: The direction of the selection, named as on `<input>`.
|
|
82377
82642
|
*
|
|
82378
82643
|
* **Published for the reason `Input` publishes them, and this element needs
|
|
@@ -82430,7 +82695,7 @@ export type CustomElementsSolidJs = {
|
|
|
82430
82695
|
* - `helix-before-open`: Fired before the suggestions open. Cancelable: call `preventDefault()` to keep them closed.
|
|
82431
82696
|
* - `helix-dismiss`: Fired when the user removes a token with its remove button or with Backspace in an empty field. A `FilterChip` that names a declared field sends `helix-facet` instead. Cancelable: call `preventDefault()` to keep the token.
|
|
82432
82697
|
* - `helix-facet`: Fired when a filter changes, whether it was typed, picked, or removed. Cancelable: call `preventDefault()` to leave the text and the chip as they were.
|
|
82433
|
-
* - `helix-select`: Fired by an option in `suggestions` when it is chosen, and bubbles out of the field. Cancelable: call `preventDefault()` to stop other listeners acting on it. The field takes no action on
|
|
82698
|
+
* - `helix-select`: Fired by an option in `suggestions` when it is chosen, and bubbles out of the field. Cancelable: call `preventDefault()` to stop other listeners acting on it. The field takes no action on an option you slotted, and you decide what it does. A suggestion from `source` is written over the term at the caret unless you cancel it.
|
|
82434
82699
|
* - `input`: Fired when the text changes.
|
|
82435
82700
|
*
|
|
82436
82701
|
* ## Slots
|
|
@@ -82556,7 +82821,7 @@ export type CustomElementsSolidJs = {
|
|
|
82556
82821
|
* - `label`: The label above the field.
|
|
82557
82822
|
* - `lead`: The box before the text that holds the `start` slot.
|
|
82558
82823
|
* - `live`: The live region that says how many suggestions the open panel offers. It is rendered from the first time the panel opens with suggestions.
|
|
82559
|
-
* - `loading`: Shown in the panel while the suggestions load.
|
|
82824
|
+
* - `loading`: Shown in the panel while the suggestions load: while `loading` is set, or a request to `source` is out.
|
|
82560
82825
|
* - `rest`: The count of tokens that did not fit. It is a `<button>` with `expandable` and a `<span>` without it.
|
|
82561
82826
|
* - `surface`: The floating panel the suggestions sit in.
|
|
82562
82827
|
* - `tags`: The row the tokens sit in.
|
|
@@ -82566,7 +82831,7 @@ export type CustomElementsSolidJs = {
|
|
|
82566
82831
|
* These can be used to apply styling when a component is in a given state.
|
|
82567
82832
|
*
|
|
82568
82833
|
* - `invalid`: The field has an error to show, from the browser's validation or from your `feedback`.
|
|
82569
|
-
* - `loading`: While `loading` is set.
|
|
82834
|
+
* - `loading`: While `loading` is set, or a request to `source` is out.
|
|
82570
82835
|
* - `no-results`: `filter-suggestions` hid every suggestion, and `no-results-text` or the `no-results` slot says so.
|
|
82571
82836
|
* - `open`: The suggestions are open.
|
|
82572
82837
|
* - `settled`: Set one frame after the first render. Transitions wait for it, so an element does not animate its own arrival.
|
|
@@ -82976,6 +83241,9 @@ export type CustomElementsSolidJs = {
|
|
|
82976
83241
|
* - `legend`: Names the groups over the drawing, each a button in its color that shows
|
|
82977
83242
|
* or hides its notes. Drawn where the notes have two groups or more.
|
|
82978
83243
|
* - `legend-label`/`legendLabel`: The legend's name, read by screen readers.
|
|
83244
|
+
* - `link-count-label`/`linkCountLabel`: What screen readers hear when a walk along the links reaches a note that
|
|
83245
|
+
* has no link to follow, or goes back to a note: `{note}` for its name and
|
|
83246
|
+
* `{count}` for how many notes the list holds that it links to or from.
|
|
82979
83247
|
* - `linked-both-label`/`linkedBothLabel`: How a note linked both to and from the selected one is described, with `{note}`.
|
|
82980
83248
|
* - `linked-from-label`/`linkedFromLabel`: How a note the selected one links to is described, with `{note}`, the selected note's name.
|
|
82981
83249
|
* - `links-to-label`/`linksToLabel`: How a note that links to the selected one is described, with `{note}`.
|
|
@@ -83000,6 +83268,10 @@ export type CustomElementsSolidJs = {
|
|
|
83000
83268
|
* the list then holds, written with `count-label`.
|
|
83001
83269
|
* - `two-finger-hint-label`/`twoFingerHintLabel`: The hint shown when one finger swipes over the graph with `gestures="cooperative"`.
|
|
83002
83270
|
* - `using-label`/`usingLabel`: The line shown while the graph, with `gestures="activate"`, has the gestures.
|
|
83271
|
+
* - `walk-label`/`walkLabel`: What screen readers hear when a walk along the links moves to a note:
|
|
83272
|
+
* `{note}` for its name, `{relation}` for how it stands to the note the
|
|
83273
|
+
* step came from, such as "Linked from Roadmap", and `{index}` and `{count}`
|
|
83274
|
+
* for its place among that note's links.
|
|
83003
83275
|
* - `wheel-hint-label`/`wheelHintLabel`: The hint shown when the wheel scrolls past the graph with
|
|
83004
83276
|
* `gestures="cooperative"`. `{key}` is ⌘ on a Mac and Ctrl elsewhere.
|
|
83005
83277
|
* - `zoomed-in-label`/`zoomedInLabel`: What screen readers hear once the drawing has zoomed in, after `moved()`.
|
|
@@ -83047,7 +83319,7 @@ export type CustomElementsSolidJs = {
|
|
|
83047
83319
|
* - `helix-graph-filter`: A group in the legend was pressed, to show or hide its notes. The detail's `hidden` is every group that would be hidden. Cancelable: cancel it to keep the groups as they were, or to set `hiddenGroups` yourself.
|
|
83048
83320
|
* - `helix-graph-layout`: A layout settled, with where it put each note, sent by `laidOut()`. Keep the positions and pass them back as each note's `x` and `y`, and `z` where a renderer draws in three dimensions.
|
|
83049
83321
|
* - `helix-graph-pan`: A pan button or arrow key was pressed. `connectGraph` moves the drawing, then calls `moved()`.
|
|
83050
|
-
* - `helix-graph-part-change`: The notes, the links, the selection, the depth or the gestures changed. Used by `connectGraph`; pages do not need to listen for it.
|
|
83322
|
+
* - `helix-graph-part-change`: The notes, the links, the selection, the depth, the note the keys are on, or the gestures changed. Used by `connectGraph`; pages do not need to listen for it.
|
|
83051
83323
|
* - `helix-graph-ready`: The graph has been drawn whole, laid out and settled. Sent each time `drawn()` says it is drawn after it was not.
|
|
83052
83324
|
* - `helix-graph-signal`: Something passed between two notes, sent by `signal()`. Used by `connectGraph`; pages do not need to listen for it.
|
|
83053
83325
|
* - `helix-graph-zoom`: A zoom button or key was pressed. `connectGraph` zooms the drawing, then calls `moved()`.
|
|
@@ -83326,6 +83598,16 @@ export type CustomElementsSolidJs = {
|
|
|
83326
83598
|
*
|
|
83327
83599
|
* Component attributes and properties that can be applied to the element or by using JavaScript.
|
|
83328
83600
|
*
|
|
83601
|
+
* - `empty-text`/`emptyText`: The words shown in place of the drawing when the table has no readings,
|
|
83602
|
+
* and the fallback of the `empty` slot.
|
|
83603
|
+
* - `loading`: Whether the readings are still on their way. The chart shows
|
|
83604
|
+
* `loading-text` in place of an empty drawing until it has readings.
|
|
83605
|
+
*
|
|
83606
|
+
* Reflected, so a stylesheet can treat the chart while it waits. A chart
|
|
83607
|
+
* that already has readings keeps drawing them, so a refresh does not
|
|
83608
|
+
* blank it.
|
|
83609
|
+
* - `loading-text`/`loadingText`: The words shown in place of the drawing while `loading` is set and
|
|
83610
|
+
* there are no readings yet, and the fallback of the `loading` slot.
|
|
83329
83611
|
* - `for`: The id of the table to read.
|
|
83330
83612
|
*
|
|
83331
83613
|
* Names a table in the same tree, so a chart inside another component's
|
|
@@ -83352,10 +83634,6 @@ export type CustomElementsSolidJs = {
|
|
|
83352
83634
|
* legend hid is not counted.
|
|
83353
83635
|
* - `busiest-label`/`busiestLabel`: The name the `overview` gives the busiest reading, `{busiestLabel}` in
|
|
83354
83636
|
* `overview-label`.
|
|
83355
|
-
* - `empty-text`/`emptyText`: Shown when the table has no readings in it.
|
|
83356
|
-
*
|
|
83357
|
-
* Never shown while the table cannot be read at all, which is a server render
|
|
83358
|
-
* and the hydrating one after it: see `sourceKnown`.
|
|
83359
83637
|
* - `gap`: Space between cells, in CSS pixels. It is a number for the same reason
|
|
83360
83638
|
* `min-cell` is.
|
|
83361
83639
|
* - `min-cell`/`minCell`: The smallest a cell may get before the strip draws fewer of them, in CSS pixels.
|
|
@@ -83386,9 +83664,7 @@ export type CustomElementsSolidJs = {
|
|
|
83386
83664
|
* calendar heatmap does: a week is a column, so the strip reads along the
|
|
83387
83665
|
* line in weeks, from the right on a right-to-left page, and top to bottom in
|
|
83388
83666
|
* days.
|
|
83389
|
-
* - `selected-label`/`selectedLabel`: What the readout
|
|
83390
|
-
* where the cell stands: "Day 1: 0 (1 of 14, selected)". Empty adds
|
|
83391
|
-
* nothing.
|
|
83667
|
+
* - `selected-label`/`selectedLabel`: What the readout added for a selected cell, under `selection-mode`.
|
|
83392
83668
|
* - `selection-label`/`selectionLabel`: What the `selection` part says after the selection changes. `{count}` is
|
|
83393
83669
|
* how many cells are selected, written in the locale, and a language that
|
|
83394
83670
|
* needs plural forms writes them: `{count, plural, one {# wybrany} few
|
|
@@ -83507,6 +83783,8 @@ export type CustomElementsSolidJs = {
|
|
|
83507
83783
|
*
|
|
83508
83784
|
* - `change`: Fired once a press or a key has changed which cells are selected.
|
|
83509
83785
|
* - `helix-before-change`: Fired before a press or a key changes which cells are selected, with the `value` it would leave. Cancelable.
|
|
83786
|
+
* - `helix-reading-change`: The reading shown moved, or was put away: `index` is the row, or `-1` for none, with its `label`, the `series` the keys rest on, and the `pointerType` that moved it.
|
|
83787
|
+
* - `helix-reading-press`: A reading was clicked, tapped, or pressed with Enter or Space, with the same detail as `helix-reading-change`.
|
|
83510
83788
|
* - `helix-resize`: Fired when the number of cells drawn changes, with the new number.
|
|
83511
83789
|
*
|
|
83512
83790
|
* ## Slots
|
|
@@ -83516,6 +83794,8 @@ export type CustomElementsSolidJs = {
|
|
|
83516
83794
|
* - `end`: Below the strip, at the trailing edge.
|
|
83517
83795
|
* - `start`: Below the strip, at the leading edge.
|
|
83518
83796
|
* - `summary`: Below the strip, in the middle.
|
|
83797
|
+
* - `empty`: Content shown under the strip when the table has no readings, such as a link to add the first. Falls back to `empty-text`.
|
|
83798
|
+
* - `loading`: Content shown under the strip while `loading` is set and there are no readings yet. Falls back to `loading-text`.
|
|
83519
83799
|
*
|
|
83520
83800
|
* ## Methods
|
|
83521
83801
|
*
|
|
@@ -83607,9 +83887,12 @@ export type CustomElementsSolidJs = {
|
|
|
83607
83887
|
* - `tooltip-top`: The bubble while it is above the reading. Set alongside `tooltip`.
|
|
83608
83888
|
* - `tooltip-value`: A column's value inside the tooltip.
|
|
83609
83889
|
* - `cell-selected`: A cell that is selected, under `selection-mode`. Set alongside `cell`.
|
|
83610
|
-
* - `empty`:
|
|
83890
|
+
* - `empty`: The words under the strip 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, there being no document to resolve `for` in.
|
|
83611
83891
|
* - `end`: The trailing slot's box.
|
|
83892
|
+
* - `loading`: The words under the strip while `loading` is set and there are no readings: the `loading` slot, falling back to `loading-text`.
|
|
83612
83893
|
* - `overview`: The busiest reading and the total of the readings drawn, written as a sentence for screen readers, which describes the strip. Rendered once there are cells. Hide it visually.
|
|
83894
|
+
* - `plot`: The same element as `strip`, under the name every chart gives the drawing that takes focus.
|
|
83895
|
+
* - `row`: A column of cells, which a grid reads as a row, under `selection-mode`. It draws no box.
|
|
83613
83896
|
* - `selection`: A polite region that says how many cells are selected after a change, rendered from the first change. Hide it visually.
|
|
83614
83897
|
* - `start`: The leading slot's box.
|
|
83615
83898
|
* - `summary`: The middle slot's box.
|
|
@@ -83621,6 +83904,7 @@ export type CustomElementsSolidJs = {
|
|
|
83621
83904
|
*
|
|
83622
83905
|
* - `active`: While a cell is shown, under the pointer or the keys, with its tooltip open.
|
|
83623
83906
|
* - `empty`: While the `empty` part stands in place of the cells.
|
|
83907
|
+
* - `loading`: While the `loading` part stands in place of the cells.
|
|
83624
83908
|
* - `settled`: Set one frame after the first render. Transitions wait for it, so an element does not animate its own arrival.
|
|
83625
83909
|
*/
|
|
83626
83910
|
"helix-heatmap": Partial<
|
|
@@ -83863,6 +84147,15 @@ export type CustomElementsSolidJs = {
|
|
|
83863
84147
|
*
|
|
83864
84148
|
* Methods that can be called to access component functionality.
|
|
83865
84149
|
*
|
|
84150
|
+
* - `click() => void`: Presses the button, as `click()` presses a native one: the command is sent,
|
|
84151
|
+
* the form submits or resets, and `helix-press` says `virtual`.
|
|
84152
|
+
*
|
|
84153
|
+
* **Passed to the inner control, because a click on the host reaches nothing
|
|
84154
|
+
* that acts.** The control in the shadow root is what answers a click, so
|
|
84155
|
+
* `click()` from a script, an automation or a test, dispatched on the host,
|
|
84156
|
+
* submitted nothing and sent no `helix-press`. The control's own click reaches
|
|
84157
|
+
* the host's listeners once, retargeted, as one from a native button does. A
|
|
84158
|
+
* disabled button does nothing, and a pending one refuses the press.
|
|
83866
84159
|
* - `formAssociatedCallback(form: HTMLFormElement | null) => void`: Called by the browser when the control's form changes: watches the new
|
|
83867
84160
|
* form's `checkValidity()`, as connecting does for the form it starts in.
|
|
83868
84161
|
* - `formDisabledCallback(disabled: boolean) => void`: Called by the browser when an ancestor fieldset is disabled or enabled.
|
|
@@ -87795,6 +88088,9 @@ export type CustomElementsSolidJs = {
|
|
|
87795
88088
|
* `focus()` above already puts focus on the control inside the row rather than
|
|
87796
88089
|
* on the row, which is the whole of what moving here means.
|
|
87797
88090
|
* - `select() => void`: Chooses the row, the same as pressing it.
|
|
88091
|
+
* - `click() => void`: Presses the row, as `click()` presses a native button: passed to the
|
|
88092
|
+
* control inside, which is what answers a click, so a script's `click()`
|
|
88093
|
+
* chooses the row, or follows its link, once.
|
|
87798
88094
|
*
|
|
87799
88095
|
* ## CSS Custom Properties
|
|
87800
88096
|
*
|
|
@@ -94796,6 +95092,9 @@ export type CustomElementsSolidJs = {
|
|
|
94796
95092
|
* - `focus(options?: FocusOptions) => void`: Puts focus on the control inside the item.
|
|
94797
95093
|
* - `focusItem() => void`: Moves focus to the action. Part of `NavigableItem`, which the shared
|
|
94798
95094
|
* keyboard controller uses for the arrow keys.
|
|
95095
|
+
* - `click() => void`: Presses the action, as `click()` presses a native button: passed to the
|
|
95096
|
+
* control inside, which is what answers a click, so a script's `click()`
|
|
95097
|
+
* chooses the action and follows its link, once.
|
|
94799
95098
|
* - `select() => void`: Chooses the action, the same as pressing it.
|
|
94800
95099
|
*
|
|
94801
95100
|
* ## CSS Custom Properties
|
|
@@ -97067,6 +97366,9 @@ export type CustomElementsSolidJs = {
|
|
|
97067
97366
|
* disabled or a listener cancels the event.
|
|
97068
97367
|
* - `focus(options?: FocusOptions) => void`: Moves focus to the tab's control, the button or the link inside it, so a
|
|
97069
97368
|
* script can focus the tab the way it focuses a native one.
|
|
97369
|
+
* - `click() => void`: Presses the tab, as `click()` presses a native button: passed to the
|
|
97370
|
+
* control inside, which is what answers a click, so a script's `click()`
|
|
97371
|
+
* selects the tab, or follows its link, once.
|
|
97070
97372
|
*
|
|
97071
97373
|
* ## CSS Custom Properties
|
|
97072
97374
|
*
|
|
@@ -101850,6 +102152,8 @@ export type CustomCssProperties = {
|
|
|
101850
102152
|
"--aura-ground"?: (string) | undefined;
|
|
101851
102153
|
/** The faint stop between the ground and the glow. Defaults to `--helix-color-primary-subtle`. */
|
|
101852
102154
|
"--aura-haze"?: (string) | undefined;
|
|
102155
|
+
/** The pause control's ground. Defaults to `--helix-color-surface-overlay`. */
|
|
102156
|
+
"--aura-pause-background-color"?: (string) | undefined;
|
|
101853
102157
|
/** The hottest stop, at the center of a shape. Defaults to `--helix-color-primary-active` on a light page and `--helix-color-foreground` on a dark one. */
|
|
101854
102158
|
"--aura-peak"?: (string) | undefined;
|
|
101855
102159
|
/** The fill of the count of avatars past `max`. */
|