Tekstisisendi juhtelement Power Appsis

Kast, kuhu kasutaja saab teksti, numbreid ja muid andmeid tippida.

Kirjeldus

Kasutaja saab määrata andmeid, tippides tekstisisendi juhtelementi. Olenevalt sellest, kuidas rakendust konfigureerite, võidakse need andmed lisada andmeallikasse, mida kasutatakse ajutise väärtuse arvutamiseks või mõnel muul viisil.

Põhiomadused

Vaikimisi – juhtelemendi algväärtus, enne kui kasutaja seda muudab.

Tekst – tekst, mis kuvatakse juhtelemendis või mida kasutaja tipib juhtelementi.

Lisaatribuudid

AccessibleLabel (Juurdepääsusilt) – ekraanilugerite silt.

Align (Joonda) – teksti asukoht seoses juhtelemendi horisontaalse keskpunktiga.

BorderColor (Äärise värv) – juhtelemendi äärise värv.

BorderStyle (Äärise stiil) – kas juhtelemendi ääris on Solid (Tavaline), Dashed (Katkendlik joon), Dotted (Punktiirjoon) või None (Puudub).

BorderThickness (Äärise paksus) – juhtelemendi äärise paksus.

Clear (Selge) – kas tekstisisendi juhtelement näitab "X"-i, et kasutaja saab juhtelemendi sisu tühjendamiseks sellele koputada või klõpsata. Töötab ainult SingleLine režiimis.

Color – juhtelemendi teksti värv.

DelayOutput (Hiline väljund) – kui väärtuseks on seatud tõene, registreeritakse kasutaja sisestus pärast poolesekundilist viivitust. Kasulik, et viivitada kalleid toiminguid kuni kasutaja lõpetab teksti sisestamise (st filtreerimine, kui sisendit kasutatakse teistes valemites).

DisplayMode (Kuva režiim) - kas juhtelement võimaldab kasutajal sisestada (Edit (Redigeeri)), kuvada ainult andmeid (View (Kuva)) või olla keelatud (Disabled (Keelatud)).

DisabledBorderColor (Keelatud äärise värv) – juhtelemendi äärise värv, kui selle juhtelemendi atribuudi DisplayMode (Kuva režiim) väärtuseks on määratud Disabled (Keelatud).

Keelatud värv – juhtelemendi teksti värv, kui selle atribuudi Kuva režiim väärtuseks on määratud Disabled (Keelatud).

Keelatud täitevärv – juhtelemendi taustavärv, kui selle atribuudi Kuva režiim väärtuseks on määratud Disabled (Keelatud).

EnableSpellCheck (Luba õigekirjakontroll) – kas tekstisisendi juhtelement peaks kasutama brauseri õigekirjakontrolli funktsiooni. Windows Power Apps ei toeta seda atribuuti.

Fill (Taust) – juhtelemendi taustavärv.

FocusedBorderColor (Fokuseeritud äärise värv) – juhtelemendi äärise värv, kui juhtelement on fokuseeritud.

FocusedBorderThickness (Fokuseeritud äärise paksus) – juhtelemendi äärise paksus, kui juhtelement on fokuseeritud.

Font – fontide perekonna nimi, milles tekst kuvatakse.

Fondi paksus – juhtelemendi teksti paksus: Bold (Paks), Semibold (Poolpaks), Normal (Tavaline) või Lighter (Õhem).

Format (Vorming) – kas kasutaja sisend on piiratud ainult numbritega või võib olla suvaline tekst. Kui see on seatud väärtusele Number, saab sisestada ainult numbreid ja teatud numbrilisi sümboleid. Toetatud sümbolid ja vormingud sõltuvad brauseri keelest ja neid ei saa määrata üksikutele juhtelementidele.

Height (Kõrgus) – Juhtelemendi ülemiste ja alumiste servade vaheline kaugus.

HintText (Vihjetekst) – helehall tekst, mis kuvatakse tekstisisendi juhtelemendis, kui see on tühi.

HoverBorderColor (Hõljumise äärise värv) – juhtelemendi äärise värv, kui kasutaja hoiab vastaval juhtelemendil hiirekursorit.

Hõljumisevärv – juhtelemendi teksti värv, kui kasutaja hoiab sellel hiirekursorit.

Hõljumise taustavärv – juhtelemendi taustavärv, kui kasutaja hoiab sellel hiirekursorit.

Kursiiv – kas juhtelemendi tekst on kursiivis.

LineHeight (Teksti kõrgus) – vahemaa näiteks teksti või loendi üksuste vahel.

MaxLength (Maksimaalne pikkus) – märkide arv, mida kasutaja saab tekstisisendi juhtelementi tippida.

Mode (Režiim) – juhtelement on režiimis SingleLine (Üks rida), MultiLine (Mitmerealine) või Password (Parool) režiimis.

OnChange – toimingud, mis sooritatakse juhul, kui kasutaja muudab juhtelemendi väärtust (nt liuguri väärtust muutes).

OnSelect – toimingud, mida sooritatakse juhul, kui kasutaja klõpsab juhtelemendil.

PaddingBottom – vahemaa juhtelemendi teksti ja juhtelemendi alumise serva vahel.

Vasak vahe – vahemaa juhtelemendi teksti ja juhtelemendi vasaku serva vahel.

Parem vahe – vahemaa juhtelemendi teksti ja juhtelemendi parema serva vahel.

Ülemine vahe – vahemaa juhtelemendi teksti ja juhtelemendi ülemise serva vahel.

PressedBorderColor (Äärise värv vajutamisel) – juhtelemendi äärise värv, kui kasutaja klõpsab või koputab seda.

Vajutamisvärv – juhtelemendi teksti värv, kui kasutaja klõpsab või vajutab sellel.

