说到 props 就不得不提到「单向数据流」,单向数据流是一种组件化中的数据流向的规范,数据总是从父组件流向子组件,这遵循了子组件不能更改父组件流入的数据,这个数据就是 props !

子组件为什么不可以更改 props 呢?
这是因为如果某个数据属于父组件定义的(父组件传递给子组件的是一个数据的副本,尤其是引用数据的时候),当子组件去更改父组件传递来的 props ,首先父组件的数据将会受到影响,其次这会导致概念上的越权,且不符合权限上的规范。
另外当父组件内包含很多子组件的时候,父组件是不知道哪个子组件更改 data 中的数据,这会造成很大的维护的成本!

props 基本传递

当父组件调用子组件的时候,可以给子组件传递任意数量、任意类型的数据:

  1. <template>
  2. <div>
  3. <!-- 默认传递的都是字符串类型 -->
  4. <my-test num="1" arr="[1,2,3,4,5]" />
  5. </div>
  6. </template>

子组件只需要通过 props 属性注册一下父组件传递来的数据即可,这样子组件才知道哪些是外部传递来的数据:

  1. <template>
  2. <div>
  3. {{ num }}
  4. {{ arr }}
  5. </div>
  6. </template>
  7. <script>
  8. export default{
  9. name:"MyTest",
  10. props: ['num','arr']
  11. }
  12. </script>

如果你想传递特定的数据类型,需要使用 v-bind 或者 : 进行动态绑定:

  1. <template>
  2. <div>
  3. <my-test v-bind:num="1" :arr="[1,2,3,4,5]" :str="'123'" />
  4. </div>
  5. </template>

此时,引号内部传递的就是 JS 表达式,而不再是一个普通的字符串!

或者你也可以传递 data 中的数据:

  1. <template>
  2. <div>
  3. <my-test :num="num" :arr="arr" :str="str" />
  4. </div>
  5. </template>
  6. <script>
  7. import MyTest from "./components/MyTest.vue";
  8. export default{
  9. name:"App",
  10. components:{
  11. MyTest
  12. },
  13. data(){
  14. return{
  15. num: 1,
  16. arr: [1, 2, 4],
  17. str: "123"
  18. }
  19. }
  20. }
  21. </script>

如果你想一次性传递多个属性,你可以使用 v-bind 指令批量传递:

  1. <template>
  2. <div>
  3. <my-test v-bind="obj" />
  4. <!-- 等同于 -->
  5. <!-- <my-test :a="obj.a" :b="obj.b" /> -->
  6. </div>
  7. </template>
  8. <script>
  9. import MyTest from "./components/MyTest.vue";
  10. export default{
  11. name:"App",
  12. components:{
  13. MyTest
  14. },
  15. data(){
  16. return{
  17. obj: {
  18. a: 1,
  19. b: 2
  20. }
  21. }
  22. }
  23. }
  24. </script>
  1. <template>
  2. <div>
  3. {{ a }}
  4. {{ b }}
  5. </div>
  6. </template>
  7. <script>
  8. export default{
  9. name:"MyTest",
  10. props: ['a','b']
  11. }
  12. </script>

当父组件传递数据后,子组件可用通过props: [xxx]的方式来进行接收注册,但是通过数组的方式,子组件无法验证父组件传递来的数据是否符合类型要求,Vue 支持把 props 改为一个对象的方式来进行注册属性:

  1. <template>
  2. <div>
  3. {{ a }}
  4. {{ b }}
  5. </div>
  6. </template>
  7. <script>
  8. import MyTest from "./components/MyTest.vue";
  9. export default{
  10. name:"App",
  11. components:{
  12. MyTest
  13. },
  14. props: {
  15. num: Number,
  16. arr: Array,
  17. str: String,
  18. bool: Boolean,
  19. obj: Object,
  20. setNum: Function
  21. }
  22. };
  23. </script>

当父组件传递的数据不符合 props 的类型要求时,将抛出一个警告:

  1. <template>
  2. <div>
  3. <!-- 子组件验证 num 为 Number 类型 -->
  4. <my-test :num="{}" />
  5. </div>
  6. </template>
  7. <script>
  8. import MyTest from "./components/MyTest.vue";
  9. export default{
  10. name:"App",
  11. components:{
  12. MyTest
  13. },
  14. data(){
  15. return{
  16. obj: {
  17. a: 1,
  18. b: 2
  19. }
  20. }
  21. }
  22. }
  23. </script>

