Sdílet prostřednictvím

control – element

Definuje obor názvů, verzi a zobrazované informace komponenty.

K dispozici pro

Modelem řízené aplikace a aplikace plátna

Parametry

Název Description Typ Povinné K dispozici pro
namespace Definuje prototyp objektu komponenty. Pouze písmena nebo číslice Ano Modelem řízené aplikace a aplikace plátna
constructor Metoda pro inicializaci objektu Pouze písmena nebo číslice Ano Modelem řízené aplikace a aplikace plátna
control-type Bez ohledu na to, jestli je ovládací prvek standardní nebo ovládací prvek React. Hodnota virtual označuje ovládací prvek React pomocí knihovny React platformy. Virtuální ovládací prvky jsou funkcí ve verzi Public Preview. Další informace: Knihovny ovládacích prvků React a platforem standard|virtual Ne Modelem řízené aplikace a aplikace plátna
description-key Definuje popis komponenty viditelné v uživatelském rozhraní. string Ne Modelem řízené aplikace a aplikace plátna
display-name-key Definuje název ovládacího prvku viditelného v uživatelském rozhraní. string Ano Modelem řízené aplikace a aplikace plátna
preview-image Obrázek použitý na obrazovkách přizpůsobení k zobrazení náhledu komponenty string Ne Modelem řízené aplikace
version Definuje verzi komponenty definované v sémantické sémantické správě verzí. string Ano Modelem řízené aplikace a aplikace plátna

Nadřazené elementy

prvek Description
manifest Manifest je soubor metadat, který definuje komponentu. Jedná se o XML soubor, který popisuje:
  • Obor názvů komponenty.
  • Druh dat, která je možné nakonfigurovat, buď pole, nebo datovou sadu.
  • Všechny vlastnosti, které lze nakonfigurovat v aplikaci při přidání komponenty.
  • Seznam souborů prostředků, které komponenta potřebuje.
    • Jedním z nich musí být webový prostředek TypeScriptu. Tento TypeScript musí obsahovat funkci, která vytvoří instanci objektu. Tím se implementuje rozhraní, které zveřejňuje metody, které jsou vyžadovány pro fungování komponenty. Tomu se říká knihovna implementace komponent.
  • Název funkce TypeScript v knihovně implementace komponenty, která vrátí objekt, který použije požadované rozhraní komponenty.
Když uživatel nakonfiguruje vlastní komponentu v aplikaci plátna nebo modelem řízenou aplikaci, data v manifestu vyfiltrují dostupné komponenty, aby byly pro konfiguraci k dispozici pouze platné komponenty pro daný kontext. Vlastnosti definované v manifestu pro komponentu se vykreslují jako konfigurační pole, aby uživatel, který komponentu konfiguruje, mohl zadat hodnoty. Tyto hodnoty vlastností jsou pak k dispozici pro funkci komponenty za běhu.

Podřízené elementy

prvek Description Výskyty
datová sada Uzel datové sady v manifestu komponenty představuje konkrétní konfigurovatelnou reprezentaci sady záznamů tabulky. 0 a více
external-service-usage Určuje, jestli tento ovládací prvek používá externí službu, nebo ne. Pokud ano, nastavte příznak povoleného atributu jako true a přidejte do <domain> vlastnosti doménu externí služby. Ovládací prvek, který používá jakoukoli externí službu, je prémiový ovládací prvek a koncový uživatel bude potřebovat licenci Power Apps k otevření aplikace s prémiovým řízením. Další informace: Licencování 0 nebo 1
vlastnost Uzel vlastnosti definuje konkrétní konfigurovatelnou část dat, kterou komponenta očekává od Microsoft Dataverse. 0 a více
prostředky Uzel prostředků v manifestu komponenty odkazuje na soubory prostředků, které komponenta vyžaduje k implementaci vizualizace. 1
type-group Uzel skupiny typů definuje sadu typů identifikovaných jedním názvem. Tyto informace lze použít k identifikaci datových typů podporovaných konkrétní vlastností. 0 a více
property-dependencies Definuje skupinu závislostí vlastností. 0 a více
akce platformy Používá se k určení zatížení závislostí na vyžádání místo při načtení ovládacího prvku. 0 nebo 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>

Referenční informace ke schématu manifestu architektury komponent Power Apps
Referenční informace k rozhraní API pro architekturu komponent Power Apps
Přehled architektury komponent Power Apps

  • Last updated on