ILLA home page
  1. Input

Tekst Input komponent er et brugergrænseflade element, der giver brugerne mulighed for at indtaste og redigere tekst i en form eller input felt.

Egenskaber

EgenskaberVarebeskrivelse
Standard værdiDen oprindelige værdi af komponenten. Du kan dynamisk ændre startværdien ved at skrive JavaScript i {{}}.
PladsholderVærdien vil blive vist når inputfeltet er tomt.
EtiketNavnet på det felt, der vises til brugeren
BilledtekstEn billedtekst der bruges til at beskrive feltet i detaljer
Skjult etiketAngiv, om etiketten skal vises
PlaceringSæt placeringen af etiketten relativt til komponenten
JusteringIndstil justeringen (indstil til venstre eller højre) af etiketten
WidthNår etiketten er på venstre side af komponenten, indstilles breddeforholdet for etiketten.
BegivenhedshåndteringUdløs forespørgsler, styrekomponenter eller ring til andre API’er som svar på komponenthændelser.
DeaktiveretKontroller status for, om komponenten er deaktiveret. Komponenten kan ikke ændres eller fokuseres, når den er deaktiveret.
Kun LæsKontrollere status for, om komponenten er skrivebeskyttet. En skrivebeskyttet komponent kan vælges og fokuseres, men kan ikke ændres.
Vis ryd-knapkontrollere, om en klar knap vises i inputfeltet
Vis karakter antalstyre, om tegnoptællingen for input vises eller ej
Præfiks tekstet kort stykke tekst, der vises til venstre for inputfeltet, ofte brugt til at give yderligere kontekst eller instruktioner til brugeren
Suffiks teksten kort tekst, der vises til højre for inputfeltet, ofte brugt til at give yderligere oplysninger eller feedback til brugeren
VærktøjstipBrugere kan indtaste komponentværktøjstip her. Værktøjsvink vil blive vist når den er fokuseret. Markdown format er understøttet.
Obligatorisk feltGyldig kun, når kontakten er tændt.
Mønsterangive et regulært udtryksmønster, som brugerens input skal matche for at blive betragtet som gyldigt
Maks. længdesæt det maksimale antal tegn, der kan indtastes i indtastningsfeltet.
Min. Længdeangive det mindste antal tegn, som brugeren skal indtaste i inputfeltet for at inputtet kan betragtes som gyldigt.
Brugerdefineret regelOpret din valideringslogik her. Reglerne skal laves i JavaScript og dækket af {{}}.
Skjul valideringsbeskedDu kan skjule fejlmeddelelsen ved at skifte den skjulte status, når inputværdien er forkert. Du kan dynamisk ændre den skjulte status af JavaScript.
Formular DatanøgleAngiv en nøgle til en ombrydningsformularkomponent, når du konstruerer dataattributten.
HiddenStyr dynamisk om komponenten er skjult. Du kan ændre den skjulte status gennem dynamisk boolesk værdi.
Tema FarveTillader brugere at angive knappens baggrundsfarve og gennemsigtighed

Metode

Du kan bruge andre komponenter til at styre komponenten. Vi støtter følgende to metoder:

  • setValue

For at indstille inputværdien, for eksempel, {{‘value1’}}

EgenskaberVarebeskrivelse
VærdiInput value
  • clearValue

For at rydde værdien af den valgte komponent

  • focus

Når fokusmetoden kaldes, inputfeltet vil blive fremhævet og klar for brugeren at begynde at skrive uden at brugeren skal klikke på inputfeltet

Eksempel Anvendelse:

Input komponent støtte lytte til onChange begivenhed af andre komponenter ved hjælp af indbygget begivenhed system. Opsæt den ved at følge disse eksempel trin:

  1. Tilføj en begivenhedsudløser til den komponent, du vil lytte til. For eksempel, hvis du ønsker at lytte til den onChange begivenhed af en Radio Group komponent, du vil tilføje en hændelsesbehandler til den Radio Group komponent.
  2. Vælg Kontrolkomponent i aktionen i hændelseshåndteringen, vælg den Input-komponent, som du ønsker at opdatere som mål for hændelsen.
  3. Vælg handlingen SetValue og vælg den relevante værdi for inputkomponenten. Dette vil være den værdi, som inputkomponenten har, og vil opdatere, når begivenheden udløses.
  4. Gem indstillingerne for event trigger og gentag processen for alle andre komponenter, som du ønsker at lytte til.

Når du har konfigureret begivenheden udløser, opdateres inputkomponenten automatisk, når onChange begivenheden udløses på de andre komponenter. Dette giver dig mulighed for at oprette dynamiske grænseflader, der reagerer på brugerinput i realtid, gør det lettere for brugerne at navigere og interagere med din applikation.

Hændelse handler

BegivenhedVarebeskrivelse
SkiftNår en bruger ændrer den valgte inputværdi
FokusNår en bruger flytter musemarkøren på inputkomponenten
BlurNår en bruger er færdig input værdi og holde op fra at fokusere på kaskadekomponenten

Data

Komponenten har nogle almindeligt anvendte data, som kan kaldes via {{componentName.propertyName}} i appen.

Egenskabens navnVarebeskrivelse
værdibruger input værdi
colorSchemebaggrundsfarve på knappen
deaktivereten boolsk værdi angiver den deaktiverede status
displayNamenavnet på denne komponent (dvs. knap1)
formDataKeyFormularens datakast for input
hiddenskjult status (sand eller falsk)
etiketetiket værdi
labelAlignjustering af inputetiket (venstre eller højre)
labelPositionplacering af inputetiket (venstre eller højre)
labelBreddedet heltal, der repræsenterer mærkets bredde.
maxLængdeværdien af den maksimale længde
minLængdeværdien af mindste længde
pladsholderpladsholderens værdi
prefixTextværdi af tekstpræfikset
suffixTextværdi af tekstsuffikset
skrivebeskytteten boolsk værdi angiver readyOnly status for input.
påkræveten boolsk værdi angiver den krævede status for input.
regexregulært udtryk for input
showCharacterCounten boolsk værdi angiver, om antallet af tegn på input vises
tooltipTextværdi af tooltip tekst

Eksempel: {{input1.value}}

Brug case

Nedenfor er nogle eksempler til tilpasning af input komponent.

  • Præfiks:

input_prefix

  • Suffiks:

input_suffix

  • Værktøjstip:

input_tooltip

  • Mønster:

input_pattern