Naar inhoud
1.6k

Keuzegroep

Een reeks keuzerondjes voor abonnementen, verzendopties en instellingenformulieren — met die neobrutalistische stijl van randen en schaduwen.

import { Label } from "@/components/ui/label"
import { RadioGroup, RadioGroupItem } from "@/components/ui/radio-group"

De radiogroep presenteert een set opties die elkaar uitsluiten — vink je één item aan, dan gaan de andere uit. Gebouwd op de component Base UI Radio Group en vormgegeven volgens het neobrutalistische recept: dikke randen, harde schaduwen en vette typografie.

Ideaal voor:

  • Abonnementskeuzes — free / pro / enterprise als keuzekaarten, met precies één afgedwongen selectie.
  • Checkout-opties — verzendsnelheid of betaalmethode, waar elke keuze zichtbaar moet blijven.
  • Instellingen met 2–5 opties — thema, dichtheid, meldingsfrequentie; minder klikken dan een select.

Installatie

pnpm dlx shadcn@latest add https://neobrutalism.com/r/base/radio-group.json
npx shadcn@latest add https://neobrutalism.com/r/base/radio-group.json
yarn dlx shadcn@latest add https://neobrutalism.com/r/base/radio-group.json
bunx --bun shadcn@latest add https://neobrutalism.com/r/base/radio-group.json

Installeer de volgende afhankelijkheden:

pnpm add @base-ui/react
npm install @base-ui/react
yarn add @base-ui/react
bun add @base-ui/react

Kopieer en plak de volgende code in je project.

components/ui/radio-group.tsx
"use client"

import * as React from "react"
import { RadioGroup as RadioGroupPrimitive } from "radix-ui"

import { cn } from "@/lib/utils"

function RadioGroup({
  className,
  ...props
}: React.ComponentProps<typeof RadioGroupPrimitive.Root>) {
  return (
    <RadioGroupPrimitive.Root
      data-slot="radio-group"
      className={cn("grid w-full gap-2", className)}
      {...props}
    />
  )
}

function RadioGroupItem({
  className,
  ...props
}: React.ComponentProps<typeof RadioGroupPrimitive.Item>) {
  return (
    <RadioGroupPrimitive.Item
      data-slot="radio-group-item"
      className={cn(
        "group/radio-group-item peer relative flex aspect-square size-5 shrink-0 rounded-full border-2 bg-input shadow-sm outline-none after:absolute after:-inset-x-3 after:-inset-y-2 focus-visible:outline-2 focus-visible:outline-offset-2 focus-visible:outline-primary disabled:cursor-not-allowed disabled:opacity-50 aria-invalid:border-destructive",
        className
      )}
      {...props}
    >
      <RadioGroupPrimitive.Indicator
        data-slot="radio-group-indicator"
        className="flex size-4 items-center justify-center"
      >
        <span className="absolute top-1/2 left-1/2 size-2 -translate-x-1/2 -translate-y-1/2 rounded-full bg-primary" />
      </RadioGroupPrimitive.Indicator>
    </RadioGroupPrimitive.Item>
  )
}

export { RadioGroup, RadioGroupItem }

Werk de importpaden bij zodat ze overeenkomen met je projectconfiguratie.

Gebruik

import { Label } from "@/components/ui/label"
import { RadioGroup, RadioGroupItem } from "@/components/ui/radio-group"
<RadioGroup defaultValue="option-one">
  <div className="flex items-center gap-3">
    <RadioGroupItem value="option-one" id="option-one" />
    <Label htmlFor="option-one">Option One</Label>
  </div>
  <div className="flex items-center gap-3">
    <RadioGroupItem value="option-two" id="option-two" />
    <Label htmlFor="option-two">Option Two</Label>
  </div>
</RadioGroup>

Compositie

Gebruik de volgende compositie om een RadioGroup op te bouwen:

RadioGroup
├── RadioGroupItem
└── RadioGroupItem

Voorbeelden

Beschrijving

Radio-group-items met een beschrijving met behulp van de component Field.

import {
  Field,
  FieldContent,

Choice Card

Gebruik FieldLabel om het hele Field te omhullen voor een klikbare selectie in kaartstijl.

import {
  Field,
  FieldContent,

Fieldset

Gebruik FieldSet en FieldLegend om radio-items met een label en beschrijving te groeperen.

import {
  Field,
  FieldDescription,

Uitgeschakeld

Gebruik de prop disabled op RadioGroup om alle items uit te schakelen.

import { Field, FieldLabel } from "@/components/ui/field"
import { RadioGroup, RadioGroupItem } from "@/components/ui/radio-group"

Ongeldig

Gebruik aria-invalid op RadioGroupItem en data-invalid op Field om validatiefouten te tonen.

import {
  Field,
  FieldDescription,

RTL

Om RTL-ondersteuning in Neobrutalism in te schakelen, zie de RTL-configuratiegids.

"use client"

import * as React from "react"

Toegankelijkheid

De radiogroep volgt het WAI-ARIA Radio Group-patroon: de container rendert role="radiogroup", elk item is een role="radio"-knop met aria-checked, en dankzij een roving tabindex vormt de hele groep één tabstop.

Toetsenbordinteracties:

ToetsActie
Tab / Shift + TabVerplaatst de focus de groep in (het aangevinkte of eerste item) / eruit
SpaceVinkt het gefocuste item aan als dat nog niet zo is
ArrowDown / ArrowRightVerplaatst de focus naar het volgende item en vinkt het aan
ArrowUp / ArrowLeftVerplaatst de focus naar het vorige item en vinkt het aan

De pijltjes links en rechts volgen in RTL de leesrichting.

API-referentie

Zie de documentatie van Base UI Radio Group.