> 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-simple.md).

# Deslizador Simples

Adicione um controlo de Deslizador Simples a um painel IoT Kilo — um deslizador horizontal que define o valor de um dispositivo num intervalo.

O **Simples** controlo deslizante é uma faixa horizontal que você arrasta para definir um **valor numérico**. É o mais compacto dos três layouts de controlo deslizante e encaixa-se perfeitamente numa linha de mosaicos do painel.

## Quando usá-lo

Use um controlo deslizante Simples para qualquer valor que um operador aumente ou diminua, quando um controlo horizontal faça sentido naturalmente: um **velocidade do motor ou da ventoinha**, um **nível de regulação da intensidade**, ou um **valor de referência alvo**. Se quiser antes um aspeto de tipo nível ou de instrumento, consulte o [Controlo deslizante vertical](/kilo-docs-pt/kilo-iot-server/dashboards/adding-widgets/control-widget/slider-vertical.md) ou [Controlo deslizante circular](/kilo-docs-pt/kilo-iot-server/dashboards/adding-widgets/control-widget/slider-circular.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 reporta o valor atual, para que o controlo deslizante 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 slider → Simples**.
4. Defina o **Comando** que o slider aciona, o **Parâmetro** que ele define, e um **Valor**.
5. Adicione **Rótulos de início e fim** para o intervalo (por exemplo `150` e `500`) e ative **Mostrar** para os exibir; escolha uma **Cor do slider** e ative **Mostrar nome e última atualização**.
6. Clique em **Guardar**.

<figure><img src="https://585438662-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FtNQh1wBSHSaknslMdOXm%2Fuploads%2Fgit-blob-2bbf1273afbafc86a68891a91e7f62498d3a5a70%2Fcontrol-widget-slider-simple.jpg?alt=media" alt="Control widget Simple slider — a horizontal track setting a value across a range"><figcaption></figcaption></figure>

## O que acontece quando o utiliza

Arrastar o slider envia o comando escolhido com o novo valor como parâmetro, através do pipeline de comandos do dispositivo. O manípulo segue o **métrica do dispositivo**, por isso reflete o valor que o dispositivo realmente reporta.

## Erros comuns

* **Associar um comando sem um parâmetro numérico** — um slider precisa de um parâmetro que possa definir como número; um comando simples de ligar/desligar pertence a um [Interruptor](/kilo-docs-pt/kilo-iot-server/dashboards/adding-widgets/control-widget/switch.md).
* **Intervalo que não corresponde ao dispositivo** — defina Início/Fim para o mínimo e máximo reais do parâmetro, para que o curso total corresponda a valores válidos.

## 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: [Controlo deslizante circular](/kilo-docs-pt/kilo-iot-server/dashboards/adding-widgets/control-widget/slider-circular.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 slider aciona


---

# 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-simple.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.
