写点什么

Vue3, setup 语法糖、Composition API 全方位解读

作者:yyds2026
  • 2022-10-24
    浙江
  • 本文字数:7492 字

    阅读完需:约 25 分钟

  1. 起初 Vue3.0 暴露变量必须 return 出来,template 中才能使用;

  2. Vue3.2 中 只需要在 script 标签上加上 setup 属性,组件在编译的过程中代码运行的上下文是在 setup() 函数中,无需 returntemplate 可直接使用。

  3. 本文章以 Vue2 的角度学习 Vue3 的语法,让你快速理解 Vue3 的 Composition Api

  4. 本文章第十四节为状态库 Pinia 的安装、使用讲解

一、文件结构

Vue2 中,<template> 标签中只能有一个根元素,在 Vue3 中没有此限制


<template>  // ...</template>
<script setup> // ...</script>
<style lang="scss" scoped> // 支持CSS变量注入v-bind(color)</style>
复制代码

二、data

<script setup>  import { reactive, ref, toRefs } from 'vue'
// ref声明响应式数据,用于声明基本数据类型 const name = ref('Jerry') // 修改 name.value = 'Tom'
// reactive声明响应式数据,用于声明引用数据类型 const state = reactive({ name: 'Jerry', sex: '男' }) // 修改 state.name = 'Tom'
// 使用toRefs解构 const {name, sex} = toRefs(state) // template可直接使用{{name}}、{{sex}}</script>
复制代码

三、method

<template>  // 调用方法  <button @click='changeName'>按钮</button>  </template>
<script setup> import { reactive } from 'vue'
const state = reactive({ name: 'Jery' }) // 声明method方法 const changeName = () => { state.name = 'Tom' } </script>
复制代码

四、computed

<script setup>  import { computed, ref } from 'vue'
const count = ref(1)
// 通过computed获得doubleCount const doubleCount = computed(() => { return count.value * 2 }) // 获取 console.log(doubleCount.value)</script>
复制代码

五、watch

<script setup>  import { watch, reactive } from 'vue'
const state = reactive({ count: 1 })
// 声明方法 const changeCount = () => { state.count = state.count * 2 }
// 监听count watch( () => state.count, (newVal, oldVal) => { console.log(state.count) console.log(`watch监听变化前的数据:${oldVal}`) console.log(`watch监听变化后的数据:${newVal}`) }, { immediate: true, // 立即执行 deep: true // 深度监听 } )</script>
复制代码

六、props 父传子

子组件

<template>  <span>{{props.name}}</span>  // 可省略【props.】  <span>{{name}}</span></template>
<script setup> // import { defineProps } from 'vue' // defineProps在<script setup>中自动可用,无需导入 // 需在.eslintrc.js文件中【globals】下配置【defineProps: true】
// 声明props const props = defineProps({ name: { type: String, default: '' } }) </script>
复制代码

父组件

引入子组件,组件会自动注册


<template>  <child name='Jerry'/>  </template>
<script setup> // 引入子组件 import child from './child.vue'</script>
复制代码


参考 vue 实战视频讲解:进入学习

七、emit 子传父

子组件

<template>  <span>{{props.name}}</span>  // 可省略【props.】  <span>{{name}}</span>  <button @click='changeName'>更名</button></template>
<script setup> // import { defineEmits, defineProps } from 'vue' // defineEmits和defineProps在<script setup>中自动可用,无需导入 // 需在.eslintrc.js文件中【globals】下配置【defineEmits: true】、【defineProps: true】 // 声明props const props = defineProps({ name: { type: String, default: '' } }) // 声明事件 const emit = defineEmits(['updateName']) const changeName = () => { // 执行 emit('updateName', 'Tom') }</script>
复制代码

父组件

<template>  <child :name='state.name' @updateName='updateName'/>  </template>
<script setup> import { reactive } from 'vue' // 引入子组件 import child from './child.vue'
const state = reactive({ name: 'Jerry' }) // 接收子组件触发的方法 const updateName = (name) => { state.name = name }</script>
复制代码

八、v-model

支持绑定多个v-modelv-modelv-model:modelValue 的简写


绑定其他字段,如:v-model:name

子组件

