1 组件的 props
为了提高组件的复用性，在封装 vue 组件时需要遵守如下的原则：
组件的 DOM 结构、Style 样式要尽量复用
组件中要展示的数据，尽量由组件的使用者提供
为了方便使用者为组件提供要展示的数据，vue 组件提供了 props 的概念。
props 是组件的自定义属性，组件的使用者可以通过 props 把数据传递到子组件内部，供子组件内部进行使用。
props 的作用：
父组件通过 props 向子组件传递要展示的数据。
props 的好处：
提高了组件的复用性。
2 在组件中声明 props
在封装 vue 组件时，可以把动态的数据项声明为 props 自定义属性。自定义属性可以在当前组件的模板结构中被直接使用。示例代码如下：
<template> <div> <h3>标题：{{title}}</h3> <h5>作者：{{author}}</h5> <h6>发布时间：{{pubTime}}</h6> </div> </template> <script> export default { name: 'MyArticle', // 外界可以传递指定的数据，到当前的组件中 props: ['title', 'author', 'pubTime'] } </script>
父组件向子组件传值，可以直接传值，也可以使用动态属性绑定。
可以使用 v-bind 属性绑定的形式，为组件动态绑定 props 的值。
<template> <div> <h1>这是 App.vue 根组件</h1> <hr /> <my-article :title="info.title" :author="'post by ' + info.author" pub-time="1989"></my-article> </div> </template> <script> import MyArticle from './Article.vue' export default { name: 'MyApp', data() { return { info: { title: 'abc', author: '123', }, } }, components: { MyArticle, }, } </script>
使用v-bind指令的形式向子组件中的props配置项传递数据，传递的为js表达式的结果，如果没有使用v-bind，传递的为字符串类型的数据。
3 无法使用未声明的 props
如果父组件给子组件传递了未声明的 props 属性，则这些属性会被忽略，无法被子组件使用，示例代码如下：
<template> <div> <h3>标题：{{title}}</h3> <h5>作者：{{author}}</h5> <h6>发布时间：{{pubTime}}</h6> </div> </template> <script> export default { name: 'MyArticle', // 外界可以传递指定的数据，到当前的组件中 props: ['title', 'author'] } </script>
<template> <div> <h1>这是 App.vue 根组件</h1> <hr /> <my-article :title="info.title" :author="'post by ' + info.author" pub-time="1989"></my-article> </div> </template> <script> import MyArticle from './Article.vue' export default { name: 'MyApp', data() { return { info: { title: 'abc', author: '123', }, } }, components: { MyArticle, }, } </script>
在子组件中不存在pubTime。
4 props 的大小写命名
组件中如果使用“camelCase (驼峰命名法)”声明了 props 属性的名称，则有两种方式为其绑定属性的值：
<template> <div> <h6>发布时间：{{pubTime}}</h6> </div> </template> <script> export default { name: 'MyArticle', // 外界可以传递指定的数据，到当前的组件中 props: ['pubTime'] } </script>
<template> <div> <h1>这是 App.vue 根组件</h1> <hr /> <my-article pub-time="1989"></my-article> <my-article pubTime="1989"></my-article> </div> </template> <script> import MyArticle from './Article.vue' export default { name: 'MyApp', data() { return { info: { title: 'abc', author: '123', }, } }, components: { MyArticle, }, } </script>
5 props 验证
props 验证指的是：在封装组件时对外界传递过来的 props 数据进行合法性的校验，从而防止数据不合法的问题。
使用数组类型的 props 节点的缺点：无法为每个 prop 指定具体的数据类型。
6 对象类型的 props 节点
使用对象类型的 props 节点，可以对每个 prop 进行数据类型的校验
// props: ['count', 'state'], props: { count: { type: Number }, state: Boolean }
<template> <div> <p>数量：{{ count }}</p> <p>状态：{{ state }}</p> </div> </template> <script> export default { name: 'MyCount', // props: ['count', 'state'], props: { count: { type: Number }, state: Boolean } } </script> <style lang="less" scoped></style>
7 props 验证
对象类型的 props 节点提供了多种数据验证方案。
① 基础的类型检查
② 多个可能的类型
③ 必填项校验
④ 属性默认值
⑤ 自定义验证函数
8 基础的类型检查
可以直接为组件的 prop 属性指定基础的校验类型，从而防止组件的使用者为其绑定错误类型的数据。
8.1 支持校验的基础类型
String Number Boolean Array Object Date Function Symbol
9 多个可能的类型
如果某个 prop 属性值的类型不唯一，此时可以通过数组的形式，为其指定多个可能的类型
info的值可能是字符串或数字
info: [String, Number] • 1
<template> <div> <p>数量：{{ count }}</p> <p>状态：{{ state }}</p> </div> </template> <script> export default { name: 'MyCount', // props: ['count', 'state'], props: { count: { type: Number }, state: Boolean, info: [String, Number] }, } </script> <style lang="less" scoped></style>
10 必填项校验
如果组件的某个 prop 属性是必填项，必须让组件的使用者为其传递属性的值。
可以将其设置为必填项：
count: { type: Number, required: true //count属性的值必须有 },
<template> <div> <p>数量：{{ count }}</p> <p>状态：{{ state }}</p> </div> </template> <script> export default { name: 'MyCount', // props: ['count', 'state'], props: { count: { type: Number, required: true }, state: Boolean, info: [String, Number] }, } </script> <style lang="less" scoped></style>
11 属性默认值
在封装组件时，可以为某个 prop 属性指定默认值。
count: { type: Number, required: true, default: 100 //如果没有传值，count默认为100 },
<template> <div> <p>数量：{{ count }}</p> <p>状态：{{ state }}</p> </div> </template> <script> export default { name: 'MyCount', // props: ['count', 'state'], props: { count: { type: Number, required: true, default: 100 }, state: Boolean, info: [String, Number] }, } </script> <style lang="less" scoped></style>
12 自定义验证函数
在封装组件时，可以为 prop 属性指定自定义的验证函数，从而对 prop 属性的值进行更加精确的控制。
通过validator函数对type属性进行校验，value为传入给type的值，type的值为数组中的一个。值为数组中的一个返回值为true表示验证通过，否则验证失败。
type: { validator(value) { return ['success', 'warning', 'danger'].indexOf(value) !== -1 } }
<template> <div> <p>数量：{{ count }}</p> <p>状态：{{ state }}</p> </div> </template> <script> export default { name: 'MyCount', // props: ['count', 'state'], props: { count: { type: Number, required: true, default: 100 }, state: Boolean, info: [String, Number], myType: { validator(value) { return ['success', 'warning', 'danger'].indexOf(value) !== -1 } } }, } </script> <style lang="less" scoped></style>
13 props配置项的注意点
- 不要修改props中的值，props是只读的，Vue底层会监测你对props的修改，如果进行了修改，就会发出警告，若业务需求确实需要修改，那么请复制props的内容到data中一份，然后去修改data中的数据。
- 如果data与props中存在同名的变量，那么会优先使用props中的数据，因为优先级props更高
- props中不要使用已经被vue使用了的关键字作为接收父组件传递数据的变量名。
