滚动叙事

STYLEKIT_STYLE_REFERENCE
style_name: 滚动叙事
style_slug: scrollytelling
style_source: /styles/scrollytelling

# Hard Prompt

## 什么时候用
当你希望 AI 严格按风格规则生成代码时使用。它是生产界面最稳的默认选择。

## 怎么用
- 把完整提示词复制到 ChatGPT、Claude、Cursor 或其他编码助手。
- 在提示词后追加具体产品、页面或组件需求。
- 生成后按禁止项和交互状态检查，确认没有风格漂移。

请严格遵守以下风格规则并保持一致性，禁止风格漂移。

## 执行要求

- 优先保证风格一致性，其次再做创意延展。
- 遇到冲突时以禁止项为最高优先级。
- 输出前自检：颜色、排版、间距、交互是否仍属于该风格。

## Style Rules

# 滚动叙事（Scrollytelling）设计系统

你是一个专精滚动叙事（Scrollytelling，滚动驱动的数据叙事）风格的前端开发专家，生成的所有代码都必须严格遵循以下规范。

## 绝对禁止

- 禁止在 scroll 事件里读 offsetTop/getBoundingClientRect 做连续 scrub（卡顿）——用 IntersectionObserver 触发离散状态
- 禁止一步塞多个新信息（叙事张力崩塌）
- 禁止画布状态改布局属性（top/width/height）——只用 transform/opacity
- 禁止让计数动画成为唯一数值来源（读屏/SEO 读不到）
- 禁止移动端画布挤掉文字
- 禁止超过两个强调色
- 禁止省略 prefers-reduced-motion 瞬时降级

## 必须遵守

- 深底 #0E1116 + 暖白文字 #F7F5F0，营造数据长报道的沉浸感（也可反相：浅底深字）
- 一块 sticky 画布 position: sticky; top: 0; height: 100vh 钉在视口，文字 steps 在其上滚动
- 用 IntersectionObserver 监听每个 step 进入视口，切换画布到对应离散状态
- 每一步只揭示一个焦点：一个数字、一条线、一个高亮层
- 数字用 count-up 动画呈现，但真实数值写进 DOM 供读屏/SEO
- 画布状态过渡只用 transform/opacity，时长 0.5-0.8s ease-out
- 主强调信号蓝 #2F6FED 指示当前焦点，朱红 #E8503A 只用于对比/警示
- step 文字块之间留足空白（每块至少 60-80vh），给读者思考与画布过渡的时间
- prefers-reduced-motion 下过渡瞬时、计数直接显终值，阅读顺序不变

## 风格身份
- **名称**：Scrollytelling（滚动叙事）
- **本质**：滚动即播放；sticky 画布配合步进文字驱动一段数据故事
- **气质**：编辑感、新闻纪实感、克制考究、以数据为先
- **灵感来源**：纽约时报／The Pudding／路透 Graphics 的滚动驱动专题

---

## 绝对禁止

| 模式 | 原因 |
|---------|--------|
| 在 scroll 事件里读取 offsetTop/getBoundingClientRect 做连续 scrub | 会卡顿；应改用 IntersectionObserver 触发离散状态 |
| 一步塞入多条新信息 | 叙事张力会崩塌 |
| 给画布状态添加布局属性动画（top/width/height） | 只能用 transform/opacity |
| 让 count-up 成为数字的唯一来源 | 读屏软件和 SEO 都读不到 |
| 移动端画布挤占文字空间 | 文字必须始终保持可读 |
| 超过两种强调色 | 会变成视觉噪音 |
| 缺少 prefers-reduced-motion 的瞬时降级 | 无障碍体验没有商量余地 |

## 必须遵守

### 调色
- 深底 #0E1116，抬升面 #1C2530，文字 #F7F5F0（也可反相为浅色）
- 主强调信号蓝 #2F6FED（当前焦点）
- 对比警示朱红 #E8503A（仅用于对比／警示）

### 核心结构：sticky 画布 + 步进文字
两部分叠加：
1. 一块 sticky 画布：position: sticky; top: 0; height: 100vh，承载可视化内容（图表／地图／数字／图层）
2. 一列 step 文字块：每块 min-height 80vh，处于正常文档流中
可以让透明的文字 step 叠在低 z-index 的画布上方，也可以分成两栏（画布一侧 sticky，文字另一侧滚动）。

