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,351 0 条评论 0 个 reaction 已指派 0 人 在 GitHub 查看

维护者通常 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

  1. 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 no codeatlas-ui lint: {@html} contendo <noscript>, e <noscript> com <style> dentro de componente).
  2. 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.
  3. 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.
  4. 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.
  5. 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

环境准备

从这里开始

  1. 先读完整个 Issue,再读项目的贡献指南。
  2. 在 Issue 下留言说明你要接手 —— 这能避免两个人做同样的事。
  3. Fork 仓库,在一个分支上完成修改。
  4. 提交 Pull Request,并在描述里引用这个 Issue 编号。

codeatlasdev/ui 的其他 Issue

查看 codeatlasdev/ui 的全部 Issue

相似的 Issue

更多 TypeScript Issue

把新 issue 发到你的邮箱

精选适合新手参与的 GitHub issue 摘要。