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

Aberta
#1,351 0 comentários 0 reações 0 responsáveis Ver no GitHub

Mantenedores costumam responder em até 1 dia

Ninguém assumiu esta issue ainda.

Avaliação

Dificuldade
5/5
Tempo estimado
Mais de uma semana
Facilidade para iniciantes
25/100
Tipo de issue
Funcionalidade
Clareza
Razoavelmente clara
Status de atividade
Ativa
Stack de tecnologia
typescript

Direção de pesquisa

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.

Escrita pelo modelo de indexação a partir do texto da issue.

Descrição

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.
Linguagem predominante
TypeScript
Estrelas
6
Forks
3
Merge médio
5h 21min
PRs com merge (30d)
378

Preparar o ambiente

Primeiros passos

  1. Leia a issue inteira e depois o guia de contribuição do projeto.
  2. Comente na issue dizendo que vai assumir — evita que duas pessoas façam o mesmo trabalho.
  3. Faça um fork do repositório e trabalhe em uma branch.
  4. Abra um pull request que referencie o número da issue.

Mais de codeatlasdev/ui

Todas as issues de codeatlasdev/ui

Issues semelhantes

Mais issues de TypeScript

Receba novas issues na sua caixa de entrada

Um resumo curto de issues do GitHub para quem está começando.