testing: detectores de UI como pacote consumível (faixa vazia, gutter, sobreposição, texto cru, hierarquia de ações, CLS com origem, foco após toque)

Ouverte
#1,290 1 commentaire 0 réactions 0 personnes assignées Voir sur GitHub

Les mainteneurs répondent en général sous 1 jour

Personne n'a encore pris cette issue.

Évaluation

Difficulté
4/5
Temps estimé
3-5 jours
Accessibilité débutants
35/100
Type d'issue
Fonctionnalité
Clarté
Plutôt claire
Activité
Active
Stack technique
playwright, typescript
Domaine
testing

Piste de recherche

Read discussion #1087 §2.5 and the consumer request atlas#215 first; they define the detectors and the acceptance run. The deliverable is a stable export such as @codeatlasdev/ui/testing/detectors with the detect(page, opts) signature and one function per detector, each backed by a failing and a corrected fixture. The empty-band case (490 px of blank on a 390x844 viewport) is the explicit acceptance test; run everything through Playwright on Chromium and WebKit at 390 and 1440 px in light and dark. Done means atlas#215 passes without the detectors depending on kit DOM code.

Rédigé par le modèle d'indexation à partir du texte de l'issue.

Description

Pedido de codeatlasdev/atlas#215 (épico codeatlasdev/atlas#168). A Atlas Crew precisa rodar, numa página aberta pelo Playwright (Chromium e WebKit, 390 e 1440 px, claro e escuro), os detectores descritos na discussão #1087 §2.5, sem copiar a lógica para o Atlas.

O que falta aqui

Um export estável, por exemplo @codeatlasdev/ui/testing/detectors, com uma função por detector e uma que roda todos:

type Finding = { detector: string; severity: "error" | "warn"; message: string; rect?: DOMRectInit; selector?: string };
export function detect(page: Page | Window, opts?: { only?: string[] }): Promise<Finding[]>;

Detectores (cada um com fixture que falha e fixture corrigida):

  1. Faixa vazia na página inteira: banda horizontal sem conteúdo acima de um limite (ex.: 490 px de vazio num 390x844) — ver #1084.
  2. Gutter < 12 px no celular — ver #1154.
  3. Sobreposição de irmãos (caixas que se cobrem sem ser overlay).
  4. Texto cru: ids, snake_case/kebab-case em títulos e rótulos.
  5. Hierarquia de ações: mais de uma ação primária visível no mesmo grupo.
  6. CLS com origem: deslocamento acima do limite, com o elemento que causou — ver #1068 e #974.
  7. Foco após toque: o elemento ativado perde o foco ou ele vai para o body — ver #1229.

Por que no ui

O Atlas e qualquer app do kit usam as mesmas regras; duplicá-las no Atlas faria as duas divergirem.

Aceite (o que o Atlas vai testar)

  • O detector de faixa vazia reprova uma fixture com faixa de 490 px e aprova a corrigida (codeatlasdev/atlas#215).
  • Rodam no Chromium e no WebKit (WebKit é o motor do Atlas Desktop e do Safari do iPhone).
  • Sem dependência de DOM do kit: funcionam em qualquer página (o Atlas roda em apps de clientes).
Langage dominant
TypeScript
Étoiles
6
Forks
3
Merge moyen
5 h 21 min
PR mergées (30 j)
378

Préparer son environnement

Par où commencer

  1. Lisez l'issue en entier, puis le guide de contribution du projet.
  2. Signalez en commentaire que vous la prenez — cela évite que deux personnes fassent le même travail.
  3. Forkez le dépôt et travaillez sur une branche.
  4. Ouvrez une pull request qui référence le numéro de l'issue.

Autres issues de codeatlasdev/ui

Toutes les issues de codeatlasdev/ui

Issues similaires

Plus d'issues TypeScript

Recevez les nouvelles issues par e-mail

Un résumé court des issues GitHub adaptées aux débutants.