- A+
简介
<script setup>
语法糖并不是新增的功能模块,它只是简化了以往的组合API(compositionApi)
的必须返回(return)
的写法,并且有更好的运行时性能。
在 setup 函数中:所有 ES 模块导出都被认为是暴露给上下文的值,并包含在 setup()
返回对象中。相对于之前的写法,使用后,语法也变得更简单。
你不必担心setup语法糖
的学习成本,他是组合式API的简化,并没有新增的知识点。你只需要了解一些用法和细微的不同之处,甚至比之前写setup()
还要顺手!
使用方式极其简单,仅需要在 script 标签加上 setup 关键字即可。示例:
<script setup> </script>
注:因为setup语法糖是vue3.2正式确定下来的议案,所以vue3.2的版本是真正适合setup语法糖的版本。
1. 属性和方法无需返回,直接使用
以前使用响应式数据是:
<template> {{msg}} </template> <script> import { ref } from 'vue' export default { setup () { const msg = ref('hello vue3'); return { msg } } } </script>
现在使用 setup 语法糖,不需要return返回
和 setup函数
,只需要全部定义在<script setup>
内即可:
<template> {{msg}} </template> <script setup> import { ref } from 'vue' const msg = ref('hello vue3'); </script>
reactive
, computed
, 也一样可以使用:
<template> <div>{{msg}}</div> <div>{{obj.a}}</div> <div>{{sum}}</div> </template> <script setup> import { ref, reactive, computed } from 'vue' const msg = ref('hello vue3'); const obj = reactive({ a: 1, b: 2 }) const sum = computed(() => { return obj.a + 3; }); </script>
2. 组件自动注册
在 script setup 中,引入的组件可以直接使用,无需再通过components进行注册,并且无法指定当前组件的名字,它会自动以文件名为主,也就是不用再写name属性了。示例:
<template> <Child /> </template> <script setup> import Child from '@/components/Child.vue' </script>
3. 组件数据传递(props和emits)
props
和 emits
在语法糖中使用 defineEmits
和 defineProps
方法来使用:
子组件 Child.vue:
<template> <div @click="toEmits">Child Components</div> </template> <script setup> // defineEmits,defineProps无需导入,直接使用 const emits = defineEmits(['getChild']); const props = defineProps({ title: { type: String, defaule: 'defaule title' } }); const toEmits = () => { emits('getChild', 'child value') // 向父组件传递数据 } // 获取父组件传递过来的数据 console.log(props.title); // parent value </script>
父组件 Home.vue:
<template> <Child @getChild="getChild" :title="msg" /> </template> <script setup> import { ref } from 'vue' import Child from '@/components/Child.vue' const msg = ref('parent value') const getChild = (e) => { // 接收父组件传递过来的数据 console.log(e); // child value } </script>
4. 获取 slots 和 attrs
可以通过useContext从上下文中获取 slots 和 attrs。不过提案在正式通过后,废除了这个语法,被拆分成了useAttrs和useSlots。示例:
// 旧 <script setup> import { useContext } from 'vue' const { slots, attrs } = useContext() </script> // 新 <script setup> import { useAttrs, useSlots } from 'vue' const slots = useSlots(); const attrs = useAttrs(); console.log(attrs.dataId); // 查看父组件传来的自定义属性 </script>
5. 对外暴露属性(defineExpose)
<script setup>
的组件默认不会对外部暴露任何内部声明的属性。
如果有部分属性要暴露出去,可以使用 defineExpose
子组件 Child.vue:
<template> {{msg}} </template> <script setup> import { ref } from 'vue' let msg = ref("Child Components"); let num = ref(123); // defineExpose无需导入,直接使用 defineExpose({ msg, num }); </script>
父组件 Home.vue:
<template> <Child ref="child" /> </template> <script setup> import { ref, onMounted } from 'vue' import Child from '@/components/Child.vue' let child = ref(null); onMounted(() => { console.log(child.value.msg); // Child Components console.log(child.value.num); // 123 }) </script>