SearchField: busca com limpar, Esc, role=search e estado vazio

未关闭
#1,212 0 条评论 0 个 reaction 已指派 0 人 在 GitHub 查看

维护者通常 1 天内回复

还没有人认领这个 Issue。

评估

难度
3/5
预计耗时
1-2 天
新手友好度
60/100
Issue 类型
功能
描述清晰度
基本清楚
活跃度
活跃
技术栈
typescript

调研方向

Start in the component source beside the existing TextField and Combobox, since SearchField should reuse their prop and accessibility conventions; the apps/web/... paths point at a private repo and are reference only. Add the component with value, debounce, onsearch, a localized aria-label on the clear button, Esc clearing, a role="search" container and an aria-live counter, then export it from the package entry point. Done when tests cover the four acceptance criteria: one call after 250ms, Esc emitting onsearch(""), a labelled 44px clear button on coarse pointers, and the "Nenhum resultado" announcement.

由索引模型根据 Issue 内容生成。

描述

area:a11y area:forms enhancement

Versão: @codeatlasdev/ui 4.6.0 · código lido em main (950628f2) · classe: lacuna (migração do AC)

Problema

O AC depende deste comportamento hoje e a lib não o oferece. Sem ele, a migração perde qualidade no desktop, no mobile ou no PWA.

O que a lib já oferece (para não duplicar) e o que falta

TextField type="search" não tem limpar nem Esc. Combobox filtra mas não é campo de busca livre. useDebouncedValue do AC não tem equivalente documentado na lib.

Referência no AC

Caminhos do repo AC (repo privado, só caminho):

apps/web/src/components/geography/map/overlays/search-box.tsx:13-30 (debounce 250, URL, sem clear, sem Esc); apps/web/src/components/whatsapp/numbers-tab.tsx:166-168 (type=search); apps/web/src/components/admin/cliche-client-picker.tsx (debounce, mínimo de 2, XIcon).

Defeitos do AC (verificados por leitura do código): (leitura) search-box.tsx: sem botão limpar, sem Esc e sem landmark de busca. (leitura) numbers-tab.tsx: type=search sem nome visível (só placeholder).

Proposta

SearchField com value, debounce, onsearch, botão limpar (aria-label localizado), Esc limpa, role="search" no contêiner e contagem de resultados via aria-live="polite".

Critério de aceite (testável)

  • Digitar e esperar 250ms chama onsearch uma vez.
  • Esc com texto limpa e chama onsearch("").
  • Botão limpar tem nome acessível e alvo de 44px em coarse.
  • Sem resultados, o contador anuncia "Nenhum resultado".

Mãe: #1089

主要语言
TypeScript
星标
6
派生
3
平均合并
5 小时 21 分钟
30 天内合并 PR
378

环境准备

从这里开始

  1. 先读完整个 Issue,再读项目的贡献指南。
  2. 在 Issue 下留言说明你要接手 —— 这能避免两个人做同样的事。
  3. Fork 仓库,在一个分支上完成修改。
  4. 提交 Pull Request,并在描述里引用这个 Issue 编号。

codeatlasdev/ui 的其他 Issue

查看 codeatlasdev/ui 的全部 Issue

相似的 Issue

更多 TypeScript Issue

把新 issue 发到你的邮箱

精选适合新手参与的 GitHub issue 摘要。