@netang/quasar 0.0.102 → 0.0.103

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.
Files changed (162) hide show
  1. package/LICENSE +21 -21
  2. package/README.md +11 -11
  3. package/_docs/docs/.vuepress/client.js +8 -8
  4. package/_docs/docs/.vuepress/config.js +40 -40
  5. package/_docs/docs/.vuepress/configs/index.js +2 -2
  6. package/_docs/docs/.vuepress/configs/navbar/index.js +1 -1
  7. package/_docs/docs/.vuepress/configs/navbar/zh.js +16 -16
  8. package/_docs/docs/.vuepress/configs/sidebar/index.js +1 -1
  9. package/_docs/docs/.vuepress/configs/sidebar/zh.js +75 -75
  10. package/_docs/docs/.vuepress/public/css/index.css +3 -3
  11. package/_docs/docs/.vuepress/styles/index.scss +3 -3
  12. package/_docs/docs/components/column-title.md +25 -25
  13. package/_docs/docs/components/data.md +66 -66
  14. package/_docs/docs/components/dialog.md +59 -59
  15. package/_docs/docs/components/dragger.md +26 -26
  16. package/_docs/docs/components/editor-code.md +16 -16
  17. package/_docs/docs/components/empty.md +13 -13
  18. package/_docs/docs/components/field-date.md +16 -16
  19. package/_docs/docs/components/field-text.md +57 -57
  20. package/_docs/docs/components/field-tree.md +14 -14
  21. package/_docs/docs/components/img.md +25 -25
  22. package/_docs/docs/components/input-number.md +21 -21
  23. package/_docs/docs/components/list-menu-item.md +21 -21
  24. package/_docs/docs/components/list-menu.md +21 -21
  25. package/_docs/docs/components/power-page.md +21 -21
  26. package/_docs/docs/components/price.md +21 -21
  27. package/_docs/docs/components/render.md +12 -12
  28. package/_docs/docs/components/search-item.md +10 -10
  29. package/_docs/docs/components/search.md +12 -12
  30. package/_docs/docs/components/select.md +11 -11
  31. package/_docs/docs/components/splitter.md +15 -15
  32. package/_docs/docs/components/table-column-fixed.md +20 -20
  33. package/_docs/docs/components/table-pagination.md +20 -20
  34. package/_docs/docs/components/table-splitter.md +20 -20
  35. package/_docs/docs/components/table-summary.md +20 -20
  36. package/_docs/docs/components/table.md +25 -25
  37. package/_docs/docs/components/thumbnail.md +18 -18
  38. package/_docs/docs/components/toolbar.md +9 -9
  39. package/_docs/docs/components/uploader-query.md +19 -19
  40. package/_docs/docs/components/uploader.md +16 -16
  41. package/_docs/docs/components/value-format.md +26 -26
  42. package/_docs/docs/index.md +1 -1
  43. package/_docs/docs/utils/alert.md +26 -26
  44. package/_docs/docs/utils/area.md +112 -112
  45. package/_docs/docs/utils/arr.md +80 -80
  46. package/_docs/docs/utils/auth.md +101 -101
  47. package/_docs/docs/utils/bus.md +18 -18
  48. package/_docs/docs/utils/confirm.md +31 -31
  49. package/_docs/docs/utils/copy.md +22 -22
  50. package/_docs/docs/utils/dialog.md +98 -98
  51. package/_docs/docs/utils/dict.md +50 -50
  52. package/_docs/docs/utils/dictOptions.md +27 -27
  53. package/_docs/docs/utils/form.md +33 -33
  54. package/_docs/docs/utils/getData.md +60 -60
  55. package/_docs/docs/utils/getFile.md +21 -21
  56. package/_docs/docs/utils/getImage.md +33 -33
  57. package/_docs/docs/utils/getTime.md +51 -51
  58. package/_docs/docs/utils/index.md +1 -1
  59. package/_docs/docs/utils/loading.md +18 -18
  60. package/_docs/docs/utils/notify.md +29 -29
  61. package/_docs/docs/utils/power.md +353 -353
  62. package/_docs/docs/utils/previewImage.md +11 -11
  63. package/_docs/docs/utils/price.md +45 -45
  64. package/_docs/docs/utils/rule.md +30 -30
  65. package/_docs/docs/utils/ruleValid.md +31 -31
  66. package/_docs/docs/utils/symbols.md +30 -30
  67. package/_docs/docs/utils/table.md +194 -194
  68. package/_docs/docs/utils/timestamp.md +27 -27
  69. package/_docs/docs/utils/toast.md +27 -27
  70. package/_docs/docs/utils/tree.md +174 -174
  71. package/_docs/docs/utils/uploader.md +29 -29
  72. package/_docs/package.json +11 -11
  73. package/components/column-title/index.vue +37 -37
  74. package/components/data/index.vue +20 -20
  75. package/components/dialog/index.vue +372 -372
  76. package/components/dragger/index.vue +203 -203
  77. package/components/drawer/index.vue +303 -303
  78. package/components/editor-code/index.vue +289 -289
  79. package/components/empty/index.vue +71 -71
  80. package/components/field-date/index.vue +850 -850
  81. package/components/field-date/methods.js +100 -100
  82. package/components/field-table/index.vue +1222 -1222
  83. package/components/field-text/index.vue +165 -165
  84. package/components/field-tree/index.vue +103 -81
  85. package/components/img/index.vue +202 -202
  86. package/components/input-number/index.vue +546 -546
  87. package/components/list-menu/index.vue +149 -149
  88. package/components/list-menu-item/index.vue +79 -79
  89. package/components/power-page/index.vue +92 -92
  90. package/components/price/index.vue +188 -188
  91. package/components/private/components/index.js +11 -11
  92. package/components/private/components/move-to-tree/index.vue +154 -154
  93. package/components/private/edit-power-data/index.vue +816 -816
  94. package/components/private/table-visible-columns-button/index.vue +109 -109
  95. package/components/render/index.vue +150 -150
  96. package/components/search/index.vue +222 -222
  97. package/components/search-item/index.vue +210 -210
  98. package/components/splitter/index.vue +415 -415
  99. package/components/table/index.vue +456 -456
  100. package/components/table-column-fixed/index.vue +112 -112
  101. package/components/table-pagination/index.vue +192 -192
  102. package/components/table-splitter/index.vue +360 -360
  103. package/components/table-summary/index.vue +110 -110
  104. package/components/thumbnail/index.vue +72 -72
  105. package/components/toolbar/container.vue +31 -31
  106. package/components/toolbar/index.vue +136 -136
  107. package/components/uploader/index.vue +158 -158
  108. package/components/uploader-query/index.vue +758 -758
  109. package/components/value-format/index.vue +274 -274
  110. package/configs/area3.js +1 -1
  111. package/docs/css/index.css +3 -3
  112. package/package.json +1 -1
  113. package/sass/common.scss +174 -174
  114. package/sass/index.scss +14 -14
  115. package/sass/line.scss +39 -39
  116. package/sass/quasar/btn.scss +46 -46
  117. package/sass/quasar/common.scss +3 -3
  118. package/sass/quasar/dialog.scss +7 -7
  119. package/sass/quasar/drawer.scss +6 -6
  120. package/sass/quasar/field.scss +243 -243
  121. package/sass/quasar/loading.scss +6 -6
  122. package/sass/quasar/menu.scss +8 -8
  123. package/sass/quasar/table.scss +150 -150
  124. package/sass/quasar/toolbar.scss +22 -22
  125. package/store/index.js +29 -29
  126. package/utils/$auth.js +127 -127
  127. package/utils/$form.js +56 -56
  128. package/utils/$power.js +1215 -1215
  129. package/utils/$rule.js +13 -13
  130. package/utils/$ruleValid.js +10 -10
  131. package/utils/$table.js +999 -999
  132. package/utils/$tree.js +713 -713
  133. package/utils/alert.js +12 -12
  134. package/utils/area.js +400 -400
  135. package/utils/arr.js +51 -51
  136. package/utils/bus.js +6 -6
  137. package/utils/config.js +52 -52
  138. package/utils/confirm.js +11 -11
  139. package/utils/copy.js +30 -30
  140. package/utils/dialog.js +36 -36
  141. package/utils/dict.js +21 -21
  142. package/utils/dictOptions.js +28 -28
  143. package/utils/getData.js +73 -73
  144. package/utils/getFile.js +40 -40
  145. package/utils/getImage.js +153 -153
  146. package/utils/getTime.js +106 -106
  147. package/utils/index.js +61 -61
  148. package/utils/loading.js +15 -15
  149. package/utils/notify.js +13 -13
  150. package/utils/previewImage.js +10 -10
  151. package/utils/price.js +18 -18
  152. package/utils/symbols.js +18 -18
  153. package/utils/timestamp.js +18 -18
  154. package/utils/toast.js +13 -13
  155. package/utils/uploader/aliyun.js +6 -6
  156. package/utils/uploader/local.js +8 -8
  157. package/utils/uploader/qiniu.js +321 -321
  158. package/utils/uploader.js +1059 -1059
  159. package/utils/useAuth.js +30 -30
  160. package/utils/useRouter.js +47 -47
  161. package/utils/useSearch.js +0 -6
  162. package/utils/useUploader.js +53 -53
