CommunityProgramación y desarrollogithub.com

depth-scroll

Construye una página de desplazamiento en profundidad: paneles que viajan hacia el espectador mientras se desplaza, basada en WhatTheFad.

¿Qué es depth-scroll?

Este skill te permite generar una página web interactiva con desplazamiento en profundidad, ideal para presentar una secuencia de paneles (dibujos, tarjetas conceptuales, etapas) que el lector recorre uno a uno. Inspirado en la página de aterrizaje de WhatTheFad, el skill convierte un conjunto de figuras en una experiencia inmersiva donde cada panel aparece desde la distancia, se detiene nítido en el plano de la pantalla y luego pasa detrás del espectador, mientras una corriente de tarjetas vuela hacia él. Soporta múltiples desencadenantes como 'una UI que se desplaza hacia el usuario', 'como whatthefad', 'haz que vuele hacia mí', 'desplazamiento en profundidad', 'desplázate dentro de la pantalla' o 'un túnel de estos'. El skill incluye un template HTML, un script de construcción en Python, un capturador headless en Node.js y documentación detallada. La salida es un archivo HTML autónomo sin dependencias externas ni WebGL, con una paleta de colores cálidos personalizable. Es adecuado para 4 a 12 paneles que quepan en una pantalla, pero no para texto largo, tablas o contenido que requiera comparación lateral.

Compatible con✓Claude Code~Codex CLI✓Cursor
npx skills add https://github.com/rafaelcarlosabbariao/skills/tree/HEAD/agnostic/depth-scroll

Installed? Explore more Programación y desarrollo skills: steipete/bluebubbles, steipete/eightctl, steipete/blucli · View all 6 →

Preguntar en tu IA favorita

Abre un nuevo chat con esta habilidad de agente ya precargada.

Documentación

Si existe SKILL.local.md en esta carpeta, léelo primero; contiene tus rutas, datos y reglas internas.

Desplazamiento en profundidad

Un formato de página para un conjunto de figuras que el lector recorre, una a la vez. La primera versión convirtió un conjunto de dibujos explicativos en un desplazamiento hacia el espectador, modelado a partir de la página de inicio de WhatTheFad (whatthefad.netlify.app, fuente en github.com/rafaelcarlosabbariao/cultural-archaeology).

El skill contiene cuatro archivos:

ArchivoQué es
template.htmlLa página: el marco de la estación, la corriente, el carril y el script que los controla
build.pyCompleta la plantilla a partir de una especificación, como comando o como módulo
capture.mjsCapturas headless en tiempo real y comprobaciones de navegación sobre el protocolo DevTools
SKILL.mdEste archivo

Cuándo encaja

  • Encaja para cuatro a doce paneles independientes que se lean uno a la vez, cada uno ajustado a una pantalla: dibujos, tarjetas de una sola idea, las etapas de una secuencia.
  • No encaja para texto largo, tablas o cualquier cosa que el lector compare una al lado de la otra o escanee de un lado a otro. Para eso, crea una página plana.
  • Salida. La página es un solo archivo .html autónomo, sin scripts externos ni WebGL. La plantilla incluye una paleta de colores crema cálida y tinta en los tokens de :root; puedes cambiar el estilo a tu gusto.

Cómo funciona

El campo de WhatTheFad, la fuente

