首页>>前端>>Vue->vue3中文文档(vue2中文文档)

vue3中文文档(vue2中文文档)

时间:2023-12-07 本站 点击:0

Vue3 组合式 API 的基础 —— setup

组合式 API 基础 - Vue3中文文档

Setup - Vue3中文文档

setup 是一个组件选项,所以像别的组件选项一样,写在组件导出的对象里。

官方文档如此描述:

setup 选项应该是一个接受 props 和 context 的函数。

此外,我们从 setup 返回的所有内容都将暴露给组件的其余部分 (计算属性、方法、生命周期钩子等等) 以及组件的模板。

个人觉得可以理解为:

正如在一个标准组件中所期望的那样, setup 函数中的 props 是响应式的,当传入新的 prop 时,它将被更新。

context 上下文是一个普通的 JavaScript 对象,它暴露三个组件的 property:

context 是一个普通的 JavaScript 对象,也就是说,它不是响应式的,这意味着你可以安全地对 context 使用 ES6 解构。

attrs 和 slots 是有状态的对象,它们总是会随组件本身的更新而更新。这意味着你应该避免对它们进行解构,并始终以 attrs.x 或 slots.x 的方式引用 property。请注意,与 props 不同, attrs 和 slots 是非响应式的。如果你打算根据 attrs 或 slots 更改应用副作用,那么应该在 onUpdated 生命周期钩子中执行此操作。

如果 setup 返回一个对象,则可以在组件的模板中像传递给 setup 的 props property 一样访问该对象的 property:

setup 还可以返回一个渲染函数,该函数可以直接使用在同一作用域中声明的响应式状态:

新的 setup 组件选项在 创建组件之前 执行,一旦 props 被解析,并充当合成 API 的入口点。

在 setup() 内部, this 不会是该活跃实例的引用,因为 setup() 是在解析其它组件选项之前被调用的掘此睁,所以 setup() 内部的 this 的行为与其它选项中的 this 完全不同。这在和其它选项式 API 一起使用 setup() 时可能会导致混淆。

reactive() 接收一个普通对象然后返回该普通对象的响应式代理。等同于 2.x 的 Vue.observable()

响应式转换是“深层的”:会影响对象内部所有嵌套的属性。基于 ES2015 的 Proxy 实现,返回的代理对象 不等于 原始对象。建议仅使用代理对象而避免依赖原始对象。

接受一个参数值并返回一个响应式且可改变的 ref 对象。ref 对象拥有一个指向内部值的单一属性 .value 。

如果传入 ref 的是一个对象,将调用 reactive 方法进行深层响应转换。

使用响应式 computed API 有两种方式:

传入一个对象(响应式或普通)或 ref,返回一个原始对象的 只读 代理。一个只读的代理是“深层的”,对象内部任何嵌套的属性也都是只读的。

立即执行传入的一个函数,并响应式追踪其依赖,并在其依赖变更时重新运行该函数。

当 watchEffect 在组件的 setup() 函数或生命周期钩子被调用时, 侦听器会被链接到该组件的生命周期,并在组件卸载时自动停止。

在一些情况下,也可以显式调用返回值以停止侦听:

有时副作用函数会执行一些异步的副作用, 这些响应需要在其失效时清除(即完成之前状态已改变了)。所以侦听副作用传入的函数可以接收一个 onInvalidate 函数作入参, 用来注册清理失效时的回调。当以下情况发判岁生时,这个 失效回调 会被触发:

我们之所以是通过传入一个函数去注册失效回调,而不是从回调返回它(如 React useEffect 中的方式),是因为返扒雹回值对于异步错误处理很重要。

在执行数据请求时,副作用函数往往是一个异步函数:

我们知道异步函数都会隐式地返回一个 Promise,但是清理函数必须要在 Promise 被 resolve 之前被注册。另外,Vue 依赖这个返回的 Promise 来自动处理 Promise 链上的潜在错误。

Vue 的响应式系统会缓存副作用函数,并异步地刷新它们,这样可以避免同一个 tick 中多个状态改变导致的不必要的重复调用。在核心的具体实现中, 组件的更新函数也是一个被侦听的副作用。当一个用户定义的副作用函数进入队列时, 会在所有的组件更新后执行:

