写了个 VS Code 中实时预览 Vue/React 组件的插件

2022-03-16 10:21:16 +08:00
 jawei

最近年纪大了喜欢胡思乱想,前段时间突然想到能不能在 VS Code 中实现组件的所见即所得,于是折腾了两个月终于做出了能实现这个效果的插件,如图:

支持实时预览 Webpack/Vite 开发时下的 React/Vue 组件( Angular 应该也能,但是我还没用过,所以没做支持)。

使用方式

按参考文档安装并使用插件:https://github.com/jaweii/AutoPreview

然后你就可以写组件时实时预览当前组件:

还可以把可复用组件 /物料的用例整理在一个预览专用的文件里:

在 OUTPUT 面板切到 AutoPreview 来打印调试:

断点功能:emmm...? 我也想有...

把预览面板拖到底部来预览比较宽的组件:

实现方式

一开始我是只想实现 Webpack+React 的组件预览的,尝试了从 Webpack 配置着手来实现,但是发现这条路走不通,依赖关系太错综复杂了,搁置几天后想到了我以前 Vue-Layout 项目中组件重新挂载的思路,几番尝试后找到实现的关键,即通过 Webpack 和 Vite 都提供的 import api 来异步加载当前窗口文件路径的组件,然后重新挂载到预览窗口,即可实现预览。

所以其本质上和你给项目新增个路由来显示当前页面中的组件一样,只是插件自动帮你做了。

而因为使用了 Webpack 和 Vite 都提供的 import api ,使用这两种构建工具开发时,所有的前端框架理论上都可以实现在 VS Code 中渲染项目组件实现预览。

延伸

现在我也只是写了几个 Demo 来测试插件效果,对实际开发过程中是有增效还是鸡肋我也不确定,只是感兴趣就做了。

在做的过程中也有一些思考:

如果给可预览的组件分级,那么有

这三种级别。

基础组件

通常实际项目中,基础组件是来自内部或第三方组件库,高复用,低耦合,其提供的文档已经能够预览组件效果,针对这类组件的 IDE 内预览似乎意义并不是很大;

物料

物料则是根据产品需求对基础组件、元素、业务逻辑进行组合的产物,这类物料有的是项目内可复用的,有的是项目内没有复用但是跨项目存在复用,有的是业务定制完全不可复用的。

实际项目的协同中,物料也是最容易被重复写的,且随着项目越来越大其会散落在各个内页,没有一个展示页来让不同开发者知道哪些物料是已经有了的,就会造成重复造物料。对于这个问题,阿里飞冰、京东 JD WORK 这样的开发链工具是一种解决方案,其提供的物料制作、发布、使用一条龙服务可以很大程度上避免重复造物料,是个重武器。

我想到了个轻武器的方案,即针对物料的 IDE 内预览,若合理约定、使用,或许也会是改善重复造物料问题的一个方案。比如约定开发者对可复用的物料导出预览,这样插件可以列出所有可预览的组件供其他开发者浏览,其他开发者开发新物料前,先在预览列表看看有没有可复用的,如果有直接参考复用或 CV 定制,没有再自己写。

页面

页面级则是复用性极低,不过 IDE 内预览 H5 页面倒也是种不错的体验,不用在浏览器和编辑器间切换,有点微信开发者工具的感觉。


还有一点看法,如果组件的预览能够优化开发体验,我想并不是因为它能预览,而是因为其强制组件作者写预览函数,预览组件,天然需要为组件 props 传递 mock 数据,而 mock 的数据能供自己和其他开发者参考和 CV ,这是其提高代码可维护性,降低协同成本的很重要的原因。

且如果预览函数能罗列出组件的多个用例,对于其他开发者来说是多么心旷神怡的事:


3817 次点击
所在节点    分享创造
25 条回复
ShareManT
2022-03-16 10:53:26 +08:00
有这种想法挺好的,支持一个,确实预览会比较方便。

