Campos: o foco some num campo com erro (foco + erro = erro); regra de um contorno por controle

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

维护者通常 1 天内回复

还没有人认领这个 Issue。

评估

难度
4/5
预计耗时
3-5 天
新手友好度
48/100
Issue 类型
缺陷
描述清晰度
基本清楚
活跃度
活跃
技术栈
typescript

调研方向

Start by reading the error and focus styles in TextField.svelte, then inspect the corresponding states in TextArea and Select; the issue names DateField and Combobox as additional controls to check. Compare computed styles for focused and invalid fields, and verify that focus remains visible with one contour per control, including in forced-colors mode. The issue also proposes auditLayout detectors and a native choice group, so confirm the intended scope before treating those as part of this fix.

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

描述

area:a11y area:components area:forms bug

Problema (medido, @codeatlasdev/ui 4.6.0)

Um campo com erro que recebe foco não mostra o foco. Medido no TextField da tela de login do wi (painel SvelteKit), lendo o estilo computado de .ca-tf__wrap em cada estado:

Estado border-color box-shadow outline do input
foco --ca-focus-ring 0 0 0 2px na cor do foco none
erro --ca-semantic-error 0 0 0 2px do erro a 18% none
foco + erro igual ao erro igual ao erro none

Causa: em TextField.svelte a regra .ca-tf__wrap--error (linha ~249) vem depois de .ca-tf__wrap--focused (linha ~243) com a mesma especificidade e reescreve border-color e box-shadow; o input tem outline: none. O mesmo padrão está no TextArea (.ca-ta__wrap--error) e no Select (.ca-sel__trigger[aria-invalid='true']). Quem navega por teclado até um campo inválido não vê onde está (WCAG 2.4.7), justamente no momento em que precisa corrigir.

O conserto ingênuo é pior

O dono do wi viu isso num formulário do app (campos próprios, feitos à mão): borda vermelha de erro com um outline azul de foco em volta, separado por 1px. Reação dele: "borda em cima de borda, falta de capricho". Somar o anel de foco padrão por fora do campo com erro resolve a acessibilidade e cria dois traços de cores diferentes no mesmo controle.

Regra proposta: um contorno por controle

  1. A borda do campo é o único contorno dele. Estado muda a cor dessa borda e o halo colado nela, nunca acrescenta um segundo traço de outra cor.
  2. Foco + erro: a borda continua na cor do erro (o erro não some) e o halo passa de 18% para cheio, na mesma cor. Foco visível, uma cor só.
  3. Em forced-colors, box-shadow some: o foco volta a ser outline: 2px solid Highlight.
  4. Vale para TextField, TextArea, Select, DateField, Combobox e qualquer controle com --error.
.ca-tf__wrap--error.ca-tf__wrap--focused,
.ca-tf__wrap--error.ca-tf__wrap--addons:focus-within {
  border-color: var(--ca-semantic-error);
  box-shadow: 0 0 0 var(--ca-border-width-focus) var(--ca-semantic-error);
}

Encaixa no #1229 (linguagem de bordas e foco: "erro na borda existente, sem halo extra"), que não cobre o estado combinado.

Segundo caso da mesma regra: controle dentro de contêiner arredondado

No mesmo formulário, uma fileira de segmentos dentro de um grupo com border-radius e overflow: clip: a opção escolhida desenhava box-shadow: inset 0 0 0 2px com raio 0, e o canto arredondado do grupo cortava o anel (o traço azul sumia no canto e encostava na borda cinza). Correção no app: cada célula é uma pastilha recuada 3px da borda da trilha, com raio = raio da trilha − recuo (concêntrico, como #915), e o foco na escolhida troca o anel da escolha em vez de somar outro.

O SegmentedControl da lib já faz isso (thumb com calc(var(--ca-radius-control) - var(--ca-space-0-5))). O app só refez o controle porque precisava de um grupo de rádio nativo, que funciona sem JavaScript e envia name=valor num <form>; o SegmentedControl e o Select da lib dependem de hidratação (#755). Pedido: um grupo de escolha nativo (rádio/checkbox) com as apresentações "segmentos" e "lista agrupada" (#1347, item 5 do comentário de espaço e acabamento).

Detectores para o auditLayout (#1290)

  • double-edge: elemento com border visível e outline visível de cor diferente ao mesmo tempo.
  • clipped-ring: filho com box-shadow/outline e raio menor que o do ancestral com overflow: hidden|clip cujo canto ele toca.
  • focus-invisible: para cada campo, o estilo computado em foco + inválido difere do inválido sem foco.

No wi

Campos próprios do formulário de lista de espera corrigidos com a regra acima (apps/web/src/routes/lista-de-espera/_components/{TextInput,SelectField,OptionGroup}.svelte), com teste em apps/web/tests/waitlist.spec.ts ("one edge per control"). Os campos da lib usados no resto do painel continuam com o defeito desta issue.

主要语言
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 摘要。