0.4.0 • Published 1 year ago

enn-schema-table v0.4.0

Weekly downloads
-
License
ISC
Repository
-
Last release
1 year ago

使用方法

import { SchemaTable, DataModel } from 'enn-schema-table'
  • @0.4.0 破坏性变更注意事项:

    • DataModel
      • 原有结果中的 message 改为 message。前缀 避免与 data 里已有的 message 冲突。
      • 参数统一化变更 xxxConfig -> xxxConf: axiosConfig -> axiosConf
    • Schema-table
      • .top-right-btn、.enn-schema-table-query .query-reset-btn 增加 margin-bottom: 15px; 解决与表格贴在一起的问题。
      • 参数统一化变更 xxxConfig -> xxxConf: SchemaTable: colConfig、dialogConfig、paginationConfig -> colConf、dialogConf、paginationConf
      • pageNumberKey、pageSizeKey 移动至 paginationConfig 中
    • BooleanResult、TextEllipsis 组件文件目录位置调整,移至 components 下
  • @0.3.0 变更注意事项

  • 注意:布局请使用 layout 参数进行配置,属性:newLayout、appendSearch 已去除(改用 newLayout: layout="title"; appendSearch: queryLayout="appendBtnSearch")!
  • 带有 Title 版本布局, schema-table 属性:layout === 'title' || !!title 时触发。

属性 Props

属性名称属性类型必须默认值描述
schemaObject字段描述文件,包含各个字段的信息
modelObject数据模型,包含 CURD 接口信息
model.queryObject传入初始的 query 信息,通常是分页信息 { pageSize: 10, pageNumber: 1 },pageSize 可以取 10/20/50,query 信息会在列表请求的时候带给后端
hasQueryBooleantrue是否包含搜索、筛选框、搜索按钮等
searchString''传入空字符串时,不包含搜索框;传入非空字符串时,显示搜索框,同时传入的字符串作为搜索框的占位符
queryLayoutStringdefault组件 query 布局模式,default/appendSearch/prependBtnSearch/appendBtnSearch 具体参数请查看下方 queryLayout 枚举值
layoutStringdefault组件布局模式,default/title/card 具体参数请查看下方 layout 枚举值
hasResetBooleanfalse是否展示重置按钮等
filtersArray[]字符串数组,可以包含要筛选的字段 key 值(schema 中的 name),或者字符串 '$timerange'(时间范围筛选专用)
tableAttrsObject传入 el-table 的参数,参考 el-table Table Attributes
hasOrderBooleantrue是否在表格的第一列展示序号,默认为全局序号(通过计算当前页和位置获得)
hasActionBooleantrue是否在表格的最右增加一个“操作”列;hasAction 为 true 时,下面的 canCreate/canEdit/canDelete 才会生效
canCreateBooleantrue是否显示新增按钮
canEditBooleantrue是否显示编辑按钮
canDeleteBooleantrue是否显示删除按钮
canMultipleDeleteBooleanfalse是否可以批量删除,需要配合 DataModel 的 multipleDeleteApi 批量删除按钮才会生效
showMultipleSelectBooleanfalse是否展示多选列
defaultSelectedArray默认选中的行
fetchOnEditBooleantrue展示编辑弹框时,是否会调用一次详情接口进行回填(某些场景下,列表接口只返回部分部分字段,只有详情接口会返回全部字段);若为 false,则会使用表格列表接口返回的 row 数据进行回填
defaultFormDataObject{}给新增、编辑对话框中的表单增加默认值
hasPaginationBooleantrue是否显示分页
maxHeightStringundefined表格行显示区域的最大高度,格式为 '500px' 这样的字符串
dialogWidthString'600px'新增、编辑对话框的宽度,也可以传百分比
dialogConfigObject{}dialog 配置对象
colConfigObject{}指定各列的参数(比如列宽),key 为字段的 name。可以指定名为 “$actionBtns”的字段来设置“操作”列
queryConfObject{}设置 query 参数的 key
paginationConfigObject{}进行 pagenation 相关设置
titleString-表格的标题,传入标题自动开启新版样式
newLayoutBooleanfalse使用新的布局
tooltipEffectStringlighttooltip effect 属性 dark/light

layout 枚举值

  • default: 最初始的布局,search 在 form 第一位,有搜索按钮。
  • title: table 组件包括了 title 的布局,table 操作按钮在 title 右侧。
  • card: 列表为卡片格式的布局。

queryLayout 枚举值

  • default: 最初始的布局,search 在 form 第一项,有搜索按钮(el-button type="primary")。
  • appendSearch: search 在最后一项,去除所有项的 label,有搜索按钮(el-button type="primary")。
  • prependBtnSearch: search 在 form 第一项,搜索按钮在 search input prepend (输入框 前置 内容)的位置。
  • appendBtnSearch: search 在 form 最后一项,搜索按钮在 search input append (输入框 后置 内容)的位置。

