,大家好,我卡颂。,回想下你学新技术的主要途径是什么?看书?看技术文档?看博文?看视频?,归纳起来,无外乎「文字」、「视频」两种形式。,从纸媒时代到互联网时代,再到移动互联网时代,虽然信息的载体发生变化,但信息的呈现形式仍以「文字」为主。,文字可以主动控制阅读速度、节奏,而视频有更佳的表现力。,可以说他们在体验上各有优劣。,那有没有一种形式能结合两者的优点呢?有,答案是「交互式文章」。,相信很多React学习者都看过[1]。,
,这是一篇讲解React原理的交互式博文,左侧代码,右侧正文。随着正文的阅读,左侧代码会相应变化。,这篇文章对应的[2]有5k star,可以认为是入门React原理的最佳实践了。,事实上,不仅是前端,很多领域的技术文章都能以「交互式」的形式呈现。,比如这篇「介绍数组是如何工作」的文章 —— [3],用交互的方式演示了数组中每个字节处理数据的方式:,
,这样的文章,相比传统的技术文章、视频,有很多优势。,本文会介绍「交互式文章」相关的一些技术实践,以及他为我们开发者带来的新机遇。,交互式文章的本质还是文章。MD是最常见的技术文章格式,所以,在MD文件中插入「交互式组件」是常见的交互式文章组成形式,这就是MDX。,MDX中的交互方式主要有两种:,[4]是一个动画交互组件。,他的本质是一个React动画组件(用于展示代码之间的渐变动画)。,
,上文提到的「build-your-own-react」就是使用「code-surfer」实现的。,[5]是另一个使用「code-surfer」的项目。,我们使用git diff命令时,命令行会使用颜色(通常是红、绿)区分新增、删除的代码:,
,「git-history」项目使用动画的形式,展示git history中代码的增删。,
,读者可以在[6]体验他的效果。,除了动画交互外,Demo交互在技术文章中更常见。所有主流前端框架的文档中都提供了Demo。,比如,下图是React文档中的Demo:,
,常见的Demo交互形式有:,成名较早,是当前最主流的在线Demo展现方式,由客户端、服务端两部分组成。,开发者可以使用基于codesandbox封装的Sandpack实现自定义的在线Demo。,基于WebContainers(一款基于WebAssembly的操作系统,可以实现在浏览器中运行Node.js)封装,客户端、服务端都在浏览器中实现。,相较于codesandbox,有更多优势,比如:,前端领域发展至今,已经很少有完全创新的开源项目了。,通常,新项目会在现有项目的基础上进行微创新。比如Solid.js借鉴了React、Knockout.js。,Vue3也准备借鉴Svelte,出一个「无虚拟DOM」的版本。,为了在激烈的竞争中胜出,项目文档都会在「用户体验」上拉满。,这一点,可以对比React新老文档来体会。,对于文档的用户体验,其中非常重要的一点,就是提供丰富的交互。,基础的,如Vue3,提供了在线Demo与Playground:,
,Vue3在线demo,进阶的,如Svelte,提供了基于在线Demo的[7]:,
,更详细的,如React,提供了以交互式文章组成的[8]。,
,前端框架文档中的交互性主要以Demo为主。除此之外,还有些项目文档以动画交互为主,比如[9]中的滚动聚焦效果:,
,[10]中的hover后代码高亮效果:,
,视频相比于传统文章有更好的表现力,但是与交互式文章相比,就差远了。,[11]将Demo与动画交互结合,实现了视频播放器的效果:,
,相比于传统视频只能看不能动,交互式播放器可以随时暂停,修改代码。,scrimba是「Demo与动画交互结合的播放器」的商业化产品,读者可以看看[12]感受下交互体验。,
,对于国内的技术博主,「交互式文章」还是一片蓝海。,相比于传统文章、视频,「交互式文章」的体验优势有多大呢?比如这篇文章 —— [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。
© 版权声明
文章版权归作者所有,未经允许请勿转载。