在这个例子中:

请注意,初始化运行是在组件 mounted 之前执行的。因此,如果你希望在编写副作用函数时访问 DOM(或模板 ref),请在 onMounted 钩子中进行:

如果副作用需要同步或在组件更新之前重新运行,我们可以传递一个拥有 flush 属性的对象作为选项(默认为 'post' ):

onTrack 和 onTrigger 选项可用于调试一个侦听器的行为。

这两个回调都将接收到一个包含有关所依赖项信息的调试器事件。建议在以下回调中编写 debugger 语句来检查依赖关系:

onTrack 和 onTrigger 仅在开发模式下生效。

watch API 完全等效于 2.x this.$watch (以及 watch 中相应的选项)。 watch 需要侦听特定的数据源,并在回调函数中执行副作用。默认情况是懒执行的,也就是说仅在侦听的源变更时才执行回调。

可以直接导入 onXXX 一族的函数来注册生命周期钩子:

记一次 Vue2 迁移 Vue3 的实践总结

文章来源于@Elab团队,

一、Vue3

Vue3中文文档[1]

2.x 全局 API3.x 实例 API (app) Vue.configapp.config Vue.config.productionTip无 Vue.config.ignoredElementsapp.config.isCustomElement Vue.componentapp.component Vue.directiveapp.directive Vue.mixinapp.mixin Vue.useapp.use Vue.prototypeapp.config.globalProperties

引入此配置选项的目的是支持原生自定义元素,因此数逗衡重命名可以更好地传达它的功能,新选项还需要一个比旧的 string/RegExp 方法提供更多灵活性的函数:

在Vue 2中,Vue.prototype通常用于添加可在所有组件中访问的属性。

Vue 3中的等效项是config.globalProperties。在实例化应用程序内薯做的组件时,将复制这些属性

2.0生命周期3.0生命周期 beforeCreate(组件创建之前)setup() created(组件创建完成)setup() beforeMount(组件挂载之前)onBeforeMount(组件挂载之前) mounted(组件挂载完成)onMounted(组件挂载完成) beforeUpdate(数据更新,虚拟DOM打补丁之前)onBeforeUpdate(数据更新,虚拟DOM打补丁之前) updated(数据更新,虚拟DOM渲染完成)onUpdated(数据更新,虚拟DOM渲染完成) beforeDestroy(组件销毁之前)onBeforeUnmount(组件销毁之前) destroyed(组件销毁之后)onUnmounted(组件销毁之后) activated(被 keep-alive 缓存的组件激活时调用)onActivated(被激活时执行) deactivated(被 keep-alive 缓存的组件停用时调用)onDeactivated(比如从 A 组件,切换到 B 组件,A 组件消失时执行) errorCaptured(当捕获一个来自子孙组件的错误时被调用)onErrorCaptured(当捕获一个来自子孙组件的异常时激活钩子函数)

注意点:

refreactive 入指拆参基本类型引用类型 返回值响应式且可变的 ref 对象响应式代理(Proxy) 访问方式1.ref 对象拥有一个指向内部值的单一属性 .value

2.在dom和setup()的return中会自动解套

3.ref 作为 reactive 对象的 property 被访问或修改时,也将自动解套直接.访问即可

问题 注意点: 因为reactive是组合函数【 对象 】,所以必须始终保持对这个所返回对象的引用以保持响应性,不能解构该对象或者展开

例如:

const { a } = objReactive 或者 return { ...objReactive }

解决方法:

toRefs API

用来提供解决此约束的办法——它将响应式对象的每个 property 都转成了相应的 ref【把对象转成了ref】。

watchEffect 的第一个参数—— effect 函数——自己也有参数:叫 onInvalidate ,也是一个函数,用于清除 effect 产生的副作用。

onInvalidate 被调用的时机很微妙:它只作用于异步函数,并且只有在如下两种情况下才会被调用:

主要作用是指定调度器,即何时运行副作用函数。

优点:很优秀

缺点:他的对手(React),更优秀

虽然好多地方神似React,但是我们也可以从中看出,他们的都源于比较成熟的编程范式——FP(Functional Programming)。