Xnip2023-05-15_15-45-39.jpg
Vue 之所以抛出警告,而不是错误是因为类型校验本身就是方便开发者去检查类型是否符合要求。

当你不确定一个数据是什么类型的时候,你可以使用数组来指定props.x为多种类型:

  1. <script>
  2. import MyTest from "./components/MyTest.vue";
  3. export default{
  4. name:"App",
  5. components:{
  6. MyTest
  7. },
  8. props: {
  9. title: String,
  10. isRecom: Boolean,
  11. status: [String, Number],
  12. author: Object,
  13. content: String,
  14. commentCount: Number,
  15. comments: Array
  16. }
  17. };
  18. </script>

你可能注意到setNum属性是一个函数类型,是的,这是容许的!

  1. <template>
  2. <div>
  3. <!-- setNum 为 Function 类型 -->
  4. <my-test setNum="setNum" />
  5. </div>
  6. </template>
  7. <script>
  8. import MyTest from "./components/MyTest.vue";
  9. export default{
  10. name:"App",
  11. components:{
  12. MyTest
  13. },
  14. methods:{
  15. setNum(){
  16. console.log("Parent component function is call!")
  17. }
  18. }
  19. }
  20. </script>
  1. <template>
  2. <!-- 点击的时候会正常执行父组件中的 setNum 方法 -->
  3. <button @click="setNum">Click btn</button>
  4. </template>
  5. <script>
  6. export default {
  7. name: "MyTest",
  8. props: {
  9. setNum: Function
  10. }
  11. };
  12. </script>

实际上,props.x的类型是相应类型的构造函数,所以我们可以自定一个构造函数,让 Vue 进行校验:

  1. <template>
  2. <!-- 传递一个类型为 Demo 的对象 -->
  3. <my-test :demo="new Demo()" />
  4. </template>
  5. <script>
  6. import { Demo } from "./myFunction.js";
  7. import MyTest from "./components/MyTest.vue";
  8. export default{
  9. name:"App",
  10. components:{
  11. MyTest
  12. },
  13. methods:{
  14. Demo
  15. }
  16. }
  17. </script>
  1. <template>
  2. {{ demo }}
  3. </template>
  4. <script>
  5. import { Demo } from "../myFunction.js";
  6. export default {
  7. name: "MyTest",
  8. props: {
  9. demo: Demo // 这将正常通过校验
  10. }
  11. };
  12. </script>

深入 props 的应用

props 也可以设置默认值,当父组件没有传递对应属性的时候生效:

  1. <template>
  2. <div>
  3. {{ num }}
  4. </div>
  5. </template>
  6. <script>
  7. export default {
  8. name: "MyTest",
  9. props: {
  10. // 通过对象的形式进行表达
  11. num: {
  12. type: Number,
  13. default: 100
  14. }
  15. }
  16. };
  17. </script>

:::warning ⚠️ 注意
如果声明了 default 值,那么在 prop 的值被解析为 undefined 时,无论 prop 是未被传递还是显式指明的 undefined,都会改为 default 值。 :::

如果你需要给一个对象设置默认值,应该通过函数返回一个对象,这和组件内 data 返回一个对象道理是一致的:

  1. <script>
  2. export default {
  3. name: "MyTest",
  4. props: {
  5. article: {
  6. type: Object,
  7. default: ()=>({})
  8. }
  9. }
  10. };
  11. </script>

但是当时类型为函数的时候,默认值却不同!当类型为函数的时候,default 的值将作为函数的默认值:

  1. <template>
  2. <!-- 点击按钮就会打印 'Default function' -->
  3. <button @click="setNum">Click btn</button>
  4. </template>
  5. <script>
  6. export default {
  7. name: "MyTest",
  8. props: {
  9. setNum:{
  10. type: Function,
  11. // 不像对象或数组的默认,这不是一个工厂函数。
  12. // 这会是一个用来作为默认值的函数
  13. default() {
  14. return 'Default function'
  15. }
  16. }
  17. }
  18. };
  19. </script>

