elemento de control

Define o espazo de nomes, a versión e a información de visualización do compoñente.

Dispoñible para

Aplicacións baseadas en modelos e lenzo

Parámetros

Nome Descripción Tipo Obrigatorio Dispoñible para
namespace Define o prototipo do obxecto do compoñente Só letras ou números Si Aplicacións baseadas en modelos e lenzo
constructor Método para inicializar o obxecto Só letras ou números Si Aplicacións baseadas en modelos e lenzo
control-type Se o control é un control estándar ou un control React. O valor de virtual indica un control React usando a biblioteca React da plataforma. Os controis virtuais son unha característica na vista previa pública. Máis información: Controis de React e bibliotecas de plataformas standard|virtual Non Aplicacións baseadas en modelos e lenzo
description-key Define a descrición do compoñente visible na interface de usuario. string Non Aplicacións baseadas en modelos e lenzo
display-name-key Define o nome do control visible na interface de usuario. string Si Aplicacións baseadas en modelos e lenzo
preview-image Imaxe usada nas pantallas de personalización para mostrar unha vista previa do compoñente. string Non Aplicacións controladas por modelos
version Define a versión do compoñente definido en Versións semánticas string Si Aplicacións baseadas en modelos e lenzo

Elementos pais

Elemento Descripción
Manifesto Manifest é o ficheiro de metadatos que define un compoñente. Trátase dun XML arquivo que describe:
  • Espazo de nomes do compoñente.
  • O tipo de datos que se poden configurar, xa sexa un campo ou un conxunto de datos.
  • Calquera propiedade que se poida configurar na aplicación cando se engade o compoñente.
  • Lista de ficheiros de recursos que o compoñente necesita.
    • Un deles debe ser un recurso web de TypeScript. Este TypeScript debe incluír unha función que instanciará un obxecto. Isto implementa unha interface que expón os métodos necesarios para que o compoñente funcione. Isto chámase biblioteca de implementación de compoñentes.
  • O nome dunha función TypeScript na biblioteca de implementación de compoñentes que devolverá un obxecto que aplica a interface de compoñentes requirida.
Cando o usuario configura un compoñente personalizado nunha aplicación de lenzo ou unha aplicación baseada en modelos, os datos do manifesto filtran os compoñentes dispoñibles para que só os compoñentes válidos para o contexto estean dispoñibles para a configuración. As propiedades definidas no manifesto para un compoñente son representadas como campos de configuración para que o usuario que configura o compoñente poida especificar valores. Estes valores de propiedade están dispoñibles para a función compoñente en tempo de execución.

Elementos fillos

Elemento Descripción Ocorrencias
conxunto de datos O nodo do conxunto de datos no manifesto do compoñente representa unha representación específica e configurable dun conxunto de rexistros de táboa. 0 ou máis
Uso de servizos externos Indica se este control está a usar un servizo externo ou non. Se é así, establece a bandeira de atributo habilitado como verdadeira e engade o dominio de servizo externo á <domain> propiedade. Un control que usa calquera servizo externo é un control premium e o usuario final necesitará unha licenza de Power Apps para abrir unha aplicación cun control premium. Máis información: Licenzas 0 ou 1
Propiedade O nodo de propiedades define un dato específico e configurable que o compoñente espera do Microsoft Dataverse. 0 ou máis
Recursos O nodo de recursos no manifesto do compoñente refírese aos ficheiros de recursos que o compoñente require para implementar a súa visualización. 1
grupo de tipos O nodo type-group define un conxunto de tipos identificados cun único nome. Esta información pode usarse para identificar os tipos de datos soportados por unha propiedade específica. 0 ou máis
Dependencias de propiedades Define un grupo de dependencias de propiedades. 0 ou máis
plataforma - acción Utilízase para especificar que as dependencias do control se cargan baixo demanda en lugar de cando se carga o control. 0 ou 1

Exemplo

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

Referencia do esquema de manifesto do marco de compoñentes de Power Apps
Referencia da API do marco de compoñentes de Power Apps
Visión xeral do marco de compoñentes de Power Apps

  • Last updated on