🧬 Sammensatte komponenter
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.
Tilgjengelige egenskaper for datoutvalg JavaScript kan skrives til å lese eller endre informasjon om komponenter.
Egenskaper | Beskrivelse |
---|---|
Start dato | Startdato for komponenten |
Sluttdato for | Standardverdien for sluttdato for komponenten |
Formatér | Ugyldig dato format-streng. Se https://day.js.org/docs/en/parse/string-format. |
Start plassholder | Verdien vil bli vist når startdato i feltet er tomt. |
Slutt plassholder | Verdien vil bli vist når sluttdato i feltet er tomt. |
Maks dato | angi maksimal dato som en bruker kan velge fra kalendergrensesnittet. |
Min dato | spesifiser den tidligste datoen som en bruker kan velge fra kalendergrensesnittet. |
Etikett | Navnet på feltet som vises til brukeren |
Bildetekst | Bildetekst som brukes til å beskrive feltet i detalj |
Skjult etikett | Angi om etiketten skal vises |
Posisjon | Still plasseringen av etiketten i forhold til komponenten |
Justering | Sett justeringen (justert til venstre eller høyre) for etiketten |
Width | Når etiketten er på venstre side av komponenten, angir du forholdet bredden på etiketten. |
Arrangementshåndterer | Utløse spørringer, kontroll-komponenter eller ringe andre APIer som respons på komponenthendelser. |
Deaktivert | Kontroller statusen for hvorvidt komponenten er deaktivert. Komponenten kan ikke endres eller fokusert når den er deaktivert. |
Kun lese | Kontroller statusen for om komponenten bare er skrivebeskyttet. En skrivebeskyttet komponent kan velges og fokuseres men kan ikke endres. |
Verktøytips | Brukere kan skrive inn komponentens verktøytips her. Verktøytuppen vil bli vist når den er fokusert. Markdown formatet støttes |
Vis null-knapp | kontrollere om en tydelig knapp vises i inntastingsfeltet eller ikke |
Obligatorisk felt | Gyldig bare når bryteren er på. |
Egendefinert regel | Opprett din valideringslogikk her. Reglene skal gjøres i JavaScript og dekkes av {{}}. |
Skjul valideringsmelding | Du kan skjule feilmeldingen ved å bytte den skjulte statusen når inntastingsverdien er feil. Du kan dynamisk endre den skjulte statusen etter JavaScript. |
Skjema Datastøkkel | Angi en nøkkel til en ‘wrapping form’-komponent når du konstruerer dataattributtet. |
Hidden | Dynamisk kontrollere om komponenten er skjult. Du kan endre skjult status gjennom dynamisk boolsk verdi. |
Tema farge | Lar brukere angi knappens bakgrunnsfarge og tetthet |
Du kan bruke andre komponenter til å kontrollere komponenten. Vi støtter følgende to metoder:
For å angi startdato verdi for eksempel, {{“value1”}}
Egenskaper | Beskrivelse |
---|---|
Verdi | Input startverdi |
For å angi sluttdatoverdien, for eksempel, {{“value2”}}
Egenskaper | Beskrivelse |
---|---|
Verdi | Input end value |
For å fjerne verdien for den valgte komponenten
For å verifisere at inndatainformasjonen er juridisk
For å fjerne valideringsmeldingen
Hendelse | Beskrivelse |
---|---|
Endre | Når en bruker endrer den valgte datoverdien, utfør en spesifikk handling tilpasset av brukerne. |
Komponenten har noen vanlig brukte data, som kan kalles via {{componentName.propertyName}}
i appen.
Egenskap navn | Beskrivelse |
---|---|
colorScheme | fargeegenskapen til Datoen |
customRegel | den egendefinerte regelen som brukeren oppgav |
datoformat | formatet på dato |
deaktivert | en Boolsk verdi indikerer status som deaktivert |
displayNavn | navnet på denne komponenten (dvs cascader1) |
startplassholder | plassholderverdi for startdato |
endPlaceholder | plassholderverdi for sluttdato |
hendelser | en listeverdi for hendelsessekvensen |
formDataKey | formularet datastøkkelen for dato |
hidden | en Boolsk verdi indikerer at knappen er gjemt |
hideValideringMelding | en Boolsk verdi indikerer om valideringsmeldingen er skjult |
etikett | etikett verdi |
labelJuster | justering av kasseetikett (venstre eller høyre) |
etikettposisjon | stilling til kasseetikett (venstre eller høyre) |
etikettbredde | heltall som representerer bredden på etiketten |
skrivebeskyttet | en Boolsk verdi indikerer klaryKun status for inngang. |
obligatorisk | en Boolsk verdi angir påkrevd status for inngang. |
VisRens | en Boolsk verdi indikerer wether vil datoen vises klar |
verdi | Valgt verdi |
Eksempel: {{dateRange1.value[0]}}
Så vil vi vise hvordan vi skal kartlegge dataene fra datakilden til datoperiode og angi en verdi til dagens dato med en knapp.
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.
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.
For den knappen
komponenten, kan vi konfigurere den for å sette sluttdato-verdien i dato-intervall
komponenten til dagens dato.
Kontrollkomponent
i aksjonen, velg `dato-området ** komponenten du vil oppdatere når målet til hendelsen.setEndValue
handlingen og angi Sluttdato
som {{currentUserInfo.updatedAt}}
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.