Skip to content

GridColumnsSelect

How many products a listing shows in a row: a label and a few numbers to choose between.

In Figma: Grid Columns Select (node 2109:1076). In code: components/ui/grid-columns-select.tsx

Example

Kolonner
Kolonner
import { GridColumnsSelect } from '@/components/ui/grid-columns-select';

<GridColumnsSelect label="Kolonner" name="columns" options={[3, 4, 6]} defaultValue={3} />

Props

PropTypeDefaultWhat it does
label (required)stringWhat is being chosen, such as "Kolonner". Shown before the options and read aloud as the name of the group.
name (required)stringThe form field name. One select is one radio group.
options (required)number[]The column counts to choose between, such as [3, 4, 6].
valuenumberThe chosen count. With onChange the select is controlled.
defaultValuenumberThe count chosen from the start, uncontrolled.
onChange(value: number) => voidCalled with the new count.

Do

  • Offer counts the grid can hold: product overviews may use their own grid, such as six tiles per row.
  • Keep the choice in the address or in a setting, so the listing comes back the same.

Do not

  • Do not use it for anything but the number of columns in a listing.
  • Do not show it on a phone, where a listing has no room for a choice.

Accessibility

  • Each option is a native radio button in a fieldset named by the label: arrow keys move, a form posts the value.
  • The chosen option is marked by the four corners from the logo and by the text colour.
  • Figma sets an unchosen option in text/weak (Ash, about 2:1 on White). Here it is text/muted, which holds 4.5:1 in light and dark, until Peter answers question 32.

Tokens it uses

  • color.text.default
  • color.text.muted
  • radius.sm
  • type.body.sm
  • space.inline.1
  • space.inline.2
  • component.grid-column-option.size
  • component.grid-column-option.corner-size
  • component.grid-column-option.corner-inset
  • component.variation-option.corner-radius