iis服务器助手广告广告
返回顶部
首页 > 资讯 > 前端开发 > JavaScript >使用 render 函数封装高扩展的组件
  • 699
分享到

使用 render 函数封装高扩展的组件

2024-04-02 19:04:59 699人浏览 泡泡鱼
摘要

需求: 后台管理中常常有如下布局的数据展示需求: 像表格又不是表格,像表单又不是表单,实际上样子像表格,呈现的数据是一个对象,和 fORM 的绑定的值一样,我将其称为表单式表格。

需求:

后台管理中常常有如下布局的数据展示需求:

像表格又不是表格,像表单又不是表单,实际上样子像表格,呈现的数据是一个对象,和 fORM 的绑定的值一样,我将其称为表单式表格。

样式深的列是标题,浅的列是标题对应的取值,数据往往是服务器返回的,标题往往是定宽的,取值可能各种各样,比如显示一张图片,值为 01,需要显示是与否,有时候需要添加一个修改按钮,让用户能修改某些值,还需要设置某一列跨越几列。

先来看看一个基于 element ui 的实现

不好的实现:

在接手的项目看到一个实现,先看使用方式


<FormTable :data="lessonPackageArr" :fleldsInfo="lessonPackageInfo" :maxColumn="3" label-width="120px">
  <template #presentedHours="{ data }">
    <div class="flex-box between">
      <span>
        {{ data.presentedHours }}
      </span>
      <span class="column-btn" @click="editPresentedHours(data)">修改</span>
    </div>
  </template>
  <template #gifts="{ data }">
    <div class="flex-box between">
      <span>
        {{ data.gifts }}
      </span>
      <span class="column-btn" @click="editPresentedHours(data)">修改</span>
    </div>
  </template>
</FormTable>


lessonPackageInfo 对象如下结构:


// 一个对象,用于配置标题列和标题列对应的字段
// type 指定值的类型,现在组件内部设置可能显示哪些类型的值了
// 对于服务其返回 1 0 需要显示 是否的数,提供一个 map_data 来映射
// column 属性设置跨列
// 需要自定义显示内容 提供 slot
lessonPackageInfo: {
    orderType: { type: 'option', desc: '课时包类别', map_data: { 1: '首单', 2: '续费', 5: '赠课' } },
    combo: { type: 'text', desc: '套餐名称' },
    presentedHours: { type: 'text', desc: '赠送课时', slot: true },
    price: { type: 'text', desc: '标准价格' },
    gifts: { type: 'text', desc: '赠送礼物', column: 3, slot: true },
  }


  • props 不够直观,配置项多
  • 不是完全数据驱动

为何组件的配置项多不好?

对于这种需求很固定,组件的输入即 props 应该要最小化,组件功能要最大化,尽量给 props 提供默认值,这样才能提高团队的开发效率。

为何不是完全的数据驱动不好?

这个组件不是完全数据驱动的,需要自定义显示列是,需要编写模板。

如果需要自定义的列很多,就要写很多模板代码,想要再提取,只能再次封装组件,不提取,模板代码可能会膨胀,你可能经常看到动辄 500 行一行的 template ?而膨胀的模板代码,让组件维护变得困难,需要 template js 代码之间来回切换。再者,增加一列自定义的数据,起码要修改两个地方。

为何需要完全的数据驱动?

虽然有 slot 来扩展组件,但是我们在写业务组件时候应该少用,而是尽量使用数据驱动模板。因为数据是 js 代码,当组件代码膨胀时,很容易把 js 代码提取成单独的文件, 而想要提取 slot 的代码,只能再封装组件。

三大前端框架的设计理念都是数据驱动模板,这是它们区别于 Jquery 的重要特征,也是我们封装业务组件时优先遵循的原则。

看了组件使用的问题,再看组件的代码:


<template>
  <div v-if="tableData.length" class="form-table">
    <div v-for="(data, _) in tableData" :key="_" class="table-border">
      <el-row v-for="(row, index) in rows" :key="index">
        <el-col v-for="(field, key) in row" :key="key" :span="getSpan(field.column)">
          <div v-if="(field.disabled && data[key]) || !field.disabled" class="column-content flex-box between">
            <div class="label" :style="'width:' + labelWidth">
              <span v-if="field.required" class="required">*</span>
              {{ field.desc }}
            </div>
            <div class="text flex-item" :title="data[key]">
              <template v-if="key === 'minAge'">
                <span>{{ data[key] }}</span>
                -
                <span>{{ data['maxAge'] }}</span>
              </template>
              <template v-else-if="key === 'status'">
                <template v-if="field.statusList">
                  <span v-if="data[key] == 0" :class="field.statusList[2]">{{ field.map_data[data[key]] }}</span>
                  <span v-else-if="data[key] == 10 || data[key] == 34" :class="field.statusList[1]">
                    {{ field.map_data[data[key]] }}
                  </span>
                  <span v-else :class="field.statusList[0]">{{ field.map_data[data[key]] }}</span>
                </template>
                <span v-else>{{ field.map_data[data[key]] }}</span>
              </template>

              <slot v-else :name="key" v-bind:data="data">
                <TableColContent
                  :dataType="field.type"
                  :metaData="data[key]"
                  :mapData="field.map_data"
                  :text="field.text"
                />
              </slot>
            </div>
          </div>
        </el-col>
      </el-row>
    </div>
  </div>
  <div v-else class="form-table empty">暂无数据</div>
