@a2simcode/ui 0.0.175 → 0.0.177

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 (344) hide show
  1. package/.cursor/skills/ui-component-helper/README.md +86 -86
  2. package/.cursor/skills/ui-component-helper/SKILL.md +115 -115
  3. package/LICENSE +53 -53
  4. package/README.md +156 -156
  5. package/dist/simcode-ui.es.js +467 -478
  6. package/dist/simcode-ui.umd.js +2 -2
  7. package/dist/stats.html +1 -1
  8. package/dist/ui.css +1 -1
  9. package/docs/components/autocomplete.md +89 -89
  10. package/docs/components/barcode.md +101 -101
  11. package/docs/components/button-select.md +24 -24
  12. package/docs/components/button.md +117 -117
  13. package/docs/components/buttons.md +119 -119
  14. package/docs/components/cascader-select.md +114 -114
  15. package/docs/components/checkbox.md +114 -114
  16. package/docs/components/code-mirror.md +85 -85
  17. package/docs/components/collapse.md +26 -26
  18. package/docs/components/comp.md +71 -71
  19. package/docs/components/count-up.md +24 -24
  20. package/docs/components/count.md +24 -24
  21. package/docs/components/data-panel.md +24 -24
  22. package/docs/components/date.md +76 -76
  23. package/docs/components/dialog-full.md +112 -112
  24. package/docs/components/dialog.md +127 -127
  25. package/docs/components/divider.md +24 -24
  26. package/docs/components/drawer.md +127 -127
  27. package/docs/components/dynamic-layer.md +118 -118
  28. package/docs/components/echarts.md +72 -72
  29. package/docs/components/editor.md +24 -24
  30. package/docs/components/form.md +72 -72
  31. package/docs/components/guid.md +39 -39
  32. package/docs/components/hpanel.md +24 -24
  33. package/docs/components/icon.md +56 -56
  34. package/docs/components/input-button.md +24 -24
  35. package/docs/components/input-code.md +24 -24
  36. package/docs/components/input-color.md +114 -114
  37. package/docs/components/input-layer.md +26 -26
  38. package/docs/components/input-rows.md +370 -370
  39. package/docs/components/input-tag.md +50 -50
  40. package/docs/components/input.md +129 -129
  41. package/docs/components/layer-form.md +61 -61
  42. package/docs/components/layer.md +127 -127
  43. package/docs/components/layout.md +132 -132
  44. package/docs/components/map.md +24 -24
  45. package/docs/components/menu.md +121 -121
  46. package/docs/components/meta/button.ts +4 -4
  47. package/docs/components/meta/buttons.ts +76 -76
  48. package/docs/components/meta/code-mirror.ts +108 -108
  49. package/docs/components/meta/comp.ts +236 -236
  50. package/docs/components/meta/date.ts +267 -267
  51. package/docs/components/meta/echarts.ts +64 -64
  52. package/docs/components/meta/form-item.ts +50 -50
  53. package/docs/components/meta/form.ts +181 -181
  54. package/docs/components/meta/input-button.ts +2 -2
  55. package/docs/components/meta/input-cards.ts +112 -112
  56. package/docs/components/meta/input-code.ts +2 -2
  57. package/docs/components/meta/input-color.ts +243 -243
  58. package/docs/components/meta/input-layer.ts +366 -366
  59. package/docs/components/meta/input-rows.ts +119 -119
  60. package/docs/components/meta/layer-form.ts +56 -56
  61. package/docs/components/meta/map.ts +68 -68
  62. package/docs/components/meta/panel.ts +152 -152
  63. package/docs/components/meta/slider.ts +270 -270
  64. package/docs/components/meta/table-panel.ts +232 -232
  65. package/docs/components/meta/table.ts +391 -391
  66. package/docs/components/meta/tabs.ts +146 -146
  67. package/docs/components/meta/title.ts +91 -91
  68. package/docs/components/meta/tree-select.ts +199 -199
  69. package/docs/components/meta/tree.ts +219 -219
  70. package/docs/components/meta/vpanel.ts +19 -19
  71. package/docs/components/meta/workflow-viewer.ts +55 -55
  72. package/docs/components/number.md +124 -124
  73. package/docs/components/page.md +102 -102
  74. package/docs/components/panel.md +37 -37
  75. package/docs/components/radio.md +87 -87
  76. package/docs/components/rate.md +71 -71
  77. package/docs/components/select.md +133 -133
  78. package/docs/components/slider-captcha.md +41 -41
  79. package/docs/components/slider.md +101 -101
  80. package/docs/components/switch.md +90 -90
  81. package/docs/components/table-panel.md +236 -236
  82. package/docs/components/table.md +391 -391
  83. package/docs/components/tabs.md +26 -26
  84. package/docs/components/title.md +24 -24
  85. package/docs/components/tree.md +207 -207
  86. package/docs/components/upload.md +117 -117
  87. package/docs/components/workflow-viewer.md +21 -21
  88. package/docs/components/workflow.md +21 -21
  89. package/docs/examples/autocomplete/advanced.vue +35 -35
  90. package/docs/examples/autocomplete/basic.vue +32 -32
  91. package/docs/examples/autocomplete/clearable.vue +33 -33
  92. package/docs/examples/autocomplete/custom-template.vue +49 -49
  93. package/docs/examples/autocomplete/disabled.vue +33 -33
  94. package/docs/examples/autocomplete/icon.vue +37 -37
  95. package/docs/examples/barcode/all-types.vue +380 -380
  96. package/docs/examples/barcode/basic.vue +14 -14
  97. package/docs/examples/barcode/props-appearance.vue +243 -243
  98. package/docs/examples/barcode/props-geometry.vue +143 -143
  99. package/docs/examples/barcode/props-logic.vue +216 -216
  100. package/docs/examples/barcode/props-symbology.vue +199 -199
  101. package/docs/examples/barcode/props-text.vue +268 -268
  102. package/docs/examples/button/basic.vue +7 -7
  103. package/docs/examples/button/danger-ghost.vue +17 -17
  104. package/docs/examples/button/disabled.vue +10 -10
  105. package/docs/examples/button/loading.vue +6 -6
  106. package/docs/examples/button/shape.vue +7 -7
  107. package/docs/examples/button/size.vue +14 -14
  108. package/docs/examples/button/type.vue +10 -10
  109. package/docs/examples/button-select/basic.vue +19 -19
  110. package/docs/examples/buttons/basic.vue +45 -45
  111. package/docs/examples/buttons/disabled.vue +36 -36
  112. package/docs/examples/buttons/dropdown.vue +63 -63
  113. package/docs/examples/buttons/group.vue +52 -52
  114. package/docs/examples/buttons/link.vue +47 -47
  115. package/docs/examples/buttons/popup.vue +39 -39
  116. package/docs/examples/buttons/size.vue +45 -45
  117. package/docs/examples/cascader-select/basic.vue +28 -28
  118. package/docs/examples/cascader-select/clearable.vue +34 -34
  119. package/docs/examples/cascader-select/disabled.vue +43 -43
  120. package/docs/examples/cascader-select/filterable.vue +37 -37
  121. package/docs/examples/cascader-select/methods.vue +84 -84
  122. package/docs/examples/cascader-select/multiple.vue +38 -38
  123. package/docs/examples/cascader-select/slot.vue +45 -45
  124. package/docs/examples/checkbox/basic.vue +18 -18
  125. package/docs/examples/checkbox/button.vue +19 -19
  126. package/docs/examples/checkbox/color.vue +25 -25
  127. package/docs/examples/checkbox/disabled.vue +17 -17
  128. package/docs/examples/checkbox/min-max.vue +20 -20
  129. package/docs/examples/checkbox/mixed.vue +56 -56
  130. package/docs/examples/checkbox/size.vue +28 -28
  131. package/docs/examples/code-mirror/basic.vue +11 -11
  132. package/docs/examples/code-mirror/events.vue +42 -42
  133. package/docs/examples/code-mirror/height.vue +25 -25
  134. package/docs/examples/code-mirror/mode.vue +33 -33
  135. package/docs/examples/code-mirror/readonly.vue +14 -14
  136. package/docs/examples/collapse/basic.vue +82 -82
  137. package/docs/examples/comp/basic.vue +7 -7
  138. package/docs/examples/comp/collapse.vue +38 -38
  139. package/docs/examples/comp/tabs.vue +38 -38
  140. package/docs/examples/count/basic.vue +101 -101
  141. package/docs/examples/count-up/basic.vue +89 -89
  142. package/docs/examples/data-panel/basic.vue +110 -110
  143. package/docs/examples/date/basic.vue +73 -73
  144. package/docs/examples/date/default-value.vue +59 -59
  145. package/docs/examples/date/format.vue +75 -75
  146. package/docs/examples/date/range.vue +66 -66
  147. package/docs/examples/date/types.vue +79 -79
  148. package/docs/examples/decorated-title/basic.vue +31 -31
  149. package/docs/examples/dialog/basic.vue +36 -36
  150. package/docs/examples/dialog/custom-buttons.vue +44 -44
  151. package/docs/examples/dialog/fullscreen.vue +23 -23
  152. package/docs/examples/dialog/no-mask.vue +17 -17
  153. package/docs/examples/dialog/size.vue +44 -44
  154. package/docs/examples/dialog/steps.vue +57 -57
  155. package/docs/examples/dialog-full/basic.vue +29 -29
  156. package/docs/examples/dialog-full/custom-buttons.vue +45 -45
  157. package/docs/examples/dialog-full/no-buttons.vue +18 -18
  158. package/docs/examples/dialog-full/no-header.vue +27 -27
  159. package/docs/examples/dialog-full/steps.vue +71 -71
  160. package/docs/examples/divider/basic.vue +52 -52
  161. package/docs/examples/drawer/basic.vue +35 -35
  162. package/docs/examples/drawer/custom-buttons.vue +34 -34
  163. package/docs/examples/drawer/direction.vue +47 -47
  164. package/docs/examples/drawer/mask.vue +36 -36
  165. package/docs/examples/drawer/no-buttons.vue +20 -20
  166. package/docs/examples/drawer/size.vue +28 -28
  167. package/docs/examples/dynamic-layer/basic.vue +33 -33
  168. package/docs/examples/dynamic-layer/custom-buttons.vue +43 -43
  169. package/docs/examples/dynamic-layer/form.vue +73 -73
  170. package/docs/examples/dynamic-layer/steps.vue +52 -52
  171. package/docs/examples/dynamic-layer/types.vue +40 -40
  172. package/docs/examples/echarts/basic.vue +31 -31
  173. package/docs/examples/echarts/dynamic.vue +43 -43
  174. package/docs/examples/echarts/line.vue +46 -46
  175. package/docs/examples/echarts/pie.vue +44 -44
  176. package/docs/examples/editor/basic.vue +15 -15
  177. package/docs/examples/form/basic.vue +665 -662
  178. package/docs/examples/form/init.vue +76 -76
  179. package/docs/examples/form/master-detail.vue +203 -203
  180. package/docs/examples/form/rule-format.vue +179 -179
  181. package/docs/examples/guid/basic.vue +10 -10
  182. package/docs/examples/guid/size.vue +13 -13
  183. package/docs/examples/hpanel/basic.vue +79 -79
  184. package/docs/examples/icon/basic.vue +9 -9
  185. package/docs/examples/icon/rotate-flip.vue +9 -9
  186. package/docs/examples/icon/size.vue +7 -7
  187. package/docs/examples/input/basic.vue +10 -10
  188. package/docs/examples/input/clearable.vue +12 -12
  189. package/docs/examples/input/disabled.vue +6 -6
  190. package/docs/examples/input/icon.vue +23 -23
  191. package/docs/examples/input/password.vue +18 -18
  192. package/docs/examples/input/size.vue +13 -13
  193. package/docs/examples/input/textarea.vue +25 -25
  194. package/docs/examples/input/word-limit.vue +28 -28
  195. package/docs/examples/input-button/basic.vue +33 -33
  196. package/docs/examples/input-code/basic.vue +29 -29
  197. package/docs/examples/input-color/basic.vue +10 -10
  198. package/docs/examples/input-color/disabled.vue +13 -13
  199. package/docs/examples/input-color/format.vue +17 -17
  200. package/docs/examples/input-color/no-alpha.vue +13 -13
  201. package/docs/examples/input-color/only-button.vue +15 -15
  202. package/docs/examples/input-color/predefine.vue +31 -31
  203. package/docs/examples/input-color/size.vue +15 -15
  204. package/docs/examples/input-layer/basic.vue +86 -86
  205. package/docs/examples/input-rows/basic.vue +73 -73
  206. package/docs/examples/input-rows/drag.vue +48 -48
  207. package/docs/examples/input-rows/layer-form.vue +85 -85
  208. package/docs/examples/input-rows/nested.vue +91 -91
  209. package/docs/examples/input-tag/basic.vue +27 -27
  210. package/docs/examples/input-tag/colors.vue +23 -23
  211. package/docs/examples/input-tag/readonly.vue +17 -17
  212. package/docs/examples/layer/basic.vue +43 -43
  213. package/docs/examples/layer/custom-buttons.vue +61 -61
  214. package/docs/examples/layer/drawer.vue +37 -37
  215. package/docs/examples/layer/full.vue +38 -38
  216. package/docs/examples/layer/modal.vue +34 -34
  217. package/docs/examples/layer/steps.vue +46 -46
  218. package/docs/examples/layer-form/basic.vue +76 -76
  219. package/docs/examples/layer-form/config.vue +82 -82
  220. package/docs/examples/layer-form/size.vue +72 -72
  221. package/docs/examples/layout/basic.vue +36 -36
  222. package/docs/examples/layout/custom-size.vue +50 -50
  223. package/docs/examples/layout/disable-move.vue +37 -37
  224. package/docs/examples/layout/hide-mid-when-narrow.vue +96 -96
  225. package/docs/examples/layout/min-size.vue +73 -73
  226. package/docs/examples/layout/percent-size.vue +80 -80
  227. package/docs/examples/layout/simple.vue +22 -22
  228. package/docs/examples/layout/top-side.vue +34 -34
  229. package/docs/examples/map/basic.vue +22 -22
  230. package/docs/examples/menu/basic.vue +58 -58
  231. package/docs/examples/menu/collapsed.vue +49 -49
  232. package/docs/examples/menu/horizontal.vue +44 -44
  233. package/docs/examples/menu/selection-test.vue +104 -104
  234. package/docs/examples/menu/theme.vue +46 -46
  235. package/docs/examples/menu/vertical.vue +46 -46
  236. package/docs/examples/number/advanced.vue +143 -143
  237. package/docs/examples/number/basic.vue +63 -63
  238. package/docs/examples/number/disabled.vue +49 -49
  239. package/docs/examples/number/size.vue +42 -42
  240. package/docs/examples/number/slots.vue +123 -123
  241. package/docs/examples/number/step-strictly.vue +41 -41
  242. package/docs/examples/number/step.vue +47 -47
  243. package/docs/examples/page/basic.vue +41 -41
  244. package/docs/examples/page/code-table-model.vue +428 -428
  245. package/docs/examples/page/dept-user-management.vue +211 -211
  246. package/docs/examples/page/init.vue +87 -87
  247. package/docs/examples/page/log.vue +453 -453
  248. package/docs/examples/page/user-management.vue +313 -313
  249. package/docs/examples/panel/tool-buttons.vue +18 -18
  250. package/docs/examples/radio/basic.vue +17 -17
  251. package/docs/examples/radio/button.vue +17 -17
  252. package/docs/examples/radio/color.vue +18 -18
  253. package/docs/examples/radio/disabled.vue +17 -17
  254. package/docs/examples/radio/size.vue +29 -29
  255. package/docs/examples/rate/basic.vue +24 -24
  256. package/docs/examples/rate/half.vue +24 -24
  257. package/docs/examples/rate/readonly.vue +11 -11
  258. package/docs/examples/rate/text.vue +37 -37
  259. package/docs/examples/select/basic.vue +16 -16
  260. package/docs/examples/select/clearable.vue +22 -22
  261. package/docs/examples/select/disabled.vue +31 -31
  262. package/docs/examples/select/filterable.vue +24 -24
  263. package/docs/examples/select/group.vue +23 -23
  264. package/docs/examples/select/icon.vue +16 -16
  265. package/docs/examples/select/multiple.vue +18 -18
  266. package/docs/examples/select/size.vue +39 -39
  267. package/docs/examples/slider/basic.vue +42 -42
  268. package/docs/examples/slider/disabled.vue +17 -17
  269. package/docs/examples/slider/marks.vue +30 -30
  270. package/docs/examples/slider/size.vue +37 -37
  271. package/docs/examples/slider/tooltip.vue +36 -36
  272. package/docs/examples/slider/vertical.vue +26 -26
  273. package/docs/examples/slider-captcha/basic.vue +44 -44
  274. package/docs/examples/slider-captcha/custom.vue +48 -48
  275. package/docs/examples/switch/basic.vue +16 -16
  276. package/docs/examples/switch/disabled.vue +13 -13
  277. package/docs/examples/switch/loading.vue +13 -13
  278. package/docs/examples/switch/size.vue +15 -15
  279. package/docs/examples/switch/text.vue +13 -13
  280. package/docs/examples/table/action-filter.vue +126 -126
  281. package/docs/examples/table/actions.vue +116 -116
  282. package/docs/examples/table/add-row.vue +103 -103
  283. package/docs/examples/table/basic.vue +168 -168
  284. package/docs/examples/table/checkbox-layout.vue +68 -68
  285. package/docs/examples/table/custom-layout.vue +115 -115
  286. package/docs/examples/table/dynamic-type.vue +73 -73
  287. package/docs/examples/table/editable.vue +262 -262
  288. package/docs/examples/table/field-selection.vue +87 -87
  289. package/docs/examples/table/frozen-column.vue +140 -140
  290. package/docs/examples/table/height-mode.vue +99 -99
  291. package/docs/examples/table/icon.vue +85 -85
  292. package/docs/examples/table/link.vue +66 -66
  293. package/docs/examples/table/multiple.vue +188 -188
  294. package/docs/examples/table/pagination.vue +151 -151
  295. package/docs/examples/table/single-selection.vue +64 -64
  296. package/docs/examples/table/sub-table-lazy.vue +97 -97
  297. package/docs/examples/table/sub-table.vue +103 -103
  298. package/docs/examples/table/tag.vue +43 -43
  299. package/docs/examples/table/tree-column.vue +119 -119
  300. package/docs/examples/table/tree-data.vue +141 -141
  301. package/docs/examples/table/tree-default-expand-all.vue +60 -60
  302. package/docs/examples/table/tree-lazy.vue +80 -80
  303. package/docs/examples/table/tree-set-selection.vue +75 -75
  304. package/docs/examples/table-panel/basic.vue +229 -229
  305. package/docs/examples/table-panel/batch-operations.vue +285 -285
  306. package/docs/examples/table-panel/button-visibility.vue +88 -88
  307. package/docs/examples/table-panel/filter.vue +219 -219
  308. package/docs/examples/table-panel/get-selection.vue +111 -111
  309. package/docs/examples/table-panel/multiple-selection.vue +243 -243
  310. package/docs/examples/table-panel/pagination.vue +133 -133
  311. package/docs/examples/table-panel/sub-table-lazy.vue +118 -118
  312. package/docs/examples/table-panel/tree-parent-key.vue +67 -67
  313. package/docs/examples/tabs/basic.vue +98 -98
  314. package/docs/examples/time/base.vue +67 -67
  315. package/docs/examples/title/basic.vue +87 -87
  316. package/docs/examples/tree/accordion.vue +46 -46
  317. package/docs/examples/tree/basic.vue +50 -50
  318. package/docs/examples/tree/buttons.vue +53 -53
  319. package/docs/examples/tree/checkable.vue +52 -52
  320. package/docs/examples/tree/custom-keys.vue +39 -39
  321. package/docs/examples/tree/default-expanded.vue +52 -52
  322. package/docs/examples/tree/draggable.vue +29 -29
  323. package/docs/examples/tree/expand-on-click.vue +39 -39
  324. package/docs/examples/tree/flat-data.vue +20 -20
  325. package/docs/examples/tree/icon.vue +40 -40
  326. package/docs/examples/tree/load-data.vue +37 -37
  327. package/docs/examples/tree/methods.vue +74 -74
  328. package/docs/examples/tree/theme.vue +33 -33
  329. package/docs/examples/tree-select/basic.vue +47 -47
  330. package/docs/examples/upload/accept.vue +31 -31
  331. package/docs/examples/upload/basic.vue +12 -12
  332. package/docs/examples/upload/drag.vue +11 -11
  333. package/docs/examples/upload/image.vue +17 -17
  334. package/docs/examples/upload/limit.vue +20 -20
  335. package/docs/examples/upload/multiple.vue +17 -17
  336. package/docs/examples/upload/readonly.vue +17 -17
  337. package/docs/examples/utils/cipher.vue +160 -160
  338. package/docs/examples/utils/common.vue +153 -153
  339. package/docs/examples/utils/date.vue +56 -56
  340. package/docs/examples/utils/dom.vue +52 -52
  341. package/docs/examples/utils/is.vue +70 -70
  342. package/docs/examples/workflow/basic.vue +265 -265
  343. package/docs/examples/workflow-viewer/basic.vue +248 -248
  344. package/package.json +23 -23
