Site color

Choose your site’s color palette.

Saved on this device.

Grid

GridTwo-dimensional layout

From equal cards to deliberate tracks. Responsive columns and item alignment make space for the content.

Layout & content

In context

A responsive workspaceCOMPOSITION

Documentation

A clear place to begin.

Open guides

Ready to compose

Small components. Flexible layouts.

One column on narrow screens, two at sm, and three at xl. The first card spans two columns from sm upward.

<Grid columns="1" columnsSm="2" columnsXl="3">
<Panel class="layout-featured-card" tone="feature" variant="surface">
<IconFrame name="lucide:layers" tone="feature"/>
<h3>Build with intent</h3>
<p>A featured card with room for a little more context.</p>
</Panel>
<Panel tone="info">
<h3>Documentation</h3>
<p>A clear place to begin.</p>
<BtnLink href="/guides/" tone="info" variant="link">Open guides</BtnLink>
</Panel>
<Panel tone="success">
<h3>Ready to compose</h3>
<p>Small components. Flexible layouts.</p>
</Panel>
</Grid>

Interactive playground

Start with a preset, then change the column counts, gap, item alignment, and packing. Choose Auto-fit cards and reduce the preview width to see cards wrap without a media query. Choose Dense board, then turn dense packing off to compare how later items fill earlier gaps.

Responsive overrides use the browser viewport, not the preview width. Resize your browser to cross a breakpoint; the live readout shows which setting applies. Empty overrides inherit the smaller breakpoint. Spacing uses the framework's gap utilities. Wide cards use the same layout-featured-card class as the guide's spanning examples, starting at sm.

<RegorApp id="grid-playground" src="./playground.ts"/>
import {
  defineBadgeComponents,
  defineButtonComponents,
  defineFlexComponents,
  defineFormComponents,
  defineFormInputField,
  defineFormSelectField,
  defineGridComponents,
  defineIconComponents,
  definePanelComponents,
  type FormSelectOption,
} from '@purestack/ts-components'
import { BREAKPOINTS } from '@purestack/ts-style'
import { lucide_chevron_down } from '@purestack/ts-svg-icons'
import {
  batch,
  computed,
  createApp,
  defineComponent,
  html,
  onMounted,
  onUnmounted,
  ref,
} from 'regor'

const breakpoints = ['sm', 'md', 'lg', 'xl'] as const
type GridAlignment = 'stretch' | 'start' | 'center' | 'end'
const countOptions: FormSelectOption[] = Array.from({ length: 12 }, (_, i) => ({
  label: `${i + 1} column${i ? 's' : ''}`,
  value: String(i + 1),
}))
const alignmentOptions: FormSelectOption[] = [
  'stretch',
  'start',
  'center',
  'end',
].map((value) => ({ label: value, value }))
const samples = [
  {
    title: 'Content',
    description: 'Write a clear starting point.',
    tone: 'accent',
  },
  {
    title: 'Components',
    description: 'Compose a consistent interface.',
    tone: 'info',
  },
  {
    title: 'Themes',
    description: 'Make room for light and dark.',
    tone: 'feature',
  },
  {
    title: 'Navigation',
    description: 'Connect the next useful step.',
    tone: 'success',
  },
  {
    title: 'Preview',
    description: 'Review the details together.',
    tone: 'warning',
  },
  {
    title: 'Publish',
    description: 'Share what you have built.',
    tone: 'neutral',
  },
]

function escapeAttribute(value: string) {
  return value
    .replaceAll('&', '&amp;')
    .replaceAll('"', '&quot;')
    .replaceAll('<', '&lt;')
    .replaceAll('>', '&gt;')
}

