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 摘要。