Kontrolnik »Kartica« v aplikaciji Power Apps
Omogoča prikaz in urejanje izkušenj za posamezno polje kontrolnika Display form ali Edit form.
Opis
Kontrolnika Display form in Edit form delujeta kot vsebnika za prikaz in ogled zapisov v celoti. Vsak vsebnik lahko vsebuje nabor kontrolnikov Kartica, ki prikazujejo posamezna polja ali omogočajo posodobitev teh polj. Vsaka kartica ima lastnost DataField, ki določa polje zapisa, za katerega deluje.
Vnaprej določene kartice so določene za različne vrste podatkov in uporabniških izkušenj. Obstaja lahko na primer kartica za urejanje številčnega polja s kontrolnikom Text input, ki je odličen za uporabo s tipkovnico. Druga kartica morda podpira urejanje številke z uporabo kontrolnika Slider. Ko ste izbrali kontrolnik obrazca, lahko v desnem podoknu enostavno izberete kartico na podlagi polja.
Kartice vsebujejo kontrolnike same po sebi. Kontrolniki kartice so sestavni del izkušnje za prikaz in urejanje posameznega polja. Številčna kartica lahko na primer vsebuje kontrolnik Label, ki zagotavlja prikazno ime polja, in kontrolnik Text input, ki zagotavlja urejevalnik za vrednost polja. Kartica ima lahko tudi kontrolnik Label, ki prikazuje morebitne napake pri preverjanju veljavnosti in kontrolnik Label za vsa polja z zvezdico, ki označuje obvezno polje.
Kontrolnike vnaprej določene kartice lahko prilagodite tako, da spremenite njihovo velikost, jih premaknete, skrijete, jim dodate kontrolnike in izvedete druge spremembe. Začnete lahko tudi s popolnoma prazno kartico, »kartico po meri«, ki ji dodate kontrolnike od začetka.
Vnaprej določene kartice so privzeto zaklenjene. Na zaklenjeni kartici lahko spremenite le nekatere lastnosti kartice ali kontrolnike znotraj kartice, ne morete pa tudi izbrisati zaklenjene kartice. Ključavnico kartice lahko prikažete in jo odklenete v zavihku Ogled v pogledu Napredno. Če je lastnost zaklenjena in je ni mogoče spremeniti, se prikaže z ikono ključavnice poleg njenega imena. Odklepanje kartice je napredna dejavnost in jo je treba opraviti previdno, saj boste s tem prekinili samodejno ustvarjanje formule za kartico in kartice ne boste mogli ponovno zakleniti.
V vsebniku obrazca je na voljo zapis ThisItem, ki vsebuje vsa polja zapisa. Lastnost kartice Privzeto je na primer pogosto nastavljena na ThisItem.FieldName.
Za konfiguracijo kontrolnika lahko uporabite sklic Nadrejeno, da se sklicujete na lastnosti kartice. Kontrolnik bi moral na primer uporabiti Parent.Default za branje začetnega stanja polja iz vira podatkov. Z uporabo lastnosti Nadrejeno namesto neposrednega dostopa do želenih informacij je kartica bolje enkapsulirana in jo lahko spremenite v drugo polje brez kršenja internih formul.
Glejte Razumevanje podatkovnih kartic za ogled primerov, kako prilagoditi, odkleniti in ustvariti kartice.
Ključne lastnosti
DataField – Ime polja znotraj zapisa, ki ga ta kartica prikazuje in ureja.
- Navedite ime kot en statični niz, ki je obdan z dvojnimi narekovaji (npr. »Ime«), in ne formule.
- Odvežite kartico tako, da nastavite njeno lastnost DataField na prazno. Lastnosti Veljavno in Posodobitev se ne upoštevata pri odvezanih karticah.
Privzeto – Začetna vrednost kontrolnika, preden jo uporabnik spremeni.
- Za vsak kontrolnik v kartici nastavite to lastnost na Parent.Default, s čimer se boste sklicevali na privzeto vrednost polja glede na vir podatkov. Nastavite na primer lastnost drsnika Privzeto na Parent.Default, da zagotovite, da uporabnik najprej uporabi splošno vrednost za ta drsnik.
DisplayMode – vrednosti so lahko Edit, View ali Disabled. Konfigurira možnost, ali kontrolnik znotraj kartice omogoča vnašanje uporabnika (Uredi), izključno prikaz podatkov (Ogled) oziroma je onemogočen (Onemogočeno).
- Omogoča uporabo ene same kartice v obrazcih za urejanje in ogled, in sicer s konfiguracijo te lastnosti, ki je privzeto vezana na vedenje obrazca.
- V načinu Ogled bodo podrejeni kontrolniki, kot so Text input, Drop down, Date Picker, prikazovali samo besedilno vrednost in ne bodo upodobili interaktivnih ali dekorativnih elementov.
DisplayName – Uporabniku prijazno ime za polje v viru podatkov.
- Funkcija DataSourceInfo zagotavlja te metapodatke iz vira podatkov.
- Kontrolniki znotraj kartice morajo uporabiti Parent.DisplayName za sklicevanje na ime polja.
Napaka – Uporabniku prijazno sporočilo o napaki, ki se prikaže za to polje po neuspešnem preverjanju veljavnosti.
- Ta lastnost se nastavi ob klicu funkcije SubmitForm.
- Sporočilo opisuje težave pri preverjanju veljavnosti, ki temeljijo na metapodatkih vira podatkov in preverjanju lastnosti kartice Obvezno.
Obvezno – Določa, ali mora kartica, ki ureja polje vira podatkov, vsebovati vrednost.
- Funkcija DataSourceInfo zagotavlja zahtevane metapodatke iz vira podatkov.
- Kontrolniki znotraj kartice morajo uporabiti Parent.Required, da ugotovijo, ali je polje kartice obvezno.
Posodobitev – Vrednost odgovora za vir podatkov posameznega polja.
- Uporabite formulo te lastnosti, da izvlečete vrednosti iz kontrolnikov za urejanje kartice, da odgovorite viru podatkov. Lastnost kartice Posodobitev na primer nastavite na Slider.Value, da posodobite vir podatkov z vrednostjo drsnika v tej kartici.
Širina – Razdalja med levim in desnim robom kontrolnika.
WidthFit – Določa, ali kontrolnik samodejno raste vodoravno, da zapolni prazno mesto v kontrolniku vsebnika, kot je kontrolnik Edit form. Če ima več kartic to lastnost nastavljeno na true, je prostor med njimi razdeljen. Če želite več informacij, glejte Razumevanje postavitve podatkovnih obrazcev.
Dodatne lastnosti
BorderColor – Barva obrobe kontrolnika.
BorderStyle – Določa, ali je obroba kontrolnika nastavljena na Fiksno, Črtkano, Pikčasto ali Brez.
BorderThickness – Debelina obrobe kontrolnika.
Polnilo – Barva ozadja kontrolnika.
Višina – Razdalja med zgornjim in spodnjim robom kontrolnika.
Veljavno – Določa, ali kontrolnika Card oziroma Edit form vsebujeta veljavne vnose, ki so pripravljeni za pošiljanje v vir podatkov.
Vidno – Določa, ali je kontrolnik prikazan ali skrit.
X – Razdalja med levim robom kontrolnika in levim robom njegovega nadrejenega vsebnika (oziroma zaslona, če nima nadrejenega vsebnika). Za kontrolnik Card v vsebniku, ki ima več stolpcev, ta lastnost določa stolpec, v katerem je prikazana kartica.
Y – Razdalja med zgornjim robom kontrolnika in zgornjim robom njegovega nadrejenega vsebnika (oziroma zaslona, če nima nadrejenega vsebnika). Za kontrolnik Card v vsebniku, ki ima več vrstic, ta lastnost določa vrstico, v kateri je prikazana kartica.
Primeri
Za primere glejte Razumevanje podatkovnih kartic in Razumevanje postavitve podatkovnih obrazcev.
Smernice o dostopnosti
Barvni kontrast
Obstajati mora ustrezen barvni kontrast med:
- Polnilom in vsemi podrejenimi kontrolniki. Če kartica na primer vsebuje Label in ima oznaka prosojno polnilo, se bo lastnost Fill kartice samodejno spremenilo v barvo ozadja za oznako. Zato mora biti dovolj kontrasta med lastnostjo Fill kartice in lastnostjo Color oznake.
Podpora za bralnik zaslona
- Lastnost DisplayName mora biti prikazana.
Opomba
Ali nam lahko poveste, kateri je vaš prednostni jezik za dokumentacijo? Izpolnite kratko anketo. (upoštevajte, da je v angleščini)
Z anketo boste porabili približno sedem minut. Ne zbiramo nobenih osebnih podatkov (izjava o zasebnosti).