king-design-analyzer 2.1.9 → 2.2.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.
Files changed (327) hide show
  1. package/components/actions.json +109 -0
  2. package/components/advancedset.json +128 -0
  3. package/components/affix.json +8 -0
  4. package/components/aksk.json +172 -0
  5. package/components/anchor.json +220 -0
  6. package/components/anchorlink.json +111 -0
  7. package/components/az.json +15 -2
  8. package/components/badge.json +8 -0
  9. package/components/billtypes.json +14 -2
  10. package/components/breadcrumb.json +9 -1
  11. package/components/button.json +192 -0
  12. package/components/buttonlink.json +74 -0
  13. package/components/card.json +14 -4
  14. package/components/cardcol.json +142 -0
  15. package/components/cardcols.json +121 -0
  16. package/components/cardcontent.json +20 -3
  17. package/components/cardtabs.json +172 -0
  18. package/components/carousel.json +7 -0
  19. package/components/cascader.json +576 -368
  20. package/components/checkbox.json +51 -4
  21. package/components/cidrinput.json +140 -0
  22. package/components/code.json +8 -1
  23. package/components/collapse.json +335 -341
  24. package/components/colorpicker.json +217 -0
  25. package/components/configprovider.json +96 -0
  26. package/components/copy.json +7 -0
  27. package/components/copyhover.json +111 -0
  28. package/components/copyrow.json +125 -0
  29. package/components/datepicker.json +656 -524
  30. package/components/description.json +98 -0
  31. package/components/descriptions.json +10 -3
  32. package/components/diagram.json +295 -0
  33. package/components/dialog.json +526 -455
  34. package/components/divider.json +9 -1
  35. package/components/drawer.json +603 -558
  36. package/components/dropdown.json +464 -384
  37. package/components/duration.json +125 -0
  38. package/components/editable.json +66 -0
  39. package/components/ellipsis.json +34 -1
  40. package/components/filtertablefieldsdialog.json +128 -0
  41. package/components/flex.json +152 -0
  42. package/components/form.json +143 -3
  43. package/components/formiteminput.json +214 -0
  44. package/components/formitemspinner.json +213 -0
  45. package/components/formitemswitch.json +185 -0
  46. package/components/formitemtableconfigs.json +210 -0
  47. package/components/grid.json +7 -0
  48. package/components/header.json +165 -0
  49. package/components/icon.json +13 -1
  50. package/components/icontooltip.json +19 -1
  51. package/components/input.json +196 -8
  52. package/components/instancelist.json +194 -0
  53. package/components/instancenum.json +196 -0
  54. package/components/ipinput.json +117 -0
  55. package/components/kspstatus.json +205 -0
  56. package/components/kvcode.json +120 -0
  57. package/components/layoutcontent.json +24 -3
  58. package/components/layoutlistcontent.json +157 -0
  59. package/components/layoutpermissioncontent.json +156 -0
  60. package/components/layoutstandardlist.json +276 -0
  61. package/components/layouttabs.json +168 -0
  62. package/components/lazymount.json +87 -0
  63. package/components/lazyteleport.json +119 -0
  64. package/components/menu.json +11 -3
  65. package/components/notification.json +351 -0
  66. package/components/pagination.json +12 -0
  67. package/components/paginationplus.json +30 -3
  68. package/components/password.json +121 -0
  69. package/components/popover.json +457 -437
  70. package/components/projects.json +129 -0
  71. package/components/protable.json +99 -8
  72. package/components/queuevisualrange.json +110 -0
  73. package/components/radio.json +82 -2
  74. package/components/rate.json +200 -0
  75. package/components/region.json +14 -2
  76. package/components/scrollselect.json +140 -0
  77. package/components/search.json +221 -0
  78. package/components/searchinput.json +132 -0
  79. package/components/searchitems.json +215 -0
  80. package/components/searchselect.json +195 -0
  81. package/components/select.json +749 -666
  82. package/components/sidebar.json +198 -0
  83. package/components/skeleton.json +234 -0
  84. package/components/slider.json +12 -2
  85. package/components/spin.json +10 -2
  86. package/components/spinner.json +419 -429
  87. package/components/split.json +263 -0
  88. package/components/sshkeys.json +138 -0
  89. package/components/status.json +60 -3
  90. package/components/steps.json +7 -0
  91. package/components/switch.json +12 -3
  92. package/components/table.json +24 -2
  93. package/components/tablecolumnid.json +14 -2
  94. package/components/tabs.json +14 -2
  95. package/components/tag.json +8 -5
  96. package/components/timeline.json +215 -0
  97. package/components/timepicker.json +147 -3
  98. package/components/timerange.json +262 -0
  99. package/components/tip.json +27 -0
  100. package/components/tooltip.json +492 -395
  101. package/components/tour.json +418 -372
  102. package/components/transfer.json +79 -8
  103. package/components/tree.json +28 -5
  104. package/components/treeselect.json +612 -475
  105. package/components/upload.json +474 -473
  106. package/components/vdialog.json +309 -0
  107. package/components/vdrawer.json +335 -0
  108. package/components/virtuallist.json +7 -0
  109. package/dist/ast/index.d.mts +65 -2
  110. package/dist/ast/index.d.ts +65 -2
  111. package/dist/ast/index.js +4 -3
  112. package/dist/ast/index.mjs +2 -1
  113. package/dist/chunk-4OTQAQ6J.mjs +341 -0
  114. package/dist/{chunk-F26GUCGG.js → chunk-4WXOYU2N.js} +32 -9
  115. package/dist/chunk-6HOIRUQB.mjs +409 -0
  116. package/dist/chunk-DHLWNT53.js +364 -0
  117. package/dist/{chunk-H2ET6MMM.mjs → chunk-IPJJMPOO.mjs} +155 -66
  118. package/dist/{chunk-WYSRJVX4.js → chunk-JJ6AB4ZH.js} +2 -2
  119. package/dist/{chunk-2W6OCG2S.js → chunk-JNRGUR3O.js} +155 -67
  120. package/dist/chunk-KF5YBEM5.js +143 -0
  121. package/dist/{chunk-OJOHB64C.mjs → chunk-LRTDTFFQ.mjs} +28 -5
  122. package/dist/{chunk-DSWKLUIX.mjs → chunk-NZL6T22V.mjs} +1 -1
  123. package/dist/chunk-QC6VTSA3.mjs +117 -0
  124. package/dist/chunk-V5N65MRP.js +411 -0
  125. package/dist/full/index.d.mts +2 -0
  126. package/dist/full/index.d.ts +2 -0
  127. package/dist/full/index.js +7 -6
  128. package/dist/full/index.mjs +5 -4
  129. package/dist/index.d.mts +1 -0
  130. package/dist/index.d.ts +1 -0
  131. package/dist/index.js +14 -13
  132. package/dist/index.mjs +6 -5
  133. package/dist/metadata/index.d.mts +38 -3
  134. package/dist/metadata/index.d.ts +38 -3
  135. package/dist/metadata/index.js +26 -16
  136. package/dist/metadata/index.mjs +26 -15
  137. package/dist/resolve-BsLBxlBi.d.mts +24 -0
  138. package/dist/resolve-BsLBxlBi.d.ts +24 -0
  139. package/dist/runtime/index.d.mts +2 -0
  140. package/dist/runtime/index.d.ts +2 -0
  141. package/dist/runtime/index.js +4 -4
  142. package/dist/runtime/index.mjs +2 -2
  143. package/dist/shared/index.d.mts +10 -0
  144. package/dist/shared/index.d.ts +10 -0
  145. package/dist/shared/index.js +23 -0
  146. package/dist/shared/index.mjs +2 -0
  147. package/dist/static/index.js +5 -5
  148. package/dist/static/index.mjs +2 -2
  149. package/docs_for_llm/actions.doc.md +87 -0
  150. package/docs_for_llm/advancedset.doc.md +98 -0
  151. package/docs_for_llm/affix.doc.md +20 -7
  152. package/docs_for_llm/aksk.doc.md +111 -0
  153. package/docs_for_llm/anchor.doc.md +155 -0
  154. package/docs_for_llm/anchorlink.doc.md +75 -0
  155. package/docs_for_llm/az.doc.md +17 -11
  156. package/docs_for_llm/badge.doc.md +11 -5
  157. package/docs_for_llm/billtypes.doc.md +17 -11
  158. package/docs_for_llm/breadcrumb.doc.md +80 -4
  159. package/docs_for_llm/button.doc.md +91 -18
  160. package/docs_for_llm/buttonlink.doc.md +64 -0
  161. package/docs_for_llm/card.doc.md +58 -8
  162. package/docs_for_llm/cardcol.doc.md +78 -0
  163. package/docs_for_llm/cardcols.doc.md +84 -0
  164. package/docs_for_llm/cardcontent.doc.md +31 -10
  165. package/docs_for_llm/cardtabs.doc.md +106 -0
  166. package/docs_for_llm/carousel.doc.md +79 -7
  167. package/docs_for_llm/cascader.doc.md +106 -23
  168. package/docs_for_llm/checkbox.doc.md +25 -13
  169. package/docs_for_llm/cidrinput.doc.md +83 -0
  170. package/docs_for_llm/code.doc.md +22 -11
  171. package/docs_for_llm/collapse.doc.md +147 -14
  172. package/docs_for_llm/colorpicker.doc.md +104 -0
  173. package/docs_for_llm/configprovider.doc.md +77 -0
  174. package/docs_for_llm/copy.doc.md +15 -13
  175. package/docs_for_llm/copyhover.doc.md +59 -0
  176. package/docs_for_llm/copyrow.doc.md +80 -0
  177. package/docs_for_llm/datepicker.doc.md +66 -35
  178. package/docs_for_llm/description.doc.md +75 -0
  179. package/docs_for_llm/descriptions.doc.md +122 -10
  180. package/docs_for_llm/diagram.doc.md +343 -0
  181. package/docs_for_llm/dialog.doc.md +97 -77
  182. package/docs_for_llm/divider.doc.md +14 -7
  183. package/docs_for_llm/drawer.doc.md +114 -69
  184. package/docs_for_llm/dropdown.doc.md +290 -22
  185. package/docs_for_llm/duration.doc.md +76 -0
  186. package/docs_for_llm/editable.doc.md +36 -14
  187. package/docs_for_llm/ellipsis.doc.md +10 -5
  188. package/docs_for_llm/filtertablefieldsdialog.doc.md +99 -0
  189. package/docs_for_llm/flex.doc.md +83 -0
  190. package/docs_for_llm/form.doc.md +196 -18
  191. package/docs_for_llm/formiteminput.doc.md +128 -0
  192. package/docs_for_llm/formitemspinner.doc.md +105 -0
  193. package/docs_for_llm/formitemswitch.doc.md +113 -0
  194. package/docs_for_llm/formitemtableconfigs.doc.md +95 -0
  195. package/docs_for_llm/grid.doc.md +78 -5
  196. package/docs_for_llm/header.doc.md +114 -0
  197. package/docs_for_llm/icon.doc.md +12 -8
  198. package/docs_for_llm/icontooltip.doc.md +121 -0
  199. package/docs_for_llm/input.doc.md +199 -41
  200. package/docs_for_llm/instancelist.doc.md +113 -0
  201. package/docs_for_llm/instancenum.doc.md +95 -0
  202. package/docs_for_llm/ipinput.doc.md +77 -0
  203. package/docs_for_llm/kspstatus.doc.md +82 -0
  204. package/docs_for_llm/kvcode.doc.md +76 -0
  205. package/docs_for_llm/layoutcontent.doc.md +54 -17
  206. package/docs_for_llm/layoutlistcontent.doc.md +168 -0
  207. package/docs_for_llm/layoutpermissioncontent.doc.md +93 -0
  208. package/docs_for_llm/layoutstandardlist.doc.md +129 -0
  209. package/docs_for_llm/layouttabs.doc.md +101 -0
  210. package/docs_for_llm/lazymount.doc.md +82 -0
  211. package/docs_for_llm/lazyteleport.doc.md +85 -0
  212. package/docs_for_llm/menu.doc.md +139 -14
  213. package/docs_for_llm/message.doc.md +93 -10
  214. package/docs_for_llm/notification.doc.md +214 -0
  215. package/docs_for_llm/pagination.doc.md +30 -17
  216. package/docs_for_llm/paginationplus.doc.md +31 -10
  217. package/docs_for_llm/password.doc.md +86 -0
  218. package/docs_for_llm/popover.doc.md +24 -55
  219. package/docs_for_llm/progress.doc.md +13 -10
  220. package/docs_for_llm/projects.doc.md +91 -0
  221. package/docs_for_llm/protable.doc.md +98 -15
  222. package/docs_for_llm/queuevisualrange.doc.md +78 -0
  223. package/docs_for_llm/radio.doc.md +23 -8
  224. package/docs_for_llm/rate.doc.md +127 -0
  225. package/docs_for_llm/region.doc.md +25 -13
  226. package/docs_for_llm/scrollselect.doc.md +90 -0
  227. package/docs_for_llm/search.doc.md +120 -0
  228. package/docs_for_llm/searchinput.doc.md +111 -0
  229. package/docs_for_llm/searchitems.doc.md +116 -0
  230. package/docs_for_llm/searchselect.doc.md +126 -0
  231. package/docs_for_llm/select.doc.md +208 -49
  232. package/docs_for_llm/sidebar.doc.md +133 -0
  233. package/docs_for_llm/skeleton.doc.md +152 -0
  234. package/docs_for_llm/slider.doc.md +42 -22
  235. package/docs_for_llm/spin.doc.md +18 -6
  236. package/docs_for_llm/spinner.doc.md +28 -18
  237. package/docs_for_llm/split.doc.md +170 -0
  238. package/docs_for_llm/sshkeys.doc.md +88 -0
  239. package/docs_for_llm/status.doc.md +14 -9
  240. package/docs_for_llm/steps.doc.md +81 -7
  241. package/docs_for_llm/switch.doc.md +32 -16
  242. package/docs_for_llm/table.doc.md +317 -55
  243. package/docs_for_llm/tablecolumnid.doc.md +36 -16
  244. package/docs_for_llm/tabs.doc.md +117 -12
  245. package/docs_for_llm/tag.doc.md +167 -15
  246. package/docs_for_llm/timeline.doc.md +187 -0
  247. package/docs_for_llm/timepicker.doc.md +74 -36
  248. package/docs_for_llm/timerange.doc.md +157 -0
  249. package/docs_for_llm/tip.doc.md +50 -11
  250. package/docs_for_llm/tooltip.doc.md +99 -27
  251. package/docs_for_llm/tour.doc.md +125 -28
  252. package/docs_for_llm/transfer.doc.md +99 -33
  253. package/docs_for_llm/tree.doc.md +129 -24
  254. package/docs_for_llm/treeselect.doc.md +101 -44
  255. package/docs_for_llm/upload.doc.md +63 -32
  256. package/docs_for_llm/useCRUD.doc.md +49 -0
  257. package/docs_for_llm/useCountdown.doc.md +43 -0
  258. package/docs_for_llm/useDetail.doc.md +48 -0
  259. package/docs_for_llm/useDialog.doc.md +46 -0
  260. package/docs_for_llm/useEntity.doc.md +45 -0
  261. package/docs_for_llm/useEventListener.doc.md +44 -0
  262. package/docs_for_llm/useFalseUntilTruthy.doc.md +41 -0
  263. package/docs_for_llm/useGetCopyAuthText.doc.md +35 -0
  264. package/docs_for_llm/useGetUserPermission.doc.md +43 -0
  265. package/docs_for_llm/useGroup.doc.md +48 -0
  266. package/docs_for_llm/useIdEntities.doc.md +48 -0
  267. package/docs_for_llm/useIdEntity.doc.md +103 -0
  268. package/docs_for_llm/useInterval.doc.md +43 -0
  269. package/docs_for_llm/useLayoutStandardList.doc.md +38 -0
  270. package/docs_for_llm/useMessage.doc.md +46 -0
  271. package/docs_for_llm/useModifyCache.doc.md +37 -0
  272. package/docs_for_llm/useOpenDialog.doc.md +41 -0
  273. package/docs_for_llm/usePagination.doc.md +60 -0
  274. package/docs_for_llm/usePersist.doc.md +54 -0
  275. package/docs_for_llm/usePoll.doc.md +41 -0
  276. package/docs_for_llm/useRoutePlus.doc.md +34 -0
  277. package/docs_for_llm/useRouterPlus.doc.md +34 -0
  278. package/docs_for_llm/useSearch.doc.md +68 -0
  279. package/docs_for_llm/useShell.doc.md +43 -0
  280. package/docs_for_llm/useSkip.doc.md +41 -0
  281. package/docs_for_llm/useStorageIdEntity.doc.md +46 -0
  282. package/docs_for_llm/useStore.doc.md +34 -0
  283. package/docs_for_llm/useTable.doc.md +57 -0
  284. package/docs_for_llm/useTableGroup.doc.md +47 -0
  285. package/docs_for_llm/useTableSort.doc.md +40 -0
  286. package/docs_for_llm/useToState.doc.md +112 -0
  287. package/docs_for_llm/useUser.doc.md +38 -0
  288. package/docs_for_llm/useValidForm.doc.md +41 -0
  289. package/docs_for_llm/vdialog.doc.md +154 -0
  290. package/docs_for_llm/vdrawer.doc.md +148 -0
  291. package/docs_for_llm/virtuallist.doc.md +157 -3
  292. package/hooks/useCRUD.json +61 -0
  293. package/hooks/useCountdown.json +49 -0
  294. package/hooks/useDetail.json +67 -0
  295. package/hooks/useDialog.json +49 -0
  296. package/hooks/useEntity.json +61 -0
  297. package/hooks/useEventListener.json +61 -0
  298. package/hooks/useFalseUntilTruthy.json +43 -0
  299. package/hooks/useGetCopyAuthText.json +36 -0
  300. package/hooks/useGetUserPermission.json +55 -0
  301. package/hooks/useGroup.json +49 -0
  302. package/hooks/useIdEntities.json +61 -0
  303. package/hooks/useInterval.json +55 -0
  304. package/hooks/useLayoutStandardList.json +36 -0
  305. package/hooks/useMessage.json +73 -0
  306. package/hooks/useModifyCache.json +36 -0
  307. package/hooks/useOpenDialog.json +43 -0
  308. package/hooks/usePagination.json +49 -0
  309. package/hooks/usePersist.json +61 -0
  310. package/hooks/usePoll.json +43 -0
  311. package/hooks/useRoutePlus.json +36 -0
  312. package/hooks/useRouterPlus.json +36 -0
  313. package/hooks/useSearch.json +56 -0
  314. package/hooks/useShell.json +49 -0
  315. package/hooks/useSkip.json +43 -0
  316. package/hooks/useStorageIdEntity.json +67 -0
  317. package/hooks/useStore.json +36 -0
  318. package/hooks/useTable.json +49 -0
  319. package/hooks/useTableGroup.json +43 -0
  320. package/hooks/useTableSort.json +43 -0
  321. package/hooks/useUser.json +36 -0
  322. package/hooks/useValidForm.json +43 -0
  323. package/package.json +14 -8
  324. package/dist/chunk-D3Y6FGWA.js +0 -153
  325. package/dist/chunk-HPAUCD5I.js +0 -156
  326. package/dist/chunk-L4DS3EXI.mjs +0 -133
  327. package/dist/chunk-NZ6TLWMD.mjs +0 -151
