Hopp til hovedinnhold

Hva leter du etter?

Prøv å søke etter…

Komponenter

Field

Field er et hjelpemiddel for å automatisk koble et felt sammen med Label, Field.Description, ValidationMessage og Field.Counter.

Det er vanlig å bli forvirret mellom Fieldset og Field. En god huskeregel er at Fieldset er et sett med Field

position
Description

Position of toggle inputs (radio, checkbox, switch) in field

Type
"start" | "end"
Default
start
asChild
Description

Change the default rendered element for the one passed as a child, merging their props and behavior. @deprecated This is not supported anymore, as the element needs to be `ds-field`

Type
boolean
Default
false
NameTypeDefaultDescription
position"start" | "end"start

Position of toggle inputs (radio, checkbox, switch) in field

asChildbooleanfalse

Change the default rendered element for the one passed as a child, merging their props and behavior. @deprecated This is not supported anymore, as the element needs to be `ds-field`

FieldCounter

over
Description

Label template for when `maxCount` is exceeded. Use `%d` to insert the number of characters.

Type
string
Default
'%d tegn for mye'
under
Description

Label template for count. Use `%d` to insert the number of characters.

Type
string
Default
'%d tegn igjen'
hint
Description

@deprecated The hint attribute is deprecated.

Type
string
limit
Description

The maximum allowed characters.

Type
number
Default
undefined
asChild
Description

Change the default rendered element for the one passed as a child, merging their props and behavior.

Type
boolean
Default
false
NameTypeDefaultDescription
overstring'%d tegn for mye'

Label template for when `maxCount` is exceeded. Use `%d` to insert the number of characters.

understring'%d tegn igjen'

Label template for count. Use `%d` to insert the number of characters.

hintstring-

@deprecated The hint attribute is deprecated.

limitnumberundefined

The maximum allowed characters.

asChildbooleanfalse

Change the default rendered element for the one passed as a child, merging their props and behavior.

Bruk

Field kan brukes sammen med Input, Textarea og Select. OBS: Textfield har allerede Field innebygd, og kan derfor ikke brukes i en Field.

Eksempel

Prefix/Suffix

Prefixer og suffixer er nyttige for å vise enheter, valuta eller andre typer informasjon som er relevant for feltet. Du skal ikke bruke disse alene, siden skjermlesere ikke leser dem opp. Det er viktig at samme informasjon som vises i prefixet eller suffixet også er inkludert i ledeteksten.

Antall tegn

Bruk Field.Counter til å informere om antall tegn brukerne kan skrive i feltet.

Plassering

Bruk position="end" når du ønsker å plassere for eksempel en Switch til høyre for Label.

Du kan endre teksten ved å sende inn props, som du kan se øverst på siden. Språket er standard norsk bokmål.

HTML

Legg klassenavnet ds-field<ds-field> elementet. <ds-field> kobler sammen label, input, valideringsmelding og counter.

Antall tegn

For å få en teller på input og textarea, legg til en <p> med attributtet data-field="counter" inne i ds-field.

Du kan styre teksten i telleren ved å bruke følgende attributter:

attributetypedefaultrequired
data-limitnumberundefinedtrue
data-overstring%d tegn for myefalse
data-understring%d tegn igjenfalse

Ubestemt

For å sette en checkbox til ubestemt, legg til data-indeterminate="true"<input> elementet.

Plassering

For å endre plassering av elementer i Field, som for eksempel en Switch, kan du legge til data-position="end|start" på samme element som ds-field.

CSS variabler og data-attributter

CSS-variabler
NavnVerdi
--dsc-field-content-spacingvar(--ds-size-2)
--dsc-field-counter-over"%d tegn for mye"
--dsc-field-counter-under"%d tegn igjen"
--dsc-field-affix-border-widthvar(--ds-border-width-default)
--dsc-field-affix-border-stylesolid
--dsc-field-affix-border-colorvar(--ds-color-neutral-border-default)
--dsc-field-affix-padding-inlinevar(--ds-size-4)
Data-attributter
NavnVerdi
data-fielddescription, counter
data-stateover
data-clickdelegatefor
data-positionend
Rediger denne siden på github.com (åpnes i ny fane)