Ant Design Vue 实现可变列宽功能,封装一个hook开箱即用

背景:用户需要实现可变列宽功能,但是项目当中UI框架绑定过深,无法通过升级UI框架的方式实现功能,需要在Ant Design Vue2.x上扩展功能。

一,依赖环境

Vue3、TypeScript、interactjs。

二、实现思路

通过interactjs结合table组件components接口使得DOM元素可以拖动,然后获取每次拖动的值进行设置表格宽度即可。

三、具体代码

import { Ref, h, onMounted, onUpdated, ref } from 'vue';
import { Table } from 'ant-design-vue';
import interact from 'interactjs';
import _ from 'lodash-es';
import { userProfile } from '/@/store/modules/user-profile';
import { useRoute } from 'vue-router';

/**
 * 修改表格列宽,并且上传表格
 * @param tableId 表格id 当前业务需求需要保存配置,可根据需求调整
 * @param columns 表格列
 * @param disable 是否能够调整表格宽度
 * @returns 绑定表格的ref变量
 */
export function useChangeColumnWidth(tableId: string, columns: Ref<any[]>, disable?: boolean) {
  let headTr: HTMLElement | null = null;
  let colgroup: HTMLElement | null = null;
  let HeaderColgroup: HTMLElement | null = null;
  const tableRef = ref<InstanceType<typeof Table>>();
  const route = useRoute();
  const id = tableId + route.path.replaceAll('/', '-');
  // ant-design 只定义表头渲染函数
  const ResizeAbleTitle = (props: any, children: any) => {
    const { key, ...restProps } = props;
    if (disable) return h('th', { ...restProps }, children);
    return h(
      'th',
      {
        ...restProps,
        key,
        onVnodeMounted(e: any) {
          interact(e.el).resizable({
            edges: { top: false, left: false, bottom: false, right: true },
            listeners: {
              move: function (event) {
                const { width } = event.rect;
                if (width <= 100) return;
                // 查询当前节点索引
                const i = findIndex(headTr?.children!, event.target);
                if (!colgroup) initElement();
                const handCol = colgroup?.children[i] as HTMLElement;
                const bodyCol = HeaderColgroup?.children[i] as HTMLElement;
                const params = {
                  width,
                  minWidth: 100,
                };
                setElementWidth(event.target, params);
                handCol && setElementWidth(handCol, params);
                bodyCol && setElementWidth(bodyCol, params);
                // 关闭元素的点击事件
                event.target.style.pointerEvents = 'none';
                changeColumnsWidth(
                  columns?.value.find((item) => item.dataIndex === key),
                  width,
                  id,
                  () => {
                    event.target.style.pointerEvents = 'auto';
                  }
                );
              },
            },
          });
        },
      },
      children
    );
  };

  // 初始化元素
  const initElement = () => {
    const table = tableRef.value?.$el as HTMLDivElement;
    // 可根据实际DOM结构调整,这里是需要调整宽度的元素集合
    headTr = table.querySelector('.ant-table-thead > tr');
    colgroup = table.querySelector('.ant-table-body > table > colgroup')!;
    HeaderColgroup = table.querySelector('.ant-table-header > table > colgroup')!;
  };
  onMounted(() => {
    initElement();
  });
  onUpdated(() => {
    initElement();
  });
  return {
    tableRef,
    ResizeAbleTitle,
  };
}

// 设置元素宽度
function setElementWidth(el: HTMLElement, { width, minWidth }: any) {
  Object.assign(el.style, {
    width: `${width}px`,
    minWidth: `${minWidth}px`,
    // height: `${event.rect.height}px`,
    // transform: `translate(${x}px, ${y}px)`,
  });
}

//查找元素所在位置
function findIndex(listNodes: HTMLCollection, el: HTMLElement) {
  for (let i = 0; i < listNodes.length; i++) {
    if (listNodes[i] === el) {
      return i;
    }
  }
  return -1;
}

// 收集用户习惯,防抖处理
const changeColumnsWidth = _.debounce(
  (col: any, width: number, id: string, callbackFn?: () => void) => {
    col.width = width;
//  根据业务需求自行调整,这里可以上传到服务器保存用户习惯
//    userProfile.setUserTableConfig({
//      resourceId: id,
//      tableConfig: JSON.stringify({ [col.dataIndex]: { width } }),
//    });
    callbackFn && callbackFn();
  },
  500
);

四、使用方法

<template>
  <Table ref="tableRef" :components="components"
    :columns="newColumns.length ? newColumns : undefined">
    .....
  </Table>
</template>

<script lang="ts">
import { PropType, computed, ref, watch, defineComponent } from 'vue';
import { Table } from 'ant-design-vue'
import { useChangeColumnWidth } from './hook/useChangeColumnWidth';
export default defineComponent({
  components: { Table },
  props: {
    columns: {
      type: Array as PropType<any[]>,
      default() {
        return [] as PropType<any[]>
      }
    },
    tableId: { // 表格的uuid唯一标识
      type: String as PropType<string>,
      default: ""
    },
    noChangeWidth: { // 禁止修改列宽
      type: Boolean,
      default: false
    },
    scroll: {
      type: Object as PropType<{ x: number, y: number }>,
    }
  },
  setup(props) {
    const filterList = ['operation', 'index']
    const newColumns = ref<any[]>([...formatColumn(props.columns)])
    watch(() => props.columns, (value: any[]) => {
      newColumns.value = formatColumn(value)
    })

    const { tableRef, ResizeAbleTitle } = useChangeColumnWidth(props.tableId, newColumns, props.noChangeWidth);
    const components = {
      header: {
        cell: ResizeAbleTitle,
      },
    };
    return {
      newColumns,
      tableRef,
      components,
    }
  }
})
</script>

