全球新消息丨代号：Rurouni Kenshin，vue3.3正式发布，快来尝鲜！！！

为了向后兼容，3.3 仍然全局注册 JSX 命名空间。我们计划在 3.4 中删除默认的全局注册。如果您正在使用 TSX 与 Vue，请在升级到 3.3后在 tsconfig.json 中添加显式的 jsxImportSource，以避免在 3.4 中出现问题。

1写在前面

Vue官方团队在5月10日宣布发布 Vue 3.3 “浪客剑心”！

(资料图片)

此版本专注于改进开发人员体验 ，特别是 SFC<script setup>与 TypeScript 的使用。一同发布的还有 1.6 版本的 Vue Language Tools （以前称为 Volar），我们解决了很多 Vue 与 TypeScript 使用上的痛点。

想要体验Vue3.3的前提是：升级Vue到最新版本，同时升级对应的依赖项，对于一些实验性功能需要进行手动开启。

依赖更新

升级到 3.3 时，建议同时更新以下依赖项：

volar / vue-tsc@^1.6.4

vite@^4.3.5

@vitejs/plugin-vue@^4.2.0

vue-loader@^17.1.0（如果使用 webpack 或 vue-cli）

更多更新日志可以查看：https://github.com/vuejs/core/blob/main/CHANGELOG.md#330-2023-05-08

2defineProps和defineEmits支持外部import类型和复杂类型

在vue3.3之前的vue文件中， defineProps和defineEmits仅支持使用当前文件定义的类型，不能通过import导入外部定义的类型，且仅支持类型字面量和当前文件的interface。

在vue3.3对这一限制进行了优化，编译器可以通过AST支持解析外部impoort的类型，并支持有限的复杂类型。

<script lang="ts" setup>import type { TestProps } from "./props";// vue3.3 支持外部导入props类型，通过泛型定义props上的属性类型defineProps();defineProps();</script>

注意：defineProps和defineEmits并不是100%全面支持复杂类型，例如不能对整个props对象像普通类型一样进行条件类型，但是可以对单个prop类型使用条件类型。

import type { TestProps } from "./props";defineProps();

如上面使用条件类型，将会抛出异常：

详细说明见：PR#8083

3通过generic属性定义泛型组件

使用vue的setup语法糖的组件，可以通过在generic属性传递泛型类型参数，从而构成泛型组件：

<script lang="ts" setup generic="T, U">defineProps<{  options: T[],  selected: T,  id: U}>()</script>

通过generic接受的泛型类型，和Typescript中的泛型的参数列表使用方法是一样的，这就意味着你可以定义多个泛型参数、使用extends约束、默认类型和引用import导入的类型。

<script lang="ts" setup generic="T extends Option, U">import { Option } from "./props"defineProps<{  options: T[],  selected: T,  id: U}>()</script>

注意：此功能在之前需要显式开启，在最新版本的volar/vue-tsc中已支持默认开启。

详细说明见：RFCS#436

4更符合人体工程学的 defineEmits

在Vue3.3之前的defineEmits的类型仅支持使用签名语法：

interface EmitsType{  (event: "change", value: T): void  (event: "click", value: T, ...rest:U[]): void}defineEmits>()

interface EmitsType{  change: (value: T) => void  click: (value: T, ...rest:U[]) => void}defineEmits>()

此种方式定义的类型和emit返回的类型匹配，但是在实际开发中编写代码比较冗长和笨拙，Vue3.3对此进行优化使得更加符合人类习惯。

interface EmitsType{  change: [ value: T ],  click: [ value:T, ...rest: U[] ]}defineEmits>()

在使用类型字面量形式中，键key是事件名称，值value是指定附加参数的数组类型，对此可以使用标识元组元素的形式。见元组元素标记

Vue3.3对于defineEmits的泛型定义形式并不是破坏性改变，对原有的签名语法依旧支持。

5使用 defineSlots 设置 slots 类型

Vue3.3后的defineSlots宏支持声明预期的插槽和对应插槽的props类型。

<script lang="ts" setup>interface SlotsType{  default?: (props: {    title: string  })=>any;  header?: (props: {    title: string  })=>any}defineSlots()</script>

当前，defineSlots仅接受一个类型参数，不支持运行时参数，且类型参数限制为一个类型字面量：

defineSlots 的返回值与 useSlots 返回的插槽对象相同。

注意：

此外，defineComponent用法也有对应的 slots 选项。 这两个 API 都没有运行时影响，并且纯粹用作 IDE 和 vue-tsc 的类型提示。

import { SlotsType } from "vue"defineComponent({  slots: Object as SlotsType<{    default: { foo: string; bar: number }    item: { data: number }  }>,  setup(props, { slots }) {    expectType any)>(      slots.default    )    expectType any)>(slots.item)  }})

更多详情见：PR#7982

6实验性功能

响应式props解构

响应式props解构此前是现已删除的 Reactivity Transform的一部分，Vue3.3现已将其拆分成独立功能。

响应式props解构的功能毫无疑问是为解构后的props属性提供响应式，此外还提供了更加符合用户习惯的声明props默认值方式。