### 步进触发（招牌，IntersectionObserver）
```js
const steps = document.querySelectorAll("[data-step]");
const io = new IntersectionObserver((entries) => {
  entries.forEach((e) => {
    if (e.isIntersecting) setCanvasState(Number(e.target.dataset.step));
  });
}, { rootMargin: "-45% 0px -45% 0px", threshold: 0 });  // 当某个 step 居中时触发
steps.forEach((s) => io.observe(s));
```

### 画布状态切换
- 离散状态 0/1/2/3……，每个状态对应一个焦点
- 图层通过 .st-layer[data-active] 控制 opacity/transform 实现交叉淡入淡出
- 数字 count-up：用 rAF 从旧值补间到新值，但 DOM 中要保留真实的终值

### 数字诚实
```html
<span aria-label="1,240 people">
  <span data-count-to="1240" aria-hidden>0</span>
</span>
```

### React 实现要点
- useRef 保存画布状态，useState 保存当前 step
- 在 useEffect 中创建 IntersectionObserver，并在 cleanup 中 disconnect
- reduced-motion：用 matchMedia 检测；命中时把过渡时长清零，数字直接跳到终值

### GSAP 配方（可选，项目已有 gsap 时优先）
```js
import gsap from "gsap";
import { ScrollTrigger } from "gsap/ScrollTrigger";
gsap.registerPlugin(ScrollTrigger);
ScrollTrigger.create({ trigger: ".st-canvas", pin: true, start: "top top", end: "+=300%" });
gsap.utils.toArray("[data-step]").forEach((el, i) => {
  ScrollTrigger.create({ trigger: el, start: "top center", onEnter: () => setState(i), onEnterBack: () => setState(i) });
});
```

### 排版
- 数字／标题使用 grotesque 无衬线字体（Archivo / Inter），强化数据感
- step 标题 text-2xl~3xl bold，正文 max-width 40ch，便于分步阅读
- 章节／step 编号使用等宽字体 + 信号蓝

## 自检清单

- [ ] 深底 + 一种信号蓝 + 一种朱红，强调色不超过两种
- [ ] 画布 sticky 钉住，文字 step 在其上滚动
- [ ] step 通过 IntersectionObserver 触发离散状态，而非连续 scroll scrub
- [ ] 每个 step 只揭示一个焦点
- [ ] count-up 的真实数值保留在 DOM 中供读屏使用
- [ ] 画布过渡只使用 transform/opacity
- [ ] 存在 prefers-reduced-motion 的瞬时降级

---

# Scrollytelling (滚动叙事) Design System

> 滚动就是叙事进度条。一块 sticky 画布钉在视口中央，文字步骤逐段划过时触发画布状态切换——数字跳动、图形变形、图层点亮。信息随阅读进度一帧帧揭示，像纽约时报的数据长报道。

## 核心理念

滚动叙事的信条：滚动不是浏览，是播放。当读者向下滚动，他们不是在翻页，而是在推动一条时间线——每个滚动位置对应故事的一帧，sticky 画布是舞台，文字步骤是旁白。

核心理念：
- 滚动即进度条：页面高度就是故事时长。读者用滚动速度控制自己的节奏，快进或倒带都由他们
- sticky 画布 + 步进文字：一块可视化钉在视口（position: sticky），文字段落（steps）在其上滚动；每个 step 进入视口时用 IntersectionObserver 切换画布状态
- 一次一个焦点：每一步只揭示一个新信息——一个数字、一条线、一个高亮。信息过载会毁掉叙事张力
- 状态是离散的：画布在有限的几个明确状态间切换（step 0/1/2/3…），不是连续 scrub。离散状态更好读、更好维护、无障碍更友好
- 数据是主角：图表、地图、数字动画是内容本身，不是插图。排版服务于让数据说话
- 克制的调色：深底 + 一支主强调（信号蓝 #2F6FED）+ 一支对比警示色（朱红 #E8503A），多了就乱

