Vue3基础

Vue3

一、组合式API介绍

*Vue3提供两种组织代码逻辑的写法：

• 通过data、methods、watch等配置选项组织代码逻辑是选项式API写法
• 所有逻辑在setup函数中,使用ref、watch等函数组织代码是组合式API写法

准备了两份代码实现同一些功能，做对比：

option api

<template>
  <button @click="toggle">显示隐藏图片</button>
  <img v-show="show" alt="Vue logo" src="./assets/logo.png" />
  <hr />
  计数器：{{ count }} <button @click="increment">累加</button>
</template>
<script>
export default {
  data() {
    return {
      show: true,
      count: 0,
    };
  },
  methods: {
    toggle() {
      this.show = !this.show;
    },
    increment() {
      this.count++;
    },
  },
};
</script>

composition api

<template>
  <button @click="toggle">显示隐藏图片</button>
  <img v-show="show" alt="Vue logo" src="./assets/logo.png" />
  <hr />
  计数器：{{ count }} <button @click="increment">累加</button>
</template>
<script>
// ref 就是一个组合式API  
import { ref } from 'vue';
export default {
  setup () {
    // 显示隐藏
    const show = ref(true)
    const toggle = () => {
      show.value = !show.value
    }
    // 计数器
    const count = ref(0)
    const increment = () => {
      count.value ++
    }

    return { show, toggle, count, increment }
  }
};
</script>

总结：

• 在setup中通过vue提供的函数组织代码实现功能，就是组合式API写法。
• 组合式API有什么好处？可复用，可维护
• ref是不是一个组合式API？是

二、Vue3语法

1. setup函数

• setup函数是Vue3特有的选项，作为组合式API的起点
• 从组件生命周期看，他在beforeCreate之前执行
• 函数中this不是组件实例，是undefined
• 如果数据或者函数在模板中使用，需要在setup返回

<template>
  <div class="container">
    <h1 @click="say()">{{msg}}</h1>
  </div>
</template>

<script>
export default {
  setup () {
    console.log('setup执行了')
    console.log(this)
    // 定义数据和函数
    const msg = 'hi vue3'
    const say = () => {
      console.log(msg)
    }
    // 返回给模板使用
    return { msg , say}
  },
  beforeCreate() {
    console.log('beforeCreate执行了')
    console.log(this)
  }
}
</script>

今后在Vue3的项目中几乎用不到this，所有的东西通过函数获取

2. reactive函数

以前在data函数中返回对象数据就是响应式的，现在setup中返回对象数据是响应式的吗？

• 不是，需要使用reactive转成响应式

使用步骤：

1. 从vue中导出reactive函数
2. 在setup函数中，使用reactive函数，传入一个普通对象，返回一个响应式数据对象
3. 最后setup函数返回一个对象，包含该响应式对象即可，模板中可使用

<template>
  <div>
    <p>姓名：{{state.name}}</p>
    <p>年龄：{{state.age}} <button @click="state.age++">一年又一年</button></p>
  </div>
</template>

<script>
// 1. 导入函数
import { reactive } from "vue"; 
export default {
  setup() {
    // 2. 创建响应式数据对象
    const state = reactive({ name: 'tom', age: 18 })
    // 3. 返回数据
    return { state }
  }
};
</script>

• reactive函数通常定义：复杂类型的响应式数据
• 可以转换简单数据吗？ 不能

3. ref函数

使用步骤：

1. 从vue中导出ref函数
2. 在setup函数中，使用ref函数，传入普通数据（简单or复杂），返回一个响应式数据
3. 最后setup函数返回一个对象，包含该响应式数据即可
4. 注意：使用ref创建的数据，js中需要.value,template中可省略

落地代码：

<template>
  <div>
    <p>
      计数器：{{ count }}
      <button @click="count++">累加1</button>
      <!-- template中使用可省略.value -->
      <button @click="increment">累加10</button>
    </p>
  </div>
</template>

<script>
// 1. 导入函数
import { ref } from "vue";
export default {
  setup() {
    // 2. 创建响应式数据对象
    const count = ref(0);
    const increment = () => {
      // js中使用需要.value
      count.value += 10;
    };
    // 3. 返回数据
    return { count, increment };
  },
};
</script>

• ref可以把简单数据类型或者复杂数据转化成响应式数据，注意使用加上 .value，不过模板可以省略

• 疑问：定义响应式数据使用ref还是reactive呢？

4. reactive 与 ref 的选择

开始分析：

• reactive可以转换对象成为响应式数据对象，但是不支持简单数据类型。
• ref可以转换成简单数据类型为响应式数据对象，也支持复杂数据类型，但是操作的时候需要.value
• 他们各有各的特点，现在也没有最佳实践，没有明显的界限，所以大家可以自由选择。

推荐用法：