@@ -0,0 +1,111 @@
1
+ # AK/SK 配置 (AKSK)
2
+
3
+ 用于录入 AccessKey / SecretKey 并控制是否沿用原始凭证的业务表单组件,常见于任务同步、数据接入和跨账号授权场景。
4
+
5
+ **关键词**: aksk, access key, secret key, 凭证配置, ak sk, 云服务凭证
6
+
7
+ **使用场景**: 云服务凭证录入、数据集或任务凭证配置、切换原始凭证或自定义凭证
8
+
9
+ ## 导入语句
10
+ ```typescript
11
+ import { AKSK } from '@ksyun-internal/versatile';
12
+ ```
13
+
14
+ ## 属性 (Props)
15
+ | 属性名 | 类型 | 默认值 | 必填 | 说明 | 标签 | 示例 |
16
+ | --- | --- | --- | --- | --- | --- | --- |
17
+ | ak | `string | null` | `undefined` | 否 | 当前 AccessKey | - | - |
18
+ | sk | `string | null` | `undefined` | 否 | 当前 SecretKey | - | - |
19
+ | isUseOriginal | `boolean | null` | `false` | 否 | 是否使用原始 AK/SK | - | - |
20
+ | isShowUseOriginal | `boolean | null` | `false` | 否 | 是否展示“使用原始凭证”选项 | - | - |
21
+ | inDataSet | `boolean | null` | `undefined` | 否 | 是否处于数据集场景 | - | - |
22
+
23
+ ## 事件 (Events)
24
+ | 事件名 | Vue事件名 | 说明 | 回调参数 | 示例 |
25
+ | --- | --- | --- | --- | --- |
26
+ | update:ak | `@update:ak` | AccessKey 变更时触发,便于和父级表单状态保持同步。 | `value?: string | null` | - |
27
+ | update:sk | `@update:sk` | SecretKey 变更时触发,通常用于同步加密存储前的表单值。 | `value?: string | null` | - |
28
+ | update:isUseOriginal | `@update:isUseOriginal` | “使用原始凭证”开关变化时触发,可据此切换输入项显隐。 | `value?: boolean | null` | - |
29
+
30
+ ### 事件参数说明
31
+ **update:ak**
32
+
33
+ | 参数 | 类型 | 必填 | 默认值 | 说明 |
34
+ | --- | --- | --- | --- | --- |
35
+ | value | `string | null` | 否 | - | 当前输入的 AccessKey 值。 |
36
+
37
+ **update:sk**
38
+
39
+ | 参数 | 类型 | 必填 | 默认值 | 说明 |
40
+ | --- | --- | --- | --- | --- |
41
+ | value | `string | null` | 否 | - | 当前输入的 SecretKey 值。 |
42
+
43
+ **update:isUseOriginal**
44
+
45
+ | 参数 | 类型 | 必填 | 默认值 | 说明 |
46
+ | --- | --- | --- | --- | --- |
47
+ | value | `boolean | null` | 否 | - | 当前是否使用原始凭证。 |
48
+
49
+ ## 使用示例
50
+ ### 任务配置中的 AK/SK 凭证录入
51
+ **场景**: 录入任务访问外部对象存储或服务所需的访问凭证。
52
+
53
+ 通过多个 v-model 同步 AccessKey、SecretKey 和原始凭证开关。
54
+
55
+ **使用的 API**: 属性: ak, sk, isUseOriginal, isShowUseOriginal | 事件: update:ak, update:sk, update:isUseOriginal
56
+
57
+ ```vue
58
+ <script setup lang="ts">
59
+ import { ref } from 'vue';
60
+ import { AKSK } from '@ksyun-internal/versatile';
61
+
62
+ const ak = ref('AKLTxxxxxxxx');
63
+ const sk = ref('********');
64
+ const isUseOriginal = ref(false);
65
+ </script>
66
+
67
+ <template>
68
+ <AKSK
69
+ v-model:ak="ak"
70
+ v-model:sk="sk"
71
+ v-model:isUseOriginal="isUseOriginal"
72
+ :is-show-use-original="true"
73
+ />
74
+ </template>
75
+ ```
76
+
77
+ ### 切换是否沿用原始凭证
78
+ **场景**: 在数据同步任务中切换使用系统默认凭证或自定义凭证。
79
+
80
+ 结合 update:isUseOriginal 在不同凭证来源之间切换。
81
+
82
+ **使用的 API**: 属性: ak, sk, isUseOriginal, isShowUseOriginal, inDataSet | 事件: update:isUseOriginal
83
+
84
+ ```vue
85
+ <script setup lang="ts">
86
+ import { ref } from 'vue';
87
+ import { AKSK } from '@ksyun-internal/versatile';
88
+
89
+ const ak = ref('AKLTxxxx');
90
+ const sk = ref('******');
91
+ const isUseOriginal = ref(true);
92
+ const handleToggle = (value: boolean) => {
93
+ console.log('use original credentials:', value);
94
+ };
95
+ </script>
96
+
97
+ <template>
98
+ <AKSK
99
+ v-model:ak="ak"
100
+ v-model:sk="sk"
101
+ v-model:isUseOriginal="isUseOriginal"
102
+ :is-show-use-original="true"
103
+ :in-data-set="true"
104
+ @update:isUseOriginal="handleToggle"
105
+ />
106
+ </template>
107
+ ```
108
+
109
+ ## 相关组件
110
+ FormItemInput
111
+
@@ -0,0 +1,155 @@
1
+ # 锚点导航 (Anchor)
2
+
3
+ 锚点导航组件,用于监听页面滚动位置并高亮当前锚点。支持自定义滚动容器、偏移量、横向或纵向模式,通常与 AnchorLink 配合使用。
4
+
5
+ **关键词**: anchor, 锚点, 目录导航, 滚动定位, AnchorLink
6
+
7
+ **使用场景**: 长页面章节导航、文档目录定位、详情页内容分区跳转
8
+
9
+ ## 导入语句
10
+ ```typescript
11
+ import { Anchor, AnchorLink } from '@king-design/vue';
12
+ ```
13
+
14
+ ## 属性 (Props)
15
+ | 属性名 | 类型 | 默认值 | 必填 | 说明 | 标签 | 示例 |
16
+ | --- | --- | --- | --- | --- | --- | --- |
17
+ | value | `string` | `undefined` | 否 | 当前激活的锚点 href,可用 v-model 双向绑定 | - | `<Anchor v-model="currentLink"></Anchor>` |
18
+ | offset | `number` | `0` | 否 | 滚动定位偏移量,适合页面存在固定头部时使用 | - | `<Anchor :offset="64"></Anchor>` |
19
+ | container | `string | HTMLElement` | `window` | 否 | 监听滚动的容器,可传选择器或 HTMLElement | - | `<Anchor container="#scroll-container"></Anchor>` |
20
+ | threshold | `number` | `0` | 否 | 激活锚点时的阈值范围 | - | `<Anchor :threshold="20"></Anchor>` |
21
+ | vertical | `boolean` | `true` | 否 | 是否使用纵向模式,默认开启;传 false 时为横向模式 | - | `<Anchor :vertical="false"></Anchor>` |
22
+ | size | `Sizes` | `"default"` | 否 | 导航尺寸 | - | `<Anchor size="small"></Anchor>` |
23
+ | duration | `number` | `300` | 否 | 点击锚点后的滚动动画时长,单位 ms | - | `<Anchor :duration="500"></Anchor>` |
24
+
25
+ ## 事件 (Events)
26
+ | 事件名 | Vue事件名 | 说明 | 回调参数 | 示例 |
27
+ | --- | --- | --- | --- | --- |
28
+ | change | `@change` | 当前激活锚点变化时触发 | `href: string` | `<Anchor @change="handleChange"></Anchor>` |
29
+ | click | `@click` | 点击锚点链接时触发 | `e: MouseEvent, link: AnchorLinkProps` | `<Anchor @click="handleClick"></Anchor>` |
30
+
31
+ ### 事件参数说明
32
+ **change**
33
+
34
+ | 参数 | 类型 | 必填 | 默认值 | 说明 |
35
+ | --- | --- | --- | --- | --- |
36
+ | href | `string` | 是 | - | 当前激活锚点 href |
37
+
38
+ 事件处理示例:
39
+ ```typescript
40
+ const handleChange = (href: string) => {
41
+ console.log('当前锚点', href);
42
+ };
43
+ ```
44
+
45
+ **click**
46
+
47
+ | 参数 | 类型 | 必填 | 默认值 | 说明 |
48
+ | --- | --- | --- | --- | --- |
49
+ | e | `MouseEvent` | 是 | - | 原生鼠标事件 |
50
+ | link | `AnchorLinkProps` | 是 | - | 被点击的锚点配置 |
51
+
52
+ 事件处理示例:
53
+ ```typescript
54
+ const handleClick = (e: MouseEvent, link: { href?: string }) => {
55
+ console.log('点击了锚点', link.href);
56
+ };
57
+ ```
58
+
59
+ ## 插槽 (Slots)
60
+ | 插槽名 | 说明 | 模板写法 | 示例 |
61
+ | --- | --- | --- | --- |
62
+ | default | 锚点导航内容,通常放置一个或多个 AnchorLink | `#default` | `<Anchor>
63
+ <AnchorLink href="section1" title="Section 1" />
64
+ </Anchor>` |
65
+
66
+ ### 插槽参数说明
67
+ **default**
68
+
69
+ - 参数结构: 无参数
70
+
71
+ ## 方法 (Methods)
72
+ | 方法名 | 说明 | 参数 | 返回值 |
73
+ | --- | --- | --- | --- |
74
+ | getLinks | 获取当前 Anchor 中注册的所有 href | `-` | `string[]` |
75
+ | getTargetElement | 根据 href 查找对应的目标元素 | `href: string` | `HTMLElement | null` |
76
+
77
+ ### 方法参数说明
78
+ **getTargetElement**
79
+
80
+ | 参数 | 类型 | 必填 | 默认值 | 说明 |
81
+ | --- | --- | --- | --- | --- |
82
+ | href | `string` | 是 | - | 目标锚点 href |
83
+
84
+ 调用示例:
85
+ ```typescript
86
+ anchorRef.value?.getTargetElement('section2');
87
+ ```
88
+
89
+ ### 方法调用示例
90
+ **getLinks**
91
+
92
+ ```typescript
93
+ anchorRef.value?.getLinks();
94
+ ```
95
+
96
+ **getTargetElement**
97
+
98
+ ```typescript
99
+ anchorRef.value?.getTargetElement('section2');
100
+ ```
101
+
102
+ ## 使用示例
103
+ ### 基础用法
104
+ **场景**: 为详情页长内容区域提供目录导航。
105
+
106
+ 在滚动容器旁边展示纵向锚点导航。
107
+
108
+ **使用的 API**: 属性: value, container | 插槽: default
109
+
110
+ ```vue
111
+ <script setup lang="ts">
112
+ import { ref } from 'vue';
113
+ import { Anchor, AnchorLink } from '@king-design/vue';
114
+
115
+ const current = ref('section1');
116
+ </script>
117
+ <template>
118
+ <div style="display: flex; gap: 20px; align-items: flex-start;">
119
+ <div id="scroll-container" style="height: 240px; overflow-y: auto; width: 360px; border: 1px solid #eee; padding: 12px;">
120
+ <section id="section1" style="height: 180px;">第一部分</section>
121
+ <section id="section2" style="height: 180px;">第二部分</section>
122
+ <section id="section3" style="height: 180px;">第三部分</section>
123
+ </div>
124
+ <Anchor v-model="current" container="#scroll-container">
125
+ <AnchorLink href="section1" title="第一部分" />
126
+ <AnchorLink href="section2" title="第二部分" />
127
+ <AnchorLink href="section3" title="第三部分" />
128
+ </Anchor>
129
+ </div>
130
+ </template>
131
+ ```
132
+
133
+ ### 横向锚点
134
+ **场景**: 在页面头部展示横向章节切换导航。
135
+
136
+ 将 Anchor 作为横向导航栏使用。
137
+
138
+ **使用的 API**: 属性: vertical, offset | 插槽: default
139
+
140
+ ```vue
141
+ <script setup lang="ts">
142
+ import { Anchor, AnchorLink } from '@king-design/vue';
143
+ </script>
144
+ <template>
145
+ <Anchor :vertical="false" :offset="64">
146
+ <AnchorLink href="overview" title="概览" />
147
+ <AnchorLink href="spec" title="规格" />
148
+ <AnchorLink href="billing" title="计费" />
149
+ </Anchor>
150
+ </template>
151
+ ```
152
+
153
+ ## 相关组件
154
+ AnchorLink, Affix
155
+
@@ -0,0 +1,75 @@
1
+ # 锚点链接 (AnchorLink)
2
+
3
+ Anchor 的子链接组件,用于声明单个锚点项。支持标题、禁用态以及嵌套层级,通常作为 Anchor 的默认插槽子节点出现。
4
+
5
+ **关键词**: anchorlink, 锚点链接, 目录项, Anchor
6
+
7
+ **使用场景**: Anchor 子导航项、目录树层级导航
8
+
9
+ ## 导入语句
10
+ ```typescript
11
+ import { AnchorLink } from '@king-design/vue';
12
+ ```
13
+
14
+ ## 属性 (Props)
15
+ | 属性名 | 类型 | 默认值 | 必填 | 说明 | 标签 | 示例 |
16
+ | --- | --- | --- | --- | --- | --- | --- |
17
+ | href | `string` | `undefined` | 否 | 目标元素的 id 或锚点标识 | - | `<AnchorLink href="section1" title="第一部分" />` |
18
+ | title | `string | VNode` | `undefined` | 否 | 链接标题内容 | - | `<AnchorLink href="billing" title="计费说明" />` |
19
+ | disabled | `boolean` | `false` | 否 | 是否禁用当前锚点链接 | - | `<AnchorLink href="advanced" title="高级设置" disabled />` |
20
+
21
+ ## 插槽 (Slots)
22
+ | 插槽名 | 说明 | 模板写法 | 示例 |
23
+ | --- | --- | --- | --- |
24
+ | default | 自定义链接内容;未设置 title 时可直接通过默认插槽传入文字或节点 | `#default` | `<AnchorLink href="section2">第二部分</AnchorLink>` |
25
+
26
+ ### 插槽参数说明
27
+ **default**
28
+
29
+ - 参数结构: 无参数
30
+
31
+ ## 使用示例
32
+ ### 基础链接
33
+ **场景**: 为章节导航添加单个可点击锚点项。
34
+
35
+ 在 Anchor 中声明单个锚点链接。
36
+
37
+ **使用的 API**: 属性: href, title | 插槽: default
38
+
39
+ ```vue
40
+ <script setup lang="ts">
41
+ import { Anchor, AnchorLink } from '@king-design/vue';
42
+ </script>
43
+ <template>
44
+ <Anchor>
45
+ <AnchorLink href="section1" title="第一部分" />
46
+ <AnchorLink href="section2">第二部分</AnchorLink>
47
+ </Anchor>
48
+ </template>
49
+ ```
50
+
51
+ ### 嵌套链接
52
+ **场景**: 构建多级目录结构的页面导航。
53
+
54
+ 在纵向 Anchor 中构建层级导航。
55
+
56
+ **使用的 API**: 属性: href, title | 插槽: default
57
+
58
+ ```vue
59
+ <script setup lang="ts">
60
+ import { Anchor, AnchorLink } from '@king-design/vue';
61
+ </script>
62
+ <template>
63
+ <Anchor>
64
+ <AnchorLink href="overview" title="概览">
65
+ <AnchorLink href="overview-base" title="基础信息" />
66
+ <AnchorLink href="overview-network" title="网络配置" />
67
+ </AnchorLink>
68
+ <AnchorLink href="billing" title="计费" />
69
+ </Anchor>
70
+ </template>
71
+ ```
72
+
73
+ ## 相关组件
74
+ Anchor
75
+
@@ -2,9 +2,9 @@
2
2
 
