# Présentation

Un widget est un élément du tableau de bord qui permet d'**interagir** avec le système pour **lire ou modifier une variable.**

On distingue deux types de widgets :

- **les widgets d'action**  
    ils permettent d’envoyer des commandes d'action directement depuis le tableau de bord (par exemple un interrupteur pour allumer et éteindre un appareil).
- **les widgets d'états** ils permettent de visualiser des états ou des mesures sans possibilité d'interaction.

Selon le type de widget, différentes fonctionnalités peuvent être disponibles :

- affichage d’état,
- commande manuelle,
- variation,
- visualisation de mesures,
- retour d’information,
- pilotage d’équipements

### 1- Widgets d'action

- **Interrupteur** : permet de commander une sortie en ON/OFF.  
    *exemple : éclairage, relais*
- **Variateur** : permet d’ajuster une valeur sur une plage définie  
    *exemple : variation d’intensité lumineuse, consigne*
- <span style="color: rgb(34, 34, 34);">**Variateur d’ouvrant** : p</span>ermet de piloter la position d’un ouvrant (volet, BSO…)  
    *exemple : ouverture partielle, fermeture complète*
- <span style="color: rgb(34, 34, 34);">**Switch à glissière** : p</span>ermet de basculer entre plusieurs états  
    *exemple : auto / manuel / arrêt*

### 2- Widgets d'états

- <span role="text">**Capteur** (affichage de valeur) : a</span>ffiche une mesure issue d’un capteur  
    *exemple : température, humidité, niveau*
- **Voyant d’état** : indique l’état d’une variable  
    *exemple : marche/arrêt, défaut, alarme*

### <span role="text">3- Widgets avancés</span>

- <span style="color: rgb(34, 34, 34);">**Régulation** : p</span>ermet de piloter automatiquement un équipement en fonction d’une consigne et d’une mesure  
    *exemple : régulation de température, gestion de ventilation*

<p class="callout success">**💡 [Accès direct en mode application sur Smartphone](https://modlink.fr/help/link/206#bkmrk-3--acc%C3%A8s-en-mode-app)**   
Permet un accès rapide aux widgets pour piloter les équipements et consulter leur état.  
L’utilisateur peut **rester connecté** afin d’accéder aux widgets sans avoir à s’authentifier à chaque utilisation.</p>