代号:Rurouni Kenshin,vue3.3正式发布,快来尝鲜!!!

1写在前面

Vue官方团队在5月10日宣布发布 Vue 3.3 "浪客剑心"!

此版本专注于改进开发人员体验 ,特别是 SFC 

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

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

如上面使用条件类型,将会抛出异常:

详细说明见:PR#8083

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

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

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

注意:此功能在之前需要显式开启,在最新版本的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类型。



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

  • key:slot名称
  • value:slot函数,插槽函数的第一个参数是插槽期望接受的props,其定义的类型是用于模板中的插槽props。

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

注意:

  • volar / vue-tsc 尚未实现 slots 类型检查。
  • slot 函数的返回类型目前是忽略的,是any类型,但我们可能会在将来利用它进行 slot 内容检查。

此外,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默认值方式。



官方给出的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使用,需要:

  • 声明props
  • 在打算更新props时,使用emit进行相应的update:proName事件

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



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



执行效果:

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

  • defineModel 宏是 

    根据接受 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 允许直接在 

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

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

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

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

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

    toValue(1) //       --> 1
    toValue(ref(1)) //  --> 1
    toValue(() => 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主要有以下变化:

    • 增强defineProps和defineEmits支持外部import类型和复杂类型
    • 新增通过generic属性定义泛型组件
    • 增强更符合人体工程学的 defineEmits
    • 增强使用 defineSlots 设置 slots 类型

    实验性功能:

    • 响应式props解构
    • 新增defineModel实现v-model属性更新值

    其他特性:

    • 新增宏defineOptions声明组件选项
    • 增强 toRef 和 toValue 实现更好的 getter 支持
    • JSX 导入源支持

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

    文章题目:代号:Rurouni Kenshin,vue3.3正式发布,快来尝鲜!!!
    本文网址:http://www.csdahua.cn/qtweb/news24/374824.html

    网站建设、网络推广公司-快上网,是专注品牌与效果的网站制作,网络营销seo公司;服务项目有等

    广告

    声明:本网站发布的内容(图片、视频和文字)以用户投稿、用户转载内容为主,如果涉及侵权请尽快告知,我们将会在第一时间删除。文章观点不代表本网站立场,如需处理请联系客服。电话:028-86922220;邮箱:631063699@qq.com。内容未经允许不得转载,或转载时需注明来源: 快上网