</template>

<script>
  import TableColContent from '@/components/TableColContent'
  export default {
    name: 'FormTable',
    components: {
      TableColContent,
    },
    props: {
      // 数据
      data: {
        required: true,
        type: [Object, Array, null],
      },
      // 字段信息
      fleldsInfo: {
        required: true,
        type: Object,
        // className: { type: "text", desc: "班级名称", column: 3 },
      },
      // 最多显示列数
      maxColumn: {
        required: false,
        type: Number,
        default: 2,
      },
      labelWidth: {
        required: false,
        type: String,
        default: '90px',
      },
    },
    data() {
      return {}
    },
    computed: {
      tableData() {
        if (!this.data) {
          return []
        }
        if (this.data instanceof Array) {
          return this.data
        } else {
          return [this.data]
        }
      },
      rows() {
        const returnArray = []
        let total = 0
        let item = {}
        for (const key in this.fleldsInfo) {
          const nextTotal = total + this.fleldsInfo[key].column || 1
          if (nextTotal > this.maxColumn) {
            returnArray.push(item)
            item = {}
            total = 0
          }
          total += this.fleldsInfo[key].column || 1
          item[key] = this.fleldsInfo[key]
          if (total === this.maxColumn) {
            returnArray.push(item)
            item = {}
            total = 0
          }
        }
        if (total) {
          returnArray.push(item)
        }
        return returnArray
      },
    },
    methods: {
      getSpan(column) {
        if (!column) {
          column = 1
        }
        return column * (24 / this.maxColumn)
      },
    },
  }
</script>

有哪些问题?

  • 模板有太多的条件判断,不优雅
  • 自定义显示列,还需要在引入 TableColContent,增加了组件复杂性

TableColContent 内部还是对配置项的 type 进行条件判断

部分代码:


<span v-else-if="dataType === 'image' || dataType === 'cropper'" :class="className">
  <el-popover placement="right" title="" trigger="hover">
    <img :src="metaData" style="max-width: 600px;" />
    <img slot="reference" :src="metaData" :alt="metaData" width="44" class="column-pic" />
  </el-popover>
</span>


分析完以上实现的问题,看看好的实现:

好的实现:

先看使用方式:


<template>
  <ZmFormTable :titleList="titleList" :data="data" />
</template>
<script>
  export default {
    name: 'Test',
    data() {
      return {
        data: {}, // 从服务器获取
        titleList: [
          { title: '姓名', prop: 'name', span: 3 },
          {
            title: '课堂作品',
            prop: (h, data) => {
              const img =
                (data.workPic && (
                  <ElImage
                    style='width: 100px; height: 100px;'
                    src={data.workPic}
                    preview-src-list={[data.workPic]}
                  ></ElImage>
                )) ||
                ''
              return img
            },
            span: 3,
          },
          { title: '作品点评', prop: 'workComment', span: 3 },
        ],
      }
    },
  }
</script>


组件说明: titleList是组件的列配置,一个数组,元素 title 属性是标题,prop 指定从 data 里取值的字段,span 指定这列值跨越的行数。

prop 支持 string ,还支持函数,这是实现自定义显示的方式,当这个函数很大时,可提取到独立的 js 文件中,也可以把整个 titleList 提取单独的 js 文件中。

参数 h 和 data 是如何传递进来的?或者 这函数在哪调用呢?

h 是 createElement 函数,data 是从组件内部的 data,和父组件传入的 data 是同一个值。

当普通函数的第一个参数是 h 是,它就是一个 render 函数。

这种方式使用起来简单多了。

看看内部实现:

<template>
  <div class="form-table">
    <ul v-if="titleList.length">
      <!-- titleInfo 是经过转化的titleList-->
      <li
        v-for="(item, index) in titleInfo"
        :key="index"
        :style="{ width: ((item.span || 1) / titleNumPreRow) * 100 + '%' }"
      >
        <div class="form-table-title" :style="`width: ${titleWidth}px;`">
          <Container v-if="typeof item.title === 'function'" :renderContainer="item.title" :data="data" />
          <span v-else>
            {{ item.title }}
          </span>
        </div>
        <div class="form-table-key" :style="`width:calc(100% - ${titleWidth}px);`">
          <Container v-if="typeof item.prop === 'function'" :renderContainer="item.prop" :data="data" />
          <span v-else>
            {{ ![null, void 0].includes(data[item.prop] && data[item.prop]) || '' }}
          </span>
        </div>
      </li>
    </ul>
    <div v-else class="form-table-no-data">暂无数据</div>
  </div>
