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

オープン
#1,349 コメント 1 件 リアクション 0 件 担当者 0 名 GitHub で見る

メンテナーはふだん 1 日以内に返信

まだ誰も着手していません。

評価

難易度
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分
マージ済み PR(30日)
378

環境構築

はじめの一歩

  1. issue を最後まで読み、次にプロジェクトのコントリビューションガイドを読みます。
  2. 着手することを issue にコメントします — 二人が同じ作業をするのを防げます。
  3. リポジトリをフォークし、ブランチを切って変更します。
  4. issue 番号を参照したプルリクエストを送ります。

codeatlasdev/ui のほかの issue

codeatlasdev/ui の issue をすべて見る

似ている issue

TypeScript の issue をもっと見る

新しい issue をメールで受け取る

初心者向けの GitHub issue を短くまとめたダイジェスト。