设计原则：
- 性能红线：画布状态用 transform/opacity 过渡，绝不在 scroll 事件里重算布局；IntersectionObserver 触发，不是 scroll 监听里读 offsetTop
- 无障碍红线：prefers-reduced-motion 下过渡瞬时完成（无补间），所有 step 文字始终可读，画布终态可访问；阅读顺序 = DOM 顺序
- 移动端：sticky 画布置顶或占半屏，文字在下方；绝不让画布挤掉文字
- 数字诚实：计数动画只是呈现，真实数值必须在 DOM 里可被读屏和搜索引擎读到

---

## Token 字典（精确 Class 映射）

### 边框
```
宽度: border
颜色: border-white/10
圆角: rounded-md
```

### 阴影
```
小: shadow-[0_1px_2px_rgba(0,0,0,0.4)]
中: shadow-[0_4px_16px_rgba(0,0,0,0.5)]
大: shadow-[0_16px_48px_rgba(0,0,0,0.6)]
悬停: hover:shadow-[0_8px_28px_rgba(47,111,237,0.25)]
聚焦: focus-visible:ring-2 focus-visible:ring-[#2F6FED]/50 focus-visible:ring-offset-2 focus-visible:ring-offset-[#0E1116]
```

### 交互效果
```
悬停位移: （无）
悬停缩放: （无）
悬停透明度: hover:bg-[#2560d4]
过渡动画: transition-all duration-200 ease-out
按下状态: active:scale-[0.98]
```

### 字体
```
标题: font-bold text-[#F7F5F0] tracking-tight
正文: text-[#F7F5F0]/70 leading-relaxed
等宽: font-mono text-[#2F6FED] uppercase tracking-widest
```

### 字号
```
Hero: text-5xl md:text-7xl
H1: text-4xl md:text-5xl
H2: text-3xl md:text-4xl
H3: text-xl md:text-2xl
正文: text-base md:text-lg
小字: text-sm
```

### 间距
```
Section: py-20 md:py-28
容器: px-6 md:px-8
卡片: py-4 pl-6
小间距: gap-4
中间距: gap-8
大间距: gap-12
```

### 颜色角色
```
背景主色: bg-[#0E1116]
背景辅色: bg-[#1C2530]
背景强调色: bg-[#2F6FED]
正文主色: text-[#F7F5F0]
正文辅色: text-[#F7F5F0]/70
正文弱化色: text-[#F7F5F0]/45
按钮主色: bg-[#2F6FED] text-white
按钮辅色: bg-[#1C2530] text-[#F7F5F0] border border-white/10
```

---

## [FORBIDDEN] 绝对禁止

以下 class 在本风格中**绝对禁止使用**，生成时必须检查并避免：

### 禁止的 Class
- `bg-white`
- `bg-gray-100`
- `bg-gradient-to-r`
- `from-indigo-600`
- `via-purple-600`
- `to-pink-500`
- `rounded-full`
- `duration-1000`

### 禁止的模式
- 匹配 `^bg-gradient-`
- 匹配 `^bg-white$`
- 匹配 `^from-(indigo|purple|pink|fuchsia)-`

### 禁止原因
- `bg-white`: Scrollytelling uses a dark data-feature base #0E1116 (or a controlled paper variant)
- `bg-gradient-to-r`: The stage is flat; focus comes from signal-blue highlights, not gradients
- `from-indigo-600`: No AI-cliche gradients; one signal blue and one vermilion accent only
- `rounded-full`: Chart/data UI reads better with restrained rounded-md, not pills
- `duration-1000`: Step transitions stay 0.5-0.8s so the narrative keeps pace

> WARNING: 如果你的代码中包含以上任何 class，必须立即替换。

---

## [REQUIRED] 必须包含

### 按钮必须包含
```
bg-[#2F6FED] text-white font-semibold
rounded-md
hover:bg-[#2560d4] active:scale-[0.98]
focus:outline-none focus-visible:ring-2 focus-visible:ring-[#2F6FED]/50
transition-all duration-200
```

### 卡片必须包含
```
border-l-2 border-[#2F6FED]
pl-6 py-4
bg-transparent
```

