Skip to content

vue3 新文档有什么改变

来看看 Vue 文档有哪些变化

昨天在微博上看到Vue新文档文档更新的推文,今天大概过了一下英文版的,新文档的效果确实比旧文档好,主要变化如下:

Composition API 支持友好,示例代码有Composition API写法。
文档目录结构调整,更清晰易查找。
示例代码可以编辑预览,再也不用为了看效果需要启动一个自己的示例项目
教程更像教程,不仅可以跟着做,还可以在页面编辑预览。

1 Composition API 支持友好

无论是指导(guide )还是教程(tutoral)和 示例 ,都可以切换示例中代码的风格,可以选择 composition API 或 Option API 风格 。

2文档目录结构调整,更清晰易查找

Vue 2 之前的文档,左边导航目录有多级嵌套,结构不是很清晰。新文档左侧目录结构重新分组,只有2级,第三级在右侧,这样文档结构更清晰易懂容易查找。

3教程和示例库的代码可以修改查看效果

之前文档只能看代码,运行效果怎么样,需要自己把代码复制到项目中,才能看到。新文档可以在看代码的的时候,自己尝试修改代码,查看效果,不需要离开文档。

4 教程更像教程

原来的教程就是文档,现在文档叫指导(guide),教程(tutoral)是新的一部分内容,和next.js 和 gatsby 的教程形式类似,分若干步,一步一步的完成开发,不同的是vue 的教程做的更好,可以在示例代码中编辑代码,在当前页面中查看效果,不用把代码复制到自己的项目,或跳转到codesanbox 之类的第三方网站

总结

新文档目录结构更清晰,容易阅读和查找。示例代码包含Composition API 风格的代码,妈妈再页不用担心为了用Composition API  写一点功能到处翻文档。新文档的教程 吸收了 react 新文档 ,nextjs文档,gatsby 的文档等知名开源项目的文档的有点,而且做的更好。教程分步骤,代码课编辑预览,提高了文档的可用性。