> 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-de/kilo-iot-server/dashboards/adding-widgets/control-widget/slider-circular.md).

# Kreisförmiger Schieberegler

Fügen Sie einem Kilo-IoT-Dashboard eine kreisförmige Schiebereglersteuerung hinzu — ein radialer Drehregler, der einen Gerätewert mit Instrumentencharakter festlegt.

Die **Kreisförmig** Schieberegler setzt einen **numerischen Wert** auf einem Radialregler — ziehe entlang des Bogens, und der Wert folgt. Es sieht aus wie ein Instrumentenanzeiger, sodass es den Blick auf eine Haupteinstellung lenkt.

## Wann Sie sie verwenden

Greife zum Circular-Slider, wenn sich ein Drehregler besser lesen lässt als ein Balken — ein **Farbtemperatur**, eine **Ventilstellung** als Prozentsatz oder jede einzelne Einstellung, die auf einem Bedienbildschirm hervorstechen soll. Für eine kompakte Inline-Steuerung verwende den [Einfachen Schieberegler](/kilo-docs-de/kilo-iot-server/dashboards/adding-widgets/control-widget/slider-simple.md); für eine Steuerung im Pegelstil verwende den [Vertikaler Schieberegler](/kilo-docs-de/kilo-iot-server/dashboards/adding-widgets/control-widget/slider-vertical.md).

## Was Sie zuerst benötigen

* Ein steuerbares Gerät mit einem Befehl auf seiner **Befehle & Status** Registerkarte, deren **Parameter eine Zahl annimmt** (siehe [Befehle erstellen](/kilo-docs-de/kilo-iot-server/devices/commands/creating-commands.md)).
* Eine **Geräte-Metrik** der den aktuellen Wert meldet, sodass der Drehregler zeigt, wo die Einstellung steht.

## So richten Sie es ein

1. Öffnen Sie das Dashboard in **Bearbeitungsmodus** → **Widget hinzufügen** → **Steuerung**.
2. **Datenquelle** Registerkarte: Wählen Sie das **Gerät** und die **Geräte-Metrik** für den Live-Wert. Klicken Sie **Weiter**.
3. **Erscheinungsbild** Registerkarte: Geben Sie einen **Widget-Name**, wählen Sie **Widget-Typ → Schieberegler**, dann setzen Sie **Schieberegler-Typ → Kreisförmig**.
4. Legen Sie die **Befehl**, den **Parameter** festlegt, und ein Anfangs **Wert**.
5. Hinzufügen **Start- und Endbeschriftungen** für den Bereich (z. B. `150` und `500`) mit **Anzeige** ein, wählen Sie einen **Schiebereglerfarbe**, und schalten Sie **Anzeigename und letzte Aktualisierung**.
6. Klicken Sie auf **Speichern**.

<figure><img src="https://895787959-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FtNQh1wBSHSaknslMdOXm%2Fuploads%2Fgit-blob-33e6f30422fee72f97282e0ea9dddb023555058c%2Fcontrol-widget-slider-circular.jpg?alt=media" alt="Control widget Circular slider — a radial dial setting a value across a range"><figcaption></figcaption></figure>

## Was passiert, wenn Sie es verwenden

Das Ziehen um den Drehregler herum sendet den Befehl mit dem neuen Wert als Parameter. Die Position des Reglers folgt dem **Geräte-Metrik**, sodass sie stets den vom Gerät gemeldeten Wert widerspiegelt.

## Häufige Fehler

* **Verwechslung mit dem Radialen Messgerät** — der Circular-Slider *setzt* einen Wert (es ist ein Bedienelement); die Last Data [Radialmessgerät](/kilo-docs-de/kilo-iot-server/dashboards/adding-widgets/last-data-widget/radial-gauge.md) nur *zeigt* einen.
* **Kein numerischer Parameter** — wie jeder Schieberegler benötigt er einen Befehlsparameter, den er auf einen numerischen Wert setzen kann; für Ein/Aus verwende einen [Schalter](/kilo-docs-de/kilo-iot-server/dashboards/adding-widgets/control-widget/switch.md).

## Siehe auch

* [Steuerungs-Widget](/kilo-docs-de/kilo-iot-server/dashboards/adding-widgets/control-widget.md) — Überblick und die anderen Steuerungstypen
* Andere Schieberegler-Layouts: [Einfachen Schieberegler](/kilo-docs-de/kilo-iot-server/dashboards/adding-widgets/control-widget/slider-simple.md) · [Vertikaler Schieberegler](/kilo-docs-de/kilo-iot-server/dashboards/adding-widgets/control-widget/slider-vertical.md)
* [Gerätebefehle](/kilo-docs-de/kilo-iot-server/devices/commands.md) — definiere den Befehl, den dieser Drehregler steuert


---

# 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-de/kilo-iot-server/dashboards/adding-widgets/control-widget/slider-circular.md?ask=<question>&goal=<endgoal>
```

`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.
