# Blocs réutilisables (/docs/creation-seances/blocs-reutilisables)



## Vue d'ensemble [#vue-densemble]

Un **bloc** est un élément que tu enregistres une fois pour le réutiliser dans plusieurs séances. Trois types de blocs existent dans FormaPulse :

* **Bloc séance** : un ensemble de **sections** d'une séance (échauffement, ateliers, etc.) que tu sélectionnes via des **checkboxes** dans la structure de la séance.
* **Bloc terrain*&#x2A; &#x2A;(type interne « exercice »)* : une configuration d'éléments (images, matériels, structures) posés sur le **canvas terrain** d'un exercice.
* **Bloc libre** : une configuration d'éléments posés sur le **canvas libre**, indépendante d'un exercice terrain.

<VideoYoutube id="Q97o3zsmDao" titre="AMS Formapulse — Blocs réutilisables" />

## Quand utiliser un bloc plutôt qu'un exercice [#quand-utiliser-un-bloc-plutôt-quun-exercice]

| Situation                                                                  | Préférence   |
| -------------------------------------------------------------------------- | ------------ |
| Un exercice unique qui revient parfois                                     | Exercice     |
| Un enchaînement de sections toujours identique (ex: échauffement standard) | Bloc séance  |
| Une configuration d'éléments terrain qui revient                           | Bloc terrain |
| Un schéma / contenu créé sur le canvas libre à réutiliser tel quel         | Bloc libre   |

## Étape 1 — Toujours commencer par « Outils » [#étape-1--toujours-commencer-par--outils-]

Quel que soit le type de bloc, tu démarres depuis le panneau **Outils** dans le créateur de séance :

1. Ouvre le créateur (**Création > Créateur**).
2. Clique sur **Outils** dans la barre.
3. Selon le mode dans lequel tu te trouves, le bouton affiche :
   * **« Créer bloc séance »** quand tu es sur la structure de la séance.
   * **« Créer bloc spécifique »** quand tu es sur un canvas terrain (mode exercice) ou sur le canvas libre.
4. Clique dessus. Tu passes en **mode sélection** : un bandeau vert apparaît en haut.

La suite dépend du type de bloc.

***

## Créer un bloc séance [#créer-un-bloc-séance]

**Contexte** : tu es sur la structure de séance (mode par défaut du créateur).

### Sélectionner les sections [#sélectionner-les-sections]

Une fois en mode sélection, une **checkbox apparaît à gauche de chaque section** de ta séance. Coche toutes les sections que tu veux inclure dans le bloc.

Le bandeau vert en haut affiche en temps réel :

> *« X section(s) sélectionnée(s) (Y série(s)) »*

### Valider la sélection [#valider-la-sélection]

Clique sur **Créer le bloc*&#x2A; dans le bandeau vert. Une fenêtre &#x2A;*« Créer un bloc réutilisable »** s'ouvre.

### Renseigner les informations [#renseigner-les-informations]

| Champ                                 | Description                                                                                                                |
| ------------------------------------- | -------------------------------------------------------------------------------------------------------------------------- |
| **Nom du bloc**                       | Ex : &#x2A;« Échauffement standard »&#x2A;, &#x2A;« Circuit cardio »*                                                      |
| **Type de bloc**                      | Préselectionné sur **Bloc séance** (non modifiable)                                                                        |
| **Catégorie*&#x2A; &#x2A;(optionnel)* | Choisis une catégorie existante ou crée-en une nouvelle. C'est elle qui détermine le rangement du bloc dans **Mes blocs**. |

Récapitulatif affiché : nombre de sections sélectionnées + nombre de séries incluses.

### Enregistrer [#enregistrer]

Clique sur **Créer le bloc**. Le bloc est sauvegardé et disponible dans **Mes blocs** sous l'onglet **Séance**.

***

## Créer un bloc terrain ou libre [#créer-un-bloc-terrain-ou-libre]

**Contexte** : tu es sur un **canvas** — soit le canvas terrain d'un exercice (mode terrain), soit le canvas libre.

### Sélectionner les éléments sur le canvas [#sélectionner-les-éléments-sur-le-canvas]

Avant de cliquer dans Outils, **sélectionne d'abord les éléments** que tu veux inclure dans le bloc directement sur le canvas (images, matériels, structures, dessins). Tu peux sélectionner plusieurs éléments d'un coup avec un rectangle de sélection.