function createGridPlayground() {
  const selectedPreset = ref('cards')
  const base = ref('1')
  const customTracks = ref('minmax(0, 2fr) minmax(0, 1fr)')
  const sm = ref('2')
  const md = ref('')
  const lg = ref('3')
  const xl = ref('')
  const itemAlignment = ref<GridAlignment>('stretch')
  const itemJustification = ref<GridAlignment>('stretch')
  const dense = ref(false)
  const wideItems = ref(false)
  const variedHeights = ref(true)
  const descriptions = ref(true)
  const gap = ref('3')
  const itemCount = ref('6')
  const previewWidth = ref('w-full')
  const element = ref('div')
  const browserWidth = ref(window.innerWidth)
  const measuredWidth = ref(0)
  const measuredColumns = ref(0)
  const copyLabel = ref('Copy markup')
  const trackError = computed(() =>
    base() === 'custom' &&
    (!customTracks().trim() ||
      !CSS.supports('grid-template-columns', customTracks().trim()))
      ? 'Enter a valid CSS grid-template-columns value. The preview uses one column until it is valid.'
      : '',
  )
  const columns = computed(() =>
    base() === 'custom' ? (trackError() ? '1' : customTracks().trim()) : base(),
  )
  const responsive = [sm, md, lg, xl]
  const activeBreakpoint = computed(() => {
    const width = browserWidth()
    return (
      [...breakpoints]
        .reverse()
        .find(
          (name) => width >= Number.parseInt(BREAKPOINTS[name].value, 10),
        ) ?? 'base'
    )
  })
  const activeColumns = computed(() => {
    let value = columns()
    breakpoints.forEach((name, i) => {
      if (
        browserWidth() >= Number.parseInt(BREAKPOINTS[name].value, 10) &&
        responsive[i]()
      )
        value = responsive[i]()
    })
    return value
  })
  const spanFor = (value: string) =>
    /^\d+$/.test(value) && Number(value) >= 2 ? 2 : 1
  const canSpan = computed(() =>
    [columns(), ...responsive.map((value) => value()).filter(Boolean)].every(
      (value) => spanFor(value) === 2,
    ),
  )
  const tiles = computed(() =>
    Array.from({ length: Number(itemCount()) }, (_, index) => ({
      ...samples[index % samples.length],
      index,
      label: String(index + 1).padStart(2, '0'),
    })),
  )
  const gridClass = computed(() => `gap-${gap()} p-0 m-0 list-none`)
  const widthClass = computed(() => `${previewWidth()} max-w-full mx-auto`)
  const itemClass = (index: number) =>
    `min-w-0${wideItems() && canSpan() && index < 2 ? ' layout-featured-card' : ''}`
  const cardBodyClass = (index: number) =>
    variedHeights() ? ['p-3', 'p-5', 'p-4'][index % 3] : 'p-3'
  const markup = computed(() => {
    const attrs = [`columns="${escapeAttribute(columns())}"`]
    breakpoints.forEach((name, i) => {
      if (responsive[i]())
        attrs.push(
          `columns${name[0].toUpperCase() + name.slice(1)}="${responsive[i]()}"`,
        )
    })
    if (element() !== 'div') attrs.push(`container="${element()}"`)
    attrs.push(
      `alignItems="${itemAlignment()}"`,
      `justifyItems="${itemJustification()}"`,
      `:dense="${dense()}"`,
      `class="${gridClass()}"`,
    )
    const tag = element() === 'ul' ? 'li' : 'div'
    const items = tiles()
      .map(
        (tile) =>
          `  <Flex${tag === 'div' ? '' : ` container="${tag}"`} direction="column" class="${itemClass(tile.index)}">\n    <Panel tone="${tile.tone}" variant="surface" class="flex-1 min-w-0" bodyClass="p-0">\n      <Flex direction="column" align="start" class="gap-1 ${cardBodyClass(tile.index)}">\n      <Badge tone="${tile.tone}" variant="outline">${tile.label}</Badge>\n      <h3 class="fs-h6 mt-2 mb-1 wrap-anywhere">${tile.title}</h3>${descriptions() ? `\n      <p class="text-muted mb-0 wrap-anywhere">${tile.description}</p>` : ''}\n      </Flex>\n    </Panel>\n  </Flex>`,
      )
      .join('\n')
    return `<Grid ${attrs.join('\n  ')}>\n${items}\n</Grid>`
  })
  const loadPreset = (preset: 'cards' | 'tracks' | 'auto' | 'dense') =>
    batch(() => {
      selectedPreset(preset)
      base('1')
      sm('2')
      md('')
      lg('3')
      xl('')
      itemAlignment('stretch')
      itemJustification('stretch')
      dense(false)
      wideItems(false)
      variedHeights(true)
      descriptions(true)
      gap('3')
      itemCount('6')
      previewWidth('w-full')
      element('div')
      customTracks('minmax(0, 2fr) minmax(0, 1fr)')
      if (preset === 'tracks' || preset === 'auto') {
        base('custom')
        sm('')
        lg('')
        if (preset === 'auto')
          customTracks('repeat(auto-fit, minmax(min(100%, 180px), 1fr))')
      }
      if (preset === 'dense') {
        base('3')
        sm('')
        lg('')
        dense(true)
        wideItems(true)
        variedHeights(false)
        itemCount('9')
      }
    })

  let frame = 0
  let copyTimer: ReturnType<typeof setTimeout> | undefined
  let resizeObserver: ResizeObserver | undefined
  let mutationObserver: MutationObserver | undefined
  const measure = () => {
    frame = 0
    browserWidth(window.innerWidth)
    const grid = document.getElementById('grid-lab-preview')
    if (!grid) return
    measuredWidth(Math.round(grid.getBoundingClientRect().width))
    measuredColumns(
      getComputedStyle(grid).gridTemplateColumns.match(/\d+(?:\.\d+)?px/g)
        ?.length ?? 0,
    )
  }
  const scheduleMeasure = () => {
    if (!frame) frame = requestAnimationFrame(measure)
  }
  onMounted(() => {
    const stage = document.getElementById('grid-lab-stage')
    if (!stage) return
    resizeObserver = new ResizeObserver(scheduleMeasure)
    resizeObserver.observe(stage)
    mutationObserver = new MutationObserver(scheduleMeasure)
    mutationObserver.observe(stage, {
      attributes: true,
      childList: true,
      subtree: true,
      attributeFilter: ['style', 'class'],
    })
    window.addEventListener('resize', scheduleMeasure)
    scheduleMeasure()
  })
  onUnmounted(() => {
    resizeObserver?.disconnect()
    mutationObserver?.disconnect()
    window.removeEventListener('resize', scheduleMeasure)
    cancelAnimationFrame(frame)
    if (copyTimer) clearTimeout(copyTimer)
  })
  return {
    selectedPreset,
    base,
    customTracks,
    sm,
    md,
    lg,
    xl,
    columns,
    itemAlignment,
    itemJustification,
    dense,
    wideItems,
    variedHeights,
    descriptions,
    gap,
    itemCount,
    previewWidth,
    element,
    trackError,
    canSpan,
    tiles,
    gridClass,
    widthClass,
    itemClass,
    cardBodyClass,
    markup,
    browserWidth,
    measuredWidth,
    measuredColumns,
    activeBreakpoint,
    activeColumns,
    copyLabel,
    loadPreset,
    reset: () => loadPreset('cards'),
    baseOptions: [
      ...countOptions,
      { label: 'Custom CSS tracks', value: 'custom' },
    ],
    responsiveOptions: [
      { label: 'Inherit smaller breakpoint', value: '' },
      ...countOptions,
    ],
    alignmentOptions,
    gapOptions: [0, 1, 2, 3, 4, 5, 6].map((value) => ({
      label: `gap-${value}`,
      value: String(value),
    })),
    itemOptions: [3, 6, 9, 12].map((value) => ({
      label: `${value} items`,
      value: String(value),
    })),
    widthOptions: [
      { label: 'Full available width', value: 'w-full' },
      { label: 'Narrow', value: 'layout-playground-width--narrow' },
      { label: 'Medium', value: 'layout-playground-width--medium' },
      { label: 'Wide', value: 'layout-playground-width--wide' },
    ],
    containerOptions: ['div', 'section', 'ul'].map((value) => ({
      label: value,
      value,
    })),
    copy: async () => {
      if (copyTimer) clearTimeout(copyTimer)
      try {
        await navigator.clipboard.writeText(markup())
        copyLabel('Copied')
      } catch {
        copyLabel('Select the markup below to copy')
      }
      copyTimer = setTimeout(() => copyLabel('Copy markup'), 2500)
    },
  }
}

