大家好，我卡颂。
回想下你学新技术的主要途径是什么？看书？看技术文档？看博文？看视频？
归纳起来，无外乎「文字」、「视频」两种形式。
从纸媒时代到互联网时代，再到移动互联网时代，虽然信息的载体发生变化，但信息的呈现形式仍以「文字」为主。
文字可以主动控制阅读速度、节奏，而视频有更佳的表现力。
可以说他们在体验上各有优劣。
那有没有一种形式能结合两者的优点呢？有，答案是「交互式文章」。
相信很多React学习者都看过build-your-own-react[1]。
这是一篇讲解React原理的交互式博文，左侧代码，右侧正文。随着正文的阅读，左侧代码会相应变化。
这篇文章对应的Github仓库[2]有5k star，可以认为是入门React原理的最佳实践了。
事实上，不仅是前端，很多领域的技术文章都能以「交互式」的形式呈现。
比如这篇「介绍数组是如何工作」的文章 —— how-arrays-work[3],用交互的方式演示了数组中每个字节处理数据的方式：
这样的文章，相比传统的技术文章、视频，有很多优势。
本文会介绍「交互式文章」相关的一些技术实践，以及他为我们开发者带来的新机遇。
交互方式的实践
交互式文章的本质还是文章。MD是最常见的技术文章格式，所以，在MD文件中插入「交互式组件」是常见的交互式文章组成形式，这就是MDX。
MDX中的交互方式主要有两种：
- 动画交互效果
- Demo交互
动画交互效果
code-surfer[4]是一个动画交互组件。
他的本质是一个React动画组件（用于展示代码之间的渐变动画）。
上文提到的「build-your-own-react」就是使用「code-surfer」实现的。
git-history[5]是另一个使用「code-surfer」的项目。
我们使用git diff命令时，命令行会使用颜色（通常是红、绿）区分新增、删除的代码：
「git-history」项目使用动画的形式，展示git history中代码的增删。
读者可以在githistory项目[6]体验他的效果。
Demo交互
除了动画交互外，Demo交互在技术文章中更常见。所有主流前端框架的文档中都提供了Demo。
比如，下图是React文档中的Demo：
常见的Demo交互形式有：
codesandbox
成名较早，是当前最主流的在线Demo展现方式，由客户端、服务端两部分组成。
开发者可以使用基于codesandbox封装的Sandpack实现自定义的在线Demo。
stackblitz
基于WebContainers（一款基于WebAssembly的操作系统，可以实现在浏览器中运行Node.js）封装，客户端、服务端都在浏览器中实现。
相较于codesandbox，有更多优势，比如：
- 可以离线使用（因为浏览器包含完整的服务端、客户端）
- 相比
codesandbox网络延迟更小（codesandbox中Node脚本是在服务端执行的，再传输给客户端）
文档的体验之争
前端领域发展至今，已经很少有完全创新的开源项目了。
通常，新项目会在现有项目的基础上进行微创新。比如Solid.js借鉴了React、Knockout.js。
Vue3也准备借鉴Svelte，出一个「无虚拟DOM」的版本。
为了在激烈的竞争中胜出，项目文档都会在「用户体验」上拉满。
这一点，可以对比React新老文档来体会。
对于文档的用户体验，其中非常重要的一点，就是提供丰富的交互。
基础的，如Vue3，提供了在线Demo与Playground：
Vue3在线demo
进阶的，如Svelte，提供了基于在线Demo的Svelte教程[7]：
更详细的，如React，提供了以交互式文章组成的React教程[8]
前端框架文档中的交互性主要以Demo为主。除此之外，还有些项目文档以动画交互为主，比如stripe文档[9]中的滚动聚焦效果：
Lit文档[10]中的hover后代码高亮效果：
视频的体验之争
视频相比于传统文章有更好的表现力，但是与交互式文章相比，就差远了。
Storyteller Demo Playback[11]将Demo与动画交互结合，实现了视频播放器的效果：
相比于传统视频只能看不能动，交互式播放器可以随时暂停，修改代码。
scrimba是「Demo与动画交互结合的播放器」的商业化产品，读者可以看看scrimba vuex教程[12]感受下交互体验。
开发者的一片蓝海
对于国内的技术博主，「交互式文章」还是一片蓝海。
相比于传统文章、视频，「交互式文章」的体验优势有多大呢？比如这篇文章 —— 100%在CSS中的意义[13]
在文章中，读者可以拖拽滑杆看到不同百分比的效果：
对于想建立自己技术影响力的开发者，这是种很好的尝试。
参考资料
[1]
build-your-own-react: https://pomb.us/build-your-own-react/
[2]
Github仓库: https://github.com/pomber/didact
[3]
how-arrays-work: https://www.nan.fyi/how-arrays-work
[4]
code-surfer: https://github.com/pomber/code-surfer
[5]
git-history: https://github.com/pomber/git-history
[6]
githistory项目: https://github.githistory.xyz/torvalds/linux/blob/master/kernel/up.c
[7]
Svelte教程: https://svelte.dev/tutorial/basics
[8]
React教程: https://beta.reactjs.org/learn/describing-the-ui
[9]
stripe文档: https://not-stripe.vercel.app/
[10]
Lit文档: https://lit.dev/
[11]
Storyteller Demo Playback: https://markm208.github.io/stDemo/playback.html?view=code
[12]
scrimba vuex教程: https://scrimba.com/scrim/cMPa2Uk?pl=pnyzgAP
[13]
100%在CSS中的意义: https://wattenberger.com/blog/css-percents