框架只是工具,解决问题才是终极目标;我们还是要把重点放在领悟框架的设计思想上;悟到了,才是真正掌握了解决问题的手段。(抄的)

Vue3 新特性 —— teleport 瞬间移动

Teleport | Vue3中文文档

teleport | Vue School 的免费课程

使用 teleport/teleport 标签包差姿裹内容,且给 to 属性绑定瞬移位置的选择器。

/src/components/HelloWorld.vue :

/src/App.vue

/public/index.html

假设就为一个 Modal :

虽然我们是在 HelloWorld.vue 组祥庆旅件里定义 teleport to="#modal"/teleport 内容的,但它实际谨凳渲染的位置在 #modal 处,完成了“瞬间移动”。

设置为 true :

查看页面会发现:弹窗内容不在 #modal 即绿色框里

查看 DOM 结构:

vue 3.0 正式版来了

Vuejs 于2020年9月19日凌晨发布了代号为One Piece的 3.0 版本。以下简称Vue3

跟着官网文档,我们一起来体验下新版的魅力。

Vue3官方文档地址:

首先是测试工具

谷歌插件(需要翻墙):

火狐插件:

electron桌面应用插件:

出于原型制作或学习目的,您可以将最新版本与以下灶启芦各项配合使用:

使用Vue构建大型应用程序时,建议使用NPM安装方法。它与 Webpack 或 Rollup 等模块 捆绑器 很好地配旁伍对。Vue还提供了用于创作 单一文件组件的 随附工具。

ue提供隐带了一个 官方CLI 用于快速搭建单页应用。

对于Vue 3,您应该使用Vue CLI v4.5,该版本在上npm提供@vue/cli@next。要升级,您需要在@vue/cli全局范围内重新安装最新版本:

然后在Vue项目中运行

在 dist/ NPM软件包的目录中,您会找到许多不同的Vue.js版本。

全局安装脚手架

查看脚手架版本是否在4.5以上(含4.5)

创建项目

此时终端显示如下图

选择第二项 Vue 3 Preview ,等待安装完成。

到此,恭喜你迈入了 Vue 3.0的时代!

uni-app 项目小程序端支持 vue3 介绍

随着 vue3 的发布, uni-app 也逐步支持 vue3 。

目前模告小程序平台已支持,h5、App 平台暂不支持。

除支持 vue3 语法特性外, uni-app 特有的生命周期钩子支持 Composition API ,如 onLaunch , onShow , onLoad …

下面介绍创建支持 vue3 的 uni-app 项目的流程,以及使用中的一些注意事项。vue3 相关问题请关注vue官方文档 vue3 中文文档。

目前仅支持 cli 方式创建支持 vue3 默认模板项目。

如果你之前没有使用过 vue-cli 方式创建过项目,需要先安装 vue-cli ,若已安装则跳过步骤 1。

步骤 1: 全局安装vue-cli

步骤 2: 用如下的命令创建vue3工程

步骤 3: 创建好工程后,进入对应目录

步骤 4: 将项目跑到微信平台

需要将编译后的文件 dist/dev/mp-weixin 导入微信开发者工具运行,也可将项目拖入 HbuildX 中运行,方便运行到各个平台。

欢迎开发者反馈使用该版本遇到的问题,我们将积极收集意见。

后续:

DCloud之所以不支持vue3的h5和app版,主要是因为局码虚vue3的组件中很多语法的写法发生变化,这导致uni-app的h5版基础组件库和app版基础组件库的写法与vue3不兼容。

当然除了基础组件,插件市场的所有插件(包括uni ui),都不支持vue3。即便是uni-app已经推出的vue3的小程序版,也不支持插件市场的插件。

考虑到生态兼容的重要性,vue官方(尤雨溪)计划2021年4月中下旬推出新版,对桐燃vue2的语法做兼容,届时uni-app的h5版和app版将同时推出,并且插件市场的众多插件也将自动适配vue3版的uni-app。


本文来自互联网用户投稿,该文观点仅代表作者本人,不代表本站立场。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。
如若转载,请注明出处:/Vue/17624.html