Поделиться через

элемент control

Определяет пространство имен компонента, версию и отображаемую информацию.

Доступно для

Приложения на основе модели и холста

Параметры

Имя Description Тип Обязательно Доступно для
namespace Определяет прототип объекта компонента Только буквы или цифры Да Приложения на основе модели и холста
constructor Метод инициализации объекта Только буквы или цифры Да Приложения на основе модели и холста
control-type Является ли элемент управления стандартным элементом управления или элементом управления React. Значение virtual указывает элемент управления React с помощью библиотеки Platform React. Виртуальные элементы управления — это функция общедоступной предварительной версии. Дополнительные сведения: элементы управления React и библиотеки платформы standard|virtual нет Приложения на основе модели и холста
description-key Определяет описание компонента, видимого в пользовательском интерфейсе. string нет Приложения на основе модели и холста
display-name-key Определяет имя элемента управления, видимого в пользовательском интерфейсе. string Да Приложения на основе модели и холста
preview-image Изображение, используемое на экранах настройки для отображения предварительного просмотра компонента. string нет Приложения на основе моделей
version Определяет версию компонента, определенного в семантической версии string Да Приложения на основе модели и холста

Родительские элементы

Элемент Description
очевидный Манифест — это файл метаданных, определяющий компонент. XML Это файл, описывающий:
  • Пространство имен компонента.
  • Тип данных, которые можно настроить, поле или набор данных.
  • Все свойства, которые можно настроить в приложении при добавлении компонента.
  • Список файлов ресурсов, необходимых компоненту.
    • Одним из них должен быть веб-ресурс TypeScript. Этот TypeScript должен включать функцию, которая создаст экземпляр объекта. Это реализует интерфейс, предоставляющий методы, необходимые для работы компонента. Это называется библиотекой реализации компонентов.
  • Имя функции TypeScript в библиотеке реализации компонентов, которая вернет объект, который применяет обязательный интерфейс компонента.
Когда пользователь настраивает пользовательский компонент в приложении холста или в приложении на основе модели, данные в манифесте фильтруют доступные компоненты, чтобы только допустимые компоненты для контекста были доступны для настройки. Свойства, определенные в манифесте компонента, отображаются в виде полей конфигурации, чтобы пользователь, настроив компонент, может указать значения. Затем эти значения свойств доступны функции компонента во время выполнения.

Дочерние элементы

Элемент Description Вхождений
набор данных Узел набора данных в манифесте компонента представляет определенное настраиваемое представление набора записей таблиц. 0 и более
внешнее использование службы Указывает, использует ли этот элемент управления внешнюю службу или нет. Если это так, задайте флаг атрибута в качестве true и добавьте в свойство домен <domain> внешней службы. Элемент управления, использующий любую внешнюю службу, является элементом управления premium, и пользователю потребуется лицензия Power Apps для открытия приложения с элементом управления premium. Дополнительные сведения: лицензирование 0 или 1
свойство Узел свойств определяет определенный настраиваемый фрагмент данных, который компонент ожидает от Microsoft Dataverse. 0 и более
ресурсы Узел ресурсов в манифесте компонента ссылается на файлы ресурсов, необходимые для реализации визуализации. 1
type-group Узел группы типов определяет набор типов, определяемых одним именем. Эти сведения можно использовать для идентификации типов данных, поддерживаемых определенным свойством. 0 и более
зависимости свойств Определяет группу зависимостей свойств. 0 и более
действие платформы Используется для указания того, что зависимости элемента управления загружаются по запросу, а не при загрузке элемента управления. 0 или 1

Example

<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

  • Last updated on