3
3
  可用区(Availability Zone)选择组件。
4
4
 
5
- **关键词**: az, zone, 可用区, 机房
5
+ **关键词**: az, zone, 可用区, 机房, availability zone, az select, 可用区选择
6
6
 
7
- **使用场景**: 购买页选择可用区
7
+ **使用场景**: 购买页选择可用区、与地域联动切换机房、资源部署位置选择、高可用架构中选择目标可用区
8
8
 
9
9
  ## 导入语句
10
10
  ```typescript
@@ -12,21 +12,27 @@ import { AZ } from '@ksyun-internal/versatile';
12
12
  ```
13
13
 
14
14
  ## 属性 (Props)
15
- | 属性名 | 类型 | 默认值 | 必填 | 说明 | 示例 |
16
- | --- | --- | --- | --- | --- | --- |
17
- | modelValue | `string` | `undefined` | 否 | 选中的可用区编码 | `<AZ v-model="azCode" />` |
18
- | regionCode | `string` | `undefined` | 否 | 所属地域编码 | `<AZ regionCode="cn-beijing-6" />` |
19
- | packages | `AZ[]` | `undefined` | 否 | 可用区配置列表(通常从Region组件联动获取,或通过API获取) | `<AZ :packages="packages" />` |
20
- | showLearnMore | `boolean` | `true` | 否 | 是否显示了解更多 | - |
21
- | learnMoreUrl | `number` | `undefined` | 否 | 了解更多链接ID | - |
15
+ | 属性名 | 类型 | 默认值 | 必填 | 说明 | 标签 | 示例 |
16
+ | --- | --- | --- | --- | --- | --- | --- |
17
+ | modelValue | `string` | `undefined` | 否 | 选中的可用区编码 | - | `<AZ v-model="azCode" />` |
18
+ | regionCode | `string` | `undefined` | 否 | 所属地域编码 | - | `<AZ regionCode="cn-beijing-6" />` |
19
+ | packages | `AZ[]` | `undefined` | 否 | 可用区配置列表(通常从Region组件联动获取,或通过API获取) | - | `<AZ :packages="packages" />` |
20
+ | showLearnMore | `boolean` | `true` | 否 | 是否显示了解更多 | - | - |
21
+ | learnMoreUrl | `number` | `undefined` | 否 | 了解更多链接ID | - | - |
22
22
 
