## Prop
### 使用Prop传递数据
组件实例的作用域是孤立的。这意味着不能(也不应该)在子组件的模板内直接引用父组件的数据。要让子组件使用父组件的数据,我们需要通过子组件的props选项。
子组件要显式地用 props 选项声明它期待获得的数据:
~~~
Vue.component('child', {
// 声明 props
props: ['message'],
// 就像 data 一样,prop 可以用在模板内
// 同样也可以在 vm 实例中像 “this.message” 这样使用
template: '<span>{{ message }}</span>'
})
~~~
然后我们可以这样向它传入一个普通字符串:
~~~
<child message="hello!"></child>
~~~
>[info]完整代码示例:
~~~
<div id="app">
<child message="hello!"></child>
</div>
<script type="text/javascript">
Vue.component('child', {
// 声明 props
props: ['message'],
// 就像 data 一样,prop 可以用在模板内
// 同样也可以在 vm 实例中像 “this.message” 这样使用
template: '<span>{{ message }}</span>'
})
new Vue({
el:'#app'
});
</script>
~~~
页面显示效果为:hello
### camelCase vs.kebab-case
HTML 特性是不区分大小写的。所以,当使用的不是字符串模版,camelCased (驼峰式) 命名的 prop 需要转换为相对应的 kebab-case (短横线隔开式) 命名:
~~~
Vue.component('child', {
// camelCase in JavaScript
props: ['myMessage'],
template: '<span>{{ myMessage }}</span>'
})
~~~
~~~
<!-- kebab-case in HTML -->
<child my-message="hello!"></child>
~~~
如果你使用字符串模版,则没有这些限制。
>[info]完整代码示例:
~~~
<div id="app">
<child my-message="hello!"></child>
</div>
<script type="text/javascript">
Vue.component('child', {
// camelCase in JavaScript
props: ['myMessage'],
template: '<span>{{ myMessage }}</span>'
})
new Vue({
el:'#app'
});
</script>
~~~
### 动态Prop
在模板中,要动态地绑定父组件的数据到子模板的props,与绑定到任何普通的HTML特性相类似,就是用 v-bind。每当父组件的数据变化时,该变化也会传导给子组件:
~~~
<div>
<input v-model="parentMsg">
<br>
<child v-bind:my-message="parentMsg"></child>
</div>
~~~
使用 v-bind 的缩写语法通常更简单:
~~~
<child :my-message="parentMsg"></child>
~~~
>[info]完整代码示例:
~~~
<div id="app">
<input v-model="parentMsg">
<br>
<child v-bind:my-message="parentMsg"></child>
</div>
<script type="text/javascript">
new Vue({
el:'#app',
data: {
parentMsg: 'Message from parent'
},
components: {
child: {
props: ['myMessage'],
template: '<span>{{myMessage}}</span>'
}
}
});
</script>
~~~
### 字面量语法 VS 动态语法
初学者常犯的一个错误是使用字面量语法传递数值:
~~~
<!-- 传递了一个字符串 "1" -->
<comp some-prop="1"></comp>
~~~
因为它是一个字面 prop ,它的值是字符串 "1" 而不是number。如果想传递一个实际的number,需要使用 v-bind ,从而让它的值被当作 JavaScript 表达式计算:
~~~
<!-- 传递实际的 number -->
<comp v-bind:some-prop="1"></comp>
~~~
### 单向数据流
prop 是单向绑定的:当父组件的属性变化时,将传导给子组件,但是不会反过来。这是为了防止子组件无意修改了父组件的状态——这会让应用的数据流难以理解。
另外,每次父组件更新时,子组件的所有 prop 都会更新为最新值。这意味着你不应该在子组件内部改变 prop 。如果你这么做了,Vue 会在控制台给出警告。
为什么我们会有修改prop中数据的冲动呢?通常是这两种原因:
- prop 作为初始值传入后,子组件想把它当作局部数据来用;
- prop 作为初始值传入,由子组件处理成其它数据输出。
对这两种原因,正确的应对方式是:
- 1.定义一个局部变量,并用 prop 的值初始化它:
~~~
props: ['initialCounter'],
data: function () {
return { counter: this.initialCounter }
}
~~~
- 2.定义一个计算属性,处理 prop 的值并返回。
~~~
props: ['size'],
computed: {
normalizedSize: function () {
return this.size.trim().toLowerCase()
}
}
~~~
>[danger]注意在 JavaScript 中对象和数组是引用类型,指向同一个内存空间,如果 prop 是一个对象或数组,在子组件内部改变它会影响父组件的状态。
### Prop验证
我们可以为组件的 props 指定验证规格。如果传入的数据不符合规格,Vue 会发出警告。当组件给其他人使用时,这很有用。
要指定验证规格,需要用对象的形式,而不能用字符串数组:
~~~
Vue.component('example', {
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
type 也可以是一个自定义构造器函数,使用 instanceof 检测。
当 prop 验证失败,Vue会在抛出警告 (如果使用的是开发版本)。
- 前端新手村
- 前言
- 第1章 遇见Vue.js
- 第一个Vue.js程序
- vue尝鲜
- 第2章 概念理解
- 渐进式框架
- 虚拟DOM
- MVVM模式
- MVX模式是什么
- 第3章 Vue基础概览
- 第4章 Vue内置指令详解
- vue-text
- vue-html
- v-show
- v-if
- v-else
- v-else-if
- v-for
- v-on
- v-bind
- v-model
- v-pre
- v-cloak
- v-once
- 第5章 基础demo小练习
- 图书管理系统
- 页面布局
- 列表渲染
- 功能实现
- 基于BootStrap+Vuejs实现用户信息表
- 功能描述
- 布局实现
- 星座判断
- 第6章 组件
- 什么是组件
- 使用组件
- Prop
- 自定义事件
- 使用Slot分发内容
- 动态组件
- 杂项
- 第7章-过渡
- 过渡效果
- 概述
- 单元素/组件的过渡
- 初始渲染的过渡
- 多个元素的过渡
- 多个组件的过渡
- 列表过渡
- 可复用的过渡
- 动态过渡
- 过渡状态
- 状态动画与watcher
- 动态状态转换
- 通过组件组织过渡
- Render函数
- 基础
- createElement参数
- 使用JavaScript代替模板功能
- JSX
- 函数化组件
- 模板编译
- 自定义指令
- 简介
- 钩子函数
- 钩子函数参数
- 函数简写
- 对象字面量
- Vuex状态管理
- Vuex是什么?
- Vuex的安装
- Vuex起步
- data的替代品-State和Getter
- 测试Getter
- Action-操作的执行者
- 测试Action
- 只用Mutation修改状态
- 测试Mutations
- Vuex的基本结构
- 子状态和模块
- 用服务分离外部操作
- Vue-router
- Vue-router是什么
- Vue-router安装
- 基本用法1
- 基本用法2
- Vue-cli
- Vue中的Node.js
- Vue中的npm、cnpm
- Vue中的webpack
- 安装
- 基本使用
- 模板
- 全局API
- Vue.extend
- Vue.nextTick
- Vue.set
- Vue.delete
- Vue.directive
- Vue.filter
- Vue.component
- Vue.use
- Vue.mixin
- Vue.compile
- 附录
- 相关网站
- 尤雨溪
- 第10章 webpack
- webpack安装
- webpack基本使用
- webpack命令行
- webpack配置文件
- 单页面应用SPA
- 第1章 Vue.js简介
- 1.1 Vue.js简介
- 1.1.1 Vue.js是什么
- 1.1.2 为什么要用Vue.js
- 1.1.3 Vue.js的发展历史
- 1.1.4 Vue.js与其他框架的区别
- 1.2 如何使用Vue.js
- 1.2.1 第一个Vue.js程序
- 1.2.2 Vue.js小尝鲜
- 1.3 概念详解
- 1.3.1 什么是渐进式框架
- 1.3.2 虚拟DOM是什么
- 1.3.3 如何理解MVVM
- 第2章 基础概览
- 2.1 Vue实例
- 2.1.1 构造器
- 2.1.2 属性与方法
- 2.1.3 实例生命周期
- 2.1.4 生命周期图示
- 2.2 模板语法
- 2.2.1 插值
- 2.2.2 指令
- 2.2.3 过滤器
- 2.2.4 缩写
- 第3章 Class与Style的绑定
- 第4章 模板渲染
- 第5章 事件详解
- 第6章 表单控件绑定
- 第7章 指令详解
- 7.1 内部指令
- 7.2 自定义指令
- 7.3 指令的高级选项
- 第8章 计算属性
- 第9章 过滤器
- 第10章 组件
- 10.1 什么是组件
- 10.2 注册组件
- 10.3 组件选项
- 10.4 组件间的通信
- 10.5 内容分发
- 10.6 动态组件