simple-table-plus
v1.0.5
Published
schema config table depends on element-plus
Downloads
267
Readme
SimpleTable 简单列表
介绍
基于 element-ui-plus 以及 mc-form-plus, 使用 config 对象进行配置生成的简单列表
引入
安装: npm i --save @hxyfe/simple-table
全局注册:
import Vue from 'vue';
import SimpleTable from '@hxyfe/simple-table';
Vue.component(SimpleTable.name, SimpleTable);
API
Props
表单组件的属性:
| 参数 | 说明 | 类型 | 默认值 | | ------------ | ---------------------------------------------- | -------------------------- | ------- | | api | 列表请求数据的方法(必须) | Function | - | | config | 当前列表的配置参数(必须) | Object | - | | commonParams | 其他请求的公共参数,如果有改变则会自动发起请求 | Object | - | | defaultFetch | 默认列表发起第一次请求的时机 | created/mounted/其他任意值 | created |
除上面列出的属性外,其他定义在
SimpleTable
上的属性均会透传给element-ui
的 Table 组件
api 的要求:
- 必须是一个返回 promise 的函数
- 该函数的入参是接口的请求参数
- 返回的resolve 的对象包含两个键名 列表总数据量 totalRecord 和 当前请求的列表数据 recordList
- 也就是说结构为: { totalRecord: 0, recordList: [] }
// api 的示例代码
api(params) {
// 如果有其他固定参数,也可以在这里传入
// 例如 : params.xxx = 'xxx';
return this.$http.post('/list', params).then((res) => {
const data = {};
data.totalRecord = res.totalRecord;
data.recordList = res.recordList || [];
return data;
});
},
commonParams 的说明:
- 如果请求列表数据的接口入参除了搜索条件外还有其他入参则可以使用该属性传入
- 该属性会被深度监听,如果有任何变动则会发起新的请求
- 由于该属性变动导致发起的请求不会重置其他条件,也就是搜索条件和翻页都不会做修改
- 如果是不需要响应的请求参数就不应该定义在该属性内,可以在定义 api 方法时传入
defaultFetch 的说明:
- created: 在组件 created 时机发起第一次请求;
- mounted: 在组件 mounted 时机发起第一次请求;
- 其他任意值: 不自动发起第一次请求,需要使用者主动发起请求
config 对象的属性:
| 参数 | 说明 | 类型 | 默认值 | | ---------- | ------------------ | -------------- | ------ | | search | 列表的搜索参数 | Object | - | | columns | 列表的配置参数 | Array | - | | pagination | 列表的翻页配置参数 | boolean/Object | - |
config 的说明:
- search 的具体配置和 mc-form 配置参数完全一致,请参考该组件文档进行配置
- columns 中扩展了 renderCell 属性,可以定义一个字符串或者一个方法
- 如果定义的是字符串,则该字符串代表一个
SimpleTable
具名 slot-scope - 如果定义的是方法,则该方法不要使用箭头函数定义,且不要进行
this
绑定 - 如果定义的是方法,该方法内部
this
将直接指向当前vm
实例,也就是可以拿到当前实例上的方法和数据,且该方法可以写jsx
- columns 中的配置大部分直接透传给 table-column ,所以除了
renderCell
外,其他和 element-ui 中的属性一模一样
- 如果定义的是字符串,则该字符串代表一个
- pagination 配置了列表的翻页数据
- 如果没有该属性,或者属性值为一个 “假值” 则不渲染翻页器,且请求参数中也不会有相关参数
- 如果传入一个非对象真值,例如
true
,则会使用默认的配置参数渲染翻页器 - 如果传入一个对象值,则会使用该对象配置对默认配置进行覆盖
- 翻页器使用的是 Pagination 实现,所以具体可配置项也和该组件一模一样
Events
和 Table 支持的事件一样
方法
通过 ref 可以获取到 SimpleTable 实例并调用实例方法
| 方法名 | 说明 | 参数 | 返回值 | | ------------ | ------------ | ------- | ------ | | fetchRecords | 重新请求数据 | - | - | | reset | 重置搜索条件 | boolean | - |
reset 如果传入 “真值” 则重置搜索条件并且发起请求,否则只重置搜索条件
<simple-table
ref="sTable"
:api="api"
:config="config"
:commonParams="commonParams"
defaultFetch="mounted"
></simple-table>
fetch() {
this.$refs.sTable && this.$refs.sTable.fetchRecords();
},
// 或者操作列表内置的 form ,但是不建议做这种操作
// this.$refs.sTable.$refs.form.setOptions('categoryId', 'data', d);
代码演示
基础用法
使用该组件后,一个列表基本写完配置就写完了
<simple-table ref="sTable" :api="api" :config="config" :commonParams="commonParams">
<template slot="test" slot-scope="{ row }">
<span>{{ row.type | test }}</span>
</template>
</simple-table>
import { api } from '../mock/index';
const COLUMNS = [
{
type: 'index',
width: '50',
align: 'center',
label: '序号',
},
{
property: 'appId',
'show-overflow-tooltip': true,
width: '150',
label: '公众号ID',
},
{
property: 'wechatName',
'show-overflow-tooltip': true,
minWidth: '200',
label: '名称',
},
{
'show-overflow-tooltip': true,
minWidth: '200',
label: '测试 slot',
renderCell: 'test',
},
{
'show-overflow-tooltip': true,
minWidth: '200',
label: '测试 箭头函数',
renderCell: ({ row }) => typeof row,
},
{
'show-overflow-tooltip': true,
width: '100',
label: '公众号类型',
renderCell({ row }) {
return <span>{row.type}</span>;
},
},
{
width: '230',
label: '操作',
align: 'center',
fixed: 'right',
renderCell({ row }) {
const { log } = this;
return (
<div>
<el-button type='text' onClick={() => log(row.wechatName)}>
打印name
</el-button>
<el-button type='text' onClick={() => log(row.appId)}>
打印appId
</el-button>
</div>
);
},
},
];
// 搜索表单配置
const FORM_CONFIG = {
gutter: 20,
labelWidth: '100px',
properties: [
{
field: 'itemCode',
value: null,
label: '商品编号',
type: 'text',
ui: {
column: 8,
},
},
{
field: 'itemName',
value: null,
label: '商品名称',
type: 'text',
ui: {
column: 8,
},
},
{
field: 'goodsStatus',
value: null,
label: '商品状态',
type: 'select',
ui: {
column: 8,
clearable: true,
},
options: {
data: [{ label: '嘿嘿嘿', value: '1' }],
},
},
{
field: 'scanStartTime-scanEndTime',
value: null,
label: '时间',
type: 'datetimerange',
ui: {
column: 16,
},
},
],
};
export default {
filters: {
test(val) {
return val % 2 ? '嘿嘿' : '哈哈';
},
},
data() {
return {
config: {
search: FORM_CONFIG,
columns: [...COLUMNS],
pagination: true,
},
commonParams: {},
};
},
methods: {
log(msg) {
console.log(`点击打印数据:${msg}`);
},
api(data) {
console.log('当前请求参数为', data);
return api(data);
},
},
};
// '../mock/index';
const item = {
id: 2,
wechatId: 'aaaaaa',
wechatName: '测试公众号',
appId: '1414',
type: 2,
};
let start = 0;
const getList = () => {
const recordList = [];
for (let i = 0; i < 10; i++) {
const temp = { ...item };
Object.keys(temp).forEach((k) => {
temp[k] += start++;
});
recordList.push(temp);
}
return recordList;
};
export const api = () => Promise.resolve({
totalRecord: 666,
recordList: getList(),
});