<template>  <span @click="changeInfo">我叫{{ modelValue }},今年{{ age }}岁</span></template>
<script setup> // import { defineEmits, defineProps } from 'vue' // defineEmits和defineProps在<script setup>中自动可用,无需导入 // 需在.eslintrc.js文件中【globals】下配置【defineEmits: true】、【defineProps: true】
defineProps({ modelValue: String, age: Number }) const emit = defineEmits(['update:modelValue', 'update:age']) const changeInfo = () => { // 触发父组件值更新 emit('update:modelValue', 'Tom') emit('update:age', 30) }</script>
复制代码

父组件

<template>  // v-model:modelValue简写为v-model  // 可绑定多个v-model  <child    v-model="state.name"    v-model:age="state.age"  /></template>
<script setup> import { reactive } from 'vue' // 引入子组件 import child from './child.vue'
const state = reactive({ name: 'Jerry', age: 20 })</script>
复制代码

九、nextTick

<script setup>  import { nextTick } from 'vue'
nextTick(() => { // ... })</script>
复制代码

十、ref 子组件实例和 defineExpose

  • 在标准组件写法里,子组件的数据都是默认隐式暴露给父组件的,但在 script-setup 模式下,所有数据只是默认 return 给 template 使用,不会暴露到组件外,所以父组件是无法直接通过挂载 ref 变量获取子组件的数据。

  • 如果要调用子组件的数据,需要先在子组件显示的暴露出来,才能够正确的拿到,这个操作,就是由 defineExpose 来完成。

子组件

<template>  <span>{{state.name}}</span></template>
<script setup> import { reactive, toRefs } from 'vue' // defineExpose无需引入 // import { defineExpose, reactive, toRefs } from 'vue'
// 声明state const state = reactive({ name: 'Jerry' }) // 将方法、变量暴露给父组件使用,父组件才可通过ref API拿到子组件暴露的数据 defineExpose({ // 解构state ...toRefs(state), // 声明方法 changeName () { state.name = 'Tom' } })</script>
复制代码

父组件

1. 获取一个子组件实例

<template>  <child ref='childRef'/></template>
<script setup> import { ref, nextTick } from 'vue' // 引入子组件 import child from './child.vue'
// 子组件ref(TypeScript语法) const childRef = ref<InstanceType<typeof child>>()
// nextTick nextTick(() => { // 获取子组件name console.log(childRef.value.name) // 执行子组件方法 childRef.value.changeName() })</script>
复制代码

2. 获取多个子组件实例:在 v-for 中获取子组件实例

这种情况仅适用于 v-for 循环数是固定的情况 ,因为如果 v-for 循环数 在初始化之后发生改变,那么就会导致 childRefs 再一次重复添加,childRefs 中会出现重复的子组件实例


<template>  <div v-for="item in 3" :key="item">    <child :ref='addChildRef'/>  </div></template>
<script setup> // 省略... // 子组件实例数组 const childRefs = ref([]) // 通过 addChildRef 方法向 childRefs 添加子组件实例 const addChildRef = (el) => { childRefs.value.push(el) }</script>
复制代码

3. 获取多个子组件实例:动态 v-for 获取子组件实例

通过下标来向 childRefs 添加/修改,初始化之后,动态修改 v-for 循环数,会自动根据下标重新修改该下标对应的数据


<template>  <button @click='childNums++'></button>  <div v-for="(item, i) in childNums" :key="item">    // 通过下标向 childRefs 动态添加子组件实例    <child :ref='(el) => childRefs[i] = el'/>  </div>  <button @click='childNums--'></button></template>
<script setup> // 省略... // 子组件数量 const childNums = ref(1) // 子组件实例数组 const childRefs = ref([])</script>
复制代码

十、插槽 slot

子组件

<template>  // 匿名插槽  <slot/>  // 具名插槽  <slot name='title'/>  // 作用域插槽  <slot name="footer" :scope="state" /></template>
<script setup> import { useSlots, reactive } from 'vue' const state = reactive({ name: '张三', age: '25岁' }) const slots = useSlots() // 匿名插槽使用情况 const defaultSlot = reactive(slots.default && slots.default().length) console.log(defaultSlot) // 1 // 具名插槽使用情况 const titleSlot = reactive(slots.title && slots.title().length) console.log(titleSlot) // 3</script>
复制代码

父组件

<template>  <child>    // 匿名插槽    <span>我是默认插槽</span>    // 具名插槽    <template #title>      <h1>我是具名插槽</h1>      <h1>我是具名插槽</h1>      <h1>我是具名插槽</h1>    </template>    // 作用域插槽    <template #footer="{ scope }">      <footer>作用域插槽——姓名:{{ scope.name }},年龄{{ scope.age }}</footer>    </template>  </child> </template>
<script setup> // 引入子组件 import child from './child.vue'</script>
复制代码

十二、路由 useRoute 和 useRouter

<script setup>  import { useRoute, useRouter } from 'vue-router'
// 必须先声明调用 const route = useRoute() const router = useRouter()
// 路由信息 console.log(route.query)
// 路由跳转 router.push('/newPage')</script>
复制代码

十三、路由导航守卫

<script setup>  import { onBeforeRouteLeave, onBeforeRouteUpdate } from 'vue-router'
// 添加一个导航守卫,在当前组件将要离开时触发。 onBeforeRouteLeave((to, from, next) => { next() })
// 添加一个导航守卫,在当前组件更新时触发。 // 在当前路由改变,但是该组件被复用时调用。 onBeforeRouteUpdate((to, from, next) => { next() })</script>
复制代码

十四、store

Vuex

*Vue3 中的 Vuex 不再提供辅助函数写法


<script setup>  import { useStore } from 'vuex'  import { key } from '../store/index'
// 必须先声明调用 const store = useStore(key)
// 获取Vuex的state store.state.xxx
// 触发actions的方法 store.commit('fnName')
// 触发actions的方法 store.dispatch('fnName')
// 获取Getters store.getters.xxx</script>
复制代码

Pinia

*全面拥抱 Pinia 吧!


2021 年 11 月 24 日,尤大在 Twitter 上宣布:Pinia 正式成为 Vue 官方的状态库,意味着 Pinia 就是 Vuex 5Pinia 的优点:


  • 同时支持 Composition Api 和 Options api 的语法;

  • 去掉 mutations ,只有 state 、getters 和 actions ;

  • 不支持嵌套的模块,通过组合 store 来代替;

  • 更完善的 Typescript 支持;

  • 清晰、显式的代码拆分;

安装

# 使用 npmnpm install pinia
# 使用 yarnyarn add pinia
复制代码

main.js 引入

import App from './App.vue'import { createApp } from 'vue'import { createPinia } from 'pinia'
const app = createApp(App)app.use(createPinia())app.mount('#app')
复制代码

配置 store.js

import { defineStore } from 'pinia'
// defineStore 调用后返回一个函数,调用该函数获得 Store 实体export const useStore = defineStore({ // id: 必须,在所有 Store 中唯一 id: 'globalState', // state: 返回对象的函数 state: () => ({ count: 1, data: { name: 'Jerry', sex: '男' } }), // getter 第一个参数是 state,是当前的状态,也可以使用 this 获取状态 // getter 中也可以访问其他的 getter,或者是其他的 Store getters: { // 通过 state 获取状态 doubleCount: (state) => state.count * 2, // 通过 this 获取状态(注意this指向) tripleCount() { return this.count * 3 } }, actions: { updateData (newData, count) { // 使用 this 直接修改 this.data = { ...newData } this.count = count
// 使用 $patch 修改多个值 this.$patch({ data: { ...newData }, count }) } }})
复制代码

使用 store

<template>  // 获取 store 的 state  <p>姓名:{{store.data.name}}</p>  <p>性别:{{store.data.sex}}</p>
// 调用 actions 方法 / 修改 store <button @click='update'>修改用户信息</button>
// 获取 getter <p>获取getter:{{store.doubleCount}}</p></template>
<script setup> import { useStore } from '@store/store.js' const store = useStore() function update () { // 通过 actions 定义的方法修改 state store.updateData({ name: 'Tom', sex: '女' }) // 通过 store 直接修改 store.data = { name: 'Tom', sex: '女' } // 同时改变多个状态 store.$patch((state) => { state.data = { name: 'Tom', sex: '女' } state.count = 2 }) }</script>
<style lang="scss" scoped></style>
复制代码

其他方法

替换整个 state


$state 可以让你通过将 store 的属性设置为新对象来替换 store 的整个 state


const store = useStore()store.$state = {  name: 'Bob',  sex: '男'}
复制代码


重置状态


调用 store 上的 $reset() 方法将状态重置为初始值


const store = useStore()store.$reset()
复制代码

十五、生命周期

通过在生命周期钩子前面加上 “on” 来访问组件的生命周期钩子。


下表包含如何在 Option API 和 setup() 内部调用生命周期钩子


十六、原型绑定与组件内使用

main.js

import { createApp } from 'vue'import App from './App.vue'const app = createApp(App)
// 获取原型const prototype = app.config.globalProperties
// 绑定参数prototype.name = 'Jerry'
复制代码

组件内使用

<script setup>  import { getCurrentInstance } from 'vue'
// 获取原型 const { proxy } = getCurrentInstance()
// 输出 console.log(proxy.name)</script>
复制代码

十七、v-bind() CSS 变量注入

<template>  <span>Jerry</span></template>
<script setup> import { ref, reactive } from 'vue' // prop接收样式 const props = defineProps({ border: { type: String, default: '1px solid yellow' } }) // 常量声明样式 const background = 'red' // 响应式数据声明样式 const color = ref('blue') const style = reactive({ opacity: '0.8' })</script>
<style lang="scss" scoped> span { // 使用常量声明的样式 background: v-bind(background); // 使用响应式数据声明的样式 color: v-bind(color); opacity: v-bind('style.opacity'); // 使用prop接收的样式 border: v-bind('props.border'); }</style>
复制代码

十八、provide 和 inject

父组件

<template>  <child/></template>
<script setup> import { ref, watch, provide } from 'vue' // 引入子组件 import child from './child.vue'
let name = ref('Jerry') // 声明provide provide('provideState', { name, changeName: () => { name.value = 'Tom' } }) // 监听name改变 watch(name, () => { console.log(`name变成了${name}`) setTimeout(() => { console.log(name.value) // Tom }, 1000) })</script>
复制代码

子组件

<script setup>  import { inject } from 'vue'  // 注入,第二个参数为默认值  const provideState = inject('provideState', {})
// 子组件触发name改变 provideState.changeName()</script>
复制代码

十九、自定义指令

Vue3 相较于 Vue2 的自定义声明方法有些不同


const app = createApp({})
// 使 v-demo 在所有组件中都可用app.directive('demo', { // 在绑定元素的 attribute 前或事件监听器应用前调用 created(el, binding, vnode, prevVnode) {}, // 在元素被插入到 DOM 前调用 beforeMount(el, binding, vnode, prevVnode) {}, // 在绑定元素的父组件 // 及他自己的所有子节点都挂载完成后调用 mounted(el, binding, vnode, prevVnode) {}, // 绑定元素的父组件更新前调用 beforeUpdate(el, binding, vnode, prevVnode) {}, // 在绑定元素的父组件 // 及他自己的所有子节点都更新后调用 updated(el, binding, vnode, prevVnode) {}, // 绑定元素的父组件卸载前调用 beforeUnmount(el, binding, vnode, prevVnode) {}, // 绑定元素的父组件卸载后调用 unmounted(el, binding, vnode, prevVnode) {}})
复制代码


比如实现一个默认密文身份证号,点击才展示的指令


app.directive('ciphertext', {  created: (el: any) => {    console.log(el, 1111)    el.style.cursor = 'pointer'    const value = el.innerText    if (!value || value === 'null' || value === '--') {      el.innerText = '--'    } else {      el.setAttribute('title', '点击查看')      el.innerText = hideText(value)      el.addEventListener('click', () => {        if (el.innerText.indexOf('*') > -1) {          el.innerText = value        } else {          el.innerText = hideText(value)        }      })    }  }})
<span v-ciphertext>{{idNumber}}</span>
复制代码

二十、对 await 的支持

不必再配合 async 就可以直接使用 await 了,这种情况下,组件的 setup 会自动变成 async setup 。


<script setup>  const post = await fetch('/api').then(() => {})</script>
复制代码

二十一、定义组件的 name

用单独的<script>块来定义


<script>  export default {    name: 'ComponentName',  }</script>
复制代码


用户头像

yyds2026

关注

还未添加个人签名 2022-09-08 加入

还未添加个人简介

评论

发布
暂无评论
Vue3, setup语法糖、Composition API全方位解读_Vue_yyds2026_InfoQ写作社区