Tela muda conforme o caminho: <noscript><style> via {@html} vale com JS na navegação pelo cliente; fallback sem JS, coluna lateral e formulário em passos precisam ser da lib
维护者通常 1 天内回复
还没有人认领这个 Issue。
评估
- 难度
- 5/5
- 预计耗时
- 一周以上
- 新手友好度
- 25/100
- Issue 类型
- 功能
- 描述清晰度
- 基本清楚
- 活跃度
- 活跃
- 技术栈
- typescript
调研方向
Read the referenced auditLayout and detector work in #1290, the delivery checklist in #922, and the component or lint entry points mentioned in the repository. The issue proposes changes across documentation, linting, navigation tests, layouts, and a stepper component. Done means those behaviors and checks are defined and covered for direct loads, internal navigation, and no-JavaScript use.
由索引模型根据 Issue 内容生成。
描述
Versão: 4.6.0 · App: wi, página pública /lista-de-espera (formulário em passos ao lado de uma coluna de contexto)
O dono do produto abriu a página vindo da landing e viu isto, em 1568x924, tema escuro: o cartão mostrava as quatro etapas de uma vez (sem "Passo 1 de 4"), a página rolava 1981 px, a coluna da esquerda estava vazia no alto e o título "Entre na lista de espera" aparecia colado na borda de baixo da tela. Abrindo a mesma URL direto (F5) a página estava certa. Ele considerou inadmissível, com razão: é a porta de entrada do produto.
Continuação de #1350 (regras de espaço e consistência do mesmo dono) e de #1347 (composição por tela). Esta issue registra um defeito de outra classe: o mesmo componente renderiza diferente conforme o caminho por onde a página chegou, e nenhum teste da lib ou do app pegava isso.
Causa medida
O formulário tinha um fallback sem JavaScript assim:
<svelte:head>
{@html `<noscript><style>.wl-step[hidden]{display:flex!important}…</style></noscript>`}
</svelte:head>
- Carga direta (SSR): o navegador lê o
<noscript>com scripting ligado e ignora o<style>. Certo. - Navegação pelo cliente: o Svelte monta
{@html}com um<template>. O conteúdo de<template>é analisado com scripting desligado, então o<noscript>vira elementos de verdade e o<style>passa a valer com o JavaScript ligado. Resultado: todos os passos visíveis, e a coluna do lado (centrada contra o cartão) desce para o meio de um cartão de duas telas.
Correção no app: @media (scripting: none) no CSS do componente no lugar do <noscript><style>, e um teste que navega da landing para a página e exige um passo visível e a página cabendo na tela (falha sem a correção: 4 passos visíveis).
O que a lib deveria garantir
- Fallback sem JavaScript tem um caminho só, e é CSS. Documentar
@media (scripting: none)como o jeito de escrever o estado sem JS e proibir<noscript><style>(regra de lint nocodeatlas-ui lint:{@html}contendo<noscript>, e<noscript>com<style>dentro de componente). - Navegação pelo cliente é uma viewport de teste. O
auditLayout/detectores (#1290) e as receitas deveriam rodar cada tela em dois caminhos: carga direta e chegada por link interno. Mesmo DOM, mesma medida; qualquer diferença é defeito. - Coluna de contexto ao lado de um formulário longo (o "AuthLayout com painel" e as páginas de cadastro): quando o formulário passa da altura da tela, a coluna lateral fica no topo e acompanha a rolagem (
position: sticky), nunca centrada contra o cartão. Hoje cada app decide e erra igual: título no meio do vazio. - Formulário em passos como componente (
Stepper/WizardForm): progresso, um passo por vez, passos na mesma célula para o cartão não pular, foco no título do passo, e o modo sem JavaScript (todos os passos com títulos de seção) embutido e testado. Este app escreveu tudo isso à mão (.wl-step[hidden], grid de uma célula,visibility), e o fallback foi exatamente a parte que quebrou. - Checklist "antes de entregar" de #922 ganha três itens: abrir por link interno, abrir sem JavaScript, abrir com a página anterior em outro tema.
Regras do dono que esta página violou (para o texto normativo de #922)
- Título no rodapé e coluna vazia em cima: faixa vazia sem função.
- Formulário de quatro passos virando uma tela de 2000 px sem progresso: nada do que a pessoa vê pode depender do caminho por onde ela chegou.
- A primeira tela de um produto é avaliada com o mesmo rigor do painel: espaço, alinhamento e hierarquia, no celular e no desktop, claro e escuro.
- 主要语言
- TypeScript
- 星标
- 6
- 派生
- 3
- 平均合并
- 5 小时 21 分钟
- 30 天内合并 PR
- 378
环境准备
- 没有 Dockerfile 或 Docker Compose 文件
- 有 Pull Request 模板
- 阅读贡献指南
从这里开始
- 先读完整个 Issue,再读项目的贡献指南。
- 在 Issue 下留言说明你要接手 —— 这能避免两个人做同样的事。
- Fork 仓库,在一个分支上完成修改。
- 提交 Pull Request,并在描述里引用这个 Issue 编号。
codeatlasdev/ui 的其他 Issue
-
难度 2/5 1-3 小时 新手友好度 84/100
codeatlasdev/ui#1340 ·
维护者通常 1 天内回复
-
area:a11y area:components bug
难度 2/5 1-3 小时 新手友好度 76/100
codeatlasdev/ui#1336 ·
维护者通常 1 天内回复
-
难度 2/5 1-3 小时 新手友好度 77/100
codeatlasdev/ui#1329 ·
维护者通常 1 天内回复
-
good first issue
难度 2/5 1-3 小时 新手友好度 74/100
codeatlasdev/ui#1292 · 1 条评论 ·
维护者通常 1 天内回复
-
area:components enhancement good first issue
难度 2/5 1-3 小时 新手友好度 68/100
codeatlasdev/ui#1198 ·
维护者通常 1 天内回复
相似的 Issue
-
bug frontend
难度 2/5 1-3 小时 新手友好度 85/100
CivicTechWR/accessible-housing-portal#578 ·
维护者通常 1 天内回复
-
难度 2/5 1-3 小时 新手友好度 68/100
nekko-labs/nekko-agent#2998 ·
维护者通常 1 天内回复
-
难度 1/5 1 小时以内 新手友好度 86/100
sandbox-quantum/switch#2163 ·
维护者通常 1 天内回复
-
enhancement ux
难度 2/5 1-3 小时 新手友好度 72/100
lolimmlost/aidj#433 ·
维护者通常 1 天内回复
-
test: ipcShownDialogKeys.test.tsx can fail the unit run with 'window is not defined' after it ends未关闭
难度 2/5 1-3 小时 新手友好度 72/100
维护者通常 1 天内回复