23
23
  ## 事件 (Events)
24
24
  | 事件名 | Vue事件名 | 说明 | 回调参数 | 示例 |
25
25
  | --- | --- | --- | --- | --- |
26
26
  | change | `update:modelValue` | 可用区改变时触发 | `value: string` | `<AZ @update:modelValue="v => console.log(v)" /></AZ>` |
27
27
 
28
- ### 事件处理函数示例
29
- **change**:
28
+ ### 事件参数说明
29
+ **change**
30
+
31
+ | 参数 | 类型 | 必填 | 默认值 | 说明 |
32
+ | --- | --- | --- | --- | --- |
33
+ | value | `string` | 是 | - | 新的AZCode |
34
+
35
+ 事件处理示例:
30
36
  ```typescript
31
37
  (val) => { console.log(val); }
32
38
  ```
@@ -12,18 +12,24 @@ import { Badge } from '@king-design/vue';
12
12
  ```
13
13
 
14
14
  ## 属性 (Props)
15
- | 属性名 | 类型 | 默认值 | 必填 | 说明 | 示例 |
16
- | --- | --- | --- | --- | --- | --- |
17
- | text | `string | number` | `undefined` | 否 | 显示的文本内容或数字。如果不传,则显示为一个小红点。 | `<Badge :text="10"></Badge>` |
18
- | max | `number` | `undefined` | 否 | 显示的最大数值,超过最大值会显示为 max+。仅在 text 为 numeric 时生效。 | `<Badge :text="100" :max="99"></Badge>` |
19
- | disabled | `boolean` | `false` | 否 | 是否隐藏徽标 | `<Badge disabled></Badge>` |
15
+ | 属性名 | 类型 | 默认值 | 必填 | 说明 | 标签 | 示例 |
16
+ | --- | --- | --- | --- | --- | --- | --- |
17
+ | text | `string | number` | `undefined` | 否 | 显示的文本内容或数字。如果不传,则显示为一个小红点。 | - | `<Badge :text="10"></Badge>` |
18
+ | max | `number` | `undefined` | 否 | 显示的最大数值,超过最大值会显示为 max+。仅在 text 为 numeric 时生效。 | - | `<Badge :text="100" :max="99"></Badge>` |
19
+ | disabled | `boolean` | `false` | 否 | 是否隐藏徽标 | - | `<Badge disabled></Badge>` |
20
20
 
21
21
  ## 插槽 (Slots)
22
22
  | 插槽名 | 说明 | 模板写法 | 示例 |
23
23
  | --- | --- | --- | --- |
24
24
  | default | 徽标包裹的元素 | `#default` | `<Badge><Button>Button</Button></Badge>` |