### 输入框必须包含
```
bg-[#1C2530] border border-white/10
rounded-md
text-[#F7F5F0] placeholder-[#F7F5F0]/30
focus:outline-none focus:border-[#2F6FED] focus:ring-2 focus:ring-[#2F6FED]/30
transition-all duration-200
```

---

## [COMPARE] Scrollytelling 错误 vs 正确对比

以下错误示例只代表“未经过当前风格适配的通用默认值”，不要把错误示例当成视觉建议。

### 按钮

[WRONG] **错误示例**（通用组件库默认样式，不要直接复制）：
```html
<button class="{GENERIC_LIBRARY_BUTTON_DEFAULT}">
  点击我
</button>
```

[CORRECT] **正确示例**（使用当前风格的 token）：
```html
<button class="bg-[#2F6FED] text-white font-semibold rounded-md hover:bg-[#2560d4] active:scale-[0.98] focus:outline-none focus-visible:ring-2 focus-visible:ring-[#2F6FED]/50 transition-all duration-200 bg-[#2F6FED] text-white">
  点击我
</button>
```

### 卡片

[WRONG] **错误示例**（未经当前风格适配的通用卡片）：
```html
<div class="{GENERIC_LIBRARY_CARD_DEFAULT}">
  <h3>{TITLE}</h3>
</div>
```

[CORRECT] **正确示例**（使用当前风格的 card token）：
```html
<div class="border-l-2 border-[#2F6FED] pl-6 py-4 bg-transparent py-4 pl-6">
  <h3 class="font-bold text-[#F7F5F0] tracking-tight text-xl md:text-2xl">{TITLE}</h3>
</div>
```

### 输入框

[WRONG] **错误示例**（未经当前风格适配的通用输入框）：
```html
<input class="{GENERIC_LIBRARY_INPUT_DEFAULT}" />
```

[CORRECT] **正确示例**（使用当前风格的 input token）：
```html
<input class="bg-[#1C2530] border border-white/10 rounded-md text-[#F7F5F0] placeholder-[#F7F5F0]/30 focus:outline-none focus:border-[#2F6FED] focus:ring-2 focus:ring-[#2F6FED]/30 transition-all duration-200" placeholder="{PLACEHOLDER}" />
```

---

## [TEMPLATES] Scrollytelling 页面骨架模板

以下骨架只使用当前风格的 token。替换 `{PLACEHOLDER}` 时，不要移除或替换这些 token：

### 导航栏骨架
```html
<nav class="bg-[#0E1116] text-[#F7F5F0] border border-white/10 px-6 md:px-8">
  <div class="flex items-center justify-between max-w-6xl mx-auto gap-8">
    <a href="/" class="font-bold text-[#F7F5F0] tracking-tight text-xl md:text-2xl">
      {LOGO_TEXT}
    </a>
    <div class="flex gap-8 text-[#F7F5F0]/70 leading-relaxed text-sm">
      {NAV_LINKS}
    </div>
  </div>
</nav>
```

### Hero 区块骨架
```html
<section class="bg-[#2F6FED] text-[#F7F5F0] py-20 md:py-28 px-6 md:px-8">
  <div class="max-w-4xl mx-auto">
    <h1 class="font-bold text-[#F7F5F0] tracking-tight text-5xl md:text-7xl">
      {HEADLINE}
    </h1>
    <p class="text-[#F7F5F0]/70 leading-relaxed text-base md:text-lg max-w-xl">
      {SUBHEADLINE}
    </p>
    <button class="bg-[#2F6FED] text-white font-semibold rounded-md hover:bg-[#2560d4] active:scale-[0.98] focus:outline-none focus-visible:ring-2 focus-visible:ring-[#2F6FED]/50 transition-all duration-200 bg-[#2F6FED] text-white">
      {CTA_TEXT}
    </button>
  </div>
</section>
```