### Lancer la création [#lancer-la-création]

Ouvre **Outils** et clique sur **Créer bloc spécifique**. Le bouton affiche le nombre d'éléments sélectionnés :

> *« Créer un bloc (N) »*

Si aucun élément n'est sélectionné, le bouton est grisé.

### Renseigner les informations [#renseigner-les-informations-1]

La même fenêtre &#x2A;*« Créer un bloc réutilisable »** s'ouvre :

| Champ                                 | Description                                                                                                                 |
| ------------------------------------- | --------------------------------------------------------------------------------------------------------------------------- |
| **Nom du bloc**                       | Ex : &#x2A;« Plot couloir 5m »&#x2A;, &#x2A;« Circuit conduite de balle »*                                                  |
| **Type de bloc**                      | Préselectionné sur **Bloc terrain** (depuis un canvas exercice) ou **Bloc libre** (depuis le canvas libre) — non modifiable |
| **Catégorie*&#x2A; &#x2A;(optionnel)* | Choisis une catégorie existante ou crée-en une nouvelle                                                                     |

Récapitulatif affiché : &#x2A;« Éléments sélectionnés : N »*.

### Enregistrer [#enregistrer-1]

Clique sur **Créer le bloc**. Le bloc est sauvegardé et disponible dans **Mes blocs** sous l'onglet **Exercice** ou **Libre** selon le contexte.

***

## Réutiliser un bloc [#réutiliser-un-bloc]

À chaque endroit pertinent du créateur, un panneau **Mes blocs** est disponible :

* Dans la **structure de séance** : bouton **Blocs** à côté du bouton « Ajouter une section ». Onglet **Séance** disponible.
* Sur un **canvas terrain** : bouton **Mes blocs** dans le header du canvas. Onglet **Exercice** disponible.
* Sur le **canvas libre** : bouton **Mes blocs** dans le header du canvas. Onglet **Libre** disponible.

Dans le popover :

* Recherche par nom ou catégorie : &#x2A;« Rechercher (nom ou catégorie)… »*
* Affichage groupé par catégorie (accordéon)
* Pour chaque bloc : nom + métadonnées (&#x2A;« X sections · Y séries »&#x2A; ou &#x2A;« X éléments »*)
* Lien **Tous mes blocs** en bas du popover → ouvre la bibliothèque complète

Clique sur un bloc pour l'insérer. Le bloc inséré devient **indépendant** : tu peux l'adapter sans impacter le bloc d'origine.

## Bibliothèque complète [#bibliothèque-complète]

URL : **/creation/blocs** — accessible aussi via le lien **Tous mes blocs** dans le popover.

Titre de la page : **Mes blocs réutilisables**.

Tu y retrouves tous tes blocs avec :

* **Onglets** : *Tous*, *Séance*, *Exercice*, *Libre*
* **Recherche*&#x2A; : &#x2A;« Rechercher un bloc… »*
* **Filtre catégorie** : *Toutes les catégories* par défaut, ou filtre sur une catégorie précise
* **Gérer les catégories** : bouton qui ouvre la fenêtre de gestion (renommer, changer la couleur, supprimer)
* Sur chaque bloc : actions **Modifier** et **Supprimer**

## Erreurs à éviter [#erreurs-à-éviter]

* **Bloc trop figé** : si ton bloc échauffement contient les 8 mêmes exercices à chaque fois, le staff finit par s'ennuyer. Garde 2-3 variantes.
* **Modifier un bloc et s'attendre à ce que ça impacte les séances passées** : non, les blocs insérés deviennent indépendants. Pour propager une modification, recrée les séances concernées.
* **Cliquer sur « Créer bloc spécifique » sans avoir sélectionné d'éléments sur le canvas** : le bouton reste grisé et le bloc ne peut pas être créé.

## Aller plus loin [#aller-plus-loin]

<Cards>
  <Card title="Créer un exercice" href="/docs/creation-seances/creer-exercices" />

  <Card title="Construire une séance" href="/docs/creation-seances/creer-une-seance" />

  <Card title="Créer une séance avec exercice" href="/docs/creation-seances/creer-seance-exercice" />
</Cards>
