> Mis à jour pour la version 6.0.30

Une variable **Sélection unique** ou **Sélection multiple** garde un choix parmi une liste fermée d'options que vous écrivez vous-même : un niveau de difficulté, une humeur, une catégorie, les objets pris par le joueur. Contrairement à un texte libre, la valeur ne peut jamais être mal orthographiée : c'est toujours l'une de vos options.

![La fenêtre Variables avec une variable Sélection unique ouverte, l'aperçu pour le joueur en haut et la liste des options en dessous](https://chatwoot.fr.nocodespacelab.com/rails/active_storage/blobs/redirect/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBBcmtKIiwiZXhwIjpudWxsLCJwdXIiOiJibG9iX2lkIn19--d7a64d9b74c7f075d4a76300b8552621420f2e80/aide-visuels--variable-panneau-selection-options.fr.png)
*La fenêtre Variables avec une variable Sélection unique ouverte, l'aperçu pour le joueur en haut et la liste des options en dessous.*

## À quoi ça sert

- **Sélection unique** : un seul choix à la fois, comme un niveau de difficulté (Facile, Normal, Difficile).
- **Sélection multiple** : plusieurs choix cochés en même temps, comme les objets de l'inventaire ou les centres d'intérêt du joueur.

Chaque option a un nom (son libellé) et, si vous le voulez, une couleur. Vous pouvez la renommer ou la déplacer à tout moment : les blocs qui l'utilisent continuent de fonctionner, car chaque option garde un identifiant interne qui ne change jamais.

## Créer la variable

1. Ouvrez la fenêtre **Variables**.
2. Cliquez sur **Ajouter variable**.
3. Donnez un nom à la variable, puis choisissez le type **Sélection unique** ou **Sélection multiple**.
4. Validez avec **Ajouter**.

> 🔺 **À savoir :** le type d'une variable ne peut pas être changé après sa création (« Le type d'une variable ne peut pas être changé »). Si vous hésitez, lisez [Choisir le type d'une variable](https://documentation.celestory.io/hc/celestorydoc/articles/1795347773-choisir-le-type-d-une-variable).

Si la variable n'a pas encore de valeur, le panneau propose le bouton **Ajouter un choix unique** (ou **Ajouter un choix multiple**) : cliquez dessus pour créer la valeur de départ.

## Écrire les options

Le panneau a deux positions, **Visuel** et **Source**. Dans **Visuel**, la section **Options** liste vos options.

1. Dans le champ **Première option**, tapez le nom de l'option, par exemple « Facile ».
2. Appuyez sur Entrée ou cliquez sur **Ajouter**. Le champ reste prêt pour l'option suivante (il s'appelle alors **Nouvelle option**).
3. Répétez pour chaque option.

