Altinn Studio Referanse Brukergrensesnitt Komponenter Option

Option

Komponent som lar deg vise et valg fra en kodeliste

Bruk

Option-komponenten lar deg vise frem et valg fra en kodeliste. Dette kan være nyttig dersom du har en verdi fra en kodeliste, men ønsker å vise frem dette til brukeren uten at brukeren skal kunne endre denne verdien. Med andre ord, Option-komponenten er en read-only komponent, også kjent som en visningskomponent eller presentasjonskomponent.

Et eksempel på bruk kan være at kommunen brukeren tilhører er hentet inn fra folkeregisteret og lagret i datamodellen vha. forhåndsutfylling. Selv om brukeren ikke skal endre denne verdien bør den vises frem til informasjon, da alle deler av datamodellen er en del av den endelige innsendingen. Man kan hente inn listen over kommuner fra felles standard kodelister for å slå opp kommunenummeret og vise frem kommunenavnet.

Anatomi

Horisontal: Et valg strukturert horisontalt.
Option horisontal
Vertikal: Et valg strukturert vertikalt.
Option vertikal

Relatert

Egenskaper

Vi oppdaterer for øyeblikket hvordan egenskaper for komponenter dokumenteres. Listen over egenskaper kan derfor være unøyaktig.

Egenskap	Type	Beskrivelse
`id`	string	Komponent-ID-en. Må være unik innenfor alle oppsett/sider i et oppsett-sett. Kan ikke slutte med .
`value`	number	En verdi som finnes i kodelisten. Denne egenskapen kan være et dynamisk uttrykk som henter denne verdien fra f.eks. datamodellen.
`textResourceBindings.title`	string	Ledetekst (valgfritt)
`textResourceBindings.description`	string	Beskrivelse (valgfritt)
`textResourceBindings.help`	string	Hjelpetekst (valgfritt)
`direction`	string	Setter den strukturerte retningen av ledetekst og verdi. Enum: [horizontal, vertical] Default: horizontal
`icon`	string	Stien til et ikon som skal vises i forbindelse med valget (valgfritt)

I tilegg støttes alle egenskaper for kobling mot kodelister.

Konfigurering

Legg til komponent

{
  "id": "municipality",
  "type": "Option",
  "textResourceBindings": {
    "title": "Kommune"
  },
  "value": ["dataModel", "Prefill.MunicipalityNumber"],
  "direction": "vertical",
  "optionsId": "kommuner"
}

Legg til tittel og elementer

`textResourceBindings.title`

Ledetekst for valget. Denne kan legges til som en hardkodet streng eller som en referanse til en tekstressurs. Denne egenskapen brukes for å vise til brukeren hva valget gjelder, ikke hva valget er. Skal man vise frem valgt kommune, kan denne være f.eks. “Kommune” eller “Din kommune”. Selve valget (verdien) hentes fra kodelisten, og vises da som f.eks. “Oslo”.

`textResourceBindings.description`

Beskrivelse for valget. Denne kan legges til som en hardkodet streng eller som en referanse til en tekstressurs.

`textResourceBindings.help`

Hjelpetekst for valget. Denne kan legges til som en hardkodet streng eller som en referanse til en tekstressurs.

`value`

Her spesifiserer man verdien som skal vises frem. Denne må stemme overens med en verdi i kodelisten. Verdien kan også bestemmes ut ifra et dynamisk uttrykk.

`direction`

Bestemmer om valget vises under eller ved siden av ledeteksten. horizontal for ved siden av og vertical for under.