ILLA home page
  1. Date Range

DatoRange komponent er en UI komponent som tillater brukere å velge en rekke datoer fra et kalendergrensesnitt, som typisk brukes i form eller innkjøringsgrensesnitt der brukeren trenger å spesifisere en start- og sluttdatointervall.

Når en datointervall-komponent er lagt til lerretet, viser den to kalendergrensesnitt side om side. Én kalendergrensesnitt brukes til å velge startdato, mens den andre brukes til å velge sluttdato. Brukeren kan navigere gjennom kalenderne ved å klikke på forrige eller neste piler for å gå til en annen måned, eller ved å klikke på en bestemt dato for å velge den. De valgte datoene vil vises i inndatafeltene.

Properties

Tilgjengelige egenskaper for datoutvalg JavaScript kan skrives til å lese eller endre informasjon om komponenter.

EgenskaperBeskrivelse
Start datoStartdato for komponenten
Sluttdato forStandardverdien for sluttdato for komponenten
FormatérUgyldig dato format-streng. Se https://day.js.org/docs/en/parse/string-format.
Start plassholderVerdien vil bli vist når startdato i feltet er tomt.
Slutt plassholderVerdien vil bli vist når sluttdato i feltet er tomt.
Maks datoangi maksimal dato som en bruker kan velge fra kalendergrensesnittet.
Min datospesifiser den tidligste datoen som en bruker kan velge fra kalendergrensesnittet.
EtikettNavnet på feltet som vises til brukeren
BildetekstBildetekst som brukes til å beskrive feltet i detalj
Skjult etikettAngi om etiketten skal vises
PosisjonStill plasseringen av etiketten i forhold til komponenten
JusteringSett justeringen (justert til venstre eller høyre) for etiketten
WidthNår etiketten er på venstre side av komponenten, angir du forholdet bredden på etiketten.
ArrangementshåndtererUtløse spørringer, kontroll-komponenter eller ringe andre APIer som respons på komponenthendelser.
DeaktivertKontroller statusen for hvorvidt komponenten er deaktivert. Komponenten kan ikke endres eller fokusert når den er deaktivert.
Kun leseKontroller statusen for om komponenten bare er skrivebeskyttet. En skrivebeskyttet komponent kan velges og fokuseres men kan ikke endres.
VerktøytipsBrukere kan skrive inn komponentens verktøytips her. Verktøytuppen vil bli vist når den er fokusert. Markdown formatet støttes
Vis null-knappkontrollere om en tydelig knapp vises i inntastingsfeltet eller ikke
Obligatorisk feltGyldig bare når bryteren er på.
Egendefinert regelOpprett din valideringslogikk her. Reglene skal gjøres i JavaScript og dekkes av {{}}.
Skjul valideringsmeldingDu kan skjule feilmeldingen ved å bytte den skjulte statusen når inntastingsverdien er feil. Du kan dynamisk endre den skjulte statusen etter JavaScript.
Skjema DatastøkkelAngi en nøkkel til en ‘wrapping form’-komponent når du konstruerer dataattributtet.
HiddenDynamisk kontrollere om komponenten er skjult. Du kan endre skjult status gjennom dynamisk boolsk verdi.
Tema fargeLar brukere angi knappens bakgrunnsfarge og tetthet

Methods

Du kan bruke andre komponenter til å kontrollere komponenten. Vi støtter følgende to metoder:

  • setStartValue

For å angi startdato verdi for eksempel, {{“value1”}}

EgenskaperBeskrivelse
VerdiInput startverdi
  • **setEndverdi

For å angi sluttdatoverdien, for eksempel, {{“value2”}}

EgenskaperBeskrivelse
VerdiInput end value
  • clearValue

For å fjerne verdien for den valgte komponenten

  • validate

For å verifisere at inndatainformasjonen er juridisk

  • clearValidate

For å fjerne valideringsmeldingen

Arrangement behandler

HendelseBeskrivelse
EndreNår en bruker endrer den valgte datoverdien, utfør en spesifikk handling tilpasset av brukerne.

Data

Komponenten har noen vanlig brukte data, som kan kalles via {{componentName.propertyName}} i appen.

Egenskap navnBeskrivelse
colorSchemefargeegenskapen til Datoen
customRegelden egendefinerte regelen som brukeren oppgav
datoformatformatet på dato
deaktiverten Boolsk verdi indikerer status som deaktivert
displayNavnnavnet på denne komponenten (dvs cascader1)
startplassholderplassholderverdi for startdato
endPlaceholderplassholderverdi for sluttdato
hendelseren listeverdi for hendelsessekvensen
formDataKeyformularet datastøkkelen for dato
hiddenen Boolsk verdi indikerer at knappen er gjemt
hideValideringMeldingen Boolsk verdi indikerer om valideringsmeldingen er skjult
etikettetikett verdi
labelJusterjustering av kasseetikett (venstre eller høyre)
etikettposisjonstilling til kasseetikett (venstre eller høyre)
etikettbreddeheltall som representerer bredden på etiketten
skrivebeskytteten Boolsk verdi indikerer klaryKun status for inngang.
obligatorisken Boolsk verdi angir påkrevd status for inngang.
VisRensen Boolsk verdi indikerer wether vil datoen vises klar
verdiValgt verdi

Eksempel: {{dateRange1.value[0]}}

Bruk kasse

Så vil vi vise hvordan vi skal kartlegge dataene fra datakilden til datoperiode og angi en verdi til dagens dato med en knapp.

Trinn 1 Legg til en handling

La oss lage en tabell i REST API kalt promoteCodes , inkludert 6 kolonner: code, id, createdAt, expiredAt, **startedAt, updatedAt. Vi benytter oss av startAt og utløper tid til prøvebruk.

Da kan vi opprette en ny handling for REST API fra handlelisten, som viser alle data i promoteringskoder og navngitt restapi1.

Klikk Lagre og Kjør for å aktivere denne handlingen.

Trinn 2 Legg til komponenter

Deretter kan vi legge til en date range-komponent og en knapp** komponent til lerretet. For standard startdato for datointervall-komponenten, benytter vi startpunktet for første kode fra resten av API-dataene.

{{restapi1.data.promoteCodes[0].startedAt}}

På samme måte er det for standardverdien til sluttdato som vi bruker utløper på tidspunktet for første fremme kode i resten av API-dataene.

{{restapi1.data.promoteCodes[0].expiredAt}}

Vi merket også knappen som ‘Oppdater’ som vist nedenfor.

date_range_0

Trinn 3 Konfigurere komponenten

For den knappen komponenten, kan vi konfigurere den for å sette sluttdato-verdien i dato-intervall komponenten til dagens dato.

  1. I Redigeringshendelsesbehandleren velger du Kontrollkomponent i aksjonen, velg `dato-området ** komponenten du vil oppdatere når målet til hendelsen.
  2. Velg setEndValue handlingen og angi Sluttdato som {{currentUserInfo.updatedAt}}

date_range_config

Trinn 4 Prøving

Nå når du klikker på ‘Oppdater’-knappen, skal sluttdatoen endres til dagens dato. På samme måte som her har vi 2023-5-6, men det kan være noe annerledes når dere tester det.

date_range_1