如果能确定数据是对象且字段名称也确定，可使用reactive转成响应式数据，其他一概使用ref。这样就没有新郑负担

    // 1. 明确表单对象有两个字段
    const form = reactive({
      username: '',
      password: ''
    })

    // 2. 后台返回的数据对象
    const data = ref(null)
    const res = await axios.get('/user/100')
    data.value = res.data

在定义响应式数据的函数选择上，遵循：尽量使用ref函数支持所有场景，确定字段的对象使用reactive可以省去.value

5. setup语法糖

发现：

使用setup有几件事必须做：默认导出配置选项，setup函数声明，返回模板需要数据与函数

<script>
export default {
  setup() {
    const say = () => console.log('hi')
    return { say }
  }
}
</script>

解法：

使用setup语法糖

<script setup>
  const say = () => console.log('hi')
</script>

<script setup>
  // 显示隐藏
  const show = ref(true)
  const toggle = () => {
    show.value = !show.value
  }
  // 计数器
  const count = ref(0)
  const increment = () => {
    count.value ++
  }
</script>

<template>
  <button @click="toggle">显示隐藏图片</button>
  <img v-show="show" alt="Vue logo" src="./assets/logo.png" />
  <hr />
  计数器：{{ count }} <button @click="increment">累加</button>
</template>

在script setup 中的顶层变量都可以在模板使用，数据，函数，组件。

6. computed函数

大致步骤：

1. 从vue中导出computed函数
2. 在setup函数中，使用computed函数，传入一个函数，函数返回计算好的数据
3. 最后setup函数返回一个对象，包含该计算属性数据即可，然后模板使用

<script setup>
  import { ref, computed } from "vue";

  const scoreList = ref([80, 100, 90, 70, 60]);
  // 计算属性
  const betterList = computed(() => scoreList.value.filter((item) => item >= 90));
  // 改变数据，计算属性改变
  setTimeout(() => {
    scoreList.value.push(92, 66);
  }, 3000);

</script>

<template>
  <div>
    <p>分数：{{ scoreList }}</p>
    <p>优秀：{{ betterList }}</p>
  </div>
</template>

使用computed定义计算属性，场景：当需要依赖一个数据得到新的数据使用计算属性

7. watch函数

大致内容：

• 使用watch监听一个响应式数据
• 使用watch监听多个响应式数据
• 使用watch监听响应式对象数据中的一个属性（简单）
• 使用watch监听响应式对象数据中的一个属性（复杂），配置深度监听
• 使用watch监听，配置默认执行

使用 watch 监听一个响应式数据

<script setup>
  import { ref, watch } from "vue";
  const count = ref(0);
  // 1. 监听一个响应式数据
  // watch(数据, 改变后回调函数)
  watch(count, () => {
    console.log("count改变了");
  });
  // 2s改变数据
  setTimeout(() => {
    count.value++;
  }, 2000);
</script>

<template>
  <p>计数器：{{ count }}</p>
</template>

使用 watch 监听多个响应式数据

<script setup>
  import { reactive, ref, watch } from "vue";
  const count = ref(0);
  const user = reactive({
    name: "tom",
    info: {
      gender: "男",
      age: 18,
    },
  });
  
  // 2. 监听多个响应式数据
  // watch([数据1, 数据2, ...], 改变后回调函数)
  watch([count, user], () => {
    console.log("数据改变了");
  });
  
  // 2s改变数据
  setTimeout(() => {
    count.value++;
  }, 2000);
  
  // 4s改变数据
  setTimeout(() => {
    user.info.age++;
  }, 4000);
</script>

<template>
  <p>计数器：{{ count }}</p>
  <p>
    姓名：{{ user.name }} 性别：{{ user.info.gender }} 年龄：{{ user.info.age }}
  </p>
</template>

使用 watch 监听响应式对象数据中的一个属性(简单)

<script setup>
  import { reactive, watch } from "vue";
  const user = reactive({
    name: "tom",
    info: {
      gender: "男",
      age: 18,
    },
  });
  // 3. 监听响应式对象数据的一个数据，简单类型
  // watch(()=>数据, 改变后回调函数)
  watch(()=>user.name, () => {
    console.log("数据改变了");
  });
  // 2s改变数据
  setTimeout(() => {
    user.name = 'jack';
  }, 2000);
  // 4s改变数据
  setTimeout(() => {
    user.info.age = 60;
  }, 4000);
</script>

<template>
  <p>
    姓名：{{ user.name }} 性别：{{ user.info.gender }} 年龄：{{ user.info.age }}
  </p>
</template>

使用 watch 监听响应式对象数据中的一个属性(复杂)，配置深度监听

