vezérlőelem

Meghatározza az összetevő névterét, verzióját és megjelenítési adatait.

Elérhető a következőhöz:

Modellalapú és vászonalapú alkalmazások

Paraméterek

Név Description Típus Kötelező Elérhető a következőhöz:
namespace Meghatározza az összetevő objektum prototípusát Csak betűk vagy számok Igen Modellalapú és vászonalapú alkalmazások
constructor Az objektum inicializálásának módja Csak betűk vagy számok Igen Modellalapú és vászonalapú alkalmazások
control-type Legyen szó standard vagy React vezérlőről. Az érték virtual egy React-vezérlőt jelöl platform React-kódtár használatával. A virtuális vezérlők nyilvános előzetes verziójú funkciók. További információ: React-vezérlők és platformkódtárak standard|virtual Nem Modellalapú és vászonalapú alkalmazások
description-key Meghatározza a felhasználói felületen látható összetevő leírását. string Nem Modellalapú és vászonalapú alkalmazások
display-name-key Meghatározza a felhasználói felületen látható vezérlőelem nevét. string Igen Modellalapú és vászonalapú alkalmazások
preview-image A testreszabási képernyőkön az összetevő előnézetének megjelenítéséhez használt kép. string Nem Modellvezérelt alkalmazások
version A szemantikai verziószámozásban definiált összetevő verzióját határozza meg string Igen Modellalapú és vászonalapú alkalmazások

Szülőelemek

Elem Description
kimutat A jegyzékfájl egy összetevőt meghatározó metaadatfájl. Ez egy XML fájl, amely a következőket írja le:
  • Az összetevő névtere.
  • A konfigurálható adatok típusa mező vagy adatkészlet.
  • Minden olyan tulajdonság, amely konfigurálható az alkalmazásban az összetevő hozzáadásakor.
  • Az összetevő által igényelt erőforrásfájlok listája.
    • Az egyiknek TypeScript webes erőforrásnak kell lennie. Ennek a TypeScriptnek tartalmaznia kell egy függvényt, amely létrehoz egy objektumot. Ez egy olyan felületet implementál, amely az összetevő működéséhez szükséges módszereket teszi elérhetővé. Ezt az összetevő-implementációs kódtárnak nevezzük.
  • Egy TypeScript-függvény neve az összetevő-implementációs kódtárban, amely egy olyan objektumot ad vissza, amely a szükséges összetevő-interfészt alkalmazza.
Ha a felhasználó egyéni összetevőt konfigurál egy vászonalapú alkalmazásban vagy egy modellalapú alkalmazásban, a jegyzékben szereplő adatok kiszűrik az elérhető összetevőket, így csak a környezet érvényes összetevői érhetők el a konfigurációhoz. Az összetevő jegyzékfájljában definiált tulajdonságok konfigurációs mezőkként jelennek meg, így az összetevőt konfiguráló felhasználó megadhat értékeket. Ezek a tulajdonságértékek ezután futtatáskor érhetők el az összetevőfüggvény számára.

Gyermekelemek

Elem Description Események
adatkészlet Az összetevőjegyzék adathalmazcsomópontja a táblarekordok egy halmazának konkrét, konfigurálható ábrázolását jelöli. 0 vagy több
külső szolgáltatás-használat Azt jelzi, hogy ez a vezérlő külső szolgáltatást használ-e. Ha igen, állítsa az engedélyezett attribútum jelzőt igaz értékre, és adja hozzá a külső szolgáltatás tartományát a <domain> tulajdonsághoz. A külső szolgáltatást használó vezérlők prémium szintű vezérlők, és a végfelhasználónak Power Apps-licencre lesz szüksége egy prémium szintű vezérlővel rendelkező alkalmazás megnyitásához. További információ: Licencelés 0 vagy 1
ingatlan A tulajdonságcsomópont egy konkrét, konfigurálható adatrészletet határoz meg, amelyet az összetevő elvár a Microsoft Dataverse-től. 0 vagy több
Erőforrások Az összetevő jegyzékében szereplő erőforráscsomópont azokra az erőforrásfájlokra hivatkozik, amelyekre az összetevőnek szüksége van a vizualizáció implementálásához. 1
típuscsoport A típuscsoport csomópontja egyetlen névvel azonosított típuskészletet határoz meg. Ez az információ egy adott tulajdonság által támogatott adattípusok azonosítására használható. 0 vagy több
tulajdonságfüggőségek A tulajdonságfüggőségek egy csoportját határozza meg. 0 vagy több
platformművelet Annak meghatározására szolgál, hogy a vezérlő függőségei igény szerint töltődjenek be a vezérlő betöltése helyett. 0 vagy 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-összetevő-keretrendszer jegyzékséma-referencia
Power Apps-összetevő-keretrendszer API-referenciája
A Power Apps összetevő-keretrendszerének áttekintése