> ## Documentation Index
> Fetch the complete documentation index at: https://docs.yampi.com.br/llms.txt
> Use this file to discover all available pages before exploring further.

# LoaderButton

> Botão que exibe um spinner de carregamento enquanto uma ação está sendo processada.

Substitui o conteúdo do botão por um spinner animado enquanto `sending` é `true`. Impede cliques duplicados durante o processamento e suporta estado desabilitado independente.

## Uso

```vue theme={"system"}
<LoaderButton
  :sending="isLoading"
  :disabled="!isValid"
  title="Finalizar pedido"
  @click="submitOrder"
/>
```

Com slot customizado:

```vue theme={"system"}
<LoaderButton :sending="isLoading" @click="submit">
  <span>Salvar alterações</span>
</LoaderButton>
```

## Propriedades

| Propriedade      |    Tipo   | Obrigatória | Valor padrão | Descrição                                                           |
| :--------------- | :-------: | :---------: | :----------: | :------------------------------------------------------------------ |
| `sending`        | `Boolean` |      ✅      |       —      | Quando `true`, exibe o spinner e bloqueia novos cliques.            |
| `disabled`       | `Boolean` |      ❌      |    `false`   | Desabilita o botão independentemente do estado de `sending`.        |
| `title`          |  `String` |      ❌      |     `''`     | Texto do botão. Usado como fallback quando o slot não é preenchido. |
| `listenPosition` | `Boolean` |      ❌      |    `false`   | Ativa rastreamento de posição do botão na viewport.                 |

## Eventos

| Evento  | Payload      | Descrição                                                                           |
| :------ | :----------- | :---------------------------------------------------------------------------------- |
| `click` | `MouseEvent` | Disparado ao clicar no botão (não dispara quando `sending` ou `disabled` é `true`). |

## Slots

| Slot    | Descrição                                                         |
| :------ | :---------------------------------------------------------------- |
| default | Conteúdo do botão. Quando não preenchido, usa o valor de `title`. |