ILLA home page
  1. Radio gruppe

En radiogruppe, også kendt som en enkeltvalgsgruppe eller blot en radiogruppe er en komponent, der giver brugerne mulighed for kun at vælge én mulighed fra en liste af foruddefinerede indstillinger. Hver indstilling i gruppen er repræsenteret ved en cirkulær knap, der kan vælges eller fravælges af brugere. Når en indstilling er valgt, fravælges enhver tidligere valgt indstilling i gruppen automatisk.

Radiogrupperne er almindeligt anvendte i netformularer, dialogbokse, og andre interaktive applikationer, hvor brugerne har brug for at foretage et enkelt valg fra et sæt af muligheder. De er nyttige for at forhindre fejl, der kan opstå, når brugere vælger flere muligheder ved en fejl eller forvirring. Derudover er radioknapgrupper nemme at bruge og visuelt intuitive, hvilket gør dem til et populært valg for designere og udviklere.

Egenskaber

Manuelle indstillinger

Tilføj nye muligheder eller slet indstillinger manuelt og konfigurere mulighederne én efter én. Egenskaberne for muligheder er som følger:

EgenskaberVarebeskrivelse
EtiketTeksten som vises for indstillingen
VærdiVærdien associeret med indstillingen
DeaktiveretOm indstillingen er deaktiveret for valg

Tilknyttede indstillinger

Du kan også tilføje indstillinger fra en datakilde ved at kortlægge etiket og værdi egenskaber til de tilsvarende datafelter. Du kan få indstillinger dynamisk fra databasen på denne måde. I slutningen af denne artikel vil vi vise, hvordan vi kan bruge den gennem et eksempel.

EgenskaberVarebeskrivelse
DatakildeAngiv datakilden for indstillinger
EtiketBrug {{item}} til at angive etiketten på indstillinger
VærdiBrug {{item}} til at indstille værdien af indstillinger
DeaktiveretBrug {{item}} til at angive, om indstillingen er deaktiveret for valg

Andre 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 justering af etiketten
WidthNår etiketten er på venstre side af komponenten, indstilles breddeforholdet på 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-knapAngiv, om ryd-knappen skal vises
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.
Brugerdefineret regeleditor.inspect.setter_tooltip.custom_rule
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 farveFor at vælge temafarven på komponenten

Metode

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

setValue

For at angive den valgte indstilling, for eksempel, {{”value1”}}

EgenskaberVarebeskrivelse
VærdiValgt værdi

clearValue

For at rydde de valgte indstillinger

validate

At kontrollere, at inputoplysningerne er lovlige

clearValidér

For at rydde valideringsmeddelelsen

Hændelse handler

Vi støtter at lytte til den ‘onChange’ begivenhed i radiogruppen.

Når den valgte indstilling ændres, kan den udløse en specificeret handling. Det betyder, at når en bruger vælger en anden mulighed end en radiogruppe, kan der træffes en særlig foranstaltning baseret på den valgte mulighed. For eksempel i en webformular at vælge en anden mulighed kan udløse visningen af forskellige formularfelter eller indgivelsen af formularen til en anden destination. På denne måde kan den indstilling, der er valgt af brugeren påvirke adfærden af den software eller web-applikation, de bruger. Evnen til at udløse specificerede handlinger baseret på brugerinput er et vigtigt aspekt af interaktivt software design og kan forbedre anvendeligheden og funktionaliteten af softwaren.

Data

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

Egenskabens navnVarebeskrivelse
værdiValgt værdi

Brug case

Dernæst vil vi demonstrere, hvordan man bruger den kortlagte tilstand til dynamisk at opnå muligheder.

Trin 1 Tilføj en handling

Vi har oprettet en tabel med navnet selection, herunder 5 kolonner: options_en, options_jp, options_zh, options_kr, value. Vi lagrede indstillingsværdierne i ‘værdi’ og gemte valgmuligheder etiket på forskellige sprog i andre kolonner.

Opret en handling for at liste alle data i ‘selection’ ved navn ‘postgresql1’

vælg * fra valg

Trin 2 Konfigurér komponenten

  1. Sæt datakilderne til {{postgresql1.data}}

  2. Indstil etiketten til at ændre etiketten baseret på sproget.

    1. Brug {{ item.columnName }} til at angive kolonnen.
    2. Benyt {{ currentUserInfo.language }} til at indstille sprogbrugernes brug i ILLA.
    {{currentUserInfo.language=='ja-JP' ? item.options_jp 
    : currentUserInfo.language == 'ko-KR' ? item.options_kr 
    : currentUserInfo.language == 'zh-CN' ? item.options_zh 
    : item.options_en }}