# EmptyState

O que aparece no lugar de uma lista vazia: diz por que está vazio e convida para o próximo passo.

## Playground

```html
<div class="feitio-empty"><svg xmlns="http://www.w3.org/2000/svg" aria-hidden="true" viewBox="0 0 120 100" fill="none" stroke="currentColor" stroke-width="2.4" stroke-linecap="round" stroke-linejoin="round">
  <path d="M14 40c30-2.6 62 1.4 92-1.8"/>
  <path d="M18 41.5c3 16 6.2 32 10.4 46.6"/>
  <path d="M25.6 88.6c22.4-1.8 43.6.6 66.2-1.6"/>
  <path d="M101.6 41.6c-2.8 15.4-6 30.8-10.4 46.4"/>
  <path d="M32 52c1.8 10 3.2 20 4.6 29.4M50 52.6c.4 9.8.2 19.6.6 29.2M68.4 52c-.6 9.8-1.2 19.6-1.8 29.6M86 51.6c-1.6 9.6-3 19.4-4.8 29.2"/>
  <path d="M36 39c2.4-14 13-24.4 24.6-24.6C72.8 14.2 83.4 25 85 38.6"/>
  <path class="feitio-hot" d="M60.6 6.4c-.2 2.4.2 4.8-.1 7.2M44 11.2c1.4 1.8 2.6 3.6 4 5.6M77.2 11c-1.4 1.8-2.6 3.8-4 5.8"/>
</svg>
<h3>Nenhum lembrete ainda</h3><p>Crie o primeiro e ele aparece aqui.</p></div>
```

## Quando usar

-   Quando uma lista, tabela ou página não tem nada para mostrar: na primeira vez, depois de um filtro sem resultado, ou num erro grande.

## Quando não usar

-   **Enquanto carrega:** "vazio" e "carregando" são coisas diferentes.
-   **Erro de campo:** os componentes de erro.

## Exemplos

### Primeira vez

Com o desenho e a ação principal.

Mostrar código

```html
<div class="feitio-empty">
  <svg …>…</svg>
  <h3>Nenhum agendamento ainda</h3>
  <p>Crie o primeiro e ele aparece aqui.</p>
  <button type="button" class="feitio-button" data-variant="primary">Criar agendamento</button>
</div>
```

### Busca sem resultado

Sem desenho, compacto, e o jeito de desfazer o filtro.

Mostrar código

```html
<div class="feitio-empty" data-size="compact">
  <h3>Nada encontrado para "plantas"</h3>
  …
</div>
```

### Erro grande

Com o desenho do papel rasgado, e o que fazer.

Mostrar código

```html
<div class="feitio-empty">
  <svg …>…</svg>
  <h3>O servidor não respondeu</h3>
  …
</div>
```

## Bons e maus padrões

Faça assim

### Nenhuma tarefa aqui

Crie a primeira.

Diz o que é e o que fazer.

Não faça

Parece que não há nada por aqui ainda…

Reticências e nenhuma saída: a pessoa fica olhando para o vazio.

## Como escrever

-   Título: o que não existe ("Nenhum agendamento ainda"). Texto: o próximo passo. Botão: a ação, com verbo e objeto.

## Acessibilidade

-   O desenho acompanha (`aria-hidden`); o título e o texto dizem tudo.

## Atributos

Atributo

Valores

Para quê

`class="feitio-empty"`

obrigatório

A caixa centralizada.

`data-size="compact"`

opcional

Para busca ou filtro sem resultado.

Os desenhos estão no [catálogo de ilustrações](/pt/resources/ilustracoes/).