不过还有个 storybook 虽然不是 编辑器的插件 但是更成熟完善。
MrTLJH
2022-03-16 11:14:27 +08:00
牛逼啊,但我不用 Vue/React/Angular 这些,年纪大了受不了写个前端还要编译打包之类的,老年人最多用用 JQ ,更多的是原生 JS 。哎~跟不上技术的节奏了
murmur
2022-03-16 11:15:34 +08:00
为什么要用这个呢,现实开发的属性很可能是外面传进来的,用户如果要预览直接开一个 hmr 就可以了
yu7er
2022-03-16 11:15:57 +08:00
那个显示包版本的是啥插件呀
RealJacob
2022-03-16 11:38:11 +08:00
看文档需要改项目代码,感觉侵入性有点强啊。即使只是在入口处判断一下
ccyu220
2022-03-16 11:59:20 +08:00
如果不想开整个项目页面,Vue 和 React 也有单文件服务,你这个稍微复杂了些。
jawei
2022-03-16 12:22:22 +08:00
依赖错综复杂,最常用的场景,登录框组件文件里调用全局注册的 toast 弹框提示登录失败,单文件里没注册服务是跑不起来的
jawei
2022-03-16 12:22:35 +08:00
@ccyu220 依赖错综复杂,最常用的场景,登录框组件文件里调用全局注册的 toast 弹框提示登录失败,单文件里没注册服务是跑不起来的
jawei
2022-03-16 12:25:28 +08:00
@RealJacob 我也觉得有侵入性,目前也没有好的办法解决,我再想想怎么解决
jawei
2022-03-16 12:26:12 +08:00
jawei
2022-03-16 12:27:52 +08:00
@murmur emmm ,看着会比较酷 哈哈哈哈
jawei
2022-03-16 12:28:17 +08:00
@MrTLJH 哎 不服老不行啊
jawei
2022-03-16 12:30:43 +08:00
@ShareManT 谢谢
Storybook 就是我说的基础组件的文档,针对这里面的组件 IDE 内预览确实没什么意义,(装下逼还是可以的吧哈哈哈哈)
equt
2022-03-16 12:53:17 +08:00
ycr6708536
2022-03-16 13:25:36 +08:00
实际业务开发中,预览 page 级别是可行的,组件不太可行,举个例子:props 参数、eventbus 的数据都用不到。
还有一个问题如何支持各种编译配置( typescript 、babel 、scss )等。
综上学习不错,实际使用场景比较受限。
jawei
2022-03-16 14:19:02 +08:00
@equt 看起来这个还没有发布,似乎和我这个思路不一样,只支持 Vite
jawei
2022-03-16 14:22:31 +08:00
@ycr6708536 这个实现方式,不会有“如何支持各种编译配置( typescript 、babel 、scss )”的问题
jin5354
2022-03-16 18:32:18 +08:00
支持分享。。但是当我在写 UI 时,我必然是对着浏览器开发啊。。那么我有什么场景需要在编辑器上看效果呢。。还会占用 IDE 的空间。。
jawei
2022-03-16 19:30:19 +08:00
@jin5354 我的看法是看法是,一切都是组件,你写评论框组件的时候是没有必要看到 Header 、Article 之类的内容的,甚至是分散注意力的,写好后最后才在浏览器看看组件被组合使用的效果。

空间也没怎么占用太多吧
hxse
2022-03-16 19:43:06 +08:00
要是可以传自定义的测试数据, 可能会更实用一些, 用来测试组件不错

这是一个专为移动设备优化的页面(即为了让你能够在 Google 搜索结果里秒开这个页面),如果你希望参与 V2EX 社区的讨论,你可以继续到 V2EX 上打开本讨论主题的完整版本。

https://www.v2ex.com/t/840680

V2EX 是创意工作者们的社区,是一个分享自己正在做的有趣事物、交流想法,可以遇见新朋友甚至新机会的地方。

V2EX is a community of developers, designers and creative people.

© 2021 V2EX