Lee el index.html de WhatTheFad (CSS #landing-trendfield y la función renderTrendField).

  • Proyección. El campo es un contenedor con perspective: 900px, y cada chip se coloca con translate3d(x, y, z). El navegador dibuja un chip a escala 900 / (900 − z): 0.24 en z = −2800, 1 en el plano de la pantalla y 1.3 en z = 220.
  • Un reloj impulsa el movimiento. Un bucle requestAnimationFrame mueve cada chip hacia el espectador a 150 px/s multiplicado por un factor por chip de 0.75 a 1.25. Al pasar z = 220, reaparece en un anillo elíptico en z = −2800.
  • Desvanecimientos y orden de pintado. Un chip se desvanece en el primer cuarto de su profundidad y se desvanece entre z = 60 y 220. El campo nunca usa preserve-3d, por lo que el z-index de cada chip se establece desde su profundidad para que el más cercano se pinte encima.
  • El centro tranquilo. Una mask-image radial oculta el centro, donde los chips lejanos se reúnen en el punto de fuga.
  • Capturar un chip. El navegador vuelve a comprobar :hover solo cuando el puntero se mueve, por lo que un chip que se desliza bajo un cursor quieto nunca se ilumina. WhatTheFad prueba el puntero contra el rectángulo proyectado de cada chip en cada fotograma, y un chip capturado reduce la velocidad del campo al 8%.

Lo que agrega este formato

  • El desplazamiento es la cámara.
    • Una pista alta (main.depth) contiene una parada por estación, separadas por una altura de etapa, con scroll-snap-type: y proximity.
    • Una etapa fija debajo del encabezado anclado sostiene la escena.
    • La posición de desplazamiento se convierte en un índice de estación, entero en cada parada. La cámara se aproxima suavemente a él (velocidad 9 por segundo), y la estación i se dibuja en z = (cámara − i) × 1400.
  • El paso de una estación.
    • La estación que espera detrás está atenuada y un poco baja, por lo que se eleva a su lugar a medida que avanza.
    • En reposo está en z = 0 y escala 1, en píxeles enteros, por lo que su texto es tan nítido como una página plana.
    • Al pasar al espectador, se desvanece en z = 300, a 1.5×.
    • Una estación más alta que la etapa se escala para que quepa.
  • La corriente. El campo de WhatTheFad, incluida la máscara. La velocidad de las tarjetas es una base de 46 más 0.9 de la velocidad de la cámara, por lo que desplazarse hacia adelante las hace pasar rápidamente y desplazarse hacia atrás las aleja. Una estación nombra los grupos de tarjetas que ilumina (lit), y esas tarjetas se iluminan mientras está al frente.
  • Entrada.
    • Rueda, trackpad, toque, las teclas de flecha, el carril y el contenido del encabezado mueven el mismo desplazamiento nativo, por lo que cada entrada llega a las mismas paradas.
    • El foco que entra en una estación que no está al frente se desplaza hacia ella.
    • La corriente es decorativa, y solo la estación en reposo acepta eventos de puntero, por lo que no se necesita una prueba de impacto por fotograma.
  • Respaldo. Sin JavaScript, o con prefers-reduced-motion: reduce, la página muestra las estaciones apiladas en plano. La profundidad se activa mediante una clase deep que agrega el script. En modo plano, los anclajes del contenido se mueven a las estaciones.

Cómo construir una

SK a continuación es donde hayas instalado este skill, por ejemplo ~/.claude/skills/depth-scroll.

  1. Primero el contenido. Coloca cada panel en una página plana como <figure class="fig"> que contenga un .plate (el dibujo) y un figcaption. La página plana también es la copia de lectura. Una estación puede, en su lugar, llevar html sin procesar.
  2. Escribe una especificación (a continuación), como un archivo JSON o como un diccionario en el propio script de compilación del proyecto cuando los valores se calculan (por ejemplo, nombres de tarjetas leídos de un archivo de datos).
  3. Constrúyelo.
    python3 -I $SK/build.py spec.json
    
    o, desde un script:
    sys.path.insert(0, str(Path.home() / '.claude/skills/depth-scroll'))
    import build
    build.write(spec, base=HERE)
    
  4. Encabezado opcional. La plantilla deja espacio para un encabezado anclado (--pin-h, header.pin, nav.pin-toc). Sin uno, la etapa comienza en la parte superior de la ventana.
  5. Compruébalo con capture.mjs (a continuación), luego confirma los cambios.

La especificación

Las rutas son relativas a base: la carpeta del archivo de especificación, o la carpeta pasada a write. Las rutas de las imágenes se escriben en la página tal como se dan, así que entrégalas relativas a la página de salida.

CampoQué contiene
outLa página a escribir
titleEl <title>, nombrado por tipo (<Asunto> <sustantivo de tipo>)
sourcePágina plana opcional. Sus bloques figure.fig se convierten en fig: n, y sus bloques de estilo (no los del encabezado) se copian para que los dibujos mantengan sus clases
kickerLa pequeña etiqueta sobre una estación de sección; el subtítulo de una subsección es el nombre de su sección
doorHTML de la primera estación: un título destacado, una nota, un enlace a la página plana
stations[]id; sec y/o sub (las líneas de contenido; sec solo es una sección, sub solo una subsección, ambos abre una sección en esta estación); title (por defecto es sub, luego sec); lead (HTML, una o dos oraciones); fig o html; cards ([{img, label}], una fila de imágenes pequeñas); lit (grupos de la corriente a iluminar)
cards_labelLa etiqueta al final de la fila de imágenes de una estación
close{title, kicker, html} para la última estación, normalmente las fuentes
stream[]{label, img, group} por tarjeta. De cuarenta a ochenta se lee como una corriente
cssCSS adicional opcional, agregado al final

Comprobación

K=$SK/capture.mjs
node $K file:///ruta/pagina.html at-2.png 2                  # una estación en reposo
node $K file:///ruta/pagina.html transit.png 4.4 --wait=900  # entre dos estaciones, disparando
node $K file:///ruta/pagina.html last.png 9                  # la última parada es accesible
node $K file:///ruta/pagina.html light.png 5 --light         # el fondo diurno
node $K file:///ruta/pagina.html phone.png 3 375 700         # ancho de teléfono
node $K file:///ruta/pagina.html flat.png 0 --reduce         # la página con movimiento reducido
node $K "file:///ruta/pagina.html#st-model" hash.png -       # un enlace a una parada, al cargar
node $K file:///ruta/pagina.html nav.png 0 --nav             # flechas, el último enlace de contenido, el carril

Cada ejecución imprime las paradas y, por paso, y, front (la estación que recibe eventos de puntero), rail, cardsShown, cardsLit, deep y pageWidth. Una estación en reposo tiene front igual a su índice; pageWidth debe leer el ancho de la ventana gráfica (sin desplazamiento lateral de página). Mira cada imagen, en ambos fondos y al ancho de teléfono, antes de darlo por terminado. Para páginas cuyas imágenes están fuera de la carpeta, copia la página al bloc de notas con rutas de imagen absolutas primero.

No compruebes con chrome --headless --screenshot. Bajo --virtual-time-budget, los fotogramas de animación apenas avanzan, por lo que la cámara suavizada nunca llega, y una captura de pantalla de una ventana desplazada puede salir en blanco. capture.mjs impulsa un Chrome headless en tiempo real, donde los fotogramas se ejecutan a su velocidad real.

Ajuste

Las constantes se encuentran al principio del script en template.html.

ConstanteValorQué mueve
PERSP900Debe coincidir con la perspective CSS en .stations y .field
GAP1400Profundidad mundial entre dos estaciones
AHEAD2.2 × GAPHasta qué distancia se dibuja una estación por delante
PASS300Donde una estación que pasa se ha desvanecido (escala 1.5)
LIFT36Píxeles que una estación en espera se sienta baja por GAP de distancia
DEPTH, NEAR2800, 220La profundidad de generación de la corriente y la profundidad donde una tarjeta ha pasado volando
BASE46La velocidad de la corriente en reposo, px/s
suavizado de cámara9 por segundoQué tan rápido la cámara alcanza el desplazamiento

Lo que salió mal en la primera versión

Cada uno de estos se encontró al mirar, y cada uno está corregido en la plantilla.

  • El margen de desplazamiento del encabezado. El encabezado anclado le da a cada [id] un scroll-margin-top, por lo que los anclajes aterrizan debajo de él. Los saltos aterrizaban 126 píxeles antes de cada parada hasta que las paradas se establecieron a cero.
  • La pista era un encabezado más corta. La página terminaba antes de que la última parada pudiera llegar a la parte superior. La altura de la pista usa la altura de la ventana, no la de la etapa.
  • Las tarjetas volaban detrás de la columna de contenido. Esa columna es fija y transparente, por lo que las tarjetas se mostraban a través de su texto. Cuando la columna es fija, la etapa comienza a su derecha.
  • Las tarjetas lejanas se reunían en el punto de fuga. La máscara de WhatTheFad lo solucionó.
  • La estación que pasaba permanecía como un gran desenfoque. La solución fue un PASS más corto y un desvanecimiento al cuadrado.
  • La estación en espera se mostraba debajo de las estaciones cortas. Se dibuja atenuada (al cuadrado).
  • El contenido del modo plano apuntaba a paradas ocultas. Las paradas se mueven a las estaciones.
  • Un desplazamiento que aterrizaba antes del evento de carga golpeaba una página corta. La pista se diseña tan pronto como se analiza el documento, y nuevamente una vez que las fuentes y las imágenes se asientan, por lo que un desplazamiento restaurado y un enlace #st-<id> aterrizan.
  • En un teléfono, los dibujos anchos se desplazan lateralmente dentro de su placa, la fila de imágenes está oculta y la estación se estrecha para que el carril mantenga el borde derecho.

Pendiente

  • Capturar una tarjeta. En WhatTheFad, un chip capturado abre una excavación. Aquí una tarjeta podría abrir su registro, lo que requiere que la página de destino tome una identificación en su URL y la prueba de impacto proyectada anterior.
  • Un control de pausa. La corriente se mueve mientras la página esté abierta. El movimiento reducido la detiene, pero no hay un botón de pausa, que WCAG 2.2.2 solicita para el movimiento que dura más de cinco segundos junto con otro contenido.
  • La sensación en un trackpad y teléfono reales, y la velocidad de fotogramas, no han sido evaluadas por una persona.

Individual skills in this repo

This repo contains 1 individual skill — each has its own dedicated page.

Skills relacionados