Taustavärv vajutamisel – juhtelemendi taustavärv, kui kasutaja klõpsab või vajutab sellel.

RadiusBottomLeft – arv, milleni juhtelemendi alumine vasakpoolne nurk on ümardatud.

RadiusBottomRight – arv, milleni juhtelemendi alumine parempoolne nurk on ümardatud.

RadiusTopLeft – arv, milleni juhtelemendi ülemine vasakpoolne nurk on ümardatud.

RadiusTopRight – arv, milleni juhtelemendi ülemine parempoolne nurk on ümardatud.

Reset (Lähtesta) – kas juhtelement taastab algväärtuse.

Suurus – juhtelemendis kuvatava teksti fondi suurus.

Läbikriipsutus – kas juhtelemendis kuvatavat teksti läbib kriips.

TabIndex – klaviatuuri navigeerimise järjekord võrreldes teiste juhtelementidega.

Tooltip (Tööriistavihje) – selgitav tekst, mis kuvatakse, kui kasutaja liigub kursoriga üle juhtelemendi.

Allakriipsutus – kas juhtelemendis kuvatav tekst on allajoonitud.

VirtualKeyboardMode (Virtuaalse klaviatuuri režiim) – virtuaalse klaviatuuri tüüp (tekstiline või numbriline), mis kuvatakse rakenduse kasutaja puutetundlikul ekraanil. Atribuut Format (Vorming) määrab vaikimisi väärtuse. Seadme tugi on erinev. Töötavatel iOS seadmetel peab olema vähemalt versioon 12.2. Soovitatav operatsioonisüsteemi versioon Android seadmetel on 9.0 ja numbriliste klaviatuuride võimalused sõltuvad Android seadmetest. Windows 10 ei toeta seda atribuuti.

Visible (Nähtav) – kas juhtelement on nähtav või peidetud.

Width (Laius) – vahemaa juhtelemendi vasaku ja parema serva vahel.

X – vahemaa juhtelemendi vasaku serva ja vanemkonteineri vasaku serva vahel (ekraan, kui vanemkonteinerit pole).

Y – vahemaa juhtelemendi ülemise serva ja vanemkonteineri ülemise serva vahel (ekraan, kui vanemkonteinerit pole).

Seotud funktsioonid

DateTimeValue( String )

Näited

Andmete kogumine

1. Lisage kaks tekstisisendi juhtelementi ja nimetage need inputFirst (Esimene sisend) ja InputLast (Viimane sisend).

   Kuidas lisada, nimetada ja konfigureerida juhtelementi?

2. Lisage nupp, määrake selle atribuudi Text (Tekst) väärtuseks Add (Lisa) ja seadke selle atribuut OnSelect (Valimisel) valemile.
   Collect(Names, {FirstName:inputFirst.Text, LastName:inputLast.Text})

   Kas soovite lisateavet funktsiooni Collect või other functions kohta?

3. Lisage vertikaalpaigutusega tekstigalerii, määrake selle atribuudi Items (Üksused) väärtuseks Names (Nimed) ja seadke Subtitle1 atribuudi Text (Tekst) väärtuseks ThisItem.FirstName.

4. (valikuline) Kustutage malli galerii alumine silt nimega Body1 ja seadke galerii atribuudi TemplateSize (Malli suurus) väärtuseks 80.

5. Vajutage klahvi F5, tippige tekstisõne valikusse inputFirst (Esimene sisend) ja inputLast (Viimane sisend) ja seejärel klõpsake või koputage nuppu Add (Lisa).

6. (valikuline) Lisage kogumisse rohkem nimesid ja vajutage seejärel vaike-tööruumi naasmiseks paoklahvi (ESC).

Küsi parooli

1. Lisage tekstisisendi juhtelement, nimetage see inputPassword (Sisendi parool) ja seadke selle atribuudi Mode (Režiim) väärtuseks Password (Parool).

2. Lisage silt ja määrake atribuut Tekst järgmisele valemile.
   If(inputPassword.Text = "P@ssw0rd", "Juurdepääs antud", "Juurdepääs keelatud")

   Kas soovite lisateavet funktsiooni If (Kui) või muud funktsioonid kohta?

3. Vajutage klahvi F5 ja tippige P@ssw0rd suvandisse inputPassword (Sisendi parool).

   Kui olete parooli tippimise lõpetanud, siis silt lõpetab Access denied (Juurdepääs keelatud) kuvamise ja kuvab hoopis Access granted (Juurdepääs antud).

4. Vajutage vaike-tööruumi naasmiseks paoklahvi (ESC).

5. (valikuline) Lisage juhtelement (nt nool), konfigureerige see liikumine mõnele teisele kuvale ja kuvage see alles pärast seda, kui kasutaja on parooli sisestanud.

6. (valikuline) Lisage nupp, konfigureerige selle atribuut Text (Tekst), et kuvada Sign in (Logi sisse), lisage taimer ja keelake tekstisisendi juhtelement teatud aja jooksul kui kasutaja tipib vale parooli ja seejärel klõpsab või koputab nuppu Sign in (Logi sisse).

Hõlbustusfunktsioonide suunised

Värvi kontrastsus

• Rakendatakse standardseid värvilisi kontrasti nõudeid.

Ekraanilugeja tugi

• AccessibleLabel (Juurdepääsusilt) peab olema defineeritud.

Klaviatuuri tugi

• TabIndex väärtus peab olema null või suurem, et klaviatuuri kasutajad saaksid sellele liikuda.
• Fookuse indikaatorid peavad olema selgelt nähtavad. Selle saavutamiseks kasutage FocusedBorderColor (Fookustatud äärise värv) ja FocusedBorderThickness (Fookustatud äärise paksus).