ILLA home page
  1. Input

Text Inmatningskomponent är ett användargränssnitt element som tillåter användare att ange och redigera text i ett formulär eller inmatningsfält.

Egenskaper

EgenskaperBeskrivning
Förvalt värdeDet initiala värdet av komponenten. Du kan dynamiskt ändra initialvärdet genom att skriva JavaScript i {{}}.
PlatshållareVärdet kommer att visas när inmatningsfältet är tomt.
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.
Visa tydlig knappkontrollera om en tydlig knapp visas i inmatningsfältet
Visa antal teckenkontrollera om antalet tecken i indata visas eller inte
Prefix texten kort text som visas till vänster om inmatningsfältet, ofta används för att ge ytterligare sammanhang eller instruktioner till användaren
Suffix texten kort text som visas till höger om inmatningsfältet, ofta används för att ge ytterligare information eller feedback till användaren
VerktygstipsAnvändare kan ange komponenten verktygstips här. Verktygstipen kommer att visas när den är fokuserad. Markdown format stöds.
Obligatoriskt fältGäller endast när strömbrytaren är aktiverad.
Mönsterange ett reguljärt uttrycksmönster som användarens indata måste matcha för att anses vara giltigt
Max längdange det maximala antalet tecken som kan anges i inmatningsfältet.
Minsta längdange det minsta antalet tecken som användaren måste ange i inmatningsfältet för att inmatningen ska anses giltig.
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

Metod

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

  • setValue

För att ställa in indatavärdet, till exempel, {{‘value1’}}

EgenskaperBeskrivning
VärdeInput value
  • clearValue

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

  • focus

När fokusmetoden kallas, inmatningsfältet kommer att markeras och redo för användaren att börja skriva utan att användaren behöver klicka på inmatningsfältet

Exempel Användning:

Input komponent stöd lyssna på onChange-händelsen av andra komponenter med hjälp av inbyggda händelsesystem. Ställ in det genom att följa dessa exempelsteg:

  1. Lägg till en händelseutlösare till den komponent som du vill lyssna på. Till exempel, om du vill lyssna på onChange händelsen av en radiogruppskomponent, du skulle lägga till en händelsehanterare till den Radio Group komponenten.
  2. I händelsehanteraren Redigera, välj Control component i åtgärd, välj Input komponenten som du vill uppdatera som mål för händelsen.
  3. Välj åtgärden SetValue och välj lämpligt värde för inmatningskomponenten. Detta kommer att vara det värde som inmatningskomponenten har och kommer att uppdatera när händelsen utlöses.
  4. Spara inställningarna för händelsen och upprepa processen för andra komponenter som du vill lyssna på.

När du har konfigurerat händelseutlösarna, kommer indatakomponenten automatiskt att uppdateras när händelsen onChange utlöses på de andra komponenterna. Detta gör att du kan skapa dynamiska gränssnitt som svarar på användarens indata i realtid. göra det enklare för användare att navigera och interagera med din applikation.

Händelsehanterare

HändelseBeskrivning
ÄndraNär en användare ändrar det valda inmatningsvärdet
FokusNär en användare flyttar muspekaren på inmatningskomponenten
BlurNär en användare är klar att mata in värde och sluta fokusera på kaskadkomponenten

Data

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

Egenskapens namnBeskrivning
värdeanvändarens inmatningsvärde
colorSchemebakgrundsfärg på knappen
inaktiveradett booleskt värde anger inaktiverad status
visningsnamnnamnet på denna komponent (dvs knapp1)
formDataKeyformulärdataknappen för inmatning
hiddendold status (sant eller falskt)
etikettetikett värde
etikettJusterajustering av inmatningsetiketten (vänster eller höger)
etikettPositionposition för inmatningsetikett (vänster eller höger)
etikettBreddheltal som representerar bredden av etikett.
maxLängdvärdet av maximal längd
minLängdvärdet av minsta längd
platshållarePlatshållarens värde
prefixTextvärdet av textprefixet
suffixTextvärdet av textsuffix
readOnlyett booleskt värde anger status readyOnly för indata.
obligatoriskett booleskt värde anger status som krävs för inmatning.
regexreguljärt uttryck för indata
showCharacterCountett booleskt värde anger om antalet tecken visas
tooltipTextvärdet av verktygstips text

Exempel: {{input1.value}}

Använd ärende

Nedan följer några exempel för att anpassa inmatningskomponenten.

  • Prefix:

input_prefix

  • Suffix:

input_suffix

  • Verktygstips:

input_tooltip

  • Mönster:

input_pattern