dialogConfig

属性名称属性类型必须默认值描述
closeOnClickModalBooleanfalse是否可以通过点击 modal 关闭 Dialog
dialogWidthString712px弹窗的 width

queryConf

属性名称属性类型必须默认值描述
searchKeyStringsearch列表请求入参关键词的 key
closePrefixBoolean是否关闭列表请求入参参数改成 key 开头前缀的功能,使用 schema 的 name 作为 key。
schemaObjectquery 专用的 schema,用于替换原有 schema
formConfObjectquery 专用的 config,可覆盖 props.formConf
defaultQueryObjectquery 默认值,用于重置按钮恢复到默认数据
showLabelBoolean是否展示 query 的 Label,新版(传入 titlenewLayout === true 时)默认 true
clearableBoolean/Objecttrue是否展示 query 中 select 的清除按钮
  • clearable 传 false,表示所有的 select 都关闭清除按钮
  • clearable 作为对象,传入 select 的 name ,可以关闭对应 select 的清除按钮

paginationConfig

属性名称属性类型必须默认值描述
pageSizesArray\<Number>分页器每页显示个数选择器的选项设置
pageNumberKeyStringpageNumber列表请求入参页码的 key
pageSizeKeyStringpageSize列表请求入参当前页条数的 key

colConfig

属性名称属性类型必须默认值描述
widthString对应列的宽度
minWidthString对应列的最小宽度
ellipsisBoolean对应列是否使用多行省略,默认2行
switchConfObjecttype 为 switch 时的展示配置
  • 通过 colConfigcolName 配置对应列
  • 其中操作列的 colName 为 $actionBtns
  • 其中序号列的 colName 为 $index

switchConf

属性名称属性类型必须默认值描述
minIconBooleantrue使用点的图标。自定义 icon 时,该项必须为 false
showIconBooleantrue是否显示 icon
activeTextStringdata true 时的文案,可直接在 schema 中配置
inactiveTextStringdata 不为 true 时的文案,可直接在 schema 中配置
activeIconStringdata true 时的 icon。minIcon false 时,默认值为 el-icon-success
inactiveIconStringdata 不为 true 时的 icon。minIcon false 时,默认值为 el-icon-error
activeValueBoolean/String/Numbertrueswitch 开值,可直接在 schema 中配置
inactiveValueBoolean/String/Numberfalseswitch 关值,可直接在 schema 中配置
strictModeBooleantrue使用三等号判断传入的值和 activeValue 是否相等

colConfig 示例

<template>
  ...
  <SchemaTable
    ...
    :colConfig="{
      $actionBtns: { width: 50 }
    }"
  >
  ...
</template>

插槽 Slots

插槽名称绑定值作用
queryschema(Object), data: (Object))用于插入自定义 query 表单
overrideQueryBtnsrow(Object)用于覆写 query 中搜索、重置后面的其他操作按钮(老版样式的新增、批量删除)
preQueryBtnsrow(Object)用于插入自定义操作,插入位置位于 query 区域(搜索按钮右侧,DOM 新增按钮之前)
queryBtnsrow(Object)用于插入自定义操作,插入位置位于 query 区域(搜索按钮右侧,DOM 批量删除按钮之后)
列插槽(每一列的插槽名称都不同,具体为 schema 中的 name 值)row(Object)/ data(Object)针对某一列的模板进行覆写,绑定的 row 为当前行的数据,data 为当前单元格(当前行当前列)的数据
createBtnonCreate(方法)覆写新增按钮,调用绑定的 onCreate 方法可以唤起默认的新增对话框
multipleDeleteBtnonMultipleDelete, multipleDeleteLoading, disabled, selectedRows,用于覆写批量删除按钮,调用绑定的 onMultipleDelete 可以自动处理批量删除逻辑
overrideHeaderBtnsrow(Object)用于覆写顶部操作按钮
headerBtnsrow(Object)(只有新版布局才会生效)用于插入顶部自定义操作,插入位置位于顶部按钮之后
overrideActionBtnsrow(Object)在 hasAction 为 true 时生效。用于覆写整个“操作”列
preActionBtnsrow(Object)操作列,编辑按钮左侧的插槽
postActionBtnsrow(Object)操作列,删除按钮右侧的插槽
actionBtnsrow(Object)操作列,编辑按钮和删除按钮中间的插槽
cardItemrow(Object)layout="card" 模式专属,卡片项插槽,完全覆盖卡片,包括内置的编辑、删除按钮等
cardContainerrow(Object)layout="card" 模式专属,卡片内容插槽

自定义“操作”栏按钮写法参考

<template #actionBtns="{ row }">
  <el-link
    type="primary"
    @click="onDispatch(row)"
  >
    下发
  </el-link>
