SearchField: busca com limpar, Esc, role=search e estado vazio
维护者通常 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 内容生成。
描述
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
onsearchuma 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
环境准备
- 没有 Dockerfile 或 Docker Compose 文件
- 有 Pull Request 模板
- 阅读贡献指南
从这里开始
- 先读完整个 Issue,再读项目的贡献指南。
- 在 Issue 下留言说明你要接手 —— 这能避免两个人做同样的事。
- Fork 仓库,在一个分支上完成修改。
- 提交 Pull Request,并在描述里引用这个 Issue 编号。
codeatlasdev/ui 的其他 Issue
-
难度 2/5 1-3 小时 新手友好度 84/100
codeatlasdev/ui#1340 ·
维护者通常 1 天内回复
-
area:a11y area:components bug
难度 2/5 1-3 小时 新手友好度 76/100
codeatlasdev/ui#1336 ·
维护者通常 1 天内回复
-
难度 2/5 1-3 小时 新手友好度 77/100
codeatlasdev/ui#1329 ·
维护者通常 1 天内回复
-
good first issue
难度 2/5 1-3 小时 新手友好度 74/100
codeatlasdev/ui#1292 · 1 条评论 ·
维护者通常 1 天内回复
-
area:components enhancement good first issue
难度 2/5 1-3 小时 新手友好度 68/100
codeatlasdev/ui#1198 ·
维护者通常 1 天内回复
相似的 Issue
-
难度 1/5 1 小时以内 新手友好度 86/100
sandbox-quantum/switch#2163 ·
维护者通常 1 天内回复
-
automated issue report
难度 1/5 1 小时以内 新手友好度 78/100
维护者通常 1 天内回复
-
area/dashboard kind/bug QA/dev-automation
难度 1/5 1 小时以内 新手友好度 75/100
维护者通常 1 天内回复
-
bug pydanty:is-working
难度 2/5 1-3 小时 新手友好度 82/100
pydantic/pydantic-ai#13939 ·
维护者通常 1 天内回复
-
self-host
难度 2/5 1-3 小时 新手友好度 70/100
funmusicplace/mirlo#2625 ·
维护者通常 1 天内回复