Vue Render函数

计算机软件开发 2024-9-28 10:40:16 33 0 来自 中国
前置知识:vm.$slots


  • 范例:{ [name: string]: ?Array<VNode> }
  • 只读
  • 相应性:否
  • 详细
    用来访问被插槽分发的内容。每个具名插槽有其相应的 property (比方:v-slot:foo 中的内容将会在 vm.$slots.foo 中被找到)。default property 包括了全部没有被包罗在具名插槽中的节点,或 v-slot:default 的内容。
    请注意插槽不是相应性的。如果你必要一个组件可以在被传入的数据发生厘革时重渲染,我们发起改变计谋,依赖诸如 props 或 data 等相应性实例选项。
    注意:v-slot:foo 在 2.6 以上的版本才支持。对于之前的版本,你可以使用废弃了的语法。
    在使用渲染函数誊写一个组件时,访问 vm.$slots 最有帮助。
<blog-post>  <template v-slot:header>    <h1>About Me</h1>  </template>  <p>Here's some page content, which will be included in vm.$slots.default, because it's not inside a named slot.</p>  <template v-slot:footer>    <p>Copyright 2016 Evan You</p>  </template>  <p>If I have some content down here, it will also be included in vm.$slots.default.</p>.</blog-post>Vue.component('blog-post', {  render: function (createElement) {    var header = this.$slots.header    var body   = this.$slots.default    var footer = this.$slots.footer    return createElement('div', [      createElement('header', header),      createElement('main', body),      createElement('footer', footer)    ])  }})节点、树以及假造 DOM

createElement 参数

