Frivio

Design

Checkbox

Et valg som er del av et skjema og bekreftes/lagres samlet — «button role="checkbox"», aldri et rått input-element med type="checkbox".

import { Checkbox } from '@/components/ui/Checkbox'

Retningslinjer

Bruk

  • Et valg som er DEL av et skjema og lagres samlet — «godtar vilkårene», hvilke tiltak som skal med.

  • size="sm" for tette rader — radavkrysning uten synlig etikett ved siden av (sett ariaLabel da).

Ikke bruk

  • Bruk Switch i stedet når verdien er binær og trer i kraft med én gang, uten lagre-handling.

  • Ikke et rått input-element med type="checkbox" noe sted i appen.

Eksempler

Vis alt som

Med etikett og forklaring

Uten forklaring

Kun etikett, når teksten alene er selvforklarende.

Deaktivert

size="sm" i en tett rad

Ekstra isolasjon i loft

Indeterminate («velg alle»)

Strek når NOEN, men ikke alle, underliggende rader er krysset av.

shape="round" — fullført-oppgave-avkrysning

Samme boks, kun rounded-full — kun for en fullført-avkrysning på en oppgaverad, aldri i et skjema.

Skifte tak

Sveip tabellen for å se hele innholdet

Navn
Type
Default
Beskrivelse
checked *
boolean
—
Om boksen er avkrysset.
onChange *
(v: boolean) => void
—
Kalles med ny verdi ved klikk.
disabled
boolean
—
Deaktiverer boksen.
label
ReactNode
—
Ledeteksten. Utelates for en ren rad-avkrysning uten synlig tekst — sett ariaLabel da.
description
ReactNode
—
Forklaringen under etiketten.
ariaLabel
string
—
Kun når label mangler: gir skjermlesere et navn på boksen.
size
'sm' | 'md'
'md'
sm = 16px boks for tette rader. md = 20px for skjema.
shape
'square' | 'round'
'square'
round er SAMME boks, kun rounded-full — kun for fullført-oppgave-avkrysning på en rad, aldri i et skjema.
indeterminate
boolean
—
Tredje tilstand («noen, ikke alle») — strek i stedet for hake, aria-checked="mixed". Overstyrer checked visuelt.
className
string
—
Ekstra klasser.

Regler

regel/ingen-raa-skjemaelementer

Beslektede