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

  • Článok

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

Dôležité

Druhy vlastností

Tvorcovia majú k dispozícii štyri typy vlastností:

  1. Vlastnosti údajov: Vlastnosti údajov sa týkajú údajov, napríklad farebná alebo textová hodnota. Vlastnosť Údaje možno nastaviť ako Vstup alebo Výstup, čo označuje, či komponent poskytuje údaje aplikácii (Výstup ·) alebo aplikácia poskytuje údaje komponentu ( Vstup). Vlastnosti údajov sú jediné vlastníctva, ktoré sa zúčastňujú na toku údajov aplikácie.
  2. Vlastnosti funkcie: Vlastnosti funkcie súvisia s logikou, napríklad výpočet na základe konkrétnych parametrov alebo zmena textu. Vlastnosť 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 funkcií sa nepodieľajú na toku údajov aplikácie a nemôžu používať komponenty ani premenné aplikácie.
  3. Vlastnosti akcie: Vlastnosti akcie sú typom vlastnosti, ktorá sa zaoberá logikou a správa sa ako výstupná 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"). Clear() Vlastnosť Akcia môže napríklad poskytovať funkcie, ktoré môže aplikácia vyvolať na vymazanie niektorých hodnôt v komponente, alebo vlastnosť Akcia Save() ·, ktorá aktualizuje zdroj údajov.
  4. Vlastnosti udalosti: Vlastnosti udalosti sú kategóriou vlastností, ktorá zahŕňa logiku a funkcie ako vstupná 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 or OnChanged.

Vlastnosť údajov

Využitie vlastníctva údajov je ľahko predstaviteľné. Š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 sprístupniť vlastnosti ovládacieho prvku v rámci komponentu hostiteľskej aplikácii. V tomto príklade je náš komponent pomenovaný Component1. Do nášho komponentu vložíme posuvné ovládanie. Budeme mať vlastnosť Vstup na určenie farby zo spotrebiteľskej aplikácie a vlastnosť Výstup, kde komponent môže aplikácii povedať, aká je aktuálna hodnota jazdca. V nasledujúcom príklade sa predpokladá, že súčasť obsahuje ovládací prvok jazdca s Slider názvom.

  1. Na table vlastností komponentu vyberte položku Nová vlastná vlastnosť.
  2. Na table Nová vlastná vlastnosť zadajte zobrazované meno Slider Color.
  3. Vyberte Typ vlastnosti Údaje a potom vyberte Hodnota definície vlastnosti Vstup.
  4. Nakoniec z rozbaľovacieho zoznamu Typ údajov vyberte položku Farba.
  5. Kliknite na položku Vytvoriť.

Potom vyberte Slider1 ovládací prvok Jazdec . Vyhľadajte jeho vlastnosť ValueFill a do riadka vzorcov zadajte Component1.SliderColor výraz. Component1 odkazuje na názov našej súčasti a SliderColor je názvom vlastníctva, ktoré sme predtým pridali.

Teraz má SliderColor náš komponent vlastnosť, ktorú je možné nastaviť v spotrebiteľskej aplikácii, aby odovzdal farbu do komponentu a nastavil vlastnosť posúvača ValueFill .

Chceme tiež poskytnúť hodnotu posúvača spotrebiteľskej aplikácii. Aby sme to dosiahli, pridáme vlastnosť Výstup .

  1. Na table vlastností komponentu vyberte položku Nová vlastná vlastnosť.
  2. Na table Nová vlastná vlastnosť zadajte zobrazované meno Slider Value.
  3. Vyberte položku Typ vlastnosti Údaje a potom položku Hodnota definície vlastnosti Výstup.
  4. Nakoniec z rozbaľovacieho zoznamu Typ údajov vyberte položku Číslo.
  5. Kliknite na položku Vytvoriť.

Keď je vlastnosť Údaje Výstup ·, komponent poskytuje hodnotu spotrebúvajúcej aplikácii. Ak chcete nastaviť vzorec, musíme nastaviť novú SliderValue vlastnosť v komponente na vlastnosť Hodnota jazdca.

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

Teraz bude vlastnosť nášho komponentu odrážať hodnotu posúvača vo vnútri komponentu SliderValue , ktorú je potom možné prečítať z aplikácie pre spotrebu.

Vlastnosť funkcie

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

Poznámka

Vlastnosti funkcie 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 sa musia odovzdať ako argumenty.

Výstupná funkcia je jednoduchý spôsob, ako vytvoriť vlastnú funkciu Power Apps. Komponent definuje výstupnú funkciu výrazom, ktorý prevezme niektoré argumenty a vráti hodnotu. Túto funkciu je potom možné použiť v aplikácii pomocou názvu komponentu (povedzme Component1) volaním Component1.MyFunction(arg1, arg2).

Funkcia Input je spôsob, akým môže aplikácia poskytujúca spotrebu poskytnúť komponentu logiku, podobne ako ukazovateľ funkcie alebo funkcia spätného volania. Vaša súčasť môže napríklad pracovať s menami ľudí a môže mať vstupnú funkciu s argumentmi firstname a lastname rešpektuje reťazec späť. Aplikácia by mohla definovať výraz funkcie, ktorý sa má vrátiť $"{firstname} {lastname}" , alebo by mohla definovať výraz pre $"{lastname}, {firstname}". Komponent môže jednoducho zavolať funkciu, ktorú poskytol tvorca aplikácie, a použiť vrátený reťazec.

Vlastnosť akcie

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

V príklade jazdca použitého pre vlastnosť Údaje predtým môžeme zaviesť vlastnosť akcie s názvom ResetValue nastaviť jazdec späť na predvolenú hodnotu. Na to môžeme použiť vzorec Reset( Slider1 ) . Teraz môžu inštancie nášho komponentu v aplikácii volať Component1.ResetValue() a nastaviť posúvač späť na predvolenú hodnotu.

Vlastnosť udalosti

Existuje mnoho spoločných vlastností typu udalosti, vlastností funkcie efektívneho vstupného správania, v štandardných ovládacích prvkoch. OnSelect na ovládacom prvku tlačidla je najzreteľnejším príkladom. Komponent by mohol definovať ľubovoľný počet vlastností udalostí a nazvať tieto udalosti ako funkciu. Napríklad komponent, ktorý má ovládací prvok tlačidla, môže mať pomenovanú OnButtonClicked vlastnosť udalosti. V ovládacom prvku tlačidla OnSelect môže komponent volať svoju Component1.OnButtonClicked() vlastnosť. Spotrebiteľská aplikácia potom môže definovať svoju vlastnú logiku pre túto vlastnosť, ktorá bude konať po stlačení tlačidla vo vnútri komponentu.

Predvolené hodnoty vlastností alebo argumentov

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

Napríklad vlastnosť Akcia s názvom AddRecord akceptuje záznam, ktorý sa má pridať do lokálnej kolekcie. Ak chce tvorca poskytnúť schému očakávaného záznamu, musí pridať predvolenú hodnotu pre argument tejto AddRecord vlastnosti.