// @returns {VNode}createElement(  // {String | Object | Function}  // 一个 HTML 标署名、组件选项对象,大概  // resolve 了上述任何一种的一个 async 函数。必填项。  'div',  // {Object}  // 一个与模板中 attribute 对应的数据对象。可选。  {    // (详情见下一节)  },  // {String | Array}  // 子级假造节点 (VNodes),由 `createElement()` 构建而成,  // 也可以使用字符串来天生“文本假造节点”。可选。  [    '先写一些笔墨',    createElement('h1', '一则头条'),    createElement(MyComponent, { // vnode数据对象的属性,props,data,methods等等,也可以是HTML attribute      props: {        someProp: 'foobar'      }    })  ])有一点要注意:正如 v-bind:class 和 v-bind:style 在模板语法中会被特别对待一样,它们在 VNode 数据对象中也有对应的顶层字段。该对象也答应你绑定平凡的 HTML attribute,也答应绑定如 innerHTML 如许的 DOM property (这会覆盖 v-html 指令)。
{  // 与 `v-bind:class` 的 API 类似,  // 担当一个字符串、对象或字符串和对象构成的数组  'class': {    foo: true,    bar: false  },  // 与 `v-bind:style` 的 API 类似,  // 担当一个字符串、对象,或对象构成的数组  style: {    color: 'red',    fontSize: '14px'  },  // 平凡的 HTML attribute  attrs: {    id: 'foo'  },  // 组件 prop  props: {    myProp: 'bar'  },  // DOM property  domProps: {    innerHTML: 'baz'  },  // 事故监听器在 `on` 内,  // 但不再支持如 `v-on:keyup.enter` 如许的修饰器。  // 必要在处置处罚函数中手动查抄 keyCode。  on: {    click: this.clickHandler  },  // 仅用于组件,用于监听原生事故,而不是组件内部使用  // `vm.$emit` 触发的事故。  nativeOn: {    click: this.nativeClickHandler  },  // 自界说指令。注意,你无法对 `binding` 中的 `oldValue`  // 赋值,由于 Vue 已经主动为你进行了同步。  directives: [    {      name: 'my-custom-directive',      value: '2',      expression: '1 + 1',      arg: 'foo',      modifiers: {        bar: true      }    }  ],  // 作用域插槽的格式为  // { name: props => VNode | Array<VNode> }  scopedSlots: {    default: props => createElement('span', props.text)  },  // 如果组件是别的组件的子组件,需为插槽指定名称  slot: 'name-of-slot',  // 别的特别顶层 property  key: 'myKey',  ref: 'myRef',  // 如果你在渲染函数中给多个元素都应用了类似的 ref 名,  // 那么 `$refs.myRef` 会酿成一个数组。  refInFor: true}下面是使用render创建的组件示例:

var getChildrenTextContent = function (children) {  return children.map(function (node) {    return node.children      ? getChildrenTextContent(node.children)      : node.text  }).join('')}Vue.component('anchored-heading', {  render: function (createElement) {    // 创建 kebab-case 风格的 ID    var headingId = getChildrenTextContent(this.$slots.default)      .toLowerCase()      .replace(/\W+/g, '-')      .replace(/(^-|-$)/g, '')    return createElement(      'h' + this.level,      [        createElement('a', {          attrs: {            name: headingId,            href: '#' + headingId          }        }, this.$slots.default)      ]    )  },  props: {    level: {      type: Number,      required: true    }  }})VNode 必须唯一

组件树中的全部 VNode 必须是唯一的。这意味着,下面的渲染函数是不合法的:
render: function (createElement) {  var myParagraphVNode = createElement('p', 'hi')  return createElement('div', [    // 错误 - 重复的 VNode    myParagraphVNode, myParagraphVNode  ])}如果你真的必要重复很多次的元素/组件,你可以使用工厂函数来实现。比方,下面这渲染函数用完全合法的方式渲染了 20 个类似的段落:
render: function (createElement) {  return createElement('div',    Array.apply(null, { length: 20 }).map(function () {      return createElement('p', 'hi')    })  )}使用 JavaScript 取代模板功能

v-if 和 v-for

只要在原生的 JavaScript 中可以轻松完成的操纵,Vue 的渲染函数就不会提供专有的更换方法。比如,在模板中使用的 v-if 和 v-for:
<ul v-if="items.length">  <li v-for="item in items">{{ item.name }}</li></ul><p v-else>No items found.</p>这些都可以在渲染函数中用 JavaScript 的 if/else 和 map 来重写:
props: ['items'],render: function (createElement) {  if (this.items.length) {    return createElement('ul', this.items.map(function (item) {      return createElement('li', item.name)    }))  } else {    return createElement('p', 'No items found.')  }}v-model

渲染函数中没有与 v-model 的直接对应——你必须自己实现相应的逻辑:
props: ['value'],render: function (createElement) {  var self = this  return createElement('input', {    domProps: {      value: self.value    },    on: {      input: function (event) {        self.$emit('input', event.target.value)      }    }  })}事故 & 按键修饰符

对于 .passive、.capture 和 .once 这些事故修饰符,Vue 提供了相应的前缀可以用于 on:
on: {  '!click': this.doThisInCapturingMode,  '~keyup': this.doThisOnce,  '~!mouseover': this.doThisOnceInCapturingMode}对于有些修饰符,私有前缀都不是必须的,由于你可以在事故处置处罚函数中使用事故方法:
on: {  keyup: function (event) {    // 如果触发事故的元素不是事故绑定的元素    // 则返回    if (event.target !== event.currentTarget) return    // 如果按下去的不是 enter 键大概    // 没有同时按下 shift 键    // 则返回    if (!event.shiftKey || event.keyCode !== 13) return    // 克制 事故冒泡    event.stopPropagation()    // 克制该元素默认的 keyup 事故    event.preventDefault()    // ...  }}插槽

你可以通过 this.$slots 访问静态插槽的内容,每个插槽都是一个 VNode 数组:
render: function (createElement) {  // `<div><slot></slot></div>`  return createElement('div', this.$slots.default)}也可以通过 this.$scopedSlots 访问作用域插槽,每个作用域插槽都是一个返回多少 VNode 的函数:
props: ['message'],render: function (createElement) {  // `<div><slot :text="message"></slot></div>`  return createElement('div', [    this.$scopedSlots.default({      text: this.message    })  ])}如果要用渲染函数向子组件中通报作用域插槽,可以使用 VNode 数据对象中的 scopedSlots 字段:
render: function (createElement) {  // `<div><child v-slot="props"><span>{{ props.text }}</span></child></div>`  return createElement('div', [    createElement('child', {      // 在数据对象中通报 `scopedSlots`      // 格式为 { name: props => VNode | Array<VNode> }      scopedSlots: {        default: function (props) {          return createElement('span', props.text)        }      }    })  ])}以上示例均来自vue2官网
您需要登录后才可以回帖 登录 | 立即注册

Powered by CangBaoKu v1.0 小黑屋藏宝库It社区( 冀ICP备14008649号 )

GMT+8, 2024-11-23 16:25, Processed in 0.134406 second(s), 32 queries.© 2003-2025 cbk Team.

快速回复 返回顶部 返回列表