Elementos CreateUiDefinition

Este artículo es la referencia elemental para un archivo createUiDefinition.json, que utiliza Azure Managed Applications. Utiliza este artículo para determinar qué elementos están soportados en CreateUiDefinition.

La vista de formulario para especificaciones de plantilla utiliza el formatouiFormDefinition.json . Tiene su propia lista de elementos soportados. Muchos elementos de la vista de Formulario usan el mismo esquema que los elementos de CreateUiDefinition y enlazan a estas páginas de referencia para evitar duplicar contenido, pero ambos formatos no soportan exactamente los mismos elementos.

Esquema

El esquema de la mayoría de los elementos es el siguiente:

{
  "name": "element1",
  "type": "Microsoft.Common.TextBox",
  "label": "Some text box",
  "defaultValue": "my value",
  "toolTip": "Provide a descriptive name.",
  "constraints": {},
  "options": {},
  "visible": true
}
Propiedad Obligatorio Descripción
name Sí Un identificador interno para hacer referencia a una instancia específica de un elemento. El uso más común del nombre del elemento es en outputs, donde se asignan los valores de salida de los elementos especificados a los parámetros de la plantilla. También se puede usar para enlazar el valor de salida de un elemento a defaultValue de otro elemento.
type Sí El control de interfaz de usuario que se representa para el elemento. Para ver una lista de los tipos admitidos, consulte Elementos.
label Sí Texto para mostrar del elemento. Algunos tipos de elementos contienen varias etiquetas, por lo que el valor podría ser un objeto que contiene varias cadenas.
defaultValue No Valor predeterminado de la propiedad. Algunos tipos de elemento admiten valores predeterminados complejos, por lo que el valor podría ser un objeto.
toolTip No El texto que se muestra en la información sobre herramientas del elemento. Similar a label, algunos elementos admiten varias cadenas de información sobre herramientas. Se pueden insertar vínculos en línea con la sintaxis de Markdown.
constraints No Una o varias propiedades que se utilizan para personalizar el comportamiento de validación del elemento. Las propiedades que se admiten para las restricciones varían según el tipo de elemento. Algunos tipos de elementos no admiten la personalización del comportamiento de validación y, por tanto, no tienen ninguna propiedad de restricciones.
options No Más propiedades que personalizan el comportamiento del elemento. De forma similar a constraints, las propiedades que se admiten varían según el tipo de elemento.
visible No Indica si se muestra el elemento. Si true, se muestran el elemento y los elementos secundarios aplicables. El valor predeterminado es true. Use funciones lógicas para controlar dinámicamente el valor de esta propiedad.

Elementos

Los siguientes elementos están soportados en createUiDefinition.json. La documentación de cada elemento contiene un ejemplo de interfaz de usuario, un esquema, comentarios sobre el comportamiento del elemento (normalmente sobre la validación y personalización compatibles) y una salida de ejemplo.

Para los elementos soportados en uiFormDefinition.json, incluyendo selectores de alcance específicos de la vista de Formular, véase Elementos de la vista de Formular.

Pasos siguientes

Para ver una introducción sobre la creación de definiciones de interfaz de usuario, consulte Introducción a CreateUiDefinition.

  • Last updated on