UI

Search Field

Campo de busca com ícone de lupa e botão para limpar o texto.

Instalação

npx shadcn@latest add @lenstech/search-field

Uso

import { SearchField } from "@/components/ui/search-field"
<SearchField aria-label="Buscar pedidos" placeholder="Buscar por cliente ou nº do pedido" />

Teclado

Enter dispara onSubmit com o texto digitado e Esc limpa o campo (disparando onClear). O botão ✕ só aparece quando há texto. Como a lupa já indica a função, é comum não ter rótulo visível — nesse caso informe aria-label.

Exemplos

Com rótulo e descrição

Pressione Enter para buscar e Esc para limpar.

Filtrar uma lista

Controle com value + onChange (que recebe a string) para filtrar enquanto digita.

  • Pão francês
  • Pão integral
  • Bolo de cenoura
  • Sonho
  • Café coado
  • Pão de queijo

Buscar ao pressionar Enter

Digite e pressione Enter.

Desabilitado

Quando usar

  • Use para buscar em listas, tabelas ou no site inteiro.
  • Não use para escolher um item de uma lista conhecida — use Combobox.
  • Não use para dados que não são busca (nome, e-mail) — use Input.

API

SearchField

Aceita todas as props do SearchField do React Aria, mais:

Prop

Type

On this page