Commit 3b6c0c2778eb8c3b353a65e4fff4e59b1218f66c
1 parent
140ecdfb
Exists in
master
and in
1 other branch
新增Table组件
Showing
6 changed files
with
177 additions
and
3 deletions
Show diff stats
examples/router/routes.js
| @@ -24,6 +24,12 @@ const _components = [ | @@ -24,6 +24,12 @@ const _components = [ | ||
| 24 | meta: { title: 'Form 表单' }, | 24 | meta: { title: 'Form 表单' }, |
| 25 | component: () => import('@/views/docs/form.md'), | 25 | component: () => import('@/views/docs/form.md'), |
| 26 | }, | 26 | }, |
| 27 | + { | ||
| 28 | + path: 'table', | ||
| 29 | + name: 'table', | ||
| 30 | + meta: { title: 'Table 表格' }, | ||
| 31 | + component: () => import('@/views/docs/table.md'), | ||
| 32 | + }, | ||
| 27 | ] | 33 | ] |
| 28 | } | 34 | } |
| 29 | ] | 35 | ] |
examples/views/docs/form.md
| @@ -57,6 +57,7 @@ export default { | @@ -57,6 +57,7 @@ export default { | ||
| 57 | return { | 57 | return { |
| 58 | formList: [ | 58 | formList: [ |
| 59 | { type: 'el-input', key: 'name', label: '名称', rules: [{ required: true, message: '请输入名称' }] }, | 59 | { type: 'el-input', key: 'name', label: '名称', rules: [{ required: true, message: '请输入名称' }] }, |
| 60 | + { type: 'el-input', key: 'gender', label: '性别', group: { label: '身体状况', icon: 'edit' } }, | ||
| 60 | { type: 'eagle-select', key: 'address', label: '住址', props: { dataSource: [{ label: '大街上', value: 'S' }, { label: '小区里', value: 'H' }] }, group: '详细地址' }, | 61 | { type: 'eagle-select', key: 'address', label: '住址', props: { dataSource: [{ label: '大街上', value: 'S' }, { label: '小区里', value: 'H' }] }, group: '详细地址' }, |
| 61 | { type: 'el-input', key: 'postcode', label: '邮编', tip: { content: '邮政编码', placement: "left" }, group: '详细地址' }, | 62 | { type: 'el-input', key: 'postcode', label: '邮编', tip: { content: '邮政编码', placement: "left" }, group: '详细地址' }, |
| 62 | { type: 'el-input', key: 'number', label: '楼栋号', group: '详细地址' }, | 63 | { type: 'el-input', key: 'number', label: '楼栋号', group: '详细地址' }, |
| @@ -0,0 +1,90 @@ | @@ -0,0 +1,90 @@ | ||
| 1 | +# Table 表格 | ||
| 2 | + | ||
| 3 | +不同于常规Table组件，本组件采用配置列表的方式实现表格快速配置 | ||
| 4 | + | ||
| 5 | +## 基础用法 | ||
| 6 | + | ||
| 7 | +表格列可以通过`list`动态配置 | ||
| 8 | + | ||
| 9 | +:::snippet 使用`list`属性设置数据源，每一项都已设置为**el-table-column**，数据源格式与`Form`相同 | ||
| 10 | + | ||
| 11 | +```html | ||
| 12 | +<template> | ||
| 13 | + <eagle-table ref="table" :value="tableData" :list="tableList" :tableProps="tableProps"> | ||
| 14 | + <el-table-column type="selection" width="55"></el-table-column> | ||
| 15 | + <el-table-column type="index" width="50"></el-table-column> | ||
| 16 | + <template #postcode="{ label, key }"> | ||
| 17 | + <el-table-column prop="postcode" label="家属院" min-width="200"> | ||
| 18 | + <template slot-scope="{ row: { postcode, number }, $index }"> <!-- 由于渲染问题，这里没有显示出来 --> | ||
| 19 | + <span style="color: orange">{{ $index }}</span> | ||
| 20 | + <span style="color: blue">{{ label }}</span> | ||
| 21 | + <span style="color: red">{{ key }}</span> | ||
| 22 | + <span>{{ number }}</span> | ||
| 23 | + <span>{{ postcode }}</span> | ||
| 24 | + </template> | ||
| 25 | + </el-table-column> | ||
| 26 | + </template> | ||
| 27 | + </eagle-table> | ||
| 28 | +</template> | ||
| 29 | + | ||
| 30 | +<script> | ||
| 31 | +export default { | ||
| 32 | + data() { | ||
| 33 | + return { | ||
| 34 | + tableData: [ | ||
| 35 | + { name: '项伯', address: '大楚小区', postcode: 555, number: '北城1号院' }, | ||
| 36 | + { name: '项仲', address: '大楚小区', postcode: 555, number: '北城2号院' }, | ||
| 37 | + { name: '项叔', address: '大楚小区', postcode: 555, number: '北城3号院' }, | ||
| 38 | + { name: '项季', address: '大楚小区', postcode: 555, number: '北城4号院' }, | ||
| 39 | + ], | ||
| 40 | + tableProps: { | ||
| 41 | + border: true | ||
| 42 | + }, | ||
| 43 | + tableList: [ | ||
| 44 | + { key: 'name', label: '名称', | ||
| 45 | + formatter(row, column) { | ||
| 46 | + return `${row.name} - ${row.postcode}`; | ||
| 47 | + } | ||
| 48 | + }, | ||
| 49 | + { key: 'address', label: '住址' }, | ||
| 50 | + { key: 'postcode', label: '邮编' }, | ||
| 51 | + { key: 'number', label: '楼栋号', minWidth: '180' }, | ||
| 52 | + ] | ||
| 53 | + } | ||
| 54 | + }, | ||
| 55 | + mounted() { | ||
| 56 | + console.log(this.$refs.table.tableInstance); | ||
| 57 | + }, | ||
| 58 | + methods: { | ||
| 59 | + handleSubmit(value) { | ||
| 60 | + console.log(value) | ||
| 61 | + }, | ||
| 62 | + handleCancel() { | ||
| 63 | + this.$refs.form.reset() | ||
| 64 | + console.log('cancel!') | ||
| 65 | + } | ||
| 66 | + } | ||
| 67 | +} | ||
| 68 | +</script> | ||
| 69 | +``` | ||
| 70 | + | ||
| 71 | +::: | ||
| 72 | + | ||
| 73 | + | ||
| 74 | +## Attribute 属性 | ||
| 75 | + | ||
| 76 | +参数|说明|类型|可选值|默认值 | ||
| 77 | +-|-|-|-|- | ||
| 78 | +list | 表单项配置列表 | Array | - | [] | ||
| 79 | +tableProps | ElementUI表格属性 | Object | - | { size: 'small' } | ||
| 80 | +tableEvents | ElementUI表格事件 | Object | - | {} | ||
| 81 | + | ||
| 82 | +## List 表单项配置列表 | ||
| 83 | + | ||
| 84 | +配置方法与Form组件基本相同，有部分属性删减 | ||
| 85 | + | ||
| 86 | +参数|说明|类型|可选值|默认值 | ||
| 87 | +-|-|-|-|- | ||
| 88 | +key | 参数名 | String | - | - | ||
| 89 | +label | 参数标签 | String | - | - | ||
| 90 | +其它参数 | ElementUI表格项的属性 | Any | - | - | ||
| 0 | \ No newline at end of file | 91 | \ No newline at end of file |
packages/form/index.vue
| @@ -8,6 +8,9 @@ | @@ -8,6 +8,9 @@ | ||
| 8 | border-bottom: 1px solid #d9d9d9; | 8 | border-bottom: 1px solid #d9d9d9; |
| 9 | margin-bottom: 30px; | 9 | margin-bottom: 30px; |
| 10 | } | 10 | } |
| 11 | +.eagle-form__group-icon { | ||
| 12 | + padding-right: 10px; | ||
| 13 | +} | ||
| 11 | .eagle-form__group-content { | 14 | .eagle-form__group-content { |
| 12 | margin: 15px 0px; | 15 | margin: 15px 0px; |
| 13 | } | 16 | } |
| @@ -19,7 +22,10 @@ | @@ -19,7 +22,10 @@ | ||
| 19 | <template v-for="(data, index) in listOption.dataList"> | 22 | <template v-for="(data, index) in listOption.dataList"> |
| 20 | <template v-if="listOption.isGroup"> | 23 | <template v-if="listOption.isGroup"> |
| 21 | <slot v-if="$scopedSlots[data.key] || $slots[data.key]" :name="data.key" v-bind="data"></slot> | 24 | <slot v-if="$scopedSlots[data.key] || $slots[data.key]" :name="data.key" v-bind="data"></slot> |
| 22 | - <el-col v-else class="eagle-form__group-title" :key="data.key" :span="24">{{ data.label }}</el-col> | 25 | + <el-col v-else class="eagle-form__group-title" :key="data.key" :span="24"> |
| 26 | + <i v-if="data.icon" :class="`el-icon-${data.icon} eagle-form__group-icon`"></i> | ||
| 27 | + <span>{{ data.label }}</span> | ||
| 28 | + </el-col> | ||
| 23 | </template> | 29 | </template> |
| 24 | <el-row :class="{ 'eagle-form__group-content': listOption.isGroup }" :key="'group-content-' + index" :gutter="15"> | 30 | <el-row :class="{ 'eagle-form__group-content': listOption.isGroup }" :key="'group-content-' + index" :gutter="15"> |
| 25 | <template v-for="(item, index) in data.list"> | 31 | <template v-for="(item, index) in data.list"> |
| @@ -95,7 +101,7 @@ export default { | @@ -95,7 +101,7 @@ export default { | ||
| 95 | this.model[key] = val ? val[key] : undefined; | 101 | this.model[key] = val ? val[key] : undefined; |
| 96 | }); | 102 | }); |
| 97 | }, | 103 | }, |
| 98 | - // 配置列表又改动时初始化表单模型 | 104 | + // 配置列表有改动时初始化表单模型 |
| 99 | list(value) { | 105 | list(value) { |
| 100 | this.initModel(value); | 106 | this.initModel(value); |
| 101 | }, | 107 | }, |
| @@ -124,7 +130,7 @@ export default { | @@ -124,7 +130,7 @@ export default { | ||
| 124 | if (typeof data.group === 'object') { | 130 | if (typeof data.group === 'object') { |
| 125 | if (!groupSet[`group-${data.group.key}`]) { | 131 | if (!groupSet[`group-${data.group.key}`]) { |
| 126 | groupSet[`group-${data.group.key}`] = { | 132 | groupSet[`group-${data.group.key}`] = { |
| 127 | - label: data.group.label, | 133 | + ...data.group, |
| 128 | list: [] | 134 | list: [] |
| 129 | }; | 135 | }; |
| 130 | } | 136 | } |
packages/index.js
| @@ -11,6 +11,7 @@ import RadioGroup from './radio-group' | @@ -11,6 +11,7 @@ import RadioGroup from './radio-group' | ||
| 11 | import Select from './select' | 11 | import Select from './select' |
| 12 | import StatusIndicator from './status-indicator' | 12 | import StatusIndicator from './status-indicator' |
| 13 | import SwitchButton from './switch-button' | 13 | import SwitchButton from './switch-button' |
| 14 | +import Table from './table' | ||
| 14 | import TreeSelect from './tree-select' | 15 | import TreeSelect from './tree-select' |
| 15 | 16 | ||
| 16 | const components = { | 17 | const components = { |
| @@ -27,6 +28,7 @@ const components = { | @@ -27,6 +28,7 @@ const components = { | ||
| 27 | Select, | 28 | Select, |
| 28 | StatusIndicator, | 29 | StatusIndicator, |
| 29 | SwitchButton, | 30 | SwitchButton, |
| 31 | + Table, | ||
| 30 | TreeSelect | 32 | TreeSelect |
| 31 | } | 33 | } |
| 32 | 34 |
| @@ -0,0 +1,69 @@ | @@ -0,0 +1,69 @@ | ||
| 1 | +<style> | ||
| 2 | +.eagle-table { | ||
| 3 | + width: 100%; | ||
| 4 | +} | ||
| 5 | +</style> | ||
| 6 | + | ||
| 7 | +<template> | ||
| 8 | + <el-table class="eagle-table" ref="table" :data="tableData" v-bind="tableProps" v-on="tableEvents"> | ||
| 9 | + <slot></slot> | ||
| 10 | + <template v-if="list && list.length > 0"> | ||
| 11 | + <template v-for="(item, index) in list"> | ||
| 12 | + <slot v-if="$scopedSlots[item.key] || $slots[item.key]" :name="item.key" v-bind="item" :row="item"></slot> | ||
| 13 | + <el-table-column v-else v-bind="item" :prop="item.key" :key="index" :min-width="item.minWidth || '120'"></el-table-column> | ||
| 14 | + </template> | ||
| 15 | + </template> | ||
| 16 | + </el-table> | ||
| 17 | +</template> | ||
| 18 | + | ||
| 19 | +<script> | ||
| 20 | +export default { | ||
| 21 | + name: 'Table', | ||
| 22 | + props: { | ||
| 23 | + // 用于实例化本组件绑定v-model的值 | ||
| 24 | + value: Array, | ||
| 25 | + // 配置列表 | ||
| 26 | + list: { | ||
| 27 | + type: Array, | ||
| 28 | + required: true | ||
| 29 | + }, | ||
| 30 | + // 表格参数 | ||
| 31 | + tableProps: { | ||
| 32 | + type: Object, | ||
| 33 | + default() { | ||
| 34 | + return { | ||
| 35 | + size: 'small', | ||
| 36 | + } | ||
| 37 | + } | ||
| 38 | + }, | ||
| 39 | + // 表格事件 | ||
| 40 | + tableEvents: Object, | ||
| 41 | + }, | ||
| 42 | + watch: { | ||
| 43 | + // 组件外部v-model值更新后同步刷新model | ||
| 44 | + value(val) { | ||
| 45 | + this.tableData = val || []; | ||
| 46 | + }, | ||
| 47 | + }, | ||
| 48 | + mounted() { | ||
| 49 | + this.tableData = this.value || []; | ||
| 50 | + }, | ||
| 51 | + computed: { | ||
| 52 | + // 表格实体 | ||
| 53 | + tableInstance: { | ||
| 54 | + get() { | ||
| 55 | + return this.$refs.table; | ||
| 56 | + } | ||
| 57 | + } | ||
| 58 | + }, | ||
| 59 | + data() { | ||
| 60 | + return { | ||
| 61 | + // 表格数据 | ||
| 62 | + tableData: [], | ||
| 63 | + }; | ||
| 64 | + }, | ||
| 65 | + methods: { | ||
| 66 | + | ||
| 67 | + } | ||
| 68 | +}; | ||
| 69 | +</script> | ||
| 0 | \ No newline at end of file | 70 | \ No newline at end of file |