ILLA home page
  1. Interval de timp

Componenta cu rază de timp este o componentă UI care permite utilizatorilor să selecteze un interval de timp de la o interfață de 24 de ore, De obicei folosit în formulare sau interfețe de intrare de date în cazul în care utilizatorul trebuie să specifice un interval de timp și de început.

Atunci când o componentă Time Range este adăugată la pânză, aceasta afișează două interfețe de 24 de ore una lângă alta. O interfață este folosită pentru a selecta ora de pornire, în timp ce cealaltă interfață este folosită pentru a selecta ora de sfârșit. Utilizatorul poate ajusta timpul mutând cursorul mouse-ului sau folosind săgeţile în sus şi în jos.

Properties

Intervalul de timp pentru proprietățile disponibile. JavaScript poate fi scris pentru a citi sau a modifica informații despre componente.

ProprietățiDescriere
Ora de începereValoarea implicită a timpului de pornire al componentei
Ora de încheiereTimpul de sfârșit implicit al componentei
FormatUn șir de format de dată valid. Vezi https://day.js.org/docs/en/parse/string-format.
Începeți substituentulValoarea va fi afișată atunci când câmpul de timp de intrare este gol.
Substituent finalValoarea va fi afișată atunci când câmpul de sfârșit de intrare este gol.
Dimensiune pasdimensiunea pasului în unitate de minute
EtichetăNumele câmpului afişat utilizatorului
LegendăO legendă folosită pentru a descrie câmpul în detaliu
Etichetă ascunsăSetează dacă se afișează eticheta
PozițieSetați poziția etichetei în raport cu componenta
AliniereSetați alinierea (aliniere la stânga sau la dreapta) a etichetei
WidthCând eticheta este pe partea stângă a componentei, setaţi raportul lăţimii etichetei.
Gestionar de evenimenteDeclanșează interogări, controlează componente sau apelează alte API-uri ca răspuns la evenimentele componentei.
DezactivatControlează starea de dezactivare a componentei. Componenta nu poate fi modificată sau focalizată atunci când este dezactivată.
TooltipUtilizatorii pot introduce aici pontul componentei. Sfatul de instrumente va fi afișat când este concentrat. Formatul markdown este acceptat.
Afişare buton ştergerecontrolează dacă în câmpul de intrare este sau nu afișat un buton de ștergere
Câmp obligatoriuValid numai când comutatorul este pornit.
Regulă personalizatăCrează-ți logica validării aici. Regulile ar trebui să fie stabilite în JavaScript și acoperite de {{}}.
Ascunde mesajul de validarePuteți ascunde eroarea prin comutarea stării ascunse atunci când valoarea de intrare este incorectă. Poți schimba dinamic starea ascunsă de JavaScript.
Formular cheie dateSpecificați o cheie a unei componente de împachetare a formei la construirea atributului de date.
HiddenControlează dinamic dacă componenta este ascunsă. Puteți schimba starea ascunsă prin valoarea booleană dinamică.
Culoare temăPermite utilizatorilor să specifice culoarea de fundal şi opacitatea butonului

Methods

Puteţi utiliza alte componente pentru a controla componenta. Sprijinim următoarele două metode:

  • setStartTime

Pentru a seta valoarea datei de începere, de exemplu, {{“value1”}}

ProprietățiDescriere
ValoareIntroducere valoare timp pornire
  • setEndTime

Pentru a seta valoarea datei de încheiere, de exemplu, {{“value2”}}

ProprietățiDescriere
ValoareIntroducere valoare timp
  • clearValue

Pentru a șterge valoarea componentei selectate

  • validate

Pentru a verifica dacă informațiile de intrare sunt legale

  • clearValidate

Pentru a șterge mesajul de validare

Gestionar de evenimente

EvenimentDescriere
SchimbăAtunci când un utilizator schimbă valoarea timpului selectat, efectuează o acțiune specifică personalizată de către utilizatori.

Date

Componenta are niște date utilizate în mod obișnuit, care pot fi apelate prin {{componentName.propertyName}} în aplicație.

Nume proprietateDescriere
culoriculoarea proprietății datei
regulă personalizatăregula personalizată specificată de utilizator
dezactivato valoare Booleană indică starea persoanelor cu handicap
AfișeazăNumenumele acestei componente (ie cascader1)
startTimevaloarea timpului de pornire
endTimevaloare sfârșit timp
startPlaceholdervaloare substituent pentru ora de început
endPlaceholdervaloare substituent pentru ora de sfârșit
evenimenteo valoare Array pentru secvența evenimentelor
Formatformatul datei și orei
formDataKeyFormularul cheie de date al datei
hiddeno valoare Booleană indică starea ascunsă a butonului
hideValidationMesajo valoare Booleană indică dacă mesajul de validare este ascuns
etichetăvaloare etichetă
Alinierealiniere etichetă cascadă (stânga sau dreapta)
Pozitieeticheta casierului (stânga sau dreapta)
Lățime etichetăinteger reprezentând lăţimea etichetei
minutePasulvaloare pas de minut
necesara Valoarea booleană indică starea necesară a intrărilor.
afişareo valoare Boolean indică noi data va fi afișată clar
valoareValoare selectată

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

Utilizare majusculă

Apoi, vom demonstra cum să cartografiem datele de la sursa de date la intervalul de timp şi să setăm valoarea de sfârşit la ora curentă cu un buton.

Pasul 1 Adăugare acţiune

Să creăm un tabel în REST API numit promoteCode, inclusiv 6 coloane: code, id, createdAt, expiredAt, startedAt, updatedAt. Vom folosi începutul și timpul expirat la ora pentru utilizarea eșantionului.

Apoi putem crea o nouă acțiune pentru REST API din lista de acțiuni, enumerând toate datele în promoteCodes și numit restapi1.

Faceţi clic pe Salvează şi Run pentru a activa această acţiune.

Pasul 2 Adaugă Componente

Apoi, putem adăuga o componentă interval de timp şi o componentă button la pânză, Pentru valoarea implicită a timpului de pornire al componentei de interval, folosim startedLa momentul primei promovări a codului din restul datelor API.

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

In mod similar, pentru valoarea implicita a orarului de sfarsit, folosim expiratLa momentul primului cod de promovare din restul datelor API.

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

De asemenea, am etichetat butonul ca “Acum” după cum se arată mai jos.

time_range_0

Pasul 3 Configurarea componentei

Pentru componenta button, o putem configura pentru a seta valoarea dată de sfârșit în componenta interval de timp la data de astăzi.

  1. În gestionarul de editare a evenimentului, selectați Componenta Control în acțiune, selectați componenta interval de timp pe care doriți să o actualizați ca țintă a evenimentului.
  2. Alege setEndTime acţiune şi setează Ora de sfârşit ca {{currentUserInfo.updatedAt}}

time_range_config

Etapa 4 Test

Acum că atunci când faceți clic pe butonul “Acum”, ora finală ar trebui să se schimbe la data de astăzi. În ceea ce privește aici, avem 20:03:05, dar poate fi diferit când îl testați.

time_range_1