![La section Options avec trois options, leur pastille de couleur, les flèches et la poignée](https://chatwoot.fr.nocodespacelab.com/rails/active_storage/blobs/redirect/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBBcm9KIiwiZXhwIjpudWxsLCJwdXIiOiJibG9iX2lkIn19--2843c181b684f959e14dcdc1261a32caeef2bd69/aide-visuels--selection-section-options.fr.png)
*La section Options avec trois options, leur pastille de couleur, les flèches et la poignée.*

Sur chaque ligne, vous pouvez :

- **renommer** l'option en cliquant sur son nom, puis valider avec Entrée ;
- **changer sa couleur** en cliquant sur la pastille : la palette propose dix teintes (Bleu, Cyan, Vert, Orange, Rouge, Marron, Violet, Rose, Gris, Jaune) en quatre intensités (clair, moyen, foncé, très foncé), ou **Sans couleur** ;
- **réordonner** en glissant la poignée, avec les boutons flèche vers le haut et vers le bas de la ligne, ou avec Alt + flèche haut ou bas dans le nom de l'option ;
- **supprimer** avec le bouton **Supprimer l'option**.

Après une suppression, un message « Option « Facile » supprimée. » apparaît avec le bouton **Annuler** : l'option revient à sa place, avec son identifiant d'origine, donc les blocs qui s'y référaient refonctionnent. Cochez **Afficher les identifiants** pour voir l'identifiant de chaque option.

## Choisir la valeur de départ

La section **Aperçu pour le joueur** montre la liste telle que le joueur la verrait. C'est ici que vous choisissez la **valeur au lancement du graphe** (la valeur par défaut) :

- pour une **Sélection unique**, cliquez sur une option ; **Effacer le choix** retire la sélection. Le réglage **Aspect de l'aperçu** (**Liste** ou **Menu déroulant**) ne change que l'aperçu, pas la variable ;
- pour une **Sélection multiple**, cochez les options de départ ; un compteur indique par exemple « 2 sur 5 ».

Une phrase sous l'aperçu résume l'état : « Pour le moment, Difficulté vaut « Normal ». » Si vous supprimez l'option choisie, la valeur de départ est simplement vide.

![L'aperçu en mode Menu déroulant, avec la phrase de résumé en dessous](https://chatwoot.fr.nocodespacelab.com/rails/active_storage/blobs/redirect/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBBcnNKIiwiZXhwIjpudWxsLCJwdXIiOiJibG9iX2lkIn19--a7fbac46432f14c1c65c101dba4442cba050b839/aide-visuels--selection-apercu-menu-deroulant.fr.png)
*L'aperçu en mode Menu déroulant, avec la phrase de résumé en dessous.*

## Utiliser la variable dans les blocs

- **Assignation** : choisissez la variable, puis la ou les options à lui donner. Pour une sélection multiple, l'assignation remplace les options cochées.
- **Liste contient** : branchez la variable sur l'entrée **liste** et une option sur l'entrée **valeur** ; le bloc répond oui ou non selon que l'option est choisie (pour une sélection unique) ou cochée (pour une sélection multiple).
- **Choix multiple** : ce bloc écrit les cases cochées du joueur dans une variable Sélection unique ou multiple. Voir [🟩 Choix multiple](https://documentation.celestory.io/hc/celestorydoc/articles/fr-blocs-choix-multiple-9871b9).
- **Baserow** : voir plus bas.

## L'afficher dans un texte ou un menu

Écrivez `{{difficulte}}` dans un dialogue, un narrateur, une alerte ou une slide : le texte affiche le **libellé** de l'option choisie, pas son identifiant. Pour une sélection multiple, les libellés sont séparés par des virgules.

Dans l'éditeur de menus, l'élément **Variable** accepte aussi ces deux types et affiche les libellés choisis.

## Traduire les libellés

Les libellés des options se traduisent avec le reste du projet. Dans la fenêtre **Traductions**, **Exporter un fichier PO** inclut les options de vos variables, et **Importer un fichier PO** les relit une fois traduites. Chaque traduction indique « libellé d'option traduit sur ... » avec son pourcentage de complétion. Le joueur voit la traduction de sa langue, ou à défaut le libellé que vous avez écrit. Voir [La Fenêtre Traductions](https://documentation.celestory.io/hc/celestorydoc/articles/fr-decouvrir-celestory-la-fenetre-traductions-0ca984).

## Avec Baserow

Un champ Baserow de type sélection unique ou sélection multiple est lu comme une variable Sélection unique ou multiple, avec les options (et les couleurs) du champ. En écriture, le bloc envoie l'option choisie à Baserow. Si une option n'existe pas dans le champ, rien n'est écrit et un message le dit : ajoutez l'option dans Baserow, puis cliquez sur **Synchroniser les colonnes** dans la configuration Baserow du bloc. Voir [🗄 Créez votre base de données avec Baserow](https://documentation.celestory.io/hc/celestorydoc/articles/fr-donnees-creez-votre-base-de-donnees-avec-baserow-622b1d).

## Dépannage

| Message | Solution |
|---|---|
| Saisissez un nom pour la nouvelle option, par exemple « Oui » ou « Rouge », puis validez de nouveau. | Le champ était vide : tapez un nom avant Entrée ou **Ajouter**. |
| Le nom d'une option ne peut pas être vide. | Le nom précédent est conservé. Saisissez un autre nom ou supprimez l'option. |
| Une autre option porte aussi le nom « Rouge ». | Les deux options restent distinctes, mais renommez-en une pour ne pas les confondre. |
| Rien n'a été écrit : le champ Baserow n'a pas d'option nommée ... | Choisissez une option du champ, ou ajoutez-la dans Baserow puis synchronisez les colonnes. |

## Voir aussi

- [Choisir le type d'une variable](https://documentation.celestory.io/hc/celestorydoc/articles/1795347773-choisir-le-type-d-une-variable)
- [🟩 Choix multiple](https://documentation.celestory.io/hc/celestorydoc/articles/fr-blocs-choix-multiple-9871b9)
- [⛓ Variables](https://documentation.celestory.io/hc/celestorydoc/articles/fr-decouvrir-celestory-variables-634855)
- [La Fenêtre Traductions](https://documentation.celestory.io/hc/celestorydoc/articles/fr-decouvrir-celestory-la-fenetre-traductions-0ca984)
