@fusion.dev/helix 0.39.0 → 0.41.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 +378 -89
- package/dist/accordion/item/accordion-item.d.ts +2 -4
- package/dist/accordion/root/accordion-root.d.ts +1 -1
- package/dist/area-chart/root/area-chart-root.d.ts +27 -2
- package/dist/bar-chart/root/bar-chart-root.css.js +0 -1
- package/dist/bar-chart/root/bar-chart-root.d.ts +17 -5
- package/dist/bar-chart/root/bar-chart-root.js +2 -6
- package/dist/donut-chart/root/donut-chart-root.css.js +1 -1
- package/dist/donut-chart/root/donut-chart-root.d.ts +1 -1
- package/dist/legend/root/legend-root.js +2 -6
- package/dist/line-chart/root/line-chart-root.d.ts +15 -6
- package/dist/menu/item/menu-item.d.ts +7 -4
- package/dist/menu/root/menu-root.d.ts +1 -1
- package/dist/navigation/root/navigation-root.d.ts +1 -1
- package/dist/pagination/root/pagination-root.d.ts +1 -1
- package/dist/pagination/size/pagination-size.d.ts +1 -1
- package/dist/pagination/summary/pagination-summary.d.ts +1 -1
- package/dist/scatter-chart/root/scatter-chart-root.css.js +1 -1
- package/dist/scatter-chart/root/scatter-chart-root.d.ts +25 -1
- package/dist/steps/root/steps-root.d.ts +1 -1
- package/dist/steps/step/step.d.ts +1 -1
- package/dist/tabs/root/tabs-root.d.ts +12 -5
- package/package.json +6 -6
- package/types/jsx.d.ts +814 -170
- package/types/vue.d.ts +109 -52
package/types/jsx.d.ts
CHANGED
|
@@ -390,12 +390,12 @@ export type HelixAccordionItemElementEvent<E = Event> = TypedEvent<
|
|
|
390
390
|
HelixAccordionItem,
|
|
391
391
|
E
|
|
392
392
|
>;
|
|
393
|
-
/** `helix-before-open` event type */
|
|
394
|
-
export type HelixAccordionItemHelixBeforeOpenElementEvent =
|
|
395
|
-
HelixAccordionItemElementEvent<HelixBeforeOpenEvent>;
|
|
396
393
|
/** `helix-before-close` event type */
|
|
397
394
|
export type HelixAccordionItemHelixBeforeCloseElementEvent =
|
|
398
395
|
HelixAccordionItemElementEvent<HelixBeforeCloseEvent>;
|
|
396
|
+
/** `helix-before-open` event type */
|
|
397
|
+
export type HelixAccordionItemHelixBeforeOpenElementEvent =
|
|
398
|
+
HelixAccordionItemElementEvent<HelixBeforeOpenEvent>;
|
|
399
399
|
|
|
400
400
|
export type HelixAccordionItemProps = {
|
|
401
401
|
/** Whether the element is open.
|
|
@@ -452,14 +452,14 @@ it, and the resting state of a reflected property is the attribute's
|
|
|
452
452
|
absence. Caught by `hydration.dom.spec.ts`. */
|
|
453
453
|
name?: (HelixAccordionItem["name"]) | undefined;
|
|
454
454
|
|
|
455
|
-
/** Fired before the item opens or closes. Cancelable: refusing it takes the decision and nothing moves. */
|
|
456
|
-
"onhelix-before-open"?: ((
|
|
457
|
-
e: HelixAccordionItemHelixBeforeOpenElementEvent,
|
|
458
|
-
) => void) | undefined;
|
|
459
455
|
/** Fired before the section closes, and cancelable. */
|
|
460
456
|
"onhelix-before-close"?: ((
|
|
461
457
|
e: HelixAccordionItemHelixBeforeCloseElementEvent,
|
|
462
458
|
) => void) | undefined;
|
|
459
|
+
/** Fired before the section opens. Cancelable: refusing it takes the decision and nothing moves. */
|
|
460
|
+
"onhelix-before-open"?: ((
|
|
461
|
+
e: HelixAccordionItemHelixBeforeOpenElementEvent,
|
|
462
|
+
) => void) | undefined;
|
|
463
463
|
/** Says the state moved, carrying `newState` and `oldState`. */
|
|
464
464
|
ontoggle?: ((e: HelixAccordionItemElementEvent) => void) | undefined;
|
|
465
465
|
};
|
|
@@ -518,14 +518,14 @@ empty string writes `name=""` onto every item ever rendered: Lit reflects
|
|
|
518
518
|
it, and the resting state of a reflected property is the attribute's
|
|
519
519
|
absence. Caught by `hydration.dom.spec.ts`. */
|
|
520
520
|
"prop:name"?: (HelixAccordionItem["name"]) | undefined;
|
|
521
|
-
/** Fired before the item opens or closes. Cancelable: refusing it takes the decision and nothing moves. */
|
|
522
|
-
"on:helix-before-open"?: ((
|
|
523
|
-
e: HelixAccordionItemHelixBeforeOpenElementEvent,
|
|
524
|
-
) => void) | undefined;
|
|
525
521
|
/** Fired before the section closes, and cancelable. */
|
|
526
522
|
"on:helix-before-close"?: ((
|
|
527
523
|
e: HelixAccordionItemHelixBeforeCloseElementEvent,
|
|
528
524
|
) => void) | undefined;
|
|
525
|
+
/** Fired before the section opens. Cancelable: refusing it takes the decision and nothing moves. */
|
|
526
|
+
"on:helix-before-open"?: ((
|
|
527
|
+
e: HelixAccordionItemHelixBeforeOpenElementEvent,
|
|
528
|
+
) => void) | undefined;
|
|
529
529
|
/** Says the state moved, carrying `newState` and `oldState`. */
|
|
530
530
|
"on:toggle"?: ((e: HelixAccordionItemElementEvent) => void) | undefined;
|
|
531
531
|
|
|
@@ -937,9 +937,13 @@ words and is already written. */
|
|
|
937
937
|
label?: (HelixAreaChart["label"]) | undefined;
|
|
938
938
|
/** How a band's edge gets from one reading to the next.
|
|
939
939
|
|
|
940
|
-
|
|
941
|
-
|
|
942
|
-
|
|
940
|
+
Three values, and the class doc argues for each: `straight` is absent and
|
|
941
|
+
is the default, `smooth` is for a stack read as a shape and is the one that
|
|
942
|
+
can draw a part as less than nothing, `step` is for a quantity that changes
|
|
943
|
+
at a moment and is ordered the way `straight` is.
|
|
944
|
+
|
|
945
|
+
Absent rather than defaulted because a reflecting property with a default
|
|
946
|
+
writes its attribute onto every host, including the ones nobody configured. */
|
|
943
947
|
curve?: (HelixAreaChart["curve"]) | undefined;
|
|
944
948
|
/** Which rules are drawn across the plot, if any.
|
|
945
949
|
|
|
@@ -976,9 +980,13 @@ words and is already written. */
|
|
|
976
980
|
"prop:label"?: (HelixAreaChart["label"]) | undefined;
|
|
977
981
|
/** How a band's edge gets from one reading to the next.
|
|
978
982
|
|
|
979
|
-
|
|
980
|
-
|
|
981
|
-
|
|
983
|
+
Three values, and the class doc argues for each: `straight` is absent and
|
|
984
|
+
is the default, `smooth` is for a stack read as a shape and is the one that
|
|
985
|
+
can draw a part as less than nothing, `step` is for a quantity that changes
|
|
986
|
+
at a moment and is ordered the way `straight` is.
|
|
987
|
+
|
|
988
|
+
Absent rather than defaulted because a reflecting property with a default
|
|
989
|
+
writes its attribute onto every host, including the ones nobody configured. */
|
|
982
990
|
"prop:curve"?: (HelixAreaChart["curve"]) | undefined;
|
|
983
991
|
/** Which rules are drawn across the plot, if any.
|
|
984
992
|
|
|
@@ -1411,6 +1419,12 @@ The chart's treatment, which every series takes unless `outlined` or
|
|
|
1411
1419
|
of the series color with that edge on it, and absent is the filled column,
|
|
1412
1420
|
per the rule that a reflected property takes no default.
|
|
1413
1421
|
|
|
1422
|
+
`solid` is that filled column written out. It matches no rule in the sheet
|
|
1423
|
+
and lands on the base one, which is what the resting value of every axis in
|
|
1424
|
+
the registry does, and it is worth having so a consumer switching a chart
|
|
1425
|
+
between treatments has a word for the one it started at rather than having
|
|
1426
|
+
to remove the attribute.
|
|
1427
|
+
|
|
1414
1428
|
**It composes with `material` rather than competing with it.** Emphasis
|
|
1415
1429
|
decides what is drawn and material decides how much of it comes through, so
|
|
1416
1430
|
`glass` thins whatever emphasis put there: the fill on a solid column, the
|
|
@@ -1467,10 +1481,15 @@ having the datum rather than by painting it invisibly. */
|
|
|
1467
1481
|
material?: (HelixBarChart["material"]) | undefined;
|
|
1468
1482
|
/** Which series are drawn as an outline rather than a fill, by name.
|
|
1469
1483
|
|
|
1470
|
-
|
|
1471
|
-
the way `lines` and `secondary` are, so a chart says
|
|
1472
|
-
rather than counting columns. Names because they are
|
|
1473
|
-
carries and what the legend already shows.
|
|
1484
|
+
Separated by whitespace or commas and matched against the column headings
|
|
1485
|
+
the table gives, the way `lines` and `secondary` are, so a chart says
|
|
1486
|
+
`outlined="Forecast"` rather than counting columns. Names because they are
|
|
1487
|
+
what the table already carries and what the legend already shows.
|
|
1488
|
+
|
|
1489
|
+
All five read one splitter, `seriesNames` in `core`, because the sentence
|
|
1490
|
+
above was true of the matching and false of the splitting: these three took
|
|
1491
|
+
a comma and those two did not, so `lines="Gateway, Billing"` drew no line
|
|
1492
|
+
and said nothing.
|
|
1474
1493
|
|
|
1475
1494
|
**The case this exists for is a series that is not a measurement.** A
|
|
1476
1495
|
forecast, a target, a budget: something drawn on the same axis as the
|
|
@@ -1539,28 +1558,38 @@ and reach no reader through the table. */
|
|
|
1539
1558
|
gridlines?: (HelixBarChart["gridlines"]) | undefined;
|
|
1540
1559
|
/** Which series are drawn as a line instead of as columns, by name.
|
|
1541
1560
|
|
|
1542
|
-
|
|
1543
|
-
chart says `lines="Margin"` rather than counting
|
|
1544
|
-
they are what the table already carries and what the
|
|
1545
|
-
an index is a fourth place the column order is
|
|
1546
|
-
one to go stale when somebody moves a column.
|
|
1547
|
-
|
|
1548
|
-
**
|
|
1549
|
-
|
|
1550
|
-
something comparable to the columns beside it.
|
|
1551
|
-
|
|
1552
|
-
|
|
1553
|
-
|
|
1554
|
-
|
|
1555
|
-
|
|
1556
|
-
|
|
1557
|
-
|
|
1561
|
+
Separated by whitespace or commas and matched against the column headings
|
|
1562
|
+
the table gives, so a chart says `lines="Margin"` rather than counting
|
|
1563
|
+
columns. Names because they are what the table already carries and what the
|
|
1564
|
+
legend already shows: an index is a fourth place the column order is
|
|
1565
|
+
written down and the first one to go stale when somebody moves a column.
|
|
1566
|
+
|
|
1567
|
+
**This says which mark a series takes and nothing about which scale it is
|
|
1568
|
+
measured on.** Named here alone, a line shares the columns' domain, so it
|
|
1569
|
+
says something comparable to the columns beside it.
|
|
1570
|
+
|
|
1571
|
+
The other half of a combination chart, a count against a percentage on a
|
|
1572
|
+
scale of its own, is `secondary`, which is a separate property because it
|
|
1573
|
+
is a separate question and because the two compose: `with-a-second-axis`
|
|
1574
|
+
ships naming one series in both. The argument for why a second scale is opt
|
|
1575
|
+
in, and why setting it labels both axes, is written there.
|
|
1576
|
+
|
|
1577
|
+
A line among columns measures from zero, because the columns do and they
|
|
1578
|
+
share the axis. So does a line on the second scale, which is that scale's
|
|
1579
|
+
own rule rather than this one's. */
|
|
1558
1580
|
lines?: (HelixBarChart["lines"]) | undefined;
|
|
1559
1581
|
/** Which series are measured against a scale of their own, by name.
|
|
1560
1582
|
|
|
1561
|
-
|
|
1562
|
-
|
|
1563
|
-
|
|
1583
|
+
Separated and matched the way `lines` is, against the column headings the
|
|
1584
|
+
table gives. Opt in: absent, every series shares one domain, which is what
|
|
1585
|
+
makes a chart comparable and is the right default.
|
|
1586
|
+
|
|
1587
|
+
**The scale, and `lines` is the mark.** The two are separate properties
|
|
1588
|
+
because they answer separate questions and a series usually wants both:
|
|
1589
|
+
a percentage beside a count is drawn as a line *and* measured on its own
|
|
1590
|
+
axis, which is what `with-a-second-axis` writes out. Neither implies the
|
|
1591
|
+
other, so a series can be a line on the shared scale and a column can have
|
|
1592
|
+
a scale to itself.
|
|
1564
1593
|
|
|
1565
1594
|
**Two scales on one frame let an author put any two shapes in any relation
|
|
1566
1595
|
by choosing the ranges, and a reader cannot see it happening.** That is not
|
|
@@ -1592,6 +1621,12 @@ The chart's treatment, which every series takes unless `outlined` or
|
|
|
1592
1621
|
of the series color with that edge on it, and absent is the filled column,
|
|
1593
1622
|
per the rule that a reflected property takes no default.
|
|
1594
1623
|
|
|
1624
|
+
`solid` is that filled column written out. It matches no rule in the sheet
|
|
1625
|
+
and lands on the base one, which is what the resting value of every axis in
|
|
1626
|
+
the registry does, and it is worth having so a consumer switching a chart
|
|
1627
|
+
between treatments has a word for the one it started at rather than having
|
|
1628
|
+
to remove the attribute.
|
|
1629
|
+
|
|
1595
1630
|
**It composes with `material` rather than competing with it.** Emphasis
|
|
1596
1631
|
decides what is drawn and material decides how much of it comes through, so
|
|
1597
1632
|
`glass` thins whatever emphasis put there: the fill on a solid column, the
|
|
@@ -1648,10 +1683,15 @@ having the datum rather than by painting it invisibly. */
|
|
|
1648
1683
|
"prop:material"?: (HelixBarChart["material"]) | undefined;
|
|
1649
1684
|
/** Which series are drawn as an outline rather than a fill, by name.
|
|
1650
1685
|
|
|
1651
|
-
|
|
1652
|
-
the way `lines` and `secondary` are, so a chart says
|
|
1653
|
-
rather than counting columns. Names because they are
|
|
1654
|
-
carries and what the legend already shows.
|
|
1686
|
+
Separated by whitespace or commas and matched against the column headings
|
|
1687
|
+
the table gives, the way `lines` and `secondary` are, so a chart says
|
|
1688
|
+
`outlined="Forecast"` rather than counting columns. Names because they are
|
|
1689
|
+
what the table already carries and what the legend already shows.
|
|
1690
|
+
|
|
1691
|
+
All five read one splitter, `seriesNames` in `core`, because the sentence
|
|
1692
|
+
above was true of the matching and false of the splitting: these three took
|
|
1693
|
+
a comma and those two did not, so `lines="Gateway, Billing"` drew no line
|
|
1694
|
+
and said nothing.
|
|
1655
1695
|
|
|
1656
1696
|
**The case this exists for is a series that is not a measurement.** A
|
|
1657
1697
|
forecast, a target, a budget: something drawn on the same axis as the
|
|
@@ -1720,28 +1760,38 @@ and reach no reader through the table. */
|
|
|
1720
1760
|
"prop:gridlines"?: (HelixBarChart["gridlines"]) | undefined;
|
|
1721
1761
|
/** Which series are drawn as a line instead of as columns, by name.
|
|
1722
1762
|
|
|
1723
|
-
|
|
1724
|
-
chart says `lines="Margin"` rather than counting
|
|
1725
|
-
they are what the table already carries and what the
|
|
1726
|
-
an index is a fourth place the column order is
|
|
1727
|
-
one to go stale when somebody moves a column.
|
|
1728
|
-
|
|
1729
|
-
**
|
|
1730
|
-
|
|
1731
|
-
something comparable to the columns beside it.
|
|
1732
|
-
|
|
1733
|
-
|
|
1734
|
-
|
|
1735
|
-
|
|
1736
|
-
|
|
1737
|
-
|
|
1738
|
-
|
|
1763
|
+
Separated by whitespace or commas and matched against the column headings
|
|
1764
|
+
the table gives, so a chart says `lines="Margin"` rather than counting
|
|
1765
|
+
columns. Names because they are what the table already carries and what the
|
|
1766
|
+
legend already shows: an index is a fourth place the column order is
|
|
1767
|
+
written down and the first one to go stale when somebody moves a column.
|
|
1768
|
+
|
|
1769
|
+
**This says which mark a series takes and nothing about which scale it is
|
|
1770
|
+
measured on.** Named here alone, a line shares the columns' domain, so it
|
|
1771
|
+
says something comparable to the columns beside it.
|
|
1772
|
+
|
|
1773
|
+
The other half of a combination chart, a count against a percentage on a
|
|
1774
|
+
scale of its own, is `secondary`, which is a separate property because it
|
|
1775
|
+
is a separate question and because the two compose: `with-a-second-axis`
|
|
1776
|
+
ships naming one series in both. The argument for why a second scale is opt
|
|
1777
|
+
in, and why setting it labels both axes, is written there.
|
|
1778
|
+
|
|
1779
|
+
A line among columns measures from zero, because the columns do and they
|
|
1780
|
+
share the axis. So does a line on the second scale, which is that scale's
|
|
1781
|
+
own rule rather than this one's. */
|
|
1739
1782
|
"prop:lines"?: (HelixBarChart["lines"]) | undefined;
|
|
1740
1783
|
/** Which series are measured against a scale of their own, by name.
|
|
1741
1784
|
|
|
1742
|
-
|
|
1743
|
-
|
|
1744
|
-
|
|
1785
|
+
Separated and matched the way `lines` is, against the column headings the
|
|
1786
|
+
table gives. Opt in: absent, every series shares one domain, which is what
|
|
1787
|
+
makes a chart comparable and is the right default.
|
|
1788
|
+
|
|
1789
|
+
**The scale, and `lines` is the mark.** The two are separate properties
|
|
1790
|
+
because they answer separate questions and a series usually wants both:
|
|
1791
|
+
a percentage beside a count is drawn as a line *and* measured on its own
|
|
1792
|
+
axis, which is what `with-a-second-axis` writes out. Neither implies the
|
|
1793
|
+
other, so a series can be a line on the shared scale and a column can have
|
|
1794
|
+
a scale to itself.
|
|
1745
1795
|
|
|
1746
1796
|
**Two scales on one frame let an author put any two shapes in any relation
|
|
1747
1797
|
by choosing the ranges, and a reader cannot see it happening.** That is not
|
|
@@ -6828,7 +6878,15 @@ the bar chart's baseline is not a property at all.
|
|
|
6828
6878
|
circumference, which needs the radius, and reading a custom property means
|
|
6829
6879
|
`getComputedStyle`, which is client-only: a server would draw a different
|
|
6830
6880
|
ring than the client. A plot's proportions are markup for the same reason
|
|
6831
|
-
`curve` is.
|
|
6881
|
+
`curve` is.
|
|
6882
|
+
|
|
6883
|
+
**And so it does not reflect**, which is the same argument read forward. No
|
|
6884
|
+
selector on either tier asks about it and none can want to: everything the
|
|
6885
|
+
thickness decides is arithmetic done here and published as
|
|
6886
|
+
`--donut-chart-stroke`, which is a number a rule can do sums with where the
|
|
6887
|
+
word is not. Reflected, it wrote a value onto every host a script had set
|
|
6888
|
+
it on for nothing to read. `sweep` beside it is the converse and reflects,
|
|
6889
|
+
because three rules select on it. */
|
|
6832
6890
|
hole?: (HelixDonutChart["hole"]) | undefined;
|
|
6833
6891
|
/** How much of the circle the whole occupies.
|
|
6834
6892
|
|
|
@@ -6926,7 +6984,15 @@ the bar chart's baseline is not a property at all.
|
|
|
6926
6984
|
circumference, which needs the radius, and reading a custom property means
|
|
6927
6985
|
`getComputedStyle`, which is client-only: a server would draw a different
|
|
6928
6986
|
ring than the client. A plot's proportions are markup for the same reason
|
|
6929
|
-
`curve` is.
|
|
6987
|
+
`curve` is.
|
|
6988
|
+
|
|
6989
|
+
**And so it does not reflect**, which is the same argument read forward. No
|
|
6990
|
+
selector on either tier asks about it and none can want to: everything the
|
|
6991
|
+
thickness decides is arithmetic done here and published as
|
|
6992
|
+
`--donut-chart-stroke`, which is a number a rule can do sums with where the
|
|
6993
|
+
word is not. Reflected, it wrote a value onto every host a script had set
|
|
6994
|
+
it on for nothing to read. `sweep` beside it is the converse and reflects,
|
|
6995
|
+
because three rules select on it. */
|
|
6930
6996
|
"prop:hole"?: (HelixDonutChart["hole"]) | undefined;
|
|
6931
6997
|
/** How much of the circle the whole occupies.
|
|
6932
6998
|
|
|
@@ -9513,7 +9579,20 @@ Matched as `outlined` is. */
|
|
|
9513
9579
|
/** Which way to read the table.
|
|
9514
9580
|
|
|
9515
9581
|
Absent is `series`, one entry per data column. `categories` reads one entry
|
|
9516
|
-
per body row instead, for a donut, whose slices are the rows.
|
|
9582
|
+
per body row instead, for a donut, whose slices are the rows.
|
|
9583
|
+
|
|
9584
|
+
**`measures` is `series` without the first column, and it is for a
|
|
9585
|
+
scatter.** That chart reads its first numeric column as the measure
|
|
9586
|
+
*across*, so its first plotted series is the table's second and everything
|
|
9587
|
+
a legend beside it named was one color out: the across column wearing the
|
|
9588
|
+
color of the first series drawn, and each real series wearing the next
|
|
9589
|
+
one's. The across gets no entry rather than a shifted one, because it is an
|
|
9590
|
+
axis and a scatter already writes its name at the end of the scale under
|
|
9591
|
+
the plot.
|
|
9592
|
+
|
|
9593
|
+
A legend cannot ask the chart which of these it is, `for` naming the table
|
|
9594
|
+
they share and not each other, so the consumer says it. That is the same
|
|
9595
|
+
shape `categories` already has. */
|
|
9517
9596
|
entries?: (HelixLegend["entries"]) | undefined;
|
|
9518
9597
|
/** The id of the table to take the names from.
|
|
9519
9598
|
|
|
@@ -9596,7 +9675,20 @@ Matched as `outlined` is. */
|
|
|
9596
9675
|
/** Which way to read the table.
|
|
9597
9676
|
|
|
9598
9677
|
Absent is `series`, one entry per data column. `categories` reads one entry
|
|
9599
|
-
per body row instead, for a donut, whose slices are the rows.
|
|
9678
|
+
per body row instead, for a donut, whose slices are the rows.
|
|
9679
|
+
|
|
9680
|
+
**`measures` is `series` without the first column, and it is for a
|
|
9681
|
+
scatter.** That chart reads its first numeric column as the measure
|
|
9682
|
+
*across*, so its first plotted series is the table's second and everything
|
|
9683
|
+
a legend beside it named was one color out: the across column wearing the
|
|
9684
|
+
color of the first series drawn, and each real series wearing the next
|
|
9685
|
+
one's. The across gets no entry rather than a shifted one, because it is an
|
|
9686
|
+
axis and a scatter already writes its name at the end of the scale under
|
|
9687
|
+
the plot.
|
|
9688
|
+
|
|
9689
|
+
A legend cannot ask the chart which of these it is, `for` naming the table
|
|
9690
|
+
they share and not each other, so the consumer says it. That is the same
|
|
9691
|
+
shape `categories` already has. */
|
|
9600
9692
|
"prop:entries"?: (HelixLegend["entries"]) | undefined;
|
|
9601
9693
|
/** The id of the table to take the names from.
|
|
9602
9694
|
|
|
@@ -9728,9 +9820,20 @@ useful thing: it is where a reader looks for "and what is it now", which is
|
|
|
9728
9820
|
the question a sparkline's single mark answers too.
|
|
9729
9821
|
|
|
9730
9822
|
`none` lets the lines stop on their own, which suits a chart read for its
|
|
9731
|
-
shape rather than for where it finished.
|
|
9823
|
+
shape rather than for where it finished. `square` is the same mark with its
|
|
9824
|
+
corners, for a drawing whose neighbors are square, the columns of a table
|
|
9825
|
+
beside it for instance. `ring` lets the ground through, for a chart drawn
|
|
9826
|
+
over something busy. `triangle` points along the axis and reads as "and
|
|
9827
|
+
onward" rather than as a second claim about the data.
|
|
9828
|
+
|
|
9829
|
+
The shapes come from
|
|
9732
9830
|
`helix/styled/src/shared/chart/terminus.css`, the same sheet `Sparkline` takes, so
|
|
9733
|
-
the set is identical wherever one appears.
|
|
9831
|
+
the set is identical wherever one appears. **Which is why every value is
|
|
9832
|
+
named here.** `Sparkline` shipped `square` implemented, drawn, asserted and
|
|
9833
|
+
undocumented until the cohort before this one; this family reads the same
|
|
9834
|
+
four out of the same sheet and had left two of them unwritten, so the
|
|
9835
|
+
finding arrived twice. A shared vocabulary wants naming at each door into
|
|
9836
|
+
it, because a reader arrives at one door and not at the set.
|
|
9734
9837
|
|
|
9735
9838
|
`ring` is the one that asks something of the drawing. It leaves a hole and a
|
|
9736
9839
|
line ends at the reading, which is the hole's center, so the `<svg>` is
|
|
@@ -9862,9 +9965,20 @@ useful thing: it is where a reader looks for "and what is it now", which is
|
|
|
9862
9965
|
the question a sparkline's single mark answers too.
|
|
9863
9966
|
|
|
9864
9967
|
`none` lets the lines stop on their own, which suits a chart read for its
|
|
9865
|
-
shape rather than for where it finished.
|
|
9968
|
+
shape rather than for where it finished. `square` is the same mark with its
|
|
9969
|
+
corners, for a drawing whose neighbors are square, the columns of a table
|
|
9970
|
+
beside it for instance. `ring` lets the ground through, for a chart drawn
|
|
9971
|
+
over something busy. `triangle` points along the axis and reads as "and
|
|
9972
|
+
onward" rather than as a second claim about the data.
|
|
9973
|
+
|
|
9974
|
+
The shapes come from
|
|
9866
9975
|
`helix/styled/src/shared/chart/terminus.css`, the same sheet `Sparkline` takes, so
|
|
9867
|
-
the set is identical wherever one appears.
|
|
9976
|
+
the set is identical wherever one appears. **Which is why every value is
|
|
9977
|
+
named here.** `Sparkline` shipped `square` implemented, drawn, asserted and
|
|
9978
|
+
undocumented until the cohort before this one; this family reads the same
|
|
9979
|
+
four out of the same sheet and had left two of them unwritten, so the
|
|
9980
|
+
finding arrived twice. A shared vocabulary wants naming at each door into
|
|
9981
|
+
it, because a reader arrives at one door and not at the set.
|
|
9868
9982
|
|
|
9869
9983
|
`ring` is the one that asks something of the drawing. It leaves a hole and a
|
|
9870
9984
|
line ends at the reading, which is the hole's center, so the `<svg>` is
|
|
@@ -19970,8 +20084,8 @@ export type CustomElements = {
|
|
|
19970
20084
|
*
|
|
19971
20085
|
* Events that will be emitted by the component.
|
|
19972
20086
|
*
|
|
19973
|
-
* - `helix-before-open`: Fired before the item opens or closes. Cancelable: refusing it takes the decision and nothing moves.
|
|
19974
20087
|
* - `helix-before-close`: Fired before the section closes, and cancelable.
|
|
20088
|
+
* - `helix-before-open`: Fired before the section opens. Cancelable: refusing it takes the decision and nothing moves.
|
|
19975
20089
|
* - `toggle`: Says the state moved, carrying `newState` and `oldState`.
|
|
19976
20090
|
*
|
|
19977
20091
|
* ## Slots
|
|
@@ -20012,7 +20126,7 @@ export type CustomElements = {
|
|
|
20012
20126
|
* - `chevron`: The open and close indicator.
|
|
20013
20127
|
* - `container`: The outer wrapper.
|
|
20014
20128
|
* - `content`: The revealed region.
|
|
20015
|
-
* - `content-inner`:
|
|
20129
|
+
* - `content-inner`: The clipping box inside the animated region. The inset is on the slot within it, not here: padding on the grid item survives a zero track, which left a shut section with a band of space under it.
|
|
20016
20130
|
* - `trigger`: The clickable summary row.
|
|
20017
20131
|
*
|
|
20018
20132
|
* ## CSS States
|
|
@@ -20381,6 +20495,30 @@ export type CustomElements = {
|
|
|
20381
20495
|
* the bands overlap where they are drawn and a translucent one would show the
|
|
20382
20496
|
* others through it.
|
|
20383
20497
|
*
|
|
20498
|
+
* **No visual axis applies here, and that is the answer rather than a gap.**
|
|
20499
|
+
* Both refusals are geometric and both were argued in the stylesheet before
|
|
20500
|
+
* they were argued anywhere a reader looks.
|
|
20501
|
+
*
|
|
20502
|
+
* `emphasis` is which of a family's two marks carries the reading, and here
|
|
20503
|
+
* neither can give way. The fill is the value, a band's thickness being its
|
|
20504
|
+
* amount, and the edge is the boundary, which is why it is drawn at full color
|
|
20505
|
+
* over a pale fill rather than left to two pale fills meeting. Every point on
|
|
20506
|
+
* the axis moves one at the other's expense: `outlined` thins the fill until
|
|
20507
|
+
* the chart is a set of cumulative lines, which is `LineChart` and is the form
|
|
20508
|
+
* this one exists because a reader cannot read shares off; `solid` takes the
|
|
20509
|
+
* fill to the series' own color, which is the edge's color, so the boundary
|
|
20510
|
+
* disappears into the band it bounds. `LineChart` can take the axis because its
|
|
20511
|
+
* wash is optional there, `area` deciding whether one is drawn at all.
|
|
20512
|
+
*
|
|
20513
|
+
* `material` is what reads through a mark, and a band cannot let anything
|
|
20514
|
+
* through. Each is drawn as everything under its top edge with the next one
|
|
20515
|
+
* down covering the rest, so a translucent band shows the bands behind it and
|
|
20516
|
+
* reads as a third color that is in no palette. That is `LineChart`'s recorded
|
|
20517
|
+
* reason for refusing `wash`, met here from the other side. The strength of a
|
|
20518
|
+
* fill is still adjustable and is `--area-chart-fill-strength`, which is a
|
|
20519
|
+
* continuum rather than an axis and is a theme's business rather than a
|
|
20520
|
+
* reader's.
|
|
20521
|
+
*
|
|
20384
20522
|
* ## Attributes & Properties
|
|
20385
20523
|
*
|
|
20386
20524
|
* Component attributes and properties that can be applied to the element or by using JavaScript.
|
|
@@ -20399,9 +20537,13 @@ export type CustomElements = {
|
|
|
20399
20537
|
* words and is already written.
|
|
20400
20538
|
* - `curve`: How a band's edge gets from one reading to the next.
|
|
20401
20539
|
*
|
|
20402
|
-
*
|
|
20403
|
-
*
|
|
20404
|
-
*
|
|
20540
|
+
* Three values, and the class doc argues for each: `straight` is absent and
|
|
20541
|
+
* is the default, `smooth` is for a stack read as a shape and is the one that
|
|
20542
|
+
* can draw a part as less than nothing, `step` is for a quantity that changes
|
|
20543
|
+
* at a moment and is ordered the way `straight` is.
|
|
20544
|
+
*
|
|
20545
|
+
* Absent rather than defaulted because a reflecting property with a default
|
|
20546
|
+
* writes its attribute onto every host, including the ones nobody configured.
|
|
20405
20547
|
* - `gridlines`: Which rules are drawn across the plot, if any.
|
|
20406
20548
|
*
|
|
20407
20549
|
* The same three values `LineChart` takes, with the same fallback: a bare
|
|
@@ -20441,6 +20583,11 @@ export type CustomElements = {
|
|
|
20441
20583
|
* calendar week, and declaring that against a base class whose `rows` is a
|
|
20442
20584
|
* `Row[]` getter is a type error at best. Name the member for what it holds
|
|
20443
20585
|
* rather than for the shortest word available. (property only) (readonly)
|
|
20586
|
+
* - `plottedColumns`: Which cells of a row hold numbers, by their place in it, in table order.
|
|
20587
|
+
*
|
|
20588
|
+
* The same test `readSeries` applies when it drops a column of notes: a
|
|
20589
|
+
* column is a series where any row parses, so a series survives one blank
|
|
20590
|
+
* cell and a column of words is never one. (property only) (readonly)
|
|
20444
20591
|
* - `readings`: How many readings there are, which is what the pointer maps onto. (property only) (readonly)
|
|
20445
20592
|
* - `whenSettled`: Resolves a frame after the first update, when transitions are switched on.
|
|
20446
20593
|
*
|
|
@@ -20463,6 +20610,24 @@ export type CustomElements = {
|
|
|
20463
20610
|
* browser harness's awaits it alone: a browser always runs the frame, and a
|
|
20464
20611
|
* timer beside it was a bet on how long one takes, which a busy run lost. (property only) (readonly)
|
|
20465
20612
|
*
|
|
20613
|
+
* ## Methods
|
|
20614
|
+
*
|
|
20615
|
+
* Methods that can be called to access component functionality.
|
|
20616
|
+
*
|
|
20617
|
+
* - `seriesOf(cell: number) => number | undefined`: The palette slot the cell at this place in a row is drawn in.
|
|
20618
|
+
*
|
|
20619
|
+
* **A cell's place in its row is not its series' depth, and the tooltip
|
|
20620
|
+
* spent a while assuming it was.** `readSeries` drops a column nothing
|
|
20621
|
+
* parses and `readRows` keeps it, so one column of notes among the figures
|
|
20622
|
+
* moves every column after it one color along in the bubble: a row reading
|
|
20623
|
+
* `Referral 1,080` wearing series three's green beside a legend that says
|
|
20624
|
+
* series three is something else, which is the one failure the dot exists
|
|
20625
|
+
* to prevent.
|
|
20626
|
+
*
|
|
20627
|
+
* Overridden where a chart reads the table some other way. `ScatterChart`
|
|
20628
|
+
* splits the first plotted column off as the measure across, so its first
|
|
20629
|
+
* *plotted* series is this table's second numeric column.
|
|
20630
|
+
*
|
|
20466
20631
|
* ## CSS Custom Properties
|
|
20467
20632
|
*
|
|
20468
20633
|
* CSS variables available for styling the component.
|
|
@@ -20472,6 +20637,7 @@ export type CustomElements = {
|
|
|
20472
20637
|
* - `--area-chart-gap`: Space between the drawing and its labels. (default: `undefined`)
|
|
20473
20638
|
* - `--area-chart-gridline-color`: One rule across the plot, under `gridlines`. (default: `undefined`)
|
|
20474
20639
|
* - `--area-chart-width`: Thickness of a band's top edge, over `--chart-stroke`. (default: `undefined`)
|
|
20640
|
+
* - `--chart-stroke`: Thickness of a band's top edge, one name across this family, Line Chart and Bar Chart's `lines`, since the three read one shared rule. `--area-chart-width` overrides it here. (default: `undefined`)
|
|
20475
20641
|
*
|
|
20476
20642
|
* ## CSS Parts
|
|
20477
20643
|
*
|
|
@@ -20949,6 +21115,12 @@ export type CustomElements = {
|
|
|
20949
21115
|
* of the series color with that edge on it, and absent is the filled column,
|
|
20950
21116
|
* per the rule that a reflected property takes no default.
|
|
20951
21117
|
*
|
|
21118
|
+
* `solid` is that filled column written out. It matches no rule in the sheet
|
|
21119
|
+
* and lands on the base one, which is what the resting value of every axis in
|
|
21120
|
+
* the registry does, and it is worth having so a consumer switching a chart
|
|
21121
|
+
* between treatments has a word for the one it started at rather than having
|
|
21122
|
+
* to remove the attribute.
|
|
21123
|
+
*
|
|
20952
21124
|
* **It composes with `material` rather than competing with it.** Emphasis
|
|
20953
21125
|
* decides what is drawn and material decides how much of it comes through, so
|
|
20954
21126
|
* `glass` thins whatever emphasis put there: the fill on a solid column, the
|
|
@@ -21002,10 +21174,15 @@ export type CustomElements = {
|
|
|
21002
21174
|
* having the datum rather than by painting it invisibly.
|
|
21003
21175
|
* - `outlined`: Which series are drawn as an outline rather than a fill, by name.
|
|
21004
21176
|
*
|
|
21005
|
-
*
|
|
21006
|
-
* the way `lines` and `secondary` are, so a chart says
|
|
21007
|
-
* rather than counting columns. Names because they are
|
|
21008
|
-
* carries and what the legend already shows.
|
|
21177
|
+
* Separated by whitespace or commas and matched against the column headings
|
|
21178
|
+
* the table gives, the way `lines` and `secondary` are, so a chart says
|
|
21179
|
+
* `outlined="Forecast"` rather than counting columns. Names because they are
|
|
21180
|
+
* what the table already carries and what the legend already shows.
|
|
21181
|
+
*
|
|
21182
|
+
* All five read one splitter, `seriesNames` in `core`, because the sentence
|
|
21183
|
+
* above was true of the matching and false of the splitting: these three took
|
|
21184
|
+
* a comma and those two did not, so `lines="Gateway, Billing"` drew no line
|
|
21185
|
+
* and said nothing.
|
|
21009
21186
|
*
|
|
21010
21187
|
* **The case this exists for is a series that is not a measurement.** A
|
|
21011
21188
|
* forecast, a target, a budget: something drawn on the same axis as the
|
|
@@ -21067,27 +21244,37 @@ export type CustomElements = {
|
|
|
21067
21244
|
* and reach no reader through the table.
|
|
21068
21245
|
* - `lines`: Which series are drawn as a line instead of as columns, by name.
|
|
21069
21246
|
*
|
|
21070
|
-
*
|
|
21071
|
-
* chart says `lines="Margin"` rather than counting
|
|
21072
|
-
* they are what the table already carries and what the
|
|
21073
|
-
* an index is a fourth place the column order is
|
|
21074
|
-
* one to go stale when somebody moves a column.
|
|
21075
|
-
*
|
|
21076
|
-
* **
|
|
21077
|
-
*
|
|
21078
|
-
* something comparable to the columns beside it.
|
|
21079
|
-
*
|
|
21080
|
-
*
|
|
21081
|
-
*
|
|
21082
|
-
*
|
|
21083
|
-
*
|
|
21084
|
-
*
|
|
21085
|
-
*
|
|
21247
|
+
* Separated by whitespace or commas and matched against the column headings
|
|
21248
|
+
* the table gives, so a chart says `lines="Margin"` rather than counting
|
|
21249
|
+
* columns. Names because they are what the table already carries and what the
|
|
21250
|
+
* legend already shows: an index is a fourth place the column order is
|
|
21251
|
+
* written down and the first one to go stale when somebody moves a column.
|
|
21252
|
+
*
|
|
21253
|
+
* **This says which mark a series takes and nothing about which scale it is
|
|
21254
|
+
* measured on.** Named here alone, a line shares the columns' domain, so it
|
|
21255
|
+
* says something comparable to the columns beside it.
|
|
21256
|
+
*
|
|
21257
|
+
* The other half of a combination chart, a count against a percentage on a
|
|
21258
|
+
* scale of its own, is `secondary`, which is a separate property because it
|
|
21259
|
+
* is a separate question and because the two compose: `with-a-second-axis`
|
|
21260
|
+
* ships naming one series in both. The argument for why a second scale is opt
|
|
21261
|
+
* in, and why setting it labels both axes, is written there.
|
|
21262
|
+
*
|
|
21263
|
+
* A line among columns measures from zero, because the columns do and they
|
|
21264
|
+
* share the axis. So does a line on the second scale, which is that scale's
|
|
21265
|
+
* own rule rather than this one's.
|
|
21086
21266
|
* - `secondary`: Which series are measured against a scale of their own, by name.
|
|
21087
21267
|
*
|
|
21088
|
-
*
|
|
21089
|
-
*
|
|
21090
|
-
*
|
|
21268
|
+
* Separated and matched the way `lines` is, against the column headings the
|
|
21269
|
+
* table gives. Opt in: absent, every series shares one domain, which is what
|
|
21270
|
+
* makes a chart comparable and is the right default.
|
|
21271
|
+
*
|
|
21272
|
+
* **The scale, and `lines` is the mark.** The two are separate properties
|
|
21273
|
+
* because they answer separate questions and a series usually wants both:
|
|
21274
|
+
* a percentage beside a count is drawn as a line *and* measured on its own
|
|
21275
|
+
* axis, which is what `with-a-second-axis` writes out. Neither implies the
|
|
21276
|
+
* other, so a series can be a line on the shared scale and a column can have
|
|
21277
|
+
* a scale to itself.
|
|
21091
21278
|
*
|
|
21092
21279
|
* **Two scales on one frame let an author put any two shapes in any relation
|
|
21093
21280
|
* by choosing the ranges, and a reader cannot see it happening.** That is not
|
|
@@ -21136,6 +21323,11 @@ export type CustomElements = {
|
|
|
21136
21323
|
* calendar week, and declaring that against a base class whose `rows` is a
|
|
21137
21324
|
* `Row[]` getter is a type error at best. Name the member for what it holds
|
|
21138
21325
|
* rather than for the shortest word available. (property only) (readonly)
|
|
21326
|
+
* - `plottedColumns`: Which cells of a row hold numbers, by their place in it, in table order.
|
|
21327
|
+
*
|
|
21328
|
+
* The same test `readSeries` applies when it drops a column of notes: a
|
|
21329
|
+
* column is a series where any row parses, so a series survives one blank
|
|
21330
|
+
* cell and a column of words is never one. (property only) (readonly)
|
|
21139
21331
|
* - `readings`: How many readings there are, which is what the pointer maps onto. (property only) (readonly)
|
|
21140
21332
|
* - `whenSettled`: Resolves a frame after the first update, when transitions are switched on.
|
|
21141
21333
|
*
|
|
@@ -21158,6 +21350,24 @@ export type CustomElements = {
|
|
|
21158
21350
|
* browser harness's awaits it alone: a browser always runs the frame, and a
|
|
21159
21351
|
* timer beside it was a bet on how long one takes, which a busy run lost. (property only) (readonly)
|
|
21160
21352
|
*
|
|
21353
|
+
* ## Methods
|
|
21354
|
+
*
|
|
21355
|
+
* Methods that can be called to access component functionality.
|
|
21356
|
+
*
|
|
21357
|
+
* - `seriesOf(cell: number) => number | undefined`: The palette slot the cell at this place in a row is drawn in.
|
|
21358
|
+
*
|
|
21359
|
+
* **A cell's place in its row is not its series' depth, and the tooltip
|
|
21360
|
+
* spent a while assuming it was.** `readSeries` drops a column nothing
|
|
21361
|
+
* parses and `readRows` keeps it, so one column of notes among the figures
|
|
21362
|
+
* moves every column after it one color along in the bubble: a row reading
|
|
21363
|
+
* `Referral 1,080` wearing series three's green beside a legend that says
|
|
21364
|
+
* series three is something else, which is the one failure the dot exists
|
|
21365
|
+
* to prevent.
|
|
21366
|
+
*
|
|
21367
|
+
* Overridden where a chart reads the table some other way. `ScatterChart`
|
|
21368
|
+
* splits the first plotted column off as the measure across, so its first
|
|
21369
|
+
* *plotted* series is this table's second numeric column.
|
|
21370
|
+
*
|
|
21161
21371
|
* ## CSS Custom Properties
|
|
21162
21372
|
*
|
|
21163
21373
|
* CSS variables available for styling the component.
|
|
@@ -21170,7 +21380,8 @@ export type CustomElements = {
|
|
|
21170
21380
|
* - `--bar-chart-gridline-color`: One rule across the plot, under `gridlines`. (default: `undefined`)
|
|
21171
21381
|
* - `--bar-chart-line-color`: A `lines` series, overriding its series color. (default: `undefined`)
|
|
21172
21382
|
* - `--bar-chart-line-width`: Thickness of a `lines` series, over `--chart-stroke`. (default: `undefined`)
|
|
21173
|
-
* - `--
|
|
21383
|
+
* - `--chart-stroke`: Thickness of a `lines` series, one name across this family, Line Chart and Area Chart's top edge, since the three read one shared rule. `--bar-chart-line-width` overrides it here. (default: `undefined`)
|
|
21384
|
+
* - `--bar-chart-axis`: How wide an axis column is drawn, in `ch`, from the widest number on it. Written on the axis itself, and only where the categories run along the bottom: turned sideways an axis is a row and takes a line's height instead. (default: `undefined`)
|
|
21174
21385
|
* - `--bar-chart-secondary`: The color of the secondary axis when one series owns it. It resolves a `--helix-color-series-*` token, so on the headless tier alone it names something that is not there. #138. (default: `undefined`)
|
|
21175
21386
|
* - `--chart-bar-wash`: The gradient a bar would take, named per bar so the styled tier can point `fill` at it. Drawn whatever the treatment and used only where `wash="gradient"` asks for it. (default: `undefined`)
|
|
21176
21387
|
*
|
|
@@ -25636,6 +25847,14 @@ export type CustomElements = {
|
|
|
25636
25847
|
* `getComputedStyle`, which is client-only: a server would draw a different
|
|
25637
25848
|
* ring than the client. A plot's proportions are markup for the same reason
|
|
25638
25849
|
* `curve` is.
|
|
25850
|
+
*
|
|
25851
|
+
* **And so it does not reflect**, which is the same argument read forward. No
|
|
25852
|
+
* selector on either tier asks about it and none can want to: everything the
|
|
25853
|
+
* thickness decides is arithmetic done here and published as
|
|
25854
|
+
* `--donut-chart-stroke`, which is a number a rule can do sums with where the
|
|
25855
|
+
* word is not. Reflected, it wrote a value onto every host a script had set
|
|
25856
|
+
* it on for nothing to read. `sweep` beside it is the converse and reflects,
|
|
25857
|
+
* because three rules select on it.
|
|
25639
25858
|
* - `sweep`: How much of the circle the whole occupies.
|
|
25640
25859
|
*
|
|
25641
25860
|
* Absent is the full turn. `half` is a semi-donut: the same shares spread
|
|
@@ -25685,6 +25904,11 @@ export type CustomElements = {
|
|
|
25685
25904
|
* calendar week, and declaring that against a base class whose `rows` is a
|
|
25686
25905
|
* `Row[]` getter is a type error at best. Name the member for what it holds
|
|
25687
25906
|
* rather than for the shortest word available. (property only) (readonly)
|
|
25907
|
+
* - `plottedColumns`: Which cells of a row hold numbers, by their place in it, in table order.
|
|
25908
|
+
*
|
|
25909
|
+
* The same test `readSeries` applies when it drops a column of notes: a
|
|
25910
|
+
* column is a series where any row parses, so a series survives one blank
|
|
25911
|
+
* cell and a column of words is never one. (property only) (readonly)
|
|
25688
25912
|
* - `readings`: How many readings there are, which is what the pointer maps onto. (property only) (readonly)
|
|
25689
25913
|
* - `whenSettled`: Resolves a frame after the first update, when transitions are switched on.
|
|
25690
25914
|
*
|
|
@@ -25713,6 +25937,24 @@ export type CustomElements = {
|
|
|
25713
25937
|
*
|
|
25714
25938
|
* - `(default)`: Goes in the middle of the ring. A total, usually.
|
|
25715
25939
|
*
|
|
25940
|
+
* ## Methods
|
|
25941
|
+
*
|
|
25942
|
+
* Methods that can be called to access component functionality.
|
|
25943
|
+
*
|
|
25944
|
+
* - `seriesOf(cell: number) => number | undefined`: The palette slot the cell at this place in a row is drawn in.
|
|
25945
|
+
*
|
|
25946
|
+
* **A cell's place in its row is not its series' depth, and the tooltip
|
|
25947
|
+
* spent a while assuming it was.** `readSeries` drops a column nothing
|
|
25948
|
+
* parses and `readRows` keeps it, so one column of notes among the figures
|
|
25949
|
+
* moves every column after it one color along in the bubble: a row reading
|
|
25950
|
+
* `Referral 1,080` wearing series three's green beside a legend that says
|
|
25951
|
+
* series three is something else, which is the one failure the dot exists
|
|
25952
|
+
* to prevent.
|
|
25953
|
+
*
|
|
25954
|
+
* Overridden where a chart reads the table some other way. `ScatterChart`
|
|
25955
|
+
* splits the first plotted column off as the measure across, so its first
|
|
25956
|
+
* *plotted* series is this table's second numeric column.
|
|
25957
|
+
*
|
|
25716
25958
|
* ## CSS Custom Properties
|
|
25717
25959
|
*
|
|
25718
25960
|
* CSS variables available for styling the component.
|
|
@@ -27348,6 +27590,11 @@ export type CustomElements = {
|
|
|
27348
27590
|
* calendar week, and declaring that against a base class whose `rows` is a
|
|
27349
27591
|
* `Row[]` getter is a type error at best. Name the member for what it holds
|
|
27350
27592
|
* rather than for the shortest word available. (property only) (readonly)
|
|
27593
|
+
* - `plottedColumns`: Which cells of a row hold numbers, by their place in it, in table order.
|
|
27594
|
+
*
|
|
27595
|
+
* The same test `readSeries` applies when it drops a column of notes: a
|
|
27596
|
+
* column is a series where any row parses, so a series survives one blank
|
|
27597
|
+
* cell and a column of words is never one. (property only) (readonly)
|
|
27351
27598
|
* - `readings`: How many readings there are, which is what the pointer maps onto. (property only) (readonly)
|
|
27352
27599
|
* - `visible`: How many cells are actually drawn.
|
|
27353
27600
|
*
|
|
@@ -27398,6 +27645,24 @@ export type CustomElements = {
|
|
|
27398
27645
|
* - `start`: Below the strip, at the leading edge.
|
|
27399
27646
|
* - `summary`: Below the strip, in the middle.
|
|
27400
27647
|
*
|
|
27648
|
+
* ## Methods
|
|
27649
|
+
*
|
|
27650
|
+
* Methods that can be called to access component functionality.
|
|
27651
|
+
*
|
|
27652
|
+
* - `seriesOf(cell: number) => number | undefined`: The palette slot the cell at this place in a row is drawn in.
|
|
27653
|
+
*
|
|
27654
|
+
* **A cell's place in its row is not its series' depth, and the tooltip
|
|
27655
|
+
* spent a while assuming it was.** `readSeries` drops a column nothing
|
|
27656
|
+
* parses and `readRows` keeps it, so one column of notes among the figures
|
|
27657
|
+
* moves every column after it one color along in the bubble: a row reading
|
|
27658
|
+
* `Referral 1,080` wearing series three's green beside a legend that says
|
|
27659
|
+
* series three is something else, which is the one failure the dot exists
|
|
27660
|
+
* to prevent.
|
|
27661
|
+
*
|
|
27662
|
+
* Overridden where a chart reads the table some other way. `ScatterChart`
|
|
27663
|
+
* splits the first plotted column off as the measure across, so its first
|
|
27664
|
+
* *plotted* series is this table's second numeric column.
|
|
27665
|
+
*
|
|
27401
27666
|
* ## CSS Custom Properties
|
|
27402
27667
|
*
|
|
27403
27668
|
* CSS variables available for styling the component.
|
|
@@ -28318,6 +28583,19 @@ export type CustomElements = {
|
|
|
28318
28583
|
*
|
|
28319
28584
|
* Absent is `series`, one entry per data column. `categories` reads one entry
|
|
28320
28585
|
* per body row instead, for a donut, whose slices are the rows.
|
|
28586
|
+
*
|
|
28587
|
+
* **`measures` is `series` without the first column, and it is for a
|
|
28588
|
+
* scatter.** That chart reads its first numeric column as the measure
|
|
28589
|
+
* *across*, so its first plotted series is the table's second and everything
|
|
28590
|
+
* a legend beside it named was one color out: the across column wearing the
|
|
28591
|
+
* color of the first series drawn, and each real series wearing the next
|
|
28592
|
+
* one's. The across gets no entry rather than a shifted one, because it is an
|
|
28593
|
+
* axis and a scatter already writes its name at the end of the scale under
|
|
28594
|
+
* the plot.
|
|
28595
|
+
*
|
|
28596
|
+
* A legend cannot ask the chart which of these it is, `for` naming the table
|
|
28597
|
+
* they share and not each other, so the consumer says it. That is the same
|
|
28598
|
+
* shape `categories` already has.
|
|
28321
28599
|
* - `for`: The id of the table to take the names from.
|
|
28322
28600
|
*
|
|
28323
28601
|
* Resolved through `getRootNode()`, so a legend inside another component's
|
|
@@ -28383,9 +28661,15 @@ export type CustomElements = {
|
|
|
28383
28661
|
* lets one drawing fill a narrow card and a wide panel, and without
|
|
28384
28662
|
* `vector-effect: non-scaling-stroke` the same line comes out hairline in the
|
|
28385
28663
|
* first and heavy in the second. It rescues strokes and not geometry, which is
|
|
28386
|
-
* why
|
|
28387
|
-
*
|
|
28388
|
-
*
|
|
28664
|
+
* why nothing inside the drawing marks a reading: a circle in a stretched
|
|
28665
|
+
* coordinate space is an ellipse, and there is no vector-effect that answers
|
|
28666
|
+
* for a shape.
|
|
28667
|
+
*
|
|
28668
|
+
* **The last reading of each series is marked, and that is the same rule rather
|
|
28669
|
+
* than an exception to it.** `terminus` draws an HTML element placed over the
|
|
28670
|
+
* plot by percentage instead of a shape inside it, so it keeps its shape at any
|
|
28671
|
+
* width. It is on by default, as a dot, because the column of marks at the far
|
|
28672
|
+
* edge is where a reader looks for "and what is it now".
|
|
28389
28673
|
*
|
|
28390
28674
|
* ## Attributes & Properties
|
|
28391
28675
|
*
|
|
@@ -28498,9 +28782,20 @@ export type CustomElements = {
|
|
|
28498
28782
|
* the question a sparkline's single mark answers too.
|
|
28499
28783
|
*
|
|
28500
28784
|
* `none` lets the lines stop on their own, which suits a chart read for its
|
|
28501
|
-
* shape rather than for where it finished.
|
|
28785
|
+
* shape rather than for where it finished. `square` is the same mark with its
|
|
28786
|
+
* corners, for a drawing whose neighbors are square, the columns of a table
|
|
28787
|
+
* beside it for instance. `ring` lets the ground through, for a chart drawn
|
|
28788
|
+
* over something busy. `triangle` points along the axis and reads as "and
|
|
28789
|
+
* onward" rather than as a second claim about the data.
|
|
28790
|
+
*
|
|
28791
|
+
* The shapes come from
|
|
28502
28792
|
* `helix/styled/src/shared/chart/terminus.css`, the same sheet `Sparkline` takes, so
|
|
28503
|
-
* the set is identical wherever one appears.
|
|
28793
|
+
* the set is identical wherever one appears. **Which is why every value is
|
|
28794
|
+
* named here.** `Sparkline` shipped `square` implemented, drawn, asserted and
|
|
28795
|
+
* undocumented until the cohort before this one; this family reads the same
|
|
28796
|
+
* four out of the same sheet and had left two of them unwritten, so the
|
|
28797
|
+
* finding arrived twice. A shared vocabulary wants naming at each door into
|
|
28798
|
+
* it, because a reader arrives at one door and not at the set.
|
|
28504
28799
|
*
|
|
28505
28800
|
* `ring` is the one that asks something of the drawing. It leaves a hole and a
|
|
28506
28801
|
* line ends at the reading, which is the hole's center, so the `<svg>` is
|
|
@@ -28541,6 +28836,11 @@ export type CustomElements = {
|
|
|
28541
28836
|
* calendar week, and declaring that against a base class whose `rows` is a
|
|
28542
28837
|
* `Row[]` getter is a type error at best. Name the member for what it holds
|
|
28543
28838
|
* rather than for the shortest word available. (property only) (readonly)
|
|
28839
|
+
* - `plottedColumns`: Which cells of a row hold numbers, by their place in it, in table order.
|
|
28840
|
+
*
|
|
28841
|
+
* The same test `readSeries` applies when it drops a column of notes: a
|
|
28842
|
+
* column is a series where any row parses, so a series survives one blank
|
|
28843
|
+
* cell and a column of words is never one. (property only) (readonly)
|
|
28544
28844
|
* - `readings`: How many readings there are, which is what the pointer maps onto. (property only) (readonly)
|
|
28545
28845
|
* - `whenSettled`: Resolves a frame after the first update, when transitions are switched on.
|
|
28546
28846
|
*
|
|
@@ -28563,17 +28863,39 @@ export type CustomElements = {
|
|
|
28563
28863
|
* browser harness's awaits it alone: a browser always runs the frame, and a
|
|
28564
28864
|
* timer beside it was a bet on how long one takes, which a busy run lost. (property only) (readonly)
|
|
28565
28865
|
*
|
|
28866
|
+
* ## Methods
|
|
28867
|
+
*
|
|
28868
|
+
* Methods that can be called to access component functionality.
|
|
28869
|
+
*
|
|
28870
|
+
* - `seriesOf(cell: number) => number | undefined`: The palette slot the cell at this place in a row is drawn in.
|
|
28871
|
+
*
|
|
28872
|
+
* **A cell's place in its row is not its series' depth, and the tooltip
|
|
28873
|
+
* spent a while assuming it was.** `readSeries` drops a column nothing
|
|
28874
|
+
* parses and `readRows` keeps it, so one column of notes among the figures
|
|
28875
|
+
* moves every column after it one color along in the bubble: a row reading
|
|
28876
|
+
* `Referral 1,080` wearing series three's green beside a legend that says
|
|
28877
|
+
* series three is something else, which is the one failure the dot exists
|
|
28878
|
+
* to prevent.
|
|
28879
|
+
*
|
|
28880
|
+
* Overridden where a chart reads the table some other way. `ScatterChart`
|
|
28881
|
+
* splits the first plotted column off as the measure across, so its first
|
|
28882
|
+
* *plotted* series is this table's second numeric column.
|
|
28883
|
+
*
|
|
28566
28884
|
* ## CSS Custom Properties
|
|
28567
28885
|
*
|
|
28568
28886
|
* CSS variables available for styling the component.
|
|
28569
28887
|
*
|
|
28570
|
-
* - `--chart-stroke`: Thickness of a series drawn as a line,
|
|
28888
|
+
* - `--chart-stroke`: Thickness of a series drawn as a line, one name across this family, Area Chart's top edge and Bar Chart's `lines`, since the three read one shared rule. Each family's own width hook overrides it. (default: `undefined`)
|
|
28889
|
+
* - `--chart-terminus-hole`: A fill for the middle of a `ring` terminus, which is otherwise open. One name across this family and Sparkline, the two reading one shared sheet. (default: `undefined`)
|
|
28890
|
+
* - `--chart-terminus-size`: Size of the mark on each series' last reading. One name across this family and Sparkline, the two reading one shared sheet. (default: `undefined`)
|
|
28571
28891
|
* - `--line-chart-area-opacity`: How much of a line's color its wash takes. (default: `undefined`)
|
|
28572
28892
|
* - `--line-chart-band-color`: The slot the pointer is resting in. (default: `undefined`)
|
|
28573
28893
|
* - `--line-chart-block-size`: Height of the drawing. (default: `undefined`)
|
|
28574
28894
|
* - `--line-chart-gap`: Space between the drawing and its labels. (default: `undefined`)
|
|
28575
28895
|
* - `--line-chart-gridline-color`: One rule across the plot, under `gridlines`. (default: `undefined`)
|
|
28576
28896
|
* - `--line-chart-width`: Thickness of a line, over `--chart-stroke`. (default: `undefined`)
|
|
28897
|
+
* - `--chart-terminus-x`: Where a series' last reading sits horizontally, as a percentage. Written by the component. (default: `undefined`)
|
|
28898
|
+
* - `--chart-terminus-y`: Where a series' last reading sits vertically, as a percentage. Written by the component. (default: `undefined`)
|
|
28577
28899
|
*
|
|
28578
28900
|
* ## CSS Parts
|
|
28579
28901
|
*
|
|
@@ -29273,9 +29595,12 @@ export type CustomElements = {
|
|
|
29273
29595
|
>;
|
|
29274
29596
|
|
|
29275
29597
|
/**
|
|
29276
|
-
*
|
|
29277
|
-
* the
|
|
29278
|
-
*
|
|
29598
|
+
* A row draws a column beside its label only where it has something to put in
|
|
29599
|
+
* one, and the width is the menu's rather than the row's: the page reserves a
|
|
29600
|
+
* leading or a trailing track as soon as any row on it fills one, so every
|
|
29601
|
+
* label on that page starts at the same edge and a page that fills neither pays
|
|
29602
|
+
* for neither. A row knows about its own slots and nothing about its
|
|
29603
|
+
* neighbors, which is why the reservation is not made here.
|
|
29279
29604
|
*
|
|
29280
29605
|
* ## Attributes & Properties
|
|
29281
29606
|
*
|
|
@@ -33054,6 +33379,30 @@ export type CustomElements = {
|
|
|
33054
33379
|
* dense cluster reads as dense rather than as one blot, and two points that
|
|
33055
33380
|
* overlap each keep their edge.
|
|
33056
33381
|
*
|
|
33382
|
+
* **No visual axis applies here, and that is the answer rather than a gap.**
|
|
33383
|
+
* Both refusals come out of that sentence, and both were argued in the
|
|
33384
|
+
* stylesheet before they were argued anywhere a reader looks.
|
|
33385
|
+
*
|
|
33386
|
+
* `emphasis` is how much ink a mark claims, and on a scatter that channel is
|
|
33387
|
+
* already carrying data. The points rest at 0.8 so that where they pile up they
|
|
33388
|
+
* compound: how dark a region is *is* how many rows are in it, which is most of
|
|
33389
|
+
* what a reader is looking at a scatter to see and is the one thing a table of
|
|
33390
|
+
* the same numbers hides. `solid` flattens a dense cluster and a sparse one into
|
|
33391
|
+
* the same picture; `outlined` replaces the pile with overlapping rings, which
|
|
33392
|
+
* reads as texture rather than as count. An axis whose two ends each cost the
|
|
33393
|
+
* drawing its density is not a treatment, it is a second meaning for a property
|
|
33394
|
+
* the chart already spends.
|
|
33395
|
+
*
|
|
33396
|
+
* `material` is the same refusal said once more. Translucency is the density
|
|
33397
|
+
* channel here, so `glass` and `frosted` are two more named stops on a scale
|
|
33398
|
+
* the data is using, and a point admitting the page through is a point that
|
|
33399
|
+
* counts for less than one.
|
|
33400
|
+
*
|
|
33401
|
+
* What stays adjustable is `--scatter-chart-point-opacity`, and it is a
|
|
33402
|
+
* continuum rather than an axis: a chart drawn over a busier ground wants a
|
|
33403
|
+
* different resting density, and that is a fact about the ground rather than a
|
|
33404
|
+
* claim about the points.
|
|
33405
|
+
*
|
|
33057
33406
|
* ## Attributes & Properties
|
|
33058
33407
|
*
|
|
33059
33408
|
* Component attributes and properties that can be applied to the element or by using JavaScript.
|
|
@@ -33106,6 +33455,11 @@ export type CustomElements = {
|
|
|
33106
33455
|
* calendar week, and declaring that against a base class whose `rows` is a
|
|
33107
33456
|
* `Row[]` getter is a type error at best. Name the member for what it holds
|
|
33108
33457
|
* rather than for the shortest word available. (property only) (readonly)
|
|
33458
|
+
* - `plottedColumns`: Which cells of a row hold numbers, by their place in it, in table order.
|
|
33459
|
+
*
|
|
33460
|
+
* The same test `readSeries` applies when it drops a column of notes: a
|
|
33461
|
+
* column is a series where any row parses, so a series survives one blank
|
|
33462
|
+
* cell and a column of words is never one. (property only) (readonly)
|
|
33109
33463
|
* - `readings`: How many readings there are, which is what the pointer maps onto. (property only) (readonly)
|
|
33110
33464
|
* - `whenSettled`: Resolves a frame after the first update, when transitions are switched on.
|
|
33111
33465
|
*
|
|
@@ -33128,6 +33482,24 @@ export type CustomElements = {
|
|
|
33128
33482
|
* browser harness's awaits it alone: a browser always runs the frame, and a
|
|
33129
33483
|
* timer beside it was a bet on how long one takes, which a busy run lost. (property only) (readonly)
|
|
33130
33484
|
*
|
|
33485
|
+
* ## Methods
|
|
33486
|
+
*
|
|
33487
|
+
* Methods that can be called to access component functionality.
|
|
33488
|
+
*
|
|
33489
|
+
* - `seriesOf(cell: number) => number | undefined`: The palette slot the cell at this place in a row is drawn in.
|
|
33490
|
+
*
|
|
33491
|
+
* **A cell's place in its row is not its series' depth, and the tooltip
|
|
33492
|
+
* spent a while assuming it was.** `readSeries` drops a column nothing
|
|
33493
|
+
* parses and `readRows` keeps it, so one column of notes among the figures
|
|
33494
|
+
* moves every column after it one color along in the bubble: a row reading
|
|
33495
|
+
* `Referral 1,080` wearing series three's green beside a legend that says
|
|
33496
|
+
* series three is something else, which is the one failure the dot exists
|
|
33497
|
+
* to prevent.
|
|
33498
|
+
*
|
|
33499
|
+
* Overridden where a chart reads the table some other way. `ScatterChart`
|
|
33500
|
+
* splits the first plotted column off as the measure across, so its first
|
|
33501
|
+
* *plotted* series is this table's second numeric column.
|
|
33502
|
+
*
|
|
33131
33503
|
* ## CSS Custom Properties
|
|
33132
33504
|
*
|
|
33133
33505
|
* CSS variables available for styling the component.
|
|
@@ -34770,7 +35142,7 @@ export type CustomElements = {
|
|
|
34770
35142
|
* Areas where markup can be added to the component.
|
|
34771
35143
|
*
|
|
34772
35144
|
* - `(default)`: The step's name.
|
|
34773
|
-
* - `content`: What the stage holds,
|
|
35145
|
+
* - `content`: What the stage holds. Always rendered here, a tier with no stylesheet having nothing to fold it with; the styled tier opens it on the current step down a column, and a row has no space under a step to open it into.
|
|
34774
35146
|
* - `description`: A line under the name, for what the stage is for.
|
|
34775
35147
|
* - `marker`: Replaces the number, or the check a complete step shows.
|
|
34776
35148
|
*
|
|
@@ -35412,9 +35784,16 @@ export type CustomElements = {
|
|
|
35412
35784
|
>;
|
|
35413
35785
|
|
|
35414
35786
|
/**
|
|
35415
|
-
*
|
|
35416
|
-
*
|
|
35417
|
-
* a
|
|
35787
|
+
* One mark travels between the tabs rather than each of them filling and
|
|
35788
|
+
* emptying in turn. A fill that swaps is two things changing at once and reads
|
|
35789
|
+
* as a flicker; one that moves is a single object the eye follows, and it says
|
|
35790
|
+
* where the current tab was as well as where it is. `Navigation` marks its
|
|
35791
|
+
* destinations the same way and for the same reason.
|
|
35792
|
+
*
|
|
35793
|
+
* What the mark is depends on `variant`: unset it is a raised pill on the
|
|
35794
|
+
* selected tab with nothing behind the row, `underlined` makes it a bar along
|
|
35795
|
+
* the bottom of the strip on a rule, and `segmented` grows it to the tab's own
|
|
35796
|
+
* box inside a sunken track.
|
|
35418
35797
|
*
|
|
35419
35798
|
* ## Attributes & Properties
|
|
35420
35799
|
*
|
|
@@ -35484,8 +35863,8 @@ export type CustomElements = {
|
|
|
35484
35863
|
*
|
|
35485
35864
|
* Areas where markup can be added to the component.
|
|
35486
35865
|
*
|
|
35487
|
-
* - `(default)`: The tabs.
|
|
35488
|
-
* - `panels`: The panels.
|
|
35866
|
+
* - `(default)`: The tabs, which are this element's own children.
|
|
35867
|
+
* - `panels`: The panels, which are this element's own children. A wrapper around them is assigned to the slot and pairs with nothing, since the pairing walks these children rather than the slot's tree.
|
|
35489
35868
|
*
|
|
35490
35869
|
* ## Methods
|
|
35491
35870
|
*
|
|
@@ -38810,8 +39189,8 @@ export type CustomElementsSolidJs = {
|
|
|
38810
39189
|
*
|
|
38811
39190
|
* Events that will be emitted by the component.
|
|
38812
39191
|
*
|
|
38813
|
-
* - `helix-before-open`: Fired before the item opens or closes. Cancelable: refusing it takes the decision and nothing moves.
|
|
38814
39192
|
* - `helix-before-close`: Fired before the section closes, and cancelable.
|
|
39193
|
+
* - `helix-before-open`: Fired before the section opens. Cancelable: refusing it takes the decision and nothing moves.
|
|
38815
39194
|
* - `toggle`: Says the state moved, carrying `newState` and `oldState`.
|
|
38816
39195
|
*
|
|
38817
39196
|
* ## Slots
|
|
@@ -38852,7 +39231,7 @@ export type CustomElementsSolidJs = {
|
|
|
38852
39231
|
* - `chevron`: The open and close indicator.
|
|
38853
39232
|
* - `container`: The outer wrapper.
|
|
38854
39233
|
* - `content`: The revealed region.
|
|
38855
|
-
* - `content-inner`:
|
|
39234
|
+
* - `content-inner`: The clipping box inside the animated region. The inset is on the slot within it, not here: padding on the grid item survives a zero track, which left a shut section with a band of space under it.
|
|
38856
39235
|
* - `trigger`: The clickable summary row.
|
|
38857
39236
|
*
|
|
38858
39237
|
* ## CSS States
|
|
@@ -39233,6 +39612,30 @@ export type CustomElementsSolidJs = {
|
|
|
39233
39612
|
* the bands overlap where they are drawn and a translucent one would show the
|
|
39234
39613
|
* others through it.
|
|
39235
39614
|
*
|
|
39615
|
+
* **No visual axis applies here, and that is the answer rather than a gap.**
|
|
39616
|
+
* Both refusals are geometric and both were argued in the stylesheet before
|
|
39617
|
+
* they were argued anywhere a reader looks.
|
|
39618
|
+
*
|
|
39619
|
+
* `emphasis` is which of a family's two marks carries the reading, and here
|
|
39620
|
+
* neither can give way. The fill is the value, a band's thickness being its
|
|
39621
|
+
* amount, and the edge is the boundary, which is why it is drawn at full color
|
|
39622
|
+
* over a pale fill rather than left to two pale fills meeting. Every point on
|
|
39623
|
+
* the axis moves one at the other's expense: `outlined` thins the fill until
|
|
39624
|
+
* the chart is a set of cumulative lines, which is `LineChart` and is the form
|
|
39625
|
+
* this one exists because a reader cannot read shares off; `solid` takes the
|
|
39626
|
+
* fill to the series' own color, which is the edge's color, so the boundary
|
|
39627
|
+
* disappears into the band it bounds. `LineChart` can take the axis because its
|
|
39628
|
+
* wash is optional there, `area` deciding whether one is drawn at all.
|
|
39629
|
+
*
|
|
39630
|
+
* `material` is what reads through a mark, and a band cannot let anything
|
|
39631
|
+
* through. Each is drawn as everything under its top edge with the next one
|
|
39632
|
+
* down covering the rest, so a translucent band shows the bands behind it and
|
|
39633
|
+
* reads as a third color that is in no palette. That is `LineChart`'s recorded
|
|
39634
|
+
* reason for refusing `wash`, met here from the other side. The strength of a
|
|
39635
|
+
* fill is still adjustable and is `--area-chart-fill-strength`, which is a
|
|
39636
|
+
* continuum rather than an axis and is a theme's business rather than a
|
|
39637
|
+
* reader's.
|
|
39638
|
+
*
|
|
39236
39639
|
* ## Attributes & Properties
|
|
39237
39640
|
*
|
|
39238
39641
|
* Component attributes and properties that can be applied to the element or by using JavaScript.
|
|
@@ -39251,9 +39654,13 @@ export type CustomElementsSolidJs = {
|
|
|
39251
39654
|
* words and is already written.
|
|
39252
39655
|
* - `curve`: How a band's edge gets from one reading to the next.
|
|
39253
39656
|
*
|
|
39254
|
-
*
|
|
39255
|
-
*
|
|
39256
|
-
*
|
|
39657
|
+
* Three values, and the class doc argues for each: `straight` is absent and
|
|
39658
|
+
* is the default, `smooth` is for a stack read as a shape and is the one that
|
|
39659
|
+
* can draw a part as less than nothing, `step` is for a quantity that changes
|
|
39660
|
+
* at a moment and is ordered the way `straight` is.
|
|
39661
|
+
*
|
|
39662
|
+
* Absent rather than defaulted because a reflecting property with a default
|
|
39663
|
+
* writes its attribute onto every host, including the ones nobody configured.
|
|
39257
39664
|
* - `gridlines`: Which rules are drawn across the plot, if any.
|
|
39258
39665
|
*
|
|
39259
39666
|
* The same three values `LineChart` takes, with the same fallback: a bare
|
|
@@ -39293,6 +39700,11 @@ export type CustomElementsSolidJs = {
|
|
|
39293
39700
|
* calendar week, and declaring that against a base class whose `rows` is a
|
|
39294
39701
|
* `Row[]` getter is a type error at best. Name the member for what it holds
|
|
39295
39702
|
* rather than for the shortest word available. (property only) (readonly)
|
|
39703
|
+
* - `plottedColumns`: Which cells of a row hold numbers, by their place in it, in table order.
|
|
39704
|
+
*
|
|
39705
|
+
* The same test `readSeries` applies when it drops a column of notes: a
|
|
39706
|
+
* column is a series where any row parses, so a series survives one blank
|
|
39707
|
+
* cell and a column of words is never one. (property only) (readonly)
|
|
39296
39708
|
* - `readings`: How many readings there are, which is what the pointer maps onto. (property only) (readonly)
|
|
39297
39709
|
* - `whenSettled`: Resolves a frame after the first update, when transitions are switched on.
|
|
39298
39710
|
*
|
|
@@ -39315,6 +39727,24 @@ export type CustomElementsSolidJs = {
|
|
|
39315
39727
|
* browser harness's awaits it alone: a browser always runs the frame, and a
|
|
39316
39728
|
* timer beside it was a bet on how long one takes, which a busy run lost. (property only) (readonly)
|
|
39317
39729
|
*
|
|
39730
|
+
* ## Methods
|
|
39731
|
+
*
|
|
39732
|
+
* Methods that can be called to access component functionality.
|
|
39733
|
+
*
|
|
39734
|
+
* - `seriesOf(cell: number) => number | undefined`: The palette slot the cell at this place in a row is drawn in.
|
|
39735
|
+
*
|
|
39736
|
+
* **A cell's place in its row is not its series' depth, and the tooltip
|
|
39737
|
+
* spent a while assuming it was.** `readSeries` drops a column nothing
|
|
39738
|
+
* parses and `readRows` keeps it, so one column of notes among the figures
|
|
39739
|
+
* moves every column after it one color along in the bubble: a row reading
|
|
39740
|
+
* `Referral 1,080` wearing series three's green beside a legend that says
|
|
39741
|
+
* series three is something else, which is the one failure the dot exists
|
|
39742
|
+
* to prevent.
|
|
39743
|
+
*
|
|
39744
|
+
* Overridden where a chart reads the table some other way. `ScatterChart`
|
|
39745
|
+
* splits the first plotted column off as the measure across, so its first
|
|
39746
|
+
* *plotted* series is this table's second numeric column.
|
|
39747
|
+
*
|
|
39318
39748
|
* ## CSS Custom Properties
|
|
39319
39749
|
*
|
|
39320
39750
|
* CSS variables available for styling the component.
|
|
@@ -39324,6 +39754,7 @@ export type CustomElementsSolidJs = {
|
|
|
39324
39754
|
* - `--area-chart-gap`: Space between the drawing and its labels. (default: `undefined`)
|
|
39325
39755
|
* - `--area-chart-gridline-color`: One rule across the plot, under `gridlines`. (default: `undefined`)
|
|
39326
39756
|
* - `--area-chart-width`: Thickness of a band's top edge, over `--chart-stroke`. (default: `undefined`)
|
|
39757
|
+
* - `--chart-stroke`: Thickness of a band's top edge, one name across this family, Line Chart and Bar Chart's `lines`, since the three read one shared rule. `--area-chart-width` overrides it here. (default: `undefined`)
|
|
39327
39758
|
*
|
|
39328
39759
|
* ## CSS Parts
|
|
39329
39760
|
*
|
|
@@ -39817,6 +40248,12 @@ export type CustomElementsSolidJs = {
|
|
|
39817
40248
|
* of the series color with that edge on it, and absent is the filled column,
|
|
39818
40249
|
* per the rule that a reflected property takes no default.
|
|
39819
40250
|
*
|
|
40251
|
+
* `solid` is that filled column written out. It matches no rule in the sheet
|
|
40252
|
+
* and lands on the base one, which is what the resting value of every axis in
|
|
40253
|
+
* the registry does, and it is worth having so a consumer switching a chart
|
|
40254
|
+
* between treatments has a word for the one it started at rather than having
|
|
40255
|
+
* to remove the attribute.
|
|
40256
|
+
*
|
|
39820
40257
|
* **It composes with `material` rather than competing with it.** Emphasis
|
|
39821
40258
|
* decides what is drawn and material decides how much of it comes through, so
|
|
39822
40259
|
* `glass` thins whatever emphasis put there: the fill on a solid column, the
|
|
@@ -39870,10 +40307,15 @@ export type CustomElementsSolidJs = {
|
|
|
39870
40307
|
* having the datum rather than by painting it invisibly.
|
|
39871
40308
|
* - `outlined`: Which series are drawn as an outline rather than a fill, by name.
|
|
39872
40309
|
*
|
|
39873
|
-
*
|
|
39874
|
-
* the way `lines` and `secondary` are, so a chart says
|
|
39875
|
-
* rather than counting columns. Names because they are
|
|
39876
|
-
* carries and what the legend already shows.
|
|
40310
|
+
* Separated by whitespace or commas and matched against the column headings
|
|
40311
|
+
* the table gives, the way `lines` and `secondary` are, so a chart says
|
|
40312
|
+
* `outlined="Forecast"` rather than counting columns. Names because they are
|
|
40313
|
+
* what the table already carries and what the legend already shows.
|
|
40314
|
+
*
|
|
40315
|
+
* All five read one splitter, `seriesNames` in `core`, because the sentence
|
|
40316
|
+
* above was true of the matching and false of the splitting: these three took
|
|
40317
|
+
* a comma and those two did not, so `lines="Gateway, Billing"` drew no line
|
|
40318
|
+
* and said nothing.
|
|
39877
40319
|
*
|
|
39878
40320
|
* **The case this exists for is a series that is not a measurement.** A
|
|
39879
40321
|
* forecast, a target, a budget: something drawn on the same axis as the
|
|
@@ -39935,27 +40377,37 @@ export type CustomElementsSolidJs = {
|
|
|
39935
40377
|
* and reach no reader through the table.
|
|
39936
40378
|
* - `lines`: Which series are drawn as a line instead of as columns, by name.
|
|
39937
40379
|
*
|
|
39938
|
-
*
|
|
39939
|
-
* chart says `lines="Margin"` rather than counting
|
|
39940
|
-
* they are what the table already carries and what the
|
|
39941
|
-
* an index is a fourth place the column order is
|
|
39942
|
-
* one to go stale when somebody moves a column.
|
|
39943
|
-
*
|
|
39944
|
-
* **
|
|
39945
|
-
*
|
|
39946
|
-
* something comparable to the columns beside it.
|
|
39947
|
-
*
|
|
39948
|
-
*
|
|
39949
|
-
*
|
|
39950
|
-
*
|
|
39951
|
-
*
|
|
39952
|
-
*
|
|
39953
|
-
*
|
|
40380
|
+
* Separated by whitespace or commas and matched against the column headings
|
|
40381
|
+
* the table gives, so a chart says `lines="Margin"` rather than counting
|
|
40382
|
+
* columns. Names because they are what the table already carries and what the
|
|
40383
|
+
* legend already shows: an index is a fourth place the column order is
|
|
40384
|
+
* written down and the first one to go stale when somebody moves a column.
|
|
40385
|
+
*
|
|
40386
|
+
* **This says which mark a series takes and nothing about which scale it is
|
|
40387
|
+
* measured on.** Named here alone, a line shares the columns' domain, so it
|
|
40388
|
+
* says something comparable to the columns beside it.
|
|
40389
|
+
*
|
|
40390
|
+
* The other half of a combination chart, a count against a percentage on a
|
|
40391
|
+
* scale of its own, is `secondary`, which is a separate property because it
|
|
40392
|
+
* is a separate question and because the two compose: `with-a-second-axis`
|
|
40393
|
+
* ships naming one series in both. The argument for why a second scale is opt
|
|
40394
|
+
* in, and why setting it labels both axes, is written there.
|
|
40395
|
+
*
|
|
40396
|
+
* A line among columns measures from zero, because the columns do and they
|
|
40397
|
+
* share the axis. So does a line on the second scale, which is that scale's
|
|
40398
|
+
* own rule rather than this one's.
|
|
39954
40399
|
* - `secondary`: Which series are measured against a scale of their own, by name.
|
|
39955
40400
|
*
|
|
39956
|
-
*
|
|
39957
|
-
*
|
|
39958
|
-
*
|
|
40401
|
+
* Separated and matched the way `lines` is, against the column headings the
|
|
40402
|
+
* table gives. Opt in: absent, every series shares one domain, which is what
|
|
40403
|
+
* makes a chart comparable and is the right default.
|
|
40404
|
+
*
|
|
40405
|
+
* **The scale, and `lines` is the mark.** The two are separate properties
|
|
40406
|
+
* because they answer separate questions and a series usually wants both:
|
|
40407
|
+
* a percentage beside a count is drawn as a line *and* measured on its own
|
|
40408
|
+
* axis, which is what `with-a-second-axis` writes out. Neither implies the
|
|
40409
|
+
* other, so a series can be a line on the shared scale and a column can have
|
|
40410
|
+
* a scale to itself.
|
|
39959
40411
|
*
|
|
39960
40412
|
* **Two scales on one frame let an author put any two shapes in any relation
|
|
39961
40413
|
* by choosing the ranges, and a reader cannot see it happening.** That is not
|
|
@@ -40004,6 +40456,11 @@ export type CustomElementsSolidJs = {
|
|
|
40004
40456
|
* calendar week, and declaring that against a base class whose `rows` is a
|
|
40005
40457
|
* `Row[]` getter is a type error at best. Name the member for what it holds
|
|
40006
40458
|
* rather than for the shortest word available. (property only) (readonly)
|
|
40459
|
+
* - `plottedColumns`: Which cells of a row hold numbers, by their place in it, in table order.
|
|
40460
|
+
*
|
|
40461
|
+
* The same test `readSeries` applies when it drops a column of notes: a
|
|
40462
|
+
* column is a series where any row parses, so a series survives one blank
|
|
40463
|
+
* cell and a column of words is never one. (property only) (readonly)
|
|
40007
40464
|
* - `readings`: How many readings there are, which is what the pointer maps onto. (property only) (readonly)
|
|
40008
40465
|
* - `whenSettled`: Resolves a frame after the first update, when transitions are switched on.
|
|
40009
40466
|
*
|
|
@@ -40026,6 +40483,24 @@ export type CustomElementsSolidJs = {
|
|
|
40026
40483
|
* browser harness's awaits it alone: a browser always runs the frame, and a
|
|
40027
40484
|
* timer beside it was a bet on how long one takes, which a busy run lost. (property only) (readonly)
|
|
40028
40485
|
*
|
|
40486
|
+
* ## Methods
|
|
40487
|
+
*
|
|
40488
|
+
* Methods that can be called to access component functionality.
|
|
40489
|
+
*
|
|
40490
|
+
* - `seriesOf(cell: number) => number | undefined`: The palette slot the cell at this place in a row is drawn in.
|
|
40491
|
+
*
|
|
40492
|
+
* **A cell's place in its row is not its series' depth, and the tooltip
|
|
40493
|
+
* spent a while assuming it was.** `readSeries` drops a column nothing
|
|
40494
|
+
* parses and `readRows` keeps it, so one column of notes among the figures
|
|
40495
|
+
* moves every column after it one color along in the bubble: a row reading
|
|
40496
|
+
* `Referral 1,080` wearing series three's green beside a legend that says
|
|
40497
|
+
* series three is something else, which is the one failure the dot exists
|
|
40498
|
+
* to prevent.
|
|
40499
|
+
*
|
|
40500
|
+
* Overridden where a chart reads the table some other way. `ScatterChart`
|
|
40501
|
+
* splits the first plotted column off as the measure across, so its first
|
|
40502
|
+
* *plotted* series is this table's second numeric column.
|
|
40503
|
+
*
|
|
40029
40504
|
* ## CSS Custom Properties
|
|
40030
40505
|
*
|
|
40031
40506
|
* CSS variables available for styling the component.
|
|
@@ -40038,7 +40513,8 @@ export type CustomElementsSolidJs = {
|
|
|
40038
40513
|
* - `--bar-chart-gridline-color`: One rule across the plot, under `gridlines`. (default: `undefined`)
|
|
40039
40514
|
* - `--bar-chart-line-color`: A `lines` series, overriding its series color. (default: `undefined`)
|
|
40040
40515
|
* - `--bar-chart-line-width`: Thickness of a `lines` series, over `--chart-stroke`. (default: `undefined`)
|
|
40041
|
-
* - `--
|
|
40516
|
+
* - `--chart-stroke`: Thickness of a `lines` series, one name across this family, Line Chart and Area Chart's top edge, since the three read one shared rule. `--bar-chart-line-width` overrides it here. (default: `undefined`)
|
|
40517
|
+
* - `--bar-chart-axis`: How wide an axis column is drawn, in `ch`, from the widest number on it. Written on the axis itself, and only where the categories run along the bottom: turned sideways an axis is a row and takes a line's height instead. (default: `undefined`)
|
|
40042
40518
|
* - `--bar-chart-secondary`: The color of the secondary axis when one series owns it. It resolves a `--helix-color-series-*` token, so on the headless tier alone it names something that is not there. #138. (default: `undefined`)
|
|
40043
40519
|
* - `--chart-bar-wash`: The gradient a bar would take, named per bar so the styled tier can point `fill` at it. Drawn whatever the treatment and used only where `wash="gradient"` asks for it. (default: `undefined`)
|
|
40044
40520
|
*
|
|
@@ -44583,6 +45059,14 @@ export type CustomElementsSolidJs = {
|
|
|
44583
45059
|
* `getComputedStyle`, which is client-only: a server would draw a different
|
|
44584
45060
|
* ring than the client. A plot's proportions are markup for the same reason
|
|
44585
45061
|
* `curve` is.
|
|
45062
|
+
*
|
|
45063
|
+
* **And so it does not reflect**, which is the same argument read forward. No
|
|
45064
|
+
* selector on either tier asks about it and none can want to: everything the
|
|
45065
|
+
* thickness decides is arithmetic done here and published as
|
|
45066
|
+
* `--donut-chart-stroke`, which is a number a rule can do sums with where the
|
|
45067
|
+
* word is not. Reflected, it wrote a value onto every host a script had set
|
|
45068
|
+
* it on for nothing to read. `sweep` beside it is the converse and reflects,
|
|
45069
|
+
* because three rules select on it.
|
|
44586
45070
|
* - `sweep`: How much of the circle the whole occupies.
|
|
44587
45071
|
*
|
|
44588
45072
|
* Absent is the full turn. `half` is a semi-donut: the same shares spread
|
|
@@ -44632,6 +45116,11 @@ export type CustomElementsSolidJs = {
|
|
|
44632
45116
|
* calendar week, and declaring that against a base class whose `rows` is a
|
|
44633
45117
|
* `Row[]` getter is a type error at best. Name the member for what it holds
|
|
44634
45118
|
* rather than for the shortest word available. (property only) (readonly)
|
|
45119
|
+
* - `plottedColumns`: Which cells of a row hold numbers, by their place in it, in table order.
|
|
45120
|
+
*
|
|
45121
|
+
* The same test `readSeries` applies when it drops a column of notes: a
|
|
45122
|
+
* column is a series where any row parses, so a series survives one blank
|
|
45123
|
+
* cell and a column of words is never one. (property only) (readonly)
|
|
44635
45124
|
* - `readings`: How many readings there are, which is what the pointer maps onto. (property only) (readonly)
|
|
44636
45125
|
* - `whenSettled`: Resolves a frame after the first update, when transitions are switched on.
|
|
44637
45126
|
*
|
|
@@ -44660,6 +45149,24 @@ export type CustomElementsSolidJs = {
|
|
|
44660
45149
|
*
|
|
44661
45150
|
* - `(default)`: Goes in the middle of the ring. A total, usually.
|
|
44662
45151
|
*
|
|
45152
|
+
* ## Methods
|
|
45153
|
+
*
|
|
45154
|
+
* Methods that can be called to access component functionality.
|
|
45155
|
+
*
|
|
45156
|
+
* - `seriesOf(cell: number) => number | undefined`: The palette slot the cell at this place in a row is drawn in.
|
|
45157
|
+
*
|
|
45158
|
+
* **A cell's place in its row is not its series' depth, and the tooltip
|
|
45159
|
+
* spent a while assuming it was.** `readSeries` drops a column nothing
|
|
45160
|
+
* parses and `readRows` keeps it, so one column of notes among the figures
|
|
45161
|
+
* moves every column after it one color along in the bubble: a row reading
|
|
45162
|
+
* `Referral 1,080` wearing series three's green beside a legend that says
|
|
45163
|
+
* series three is something else, which is the one failure the dot exists
|
|
45164
|
+
* to prevent.
|
|
45165
|
+
*
|
|
45166
|
+
* Overridden where a chart reads the table some other way. `ScatterChart`
|
|
45167
|
+
* splits the first plotted column off as the measure across, so its first
|
|
45168
|
+
* *plotted* series is this table's second numeric column.
|
|
45169
|
+
*
|
|
44663
45170
|
* ## CSS Custom Properties
|
|
44664
45171
|
*
|
|
44665
45172
|
* CSS variables available for styling the component.
|
|
@@ -46337,6 +46844,11 @@ export type CustomElementsSolidJs = {
|
|
|
46337
46844
|
* calendar week, and declaring that against a base class whose `rows` is a
|
|
46338
46845
|
* `Row[]` getter is a type error at best. Name the member for what it holds
|
|
46339
46846
|
* rather than for the shortest word available. (property only) (readonly)
|
|
46847
|
+
* - `plottedColumns`: Which cells of a row hold numbers, by their place in it, in table order.
|
|
46848
|
+
*
|
|
46849
|
+
* The same test `readSeries` applies when it drops a column of notes: a
|
|
46850
|
+
* column is a series where any row parses, so a series survives one blank
|
|
46851
|
+
* cell and a column of words is never one. (property only) (readonly)
|
|
46340
46852
|
* - `readings`: How many readings there are, which is what the pointer maps onto. (property only) (readonly)
|
|
46341
46853
|
* - `visible`: How many cells are actually drawn.
|
|
46342
46854
|
*
|
|
@@ -46387,6 +46899,24 @@ export type CustomElementsSolidJs = {
|
|
|
46387
46899
|
* - `start`: Below the strip, at the leading edge.
|
|
46388
46900
|
* - `summary`: Below the strip, in the middle.
|
|
46389
46901
|
*
|
|
46902
|
+
* ## Methods
|
|
46903
|
+
*
|
|
46904
|
+
* Methods that can be called to access component functionality.
|
|
46905
|
+
*
|
|
46906
|
+
* - `seriesOf(cell: number) => number | undefined`: The palette slot the cell at this place in a row is drawn in.
|
|
46907
|
+
*
|
|
46908
|
+
* **A cell's place in its row is not its series' depth, and the tooltip
|
|
46909
|
+
* spent a while assuming it was.** `readSeries` drops a column nothing
|
|
46910
|
+
* parses and `readRows` keeps it, so one column of notes among the figures
|
|
46911
|
+
* moves every column after it one color along in the bubble: a row reading
|
|
46912
|
+
* `Referral 1,080` wearing series three's green beside a legend that says
|
|
46913
|
+
* series three is something else, which is the one failure the dot exists
|
|
46914
|
+
* to prevent.
|
|
46915
|
+
*
|
|
46916
|
+
* Overridden where a chart reads the table some other way. `ScatterChart`
|
|
46917
|
+
* splits the first plotted column off as the measure across, so its first
|
|
46918
|
+
* *plotted* series is this table's second numeric column.
|
|
46919
|
+
*
|
|
46390
46920
|
* ## CSS Custom Properties
|
|
46391
46921
|
*
|
|
46392
46922
|
* CSS variables available for styling the component.
|
|
@@ -47327,6 +47857,19 @@ export type CustomElementsSolidJs = {
|
|
|
47327
47857
|
*
|
|
47328
47858
|
* Absent is `series`, one entry per data column. `categories` reads one entry
|
|
47329
47859
|
* per body row instead, for a donut, whose slices are the rows.
|
|
47860
|
+
*
|
|
47861
|
+
* **`measures` is `series` without the first column, and it is for a
|
|
47862
|
+
* scatter.** That chart reads its first numeric column as the measure
|
|
47863
|
+
* *across*, so its first plotted series is the table's second and everything
|
|
47864
|
+
* a legend beside it named was one color out: the across column wearing the
|
|
47865
|
+
* color of the first series drawn, and each real series wearing the next
|
|
47866
|
+
* one's. The across gets no entry rather than a shifted one, because it is an
|
|
47867
|
+
* axis and a scatter already writes its name at the end of the scale under
|
|
47868
|
+
* the plot.
|
|
47869
|
+
*
|
|
47870
|
+
* A legend cannot ask the chart which of these it is, `for` naming the table
|
|
47871
|
+
* they share and not each other, so the consumer says it. That is the same
|
|
47872
|
+
* shape `categories` already has.
|
|
47330
47873
|
* - `for`: The id of the table to take the names from.
|
|
47331
47874
|
*
|
|
47332
47875
|
* Resolved through `getRootNode()`, so a legend inside another component's
|
|
@@ -47395,9 +47938,15 @@ export type CustomElementsSolidJs = {
|
|
|
47395
47938
|
* lets one drawing fill a narrow card and a wide panel, and without
|
|
47396
47939
|
* `vector-effect: non-scaling-stroke` the same line comes out hairline in the
|
|
47397
47940
|
* first and heavy in the second. It rescues strokes and not geometry, which is
|
|
47398
|
-
* why
|
|
47399
|
-
*
|
|
47400
|
-
*
|
|
47941
|
+
* why nothing inside the drawing marks a reading: a circle in a stretched
|
|
47942
|
+
* coordinate space is an ellipse, and there is no vector-effect that answers
|
|
47943
|
+
* for a shape.
|
|
47944
|
+
*
|
|
47945
|
+
* **The last reading of each series is marked, and that is the same rule rather
|
|
47946
|
+
* than an exception to it.** `terminus` draws an HTML element placed over the
|
|
47947
|
+
* plot by percentage instead of a shape inside it, so it keeps its shape at any
|
|
47948
|
+
* width. It is on by default, as a dot, because the column of marks at the far
|
|
47949
|
+
* edge is where a reader looks for "and what is it now".
|
|
47401
47950
|
*
|
|
47402
47951
|
* ## Attributes & Properties
|
|
47403
47952
|
*
|
|
@@ -47510,9 +48059,20 @@ export type CustomElementsSolidJs = {
|
|
|
47510
48059
|
* the question a sparkline's single mark answers too.
|
|
47511
48060
|
*
|
|
47512
48061
|
* `none` lets the lines stop on their own, which suits a chart read for its
|
|
47513
|
-
* shape rather than for where it finished.
|
|
48062
|
+
* shape rather than for where it finished. `square` is the same mark with its
|
|
48063
|
+
* corners, for a drawing whose neighbors are square, the columns of a table
|
|
48064
|
+
* beside it for instance. `ring` lets the ground through, for a chart drawn
|
|
48065
|
+
* over something busy. `triangle` points along the axis and reads as "and
|
|
48066
|
+
* onward" rather than as a second claim about the data.
|
|
48067
|
+
*
|
|
48068
|
+
* The shapes come from
|
|
47514
48069
|
* `helix/styled/src/shared/chart/terminus.css`, the same sheet `Sparkline` takes, so
|
|
47515
|
-
* the set is identical wherever one appears.
|
|
48070
|
+
* the set is identical wherever one appears. **Which is why every value is
|
|
48071
|
+
* named here.** `Sparkline` shipped `square` implemented, drawn, asserted and
|
|
48072
|
+
* undocumented until the cohort before this one; this family reads the same
|
|
48073
|
+
* four out of the same sheet and had left two of them unwritten, so the
|
|
48074
|
+
* finding arrived twice. A shared vocabulary wants naming at each door into
|
|
48075
|
+
* it, because a reader arrives at one door and not at the set.
|
|
47516
48076
|
*
|
|
47517
48077
|
* `ring` is the one that asks something of the drawing. It leaves a hole and a
|
|
47518
48078
|
* line ends at the reading, which is the hole's center, so the `<svg>` is
|
|
@@ -47553,6 +48113,11 @@ export type CustomElementsSolidJs = {
|
|
|
47553
48113
|
* calendar week, and declaring that against a base class whose `rows` is a
|
|
47554
48114
|
* `Row[]` getter is a type error at best. Name the member for what it holds
|
|
47555
48115
|
* rather than for the shortest word available. (property only) (readonly)
|
|
48116
|
+
* - `plottedColumns`: Which cells of a row hold numbers, by their place in it, in table order.
|
|
48117
|
+
*
|
|
48118
|
+
* The same test `readSeries` applies when it drops a column of notes: a
|
|
48119
|
+
* column is a series where any row parses, so a series survives one blank
|
|
48120
|
+
* cell and a column of words is never one. (property only) (readonly)
|
|
47556
48121
|
* - `readings`: How many readings there are, which is what the pointer maps onto. (property only) (readonly)
|
|
47557
48122
|
* - `whenSettled`: Resolves a frame after the first update, when transitions are switched on.
|
|
47558
48123
|
*
|
|
@@ -47575,17 +48140,39 @@ export type CustomElementsSolidJs = {
|
|
|
47575
48140
|
* browser harness's awaits it alone: a browser always runs the frame, and a
|
|
47576
48141
|
* timer beside it was a bet on how long one takes, which a busy run lost. (property only) (readonly)
|
|
47577
48142
|
*
|
|
48143
|
+
* ## Methods
|
|
48144
|
+
*
|
|
48145
|
+
* Methods that can be called to access component functionality.
|
|
48146
|
+
*
|
|
48147
|
+
* - `seriesOf(cell: number) => number | undefined`: The palette slot the cell at this place in a row is drawn in.
|
|
48148
|
+
*
|
|
48149
|
+
* **A cell's place in its row is not its series' depth, and the tooltip
|
|
48150
|
+
* spent a while assuming it was.** `readSeries` drops a column nothing
|
|
48151
|
+
* parses and `readRows` keeps it, so one column of notes among the figures
|
|
48152
|
+
* moves every column after it one color along in the bubble: a row reading
|
|
48153
|
+
* `Referral 1,080` wearing series three's green beside a legend that says
|
|
48154
|
+
* series three is something else, which is the one failure the dot exists
|
|
48155
|
+
* to prevent.
|
|
48156
|
+
*
|
|
48157
|
+
* Overridden where a chart reads the table some other way. `ScatterChart`
|
|
48158
|
+
* splits the first plotted column off as the measure across, so its first
|
|
48159
|
+
* *plotted* series is this table's second numeric column.
|
|
48160
|
+
*
|
|
47578
48161
|
* ## CSS Custom Properties
|
|
47579
48162
|
*
|
|
47580
48163
|
* CSS variables available for styling the component.
|
|
47581
48164
|
*
|
|
47582
|
-
* - `--chart-stroke`: Thickness of a series drawn as a line,
|
|
48165
|
+
* - `--chart-stroke`: Thickness of a series drawn as a line, one name across this family, Area Chart's top edge and Bar Chart's `lines`, since the three read one shared rule. Each family's own width hook overrides it. (default: `undefined`)
|
|
48166
|
+
* - `--chart-terminus-hole`: A fill for the middle of a `ring` terminus, which is otherwise open. One name across this family and Sparkline, the two reading one shared sheet. (default: `undefined`)
|
|
48167
|
+
* - `--chart-terminus-size`: Size of the mark on each series' last reading. One name across this family and Sparkline, the two reading one shared sheet. (default: `undefined`)
|
|
47583
48168
|
* - `--line-chart-area-opacity`: How much of a line's color its wash takes. (default: `undefined`)
|
|
47584
48169
|
* - `--line-chart-band-color`: The slot the pointer is resting in. (default: `undefined`)
|
|
47585
48170
|
* - `--line-chart-block-size`: Height of the drawing. (default: `undefined`)
|
|
47586
48171
|
* - `--line-chart-gap`: Space between the drawing and its labels. (default: `undefined`)
|
|
47587
48172
|
* - `--line-chart-gridline-color`: One rule across the plot, under `gridlines`. (default: `undefined`)
|
|
47588
48173
|
* - `--line-chart-width`: Thickness of a line, over `--chart-stroke`. (default: `undefined`)
|
|
48174
|
+
* - `--chart-terminus-x`: Where a series' last reading sits horizontally, as a percentage. Written by the component. (default: `undefined`)
|
|
48175
|
+
* - `--chart-terminus-y`: Where a series' last reading sits vertically, as a percentage. Written by the component. (default: `undefined`)
|
|
47589
48176
|
*
|
|
47590
48177
|
* ## CSS Parts
|
|
47591
48178
|
*
|
|
@@ -48302,9 +48889,12 @@ export type CustomElementsSolidJs = {
|
|
|
48302
48889
|
>;
|
|
48303
48890
|
|
|
48304
48891
|
/**
|
|
48305
|
-
*
|
|
48306
|
-
* the
|
|
48307
|
-
*
|
|
48892
|
+
* A row draws a column beside its label only where it has something to put in
|
|
48893
|
+
* one, and the width is the menu's rather than the row's: the page reserves a
|
|
48894
|
+
* leading or a trailing track as soon as any row on it fills one, so every
|
|
48895
|
+
* label on that page starts at the same edge and a page that fills neither pays
|
|
48896
|
+
* for neither. A row knows about its own slots and nothing about its
|
|
48897
|
+
* neighbors, which is why the reservation is not made here.
|
|
48308
48898
|
*
|
|
48309
48899
|
* ## Attributes & Properties
|
|
48310
48900
|
*
|
|
@@ -52177,6 +52767,30 @@ export type CustomElementsSolidJs = {
|
|
|
52177
52767
|
* dense cluster reads as dense rather than as one blot, and two points that
|
|
52178
52768
|
* overlap each keep their edge.
|
|
52179
52769
|
*
|
|
52770
|
+
* **No visual axis applies here, and that is the answer rather than a gap.**
|
|
52771
|
+
* Both refusals come out of that sentence, and both were argued in the
|
|
52772
|
+
* stylesheet before they were argued anywhere a reader looks.
|
|
52773
|
+
*
|
|
52774
|
+
* `emphasis` is how much ink a mark claims, and on a scatter that channel is
|
|
52775
|
+
* already carrying data. The points rest at 0.8 so that where they pile up they
|
|
52776
|
+
* compound: how dark a region is *is* how many rows are in it, which is most of
|
|
52777
|
+
* what a reader is looking at a scatter to see and is the one thing a table of
|
|
52778
|
+
* the same numbers hides. `solid` flattens a dense cluster and a sparse one into
|
|
52779
|
+
* the same picture; `outlined` replaces the pile with overlapping rings, which
|
|
52780
|
+
* reads as texture rather than as count. An axis whose two ends each cost the
|
|
52781
|
+
* drawing its density is not a treatment, it is a second meaning for a property
|
|
52782
|
+
* the chart already spends.
|
|
52783
|
+
*
|
|
52784
|
+
* `material` is the same refusal said once more. Translucency is the density
|
|
52785
|
+
* channel here, so `glass` and `frosted` are two more named stops on a scale
|
|
52786
|
+
* the data is using, and a point admitting the page through is a point that
|
|
52787
|
+
* counts for less than one.
|
|
52788
|
+
*
|
|
52789
|
+
* What stays adjustable is `--scatter-chart-point-opacity`, and it is a
|
|
52790
|
+
* continuum rather than an axis: a chart drawn over a busier ground wants a
|
|
52791
|
+
* different resting density, and that is a fact about the ground rather than a
|
|
52792
|
+
* claim about the points.
|
|
52793
|
+
*
|
|
52180
52794
|
* ## Attributes & Properties
|
|
52181
52795
|
*
|
|
52182
52796
|
* Component attributes and properties that can be applied to the element or by using JavaScript.
|
|
@@ -52229,6 +52843,11 @@ export type CustomElementsSolidJs = {
|
|
|
52229
52843
|
* calendar week, and declaring that against a base class whose `rows` is a
|
|
52230
52844
|
* `Row[]` getter is a type error at best. Name the member for what it holds
|
|
52231
52845
|
* rather than for the shortest word available. (property only) (readonly)
|
|
52846
|
+
* - `plottedColumns`: Which cells of a row hold numbers, by their place in it, in table order.
|
|
52847
|
+
*
|
|
52848
|
+
* The same test `readSeries` applies when it drops a column of notes: a
|
|
52849
|
+
* column is a series where any row parses, so a series survives one blank
|
|
52850
|
+
* cell and a column of words is never one. (property only) (readonly)
|
|
52232
52851
|
* - `readings`: How many readings there are, which is what the pointer maps onto. (property only) (readonly)
|
|
52233
52852
|
* - `whenSettled`: Resolves a frame after the first update, when transitions are switched on.
|
|
52234
52853
|
*
|
|
@@ -52251,6 +52870,24 @@ export type CustomElementsSolidJs = {
|
|
|
52251
52870
|
* browser harness's awaits it alone: a browser always runs the frame, and a
|
|
52252
52871
|
* timer beside it was a bet on how long one takes, which a busy run lost. (property only) (readonly)
|
|
52253
52872
|
*
|
|
52873
|
+
* ## Methods
|
|
52874
|
+
*
|
|
52875
|
+
* Methods that can be called to access component functionality.
|
|
52876
|
+
*
|
|
52877
|
+
* - `seriesOf(cell: number) => number | undefined`: The palette slot the cell at this place in a row is drawn in.
|
|
52878
|
+
*
|
|
52879
|
+
* **A cell's place in its row is not its series' depth, and the tooltip
|
|
52880
|
+
* spent a while assuming it was.** `readSeries` drops a column nothing
|
|
52881
|
+
* parses and `readRows` keeps it, so one column of notes among the figures
|
|
52882
|
+
* moves every column after it one color along in the bubble: a row reading
|
|
52883
|
+
* `Referral 1,080` wearing series three's green beside a legend that says
|
|
52884
|
+
* series three is something else, which is the one failure the dot exists
|
|
52885
|
+
* to prevent.
|
|
52886
|
+
*
|
|
52887
|
+
* Overridden where a chart reads the table some other way. `ScatterChart`
|
|
52888
|
+
* splits the first plotted column off as the measure across, so its first
|
|
52889
|
+
* *plotted* series is this table's second numeric column.
|
|
52890
|
+
*
|
|
52254
52891
|
* ## CSS Custom Properties
|
|
52255
52892
|
*
|
|
52256
52893
|
* CSS variables available for styling the component.
|
|
@@ -53933,7 +54570,7 @@ export type CustomElementsSolidJs = {
|
|
|
53933
54570
|
* Areas where markup can be added to the component.
|
|
53934
54571
|
*
|
|
53935
54572
|
* - `(default)`: The step's name.
|
|
53936
|
-
* - `content`: What the stage holds,
|
|
54573
|
+
* - `content`: What the stage holds. Always rendered here, a tier with no stylesheet having nothing to fold it with; the styled tier opens it on the current step down a column, and a row has no space under a step to open it into.
|
|
53937
54574
|
* - `description`: A line under the name, for what the stage is for.
|
|
53938
54575
|
* - `marker`: Replaces the number, or the check a complete step shows.
|
|
53939
54576
|
*
|
|
@@ -54597,9 +55234,16 @@ export type CustomElementsSolidJs = {
|
|
|
54597
55234
|
>;
|
|
54598
55235
|
|
|
54599
55236
|
/**
|
|
54600
|
-
*
|
|
54601
|
-
*
|
|
54602
|
-
* a
|
|
55237
|
+
* One mark travels between the tabs rather than each of them filling and
|
|
55238
|
+
* emptying in turn. A fill that swaps is two things changing at once and reads
|
|
55239
|
+
* as a flicker; one that moves is a single object the eye follows, and it says
|
|
55240
|
+
* where the current tab was as well as where it is. `Navigation` marks its
|
|
55241
|
+
* destinations the same way and for the same reason.
|
|
55242
|
+
*
|
|
55243
|
+
* What the mark is depends on `variant`: unset it is a raised pill on the
|
|
55244
|
+
* selected tab with nothing behind the row, `underlined` makes it a bar along
|
|
55245
|
+
* the bottom of the strip on a rule, and `segmented` grows it to the tab's own
|
|
55246
|
+
* box inside a sunken track.
|
|
54603
55247
|
*
|
|
54604
55248
|
* ## Attributes & Properties
|
|
54605
55249
|
*
|
|
@@ -54669,8 +55313,8 @@ export type CustomElementsSolidJs = {
|
|
|
54669
55313
|
*
|
|
54670
55314
|
* Areas where markup can be added to the component.
|
|
54671
55315
|
*
|
|
54672
|
-
* - `(default)`: The tabs.
|
|
54673
|
-
* - `panels`: The panels.
|
|
55316
|
+
* - `(default)`: The tabs, which are this element's own children.
|
|
55317
|
+
* - `panels`: The panels, which are this element's own children. A wrapper around them is assigned to the slot and pairs with nothing, since the pairing walks these children rather than the slot's tree.
|
|
54674
55318
|
*
|
|
54675
55319
|
* ## Methods
|
|
54676
55320
|
*
|
|
@@ -58029,6 +58673,8 @@ export type CustomCssProperties = {
|
|
|
58029
58673
|
"--area-chart-gridline-color"?: (string) | undefined;
|
|
58030
58674
|
/** Thickness of a band's top edge, over `--chart-stroke`. */
|
|
58031
58675
|
"--area-chart-width"?: (string) | undefined;
|
|
58676
|
+
/** Thickness of a band's top edge, one name across this family, Line Chart and Bar Chart's `lines`, since the three read one shared rule. `--area-chart-width` overrides it here. */
|
|
58677
|
+
"--chart-stroke"?: (string) | undefined;
|
|
58032
58678
|
/** How far each avatar sits over the one before it. */
|
|
58033
58679
|
"--avatar-group-overlap"?: (string) | undefined;
|
|
58034
58680
|
/** The separation drawn between one avatar and the next. */
|
|
@@ -58059,7 +58705,7 @@ export type CustomCssProperties = {
|
|
|
58059
58705
|
"--bar-chart-line-color"?: (string) | undefined;
|
|
58060
58706
|
/** Thickness of a `lines` series, over `--chart-stroke`. */
|
|
58061
58707
|
"--bar-chart-line-width"?: (string) | undefined;
|
|
58062
|
-
/**
|
|
58708
|
+
/** How wide an axis column is drawn, in `ch`, from the widest number on it. Written on the axis itself, and only where the categories run along the bottom: turned sideways an axis is a row and takes a line's height instead. */
|
|
58063
58709
|
"--bar-chart-axis"?: (string) | undefined;
|
|
58064
58710
|
/** The color of the secondary axis when one series owns it. It resolves a `--helix-color-series-*` token, so on the headless tier alone it names something that is not there. #138. */
|
|
58065
58711
|
"--bar-chart-secondary"?: (string) | undefined;
|
|
@@ -58471,8 +59117,10 @@ export type CustomCssProperties = {
|
|
|
58471
59117
|
"--legend-swatch-size"?: (string) | undefined;
|
|
58472
59118
|
/** Width of the edge an `outlined` or `subtle` swatch is drawn with. */
|
|
58473
59119
|
"--legend-swatch-stroke"?: (string) | undefined;
|
|
58474
|
-
/**
|
|
58475
|
-
"--chart-
|
|
59120
|
+
/** A fill for the middle of a `ring` terminus, which is otherwise open. One name across this family and Sparkline, the two reading one shared sheet. */
|
|
59121
|
+
"--chart-terminus-hole"?: (string) | undefined;
|
|
59122
|
+
/** Size of the mark on each series' last reading. One name across this family and Sparkline, the two reading one shared sheet. */
|
|
59123
|
+
"--chart-terminus-size"?: (string) | undefined;
|
|
58476
59124
|
/** How much of a line's color its wash takes. */
|
|
58477
59125
|
"--line-chart-area-opacity"?: (string) | undefined;
|
|
58478
59126
|
/** The slot the pointer is resting in. */
|
|
@@ -58485,6 +59133,10 @@ export type CustomCssProperties = {
|
|
|
58485
59133
|
"--line-chart-gridline-color"?: (string) | undefined;
|
|
58486
59134
|
/** Thickness of a line, over `--chart-stroke`. */
|
|
58487
59135
|
"--line-chart-width"?: (string) | undefined;
|
|
59136
|
+
/** Where a series' last reading sits horizontally, as a percentage. Written by the component. */
|
|
59137
|
+
"--chart-terminus-x"?: (string) | undefined;
|
|
59138
|
+
/** Where a series' last reading sits vertically, as a percentage. Written by the component. */
|
|
59139
|
+
"--chart-terminus-y"?: (string) | undefined;
|
|
58488
59140
|
/** Padding inside the row. */
|
|
58489
59141
|
"--list-item-padding"?: (string) | undefined;
|
|
58490
59142
|
/** What the rail cell shows. Written by the list. */
|
|
@@ -58817,10 +59469,6 @@ export type CustomCssProperties = {
|
|
|
58817
59469
|
"--slider-marker-at"?: (string) | undefined;
|
|
58818
59470
|
/** Where the filled span ends, as a percentage of the track. */
|
|
58819
59471
|
"--slider-to"?: (string) | undefined;
|
|
58820
|
-
/** A fill for the middle of a `ring` terminus, which is otherwise open. */
|
|
58821
|
-
"--chart-terminus-hole"?: (string) | undefined;
|
|
58822
|
-
/** Size of the mark on the last reading. */
|
|
58823
|
-
"--chart-terminus-size"?: (string) | undefined;
|
|
58824
59472
|
/** How much of the line's color the wash takes where it meets the line. */
|
|
58825
59473
|
"--sparkline-area-opacity"?: (string) | undefined;
|
|
58826
59474
|
/** Corner radius on a column, under `plot="bar"`. */
|
|
@@ -58835,10 +59483,6 @@ export type CustomCssProperties = {
|
|
|
58835
59483
|
"--sparkline-inline-size"?: (string) | undefined;
|
|
58836
59484
|
/** Thickness of the line, overriding `weight`. */
|
|
58837
59485
|
"--sparkline-width"?: (string) | undefined;
|
|
58838
|
-
/** Where the last point sits horizontally, as a percentage. */
|
|
58839
|
-
"--chart-terminus-x"?: (string) | undefined;
|
|
58840
|
-
/** Where the last point sits vertically, as a percentage. */
|
|
58841
|
-
"--chart-terminus-y"?: (string) | undefined;
|
|
58842
59486
|
/** Edge length of the mark. */
|
|
58843
59487
|
"--speed-dial-item-size"?: (string) | undefined;
|
|
58844
59488
|
/** Space between the actions. */
|