Vlastnosti súčasti plátna (experimentálne)

Komponenty plátna umožňujú tvorcom vytvárať rôzne typy vlastností na prenos hodnôt alebo logiky medzi komponentom a aplikáciou, ktorá je hostiteľom komponentu. Vlastnosti sú nevyhnutnou súčasťou vytvárania interaktívnych a opakovane použiteľných komponentov.

Dôležité

• Toto je experimentálna funkcia.
• Experimentálne funkcie nie sú určené na produkčné účely a môžu mať obmedzenú funkčnosť. Tieto funkcie sú k dispozícii pred oficiálnym vydaním, aby k nim mohli zákazníci získať rýchly prístup a poskytnúť odozvu. Ďalšie informácie: Experimentálne funkcie a funkcie vo verzii ukážky.
• Správanie, ktoré popisuje tento článok, je dostupné iba v prípade, že experimentálna funkcia Rozšírené vlastnosti komponentov v Nastavenia > Pripravované funkcie > Experimentálne je zapnuté (predvolene vypnuté).
• Vaša spätná väzba je pre nás veľmi cenná – dajte nám vedieť, čo si myslíte v Power Apps komunitnom fóre experimentálnych funkcií.

Typy nehnuteľností

Tvorcovia majú k dispozícii štyri typy nehnuteľností:

1. Vlastnosti údajov: Vlastnosti údajov sa týkajú údajov, ako je farba alebo textová hodnota. Vlastnosť A Údaje môže byť nastavená ako Vstup alebo Výstup, ktoré označuje, či komponent poskytuje dáta aplikácii (Výstup) alebo aplikácia poskytuje dáta komponentu (Vstup). Údaje vlastnosti sú jediné vlastníctva, ktoré sa podieľajú na toku údajov aplikácie.
2. Vlastnosti funkcie: Vlastnosti funkcie súvisia s logikou, ako je napríklad vykonávanie výpočtu na základe špecifických parametrov alebo zmena textu. Vlastnosť A Funkcia môže byť nastavená na Vstup alebo Výstup, ktoré označuje, či komponent poskytuje funkciu, ktorú môže aplikácia volať (Výstup), alebo či aplikácia poskytuje funkciu, ktorú môže komponent volať (Vstup). Vlastnosti funkcie sa nezúčastňujú na toku údajov aplikácie a nemôžu používať premenné komponentu alebo aplikácie.
3. Vlastnosti akcie: Vlastnosti akcie sú typom vlastnosti, ktorá sa zaoberá logikou a správa sa ako Výstup Funkcia. Komponent má teda definovanú logiku a táto logika môže používať reťazené výrazy a manipulovať s kolekciami alebo premennými ("správanie"). Napríklad vlastnosť Clear() Action môže poskytovať funkcie, ktoré môže aplikácia zavolať na vymazanie niektorých hodnôt v komponente, alebo Save() Akcia vlastnosť, ktorá aktualizuje zdroj údajov.
4. Vlastnosti udalosti: Vlastnosti udalosti sú kategóriou vlastností, ktoré zahŕňajú logiku a fungujú ako Vstup Funkcia. Aplikácia teda definuje logiku, ktorú môže komponent volať, a táto logika môže používať reťazené výrazy a manipulovať s kolekciami alebo premennými ("správanie"). Názvy týchto vlastností zvyčajne odrážajú udalosť, ako napríklad OnSelect alebo OnChanged.

Vlastnosť údajov

Použitie dátovej vlastnosti si možno ľahko predstaviť. Štandardné ovládacie prvky v aplikáciách majú zvyčajne niekoľko vlastností údajov na nastavenie predvolených hodnôt, farby textu, veľkosti atď. Pozrime sa na jednoduchý príklad, keď chceme hostiteľskej aplikácii sprístupniť vlastnosti ovládacieho prvku v rámci komponentu. V tomto príklade má náš komponent názov Component1. Do vnútra nášho komponentu vložíme posuvný ovládač. Budeme mať vlastnosť Input na určenie farby z aplikácie, ktorá spotrebúva, a vlastnosť Output, kde komponent môže aplikácii povedať, aká je aktuálna hodnota posúvača. Nasledujúci príklad predpokladá, že váš komponent obsahuje Posuvník ovládací prvok s názvom Slider.

1. Na table vlastností komponentu vyberte Nová užívateľská vlastnosť.
2. Na table Nová užívateľská vlastnosť zadajte zobrazovaný názov Slider Color.
3. Vyberte Typ vlastníctva z Údaje a vyberte Definícia vlastníctva hodnota Vstup.
4. Nakoniec z rozbaľovacej ponuky Typ údajov vyberte Farba.
5. Kliknite na položku Vytvoriť.

Ďalej vyberte ovládací prvok Slider1 Posuvník . Nájdite jeho vlastnosť ValueFill a do riadka vzorcov zadajte Component1.SliderColor. Component1 odkazuje na názov nášho komponentu a SliderColor je názov vlastnosti, ktorú sme pridali predtým.

Teraz má náš komponent vlastnosť SliderColor , ktorú je možné nastaviť v konzumnej aplikácii, aby komponentu odovzdala farbu, aby sa nastavila vlastnosť posuvníka ValueFill .

