Vlastnosti súčasti plátna (verzia Preview)

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.

Požiadavky

Pred použitím tejto funkcie je potrebné ju zapnúť v nastaveniach aplikácie.

1. Otvorte aplikáciu na plátne na úpravu v Power Apps Studio. Na paneli príkazov vyberte Nastavenia>Aktualizácie.

2. Na karte Ukážka vyhľadajte a zapnite nastavenia Rozšírené vlastnosti komponentov .

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á na Vstup alebo Výstup, čo znamená, že komponent poskytuje dáta alebo 19. 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, čo označuje, či komponent poskytuje funkciu, ktorú môže aplikácia volať (Výstup), alebo 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ýstupFunkcia. 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 volať na vymazanie niektorých hodnôt v komponente, alebo vlastnosť Save()Action , ktorá aktualizuje zdroj údajov.
4. Vlastnosti udalosti: Vlastnosti udalosti sú kategóriou vlastností, ktoré zahŕňajú logiku a fungujú ako VstupFunkcia. 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, kde 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 vlastnosti z Údaje a vyberte Definícia vlastnosti hodnota Vstup.
4. Nakoniec z rozbaľovacej ponuky Typ údajov vyberte Farba.
5. Kliknite na Vytvoriť.

Ďalej vyberte ovládací prvok Slider1Posuvní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 vlastnosti z Údajov a vyberte Definícia vlastnosti hodnota Výstup
4. Nakoniec z rozbaľovacej ponuky Typ údajov vyberte Číslo.
5. Kliknite na Vytvoriť.

Keď je vlastnosť ÚdajeVý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ť.

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 je 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ť Údaje skôr môžeme zaviesť vlastnosť akcie s názvom ResetValue na nastavenie posuvníka späť na predvolenú 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 časti 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 typ záznamu vytvorí ako očakávaná schéma.

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