开发过程中,props 的使用有两种写法:
// 字符串数组写法
const subComponent = {
props: [
'name'
]
}
// 对象写法
const subComponent = {
props: {
name: {
type: String,
default
:
'Kobe Bryant'
}
}
}
Vue在内部会对 props 选项进行处理,无论开发时使用了哪种语法,Vue都会将其规范化为对象的形式。具体规范方式见Vue源码 src/core/util/options.js 文件中的 normalizeProps 函数:
/**
* Ensure all props option syntax are normalized into the
* Object-based format.(确保将所有props选项语法规范为基于对象的格式)
*/
// 参数的写法为 flow(https://flow.org/) 语法
function
normalizeProps (options: Object, vm: ?Component) {
const props = options.props
// 如果选项中没有props,那么直接return
if
(!props)
return
// 如果有,开始对其规范化
// 声明res,用于保存规范化后的结果
const res = {}
let i, val, name
if
(Array.isArray(props)) {
// 使用字符串数组的情况
i = props.length
// 使用while循环遍历该字符串数组
while
(i--) {
val = props[i]
if
(
typeof
val ===
'string'
) {
// props数组中的元素为字符串的情况
// camelize方法位于 src/shared/util.js 文件中,用于将中横线转为驼峰
name = camelize(val)
res[name] = { type:
null
}
}
else
if
(process.env.NODE_ENV !==
'production'
) {
// props数组中的元素不为字符串的情况,在非生产环境下给予警告
// warn方法位于 src/core/util/debug.js 文件中
warn(
'props must be strings when using array syntax.'
)
}
}
}
else
if
(isPlainObject(props)) {
// 使用对象的情况(注)
// isPlainObject方法位于 src/shared/util.js 文件中,用于判断是否为普通对象
for
(const key
in
props) {
val = props[key]
name = camelize(key)
// 使用for in循环对props每一个键的值进行判断,如果是普通对象就直接使用,否则将其作为type的值
res[name] = isPlainObject(val)
? val
: { type: val }
}
}
else
if
(process.env.NODE_ENV !==
'production'
) {
// 使用了props选项,但它的值既不是字符串数组,又不是对象的情况
// toRawType方法位于 src/shared/util.js 文件中,用于判断真实的数据类型
warn(
`Invalid value
for
option
"props"
: expected an Array or an Object, ` +
`but got ${toRawType(props)}.`,
vm
)
}
options.props = res
}
如此一来,假如我的 props 是一个字符串数组:
props: [
"team"
]
经过这个函数之后,props 将被规范为:
props: {
team:{
type:
null
}
}
假如我的 props 是一个对象:
props: {
name: String,
height: {
type: Number,
default
: 198
}
}
经过这个函数之后,将被规范化为:
props: {
name: {
type: String
},
height: {
type: Number,
default
: 198
}
}
注:对象的写法也分为以下两种,故仍需进行规范化
props: {
// 第一种写法,直接写类型
name: String,
// 第二种写法,写对象
name: {
type: String,
default
:
'Kobe Bryant'
}
}
最终会被规范为第二种写法。