You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
refactor(manifests): attributes read in a consistent order
The order attributes are written in is the order of the table on a
component's page and, since yesterday, of the controls under its demo. It
was whatever each manifest's author happened to type: eight components
led with a boolean or buried data-variant behind a detail.
They now read what the thing is, then how strongly it presents, then how
big, then the rest of its configuration in the order it was written, then
the on/off flags. Ten manifests moved; the other twenty-three with more
than one attribute already agreed.
Two by hand rather than by the rule. The card's ratio does nothing until
the card is below its threshold, so the threshold comes first. grid and
masonry ordered the same pair opposite ways, so grid now matches it with
the two column attributes together.
Nothing about the attributes themselves changed, only their order, so the
regenerated pages differ only in the order of their rows.
|`data-ratio`| enum |`1/1`, `4/3`, `3/2`, `16/9`, `21/9`|`16/9`|The figure's aspect ratio when the card is wide. |
75
+
|`data-variant`| enum |`primary`, `secondary`, `success`, `warning`, `alert`, `neutral`|| Tints the border and adds a bar along the top; the body stays plain. |
76
76
|`data-threshold`| enum |`2xs`, `xs`, `sm`, `md`, `lg`, `xl`, `2xl`|`md`| The card's own width from which the picture sits beside the text instead of on top. |
77
+
|`data-ratio`| enum |`1/1`, `4/3`, `3/2`, `16/9`, `21/9`|`16/9`| The figure's aspect ratio when the card is wide. |
77
78
|`data-raised`| boolean ||| A shadow instead of a border. |
78
-
|`data-variant`| enum |`primary`, `secondary`, `success`, `warning`, `alert`, `neutral`|| Tints the border and adds a bar along the top; the body stays plain. |
|`data-min`| enum |`none`, `2xs`, `xs`, `sm`, `md`, `lg`, `xl`, `2xl`|`xs`| The narrowest a column may be. With none, only data-columns decides the count; none is meant to be paired with data-columns, and alone gives a single full-width column. |
|`data-columns`| enum |`1`, `2`, `3`, `4`, `5`, `6`|| The most columns allowed. Fewer appear when the container cannot fit that many at data-min; with data-min="none" the count is exact. With data-fold, the count only ever halves. |
78
-
|`data-fold`|boolean||| Halve the column count as the grid narrows instead of stepping down one at a time. Needs data-columns 2, 4, or 6 and uses data-min as the width per column. data-min="none" has no meaning with a fold: the count needs a width per column. |
|`data-ranks`| enum |`2`, `3`, `4`, `5`, `6`|| Line up the parts of the children across each row: the value is how many parts a child has, and each part takes one row. |
79
+
|`data-fold`| boolean ||| Halve the column count as the grid narrows instead of stepping down one at a time. Needs data-columns 2, 4, or 6 and uses data-min as the width per column. data-min="none" has no meaning with a fold: the count needs a width per column. |
Copy file name to clipboardExpand all lines: docs/llms-full.txt
+13-13Lines changed: 13 additions & 13 deletions
Original file line number
Diff line number
Diff line change
@@ -315,10 +315,10 @@ Fits as many equal columns as the container allows at a minimum width, up to an
315
315
316
316
Attributes:
317
317
- data-min: none | 2xs | xs (default) | sm | md | lg | xl | 2xl — The narrowest a column may be. With none, only data-columns decides the count; none is meant to be paired with data-columns, and alone gives a single full-width column.
- data-columns: 1 | 2 | 3 | 4 | 5 | 6 — The most columns allowed. Fewer appear when the container cannot fit that many at data-min; with data-min="none" the count is exact. With data-fold, the count only ever halves.
320
-
- data-fold (boolean) — Halve the column count as the grid narrows instead of stepping down one at a time. Needs data-columns 2, 4, or 6 and uses data-min as the width per column. data-min="none" has no meaning with a fold: the count needs a width per column.
- data-ranks: 2 | 3 | 4 | 5 | 6 — Line up the parts of the children across each row: the value is how many parts a child has, and each part takes one row.
321
+
- data-fold (boolean) — Halve the column count as the grid narrows instead of stepping down one at a time. Needs data-columns 2, 4, or 6 and uses data-min as the width per column. data-min="none" has no meaning with a fold: the count needs a width per column.
322
322
323
323
### When to use it
324
324
@@ -474,8 +474,8 @@ In browsers without native masonry, items read down each column and then across.
474
474
Holds one child over the rest, centered, without pushing anything around; the parent is the box it covers.
475
475
476
476
Attributes:
477
-
- data-fixed (boolean) — Center the held child over the viewport instead of this box, and keep it there while the page scrolls.
478
477
- data-gap: none | xs | sm | md (default) | lg | xl | 2xl | 3xl | xs-sm | xs-md | xs-lg | xs-xl | xs-2xl | xs-3xl | sm-md | sm-lg | sm-xl | sm-2xl | sm-3xl | md-lg | md-xl | md-2xl | md-3xl | lg-xl | lg-2xl | lg-3xl | xl-2xl | xl-3xl | 2xl-3xl — The least space kept between the held child and the edges of the box.
478
+
- data-fixed (boolean) — Center the held child over the viewport instead of this box, and keep it there while the page scrolls.
479
479
480
480
On children:
481
481
- data-over on > * (boolean) — Lifts the child out of the flow and centers it over the box; exactly one child carries it.
@@ -516,8 +516,8 @@ Lays its children out in a single row that scrolls horizontally.
- data-attach (boolean) — Fuse the buttons into one segmented control that shares borders.
1151
1151
1152
1152
### When to use it
1153
1153
@@ -1184,10 +1184,10 @@ role="group" with a name, so the set is announced as one thing. A segmented togg
1184
1184
A bordered surface for one thing: an optional figure that bleeds to the edges, a body, and a footer that sits at the bottom; a row with the picture beside the text once the card's content reaches the md width.
1185
1185
1186
1186
Attributes:
1187
-
- data-ratio: 1/1 | 4/3 | 3/2 | 16/9 (default) | 21/9 — The figure's aspect ratio when the card is wide.
1187
+
- data-variant: primary | secondary | success | warning | alert | neutral — Tints the border and adds a bar along the top; the body stays plain.
1188
1188
- data-threshold: 2xs | xs | sm | md (default) | lg | xl | 2xl — The card's own width from which the picture sits beside the text instead of on top.
1189
+
- data-ratio: 1/1 | 4/3 | 3/2 | 16/9 (default) | 21/9 — The figure's aspect ratio when the card is wide.
1189
1190
- data-raised (boolean) — A shadow instead of a border.
1190
-
- data-variant: primary | secondary | success | warning | alert | neutral — Tints the border and adds a bar along the top; the body stays plain.
1191
1191
1192
1192
On children:
1193
1193
- data-stretch on a (boolean) — Stretches the link over the whole card, so the card is clickable while the link keeps its own name.
@@ -1556,9 +1556,9 @@ With data-trigger="hover" the module adds opening under the pointer and changes
1556
1556
One form control with its label, an optional hint, and an error that shows itself when the control is invalid.
1557
1557
1558
1558
Attributes:
1559
+
- data-variant: primary (default) | secondary | success | warning | alert | neutral — The colour of a checked checkbox or radio.
1559
1560
- data-size: sm | md (default) | lg — Scales the control's height and text.
1560
1561
- data-inline (boolean) — Put the label beside the control. Checkboxes and radios are inline without it.
1561
-
- data-variant: primary (default) | secondary | success | warning | alert | neutral — The colour of a checked checkbox or radio.
1562
1562
1563
1563
On children:
1564
1564
- data-hint on > * (boolean) — Help text, referenced by the control's aria-describedby.
@@ -1646,9 +1646,9 @@ The label's for must match the control's id; the validator checks it. Reference
1646
1646
A bar with a brand, a list of links, and actions, that collapses the links behind a toggle at its own width and opens them as a sheet, a drawer, or a screen.
1647
1647
1648
1648
Attributes:
1649
+
- data-variant: primary (default) | secondary | success | warning | alert | neutral — The hue of the current link and of the hover tint.
1649
1650
- data-threshold: 2xs | xs | sm | md (default) | lg | xl | 2xl — The nav's own width at or above which the links sit in the bar; below it they are behind the toggle.
1650
1651
- data-panel: sheet (default) | drawer | screen — The shape of the open list below the threshold: a sheet under the bar, a drawer from the start edge, or the whole screen.
1651
-
- data-variant: primary (default) | secondary | success | warning | alert | neutral — The hue of the current link and of the hover tint.
1652
1652
- data-gap: none | xs | sm (default) | md | lg | xl | 2xl | 3xl | xs-sm | xs-md | xs-lg | xs-xl | xs-2xl | xs-3xl | sm-md | sm-lg | sm-xl | sm-2xl | sm-3xl | md-lg | md-xl | md-2xl | md-3xl | lg-xl | lg-2xl | lg-3xl | xl-2xl | xl-3xl | 2xl-3xl — Space between the bar's parts and between the links.
1653
1653
1654
1654
On children:
@@ -1734,10 +1734,10 @@ Give the nav an aria-label, since a page often has more than one. The toggle nee
1734
1734
Links to the pages of a long list, each a square target, the current one filled, shrinking to Previous, the current page, and Next when it is narrow.
1735
1735
1736
1736
Attributes:
1737
-
- data-threshold: 2xs | xs | sm (default) | md | lg | xl | 2xl — The pagination's own width below which only Previous, the current page, and Next remain.
1738
1737
- data-variant: primary (default) | secondary | success | warning | alert | neutral — The hue of the current page and of the hover tint.
1739
-
- data-justify: start (default) | center | end | between | around | evenly — Where the links sit in the row.
1740
1738
- data-size: sm | md (default) | lg — The text step.
1739
+
- data-threshold: 2xs | xs | sm (default) | md | lg | xl | 2xl — The pagination's own width below which only Previous, the current page, and Next remain.
1740
+
- data-justify: start (default) | center | end | between | around | evenly — Where the links sit in the row.
1741
1741
1742
1742
### When to use it
1743
1743
@@ -1834,9 +1834,9 @@ Gives a section a shaped edge, a slant, a curve, or a wave, cut from its own bac
1834
1834
1835
1835
Attributes:
1836
1836
- data-shape: slant (default) | curve | wave — The shape of the cut edge.
1837
+
- data-size: sm | md (default) | lg — The depth of the cut: twice the size's space step.
1837
1838
- data-edge: top | bottom (default) | both — Which edge is cut.
1838
1839
- data-flip (boolean) — Mirror the shape horizontally, for alternating sections. A curve is symmetric and does not change.
1839
-
- data-size: sm | md (default) | lg — The depth of the cut: twice the size's space step.
1840
1840
1841
1841
### When to use it
1842
1842
@@ -1962,8 +1962,8 @@ Give the table a caption, or aria-label / aria-labelledby. Header cells carry sc
1962
1962
A row of tabs over their panels, showing one at a time when its module is loaded and all of them when it is not.
1963
1963
1964
1964
Attributes:
1965
-
- data-orientation: horizontal (default) | vertical — Whether the tab list runs along the top or down the side.
1966
1965
- data-variant: primary (default) | secondary | success | warning | alert | neutral — The hue of the selected tab and its edge.
1966
+
- data-orientation: horizontal (default) | vertical — Whether the tab list runs along the top or down the side.
1967
1967
- data-gap: none | xs | sm | md (default) | lg | xl | 2xl | 3xl | xs-sm | xs-md | xs-lg | xs-xl | xs-2xl | xs-3xl | sm-md | sm-lg | sm-xl | sm-2xl | sm-3xl | md-lg | md-xl | md-2xl | md-3xl | lg-xl | lg-2xl | lg-3xl | xl-2xl | xl-3xl | 2xl-3xl — Space between the list and the panels.
0 commit comments