通过

control 元素

定义组件的命名空间、版本和显示信息。

适用于

模型驱动和画布应用

参数

Name Description 类型 必选 适用于
namespace 定义组件的对象原型 仅字母或数字 是的 模型驱动和画布应用
constructor 初始化对象的方法 仅字母或数字 是的 模型驱动和画布应用
control-type 控件是标准控件还是 React 控件。 指示使用平台 React 库的 React 控件的值 virtual 。 虚拟控件是公共预览版中的一项功能。 详细信息： React 控件和平台库 standard|virtual 否 模型驱动和画布应用
description-key 定义 UI 中可见的组件的说明。 string 否 模型驱动和画布应用
display-name-key 定义 UI 中可见的控件的名称。 string 是的 模型驱动和画布应用
preview-image 自定义屏幕上用于显示组件的预览的图像。 string 否 模型驱动应用
version 定义语义版本控制中定义的组件版本 string 是的 模型驱动和画布应用

父元素

元素 Description
清单 清单是定义组件的元数据文件。 它是描述 XML ：
  • 组件的命名空间。
  • 可以配置的数据类型，可以是字段，也可以是数据集。
  • 添加组件时可在应用程序中配置的任何属性。
  • 组件所需的资源文件列表。
    • 其中一个必须是 TypeScript Web 资源。 此 TypeScript 必须包含将实例化对象的函数。 这将实现一个接口，该接口公开组件正常运行所需的方法。 这称为组件实现库。
  • 组件实现库中 TypeScript 函数的名称，该函数将返回应用所需组件接口的对象。
当用户在画布应用或模型驱动应用中配置自定义组件时，清单中的数据会筛选掉可用组件，以便只有上下文的有效组件可用于配置。 组件清单中定义的属性将呈现为配置字段，以便配置组件的用户可以指定值。 然后，这些属性值在运行时可供组件函数使用。

子元素

元素 Description 事件
data-set 组件清单中的数据集节点表示一组表记录的特定可配置表示形式。 0 或更多
external-service-usage 指示此控件是否使用外部服务。 如果是，请将启用的属性标志设置为 true，并将外部服务域添加到 <domain> 该属性。 使用任何外部服务的控件是高级控件，最终用户需要 Power Apps 许可证才能使用高级控件打开应用。 详细信息： 许可 0 或 1
财产 属性节点定义组件需要Microsoft Dataverse 的特定可配置数据片段。 0 或更多
资源 组件清单中的资源节点是指组件实现可视化效果所需的资源文件。 1
type-group 类型组节点定义一组由单个名称标识的类型。 此信息可用于标识特定属性支持的数据类型。 0 或更多
property-dependencies 定义一组属性依赖项。 0 或更多
platform-action 用于指定控件依赖项按需加载，而不是加载控件时。 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 组件框架清单架构参考
Power Apps 组件框架 API 参考
Power Apps 组件框架概述