export type GridPlayground = ReturnType<typeof createGridPlayground>

const template = html`<Flex direction="column">
  <Flex justify="between" align="center" wrap="true">
    <div>
      <p class="text-eyebrow m-0">Make space for your content</p>
      <h3 class="mt-1 mb-0">Grid layout lab</h3>
    </div>
    <Badge tone="accent" variant="surface">Live playground</Badge>
  </Flex>
  <Flex wrap="true" aria-label="Grid presets">
    <Btn
      size="sm"
      tone="accent"
      :variant="selectedPreset === 'cards' ? 'solid' : 'outline'"
      :aria-pressed="selectedPreset === 'cards'"
      @click="loadPreset('cards')"
      >Responsive cards</Btn>
    <Btn
      size="sm"
      tone="accent"
      :variant="selectedPreset === 'tracks' ? 'solid' : 'outline'"
      :aria-pressed="selectedPreset === 'tracks'"
      @click="loadPreset('tracks')"
      >Asymmetric tracks</Btn>
    <Btn
      size="sm"
      tone="accent"
      :variant="selectedPreset === 'auto' ? 'solid' : 'outline'"
      :aria-pressed="selectedPreset === 'auto'"
      @click="loadPreset('auto')"
      >Auto-fit cards</Btn>
    <Btn
      size="sm"
      tone="accent"
      :variant="selectedPreset === 'dense' ? 'solid' : 'outline'"
      :aria-pressed="selectedPreset === 'dense'"
      @click="loadPreset('dense')"
      >Dense board</Btn>
  </Flex>
  <Panel variant="surfaceAlt" bodyClass="p-3 min-w-0">
    <Flex justify="between" wrap="true" class="mb-3">
      <strong>Live layout</strong><span class="text-muted"
        >{{ measuredColumns }} tracks · {{ measuredWidth }}px
        available</span>
    </Flex>
    <div id="grid-lab-stage" :class="widthClass">
      <Grid
        id="grid-lab-preview"
        :container="element"
        :columns="columns"
        :columnsSm="sm"
        :columnsMd="md"
        :columnsLg="lg"
        :columnsXl="xl"
        :alignItems="itemAlignment"
        :justifyItems="itemJustification"
        :dense="dense"
        :class="gridClass"
      >
        <Flex
          r-for="tile in tiles"
          :container="element === 'ul' ? 'li' : 'div'"
          direction="column"
          :class="itemClass(tile.index)"
        >
          <Panel
            :tone="tile.tone"
            variant="surface"
            class="flex-1 min-w-0"
            bodyClass="p-0"
          >
            <Flex
              direction="column"
              align="start"
              :class="'gap-1 ' + cardBodyClass(tile.index)"
            >
              <Badge :tone="tile.tone" variant="outline"
                >{{ tile.label }}</Badge>
              <h3 class="fs-h6 mt-2 mb-1 wrap-anywhere">
                {{ tile.title }}
              </h3>
              <p r-if="descriptions" class="text-muted mb-0 wrap-anywhere">
                {{ tile.description }}
              </p>
            </Flex>
          </Panel>
        </Flex>
      </Grid>
    </div>
  </Panel>
  <p class="text-muted m-0">
    Browser: {{ browserWidth }}px · Active breakpoint:
    <code>{{ activeBreakpoint }}</code> · Columns:
    <code>{{ activeColumns }}</code>
  </p>
  <fieldset class="b-0 p-0 m-0">
    <legend class="text-eyebrow mb-2">Columns &amp; breakpoints</legend>
    <Grid columns="1" columnsSm="2" columnsLg="3">
      <FormSelectField
        id="grid-lab-base"
        label="Base columns"
        :model="base"
        :options="baseOptions"/>
      <FormSelectField
        id="grid-lab-sm"
        label="sm · 640px and up"
        :model="sm"
        :options="responsiveOptions"/>
      <FormSelectField
        id="grid-lab-md"
        label="md · 768px and up"
        :model="md"
        :options="responsiveOptions"/>
      <FormSelectField
        id="grid-lab-lg"
        label="lg · 1024px and up"
        :model="lg"
        :options="responsiveOptions"/>
      <FormSelectField
        id="grid-lab-xl"
        label="xl · 1280px and up"
        :model="xl"
        :options="responsiveOptions"/>
      <FormSelectField
        id="grid-lab-container"
        label="Container element"
        :model="element"
        :options="containerOptions"/>
    </Grid>
    <FormInputField
      r-if="base === 'custom'"
      id="grid-lab-custom"
      class="mt-3"
      label="CSS track list"
      :model="customTracks"
      placeholder="minmax(0, 2fr) minmax(0, 1fr)"/>
    <p r-if="trackError" role="alert" class="text-muted mb-0">
      {{ trackError }}
    </p>
  </fieldset>
  <fieldset class="b-0 p-0 m-0">
    <legend class="text-eyebrow mb-2">Spacing &amp; alignment</legend>
    <Grid columns="1" columnsSm="2" columnsLg="3">
      <FormSelectField
        id="grid-lab-align"
        label="Vertical alignment"
        :model="itemAlignment"
        :options="alignmentOptions"/>
      <FormSelectField
        id="grid-lab-justify"
        label="Horizontal alignment"
        :model="itemJustification"
        :options="alignmentOptions"/>
      <FormSelectField
        id="grid-lab-gap"
        label="Gap"
        :model="gap"
        :options="gapOptions"/>
      <FormSelectField
        id="grid-lab-items"
        label="Item count"
        :model="itemCount"
        :options="itemOptions"/>
      <FormSelectField
        id="grid-lab-width"
        label="Preview width"
        :model="previewWidth"
        :options="widthOptions"/>
    </Grid>
    <Flex wrap="true" class="mt-3">
      <FormCheck id="grid-lab-dense" label="Dense packing" :checked="dense"/>
      <FormCheck
        id="grid-lab-wide"
        label="Wide first two items"
        :checked="wideItems"
        :disabled="!canSpan"/>
      <FormCheck
        id="grid-lab-heights"
        label="Vary card padding"
        :checked="variedHeights"/>
      <FormCheck
        id="grid-lab-descriptions"
        label="Show descriptions"
        :checked="descriptions"/>
    </Flex>
  </fieldset>
  <p class="text-muted m-0">
    Breakpoints follow the browser width. Auto-fit follows the available preview
    width. Wide cards use the guide's layout-featured-card class from sm onward
    and require numeric counts of two or more at every breakpoint; dense packing
    may change their visual order.
  </p>
  <Flex justify="between" align="center" wrap="true">
    <strong>Copyable Grid markup</strong>
    <Flex wrap="true"
      ><Btn size="sm" variant="outline" @click="reset">Reset playground</Btn><Btn size="sm" @click="copy"
        ><span aria-live="polite">{{ copyLabel }}</span></Btn></Flex>
  </Flex>
  <Panel variant="surfaceAlt" bodyClass="p-3 min-w-0">
    <pre
      class="overflow-auto max-h-inspector m-0"
    ><code>{{ markup }}</code></pre>
  </Panel>
</Flex>`