<script setup>
  import { reactive, watch } from "vue";
  const user = reactive({
    name: "tom",
    info: {
      gender: "男",
      age: 18,
    },
  });
  // 4. 监听响应式对象数据的一个数据，复杂类型
  // watch(()=>数据, 改变后回调函数, {deep: true})
  watch(
    () => user.info,
    () => {
      console.log("数据改变了");
    },
    {
      // 开启深度监听
      deep: true,
    }
  );
  // 2s改变数据
  setTimeout(() => {
    user.info.age = 60;
  }, 2000);
</script>

<template>
  <p>
    姓名：{{ user.name }} 性别：{{ user.info.gender }} 年龄：{{ user.info.age }}
  </p>
</template>

使用 watch 监听，配置默认执行

      {
        // 开启深度监听
        deep: true,
+        // 默认执行一次
+        immediate: true
      }

• watch(需要监听的数据，数据改变执行函数，配置对象)来进行数据的监听

• 数据：单个数据，多个数据，函数返回对象属性，属性复杂需要开启深度监听

• 配置对象：deep深度监听immediate默认执行

8. 生命周期函数

使用步骤：

1. 先从vue导入以on开头的生命周期钩子函数
2. 在setup函数中调用生命周期函数并传入回调函数
3. 生命周期钩子函数可以调用多次

具体内容：

• Vue3和Vue2的生命周期对比：

选项式API下的生命周期函数使用	组合式API下的生命周期函数使用
beforeCreate	不需要（直接写到setup函数中）
created	不需要（直接写到setup函数中）
beforeMount	onBeforeMount
mounted	onMounted
beforeUpdate	onBeforeUpdate
updated	onUpdated
beforeDestroyed	onBeforeUnmount
destroyed	onUnmounted
activated	onActivated
deactivated	onDeactivated

• 参考代码

<script setup>
  import { onMounted } from "vue";
  // 生命周期函数：组件渲染完毕
  onMounted(()=>{
    console.log('onMounted触发了')
  })

  onMounted(()=>{
    console.log('onMounted也触发了')
  })
</script>

<template>
  <div>生命周期函数</div>
</template>

• 常用的 onMounted 组件渲染完毕：发请求，操作dom，初始化图表…

9. ref获取DOM元素

步骤：

1. 创建ref => const hRef = ref(null)
2. 模板中建立关联 => <h1 ref="hRef ">我是标题</h1>
3. 使用 => hRef.value

<script setup>
import { ref } from 'vue'

const hRef = ref(null)  
const clickFn = () => {
  hRef.value.innerText = '我不是标题'
}
</script>

<template>
  <div>
    <h1 ref="hRef">我是标题</h1>
    <button @click="clickFn">操作DOM</button>
  </div>
</template>

默认值是null,需要在渲染完毕后访问DOM属性

10. ref操作组件-defineExpose

步骤：

• 使用 <script setup>的组件是默认关闭的，组件实例使用不到顶层的数据和函数
• 需要配合defineExpose暴露给组件实例使用，暴露的响应式数据会自动解除响应式

<script setup>
import { ref } from 'vue'

const count = ref(0)
const validate = () => {
  console.log('表单校验方法')
}

// 暴露属性给外部组件使用
defineExpose({count, validate})
</script>

<template>
  <h3>我是Form组件</h3>
</template>

ref操作组件

<script setup>
import { ref } from 'vue'
import Form from './components/Form.vue'

// 1. 提供一个ref
const formRef = ref(null)
// 2. 使用组件组件和方法
const fn = () => {
  console.log(formRef.value.count)
  formRef.value.validate()
}
</script>

<template>
  <Form ref="formRef"></Form>
</template>

配合defineExpose暴露数据和方法，ref获取的组件实例才可以使用

三、组件通信

1. 父传子-defineProps函数

步骤：

1. 父组件提供数据
2. 父组件将数据传递给子组件
3. 子组件通过defineProps进行接收
4. 子组件渲染父组件传递的数据

ParentCom.vue

<script setup>
import { ref } from 'vue'
import ChildCom from './components/ChildCom.vue'

const money = ref(100)
const car = ref('玛莎拉蒂')
</script>

<template>
  <div>
    <h1>我是父组件</h1>
    <div>金钱：{{ money }}</div>
    <div>车辆：{{ car }}</div>
    <hr />
    <ChildCom :money="money" :car="car"></ChildCom>
  </div>
</template>

ChildCom.vue

<script setup>
import { computed } from 'vue'

// defineProps: 接收父组件传递的数据
const props = defineProps({
  money: Number,
  car: String,
})
// 使用props
console.log(props.money)
</script>

<template>
  <div>
    <h3>我是子组件</h3>
    <div>{{ money }} --- {{ car }}</div>
  </div>
</template>

• 如果使用defineProps接收数据，这个数据只能在模板中渲染
• 如果想要在script中也操作props属性，应该接收返回值

2. 子传父-defineEmits函数