Chceme tiež poskytnúť hodnotu jazdca konzumujúcej aplikácii. Aby sme to dosiahli, pridáme vlastnosť Output .

1. Na table vlastností komponentu vyberte Nová užívateľská vlastnosť.
2. Na table Nová užívateľská vlastnosť zadajte zobrazovaný názov Slider Value.
3. Vyberte Typ vlastníctva z Údaje a vyberte Definícia vlastníctva hodnota Výstup.
4. Nakoniec z rozbaľovacej ponuky Typ údajov vyberte Číslo.
5. Kliknite na položku Vytvoriť.

Keď je vlastnosť Údaje Výstup, komponent poskytuje hodnotu spotrebúvajúcej aplikácii. Aby sme na to nastavili vzorec, musíme nastaviť novú vlastnosť SliderValue v komponente na vlastnosť Hodnota posuvníka.

1. Na table vlastností komponentu kliknite na vlastnosť Slider Value .
2. V riadku vzorcov nahraďte predvolenú hodnotu 100 nasledujúcim vzorcom: Slider1.Value.

Vlastnosť SliderValue nášho komponentu bude teraz odrážať hodnotu posúvača vo vnútri komponentu, ktorú potom možno prečítať z aplikácie, ktorá spotrebúva.

Vlastnosť funkcie

Vlastnosť funkcie obsahuje výraz, ktorý vracia hodnotu. Funkcia zvyčajne preberá niektoré argumenty, ktoré používa na výpočet alebo určenie hodnoty, ktorá sa má vrátiť.

Poznámka

Vlastnosti funkcií momentálne nemajú prístup k premenným alebo hodnotám a vlastnostiam komponentov a nemôžu spúšťať tok údajov. Všetky požadované hodnoty musia byť odovzdané ako argumenty.

Funkcia Výstup predstavuje jednoduchý spôsob vytvorenia vlastnej funkcie pre Power Apps. Komponent definuje funkciu Výstup s výrazom, ktorý preberá nejaké argumenty a vracia hodnotu. Túto funkciu potom možno použiť v aplikácii pomocou názvu komponentu (povedzme Component1) zavolaním Component1.MyFunction(arg1, arg2).

Funkcia Vstup predstavuje spôsob, ako môže spotrebováva aplikácia poskytnúť logiku komponentu, podobne ako ukazovateľ funkcie alebo funkcia spätného volania. Váš komponent môže napríklad pracovať s menami ľudí a má vstupnú funkciu s argumentmi firstname a lastname a rešpektuje reťazec späť. Aplikácia môže definovať výraz funkcie, ktorý sa má vrátiť $"{firstname} {lastname}" , alebo sa môže rozhodnúť definovať výraz pre $"{lastname}, {firstname}". Komponent môže jednoducho zavolať funkciu, ktorú poskytol výrobca aplikácie, a použiť vrátený reťazec.

Vlastnosť akcie

Vlastnosti akcie sú podobné funkčným vlastnostiam typu Výstup, ale umožňujú vzorce vedľajších účinkov a reťazenie výrazov. Komponent môže mať vlastnosť action s názvom AddRecord , ktorá aplikácii umožňuje pridať záznam do kolekcie v komponente, alebo akciu Reset , ktorá vymaže premenné alebo kolekcie v komponente.

V príklade príkladov posuvníka použitého pre vlastnosť Dáta skôr môžeme zaviesť vlastnosť akcie s názvom ResetValue na nastavenie posuvníka späť na predvolenú hodnotu hodnotu. Môžeme na to použiť vzorec Reset( Slider1 ) . Teraz môžu inštancie nášho komponentu v aplikácii volať Component1.ResetValue() na nastavenie posúvača späť na predvolenú hodnotu.

Vlastnosť udalosti

V štandardných ovládacích prvkoch existuje veľa bežných vlastností typu udalosti, ktoré efektívne zadávajú vlastnosti funkcie správania. Najzrejmejším príkladom je OnSelect na ovládacom prvku. Komponent môže definovať ľubovoľný počet vlastností udalosti a volať tieto udalosti ako funkciu. Napríklad komponent, ktorý má tlačidlový ovládací prvok, môže mať vlastnosť udalosti s názvom OnButtonClicked. V OnSelect ovládacieho prvku tlačidla môže komponent volať svoju vlastnosť Component1.OnButtonClicked() . Konzumujúca aplikácia potom môže pre túto vlastnosť definovať svoju vlastnú logiku, ktorá bude konať po stlačení tlačidla vo vnútri komponentu.

Predvolené hodnoty pre vlastnosti alebo argumenty

Predvolené hodnoty môžu poskytnúť predvolenú hodnotu pre argument alebo vlastnosť v prípade, že nie je nastavená žiadna. Pri niektorých typoch nehnuteľností to nedáva zmysel. V niektorých prípadoch sa však môžu použiť na poskytnutie očakávanej schémy pre záznam. Poskytnutím predvoleného záznamu sa ako očakávaná schéma vytvorí typ záznamu.

Napríklad vlastnosť Action s názvom AddRecord prijíma záznam na pridanie do lokálnej kolekcie. Na poskytnutie schémy očakávaného záznamu musí výrobca pridať predvolenú hodnotu pre argument tejto AddRecord vlastnosti.