Éléments de CreateUiDefinition

Cet article est la référence élémentaire pour un fichier createUiDefinition.json, utilisé par Applications managées Azure. Utilisez cet article pour déterminer quels éléments sont pris en charge dans CreateUiDefinition.

La vue formulaire pour les spécifications du modèle utilise le formatuiFormDefinition.json . Il possède sa propre liste d’éléments prise en charge. De nombreux éléments de la vue Form utilisent le même schéma que les éléments CreateUiDefinition et renvoient vers ces pages de référence pour éviter la duplication du contenu, mais les deux formats ne supportent pas exactement les mêmes éléments.

schéma

Le schéma pour la plupart des éléments est le suivant :

{
  "name": "element1",
  "type": "Microsoft.Common.TextBox",
  "label": "Some text box",
  "defaultValue": "my value",
  "toolTip": "Provide a descriptive name.",
  "constraints": {},
  "options": {},
  "visible": true
}
Propriété Obligatoire Description
name Oui Identificateur interne pour faire référence à l’instance spécifique d’un élément. L’utilisation la plus courante du nom d’élément est dans outputs, où les valeurs de sortie des éléments spécifiés sont mises en correspondance avec les paramètres du modèle. Vous pouvez également l’utiliser pour lier la valeur de sortie d’un élément à la defaultValue d’un autre élément.
type Oui Contrôle de l’interface utilisateur pour effectuer le rendu de l’élément. Pour obtenir la liste des types pris en charge, consultez Éléments.
label Oui Texte d’affichage de l’élément. Certains types d’éléments contiennent plusieurs étiquettes. Par conséquent, la valeur pourrait être un objet contenant plusieurs chaînes.
defaultValue Non Valeur par défaut de l’élément. Certains types d’élément prennent en charge des valeurs par défaut complexes. Par conséquent, la valeur pourrait être un objet.
toolTip Non Texte à afficher dans l’info-bulle de l’élément. Comme pour label, certains éléments prennent en charge plusieurs chaînes d’info-bulle. Les liens inline peuvent être intégrés à l’aide de la syntaxe Markdown.
constraints Non Une ou plusieurs propriétés permettant de personnaliser le comportement de validation de l’élément. Les propriétés prises en charge pour constraints varient selon le type d’élément. Certains types d’éléments ne prennent pas en charge la personnalisation du comportement de validation et n’ont donc aucune propriété de contrainte.
options Non Propriétés supplémentaires qui personnalisent le comportement de l’élément. À l’instar de constraints, les propriétés prises en charge varient selon le type d’élément.
visible Non Indique si l’élément est affiché. Si la valeur est true, l’élément et les éléments enfants applicables sont affichés. La valeur par défaut est true. Utilisez les fonctions logiques pour contrôler de manière dynamique cette valeur de propriété.

Éléments

Les éléments suivants sont pris en charge dans createUiDefinition.json. La documentation de chaque élément contient un exemple d’interface utilisateur, un schéma, des remarques sur le comportement de l’élément (en général concernant la validation et la personnalisation prise en charge) et un exemple de sortie.

Pour les éléments pris en charge dans uiFormDefinition.json, y compris les sélecteurs de portée spécifiques à la vue Form, voir Éléments de la vue Form.

Étapes suivantes

Pour voir une présentation de la création de définitions d’interface utilisateur, consultez la page Prise en main de CreateUiDefinition.

  • Last updated on