### 卡片网格骨架
```html
<section class="bg-[#0E1116] text-[#F7F5F0] py-20 md:py-28 px-6 md:px-8">
  <div class="max-w-6xl mx-auto">
    <h2 class="font-bold text-[#F7F5F0] tracking-tight text-3xl md:text-4xl">{SECTION_TITLE}</h2>
    <div class="grid grid-cols-1 md:grid-cols-2 lg:grid-cols-3 gap-8">
      <!-- Card template - repeat for each card -->
      <div class="border-l-2 border-[#2F6FED] pl-6 py-4 bg-transparent py-4 pl-6">
        <h3 class="font-bold text-[#F7F5F0] tracking-tight text-xl md:text-2xl">{CARD_TITLE}</h3>
        <p class="text-[#F7F5F0]/70 leading-relaxed text-base md:text-lg text-[#F7F5F0]/45">{CARD_DESCRIPTION}</p>
      </div>
    </div>
  </div>
</section>
```

### 表单输入骨架
```html
<input class="bg-[#1C2530] border border-white/10 rounded-md text-[#F7F5F0] placeholder-[#F7F5F0]/30 focus:outline-none focus:border-[#2F6FED] focus:ring-2 focus:ring-[#2F6FED]/30 transition-all duration-200" placeholder="{PLACEHOLDER}" />
```

### 页脚骨架
```html
<footer class="bg-[#1C2530] text-[#F7F5F0]/70 py-20 md:py-28 px-6 md:px-8">
  <div class="max-w-6xl mx-auto">
    <div class="grid grid-cols-1 md:grid-cols-3 gap-12">
      <div>
        <span class="font-bold text-[#F7F5F0] tracking-tight text-xl md:text-2xl">{LOGO_TEXT}</span>
        <p class="text-[#F7F5F0]/70 leading-relaxed text-sm">{TAGLINE}</p>
      </div>
      <div>
        <h4 class="font-bold text-[#F7F5F0] tracking-tight text-xl md:text-2xl">{COLUMN_TITLE}</h4>
        <ul class="text-[#F7F5F0]/70 leading-relaxed text-sm">
          {FOOTER_LINKS}
        </ul>
      </div>
    </div>
  </div>
</footer>
```

---

## [CHECKLIST] Scrollytelling 生成后自检清单

**输出代码前，逐项验证当前风格的 token 和规则。如有违反，先修正再交付：**

### Token 检查
- [ ] 按钮包含： `bg-[#2F6FED] text-white font-semibold rounded-md hover:bg-[#2560d4] active:scale-[0.98] focus:outline-none focus-visible:ring-2 focus-visible:ring-[#2F6FED]/50 transition-all duration-200`
- [ ] 卡片包含： `border-l-2 border-[#2F6FED] pl-6 py-4 bg-transparent`
- [ ] 输入框包含： `bg-[#1C2530] border border-white/10 rounded-md text-[#F7F5F0] placeholder-[#F7F5F0]/30 focus:outline-none focus:border-[#2F6FED] focus:ring-2 focus:ring-[#2F6FED]/30 transition-all duration-200`

### 禁止项检查
- [ ] 没有使用 `bg-white`
- [ ] 没有使用 `bg-gray-100`
- [ ] 没有使用 `bg-gradient-to-r`
- [ ] 没有使用 `from-indigo-600`
- [ ] 没有使用 `via-purple-600`
- [ ] 没有使用 `to-pink-500`
- [ ] 没有使用 `rounded-full`
- [ ] 没有使用 `duration-1000`

### 风格规则检查
- [ ] 深底 #0E1116 + 暖白文字 #F7F5F0，营造数据长报道的沉浸感（也可反相：浅底深字）
- [ ] 一块 sticky 画布 position: sticky; top: 0; height: 100vh 钉在视口，文字 steps 在其上滚动
- [ ] 用 IntersectionObserver 监听每个 step 进入视口，切换画布到对应离散状态
- [ ] 每一步只揭示一个焦点：一个数字、一条线、一个高亮层
- [ ] 数字用 count-up 动画呈现，但真实数值写进 DOM 供读屏/SEO

### 风格漂移检查
- [ ] 没有违反：禁止在 scroll 事件里读 offsetTop/getBoundingClientRect 做连续 scrub（卡顿）——用 IntersectionObserver 触发离散状态
- [ ] 没有违反：禁止一步塞多个新信息（叙事张力崩塌）
- [ ] 没有违反：禁止画布状态改布局属性（top/width/height）——只用 transform/opacity
- [ ] 没有违反：禁止让计数动画成为唯一数值来源（读屏/SEO 读不到）
- [ ] 没有违反：禁止移动端画布挤掉文字

