Vue选项/DOM
Vue选项/DOM
- el
- template
- render
- renderError
el
- 类型:
string | Element
- 限制:只在由
new
创建的实例中遵守。 - 详细:
提供一个在页面上已存在的 DOM 元素作为 Vue 实例的挂载目标。可以是 CSS 选择器,也可以是一个 HTMLElement 实例。
在实例挂载之后,元素可以用vm.$el
访问。
如果在实例化时存在这个选项,实例将立即进入编译过程,否则,需要显式调用vm.$mount()
手动开启编译。
提供的元素只能作为挂载点。不同于 Vue 1.x,所有的挂载元素会被 Vue 生成的 DOM 替换。因此不推荐挂载 root 实例到
<html>
或者<body>
上。
如果render
函数和template
属性都不存在,挂载 DOM 元素的 HTML 会被提取出来用作模板,此时,必须使用 Runtime + Compiler 构建的 Vue 库。
template
- 类型:
string
- 详细:
一个字符串模板作为 Vue 实例的标识使用。模板将会 替换 挂载的元素。挂载元素的内容都将被忽略,除非模板的内容有分发插槽。
如果值以#
开始,则它将被用作选择符,并使用匹配元素的 innerHTML 作为模板。常用的技巧是用<script type="x-template">
包含模板。
出于安全考虑,你应该只使用你信任的 Vue 模板。避免使用其他人生成的内容作为你的模板。
如果 Vue 选项中包含渲染函数,该模板将被忽略。
render
- 类型:
(createElement: () => VNode) => VNode
- 详细:
字符串模板的代替方案,允许你发挥 JavaScript 最大的编程能力。该渲染函数接收一个createElement
方法作为第一个参数用来创建VNode
。
如果组件是一个函数组件,渲染函数还会接收一个额外的context
参数,为没有实例的函数组件提供上下文信息。
Vue 选项中的render
函数若存在,则 Vue 构造函数不会从template
选项或通过 el 选项指定的挂载元素中提取出的 HTML 模板编译渲染函数。
renderError
- 类型:
(createElement: () => VNode, error: Error) => VNode
- 详细:
只在开发者环境下工作。
当render
函数遭遇错误时,提供另外一种渲染输出。其错误将会作为第二个参数传递到renderError
。这个功能配合 hot-reload 非常实用。
示例:
new Vue({
render (h) {
throw new Error('oops')
},
renderError (h, err) {
return h('pre', { style: { color: 'red' }}, err.stack)
}
}).$mount('#app')
还没有评论,来说两句吧...