Altinn Studio V9 (preview) Utvikle tjenester Utforming Komponenter Checkboxes

Preview: Dette er dokumentasjonen for Altinn Studio v9, som er en forhåndsversjon. Gjeldende versjon er v8. For å se dokumentasjonen for gjeldende versjon, velg v8 i versjonsvelgeren i menyen til venstre.

Checkboxes

Egenskaper

Komponenten støtter også de [felles komponentegenskapene](../common-properties/).

type Påkrevd Type: "Checkboxes"

Angir hvilken komponenttype konfigurasjonen gjelder.

readOnly Valgfri Standardverdi: false Type: boolean | expression<boolean>

Boolsk verdi eller uttrykk som angir om komponenten skal være skrivebeskyttet eller deaktivert. Selv skrivebeskyttede felt kan foreløpig endres ved å manipulere API-kallet.

required Valgfri Standardverdi: false Type: boolean | expression<boolean>

Boolsk verdi eller uttrykk som angir om komponenten skal være påkrevd.

Liste over valideringstypene som skal vises.

optionsId Valgfri Type: string

ID-en til listen med alternativer som skal hentes fra serveren.

queryParameters Valgfri Type: object

Kobler parametere i spørringsstrengen til verdier. Parameterne legges til URL-en når alternativer hentes. Andre egenskapsnavn er tillatt. Verditype: string | expression<string>.

options Valgfri Type: object[]

Liste over statiske alternativer.

options[].label Påkrevd Type: string

Teksten som vises for alternativet.

options[].value Påkrevd Type: string | number | boolean | null

Verdien som lagres når alternativet velges.

options[].description Valgfri Type: string

Utfyllende tekst som vises med alternativet.

options[].helpText Valgfri Type: string

Hjelpetekst for alternativet.

secure Valgfri Standardverdi: false Type: boolean

Angir om det sikre API-endepunktet skal brukes når alternativer hentes fra serveren.

sortOrder Valgfri Type: "asc" | "desc"

Sorterer kodelisten stigende eller synkende etter ledetekst. Tillatte verdier: "asc", "desc".

source Valgfri Type: object

Henter alternativer fra en repeterende gruppestruktur i datamodellen.

source.dataType Valgfri Type: string

Datamodellen der dataene til den repeterende gruppen lagres. Hvis den ikke er angitt, brukes datamodellen fra layout-settet.

source.group Påkrevd Type: string

Den repeterende gruppen som alternativene skal bygges fra.

source.label Påkrevd Type: string | expression<string>

Ledetekst for alternativet som vises i grupper med radioknapper og avkrysningsbokser. Kan være ren tekst, en tekstressursbinding eller et dynamisk uttrykk.

source.value Påkrevd Type: string

Feltet i gruppen som skal brukes som verdi.

source.description Valgfri Type: string | expression<string>

Beskrivelse av alternativet som vises i grupper med radioknapper og avkrysningsbokser. Kan være ren tekst, en tekstressursbinding eller et dynamisk uttrykk.

source.helpText Valgfri Type: string | expression<string>

Hjelpetekst for alternativet som vises i grupper med radioknapper og avkrysningsbokser. Kan være ren tekst, en tekstressursbinding eller et dynamisk uttrykk.

optionFilter Valgfri Standardverdi: true Type: boolean | expression<boolean>

Filtrerer listen med alternativer ved hjelp av et uttrykk. Uttrykket skal returnere true for å beholde alternativet og false for å fjerne det. Bruk ["value"] for verdien og ["value", "label"] for tekstressurs-ID-en. Tilsvarende gjelder «description» og «helpText».

preselectedOptionIndex Valgfri Type: integer

Indeksen til alternativet som skal være forhåndsvalgt når brukeren ikke har valgt noe.

labelSettings Valgfri Type: object

Styrer hvordan ledeteksten til komponenten vises.

