# Widget Fréquence (expositions) (/docs/dashboards/widget-frequence)
## Vue d'ensemble [#vue-densemble]
Le widget **Fréquence** répond à la question « **à quoi mes joueurs ont-ils été exposés** sur la période ? ». Il ne trace pas d'indicateur : il **compte les événements** de la période (selon les filtres du dashboard) et les répartit en catégories.
Exemples :
* part du temps passé **Apte / Adapté / Blessé…** par un joueur sur le mois,
* volume de **séances vs matchs vs rendez-vous** de l'équipe,
* **couverture des tags** (combien de temps en « Vitesse », « Tactique », « Réathlétisation »…).
## Étapes [#étapes]
### 1. Ajouter le widget [#1-ajouter-le-widget]
En mode édition, glisse **Fréquence** (*« Répartition des expositions par statut, type ou tags »*) depuis l'onglet **Graphiques** de la barre latérale. Aucun indicateur n'est à choisir : le configurateur s'ouvre directement sur l'onglet **Fréquence**.
### 2. Choisir la dimension [#2-choisir-la-dimension]
| **Dimension** | Ce qui est réparti |
| -------------------- | --------------------------------------------------------------------------------------------------------- |
| **Statut** | Les présences par statut des joueurs (séances et matchs). |
| **Type d'événement** | Séances, matchs, rendez-vous, réunions. |
| **Tags** | La couverture des tags des séances et matchs. Les tags hors séance sont listés à part, sous le graphique. |
### 3. Choisir le rendu [#3-choisir-le-rendu]
| **Rendu** | Description |
| ------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Camembert** | La part de chaque catégorie, avec le total au centre. |
| **Barres de progression** | Une barre horizontale par catégorie, très lisible en petit format. |
| **Histogramme** | Une barre verticale par catégorie. |
| **Empilé** | Des barres empilées, avec un **Découpage des barres** : **Par joueur** (une barre par joueur ; une seule barre sur un dashboard individuel) ou **Par période** (une barre par **Semaine** ou par **Mois**). |
| **Dynamique** | L'enchaînement des séances et matchs du joueur : une barre colorée par statut de présence, un trophée sous les matchs. Réservé aux dashboards **filtrés sur un joueur**. Option **Afficher les meilleures séries de disponibilité** (plus longue série et série en cours). |
### 4. Régler les options [#4-régler-les-options]
Pour tous les rendus sauf Dynamique :
| **Option** | Description |
| -------------------------------- | -------------------------------------------------------------------------------------------------------- |
| **Unité** | **Durée**, **Nombre** ou **Pourcentage**. |
| **Tri** | **Valeur décroissante** ou **Ordre métier** (ordre fixe des catégories, stable d'une période à l'autre). |
| **Granularité** | **Semaine** ou **Mois** (rendu Empilé par période uniquement). |
| **Nombre maximum de catégories** | De 3 à 15, ou **Toutes**. Au-delà, les catégories restantes sont regroupées dans « Autres ». |
Section **Affichage** : **Afficher la légende**, **Afficher les valeurs**, et le choix des informations affichées à côté de chaque catégorie (**Durée**, **Nombre**, **Pourcentage**, combinables).
### 5. Personnaliser les couleurs [#5-personnaliser-les-couleurs]
La section **Couleurs** liste les catégories après le premier calcul du widget. Par défaut elles reprennent les couleurs des cycles ; tu peux changer chaque couleur (**Réinitialiser** pour revenir au défaut) et cliquer sur l'**œil** pour **masquer une catégorie**.
Le masquage est **purement visuel** : les valeurs et pourcentages des
autres catégories ne sont **pas recalculés**. Pour retirer réellement
des événements du calcul, utilise l'onglet **Pré-filtre**.
### 6. Restreindre les événements (optionnel) [#6-restreindre-les-événements-optionnel]
L'onglet **Pré-filtre** est disponible comme sur les autres widgets : types d'événements, tags à inclure ou à exclure, réinclusion des données hors analyse collective. → [Pré-filtre par widget](/docs/dashboards/pre-filtre-widget)
## Erreurs à éviter [#erreurs-à-éviter]
* **Choisir Dynamique sur un dashboard d'équipe** : le rendu est grisé et n'est disponible qu'avec un joueur sélectionné.
* **Croire qu'une catégorie masquée sort du total** : le masquage ne change pas les pourcentages ; passe par le pré-filtre.
* **Une catégorie « Autres » trop grosse** : augmente le **Nombre maximum de catégories** ou coche **Toutes**.
* **Un widget vide** (*« Aucune exposition sur la période »*) : vérifie la période et les filtres du dashboard, puis le pré-filtre du widget.
## Aller plus loin [#aller-plus-loin]