vue-super-crud 1.7.1
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/.browserslistrc +3 -0
- package/.versionrc.json +36 -0
- package/CHANGELOG.md +232 -0
- package/LICENSE +201 -0
- package/README.md +46 -0
- package/babel.config.js +12 -0
- package/build/alias.js +10 -0
- package/build/build.js +52 -0
- package/build/config.js +70 -0
- package/deploy.bat +14 -0
- package/docs/.vuepress/components/button/base.vue +88 -0
- package/docs/.vuepress/components/common/code-format.vue +331 -0
- package/docs/.vuepress/components/commonConfig/presetCodeTemplate/base.vue +68 -0
- package/docs/.vuepress/components/commonConfig/presetCodeTemplate/customParams.vue +73 -0
- package/docs/.vuepress/components/commonConfig/renderType/component.vue +160 -0
- package/docs/.vuepress/components/commonConfig/renderType/formatter.vue +49 -0
- package/docs/.vuepress/components/commonConfig/renderType/render.vue +91 -0
- package/docs/.vuepress/components/commonConfig/renderType/slot.vue +63 -0
- package/docs/.vuepress/components/crud/baseUse/baseUse.vue +98 -0
- package/docs/.vuepress/components/crud/baseUse/columnAction.vue +72 -0
- package/docs/.vuepress/components/crud/baseUse/columnWidth.vue +107 -0
- package/docs/.vuepress/components/crud/baseUse/handleRow.vue +65 -0
- package/docs/.vuepress/components/crud/baseUse/height.vue +82 -0
- package/docs/.vuepress/components/crud/baseUse/index.vue +54 -0
- package/docs/.vuepress/components/crud/baseUse/loading.vue +70 -0
- package/docs/.vuepress/components/crud/baseUse/pagination.vue +108 -0
- package/docs/.vuepress/components/crud/baseUse/selection.vue +114 -0
- package/docs/.vuepress/components/crud/baseUse/summaryMethod.vue +118 -0
- package/docs/.vuepress/components/crud/baseUse/title.vue +54 -0
- package/docs/.vuepress/components/crud/baseUse/toolbar.vue +69 -0
- package/docs/.vuepress/components/crud/buttons/common.vue +115 -0
- package/docs/.vuepress/components/crud/buttons/fast.vue +82 -0
- package/docs/.vuepress/components/crud/contextMenu/base.vue +72 -0
- package/docs/.vuepress/components/crud/copy.vue +52 -0
- package/docs/.vuepress/components/crud/crudEvents/api.vue +157 -0
- package/docs/.vuepress/components/crud/crudEvents/deleteTip.vue +93 -0
- package/docs/.vuepress/components/crud/crudEvents/events.vue +188 -0
- package/docs/.vuepress/components/crud/dataSort/base.vue +142 -0
- package/docs/.vuepress/components/crud/genDynamicColumns/base.vue +53 -0
- package/docs/.vuepress/components/crud/genDynamicColumns/dynamicAndFixed.vue +111 -0
- package/docs/.vuepress/components/crud/genDynamicColumns/treeDynamic.vue +68 -0
- package/docs/.vuepress/components/crud/handleBar/handleRow.vue +65 -0
- package/docs/.vuepress/components/crud/handleBar/toolbar.vue +69 -0
- package/docs/.vuepress/components/crud/renderType/1.vue +57 -0
- package/docs/.vuepress/components/crud/renderType/2.vue +63 -0
- package/docs/.vuepress/components/crud/renderType/3.vue +105 -0
- package/docs/.vuepress/components/crud/renderType/5.vue +91 -0
- package/docs/.vuepress/components/crud/search/1.vue +90 -0
- package/docs/.vuepress/components/crud/search/2.vue +78 -0
- package/docs/.vuepress/components/crud/search/3.vue +107 -0
- package/docs/.vuepress/components/crud/search/base.vue +123 -0
- package/docs/.vuepress/components/crud/search/localSearch.vue +124 -0
- package/docs/.vuepress/components/crud/search/special.vue +148 -0
- package/docs/.vuepress/components/crud/selection/events.vue +47 -0
- package/docs/.vuepress/components/crud/selection/pagination.vue +94 -0
- package/docs/.vuepress/components/crud/selection/singleSelection.vue +64 -0
- package/docs/.vuepress/components/crud/span/base.vue +69 -0
- package/docs/.vuepress/components/crud/span/special.vue +75 -0
- package/docs/.vuepress/components/crud/summary/base.vue +99 -0
- package/docs/.vuepress/components/crud/tableEdit/addDeleteBtn.vue +174 -0
- package/docs/.vuepress/components/crud/tableEdit/cellEdit.vue +194 -0
- package/docs/.vuepress/components/crud/tableEdit/controlEdit.vue +219 -0
- package/docs/.vuepress/components/crud/tableEdit/dialog.vue +172 -0
- package/docs/.vuepress/components/crud/tableEdit/free.vue +88 -0
- package/docs/.vuepress/components/crud/tableEdit/freeColumn.vue +82 -0
- package/docs/.vuepress/components/crud/tableEdit/methods.vue +154 -0
- package/docs/.vuepress/components/crud/tableEdit/rowAction.vue +107 -0
- package/docs/.vuepress/components/crud/tableEdit/rowBatch.vue +116 -0
- package/docs/.vuepress/components/crud/tableEdit/rowClick.vue +98 -0
- package/docs/.vuepress/components/crud/validate/base.vue +122 -0
- package/docs/.vuepress/components/crud/validate/custom.vue +82 -0
- package/docs/.vuepress/components/crud/validate/regulars.vue +88 -0
- package/docs/.vuepress/components/crud/validate/relation.vue +91 -0
- package/docs/.vuepress/components/crud/validate/tree.vue +82 -0
- package/docs/.vuepress/components/dialog/baseUse/base.vue +92 -0
- package/docs/.vuepress/components/dialog/baseUse/beforeConfirm.vue +78 -0
- package/docs/.vuepress/components/dialog/baseUse/control.vue +79 -0
- package/docs/.vuepress/components/dialog/baseUse/drawer.vue +59 -0
- package/docs/.vuepress/components/dialog/baseUse/footer.vue +87 -0
- package/docs/.vuepress/components/dialog/baseUse/insertSlot.vue +79 -0
- package/docs/.vuepress/components/dict/DictLinkage.vue +91 -0
- package/docs/.vuepress/components/dict/baseUse.vue +72 -0
- package/docs/.vuepress/components/dict/component.vue +82 -0
- package/docs/.vuepress/components/dict/localDict.vue +68 -0
- package/docs/.vuepress/components/form/baseUse/base.vue +48 -0
- package/docs/.vuepress/components/form/baseUse/dataFormat.vue +92 -0
- package/docs/.vuepress/components/form/baseUse/deep.vue +57 -0
- package/docs/.vuepress/components/form/baseUse/gridLayout.vue +47 -0
- package/docs/.vuepress/components/form/baseUse/group.vue +66 -0
- package/docs/.vuepress/components/form/baseUse/hidden.vue +40 -0
- package/docs/.vuepress/components/form/baseUse/inlineLayout.vue +48 -0
- package/docs/.vuepress/components/form/baseUse/label.vue +51 -0
- package/docs/.vuepress/components/form/baseUse/tooltip.vue +40 -0
- package/docs/.vuepress/components/form/baseUse/validate.vue +52 -0
- package/docs/.vuepress/components/form/detail/base.vue +78 -0
- package/docs/.vuepress/components/form/detail/border.vue +90 -0
- package/docs/.vuepress/components/form/detail/singleDetail.vue +72 -0
- package/docs/.vuepress/components/formatData/baseUse.vue +131 -0
- package/docs/.vuepress/components/mock/index.js +347 -0
- package/docs/.vuepress/components/mockData/custom.vue +69 -0
- package/docs/.vuepress/components/mockData/example.vue +290 -0
- package/docs/.vuepress/components/positionSlot/base.vue +24 -0
- package/docs/.vuepress/components/positionSlot/form.vue +71 -0
- package/docs/.vuepress/components/positionSlot/table.vue +85 -0
- package/docs/.vuepress/components/tabs/base.vue +57 -0
- package/docs/.vuepress/components/temp.js +195 -0
- package/docs/.vuepress/config.js +146 -0
- package/docs/.vuepress/enhanceApp.js +142 -0
- package/docs/.vuepress/public/favicon.ico +0 -0
- package/docs/.vuepress/public/super.png +0 -0
- package/docs/.vuepress/styles/index.styl +25 -0
- package/docs/.vuepress/styles/palette.styl +6 -0
- package/docs/README.md +14 -0
- package/docs/guide/button/base.md +31 -0
- package/docs/guide/commonConfig/jsx.md +166 -0
- package/docs/guide/commonConfig/presetCodeTemplate.md +68 -0
- package/docs/guide/commonConfig/renderType.md +181 -0
- package/docs/guide/crud/baseUse.md +120 -0
- package/docs/guide/crud/buttons.md +18 -0
- package/docs/guide/crud/config.md +217 -0
- package/docs/guide/crud/contextMenu.md +18 -0
- package/docs/guide/crud/dataSort.md +66 -0
- package/docs/guide/crud/genDynamicColumns.md +145 -0
- package/docs/guide/crud/handleBar.md +26 -0
- package/docs/guide/crud/renderType.md +4 -0
- package/docs/guide/crud/search.md +150 -0
- package/docs/guide/crud/selection.md +73 -0
- package/docs/guide/crud/span.md +98 -0
- package/docs/guide/crud/summary.md +167 -0
- package/docs/guide/crud/tableEdit.md +377 -0
- package/docs/guide/crud/validate.md +158 -0
- package/docs/guide/dialog/baseUse.md +81 -0
- package/docs/guide/dict/baseUse.md +174 -0
- package/docs/guide/dict/component.md +88 -0
- package/docs/guide/dict/config.md +44 -0
- package/docs/guide/form/baseUse.md +142 -0
- package/docs/guide/form/detail.md +38 -0
- package/docs/guide/formatData/baseUse.md +98 -0
- package/docs/guide/formatData/config.md +142 -0
- package/docs/guide/mockData/base.md +26 -0
- package/docs/guide/positionSlot/base.md +41 -0
- package/docs/guide/question/base.md +44 -0
- package/docs/guide/start/base.md +30 -0
- package/docs/guide/tabs/base.md +63 -0
- package/examples/App.vue +52 -0
- package/examples/Layout/components/AppMain.vue +40 -0
- package/examples/Layout/components/Item.vue +29 -0
- package/examples/Layout/components/Link.vue +44 -0
- package/examples/Layout/components/SidebarItem.vue +93 -0
- package/examples/Layout/index.vue +69 -0
- package/examples/assets/logo.png +0 -0
- package/examples/favicon.ico +0 -0
- package/examples/index.html +18 -0
- package/examples/main.js +54 -0
- package/examples/router/index.js +140 -0
- package/examples/store/index.js +0 -0
- package/examples/styles/index.scss +63 -0
- package/examples/styles/sidebar.scss +226 -0
- package/examples/styles/transition.scss +48 -0
- package/examples/styles/variables.scss +25 -0
- package/examples/views/crud/base.vue +68 -0
- package/examples/views/crud/handleRow.vue +84 -0
- package/examples/views/crud/search.vue +116 -0
- package/examples/views/dashboard/index.vue +244 -0
- package/examples/views/dashboard/index1.vue +234 -0
- package/examples/views/dashboard/test.vue +9 -0
- package/examples/views/formTest/index.vue +168 -0
- package/examples/views/nested/menu1/index.vue +7 -0
- package/examples/views/nested/menu1/menu1-1/index.vue +7 -0
- package/examples/views/nested/menu1/menu1-2/index.vue +7 -0
- package/examples/views/nested/menu1/menu1-2/menu1-2-1/index.vue +5 -0
- package/examples/views/nested/menu1/menu1-2/menu1-2-2/index.vue +5 -0
- package/examples/views/nested/menu1/menu1-3/index.vue +5 -0
- package/examples/views/nested/menu2/index.vue +5 -0
- package/gulpfile.js +84 -0
- package/lib/index.css +1 -0
- package/lib/super-crud.min.js +15 -0
- package/package.json +66 -0
- package/packages/button/index.vue +189 -0
- package/packages/core/components/comp.vue +223 -0
- package/packages/core/components/position.vue +135 -0
- package/packages/core/components/render.vue +460 -0
- package/packages/core/configManager.js +302 -0
- package/packages/core/create.js +8 -0
- package/packages/core/defaultRender.js +64 -0
- package/packages/core/dict/global.js +10 -0
- package/packages/core/dict/index.js +432 -0
- package/packages/core/dict/mixin.js +94 -0
- package/packages/core/event.js +60 -0
- package/packages/core/index.js +6 -0
- package/packages/core/init.js +122 -0
- package/packages/core/mock/genConfig.js +228 -0
- package/packages/core/mock/genData.js +422 -0
- package/packages/core/mock/index.js +4 -0
- package/packages/core/rules.js +111 -0
- package/packages/crud/column.vue +205 -0
- package/packages/crud/columnAction.vue +207 -0
- package/packages/crud/columnCell.vue +146 -0
- package/packages/crud/defaultColumn.vue +130 -0
- package/packages/crud/drawerColumn.vue +225 -0
- package/packages/crud/form.vue +69 -0
- package/packages/crud/index.vue +564 -0
- package/packages/crud/menuBar.vue +298 -0
- package/packages/crud/mixins/cacheHandler.js +36 -0
- package/packages/crud/mixins/calcColumnWidth.js +79 -0
- package/packages/crud/mixins/calcHeight.js +105 -0
- package/packages/crud/mixins/columnHandler.js +128 -0
- package/packages/crud/mixins/contextMenu.js +98 -0
- package/packages/crud/mixins/dataProcessor.js +202 -0
- package/packages/crud/mixins/dialog.js +109 -0
- package/packages/crud/mixins/excelHandler.js +150 -0
- package/packages/crud/mixins/exposeMethods.js +107 -0
- package/packages/crud/mixins/generateDynamicColumns.js +250 -0
- package/packages/crud/mixins/props.js +38 -0
- package/packages/crud/mixins/searchHandler.js +151 -0
- package/packages/crud/mixins/select.js +359 -0
- package/packages/crud/mixins/spanMethod.js +288 -0
- package/packages/crud/mixins/summary.js +177 -0
- package/packages/crud/mixins/tableEdit.js +547 -0
- package/packages/crud/mixins/validate.js +219 -0
- package/packages/crud/pagination.vue +110 -0
- package/packages/crud/search.vue +119 -0
- package/packages/crud/searchHeader.vue +231 -0
- package/packages/crud/selectBanner.vue +138 -0
- package/packages/crud/utils/EditState.js +319 -0
- package/packages/crud/utils/excelExport.js +112 -0
- package/packages/crud/utils/excelImport.js +112 -0
- package/packages/crud/utils/index.js +98 -0
- package/packages/dialog/dialog.js +233 -0
- package/packages/dialog/dialog.vue +15 -0
- package/packages/dialog/index.js +22 -0
- package/packages/dict/cascadeFormat.vue +179 -0
- package/packages/dict/dateFormat.vue +40 -0
- package/packages/dict/form/cascade.vue +61 -0
- package/packages/dict/form/checkbox.vue +90 -0
- package/packages/dict/form/extendMethod.js +22 -0
- package/packages/dict/form/input-base.js +31 -0
- package/packages/dict/form/input.js +20 -0
- package/packages/dict/form/radio.vue +69 -0
- package/packages/dict/form/select.vue +118 -0
- package/packages/dict/form/switch.vue +75 -0
- package/packages/dict/valueFormat.vue +188 -0
- package/packages/directive/dialog/drag.js +86 -0
- package/packages/directive/dialog/dragSize.js +42 -0
- package/packages/directive/index.js +9 -0
- package/packages/directive/insertSlot.js +10 -0
- package/packages/form/contextMenu.js +192 -0
- package/packages/form/draftDrawer.vue +391 -0
- package/packages/form/formAction.vue +97 -0
- package/packages/form/formItem.vue +259 -0
- package/packages/form/index.vue +451 -0
- package/packages/form/props.js +15 -0
- package/packages/grid/cell.vue +65 -0
- package/packages/grid/index.vue +130 -0
- package/packages/group/index.vue +96 -0
- package/packages/tabs/index.vue +290 -0
- package/packages/tooltip/index.js +9 -0
- package/packages/tooltip/tooltip.vue +32 -0
- package/packages/tooltip/tooltipComponent.js +38 -0
- package/packages/verifyInput/index.vue +131 -0
- package/src/config/common.js +88 -0
- package/src/config/crud.js +567 -0
- package/src/config/dialog.js +87 -0
- package/src/config/form.js +215 -0
- package/src/config/index.js +9 -0
- package/src/constants/index.js +72 -0
- package/src/index.js +67 -0
- package/src/template/btn/crud.js +6 -0
- package/src/template/btn/dialog.js +1 -0
- package/src/template/btn/form.js +3 -0
- package/src/template/btn/index.js +9 -0
- package/src/template/dicts.js +1 -0
- package/src/template/formatData.js +507 -0
- package/src/template/index.js +19 -0
- package/src/template/render.js +124 -0
- package/src/template/rules.js +53 -0
- package/src/utils/bem.js +49 -0
- package/src/utils/cache.js +77 -0
- package/src/utils/getType.js +34 -0
- package/src/utils/index.js +212 -0
- package/src/utils/mergeTemp.js +124 -0
- package/styles/button.scss +3 -0
- package/styles/crud.scss +425 -0
- package/styles/dialog.scss +95 -0
- package/styles/form.scss +532 -0
- package/styles/group.scss +78 -0
- package/styles/index.scss +94 -0
- package/styles/tabs.scss +139 -0
- package/styles/verifyInput.scss +56 -0
- package/vue-jsx-sync.js +90 -0
- package/vue.config.js +54 -0
@@ -0,0 +1,150 @@
|
|
1
|
+
# 搜索
|
2
|
+
|
3
|
+
搜索功能支持表单搜索和表头搜索两种方式,并可配置本地搜索或远程搜索。
|
4
|
+
|
5
|
+
## 基础用法
|
6
|
+
|
7
|
+
通过配置列的 `search` 属性启用搜索功能。支持表单搜索和表头搜索两种方式。</br>
|
8
|
+
使用 `search.sync` 可以双向绑定搜索参数对象。
|
9
|
+
|
10
|
+
<ClientOnly>
|
11
|
+
<common-code-format>
|
12
|
+
<crud-search-base slot="source"></crud-search-base>
|
13
|
+
|
14
|
+
<<< @/docs/.vuepress/components/crud/search/base.vue
|
15
|
+
</common-code-format>
|
16
|
+
</ClientOnly>
|
17
|
+
|
18
|
+
## 自定义搜索组件
|
19
|
+
|
20
|
+
支持插槽自定义搜索组件、搜索标题</br>
|
21
|
+
支持自定义搜索表单、搜索头配置。
|
22
|
+
|
23
|
+
<ClientOnly>
|
24
|
+
<common-code-format>
|
25
|
+
<crud-search-special slot="source"></crud-search-special>
|
26
|
+
|
27
|
+
<<< @/docs/.vuepress/components/crud/search/special.vue
|
28
|
+
</common-code-format>
|
29
|
+
</ClientOnly>
|
30
|
+
|
31
|
+
### 搜索表单配置
|
32
|
+
|
33
|
+
通过 `searchForm` 可以自定义搜索表单的配置。
|
34
|
+
|
35
|
+
```js
|
36
|
+
searchForm: {
|
37
|
+
initShow: true, // 初始展开
|
38
|
+
columnWidth: "200px", // 列宽
|
39
|
+
labelWidth: "100px", // 标签宽度
|
40
|
+
action: {
|
41
|
+
search: {
|
42
|
+
text: "查询" // 自定义按钮文本
|
43
|
+
},
|
44
|
+
reset: {
|
45
|
+
text: "重置"
|
46
|
+
}
|
47
|
+
}
|
48
|
+
}
|
49
|
+
```
|
50
|
+
|
51
|
+
### 表头搜索
|
52
|
+
|
53
|
+
通过 `searchHeader` 配置表头搜索的行为:
|
54
|
+
|
55
|
+
```js
|
56
|
+
options: {
|
57
|
+
searchHeader: {
|
58
|
+
placement: "bottom", // 弹出位置
|
59
|
+
width: "290px" // 搜索框宽度
|
60
|
+
}
|
61
|
+
}
|
62
|
+
```
|
63
|
+
|
64
|
+
## 本地搜索
|
65
|
+
|
66
|
+
通过配置 `localSearch: true` 启用本地搜索功能,可直接对表格数据进行筛选,无需发送请求。</br>
|
67
|
+
启用本地搜索时,可以搭配本地分页使用 `localPagination: true`。
|
68
|
+
</br>
|
69
|
+
支持输入框搜索、下拉选择搜索、日期搜索、自定义搜索过滤。</br>
|
70
|
+
search组件使用插槽或者函数自定义时,需要指定`search.type`。
|
71
|
+
|
72
|
+
<ClientOnly>
|
73
|
+
<common-code-format>
|
74
|
+
<crud-search-localSearch slot="source"></crud-search-localSearch>
|
75
|
+
|
76
|
+
<<< @/docs/.vuepress/components/crud/search/localSearch.vue
|
77
|
+
</common-code-format>
|
78
|
+
</ClientOnly>
|
79
|
+
|
80
|
+
### 本地搜索指定搜索类型
|
81
|
+
```js
|
82
|
+
{
|
83
|
+
prop: "date",
|
84
|
+
label: "日期",
|
85
|
+
search: {
|
86
|
+
type: "date" // 本地搜索类型
|
87
|
+
}
|
88
|
+
}
|
89
|
+
```
|
90
|
+
|
91
|
+
### 本地搜索自定义搜索过滤
|
92
|
+
```js
|
93
|
+
{
|
94
|
+
prop: "custom",
|
95
|
+
label: "自定义",
|
96
|
+
search: {
|
97
|
+
filter: (cellValue, searchValue, row) => {
|
98
|
+
// 返回 true 表示匹配,false 表示不匹配
|
99
|
+
return customFilter(cellValue, searchValue, row);
|
100
|
+
}
|
101
|
+
}
|
102
|
+
}
|
103
|
+
```
|
104
|
+
|
105
|
+
## API
|
106
|
+
|
107
|
+
### Column 配置
|
108
|
+
|
109
|
+
| 参数 | 说明 | 类型 | 默认值 |
|
110
|
+
| ---------------------- | ------------------------------------------------------------------------------------------------------------- | -------------- | ------------------- |
|
111
|
+
| search | 是否启用搜索 | boolean/object | false |
|
112
|
+
| search.prop | 搜索字段 | object | 默认继承列的prop |
|
113
|
+
| search.validateProp | 搜索验证字段、用于验证表头是否为空 | string | 默认继承search.prop |
|
114
|
+
| search.label | 搜索标签 | string | 默认继承列的label |
|
115
|
+
| search.labelRender | 搜索标签渲染函数 | function | - |
|
116
|
+
| search.reset | 单个重置事件 | function | - |
|
117
|
+
| search.comp | 搜索组件 | object | el-input |
|
118
|
+
| search.render | 搜索组件渲染函数 | function | - |
|
119
|
+
| search.type | 本地搜索类型,支持input、select、date | string | input |
|
120
|
+
| search.filter | 本地搜索过滤函数 | function | - |
|
121
|
+
| searchHeader | 是否启用表头搜索, [可配置el-popover组件属性](https://element.eleme.cn/2.15/#/zh-CN/component/popover#events) | boolean/object | 默认继承search |
|
122
|
+
| searchHeader.width | 表头搜索宽度 | string | 290px |
|
123
|
+
| searchHeader.searchBtn | 是否显示表头搜索按钮 | boolean | false |
|
124
|
+
| searchHeader.resetBtn | 是否显示表头重置按钮 | boolean | true |
|
125
|
+
| searchHeader.comp | 表头搜索组件 | object | 默认继承search |
|
126
|
+
| searchHeader.render | 表头搜索组件渲染函数 | function | 默认继承search |
|
127
|
+
|
128
|
+
### Options 配置
|
129
|
+
|
130
|
+
| 参数 | 说明 | 类型 | 默认值 |
|
131
|
+
| ------------ | ------------------ | ------- | ------ |
|
132
|
+
| expandSearch | 初始是否展开搜索框 | boolean | false |
|
133
|
+
| localSearch | 是否启用本地搜索 | boolean | false |
|
134
|
+
| searchForm | 搜索表单配置 | object | - |
|
135
|
+
| searchHeader | 表头搜索配置 | object | - |
|
136
|
+
|
137
|
+
### Events
|
138
|
+
|
139
|
+
| 事件名 | 说明 | 参数 |
|
140
|
+
| ------ | -------- | ---------- |
|
141
|
+
| search | 搜索事件 | searchData |
|
142
|
+
| reset | 重置事件 | - |
|
143
|
+
|
144
|
+
### slots
|
145
|
+
|
146
|
+
| 插槽名 | 说明 | 默认值 |
|
147
|
+
| --------------------- | -------------------- | -------------- |
|
148
|
+
| `{prop}-search` | 自定义列搜索组件 | - |
|
149
|
+
| `{prop}-search-label` | 自定义列搜索标签 | - |
|
150
|
+
| `{prop}-searchHeader` | 自定义列表头搜索内容 | 默认继承search |
|
@@ -0,0 +1,73 @@
|
|
1
|
+
# 表格选中
|
2
|
+
|
3
|
+
## 概述
|
4
|
+
|
5
|
+
表格选中分为单选和多选,通过 `selected` 响应式绑定选中数据。
|
6
|
+
|
7
|
+
|
8
|
+
## 跨分页选中
|
9
|
+
|
10
|
+
`selected` 绑定响应式选中数据,存在数据时会自动选中 </br>
|
11
|
+
`selection` 开启表格多选选中 </br>
|
12
|
+
`selection.reserveSelection` 开启数据更新时保持选中状态 </br>
|
13
|
+
|
14
|
+
<ClientOnly>
|
15
|
+
<common-code-format>
|
16
|
+
<crud-selection-pagination slot="source"></crud-selection-pagination>
|
17
|
+
|
18
|
+
<<< @/docs/.vuepress/components/crud/selection/pagination.vue
|
19
|
+
</common-code-format>
|
20
|
+
</ClientOnly>
|
21
|
+
|
22
|
+
## 选中事件
|
23
|
+
|
24
|
+
`@selection-change` 选中项发生变化时触发 </br>
|
25
|
+
`@select` 用户手动选择/取消选择某一行时触发 </br>
|
26
|
+
`@select-all` 用户手动选择/取消选择所有行时触发
|
27
|
+
|
28
|
+
<ClientOnly>
|
29
|
+
<common-code-format>
|
30
|
+
<crud-selection-events slot="source"></crud-selection-events>
|
31
|
+
|
32
|
+
<<< @/docs/.vuepress/components/crud/selection/events.vue
|
33
|
+
</common-code-format>
|
34
|
+
</ClientOnly>
|
35
|
+
|
36
|
+
|
37
|
+
## 单选
|
38
|
+
|
39
|
+
`selected` 绑定响应式选中数据,存在数据时会自动选中 </br>
|
40
|
+
`singleSelection` 开启单选模式 </br>
|
41
|
+
|
42
|
+
<ClientOnly>
|
43
|
+
<common-code-format>
|
44
|
+
<crud-selection-singleSelection slot="source"></crud-selection-singleSelection>
|
45
|
+
|
46
|
+
<<< @/docs/.vuepress/components/crud/selection/singleSelection.vue
|
47
|
+
</common-code-format>
|
48
|
+
</ClientOnly>
|
49
|
+
|
50
|
+
|
51
|
+
## selection 配置项
|
52
|
+
|
53
|
+
| 参数 | 说明 | 类型 | 可选值 | 默认值 |
|
54
|
+
| ---------------- | ------------------------- | -------------------- | ------ | ------ |
|
55
|
+
| reserveSelection | 是否启用分页选中 | boolean | - | false |
|
56
|
+
| selectable | 是否可以勾选 | Function(row, index) | - | - |
|
57
|
+
| banner | 是否显示选中项横幅 | boolean | - | false |
|
58
|
+
| ctrlSelect | 是否启用 Ctrl 键点击选中 | boolean | - | true |
|
59
|
+
| shiftSelect | 是否启用 Shift 键批量选中 | boolean | - | true |
|
60
|
+
| maxDisplay | 直接显示的最大数量 | number | - | 3 |
|
61
|
+
| labelKey | 显示的字段名 | string | - | 'id' |
|
62
|
+
| clear | 是否显示清除按钮 | boolean | - | true |
|
63
|
+
|
64
|
+
|
65
|
+
## singleSelection 配置项
|
66
|
+
|
67
|
+
| 参数 | 说明 | 类型 | 可选值 | 默认值 |
|
68
|
+
| ---------- | ------------------------ | -------------------- | ------ | ------ |
|
69
|
+
| selectable | 是否可以勾选 | Function(row, index) | - | - |
|
70
|
+
| banner | 是否显示选中项横幅 | boolean | - | false |
|
71
|
+
| ctrlSelect | 是否启用 Ctrl 键点击选中 | boolean | - | true |
|
72
|
+
| labelKey | 显示的字段名 | string | - | 'id' |
|
73
|
+
| clear | 是否显示清除按钮 | boolean | - | true |
|
@@ -0,0 +1,98 @@
|
|
1
|
+
# 表格合并
|
2
|
+
|
3
|
+
表格支持按照指定字段对行进行合并,支持多字段优先级合并。并根据配置的合并字段,自动使用多级排序。
|
4
|
+
|
5
|
+
## 基础用法
|
6
|
+
|
7
|
+
通过配置合并字段 `spanProp` 启用列的合并功能。自动合并`相同字段值`的行。</br>
|
8
|
+
特殊列也可以启用合并功能,`index` 列可以获取合并后的索引。
|
9
|
+
|
10
|
+
<ClientOnly>
|
11
|
+
<common-code-format>
|
12
|
+
<crud-span-base slot="source"></crud-span-base>
|
13
|
+
|
14
|
+
<<< @/docs/.vuepress/components/crud/span/base.vue
|
15
|
+
</common-code-format>
|
16
|
+
</ClientOnly>
|
17
|
+
|
18
|
+
## 特殊列处理
|
19
|
+
|
20
|
+
索引列配置`spanProp`,可以获取合并后的索引。</br>
|
21
|
+
选中列配置`spanProp`,可以操作合并后的选中数据,实际选中还是合并前的数据。</br>
|
22
|
+
|
23
|
+
<ClientOnly>
|
24
|
+
<common-code-format>
|
25
|
+
<crud-span-special slot="source"></crud-span-special>
|
26
|
+
|
27
|
+
<<< @/docs/.vuepress/components/crud/span/special.vue
|
28
|
+
</common-code-format>
|
29
|
+
</ClientOnly>
|
30
|
+
|
31
|
+
## 列级别自定义
|
32
|
+
|
33
|
+
通过 `spanMethod` 属性可以自定义某一列的合并规则。
|
34
|
+
|
35
|
+
```js
|
36
|
+
renderColumns: [
|
37
|
+
{
|
38
|
+
prop: "status",
|
39
|
+
label: "状态",
|
40
|
+
// 自定义合并规则
|
41
|
+
spanMethod: ({ row, rowIndex }) => {
|
42
|
+
if (row.status === "pending") {
|
43
|
+
return {
|
44
|
+
rowspan: 2,
|
45
|
+
colspan: 1,
|
46
|
+
};
|
47
|
+
}
|
48
|
+
return {
|
49
|
+
rowspan: 1,
|
50
|
+
colspan: 1,
|
51
|
+
};
|
52
|
+
},
|
53
|
+
},
|
54
|
+
];
|
55
|
+
```
|
56
|
+
|
57
|
+
## 表格级别自定义
|
58
|
+
|
59
|
+
通过 `spanMethod` 可以自定义整个表格的合并规则。
|
60
|
+
|
61
|
+
```js
|
62
|
+
spanMethod: ({ row, column, rowIndex, columnIndex }) => {
|
63
|
+
if (row.status === "pending") {
|
64
|
+
return {
|
65
|
+
rowspan: 2,
|
66
|
+
colspan: 1,
|
67
|
+
};
|
68
|
+
}
|
69
|
+
return {
|
70
|
+
rowspan: 1,
|
71
|
+
colspan: 1,
|
72
|
+
};
|
73
|
+
};
|
74
|
+
```
|
75
|
+
|
76
|
+
## API
|
77
|
+
|
78
|
+
### Column 配置
|
79
|
+
|
80
|
+
| 参数 | 说明 | 类型 | 默认值 |
|
81
|
+
| ---------- | -------------------- | -------------- | ------ |
|
82
|
+
| spanProp | 是否启用列合并 | boolean/string | false |
|
83
|
+
| spanMethod | 列级别自定义合并方法 | Function | - |
|
84
|
+
|
85
|
+
### Options 配置
|
86
|
+
|
87
|
+
| 参数 | 说明 | 类型 | 默认值 |
|
88
|
+
| ---------- | ---------------------- | -------- | ------ |
|
89
|
+
| spanMethod | 表格级别自定义合并方法 | Function | - |
|
90
|
+
|
91
|
+
### spanMethod 参数
|
92
|
+
|
93
|
+
| 参数 | 说明 | 类型 |
|
94
|
+
| ----------- | ------ | ------ |
|
95
|
+
| row | 行数据 | object |
|
96
|
+
| column | 列配置 | object |
|
97
|
+
| rowIndex | 行索引 | number |
|
98
|
+
| columnIndex | 列索引 | number |
|
@@ -0,0 +1,167 @@
|
|
1
|
+
# 表格统计
|
2
|
+
|
3
|
+
表格支持在底部显示统计信息,内置多种统计方式,也支持自定义统计逻辑。
|
4
|
+
|
5
|
+
## 基础用法
|
6
|
+
|
7
|
+
通过配置列的 `summary` 属性启用统计功能。支持以下统计方式:
|
8
|
+
- `sum`: 求和
|
9
|
+
- `avg`: 平均值
|
10
|
+
- `max`: 最大值
|
11
|
+
- `min`: 最小值
|
12
|
+
- `count`: 计数
|
13
|
+
|
14
|
+
<ClientOnly>
|
15
|
+
<common-code-format>
|
16
|
+
<crud-summary-base slot="source"></crud-summary-base>
|
17
|
+
|
18
|
+
<<< @/docs/.vuepress/components/crud/summary/base.vue
|
19
|
+
</common-code-format>
|
20
|
+
</ClientOnly>
|
21
|
+
|
22
|
+
## 格式化配置
|
23
|
+
|
24
|
+
通过 `prefix`、`suffix` 和 `decimals` 属性可以对统计结果进行格式化:
|
25
|
+
|
26
|
+
```js
|
27
|
+
renderColumns: [
|
28
|
+
{
|
29
|
+
prop: "amount",
|
30
|
+
label: "金额",
|
31
|
+
summary: {
|
32
|
+
type: "sum",
|
33
|
+
prefix: "¥", // 添加前缀
|
34
|
+
suffix: "元", // 添加后缀
|
35
|
+
decimals: 2 // 保留2位小数
|
36
|
+
}
|
37
|
+
}
|
38
|
+
]
|
39
|
+
```
|
40
|
+
|
41
|
+
## 高级统计
|
42
|
+
|
43
|
+
### 加权平均值
|
44
|
+
```js
|
45
|
+
{
|
46
|
+
prop: "score",
|
47
|
+
label: "加权平均分",
|
48
|
+
summary: {
|
49
|
+
type: "avg",
|
50
|
+
decimals: 1,
|
51
|
+
suffix: "分"
|
52
|
+
}
|
53
|
+
}
|
54
|
+
```
|
55
|
+
|
56
|
+
### 条件统计
|
57
|
+
```js
|
58
|
+
{
|
59
|
+
prop: "status",
|
60
|
+
label: "状态统计",
|
61
|
+
summary: {
|
62
|
+
type: "count",
|
63
|
+
predicate: value => value === 'active', // 只统计active状态
|
64
|
+
suffix: "个"
|
65
|
+
}
|
66
|
+
}
|
67
|
+
```
|
68
|
+
|
69
|
+
## 自定义统计方法
|
70
|
+
|
71
|
+
通过传入函数作为 `method` 可以自定义统计逻辑:
|
72
|
+
|
73
|
+
```js
|
74
|
+
{
|
75
|
+
prop: "custom",
|
76
|
+
label: "自定义统计",
|
77
|
+
summary: {
|
78
|
+
type: "custom",
|
79
|
+
method: (values, data) => {
|
80
|
+
// values: 当前列的所有数值
|
81
|
+
// data: 表格完整数据
|
82
|
+
return values.reduce((sum, val) => sum + val, 0);
|
83
|
+
},
|
84
|
+
prefix: "¥",
|
85
|
+
decimals: 2
|
86
|
+
}
|
87
|
+
}
|
88
|
+
```
|
89
|
+
|
90
|
+
## 表格级别自定义
|
91
|
+
|
92
|
+
通过 `summaryMethod` 可以自定义整个表格的统计规则:
|
93
|
+
|
94
|
+
```js
|
95
|
+
options: {
|
96
|
+
summaryMethod: ({ columns, data }) => {
|
97
|
+
const sums = [];
|
98
|
+
columns.forEach((column, index) => {
|
99
|
+
if (index === 0) {
|
100
|
+
sums[index] = '总计';
|
101
|
+
return;
|
102
|
+
}
|
103
|
+
const values = data.map(item => Number(item[column.property]));
|
104
|
+
sums[index] = values.reduce((sum, val) => sum + val, 0);
|
105
|
+
});
|
106
|
+
return sums;
|
107
|
+
}
|
108
|
+
}
|
109
|
+
```
|
110
|
+
|
111
|
+
## 嵌套数据统计
|
112
|
+
|
113
|
+
通过 `path` 属性可以统计嵌套对象中的数据:
|
114
|
+
|
115
|
+
```js
|
116
|
+
{
|
117
|
+
prop: "nested.value",
|
118
|
+
label: "嵌套数据",
|
119
|
+
summary: {
|
120
|
+
type: "sum",
|
121
|
+
path: "nested.value", // 指定数据路径
|
122
|
+
decimals: 2
|
123
|
+
}
|
124
|
+
}
|
125
|
+
```
|
126
|
+
|
127
|
+
## API
|
128
|
+
|
129
|
+
### Column Summary 配置
|
130
|
+
|
131
|
+
| 参数 | 说明 | 类型 | 默认值 |
|
132
|
+
| ---------- | ------------------------------ | -------- | ------ |
|
133
|
+
| type | 统计类型 | string | - |
|
134
|
+
| prefix | 统计值前缀 | string | '' |
|
135
|
+
| suffix | 统计值后缀 | string | '' |
|
136
|
+
| decimals | 小数位数 | number | 2 |
|
137
|
+
| path | 数据路径(用于嵌套数据) | string | - |
|
138
|
+
| ignoreZero | 是否忽略0值 | boolean | false |
|
139
|
+
| absolute | 是否取绝对值 | boolean | false |
|
140
|
+
| predicate | 计数条件(仅用于count) | function | - |
|
141
|
+
| method | 自定义统计方法(仅用于custom) | function | - |
|
142
|
+
|
143
|
+
### Options 配置
|
144
|
+
|
145
|
+
| 参数 | 说明 | 类型 | 默认值 |
|
146
|
+
| ------------- | -------------------------------------------- | -------- | ------ |
|
147
|
+
| summaryData | 不使用表格data数据,而使用外部传入的统计数据 | array | - |
|
148
|
+
| showSummary | 是否显示统计行 | boolean | false |
|
149
|
+
| summaryMethod | 自定义统计方法 | function | - |
|
150
|
+
|
151
|
+
### 内置统计类型
|
152
|
+
|
153
|
+
| 类型 | 说明 | 可选值 |
|
154
|
+
| ------ | ---------- | --------------------- |
|
155
|
+
| sum | 求和 | ignoreZero, absolute |
|
156
|
+
| avg | 平均值 | ignoreZero |
|
157
|
+
| count | 计数 | ignoreZero, predicate |
|
158
|
+
| max | 最大值 | absolute |
|
159
|
+
| min | 最小值 | absolute |
|
160
|
+
| custom | 自定义方法 | method |
|
161
|
+
|
162
|
+
### summaryMethod 参数
|
163
|
+
|
164
|
+
| 参数 | 说明 | 类型 |
|
165
|
+
| ------- | ---------- | ----- |
|
166
|
+
| columns | 列配置数组 | array |
|
167
|
+
| data | 表格数据 | array |
|