@@ -1,26 +1,26 @@
1
- # Tabs 标签页
2
-
3
- 用于分隔内容上有关联但属于不同类别的数据集合。
4
-
5
- ## 基础用法
6
-
7
- 基础的、简洁的标签页。
8
-
9
- <Demo :source-code="tabsBasicCode">
10
- <template #source>
11
- <tabs-basic />
12
- </template>
13
- <template #description>
14
- 通过 `v-model` 绑定当前激活的标签页,使用 `el-tab-pane` 定义标签页内容。
15
- </template>
16
- </Demo>
17
-
18
- ## API
19
-
20
- <ApiTable :data="tabsApi" componentName="tabs" />
21
-
22
- <script setup>
23
- import TabsBasic from '../examples/tabs/basic.vue'
24
- import tabsApi from './meta/tabs'
25
- import tabsBasicCode from '../examples/tabs/basic.vue?raw'
26
- </script>
1
+ # Tabs 标签页
2
+
3
+ 用于分隔内容上有关联但属于不同类别的数据集合。
4
+
5
+ ## 基础用法
6
+
7
+ 基础的、简洁的标签页。
8
+
9
+ <Demo :source-code="tabsBasicCode">
10
+ <template #source>
11
+ <tabs-basic />
12
+ </template>
13
+ <template #description>
14
+ 通过 `v-model` 绑定当前激活的标签页,使用 `el-tab-pane` 定义标签页内容。
15
+ </template>
16
+ </Demo>
17
+
18
+ ## API
19
+
20
+ <ApiTable :data="tabsApi" componentName="tabs" />
21
+
22
+ <script setup>
23
+ import TabsBasic from '../examples/tabs/basic.vue'
24
+ import tabsApi from './meta/tabs'
25
+ import tabsBasicCode from '../examples/tabs/basic.vue?raw'
26
+ </script>
@@ -1,24 +1,24 @@
1
- # Title 标题
2
-
3
- 用于展示页面或区域的标题文本。支持自定义颜色、大小、粗细和样式等功能。
4
-
5
- ## 基础用法
6
-
7
- <Demo :source-code="titleBasicCode">
8
- <template #source>
9
- <title-basic />
10
- </template>
11
- <template #description>
12
- 通过 `title` 属性设置标题内容,支持 `color`、`size`、`weight` 等属性自定义样式。
13
- </template>
14
- </Demo>
15
-
16
- ## API
17
-
18
- <ApiTable :data="titleApi" componentName="title" />
19
-
20
- <script setup>
21
- import TitleBasic from '../examples/title/basic.vue'
22
- import titleApi from './meta/title'
23
- import titleBasicCode from '../examples/title/basic.vue?raw'
24
- </script>
1
+ # Title 标题
2
+
3
+ 用于展示页面或区域的标题文本。支持自定义颜色、大小、粗细和样式等功能。
4
+
5
+ ## 基础用法
6
+
7
+ <Demo :source-code="titleBasicCode">
8
+ <template #source>
9
+ <title-basic />
10
+ </template>
11
+ <template #description>
12
+ 通过 `title` 属性设置标题内容,支持 `color`、`size`、`weight` 等属性自定义样式。
13
+ </template>
14
+ </Demo>
15
+
16
+ ## API
17
+
18
+ <ApiTable :data="titleApi" componentName="title" />
19
+
20
+ <script setup>
21
+ import TitleBasic from '../examples/title/basic.vue'
22
+ import titleApi from './meta/title'
23
+ import titleBasicCode from '../examples/title/basic.vue?raw'
24
+ </script>
@@ -1,207 +1,207 @@
1
- # Tree 树形控件
2
-
3
- 用清晰的层级结构展示信息,可展开或折叠。
4
-
5
- ## 基础用法
6
-
7
- 基础的树形结构展示。
8
-
9
- <Demo :source-code="treeBasicCode">
10
- <template #source>
11
- <tree-basic />
12
- </template>
13
- <template #description>
14
- 通过 `list` 属性设置树形数据,`click` 事件监听节点点击。
15
- </template>
16
- </Demo>
17
-
18
- ## 扁平数据
19
-
20
- 支持扁平数组数据,会自动转换为树形结构。
21
-
22
- <Demo :source-code="treeFlatDataCode">
23
- <template #source>
24
- <tree-flat-data />
25
- </template>
26
- <template #description>
27
- 设置 `is-tree-data` 为 `false`,组件会自动将扁平数组转换为树形结构。需要提供 `pid` 字段表示父级关系。
28
- </template>
29
- </Demo>
30
-
31
- ## 可选择
32
-
33
- 使用 `checkable` 属性开启复选框功能。
34
-
35
- <Demo :source-code="treeCheckableCode">
36
- <template #source>
37
- <tree-checkable />
38
- </template>
39
- <template #description>
40
- 设置 `checkable` 为 `true` 显示复选框,通过 `default-checked-keys` 设置默认选中,`check` 事件监听勾选变化。
41
- </template>
42
- </Demo>
43
-
44
- ## 异步加载
45
-
46
- 通过 `load-data` 属性异步加载数据。
47
-
48
- <Demo :source-code="treeLoadDataCode">
49
- <template #source>
50
- <tree-load-data />
51
- </template>
52
- <template #description>
53
- 使用 `load-data` 属性传入异步加载函数,`after-load-data` 在数据加载完成后触发。
54
- </template>
55
- </Demo>
56
-
57
- ## 图标
58
-
59
- 支持为节点设置图标。
60
-
61
- <Demo :source-code="treeIconCode">
62
- <template #source>
63
- <tree-icon />
64
- </template>
65
- <template #description>
66
- 通过 `default-icon` 和 `default-icon-color` 设置默认图标,节点数据中的 `nodeIcon` 和 `nodeIconColor` 字段可以覆盖默认值。
67
- </template>
68
- </Demo>
69
-
70
- ## 节点操作按钮
71
-
72
- 通过 `tree-buttons` 属性为节点添加操作按钮。
73
-
74
- <Demo :source-code="treeButtonsCode">
75
- <template #source>
76
- <tree-buttons />
77
- </template>
78
- <template #description>
79
- 配置 `tree-buttons` 数组,每个节点右侧会显示操作按钮,点击按钮会触发对应的 `click` 方法。
80
- </template>
81
- </Demo>
82
-
83
- ## 手风琴模式
84
-
85
- 使用 `accordion` 属性开启手风琴模式。
86
-
87
- <Demo :source-code="treeAccordionCode">
88
- <template #source>
89
- <tree-accordion />
90
- </template>
91
- <template #description>
92
- 设置 `accordion` 为 `true`,每次只打开一个同级树节点。
93
- </template>
94
- </Demo>
95
-
96
- ## 主题
97
-
98
- 通过 `theme` 属性设置主题样式。
99
-
100
- <Demo :source-code="treeThemeCode">
101
- <template #source>
102
- <tree-theme />
103
- </template>
104
- <template #description>
105
- 支持 `default` 和 `menu` 两种主题,`menu` 主题适用于菜单场景。
106
- </template>
107
- </Demo>
108
-
109
- ## 可拖拽
110
-
111
- 使用 `draggable` 属性开启拖拽功能。
112
-
113
- <Demo :source-code="treeDraggableCode">
114
- <template #source>
115
- <tree-draggable />
116
- </template>
117
- <template #description>
118
- 设置 `draggable` 为 `true` 开启拖拽,节点数据中的 `canInner` 字段控制是否允许拖入内部。
119
- </template>
120
- </Demo>
121
-
122
- ## 点击展开
123
-
124
- 使用 `expand-on-click-node` 属性控制点击节点是否展开。
125
-
126
- <Demo :source-code="treeExpandOnClickCode">
127
- <template #source>
128
- <tree-expand-on-click />
129
- </template>
130
- <template #description>
131
- 设置 `expand-on-click-node` 为 `true`,点击节点时会展开或收缩,默认为 `false`,只有点击箭头图标才会展开。
132
- </template>
133
- </Demo>
134
-
135
- ## 自定义字段名
136
-
137
- 通过 `label-key`、`value-key`、`pid-key` 等属性自定义字段名。
138
-
139
- <Demo :source-code="treeCustomKeysCode">
140
- <template #source>
141
- <tree-custom-keys />
142
- </template>
143
- <template #description>
144
- 当数据字段名不是默认值时,可以通过这些属性自定义字段名。
145
- </template>
146
- </Demo>
147
-
148
- ## 默认展开
149
-
150
- 通过 `default-expanded-keys` 和 `default-expand-all` 控制默认展开状态。
151
-
152
- <Demo :source-code="treeDefaultExpandedCode">
153
- <template #source>
154
- <tree-default-expanded />
155
- </template>
156
- <template #description>
157
- 使用 `default-expanded-keys` 设置默认展开的节点,`default-expand-all` 控制是否默认展开所有节点。
158
- </template>
159
- </Demo>
160
-
161
- ## 方法调用
162
-
163
- 通过 ref 调用组件方法。
164
-
165
- <Demo :source-code="treeMethodsCode">
166
- <template #source>
167
- <tree-methods />
168
- </template>
169
- <template #description>
170
- 使用 `setValue` 设置选中节点,`getValue` 获取选中节点,`setCheck` 设置选中复选框,`getCheck` 获取选中的复选框,`refreshData` 刷新数据。
171
- </template>
172
- </Demo>
173
-
174
- ## API
175
-
176
- <ApiTable :data="treeApi" componentName="tree" />
177
-
178
- <script setup>
179
- import TreeBasic from '../examples/tree/basic.vue'
180
- import TreeFlatData from '../examples/tree/flat-data.vue'
181
- import TreeCheckable from '../examples/tree/checkable.vue'
182
- import TreeLoadData from '../examples/tree/load-data.vue'
183
- import TreeIcon from '../examples/tree/icon.vue'
184
- import TreeButtons from '../examples/tree/buttons.vue'
185
- import TreeAccordion from '../examples/tree/accordion.vue'
186
- import TreeTheme from '../examples/tree/theme.vue'
187
- import TreeDraggable from '../examples/tree/draggable.vue'
188
- import TreeExpandOnClick from '../examples/tree/expand-on-click.vue'
189
- import TreeCustomKeys from '../examples/tree/custom-keys.vue'
190
- import TreeDefaultExpanded from '../examples/tree/default-expanded.vue'
191
- import TreeMethods from '../examples/tree/methods.vue'
192
- import treeApi from './meta/tree'
193
-
194
- import treeBasicCode from '../examples/tree/basic.vue?raw'
195
- import treeFlatDataCode from '../examples/tree/flat-data.vue?raw'
196
- import treeCheckableCode from '../examples/tree/checkable.vue?raw'
197
- import treeLoadDataCode from '../examples/tree/load-data.vue?raw'
198
- import treeIconCode from '../examples/tree/icon.vue?raw'
199
- import treeButtonsCode from '../examples/tree/buttons.vue?raw'
200
- import treeAccordionCode from '../examples/tree/accordion.vue?raw'
201
- import treeThemeCode from '../examples/tree/theme.vue?raw'
202
- import treeDraggableCode from '../examples/tree/draggable.vue?raw'
203
- import treeExpandOnClickCode from '../examples/tree/expand-on-click.vue?raw'
204
- import treeCustomKeysCode from '../examples/tree/custom-keys.vue?raw'
205
- import treeDefaultExpandedCode from '../examples/tree/default-expanded.vue?raw'
206
- import treeMethodsCode from '../examples/tree/methods.vue?raw'
207
- </script>
1
+ # Tree 树形控件
2
+
3
+ 用清晰的层级结构展示信息,可展开或折叠。
4
+
5
+ ## 基础用法
6
+
7
+ 基础的树形结构展示。
8
+
9
+ <Demo :source-code="treeBasicCode">
10
+ <template #source>
11
+ <tree-basic />
12
+ </template>
13
+ <template #description>
14
+ 通过 `list` 属性设置树形数据,`click` 事件监听节点点击。
15
+ </template>
16
+ </Demo>
17
+
18
+ ## 扁平数据
19
+
20
+ 支持扁平数组数据,会自动转换为树形结构。
21
+
22
+ <Demo :source-code="treeFlatDataCode">
23
+ <template #source>
24
+ <tree-flat-data />
25
+ </template>
26
+ <template #description>
27
+ 设置 `is-tree-data` 为 `false`,组件会自动将扁平数组转换为树形结构。需要提供 `pid` 字段表示父级关系。
28
+ </template>
29
+ </Demo>
30
+
31
+ ## 可选择
32
+
33
+ 使用 `checkable` 属性开启复选框功能。
34
+
35
+ <Demo :source-code="treeCheckableCode">
36
+ <template #source>
37
+ <tree-checkable />
38
+ </template>
39
+ <template #description>
40
+ 设置 `checkable` 为 `true` 显示复选框,通过 `default-checked-keys` 设置默认选中,`check` 事件监听勾选变化。
41
+ </template>
42
+ </Demo>
43
+
44
+ ## 异步加载
45
+
46
+ 通过 `load-data` 属性异步加载数据。
47
+
48
+ <Demo :source-code="treeLoadDataCode">
49
+ <template #source>
50
+ <tree-load-data />
51
+ </template>
52
+ <template #description>
53
+ 使用 `load-data` 属性传入异步加载函数,`after-load-data` 在数据加载完成后触发。
54
+ </template>
55
+ </Demo>
56
+
57
+ ## 图标
58
+
59
+ 支持为节点设置图标。
60
+
61
+ <Demo :source-code="treeIconCode">
62
+ <template #source>
63
+ <tree-icon />
64
+ </template>
65
+ <template #description>
66
+ 通过 `default-icon` 和 `default-icon-color` 设置默认图标,节点数据中的 `nodeIcon` 和 `nodeIconColor` 字段可以覆盖默认值。
67
+ </template>
68
+ </Demo>
69
+
70
+ ## 节点操作按钮
71
+
72
+ 通过 `tree-buttons` 属性为节点添加操作按钮。
73
+
74
+ <Demo :source-code="treeButtonsCode">
75
+ <template #source>
76
+ <tree-buttons />
77
+ </template>
78
+ <template #description>
79
+ 配置 `tree-buttons` 数组,每个节点右侧会显示操作按钮,点击按钮会触发对应的 `click` 方法。
80
+ </template>
81
+ </Demo>
82
+
83
+ ## 手风琴模式
84
+
85
+ 使用 `accordion` 属性开启手风琴模式。
86
+
87
+ <Demo :source-code="treeAccordionCode">
88
+ <template #source>
89
+ <tree-accordion />
90
+ </template>
91
+ <template #description>
92
+ 设置 `accordion` 为 `true`,每次只打开一个同级树节点。
93
+ </template>
94
+ </Demo>
95
+
96
+ ## 主题
97
+
98
+ 通过 `theme` 属性设置主题样式。
99
+
100
+ <Demo :source-code="treeThemeCode">
101
+ <template #source>
102
+ <tree-theme />
103
+ </template>
104
+ <template #description>
105
+ 支持 `default` 和 `menu` 两种主题,`menu` 主题适用于菜单场景。
106
+ </template>
107
+ </Demo>
108
+
109
+ ## 可拖拽
110
+
111
+ 使用 `draggable` 属性开启拖拽功能。
112
+
113
+ <Demo :source-code="treeDraggableCode">
114
+ <template #source>
115
+ <tree-draggable />
116
+ </template>
117
+ <template #description>
118
+ 设置 `draggable` 为 `true` 开启拖拽,节点数据中的 `canInner` 字段控制是否允许拖入内部。
119
+ </template>
120
+ </Demo>
121
+
122
+ ## 点击展开
123
+
124
+ 使用 `expand-on-click-node` 属性控制点击节点是否展开。
125
+
126
+ <Demo :source-code="treeExpandOnClickCode">
127
+ <template #source>
128
+ <tree-expand-on-click />
129
+ </template>
130
+ <template #description>
131
+ 设置 `expand-on-click-node` 为 `true`,点击节点时会展开或收缩,默认为 `false`,只有点击箭头图标才会展开。
132
+ </template>
133
+ </Demo>
134
+
135
+ ## 自定义字段名
136
+
137
+ 通过 `label-key`、`value-key`、`pid-key` 等属性自定义字段名。
138
+
139
+ <Demo :source-code="treeCustomKeysCode">
140
+ <template #source>
141
+ <tree-custom-keys />
142
+ </template>
143
+ <template #description>
144
+ 当数据字段名不是默认值时,可以通过这些属性自定义字段名。
145
+ </template>
146
+ </Demo>
147
+
148
+ ## 默认展开
149
+
150
+ 通过 `default-expanded-keys` 和 `default-expand-all` 控制默认展开状态。
151
+
152
+ <Demo :source-code="treeDefaultExpandedCode">
153
+ <template #source>
154
+ <tree-default-expanded />
155
+ </template>
156
+ <template #description>
157
+ 使用 `default-expanded-keys` 设置默认展开的节点,`default-expand-all` 控制是否默认展开所有节点。
158
+ </template>
159
+ </Demo>
160
+
161
+ ## 方法调用
162
+
163
+ 通过 ref 调用组件方法。
164
+
165
+ <Demo :source-code="treeMethodsCode">
166
+ <template #source>
167
+ <tree-methods />
168
+ </template>
169
+ <template #description>
170
+ 使用 `setValue` 设置选中节点,`getValue` 获取选中节点,`setCheck` 设置选中复选框,`getCheck` 获取选中的复选框,`refreshData` 刷新数据。
171
+ </template>
172
+ </Demo>
173
+
174
+ ## API
175
+
176
+ <ApiTable :data="treeApi" componentName="tree" />
177
+
178
+ <script setup>
179
+ import TreeBasic from '../examples/tree/basic.vue'
180
+ import TreeFlatData from '../examples/tree/flat-data.vue'
181
+ import TreeCheckable from '../examples/tree/checkable.vue'
182
+ import TreeLoadData from '../examples/tree/load-data.vue'
183
+ import TreeIcon from '../examples/tree/icon.vue'
184
+ import TreeButtons from '../examples/tree/buttons.vue'
185
+ import TreeAccordion from '../examples/tree/accordion.vue'
186
+ import TreeTheme from '../examples/tree/theme.vue'
187
+ import TreeDraggable from '../examples/tree/draggable.vue'
188
+ import TreeExpandOnClick from '../examples/tree/expand-on-click.vue'
189
+ import TreeCustomKeys from '../examples/tree/custom-keys.vue'
190
+ import TreeDefaultExpanded from '../examples/tree/default-expanded.vue'
191
+ import TreeMethods from '../examples/tree/methods.vue'
192
+ import treeApi from './meta/tree'
193
+
194
+ import treeBasicCode from '../examples/tree/basic.vue?raw'
195
+ import treeFlatDataCode from '../examples/tree/flat-data.vue?raw'
196
+ import treeCheckableCode from '../examples/tree/checkable.vue?raw'
197
+ import treeLoadDataCode from '../examples/tree/load-data.vue?raw'
198
+ import treeIconCode from '../examples/tree/icon.vue?raw'
199
+ import treeButtonsCode from '../examples/tree/buttons.vue?raw'
200
+ import treeAccordionCode from '../examples/tree/accordion.vue?raw'
201
+ import treeThemeCode from '../examples/tree/theme.vue?raw'
202
+ import treeDraggableCode from '../examples/tree/draggable.vue?raw'
203
+ import treeExpandOnClickCode from '../examples/tree/expand-on-click.vue?raw'
204
+ import treeCustomKeysCode from '../examples/tree/custom-keys.vue?raw'
205
+ import treeDefaultExpandedCode from '../examples/tree/default-expanded.vue?raw'
206
+ import treeMethodsCode from '../examples/tree/methods.vue?raw'
207
+ </script>