25
25
 
26
+ ### 插槽参数说明
27
+ **default**
28
+
29
+ - 参数结构: 无参数
30
+
26
31
  ## 常见错误与正确用法 (Anti-Hallucination)
32
+ ### 数字作为字符串传入
27
33
  > **错误用法**: `<Badge text="10" :max="9">`
28
34
  > **正确写法**: `<Badge :text="10" :max="9">`
29
35
  > **说明**: 如果 text 传入的是字符串 "10",max 属性可能无法正确比较。建议数字类型使用 v-bind 传入。
@@ -2,9 +2,9 @@
2
2
 
3
3
  计费类型选择组件,支持按量付费、包年包月等多种计费模式展示与选择。
4
4
 
5
- **关键词**: bill, price, charge, 计费, 价格
5
+ **关键词**: bill, price, charge, 计费, 价格, 计费模式, 按量付费, 包年包月
6
6
 
7
- **使用场景**: 购买页选择计费模式
7
+ **使用场景**: 购买页选择计费模式、切换按量和包年包月、试用与正式计费方式选择
8
8
 
9
9
  ## 导入语句
10
10
  ```typescript
@@ -12,21 +12,27 @@ import { BillTypes } from '@ksyun-internal/versatile';
12
12
  ```
13
13
 
14
14
  ## 属性 (Props)
