为了提高组件的复用性,在封装 vue 组件时需要遵守如下的原则:
组件的 DOM 结构、Style 样式要尽量复用
组件中要展示的数据,尽量由组件的使用者提供
为了方便使用者为组件提供要展示的数据,vue 组件提供了 props 的概念。
props 是组件的自定义属性,组件的使用者可以通过 props 把数据传递到子组件内部,供子组件内部进行使用。
props 的作用:
父组件通过 props 向子组件传递要展示的数据。
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,传递的为字符串类型的数据。
如果父组件给子组件传递了未声明的 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。
组件中如果使用“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>
props 验证指的是:在封装组件时对外界传递过来的 props 数据进行合法性的校验,从而防止数据不合法的问题。
使用数组类型的 props 节点的缺点:无法为每个 prop 指定具体的数据类型。
使用对象类型的 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>
对象类型的 props 节点提供了多种数据验证方案。
① 基础的类型检查
② 多个可能的类型
③ 必填项校验
④ 属性默认值
⑤ 自定义验证函数
可以直接为组件的 prop 属性指定基础的校验类型,从而防止组件的使用者为其绑定错误类型的数据。
String
Number
Boolean
Array
Object
Date
Function
Symbol
如果某个 prop 属性值的类型不唯一,此时可以通过数组的形式,为其指定多个可能的类型
info的值可能是字符串或数字
info: [String, Number]
<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>
如果组件的某个 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>
在封装组件时,可以为某个 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>
在封装组件时,可以为 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>