елемент керування

Визначає простір імен, версію та відомості про відображення компонента.

Доступно для

Програми на основі моделі та полотна

Параметри

Ім'я Опис Ввести Обов'язковий Доступно для
namespace Визначення прототипу об'єкта компонента Лише букви або цифри Так Програми на основі моделі та полотна
constructor Метод ініціалізації об'єкта Лише букви або цифри Так Програми на основі моделі та полотна
control-type Незалежно від того, чи є елемент керування стандартним елементом керування або елементом керування React. Значення virtual елемента керування React за допомогою бібліотеки react платформи. Віртуальні елементи керування – це функція загальнодоступного попереднього перегляду. Додаткові відомості: React controls & platform libraries standard|virtual Ні Програми на основі моделі та полотна
description-key Визначає опис компонента, видимого в інтерфейсі користувача. string Ні Програми на основі моделі та полотна
display-name-key Визначає ім'я елемента керування, видимого в інтерфейсі користувача. string Так Програми на основі моделі та полотна
preview-image Зображення, яке використовується на екранах настроювання для відображення попереднього перегляду компонента. string Ні Модельні програми
version Визначає версію компонента, визначену в семантичному старіших версіях string Так Програми на основі моделі та полотна

Батьківські елементи

Елемент Опис
Маніфесту Маніфест – це файл метаданих, який визначає компонент. Це XML файл, який описує:
  • Простір імен компонента.
  • Тип даних, які можна настроїти як поле, так і набір даних.
  • Будь-які властивості, які можна настроїти в програмі під час додавання компонента.
  • Список файлів ресурсів, які потрібні компоненту.
    • Один із них має бути веб-ресурсом TypeScript. Цей typeScript має містити функцію, яка створить екземпляр об'єкта. Упроваджує інтерфейс, який надає методи, необхідні для роботи компонента. Це називається бібліотекою впровадження компонентів.
  • Ім'я функції TypeScript у бібліотеці впровадження компонента, яка повертає об'єкт, який застосовує необхідний інтерфейс компонента.
Коли користувач настроює настроюваний компонент у програмі полотна або програмі на основі моделі, дані в маніфесті відфільтровують доступні компоненти, щоб для конфігурації були доступні лише припустимі компоненти контексту. Властивості, визначені в маніфесті компонента, відображаються як поля конфігурації, щоб користувач, який настроює компонент, міг указати значення. Після цього ці значення властивостей доступні функції компонента під час виконання.

Дочірні елементи

Елемент Опис Входження
набір даних Вузол набору даних у маніфесті компонента представляє певне настроюване представлення набору записів таблиці. 0 або більше
використання зовнішніх служб Указує, чи використовує цей елемент керування зовнішню службу. Якщо це так, установіть позначку атрибута з увімкненим значенням true та додайте до властивості домен зовнішньої <domain> служби. Елемент керування, який використовує будь-яку зовнішню службу, – це преміум-елемент керування, і кінцевому користувачу знадобиться ліцензія Power Apps, щоб відкрити програму з преміум-елементом керування. Додаткові відомості: Ліцензування 0 або 1
власність Вузол властивості визначає певний настроюваний фрагмент даних, який компонент очікує від Microsoft Dataverse. 0 або більше
ресурсів Вузол ресурсів у маніфесті компонента посилається на файли ресурсів, необхідні компоненту для його візуалізації. 1
type-group Вузол групи типів визначає набір типів, визначених одним іменем. Ці відомості можна використовувати для визначення типів даних, які підтримуються певною властивістю. 0 або більше
залежності властивостей Визначає групу залежностей властивостей. 0 або більше
platform-action Використовується, щоб указати, що залежності елемента керування завантажуються на вимогу, а не під час завантаження елемента керування. 0 або 1

Приклад

<control namespace="MyNameSpace"
   constructor="JSHelloWorldControl"
   version="1.0.0"
   display-name-key="JS_HelloWorldControl_Display_Key"
   description-key="JS_HelloWorldControl_Desc_Key"
   control-type="standard"
   preview-image="img/preview.png">
</control>

Посилання на схему маніфесту компонента Power Apps
Довідник із API компонента Power Apps
Огляд структури компонентів Power Apps