15
- | 属性名 | 类型 | 默认值 | 必填 | 说明 | 示例 |
16
- | --- | --- | --- | --- | --- | --- |
17
- | modelValue | `number` | `undefined` | 否 | 选中的计费类型ID | `<BillTypes v-model="billType" />` |
18
- | packages | `BillType[]` | `undefined` | 否 | 计费类型配置列表 | `<BillTypes :packages="packages" />` |
19
- | showTrial | `boolean` | `false` | 否 | 是否显示试用选项 | `<BillTypes showTrial />` |
20
- | showLearnMore | `boolean` | `true` | 否 | 是否显示了解更多链接 | `<BillTypes showLearnMore />` |
21
- | learnMoreUrl | `number` | `undefined` | 否 | 了解更多链接的帮助文档ID | `<BillTypes :learnMoreUrl="123" />` |
15
+ | 属性名 | 类型 | 默认值 | 必填 | 说明 | 标签 | 示例 |
16
+ | --- | --- | --- | --- | --- | --- | --- |
17
+ | modelValue | `number` | `undefined` | 否 | 选中的计费类型ID | - | `<BillTypes v-model="billType" />` |
18
+ | packages | `BillType[]` | `undefined` | 否 | 计费类型配置列表 | - | `<BillTypes :packages="packages" />` |
19
+ | showTrial | `boolean` | `false` | 否 | 是否显示试用选项 | - | `<BillTypes showTrial />` |
20
+ | showLearnMore | `boolean` | `true` | 否 | 是否显示了解更多链接 | - | `<BillTypes showLearnMore />` |
21
+ | learnMoreUrl | `number` | `undefined` | 否 | 了解更多链接的帮助文档ID | - | `<BillTypes :learnMoreUrl="123" />` |
22
22
 
