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

Đang mở
#1,351 0 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ó
5/5
Thời gian dự kiến
Hơn một tuần
Mức phù hợp với người mới
25/100
Loại issue
Tính năng
Độ rõ ràng
Khá rõ ràng
Mức độ hoạt động
Sôi nổi
Công nghệ
typescript

Hướng nghiên cứu

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.

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

Mô tả

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.
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.