</template>

Table Events

事件名参数说明
selectionChangeselectedRows, selectedRow当选择项发生变化时触发该事件。参数 selectedRows 表示选中的项数组,selectedRow 表示当前操作的项。selectAll 的时候 selectedRow 该项为 undefined
currentChangecurrentRow, oldCurrentRow单行选中
rowClickrow, column, event行点击事件。layout="card" 时为卡片项点击事件

Table Methods

  • 可使用 ref 获取并触发执行 | 函数名 | 参数 | 说明 | | --- | --- | --- | | onSearch | | 重置页码至1,并刷新列表 | | fetch | | 刷新当前页列表 | | onReset | | 重置 query 至默认值 | | onCreate | | 开启新增弹窗 | | onEdit | record | 开启编辑弹窗,参数为行数据 | | onDelete | record | 触发删除功能,参数为行数据 |

DataModel

使用

import { DataModel } from 'enn-schema-table';
// 生成实例
const dataModel = new DataModel({
  createApi: 'api',
  getApi: 'api',
  getMap(res) {
    return res;
  },
  getListApi: 'getListApi',
  getListMap(item) {
    return item;
  },
  updateApi: 'updateApi',
  deleteApi: 'deleteApi',
  multipleDeleteApi: 'multipleDeleteApi',
  query: { pageNumber: 1, pageSize: 10 },
  axiosConfig: {
    timeout: 10000,
  },
});
// 调用方式
async function test() {
  const createRes = await dataModel.create();
  const getRes = await dataModel.get();
  const getListRes = await dataModel.getListApi();
  const updateRes = await dataModel.update();
  const deleteRes = await dataModel.delete();
  const multipleDeleteRes = await dataModel.multipleDelete();
}

属性 Props

属性名称属性类型必须默认值描述
createApiStringpost 请求的 api,dataModel.
getApiStringget 请求的 api
getMapFunction处理 get 返回结果,处理完需要把结果返回
getListApiStringgetList 获取列表的 api,返回列表数据和 pagination 数据
getListMapFunctiongetList 结果 map 的回调函数,参数为结果每一项数据,处理完需要把结果返回
getListFuncFunction替代 getList 的函数,参数为 query
updateApiStringput 请求的 api
deleteApiStringdelete 请求的 api
multipleDeleteApi批量删除请求的 api,使用的 axios({ method: 'DELETE' }) 发请求
queryget 请求的参数
axiosConfigObjectaxios 的配置项

DataModelLocal

本地表格数据源

使用

import { SchemaTable, DataModelLocal } from 'enn-schema-table'
const localMd = new DataModelLocal({
  list: [{id: 1, a: 1}],
});

属性 Props

属性名称属性类型必须默认值描述
listArray列表全部的数据
createMapFunction处理列表创建的回填数据
getMapFunction处理 get 返回结果,处理完需要把结果返回
getListMapFunctiongetList 结果 map 的回调函数,参数为结果每一项数据,处理完需要把结果返回
updateMapFunction处理列表编辑的回填数据
queryObjectpageNumber, pageSize 参数
isDescBooleanlist 数据新增时的顺序。true:使用 list.unshift() 增加项

getAllData

Methods

  • 可使用 model.methodsName 调用 | 函数名 | 参数 | 说明 | | --- | --- | --- | | getAllData | removeId | 获取所有的数据,参数 true,表示删除每一项的 id |
0.4.0-beta.0

2 years ago

0.4.0-beta.1

2 years ago

0.4.0

1 year ago

0.3.0

2 years ago

0.3.2

2 years ago

0.3.1

2 years ago

0.2.2

2 years ago

0.2.1

2 years ago

0.1.0

2 years ago

0.2.0

2 years ago

0.1.1

2 years ago

0.0.40

2 years ago

0.0.38

2 years ago

0.0.39

2 years ago

0.0.25

2 years ago

0.0.37

2 years ago

0.0.30

2 years ago

0.0.31

2 years ago

0.0.32

2 years ago

0.0.33

2 years ago

0.0.34

2 years ago

0.0.35

2 years ago

0.0.36

2 years ago

0.0.26

2 years ago

0.0.27

2 years ago

0.0.28

2 years ago

0.0.29

2 years ago

0.0.20

2 years ago

0.0.21

2 years ago

0.0.22

2 years ago

0.0.23

2 years ago

0.0.24

2 years ago

0.0.16

3 years ago

0.0.17

3 years ago

0.0.18

2 years ago

0.0.19

2 years ago

0.0.14

3 years ago

0.0.15

3 years ago

0.0.12

3 years ago

0.0.13

3 years ago

0.0.11

3 years ago

0.0.10

3 years ago

0.0.9

3 years ago

0.0.8

3 years ago

0.0.7

3 years ago

0.0.6

3 years ago

0.0.5

3 years ago