</template>

<script>
  import Container from './container.js'
  export default {
    name: 'FormTable',
    components: {
      Container,
    },
    props: {
      titleWidth: {
        type: Number,
        default: 120,
      },
      titleNumPreRow: {
        type: Number,
        default: 3,
        validator: value => {
          const validate = [1, 2, 3, 4, 5, 6].includes(value)
          if (!validate) {
            console.error('titleNumPreRow 表示一行有标题字段对,只能时 1 -- 6 的偶数,默认 3')
          }
          return validate
        },
      },
      titleList: {
        type: Array,
        default: () => {
          return []
        },
        validator: value => {
          const validate = value.every(item => {
            const { title, prop } = item
            return title && prop
          })
          if (!validate) {
            console.log('传入的 titleList 属性的元素必须包含 title  和 prop 属性')
          }
          return validate
        },
      },
      data: {
        type: Object,
        default: () => {
          return {}
        },
      },
    },
  }
</script>
<!-- 样式不是关键,省略 -->

实现自定义显示的方式,没有使用动态插槽,而是用一个函数组件Container,该组件接收一个 render 函数作为 prop


export default {
  name: 'Container',
  functional: true,
  render(h, { props }) {
    return props.renderContainer(h, props.data)
  },
}

Container 内部调用 titleList 传入的函数。

总结:

  • 封装组件时优先考虑数据驱动
  • 普通函数的第一个参数是 h,就是渲染函数
  • 可能有一些人不习惯写 JSX, 可兼容两种写法

到此这篇关于使用 render 函数封装高扩展的组件的文章就介绍到这了,更多相关 render 函数封装高扩展组件内容请搜索编程网以前的文章或继续浏览下面的相关文章希望大家以后多多支持编程网!

--结束END--

本文标题: 使用 render 函数封装高扩展的组件

本文链接: https://www.lsjlt.com/news/161242.html(转载时请注明来源链接)

有问题或投稿请发送至: 邮箱/279061341@qq.com    QQ/279061341

本篇文章演示代码以及资料文档资料下载

下载Word文档到电脑,方便收藏和打印~

