Gå til hovedinnhold

Når bruker du DatePicker

DatePicker brukes når brukeren skal velge en spesifikk dato, eventuelt med tidspunkt. Komponenten egner seg godt for skjemaer der datoen er en sentral del av flyten, som billettbestilling, bookinger eller rapportering.

DatePicker vs DateField

Bruk DatePicker når brukeren trenger visuell støtte fra en kalender for å velge dato. Bruk DateField alene dersom brukeren kjenner datoen de skal skrive inn (f.eks. fødselsdato), og ikke har behov for kalendervisning.

DatePicker vs NativeDatePicker

Ønsker man en OS-spesifikk opplevelse kan man bruke NativeDatePicker. Denne bruker operativsystemets innebygde datovalg og egner seg best for enkle tilfeller der man ønsker kjent mobilopplevelse.

Dato med tidspunkt

Tidspunkt kan legges til på to måter: enten direkte i DatePicker, eller som en separat TimePicker ved siden av. I løsninger ut mot vanlige sluttbrukere er en separat dato- og tidvelger foretrukket — det gir en tydeligere flyt.

Inline tidspunkt

Separat dato- og tidvelger

Bruk på mobile enheter

På smale skjermer (under 1000px) vises kalenderen i en modal i stedet for en popover, slik at hele datovelgeren alltid er synlig. Denne oppførselen kan slås av — se Utvikling-fanen for detaljer.

Validering

Begrens tilgjengelige datoer slik at brukeren ikke kan velge ugyldige datoer. Du kan sette et tidligste og seneste gyldig dato, eller markere spesifikke datoer som utilgjengelige (f.eks. helger). Gi tydelig tilbakemelding når en ugyldig dato er valgt. Se Utvikling-fanen for ulike valideringsmetoder.

Validering av datoer

Eksemplet viser en validering der helgedager er utilgjengelige.

Velge en periode

Trenger brukeren å velge en periode (fra- og til-dato), bruk RangeCalendar i stedet.

Kun kalender

Ønsker du en alltid synlig kalender uten inputfelt, se Calendar.

Universell utforming

Hvert datosegment er tilgjengelig med tastaturet og alle interagerbare elementer har beskrivelser for skjermlesere. Støtte for universell utforming håndteres automatisk av komponenten.

Ved bruk av andre språk enn norsk og engelsk må du sørge for å sende inn navigasjonsbeskrivelse på riktig språk. Se Utvikling-fanen for hvordan du konfigurerer dette.

Kom i gang

DatePicker bruker @internationalized/date til håndtering av datoobjekter, inkludert tidssoner. Den bygger på react-aria og støtter det meste av funksjonalitet du finner der.

Hjelpefunksjoner fra @internationalized/date (typ. now() og isWeekend()) er ikke inkludert i @entur/datepicker. Legg til @internationalized/date i ditt repo for å bruke dem.

Språk og locale

Språk styres gjennom prop-en locale (BCP 47-format, f.eks. nb-NO). Som default brukes maskinens locale. Ledeteksten (label) og navigationDescription må sendes inn manuelt for andre språk enn norsk og engelsk.

DatePicker tilpasset USA

Datovalidering

Begrens tilgjengelige datoer med minDate og maxDate, eller bruk isDateUnavailable for mer fleksibel validering.

Validering med minDate og maxDate

Validering med isDateUnavailable

Lese ut nåværende datovalidering

Bruk sammen med TimePicker

Inline tidspunkt med granularity

Kombinasjon med TimePicker

NativeDatePicker

Komponentprops

DatePicker

Denne komponenten har ingen props

DateField

Denne komponenten har ingen props

NativeDatePicker

Denne komponenten har ingen props