ElementUI的Table组件中的renderHeader方法研究

项目使用ElementUI,挺好用的,页面中有些地方的帮助提示通过使用组件Tooltip和el-icon-question来展示,代码如下:

本月累计收益

截图如下:

ElementUI的Table组件中的renderHeader方法研究_第1张图片
全站很多地方都有都需要这样的帮助提示,其中有些需要在表格的表头上添加,似乎有点难度。效果如下:

ElementUI的Table组件中的renderHeader方法研究_第2张图片

因为ElementUI上面的文档对这块自定义表头没有什么参考的文档,是否能够实现心里没底,去仔细翻了文档,发现有个renderHeader的函数可以实现,一直以为Vue还算比较熟悉的我有点点懵,这是个啥???

renderHeader(函数渲染)
在我不太多的Vue项目开发实践中,很少用到,因此并不熟悉,先看看官方解释:

Vue 推荐在绝大多数情况下使用 template 来创建你的 HTML。然而在一些场景中,你真的需要 JavaScript 的完全编程的能力,这就是 render 函数,它比 template 更接近编译器。
ElementUI中的renderHeader就是对列标题Label区域渲染使用的Function,通过他实现自定义表头label功能!

万变不离其宗,这个ElementUI的解释一看就像是这段官方示例:

// 官方示例部分
render: function (createElement) {
  return createElement('h1', this.blogTitle)
}

而回头再看看ElementUI的示例:Function(h, { column, $index })。耐心琢磨,结合createElement看看便粗略写出来了一个勉强能用的:

renderHeader(h, { column, $index }) {
  return h(
    'el-tooltip',
    {
      props: {
        content: (function() {
          let label = column.label
          switch (label) {
            case '访问数':
              return '网站页面上独立访问应用的人数(UV)'
              break
            case '提交数':
              return '网站页面上访客在应用上完成提交的数量'
              break
            case '成交数':
              return '网站页面上最终成功在应用上完成提交的数量'
              break
          }
        })(),
        placement: 'top'
      },
      domProps: {
        innerHTML: column.label + ''
      }
    },
    [h('span')]
  )
},
// ...

但是很奇怪的是,最后面我要加上这个[h(‘span’)]才行。

这种写法我还是参考element table 自定义表头,但是假设我写成[h(‘span’, ‘test’)]是无法展现出test的效果的。根据vue文档中解释的第三个参数,这里最为一个数组,为何span成了el-tooltip的HTML标签,我还是不解。

之所以奇怪是因为假设我将引入的组件换成el-button,见如下代码:

renderHeader(h, { column, $index }) {
  return h(
    'el-button',
    {
      props: {
        content: (function() {
          let label = column.label
        })()
      },
      domProps: {
        innerHTML: column.label + ''
      }
    }
  )
},
// ...

则不需要尾部那个[h(‘span’)]。却能呈现出button结合icon的正确效果。难道是因为这个组件自带HTML标签?胡乱猜疑是解决不了问题的。几番尝试,还是没能达到预期交互效果。不过进度问题,暂时只能使用这个勉强版本。

为何称之为勉强版,因为从上面的demo也看出来了。这个提示交互和我文章之前写的交互是有区别的,正确交互是:光标移入问号的图标上才会展示提示框,虽然目前勉强版影响不大,却一直在心中如一个疙瘩。于是过了一周,决定抽空把这个问题处理好,就有了新的写法。
勉强版虽然没有大碍,但是心中略有不爽。几日后专门抽点时间多次阅读各种实例,仔细阅读文档,反复尝试各种写法。终于写出了一个相对良好的版本,直接先上代码:

renderHeader(h, { column, $index }) {
  return [
    column.label,
    h(
      'el-tooltip',
      {
        props: {
          content: (function() {
            let label = column.label
            switch (label) {
              case '访问数':
                return '网站页面上独立访问应用的人数(UV)'
                break
              case '提交数':
                return '网站页面上访客在应用上完成提交的数量'
                break
              case '成交数':
                return '网站页面上最终成功在应用上完成提交的数量'
                break
            }
          })(),
          placement: 'top'
        }
      },
      [
        h('span', {
          class: {
            'el-icon-question': true
          }
        })
      ]
    )
  ]
}

这个写法很特别,return的是一个数组,这个写法我又是哪里看到的呢?来自elementUI的table组件的表头自定义:想把单位换行,有什么解决方法吗?的采纳回复中。乍一看有点乱七八糟,不过仔细想想,之前的提示在整个表头都触发了,现在这个数组大概起到了拼接作用,也就是将不需要出发的textNode部分提了出来。再看数组第二个值,这便是一个完整的示例了。

其实心中还是有个疑问,为什么这里h(param1, param2, param3)的第三个参数用数组,数组中的第一个又是一个h(),并且这个对应的就是组件el-tooltip的HTML标签,没有它就无法正常渲染该组件。
本文转载自ElementUI的Table组件中的renderHeader方法研究
从vue官方解释中,可以发现createElement(String | Object | Function),三个参数分别对应(DOM节点名称,节点属性键值对,子级虚拟节点)。上述两种写法其实还是一种写法,至于是否直接返回节点或节点数组,应该是ELEMENT与VUE支持的问题。另外,如果createElement(String | Object | Function)需要创建的DOM节点不是HTML原生的,而是来自ELEMENT UI或其他UI组件或自定义的节点,要先确定这些非原生节点能否在DOM结构中正常显示,如果直接卸载DOM层中也无法正常显示,调用createElement()创建也没意义。

你可能感兴趣的:(ElementUI的Table组件中的renderHeader方法研究)