# Ajouter de l'aléatoire

> Apprenez à ajouter de l’aléatoire dans vos projets PandaSuite grâce à la variable Nombre aléatoire et à la fonction Shuffle.

https://docs.pandasuite.com/fr/essentials/gamification/random/

**Dans vos projets interactifs, un brin d’imprévu peut rendre l’expérience plus engageante et variée. Avec PandaSuite, deux outils complémentaires permettent d’introduire de la surprise dans vos scénarios : la variable Nombre aléatoire et la fonction Shuffle.**

## Pourquoi utiliser des mécanismes aléatoires ?

L’aléatoire est utile pour :

- Varier le contenu affiché à chaque lancement.
- Proposer des expériences uniques à chaque utilisateur.
- Simuler des comportements de hasard (tirages, jeux…).
- Mélanger des éléments d’une liste ou d’un groupe.

Dans PandaSuite, cela se fait grâce à :

- La variable **Nombre aléatoire**, qui génère un nombre flottant compris entre 0 et 1.
- La fonction **Shuffle**, qui mélange l’ordre d’une liste ou d’un groupe d’éléments.

## La variable Nombre aléatoire

### Qu’est-ce que c’est ?

La variable système **Nombre aléatoire** génère une nouvelle valeur à chaque actualisation.
Elle retourne un nombre décimal compris entre 0 et 1 (par exemple : 0,274 ou 0,859).

Cette valeur peut ensuite être utilisée dans des conditions logiques, des calculs ou affichée directement.

### Comment l’utiliser ?

Vous pouvez insérer la variable **Nombre aléatoire** dans vos scénarios pour :

- Comparer cette valeur à un seuil (exemple : si > 0,5…).
- Multiplier cette valeur par un entier pour obtenir une plage (exemple : Nombre aléatoire \* 5 donne une valeur entre 0 et 5).
- Créer des effets de hasard sans calcul compliqué.

> **Info**
>
> 💡 Pour obtenir un entier compris entre 1 et N, utilisez une formule de
> calcul : Arrondi(Nombre aléatoire × N) + 1

### Exemple : afficher une carte au hasard

- Créez une [Collection](https://docs.pandasuite.com/fr/essentials/data/collection/) contenant toutes vos cartes
- Sur le bouton, déclencher une action pour définir la valeur d'une variable *random\_index*

```
 random_index = Round (Nombre aléatoire × (Count-1)) + 1
  (où Count est le nombre de cartes de la collection)
```

- Affichez dynamiquement la carte correspondante en vous appuyant sur la valeur de la variable *random\_index*

[Image : Fenêtre Données de l'action du bouton de tirage : Random number, puis Multiply et Round ; l'action est encadrée à droite]

## La fonction Shuffle

La [fonction](https://docs.pandasuite.com/fr/essentials/data/functions/) **Shuffle** (mélanger en français) permet de réorganiser aléatoirement l’ordre des éléments d’un **[Tableau](https://docs.pandasuite.com/fr/essentials/data/data-types/#tableau)** ou d’une **[Collection](https://docs.pandasuite.com/fr/essentials/data/data-types/#collection)**. S'il s'agit d'un **Tableau**, elle retourne un **Tableau**. Pour une **Collection**, elle retourne un **Multi-référence**. Vous pouvez également définir une limite pour contrôler le nombre d’éléments retournés.

### Comment l’utiliser ?

1. Placez les éléments que vous souhaitez mélanger dans une **Collection**.
2. Dans cet exemple, créez une variable de type **Multi-référence** qui pointe vers cette **Collection**.
3. Ajoutez une action pour initialiser cette variable nouvellement créée.
4. En **Valeur**, partez de votre collection et utilisez la fonction **Shuffle**.
5. Dans les **Paramètres**, précisez le nombre d’éléments à inclure dans le résultat mélangé.

[Image : Fenêtre Données : la collection cards suivie de la fonction Shuffle, qui retourne un Multi-référence de deux cartes au hasard]

### Cas d’usage

- Mélanger les questions d’un quiz.
- Réordonner des images ou cartes pour un jeu de mémoire.
- Créer des listes ou carrousels dynamiques.

## Ressources complémentaires

[Modèle : Cartes aléatoires](https://pandasuite.com/dashboard/use-template/c0r3GpYBaHn0WhDCjnLF)