下载Word文档
猜你喜欢
  • 使用 render 函数封装高扩展的组件
    需求: 后台管理中常常有如下布局的数据展示需求: 像表格又不是表格,像表单又不是表单,实际上样子像表格,呈现的数据是一个对象,和 form 的绑定的值一样,我将其称为表单式表格。 ...
    99+
    2024-04-02
  • vue中使用render封装一个select组件
    目录使用render封装一个select组件vue另类封装--render函数封装先看看文件的结构render函数封装使用render封装一个select组件 父组件 val...
    99+
    2024-04-02
  • Vue3 封装扩展并简化Vuex在组件中的调用问题
    目录1.创建文件utils/vueTool.js2.添加开发环境中的模块验证3.页面调用封装如果你在项目中使用了 vuex模块化,并且在项目中使用actions中函数调用频率高,推荐...
    99+
    2023-01-28
    Vue3 封装扩展 Vuex 组件 调用
  • 使用vue组件封装共用的组件
    目录这里提供两种vue封装共用组件的方法方法一方法二vue封装公共组件调用方法这里提供两种vue封装共用组件的方法 方法一 main.js中 import ListItem from...
    99+
    2024-04-02
  • vue中的render函数、h()函数、函数式组件详解
    目录一、什么是render二、vue中的render三、函数式组件补充 h函数使用场景一、什么是render 官网:用于编程式地创建组件虚拟 DOM 树的函数。 在我们使用webpa...
    99+
    2023-02-09
    vue render函数 vue  h()函数 vue函数式组件
  • ECMAscrip函数的扩展怎么使用
    本篇内容主要讲解“ECMAscrip函数的扩展怎么使用”,感兴趣的朋友不妨来看看。本文介绍的方法操作简单快捷,实用性强。下面就让小编来带大家学习“ECMAscrip函数的扩展怎么使用”吧!1.函数参数的默认值1.1函数参数指定默认值在ECM...
    99+
    2023-06-21
  • Linux 系统下使用 npm 安装 PHP 的数组扩展?
    在 Linux 系统下使用 npm 安装 PHP 的数组扩展可能会是一个有用的技巧,尤其是当你正在开发一个 PHP 应用程序,并且需要使用一些比较高级的数组操作时。本文将介绍如何使用 npm 安装 PHP 的数组扩展,并提供一些示例代码来演...
    99+
    2023-06-18
    linux 数组 npm
  • 怎么使用PostgreSQL扩展函数
    这篇文章主要讲解了“怎么使用PostgreSQL扩展函数”,文中的讲解内容简单清晰,易于学习与理解,下面请大家跟着小编的思路慢慢深入,一起来研究和学习“怎么使用PostgreSQL扩展函数”吧!例子.&nb...
    99+
    2024-04-02
  • 如何使用 PHP 函数扩展?
    通过编写 php 扩展模块,可以添加新函数或修改现有函数,实现自定义需求。具体步骤包括:创建 php 源代码文件;使用 phpize 初始化扩展;运行 configure 脚本生成 ma...
    99+
    2024-04-16
    函数 php扩展
  • 如何使用 PHP 扩展函数?
    php 扩展函数是核心组件之外的附加功能,可扩展 php 的功能。安装扩展函数后,在 php.ini 中启用它们,然后使用扩展函数,例如 imagick 扩展用于处理图像。您可以使用命令...
    99+
    2024-04-16
    php 扩展函数 composer
  • 如何使用 PHP 函数扩展?
    通过编写 php 扩展模块,可以添加新函数或修改现有函数,实现自定义需求。具体步骤包括:创建 php 源代码文件;使用 phpize 初始化扩展;运行 configure 脚本生成 ma...
    99+
    2024-04-16
    函数 php扩展
  • 如何使用vue组件封装共用的组件
    这篇文章主要介绍了如何使用vue组件封装共用的组件的相关知识,内容详细易懂,操作简单快捷,具有一定借鉴价值,相信大家阅读完这篇如何使用vue组件封装共用的组件文章都会有所收获,下面我们一起来看看吧。这里提供两种vue封装共用组件的方法方法一...
    99+
    2023-06-30
  • 如何使用 Mockery 扩展 PHP 函数?
    使用 mockery 来扩展 php 函数,通过以下步骤模拟函数的行为:安装 mockery 库。使用 mockery::mock('alias:函数名称') 创建模拟函数,其中 ali...
    99+
    2024-04-11
    php函数 mockery composer
  • 如何使用 Hamcrest 扩展 PHP 函数?
    是的,通过使用 hamcrest 可以扩展 php 函数以增强测试可读性:使用 extend() 方法扩展函数,将函数名和 hamcrest 匹配器作为参数。对于泛型函数,指定类型提示。...
    99+
    2024-04-11
    php hamcrest composer
  • 如何使用 Prophecy 扩展 PHP 函数?
    使用 prophecy 扩展 php 函数可通过以下步骤实现:使用 composer 安装 prophecy。使用 prophesize() 方法创建桩对象。使用 will() 方法配置...
    99+
    2024-04-11
    php prophecy composer
  • 如何使用 RespectPHP 扩展 PHP 函数?
    respectphp 扩展 php 的验证功能,让开发者轻松验证数据类型。它提供了广泛的验证规则,支持链接形成复杂、可读的验证链。常见的用途包括表单验证,其中 respectphp 与 ...
    99+
    2024-04-11
    php函数 composer
  • 如何使用 SinonPHP 扩展 PHP 函数?
    sinonphp 允许扩展或覆盖 php 函数和方法,用于单元测试或定制代码行为。它提供了以下主要功能:扩展函数:使用 sinonphp\stub 函数扩展已有的 php 函数。扩展方法...
    99+
    2024-04-11
    php sinonphp composer 作用域
  • 使用 PHP 函数的最佳实践:高并发和可扩展性?
    遵循 php 函数最佳实践可提升高并发和可扩展性。具体做法包括:1. 优先使用内置函数;2. 缓存函数结果;3. 限制递归深度;4. 使用惰性求值;5. 并行处理大型数据集。 PHP ...
    99+
    2024-05-05
    高并发 可扩展性 堆栈溢出
  • PHP中如何使用 function函数扩展
    这篇文章将为大家详细讲解有关PHP中如何使用 function函数扩展,文章内容质量较高,因此小编分享给大家做个参考,希望大家阅读完这篇文章后对相关知识有一定的了解。PHP function函数扩展的代码示例:< php &...
    99+
    2023-06-17
  • 使用PHP自定义函数扩展数组交集和并集的功能
    使用 php 自定义函数可扩展数组交集和并集功能,自定义交集函数允许按键或值查找交集,而自定义并集函数按键或值查找并集。这使您能够基于特定需求灵活操作数组。 使用 PHP 自定义函数扩...
    99+
    2024-05-01
    编程语言 数组操作
软考高级职称资格查询
编程网,编程工程师的家园,是目前国内优秀的开源技术社区之一,形成了由开源软件库、代码分享、资讯、协作翻译、讨论区和博客等几大频道内容,为IT开发者提供了一个发现、使用、并交流开源技术的平台。
  • 官方手机版

  • 微信公众号

  • 商务合作