可能很多同学(包括我)刚上手 Vue 3.0 之后,都会觉得开发过程似乎变得更繁琐了,Vue 官方团队当然不会无视群众的呼声,如果你基于脚手架和 .vue 文件开发,那么可以享受到更高效率的开发体验。
在阅读这篇文章之前,需要对 Vue 3.0 的单组件有一定的了解,如果还处于完全没有接触过的阶段,请先抽点时间阅读 单组件的编写 一章。
WARNING
本章节的部分方案属于实验性方案,或者是刚进入定稿阶段,所以在官网文档上还暂时看不到使用说明,期间可能还会有一些功能调整和 BUG 修复,请留意版本号说明。
所以要体验以下新特性,请确保项目下 package.json 里的 vue (opens new window)和 @vue/compiler-sfc (opens new window)都在 v3.1.4 版本以上,最好同步 NPM 上当前最新的 @next 版本,否则在编译过程中可能出现一些奇怪的问题(这两个依赖必须保持同样的版本号)。
#script-setup
这是一个比较有争议的新特性,作为 setup 函数的语法糖,褒贬不一,不过经历了几次迭代之后,目前在体验上来说,感受还是非常棒的。
TIP
截止至 2021-07-16 ,方案已在 Vue
3.2.0-beta.1
版本中脱离实验状态,正式进入 Vue 3.0 的队伍,在新的版本中已经可以作为一个官方标准的开发方案使用(但初期仍需注意与开源社区的项目兼容性问题,特别是 UI 框架)。
另外,Vue 的 3.1.2
版本是针对 script-setup 的一个分水岭版本,自 3.1.4
开始 script-setup 进入定稿状态,部分旧的 API 已被舍弃,本章节内容将以最新的 API 为准进行整理说明,如果您需要查阅旧版 API 的使用,请参阅 这里 (opens new window)。
#新特性的产生背景
在了解它怎么用之前,可以先了解一下它被推出的一些背景,可以帮助你对比开发体验上的异同点,以及了解为什么会有这一章节里面的新东西。
在 Vue 3.0 的 .vue 组件里,遵循 SFC 规范要求(注:SFC,即 Single-File Component,.vue 单组件),标准的 setup 用法是,在 setup 里面定义的数据如果需要在 template 使用,都需要 return 出来。
如果你使用的是 TypeScript ,还需要借助 defineComponent 来帮助你对类型的自动推导。
关于标准 setup 和 defineComponent 的说明和用法,可以查阅 全新的 setup 函数 一节。
script-setup 的推出是为了让熟悉 3.0 的用户可以更高效率的开发组件,减少一些心智负担,只需要给 script 标签添加一个 setup 属性,那么整个 script 就直接会变成 setup 函数,所有顶级变量、函数,均会自动暴露给模板使用(无需再一个个 return 了)。
Vue 会通过单组件编译器,在编译的时候将其处理回标准组件,所以目前这个方案只适合用 .vue 文件写的工程化项目。
对,就是这样,代码量瞬间大幅度减少……
TIP
因为 script-setup 的大部分功能在书写上和标准版是一致的,这里只提及一些差异化的表现。
#全局编译器宏
在 script-setup 模式下,新增了 4 个全局编译器宏,他们无需 import 就可以直接使用。
但是默认的情况下直接使用,项目的 eslint 会提示你没有导入,但你导入后,控制台的 Vue 编译助手又会提示你不需要导入,就很尴尬…
哈哈哈哈不过不用着急,可以配置一下 lint ,把这几个编译助手写进全局规则里,就可以了,不需要导入也不会报错了。
// 项目根目录下的 .eslintrc.js
module.exports = {
// 原来的lint规则,补充下面的globals...
globals: {
defineProps: 'readonly',
defineEmits: 'readonly',
defineExpose: 'readonly',
withDefaults: 'readonly',
},
}
关于几个宏的说明都在下面的文档部分有说明,你也可以从这里导航过去直接查看。
宏 | 说明 |
---|---|
defineProps | 点击查看 |
defineEmits | 点击查看 |
defineExpose | 点击查看 |
withDefaults | 点击查看 |
下面我们继续了解 script-setup 的变化。
#template 操作简化
如果使用 JSX / TSX 写法,这一点没有太大影响,但对于习惯使用 的开发者来说,这是一个非常爽的体验。
主要体现在这两点:
#变量无需进行 return
标准组件模式下,setup 里定义的变量,需要 return 后,在 template 部分才可以正确拿到:
{{ msg }}
在 script-setup 模式下,你定义了就可以直接使用。
{{ msg }}
#子组件无需手动注册
子组件的挂载,在标准组件里的写法是需要 import 后再放到 components 里才能够启用:
在 script-setup 模式下,只需要导入组件即可,编译器会自动识别并启用。
#props 的接收方式变化
由于整个 script 都变成了一个大的 setup function ,没有了组件选项,也没有了 setup 入参,所以没办法和标准写法一样去接收 props 了。
这里需要使用一个全新的 API :defineProps
。
defineProps
是一个方法,内部返回一个对象,也就是挂载到这个组件上的所有 props ,它和普通的 props 用法一样,如果不指定为 prop, 则传下来的属性会被放到 attrs 那边去。
TIP
前置知识点:接收 props - 组件之间的通信。
#defineProps 的基础用法
所以,如果只是单纯在 template 里使用,那么其实就这么简单定义就可以了:
defineProps([
'name',
'userInfo',
'tags'
])
使用 string[]
数组作为入参,把 prop 的名称作为数组的 item 传给 defineProps
就可以了。
如果 script 里的方法要拿到 props 的值,你也可以使用字面量定义:
const props = defineProps([
'name',
'userInfo',
'tags'
])
console.log(props.name);
但在作为一个 Vue 老玩家,都清楚不显性的指定 prop 类型的话,很容易在协作中引起程序报错,那么应该如何对每个 prop 进行类型检查呢?
有两种方式来处理类型定义。
#通过构造函数检查 prop
这是第一种方式:使用 JavaScript 原生构造函数进行类型规定。
也就是跟我们平时定义 prop 类型时一样, Vue 会通过 instanceof
来进行 类型检查 (opens new window)。
使用这种方法,需要通过一个 “对象” 入参来传递给 defineProps
,比如:
defineProps({
name: String,
userInfo: Object,
tags: Array
});
所有原来 props 具备的校验机制,都可以适用,比如你除了要限制类型外,还想指定 name
是可选,并且带有一个默认值:
defineProps({
name: {
type: String,
required: false,
default: 'Petter'
},
userInfo: Object,
tags: Array
});
更多的 props 校验机制,可以点击 带有类型限制的 props 和 可选以及带有默认值的 props 了解更多。
#使用类型注解检查 prop
这是第二种方式:使用 TypeScript 的类型注解。
和 ref 等 API 的用法一样,defineProps
也是可以使用尖括号 <> 来包裹类型定义,紧跟在 API 后面,另外,由于 defineProps
返回的是一个对象(因为 props 本身是一个对象),所以尖括号里面的类型还要用大括号包裹,通过 key: value
的键值对形式表示,如:
defineProps<{ name: string }>();
注意到了吗?这里使用的类型,和第一种方法提到的指定类型时是不一样的。
TIP
在这里,不再使用构造函数校验,而是需要遵循使用 TypeScript 的类型。
比如字符串是 string
,而不是 String
。
如果有多个 prop ,就跟写 interface 一样:
defineProps<{
name: string;
phoneNumber: number;
userInfo: object;
tags: string[];
}>();
其中,举例里的 userInfo
是一个对象,你可以简单的指定为 object,也可以先定义好它对应的类型,再进行指定:
interface UserInfo {
id: number;
age: number;
}
defineProps<{
name: string;
userInfo: UserInfo;
}>();
如果你想对某个数据设置为可选,也是遵循 TS 规范,通过英文问号 ?
来允许可选:
// name 是可选
defineProps<{
name?: string;
tags: string[];
}>();
如果你想设置可选参数的默认值,需要借助 withDefaults API。
WARNING
需要强调的一点是:在 构造函数 和 类型注解 这两种校验方式只能二选一,不能同时使用,否则会引起程序报错
#withDefaults 的基础用法
这个新的 withDefaults API 可以让你在使用 TS 类型系统时,也可以指定 props 的默认值。
它接收两个入参:
参数 | 类型 | 含义 |
---|---|---|
props | object | 通过 defineProps 传入的 props |
defaultValues | object | 根据 props 的 key 传入默认值 |
可能缺乏一些官方描述,还是看参考用法可能更直观:
withDefaults(defineProps<{
size?: number
labels?: string[]
}>(), {
size: 3,
labels: () => ['default label']
})
如果你要在 TS / JS 再对 props 进行获取,也可以通过字面量来拿到这些默认值:
// 如果不习惯上面的写法,你也可以跟平时一样先通过interface定义一个类型接口
interface Props {
msg?: string
}
// 再作为入参传入
const props = withDefaults(defineProps(), {
msg: 'hello'
})
// 这样就可以通过props变量拿到需要的prop值了
console.log(props.msg)
#emits 的接收方式变化
和 props 一样,emits 的接收也是需要使用一个全新的 API 来操作,这个 API 就是 defineEmits
。
和 defineProps
一样, defineEmits
也是一个方法,它接受的入参格式和标准组件的要求是一致的。
TIP
注意:从3.1.3
版本开始,该 API 已被改名,加上了复数结尾,带有 s,在此版本之前是没有 s 结尾!
前置知识点:接收 emits - 组件之间的通信。
#defineEmits 的基础用法
由于 emit 并非提供给模板直接读取,所以需要通过字面量来定义 emits。
最基础的用法也是传递一个 string[]
数组进来,把每个 emit 的名称作为数组的 item 。
// 获取 emit
const emit = defineEmits(['chang-name']);
// 调用 emit
emit('chang-name', 'Tom');
由于 defineEmits
的用法和原来的 emits 选项差别不大,这里也不重复说明更多的诸如校验之类的用法了,可以查看 接收 emits 一节了解更多。
#attrs 的接收方式变化
attrs
和 props
很相似,也是基于父子通信的数据,如果父组件绑定下来的数据没有被指定为 props
,那么就会被挂到 attrs
这边来。
在标准组件里, attrs
的数据是通过 setup
的第二个入参 context
里的 attrs
API 获取的。
// 标准组件的写法
export default defineComponent({
setup (props, { attrs }) {
// attrs 是个对象,每个 Attribute 都是它的 key
console.log(attrs.class);
// 如果传下来的 Attribute 带有短横线,需要通过这种方式获取
console.log(attrs['data-hash']);
}
})
但和 props
一样,由于没有了 context
参数,需要使用一个新的 API 来拿到 attrs
数据。
这个 API 就是 useAttrs
。
TIP
请注意,useAttrs
API 需要 Vue3.1.4
或更高版本才可以使用。
#useAttrs 的基础用法
顾名思义, useAttrs 可以是用来获取 attrs 数据的,它的用法非常简单:
// 导入 useAttrs 组件
import { useAttrs } from 'vue'
// 获取 attrs
const attrs = useAttrs()
// attrs是个对象,和 props 一样,需要通过 key 来得到对应的单个 attr
console.log(attrs.msg);
对 attrs
不太了解的话,可以查阅 获取非 Prop 的 Attribute
#slots 的接收方式变化
slots
是 Vue 组件的插槽数据,也是在父子通信里的一个重要成员。
对于使用 template 的开发者来说,在 script-setup 里获取插槽数据并不困难,因为跟标准组件的写法是完全一样的,可以直接在 template 里使用
标签渲染。
但对使用 JSX / TSX 的开发者来说,就影响比较大了,在标准组件里,想在 script 里获取插槽数据,也是需要在 setup
的第二个入参里拿到 slots
API 。
// 标准组件的写法
export default defineComponent({
// 这里的 slots 就是插槽
setup (props, { slots }) {
// ...
}
})
新版本的 Vue 也提供了一个全新的 useSlots
API 来帮助 script-setup 用户获取插槽。
TIP
请注意,useSlots
API 需要 Vue3.1.4
或更高版本才可以使用。
#useSlots 的基础用法
先来看看父组件,父组件先为子组件传入插槽数据,支持 “默认插槽” 和 “命名插槽” :
I am a default slot from TSX.
I am a msg slot from TSX.
在使用 JSX / TSX 编写的子组件里,就可以通过 useSlots
来获取父组件传进来的 slots
数据进行渲染:
// 注意:这是一个 .tsx 文件
import { defineComponent, useSlots } from 'vue'
const ChildTSX = defineComponent({
setup() {
// 获取插槽数据
const slots = useSlots()
// 渲染组件
return () => (
{/* 渲染默认插槽 */}
{ slots.default ? slots.default() : '' }
{/* 渲染命名插槽 */}
{ slots.msg ? slots.msg() : '' }
)
},
})
export default ChildTSX
#ref 的通信方式变化
在标准组件写法里,子组件的数据都是默认隐式暴露给父组件的,也就是父组件可以通过 childComponent.value.foo
这样的方式直接操作子组件的数据(参见:DOM 元素与子组件 - 响应式 API 之 ref)。
但在 script-setup 模式下,所有数据只是默认隐式 return 给 template 使用,不会暴露到组件外,所以父组件是无法直接通过挂载 ref 变量获取子组件的数据。
在 script-setup 模式下,如果要调用子组件的数据,需要先在子组件显示的暴露出来,才能够正确的拿到,这个操作,就是由 defineExpose
来完成。
#defineExpose 的基础用法
defineExpose
的用法非常简单,它本身是一个函数,可以接受一个对象参数。
在子组件里,像这样把需要暴露出去的数据通过 key: value
的形式作为入参(下面的例子是用到了 ES6 的 属性的简洁表示法 (opens new window)):
然后你在父组件就可以通过挂载在子组件上的 ref 变量,去拿到暴露出来的数据了。
#顶级 await 的支持
在 script-setup 模式下,不必再配合 async 就可以直接使用 await 了,这种情况下,组件的 setup 会自动变成 async setup 。
它转换成标准组件的写法就是:
点赞加关注,永远不迷路
每天一更新,创作拿命拼