Skip to content

Card

A surface container for grouping related content. It comes with ts card-media (an image) and a card group (data-card-grid, a responsive layout), and it can be made clickable as an <a class="ts card is-link" href>.

Content · 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.

Card with a glow that follows the pointer

Pro plan · 12 seats

Includes the Production and Staging environments.

html

Class reference

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

Variant

Surface treatment: default with a shadow, ghost with no border, and outline with just the outline.

Dashboard
Dashboard
Dashboard
html

Padding

Inner spacing, from none to lg.

Payments API
Payments API
Payments API
Payments API
Payments API
html

States

has-glow adds the glow that follows the mouse (spotlight).

Marketing site
html

Combinations

Variant and padding combined.

Mobile app
Mobile app
Mobile app
html

When to use

  • The content reads as a unit, like a product, a project, or a summary.
  • Each item has a different shape (image, text, actions) and doesn’t fit in a row.
  • You want the block to stand out from the background and be clickable as a whole.

When not to use

  • The items are uniform and compared field by field → table.
  • You only need to separate blocks of text → separator or whitespace.
  • It’s a notice, not content → note.

Do

  • If the whole card is clickable, make it an <a class="ts card is-link" href> instead of adding an invisible button.
  • Keep the same structure across all the cards in a grid.

Don’t

  • Don’t nest cards inside cards. The hierarchy gets lost.
  • Don’t add several different actions to a card that’s already a link as a whole.

TaishoDS Core

Needs Core’s JS, which hooks in through data-ts-* attributes.

The spotlight effect follows the pointer, and Core handles that.

Core hooks into it through these attributes. They go in the markup, and there’s nothing to initialize.

  • data-ts-spotlight

What it does: Listens to pointermove and writes two CSS variables with the position. Without it, the Card still looks right, just without the glow.

From the CDN, without a build, load taisho.card.css along with taisho.base.css. Also load:

  • taisho.grid.css

For how Core works in general, see Behavior.

Accessibility

  • A card that navigates wraps a real <a href> (navigable and focusable). Without it, it’s a neutral container.
  • The glow (has-glow) is purely decorative.

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.