Udostępnij przez

control, element

Definiuje przestrzeń nazw, wersję i wyświetlanie informacji o składniku.

Dostępne dla

Aplikacje oparte na modelu i kanwy

Parametry

Name Description Typ Wymagane Dostępne dla
namespace Definiuje prototyp obiektu składnika Tylko litery lub cyfry Tak Aplikacje oparte na modelu i kanwy
constructor Metoda inicjowania obiektu Tylko litery lub cyfry Tak Aplikacje oparte na modelu i kanwy
control-type Niezależnie od tego, czy kontrolka jest standardową kontrolką, czy kontrolką React. Wartość virtual wskazuje kontrolkę React przy użyciu biblioteki platformy React. Kontrolki wirtualne są funkcją w publicznej wersji zapoznawczej. Więcej informacji: Kontrolki i biblioteki platformy React standard|virtual Nie. Aplikacje oparte na modelu i kanwy
description-key Definiuje opis składnika widocznego w interfejsie użytkownika. string Nie. Aplikacje oparte na modelu i kanwy
display-name-key Definiuje nazwę kontrolki widocznej w interfejsie użytkownika. string Tak Aplikacje oparte na modelu i kanwy
preview-image Obraz używany na ekranach dostosowywania w celu wyświetlenia podglądu składnika. string Nie. Aplikacje oparte na modelu
version Definiuje wersję składnika zdefiniowanego w semantycznej wersji string Tak Aplikacje oparte na modelu i kanwy

Elementy nadrzędne

Składnik Description
manifest Manifest to plik metadanych, który definiuje składnik. Jest to XML plik, który opisuje:
  • Przestrzeń nazw składnika.
  • Rodzaj danych, które można skonfigurować— pole lub zestaw danych.
  • Wszelkie właściwości, które można skonfigurować w aplikacji po dodaniu składnika.
  • Lista plików zasobów, których potrzebuje składnik.
    • Jednym z nich musi być zasób internetowy TypeScript. Ten język TypeScript musi zawierać funkcję, która utworzy wystąpienie obiektu. Spowoduje to zaimplementowanie interfejsu, który uwidacznia metody wymagane do działania składnika. Jest to nazywane biblioteką implementacji składników.
  • Nazwa funkcji TypeScript w bibliotece implementacji składników, która zwróci obiekt, który stosuje wymagany interfejs składnika.
Gdy użytkownik konfiguruje składnik niestandardowy w aplikacji kanwy lub aplikacji opartej na modelu, dane w manifeście filtrują dostępne składniki tak, aby tylko prawidłowe składniki kontekstu są dostępne dla konfiguracji. Właściwości zdefiniowane w manifeście składnika są renderowane jako pola konfiguracji, dzięki czemu użytkownik konfigurujący składnik może określić wartości. Te wartości właściwości są następnie dostępne dla funkcji składnika w czasie wykonywania.

Elementy podrzędne

Składnik Description Wystąpień
zestaw danych Węzeł zestawu danych w manifeście składnika reprezentuje konkretną, konfigurowalną reprezentację zestawu rekordów tabeli. 0 lub więcej
użycie usługi zewnętrznej Wskazuje, czy ta kontrolka korzysta z usługi zewnętrznej, czy nie. Jeśli tak jest, ustaw flagę włączonego atrybutu jako true i dodaj domenę usługi zewnętrznej <domain> do właściwości . Kontrolka korzystająca z dowolnej usługi zewnętrznej jest kontrolką Premium, a użytkownik końcowy będzie potrzebować licencji usługi Power Apps, aby otworzyć aplikację z kontrolką Premium. Więcej informacji: Licencjonowanie 0 lub 1
właściwość Węzeł właściwości definiuje określony, konfigurowalny fragment danych, którego oczekuje składnik z usługi Microsoft Dataverse. 0 lub więcej
zasoby Węzeł zasobów w manifeście składnika odwołuje się do plików zasobów, których składnik wymaga zaimplementowania wizualizacji. 1
type-group Węzeł grupy typów definiuje zestaw typów zidentyfikowanych przez jedną nazwę. Te informacje mogą służyć do identyfikowania typów danych obsługiwanych przez określoną właściwość. 0 lub więcej
zależności właściwości Definiuje grupę zależności właściwości. 0 lub więcej
akcja platformy Służy do określania, że zależności sterujące ładują się na żądanie zamiast podczas ładowania kontrolki. 0 lub 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>

Dokumentacja schematu manifestu platformy składników usługi Power Apps
Dokumentacja interfejsu API platformy składników usługi Power Apps
Omówienie struktury składników usługi Power Apps

  • Last updated on