Elementos CreateUiDefinition

Este artigo é a referência elemental para um ficheirocreateUiDefinition.json, que é utilizado por Aplicações Geridas do Azure. Use este artigo para determinar quais os elementos suportados no CreateUiDefinition.

A vista de formulário para especificações de modelos utiliza o formatouiFormDefinition.json . Tem a sua própria lista de elementos suportada. Muitos elementos da vista Form usam o mesmo esquema que os elementos CreateUiDefinition e ligam a estas páginas de referência para evitar duplicação de conteúdo, mas os dois formatos não suportam exatamente os mesmos elementos.

Esquema

O esquema para a maioria dos elementos é o seguinte:

{
  "name": "element1",
  "type": "Microsoft.Common.TextBox",
  "label": "Some text box",
  "defaultValue": "my value",
  "toolTip": "Provide a descriptive name.",
  "constraints": {},
  "options": {},
  "visible": true
}
Property Necessário Descrição
name Sim Um identificador interno para fazer referência a uma instância específica de um elemento. O uso mais comum do nome do elemento é em outputs, onde os valores de saída dos elementos especificados são mapeados para os parâmetros do modelo. Você também pode usá-lo para vincular o valor de saída de um elemento ao defaultValue de outro elemento.
type Sim O controle de interface do usuário a ser renderizado para o elemento . Para obter uma lista dos tipos suportados, consulte Elementos.
label Sim O texto de exibição do elemento. Alguns tipos de elementos contêm vários rótulos, portanto, o valor pode ser um objeto contendo várias cadeias de caracteres.
defaultValue Não O valor padrão do elemento . Alguns tipos de elementos suportam valores padrão complexos, de modo que o valor pode ser um objeto.
toolTip Não O texto a ser exibido na dica de ferramenta do elemento. Semelhante ao , alguns elementos suportam várias cadeias de caracteres de dica labelde ferramenta. Os links embutidos podem ser incorporados usando a sintaxe Markdown.
constraints Não Uma ou mais propriedades que são usadas para personalizar o comportamento de validação do elemento. As propriedades suportadas para restrições variam de acordo com o tipo de elemento. Alguns tipos de elementos não suportam a personalização do comportamento de validação e, portanto, não têm nenhuma propriedade constraints.
options Não Mais propriedades que personalizam o comportamento do elemento. Semelhante ao constraints, as propriedades suportadas variam de acordo com o tipo de elemento.
visible Não Indica se o elemento é exibido. Se true, o elemento e os elementos filho aplicáveis serão exibidos. O valor predefinido é true. Use funções lógicas para controlar dinamicamente o valor dessa propriedade.

Elementos

Os seguintes elementos são suportados em createUiDefinition.json. A documentação para cada elemento contém um exemplo de interface do usuário, esquema, comentários sobre o comportamento do elemento (geralmente sobre validação e personalização suportada) e saída de exemplo.

Para elementos suportados em uiFormDefinition.json, incluindo seletores de âmbito específicos da vista Form, veja Elementos da vista Form.

Próximos passos

Para obter uma introdução à criação de definições de interface do usuário, consulte Introdução a CreateUiDefinition.

  • Last updated on