const component = defineComponent<GridPlayground>(template, {
  context: createGridPlayground,
})
createApp(
  {
    components: {
      GridPlayground: component,
      ...defineGridComponents(),
      ...defineFlexComponents(),
      ...definePanelComponents(),
      ...defineBadgeComponents(),
      ...defineButtonComponents(),
      ...defineFormComponents(),
      ...defineFormInputField(),
      ...defineFormSelectField(),
      ...defineIconComponents((name) =>
        name === 'lucide:chevron-down' ? lucide_chevron_down : '',
      ),
    },
  },
  { selector: 'app#grid-playground', template: html`<GridPlayground/>` },
)

A responsive card grid

One column becomes two at sm and three at lg. Cards stretch to share the row height.

01

Content

Write structured pages in MDX.

02

Components

Compose reusable interfaces with typed props.

03

Theme

Keep every surface consistent.

<Grid columns="1" columnsSm="2" columnsLg="3">
  <Panel bodyClass="p-3">
    <Badge tone="accent">01</Badge>
    <h3>Content</h3>
    <p>Write structured pages in MDX.</p>
  </Panel>
  <Panel bodyClass="p-3">
    <Badge tone="info">02</Badge>
    <h3>Components</h3>
    <p>Compose reusable interfaces with typed props.</p>
  </Panel>
  <Panel bodyClass="p-3">
    <Badge tone="success">03</Badge>
    <h3>Theme</h3>
    <p>Keep every surface consistent.</p>
  </Panel>
