一、Prop 的大小写 (camelCase vs kebab-case)
HTML 中的 attribute 名是大小写不敏感的,所以浏览器会把所有大写字符解释为小写字符。这意味着当你使用 DOM 中的模板时,camelCase (驼峰命名法) 的 prop 名需要使用其等价的 kebab-case (短横线分隔命名) 命名。
示例1:
Vue.component("zidingyi", {
template: "#tpl",
props:["helloworld"],
data: function () {
return {}
}
})
<div id="app">
<!-- 这里通过绑定属性的方式给组件传递参数 -->
<zidingyi helloWorld="hello" ></zidingyi>
<zidingyi ></zidingyi>
</div>
<template id="tpl">
<h1>我是一个{{helloworld}}</h1>
</template>
示例2:
Vue.component('blog-post', {
// 在 JavaScript 中是 camelCase 的
props: ['postTitle'],
template: '<h3>{{ postTitle }}</h3>'
})
<!-- 在 HTML 中是 kebab-case 的 -->
<blog-post post-title="hello!"></blog-post>
值得注意的是:如果外部的属性名中带有 - 我们的props里定义的时候要注意转驼峰 当然如果不转 也能使用
但是在插值语法{{}}要转驼峰
提示:想象一下 {{hello-world}} 会被当做什么来对待。
二、传递静态或动态 Prop
给组件传递属性
// 向组件内传递数据 我们可以通过属性传递的方式
Vue.component("zidingyi", {
template: "#tpl",
// 定义props
props: ["a"], // Vue会把props里声明的字符串作为data的一个数据 所以props里你如果写了的话就不要再在data中再次定义了
data: function () {
return {}
}
})
var v1 = new Vue({
el: "#app",
data: {
name1: "张三",
name2: "李四"
}
})
<div id="app">
<!-- 这里通过绑定属性的方式给组件传递参数 -->
<zidingyi v-bind:a="name1"></zidingyi>
<zidingyi v-bind:a="name2"></zidingyi>
</div>
<template id="tpl">
<h1>我是一个{{a}}</h1>
</template>
三、Prop 验证
我们可以为组件的 prop 指定验证要求,例如你知道的这些类型。如果有一个需求没有被满足,则 Vue 会在浏览器控制台中警告你。这在开发一个会被别人用到的组件时尤其有帮助。
Vue.component('my-component', {
props: {
// 基础的类型检查 (`null` 和 `undefined` 会通过任何类型验证)
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 ['success', 'warning', 'danger'].indexOf(value) !== -1
}
}
}
})
注意那些 prop 会在一个组件实例创建之前进行验证,所以实例的 property (如 data、computed 等) 在
default 或 validator 函数中是不可用的。
四、单向数据流
所有的 prop 都使得其父子 prop 之间形成了一个单向下行绑定:父级 prop 的更新会向下流动到子组件中,但是反过来则不行。这样会防止从子组件意外变更父级组件的状态,从而导致你的应用的数据流向难以理解。
额外的,每次父级组件发生变更时,子组件中所有的 prop 都将会刷新为最新的值。这意味着你不应该在一个子组件内部改变 prop。如果你这样做了,Vue 会在浏览器的控制台中发出警告。
这里有两种常见的试图变更一个 prop 的情形:
- 这个 prop 用来传递一个初始值;这个子组件接下来希望将其作为一个本地的 prop 数据来使用。
在这种情况下,最好定义一个本地的 data property 并将这个 prop 用作其初始值:
props: ['initialCounter'],
data: function () {
return {
counter: this.initialCounter
}
}
- 这个 prop 以一种原始的值传入且需要进行转换。
在这种情况下,最好使用这个 prop 的值来定义一个计算属性:
props: ['size'],
computed: {
normalizedSize: function () {
return this.size.trim().toLowerCase()
}
}
注意在 JavaScript 中对象和数组是通过引用传入的,所以对于一个数组或对象类型的 prop 来说,在子组件中改变变更这个对象或数组本身将会影响到父组件的状态。