Свойства на компонентите за платно (преглед)

Компонентите на платното позволяват на производителите да създават различни типове свойства за предаване на стойности или логика между компонента и приложението, което хоства компонента. Свойствата са съществена част от създаването на интерактивни компоненти и компоненти за многократна употреба.

Предварителни изисквания

Преди да можете да използвате тази функция, тя трябва да бъде включена в настройките на приложението.

1. Отворете приложението си за платно за редактиране Power Apps Studio. В командната лента изберете Актуализации> на настройките.

2. В раздела Визуализация намерете и включете настройките Подобрени свойства на компонента.

Видове имоти

Има четири вида имоти, достъпни за производителите:

1. Свойства на данните: Свойствата на данните се отнасят до данни, като например стойност на цвят или текст. Свойството Data може да бъде зададено на Input или Output, което показва дали компонентът предоставя данни на приложението (Output) или приложението предоставя данни на компонента (Input). Свойствата на данните са единствените свойства, които участват в потока от данни на приложението.
2. Свойства на функцията: Свойствата на функцията са свързани с логиката, като например извършване на изчисление въз основа на конкретни параметри или промяна на текст. Свойството Function може да бъде зададено на Input или Output, което показва дали компонентът предоставя функция, която приложението може да извика (Output), или приложението предоставя функция, която компонентът може да извика (Input). Свойствата на функцията не участват в потока от данни на приложението и не могат да използват компонентни или променливи на приложението.
3. Свойства на действието: Свойствата на действието са тип свойство, което се занимава с логика и се държи като изходна функция. По този начин компонентът има дефинирана логика и тази логика може да използва верижни изрази и да манипулира колекции или променливи ("поведение"). Например свойство за Clear()действие може да предостави функционалност, която приложението може да извика, за да изчисти някои стойности в компонента, или свойство Save()на действие , което актуализира източник на данни.
4. Свойства на събитието: Свойствата на събитието са категория свойства, която включва логика и функции като входна функция. По този начин приложението дефинира логиката, която компонентът може да извика и тази логика може да използва верижни изрази и да манипулира колекции или променливи ("поведение"). Обикновено имената на тези свойства отразяват събитие като OnSelect или OnChanged.

Свойство на данни

Използването на свойство за данни е лесно да си представим. Стандартните контроли в приложенията обикновено имат няколко свойства на данните, за да зададат стойности по подразбиране, цвят на текста, размер и т.н. Нека разгледаме един прост пример, в който искаме да направим свойствата на контрола в рамките на компонента достъпни за хостинг приложението. В този пример нашият компонент е наречен Component1. Ще поставим плъзгач във вътрешността на нашия компонент. Ще имаме свойство Input , за да посочим цвета от консумиращото приложение, и свойство Output , където компонентът може да каже на приложението каква е текущата стойност на плъзгача. Следващият пример предполага, че вашият компонент съдържа контрола Плъзгач с Slider име.

1. В екрана със свойства на компонента изберете Ново персонализирано свойство.
2. В екрана Ново свойство по избор въведете показвано име Slider Color.
3. Изберете Тип свойство на данните и изберете Стойност на дефиницията на свойството Вход.
4. Накрая от падащото меню Тип данни изберете Цвят.
5. Кликнете върху Създаване.

След това изберете контролата Slider1Плъзгач . Намерете свойството ValueFill и в лентата с формули въведете Component1.SliderColor. Component1 се отнася до името на нашия компонент и SliderColor е името на свойството, което добавихме по-рано.

Сега нашият компонент има свойство SliderColor , което може да бъде зададено в консумиращото приложение, за да предаде цвят в компонента, за да зададе свойството ValueFill на плъзгача.

Също така искаме да предоставим стойността на плъзгача на потребителското приложение. За да постигнем това, ще добавим свойство Output .

1. В екрана със свойства на компонента изберете Ново персонализирано свойство.
2. В екрана Ново свойство по избор въведете показвано име Slider Value.
3. Изберете Тип свойство на данните и изберете Стойност на дефиницията на свойството Изход.
4. Накрая, от падащото меню Тип данни изберете Брой.
5. Кликнете върху Създаване.

Когато свойство на данни е Изход, компонентът предоставя стойността на приложението, което консумира. За да зададем формулата за това, трябва да зададем новото SliderValue свойство в компонента на свойството Value на плъзгача.

1. В екрана със свойства на компонента щракнете върху свойството Slider Value .
2. В лентата за формули заменете стойността по подразбиране със 100 следната формула: Slider1.Value.

Сега свойството SliderValue на нашия компонент ще отразява стойността на плъзгача вътре в компонента, която след това може да бъде прочетена от консумиращото приложение.

Свойство на функцията

Свойството на функцията съдържа израз, който връща стойност. Обикновено функцията приема някои аргументи, които използва, за да изчисли или определи стойността за връщане.

Изходната функция е лесен начин за създаване на персонализирана функция за Power Apps. Компонентът дефинира Output функция с израз, който приема някои аргументи и връща стойност. След това тази функция може да се използва в приложение, като се използва името на компонента (да речем Component1) чрез извикване Component1.MyFunction(arg1, arg2).

Функцията за въвеждане е начин за потребителско приложение да предостави логика на компонент, подобно на указател на функция или функция за обратно извикване. Например, вашият компонент може да се занимава с имената на хората и да има функция за въвеждане с аргументи firstname и lastname да уважава гръб на низ. Приложението може да дефинира израза на функцията, който да върне $"{firstname} {lastname}" , или може да избере да дефинира израз за $"{lastname}, {firstname}". Компонентът може просто да извика функцията, предоставена от производителя на приложения, и да използва върнатия низ.

Свойство на действие

Свойствата на действието са подобни на свойствата на функцията от тип Output, но позволяват формули за странични ефекти и верижно свързване на изрази. Компонентът може да има свойство за действие, наречено AddRecord , което позволява на приложението да добави запис към колекция вътре в компонента, или Reset действие, което изчиства променливи или колекции вътре в компонента.

В примера с примерите за плъзгач, използвани за свойството Data по-рано, можем да въведем свойство за действие, извикано ResetValue , за да върне плъзгача обратно към стойността му по подразбиране. Можем да използваме формулата Reset( Slider1 ) за това. Сега екземплярите на нашия компонент в приложението могат да извикат Component1.ResetValue() , за да върнат плъзгача обратно към стойността по подразбиране.

Собственост на събитието

Има много общи свойства от тип събитие, ефективно свойства на функцията за поведение на входа, в стандартните контроли. OnSelect на бутона за управление е най-очевидният пример. Компонентът може да дефинира произволен брой свойства на събитието и да извика тези събития като функция. Например компонент, който има контрола на бутон, може да има име на свойство OnButtonClicked за събитие. В OnSelect на контролата на бутона компонентът може да извика своето Component1.OnButtonClicked() свойство. След това потребителското приложение може да дефинира своя собствена логика за това свойство, за да действа при натискане на бутона вътре в компонента.

Стойности по подразбиране за свойства или аргументи

Стойностите по подразбиране могат да предоставят стойност по подразбиране за аргумент или свойство, в случай че не е зададена такава. Това няма смисъл за някои видове имоти. В някои случаи обаче те могат да се използват за предоставяне на очаквана схема за запис. Чрез предоставяне на запис по подразбиране се установява тип запис като очаквана схема.

Например свойство на действие с име AddRecord приема запис, който да бъде добавен към локална колекция. За да предостави схемата на очаквания запис, производителят трябва да добави стойност по подразбиране за аргумента на това AddRecord свойство.