Prop 的大小写 (camelCase vs kebab-case)
HTML 中的特性名是大小写不敏感的,所以浏览器会把所有大写字符解释为小写字符。这意味着当你使用 DOM 中的模板时,camelCase (驼峰命名法) 的 prop 名需要使用其等价的 kebab-case (短横线分隔命名) 命名。重申一次,如果你使用字符串模板,那么这个限制就不存在了。
Vue.component('blog-post', {
// 在 JavaScript 中是 camelCase(驼峰命名法) 的
props: ['postTitle'],
template: '<h3>{{ postTitle }}</h3>'
})
<!-- 在 HTML 中是 kebab-case(短横线命名法) 的 -->
<blog-post post-title="hello!"></blog-post>
这里,组件中的props的属性值是用的驼峰命名法,html中的属性名必须是短横线命名法。
传递静态或动态 Prop
给 prop 传入一个静态的值:
<blog-post title="My journey with Vue"></blog-post>
prop 可以通过 v-bind 动态赋值
<!-- 动态赋予一个变量的值 -->
<blog-post v-bind:title="post.title"></blog-post>
<!-- 动态赋予一个复杂表达式的值 -->
<blog-post
v-bind:title="post.title + ' by ' + post.author.name"
></blog-post>
实际上任何类型的值都可以传给一个 prop。
单向数据流
所有的 prop 都使得其父子 prop 之间形成了一个单向下行绑定:父级 prop 的更新会向下流动到子组件中,但是反过来则不行。这样会防止从子组件意外改变父级组件的状态,从而导致你的应用的数据流向难以理解。
额外的,每次父级组件发生更新时,子组件中所有的 prop 都将会刷新为最新的值。这意味着你不应该在一个子组件内部改变 prop。如果你这样做了,Vue 会在浏览器的控制台中发出警告。
<!DOCTYPE html>
<html>
<head>
<meta charset="utf-8" />
<title>单向数据流</title>
<meta name="viewport" content="width=device-width,initial-scale=1,minimum-scale=1,maximum-scale=1,user-scalable=no" />
</head>
<div id="app">
<custom-component :count="count"></custom-component>
</div>
<body>
</body>
<script src="js/vue.js"></script>
<script type="text/javascript">
Vue.component('custom-component',{
props: ['count'],
template: `
<div>
<h3>这是一个自定义模板</h3>
<input type="button" value="按钮" @click="changeCount" />
<p>{{count}}</p>
</div>
`,
methods: {
changeCount(){
this.count++
}
}
})
var app = new Vue({
el: '#app',
data () {
return{
count: 0
}
}
})
</script>
</html>
数据从父级组件传递给子组件,只能单向绑定。子组件内部不能直接修改从父级传递过来的数据。
上面代码控制台会出现报错:避免在子组件数据被重写,可以改变props的情况,使用数据或计算属性来解决。
<!DOCTYPE html>
<html>
<head>
<meta charset="utf-8" />
<title>单向数据流</title>
<meta name="viewport" content="width=device-width,initial-scale=1,minimum-scale=1,maximum-scale=1,user-scalable=no" />
</head>
<div id="app">
<custom-component :count="count"></custom-component>
</div>
<body>
</body>
<script src="js/vue.js"></script>
<script type="text/javascript">
/* Vue.component("custom-component", {
//作为data中局部数据的初始值来过渡,必须以函数形式申明,
//相当于子组件里操作的都是this.count的指针
data() {
return {
initCount: this.count
}
},
props: ['count'],
template: `
<div>
<h1>一个自定义模版</h1>
<input type="button" @click="changeCount" value="按钮"/>
{{initCount}}
</div>`,
methods: {
changeCount() {
//这里计算的也是initCount
this.initCount++
}
}
}); */
Vue.component("custom-component", {
data() {
return {
initCount: this.count
}
},
//与直接使用data不同的是这里添加选项参数计算属性`computed`
computed: {
initCount2() {
return this.initCount;
}
},
props: ['count'],
template: `
<div>
<h1>一个自定义模版</h1>
<input type="button" @click="changeCount" value="按钮"/>
{{initCount2}}
</div>`,
methods: {
changeCount() {
this.initCount++
}
}
});
var app = new Vue({
el: '#app',
data () {
return{
count: 0
}
}
})
</script>
</html>
Prop 验证
我们可以为组件的 prop 指定验证要求,例如你知道的这些类型。如果有一个需求没有被满足,则 Vue 会在浏览器控制台中警告你。这在开发一个会被别人用到的组件时尤其有帮助。
为了定制 prop 的验证方式,你可以为 props 中的值提供一个带有验证需求的对象,而不是一个字符串数组。例如:
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 验证失败的时候,(开发环境构建版本的) Vue 将会产生一个控制台的警告。
注意那些 prop 会在一个组件实例创建之前进行验证,所以实例的属性 (如 data、computed 等) 在 default 或 validator 函数中是不可用的。
类型检查
type
可以是下列原生构造函数中的一个:
String
Number
Boolean
Array
Object
Date
Function
-
Symbol
额外的,type
还可以是一个自定义的构造函数,并且通过instanceof
来进行检查确认。
禁用特性继承
如果你不希望组件的根元素继承特性,你可以在组件的选项中设置 inheritAttrs: false。例如:
Vue.component('my-component', {
inheritAttrs: false,
// ...
})