开发过程中,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' } }
最终会被规范为第二种写法。