23
23
  ## 事件 (Events)
24
24
  | 事件名 | Vue事件名 | 说明 | 回调参数 | 示例 |
25
25
  | --- | --- | --- | --- | --- |
26
26
  | change | `update:modelValue` | 选中值改变时触发 | `value: number` | `<BillTypes @update:modelValue="v => console.log(v)" /></BillTypes>` |
27
27
 
28
- ### 事件处理函数示例
29
- **change**:
28
+ ### 事件参数说明
29
+ **change**
30
+
31
+ | 参数 | 类型 | 必填 | 默认值 | 说明 |
32
+ | --- | --- | --- | --- | --- |
33
+ | value | `number` | 是 | - | 新的计费类型ID |
34
+
35
+ 事件处理示例:
30
36
  ```typescript
31
37
  (val) => { console.log(val); }
32
38
  ```
@@ -12,24 +12,98 @@ import { Breadcrumb, BreadcrumbItem } from '@king-design/vue';
12
12
  ```
13
13
 
14
14
  ## 属性 (Props)
15
- | 属性名 | 类型 | 默认值 | 必填 | 说明 | 示例 |
16
- | --- | --- | --- | --- | --- | --- |
17
- | separator | `string` | `undefined` | 否 | 指定分隔符 | `<Breadcrumb separator=">"></Breadcrumb>` |
15
+ | 属性名 | 类型 | 默认值 | 必填 | 说明 | 标签 | 示例 |
16
+ | --- | --- | --- | --- | --- | --- | --- |
17
+ | separator | `string` | `undefined` | 否 | 指定分隔符 | - | `<Breadcrumb separator=">"></Breadcrumb>` |
18
18
 
19
19
  ## 插槽 (Slots)
20
20
  | 插槽名 | 说明 | 模板写法 | 示例 |
21
21
  | --- | --- | --- | --- |
22
- | separator | 指定分隔符 | `undefined` | - |
22
+ | separator | 指定分隔符 | `#separator` | `<Breadcrumb>
23
+ <template #separator>
24
+ 自定义separator内容
25
+ </template>
26
+ </Breadcrumb>` |
27
+
28
+ ### 插槽参数说明
29
+ **separator**
30
+
31
+ - 参数结构: 无参数
23
32
 
24
33
  ## 子组件 (Sub-Components)
25
34
  ### BreadcrumbItem
26
35
  面包屑项组件,用于定义导航路径中的每一项
27
36
 
37
+ #### 属性 (Props)
28
38
  | 属性名 | 类型 | 说明 | 示例 |
29
39
  | --- | --- | --- | --- |
30
40
  | to | `string | object` | 指定超链接地址,支持字符串路径或 Vue Router 路由对象 | `<BreadcrumbItem to="/products">产品中心</BreadcrumbItem>` |
31
41
 
42
+ #### 组合示例
43
+ ##### 带链接的面包屑
44
+ **场景**: 创建可点击跳转的面包屑导航
45
+
46
+ 点击可跳转的面包屑项
47
+
48
+ **命中的子组件 API**: 属性: to
49
+
50
+ ```vue
51
+ <script setup lang="ts">
52
+ import { Breadcrumb, BreadcrumbItem } from '@king-design/vue';
53
+ </script>
54
+ <template>
55
+ <Breadcrumb>
56
+ <BreadcrumbItem to="/">首页</BreadcrumbItem>
57
+ <BreadcrumbItem to="/products">产品中心</BreadcrumbItem>
58
+ <BreadcrumbItem>当前页面</BreadcrumbItem>
59
+ </Breadcrumb>
60
+ </template>
61
+ ```
62
+
63
+ ##### 配合 Vue Router
64
+ **场景**: 配合 Vue Router 使用路由对象导航
65
+
66
+ 使用路由对象进行导航
67
+
68
+ **命中的子组件 API**: 属性: to
69
+
70
+ ```vue
71
+ <script setup lang="ts">
72
+ import { Breadcrumb, BreadcrumbItem } from '@king-design/vue';
73
+ </script>
74
+ <template>
75
+ <Breadcrumb>
76
+ <BreadcrumbItem :to="{name: 'home'}">首页</BreadcrumbItem>
77
+ <BreadcrumbItem :to="{path: '/products'}">产品中心</BreadcrumbItem>
78
+ <BreadcrumbItem :to="{path: '/products/1', query: {id: 1}}">产品详情</BreadcrumbItem>
79
+ </Breadcrumb>
80
+ </template>
81
+ ```
82
+
83
+ ##### 带图标的首页
84
+ **场景**: 使用图标表示首页
85
+
86
+ 首页项使用图标代替文字
87
+
88
+ **命中的子组件 API**: 属性: to
89
+
90
+ ```vue
91
+ <script setup lang="ts">
92
+ import { Breadcrumb, BreadcrumbItem, Icon } from '@king-design/vue';
93
+ </script>
94
+ <template>
95
+ <Breadcrumb>
96
+ <BreadcrumbItem to="/">
97
+ <Icon class="k-icon-home" />
98
+ </BreadcrumbItem>
99
+ <BreadcrumbItem to="/products">产品中心</BreadcrumbItem>
100
+ <BreadcrumbItem>产品详情</BreadcrumbItem>
101
+ </Breadcrumb>
102
+ </template>
103
+ ```
104
+
32
105
  ## 常见错误与正确用法 (Anti-Hallucination)
106
+ ### 最后一项不应该有链接
33
107
  > **错误用法**: `<Breadcrumb>
