```meta
title: @search — uma busca para os leitores do site
description: Uma caixa de busca sobre as páginas de uma pasta do site: cada página que tem todas as palavras digitadas, a mais nova primeiro, com o título e a linha onde a palavra está.
```

_flows.md · documentação · [Blocos](/@docs/blocks)_

# @search

Uma caixa de busca para quem lê o site: procura nas páginas de uma pasta as que têm todas as palavras digitadas, a mais nova primeiro, cada uma com o título e a linha onde a palavra aparece. Só aparecem as páginas que aquele leitor pode abrir.

## Ao vivo

Esta busca procura nas páginas desta galeria de blocos. Experimente `contagem` ou `formulário`.

```@search from:/@docs/blocks placeholder:"Buscar nos blocos" limit:5
```

~~~text
```@search from:/@docs/blocks placeholder:"Buscar nos blocos" limit:5
```
~~~

É um formulário comum (`?q=` no endereço): funciona sem script, no domínio próprio do site, e o endereço de uma busca pode ser copiado e mandado para alguém.

## No cabeçalho de um site

Um site trazido do Webflow, Wix, Squarespace ou WordPress costuma ter a busca no topo. No layout do site, sobre a pasta dele:

~~~text
```@search from:~/site placeholder:"Buscar na loja"
```
~~~

## Argumentos

- `from` — a pasta onde buscar, no mesmo espaço da página: `/@voce/site`, ou relativa como um link (`./` esta página, `~/site` no espaço). A pasta de outro espaço é recusada. Sem ele, as páginas abaixo da página onde está o bloco, e ela mesma.
- `limit` — quantas páginas no máximo, de 1 a 30. O padrão é 10.
- `placeholder` — as palavras dentro da caixa vazia. O padrão é "Buscar".

Para listar as páginas de uma pasta sem busca, o [@pages](/@docs/blocks/pages).