Liste de bouton

Liste de boutons pour faire un choix simple. La liste est construite dynamiquement à partir d’une liste d’options.

NOTE Il n’est pas possible de sélectionner plusieurs boutons en même temps.

Sommaire

Propriétés spécifiques

Selection

La propriété spécifique Selection reflète la valeur sélectionnée en cours.

La valeur attendue est la value de l’une des options de l’acteur.

Chemin d’accès depuis l’acteur properties.value ⚡ Doc Script API

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.

Chemin d’accès depuis l’acteur properties.size ⚡ Doc Script API

En ligne

La propriété spécifique En ligne? permet de changer l’orientation d’empilement de la liste de boutons.

Lorsque cette propriété est activée, la liste est affichée sur une seule ligne, les boutons côte à côte.

A l’inverse, lorsqu’elle est désactivée, les boutons s’affichent sur une seule colonne, les uns en dessous des autres.

Chemin d’accès depuis l’acteur properties.isInline ⚡ Doc Script API

Options

La propriété spécifique Options permet de renseigner les boutons avec le format JSON.

Il y a trois paramètres à renseigner afin de créer un nouveau bouton via le format JSON :

  • value (OBLIGATOIRE):
    Renseigne la valeur du bouton.
    La valeur attendue est une chaine de caractère.

  • text (OBLIGATOIRE):
    Renseigne le texte qui est affiché sur le bouton.
    La valeur attendue est une chaine de caractère.

  • disabled (OPTIONNEL):
    Permet d’activer / désactiver le bouton.
    La valeur attendue est un booléen (true/false).
    Si cette option n’est pas précisée, la valeur par défaut est False.

EXEMPLE Voici une liste de 3 boutons, dont le dernier est désactivé :

[
  {
    "value": "bouton1",
    "text": "Button 1"
  },
  {
    "value": "bouton2",
    "text": "Button 2"
  },
  {
    "value": "bouton3",
    "text": "Button 3",
    "disabled": true
  }
]

Chemin d’accès depuis l’acteur properties.options ⚡ Doc Script API

Mode

La propriété spécifique Mode permet d’assigner des classes bootstrap à l’ensemble de la liste de bouton.

Chaque classe possède son code couleur propre.

Liste des options disponibles avec leurs exemples :

SynApps

Chemin d’accès depuis l’acteur properties.mode ⚡ Doc Script API

Dépassement de texte

La propriété spécifique Dépassement de texte permet de gérer l’affichage du texte dans le cas ou la taille du conteneur ne suffit pas à afficher l’entièreté du texte.

Il existe donc trois options pour cette propriété :

  • Sans retour à la ligne.
  • Retour à la ligne.
  • Tronqué.

Voici des exemples pour chacun des exemples :

Sans retour à la ligne

SynApps

Retour à la ligne

SynApps

⚠️ ATTENTION
La taille verticale de l’acteur est automatiquement adaptée à la taille du texte sauf si celle ci est fixée.

Tronqué

SynApps

Chemin d’accès depuis l’acteur properties.textOverflow ⚡ Doc Script API

Actif

La propriété spécifique Actif? permet d’activer / désactiver toute interaction avec la liste de tous les boutons.

Lorsque la propriété est désactivée, la liste de boutons concernée n’est pas cliquable par l’utilisateur. Les événements d’interaction sont de ce fait désactivés.

Lorsque la propriété est activée, la liste de boutons fonctionne normalement et tous ses événements sont activés.

Chemin d’accès depuis l’acteur properties.isActive ⚡ Doc Script API

Informations

Texte sélectionné

🚧 en cours de rédaction…

Évènements spécifiques

🚧 en cours de rédaction…