Layout
GridItem
A cell inside a fixed-column Grid (e.g. <Grid columns={12}>). Each item sets its own width with span, and an optional start line, using a fixed number or a responsive map at design-system breakpoints. Mirrors the shadcn col-span-N and MUI Grid size model.
Examples
8 / 4 split (responsive)
Loading preview
<Grid columns={12} gap="12px">
<GridItem span={{ mobile: 12, desktop: 8 }}>main</GridItem>
<GridItem span={{ mobile: 12, desktop: 4 }}>aside</GridItem>
</Grid>API
| Prop | Type | Default | Description |
|---|---|---|---|
span | number | { mobile?, tablet?, desktop? } | 1 | Number of parent tracks to span, or a responsive map. |
start | number | { mobile?, tablet?, desktop? } | auto | Explicit 1-based start line (or responsive map); omit to auto-place after the previous item. |
Styling and attributes
Like every component, GridItem accepts the universal token style props (m, p, sx, display, responsive maps, ...) and forwards standard DOM attributes (id, data-*, aria-*, event handlers) to the underlying element. See Styling for the full API.
Guidelines
Do
- Use GridItem only inside a fixed-column Grid (e.g. columns={12}).
- Use a responsive span map so cells reflow on mobile.
Avoid
- Do not use GridItem in the default equal-columns Grid; auto-placed cells do not need it.