Hopp til hovedinnhold

Komponenter

Checkbox

Checkbox gir brukerne mulighet til å velge ett eller flere alternativer. Den kan også brukes i tilfeller der brukeren skal bekrefte noe.

disabled
Description

Disables element @note Avoid using if possible for accessibility purposes

Type
boolean
readOnly
Description

Toggle `readOnly`

Type
boolean
aria-label
Description

Optional aria-label

Type
string
label
Description

Checkbox label

Type
ReactNode
description
Description

Description for field

Type
ReactNode
value
Description

Value of the `input` element

Type
string | number | readonly string[]
error
Description

Error message for field

Type
ReactNode
aria-labelledby
Type
string
NameTypeDefaultDescription
disabledboolean-

Disables element @note Avoid using if possible for accessibility purposes

readOnlyboolean-

Toggle `readOnly`

aria-labelstring-

Optional aria-label

labelReactNode-

Checkbox label

descriptionReactNode-

Description for field

valuestring | number | readonly string[]-

Value of the `input` element

errorReactNode-

Error message for field

aria-labelledbystring-

-

Bruk

Eksempler

Gruppering

Bruk Fieldset og useCheckboxGroup for gruppering av flere valg.

Indeterminate checkbox

Legg inn allowIndeterminate: true i getCheckboxProps for å opprette en overordnet Checkbox som kan velge eller fjerne alle alternativer. Dette aktiverer en ekstra tilstand, indeterminate, ved siden av checked og unchecked. Den vises med en horisontal strek når én eller flere Checkbox er markert i gruppen. Den vises som en vanlig Checkbox dersom alle i gruppen har samme tilstand.

HTML

Checkbox er ein samansatt komponent, så i HTML må du bygge den opp av fleire komponentar. Me bruker Fieldset, Label og Input for å lage ein Checkbox.

Koden under viser hvordan du visuelt kan bygge opp en Checkbox i HTML, men du må selv passe på at <input> blir koblet sammen med <label> og beskrivelse.

I Fieldset

Koden under er et eksempel på hvordan du bruker Checkbox inni <fieldset>. Merk at vi kun viser en Checkbox her, i praksis vil dette ofte være flere.

CSS variablar og data-attributter

Checkbox er en sammensatt komponent, og derfor viser vi variabler og data-attributter fra ds-input her.

CSS-variabler
NavnVerdi
--dsc-input-padding-blockvar(--ds-size-2)
--dsc-input-padding-inlinevar(--ds-size-3)
--dsc-input-paddingvar(--dsc-input-padding-block) var(--dsc-input-padding-inline)
--dsc-input-size--togglevar(--ds-size-6)
--dsc-input-sizevar(--ds-size-12)
--dsc-input-background--readonlyvar(--ds-color-neutral-surface-tinted)
--dsc-input-backgroundvar(--ds-color-neutral-surface-default)
--dsc-input-border-color--readonlyvar(--ds-color-neutral-border-subtle)
--dsc-input-border-colorvar(--ds-color-neutral-border-default)
--dsc-input-border-stylesolid
--dsc-input-border-width--togglemax(var(--ds-border-width-default),calc(var(--ds-size-1)/2))
--dsc-input-border-widthvar(--ds-border-width-default)
--dsc-input-outline-color--hovervar(--ds-color-neutral-border-default)
--dsc-input-outline-color--toggle--hovervar(--dsc-input-accent-color)
--dsc-input-outline-width--hovervar(--ds-border-width-default)
--dsc-input-outline-style--hoversolid
--dsc-input-color--readonlyvar(--ds-color-neutral-text-default)
--dsc-input-colorvar(--ds-color-neutral-text-default)
--dsc-input-stroke-colorvar(--ds-color-base-contrast-default)
--dsc-input-stroke-color--invalidvar(--ds-color-danger-base-contrast-default)
--dsc-input-stroke-width0.05em
--dsc-input-accent-colorvar(--ds-color-base-default)
--dsc-input-accent-color--invalidvar(--ds-color-danger-text-subtle)
--dsc-input-line-heightvar(--ds-line-height-md)
Data-attributter
NavnVerdi
data-widthauto
Rediger denne siden på github.com (åpnes i ny fane)