Vlastnosti součástí plátna (experimentální)

Součásti plátna umožňují tvůrcům vytvářet různé typy vlastností pro přenos hodnot nebo logiky mezi součástí a aplikací, která součást hostuje. Vlastnosti jsou nezbytnou součástí vytváření interaktivních a opakovaně použitelných součástí.

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 akce Clear() by mohla poskytovat funkce, které může aplikace volat, aby vymazala některé hodnoty v součásti, nebo vlastnost akce Save(), 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 chceme hostitelské aplikaci zpřístupnit vlastnosti ovládacího prvku v rámci součásti. V tomto příkladu se naše součást jmenuje Component1. Do naší součásti vložíme ovládací prvek posuvník. Budeme mít vlastnost Vstup pro určení barvy z konzumující aplikace a vlastnost Výstup , kde součást může aplikaci sdělit, jaká je aktuální hodnota posuvníku. Následující příklad předpokládá, že vaše komponenta obsahuje ovládací prvek typu Posuvník s názvem 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 odkazuje na název naší součásti a SliderColor je název vlastnosti, kterou jsme přidali dříve.

Nyní má naše součást vlastnost SliderColor, kterou lze nastavit v konzumující aplikaci, aby součásti předala barvu, která se nastaví jako vlastnost posuvníku ValueFill.

Chceme také poskytnout hodnotu posuvníku konzumující aplikaci. Abychom toho dosáhli, přidáme Výstupní vlastnost.

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. Abychom pro ni mohli nastavit vzorec, musíme nastavit novou vlastnost SliderValue v součásti na vlastnost Value 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.

Nyní bude vlastnost SliderValue naší součásti odrážet hodnotu posuvníku uvnitř součásti, kterou pak lze číst z konzumující aplikace.

Vlastnost funkce

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

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).

Vstupní funkce je způsob, jak konzumující aplikace poskytne logiku součásti, podobně jako ukazatel na funkci nebo funkce zpětného volání. Vaše součást může například pracovat se jmény lidí a mít vstupní funkci s argumenty firstname a lastname, která vrátí sloučený řetězec. Aplikace by mohla definovat výraz funkce, který vrátí $"{firstname} {lastname}", nebo se může definovat výraz pro $"{lastname}, {firstname}". Součást může pouze zavolat funkci, kterou poskytl tvůrce aplikace, a použít 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ů. Součást může mít pojmenovanou vlastnost akce AddRecord, která umožňuje aplikaci přidat záznam do kolekce uvnitř součásti, nebo akce Reset, která vymaže proměnné nebo kolekce uvnitř součásti.

V příkladu posuvníku použitého dříve pro vlastnost dat můžeme zavést vlastnost akce s názvem ResetValue, která nastaví posuvník zpět na výchozí hodnotu. Můžeme přitom použít vzorec Reset( Slider1 ). Nyní mohou instance naší součásti v aplikaci volat Component1.ResetValue() a nastavit tak posuvník zpět na výchozí hodnotu.

Vlastnost události

Ve standardních ovládacích prvcích existuje mnoho běžných vlastností typu Událost, většinou vlastnosti s chováním vstupu. OnSelect na ovládacím prvku tlačítka je asi nejtypičtější příklad. Součást může definovat libovolný počet vlastností události a volat tyto události jako funkci. Například součást, která má ovládací prvek tlačítka, může mít vlastnost události pojmenovanou OnButtonClicked. Ve vlastnosti OnSelect ovládacího prvku tlačítka může součást volat svou vlastnost Component1.OnButtonClicked(). Konzumující aplikace pak může pro tuto vlastnost definovat svou vlastní logiku, která se použije, když je stisknuto tlačítko uvnitř součásti.

Výchozí hodnoty pro vlastnosti nebo argumenty

Výchozí hodnoty mohou poskytnout výchozí hodnotu pro argument nebo vlastnost v případě, že není nastavena žádná hodnota. U některých typů vlastností to nedává smysl. V některých případech však lze výchozí hodnotu použít k poskytnutí očekávaného schématu záznamu. Poskytnutím výchozího záznamu se stanoví typ záznamu jako očekávané schéma.

Například vlastnost akce s názvem AddRecord přijímá záznam, který má být přidán do místní kolekce. Aby bylo možné poskytnout schéma očekávaného záznamu, musí tvůrce přidat výchozí hodnotu pro argument této vlastnosti AddRecord.