Se SKILL.local.md existir nesta pasta, leia-o primeiro; ele contém seus caminhos, dados e regras locais.
Rolagem de profundidade
Um formato de página para um conjunto de figuras que o leitor percorre, uma de cada vez. A primeira construção transformou um conjunto de desenhos explicativos em uma rolagem em direção ao visualizador, modelada na página de destino do WhatTheFad (whatthefad.netlify.app, código-fonte em github.com/rafaelcarlosabbariao/cultural-archaeology).
A habilidade contém quatro arquivos:
| Arquivo | O que é |
|---|---|
template.html | A página: a estrutura da estação, o fluxo, a barra e o script que os executa |
build.py | Preenche o modelo a partir de uma especificação, como comando ou como módulo |
capture.mjs | Capturas headless em tempo real e verificações de navegação sobre o protocolo DevTools |
SKILL.md | Este arquivo |
Quando se aplica
- Aplica-se a quatro a doze painéis autocontidos, lidos um de cada vez, cada um cabendo em uma tela: desenhos, cartões de uma ideia, os estágios de uma sequência.
- Não se aplica a textos longos, tabelas ou qualquer coisa que o leitor compare lado a lado ou examine indo e voltar. Construa uma página plana para esses casos.
- Saída. A página é um único arquivo
.htmlautocontido, sem scripts externos e sem WebGL. O modelo vem com uma paleta de creme quente e tinta em tokens:root; reestilize-a a gosto.
Como funciona
O campo do WhatTheFad, a fonte
Leia do index.html do WhatTheFad (CSS #landing-trendfield e a função renderTrendField).
- Projeção. O campo é um contêiner com
perspective: 900px, e cada chip é posicionado comtranslate3d(x, y, z). O navegador desenha um chip na escala 900 / (900 − z): 0,24 em z = −2800, 1 no plano da tela e 1,3 em z = 220. - Um relógio impulsiona o movimento. Um loop
requestAnimationFramemove cada chip em direção ao visualizador a 150 px/s vezes um fator por chip de 0,75 a 1,25. Após z = 220, ele reaparece em um anel elíptico em z = −2800. - Fades e ordem de pintura. Um chip aparece gradualmente no primeiro quarto de sua profundidade e desaparece entre z = 60 e 220. O campo nunca usa
preserve-3d, então oz-indexde cada chip é definido a partir de sua profundidade para que o mais próximo pinte por cima. - O centro silencioso. Uma
mask-imageradial esconde o meio, onde chips distantes se acumulam no ponto de fuga. - Pegando um chip. O navegador verifica novamente
:hoverapenas quando o ponteiro se move, então um chip derivando sob um cursor parado nunca acende. O WhatTheFad testa o ponteiro contra o retângulo projetado de cada chip a cada quadro, e um chip pego reduz a velocidade do campo para 8%.
O que este formato adiciona
- A rolagem é a câmera.
- Uma trilha alta (
main.depth) contém uma parada por estação, um altura de estágio de distância, comscroll-snap-type: y proximity. - Um estágio fixo sob o cabeçalho fixo contém a cena.
- A posição de rolagem se torna um índice de estação, inteiro em cada parada. Uma câmera se aproxima suavemente (taxa 9 por segundo), e a estação
ié desenhada em z = (câmera − i) × 1400.
- Uma trilha alta (
- A passagem de uma estação.
- A estação que espera atrás está escura e um pouco baixa, então ela sobe para o lugar conforme avança.
- Em repouso, ela está em z = 0 e escala 1, em pixels inteiros, então seu texto é tão nítido quanto uma página plana.
- Ao passar pelo visualizador, ela desaparece em z = 300, com 1,5×.
- Uma estação mais alta que o estágio é escalada para caber.
- O fluxo. O campo do WhatTheFad, máscara incluída. A velocidade dos cartões é uma base de 46 mais 0,9 da velocidade da câmera, então rolar para frente os acelera e rolar para trás os afasta. Uma estação nomeia os grupos de cartões que ela ilumina (
lit), e esses cartões acendem enquanto ela estiver na frente. - Entrada.
- Roda, trackpad, toque, as teclas de seta, a barra e o conteúdo do cabeçalho movem a mesma rolagem nativa, então toda entrada chega nas mesmas paradas.
- O foco entrando em uma estação que não está na frente rola até ela.
- O fluxo é decorativo, e apenas a estação em repouso recebe eventos de ponteiro, então nenhum teste de impacto por quadro é necessário.
- Fallback. Sem JavaScript, ou com
prefers-reduced-motion: reduce, a página são as estações empilhadas planas. A profundidade é ativada por uma classedeepque o script adiciona. No modo plano, as âncoras do conteúdo se movem para as estações.
Construindo uma
SK abaixo é onde você instalou esta habilidade, por exemplo ~/.claude/skills/depth-scroll.
- Conteúdo primeiro. Coloque cada painel em uma página plana como
<figure class="fig">contendo um.plate(o desenho) e umfigcaption. A página plana também é a cópia de leitura. Uma estação pode, alternativamente, conterhtmlbruto. - Escreva uma especificação (abaixo), como um arquivo JSON ou como um dict no próprio script de construção do projeto quando os valores são computados (por exemplo, nomes de cartões lidos de um arquivo de dados).
- Construa-a.
ou, a partir de um script:python3 -I $SK/build.py spec.jsonsys.path.insert(0, str(Path.home() / '.claude/skills/depth-scroll')) import build build.write(spec, base=AQUI) - Cabeçalho opcional. O modelo deixa espaço para um cabeçalho fixo (
--pin-h,header.pin,nav.pin-toc). Sem um, o estágio começa no topo da janela. - Verifique-a com
capture.mjs(abaixo), então faça o commit.
A especificação
Os caminhos são relativos a base: a pasta do arquivo de especificação ou a pasta passada para write. Os caminhos das imagens são escritos na página como fornecidos, então forneça-os relativos à página de saída.
| Campo | O que contém |
|---|---|
out | A página a ser escrita |
title | O <title>, nomeado por tipo (<Assunto> <substantivo do tipo>) |
source | Página plana opcional. Seus blocos figure.fig se tornam fig: n, e seus blocos de estilo (não os do cabeçalho) são copiados para que os desenhos mantenham suas classes |
kicker | O pequeno rótulo sobre uma estação de nível de seção; o kicker de uma subseção é o nome de sua seção |
door | HTML da primeira estação: um resumo, uma nota, um link para a página plana |
stations[] | id; sec e/ou sub (as linhas de conteúdo; sec sozinho é uma seção, sub sozinho uma subseção, ambos abre uma seção nesta estação); title (padrão para sub, depois sec); lead (HTML, uma ou duas frases); fig ou html; cards ([{img, label}], uma pequena fileira de imagens); lit (grupos do fluxo para iluminar) |
cards_label | O rótulo no final da fileira de imagens de uma estação |
close | {title, kicker, html} para a última estação, geralmente as fontes |
stream[] | {label, img, group} por cartão. Quarenta a oitenta é lido como um fluxo |
css | CSS extra opcional, anexado por último |
Verificando
K=$SK/capture.mjs
node $K file:///caminho/pagina.html em-repouso.png 2 # uma estação em repouso
node $K file:///caminho/pagina.html em-transito.png 4.4 --wait=900 # entre duas estações, saindo do encaixe
node $K file:///caminho/pagina.html ultima.png 9 # a última parada é alcançável
node $K file:///caminho/pagina.html luz.png 5 --light # o fundo claro
node $K file:///caminho/pagina.html celular.png 3 375 700 # largura de celular
node $K file:///caminho/pagina.html plano.png 0 --reduce # a página com movimento reduzido
node $K "file:///caminho/pagina.html#st-modelo" hash.png - # um link para uma parada, ao carregar
node $K file:///caminho/pagina.html navegacao.png 0 --nav # setas, o último link do conteúdo, a barra
Cada execução imprime as paradas e, por etapa, y, front (a estação que recebe eventos de ponteiro), rail, cardsShown, cardsLit, deep e pageWidth. Uma estação em repouso tem front igual ao seu índice; pageWidth deve ler a largura da janela de visualização (sem rolagem lateral da página). Olhe cada imagem, em ambos os fundos e na largura de celular, antes de considerar concluído. Para páginas cujas imagens estão fora da pasta, copie a página para o scratchpad com caminhos de imagem absolutos primeiro.
Não verifique com chrome --headless --screenshot. Sob --virtual-time-budget, os quadros de animação mal avançam, então a câmera suavizada nunca chega, e uma captura de tela de uma janela rolada pode voltar em branco. capture.mjs dirige um Chrome headless em tempo real, onde os quadros são executados em sua taxa real.
Ajuste
As constantes estão no início do script em template.html.
| Constante | Valor | O que move |
|---|---|---|
PERSP | 900 | Deve corresponder ao perspective CSS em .stations e .field |
GAP | 1400 | Profundidade mundial entre duas estações |
AHEAD | 2,2 × GAP | Quão à frente uma estação é desenhada |
PASS | 300 | Onde uma estação passando desapareceu (escala 1,5) |
LIFT | 36 | Pixels que uma estação em espera fica baixa por GAP de distância |
DEPTH, NEAR | 2800, 220 | A profundidade de surgimento do fluxo e a profundidade onde um cartão passou |
BASE | 46 | A velocidade do fluxo em repouso, px/s |
| suavização da câmera | 9 por segundo | A rapidez com que a câmera alcança a rolagem |
O que deu errado na primeira construção
Cada um desses foi encontrado olhando, e cada um está corrigido no modelo.
- A margem de rolagem do cabeçalho. O cabeçalho fixo dá a cada
[id]umscroll-margin-top, para que as âncoras caiam abaixo dele. Os saltos caíam 126px antes de cada parada até que as paradas fossem ajustadas para zero. - A trilha estava um cabeçalho mais curta. A página terminava antes que a última parada pudesse chegar ao topo. A altura da trilha usa a altura da janela, não a do estágio.
- Cartões voavam atrás da coluna de conteúdo. Essa coluna é fixa e transparente, então os cartões apareciam através de seu texto. Quando a coluna está fixa, o estágio começa à sua direita.
- Cartões distantes se acumulavam no ponto de fuga. A máscara do WhatTheFad corrigiu isso.
- A estação passando persistia como um grande borrão. A correção foi um
PASSmais curto e um fade ao quadrado. - A estação em espera aparecia sob estações curtas. Ela é desenhada escurecida (ao quadrado).
- Os âncoras do modo plano apontavam para paradas ocultas. As paradas se movem para as estações.
- Uma rolagem que chegava antes do evento de carga atingia uma página curta. A trilha é disposta assim que o documento é analisado, e novamente quando as fontes e imagens se estabilizam, então uma rolagem restaurada e um link
#st-<id>ambos pousam. - Em um celular, os desenhos largos deslizam lateralmente dentro de sua placa, a fileira de imagens fica oculta e a estação é estreitada para que a barra mantenha a borda direita.
Em aberto
- Pegar um cartão. No WhatTheFad, um chip pego abre uma escavação. Aqui, um cartão poderia abrir seu registro, o que requer que a página de destino receba um id em sua URL e o teste de impacto projetado acima.
- Um controle de pausa. O fluxo se move enquanto a página estiver aberta. Movimento reduzido o para, mas não há botão de pausa, o que a WCAG 2.2.2 exige para movimento que dura mais de cinco segundos junto com outro conteúdo.
- A sensação em um trackpad e celular reais, e a taxa de quadros, não foram julgados por uma pessoa.