Skip to content

Stack

A flex layout with semantic spacing—direction (flex-col, flex-row), gap-*, alignment, and wrap, all with ts utilities. Grid’s sibling.

Layout · TaishoDS Core, in plain HTML.

Examples

One working example per case. Each example is the HTML of its preview—copy it as is, and with Core’s CSS and JS loaded, it looks and works the same.

Stacked settings with spacing

Notifications
Language
Time zone
html

Class reference

Every value of each modifier, with its HTML ready to copy.

Direction

Stacking direction: column (flex-col) or row (flex-row).

Dashboard Payments API
Dashboard Payments API
html

Gap

The space between items (gap-*), from the none token to double.

Marketing site Mobile app
Marketing site Mobile app
Marketing site Mobile app
Marketing site Mobile app
Marketing site Mobile app
Marketing site Mobile app
html

Alignment

Alignment on the cross axis (items-*): start, center, end, and stretch.

Data pipeline Production
Data pipeline Production
Data pipeline Production
Data pipeline Production
Data pipeline Production
html

Distribution

Distribution on the main axis (justify-*): start, center, between, around, and evenly.

Staging Development
Staging Development
Staging Development
Staging Development
Staging Development
Staging Development
html

States

The stack with its default settings.

Dashboard Payments API Marketing site
html

When to use

  • The elements run in a single direction, like a column of sections or a row of buttons.
  • What matters is the space between items, not aligning them into columns.
  • You want the same spacing rhythm as the rest of the system.

When not to use

  • The elements need to line up in rows and columns → grid.
  • It’s the width of the whole page → container.

Do

  • Use the system’s gaps instead of one-off margins on the children.
  • If the block is a region, use the right semantic element.

Don’t

  • Don’t add margins to the children to fix the spacing. Change the gap.
  • Don’t force a grid out of nested stacks → grid.

TaishoDS Core

Doesn’t need JavaScript—it’s markup and CSS.

Layout: flexbox and gap.

From the CDN, without a build, this component has no file of its own—it comes with taisho.base.css.

For how Core works in general, see Behavior.

Accessibility

  • A layout container that adds no semantics and doesn’t change the DOM order, so visual order and reading order match.

Verification

What was actually tested. Anything that wasn’t tested says so—we’d rather say “not verified” than claim too much.

  • axe WCAG 2.2 A + AA in a real browser, in light and dark mode, before every release.
  • keyboard Adds no keys of its own—it uses the browser’s native behavior.
  • screen reader Not verified with a screen reader. Test it in your own combination of components, not just here, where each one appears alone and on its happy path.