<script lang="ts" setup>import {  watchEffect } from "vue"// 官方给出的demo是这样写，但是我发现不能对props进行泛型类型声明，解构后的属性失去了类型推断 不建议使用这种方式const {  name ="dudu" } = defineProps(["name"])// 个人推荐搭配withDefaults进行赋默认值和响应式解构，有解构需要时可以进行解构赋值，没有时可以在withDefaults中赋默认值const {  name = "dudu" } = withDefaults(defineProps<{}>(),{})watchEffect(()=>{   // 在 watchers 和 computed getters 中访问 `name`   // 将其作为依赖项进行跟踪，就像访问 `name` 一样  console.log(`my friend‘s name is: ${name}`)})</script>

官方给出的demo是这样写，但是实际使用中发现不能对props进行泛型类型声明，解构后的属性失去了类型推断 不建议使用这种方式。

const {  name ="dudu" } = defineProps(["name"])

个人推荐搭配withDefaults进行赋默认值和响应式解构，有解构需要时可以进行解构赋值，没有时可以在withDefaults中赋默认值。

const {  name = "dudu" } = withDefaults(defineProps<{}>(),{})

如果搭配withDefaults同时进行响应式解构时赋默认值，那么解构时不能改变withDefaults赋的默认值，也就是withDefaults的默认值是不可改变的。

const {  name ="dudu" } = withDefaults(defineProps<{  name: string}>(),{  name:"dudududududu"})

我们看到只会显示withDefaults的默认值：

注意：此功能是实验性功能，需要在打包配置中进行手动开启。

更多详情见：RFC#502

defineModel

在Vue3.3前的组件想要支持v-model使用，需要：

子组件支持v-model的方式：

<script lang="ts" setup>// BEFORE: Vue3.3前的方式const props = defineProps(["modelValue"])const emit = defineEmits(["update:modelValue"])console.log(props.modelValue)function onInput(e) {  emit("update:modelValue", e.target.value)}</script>

与此同时，父组件需要进行对应声明使用：

<script setup lang="ts">import DefineModel from "./components/DefineModel.vue";const name = ref("dudu")</script>

执行效果：

Vue3.3引入了一个名为 defineModel 的新 SFC 宏，该宏增强了声明 v-model 使用的双向绑定道具时的开发人员体验。使用 defineModel ，v-model绑定的props 可以像 ref 一样被声明和解构。

defineModel简化了声明props和emit的过程，会自动注册一个prop，并返回一个可以直接改变的 ref：

<script lang="ts" setup>// AFTER: Vue3.3后的方式const modelValue =  defineModel()console.log(modelValue.value)</script>

根据接受 defineModel 返回值的变量名，这里是 modelValue，会自动定义 props 名为 modelValue，emit 事件为 update:modelValue。

此外，defineModel也支持声明变量名称、类型和赋初值，其实就是props和emit的结合体。

const count = defineModel("count", { default: 0 })

注意：Vue3.3引入了一个新的编译器脚本选项 defineModel ，默认情况下处于禁用状态，需要手动进行配置开启。

在vite的配置如下：

// https://vitejs.dev/config/export default defineConfig({  plugins: [vue({    // propsDestructure: true,    script: {      defineModel: true,    }  })],})

更多详情见：RFC#503

7其他特性

新增宏defineOptions

新增defineOptions 允许直接在<script setup>中声明组件选项，而无需单独的<script>块：

<script setup>defineOptions({ inheritAttrs: false })</script>

增强 toRef 和 toValue 实现更好的 getter 支持

toRef 已得到增强以支持将值/getters/现有 refs 规范化为 refs：

// 相当于 ref(1)toRef(1)// 创建只读 ref，使用 .value 时执行 gettertoRef(() => props.foo)// 返回 reftoRef(existingRef)

使用 getter 调用 toRef 类似于 computed，但是当 getter 只执行属性访问而没有昂贵的计算时，可以更高效。

新的 toValue 工具方法提供相反的功能，即将值/ getter / ref 规范化为值：

toValue(1) //       --> 1toValue(ref(1)) //  --> 1toValue(() => 1) // --> 1

toValue 可以在组合式函数中代替 unref，以便组合式函数可以接受 getter 作为响应式数据源：

// 以前：分配不必要的中间引用useFeature(computed(() => props.foo))useFeature(toRef(props, "foo"))// 现在：更高效和简洁useFeature(() => props.foo)

toRef 和 toValue 之间的关系类似于 ref 和 unref 之间的关系，主要区别在于 getter 函数的特殊处理。

JSX 导入源支持

目前，Vue 的类型自动注册全局 JSX 类型。这可能会与需要 JSX 类型推断的其他库一起使用时发生冲突，特别是 React。

从3.3开始，Vue 支持通过 TypeScript 的 jsxImportSource 选项指定 JSX 命名空间。这允许用户根据其需要，选择全局或每个文件的选择加入。

为了向后兼容，3.3 仍然全局注册 JSX 命名空间。我们计划在 3.4 中删除默认的全局注册。如果您正在使用 TSX 与 Vue，请在升级到 3.3后在 tsconfig.json 中添加显式的 jsxImportSource，以避免在 3.4 中出现问题。

按计划，Vue官方的目标是在2023年开始制作较小，更频繁的功能发行版。

更多内容阅读：vue官方博客https://blog.vuejs.org/posts/vue-3-3

8写在最后

Vue3.3没有进行大的功能破坏性改变，在使用体验上更加符合人体工程学和用户习惯，没有心智负担。

Vue3.3主要有以下变化：

实验性功能：

其他特性：

学而知不足，水平有限，还望诸君多多指教。觉得文章不错的读者，不妨点个关注，收藏起来上班摸鱼的时候品尝。