Partager via

Éléments de CreateUiDefinition

  • Article

Cet article décrit le schéma et les propriétés de tous les éléments pris en charge d’un fichier createUiDefinition.json .

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

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.

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