Del via


kontrollelement

Definerer komponentens navneområde, versjon og visningsinformasjon.

Tilgjengelig for

Modelldrevne apper og lerretsapper

Parametere

Navn Beskrivelse Type Kreves Tilgjengelig for
namespace Definerer objektprototypen for komponenten Bare bokstaver eller tall Ja Modelldrevne apper og lerretsapper
constructor En metode for initialisering av objektet Bare bokstaver eller tall Ja Modelldrevne apper og lerretsapper
control-type Om kontrollen er en standardkontroll eller en React-kontroll. Verdien til indikerer en React-kontroll ved hjelp av virtual react-biblioteket på plattformen. Virtuelle kontroller er en funksjon i offentlig forhåndsvisning. Mer informasjon: React-kontroller og plattformbiblioteker standard|virtual Nei Modelldrevne apper og lerretsapper
description-key Definerer beskrivelsen av komponenten som er synlig i brukergrensesnittet. string Nei Modelldrevne apper og lerretsapper
display-name-key Definerer navnet på kontrollen som vises i brukergrensesnittet. string Ja Modelldrevne apper og lerretsapper
preview-image Bilde som brukes på tilpassingsskjermene for å vise en forhåndsvisning av komponenten. string Nei Modelldrevne apper
version Definerer versjonen av komponenten som er definert i Semantic Versioning string Ja Modelldrevne apper og lerretsapper

Overordnede elementer

Element Beskrivelse
manifest Manifest er metadatafilen som definerer en komponent. Det er en XML fil som beskriver:
  • Navneområdet for komponenten.
  • Datatypen den kan konfigureres, enten et felt eller et datasett.
  • Alle egenskaper som kan konfigureres i programmet når komponenten legges til.
  • En liste over ressursfiler som komponenten trenger.
    • Én av dem må være en TypeScript-nettressurs. Denne TypeScript må inneholde en funksjon som vil starte et objekt. Dette implementerer et grensesnitt som viser metoder som kreves for at komponenten skal fungere. Dette kalles komponentimplementeringsbiblioteket.
  • Navnet på en TypeScript-funksjon i komponentimplementeringsbiblioteket som returnerer et objekt som bruker det nødvendige komponentgrensesnittet.
Når brukeren konfigurerer en egendefinert komponent i en lerretsapp eller en modelldrevet app, filtrerer dataene i manifestet ut de tilgjengelige komponentene slik at bare de gyldige komponentene for konteksten er tilgjengelige for konfigurasjon. Egenskapene som er definert i manifestet for en komponent, gjengis som konfigurasjonsfelt, slik at brukeren som konfigurerer komponenten, kan angi verdier. Disse egenskapsverdiene er deretter tilgjengelige for komponentfunksjonen ved kjøring.

Underordnede elementer

Element Beskrivelse Forekomster
datasett Datasettnoden i komponentmanifestet representerer en bestemt, konfigurerbar representasjon av et sett med tabellposter. 0 eller flere
ekstern tjenestebruk Angir om denne kontrollen bruker ekstern tjeneste eller ikke. Hvis det er det, angir du det aktiverte attributtflagget som sann og legger til det eksterne tjenestedomenet i <domain> egenskapen. En kontroll som bruker en ekstern tjeneste, er en premium-kontroll, og sluttbrukeren trenger en Power Apps-lisens for å åpne en app med en premium-kontroll. Mer informasjon: Lisensiering 0 eller 1
eiendom Egenskapsnoden definerer en bestemt, konfigurerbar datadel som komponenten forventer fra Microsoft Dataverse. 0 eller flere
ressurser Ressursnoden i komponentmanifestet refererer til ressursfilene som komponenten krever for å implementere visualiseringen. 1
typegruppe Typegruppenoden definerer et sett med typer som identifiseres med ett enkelt navn. Denne informasjonen kan brukes til å identifisere datatypene som støttes av en bestemt egenskap. 0 eller flere
egenskapsavhengigheter Definerer en gruppe med egenskapsavhengigheter. 0 eller flere
plattformhandling Brukes til å angi at kontrollavhengigheter lastes inn ved behov i stedet for når kontrollen lastes inn. 0 eller 1

Eksempel

<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>

Skjemareferanse for framework-skjema for Power Apps-komponenten
API-referanse for power apps-komponentrammeverket
Oversikt over komponentrammeverket for Power Apps