20
头图

大家好,我卡颂。

回想下你学新技术的主要途径是什么?看书?看技术文档?看博文?看视频?

归纳起来,无外乎文字视频两种形式。

从纸媒时代到互联网时代,再到移动互联网时代,虽然信息的载体发生变化,但信息的呈现形式仍以文字为主。

文字可以主动控制阅读速度、节奏,而视频有更佳的表现力。

可以说他们在体验上各有优劣。

那有没有一种形式能结合两者的优点呢?有,答案是交互式文章

相信很多React学习者都看过build-your-own-react

这是一篇讲解React原理的交互式博文,左侧代码,右侧正文。随着正文的阅读,左侧代码会相应变化。

这篇文章对应的Github仓库有5k star,可以认为是入门React原理的最佳实践了。

事实上,不仅是前端,很多领域的技术文章都能以交互式的形式呈现。

比如这篇介绍数组是如何工作的文章 —— how-arrays-work,用交互的方式演示了数组中每个字节处理数据的方式:

这样的文章,相比传统的技术文章、视频,有很多优势。

本文会介绍交互式文章相关的一些技术实践,以及他为我们开发者带来的新机遇。

欢迎加入人类高质量前端框架群,带飞

交互方式的实践

交互式文章的本质还是文章。MD是最常见的技术文章格式,所以,在MD文件中插入交互式组件是常见的交互式文章组成形式,这就是MDX

MDX中的交互方式主要有两种:

  • 动画交互效果
  • Demo交互

动画交互效果

code-surfer是一个动画交互组件。

他的本质是一个React动画组件(用于展示代码之间的渐变动画)。

上文提到的build-your-own-react就是使用code-surfer实现的。

git-history是另一个使用code-surfer的项目。

我们使用git diff命令时,命令行会使用颜色(通常是红、绿)区分新增、删除的代码:

git-history项目使用动画的形式,展示git history中代码的增删。

读者可以在githistory项目体验他的效果。

Demo交互

除了动画交互外,Demo交互在技术文章中更常见。所有主流前端框架的文档中都提供了Demo

比如,下图是React文档中的Demo

常见的Demo交互形式有:

  • codesandbox

成名较早,是当前最主流的在线Demo展现方式,由客户端、服务端两部分组成。

开发者可以使用基于codesandbox封装的Sandpack实现自定义的在线Demo

  • stackblitz

基于WebContainers(一款基于WebAssembly的操作系统,可以实现在浏览器中运行Node.js)封装,客户端、服务端都在浏览器中实现。

相较于codesandbox,有更多优势,比如:

  • 可以离线使用(因为浏览器包含完整的服务端、客户端)
  • 相比codesandbox网络延迟更小(codesandboxNode脚本是在服务端执行的,再传输给客户端)

文档的体验之争

前端领域发展至今,已经很少有完全创新的开源项目了。

通常,新项目会在现有项目的基础上进行微创新。比如Solid.js借鉴了ReactKnockout.js

Vue3也准备借鉴Svelte,出一个无虚拟DOM的版本。

为了在激烈的竞争中胜出,项目文档都会在用户体验上拉满。

这一点,可以对比React新老文档来体会。

对于文档的用户体验,其中非常重要的一点,就是提供丰富的交互。

基础的,如Vue3,提供了在线DemoPlayground

Vue3在线demo

进阶的,如Svelte,提供了基于在线DemoSvelte教程

更详细的,如React,提供了以交互式文章组成的React教程

前端框架文档中的交互性主要以Demo为主。除此之外,还有些项目文档以动画交互为主,比如stripe文档中的滚动聚焦效果:

Lit文档中的hover后代码高亮效果:

视频的体验之争

视频相比于传统文章有更好的表现力,但是与交互式文章相比,就差远了。

Storyteller Demo PlaybackDemo与动画交互结合,实现了视频播放器的效果:

相比于传统视频只能看不能动,交互式播放器可以随时暂停,修改代码。

scrimbaDemo与动画交互结合的播放器的商业化产品,读者可以看看scrimba vuex教程感受下交互体验。

开发者的一片蓝海

对于国内的技术博主,交互式文章还是一片蓝海。

相比于传统文章、视频,交互式文章的体验优势有多大呢?比如这篇文章 —— 100%在CSS中的意义

在文章中,读者可以拖拽滑杆看到不同百分比的效果:

对于想建立自己技术影响力的开发者,这是种很好的尝试。


卡颂
3.1k 声望16.7k 粉丝