共用方式為

控制元素

定義元件的命名空間、版本和顯示資訊。

適用於

模型導向和畫布應用程式

參數

名稱 Description 類型 為必填項目 適用於
namespace 定義元件的物件原型 只有字母或數字 Yes 模型導向和畫布應用程式
constructor 初始化物件的方法 只有字母或數字 Yes 模型導向和畫布應用程式
control-type 控制項是標準控制項還是 React 控制項。 的 virtual 值表示使用平台 React 函式庫的 React 控制項。 虛擬控制項是公開預覽版中的一項功能。 其他資訊： React 控制項和平台程式庫 standard|virtual 否 模型導向和畫布應用程式
description-key 定義UI中可見的元件描述。 string 否 模型導向和畫布應用程式
display-name-key 定義 UI 中可見的控制項名稱。 string Yes 模型導向和畫布應用程式
preview-image 在自訂畫面上用來顯示元件預覽的影像。 string 否 模型導向應用程式
version 定義語意版本設定中定義的元件版本 string Yes 模型導向和畫布應用程式

父元素

元素 Description
清單 資訊清單是定義元件的中繼資料檔案。 這是一個 XML 描述以下文件：
  • 元件的命名空間。
  • 可以設定的資料類型，欄位或資料集。
  • 新增元件時可在應用程式中設定的任何內容。
  • 元件所需的資源檔案清單。
    • 其中一個必須是 TypeScript Web 資源。 此 TypeScript 必須包含一個將實例化物件的函數。 這會實作一個介面，以公開元件運作所需的方法。 這稱為元件實作庫。
  • 元件實作程式庫中 TypeScript 函數的名稱，該函數將傳回套用所需元件介面的物件。
當使用者在畫布應用程式或模型導向應用程式中設定自訂元件時，資訊清單中的資料會篩選出可用的元件，以便只有內容的有效元件可用於設定。 元件資訊清單中定義的屬性會轉譯為組態欄位，讓設定元件的使用者可以指定值。 然後，這些內容值可在執行時期供元件函數使用。

子專案

元素 Description 發生次數
資料集 元件資訊清單中的資料集節點代表一組資料表記錄的特定、可設定的表示法。 0 或更多
外部服務使用情況 指出此控制項是否使用外部服務。 如果是，請將已啟用的屬性旗標設為 true，並將外部服務網域 <domain> 新增至內容。 使用任何外部服務的控制項是進階控制項，使用者需要 Power Apps 授權才能開啟具有進階控制項的應用程式。 其他資訊： 授權 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 元件架構資訊清單結構描述參考
Power Apps 元件架構 API 參考
Power Apps 元件架構概觀

  • Last updated on