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

Đang mở
#1,349 1 bình luận 0 reaction 0 người được giao Xem trên GitHub

Maintainer thường phản hồi trong vòng 1 ngày

Chưa có ai nhận issue này.

Đánh giá

Độ khó
4/5
Thời gian dự kiến
3-5 ngày
Mức phù hợp với người mới
48/100
Loại issue
Lỗi
Độ rõ ràng
Khá rõ ràng
Mức độ hoạt động
Sôi nổi
Công nghệ
typescript
Lĩnh vực
accessibility, frontend

Hướng nghiên cứu

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.

Do mô hình lập chỉ mục viết ra từ nội dung của issue.

Mô tả

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.

Ngôn ngữ chính
TypeScript
Star
6
Fork
3
Merge trung bình
5 giờ 21 phút
Pull request đã merge (30 ngày)
378

Chuẩn bị môi trường

Bắt đầu từ đâu

  1. Đọc hết issue, rồi đọc hướng dẫn đóng góp của dự án.
  2. Bình luận trên issue rằng bạn sẽ nhận — tránh hai người làm cùng một việc.
  3. Fork repository và làm thay đổi trên một nhánh.
  4. Mở pull request có tham chiếu số hiệu của issue.

Issue khác của codeatlasdev/ui

Tất cả issue của codeatlasdev/ui

Issue tương tự

Thêm issue về TypeScript

Nhận issue mới trong hộp thư của bạn

Bản tóm tắt ngắn những issue GitHub phù hợp với người mới.