5 月 11 日,Vue 3.3 正式发布,代号 Rurouni Kenshin。本次更新主要针对开发者体验进行了改进,特别是在使用 TypeScript 时的 SFC <script setup>
。与 Vue 语言工具(以前称为 Volar)1.6 的发布相结合,解决了在使用 TypeScript 时存在的许多长期困扰问题。下面就来看看 Vue 3.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)
SFC中的 <script setup>
和 TypeScript DX 改进
宏中的导入和复杂类型支持
在之前的版本中,用于 defineProps
和 defineEmits
的类型参数位置使用的类型被限制为本地类型,并且仅支持类型字面量和接口。这是因为 Vue 需要能够分析 props
接口上的属性以生成相应的运行时选项。
此限制现已在 3.3 中解决。 编译器现在可以解析导入的类型,并支持一组有限的复杂类型:
javascript
复制代码
<script setup lang="ts">import type { Props } from'./foo'// imported + intersection typedefineProps<Props & { extraProp?: string }>()</script>
注意,复杂类型支持是基于AST的,因此不是 100% 全面的。不支持一些需要实际类型分析的复杂类型,例如条件类型。可以对单个 props
的类型使用条件类型,但不能对整个 props
对象使用条件类型。
通用组件
使用<script setup>
的组件现在可以通过 generic
属性接受泛型类型参数:
javascript
复制代码
<script setup lang="ts" generic="T">defineProps<{ items: T[] selected: T}>()</script>
generic
的值与 TypeScript 中 <...>
之间的参数列表完全相同。 例如,可以使用多个参数、extends
约束、默认类型和引用导入类型:
javascript
复制代码
<script setup lang="ts" generic="T extends string | number, U extends Item">import type { Item } from'./types'defineProps<{ id: T list: U[]}>()</script>
这个功能以前需要显式地选择,但现在在最新版本的 volar / vue-tsc 中已经默认启用了。
更符合人体工程学的 defineEmits
以前,defineEmits 的类型参数只支持调用签名语法:
javascript
复制代码
const emit = defineEmits<{
(e: 'foo', id: number): void (e: 'bar', name: string, ...rest: any[]): void}>()
该类型与 emit 的返回类型相匹配,但编写起来有点冗长和笨拙。3.3 引入了一种更符合人体工程学的声明具有类型的 emit 的方法:
javascript
复制代码
const emit = defineEmits<{
foo: [id: number] bar: [name: string, ...rest: any[]]}>()
在类型字面量中,键是事件名称,值是指定附加参数的数组类型。虽然不是必需的,但可以使用带标签的元组元素来明确表示,就像上面的示例中一样。
调用签名语法仍然受支持。
使用 defineSlots 的类型插槽
新的 defineSlots
宏可用于声明预期的插槽及其相应的预期插槽 props:
javascript
复制代码
<script setup lang="ts">defineSlots<{ default?: (props: { msg: string }) => any item?: (props: { id: number }) => any}>()</script>
defineSlots()
只接受类型参数,不接受运行时参数。类型参数应该是类型字面量,其中属性键是插槽名称,值是插槽函数。该函数的第一个参数是插槽期望接收的 props
,其类型将用于模板中的插槽 props
。 defineSlots
的返回值与 useSlots
返回的插槽对象相同。
当前的一些限制:
- volar / vue-tsc 中尚未实现必需的插槽检查。
- 插槽函数返回类型目前被忽略,可以是 any 类型,但将来可能会利用它来检查插槽内容。
defineComponent
用法也有对应的 slots
选项。 这两个 API 都没有运行时影响,并且纯粹用作 IDE 和 vue-tsc 的类型提示。
实验功能
响应式 Props 解构
以前是现在已删除的 Reactivity Transform 的一部分,响应式 props 解构已拆分为单独的功能。
该功能允许解构的 props 保持响应性,并提供更符合人体工程学的声明 props 默认值的方式:
javascript
复制代码
<script setup> import { watchEffect } from 'vue' const { msg = 'hello' } = defineProps(['msg']) watchEffect(() => { // 在 watchers 和 computed getters 中访问 `msg` // 将其作为依赖项进行跟踪,就像访问 `props.msg` 一样 console.log(`msg is: ${msg}`) }) </script> <template>{{ msg }}</template>
defineModel
以前,对于支持与 v-model
双向绑定的组件,它需要(1)声明一个 prop 和(2)在打算更新 prop 时发出相应的 update:propName
事件:
<script setup> const props = defineProps(['modelValue']) const emit = defineEmits(['update:modelValue']) console.log(props.modelValue) function onInput(e) { emit('update:modelValue', e.target.value) } </script> <template> <input :value="modelValue" @input="onInput" /> </template>
3.3 使用新的 defineModel
宏简化了使用。 宏会自动注册一个 prop
,并返回一个可以直接改变的 ref
:
javascript
复制代码
<script setup> const modelValue = defineModel() console.log(modelValue.value) </script> <template> <input v-model="modelValue" /> </template>
其他特性
defineOptions
新的 defineOptions
宏允许直接在 <script setup>
中声明组件选项,而不需要单独的 <script>
块:
javascript
复制代码
<script setup>defineOptions({ inheritAttrs: false })
</script>
使用 toRef 和 toValue 实现更好的 getter 支持
toRef
已得到增强以支持将值/getters/现有 refs
规范化为 refs
:
javascript
复制代码
// 相当于 ref(1)toRef(1)
// 创建一个 readonly ref,在 .value 访问时调用 gettertoRef(() => props.foo)
// 按原样返回现有 refstoRef(existingRef)
使用 getter
调用 toRef
类似于 computed
,但是当 getter
只执行属性访问而没有昂贵的计算时,可以更高效。
新的 toValue
工具方法提供相反的功能,即将值/ getter / ref 规范化为值:
javascript
复制代码
toValue(1) // --> 1toValue(ref(1)) // --> 1toValue(() =>1) // --> 1
toValue
可以在组合式函数中代替 unref
,以便组合式函数可以接受 getter
作为响应式数据源:
javascript
复制代码
// 以前:分配不必要的中间引用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 团队能够更有信心地更快地行动:
- 通过将类型检查与汇总构建分开并从
rollup-plugin-typescript2
移动到rollup-plugin-esbuild
,构建速度提高 10 倍。 - 通过从 Jest 转移到 Vitest 来加快测试速度。
- 通过从
@microsoft/api-extractor
转移到rollup-plugin-dts
来更快地生成类型。 - 通过
ecosystem-ci
进行综合回归测试,在发布前捕获主要生态系统依赖项中的回归。
按照计划,Vue 团队的目标是在 2023 年开始发布更小、更频繁的功能版本,敬请期待!