滚动叙事

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

# Hard Prompt

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

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

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

## 执行要求

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

## Style Rules

# 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]
```

### 交互效果
```
悬停位移: undefined
过渡动画: transition-all duration-200 ease-out
按下状态: active:scale-[0.98]
```

### 字体
```
标题: font-bold text-[#F7F5F0] tracking-tight
正文: text-[#F7F5F0]/70 leading-relaxed
```

### 字号
```
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
```

---

## [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] 错误 vs 正确对比

### 按钮

[WRONG] **错误示例**（使用了圆角和模糊阴影）：
```html
<button class="rounded-lg shadow-lg bg-blue-500 text-white px-4 py-2 hover:bg-blue-600">
  点击我
</button>
```

[CORRECT] **正确示例**（使用硬边缘、无圆角、位移效果）：
```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-[#ff006e] text-white px-4 py-2 md:px-6 md:py-3">
  点击我
</button>
```

### 卡片

[WRONG] **错误示例**（使用了渐变和圆角）：
```html
<div class="rounded-xl shadow-2xl bg-gradient-to-r from-purple-500 to-pink-500 p-6">
  <h3 class="text-xl font-semibold">标题</h3>
</div>
```

[CORRECT] **正确示例**（纯色背景、硬边缘阴影）：
```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">标题</h3>
</div>
```

### 输入框

[WRONG] **错误示例**（灰色边框、圆角）：
```html
<input class="rounded-md border border-gray-300 px-3 py-2 focus:ring-2 focus:ring-blue-500" />
```

[CORRECT] **正确示例**（黑色粗边框、聚焦阴影）：
```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 px-3 py-2 md:px-4 md:py-3" placeholder="请输入..." />
```

---

## [TEMPLATES] 页面骨架模板

使用以下模板生成页面，只需替换 `{PLACEHOLDER}` 部分：

### 导航栏骨架
```html
<nav class="bg-white border-b-2 md:border-b-4 border-black px-4 md:px-8 py-3 md:py-4">
  <div class="flex items-center justify-between max-w-6xl mx-auto">
    <a href="/" class="font-black text-xl md:text-2xl tracking-wider">
      {LOGO_TEXT}
    </a>
    <div class="flex gap-4 md:gap-8 font-mono text-sm md:text-base">
      {NAV_LINKS}
    </div>
  </div>
</nav>
```

### Hero 区块骨架
```html
<section class="min-h-[60vh] md:min-h-[80vh] flex items-center px-4 md:px-8 py-12 md:py-0 bg-{ACCENT_COLOR} border-b-2 md:border-b-4 border-black">
  <div class="max-w-4xl mx-auto">
    <h1 class="font-black text-4xl md:text-6xl lg:text-8xl leading-tight tracking-tight mb-4 md:mb-6">
      {HEADLINE}
    </h1>
    <p class="font-mono text-base md:text-xl max-w-xl mb-6 md:mb-8">
      {SUBHEADLINE}
    </p>
    <button class="bg-black text-white font-black px-6 py-3 md:px-8 md:py-4 border-2 md:border-4 border-black shadow-[4px_4px_0px_0px_rgba(255,0,110,1)] md:shadow-[8px_8px_0px_0px_rgba(255,0,110,1)] hover:shadow-none hover:translate-x-[2px] hover:translate-y-[2px] transition-all text-sm md:text-base">
      {CTA_TEXT}
    </button>
  </div>
</section>
```

### 卡片网格骨架
```html
<section class="py-12 md:py-24 px-4 md:px-8">
  <div class="max-w-6xl mx-auto">
    <h2 class="font-black text-2xl md:text-4xl mb-8 md:mb-12">{SECTION_TITLE}</h2>
    <div class="grid grid-cols-1 md:grid-cols-2 lg:grid-cols-3 gap-4 md:gap-6">
      <!-- Card template - repeat for each card -->
      <div class="bg-white border-2 md:border-4 border-black shadow-[4px_4px_0px_0px_rgba(0,0,0,1)] md:shadow-[8px_8px_0px_0px_rgba(0,0,0,1)] p-4 md:p-6 hover:shadow-[4px_4px_0px_0px_rgba(255,0,110,1)] md:hover:shadow-[8px_8px_0px_0px_rgba(255,0,110,1)] hover:-translate-y-1 transition-all">
        <h3 class="font-black text-lg md:text-xl mb-2">{CARD_TITLE}</h3>
        <p class="font-mono text-sm md:text-base text-gray-700">{CARD_DESCRIPTION}</p>
      </div>
    </div>
  </div>
</section>
```

### 页脚骨架
```html
<footer class="bg-black text-white py-12 md:py-16 px-4 md:px-8 border-t-2 md:border-t-4 border-black">
  <div class="max-w-6xl mx-auto">
    <div class="grid grid-cols-1 md:grid-cols-3 gap-8">
      <div>
        <span class="font-black text-xl md:text-2xl">{LOGO_TEXT}</span>
        <p class="font-mono text-sm mt-4 text-gray-400">{TAGLINE}</p>
      </div>
      <div>
        <h4 class="font-black text-lg mb-4">{COLUMN_TITLE}</h4>
        <ul class="space-y-2 font-mono text-sm text-gray-400">
          {FOOTER_LINKS}
        </ul>
      </div>
    </div>
  </div>
</footer>
```

---

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

**在输出代码前，必须逐项验证以下每一条。如有违反，立即修正后再输出：**

### 1. 圆角检查
- [ ] 搜索代码中的 `rounded-`
- [ ] 确认只有 `rounded-none` 或无圆角
- [ ] 如果发现 `rounded-lg`、`rounded-md` 等，替换为 `rounded-none`

### 2. 阴影检查
- [ ] 搜索代码中的 `shadow-`
- [ ] 确认只使用 `shadow-[Xpx_Xpx_0px_0px_rgba(...)]` 格式
- [ ] 如果发现 `shadow-lg`、`shadow-xl` 等，替换为正确格式

### 3. 边框检查
- [ ] 搜索代码中的 `border-`
- [ ] 确认边框颜色是 `border-black`
- [ ] 如果发现 `border-gray-*`、`border-slate-*`，替换为 `border-black`

### 4. 交互检查
- [ ] 所有按钮都有 `hover:shadow-none hover:translate-x-[2px] hover:translate-y-[2px]`
- [ ] 所有卡片都有 hover 效果（阴影变色或位移）
- [ ] 都包含 `transition-all`

### 5. 响应式检查
- [ ] 边框有 `border-2 md:border-4`
- [ ] 阴影有 `shadow-[4px...] md:shadow-[8px...]`
- [ ] 间距有 `p-4 md:p-6` 或类似的响应式值
- [ ] 字号有 `text-sm md:text-base` 或类似的响应式值

### 6. 字体检查
- [ ] 标题使用 `font-black`
- [ ] 正文使用 `font-mono`

> CRITICAL: **如果任何一项检查不通过，必须修正后重新生成代码。**

---

## [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 读不到）
- [ ] 禁止移动端画布挤掉文字