vue组件之属性Props

组件的属性和事件

父子组件之间的通信

父子组件之间的通信就是 props down,events up,父组件通过 属性 props 向下传递数据给子组件,子组件通过 事件 events 给父组件发送消息。
比如,子组件需要某个数据,就在内部定义一个 prop 属性,然后父组件就像给 html 元素指定特性值一样,把自己的 data 属性传递给子组件的这个属性。
而当子组件内部发生了什么事情的时候,就通过自定义事件来把这个事情涉及到的数据暴露出来,供父组件处理。

<my-component v-bind:foo="baz" v-on:event-a="doThis(arg1,...arg2)"></my-component>

如上代码,

  • foo 是组件内部定义的一个 prop 属性,baz 是父组件的一个 data 属性,
  • event-a 是子组件定义的一个事件,doThis 是父组件的一个方法

过程就是这样:

  • 父组件把 baz 数据通过 prop 传递给子组件的 foo;
  • 子组件内部得到 foo 的值,就可以进行相应的操作;
  • 当子组件内部发生了一些变化,希望父组件能知道时,就利用代码触发 event-a 事件,把一些数据发送出去
  • 父组件把这个事件处理器绑定为 doThis 方法,子组件发送的数据,就作为 doThis 方法的参数被传进来
  • 然后父组件就可以根据这些数据,进行相应的操作
属性 Props

Vue 组件通过 props 属性来声明一个自己的属性,然后父组件就可以往里面传递数据。

Vue.component('mycomponent',{
    template: '<div> 这是一个自定义组件, 父组件传给我的内容是:{{myMessage}}</div>',
    props: ['myMessage'],
    data () {
      return {
        message: 'hello world'
      }
    }
  })

然后调用该组件

注意,由于 HTML 特性是不区分大小写的,所以传递属性值时,myMessage 应该转换成 kebab-case (短横线隔开式)my-message="hello"。

<div id="app">
    <mycomponent my-message="hello"></mycomponent>
</div>
v-bind 绑定属性值

v-bind 绑定属性值的一个特性:一般情况下,使用 v-bind 给元素特性 (attribute) 传递值时,Vue 会将 "" 中的内容当做一个表达式。

//比如
<div attr="message">hello</div>

上面这样,div 元素的 attr 特性值就是 message。

<div v-bind:attr="message">hello</div>

这里的 message 应该是 Vue 实例的 data 的一个属性,这样 div 元素的 attr 特性值就是 message 这个属性的值。

之所以说是一般情况,是因为 class 和 style 特性并不是这样。用 v-bind:class 和 class 传入正常的类名,效果是一样的,因为对于这两个特性,Vue 采用了合并而不是替换的原则。

动态绑定特性值

根据上面,想要把父组件的属性绑定到子组件,应该使用 v-bind,这样,父组件中数据改变时能反映到子组件。
注意,根据父组件传递给子组件的属性类型的不同,当在子组件中更改这个属性时,会有以下两种情况:

  • 当父组件传递的属性是引用类型时,在子组件中更改相应的属性会导致父组件相应属性的更改。
<div id="app">
     <div>这是父组件的parentArray:{{parentArray}}</div>
     <my-component :child-array="parentArray"></my-component>
   </div>
   <script>
     Vue.component('my-component', {
       template: `
       <div> 这是接收了父组件传递值的子组件的 childArray: {{childArray}} <br>
           <button type="button" @click="changeArray">
           点击我改变父元素的 parentArray</button>
         </div>`,
       props: ['childArray'],
       data () {
         return {
           counter: 1
         }
       },
       methods: {changeArray () {
           this.childArray.push(this.counter++)}}
     })
     new Vue({
       el: '#app',
       data: {
         parentArray: []}
     })
   </script>

点击结果

当父组件传递值为基本类型时,在子组件中更改这个属性会报错。正确的做法是,在父组件中绑定属性值时,加上.sync 修饰符。

  <div id="app2">
        <div>这是父组件的parentArray:{{parent}}</div>
        <my-component-sync :child.sync="parent"></my-component-sync>