Vue 对 props 的书写并没有特别严格的规范要求,但是 Vue 推荐父组件传递的数据时候要使用-进行分割连接:

  1. <template>
  2. <my-test :set-num="setNum" />
  3. </template>
  4. <script>
  5. import MyTest from "./components/MyTest.vue";
  6. export default{
  7. name:"App",
  8. components:{
  9. MyTest
  10. },
  11. methods:{
  12. setNum(){
  13. console.log("Parent component function is call!")
  14. }
  15. }
  16. }
  17. </script>

在字符串模版中(或者 SFC 文件中),传递的属性名setNum所以不会报错,但是 Vue 的组件都是以 Web Components 为标准的,它本身也是符合 XHTML 规范的,所以推荐使用-进行分割,而子组件注册属性的时候可以使用驼峰的写法,因为注册的时候使用的是 JS 的逻辑:

  1. <script>
  2. export default {
  3. name: "MyTest",
  4. props: {
  5. setNum: Function
  6. }
  7. };
  8. </script>

另外因为 Vue 单向数据流的限制,每次父组件更新后,所有的子组件中的 props 都会被更新到最新值,这意味着你不应该在子组件中去更改一个 prop。若你这么做了,Vue 会在控制台上向你抛出警告:

  1. <script>
  2. export default {
  3. name: "MyTest",
  4. props: {
  5. num: Number
  6. },
  7. created() {
  8. // 错误!prop 是只读的!
  9. this.num++
  10. }
  11. };
  12. </script>

如果你想要更改一个 prop 的需求通常来源于以下两种场景:

  1. prop 被用于传入初始值;而子组件想在之后将其作为一个局部数据属性。在这种情况下,最好是新定义一个局部数据属性,从 props 上获取初始值即可:

    1. <script>
    2. export default {
    3. name: "MyTest",
    4. props: {
    5. num: Number
    6. },
    7. data() {
    8. return {
    9. superNum: this.num
    10. }
    11. };
    12. </script>
  2. 需要对传入的 prop 值做进一步的转换。在这种情况中,最好是基于该 prop 值定义一个计算属性:

    1. <script>
    2. export default {
    3. name: "MyTest",
    4. props: {
    5. num: Number
    6. },
    7. computed: {
    8. // 该 prop 变更时计算属性也会自动更新
    9. normalizedSize() {
    10. return this.num * 100;
    11. }
    12. }
    13. </script>

props 校验

上面我们说了可以给 props 加上类型校验,如果父组件传递的值不满足类型要求将抛出警告,但是undefinednull这两个值比较特殊:

  1. <template>
  2. <!-- 这将不会产生警告 -->
  3. <my-test :title="title" :content="content" />
  4. </template>
  5. <script>
  6. import MyTest from "./components/MyTest.vue";
  7. export default{
  8. name:"App",
  9. components:{
  10. MyTest
  11. },
  12. data(){
  13. return{
  14. title: undefined,
  15. content: null
  16. }
  17. }
  18. }
  19. </script>
  1. <script>
  2. export default {
  3. name: "MyTest",
  4. props:{
  5. title: String,
  6. content: String
  7. }
  8. }
  9. </script>

undefindnull可以通过任意的数据类型检查,这是因为传递的数据或者是由接口动态返回的,数据到底返回什么是不明确的,但是它本身确实是 String 类型,如果类型检查不通过,这可能会导致程序无法正常运行,但是这并不是程序的 bug,只是程序运行的一种现象!

另外,props 还可以配置某个属性为必传:

  1. <script>
  2. export default {
  3. name: "MyTest",
  4. props:{
  5. // 必传,且为 Strign 类型
  6. title: {
  7. type:String,
  8. required: true
  9. },
  10. }
  11. }
  12. </script>

props 还可以编写自定义验证函数:

  1. <script>
  2. export default {
  3. name: "MyButton",
  4. props: {
  5. btnType: {
  6. required: true,
  7. // 自定义验证函数
  8. validator(value) {
  9. // 如果不传递 btnType , validator 就不会执行
  10. console.log(value);
  11. // 如果值不在数组中将抛出警告
  12. return ["primary", "danger", "warning", "success"].includes(value);
  13. }
  14. }
  15. }
  16. };
  17. </script>

:::warning ⚠️ 注意
props.*.validator验证是在当前组件实例创建之前参数的,所以你不能使用 data、computed 中的数据!!! :::