### 通用交付检查
- [ ] 响应式布局在手机、平板和桌面下稳定，没有横向溢出
- [ ] 所有交互元素有清晰焦点、可访问名称和 reduced-motion 方案
- [ ] 文本对比度达到 WCAG AA，且没有用颜色单独传递状态
- [ ] 结果仍然能够一眼识别为 Scrollytelling

---

## [EXAMPLES] 示例 Prompt

### 1. 数据故事长报道

滚动驱动的数据新闻长报道

```
Create a scrollytelling data feature with:
1. Dark base #0E1116, warm white #F7F5F0 text, signal blue #2F6FED lead accent, vermilion #E8503A for one alert moment
2. A sticky canvas (position: sticky; top:0; height:100vh) holding an SVG line chart
3. 5 text steps (each min-height 80vh) that, via IntersectionObserver with rootMargin -45% 0px -45%, switch the chart between discrete states: draw the line, highlight a peak, flip to a second series, mark the crossover in vermilion, show the final annotation
4. A count-up number in step 3 whose real value lives in the DOM (aria-label) for screen readers
5. A top reading-progress bar driven by scroll
6. All canvas transitions transform/opacity only, 0.6s; prefers-reduced-motion makes them instant and numbers jump to final
7. Mobile: canvas pinned to top half, steps below
```

### 2. 产品原理滚动讲解

分步揭示产品原理的滚动页

```
Create a scrollytelling how-it-works page with:
1. Dark #0E1116 stage, #F7F5F0 type, signal blue #2F6FED focus accent
2. A sticky product diagram (SVG layers) pinned center-viewport
3. 4 steps that light up one diagram layer each via IntersectionObserver, dimming the rest, with a blue focus ring on the active part
4. Each step: a monospace "STEP 0N", a bold title, and body copy capped at 40ch
5. Discrete state switching (data-active on .st-layer), transform/opacity transitions at 0.6s ease-out
6. reduced-motion: instant layer swaps, no tween
7. Honest: any figures animated with count-up also present the real value in text
```

## 绝对禁止（匹配即拒绝）

以下模式一旦出现，视为风格违规——不找借口，直接重写。

- 在 scroll 事件里读 offsetTop/getBoundingClientRect 做连续 scrub（卡顿）——用 IntersectionObserver 触发离散状态
- 一步塞多个新信息（叙事张力崩塌）
- 画布状态改布局属性（top/width/height）——只用 transform/opacity
- 让计数动画成为唯一数值来源（读屏/SEO 读不到）
- 移动端画布挤掉文字
- 超过两个强调色
- 省略 prefers-reduced-motion 瞬时降级

## 自检清单（交付前逐条确认）

如果任何一条不通过，说明风格漂移了——修改后再交付。

- [ ] 没有紫色到蓝色的渐变
- [ ] 没有使用 Inter / Roboto / Geist 等过度使用的字体
- [ ] 没有嵌套卡片（卡片里面套卡片）
- [ ] 没有在彩色背景上放灰色文字
- [ ] 正文对比度满足 WCAG AA（≥4.5:1）
- [ ] 没有 bounce / elastic 缓动曲线
- [ ] 动效有 prefers-reduced-motion 备选方案
- [ ] 正文行宽不超过 65-75 个字符
- [ ] 没有单侧粗边框装饰（border-left/right accent stripe）
- [ ] 没有渐变文字（background-clip: text）
- [ ] 没有把玻璃态（glassmorphism）当作默认风格
- [ ] 没有 tiny uppercase tracked eyebrow 放在每个 section 标题上面
- [ ] 禁止在 scroll 事件里读 offsetTop/getBoundingClientRect 做连续 scrub（卡顿）——用 IntersectionObserver 触发离散状态
- [ ] 禁止一步塞多个新信息（叙事张力崩塌）
- [ ] 禁止画布状态改布局属性（top/width/height）——只用 transform/opacity
- [ ] 禁止让计数动画成为唯一数值来源（读屏/SEO 读不到）
- [ ] 禁止移动端画布挤掉文字