> 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-pt/kilo-iot-server/dashboards/adding-widgets/control-widget/slider-circular.md).
# Deslizador Circular
Adicione um controlo de Deslizador Circular a um painel IoT Kilo — um mostrador radial que define o valor de um dispositivo com aspeto de instrumento.
A **Circular** controlo deslizante define um **valor numérico** num mostrador radial — arraste ao longo do arco e o valor acompanha. Tem o aspeto de um indicador de instrumento, por isso chama a atenção para uma definição em destaque.
## Quando usá-lo
Opte pelo deslizador Circular quando um mostrador se lê melhor do que uma barra — um **temperatura da cor**, um **posição da válvula** como percentagem, ou qualquer definição única que queira destacar num ecrã de controlo. Para um controlo compacto na mesma linha, use o [Deslizador simples](/kilo-docs-pt/kilo-iot-server/dashboards/adding-widgets/control-widget/slider-simple.md); para um controlo ao estilo de nível, use o [Controlo deslizante vertical](/kilo-docs-pt/kilo-iot-server/dashboards/adding-widgets/control-widget/slider-vertical.md).
## O que precisa primeiro
* Um dispositivo controlável com um comando na sua **Comandos e estados** separador cujo **parâmetro aceita um número** (ver [Criar comandos](/kilo-docs-pt/kilo-iot-server/devices/commands/creating-commands.md)).
* Um **métrica do dispositivo** que indica o valor atual, para que o mostrador mostre onde a definição se encontra.
## Como configurá-lo
1. Abra o painel no **modo de edição** → **Adicionar widget** → **Controlo**.
2. **Fonte de dados** separador: escolha o **Dispositivo** e o **métrica do dispositivo** para o valor em tempo real. Clique em **Seguinte**.
3. **Aparência** separador: introduza um **Nome do widget**, escolha **Tipo de widget → Slider**, depois defina **Tipo de deslizador → Circular**.
4. Defina o **Comando**, os valores **Parâmetro** que ele define, e um **Valor**.
5. Adicione **Rótulos de início e fim** para o intervalo (por ex. `150` e `500`) com **Mostrar** ativado, escolha um **Cor do slider**, e alterne **Mostrar nome e última atualização**.
6. Clica em **Guardar**.
## O que acontece quando o utiliza
Arrastar ao redor do mostrador envia o comando com o novo valor como parâmetro. A posição do mostrador segue o **métrica do dispositivo**, para que reflita sempre o valor que o dispositivo indica.
## Erros comuns
* **Confundi-lo com o Indicador Radial** — o deslizador Circular *define* um valor (é um controlo); os Últimos Dados [Medidor Radial](/kilo-docs-pt/kilo-iot-server/dashboards/adding-widgets/last-data-widget/radial-gauge.md) apenas *apresenta* um.
* **Sem parâmetro numérico** — como qualquer deslizador, precisa de um parâmetro de comando que possa definir como um número; para ligar/desligar, use um [Interruptor](/kilo-docs-pt/kilo-iot-server/dashboards/adding-widgets/control-widget/switch.md).
## Ver também
* [Widget de controlo](/kilo-docs-pt/kilo-iot-server/dashboards/adding-widgets/control-widget.md) — visão geral e os outros tipos de controlo
* Outros layouts de slider: [Deslizador simples](/kilo-docs-pt/kilo-iot-server/dashboards/adding-widgets/control-widget/slider-simple.md) · [Controlo deslizante vertical](/kilo-docs-pt/kilo-iot-server/dashboards/adding-widgets/control-widget/slider-vertical.md)
* [Comandos do dispositivo](/kilo-docs-pt/kilo-iot-server/devices/commands.md) — defina o comando que este mostrador controla
---
# 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-pt/kilo-iot-server/dashboards/adding-widgets/control-widget/slider-circular.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.