步骤：

1. 子组件通过defineEmits获取emit函数（因为没有this）
2. 子组件通过emit触发事件，并且传递数据
3. 父组件提供方法
4. 父组件通过自定义事件的方式给子组件注册事件

ChildCom.vue

<script setup>
defineProps({
  money: Number,
  car: String,
})

// 得到emit函数，显性声明事件名称
const emit = defineEmits(['changeMoney'])
const change = () => {
  emit('changeMoney', 10)
}
</script>

PrarentCom.vue

<script setup>
import { ref } from 'vue'
import ChildCom from './components/ChildCom.vue'

const money = ref(100)
const car = ref('玛莎拉蒂')
const changeMoney = (num) => {
  money.value = money.value - num
}
</script>

<ChildCom :money="money" :car="car" @changeMoney="changeMoney"></ChildCom>

defineEmit获取emit函数，且组件需要触发的事件需要显性声明出来

3. 跨级组件通讯provide与inject函数

通过provide和inject函数可以简便的实现跨级组件通讯

祖先组件：App.vue

<script setup>
import { provide, ref } from 'vue';
import ParentCom from './ParentCom.vue';

// 1. app组件数据传递给child
const count = ref(0);
provide('count', count);

// 2. app组件函数传递给child，调用的时候可以回传数据
const updateCount = (num) => {
  count.value += num;
};
provide('updateCount', updateCount);
</script>

<template>
  <div
    class="app-page"
    style="border: 10px solid #ccc; padding: 50px; width: 600px"
  >
    app 组件 {{ count }} updateCount
    <ParentCom />
  </div>
</template>

父级组件：ParentCom.vue

<script setup>
import ChildCom from './ChildCom.vue';
</script>

<template>
  <div class="parent-page" style="padding: 50px">
    parent 组件
    <hr />
    <ChildCom />
  </div>
</template>

子级组件：ChildCom.vue

<script setup>
const count = inject('count');
const updateCount = inject('updateCount');
</script>

<template>
  <div class="child-page" style="padding: 50px; border: 10px solid #ccc">
    child 组件 {{ count }} <button @click="updateCount(100)">修改count</button>
  </div>
</template>

provide和inject是解决跨级组件通讯的方案

• provide提供后代组件需要依赖的数据或函数
• inject注入（获取）provide提供的数据或函数

官方术语：依赖注入

• App是后代组件依赖的数据和函数的提供者,Child是注入（获取）了App提供的依赖

4. 保持响应式-toRefs函数

大致步骤：

• 结构响应式数据，踩坑
• 使用toRefs处理响应式数据，爬坑
• toRefs函数的作用，与使用场景

<script setup>
import { reactive } from "vue";
const user = reactive({ name: "tom", age: 18 });
</script>

<template>
  <div>
    <p>姓名：{{ user.name }}</p>
    <p>年龄：{{ user.age }} <button @click="user.age++">一年又一年</button></p>
  </div>
</template>

使用响应式数据，踩坑

<script setup>
import { reactive } from "vue";
const { name, age } = reactive({ name: "tom", age: 18 });
</script>

<template>
  <div>
    <p>姓名：{{ name }}</p>
    <!-- 响应式丢失 -->
    <p>年龄：{{ age }} <button @click="age++">一年又一年</button></p>
  </div>
</template>

使用 toRefs 处理响应式数据，爬坑

import { reactive, toRefs } from "vue";
const user = reactive({ name: "tom", age: 18 });
const { name, age } = toRefs(user)

toRefs 函数的作用，与使用场景

• 作用：把对象中的每一个属性做一次性包装成为响应式数据
• 响应式数据展开的时候使用，结构响应式数据的时候使用

的作用，与使用场景

<script setup>
import { reactive } from "vue";
const user = reactive({ name: "tom", age: 18 });
</script>

<template>
  <div>
    <p>姓名：{{ user.name }}</p>
    <p>年龄：{{ user.age }} <button @click="user.age++">一年又一年</button></p>
  </div>
</template>

使用响应式数据，踩坑

<script setup>
import { reactive } from "vue";
const { name, age } = reactive({ name: "tom", age: 18 });
</script>

<template>
  <div>
    <p>姓名：{{ name }}</p>
    <!-- 响应式丢失 -->
    <p>年龄：{{ age }} <button @click="age++">一年又一年</button></p>
  </div>
</template>

使用 toRefs 处理响应式数据，爬坑

import { reactive, toRefs } from "vue";
const user = reactive({ name: "tom", age: 18 });
const { name, age } = toRefs(user)

toRefs 函数的作用，与使用场景

• 作用：把对象中的每一个属性做一次性包装成为响应式数据
• 响应式数据展开的时候使用，结构响应式数据的时候使用

当去结构和展开响应式数据对象使用toRefs保持响应式