@fusion.dev/helix-headless 0.152.0 → 0.153.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 +685 -10
- package/dist/area-chart/root/area-chart-root.d.ts +16 -1
- package/dist/area-chart/root/area-chart-root.js +3 -3
- package/dist/bar-chart/root/bar-chart-root.d.ts +16 -1
- package/dist/bar-chart/root/bar-chart-root.js +3 -3
- package/dist/heatmap/root/heatmap-root.d.ts +3 -0
- package/dist/heatmap/root/heatmap-root.js +2 -8
- package/dist/line-chart/root/line-chart-root.d.ts +16 -1
- package/dist/line-chart/root/line-chart-root.js +3 -3
- package/dist/loader/root/loader-root.d.ts +5 -0
- package/dist/progress/root/progress-root.d.ts +16 -1
- package/dist/progress/root/progress-root.js +12 -4
- package/dist/scatter-chart/root/scatter-chart-root.d.ts +16 -1
- package/dist/scatter-chart/root/scatter-chart-root.js +3 -3
- package/lint.json +1 -1
- package/package.json +5 -5
- package/types/jsx.d.ts +1006 -6
- package/types/vue.d.ts +224 -8
- package/types/words.d.ts +56 -0
package/types/jsx.d.ts
CHANGED
|
@@ -1128,6 +1128,25 @@ them, and the tooltip and the table hold every reading. */
|
|
|
1128
1128
|
Absent draws none: bands read as a composition need no numbers beside
|
|
1129
1129
|
them, and the tooltip and the table hold every reading. */
|
|
1130
1130
|
valueAxis?: (HelixHeadlessAreaChart["valueAxis"]) | undefined;
|
|
1131
|
+
/** The words shown in place of the drawing when the table has no readings,
|
|
1132
|
+
and the fallback of the `empty` slot. */
|
|
1133
|
+
"empty-text"?: (HelixHeadlessAreaChart["emptyText"]) | undefined;
|
|
1134
|
+
/** The words shown in place of the drawing when the table has no readings,
|
|
1135
|
+
and the fallback of the `empty` slot. */
|
|
1136
|
+
emptyText?: (HelixHeadlessAreaChart["emptyText"]) | undefined;
|
|
1137
|
+
/** Whether the readings are still on their way. The chart shows
|
|
1138
|
+
`loading-text` in place of an empty drawing until it has readings.
|
|
1139
|
+
|
|
1140
|
+
Reflected, so a stylesheet can treat the chart while it waits. A chart
|
|
1141
|
+
that already has readings keeps drawing them, so a refresh does not
|
|
1142
|
+
blank it. */
|
|
1143
|
+
loading?: (HelixHeadlessAreaChart["loading"]) | undefined;
|
|
1144
|
+
/** The words shown in place of the drawing while `loading` is set and
|
|
1145
|
+
there are no readings yet, and the fallback of the `loading` slot. */
|
|
1146
|
+
"loading-text"?: (HelixHeadlessAreaChart["loadingText"]) | undefined;
|
|
1147
|
+
/** The words shown in place of the drawing while `loading` is set and
|
|
1148
|
+
there are no readings yet, and the fallback of the `loading` slot. */
|
|
1149
|
+
loadingText?: (HelixHeadlessAreaChart["loadingText"]) | undefined;
|
|
1131
1150
|
/** The id of the table to read.
|
|
1132
1151
|
|
|
1133
1152
|
Names a table in the same tree, so a chart inside another component's
|
|
@@ -1164,6 +1183,29 @@ Set it to the words of the page's language, such as `{position} von
|
|
|
1164
1183
|
{count}`, or to nothing to say no position. A slice or a series a
|
|
1165
1184
|
legend hid is not counted. */
|
|
1166
1185
|
positionLabel?: (HelixHeadlessAreaChart["positionLabel"]) | undefined;
|
|
1186
|
+
/** The readings as data, in the shape of a table, where the page has no
|
|
1187
|
+
table to point `for` at. `for` wins where both are set.
|
|
1188
|
+
|
|
1189
|
+
```js
|
|
1190
|
+
chart.data = {
|
|
1191
|
+
caption: 'Sessions by channel',
|
|
1192
|
+
columns: ['Month', 'Direct', 'Referral'],
|
|
1193
|
+
rows: [['Jan', 10, 4], ['Feb', 20, 8]],
|
|
1194
|
+
}
|
|
1195
|
+
```
|
|
1196
|
+
|
|
1197
|
+
The first column holds each row's label and every column after it a
|
|
1198
|
+
series, as in a table. A cell is a number, words, `null` for a blank,
|
|
1199
|
+
or `{ value, text }` for a number shown as words, such as `$128k`. A
|
|
1200
|
+
number is shown in `locale`.
|
|
1201
|
+
|
|
1202
|
+
**A table is still the better source where the page can show one**:
|
|
1203
|
+
it reads with no script and before hydration, and a reader can sort and
|
|
1204
|
+
copy it. Data is drawn on the client only, so a server serves the
|
|
1205
|
+
frame, and the summary, the keys and the readout are then the whole of
|
|
1206
|
+
what a screen reader is given. Set a new object to redraw: the chart
|
|
1207
|
+
does not look inside the one it has. */
|
|
1208
|
+
data?: (HelixHeadlessAreaChart["data"]) | undefined;
|
|
1167
1209
|
|
|
1168
1210
|
/** 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. */
|
|
1169
1211
|
"onhelix-reading-change"?: ((
|
|
@@ -1237,6 +1279,25 @@ them, and the tooltip and the table hold every reading. */
|
|
|
1237
1279
|
Absent draws none: bands read as a composition need no numbers beside
|
|
1238
1280
|
them, and the tooltip and the table hold every reading. */
|
|
1239
1281
|
"prop:valueAxis"?: (HelixHeadlessAreaChart["valueAxis"]) | undefined;
|
|
1282
|
+
/** The words shown in place of the drawing when the table has no readings,
|
|
1283
|
+
and the fallback of the `empty` slot. */
|
|
1284
|
+
"attr:empty-text"?: (HelixHeadlessAreaChart["emptyText"]) | undefined;
|
|
1285
|
+
/** The words shown in place of the drawing when the table has no readings,
|
|
1286
|
+
and the fallback of the `empty` slot. */
|
|
1287
|
+
"prop:emptyText"?: (HelixHeadlessAreaChart["emptyText"]) | undefined;
|
|
1288
|
+
/** Whether the readings are still on their way. The chart shows
|
|
1289
|
+
`loading-text` in place of an empty drawing until it has readings.
|
|
1290
|
+
|
|
1291
|
+
Reflected, so a stylesheet can treat the chart while it waits. A chart
|
|
1292
|
+
that already has readings keeps drawing them, so a refresh does not
|
|
1293
|
+
blank it. */
|
|
1294
|
+
"prop:loading"?: (HelixHeadlessAreaChart["loading"]) | undefined;
|
|
1295
|
+
/** The words shown in place of the drawing while `loading` is set and
|
|
1296
|
+
there are no readings yet, and the fallback of the `loading` slot. */
|
|
1297
|
+
"attr:loading-text"?: (HelixHeadlessAreaChart["loadingText"]) | undefined;
|
|
1298
|
+
/** The words shown in place of the drawing while `loading` is set and
|
|
1299
|
+
there are no readings yet, and the fallback of the `loading` slot. */
|
|
1300
|
+
"prop:loadingText"?: (HelixHeadlessAreaChart["loadingText"]) | undefined;
|
|
1240
1301
|
/** The id of the table to read.
|
|
1241
1302
|
|
|
1242
1303
|
Names a table in the same tree, so a chart inside another component's
|
|
@@ -1273,6 +1334,29 @@ Set it to the words of the page's language, such as `{position} von
|
|
|
1273
1334
|
{count}`, or to nothing to say no position. A slice or a series a
|
|
1274
1335
|
legend hid is not counted. */
|
|
1275
1336
|
"prop:positionLabel"?: (HelixHeadlessAreaChart["positionLabel"]) | undefined;
|
|
1337
|
+
/** The readings as data, in the shape of a table, where the page has no
|
|
1338
|
+
table to point `for` at. `for` wins where both are set.
|
|
1339
|
+
|
|
1340
|
+
```js
|
|
1341
|
+
chart.data = {
|
|
1342
|
+
caption: 'Sessions by channel',
|
|
1343
|
+
columns: ['Month', 'Direct', 'Referral'],
|
|
1344
|
+
rows: [['Jan', 10, 4], ['Feb', 20, 8]],
|
|
1345
|
+
}
|
|
1346
|
+
```
|
|
1347
|
+
|
|
1348
|
+
The first column holds each row's label and every column after it a
|
|
1349
|
+
series, as in a table. A cell is a number, words, `null` for a blank,
|
|
1350
|
+
or `{ value, text }` for a number shown as words, such as `$128k`. A
|
|
1351
|
+
number is shown in `locale`.
|
|
1352
|
+
|
|
1353
|
+
**A table is still the better source where the page can show one**:
|
|
1354
|
+
it reads with no script and before hydration, and a reader can sort and
|
|
1355
|
+
copy it. Data is drawn on the client only, so a server serves the
|
|
1356
|
+
frame, and the summary, the keys and the readout are then the whole of
|
|
1357
|
+
what a screen reader is given. Set a new object to redraw: the chart
|
|
1358
|
+
does not look inside the one it has. */
|
|
1359
|
+
"prop:data"?: (HelixHeadlessAreaChart["data"]) | undefined;
|
|
1276
1360
|
/** 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. */
|
|
1277
1361
|
"on:helix-reading-change"?: ((
|
|
1278
1362
|
e: HelixHeadlessAreaChartHelixReadingChangeElementEvent,
|
|
@@ -1734,6 +1818,25 @@ bottom of bars under `orientation="horizontal"`.
|
|
|
1734
1818
|
Absent draws none with one scale, since bars compared with each other need
|
|
1735
1819
|
no numbers. With `secondary` both scales are drawn whatever this says. */
|
|
1736
1820
|
valueAxis?: (HelixHeadlessBarChart["valueAxis"]) | undefined;
|
|
1821
|
+
/** The words shown in place of the drawing when the table has no readings,
|
|
1822
|
+
and the fallback of the `empty` slot. */
|
|
1823
|
+
"empty-text"?: (HelixHeadlessBarChart["emptyText"]) | undefined;
|
|
1824
|
+
/** The words shown in place of the drawing when the table has no readings,
|
|
1825
|
+
and the fallback of the `empty` slot. */
|
|
1826
|
+
emptyText?: (HelixHeadlessBarChart["emptyText"]) | undefined;
|
|
1827
|
+
/** Whether the readings are still on their way. The chart shows
|
|
1828
|
+
`loading-text` in place of an empty drawing until it has readings.
|
|
1829
|
+
|
|
1830
|
+
Reflected, so a stylesheet can treat the chart while it waits. A chart
|
|
1831
|
+
that already has readings keeps drawing them, so a refresh does not
|
|
1832
|
+
blank it. */
|
|
1833
|
+
loading?: (HelixHeadlessBarChart["loading"]) | undefined;
|
|
1834
|
+
/** The words shown in place of the drawing while `loading` is set and
|
|
1835
|
+
there are no readings yet, and the fallback of the `loading` slot. */
|
|
1836
|
+
"loading-text"?: (HelixHeadlessBarChart["loadingText"]) | undefined;
|
|
1837
|
+
/** The words shown in place of the drawing while `loading` is set and
|
|
1838
|
+
there are no readings yet, and the fallback of the `loading` slot. */
|
|
1839
|
+
loadingText?: (HelixHeadlessBarChart["loadingText"]) | undefined;
|
|
1737
1840
|
/** The id of the table to read.
|
|
1738
1841
|
|
|
1739
1842
|
Names a table in the same tree, so a chart inside another component's
|
|
@@ -1770,6 +1873,29 @@ Set it to the words of the page's language, such as `{position} von
|
|
|
1770
1873
|
{count}`, or to nothing to say no position. A slice or a series a
|
|
1771
1874
|
legend hid is not counted. */
|
|
1772
1875
|
positionLabel?: (HelixHeadlessBarChart["positionLabel"]) | undefined;
|
|
1876
|
+
/** The readings as data, in the shape of a table, where the page has no
|
|
1877
|
+
table to point `for` at. `for` wins where both are set.
|
|
1878
|
+
|
|
1879
|
+
```js
|
|
1880
|
+
chart.data = {
|
|
1881
|
+
caption: 'Sessions by channel',
|
|
1882
|
+
columns: ['Month', 'Direct', 'Referral'],
|
|
1883
|
+
rows: [['Jan', 10, 4], ['Feb', 20, 8]],
|
|
1884
|
+
}
|
|
1885
|
+
```
|
|
1886
|
+
|
|
1887
|
+
The first column holds each row's label and every column after it a
|
|
1888
|
+
series, as in a table. A cell is a number, words, `null` for a blank,
|
|
1889
|
+
or `{ value, text }` for a number shown as words, such as `$128k`. A
|
|
1890
|
+
number is shown in `locale`.
|
|
1891
|
+
|
|
1892
|
+
**A table is still the better source where the page can show one**:
|
|
1893
|
+
it reads with no script and before hydration, and a reader can sort and
|
|
1894
|
+
copy it. Data is drawn on the client only, so a server serves the
|
|
1895
|
+
frame, and the summary, the keys and the readout are then the whole of
|
|
1896
|
+
what a screen reader is given. Set a new object to redraw: the chart
|
|
1897
|
+
does not look inside the one it has. */
|
|
1898
|
+
data?: (HelixHeadlessBarChart["data"]) | undefined;
|
|
1773
1899
|
|
|
1774
1900
|
/** 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. */
|
|
1775
1901
|
"onhelix-reading-change"?: ((
|
|
@@ -1905,6 +2031,25 @@ bottom of bars under `orientation="horizontal"`.
|
|
|
1905
2031
|
Absent draws none with one scale, since bars compared with each other need
|
|
1906
2032
|
no numbers. With `secondary` both scales are drawn whatever this says. */
|
|
1907
2033
|
"prop:valueAxis"?: (HelixHeadlessBarChart["valueAxis"]) | undefined;
|
|
2034
|
+
/** The words shown in place of the drawing when the table has no readings,
|
|
2035
|
+
and the fallback of the `empty` slot. */
|
|
2036
|
+
"attr:empty-text"?: (HelixHeadlessBarChart["emptyText"]) | undefined;
|
|
2037
|
+
/** The words shown in place of the drawing when the table has no readings,
|
|
2038
|
+
and the fallback of the `empty` slot. */
|
|
2039
|
+
"prop:emptyText"?: (HelixHeadlessBarChart["emptyText"]) | undefined;
|
|
2040
|
+
/** Whether the readings are still on their way. The chart shows
|
|
2041
|
+
`loading-text` in place of an empty drawing until it has readings.
|
|
2042
|
+
|
|
2043
|
+
Reflected, so a stylesheet can treat the chart while it waits. A chart
|
|
2044
|
+
that already has readings keeps drawing them, so a refresh does not
|
|
2045
|
+
blank it. */
|
|
2046
|
+
"prop:loading"?: (HelixHeadlessBarChart["loading"]) | undefined;
|
|
2047
|
+
/** The words shown in place of the drawing while `loading` is set and
|
|
2048
|
+
there are no readings yet, and the fallback of the `loading` slot. */
|
|
2049
|
+
"attr:loading-text"?: (HelixHeadlessBarChart["loadingText"]) | undefined;
|
|
2050
|
+
/** The words shown in place of the drawing while `loading` is set and
|
|
2051
|
+
there are no readings yet, and the fallback of the `loading` slot. */
|
|
2052
|
+
"prop:loadingText"?: (HelixHeadlessBarChart["loadingText"]) | undefined;
|
|
1908
2053
|
/** The id of the table to read.
|
|
1909
2054
|
|
|
1910
2055
|
Names a table in the same tree, so a chart inside another component's
|
|
@@ -1941,6 +2086,29 @@ Set it to the words of the page's language, such as `{position} von
|
|
|
1941
2086
|
{count}`, or to nothing to say no position. A slice or a series a
|
|
1942
2087
|
legend hid is not counted. */
|
|
1943
2088
|
"prop:positionLabel"?: (HelixHeadlessBarChart["positionLabel"]) | undefined;
|
|
2089
|
+
/** The readings as data, in the shape of a table, where the page has no
|
|
2090
|
+
table to point `for` at. `for` wins where both are set.
|
|
2091
|
+
|
|
2092
|
+
```js
|
|
2093
|
+
chart.data = {
|
|
2094
|
+
caption: 'Sessions by channel',
|
|
2095
|
+
columns: ['Month', 'Direct', 'Referral'],
|
|
2096
|
+
rows: [['Jan', 10, 4], ['Feb', 20, 8]],
|
|
2097
|
+
}
|
|
2098
|
+
```
|
|
2099
|
+
|
|
2100
|
+
The first column holds each row's label and every column after it a
|
|
2101
|
+
series, as in a table. A cell is a number, words, `null` for a blank,
|
|
2102
|
+
or `{ value, text }` for a number shown as words, such as `$128k`. A
|
|
2103
|
+
number is shown in `locale`.
|
|
2104
|
+
|
|
2105
|
+
**A table is still the better source where the page can show one**:
|
|
2106
|
+
it reads with no script and before hydration, and a reader can sort and
|
|
2107
|
+
copy it. Data is drawn on the client only, so a server serves the
|
|
2108
|
+
frame, and the summary, the keys and the readout are then the whole of
|
|
2109
|
+
what a screen reader is given. Set a new object to redraw: the chart
|
|
2110
|
+
does not look inside the one it has. */
|
|
2111
|
+
"prop:data"?: (HelixHeadlessBarChart["data"]) | undefined;
|
|
1944
2112
|
/** 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. */
|
|
1945
2113
|
"on:helix-reading-change"?: ((
|
|
1946
2114
|
e: HelixHeadlessBarChartHelixReadingChangeElementEvent,
|
|
@@ -11147,6 +11315,29 @@ Set it to the words of the page's language, such as `{position} von
|
|
|
11147
11315
|
{count}`, or to nothing to say no position. A slice or a series a
|
|
11148
11316
|
legend hid is not counted. */
|
|
11149
11317
|
positionLabel?: (HelixHeadlessDonutChart["positionLabel"]) | undefined;
|
|
11318
|
+
/** The readings as data, in the shape of a table, where the page has no
|
|
11319
|
+
table to point `for` at. `for` wins where both are set.
|
|
11320
|
+
|
|
11321
|
+
```js
|
|
11322
|
+
chart.data = {
|
|
11323
|
+
caption: 'Sessions by channel',
|
|
11324
|
+
columns: ['Month', 'Direct', 'Referral'],
|
|
11325
|
+
rows: [['Jan', 10, 4], ['Feb', 20, 8]],
|
|
11326
|
+
}
|
|
11327
|
+
```
|
|
11328
|
+
|
|
11329
|
+
The first column holds each row's label and every column after it a
|
|
11330
|
+
series, as in a table. A cell is a number, words, `null` for a blank,
|
|
11331
|
+
or `{ value, text }` for a number shown as words, such as `$128k`. A
|
|
11332
|
+
number is shown in `locale`.
|
|
11333
|
+
|
|
11334
|
+
**A table is still the better source where the page can show one**:
|
|
11335
|
+
it reads with no script and before hydration, and a reader can sort and
|
|
11336
|
+
copy it. Data is drawn on the client only, so a server serves the
|
|
11337
|
+
frame, and the summary, the keys and the readout are then the whole of
|
|
11338
|
+
what a screen reader is given. Set a new object to redraw: the chart
|
|
11339
|
+
does not look inside the one it has. */
|
|
11340
|
+
data?: (HelixHeadlessDonutChart["data"]) | undefined;
|
|
11150
11341
|
};
|
|
11151
11342
|
|
|
11152
11343
|
export type HelixHeadlessDonutChartSolidJsProps = {
|
|
@@ -11250,6 +11441,29 @@ Set it to the words of the page's language, such as `{position} von
|
|
|
11250
11441
|
{count}`, or to nothing to say no position. A slice or a series a
|
|
11251
11442
|
legend hid is not counted. */
|
|
11252
11443
|
"prop:positionLabel"?: (HelixHeadlessDonutChart["positionLabel"]) | undefined;
|
|
11444
|
+
/** The readings as data, in the shape of a table, where the page has no
|
|
11445
|
+
table to point `for` at. `for` wins where both are set.
|
|
11446
|
+
|
|
11447
|
+
```js
|
|
11448
|
+
chart.data = {
|
|
11449
|
+
caption: 'Sessions by channel',
|
|
11450
|
+
columns: ['Month', 'Direct', 'Referral'],
|
|
11451
|
+
rows: [['Jan', 10, 4], ['Feb', 20, 8]],
|
|
11452
|
+
}
|
|
11453
|
+
```
|
|
11454
|
+
|
|
11455
|
+
The first column holds each row's label and every column after it a
|
|
11456
|
+
series, as in a table. A cell is a number, words, `null` for a blank,
|
|
11457
|
+
or `{ value, text }` for a number shown as words, such as `$128k`. A
|
|
11458
|
+
number is shown in `locale`.
|
|
11459
|
+
|
|
11460
|
+
**A table is still the better source where the page can show one**:
|
|
11461
|
+
it reads with no script and before hydration, and a reader can sort and
|
|
11462
|
+
copy it. Data is drawn on the client only, so a server serves the
|
|
11463
|
+
frame, and the summary, the keys and the readout are then the whole of
|
|
11464
|
+
what a screen reader is given. Set a new object to redraw: the chart
|
|
11465
|
+
does not look inside the one it has. */
|
|
11466
|
+
"prop:data"?: (HelixHeadlessDonutChart["data"]) | undefined;
|
|
11253
11467
|
|
|
11254
11468
|
/** Set the innerHTML of the element */
|
|
11255
11469
|
innerHTML?: (string) | undefined;
|
|
@@ -13888,6 +14102,29 @@ Set it to the words of the page's language, such as `{position} von
|
|
|
13888
14102
|
{count}`, or to nothing to say no position. A slice or a series a
|
|
13889
14103
|
legend hid is not counted. */
|
|
13890
14104
|
positionLabel?: (HelixHeadlessHeatmap["positionLabel"]) | undefined;
|
|
14105
|
+
/** The readings as data, in the shape of a table, where the page has no
|
|
14106
|
+
table to point `for` at. `for` wins where both are set.
|
|
14107
|
+
|
|
14108
|
+
```js
|
|
14109
|
+
chart.data = {
|
|
14110
|
+
caption: 'Sessions by channel',
|
|
14111
|
+
columns: ['Month', 'Direct', 'Referral'],
|
|
14112
|
+
rows: [['Jan', 10, 4], ['Feb', 20, 8]],
|
|
14113
|
+
}
|
|
14114
|
+
```
|
|
14115
|
+
|
|
14116
|
+
The first column holds each row's label and every column after it a
|
|
14117
|
+
series, as in a table. A cell is a number, words, `null` for a blank,
|
|
14118
|
+
or `{ value, text }` for a number shown as words, such as `$128k`. A
|
|
14119
|
+
number is shown in `locale`.
|
|
14120
|
+
|
|
14121
|
+
**A table is still the better source where the page can show one**:
|
|
14122
|
+
it reads with no script and before hydration, and a reader can sort and
|
|
14123
|
+
copy it. Data is drawn on the client only, so a server serves the
|
|
14124
|
+
frame, and the summary, the keys and the readout are then the whole of
|
|
14125
|
+
what a screen reader is given. Set a new object to redraw: the chart
|
|
14126
|
+
does not look inside the one it has. */
|
|
14127
|
+
data?: (HelixHeadlessHeatmap["data"]) | undefined;
|
|
13891
14128
|
|
|
13892
14129
|
/** Fired once a press or a key has changed which cells are selected. */
|
|
13893
14130
|
onchange?: ((e: HelixHeadlessHeatmapElementEvent) => void) | undefined;
|
|
@@ -14071,6 +14308,29 @@ Set it to the words of the page's language, such as `{position} von
|
|
|
14071
14308
|
{count}`, or to nothing to say no position. A slice or a series a
|
|
14072
14309
|
legend hid is not counted. */
|
|
14073
14310
|
"prop:positionLabel"?: (HelixHeadlessHeatmap["positionLabel"]) | undefined;
|
|
14311
|
+
/** The readings as data, in the shape of a table, where the page has no
|
|
14312
|
+
table to point `for` at. `for` wins where both are set.
|
|
14313
|
+
|
|
14314
|
+
```js
|
|
14315
|
+
chart.data = {
|
|
14316
|
+
caption: 'Sessions by channel',
|
|
14317
|
+
columns: ['Month', 'Direct', 'Referral'],
|
|
14318
|
+
rows: [['Jan', 10, 4], ['Feb', 20, 8]],
|
|
14319
|
+
}
|
|
14320
|
+
```
|
|
14321
|
+
|
|
14322
|
+
The first column holds each row's label and every column after it a
|
|
14323
|
+
series, as in a table. A cell is a number, words, `null` for a blank,
|
|
14324
|
+
or `{ value, text }` for a number shown as words, such as `$128k`. A
|
|
14325
|
+
number is shown in `locale`.
|
|
14326
|
+
|
|
14327
|
+
**A table is still the better source where the page can show one**:
|
|
14328
|
+
it reads with no script and before hydration, and a reader can sort and
|
|
14329
|
+
copy it. Data is drawn on the client only, so a server serves the
|
|
14330
|
+
frame, and the summary, the keys and the readout are then the whole of
|
|
14331
|
+
what a screen reader is given. Set a new object to redraw: the chart
|
|
14332
|
+
does not look inside the one it has. */
|
|
14333
|
+
"prop:data"?: (HelixHeadlessHeatmap["data"]) | undefined;
|
|
14074
14334
|
/** Fired once a press or a key has changed which cells are selected. */
|
|
14075
14335
|
"on:change"?: ((e: HelixHeadlessHeatmapElementEvent) => void) | undefined;
|
|
14076
14336
|
/** Fired before a press or a key changes which cells are selected, with the `value` it would leave. Cancelable. */
|
|
@@ -16031,6 +16291,25 @@ Set it where the distance from nothing is the point rather than the shape,
|
|
|
16031
16291
|
and accept that a series which never approaches zero becomes a flat rule
|
|
16032
16292
|
near the top of the box. */
|
|
16033
16293
|
zero?: (HelixHeadlessLineChart["zero"]) | undefined;
|
|
16294
|
+
/** The words shown in place of the drawing when the table has no readings,
|
|
16295
|
+
and the fallback of the `empty` slot. */
|
|
16296
|
+
"empty-text"?: (HelixHeadlessLineChart["emptyText"]) | undefined;
|
|
16297
|
+
/** The words shown in place of the drawing when the table has no readings,
|
|
16298
|
+
and the fallback of the `empty` slot. */
|
|
16299
|
+
emptyText?: (HelixHeadlessLineChart["emptyText"]) | undefined;
|
|
16300
|
+
/** Whether the readings are still on their way. The chart shows
|
|
16301
|
+
`loading-text` in place of an empty drawing until it has readings.
|
|
16302
|
+
|
|
16303
|
+
Reflected, so a stylesheet can treat the chart while it waits. A chart
|
|
16304
|
+
that already has readings keeps drawing them, so a refresh does not
|
|
16305
|
+
blank it. */
|
|
16306
|
+
loading?: (HelixHeadlessLineChart["loading"]) | undefined;
|
|
16307
|
+
/** The words shown in place of the drawing while `loading` is set and
|
|
16308
|
+
there are no readings yet, and the fallback of the `loading` slot. */
|
|
16309
|
+
"loading-text"?: (HelixHeadlessLineChart["loadingText"]) | undefined;
|
|
16310
|
+
/** The words shown in place of the drawing while `loading` is set and
|
|
16311
|
+
there are no readings yet, and the fallback of the `loading` slot. */
|
|
16312
|
+
loadingText?: (HelixHeadlessLineChart["loadingText"]) | undefined;
|
|
16034
16313
|
/** The id of the table to read.
|
|
16035
16314
|
|
|
16036
16315
|
Names a table in the same tree, so a chart inside another component's
|
|
@@ -16067,6 +16346,29 @@ Set it to the words of the page's language, such as `{position} von
|
|
|
16067
16346
|
{count}`, or to nothing to say no position. A slice or a series a
|
|
16068
16347
|
legend hid is not counted. */
|
|
16069
16348
|
positionLabel?: (HelixHeadlessLineChart["positionLabel"]) | undefined;
|
|
16349
|
+
/** The readings as data, in the shape of a table, where the page has no
|
|
16350
|
+
table to point `for` at. `for` wins where both are set.
|
|
16351
|
+
|
|
16352
|
+
```js
|
|
16353
|
+
chart.data = {
|
|
16354
|
+
caption: 'Sessions by channel',
|
|
16355
|
+
columns: ['Month', 'Direct', 'Referral'],
|
|
16356
|
+
rows: [['Jan', 10, 4], ['Feb', 20, 8]],
|
|
16357
|
+
}
|
|
16358
|
+
```
|
|
16359
|
+
|
|
16360
|
+
The first column holds each row's label and every column after it a
|
|
16361
|
+
series, as in a table. A cell is a number, words, `null` for a blank,
|
|
16362
|
+
or `{ value, text }` for a number shown as words, such as `$128k`. A
|
|
16363
|
+
number is shown in `locale`.
|
|
16364
|
+
|
|
16365
|
+
**A table is still the better source where the page can show one**:
|
|
16366
|
+
it reads with no script and before hydration, and a reader can sort and
|
|
16367
|
+
copy it. Data is drawn on the client only, so a server serves the
|
|
16368
|
+
frame, and the summary, the keys and the readout are then the whole of
|
|
16369
|
+
what a screen reader is given. Set a new object to redraw: the chart
|
|
16370
|
+
does not look inside the one it has. */
|
|
16371
|
+
data?: (HelixHeadlessLineChart["data"]) | undefined;
|
|
16070
16372
|
|
|
16071
16373
|
/** 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. */
|
|
16072
16374
|
"onhelix-reading-change"?: ((
|
|
@@ -16200,6 +16502,25 @@ Set it where the distance from nothing is the point rather than the shape,
|
|
|
16200
16502
|
and accept that a series which never approaches zero becomes a flat rule
|
|
16201
16503
|
near the top of the box. */
|
|
16202
16504
|
"prop:zero"?: (HelixHeadlessLineChart["zero"]) | undefined;
|
|
16505
|
+
/** The words shown in place of the drawing when the table has no readings,
|
|
16506
|
+
and the fallback of the `empty` slot. */
|
|
16507
|
+
"attr:empty-text"?: (HelixHeadlessLineChart["emptyText"]) | undefined;
|
|
16508
|
+
/** The words shown in place of the drawing when the table has no readings,
|
|
16509
|
+
and the fallback of the `empty` slot. */
|
|
16510
|
+
"prop:emptyText"?: (HelixHeadlessLineChart["emptyText"]) | undefined;
|
|
16511
|
+
/** Whether the readings are still on their way. The chart shows
|
|
16512
|
+
`loading-text` in place of an empty drawing until it has readings.
|
|
16513
|
+
|
|
16514
|
+
Reflected, so a stylesheet can treat the chart while it waits. A chart
|
|
16515
|
+
that already has readings keeps drawing them, so a refresh does not
|
|
16516
|
+
blank it. */
|
|
16517
|
+
"prop:loading"?: (HelixHeadlessLineChart["loading"]) | undefined;
|
|
16518
|
+
/** The words shown in place of the drawing while `loading` is set and
|
|
16519
|
+
there are no readings yet, and the fallback of the `loading` slot. */
|
|
16520
|
+
"attr:loading-text"?: (HelixHeadlessLineChart["loadingText"]) | undefined;
|
|
16521
|
+
/** The words shown in place of the drawing while `loading` is set and
|
|
16522
|
+
there are no readings yet, and the fallback of the `loading` slot. */
|
|
16523
|
+
"prop:loadingText"?: (HelixHeadlessLineChart["loadingText"]) | undefined;
|
|
16203
16524
|
/** The id of the table to read.
|
|
16204
16525
|
|
|
16205
16526
|
Names a table in the same tree, so a chart inside another component's
|
|
@@ -16236,6 +16557,29 @@ Set it to the words of the page's language, such as `{position} von
|
|
|
16236
16557
|
{count}`, or to nothing to say no position. A slice or a series a
|
|
16237
16558
|
legend hid is not counted. */
|
|
16238
16559
|
"prop:positionLabel"?: (HelixHeadlessLineChart["positionLabel"]) | undefined;
|
|
16560
|
+
/** The readings as data, in the shape of a table, where the page has no
|
|
16561
|
+
table to point `for` at. `for` wins where both are set.
|
|
16562
|
+
|
|
16563
|
+
```js
|
|
16564
|
+
chart.data = {
|
|
16565
|
+
caption: 'Sessions by channel',
|
|
16566
|
+
columns: ['Month', 'Direct', 'Referral'],
|
|
16567
|
+
rows: [['Jan', 10, 4], ['Feb', 20, 8]],
|
|
16568
|
+
}
|
|
16569
|
+
```
|
|
16570
|
+
|
|
16571
|
+
The first column holds each row's label and every column after it a
|
|
16572
|
+
series, as in a table. A cell is a number, words, `null` for a blank,
|
|
16573
|
+
or `{ value, text }` for a number shown as words, such as `$128k`. A
|
|
16574
|
+
number is shown in `locale`.
|
|
16575
|
+
|
|
16576
|
+
**A table is still the better source where the page can show one**:
|
|
16577
|
+
it reads with no script and before hydration, and a reader can sort and
|
|
16578
|
+
copy it. Data is drawn on the client only, so a server serves the
|
|
16579
|
+
frame, and the summary, the keys and the readout are then the whole of
|
|
16580
|
+
what a screen reader is given. Set a new object to redraw: the chart
|
|
16581
|
+
does not look inside the one it has. */
|
|
16582
|
+
"prop:data"?: (HelixHeadlessLineChart["data"]) | undefined;
|
|
16239
16583
|
/** 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. */
|
|
16240
16584
|
"on:helix-reading-change"?: ((
|
|
16241
16585
|
e: HelixHeadlessLineChartHelixReadingChangeElementEvent,
|
|
@@ -22352,7 +22696,8 @@ decimals. Written as JSON in the attribute.
|
|
|
22352
22696
|
|
|
22353
22697
|
A `percent` style writes the share of the range, and any other the value
|
|
22354
22698
|
itself, so the example says "18 GB". Absent is a whole percentage. The
|
|
22355
|
-
words are announced
|
|
22699
|
+
words are announced whether or not `show-value` shows them. `value-text`
|
|
22700
|
+
still wins. */
|
|
22356
22701
|
"format-options"?: (HelixHeadlessProgress["formatOptions"]) | undefined;
|
|
22357
22702
|
/** `Intl.NumberFormat` options the reading is written with, as React Aria's
|
|
22358
22703
|
Meter and ProgressBar take them: a unit, a currency, or a number of
|
|
@@ -22364,7 +22709,8 @@ decimals. Written as JSON in the attribute.
|
|
|
22364
22709
|
|
|
22365
22710
|
A `percent` style writes the share of the range, and any other the value
|
|
22366
22711
|
itself, so the example says "18 GB". Absent is a whole percentage. The
|
|
22367
|
-
words are announced
|
|
22712
|
+
words are announced whether or not `show-value` shows them. `value-text`
|
|
22713
|
+
still wins. */
|
|
22368
22714
|
formatOptions?: (HelixHeadlessProgress["formatOptions"]) | undefined;
|
|
22369
22715
|
/** Whether the length of the task is unknown. The bar then shows activity
|
|
22370
22716
|
without a value.
|
|
@@ -22480,7 +22826,8 @@ decimals. Written as JSON in the attribute.
|
|
|
22480
22826
|
|
|
22481
22827
|
A `percent` style writes the share of the range, and any other the value
|
|
22482
22828
|
itself, so the example says "18 GB". Absent is a whole percentage. The
|
|
22483
|
-
words are announced
|
|
22829
|
+
words are announced whether or not `show-value` shows them. `value-text`
|
|
22830
|
+
still wins. */
|
|
22484
22831
|
"attr:format-options"?: (HelixHeadlessProgress["formatOptions"]) | undefined;
|
|
22485
22832
|
/** `Intl.NumberFormat` options the reading is written with, as React Aria's
|
|
22486
22833
|
Meter and ProgressBar take them: a unit, a currency, or a number of
|
|
@@ -22492,7 +22839,8 @@ decimals. Written as JSON in the attribute.
|
|
|
22492
22839
|
|
|
22493
22840
|
A `percent` style writes the share of the range, and any other the value
|
|
22494
22841
|
itself, so the example says "18 GB". Absent is a whole percentage. The
|
|
22495
|
-
words are announced
|
|
22842
|
+
words are announced whether or not `show-value` shows them. `value-text`
|
|
22843
|
+
still wins. */
|
|
22496
22844
|
"prop:formatOptions"?: (HelixHeadlessProgress["formatOptions"]) | undefined;
|
|
22497
22845
|
/** Whether the length of the task is unknown. The bar then shows activity
|
|
22498
22846
|
without a value.
|
|
@@ -23576,6 +23924,25 @@ Absent draws none. A series with fewer than two points, or with every
|
|
|
23576
23924
|
point at one measure across, has no line to draw. The summary already
|
|
23577
23925
|
gives each series' correlation, which says how near the points are to it. */
|
|
23578
23926
|
trend?: (HelixHeadlessScatterChart["trend"]) | undefined;
|
|
23927
|
+
/** The words shown in place of the drawing when the table has no readings,
|
|
23928
|
+
and the fallback of the `empty` slot. */
|
|
23929
|
+
"empty-text"?: (HelixHeadlessScatterChart["emptyText"]) | undefined;
|
|
23930
|
+
/** The words shown in place of the drawing when the table has no readings,
|
|
23931
|
+
and the fallback of the `empty` slot. */
|
|
23932
|
+
emptyText?: (HelixHeadlessScatterChart["emptyText"]) | undefined;
|
|
23933
|
+
/** Whether the readings are still on their way. The chart shows
|
|
23934
|
+
`loading-text` in place of an empty drawing until it has readings.
|
|
23935
|
+
|
|
23936
|
+
Reflected, so a stylesheet can treat the chart while it waits. A chart
|
|
23937
|
+
that already has readings keeps drawing them, so a refresh does not
|
|
23938
|
+
blank it. */
|
|
23939
|
+
loading?: (HelixHeadlessScatterChart["loading"]) | undefined;
|
|
23940
|
+
/** The words shown in place of the drawing while `loading` is set and
|
|
23941
|
+
there are no readings yet, and the fallback of the `loading` slot. */
|
|
23942
|
+
"loading-text"?: (HelixHeadlessScatterChart["loadingText"]) | undefined;
|
|
23943
|
+
/** The words shown in place of the drawing while `loading` is set and
|
|
23944
|
+
there are no readings yet, and the fallback of the `loading` slot. */
|
|
23945
|
+
loadingText?: (HelixHeadlessScatterChart["loadingText"]) | undefined;
|
|
23579
23946
|
/** The id of the table to read.
|
|
23580
23947
|
|
|
23581
23948
|
Names a table in the same tree, so a chart inside another component's
|
|
@@ -23612,6 +23979,29 @@ Set it to the words of the page's language, such as `{position} von
|
|
|
23612
23979
|
{count}`, or to nothing to say no position. A slice or a series a
|
|
23613
23980
|
legend hid is not counted. */
|
|
23614
23981
|
positionLabel?: (HelixHeadlessScatterChart["positionLabel"]) | undefined;
|
|
23982
|
+
/** The readings as data, in the shape of a table, where the page has no
|
|
23983
|
+
table to point `for` at. `for` wins where both are set.
|
|
23984
|
+
|
|
23985
|
+
```js
|
|
23986
|
+
chart.data = {
|
|
23987
|
+
caption: 'Sessions by channel',
|
|
23988
|
+
columns: ['Month', 'Direct', 'Referral'],
|
|
23989
|
+
rows: [['Jan', 10, 4], ['Feb', 20, 8]],
|
|
23990
|
+
}
|
|
23991
|
+
```
|
|
23992
|
+
|
|
23993
|
+
The first column holds each row's label and every column after it a
|
|
23994
|
+
series, as in a table. A cell is a number, words, `null` for a blank,
|
|
23995
|
+
or `{ value, text }` for a number shown as words, such as `$128k`. A
|
|
23996
|
+
number is shown in `locale`.
|
|
23997
|
+
|
|
23998
|
+
**A table is still the better source where the page can show one**:
|
|
23999
|
+
it reads with no script and before hydration, and a reader can sort and
|
|
24000
|
+
copy it. Data is drawn on the client only, so a server serves the
|
|
24001
|
+
frame, and the summary, the keys and the readout are then the whole of
|
|
24002
|
+
what a screen reader is given. Set a new object to redraw: the chart
|
|
24003
|
+
does not look inside the one it has. */
|
|
24004
|
+
data?: (HelixHeadlessScatterChart["data"]) | undefined;
|
|
23615
24005
|
|
|
23616
24006
|
/** 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. */
|
|
23617
24007
|
"onhelix-reading-change"?: ((
|
|
@@ -23683,6 +24073,25 @@ Absent draws none. A series with fewer than two points, or with every
|
|
|
23683
24073
|
point at one measure across, has no line to draw. The summary already
|
|
23684
24074
|
gives each series' correlation, which says how near the points are to it. */
|
|
23685
24075
|
"prop:trend"?: (HelixHeadlessScatterChart["trend"]) | undefined;
|
|
24076
|
+
/** The words shown in place of the drawing when the table has no readings,
|
|
24077
|
+
and the fallback of the `empty` slot. */
|
|
24078
|
+
"attr:empty-text"?: (HelixHeadlessScatterChart["emptyText"]) | undefined;
|
|
24079
|
+
/** The words shown in place of the drawing when the table has no readings,
|
|
24080
|
+
and the fallback of the `empty` slot. */
|
|
24081
|
+
"prop:emptyText"?: (HelixHeadlessScatterChart["emptyText"]) | undefined;
|
|
24082
|
+
/** Whether the readings are still on their way. The chart shows
|
|
24083
|
+
`loading-text` in place of an empty drawing until it has readings.
|
|
24084
|
+
|
|
24085
|
+
Reflected, so a stylesheet can treat the chart while it waits. A chart
|
|
24086
|
+
that already has readings keeps drawing them, so a refresh does not
|
|
24087
|
+
blank it. */
|
|
24088
|
+
"prop:loading"?: (HelixHeadlessScatterChart["loading"]) | undefined;
|
|
24089
|
+
/** The words shown in place of the drawing while `loading` is set and
|
|
24090
|
+
there are no readings yet, and the fallback of the `loading` slot. */
|
|
24091
|
+
"attr:loading-text"?: (HelixHeadlessScatterChart["loadingText"]) | undefined;
|
|
24092
|
+
/** The words shown in place of the drawing while `loading` is set and
|
|
24093
|
+
there are no readings yet, and the fallback of the `loading` slot. */
|
|
24094
|
+
"prop:loadingText"?: (HelixHeadlessScatterChart["loadingText"]) | undefined;
|
|
23686
24095
|
/** The id of the table to read.
|
|
23687
24096
|
|
|
23688
24097
|
Names a table in the same tree, so a chart inside another component's
|
|
@@ -23719,6 +24128,29 @@ Set it to the words of the page's language, such as `{position} von
|
|
|
23719
24128
|
{count}`, or to nothing to say no position. A slice or a series a
|
|
23720
24129
|
legend hid is not counted. */
|
|
23721
24130
|
"prop:positionLabel"?: (HelixHeadlessScatterChart["positionLabel"]) | undefined;
|
|
24131
|
+
/** The readings as data, in the shape of a table, where the page has no
|
|
24132
|
+
table to point `for` at. `for` wins where both are set.
|
|
24133
|
+
|
|
24134
|
+
```js
|
|
24135
|
+
chart.data = {
|
|
24136
|
+
caption: 'Sessions by channel',
|
|
24137
|
+
columns: ['Month', 'Direct', 'Referral'],
|
|
24138
|
+
rows: [['Jan', 10, 4], ['Feb', 20, 8]],
|
|
24139
|
+
}
|
|
24140
|
+
```
|
|
24141
|
+
|
|
24142
|
+
The first column holds each row's label and every column after it a
|
|
24143
|
+
series, as in a table. A cell is a number, words, `null` for a blank,
|
|
24144
|
+
or `{ value, text }` for a number shown as words, such as `$128k`. A
|
|
24145
|
+
number is shown in `locale`.
|
|
24146
|
+
|
|
24147
|
+
**A table is still the better source where the page can show one**:
|
|
24148
|
+
it reads with no script and before hydration, and a reader can sort and
|
|
24149
|
+
copy it. Data is drawn on the client only, so a server serves the
|
|
24150
|
+
frame, and the summary, the keys and the readout are then the whole of
|
|
24151
|
+
what a screen reader is given. Set a new object to redraw: the chart
|
|
24152
|
+
does not look inside the one it has. */
|
|
24153
|
+
"prop:data"?: (HelixHeadlessScatterChart["data"]) | undefined;
|
|
23722
24154
|
/** 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. */
|
|
23723
24155
|
"on:helix-reading-change"?: ((
|
|
23724
24156
|
e: HelixHeadlessScatterChartHelixReadingChangeElementEvent,
|
|
@@ -33142,6 +33574,16 @@ export type CustomElements = {
|
|
|
33142
33574
|
* tap or key, and `helix-reading-press` says a reading was clicked, tapped, or
|
|
33143
33575
|
* pressed with Enter or Space, for a page that opens what a reading stands for.
|
|
33144
33576
|
*
|
|
33577
|
+
* **`data` takes the readings as data** where the page has no table to point
|
|
33578
|
+
* `for` at, in a table's shape: the column headings, then one row per reading
|
|
33579
|
+
* with its label first. A table is still the better source where the page can
|
|
33580
|
+
* show one, since it reads before any script runs.
|
|
33581
|
+
*
|
|
33582
|
+
* **A chart with nothing to draw says so.** A table with no readings shows
|
|
33583
|
+
* `empty-text`, "No readings", in the plot, and `loading` shows `loading-text`
|
|
33584
|
+
* there until readings arrive. The `empty` and `loading` slots take markup in
|
|
33585
|
+
* their place, such as a link to add the first reading.
|
|
33586
|
+
*
|
|
33145
33587
|
* ## Attributes & Properties
|
|
33146
33588
|
*
|
|
33147
33589
|
* Component attributes and properties that can be applied to the element or by using JavaScript.
|
|
@@ -33188,6 +33630,16 @@ export type CustomElements = {
|
|
|
33188
33630
|
*
|
|
33189
33631
|
* Absent draws none: bands read as a composition need no numbers beside
|
|
33190
33632
|
* them, and the tooltip and the table hold every reading.
|
|
33633
|
+
* - `empty-text`/`emptyText`: The words shown in place of the drawing when the table has no readings,
|
|
33634
|
+
* and the fallback of the `empty` slot.
|
|
33635
|
+
* - `loading`: Whether the readings are still on their way. The chart shows
|
|
33636
|
+
* `loading-text` in place of an empty drawing until it has readings.
|
|
33637
|
+
*
|
|
33638
|
+
* Reflected, so a stylesheet can treat the chart while it waits. A chart
|
|
33639
|
+
* that already has readings keeps drawing them, so a refresh does not
|
|
33640
|
+
* blank it.
|
|
33641
|
+
* - `loading-text`/`loadingText`: The words shown in place of the drawing while `loading` is set and
|
|
33642
|
+
* there are no readings yet, and the fallback of the `loading` slot.
|
|
33191
33643
|
* - `for`: The id of the table to read.
|
|
33192
33644
|
*
|
|
33193
33645
|
* Names a table in the same tree, so a chart inside another component's
|
|
@@ -33218,6 +33670,28 @@ export type CustomElements = {
|
|
|
33218
33670
|
* cannot be cast onto across unrelated classes, so it would be invisible to
|
|
33219
33671
|
* every chart that needs it. Reading where a pointer is resting is a fair
|
|
33220
33672
|
* thing to ask a chart anyway. (property only) (readonly)
|
|
33673
|
+
* - `data`: The readings as data, in the shape of a table, where the page has no
|
|
33674
|
+
* table to point `for` at. `for` wins where both are set.
|
|
33675
|
+
*
|
|
33676
|
+
* ```js
|
|
33677
|
+
* chart.data = {
|
|
33678
|
+
* caption: 'Sessions by channel',
|
|
33679
|
+
* columns: ['Month', 'Direct', 'Referral'],
|
|
33680
|
+
* rows: [['Jan', 10, 4], ['Feb', 20, 8]],
|
|
33681
|
+
* }
|
|
33682
|
+
* ```
|
|
33683
|
+
*
|
|
33684
|
+
* The first column holds each row's label and every column after it a
|
|
33685
|
+
* series, as in a table. A cell is a number, words, `null` for a blank,
|
|
33686
|
+
* or `{ value, text }` for a number shown as words, such as `$128k`. A
|
|
33687
|
+
* number is shown in `locale`.
|
|
33688
|
+
*
|
|
33689
|
+
* **A table is still the better source where the page can show one**:
|
|
33690
|
+
* it reads with no script and before hydration, and a reader can sort and
|
|
33691
|
+
* copy it. Data is drawn on the client only, so a server serves the
|
|
33692
|
+
* frame, and the summary, the keys and the readout are then the whole of
|
|
33693
|
+
* what a screen reader is given. Set a new object to redraw: the chart
|
|
33694
|
+
* does not look inside the one it has. (property only)
|
|
33221
33695
|
* - `series`: The table's columns, one series each. Empty when there is no table.
|
|
33222
33696
|
*
|
|
33223
33697
|
* Held by the controller between edits, so a render reading this five
|
|
@@ -33234,6 +33708,9 @@ export type CustomElements = {
|
|
|
33234
33708
|
* names an element, and the chart is a generic around its plot: written
|
|
33235
33709
|
* on the host, the name reached nobody. The plot takes it, as Heatmap's
|
|
33236
33710
|
* strip always did. (property only) (readonly)
|
|
33711
|
+
* - `readingsKnown`: Whether the readings have been looked for: false on the server and
|
|
33712
|
+
* while hydrating, where no table is resolved and no data is read. A
|
|
33713
|
+
* chart says it has no readings only once this is true. (property only) (readonly)
|
|
33237
33714
|
* - `sourceRows`: Every row of the table, with each cell's text and number.
|
|
33238
33715
|
*
|
|
33239
33716
|
* This is where a tooltip's content comes from, and it is deliberately not
|
|
@@ -33280,6 +33757,13 @@ export type CustomElements = {
|
|
|
33280
33757
|
* - `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.
|
|
33281
33758
|
* - `helix-reading-press`: A reading was clicked, tapped, or pressed with Enter or Space, with the same detail as `helix-reading-change`.
|
|
33282
33759
|
*
|
|
33760
|
+
* ## Slots
|
|
33761
|
+
*
|
|
33762
|
+
* Areas where markup can be added to the component.
|
|
33763
|
+
*
|
|
33764
|
+
* - `empty`: Content shown in place of the drawing when the table has no readings, such as a link to add the first. Falls back to `empty-text`.
|
|
33765
|
+
* - `loading`: Content shown in place of the drawing while `loading` is set and there are no readings yet. Falls back to `loading-text`.
|
|
33766
|
+
*
|
|
33283
33767
|
* ## Methods
|
|
33284
33768
|
*
|
|
33285
33769
|
* Methods that can be called to access component functionality.
|
|
@@ -33329,12 +33813,14 @@ export type CustomElements = {
|
|
|
33329
33813
|
* - `area`: One part's band.
|
|
33330
33814
|
* - `axis`: The numbers of the scale beside the plot, under `value-axis`.
|
|
33331
33815
|
* - `baseline`: The rule at zero, which is the floor of the drawing.
|
|
33816
|
+
* - `empty`: The words in place of the drawing 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.
|
|
33332
33817
|
* - `gridline`: One rule across the plot, under `gridlines`.
|
|
33333
33818
|
* - `guide`: A rule down the reading a pointer is resting on.
|
|
33334
33819
|
* - `label`: One reading's name.
|
|
33335
33820
|
* - `labels`: The row of reading names.
|
|
33336
33821
|
* - `line`: The top edge of one part's band.
|
|
33337
33822
|
* - `live`: The readout: a polite live region that says the reading the keys moved to. Hide it visually.
|
|
33823
|
+
* - `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`.
|
|
33338
33824
|
* - `mark`: The invisible point the tooltip is anchored to.
|
|
33339
33825
|
* - `plot`: The drawing, which takes focus to be read by key.
|
|
33340
33826
|
* - `summary`: The total and each part's share at the latest reading, written as a sentence for screen readers.
|
|
@@ -33720,6 +34206,16 @@ export type CustomElements = {
|
|
|
33720
34206
|
* tap or key, and `helix-reading-press` says a reading was clicked, tapped, or
|
|
33721
34207
|
* pressed with Enter or Space, for a page that opens what a reading stands for.
|
|
33722
34208
|
*
|
|
34209
|
+
* **`data` takes the readings as data** where the page has no table to point
|
|
34210
|
+
* `for` at, in a table's shape: the column headings, then one row per reading
|
|
34211
|
+
* with its label first. A table is still the better source where the page can
|
|
34212
|
+
* show one, since it reads before any script runs.
|
|
34213
|
+
*
|
|
34214
|
+
* **A chart with nothing to draw says so.** A table with no readings shows
|
|
34215
|
+
* `empty-text`, "No readings", in the plot, and `loading` shows `loading-text`
|
|
34216
|
+
* there until readings arrive. The `empty` and `loading` slots take markup in
|
|
34217
|
+
* their place, such as a link to add the first reading.
|
|
34218
|
+
*
|
|
33723
34219
|
* ## Attributes & Properties
|
|
33724
34220
|
*
|
|
33725
34221
|
* Component attributes and properties that can be applied to the element or by using JavaScript.
|
|
@@ -33825,6 +34321,16 @@ export type CustomElements = {
|
|
|
33825
34321
|
*
|
|
33826
34322
|
* Absent draws none with one scale, since bars compared with each other need
|
|
33827
34323
|
* no numbers. With `secondary` both scales are drawn whatever this says.
|
|
34324
|
+
* - `empty-text`/`emptyText`: The words shown in place of the drawing when the table has no readings,
|
|
34325
|
+
* and the fallback of the `empty` slot.
|
|
34326
|
+
* - `loading`: Whether the readings are still on their way. The chart shows
|
|
34327
|
+
* `loading-text` in place of an empty drawing until it has readings.
|
|
34328
|
+
*
|
|
34329
|
+
* Reflected, so a stylesheet can treat the chart while it waits. A chart
|
|
34330
|
+
* that already has readings keeps drawing them, so a refresh does not
|
|
34331
|
+
* blank it.
|
|
34332
|
+
* - `loading-text`/`loadingText`: The words shown in place of the drawing while `loading` is set and
|
|
34333
|
+
* there are no readings yet, and the fallback of the `loading` slot.
|
|
33828
34334
|
* - `for`: The id of the table to read.
|
|
33829
34335
|
*
|
|
33830
34336
|
* Names a table in the same tree, so a chart inside another component's
|
|
@@ -33855,6 +34361,28 @@ export type CustomElements = {
|
|
|
33855
34361
|
* cannot be cast onto across unrelated classes, so it would be invisible to
|
|
33856
34362
|
* every chart that needs it. Reading where a pointer is resting is a fair
|
|
33857
34363
|
* thing to ask a chart anyway. (property only) (readonly)
|
|
34364
|
+
* - `data`: The readings as data, in the shape of a table, where the page has no
|
|
34365
|
+
* table to point `for` at. `for` wins where both are set.
|
|
34366
|
+
*
|
|
34367
|
+
* ```js
|
|
34368
|
+
* chart.data = {
|
|
34369
|
+
* caption: 'Sessions by channel',
|
|
34370
|
+
* columns: ['Month', 'Direct', 'Referral'],
|
|
34371
|
+
* rows: [['Jan', 10, 4], ['Feb', 20, 8]],
|
|
34372
|
+
* }
|
|
34373
|
+
* ```
|
|
34374
|
+
*
|
|
34375
|
+
* The first column holds each row's label and every column after it a
|
|
34376
|
+
* series, as in a table. A cell is a number, words, `null` for a blank,
|
|
34377
|
+
* or `{ value, text }` for a number shown as words, such as `$128k`. A
|
|
34378
|
+
* number is shown in `locale`.
|
|
34379
|
+
*
|
|
34380
|
+
* **A table is still the better source where the page can show one**:
|
|
34381
|
+
* it reads with no script and before hydration, and a reader can sort and
|
|
34382
|
+
* copy it. Data is drawn on the client only, so a server serves the
|
|
34383
|
+
* frame, and the summary, the keys and the readout are then the whole of
|
|
34384
|
+
* what a screen reader is given. Set a new object to redraw: the chart
|
|
34385
|
+
* does not look inside the one it has. (property only)
|
|
33858
34386
|
* - `series`: The table's columns, one series each. Empty when there is no table.
|
|
33859
34387
|
*
|
|
33860
34388
|
* Held by the controller between edits, so a render reading this five
|
|
@@ -33871,6 +34399,9 @@ export type CustomElements = {
|
|
|
33871
34399
|
* names an element, and the chart is a generic around its plot: written
|
|
33872
34400
|
* on the host, the name reached nobody. The plot takes it, as Heatmap's
|
|
33873
34401
|
* strip always did. (property only) (readonly)
|
|
34402
|
+
* - `readingsKnown`: Whether the readings have been looked for: false on the server and
|
|
34403
|
+
* while hydrating, where no table is resolved and no data is read. A
|
|
34404
|
+
* chart says it has no readings only once this is true. (property only) (readonly)
|
|
33874
34405
|
* - `sourceRows`: Every row of the table, with each cell's text and number.
|
|
33875
34406
|
*
|
|
33876
34407
|
* This is where a tooltip's content comes from, and it is deliberately not
|
|
@@ -33917,6 +34448,13 @@ export type CustomElements = {
|
|
|
33917
34448
|
* - `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.
|
|
33918
34449
|
* - `helix-reading-press`: A reading was clicked, tapped, or pressed with Enter or Space, with the same detail as `helix-reading-change`.
|
|
33919
34450
|
*
|
|
34451
|
+
* ## Slots
|
|
34452
|
+
*
|
|
34453
|
+
* Areas where markup can be added to the component.
|
|
34454
|
+
*
|
|
34455
|
+
* - `empty`: Content shown in place of the drawing when the table has no readings, such as a link to add the first. Falls back to `empty-text`.
|
|
34456
|
+
* - `loading`: Content shown in place of the drawing while `loading` is set and there are no readings yet. Falls back to `loading-text`.
|
|
34457
|
+
*
|
|
33920
34458
|
* ## Methods
|
|
33921
34459
|
*
|
|
33922
34460
|
* Methods that can be called to access component functionality.
|
|
@@ -33971,6 +34509,7 @@ export type CustomElements = {
|
|
|
33971
34509
|
* - `bar-wash-end`: The far stop of a bar's gradient, where one is used.
|
|
33972
34510
|
* - `bar-wash-start`: The stop of a bar's gradient at its base.
|
|
33973
34511
|
* - `baseline`: The line the columns stand on.
|
|
34512
|
+
* - `empty`: The words in place of the drawing 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.
|
|
33974
34513
|
* - `gridline`: One gridline across the plot, drawn when `gridlines` is set.
|
|
33975
34514
|
* - `group`: One category's columns, together.
|
|
33976
34515
|
* - `group-active`: The group the tooltip describes. Set together with `group`.
|
|
@@ -33978,6 +34517,7 @@ export type CustomElements = {
|
|
|
33978
34517
|
* - `labels`: The row of category names.
|
|
33979
34518
|
* - `line`: A series drawn as a line, named in `lines`.
|
|
33980
34519
|
* - `live`: The readout: a polite live region that says the reading the keys moved to. Hide it visually.
|
|
34520
|
+
* - `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`.
|
|
33981
34521
|
* - `mark`: The invisible point the tooltip is anchored to.
|
|
33982
34522
|
* - `plot`: The drawing, which takes focus to be read by key.
|
|
33983
34523
|
* - `summary`: The chart's name and each series' highest reading, written as a sentence for screen readers. Hide it visually.
|
|
@@ -40516,6 +41056,28 @@ export type CustomElements = {
|
|
|
40516
41056
|
* cannot be cast onto across unrelated classes, so it would be invisible to
|
|
40517
41057
|
* every chart that needs it. Reading where a pointer is resting is a fair
|
|
40518
41058
|
* thing to ask a chart anyway. (property only) (readonly)
|
|
41059
|
+
* - `data`: The readings as data, in the shape of a table, where the page has no
|
|
41060
|
+
* table to point `for` at. `for` wins where both are set.
|
|
41061
|
+
*
|
|
41062
|
+
* ```js
|
|
41063
|
+
* chart.data = {
|
|
41064
|
+
* caption: 'Sessions by channel',
|
|
41065
|
+
* columns: ['Month', 'Direct', 'Referral'],
|
|
41066
|
+
* rows: [['Jan', 10, 4], ['Feb', 20, 8]],
|
|
41067
|
+
* }
|
|
41068
|
+
* ```
|
|
41069
|
+
*
|
|
41070
|
+
* The first column holds each row's label and every column after it a
|
|
41071
|
+
* series, as in a table. A cell is a number, words, `null` for a blank,
|
|
41072
|
+
* or `{ value, text }` for a number shown as words, such as `$128k`. A
|
|
41073
|
+
* number is shown in `locale`.
|
|
41074
|
+
*
|
|
41075
|
+
* **A table is still the better source where the page can show one**:
|
|
41076
|
+
* it reads with no script and before hydration, and a reader can sort and
|
|
41077
|
+
* copy it. Data is drawn on the client only, so a server serves the
|
|
41078
|
+
* frame, and the summary, the keys and the readout are then the whole of
|
|
41079
|
+
* what a screen reader is given. Set a new object to redraw: the chart
|
|
41080
|
+
* does not look inside the one it has. (property only)
|
|
40519
41081
|
* - `series`: The table's columns, one series each. Empty when there is no table.
|
|
40520
41082
|
*
|
|
40521
41083
|
* Held by the controller between edits, so a render reading this five
|
|
@@ -40532,6 +41094,9 @@ export type CustomElements = {
|
|
|
40532
41094
|
* names an element, and the chart is a generic around its plot: written
|
|
40533
41095
|
* on the host, the name reached nobody. The plot takes it, as Heatmap's
|
|
40534
41096
|
* strip always did. (property only) (readonly)
|
|
41097
|
+
* - `readingsKnown`: Whether the readings have been looked for: false on the server and
|
|
41098
|
+
* while hydrating, where no table is resolved and no data is read. A
|
|
41099
|
+
* chart says it has no readings only once this is true. (property only) (readonly)
|
|
40535
41100
|
* - `sourceRows`: Every row of the table, with each cell's text and number.
|
|
40536
41101
|
*
|
|
40537
41102
|
* This is where a tooltip's content comes from, and it is deliberately not
|
|
@@ -43055,6 +43620,28 @@ export type CustomElements = {
|
|
|
43055
43620
|
* cannot be cast onto across unrelated classes, so it would be invisible to
|
|
43056
43621
|
* every chart that needs it. Reading where a pointer is resting is a fair
|
|
43057
43622
|
* thing to ask a chart anyway. (property only) (readonly)
|
|
43623
|
+
* - `data`: The readings as data, in the shape of a table, where the page has no
|
|
43624
|
+
* table to point `for` at. `for` wins where both are set.
|
|
43625
|
+
*
|
|
43626
|
+
* ```js
|
|
43627
|
+
* chart.data = {
|
|
43628
|
+
* caption: 'Sessions by channel',
|
|
43629
|
+
* columns: ['Month', 'Direct', 'Referral'],
|
|
43630
|
+
* rows: [['Jan', 10, 4], ['Feb', 20, 8]],
|
|
43631
|
+
* }
|
|
43632
|
+
* ```
|
|
43633
|
+
*
|
|
43634
|
+
* The first column holds each row's label and every column after it a
|
|
43635
|
+
* series, as in a table. A cell is a number, words, `null` for a blank,
|
|
43636
|
+
* or `{ value, text }` for a number shown as words, such as `$128k`. A
|
|
43637
|
+
* number is shown in `locale`.
|
|
43638
|
+
*
|
|
43639
|
+
* **A table is still the better source where the page can show one**:
|
|
43640
|
+
* it reads with no script and before hydration, and a reader can sort and
|
|
43641
|
+
* copy it. Data is drawn on the client only, so a server serves the
|
|
43642
|
+
* frame, and the summary, the keys and the readout are then the whole of
|
|
43643
|
+
* what a screen reader is given. Set a new object to redraw: the chart
|
|
43644
|
+
* does not look inside the one it has. (property only)
|
|
43058
43645
|
* - `series`: The table's columns, one series each. Empty when there is no table.
|
|
43059
43646
|
*
|
|
43060
43647
|
* Held by the controller between edits, so a render reading this five
|
|
@@ -43071,6 +43658,9 @@ export type CustomElements = {
|
|
|
43071
43658
|
* names an element, and the chart is a generic around its plot: written
|
|
43072
43659
|
* on the host, the name reached nobody. The plot takes it, as Heatmap's
|
|
43073
43660
|
* strip always did. (property only) (readonly)
|
|
43661
|
+
* - `readingsKnown`: Whether the readings have been looked for: false on the server and
|
|
43662
|
+
* while hydrating, where no table is resolved and no data is read. A
|
|
43663
|
+
* chart says it has no readings only once this is true. (property only) (readonly)
|
|
43074
43664
|
* - `sourceRows`: Every row of the table, with each cell's text and number.
|
|
43075
43665
|
*
|
|
43076
43666
|
* This is where a tooltip's content comes from, and it is deliberately not
|
|
@@ -44709,6 +45299,16 @@ export type CustomElements = {
|
|
|
44709
45299
|
* tap or key, and `helix-reading-press` says a reading was clicked, tapped, or
|
|
44710
45300
|
* pressed with Enter or Space, for a page that opens what a reading stands for.
|
|
44711
45301
|
*
|
|
45302
|
+
* **`data` takes the readings as data** where the page has no table to point
|
|
45303
|
+
* `for` at, in a table's shape: the column headings, then one row per reading
|
|
45304
|
+
* with its label first. A table is still the better source where the page can
|
|
45305
|
+
* show one, since it reads before any script runs.
|
|
45306
|
+
*
|
|
45307
|
+
* **A chart with nothing to draw says so.** A table with no readings shows
|
|
45308
|
+
* `empty-text`, "No readings", in the plot, and `loading` shows `loading-text`
|
|
45309
|
+
* there until readings arrive. The `empty` and `loading` slots take markup in
|
|
45310
|
+
* their place, such as a link to add the first reading.
|
|
45311
|
+
*
|
|
44712
45312
|
* ## Attributes & Properties
|
|
44713
45313
|
*
|
|
44714
45314
|
* Component attributes and properties that can be applied to the element or by using JavaScript.
|
|
@@ -44819,6 +45419,16 @@ export type CustomElements = {
|
|
|
44819
45419
|
* Set it where the distance from nothing is the point rather than the shape,
|
|
44820
45420
|
* and accept that a series which never approaches zero becomes a flat rule
|
|
44821
45421
|
* near the top of the box.
|
|
45422
|
+
* - `empty-text`/`emptyText`: The words shown in place of the drawing when the table has no readings,
|
|
45423
|
+
* and the fallback of the `empty` slot.
|
|
45424
|
+
* - `loading`: Whether the readings are still on their way. The chart shows
|
|
45425
|
+
* `loading-text` in place of an empty drawing until it has readings.
|
|
45426
|
+
*
|
|
45427
|
+
* Reflected, so a stylesheet can treat the chart while it waits. A chart
|
|
45428
|
+
* that already has readings keeps drawing them, so a refresh does not
|
|
45429
|
+
* blank it.
|
|
45430
|
+
* - `loading-text`/`loadingText`: The words shown in place of the drawing while `loading` is set and
|
|
45431
|
+
* there are no readings yet, and the fallback of the `loading` slot.
|
|
44822
45432
|
* - `for`: The id of the table to read.
|
|
44823
45433
|
*
|
|
44824
45434
|
* Names a table in the same tree, so a chart inside another component's
|
|
@@ -44849,6 +45459,28 @@ export type CustomElements = {
|
|
|
44849
45459
|
* cannot be cast onto across unrelated classes, so it would be invisible to
|
|
44850
45460
|
* every chart that needs it. Reading where a pointer is resting is a fair
|
|
44851
45461
|
* thing to ask a chart anyway. (property only) (readonly)
|
|
45462
|
+
* - `data`: The readings as data, in the shape of a table, where the page has no
|
|
45463
|
+
* table to point `for` at. `for` wins where both are set.
|
|
45464
|
+
*
|
|
45465
|
+
* ```js
|
|
45466
|
+
* chart.data = {
|
|
45467
|
+
* caption: 'Sessions by channel',
|
|
45468
|
+
* columns: ['Month', 'Direct', 'Referral'],
|
|
45469
|
+
* rows: [['Jan', 10, 4], ['Feb', 20, 8]],
|
|
45470
|
+
* }
|
|
45471
|
+
* ```
|
|
45472
|
+
*
|
|
45473
|
+
* The first column holds each row's label and every column after it a
|
|
45474
|
+
* series, as in a table. A cell is a number, words, `null` for a blank,
|
|
45475
|
+
* or `{ value, text }` for a number shown as words, such as `$128k`. A
|
|
45476
|
+
* number is shown in `locale`.
|
|
45477
|
+
*
|
|
45478
|
+
* **A table is still the better source where the page can show one**:
|
|
45479
|
+
* it reads with no script and before hydration, and a reader can sort and
|
|
45480
|
+
* copy it. Data is drawn on the client only, so a server serves the
|
|
45481
|
+
* frame, and the summary, the keys and the readout are then the whole of
|
|
45482
|
+
* what a screen reader is given. Set a new object to redraw: the chart
|
|
45483
|
+
* does not look inside the one it has. (property only)
|
|
44852
45484
|
* - `series`: The table's columns, one series each. Empty when there is no table.
|
|
44853
45485
|
*
|
|
44854
45486
|
* Held by the controller between edits, so a render reading this five
|
|
@@ -44865,6 +45497,9 @@ export type CustomElements = {
|
|
|
44865
45497
|
* names an element, and the chart is a generic around its plot: written
|
|
44866
45498
|
* on the host, the name reached nobody. The plot takes it, as Heatmap's
|
|
44867
45499
|
* strip always did. (property only) (readonly)
|
|
45500
|
+
* - `readingsKnown`: Whether the readings have been looked for: false on the server and
|
|
45501
|
+
* while hydrating, where no table is resolved and no data is read. A
|
|
45502
|
+
* chart says it has no readings only once this is true. (property only) (readonly)
|
|
44868
45503
|
* - `sourceRows`: Every row of the table, with each cell's text and number.
|
|
44869
45504
|
*
|
|
44870
45505
|
* This is where a tooltip's content comes from, and it is deliberately not
|
|
@@ -44911,6 +45546,13 @@ export type CustomElements = {
|
|
|
44911
45546
|
* - `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.
|
|
44912
45547
|
* - `helix-reading-press`: A reading was clicked, tapped, or pressed with Enter or Space, with the same detail as `helix-reading-change`.
|
|
44913
45548
|
*
|
|
45549
|
+
* ## Slots
|
|
45550
|
+
*
|
|
45551
|
+
* Areas where markup can be added to the component.
|
|
45552
|
+
*
|
|
45553
|
+
* - `empty`: Content shown in place of the drawing when the table has no readings, such as a link to add the first. Falls back to `empty-text`.
|
|
45554
|
+
* - `loading`: Content shown in place of the drawing while `loading` is set and there are no readings yet. Falls back to `loading-text`.
|
|
45555
|
+
*
|
|
44914
45556
|
* ## Methods
|
|
44915
45557
|
*
|
|
44916
45558
|
* Methods that can be called to access component functionality.
|
|
@@ -44963,6 +45605,7 @@ export type CustomElements = {
|
|
|
44963
45605
|
* - `axis`: The numbers of the scale beside the plot, under `value-axis`.
|
|
44964
45606
|
* - `band`: The band around the reading under the pointer.
|
|
44965
45607
|
* - `baseline`: The rule at zero, where zero is inside the range.
|
|
45608
|
+
* - `empty`: The words in place of the drawing 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.
|
|
44966
45609
|
* - `gridline`: One rule across the plot, under `gridlines`.
|
|
44967
45610
|
* - `guide`: A rule down the reading a pointer is resting on.
|
|
44968
45611
|
* - `label`: One reading's name.
|
|
@@ -44970,6 +45613,7 @@ export type CustomElements = {
|
|
|
44970
45613
|
* - `line`: The line for one series.
|
|
44971
45614
|
* - `line-dashed`: A `line` whose series `dashed` names. Set alongside `line`.
|
|
44972
45615
|
* - `live`: The readout: a polite live region that says the reading the keys moved to. Hide it visually.
|
|
45616
|
+
* - `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`.
|
|
44973
45617
|
* - `mark`: The invisible point the tooltip is anchored to.
|
|
44974
45618
|
* - `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`.
|
|
44975
45619
|
* - `marker-lone`: A `marker` on a reading with a blank on either side, which no line reaches. Set alongside `marker`.
|
|
@@ -45753,6 +46397,11 @@ export type CustomElements = {
|
|
|
45753
46397
|
* Draws two concentric circles: a track and a moving arc. The track shows the
|
|
45754
46398
|
* arc as a proportion of a whole, and costs one element.
|
|
45755
46399
|
*
|
|
46400
|
+
* **For work whose length is known, use `Progress` with `shape="ring"`.** It
|
|
46401
|
+
* draws the same ring filled to the value, says the value as a progress bar
|
|
46402
|
+
* does, and says when the work is complete. A loader claims no proportion, so
|
|
46403
|
+
* it takes no value.
|
|
46404
|
+
*
|
|
45756
46405
|
* **The center is a slot, empty by default.** Put your logo there once, where
|
|
45757
46406
|
* your app wraps the loader. When nothing is slotted, nothing extra is
|
|
45758
46407
|
* rendered.
|
|
@@ -50259,6 +50908,15 @@ export type CustomElements = {
|
|
|
50259
50908
|
*
|
|
50260
50909
|
* The fill is a fraction of the track, written as a custom property.
|
|
50261
50910
|
*
|
|
50911
|
+
* **The reading is said in the words the bar would show**: a whole percentage
|
|
50912
|
+
* of the range in `locale`, the reading `format-options` writes, or
|
|
50913
|
+
* `value-text`, as `aria-valuetext` beside the number.
|
|
50914
|
+
*
|
|
50915
|
+
* **Words set in the default slot are drawn on the bar**, or in the middle of a
|
|
50916
|
+
* ring, such as `62%` or `3 of 8`, and are what the bar says as its reading
|
|
50917
|
+
* where `value-text` is not set. While there are any, the bar carries
|
|
50918
|
+
* `:state(content)`, so a sheet can make room for them.
|
|
50919
|
+
*
|
|
50262
50920
|
* **Reaching `max` is said and sent.** When the value arrives at `max` from
|
|
50263
50921
|
* below, the bar says `complete-label`, "Complete" by default, in a polite
|
|
50264
50922
|
* `live` region and sends `helix-complete`, so a reader hears that the work is
|
|
@@ -50285,7 +50943,8 @@ export type CustomElements = {
|
|
|
50285
50943
|
*
|
|
50286
50944
|
* A `percent` style writes the share of the range, and any other the value
|
|
50287
50945
|
* itself, so the example says "18 GB". Absent is a whole percentage. The
|
|
50288
|
-
* words are announced
|
|
50946
|
+
* words are announced whether or not `show-value` shows them. `value-text`
|
|
50947
|
+
* still wins.
|
|
50289
50948
|
* - `indeterminate`: Whether the length of the task is unknown. The bar then shows activity
|
|
50290
50949
|
* without a value.
|
|
50291
50950
|
*
|
|
@@ -50374,6 +51033,7 @@ export type CustomElements = {
|
|
|
50374
51033
|
*
|
|
50375
51034
|
* Areas where markup can be added to the component.
|
|
50376
51035
|
*
|
|
51036
|
+
* - `(default)`: Words drawn on the bar, or in the middle of a ring, such as the reading. Said as the reading where `value-text` is not set.
|
|
50377
51037
|
* - `label`: A visible label. Its words name the progress bar in place of `label`.
|
|
50378
51038
|
*
|
|
50379
51039
|
* ## CSS Custom Properties
|
|
@@ -50386,6 +51046,7 @@ export type CustomElements = {
|
|
|
50386
51046
|
*
|
|
50387
51047
|
* Custom selectors for styling elements within the component.
|
|
50388
51048
|
*
|
|
51049
|
+
* - `content`: The box holding the words of the default slot, over the track or in the middle of the ring. Carries `--progress-fraction`.
|
|
50389
51050
|
* - `groove`: The unfilled circle under the ring's filled arc.
|
|
50390
51051
|
* - `indicator`: The filled part that shows the work done.
|
|
50391
51052
|
* - `live`: A polite region that says `complete-label` when the work is done, rendered from that moment. Hide it visually.
|
|
@@ -50397,6 +51058,7 @@ export type CustomElements = {
|
|
|
50397
51058
|
* These can be used to apply styling when a component is in a given state.
|
|
50398
51059
|
*
|
|
50399
51060
|
* - `complete`: The value is at `max` and the bar is not indeterminate.
|
|
51061
|
+
* - `content`: Words are set in the default slot.
|
|
50400
51062
|
* - `settled`: Set one frame after the first render. Transitions wait for it, so an element does not animate its own arrival.
|
|
50401
51063
|
*/
|
|
50402
51064
|
"helix-headless-progress": Partial<
|
|
@@ -51330,6 +51992,16 @@ export type CustomElements = {
|
|
|
51330
51992
|
* tap or key, and `helix-reading-press` says a reading was clicked, tapped, or
|
|
51331
51993
|
* pressed with Enter or Space, for a page that opens what a reading stands for.
|
|
51332
51994
|
*
|
|
51995
|
+
* **`data` takes the readings as data** where the page has no table to point
|
|
51996
|
+
* `for` at, in a table's shape: the column headings, then one row per reading
|
|
51997
|
+
* with its label first. A table is still the better source where the page can
|
|
51998
|
+
* show one, since it reads before any script runs.
|
|
51999
|
+
*
|
|
52000
|
+
* **A chart with nothing to draw says so.** A table with no readings shows
|
|
52001
|
+
* `empty-text`, "No readings", in the plot, and `loading` shows `loading-text`
|
|
52002
|
+
* there until readings arrive. The `empty` and `loading` slots take markup in
|
|
52003
|
+
* their place, such as a link to add the first reading.
|
|
52004
|
+
*
|
|
51333
52005
|
* ## Attributes & Properties
|
|
51334
52006
|
*
|
|
51335
52007
|
* Component attributes and properties that can be applied to the element or by using JavaScript.
|
|
@@ -51365,6 +52037,16 @@ export type CustomElements = {
|
|
|
51365
52037
|
* Absent draws none. A series with fewer than two points, or with every
|
|
51366
52038
|
* point at one measure across, has no line to draw. The summary already
|
|
51367
52039
|
* gives each series' correlation, which says how near the points are to it.
|
|
52040
|
+
* - `empty-text`/`emptyText`: The words shown in place of the drawing when the table has no readings,
|
|
52041
|
+
* and the fallback of the `empty` slot.
|
|
52042
|
+
* - `loading`: Whether the readings are still on their way. The chart shows
|
|
52043
|
+
* `loading-text` in place of an empty drawing until it has readings.
|
|
52044
|
+
*
|
|
52045
|
+
* Reflected, so a stylesheet can treat the chart while it waits. A chart
|
|
52046
|
+
* that already has readings keeps drawing them, so a refresh does not
|
|
52047
|
+
* blank it.
|
|
52048
|
+
* - `loading-text`/`loadingText`: The words shown in place of the drawing while `loading` is set and
|
|
52049
|
+
* there are no readings yet, and the fallback of the `loading` slot.
|
|
51368
52050
|
* - `for`: The id of the table to read.
|
|
51369
52051
|
*
|
|
51370
52052
|
* Names a table in the same tree, so a chart inside another component's
|
|
@@ -51395,6 +52077,28 @@ export type CustomElements = {
|
|
|
51395
52077
|
* cannot be cast onto across unrelated classes, so it would be invisible to
|
|
51396
52078
|
* every chart that needs it. Reading where a pointer is resting is a fair
|
|
51397
52079
|
* thing to ask a chart anyway. (property only) (readonly)
|
|
52080
|
+
* - `data`: The readings as data, in the shape of a table, where the page has no
|
|
52081
|
+
* table to point `for` at. `for` wins where both are set.
|
|
52082
|
+
*
|
|
52083
|
+
* ```js
|
|
52084
|
+
* chart.data = {
|
|
52085
|
+
* caption: 'Sessions by channel',
|
|
52086
|
+
* columns: ['Month', 'Direct', 'Referral'],
|
|
52087
|
+
* rows: [['Jan', 10, 4], ['Feb', 20, 8]],
|
|
52088
|
+
* }
|
|
52089
|
+
* ```
|
|
52090
|
+
*
|
|
52091
|
+
* The first column holds each row's label and every column after it a
|
|
52092
|
+
* series, as in a table. A cell is a number, words, `null` for a blank,
|
|
52093
|
+
* or `{ value, text }` for a number shown as words, such as `$128k`. A
|
|
52094
|
+
* number is shown in `locale`.
|
|
52095
|
+
*
|
|
52096
|
+
* **A table is still the better source where the page can show one**:
|
|
52097
|
+
* it reads with no script and before hydration, and a reader can sort and
|
|
52098
|
+
* copy it. Data is drawn on the client only, so a server serves the
|
|
52099
|
+
* frame, and the summary, the keys and the readout are then the whole of
|
|
52100
|
+
* what a screen reader is given. Set a new object to redraw: the chart
|
|
52101
|
+
* does not look inside the one it has. (property only)
|
|
51398
52102
|
* - `series`: The table's columns, one series each. Empty when there is no table.
|
|
51399
52103
|
*
|
|
51400
52104
|
* Held by the controller between edits, so a render reading this five
|
|
@@ -51411,6 +52115,9 @@ export type CustomElements = {
|
|
|
51411
52115
|
* names an element, and the chart is a generic around its plot: written
|
|
51412
52116
|
* on the host, the name reached nobody. The plot takes it, as Heatmap's
|
|
51413
52117
|
* strip always did. (property only) (readonly)
|
|
52118
|
+
* - `readingsKnown`: Whether the readings have been looked for: false on the server and
|
|
52119
|
+
* while hydrating, where no table is resolved and no data is read. A
|
|
52120
|
+
* chart says it has no readings only once this is true. (property only) (readonly)
|
|
51414
52121
|
* - `sourceRows`: Every row of the table, with each cell's text and number.
|
|
51415
52122
|
*
|
|
51416
52123
|
* This is where a tooltip's content comes from, and it is deliberately not
|
|
@@ -51457,6 +52164,13 @@ export type CustomElements = {
|
|
|
51457
52164
|
* - `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.
|
|
51458
52165
|
* - `helix-reading-press`: A reading was clicked, tapped, or pressed with Enter or Space, with the same detail as `helix-reading-change`.
|
|
51459
52166
|
*
|
|
52167
|
+
* ## Slots
|
|
52168
|
+
*
|
|
52169
|
+
* Areas where markup can be added to the component.
|
|
52170
|
+
*
|
|
52171
|
+
* - `empty`: Content shown in place of the drawing when the table has no readings, such as a link to add the first. Falls back to `empty-text`.
|
|
52172
|
+
* - `loading`: Content shown in place of the drawing while `loading` is set and there are no readings yet. Falls back to `loading-text`.
|
|
52173
|
+
*
|
|
51460
52174
|
* ## Methods
|
|
51461
52175
|
*
|
|
51462
52176
|
* Methods that can be called to access component functionality.
|
|
@@ -51506,8 +52220,10 @@ export type CustomElements = {
|
|
|
51506
52220
|
*
|
|
51507
52221
|
* Custom selectors for styling elements within the component.
|
|
51508
52222
|
*
|
|
52223
|
+
* - `empty`: The words in place of the drawing 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.
|
|
51509
52224
|
* - `gridline`: One line across the plot, drawn when `gridlines` is set.
|
|
51510
52225
|
* - `live`: The readout: a polite live region that says the row the keys moved to. Hide it visually.
|
|
52226
|
+
* - `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`.
|
|
51511
52227
|
* - `mark`: The invisible point the tooltip is anchored to.
|
|
51512
52228
|
* - `plane`: The grid that holds the plot, both axes, and their names. It runs left to right on every page.
|
|
51513
52229
|
* - `plot`: The drawing, which takes focus to be read by key.
|
|
@@ -59872,6 +60588,16 @@ export type CustomElementsSolidJs = {
|
|
|
59872
60588
|
* tap or key, and `helix-reading-press` says a reading was clicked, tapped, or
|
|
59873
60589
|
* pressed with Enter or Space, for a page that opens what a reading stands for.
|
|
59874
60590
|
*
|
|
60591
|
+
* **`data` takes the readings as data** where the page has no table to point
|
|
60592
|
+
* `for` at, in a table's shape: the column headings, then one row per reading
|
|
60593
|
+
* with its label first. A table is still the better source where the page can
|
|
60594
|
+
* show one, since it reads before any script runs.
|
|
60595
|
+
*
|
|
60596
|
+
* **A chart with nothing to draw says so.** A table with no readings shows
|
|
60597
|
+
* `empty-text`, "No readings", in the plot, and `loading` shows `loading-text`
|
|
60598
|
+
* there until readings arrive. The `empty` and `loading` slots take markup in
|
|
60599
|
+
* their place, such as a link to add the first reading.
|
|
60600
|
+
*
|
|
59875
60601
|
* ## Attributes & Properties
|
|
59876
60602
|
*
|
|
59877
60603
|
* Component attributes and properties that can be applied to the element or by using JavaScript.
|
|
@@ -59918,6 +60644,16 @@ export type CustomElementsSolidJs = {
|
|
|
59918
60644
|
*
|
|
59919
60645
|
* Absent draws none: bands read as a composition need no numbers beside
|
|
59920
60646
|
* them, and the tooltip and the table hold every reading.
|
|
60647
|
+
* - `empty-text`/`emptyText`: The words shown in place of the drawing when the table has no readings,
|
|
60648
|
+
* and the fallback of the `empty` slot.
|
|
60649
|
+
* - `loading`: Whether the readings are still on their way. The chart shows
|
|
60650
|
+
* `loading-text` in place of an empty drawing until it has readings.
|
|
60651
|
+
*
|
|
60652
|
+
* Reflected, so a stylesheet can treat the chart while it waits. A chart
|
|
60653
|
+
* that already has readings keeps drawing them, so a refresh does not
|
|
60654
|
+
* blank it.
|
|
60655
|
+
* - `loading-text`/`loadingText`: The words shown in place of the drawing while `loading` is set and
|
|
60656
|
+
* there are no readings yet, and the fallback of the `loading` slot.
|
|
59921
60657
|
* - `for`: The id of the table to read.
|
|
59922
60658
|
*
|
|
59923
60659
|
* Names a table in the same tree, so a chart inside another component's
|
|
@@ -59948,6 +60684,28 @@ export type CustomElementsSolidJs = {
|
|
|
59948
60684
|
* cannot be cast onto across unrelated classes, so it would be invisible to
|
|
59949
60685
|
* every chart that needs it. Reading where a pointer is resting is a fair
|
|
59950
60686
|
* thing to ask a chart anyway. (property only) (readonly)
|
|
60687
|
+
* - `data`: The readings as data, in the shape of a table, where the page has no
|
|
60688
|
+
* table to point `for` at. `for` wins where both are set.
|
|
60689
|
+
*
|
|
60690
|
+
* ```js
|
|
60691
|
+
* chart.data = {
|
|
60692
|
+
* caption: 'Sessions by channel',
|
|
60693
|
+
* columns: ['Month', 'Direct', 'Referral'],
|
|
60694
|
+
* rows: [['Jan', 10, 4], ['Feb', 20, 8]],
|
|
60695
|
+
* }
|
|
60696
|
+
* ```
|
|
60697
|
+
*
|
|
60698
|
+
* The first column holds each row's label and every column after it a
|
|
60699
|
+
* series, as in a table. A cell is a number, words, `null` for a blank,
|
|
60700
|
+
* or `{ value, text }` for a number shown as words, such as `$128k`. A
|
|
60701
|
+
* number is shown in `locale`.
|
|
60702
|
+
*
|
|
60703
|
+
* **A table is still the better source where the page can show one**:
|
|
60704
|
+
* it reads with no script and before hydration, and a reader can sort and
|
|
60705
|
+
* copy it. Data is drawn on the client only, so a server serves the
|
|
60706
|
+
* frame, and the summary, the keys and the readout are then the whole of
|
|
60707
|
+
* what a screen reader is given. Set a new object to redraw: the chart
|
|
60708
|
+
* does not look inside the one it has. (property only)
|
|
59951
60709
|
* - `series`: The table's columns, one series each. Empty when there is no table.
|
|
59952
60710
|
*
|
|
59953
60711
|
* Held by the controller between edits, so a render reading this five
|
|
@@ -59964,6 +60722,9 @@ export type CustomElementsSolidJs = {
|
|
|
59964
60722
|
* names an element, and the chart is a generic around its plot: written
|
|
59965
60723
|
* on the host, the name reached nobody. The plot takes it, as Heatmap's
|
|
59966
60724
|
* strip always did. (property only) (readonly)
|
|
60725
|
+
* - `readingsKnown`: Whether the readings have been looked for: false on the server and
|
|
60726
|
+
* while hydrating, where no table is resolved and no data is read. A
|
|
60727
|
+
* chart says it has no readings only once this is true. (property only) (readonly)
|
|
59967
60728
|
* - `sourceRows`: Every row of the table, with each cell's text and number.
|
|
59968
60729
|
*
|
|
59969
60730
|
* This is where a tooltip's content comes from, and it is deliberately not
|
|
@@ -60010,6 +60771,13 @@ export type CustomElementsSolidJs = {
|
|
|
60010
60771
|
* - `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.
|
|
60011
60772
|
* - `helix-reading-press`: A reading was clicked, tapped, or pressed with Enter or Space, with the same detail as `helix-reading-change`.
|
|
60012
60773
|
*
|
|
60774
|
+
* ## Slots
|
|
60775
|
+
*
|
|
60776
|
+
* Areas where markup can be added to the component.
|
|
60777
|
+
*
|
|
60778
|
+
* - `empty`: Content shown in place of the drawing when the table has no readings, such as a link to add the first. Falls back to `empty-text`.
|
|
60779
|
+
* - `loading`: Content shown in place of the drawing while `loading` is set and there are no readings yet. Falls back to `loading-text`.
|
|
60780
|
+
*
|
|
60013
60781
|
* ## Methods
|
|
60014
60782
|
*
|
|
60015
60783
|
* Methods that can be called to access component functionality.
|
|
@@ -60059,12 +60827,14 @@ export type CustomElementsSolidJs = {
|
|
|
60059
60827
|
* - `area`: One part's band.
|
|
60060
60828
|
* - `axis`: The numbers of the scale beside the plot, under `value-axis`.
|
|
60061
60829
|
* - `baseline`: The rule at zero, which is the floor of the drawing.
|
|
60830
|
+
* - `empty`: The words in place of the drawing 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.
|
|
60062
60831
|
* - `gridline`: One rule across the plot, under `gridlines`.
|
|
60063
60832
|
* - `guide`: A rule down the reading a pointer is resting on.
|
|
60064
60833
|
* - `label`: One reading's name.
|
|
60065
60834
|
* - `labels`: The row of reading names.
|
|
60066
60835
|
* - `line`: The top edge of one part's band.
|
|
60067
60836
|
* - `live`: The readout: a polite live region that says the reading the keys moved to. Hide it visually.
|
|
60837
|
+
* - `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`.
|
|
60068
60838
|
* - `mark`: The invisible point the tooltip is anchored to.
|
|
60069
60839
|
* - `plot`: The drawing, which takes focus to be read by key.
|
|
60070
60840
|
* - `summary`: The total and each part's share at the latest reading, written as a sentence for screen readers.
|
|
@@ -60460,6 +61230,16 @@ export type CustomElementsSolidJs = {
|
|
|
60460
61230
|
* tap or key, and `helix-reading-press` says a reading was clicked, tapped, or
|
|
60461
61231
|
* pressed with Enter or Space, for a page that opens what a reading stands for.
|
|
60462
61232
|
*
|
|
61233
|
+
* **`data` takes the readings as data** where the page has no table to point
|
|
61234
|
+
* `for` at, in a table's shape: the column headings, then one row per reading
|
|
61235
|
+
* with its label first. A table is still the better source where the page can
|
|
61236
|
+
* show one, since it reads before any script runs.
|
|
61237
|
+
*
|
|
61238
|
+
* **A chart with nothing to draw says so.** A table with no readings shows
|
|
61239
|
+
* `empty-text`, "No readings", in the plot, and `loading` shows `loading-text`
|
|
61240
|
+
* there until readings arrive. The `empty` and `loading` slots take markup in
|
|
61241
|
+
* their place, such as a link to add the first reading.
|
|
61242
|
+
*
|
|
60463
61243
|
* ## Attributes & Properties
|
|
60464
61244
|
*
|
|
60465
61245
|
* Component attributes and properties that can be applied to the element or by using JavaScript.
|
|
@@ -60565,6 +61345,16 @@ export type CustomElementsSolidJs = {
|
|
|
60565
61345
|
*
|
|
60566
61346
|
* Absent draws none with one scale, since bars compared with each other need
|
|
60567
61347
|
* no numbers. With `secondary` both scales are drawn whatever this says.
|
|
61348
|
+
* - `empty-text`/`emptyText`: The words shown in place of the drawing when the table has no readings,
|
|
61349
|
+
* and the fallback of the `empty` slot.
|
|
61350
|
+
* - `loading`: Whether the readings are still on their way. The chart shows
|
|
61351
|
+
* `loading-text` in place of an empty drawing until it has readings.
|
|
61352
|
+
*
|
|
61353
|
+
* Reflected, so a stylesheet can treat the chart while it waits. A chart
|
|
61354
|
+
* that already has readings keeps drawing them, so a refresh does not
|
|
61355
|
+
* blank it.
|
|
61356
|
+
* - `loading-text`/`loadingText`: The words shown in place of the drawing while `loading` is set and
|
|
61357
|
+
* there are no readings yet, and the fallback of the `loading` slot.
|
|
60568
61358
|
* - `for`: The id of the table to read.
|
|
60569
61359
|
*
|
|
60570
61360
|
* Names a table in the same tree, so a chart inside another component's
|
|
@@ -60595,6 +61385,28 @@ export type CustomElementsSolidJs = {
|
|
|
60595
61385
|
* cannot be cast onto across unrelated classes, so it would be invisible to
|
|
60596
61386
|
* every chart that needs it. Reading where a pointer is resting is a fair
|
|
60597
61387
|
* thing to ask a chart anyway. (property only) (readonly)
|
|
61388
|
+
* - `data`: The readings as data, in the shape of a table, where the page has no
|
|
61389
|
+
* table to point `for` at. `for` wins where both are set.
|
|
61390
|
+
*
|
|
61391
|
+
* ```js
|
|
61392
|
+
* chart.data = {
|
|
61393
|
+
* caption: 'Sessions by channel',
|
|
61394
|
+
* columns: ['Month', 'Direct', 'Referral'],
|
|
61395
|
+
* rows: [['Jan', 10, 4], ['Feb', 20, 8]],
|
|
61396
|
+
* }
|
|
61397
|
+
* ```
|
|
61398
|
+
*
|
|
61399
|
+
* The first column holds each row's label and every column after it a
|
|
61400
|
+
* series, as in a table. A cell is a number, words, `null` for a blank,
|
|
61401
|
+
* or `{ value, text }` for a number shown as words, such as `$128k`. A
|
|
61402
|
+
* number is shown in `locale`.
|
|
61403
|
+
*
|
|
61404
|
+
* **A table is still the better source where the page can show one**:
|
|
61405
|
+
* it reads with no script and before hydration, and a reader can sort and
|
|
61406
|
+
* copy it. Data is drawn on the client only, so a server serves the
|
|
61407
|
+
* frame, and the summary, the keys and the readout are then the whole of
|
|
61408
|
+
* what a screen reader is given. Set a new object to redraw: the chart
|
|
61409
|
+
* does not look inside the one it has. (property only)
|
|
60598
61410
|
* - `series`: The table's columns, one series each. Empty when there is no table.
|
|
60599
61411
|
*
|
|
60600
61412
|
* Held by the controller between edits, so a render reading this five
|
|
@@ -60611,6 +61423,9 @@ export type CustomElementsSolidJs = {
|
|
|
60611
61423
|
* names an element, and the chart is a generic around its plot: written
|
|
60612
61424
|
* on the host, the name reached nobody. The plot takes it, as Heatmap's
|
|
60613
61425
|
* strip always did. (property only) (readonly)
|
|
61426
|
+
* - `readingsKnown`: Whether the readings have been looked for: false on the server and
|
|
61427
|
+
* while hydrating, where no table is resolved and no data is read. A
|
|
61428
|
+
* chart says it has no readings only once this is true. (property only) (readonly)
|
|
60614
61429
|
* - `sourceRows`: Every row of the table, with each cell's text and number.
|
|
60615
61430
|
*
|
|
60616
61431
|
* This is where a tooltip's content comes from, and it is deliberately not
|
|
@@ -60657,6 +61472,13 @@ export type CustomElementsSolidJs = {
|
|
|
60657
61472
|
* - `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.
|
|
60658
61473
|
* - `helix-reading-press`: A reading was clicked, tapped, or pressed with Enter or Space, with the same detail as `helix-reading-change`.
|
|
60659
61474
|
*
|
|
61475
|
+
* ## Slots
|
|
61476
|
+
*
|
|
61477
|
+
* Areas where markup can be added to the component.
|
|
61478
|
+
*
|
|
61479
|
+
* - `empty`: Content shown in place of the drawing when the table has no readings, such as a link to add the first. Falls back to `empty-text`.
|
|
61480
|
+
* - `loading`: Content shown in place of the drawing while `loading` is set and there are no readings yet. Falls back to `loading-text`.
|
|
61481
|
+
*
|
|
60660
61482
|
* ## Methods
|
|
60661
61483
|
*
|
|
60662
61484
|
* Methods that can be called to access component functionality.
|
|
@@ -60711,6 +61533,7 @@ export type CustomElementsSolidJs = {
|
|
|
60711
61533
|
* - `bar-wash-end`: The far stop of a bar's gradient, where one is used.
|
|
60712
61534
|
* - `bar-wash-start`: The stop of a bar's gradient at its base.
|
|
60713
61535
|
* - `baseline`: The line the columns stand on.
|
|
61536
|
+
* - `empty`: The words in place of the drawing 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.
|
|
60714
61537
|
* - `gridline`: One gridline across the plot, drawn when `gridlines` is set.
|
|
60715
61538
|
* - `group`: One category's columns, together.
|
|
60716
61539
|
* - `group-active`: The group the tooltip describes. Set together with `group`.
|
|
@@ -60718,6 +61541,7 @@ export type CustomElementsSolidJs = {
|
|
|
60718
61541
|
* - `labels`: The row of category names.
|
|
60719
61542
|
* - `line`: A series drawn as a line, named in `lines`.
|
|
60720
61543
|
* - `live`: The readout: a polite live region that says the reading the keys moved to. Hide it visually.
|
|
61544
|
+
* - `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`.
|
|
60721
61545
|
* - `mark`: The invisible point the tooltip is anchored to.
|
|
60722
61546
|
* - `plot`: The drawing, which takes focus to be read by key.
|
|
60723
61547
|
* - `summary`: The chart's name and each series' highest reading, written as a sentence for screen readers. Hide it visually.
|
|
@@ -67319,6 +68143,28 @@ export type CustomElementsSolidJs = {
|
|
|
67319
68143
|
* cannot be cast onto across unrelated classes, so it would be invisible to
|
|
67320
68144
|
* every chart that needs it. Reading where a pointer is resting is a fair
|
|
67321
68145
|
* thing to ask a chart anyway. (property only) (readonly)
|
|
68146
|
+
* - `data`: The readings as data, in the shape of a table, where the page has no
|
|
68147
|
+
* table to point `for` at. `for` wins where both are set.
|
|
68148
|
+
*
|
|
68149
|
+
* ```js
|
|
68150
|
+
* chart.data = {
|
|
68151
|
+
* caption: 'Sessions by channel',
|
|
68152
|
+
* columns: ['Month', 'Direct', 'Referral'],
|
|
68153
|
+
* rows: [['Jan', 10, 4], ['Feb', 20, 8]],
|
|
68154
|
+
* }
|
|
68155
|
+
* ```
|
|
68156
|
+
*
|
|
68157
|
+
* The first column holds each row's label and every column after it a
|
|
68158
|
+
* series, as in a table. A cell is a number, words, `null` for a blank,
|
|
68159
|
+
* or `{ value, text }` for a number shown as words, such as `$128k`. A
|
|
68160
|
+
* number is shown in `locale`.
|
|
68161
|
+
*
|
|
68162
|
+
* **A table is still the better source where the page can show one**:
|
|
68163
|
+
* it reads with no script and before hydration, and a reader can sort and
|
|
68164
|
+
* copy it. Data is drawn on the client only, so a server serves the
|
|
68165
|
+
* frame, and the summary, the keys and the readout are then the whole of
|
|
68166
|
+
* what a screen reader is given. Set a new object to redraw: the chart
|
|
68167
|
+
* does not look inside the one it has. (property only)
|
|
67322
68168
|
* - `series`: The table's columns, one series each. Empty when there is no table.
|
|
67323
68169
|
*
|
|
67324
68170
|
* Held by the controller between edits, so a render reading this five
|
|
@@ -67335,6 +68181,9 @@ export type CustomElementsSolidJs = {
|
|
|
67335
68181
|
* names an element, and the chart is a generic around its plot: written
|
|
67336
68182
|
* on the host, the name reached nobody. The plot takes it, as Heatmap's
|
|
67337
68183
|
* strip always did. (property only) (readonly)
|
|
68184
|
+
* - `readingsKnown`: Whether the readings have been looked for: false on the server and
|
|
68185
|
+
* while hydrating, where no table is resolved and no data is read. A
|
|
68186
|
+
* chart says it has no readings only once this is true. (property only) (readonly)
|
|
67338
68187
|
* - `sourceRows`: Every row of the table, with each cell's text and number.
|
|
67339
68188
|
*
|
|
67340
68189
|
* This is where a tooltip's content comes from, and it is deliberately not
|
|
@@ -69881,6 +70730,28 @@ export type CustomElementsSolidJs = {
|
|
|
69881
70730
|
* cannot be cast onto across unrelated classes, so it would be invisible to
|
|
69882
70731
|
* every chart that needs it. Reading where a pointer is resting is a fair
|
|
69883
70732
|
* thing to ask a chart anyway. (property only) (readonly)
|
|
70733
|
+
* - `data`: The readings as data, in the shape of a table, where the page has no
|
|
70734
|
+
* table to point `for` at. `for` wins where both are set.
|
|
70735
|
+
*
|
|
70736
|
+
* ```js
|
|
70737
|
+
* chart.data = {
|
|
70738
|
+
* caption: 'Sessions by channel',
|
|
70739
|
+
* columns: ['Month', 'Direct', 'Referral'],
|
|
70740
|
+
* rows: [['Jan', 10, 4], ['Feb', 20, 8]],
|
|
70741
|
+
* }
|
|
70742
|
+
* ```
|
|
70743
|
+
*
|
|
70744
|
+
* The first column holds each row's label and every column after it a
|
|
70745
|
+
* series, as in a table. A cell is a number, words, `null` for a blank,
|
|
70746
|
+
* or `{ value, text }` for a number shown as words, such as `$128k`. A
|
|
70747
|
+
* number is shown in `locale`.
|
|
70748
|
+
*
|
|
70749
|
+
* **A table is still the better source where the page can show one**:
|
|
70750
|
+
* it reads with no script and before hydration, and a reader can sort and
|
|
70751
|
+
* copy it. Data is drawn on the client only, so a server serves the
|
|
70752
|
+
* frame, and the summary, the keys and the readout are then the whole of
|
|
70753
|
+
* what a screen reader is given. Set a new object to redraw: the chart
|
|
70754
|
+
* does not look inside the one it has. (property only)
|
|
69884
70755
|
* - `series`: The table's columns, one series each. Empty when there is no table.
|
|
69885
70756
|
*
|
|
69886
70757
|
* Held by the controller between edits, so a render reading this five
|
|
@@ -69897,6 +70768,9 @@ export type CustomElementsSolidJs = {
|
|
|
69897
70768
|
* names an element, and the chart is a generic around its plot: written
|
|
69898
70769
|
* on the host, the name reached nobody. The plot takes it, as Heatmap's
|
|
69899
70770
|
* strip always did. (property only) (readonly)
|
|
70771
|
+
* - `readingsKnown`: Whether the readings have been looked for: false on the server and
|
|
70772
|
+
* while hydrating, where no table is resolved and no data is read. A
|
|
70773
|
+
* chart says it has no readings only once this is true. (property only) (readonly)
|
|
69900
70774
|
* - `sourceRows`: Every row of the table, with each cell's text and number.
|
|
69901
70775
|
*
|
|
69902
70776
|
* This is where a tooltip's content comes from, and it is deliberately not
|
|
@@ -71558,6 +72432,16 @@ export type CustomElementsSolidJs = {
|
|
|
71558
72432
|
* tap or key, and `helix-reading-press` says a reading was clicked, tapped, or
|
|
71559
72433
|
* pressed with Enter or Space, for a page that opens what a reading stands for.
|
|
71560
72434
|
*
|
|
72435
|
+
* **`data` takes the readings as data** where the page has no table to point
|
|
72436
|
+
* `for` at, in a table's shape: the column headings, then one row per reading
|
|
72437
|
+
* with its label first. A table is still the better source where the page can
|
|
72438
|
+
* show one, since it reads before any script runs.
|
|
72439
|
+
*
|
|
72440
|
+
* **A chart with nothing to draw says so.** A table with no readings shows
|
|
72441
|
+
* `empty-text`, "No readings", in the plot, and `loading` shows `loading-text`
|
|
72442
|
+
* there until readings arrive. The `empty` and `loading` slots take markup in
|
|
72443
|
+
* their place, such as a link to add the first reading.
|
|
72444
|
+
*
|
|
71561
72445
|
* ## Attributes & Properties
|
|
71562
72446
|
*
|
|
71563
72447
|
* Component attributes and properties that can be applied to the element or by using JavaScript.
|
|
@@ -71668,6 +72552,16 @@ export type CustomElementsSolidJs = {
|
|
|
71668
72552
|
* Set it where the distance from nothing is the point rather than the shape,
|
|
71669
72553
|
* and accept that a series which never approaches zero becomes a flat rule
|
|
71670
72554
|
* near the top of the box.
|
|
72555
|
+
* - `empty-text`/`emptyText`: The words shown in place of the drawing when the table has no readings,
|
|
72556
|
+
* and the fallback of the `empty` slot.
|
|
72557
|
+
* - `loading`: Whether the readings are still on their way. The chart shows
|
|
72558
|
+
* `loading-text` in place of an empty drawing until it has readings.
|
|
72559
|
+
*
|
|
72560
|
+
* Reflected, so a stylesheet can treat the chart while it waits. A chart
|
|
72561
|
+
* that already has readings keeps drawing them, so a refresh does not
|
|
72562
|
+
* blank it.
|
|
72563
|
+
* - `loading-text`/`loadingText`: The words shown in place of the drawing while `loading` is set and
|
|
72564
|
+
* there are no readings yet, and the fallback of the `loading` slot.
|
|
71671
72565
|
* - `for`: The id of the table to read.
|
|
71672
72566
|
*
|
|
71673
72567
|
* Names a table in the same tree, so a chart inside another component's
|
|
@@ -71698,6 +72592,28 @@ export type CustomElementsSolidJs = {
|
|
|
71698
72592
|
* cannot be cast onto across unrelated classes, so it would be invisible to
|
|
71699
72593
|
* every chart that needs it. Reading where a pointer is resting is a fair
|
|
71700
72594
|
* thing to ask a chart anyway. (property only) (readonly)
|
|
72595
|
+
* - `data`: The readings as data, in the shape of a table, where the page has no
|
|
72596
|
+
* table to point `for` at. `for` wins where both are set.
|
|
72597
|
+
*
|
|
72598
|
+
* ```js
|
|
72599
|
+
* chart.data = {
|
|
72600
|
+
* caption: 'Sessions by channel',
|
|
72601
|
+
* columns: ['Month', 'Direct', 'Referral'],
|
|
72602
|
+
* rows: [['Jan', 10, 4], ['Feb', 20, 8]],
|
|
72603
|
+
* }
|
|
72604
|
+
* ```
|
|
72605
|
+
*
|
|
72606
|
+
* The first column holds each row's label and every column after it a
|
|
72607
|
+
* series, as in a table. A cell is a number, words, `null` for a blank,
|
|
72608
|
+
* or `{ value, text }` for a number shown as words, such as `$128k`. A
|
|
72609
|
+
* number is shown in `locale`.
|
|
72610
|
+
*
|
|
72611
|
+
* **A table is still the better source where the page can show one**:
|
|
72612
|
+
* it reads with no script and before hydration, and a reader can sort and
|
|
72613
|
+
* copy it. Data is drawn on the client only, so a server serves the
|
|
72614
|
+
* frame, and the summary, the keys and the readout are then the whole of
|
|
72615
|
+
* what a screen reader is given. Set a new object to redraw: the chart
|
|
72616
|
+
* does not look inside the one it has. (property only)
|
|
71701
72617
|
* - `series`: The table's columns, one series each. Empty when there is no table.
|
|
71702
72618
|
*
|
|
71703
72619
|
* Held by the controller between edits, so a render reading this five
|
|
@@ -71714,6 +72630,9 @@ export type CustomElementsSolidJs = {
|
|
|
71714
72630
|
* names an element, and the chart is a generic around its plot: written
|
|
71715
72631
|
* on the host, the name reached nobody. The plot takes it, as Heatmap's
|
|
71716
72632
|
* strip always did. (property only) (readonly)
|
|
72633
|
+
* - `readingsKnown`: Whether the readings have been looked for: false on the server and
|
|
72634
|
+
* while hydrating, where no table is resolved and no data is read. A
|
|
72635
|
+
* chart says it has no readings only once this is true. (property only) (readonly)
|
|
71717
72636
|
* - `sourceRows`: Every row of the table, with each cell's text and number.
|
|
71718
72637
|
*
|
|
71719
72638
|
* This is where a tooltip's content comes from, and it is deliberately not
|
|
@@ -71760,6 +72679,13 @@ export type CustomElementsSolidJs = {
|
|
|
71760
72679
|
* - `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.
|
|
71761
72680
|
* - `helix-reading-press`: A reading was clicked, tapped, or pressed with Enter or Space, with the same detail as `helix-reading-change`.
|
|
71762
72681
|
*
|
|
72682
|
+
* ## Slots
|
|
72683
|
+
*
|
|
72684
|
+
* Areas where markup can be added to the component.
|
|
72685
|
+
*
|
|
72686
|
+
* - `empty`: Content shown in place of the drawing when the table has no readings, such as a link to add the first. Falls back to `empty-text`.
|
|
72687
|
+
* - `loading`: Content shown in place of the drawing while `loading` is set and there are no readings yet. Falls back to `loading-text`.
|
|
72688
|
+
*
|
|
71763
72689
|
* ## Methods
|
|
71764
72690
|
*
|
|
71765
72691
|
* Methods that can be called to access component functionality.
|
|
@@ -71812,6 +72738,7 @@ export type CustomElementsSolidJs = {
|
|
|
71812
72738
|
* - `axis`: The numbers of the scale beside the plot, under `value-axis`.
|
|
71813
72739
|
* - `band`: The band around the reading under the pointer.
|
|
71814
72740
|
* - `baseline`: The rule at zero, where zero is inside the range.
|
|
72741
|
+
* - `empty`: The words in place of the drawing 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.
|
|
71815
72742
|
* - `gridline`: One rule across the plot, under `gridlines`.
|
|
71816
72743
|
* - `guide`: A rule down the reading a pointer is resting on.
|
|
71817
72744
|
* - `label`: One reading's name.
|
|
@@ -71819,6 +72746,7 @@ export type CustomElementsSolidJs = {
|
|
|
71819
72746
|
* - `line`: The line for one series.
|
|
71820
72747
|
* - `line-dashed`: A `line` whose series `dashed` names. Set alongside `line`.
|
|
71821
72748
|
* - `live`: The readout: a polite live region that says the reading the keys moved to. Hide it visually.
|
|
72749
|
+
* - `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`.
|
|
71822
72750
|
* - `mark`: The invisible point the tooltip is anchored to.
|
|
71823
72751
|
* - `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`.
|
|
71824
72752
|
* - `marker-lone`: A `marker` on a reading with a blank on either side, which no line reaches. Set alongside `marker`.
|
|
@@ -72614,6 +73542,11 @@ export type CustomElementsSolidJs = {
|
|
|
72614
73542
|
* Draws two concentric circles: a track and a moving arc. The track shows the
|
|
72615
73543
|
* arc as a proportion of a whole, and costs one element.
|
|
72616
73544
|
*
|
|
73545
|
+
* **For work whose length is known, use `Progress` with `shape="ring"`.** It
|
|
73546
|
+
* draws the same ring filled to the value, says the value as a progress bar
|
|
73547
|
+
* does, and says when the work is complete. A loader claims no proportion, so
|
|
73548
|
+
* it takes no value.
|
|
73549
|
+
*
|
|
72617
73550
|
* **The center is a slot, empty by default.** Put your logo there once, where
|
|
72618
73551
|
* your app wraps the loader. When nothing is slotted, nothing extra is
|
|
72619
73552
|
* rendered.
|
|
@@ -77182,6 +78115,15 @@ export type CustomElementsSolidJs = {
|
|
|
77182
78115
|
*
|
|
77183
78116
|
* The fill is a fraction of the track, written as a custom property.
|
|
77184
78117
|
*
|
|
78118
|
+
* **The reading is said in the words the bar would show**: a whole percentage
|
|
78119
|
+
* of the range in `locale`, the reading `format-options` writes, or
|
|
78120
|
+
* `value-text`, as `aria-valuetext` beside the number.
|
|
78121
|
+
*
|
|
78122
|
+
* **Words set in the default slot are drawn on the bar**, or in the middle of a
|
|
78123
|
+
* ring, such as `62%` or `3 of 8`, and are what the bar says as its reading
|
|
78124
|
+
* where `value-text` is not set. While there are any, the bar carries
|
|
78125
|
+
* `:state(content)`, so a sheet can make room for them.
|
|
78126
|
+
*
|
|
77185
78127
|
* **Reaching `max` is said and sent.** When the value arrives at `max` from
|
|
77186
78128
|
* below, the bar says `complete-label`, "Complete" by default, in a polite
|
|
77187
78129
|
* `live` region and sends `helix-complete`, so a reader hears that the work is
|
|
@@ -77208,7 +78150,8 @@ export type CustomElementsSolidJs = {
|
|
|
77208
78150
|
*
|
|
77209
78151
|
* A `percent` style writes the share of the range, and any other the value
|
|
77210
78152
|
* itself, so the example says "18 GB". Absent is a whole percentage. The
|
|
77211
|
-
* words are announced
|
|
78153
|
+
* words are announced whether or not `show-value` shows them. `value-text`
|
|
78154
|
+
* still wins.
|
|
77212
78155
|
* - `indeterminate`: Whether the length of the task is unknown. The bar then shows activity
|
|
77213
78156
|
* without a value.
|
|
77214
78157
|
*
|
|
@@ -77297,6 +78240,7 @@ export type CustomElementsSolidJs = {
|
|
|
77297
78240
|
*
|
|
77298
78241
|
* Areas where markup can be added to the component.
|
|
77299
78242
|
*
|
|
78243
|
+
* - `(default)`: Words drawn on the bar, or in the middle of a ring, such as the reading. Said as the reading where `value-text` is not set.
|
|
77300
78244
|
* - `label`: A visible label. Its words name the progress bar in place of `label`.
|
|
77301
78245
|
*
|
|
77302
78246
|
* ## CSS Custom Properties
|
|
@@ -77309,6 +78253,7 @@ export type CustomElementsSolidJs = {
|
|
|
77309
78253
|
*
|
|
77310
78254
|
* Custom selectors for styling elements within the component.
|
|
77311
78255
|
*
|
|
78256
|
+
* - `content`: The box holding the words of the default slot, over the track or in the middle of the ring. Carries `--progress-fraction`.
|
|
77312
78257
|
* - `groove`: The unfilled circle under the ring's filled arc.
|
|
77313
78258
|
* - `indicator`: The filled part that shows the work done.
|
|
77314
78259
|
* - `live`: A polite region that says `complete-label` when the work is done, rendered from that moment. Hide it visually.
|
|
@@ -77320,6 +78265,7 @@ export type CustomElementsSolidJs = {
|
|
|
77320
78265
|
* These can be used to apply styling when a component is in a given state.
|
|
77321
78266
|
*
|
|
77322
78267
|
* - `complete`: The value is at `max` and the bar is not indeterminate.
|
|
78268
|
+
* - `content`: Words are set in the default slot.
|
|
77323
78269
|
* - `settled`: Set one frame after the first render. Transitions wait for it, so an element does not animate its own arrival.
|
|
77324
78270
|
*/
|
|
77325
78271
|
"helix-headless-progress": Partial<
|
|
@@ -78269,6 +79215,16 @@ export type CustomElementsSolidJs = {
|
|
|
78269
79215
|
* tap or key, and `helix-reading-press` says a reading was clicked, tapped, or
|
|
78270
79216
|
* pressed with Enter or Space, for a page that opens what a reading stands for.
|
|
78271
79217
|
*
|
|
79218
|
+
* **`data` takes the readings as data** where the page has no table to point
|
|
79219
|
+
* `for` at, in a table's shape: the column headings, then one row per reading
|
|
79220
|
+
* with its label first. A table is still the better source where the page can
|
|
79221
|
+
* show one, since it reads before any script runs.
|
|
79222
|
+
*
|
|
79223
|
+
* **A chart with nothing to draw says so.** A table with no readings shows
|
|
79224
|
+
* `empty-text`, "No readings", in the plot, and `loading` shows `loading-text`
|
|
79225
|
+
* there until readings arrive. The `empty` and `loading` slots take markup in
|
|
79226
|
+
* their place, such as a link to add the first reading.
|
|
79227
|
+
*
|
|
78272
79228
|
* ## Attributes & Properties
|
|
78273
79229
|
*
|
|
78274
79230
|
* Component attributes and properties that can be applied to the element or by using JavaScript.
|
|
@@ -78304,6 +79260,16 @@ export type CustomElementsSolidJs = {
|
|
|
78304
79260
|
* Absent draws none. A series with fewer than two points, or with every
|
|
78305
79261
|
* point at one measure across, has no line to draw. The summary already
|
|
78306
79262
|
* gives each series' correlation, which says how near the points are to it.
|
|
79263
|
+
* - `empty-text`/`emptyText`: The words shown in place of the drawing when the table has no readings,
|
|
79264
|
+
* and the fallback of the `empty` slot.
|
|
79265
|
+
* - `loading`: Whether the readings are still on their way. The chart shows
|
|
79266
|
+
* `loading-text` in place of an empty drawing until it has readings.
|
|
79267
|
+
*
|
|
79268
|
+
* Reflected, so a stylesheet can treat the chart while it waits. A chart
|
|
79269
|
+
* that already has readings keeps drawing them, so a refresh does not
|
|
79270
|
+
* blank it.
|
|
79271
|
+
* - `loading-text`/`loadingText`: The words shown in place of the drawing while `loading` is set and
|
|
79272
|
+
* there are no readings yet, and the fallback of the `loading` slot.
|
|
78307
79273
|
* - `for`: The id of the table to read.
|
|
78308
79274
|
*
|
|
78309
79275
|
* Names a table in the same tree, so a chart inside another component's
|
|
@@ -78334,6 +79300,28 @@ export type CustomElementsSolidJs = {
|
|
|
78334
79300
|
* cannot be cast onto across unrelated classes, so it would be invisible to
|
|
78335
79301
|
* every chart that needs it. Reading where a pointer is resting is a fair
|
|
78336
79302
|
* thing to ask a chart anyway. (property only) (readonly)
|
|
79303
|
+
* - `data`: The readings as data, in the shape of a table, where the page has no
|
|
79304
|
+
* table to point `for` at. `for` wins where both are set.
|
|
79305
|
+
*
|
|
79306
|
+
* ```js
|
|
79307
|
+
* chart.data = {
|
|
79308
|
+
* caption: 'Sessions by channel',
|
|
79309
|
+
* columns: ['Month', 'Direct', 'Referral'],
|
|
79310
|
+
* rows: [['Jan', 10, 4], ['Feb', 20, 8]],
|
|
79311
|
+
* }
|
|
79312
|
+
* ```
|
|
79313
|
+
*
|
|
79314
|
+
* The first column holds each row's label and every column after it a
|
|
79315
|
+
* series, as in a table. A cell is a number, words, `null` for a blank,
|
|
79316
|
+
* or `{ value, text }` for a number shown as words, such as `$128k`. A
|
|
79317
|
+
* number is shown in `locale`.
|
|
79318
|
+
*
|
|
79319
|
+
* **A table is still the better source where the page can show one**:
|
|
79320
|
+
* it reads with no script and before hydration, and a reader can sort and
|
|
79321
|
+
* copy it. Data is drawn on the client only, so a server serves the
|
|
79322
|
+
* frame, and the summary, the keys and the readout are then the whole of
|
|
79323
|
+
* what a screen reader is given. Set a new object to redraw: the chart
|
|
79324
|
+
* does not look inside the one it has. (property only)
|
|
78337
79325
|
* - `series`: The table's columns, one series each. Empty when there is no table.
|
|
78338
79326
|
*
|
|
78339
79327
|
* Held by the controller between edits, so a render reading this five
|
|
@@ -78350,6 +79338,9 @@ export type CustomElementsSolidJs = {
|
|
|
78350
79338
|
* names an element, and the chart is a generic around its plot: written
|
|
78351
79339
|
* on the host, the name reached nobody. The plot takes it, as Heatmap's
|
|
78352
79340
|
* strip always did. (property only) (readonly)
|
|
79341
|
+
* - `readingsKnown`: Whether the readings have been looked for: false on the server and
|
|
79342
|
+
* while hydrating, where no table is resolved and no data is read. A
|
|
79343
|
+
* chart says it has no readings only once this is true. (property only) (readonly)
|
|
78353
79344
|
* - `sourceRows`: Every row of the table, with each cell's text and number.
|
|
78354
79345
|
*
|
|
78355
79346
|
* This is where a tooltip's content comes from, and it is deliberately not
|
|
@@ -78396,6 +79387,13 @@ export type CustomElementsSolidJs = {
|
|
|
78396
79387
|
* - `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.
|
|
78397
79388
|
* - `helix-reading-press`: A reading was clicked, tapped, or pressed with Enter or Space, with the same detail as `helix-reading-change`.
|
|
78398
79389
|
*
|
|
79390
|
+
* ## Slots
|
|
79391
|
+
*
|
|
79392
|
+
* Areas where markup can be added to the component.
|
|
79393
|
+
*
|
|
79394
|
+
* - `empty`: Content shown in place of the drawing when the table has no readings, such as a link to add the first. Falls back to `empty-text`.
|
|
79395
|
+
* - `loading`: Content shown in place of the drawing while `loading` is set and there are no readings yet. Falls back to `loading-text`.
|
|
79396
|
+
*
|
|
78399
79397
|
* ## Methods
|
|
78400
79398
|
*
|
|
78401
79399
|
* Methods that can be called to access component functionality.
|
|
@@ -78445,8 +79443,10 @@ export type CustomElementsSolidJs = {
|
|
|
78445
79443
|
*
|
|
78446
79444
|
* Custom selectors for styling elements within the component.
|
|
78447
79445
|
*
|
|
79446
|
+
* - `empty`: The words in place of the drawing 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.
|
|
78448
79447
|
* - `gridline`: One line across the plot, drawn when `gridlines` is set.
|
|
78449
79448
|
* - `live`: The readout: a polite live region that says the row the keys moved to. Hide it visually.
|
|
79449
|
+
* - `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`.
|
|
78450
79450
|
* - `mark`: The invisible point the tooltip is anchored to.
|
|
78451
79451
|
* - `plane`: The grid that holds the plot, both axes, and their names. It runs left to right on every page.
|
|
78452
79452
|
* - `plot`: The drawing, which takes focus to be read by key.
|