<style scoped>
</style>

见谅,时间关系实现过程没有写的很详细,后续有时间再补

  • 0
    点赞
  • 1
    收藏
    觉得还不错? 一键收藏
  • 0
    评论
### 回答1: ant-design-vue一个基于Vue.js的UI组件库,提供了丰富的组件供开发者使用。在ant-design-vue中,我们可以使用表格组件来展示和编辑数据,同时还可以进行表格的校验。 在ant-design-vue的表格中,我们可以通过配置rules属性来实现校验功能。每个表格列都可以设置rules属性,该属性接受一个数组,数组中每个对象代表一条校验规则。 每条校验规则对象中需要指定validator属性,该属性是一个函数,用来校验对应表格列的数据。在validator函数中,我们可以根据具体需求编写校验逻辑,比如判断输入是否为空、是否满足特定格式等。validator函数需要返回一个Boolean值,true表示校验成功,false表示校验失败。 除了validator函数外,校验规则对象还可以指定message属性,用来定义校验失败时的提示信息。当校验失败时,ant-design-vue会自动显示message中的内容。 在表格中使用校验功能时,我们可以通过监听表单提交事件来进行校验。在提交事件中,我们可以通过表格的validate方法来执行校验操作。validate方法会遍历所有表格列的校验规则,根据规则来验证数据。如果所有校验规则都通过,则提交成功;如果存在校验失败的规则,则提交失败,并且会自动显示相应的提示信息。 总结来说,通过ant-design-vue内置的校验功能,我们可以方便地对表格中的数据进行校验,提高用户输入的准确性和数据的可靠性。 ### 回答2: ant-design-vue(以下简称AntD)提供了一种方便的方式来实现表格校验。在AntD中,表格校验是通过自定义校验规则和使用校验器函数来实现的。 首先,我们需要创建一个自定义的校验规则对象。可以使用AntD提供的`Validators`来创建一个规则对象,例如: ```javascript import { Validators } from 'ant-design-vue'; const customValidationRule = Validators.pattern(/\d+/); ``` 上述代码创建了一个校验规则对象,该规则会检查输入值是否匹配正则表达式`/\d+/`,即是否为数字。 接下来,我们需要在表格的列定义中使用该校验规则。在AntD的Table组件的columns属性中,我们可以使用`scopedSlots`来自定义列的渲染方式。在这里,我们可以使用`edit`字段来实现可编辑的单元格,并应用校验规则。 ```javascript const columns = [ { title: '姓名', dataIndex: 'name', scopedSlots: { customRender: 'name', edit: (text, record, index) => { return ( <a-input v-decorator={['name', { rules: [{ validator: customValidationRule }] }]} placeholder='请输入姓名' /> ) } } }, // 其他列... ]; ``` 上述代码中的`v-decorator`用于绑定校验规则,`rules`属性用于指定校验规则对象。此处我们使用了之前创建的`customValidationRule`规则。在用户输入时,AntD会自动校验输入是否符合规则。 最后,我们需要对整个表单使用AntD的`Form`组件进行校验。在提交表单时,使用`form.validateFields`方法来手动校验所有字段。 ```javascript <template> <a-form @submit="handleSubmit"> <a-table :columns="columns" :dataSource="data"> <span slot='name' slot-scope='text, record, index'> {{ record.name }} </span> </a-table> <a-button type='primary' html-type='submit'>提交</a-button> </a-form> </template> <script> export default { // ... methods: { handleSubmit() { this.$refs.form.validateFields((errors, values) => { if (errors) { console.log('表格校验未通过'); return; } console.log('表格校验通过'); console.log(values); // 处理表单数据 }); }, }, } </script> ``` 上述代码中的`validateFields`方法会遍历表单中所有绑定校验规则的字段,并进行校验。如果校验未通过,则会通过`errors`参数返回错误信息。如果校验通过,则`values`参数会返回表格中所有的字段值。 这就是AntD中实现表格校验的方法。我们只需要定义校验规则、在列定义中应用规则,并在提交时对整个表单进行校验。这样可以有效地实现对表格中输入值的校验。 ### 回答3: ant-design-vue一个基于 Vue.js 的 UI 组件库,提供了丰富的组件用于开发界面。在 ant-design-vue 中,表格校验是一个常见的需求。 在 ant-design-vue 的表格组件中,我们可以通过配置校验规则来实现表格校验。首先,我们需要为表格的列定义校验规则。可以使用 `customRender` 属性来自定义渲染表格单元格的内容,并在自定义的渲染函数中添加校验规则。 当我们需要对单元格的内容进行校验时,可以使用内置的校验规则,例如,`required` 表示必填项,`min` 和 `max` 表示最小值和最大值。如果内置的校验规则不能满足需求,我们还可以自定义校验规则。 在校验规则中,我们可以通过 `validator` 属性来指定校验函数。校验函数接收三个参数:`rule`,`value` 和 `callback`。`rule` 表示当前的校验规则,`value` 表示当前单元格的内容,`callback` 用于异步校验。我们可以在校验函数中判断 `value` 是否满足规则,并通过调用 `callback` 返回校验结果。 在校验函数中,如果发现校验失败,可以通过 `callback` 返回一个错误信息,这样 ant-design-vue 会自动显示错误提示,并阻止表格单元格内容的修改。 总的来说,ant-design-vue 提供了丰富的表格校验功能,可以通过配置校验规则和自定义校验函数来实现表格数据的校验。这样可以有效地提高数据的准确性和完整性,为用户提供更好的交互体验。

“相关推荐”对你有帮助么?

  • 非常没帮助
  • 没帮助
  • 一般
  • 有帮助
  • 非常有帮助
提交
评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值