ILLA home page
  1. Tidsintervall

Tidsintervall komponent er en UI komponent som lar brukere velge et intervall fra et 24-timers grensesnitt, som vanligvis brukes i form eller innkjøringsgrensesnitt der brukeren trenger å spesifisere en start- og sluttidsperiode.

Når en tidsperiode-komponent er lagt til lerretet, viser den to 24-timers grensesnitt side om side. Ett grensesnitt brukes til å velge starttid, mens den andre brukes til å velge slutttiden. Brukeren kan justere tiden ved å bevege musepekeren eller ved å bruke pilene opp og ned.

Properties

Tidsintervall er tilgjengelige egenskaper. JavaScript kan skrives til å lese eller endre informasjon om komponenter.

EgenskaperBeskrivelse
Start tidspunktStandard starttidsverdi for komponenten
Slutt tidStandard slutttidsverdien for komponenten
FormatérUgyldig dato format-streng. Se https://day.js.org/docs/en/parse/string-format.
Start plassholderVerdien vil bli vist når starttiden inntastingsfeltet er tom.
Slutt plassholderVerdien vil bli vist når slutttids-feltet i feltet er tomt.
Størrelse på stegtrinnets størrelse i enhet av minutter
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.
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:

  • setStartTime

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

EgenskaperBeskrivelse
VerdiInndata start tidsverdi
  • setEndTime

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

EgenskaperBeskrivelse
VerdiInndata sluttverdi
  • 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 tidsverdien, 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
deaktiverten Boolsk verdi indikerer status som deaktivert
displayNavnnavnet på denne komponenten (dvs cascader1)
startTimestart tidsverdi
endTimeslutt tidsverdi
startplassholderplassholderverdi for starttid
endPlaceholderplassholderverdi for slutttid
hendelseren listeverdi for hendelsessekvensen
formatformatet på dato og klokkeslett
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
minuttTrinnSteg størrelse på minutt
obligatorisken Boolsk verdi angir påkrevd status for inngang.
VisRensen Boolsk verdi indikerer wether vil datoen vises klar
verdiValgt verdi

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

Bruk kasse

Så vil vi vise hvordan vi skal kartlegge data fra datakilden til tidsrom og sette sluttverdi til gjeldende klokkeslett 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 tidstere-komponent og en knapp** komponent til lerretet. For standard starttid for datointervall-komponenten, bruker vi startskuddet for første kode fra resten av API-dataene.

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

På samme måte er det for standard sluttverdi vi bruker utløper på tidspunktet for første fremme kode fra resten av API-dataene.

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

Vi merket også knappen som “Nå” som vist nedenfor.

time_range_0

Trinn 3 Konfigurere komponenten

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

  1. I Redigeringshendelsesbehandleren velger du Kontrollkomponent i aksjonen, velg time range komponenten du vil oppdatere når målet til hendelsen.
  2. Velg setEndTime handlingen og sett Slutttid som {{currentUserInfo.updatedAt}}

time_range_config

Trinn 4 Prøving

Nå som når du klikker på “Nå”-knappen, skal sluttiden endres til dagens dato. Her har vi derimot 20:03:05, men det kan være annerledes når man tester det.

time_range_1