ILLA home page
  1. Date Range

Datum Range komponent är en UI-komponent som tillåter användare att välja ett antal datum från ett kalendergränssnitt, vanligtvis används i formulär eller datainmatningsgränssnitt där användaren behöver ange ett start- och slutdatumintervall.

När en datumintervall komponent läggs till i duk, visar det två kalendergränssnitt sida vid sida. Ett kalendergränssnitt används för att välja startdatum medan den andra används för att välja slutdatum. Användaren kan navigera genom kalendrarna genom att klicka på föregående eller nästa pilar för att flytta till en annan månad, eller genom att klicka på ett specifikt datum för att välja det. De valda datumen kommer att visas i inmatningsfälten.

Properties

Datumintervall tillgängliga fastigheter. JavaScript kan skrivas för att läsa eller ändra information om komponenter.

EgenskaperBeskrivning
StartdatumStandardvärdet för startdatumet för komponenten
SlutdatumStandardvärdet för slutdatumet för komponenten
FormateraEn giltig datumformatsträng. Se https://day.js.org/docs/sv/parse/string-format.
Starta platshållareVärdet kommer att visas när fältet för startdatum är tomt.
Slut platshållareVärdet kommer att visas när fältet för slutdatum är tomt.
Max datumange det högsta datum som en användare kan välja från kalendergränssnittet.
Minsta datumange det tidigaste datum som en användare kan välja från kalendergränssnittet.
EtikettNamnet på fältet som visas för användaren
BildtextEn text som används för att beskriva fältet i detalj
Dold etikettAnge om etiketten ska visas
BefattningStäll in positionen för etiketten i förhållande till komponenten
JusteringAnge justering (anpassa till vänster eller höger) på etiketten
WidthNär etiketten är på vänster sida av komponenten, ställ in breddförhållandet på etiketten.
HändelsehanterareUtlösa frågor, styra komponenter, eller ringa andra API:er som svar på komponenthändelser.
InaktiveradKontrollera status för om komponenten är inaktiverad. Komponenten kan inte ändras eller fokuseras när den är inaktiverad.
Läs endastKontrollera status på om komponenten är skrivskyddad. En skrivskyddad komponent kan väljas och fokuseras men kan inte ändras.
VerktygstipsAnvändare kan ange komponenten verktygstips här. Verktygstipen kommer att visas när den är fokuserad. Markdown format stöds.
Visa tydlig knappkontrollera om en tydlig knapp visas i inmatningsfältet
Obligatoriskt fältGäller endast när strömbrytaren är aktiverad.
Anpassad regelSkapa din valideringslogik här. Reglerna ska göras i JavaScript och omfattas av {{}}.
Dölj valideringsmeddelandeDu kan dölja felmeddelandet genom att byta dold status när inmatningsvärdet är felaktigt. Du kan dynamiskt ändra den dolda statusen med JavaScript.
Formulär dataknappAnge en nyckel till en omslagningsformulärkomponent när du konstruerar data-attributet.
HiddenStyr dynamiskt om komponenten är dold. Du kan ändra den dolda statusen genom dynamiskt booleskt värde.
Tema färgTillåter användare att ange knappens bakgrundsfärg och opacitet

Methods

Du kan använda andra komponenter för att styra komponenten. Vi stöder följande två metoder:

  • setStartValue

För att ställa in startdatumets värde, till exempel, {{“value1”}}

EgenskaperBeskrivning
VärdeInmatning startvärde
  • setEndValue

För att ange slutdatumets värde, till exempel, {{“value2”}}

EgenskaperBeskrivning
VärdeInput end value
  • clearValue

För att rensa värdet på den valda komponenten

  • validate

För att verifiera att indata informationen är laglig

  • clearValidate

Rensa valideringsmeddelandet

Händelsehanterare

HändelseBeskrivning
ÄndraNär en användare ändrar det valda datumvärdet, utför specifika åtgärder som anpassats av användare.

Data

Komponenten har några vanliga data, som kan anropas via {{componentName.propertyName}} i appen.

Egenskapens namnBeskrivning
colorSchemefärgen egenskap av datum
standardregelden anpassade regeln som användaren angav
datumformatformatet av datum
inaktiveradett booleskt värde anger inaktiverad status
visningsnamnnamnet på denna komponent (dvs cascader1)
startplatshållarePlatshållarens värde för startdatum
endPlaceholderPlatshållarens värde för slutdatum
händelserett Array värde för sekvens av händelser
formDataKeyformulärdataknappen för datum
hiddenett booleskt värde anger den dolda statusen för knappen
Göm valideringsmeddelandeett booleskt värde anger om valideringsmeddelandet är dolt
etikettetikett värde
etikettJusterajustering av kaskader etikett (vänster eller höger)
etikettPositionposition för kaskader etikett (vänster eller höger)
etikettBreddheltal som representerar bredden på etiketten
readOnlyett booleskt värde anger status readyOnly för indata.
obligatoriskett booleskt värde anger status som krävs för inmatning.
visaRensaett booleskt värde anger om datumet kommer att visas tydligt
värdeValt värde

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

Använd ärende

Därefter kommer vi att visa hur man kartlägger data från datakällan till datumintervall och ställa in slutvärdet till dagens datum med en knapp.

Steg 1 Lägg till en åtgärd

Låt oss skapa en tabell i REST API som heter promoteCodes, inklusive 6 kolumner: code, id, createdAt, expiredAt, startedAt, updatedAt. Vi kommer att använda startedAt och utgångenAt tid för provanvändning.

Sedan kan vi skapa en ny åtgärd för REST API från åtgärdslistan, listar alla data i promoteCodes och heter restapi1.

Klicka på Save och Run för att aktivera denna åtgärd.

Steg 2 Lägg till komponenter

Därefter kan vi addera en date range komponent och en button komponent till duken. För standardvärdet för startdatumet för datumintervall komponent, använder vi den startadeVid tidpunkten för den första befordra koden från resten api data.

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

På samma sätt, för standard slutdatum värde, använder vi utgångna Vid tidpunkten för den första befordra koden från resten api data.

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

Vi har också märkt knappen som “Uppdatera” som visas nedan.

date_range_0

Steg 3 Konfigurera komponenten

För button komponenten kan vi konfigurera det så att värdet för slutdatum i date range komponent till dagens datum.

  1. I händelsehanteraren Redigera, välj Control component i åtgärd, Välj date range komponenten som du vill uppdatera som mål för händelsen.
  2. Välj setEndValue åtgärden och ställ in End date som {{currentUserInfo.updatedAt}}

date_range_config

Steg 4 Test

Nu när du klickar på knappen “Uppdatera” bör slutdatumet ändras till dagens datum. När det gäller här har vi 2023-5-6 men det kan vara annorlunda när du testar den.

date_range_1