使用说明
em-element-ui该组件是基于Vue和element-ui开发,该组件主要用于快速开发列表的增删查改功能,只需配置页面上显示的字段,并对各个字段加上对应的显示规则即可显示。
安装
npm install element-ui -S
npm install em-element-ui -D
安装使用
import Vue from 'vue'
import Element from 'element-ui'
import 'element-ui/lib/theme-chalk/index.css';
Vue.use(Element)
import emUI from 'em-element-ui'
Vue.use(emUI);
### DEMO演示
```html
<template>
<div class="template-main">
<em-table-list :tableListName="'collect'" :sourceData="sourceData" :source="source" :mode_list="mode_list" :page_status="page_status" :page_column="page_column" :select_list="select_list" @onListEvent="onListEvent"></em-table-list>
</div>
</template>
<script>
export default {
name: 'collect',
computed: {},
data() {
return {
sourceData: [{
collectPartner: '10001',
businessLicense: '91110108MA01QC0B0T',
companyId: 'ENN123456789012345678',
companyName: 'test',
companyAddress: '河北廊坊',
status: 1
}],
source: 'data',
mode_list: [],
page_status: 29,
page_column: [
{field: "collectPartner", name: "企业代码", fixed: "left", width: 90,
show: {type: 'text', ou: 1, placeholder: '企业代码', default: {}},
search: {type: 'text', obj: 'collectPartner', placeholder: '企业代码', default: {}},
rules: [
{ required: true, message: '请输入名称!', trigger: 'blur' },
{ min: 5, max: 32, message: '长度在 1 到 32 个字符', trigger: 'blur'},
{ validator: function (rule, value, callback) {
}, message: '名称格式为汉字、字符和下划线', trigger:'blur'}]},
{field: "businessLicense", name: "信用代码", width: 190,
show: {type: 'text', ou: 1, placeholder: '社会信用统一代码'}},
{field: "companyId", name: "ID", width: 180},
{field: "companyName", name: "企业名称",
show: {type: 'text', ou: 1, placeholder: '企业名称'},
search: {type: 'text', obj: 'companyName', placeholder: '企业名称'}},
{field: "companyAddress", name: "企业地址",
show: {type: 'text', ou: 1, placeholder: '企业地址'}},
{field: "status", stype:'switch', name: "状态", formatter: 'status', width: 80, surl: '/', switchs: {key: 'companyId'},
show: {type: 'select', ou: 1, obj: 'status', placeholder: '状态'}},
{field: "useropts", stype:'opt', ispush: false, name: "操作", align: 'center', fixed: "right",
list:[
{ type: 'add', size: 'small', icon: '', style: '', name: '新增'},
{ type: 'edit', size: 'small', icon: '', style: '', name: '编辑'},
{ type: 'del', size: 'small', icon: '', style: 'color: red', name: '删除'},
{ type: 'exec', size: 'small', icon: '', name: '抽取'},
]}
],
select_list: {
status: [
{value: 0, label: '禁用'},
{value: 1, label: '启用'}
],
companyList: {
url: '/',
}
}
}
},
created: function() {},
methods: {
onListEvent(){
console.log(arguments)
}
}
}
</script>
:::
列表属性描述
参数 | 说明 | 类型 | 可选值 | 默认值 |
---|
tableListName | 列表对应名称 | string | 必填 | — |
source | table表数据的来源。data表示自定义数据; query是通过URL动态获取,如:table queryURL | string | data/query | query |
sourceData | source值为data时使用 | array | — | [] |
rowKey | 表示table对应的字段显示下三角 | string | — | - |
mode_list | 修改和编译列表时,各个字段显示在不同的mode区域 | array | — | [] |
page_status | 控制显示内容,1:搜索条件;2:选择显示列;4:表格;8:分页功能;16:增加按钮;32:删除按钮;64:全局搜索控件 | int | — | 12 |
page_column | 列表对应字段 | array | 必填 | - |
select_list | 列表中存在select组件,使用key-value对应 | object | — | - |
列表事件
事件名 | 说明 | 参数 |
---|
onListEvent | 用于用户自定义事件,扩充接口。type为事件类型,row操作的行 | type, row |
table queryURL
queryURL是一个已key-val方式传递,key代表是请求事件,如:add/edit/list/del和自定义事件,注意:key为name时,是新增和编辑左上角title提示;val为对象,描述如下:
| 参数 | 说明 | 类型 | 可选值 | 默认值 |
|---------- |-------------- |---------- |-------------------------------- |-------- |
| url | 请求地址 | string | - | - |
| method | 请求方式 | string | — | - |
| name | 删除时回显字段 | string | — | - |
mode_list
参数 | 说明 | 类型 | 可选值 | 默认值 |
---|
ou | 区域的主键 | int | - | - |
name | 区域的名称 | string | — | - |
select_list
参数 | 说明 | 类型 | 可选值 | 默认值 |
---|
key | 字段的名字 | string | - | - |
value | 字段值,array:为静态值,如:{value: 0, label: '禁用'},{value: 1, label: '启用'};object:为动态获取值,如:{url: '/',keyVal: {value: 'oid', label: 'name'},node:'data', 'list',params: {page: 1, size: 10}} | array/object | — | - |
page_column table
参数 | 说明 | 类型 | 可选值 | 默认值 |
---|
field | 字段 | string | - | - |
stype | 显示信息类型 | string | — | - |
name | 字段名称 | string | — | - |
fixed | 字段是否固定 | string | left/right | - |
width | 字段宽度 | int | — | - |
action | 动态请求该字段值 | string | — | - |
formatter | 根据key-val获取对应的值 | string | — | - |
sort | 字段是否排序 | boolean/string | true/false/custom | false |
ispush | 提交表单时,该字段是否提交 | boolean | — | false |
align | 显示位置 | string | left/center/right | left |
hide | 是否隐藏 | boolean | — | false |
show | 用于控制增加和编辑form表单使用,详细情况:mode_list add/edit | object | — | - |
search | 用于控制查询条件,详细情况:mode_list search | object | — | - |
rules | 用于控制文本框合法校验,详细情况:mode_list rules | array | — | - |
mode_list add/edit
参数 | 说明 | 类型 | 可选值 | 默认值 |
---|
type | 文本框类型 | string | - | - |
ou | 根据mode主键显示文本框 | int | — | - |
obj | 动态获取对应的值 | array | — | - |
isDisabled | 是否在修改时,可编辑该文本框 | boolean | — | false |
remote | 动态搜索远程服务器功能 | boolean | — | false |
findKey | 搜索的字段 | string | — | - |
paramKey | 参数内参数 | string | — | - |
value | 设置默认值 | string | — | - |
placeholder | 文本框描述 | string | — | - |
mode_list search
参数 | 说明 | 类型 | 可选值 | 默认值 |
---|
type | 文本框类型 | string | - | - |
obj | 动态获取对应的值 | array | — | - |
placeholder | 文本框描述 | string | — | - |
mode_list rules
参数 | 说明 | 类型 | 可选值 | 默认值 |
---|
required | 是否必输 | boolean | - | false |
message | 错误提示消息 | string | — | - |
trigger | 触发校验 | array/string | blur/change | - |
min | 最小长度 | int | — | - |
max | 最大长队 | int | — | - |
validator | 自定义校验规则,function代表自定义方法 | string/function | — | - |