Communitygithub.com

滚动叙事

当网站、落地页、产品页、作品集或案例研究应该讲述一个故事,而不是罗列模块时使用——滚动叙事、故事化页面、'叙事性'或'电影感'网站、基于章节的页面、时间线、旅程、前后对比,或者当页面感觉像是一堆无趣的版块目录时。

滚动叙事 是什么?

滚动叙事角色适用于希望将线性浏览转化为沉浸式叙事体验的项目。它特别适合品牌、小型企业、旅游、餐饮、手工艺、服务行业以及具有明显成果展示需求的网站,也适用于SaaS或应用程序中需要展现'工作原理'等单个故事场景的片段。该技能的核心设计方法论包括五个关键的故事元素(英雄、欲望、障碍、转折、结局),并引导开发者从六种叙事装置(时间轴、路径、缩放、转变、倒计时、角色)中选择一种来构建页面滚动结构。它提供了详细的节拍表模板、节奏规则(例如:每个节拍一个想法、一个视觉、一个动画;总页面高度为6-12个视口高度)以及严格的内容编写指南。构建部分依赖于专用的故事化CSS/JS框架(storymotion.css + storymotion.js),并将每个节拍映射为HTML章节,通过进度事件驱动自定义帧逻辑。该技能还强调了无障碍体验:禁用JavaScript后页面仍需按顺序可读,支持减少动画模式,并在移动端进行适配。最终交付物是一份完整的节拍表(beats.md)、符合规范的页面结构,以及包含章节标签和滚动进度条的用户界面,确保访问者始终知道自己所处的故事阶段。

兼容平台~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/YehorSS/storymotion/tree/main/skills/scroll-narrative

在你喜欢的 AI 中提问

打开一个已预加载此 Agent Skill 的新对话。

文档

滚动叙事 是做什么的?

并非每个网站都需要一个故事。 首先决定:是完整的叙事(适用于品牌、小型企业、旅游、场所、手工艺、有可见成果的服务行业),一个单一故事场景(SaaS、应用:通常是“工作原理”),还是不需要(商店、文档、仪表盘、表单:仅用于反馈的动效,只需使用 web-motion)。对于局部场景,仅将该技能应用于那一个场景。

一个叙事性网站是访客用滚轮走进去的故事。 事实被编织进情节,而不是堆砌成功能模块。动效(参见 web-motion 技能)是故事中时间流逝的方式。

1. 在编写任何代码之前找到故事

每一行回答一句话:

  • 英雄 —— 我们跟随的是谁或什么(访客、产品、地方、菜肴、一天)。
  • 欲望 —— 他们想要什么或去哪里。
  • 障碍 —— 阻碍他们的东西(产品要解决的问题)。
  • 转折 —— 事情发生变化的时刻(产品、顶峰、第一口)。
  • 结局 —— 转折之后的世界,以及访客现在要采取的一个行动。

然后选择一个叙事装置来组织整个滚动:

装置滚动意味着适合用于
时间轴黎明 → 夜晚,1920 → 今天,第1天 → 第30天餐厅、活动、历史、日常
路径沿着一条路线或地图移动旅游、物流、探险、房地产
缩放城市 → 街道 → 房间 → 细节建筑、产品、手工艺
转变原材料 → 成品,之前 → 之后服务、装修、SaaS、健身
倒计时倒向发布或高潮时刻节日、发布、发售
角色跟随一个人的一天应用、B2C服务

2. 编写节拍表

在开始构建之前保存为 beats.md。每个节拍一行:

#节拍标题(≤ 8字)正文(≤ 40字)融入的事实视觉动效滚动长度

标准弧线(6–9个节拍):

  1. 钩子 —— 第一个屏幕。3秒内:这是什么,关键数字,主要操作。不能只有“向下滚动发现”而没有别的内容。
  2. 设定 —— 之前的世界;英雄和欲望。
  3. 旅程(2–4个节拍)—— 通过装置推进;每个节拍包含一个事实作为情节点(“到早上6点面包已经出炉了——140条”)。
  4. 转折 —— 最大的场景:通常是一个固定舞台(200–300 vh),通过滚动擦洗。
  5. 证明 —— 数据、面孔、评论,作为故事结果来讲述。
  6. 结局 + 行动号召 —— 故事落脚的地方,以及一个清晰的操作。重复钩子的操作。

3. 节奏规则

  • 每个节拍一个想法,一个视觉,一个动效。
  • 密集与稀疏交替:在一个固定场景之后,放置一张冷静的全屏照片或一个单句。
  • 每个页面最多约3个固定场景;每个固定场景必须值得其滚动长度。
  • 总页面:桌面端6–12个视口高度。只有当每个屏幕仍然有新信息时才可以更长。
  • 文本随其描述的时刻出现,绝不提前出现。
  • 访客始终知道自己在哪:章节标签 + 进度指示条。
  • 滚动本身讲述故事:进度指示条使用叙事装置作为隐喻(小时、公里、比例尺、年份、章节编号),并使用网站的色彩和字体;章节标记在上面,悬停时显示名称。

4. 内容与工艺

  • 照片是主角:仅使用高分辨率图片,100%裁剪下清晰;响应式 srcset。
  • 像人一样写作,使用简单词汇;避免“释放”、“提升”、“无缝”。
  • 数字是情节点,而不是数据网格——除非网格就是高潮。
  • 每个节拍在减少动效模式下和没有JS时都必须存活:它仍然能像一篇优秀的长页面一样可读。
  • 移动端不是桌面端的缩小版:更短的固定场景(150–200 vh),叠加舞台,更大的字体。

5. 构建

  1. 基于 storymotion.css + storymotion.js 构建(在 web-motion/assets/;固定场景使用 --p,分步标题,揭示,计数,章节标签,可拖动的滚动条,加载器,多语言,减少动效)以及 web-motion/references/recipes.md 中的做法。
  2. 将每个节拍映射到一个章节;固定节拍变为 .scene > .stage,带有 [data-step] 标题;自定义每帧逻辑监听场景的 progress 事件。
  3. 根据 web-motion 添加动效;在375px和1440px宽度下,开启和关闭减少动效模式进行验证。

完成前的检查清单:

  • 钩子通过3秒测试。
  • 每个节拍刚好有一个工作和一个事实。
  • 故事在禁用JS后按顺序可读。
  • 章节标签和进度条与节拍表一致。
  • 结尾的行动号召重复钩子的操作。

相关技能