@@ -1,353 +1,353 @@
1
- # $power 权限
2
-
3
- ::: tip
4
- `@netang/quasar/utils/$power.js` [Github](https://github.com/netangsoft/netang-quasar/blob/main/utils/%24power.js) [Gitee](https://gitee.com/jinmarcus/netang-quasar/blob/main/utils/%24power.js)
5
-
6
- 权限工具
7
- :::
8
-
9
- ## $power.create
10
-
11
- 创建权限实例
12
-
13
- - 类型
14
-
15
- ```javascript
16
- $power.create(options: Object): Object
17
- ```
18
-
19
- ### options 参数
20
-
21
- | 参数名 | 说明 | 类型 | 默认值 | 可选值 | 示例 |
22
- |-------------------------------------|-----------|------------|----------------------|-----|-----|
23
- | path | 路由路径 | `String` | 当前路由路径 | - | - |
24
- | query | 路由参数 | `Object` | 当前路由参数 | - | - |
25
- | pageLoading | 是否加载页面 | `Boolean` | false | - | - |
26
- | pageStatus | 页面状态 | `Boolean` | null | - | - |
27
- | emptyDescription | 空状态描述 | `String` | - | - | - |
28
- | power | 是否开启权限 | `Boolean` | true | - | - |
29
- | showPowerBtns | 是否显示权限按钮 | `Boolean` | true | - | - |
30
- | showToolbarPowerBtns | 是否显示工具栏权限按钮 | `Boolean` | true | - | - |
31
- | [formatPowerBtns](#formatpowerbtns) | 格式化权限按钮 | `Function` | - | - | - |
32
- | leftDrawerIcon | 左边侧滑菜单图标 | `String` | format_list_bulleted | - | - |
33
- | rightDrawerIcon | 右边侧滑菜单图标 | `search` | - | - | - |
34
- | [requestBefore](#requestbefore) | 请求前执行 | `Function` | - | - | - |
35
- | [requestSuccess](#requestsuccess) | 请求成功执行 | `Function` | - | - | - |
36
- | [requestFail](#requestfail) | 请求失败执行 | `Function` | - | - | - |
37
- | [requestAfter](#requestafter) | 请求后执行 | `Function` | - | - | - |
38
-
39
- #### formatPowerBtns
40
-
41
- 格式化权限按钮
42
-
43
- ```javascript
44
- // 创建权限实例
45
- const $power = $n.$power.create({
46
-
47
- // 格式化权限按钮
48
- formatPowerBtns(item, isFixed, tableSelected) {
49
-
50
- // 如果有选中数据
51
- if (tableSelected.length) {
52
-
53
- // 获取选中数据的第一条
54
- // 类型
55
- const { type } = tableSelected[0]
56
-
57
- // 如果按钮名称是订单详情
58
- if (item.title === '订单详情') {
59
-
60
- // 如果是商品订单
61
- if (type === 1) {
62
- // 修改跳转页面地址
63
- item.data.toPage = '/order/order/view'
64
- // 修改按钮名称
65
- item.title = '订单详情'
66
-
67
- // 否则是退货订单
68
- } else {
69
- // 修改跳转页面地址
70
- item.data.toPage = '/order/refund/edit'
71
- // 修改按钮名称
72
- item.title = '退货详情'
73
- }
74
-
75
- // 如果按钮名称是订单包裹
76
- } else if (item.title === '订单包裹') {
77
-
78
- // 如果返回 false, 则该权限按钮不显示
79
- return false
80
- }
81
- }
82
- },
83
- })
84
- ```
85
-
86
- | 参数名 | 说明 | 类型 | 示例 |
87
- |---------------|-----------|-----------|-----|
88
- | powerBtn | 单个权限按钮数据 | `Object` | - |
89
- | isFixed | 是否固定在表格列中 | `Boolean` | - |
90
- | tableSelected | 表格选中数据 | `Array` | - |
91
-
92
- #### requestBefore
93
-
94
- 请求前执行, 用于在请求前对数据进行一些验证或修改
95
-
96
- ```javascript
97
- // 创建权限实例
98
- const $power = $n.$power.create({
99
-
100
- // 请求前执行
101
- requestBefore({ options, requestData }) {
102
-
103
- // 如果没有标题
104
- if (requestData.title) {
105
-
106
- // 轻提示
107
- $n.toast({
108
- message: '名称不能为空',
109
- })
110
-
111
- // 如果返回 false, 则取消该请求
112
- return false
113
- }
114
-
115
- // 修改请求数据
116
- requestData.test_data = 123
117
- },
118
- })
119
- ```
120
-
121
- | 参数名 | 说明 | 类型 | 示例 |
122
- |-------------|-----------|----------|-----|
123
- | options | 请求时的上下文参数 | `Object` | - |
124
- | requestData | 请求接口的数据 | `Object` | - |
125
-
126
- #### requestSuccess
127
-
128
- 请求成功执行, 请求成功后进行一些操作
129
-
130
- ```javascript
131
- // 创建权限实例
132
- const $power = $n.$power.create({
133
-
134
- // 请求成功执行
135
- requestSuccess({ options, requestData, next, data, response }) {
136
-
137
- if (data.type === 1) {
138
-
139
- // 如果返回 false, 则不会继续向下执行
140
- return false
141
- }
142
-
143
- // 确认框
144
- $n.confirm({
145
- message: '提交成功,确认继续执行吗?',
146
- })
147
- // 点击确认执行
148
- .onOk(function () {
149
-
150
- // 如果传值为 false, 则关闭请求成功的轻提示
151
- next(false)
152
- })
153
- },
154
- })
155
- ```
156
-
157
- | 参数名 | 说明 | 类型 | 示例 |
158
- |-------------|-----------|------------|-----|
159
- | options | 请求时的上下文参数 | `Object` | - |
160
- | requestData | 请求接口的数据 | `Object` | - |
161
- | next | 继续向下执行 | `Function` | - |
162
- | status | 请求结果状态 | `Boolean` | - |
163
- | data | 请求返回数据 | `Any` | - |
164
- | response | 请求返回原始数据 | `Object` | - |
165
-
166
- #### requestFail
167
-
168
- 请求失败执行
169
-
170
- | 参数名 | 说明 | 类型 | 示例 |
171
- |-------------|-----------|------------|-----|
172
- | options | 请求时的上下文参数 | `Object` | - |
173
- | requestData | 请求接口的数据 | `Object` | - |
174
- | status | 请求结果状态 | `Boolean` | - |
175
- | data | 请求返回数据 | `Any` | - |
176
- | response | 请求返回原始数据 | `Object` | - |
177
-
178
- #### requestAfter
179
-
180
- 请求后执行
181
-
182
- | 参数名 | 说明 | 类型 | 示例 |
183
- |-------------|-----------|------------|-----|
184
- | options | 请求时的上下文参数 | `Object` | - |
185
- | requestData | 请求接口的数据 | `Object` | - |
186
- | status | 请求结果状态 | `Boolean` | - |
187
- | data | 请求返回数据 | `Any` | - |
188
- | response | 请求返回原始数据 | `Object` | - |
189
-
190
-
191
- ### 返回数据
192
-
193
- | 参数名 | 说明 | 类型 | 示例 |
194
- |------------------|-------------|----------------|-----|
195
- | pageLoading | 是否加载页面 | `ref(Boolean)` | - |
196
- | pageStatus | 页面状态 | `ref(Boolean)` | - |
197
- | emptyDescription | 空状态描述 | `ref(String)` | - |
198
- | routeFullPath | 当前路由全路径 | `String` | - |
199
- | routePath | 当前路由路径 | `String` | - |
200
- | routeQuery | 当前路由参数 | `Object` | - |
201
- | getRoute | 获取当前路由 | `Function` | - |
202
- | formatPowerBtns | 格式化权限按钮 | `Function` | - |
203
- | leftDrawer | 左边侧滑菜单数据 | `Object` | - |
204
- | rightDrawer | 右边侧滑菜单数据 | `Object` | - |
205
- | tableSelected | 表格已选数据 | `ref(Array)` | - |
206
- | uploader | 上传器 | `Array` | - |
207
- | checkUploading | 检查是否上传中 | `Function` | - |
208
- | powerPage | 当前页面权限 | `Object` | - |
209
- | powerBtns | 当前页面权限按钮 | `ref(Array)` | - |
210
- | toolbarPowerBtns | 当前页面工具栏权限按钮 | `ref(Array)` | - |
211
- | powerBtnClick | 权限按钮点击 | `Function` | - |
212
- | update | 更新数据 | `Function` | - |
213
-
214
- #### powerBtns
215
-
216
- 单个权限按钮参数
217
-
218
- | 参数名 | 说明 | 类型 | 可选值 | 示例 |
219
- |--------|-----------------------------------|-----------|-----------------------------------------------------------------------|------------------------|
220
- | id | 按钮 ID | `Number` | - | - |
221
- | pid | 按钮上级 ID | `Number` | - | - |
222
- | title | 按钮名称 | `String` | - | 保存 |
223
- | url | 按钮链接 | `String` | - | /goods/goods/edit_save |
224
- | name | 按钮标识(取 url 最后一级,相当于 PHP 控制器中的方法名) | `String` | - | edit_save |
225
- | type | 按钮类型 | `Number` | `11` / `12` / `13` / `14` / `15` / `16` / `20` | - |
226
- | color | 按钮颜色 | `String` | `default` / `primary` / `secondary` / `info` / `warning` / `negative` | primary |
227
- | icon | 按钮图标 | `String` | - | save |
228
- | is_log | 是否记录日志 | `Number` | `0` / `1` | - |
229
- | hidden | 是否隐藏按钮 | `Boolean` | - | - |
230
- | data | 按钮参数 | `Object` | - | - |
231
-
232
- - data 按钮参数
233
-
234
- | 参数名 | 说明 | 类型 | 可选值 | 默认值 | 示例 |
235
- |-----------------|--------------------------|----------------------|-----------------------------------|--------|-----|
236
- | selection | 列表选择类型 | `String` | `none` / `single` / `multiple` | single | - |
237
- | show | 显示类型 | `String` | `single` / `multiple` / `空(默认显示)` | - | - |
238
- | noFromPageQuery | 禁止添加来源页面参数 | `Boolean` | - | false | - |
239
- | toPage | 跳转页面 / 重定向 URL | `String` | - | - | - |
240
- | fixed | 是否固定列 | `Boolean` | - | false | - |
241
- | dbclick | 是否双击 | `Boolean` | - | false | - |
242
- | confirm | 是否确认(如果传字符串,则为确认提示的内容) | `Boolean` / `String` | - | false | - |
243
- | confirmPassword | 是否确认密码(如果传字符串,则为确认提示的内容) | `Boolean` / `String` | - | false | - |
244
- | requestQuery | 请求参数 | `Object` | - | - | - |
245
- | requestSuccess | 请求成功执行 | `Object` | - | - | - |
246
- | params | 自定义参数, 任意类型 | `Any` | - | - | - |
247
-
248
- - requestQuery
249
-
250
- 请求参数
251
-
252
- | 参数名 | 说明 | 类型 | 示例 |
253
- |------ |-----|--------------------|--|
254
- | list | 列表 | `String` / `Array` | [ "id", "sku_id AS sku" ] |
255
- | query | 参数 | `String` / `Array` | [ "id", "sku_id AS sku", { "type": 1, "name": "age" } ] |
256
-
257
-
258
- - requestSuccess
259
-
260
- 请求成功执行
261
-
262
- | 参数名 | 说明 | 类型 | 可选值 |
263
- |------ |-----|--------------------|--|
264
- | type | 类型 | `String` | `close` / `closePush` / `closePushRefresh` / `resetForm` / `refreshList` |
265
- | params | 参数 | `Any` | - |
266
-
267
-
268
- ## $power.setData
269
-
270
- 设置权限数据
271
-
272
- - 类型
273
-
274
- ```javascript
275
- $power.setData(options: Object): void
276
- ```
277
-
278
- ### options 参数
279
-
280
- | 参数名 | 说明 | 类型 |
281
- |------|-------|----------|
282
- | rows | 路由路径 | `Array` |
283
- | v | 权限版本号 | `Number` |
284
-
285
-
286
- ## $power.getData
287
-
288
- 获取权限数据
289
-
290
- - 类型
291
-
292
- ```javascript
293
- await $power.getData(): Object
294
- ```
295
-
296
- ### 返回数据
297
-
298
- | 参数名 | 说明 | 类型 | 默认值 |
299
- |------|--|----------|------|
300
- | v | 权限版本号 | `Number` | null |
301
- | all | 以 id 为索引的权限数据对象 | `Object` | |
302
- | urls | 以 url 为索引的权限数据对象 | `Object` | |
303
- | btns | 以 url 为索引的权限按钮对象 | `Object` | |
304
- | menus | 所有权限菜单数组 | `Array` | |
305
-
306
-
307
- ## $power.getPageData
308
-
309
- 获取权限数据
310
-
311
- - 类型
312
-
313
- ```javascript
314
- $power.getPageData($route): Object
315
- ```
316
-
317
- ### 返回数据
318
-
319
- | 参数名 | 说明 | 类型 |
320
- |------|--|----------|
321
- | page | 页面权限 | `Number` |
322
- | btns | 页面权限按钮数组 | `Array` |
323
-
324
-
325
- ## $power.formatBtns
326
-
327
- 格式化权限按钮
328
-
329
- - 类型
330
-
331
- ```javascript
332
- $power.formatBtns(powerBtns, filterBtns, toObject = false): Array
333
- ```
334
-
335
- ## $power.request
336
-
337
- 权限请求
338
-
339
- - 类型
340
-
341
- ```javascript
342
- await $power.request(powerBtns, filterBtns, toObject = false): void
343
- ```
344
-
345
- | 参数名 | 说明 | 类型 |
346
- |------|--|-----|
347
- | powerBtn | 权限按钮数据 | `Object` |
348
- | tableSelected | 表格选中数据 | `Array` |
349
- | checkUploading | 检查是否正在上传文件 | `Function` |
350
- | [requestBefore](#requestbefore) | 请求前执行 | `Function` |
351
- | [requestSuccess](#requestsuccess) | 请求成功执行 | `Function` |
352
- | [requestFail](#requestfail) | 请求失败执行 | `Function` |
353
- | [requestAfter](#requestafter) | 请求后执行 | `Function` |
1
+ # $power 权限
2
+
3
+ ::: tip
4
+ `@netang/quasar/utils/$power.js` [Github](https://github.com/netangsoft/netang-quasar/blob/main/utils/%24power.js) [Gitee](https://gitee.com/jinmarcus/netang-quasar/blob/main/utils/%24power.js)
5
+
6
+ 权限工具
7
+ :::
8
+
9
+ ## $power.create
10
+
11
+ 创建权限实例
12
+
13
+ - 类型
14
+
15
+ ```javascript
16
+ $power.create(options: Object): Object
17
+ ```
18
+
19
+ ### options 参数
20
+
21
+ | 参数名 | 说明 | 类型 | 默认值 | 可选值 | 示例 |
22
+ |-------------------------------------|-----------|------------|----------------------|-----|-----|
23
+ | path | 路由路径 | `String` | 当前路由路径 | - | - |
24
+ | query | 路由参数 | `Object` | 当前路由参数 | - | - |
25
+ | pageLoading | 是否加载页面 | `Boolean` | false | - | - |
26
+ | pageStatus | 页面状态 | `Boolean` | null | - | - |
27
+ | emptyDescription | 空状态描述 | `String` | - | - | - |
28
+ | power | 是否开启权限 | `Boolean` | true | - | - |
29
+ | showPowerBtns | 是否显示权限按钮 | `Boolean` | true | - | - |
30
+ | showToolbarPowerBtns | 是否显示工具栏权限按钮 | `Boolean` | true | - | - |
31
+ | [formatPowerBtns](#formatpowerbtns) | 格式化权限按钮 | `Function` | - | - | - |
32
+ | leftDrawerIcon | 左边侧滑菜单图标 | `String` | format_list_bulleted | - | - |
33
+ | rightDrawerIcon | 右边侧滑菜单图标 | `search` | - | - | - |
34
+ | [requestBefore](#requestbefore) | 请求前执行 | `Function` | - | - | - |
35
+ | [requestSuccess](#requestsuccess) | 请求成功执行 | `Function` | - | - | - |
36
+ | [requestFail](#requestfail) | 请求失败执行 | `Function` | - | - | - |
37
+ | [requestAfter](#requestafter) | 请求后执行 | `Function` | - | - | - |
38
+
39
+ #### formatPowerBtns
40
+
41
+ 格式化权限按钮
42
+
43
+ ```javascript
44
+ // 创建权限实例
45
+ const $power = $n.$power.create({
46
+
47
+ // 格式化权限按钮
48
+ formatPowerBtns(item, isFixed, tableSelected) {
49
+
50
+ // 如果有选中数据
51
+ if (tableSelected.length) {
52
+
53
+ // 获取选中数据的第一条
54
+ // 类型
55
+ const { type } = tableSelected[0]
56
+
57
+ // 如果按钮名称是订单详情
58
+ if (item.title === '订单详情') {
59
+
60
+ // 如果是商品订单
61
+ if (type === 1) {
62
+ // 修改跳转页面地址
63
+ item.data.toPage = '/order/order/view'
64
+ // 修改按钮名称
65
+ item.title = '订单详情'
66
+
67
+ // 否则是退货订单
68
+ } else {
69
+ // 修改跳转页面地址
70
+ item.data.toPage = '/order/refund/edit'
71
+ // 修改按钮名称
72
+ item.title = '退货详情'
73
+ }
74
+
75
+ // 如果按钮名称是订单包裹
76
+ } else if (item.title === '订单包裹') {
77
+
78
+ // 如果返回 false, 则该权限按钮不显示
79
+ return false
80
+ }
81
+ }
82
+ },
83
+ })
84
+ ```
85
+
86
+ | 参数名 | 说明 | 类型 | 示例 |
87
+ |---------------|-----------|-----------|-----|
88
+ | powerBtn | 单个权限按钮数据 | `Object` | - |
89
+ | isFixed | 是否固定在表格列中 | `Boolean` | - |
90
+ | tableSelected | 表格选中数据 | `Array` | - |
91
+
92
+ #### requestBefore
93
+
94
+ 请求前执行, 用于在请求前对数据进行一些验证或修改
95
+
96
+ ```javascript
97
+ // 创建权限实例
98
+ const $power = $n.$power.create({
99
+
100
+ // 请求前执行
101
+ requestBefore({ options, requestData }) {
102
+
103
+ // 如果没有标题
104
+ if (requestData.title) {
105
+
106
+ // 轻提示
107
+ $n.toast({
108
+ message: '名称不能为空',
109
+ })
110
+
111
+ // 如果返回 false, 则取消该请求
112
+ return false
113
+ }
114
+
115
+ // 修改请求数据
116
+ requestData.test_data = 123
117
+ },
118
+ })
119
+ ```
120
+
121
+ | 参数名 | 说明 | 类型 | 示例 |
122
+ |-------------|-----------|----------|-----|
123
+ | options | 请求时的上下文参数 | `Object` | - |
124
+ | requestData | 请求接口的数据 | `Object` | - |
125
+
126
+ #### requestSuccess
127
+
128
+ 请求成功执行, 请求成功后进行一些操作
129
+
130
+ ```javascript
131
+ // 创建权限实例
132
+ const $power = $n.$power.create({
133
+
134
+ // 请求成功执行
135
+ requestSuccess({ options, requestData, next, data, response }) {
136
+
137
+ if (data.type === 1) {
138
+
139
+ // 如果返回 false, 则不会继续向下执行
140
+ return false
141
+ }
142
+
143
+ // 确认框
144
+ $n.confirm({
145
+ message: '提交成功,确认继续执行吗?',
146
+ })
147
+ // 点击确认执行
148
+ .onOk(function () {
149
+
150
+ // 如果传值为 false, 则关闭请求成功的轻提示
151
+ next(false)
152
+ })
153
+ },
154
+ })
155
+ ```
156
+
157
+ | 参数名 | 说明 | 类型 | 示例 |
158
+ |-------------|-----------|------------|-----|
159
+ | options | 请求时的上下文参数 | `Object` | - |
160
+ | requestData | 请求接口的数据 | `Object` | - |
161
+ | next | 继续向下执行 | `Function` | - |
162
+ | status | 请求结果状态 | `Boolean` | - |
163
+ | data | 请求返回数据 | `Any` | - |
164
+ | response | 请求返回原始数据 | `Object` | - |
165
+
166
+ #### requestFail
167
+
168
+ 请求失败执行
169
+
170
+ | 参数名 | 说明 | 类型 | 示例 |
171
+ |-------------|-----------|------------|-----|
172
+ | options | 请求时的上下文参数 | `Object` | - |
173
+ | requestData | 请求接口的数据 | `Object` | - |
174
+ | status | 请求结果状态 | `Boolean` | - |
175
+ | data | 请求返回数据 | `Any` | - |
176
+ | response | 请求返回原始数据 | `Object` | - |
177
+
178
+ #### requestAfter
179
+
180
+ 请求后执行
181
+
182
+ | 参数名 | 说明 | 类型 | 示例 |
183
+ |-------------|-----------|------------|-----|
184
+ | options | 请求时的上下文参数 | `Object` | - |
185
+ | requestData | 请求接口的数据 | `Object` | - |
186
+ | status | 请求结果状态 | `Boolean` | - |
187
+ | data | 请求返回数据 | `Any` | - |
188
+ | response | 请求返回原始数据 | `Object` | - |
189
+
190
+
191
+ ### 返回数据
192
+
193
+ | 参数名 | 说明 | 类型 | 示例 |
194
+ |------------------|-------------|----------------|-----|
195
+ | pageLoading | 是否加载页面 | `ref(Boolean)` | - |
196
+ | pageStatus | 页面状态 | `ref(Boolean)` | - |
197
+ | emptyDescription | 空状态描述 | `ref(String)` | - |
198
+ | routeFullPath | 当前路由全路径 | `String` | - |
199
+ | routePath | 当前路由路径 | `String` | - |
200
+ | routeQuery | 当前路由参数 | `Object` | - |
201
+ | getRoute | 获取当前路由 | `Function` | - |
202
+ | formatPowerBtns | 格式化权限按钮 | `Function` | - |
203
+ | leftDrawer | 左边侧滑菜单数据 | `Object` | - |
204
+ | rightDrawer | 右边侧滑菜单数据 | `Object` | - |
205
+ | tableSelected | 表格已选数据 | `ref(Array)` | - |
206
+ | uploader | 上传器 | `Array` | - |
207
+ | checkUploading | 检查是否上传中 | `Function` | - |
208
+ | powerPage | 当前页面权限 | `Object` | - |
209
+ | powerBtns | 当前页面权限按钮 | `ref(Array)` | - |
210
+ | toolbarPowerBtns | 当前页面工具栏权限按钮 | `ref(Array)` | - |
211
+ | powerBtnClick | 权限按钮点击 | `Function` | - |
212
+ | update | 更新数据 | `Function` | - |
213
+
214
+ #### powerBtns
215
+
216
+ 单个权限按钮参数
217
+
218
+ | 参数名 | 说明 | 类型 | 可选值 | 示例 |
219
+ |--------|-----------------------------------|-----------|-----------------------------------------------------------------------|------------------------|
220
+ | id | 按钮 ID | `Number` | - | - |
221
+ | pid | 按钮上级 ID | `Number` | - | - |
222
+ | title | 按钮名称 | `String` | - | 保存 |
223
+ | url | 按钮链接 | `String` | - | /goods/goods/edit_save |
224
+ | name | 按钮标识(取 url 最后一级,相当于 PHP 控制器中的方法名) | `String` | - | edit_save |
225
+ | type | 按钮类型 | `Number` | `11` / `12` / `13` / `14` / `15` / `16` / `20` | - |
226
+ | color | 按钮颜色 | `String` | `default` / `primary` / `secondary` / `info` / `warning` / `negative` | primary |
227
+ | icon | 按钮图标 | `String` | - | save |
228
+ | is_log | 是否记录日志 | `Number` | `0` / `1` | - |
229
+ | hidden | 是否隐藏按钮 | `Boolean` | - | - |
230
+ | data | 按钮参数 | `Object` | - | - |
231
+
232
+ - data 按钮参数
233
+
234
+ | 参数名 | 说明 | 类型 | 可选值 | 默认值 | 示例 |
235
+ |-----------------|--------------------------|----------------------|-----------------------------------|--------|-----|
236
+ | selection | 列表选择类型 | `String` | `none` / `single` / `multiple` | single | - |
237
+ | show | 显示类型 | `String` | `single` / `multiple` / `空(默认显示)` | - | - |
238
+ | noFromPageQuery | 禁止添加来源页面参数 | `Boolean` | - | false | - |
239
+ | toPage | 跳转页面 / 重定向 URL | `String` | - | - | - |
240
+ | fixed | 是否固定列 | `Boolean` | - | false | - |
241
+ | dbclick | 是否双击 | `Boolean` | - | false | - |
242
+ | confirm | 是否确认(如果传字符串,则为确认提示的内容) | `Boolean` / `String` | - | false | - |
243
+ | confirmPassword | 是否确认密码(如果传字符串,则为确认提示的内容) | `Boolean` / `String` | - | false | - |
244
+ | requestQuery | 请求参数 | `Object` | - | - | - |
245
+ | requestSuccess | 请求成功执行 | `Object` | - | - | - |
246
+ | params | 自定义参数, 任意类型 | `Any` | - | - | - |
247
+
248
+ - requestQuery
249
+
250
+ 请求参数
251
+
252
+ | 参数名 | 说明 | 类型 | 示例 |
253
+ |------ |-----|--------------------|--|
254
+ | list | 列表 | `String` / `Array` | [ "id", "sku_id AS sku" ] |
255
+ | query | 参数 | `String` / `Array` | [ "id", "sku_id AS sku", { "type": 1, "name": "age" } ] |
256
+
257
+
258
+ - requestSuccess
259
+
260
+ 请求成功执行
261
+
262
+ | 参数名 | 说明 | 类型 | 可选值 |
263
+ |------ |-----|--------------------|--|
264
+ | type | 类型 | `String` | `close` / `closePush` / `closePushRefresh` / `resetForm` / `refreshList` |
265
+ | params | 参数 | `Any` | - |
266
+
267
+
268
+ ## $power.setData
269
+
270
+ 设置权限数据
271
+
272
+ - 类型
273
+
274
+ ```javascript
275
+ $power.setData(options: Object): void
276
+ ```
277
+
278
+ ### options 参数
279
+
280
+ | 参数名 | 说明 | 类型 |
281
+ |------|-------|----------|
282
+ | rows | 路由路径 | `Array` |
283
+ | v | 权限版本号 | `Number` |
284
+
285
+
286
+ ## $power.getData
287
+
288
+ 获取权限数据
289
+
290
+ - 类型
291
+
292
+ ```javascript
293
+ await $power.getData(): Object
294
+ ```
295
+
296
+ ### 返回数据
297
+
298
+ | 参数名 | 说明 | 类型 | 默认值 |
299
+ |------|--|----------|------|
300
+ | v | 权限版本号 | `Number` | null |
301
+ | all | 以 id 为索引的权限数据对象 | `Object` | |
302
+ | urls | 以 url 为索引的权限数据对象 | `Object` | |
303
+ | btns | 以 url 为索引的权限按钮对象 | `Object` | |
304
+ | menus | 所有权限菜单数组 | `Array` | |
305
+
306
+
307
+ ## $power.getPageData
308
+
309
+ 获取权限数据
310
+
311
+ - 类型
312
+
313
+ ```javascript
314
+ $power.getPageData($route): Object
315
+ ```
316
+
317
+ ### 返回数据
318
+
319
+ | 参数名 | 说明 | 类型 |
320
+ |------|--|----------|
321
+ | page | 页面权限 | `Number` |
322
+ | btns | 页面权限按钮数组 | `Array` |
323
+
324
+
325
+ ## $power.formatBtns
326
+
327
+ 格式化权限按钮
328
+
329
+ - 类型
330
+
331
+ ```javascript
332
+ $power.formatBtns(powerBtns, filterBtns, toObject = false): Array
333
+ ```
334
+
335
+ ## $power.request
336
+
337
+ 权限请求
338
+
339
+ - 类型
340
+
341
+ ```javascript
342
+ await $power.request(powerBtns, filterBtns, toObject = false): void
343
+ ```
344
+
345
+ | 参数名 | 说明 | 类型 |
346
+ |------|--|-----|
347
+ | powerBtn | 权限按钮数据 | `Object` |
348
+ | tableSelected | 表格选中数据 | `Array` |
349
+ | checkUploading | 检查是否正在上传文件 | `Function` |
350
+ | [requestBefore](#requestbefore) | 请求前执行 | `Function` |
351
+ | [requestSuccess](#requestsuccess) | 请求成功执行 | `Function` |
352
+ | [requestFail](#requestfail) | 请求失败执行 | `Function` |
353
+ | [requestAfter](#requestafter) | 请求后执行 | `Function` |