Vlastnosti součástí plátna

Komponenty plátna umožňují tvůrcům vytvářet různé typy vlastností pro předávání hodnot nebo logiky mezi komponentou a aplikací, která komponentu hostuje. Vlastnosti jsou nezbytné pro vytváření interaktivních, opakovaně použitelných komponent.

Předpoklady

U nových aplikací je tato možnost implicitně zapnutá. U stávajících aplikací ji musíte zapnout v nastavení aplikace.

1. Otevřete aplikaci plátna pro úpravy v Power Apps Studio. Na panelu příkazů vyberte Nastavení>Aktualizace.

2. Na kartě Nové vyhledejte a zapněte nastavení Rozšířené vlastnosti součásti.

Typy vlastností

Tvůrci mají k dispozici čtyři typy vlastností.

1. Vlastnosti dat: Vlastnosti dat se týkají dat, jako je barva nebo textová hodnota. Vlastnost Data lze nastavit na Vstup nebo Výstup, což říká, zda součást poskytuje data aplikaci (Výstup) nebo aplikace poskytuje data součásti (Vstup). Vlastnosti Data jsou jediné vlastnosti, které se účastní toku dat aplikace.
2. Vlastnosti funkce: Vlastnosti funkce souvisejí s logikou, jako je provádění výpočtu na základě konkrétních parametrů nebo změna textu. Vlastnost Funkce lze nastavit na Vstup nebo Výstup, což říká, zda součást poskytuje aplikaci funkci, kterou lze volat (Výstup) nebo aplikace poskytuje funkci součásti (Vstup). Vlastnosti funkce se nepodílejí na toku dat aplikace a nemohou používat proměnné součásti nebo aplikace.
3. Vlastnosti akce: Vlastnosti akce jsou typem vlastnosti, která se zabývá logikou a chová se jako Výstupnífunkce. Součást má tedy definovanou logiku a tato logika může používat zřetězené výrazy a manipulovat s kolekcemi nebo proměnnými („chování“). Například vlastnost akceClear() by mohla poskytovat funkce, které může aplikace volat, aby vymazala některé hodnoty v součásti nebo vlastnost akceSave(), která aktualizuje zdroj dat.
4. Vlastnosti události: Vlastnosti události jsou kategorií vlastností, která zahrnuje logiku a funkce jako Vstupnífunkce. Aplikace tedy definuje logiku, kterou součást může volat, a tato logika může používat zřetězené výrazy a manipulovat s kolekcemi nebo proměnnými („chování“). Názvy těchto vlastností obvykle odrážejí událost, jako je OnSelect nebo OnChanged.

Datová vlastnost

Použití datové vlastnosti si lze snadno představit. Standardní ovládací prvky v aplikacích mají obvykle několik datových vlastností pro nastavení výchozích hodnot, barvy textu, velikosti atd. Podívejme se na jednoduchý příklad, kdy chcete zpřístupnit vlastnosti ovládacího prvku v rámci komponenty pro hostující aplikaci. V tomto příkladu má komponenta název Component1. Vložte posuvník dovnitř komponenty. Přidejte vlastnost Vstup, která určí barvu z aplikace, která ji využívá, a vlastnost Výstup, aby komponenta mohla aplikaci sdělit aktuální hodnotu posuvníku. V tomto příkladu se předpokládá, že komponenta má ovládací prvek Posuvník pojmenovaný Slider.

1. V podokně vlastností součásti vyberte možnost Nová uživatelská vlastnost.
2. V podokně Nová uživatelská vlastnost zadejte zobrazovaný název Slider Color.
3. Jako Typ vlastnosti vyberte Data a poté vyberte v poli Definice vlastnosti hodnotu Vstup.
4. Nakonec v rozevíracím seznamu Datový typ vyberte Barva.
5. Klikněte na volbu Vytvořit.

Dále vyberte ovládací prvek Posuvník s názvem Slider1. Najděte jeho vlastnost ValueFill a v řádku vzorců zapište Component1.SliderColor. Component1 je název komponenty a SliderColor je název vlastnosti, kterou jste přidali.

Nyní má komponenta vlastnost SliderColor, kterou lze nastavit v aplikaci, která ji využívá, aby předala barvu do komponenty a nastavila vlastnost posuvníku ValueFill.

Můžete také zadat hodnotu posuvníku aplikaci, která ji využívá. K tomu přidejte vlastnost Výstup.

