vue3.3 版本新特性总结 defineOptions、defineModel、defineSlots、defineEmits

新特性主要围绕着父子组件之间的相关的功能更新。

本文主要以代码展示的风格来介绍功能。大家可以直接搞个父子组件,把对应代码复制粘贴进去,然后一个个试验即可。自己也动动手,加深理解。
除了标题的4个宏指令,还有 toRef 和 toValue,但让我挺无语的。。感觉没啥用,求指教。。


以下案例包含的vue3.3新内容:

defineOptions、defineModel、defineSlots、defineEmits、toRef、toValue

html 复制代码
<template>
  <div>
    <div>父组件</div>
    <div>vue3.3新特性</div>
    <div>
      <child @test1="test1" v-model:inputName.animation="data1">
        <template #default='{ msg, num }'>{{ msg }}---slot文本---{{ num }}</template>
      </child>
    </div>
  </div>
</template>
<script setup lang="ts">
import { ref,watch } from "vue";
import child from "./child.vue";
const data1 = ref(undefined)
// const data1 = ref('')
watch(data1,(val)=>{
  console.log(val,'监听是否变化');
})
setTimeout(() => {
  data1.value = '肥伦'
  console.log('变更数据',data1.value);
}, 1000);

function test1(val1, val2) {
  console.log(val1, val2);
}
</script>
<style lang="">
  
</style>
html 复制代码
<template>
  <div>
    <div>子组件</div>
    <div><input type="text" v-model="modelValue"></div>
    <button @click="c1">子组件测试按钮</button>
    <slot msg="传给父的信息" :num="1234">1</slot>
    <div>{{ dd1 }}</div>
    <div>{{ dd2 }}</div>
    <div>{{ dd3 }}</div>
  </div>
</template>
<script setup lang="ts">
import { ref, reactive, toRef, toValue, toRaw, unref,isReactive } from 'vue'
const state = reactive({
  foo: 1,
  bar: 2
})

const fooRef = toRef(() => state.foo) // 新特性: 创建一个只读的 ref; 仅限于不能修改 fooRef.value; 若 .value 是个对象,对象里面还是可以随便改的。

const dd2 = ref(1)
const dd1 = toRef(dd2) // // 按原样返回现有的 ref
// console.log(dd1===dd2); // true; 

const dd3 = toRef(1) // 等价于 ref(1)


// toValue; 跟 unref 、 toRaw 类似; 
// 首先 toValue 和 unref 都针对 ref 类型的响应式数据, toRaw 针对 reactive 类型的响应式数据; 
// 这3个用的时候,如果传的数据不符合,则直接返回所传的数据;
// 这个就懒得写示例了。。因为觉得没啥用啊,求指教...


// defineOptions
// 这个宏可以用来直接在 <script setup> 中声明组件选项,而不必使用单独的 <script> 块:
// 在两年前我看官方文档对着各个API敲案例的时候,那会如果要用到 name、inheritAttrs 还得声明2个script,现在都不用了,物是人非哈哈
defineOptions({
  name: 'thiscpmName', // 像递归组件要用到组件名的时候,就可以显示声明了
  inheritAttrs: true, // 涉及绑定属性的继承之类
  mounted() {
    console.log('牛头人啊。。真有用啊?');
  },
})


// defineModel 是 props + emit 的语法糖, defineModel就只建议用运行时声明的写法了!
// defineModel([name], [prop])的参数说明
/**
 * name 和 prop 选项都不是必填。
 */
/**
 * prop {} 参数详解
 * {
 *    type: String // 表示vmodel绑定的值类型,不符合控制台抛出警告。
 *    default: '芙莉莲' // 当父组件vmodel传入的是 undefine 将使用该默认值。
 *    set: function // 修改该 model 时触发
 *    get: function // 访问该 model 时触发
 * }
 */

// const modelValue = defineModel() // 写法1,子组件这里等价于props.modelValue + update:modelValue ;(由父组件通过 v-model 使用)
// const modelValue = defineModel({ type: String,default:'芙莉莲' }) // 写法1的基础上,设置model的功能选项。
// const modelValue = defineModel('inputName') // 写法2,子组件这里等价于props.inputName + update:inputName ;(由父组件通过 v-model:inputName 使用)
// const modelValue = defineModel('inputName', { type: String, default: '芙莉莲' }) // 写法2的基础上,声明 prop 选项
// ↓ 写法3,如果v-model声明了修饰符,则需要通过解构返回值的方式获取;
const [modelValue, modelModifiers] = defineModel('inputName', {
  type: String,
  default: '芙莉莲',
  set(val) {
    if (modelModifiers.animation) {
      return val.trim()
    }
    return val
  },
  // get(val){
  //   return val
  // }
})
console.log(modelValue.value, modelModifiers);
// modelValue 在被修改时,触发 "update:inputName" 事件; 不声明model的name时,则是默认的 update:modelValue
// 总结就是根本不用管他是 update:xxx 什么玩意,这部分不重要,因为defineModel写法下,你不需要自己去调用了!
setTimeout(() => {
  // emit('update:inputName','测试有用吗') 
  // 如果你非要自己手动调用,也是可以的!但会报TS错,因为emit没有声明该类型,解决方法就是你去声明一下就好了。
  // 但是最终还不如 modelValue.value = xx 的方式去修改更好! 
  modelValue.value = '测试更改有效的!'
}, 5000);



// 特别注意,使用对应版本的新特性时,如果遇到TS报错、实际能跑的情况下,请所有更新相关版本!(查了下官网里说的对应的版本信息)
// 不然就会像我,旧的VUE3练习项目是2年前的,看到报错还以为VUE有问题。。
const emit = defineEmits<{
  test1: [id: number, val?: string] // key是事件名,val是传输数据的数据类型、数量
  bar: [name: string, ...rest: number[]]
}>();
function c1() {
  emit('test1', 1)
}



// defineSlots() 只接受类型参数,没有运行时参数。
// 函数的第一个TS对象类型参数是插槽期望接收的 props 的TS类型
// 返回值类型目前被忽略,可以是 any,但官方说将来可能会利用它来检查插槽内容。
const slots = defineSlots<{
  // key > default 是插槽名称
  // 值类型是插槽函数,props就是作用域插槽声明的传递的数据
  default(props: { msg: string, num: number }): any
}>()
</script>
<style lang="">
  
</style>
相关推荐
正小安4 分钟前
Vite系列课程 | 11. Vite 配置文件中 CSS 配置(Modules 模块化篇)
前端·vite
编程百晓君25 分钟前
一文解释清楚OpenHarmony面向全场景的分布式操作系统
vue.js
暴富的Tdy32 分钟前
【CryptoJS库AES加密】
前端·javascript·vue.js
neeef_se33 分钟前
Vue中使用a标签下载静态资源文件(比如excel、pdf等),纯前端操作
前端·vue.js·excel
m0_7482356139 分钟前
web 渗透学习指南——初学者防入狱篇
前端
℘团子এ39 分钟前
js和html中,将Excel文件渲染在页面上
javascript·html·excel
z千鑫1 小时前
【前端】入门指南:Vue中使用Node.js进行数据库CRUD操作的详细步骤
前端·vue.js·node.js
m0_748250742 小时前
Web入门常用标签、属性、属性值
前端
m0_748230442 小时前
SSE(Server-Sent Events)返回n ,前端接收数据时被错误的截断【如何避免SSE消息中的换行符或回车符被解释为事件消息的结束】
前端