</Grid>

Content and action tracks

A minmax track lets long content shrink; the action keeps its natural width when the viewport allows it.

Ready to compose?

Use explicit tracks when equal widths are not the right fit.

Explore Flex
<Grid columns="1" columnsMd="minmax(0, 1fr) auto" alignItems="center">
  <div>
    <h3 class="m-0">Ready to compose?</h3>
    <p class="mb-0">Use explicit tracks when equal widths are not the right fit.</p>
  </div>
  <BtnLink href="/components/layout/flex/" tone="accent">Explore Flex</BtnLink>
</Grid>

Item alignment

Alignment controls how children sit inside their cells. It does not change the number of tracks.

Compact item
A taller item establishes the row height.
<Grid columns="2" alignItems="center" justifyItems="start">
  <Badge tone="accent">Compact item</Badge>
  <Panel bodyClass="p-4">A taller item establishes the row height.</Panel>
</Grid>

Every column count

Numeric counts from 1 through 12. Values are clamped to this range; each track uses minmax(0, 1fr).

Every column countCOMPOSITION
1
1
2
12
3
123
4
1234
5
12345
6
123456
7
1234567
8
12345678
9
123456789
10
12345678910
11
1234567891011
12
123456789101112

Every value is visible. Compare treatments in the site’s light and dark themes.