labelSettings.optionalIndicator Valgfri Standardverdi: true Type: boolean

Viser en markering for valgfrie felt ved ledeteksten. Aktivert som standard.

textResourceBindings Valgfri Type: object

Kobler tekstene i komponenten til tekstressurser eller uttrykk.

textResourceBindings.tableTitle Valgfri Type: string | expression<string>

Tittelen som vises i tabellvisningen. Overstyrer den vanlige tittelen.

textResourceBindings.shortName Valgfri Type: string | expression<string>

Alternativt navn i valideringsmeldinger for påkrevde felt. Overstyrer den vanlige tittelen.

textResourceBindings.requiredValidation Valgfri Type: string | expression<string>

Hele valideringsmeldingen som vises når komponenten er påkrevd og mangler verdi. Overstyrer både standardmeldingen og kortnavnet.

textResourceBindings.summaryTitle Valgfri Type: string | expression<string>

Tittelen som vises i oppsummeringen. Overstyrer den vanlige tittelen.

textResourceBindings.summaryAccessibleTitle Valgfri Type: string | expression<string>

Tittelen som brukes i aria-label på redigeringsknappen i oppsummeringen. Overstyrer både den vanlige tittelen og oppsummeringstittelen.

textResourceBindings.title Valgfri Type: string | expression<string>

Ledeteksten eller tittelen som vises over komponenten.

textResourceBindings.description Valgfri Type: string | expression<string>

Beskrivelsen som vises mellom ledeteksten og komponenten.

textResourceBindings.help Valgfri Type: string | expression<string>

Hjelpeteksten som vises når brukeren åpner hjelpeknappen.

renderAsSummary Valgfri Standardverdi: false Type: boolean

Angir om komponenten skal vises som en oppsummering.

forceShowInSummary Valgfri Standardverdi: false Type: boolean | expression<boolean>

Tvinger komponenten til å vises i en oppsummering selv om hideEmptyFields er true i oppsummeringskomponenten.

removeWhenHidden Valgfri Standardverdi: true Type: boolean | expression<boolean>

Overstyrer oppryddingen av data for skjulte komponenter ved slutten av oppgaven.

dataModelBindings Påkrevd Type: object

Kobler verdiene i komponenten til felter i datamodellen.

dataModelBindings.simpleBinding Påkrevd Type: datamodellbinding

Angir hvor i datamodellen komponenten skal lagre verdiene. Slik bruker du datamodellbindinger.

dataModelBindings.label Valgfri Type: datamodellbinding

Angir hvor i datamodellen de oversatte ledetekstene skal lagres. Må peke på en streng for enkeltvalg eller en liste med strenger for flervalg. Med gruppebinding må den peke på en streng i hver rad. Slik bruker du datamodellbindinger.

dataModelBindings.metadata Valgfri Type: datamodellbinding

Angir hvor i datamodellen metadata for valg skal lagres. Må peke på en streng. Slik bruker du datamodellbindinger.

dataModelBindings.group Valgfri Type: datamodellbinding

Plassering i punktnotasjon for den repeterende strukturen der verdiene fra avkryssede bokser skal lagres. Slik bruker du datamodellbindinger.

dataModelBindings.checked Valgfri Type: datamodellbinding

Hvis deletionStrategy er soft og group er satt, peker verdien til feltet der slettestatusen skal lagres. Slik bruker du datamodellbindinger.

deletionStrategy Valgfri Type: "soft" | "hard"

Tillatte verdier: "soft", "hard".

layout Valgfri Type: "column" | "row" | "table"

Angir hvordan alternativene skal plasseres. Tillatte verdier: "column", "row", "table".

showLabelsInTable Valgfri Standardverdi: false Type: boolean

Angir om ledeteksten skal vises når tabellen bare har ett alternativ.

alertOnChange Valgfri Standardverdi: false Type: boolean | expression<boolean>

Angir om komponenten skal varsle ved endringer.