1. V podokně vlastností součásti vyberte možnost Nová uživatelská vlastnost.
2. V podokně Nová uživatelská vlastnost zadejte zobrazovaný název Slider Value.
3. Jako Typ vlastnosti vyberte Data a poté vyberte v poli Definice vlastnosti hodnotu Výstup.
4. Nakonec v rozevíracím seznamu Datový typ vyberte Číslo.
5. Klikněte na volbu Vytvořit.

Když je Datová vlastnost nastavena na Výstup, součást poskytuje hodnotu konzumující aplikaci. Chcete-li nastavit vzorec, nastavte novou vlastnost SliderValue v komponentě na vlastnost Hodnota posuvníku.

1. V podokně vlastností součásti klikněte na vlastnost Slider Value.
2. V panelu vzorců nahraďte výchozí hodnotu 100 následujícím vzorcem: Slider1.Value.

Vlastnost komponenty SliderValue teď odráží hodnotu posuvníku uvnitř komponenty, kterou může aplikace, která ji využívá, číst.

Vlastnost funkce

Vlastnost funkce obsahuje výraz, který vrací hodnotu. Funkce obvykle přebírá argumenty, které používá k výpočtu hodnoty, která se má vrátit.

Poznámka:

Vlastnosti funkce aktuálně nemají přístup k proměnným nebo hodnotám součástí a vlastnostem, a nemohou spouštět tok dat. Všechny požadované hodnoty musejí být předány jako argumenty.

Výstupní funkce je jednoduchý způsob, jak vytvořit uživatelskou funkci pro Power Apps. Součást definuje výstupní funkci pomocí výrazu, který přebírá nějaké argumenty a vrací hodnotu. Tuto funkci pak lze použít v aplikaci s využitím názvu součásti (řekněme Component1) zavoláním Component1.MyFunction(arg1, arg2).

Funkce Vstup umožňuje, aby aplikace, která ji využívá, poskytovala komponentě logiku, podobně jako ukazatel na funkci nebo funkce zpětného volání. Pokud například komponenta pracuje se jmény osob, může mít vstupní funkci s argumenty firstname a lastname a očekává zpět řetězec. Aplikace může definovat výraz funkce, který se má vrátit $"{firstname} {lastname}" nebo $"{lastname}, {firstname}". Komponenta volá funkci, kterou tvůrce aplikace poskytuje, a používá vrácený řetězec.

Vlastnost akce

Vlastnosti akce jsou podobné funkčním vlastnostem typu Výstup, ale umožňují vzorce s vedlejšími účinky a řetězení výrazů. Komponenta může mít vlastnost akce s názvem AddRecord, která umožňuje aplikaci přidat záznam do kolekce uvnitř komponenty, nebo akci Reset, která vymaže proměnné nebo kolekce uvnitř komponenty.

V předchozím příkladu posuvníku pro vlastnost Data můžete přidat vlastnost akce s názvem ResetValue pro nastavení posuvníku zpět na výchozí hodnotu. K tomu použijte vzorec Reset( Slider1 ). Instance komponenty v aplikaci teď mohou volat Component1.ResetValue() a nastavit posuvník zpět na výchozí hodnotu.

Vlastnost události

Mnoho standardních ovládacích prvků má společné vlastnosti typu Událost, což jsou vlastnosti funkce chování vstupu. Běžným příkladem je OnSelect na ovládacím prvku tlačítka. Komponenta může definovat vlastnosti události a volat tyto události jako funkci. Například komponenta s ovládacím prvkem tlačítka může mít vlastnost události s názvem OnButtonClicked. Ve vlastnosti OnSelect ovládacího prvku tlačítka může součást volat svou vlastnost Component1.OnButtonClicked(). Aplikace, která tuto vlastnost využívá, může definovat vlastní logiku, která bude fungovat při stisknutí tlačítka uvnitř komponenty.

Výchozí hodnoty pro vlastnosti nebo argumenty

Výchozí hodnoty dávají argumentu nebo vlastnosti hodnotu, pokud není nastavena žádná. U některých typů vlastností to nedává smysl. V některých případech můžete použít výchozí hodnoty k zobrazení očekávaného schématu záznamu. Poskytnutím výchozího záznamu nastavíte typ záznamu jako očekávané schéma.

Například vlastnost Akce s názvem AddRecord přebírá záznam, který se má přidat do místní kolekce. Chcete-li zobrazit schéma očekávaného záznamu, přidejte výchozí hodnotu argumentu vlastnosti AddRecord.