Grid

Headless Grid; covers CSS grid, CSS gap, Reka UI Primitive.

Minimal setup

Use a Vue 3.5+ project with Vue SFC compilation configured (see Vite+ integration).

vp install @vizejs/ui

Add the public import below to <script setup lang="ts">. Components provide behavior without styles; the preview uses optional Paper styles.

import { Grid } from "@vizejs/ui/grid";

Or copy the source into your project with vize lib pull grid (see Source Distribution).

Try it

This is the basic example maintained with the component source, using the public package imports. The preview adds the optional Paper styles.

Open the interactive example · Styling these components

Copy the example

<!-- Three equal columns of pricing plans laid out with native CSS grid. -->
<script setup lang="ts">
import { Grid } from "@vizejs/ui/grid";

const plans = [
  { name: "Starter", price: "$0" },
  { name: "Team", price: "$12" },
  { name: "Enterprise", price: "Contact us" },
];
</script>

<template>
  <Grid as="ul" :columns="3" :gap="16" align="start">
    <li v-for="plan in plans" :key="plan.name">
      <h3>{{ plan.name }}</h3>
      <p>{{ plan.price }}</p>
    </li>
  </Grid>
</template>

API

Grid

Source: src/families/layout/grid/grid.vue

Props

Slots

Exposed

Behavior

Normative state x input -> outcome table for grid.vue (@vizejs/ui/grid). Every row is proven by the named mounted-DOM or SSR test. A row without a passing test is a contract violation.

Props

Slots

Expose

Data Attributes

ARIA Attributes

Grid never sets role, aria-hidden, aria-label, aria-labelledby, or tabindex. Consumers may pass semantic attributes to the host when the chosen element requires them.

CSS Custom Properties

Parts