0.0.7 • Published 2 years ago

wzk-component-table v0.0.7

Weekly downloads
-
License
-
Repository
-
Last release
2 years ago

前端表格组件

提供通过配置快速展示Form表单,支持Element-UI中常用元素,如Input\Select\Radio等

主要思路是依托于ElementUI的Table通过类型映射,展示表格项。

使用说明

安装

npm install @hatech/component-table

初始化

// main.js
import HatechTable from '@hatech/component-table'
Vue.use(HatechTable)

// or
// xxx.vue
import { HatechTable } from '@hatech/component-table'
export default {
  components: { HatechTable }
}

使用示例

<hatech-table :config="config" :data="data" @onEvent="onEvent" @onTableEvent="onTableEvent">
export default {
  data() {
    return {
      data: [],
      config: {}
    }
  }
}

参数

参数名类型描述
dataArray表格数据源
configObject表格配置信息
config.tableObject表格配置信息,支持el-table所有属性
config.columnsArray表格项配置信息,支持el-table-column中所有属性
config.columns[].typeString表格项类型,详见下表表单项配置类型
config.columns[].propsObject单元格中显示组件属性
config.columns[].props.formatterFunction(value, row)值处理器,显示前会经由此函数处理

表格项配置类型

类型值类型名称说明
slot插槽会提供table-column-XXX的插槽,XXX为prop的值
expand展开行会提供table-column-expand的插槽编写扩展内容,且config.columns[].prop的值需要指定一个
customHeader自定义头会提供table-column-customHeader的插槽编写头部内容,且config.columns[].prop的值需要指定一个XXX 为该列的自定义插槽名称 table-column-XXX
text文本直接显示文本
action操作列支持button、文本风格的操作按钮
input输入框同el-input
number输入框同el-input-number
radio单选框同el-radio
checkbox多选框同el-checkbox
select下拉框同el-select
date日期选择框同el-date-picker
time时间选择框同el-time-picker
cascader级联同el-cascader
tag级联同el-tag, 支持props.split(字符串时间隔符),props.labelDef(显示标题字段)

插槽

当type为slot时,提供名为table-column-prop字段名,如prop为name,即table-column-name

自定义头

当type为customHeader时,提供名为table-column-customHeader编写头部内容,如果列prop为name,即table-column-name可以编写对应列的自定义内容

事件

onTableEvent:表格事件总处理,所有表格事件由此事件发射。即el-table本身相关事件

  • choice单选事件,将返回select-radio事件
  • 输入组件值变化,将触发onCellChange事件

onEvent:事件总处理,所有自定义事件由此事件发射

  • event:el-table触发的事件名
    • action类型点击事件,将在onEvent返回options中配置的event
  • params: 事件相关参数

主题变量

未使用主题变量

依赖

依赖名版本链接
hatech-web-component0.0.8http://git.hatech.com.cn:8088/hatech-web/hatech-web-template-component.git

知识点

使用共识

如已提供相关表格项,可直接使用。有个性化需要时,请通过slot实现

特点

该组件属于纯组件中的表格组件,属于基础组件

作者/维护者

名称联系方式参与部分
吴浩wuhaowh@hatech.com.cn初始版本开发