> For the complete documentation index, see [llms.txt](https://docs.kiloiot.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.kiloiot.io/kilo-docs-fr/kilo-iot-server/dashboards/adding-widgets/control-widget/slider-simple.md).
# Curseur simple
Ajoutez un contrôle Curseur simple à un tableau de bord Kilo IoT — un curseur horizontal qui définit une valeur d’appareil sur une plage.
Les **Simple** un curseur est une piste horizontale que vous faites glisser pour définir une **valeur numérique**. C'est la disposition de curseur la plus compacte des trois et s'intègre parfaitement dans une rangée de tuiles de tableau de bord.
## Quand l'utiliser
Utilisez un curseur Simple pour toute valeur qu'un opérateur augmente ou diminue lorsque une commande horizontale est naturelle : une **vitesse de moteur ou de ventilateur**, un **niveau de gradation**, ou un **point de consigne cible**. Si vous souhaitez plutôt un aspect de type niveau ou instrument, voir le [Curseur vertical](/kilo-docs-fr/kilo-iot-server/dashboards/adding-widgets/control-widget/slider-vertical.md) ou [Curseur circulaire](/kilo-docs-fr/kilo-iot-server/dashboards/adding-widgets/control-widget/slider-circular.md).
## Ce qu'il vous faut d'abord
* Un appareil contrôlable avec une commande sur son **Commandes et états** onglet dont le **paramètre prend un nombre** (voir [Créer des commandes](/kilo-docs-fr/kilo-iot-server/devices/commands/creating-commands.md)).
* A **métrique d'appareil** qui renvoie la valeur actuelle, afin que le curseur indique où se trouve le réglage.
## Comment le configurer
1. Ouvrez le tableau de bord en **mode édition** → **Ajouter un widget** → **Contrôle**.
2. **Source de données** onglet : choisissez le **Appareil** et le **métrique d'appareil** pour la valeur en direct. Cliquez sur **Suivant**.
3. **Apparence** onglet : saisissez un **Nom du widget**. 9. Sous **Type de widget → Curseur**, puis définissez **Type de curseur → Simple**.
4. Définissez les **Commande** le curseur pilote, le **Paramètre** qu'il définit, et une valeur de départ **Valeur**.
5. Ajouter **Étiquettes de début et de fin** pour la plage (par exemple `150` et `500`) et activez **Affichage** pour les afficher ; choisissez une **Couleur du curseur** et activez **Nom affiché et dernière mise à jour**.
6. Cliquez sur **Enregistrer**.
## Ce qui se passe lorsque vous l'utilisez
Faire glisser le curseur envoie la commande choisie avec la nouvelle valeur comme paramètre, via le pipeline de commandes de l'appareil. Le curseur suit la **métrique d'appareil**, donc il reflète la valeur réellement signalée par l'appareil.
## Erreurs courantes
* **Lier une commande sans paramètre numérique** — un curseur a besoin d'un paramètre qu'il peut définir sur un nombre ; une commande marche/arrêt simple appartient à un [Interrupteur](/kilo-docs-fr/kilo-iot-server/dashboards/adding-widgets/control-widget/switch.md).
* **Plage qui ne correspond pas à l'appareil** — définissez Début/Fin sur le minimum et le maximum réels du paramètre afin que toute la course corresponde à des valeurs valides.
## Voir aussi
* [widget de contrôle](/kilo-docs-fr/kilo-iot-server/dashboards/adding-widgets/control-widget.md) — aperçu et les autres types de contrôle
* Autres dispositions de curseur : [Curseur circulaire](/kilo-docs-fr/kilo-iot-server/dashboards/adding-widgets/control-widget/slider-circular.md) · [Curseur vertical](/kilo-docs-fr/kilo-iot-server/dashboards/adding-widgets/control-widget/slider-vertical.md)
* [Commandes de l’appareil](/kilo-docs-fr/kilo-iot-server/devices/commands.md) — définissez la commande que ce curseur pilote
---
# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.
## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:
```
GET https://docs.kiloiot.io/kilo-docs-fr/kilo-iot-server/dashboards/adding-widgets/control-widget/slider-simple.md?ask=&goal=
```
`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
