Liste de cases à cocher
Acteur d’interaction qui permet d’afficher une liste de cases à cocher. Cette liste peut être une arborescence. L’acteur possède deux modes de sélection : simple et multiple.
Sommaire
Propriétés
Sélection
La propriété Sélection est une chaîne qui la valeur qui correspond au choix dans la liste des options.
Exemples:
l’option 1 est sélectionnée :
value1
Aucune valeur n’est sélectionnée si la valeur est une chaîne vide.
Les options
La propriété Options est une chaîne JSON
qui contient un tableau d’options.
Une option est un object JSON
qui possède les propriétés suivantes :
CHAMPS | DESCRIPTION | PAR DÉFAUT |
---|---|---|
value | La valeur de l’option. C’est son identifiant unique dans la liste. De préférence, la valeur est une chaîne de caractères. | - |
text | Le texte qui s’affiche à coté de la case à cocher. | - |
disabled | Indique si l’option doit apparaître désactivée. | false |
Exemple :
[
{
"value": "value1",
"text": "Option 1"
},
{
"value": "value2",
"text": "Option 2"
},
{
"value": "value3",
"text": "Option 3"
}
]
État de validation
L’acteur possède une propriété état de validation qui permet de présenter l’acteur dans des état de validation différents :
- Valide : l’acteur est vert.
- Invalide : l’acteur est rouge.
- Normal : l’acteur est normale.
Cette couleur prend le pas sur la propriété couleur qui est normalement utilisée pour définir la couleur du texte.
Taille
La propriété spécifique Taille
permet de changer celle de l’acteur.
Cette propriété possède trois options :
- Par défaut.
- Grand.
- Petit.
Seul le choix par défaut vous laisse la possibilité de modifier la taille du texte. Les autres options prennent le pas sur tout autre réglage.
Champs d’information
Texte sélectionné
Le champ d’information Texte sélectionné contient le texte correspondant à l’option sélectionné.
Liste des options
Le tableau des options est accessible dans le champ d’information Liste des options.
Événements
onSelected
L’évènement onSelected
est déclenché lorsque la sélection change.