<span class="hljs-tag">&lt;/<span class="hljs-name">div</span>&gt;</span>
<span class="hljs-tag">&lt;<span class="hljs-name">script</span> <span class="hljs-attr">src</span>=<span class="hljs-string">"https://cdn.jsdelivr.net/npm/vue"</span>&gt;</span><span class="hljs-tag">&lt;/<span class="hljs-name">script</span>&gt;</span>
<span class="hljs-tag">&lt;<span class="hljs-name">script</span>&gt;</span><span class="language-javascript">
    <span class="hljs-title class_">Vue</span>.<span class="hljs-title function_">component</span>(<span class="hljs-string">'myComponentSync'</span>, {
        <span class="hljs-attr">template</span>: <span class="hljs-string">`&lt;div&gt;这是接收了父组件传递值的子组件的child: {{child}} &lt;br&gt;
          &lt;button type="button" @click="change"&gt;
          点击我改变父元素的parent&lt;/button&gt;
        &lt;/div&gt;`</span>,
        <span class="hljs-attr">props</span>: [<span class="hljs-string">'child'</span>],
        <span class="hljs-title function_">data</span>(<span class="hljs-params"></span>) {
            <span class="hljs-keyword">return</span> {
                <span class="hljs-attr">counter</span>: <span class="hljs-variable language_">this</span>.<span class="hljs-property">child</span>
            }
        },
        <span class="hljs-attr">methods</span>: {
            <span class="hljs-title function_">change</span>(<span class="hljs-params"></span>) {
                <span class="hljs-variable language_">this</span>.<span class="hljs-property">counter</span>++
                <span class="hljs-variable language_">this</span>.$emit(<span class="hljs-string">'update:child'</span>, <span class="hljs-variable language_">this</span>.<span class="hljs-property">counter</span>)
            }
        }
    })
    <span class="hljs-keyword">new</span> <span class="hljs-title class_">Vue</span>({
        <span class="hljs-attr">el</span>: <span class="hljs-string">'#app2'</span>,
        <span class="hljs-attr">data</span>: {
            <span class="hljs-attr">parent</span>: <span class="hljs-number">0</span>
        }
    })
</span><span class="hljs-tag">&lt;/<span class="hljs-name">script</span>&gt;</span>

点击结果如下图,去掉无法改变

子组件希望对传入的 prop 进行操作

一般来说,是不建议在子组件中对父组件中传递来的属性进行操作的。如果真的有这种需求, 可以这样:

  1. 父组件传递了一个基本类型值,那么可以在子组件中创建一个新的属性,并以传递进来的值进行初始化,之后就可以操作这个新的属性了
props: ['initialCounter'],
data: function () {
  return { counter: this.initialCounter }
}
  1. 父组件传递了一个引用类型值,为了避免更改父组件中相应的数据,最好是对引用类型进行复制。复杂的情况,肯定应该是深复制。
给子组件传递正确类型的值

同样是上面的原因,静态的给子组件的特性传递值,它都会把他当做一个字符串。

<!-- 传递了一个字符串 "1" -->
<comp some-prop="1"></comp>

子组件中,特性的值是字符串 "1" 而不是 number 1。如果想传递正确的数值,应该使用 v-bind 传递,这样就能把传递的值当做一个表达式来处理,而不是字符串。

<!-- 传递实际的 number 1 -->
<comp v-bind:some-prop="1"></comp>
Prop 验证

我们可以给组件的 props 属性添加验证,当传入的数据不符合要求时,Vue 会发出警告。

Vue.component('myComponent', {
  props: {
    // 基础类型检测 (`null` 意思是任何类型都可以)
    propA: Number,
    // 多种类型
    propB: [String, Number],
    // 必传且是字符串
    propC: {
      type: String,
      required: true
    },
    // 数字,有默认值
    propD: {
      type: Number,
      default: 100
    },
    // 数组 / 对象的默认值应当由一个工厂函数返回
    propE: {
      type: Object,
      default: function () {
        return { message: 'hello' }
      }
    },
    // 自定义验证函数
    propF: {
      validator: function (value) {
        return value > 10
      }
    }
  }
})

type 可以是下面原生构造器:

  • String
  • Number
  • Boolean
  • Function
  • Object
  • Array
  • Symbol
    type 也可以是一个自定义构造器函数,使用 instanceof 检测。
// 自定义 Person 构造器
 function Person(name, age) {
    this.name = name
    this.age = age
  }
  Vue.component('my-component', {
    template: `<div> 名字: {{person-prop.name}}, 年龄: {{person-prop.age}} </div>`,
    props: {
      person-prop: {
        type: Person     // 指定类型
      }
    }
  })
  new Vue({
    el: '#app2',
    data: {
      person: 2        // 传入 Number 类型会报错
    }
  })
非 Prop 类型的属性

也可以像在 html 标签中添加 data- 开头的自定义属性一样,给自定义组件添加任意的属性。而不仅限于 data-* 形式,这样做的话,Vue 会把这个属性放在自定义组件的根元素上。一个自定义组件的模板只能有一个根元素。

覆盖非 Prop 属性

如果父组件向子组件的非 prop 属性传递了值,那么这个值会覆盖子组件模板中的特性。

<div id="app3">
    <my-component2 att="helloParent"></my-component2>
</div>
<script>
  Vue.component('my-component2', {
    template: `<div att="helloChild"> 子组件原有的特性被覆盖了 </div>`
  })
  new Vue({
    el: '#app3'
  })
</script>

上面渲染的结果是,div 的 att 属性是 helloParent。
注意:前面已经提到过,覆盖原则对于 class 和 style 不适用, 而是采用了合并 (merge) 的原则。

<div id="app3">
    <my-component2 att="helloParent" class="class2" style="color: red;"></my-component2>
</div>
<script>
  Vue.component('my-component2', {
    template: `<div att="helloChild" class="class1" style="background: yellow;">子组件原有的特性被覆盖了</div>`
  })
  new Vue({el: '#app3'})
</script>

上面的渲染结果是,div 的类名是 class1 class2,行内样式是 color:red; background:yellow;。