Wenn in diesem Ordner SKILL.local.md existiert, lesen Sie diese zuerst; sie enthält Ihre Pfade, Daten und Hausregeln.
Depth Scroll
Ein Seitenformat für eine Reihe von Figuren, die der Leser eine nach der anderen durchreist. Der erste Bau verwandelte eine Reihe von erklärenden Zeichnungen in einen Scroll auf den Betrachter zu, modelliert nach der Landing-Page von WhatTheFad (whatthefad.netlify.app, Quellcode unter github.com/rafaelcarlosabbariao/cultural-archaeology).
Der Skill enthält vier Dateien:
| Datei | Beschreibung |
|---|---|
template.html | Die Seite: Stations-Chrome, der Stream, die Schiene und das Skript, das sie betreibt |
build.py | Befüllt die Vorlage aus einer Spezifikation, als Befehl oder als Modul |
capture.mjs | Echtzeit-Headless-Screenshots und Navigationsprüfungen über das DevTools-Protokoll |
SKILL.md | Diese Datei |
Wann es passt
- Es passt bei vier bis zwölf in sich abgeschlossenen Panels, die einzeln gelesen werden und jeweils auf einen Bildschirm passen: Zeichnungen, Ein-Ideen-Karten, die Phasen einer Abfolge.
- Es passt nicht bei langen Texten, Tabellen oder allem, was der Leser nebeneinander vergleichen oder hin- und herscannen muss. Bauen Sie dafür eine flache Seite.
- Ausgabe. Die Seite ist eine einzige, in sich geschlossene
.html-Datei, ohne externe Skripte und ohne WebGL. Die Vorlage enthält eine warme Cremefarben-Tinte-Palette in:root-Tokens; passen Sie diese nach Geschmack an.
Funktionsweise
Das Feld von WhatTheFad, die Quelle
Lesen Sie in WhatTheFads index.html (#landing-trendfield-CSS und die Funktion renderTrendField).
- Projektion. Das Feld ist ein Container mit
perspective: 900px, und jeder Chip wird mittranslate3d(x, y, z)platziert. Der Browser zeichnet einen Chip im Maßstab 900 / (900 − z): 0,24 bei z = −2800, 1 auf der Bildschirmebene und 1,3 bei z = 220. - Ein Taktgeber treibt die Bewegung an. Eine
requestAnimationFrame-Schleife bewegt jeden Chip auf den Betrachter zu, mit 150 px/s multipliziert mit einem pro Chip festgelegten Faktor von 0,75 bis 1,25. Nach z = 220 wird er auf einem elliptischen Ring bei z = −2800 neu erzeugt. - Ein- und Ausblendungen und Malreihenfolge. Ein Chip blendet im ersten Viertel seiner Tiefe ein und zwischen z = 60 und 220 aus. Das Feld verwendet nie
preserve-3d, daher wird derz-indexjedes Chips aus seiner Tiefe gesetzt, sodass der nähere Chip oben gemalt wird. - Die ruhige Mitte. Eine radiale
mask-imageverdeckt die Mitte, wo sich entfernte Chips am Fluchtpunkt sammeln. - Einen Chip fangen. Der Browser überprüft
:hovernur, wenn sich die Maus bewegt. Ein Chip, der unter einem stillen Cursor hindurchtreibt, leuchtet nie. WhatTheFad testet die Mausposition gegen die projizierten Rechtecke jedes Chips in jedem Frame, und ein gefangener Chip verlangsamt das Feld auf 8%.
Was dieses Format hinzufügt
- Das Scrollen ist die Kamera.
- Eine hohe Spur (
main.depth) enthält einen Halt pro Station, eine Stufenhöhe voneinander entfernt, mitscroll-snap-type: y proximity. - Eine feste Bühne unter dem fixierten Header hält die Szene.
- Die Scrollposition wird zu einem Stationsindex, ganzzahlig an jedem Halt. Eine Kamera nähert sich ihm sanft (Rate 9 pro Sekunde), und Station
iwird bei z = (Kamera − i) × 1400 gezeichnet.
- Eine hohe Spur (
- Der Durchgang einer Station.
- Die wartende Station dahinter ist dunkel und sitzt etwas tief, sodass sie beim Vorrücken in Position steigt.
- Im Ruhezustand ist sie bei z = 0 und Skalierung 1, auf ganzen Pixeln, sodass ihr Text so scharf ist wie eine flache Seite.
- Wenn sie den Betrachter passiert, blendet sie bei z = 300 mit 1,5× aus.
- Eine Station, die höher als die Bühne ist, wird skaliert, um hineinzupassen.
- Der Strom. Das Feld von WhatTheFad, inklusive Maske. Die Geschwindigkeit der Karten beträgt 46 Basis plus 0,9 der Kamerageschwindigkeit, sodass Vorwärtsscrollen sie vorbeisausen lässt und Rückwärtsscrollen sie wegschickt. Eine Station benennt die Kartengruppen, die sie beleuchtet (
lit), und diese Karten leuchten auf, solange sie vorne ist. - Eingabe.
- Mausrad, Trackpad, Touch, Pfeiltasten, die Schiene und die Inhalte des Headers bewegen alle den einen nativen Scroll, sodass jede Eingabe an denselben Halten landet.
- Wenn der Fokus in eine Station gelangt, die nicht vorne ist, scrollt er zu ihr.
- Der Strom ist dekorativ, und nur die ruhende Station nimmt Zeigerereignisse entgegen, sodass kein Treffertest pro Frame nötig ist.
- Fallback. Ohne JavaScript oder mit
prefers-reduced-motion: reducewird die Seite flach als gestapelte Stationen dargestellt. Die Tiefe wird durch einedeep-Klasse aktiviert, die das Skript hinzufügt. Im flachen Modus werden die Anker der Inhalte auf die Stationen verschoben.
Erstellen einer solchen Seite
SK unten steht für das Verzeichnis, in dem Sie diesen Skill installiert haben, z. B. ~/.claude/skills/depth-scroll.
- Inhalt zuerst. Setzen Sie jedes Panel auf eine flache Seite als
<figure class="fig">, die eine.platte(die Zeichnung) und einefigcaptionenthält. Die flache Seite ist auch die Lesekopie. Eine Station kann stattdessen roheshtmltragen. - Schreiben Sie eine Spezifikation (unten), als JSON-Datei oder als Dictionary im eigenen Build-Skript des Projekts, wenn Werte berechnet werden (z. B. Kartennamen aus einer Datendatei).
- Bauen Sie es.
oder aus einem Skript:python3 -I $SK/build.py spec.jsonsys.path.insert(0, str(Path.home() / '.claude/skills/depth-scroll')) import build build.write(spec, base=HIER) - Optionaler Header. Die Vorlage lässt Platz für einen fixierten Header (
--pin-h,header.pin,nav.pin-toc). Ohne einen solchen beginnt die Bühne am oberen Fensterrand. - Überprüfen Sie es mit
capture.mjs(unten), dann committen Sie es.
Die Spezifikation
Pfade sind relativ zu base: dem Ordner der Spezifikationsdatei oder dem an write übergebenen Ordner. Bildpfade werden so in die Seite geschrieben, wie sie angegeben werden; geben Sie sie daher relativ zur Ausgabeseite an.
| Feld | Inhalt |
|---|---|
out | Die zu schreibende Seite |
title | Der <title>, benannt nach Art (<Subject> <Art-Substantiv>) |
source | Optionale flache Seite. Deren figure.fig-Blöcke werden zu fig: n, und ihre Style-Blöcke (nicht die des Headers) werden übernommen, damit die Zeichnungen ihre Klassen behalten |
kicker | Die kleine Bezeichnung über einer Station auf Abschnittsebene; die Bezeichnung eines Unterabschnitts ist der Name seines Abschnitts |
door | HTML der ersten Station: ein Vorwort, ein Hinweis, ein Link zur flachen Seite |
stations[] | id; sec und/oder sub (die Inhaltszeilen; sec allein ist ein Abschnitt, sub allein ein Unterabschnitt, beide öffnen einen Abschnitt auf dieser Station); title (Standard ist sub, dann sec); lead (HTML, ein oder zwei Sätze); fig oder html; cards ([{img, label}], eine kleine Bildzeile); lit (zu beleuchtende Stromgruppen) |
cards_label | Die Bezeichnung am Ende der Bildzeile einer Station |
close | {title, kicker, html} für die letzte Station, normalerweise die Quellen |
stream[] | {label, img, group} pro Karte. Vierzig bis achtzig ergeben einen Strom |
css | Optionales zusätzliches CSS, zuletzt angehängt |
Überprüfung
K=$SK/capture.mjs
node $K file:///pfad/seite.png at-2.png 2 # eine ruhende Station
node $K file:///pfad/seite.png transit.png 4.4 --wait=900 # zwischen zwei Stationen, einrastend
node $K file:///pfad/seite.png last.png 9 # der letzte Halt ist erreichbar
node $K file:///pfad/seite.png light.png 5 --light # der helle Grund
node $K file:///pfad/seite.png phone.png 3 375 700 # Telefonbreite
node $K file:///pfad/seite.png flat.png 0 --reduce # die Seite mit reduzierter Bewegung
node $K "file:///pfad/seite.html#st-model" hash.png - # ein Link zu einem Halt, beim Laden
node $K file:///pfad/seite.png nav.png 0 --nav # Pfeile, der letzte Inhaltslink, die Schiene
Jeder Durchlauf gibt die Halte aus und, pro Schritt, y, front (die Station, die Zeigerereignisse empfängt), rail, cardsShown, cardsLit, deep und pageWidth. Eine ruhende Station hat front gleich ihrem Index; pageWidth muss die Viewport-Breite anzeigen (kein seitliches Seiten-Scrollen). Sehen Sie sich jedes Bild an, sowohl in hellem als auch dunklem Grund und bei Telefonbreite, bevor Sie es als erledigt betrachten. Bei Seiten, deren Bilder außerhalb des Ordners liegen, kopieren Sie die Seite zuerst mit absoluten Bildpfaden in die Zwischenablage.
Überprüfen Sie nicht mit chrome --headless --screenshot. Unter --virtual-time-budget kommen Animationsframes kaum voran, sodass die sanfte Kamera nie ankommt, und ein Screenshot eines gescrollten Fensters kann leer zurückkommen. capture.mjs steuert einen Echtzeit-Headless-Chrome, in dem Frames mit ihrer echten Rate laufen.
Feinabstimmung
Die Konstanten stehen am Kopf des Skripts in template.html.
| Konstante | Wert | Was sie bewegt |
|---|---|---|
PERSP | 900 | Muss mit dem CSS perspective auf .stations und .field übereinstimmen |
GAP | 1400 | Welt-Tiefe zwischen zwei Stationen |
AHEAD | 2,2 × GAP | Wie weit voraus eine Station überhaupt gezeichnet wird |
PASS | 300 | Wo eine vorbeiziehende Station ausgeblendet ist (Skalierung 1,5) |
LIFT | 36 | Pixel, um die eine wartende Station pro GAP-Entfernung tiefer sitzt |
DEPTH, NEAR | 2800, 220 | Die Entstehungstiefe des Stroms und die Tiefe, in der eine Karte vorbeigeflogen ist |
BASE | 46 | Die Geschwindigkeit des Stroms im Ruhezustand, px/s |
| Kamera-Beruhigung | 9 pro Sekunde | Wie schnell die Kamera den Scroll einholt |
Was beim ersten Bau schiefging
Jeder dieser Fehler wurde durch Hinsehen gefunden und ist in der Vorlage behoben.
- Der Scroll-Margin des Headers. Der fixierte Header gibt jedem
[id]einenscroll-margin-top, damit Anker unter ihm landen. Sprünge landeten 126px zu kurz vor jedem Halt, bis die Halte auf Null gesetzt wurden. - Die Spur war einen Header zu kurz. Die Seite endete, bevor der letzte Halt die Spitze erreichen konnte. Die Höhe der Spur verwendet die Fensterhöhe, nicht die der Bühne.
- Karten flogen hinter die Inhalts-Spalte. Diese Spalte ist fixiert und transparent, sodass Karten durch ihren Text hindurch sichtbar waren. Wenn die Spalte fixiert ist, beginnt die Bühne rechts davon.
- Entfernte Karten sammelten sich am Fluchtpunkt. WhatTheFads Maske behob das Problem.
- Die vorbeiziehende Station blieb als großer Unschärfe-Fleck zurück. Die Lösung war ein kürzerer
PASSund ein quadratisches Ausblenden. - Die wartende Station war unter kurzen Stationen sichtbar. Sie wird dunkel gezeichnet (quadratisch).
- Der flache Modus zeigte auf versteckte Halte. Die Halte werden auf die Stationen verschoben.
- Ein Scroll, der vor dem Lade-Ereignis landete, traf auf eine zu kurze Seite. Die Spur wird sofort nach dem Parsen des Dokuments angelegt und erneut, sobald Schriftarten und Bilder sich gesetzt haben, sodass ein wiederhergestellter Scroll und ein
#st-<id>-Link beide landen. - Auf einem Telefon schwenken die breiten Zeichnungen seitlich innerhalb ihrer Platte, die Bildzeile wird ausgeblendet und die Station wird verschmälert, sodass die Schiene den rechten Rand behält.
Offen
- Eine Karte fangen. In WhatTheFad öffnet ein gefangener Chip eine Ausgrabung. Hier könnte eine Karte ihren Datensatz öffnen, was erfordert, dass die Zielseite eine ID in ihrer URL aufnimmt und der projizierte Treffertest von oben durchgeführt wird.
- Eine Pausensteuerung. Der Strom bewegt sich, solange die Seite geöffnet ist. Reduzierte Bewegung stoppt ihn, aber es gibt keinen Pause-Button, was WCAG 2.2.2 für Bewegung fordert, die länger als fünf Sekunden zusammen mit anderen Inhalten dauert.
- Das Gefühl auf einem echten Trackpad und Telefon sowie die Bildrate wurden noch nicht von einer Person beurteilt.