Grid.
Columns that fit the space they are given.
Grid places children in equal columns, or fits as many columns as minColumnWidth allows. The minimum is clamped with min(…, 100%), so one column never overflows a narrow parent. Gaps use the stack spacing scale and follow Theme density.
Make it yours
Preparing the example…
Composition
AnatomyGrid places children in equal columns, or fits as many columns as minColumnWidth allows. The minimum is clamped with min(…, 100%), so one column never overflows a narrow parent. Gaps use the stack spacing scale and follow Theme density.
Grid (div by default; as= for ul/section…)
├── child
├── child
└── childA place to start
UsageImport the stylesheet once at your application root. This complete example reflects the properties selected above.
Loading example…
Details that make a difference
Examples & statesField spacing
Spacing changes independently of validation and field semantics.
Loading source…
The finer details
API referenceGenerated from Dixy’s local TypeScript interfaces. Native HTML attributes and refs are forwarded. The table covers Dixy’s own options.
GridOwn
| Prop | Type / description | Default |
|---|---|---|
columns | numberFixed number of equal columns. Ignored when minColumnWidth is set. | 2 |
minColumnWidth | stringFit as many columns as this minimum width allows, e.g. "12rem". Never overflows a narrow parent. | — |
gap | SpacingSize<"stack">Space between rows and columns. | md |
align | "center" | "end" | "start" | "stretch"Block-axis alignment of items within their row. | stretch |
Built from the same foundations
Styling tokensChange Theme settings above to compare appearance, accent, neutral, radius, spacing density, motion and direction. Override component aliases on a Theme root so custom properties follow portaled content too. The wrapper merges className, style, refs and render composition with its owning primitive.
| Token | Purpose |
|---|---|
--dixy-spacing-stack-md | The component-specific starting point. |
--dixy-font-label-md | Control label font and line height; body roles remain readable in text inputs. |
--dixy-color-background-selected | Selected surfaces use semantic color across appearances. |
--dixy-color-border-focus | Focus indication remains visible independently of shadows. |
--dixy-spacing-inset-sm | Density-aware component padding. |
--dixy-motion-transition-feedback | Short state feedback, reduced by the inherited motion setting. |
Consider everyone
AccessibilityGrid changes visual placement only; DOM order remains reading and Tab order. Do not reorder children visually in a way that disagrees with the source order. Target WCAG 2.2 AA. Automated axe checks pass in unit tests; screen-reader, forced-colors and contrast verification in real browsers remains pending.
Target: WCAG 2.2 AA. Automated tests cover selected behavior; manual screen-reader, contrast, and zoom validation remain part of the release checklist.
Build it. Then understand it.
auto-fit with minmax(min(X, 100%), 1fr) gives responsive columns without media queries, and the min() guard is what stops overflow at 320px.
--dixy-spacing-stack-md