Vue3 – props

props

• 用于接收父组件传递的值

• 在使用 <script setup> 的单文件组件中，props 可以使用 defineProps() 宏来声明：

<script setup>
const props=defineProps(['foo'])
console.log(props.foo)
</script>

• 在没有使用 <script setup> 的组件中，prop 可以使用 props 选项来声明（和vue2一致）：

export default {
props: ['foo'],
setup(props) {
// setup() 接收 props 作为第一个参数
console.log(props.foo)
}
}

• 传递给 defineProps() 的参数和提供给 props 选项的值是相同的，两种声明方式背后其实使用的都是 prop 选项。

• 除了使用字符串数组来声明 prop 外，还可以使用对象的形式，如下：

对传入的props的几种校验方式

// 使用 <script setup>
defineProps({
title: String, // 属性名: 其对应的数据类型
likes: Number,
propB: [String, Number], // propB可以是字符串或者数字类型的一种
propC: { // 更加详细的定义
type: String, // 类型
required: true// 是否必传
},
// Number 类型的默认值
propD: {
type: Number, // 类型
default: 100// 指定默认值
},
// 对象类型的默认值
propE: {
type: Object, // 类型
// 对象或数组的默认值
// 必须从一个工厂函数返回。
// 该函数接收组件所接收到的原始 prop 作为参数。
default(rawProps) {
return { message: 'hello' } // 对象默认值
}
},
// 函数类型的默认值
propG: {
type: Function, // 类型
// 不像对象或数组的默认，这不是一个工厂函数。这会是一个用来作为默认值的函数
default() { // 这个直接就是一个默认函数
return'Default function'
}
}
})
// 非 <script setup>
export default {
props: {
title: String,
likes: Number
}
}

细节总结：

1. 所有prop默认都是可选的，可传可不传，如果声明了required: true，则该属性就是必须传的，否则警告

2. 除 Boolean 外的未传递的可选 prop 将会有一个默认值 undefined。

3. 布尔类型的数据未传递时prop将被转换未false，可以通过为它设置default来更改，比如说设置default：undefined与非布尔值的数据默认值相一致

传递prop的几个细节：

1. prop的名字很长的话，应该使用小驼峰（camelCase ）的形式，在传递时可以使用烤肉串（kebab-case）方式进行传递

// 父组件
// 传递 烤肉串方式，为了和html attribute对齐
<MyComponent greeting-message="hello"/>
​
// 子组件
defineProps({
greetingMessage: String // 通过小驼峰的方式接收
})
​
// 使用方面也是小驼峰的方式
<span>{{ greetingMessage }}</span>

2. 传递数据有两种，静态和动态

• 所谓静态就是，数据直接就是死的，例如

<component-one title="爱你孤身走暗巷"></component-one> // 直接传递一个字符串

• 动态就是先定义再传

<component-one :title="title"></component-one> // 通过v-bind或者:动态绑定
​
<script setup>
import ComponentOne from '../src/components/zujianup/ComponentOne.vue'
import { ref } from'vue'
const title=ref('123')
</script>

3. 不同值类型的传递

• Number

<BlogPost :likes="42"/>
<BlogPost :likes="post.likes"/>

• Boolean

<BlogPost is-published/> // 如果传递的数据是true时，可以直接写传递的属性名即可
<BlogPost :is-published="false"/> // 传递的false需要书写完整
<BlogPost :is-published="post.isPublished"/> // 传递已经定义的值

• Array

<BlogPost :comment-ids="[234, 266, 273]"/> // 直接传递一个数组
<BlogPost :comment-ids="post.commentIds"/> // 传递一个存在的数组

• Object

// 和数组类似，不多做解释了
<BlogPost
:author="{
name: 'Veronica',
company: 'Veridian Dynamics'
}"
/>
<!-- 根据一个变量的值动态传入 -->
<BlogPost :author="post.author"/>

• 使用一个对象绑定多个prop

// 定义
const post = {
id: 1,
title: 'My Journey with Vue'
}
// 传递
<component-one v-bind="post"></component-one> // 直接v-bind传递
// 相当于
<component-one :id="post.id" :title="post.title"></component-one>
// 子组件接收 -- 分开声明，不能直接定义一个post: Oject
const props = defineProps({
id: Number,
title: {
type: String,
required: true
}
})

单项数据流

• props传递的数据是只读的，不可修改，否则后台会警告

• 单项数据流的本意就是当父组件更新后，子组件的props也会跟着获取最新的值，不能去修改，如果去更改会警告

• 对于复杂数据类型而言，虽然可以更改并且也不会警告，但也不建议这样去做

• 这其实卡了复杂数据类型地址不变的bug，虽然可以，但也有很大的性能损耗，得不偿失