Every item alignment

All alignItems values with a fixed-height stage and a taller second tile.

Every item alignmentCOMPOSITION
stretch
ABC
start
ABC
center
ABC
end
ABC

Every value is visible. Compare treatments in the site’s light and dark themes.

Every horizontal placement

All justifyItems values. Stretch fills the track; the other values preserve the item’s natural width.

Every horizontal placementCOMPOSITION
stretch
ABC
start
ABC
center
ABC
end
ABC

Every value is visible. Compare treatments in the site’s light and dark themes.

Dense packing

The third small tile can fill the earlier gap when dense is enabled. Packing may change visual order, so preserve a sensible source order.

Dense packingCOMPOSITION
false
A spans 2B spans 2CD
true
A spans 2B spans 2CD

Every value is visible. Compare treatments in the site’s light and dark themes.

Tracks, containers, and every breakpoint

Columns accept a number, a numeric string, or a CSS track expression. Omitted responsive values inherit the smaller breakpoint. Custom gaps and spans belong to CSS classes or native style attributes.

Every responsive column overrideCOMPOSITION
A B C D E F

Resize the viewport: one column at the base size, two at sm, three at md, four at lg, and six at xl.

Explicit tracksCOMPOSITION

Release checklist

Ready

minmax(0, 1fr) keeps the content track shrinkable; the action track follows its content.

<Grid container="section" columns="1" columnsSm="2" columnsMd="3" columnsLg="4" columnsXl="6" aria-label="Project cards">
  <Panel>First project</Panel>
  <Panel>Second project</Panel>
</Grid>

<Grid columns="minmax(0, 1fr) auto">
  <span>Content</span>
<Badge>Ready</Badge>
</Grid>

Behavior and accessibility

Keep DOM order meaningful. Dense placement can fill earlier gaps but may make visual order differ from keyboard and reading order. Use minmax(0, 1fr) for shrinkable content tracks. Breakpoints use the active theme.

API reference

Grid contract

Props below are the public template API. RefOrValue accepts a literal or a reactive ref; bind refs with a colon-prefixed attribute. Native attributes and events can be passed through the component root.

container

RefOrValue<string>
Default
div

HTML element used as the layout root. Choose a semantic element such as section, nav or ul when its children fit that structure.

columns

RefOrValue<number | string>
Default
1

Column count from 1 to 12, or a CSS track list such as minmax(0, 1fr) auto. Numeric counts are clamped.

columnsSm

RefOrValue<number | string>
Default
inherits columns

Column count or CSS track list at the theme’s sm breakpoint and above.

columnsMd

RefOrValue<number | string>
Default
inherits smaller breakpoint

Column count or CSS track list at the theme’s md breakpoint and above.

columnsLg

RefOrValue<number | string>
Default
inherits smaller breakpoint

Column count or CSS track list at the theme’s lg breakpoint and above.

columnsXl

RefOrValue<number | string>
Default
inherits smaller breakpoint

Column count or CSS track list at the theme’s xl breakpoint and above.

alignItems

RefOrValue<GridAlignItems>
Default
stretch

Alignment inside each grid area: stretch, start, center or end.

justifyItems

RefOrValue<GridJustifyItems>
Default
stretch

Inline alignment inside each grid area: stretch, start, center or end.

dense

RefOrValue<boolean | string>
Default
false

Enables CSS grid-auto-flow: row dense. Accepts true or the string true; use a boolean binding for clarity.

Composition

Default slot: grid items. Native attributes are inherited by the chosen container. Register defineGridComponents.