34
108
  <BreadcrumbItem to="/">首页</BreadcrumbItem>
35
109
  <BreadcrumbItem to="/current">当前页面</BreadcrumbItem>
@@ -40,6 +114,7 @@ import { Breadcrumb, BreadcrumbItem } from '@king-design/vue';
40
114
  </Breadcrumb>`
41
115
  > **说明**: 面包屑最后一项表示当前页面,不应该设置链接
42
116
 
117
+ ### 直接使用 Breadcrumb 未包含 BreadcrumbItem
43
118
  > **错误用法**: `<Breadcrumb>
44
119
  <span>首页</span>
45
120
  <span>产品</span>
@@ -50,6 +125,7 @@ import { Breadcrumb, BreadcrumbItem } from '@king-design/vue';
50
125
  </Breadcrumb>`
51
126
  > **说明**: Breadcrumb 组件必须配合 BreadcrumbItem 子组件使用
52
127
 
128
+ ### 路由对象未使用绑定语法
53
129
  > **错误用法**: `<BreadcrumbItem to="{path: '/home'}">首页</BreadcrumbItem>`
54
130
  > **正确写法**: `<BreadcrumbItem :to="{path: '/home'}">首页</BreadcrumbItem>`
55
131
  > **说明**: 传入对象类型时需要使用 v-bind (:to) 语法