kui-vue 4.0.0 → 4.0.2

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 (549) hide show
  1. package/LICENSE +1 -1
  2. package/README.md +5 -5
  3. package/components/affix/demo/basic.md +5 -1
  4. package/components/affix/demo/bottom.md +4 -0
  5. package/components/affix/demo/callbacks.md +4 -0
  6. package/components/affix/demo/container.md +4 -0
  7. package/components/affix/demo/index.jsx +17 -4
  8. package/components/affix/demo/info.en_US.md +10 -0
  9. package/components/affix/index.en_US.md +8 -0
  10. package/components/alert/demo/basic.md +4 -0
  11. package/components/alert/demo/close.md +4 -0
  12. package/components/alert/demo/customIcon.md +4 -0
  13. package/components/alert/demo/icon.md +4 -0
  14. package/components/alert/demo/index.jsx +16 -3
  15. package/components/alert/demo/info.en_US.md +10 -0
  16. package/components/alert/index.en_US.md +11 -0
  17. package/components/anchor/anchor-link.jsx +45 -0
  18. package/components/anchor/anchor.jsx +137 -0
  19. package/components/anchor/demo/basic.md +38 -0
  20. package/components/anchor/demo/index.jsx +31 -0
  21. package/components/anchor/demo/info.en_US.md +5 -0
  22. package/components/anchor/demo/info.md +5 -0
  23. package/components/anchor/demo/nestedAnchors.md +39 -0
  24. package/components/anchor/demo/withinContainer.md +32 -0
  25. package/components/anchor/index.en_US.md +17 -0
  26. package/components/anchor/index.js +3 -0
  27. package/components/anchor/index.md +17 -0
  28. package/components/anchor/styles/index.less +54 -0
  29. package/components/avatar/AvatarGroup.jsx +11 -1
  30. package/components/avatar/avatar.jsx +20 -5
  31. package/components/avatar/demo/badgeGroup.md +37 -0
  32. package/components/avatar/demo/basic.md +4 -0
  33. package/components/avatar/demo/change.md +4 -0
  34. package/components/avatar/demo/index.jsx +18 -3
  35. package/components/avatar/demo/info.en_US.md +5 -0
  36. package/components/avatar/demo/types.md +4 -0
  37. package/components/avatar/index.en_US.md +8 -0
  38. package/components/avatar/index.js +2 -1
  39. package/components/avatar/styles/index.less +19 -1
  40. package/components/backtop/demo/basic.md +6 -2
  41. package/components/backtop/demo/custom.md +6 -2
  42. package/components/backtop/demo/index.jsx +17 -4
  43. package/components/backtop/demo/info.en_US.md +10 -0
  44. package/components/backtop/index.en_US.md +9 -0
  45. package/components/badge/demo/basic.md +4 -0
  46. package/components/badge/demo/color.md +4 -0
  47. package/components/badge/demo/dot.md +5 -1
  48. package/components/badge/demo/dynamic.md +5 -1
  49. package/components/badge/demo/index.jsx +16 -3
  50. package/components/badge/demo/info.en_US.md +9 -0
  51. package/components/badge/demo/mark.md +5 -0
  52. package/components/badge/demo/max.md +4 -0
  53. package/components/badge/demo/status.md +4 -0
  54. package/components/badge/index.en_US.md +8 -0
  55. package/components/breadcrumb/demo/basic.md +5 -1
  56. package/components/breadcrumb/demo/icon.md +4 -0
  57. package/components/breadcrumb/demo/index.jsx +16 -3
  58. package/components/breadcrumb/demo/info.en_US.md +11 -0
  59. package/components/breadcrumb/demo/separator.md +4 -0
  60. package/components/breadcrumb/index.en_US.md +8 -0
  61. package/components/button/button.jsx +1 -1
  62. package/components/button/demo/basic.md +4 -0
  63. package/components/button/demo/block.md +4 -0
  64. package/components/button/demo/color.md +4 -0
  65. package/components/button/demo/disabled.md +4 -0
  66. package/components/button/demo/group.md +5 -1
  67. package/components/button/demo/index.jsx +17 -4
  68. package/components/button/demo/info.en_US.md +16 -0
  69. package/components/button/demo/light.md +4 -0
  70. package/components/button/demo/loading.md +5 -1
  71. package/components/button/demo/outline.md +4 -0
  72. package/components/button/demo/size.md +4 -0
  73. package/components/button/demo/{with-icon.md → withIcon.md} +7 -3
  74. package/components/button/index.en_US.md +14 -0
  75. package/components/button/styles/index.less +1 -0
  76. package/components/card/demo/basic.md +6 -2
  77. package/components/card/demo/border.md +6 -2
  78. package/components/card/demo/index.jsx +16 -3
  79. package/components/card/demo/info.en_US.md +9 -0
  80. package/components/card/demo/notitle.md +3 -0
  81. package/components/card/index.en_US.md +8 -0
  82. package/components/carousel/carousel.jsx +55 -11
  83. package/components/carousel/demo/autoplay.md +4 -0
  84. package/components/carousel/demo/basic.md +5 -4
  85. package/components/carousel/demo/index.jsx +16 -3
  86. package/components/carousel/demo/info.en_US.md +11 -0
  87. package/components/carousel/demo/vertical.md +4 -0
  88. package/components/carousel/index.en_US.md +9 -0
  89. package/components/checkbox/demo/basic.md +3 -3
  90. package/components/checkbox/demo/{check-all.md → checkAll.md} +2 -2
  91. package/components/checkbox/demo/disabled.md +2 -2
  92. package/components/checkbox/demo/group.md +2 -2
  93. package/components/checkbox/demo/{group-layout.md → groupLayout.md} +6 -2
  94. package/components/checkbox/demo/index.jsx +18 -5
  95. package/components/checkbox/demo/info.en_US.md +10 -0
  96. package/components/checkbox/demo/info.md +5 -8
  97. package/components/checkbox/index.en_US.md +20 -0
  98. package/components/collapse/demo/accordion.md +4 -0
  99. package/components/collapse/demo/basic.md +4 -0
  100. package/components/collapse/demo/extra.md +4 -0
  101. package/components/collapse/demo/index.jsx +16 -3
  102. package/components/collapse/demo/info.en_US.md +10 -0
  103. package/components/collapse/demo/nesting.md +4 -0
  104. package/components/collapse/demo/sample.md +4 -0
  105. package/components/collapse/index.en_US.md +16 -0
  106. package/components/colorPicker/demo/basic.md +4 -0
  107. package/components/colorPicker/demo/customTrigger.md +4 -0
  108. package/components/colorPicker/demo/index.jsx +16 -3
  109. package/components/colorPicker/demo/info.en_US.md +9 -0
  110. package/components/colorPicker/demo/placement.md +4 -0
  111. package/components/colorPicker/demo/size.md +4 -0
  112. package/components/colorPicker/index.en_US.md +9 -0
  113. package/components/colorPicker/paint.jsx +1 -1
  114. package/components/components.js +9 -3
  115. package/components/datePicker/demo/basic.md +5 -1
  116. package/components/datePicker/demo/disabled.md +4 -0
  117. package/components/datePicker/demo/{disabled-date.md → disabledDate.md} +4 -0
  118. package/components/datePicker/demo/index.jsx +17 -4
  119. package/components/datePicker/demo/info.en_US.md +9 -0
  120. package/components/datePicker/demo/lang.md +4 -0
  121. package/components/datePicker/demo/presets.md +4 -0
  122. package/components/datePicker/demo/range.md +4 -0
  123. package/components/datePicker/demo/size.md +5 -1
  124. package/components/datePicker/demo/theme.md +6 -2
  125. package/components/datePicker/demo/valueType.md +4 -0
  126. package/components/datePicker/index.en_US.md +20 -0
  127. package/components/descriptions/demo/basic.md +8 -8
  128. package/components/descriptions/demo/bordered.md +17 -17
  129. package/components/descriptions/demo/index.jsx +20 -7
  130. package/components/descriptions/demo/info.en_US.md +9 -0
  131. package/components/descriptions/demo/size.md +21 -21
  132. package/components/descriptions/demo/vertical.md +20 -0
  133. package/components/descriptions/demo/verticalBordered.md +32 -0
  134. package/components/descriptions/index.en_US.md +16 -0
  135. package/components/divider/demo/basic.md +4 -0
  136. package/components/divider/demo/default.md +9 -5
  137. package/components/divider/demo/index.jsx +17 -4
  138. package/components/divider/demo/info.en_US.md +10 -0
  139. package/components/divider/demo/withText.md +22 -0
  140. package/components/divider/index.en_US.md +8 -0
  141. package/components/divider/index.md +6 -6
  142. package/components/drawer/demo/basic.md +7 -3
  143. package/components/drawer/demo/custom.md +4 -0
  144. package/components/drawer/demo/index.jsx +16 -3
  145. package/components/drawer/demo/info.en_US.md +11 -0
  146. package/components/drawer/demo/target.md +5 -1
  147. package/components/drawer/demo/withForm.md +24 -20
  148. package/components/drawer/drawer.jsx +1 -3
  149. package/components/drawer/index.en_US.md +18 -0
  150. package/components/dropdown/demo/arrow.md +4 -0
  151. package/components/dropdown/demo/basic.md +5 -1
  152. package/components/dropdown/demo/cascading.md +5 -1
  153. package/components/dropdown/demo/divider.md +4 -0
  154. package/components/dropdown/demo/dropdownbutton.md +4 -0
  155. package/components/dropdown/demo/index.jsx +18 -5
  156. package/components/dropdown/demo/info.en_US.md +9 -0
  157. package/components/dropdown/demo/placement.md +4 -0
  158. package/components/dropdown/demo/rightmenu.md +4 -0
  159. package/components/dropdown/index.en_US.md +7 -0
  160. package/components/empty/demo/basic.md +4 -0
  161. package/components/empty/demo/custom.md +9 -5
  162. package/components/empty/demo/index.jsx +16 -3
  163. package/components/empty/demo/info.en_US.md +10 -0
  164. package/components/empty/demo/nodesc.md +4 -0
  165. package/components/empty/demo/used.md +4 -0
  166. package/components/empty/index.en_US.md +7 -0
  167. package/components/flex/demo/align.md +4 -0
  168. package/components/flex/demo/basic.md +4 -0
  169. package/components/flex/demo/index.jsx +16 -3
  170. package/components/flex/demo/info.en_US.md +13 -0
  171. package/components/flex/demo/size.md +4 -0
  172. package/components/flex/demo/wrap.md +4 -0
  173. package/components/flex/index.en_US.md +9 -0
  174. package/components/form/demo/align.md +4 -0
  175. package/components/form/demo/basic.md +6 -2
  176. package/components/form/demo/customvalid.md +17 -13
  177. package/components/form/demo/dynamicvalid.md +19 -7
  178. package/components/form/demo/index.jsx +16 -3
  179. package/components/form/demo/info.en_US.md +40 -0
  180. package/components/form/demo/length.md +54 -40
  181. package/components/form/demo/valid.md +55 -47
  182. package/components/form/demo/withmodal.md +13 -9
  183. package/components/form/formitem.jsx +1 -1
  184. package/components/form/index.en_US.md +36 -0
  185. package/components/grid/demo/alignWhiteSpace.md +25 -0
  186. package/components/grid/demo/architecture.md +159 -0
  187. package/components/grid/demo/autoFillMinWidth.md +32 -0
  188. package/components/grid/demo/basic.md +24 -19
  189. package/components/grid/demo/bento.md +161 -0
  190. package/components/grid/demo/breakpointFallback.md +29 -0
  191. package/components/grid/demo/fixedRowsAreas.md +56 -0
  192. package/components/grid/demo/footerStrategy.md +39 -0
  193. package/components/grid/demo/heroSection.md +38 -0
  194. package/components/grid/demo/index.jsx +36 -14
  195. package/components/grid/demo/info.en_US.md +30 -0
  196. package/components/grid/demo/info.md +25 -9
  197. package/components/grid/demo/suffixDisplayNone.md +28 -0
  198. package/components/grid/grid.jsx +73 -0
  199. package/components/grid/gridItem.jsx +55 -0
  200. package/components/grid/index.en_US.md +33 -0
  201. package/components/grid/index.js +3 -3
  202. package/components/grid/index.md +30 -13
  203. package/components/grid/styles/index.less +6 -67
  204. package/components/grid/useBreakpoint.js +46 -0
  205. package/components/icon/demo/basic.md +4 -0
  206. package/components/icon/demo/index.jsx +22 -5
  207. package/components/icon/demo/info.en_US.md +11 -0
  208. package/components/icon/demo/search.vue +18 -15
  209. package/components/icon/demo/stroke.md +4 -0
  210. package/components/icon/demo/use.en_US.md +28 -0
  211. package/components/icon/index.en_US.md +9 -0
  212. package/components/image/demo/basic.md +5 -1
  213. package/components/image/demo/errors.md +4 -0
  214. package/components/image/demo/extra.md +4 -0
  215. package/components/image/demo/group.md +4 -0
  216. package/components/image/demo/index.jsx +16 -3
  217. package/components/image/demo/info.en_US.md +10 -0
  218. package/components/image/index.en_US.md +22 -0
  219. package/components/input/demo/basic.md +10 -6
  220. package/components/input/demo/event.md +6 -2
  221. package/components/input/demo/group.md +7 -3
  222. package/components/input/demo/icon.md +5 -1
  223. package/components/input/demo/index.jsx +16 -3
  224. package/components/input/demo/info.en_US.md +10 -0
  225. package/components/input/demo/size.md +5 -1
  226. package/components/input/demo/suffix.md +19 -15
  227. package/components/input/demo/textarea.md +8 -4
  228. package/components/input/demo/theme.md +10 -11
  229. package/components/input/index.en_US.md +22 -0
  230. package/components/input/styles/index.less +3 -0
  231. package/components/inputNumber/demo/basic.md +4 -0
  232. package/components/inputNumber/demo/ffix.md +9 -5
  233. package/components/inputNumber/demo/format.md +10 -6
  234. package/components/inputNumber/demo/index.jsx +16 -3
  235. package/components/inputNumber/demo/info.en_US.md +9 -0
  236. package/components/inputNumber/demo/size.md +4 -0
  237. package/components/inputNumber/index.en_US.md +18 -0
  238. package/components/layout/demo/basic.md +11 -7
  239. package/components/layout/demo/documentationLayout.md +123 -0
  240. package/components/layout/demo/enterpriseAdminConsole.md +161 -0
  241. package/components/layout/demo/index.jsx +23 -14
  242. package/components/layout/demo/info.en_US.md +13 -0
  243. package/components/layout/demo/lowCodeLayout.md +148 -0
  244. package/components/layout/demo/messagingCollaboration.md +116 -0
  245. package/components/layout/demo/portalExhibition.md +129 -0
  246. package/components/layout/demo/workbenchLayout.md +142 -0
  247. package/components/layout/index.en_US.md +0 -0
  248. package/components/loading/demo/basic.md +4 -0
  249. package/components/loading/demo/index.jsx +16 -3
  250. package/components/loading/demo/info.en_US.md +71 -0
  251. package/components/loading/index.en_US.md +9 -0
  252. package/components/menu/demo/accordion.md +4 -0
  253. package/components/menu/demo/basic.md +9 -1
  254. package/components/menu/demo/collapsed.md +4 -0
  255. package/components/menu/demo/index.jsx +16 -3
  256. package/components/menu/demo/info.en_US.md +9 -0
  257. package/components/menu/demo/inline.md +4 -0
  258. package/components/menu/demo/mode.md +4 -0
  259. package/components/menu/demo/theme.md +4 -0
  260. package/components/menu/demo/vertical.md +4 -0
  261. package/components/menu/index.en_US.md +50 -0
  262. package/components/menu/menu.jsx +1 -1
  263. package/components/menu/styles/index.less +13 -6
  264. package/components/message/demo/basic.md +4 -0
  265. package/components/message/demo/close.md +10 -13
  266. package/components/message/demo/icon.md +6 -2
  267. package/components/message/demo/index.jsx +16 -3
  268. package/components/message/demo/info.en_US.md +10 -0
  269. package/components/message/demo/types.md +7 -3
  270. package/components/message/index.en_US.md +25 -0
  271. package/components/modal/demo/basic.md +9 -13
  272. package/components/modal/demo/confirm.md +15 -11
  273. package/components/modal/demo/custom.md +9 -5
  274. package/components/modal/demo/global.md +14 -10
  275. package/components/modal/demo/index.jsx +16 -3
  276. package/components/modal/demo/info.en_US.md +10 -0
  277. package/components/modal/demo/more.md +4 -0
  278. package/components/modal/index.en_US.md +45 -0
  279. package/components/notice/demo/basic.md +8 -4
  280. package/components/notice/demo/close.md +12 -17
  281. package/components/notice/demo/icon.md +15 -7
  282. package/components/notice/demo/index.jsx +16 -3
  283. package/components/notice/demo/info.en_US.md +13 -0
  284. package/components/notice/demo/types.md +10 -6
  285. package/components/notice/index.en_US.md +24 -0
  286. package/components/page/demo/basic.md +4 -0
  287. package/components/page/demo/index.jsx +17 -4
  288. package/components/page/demo/info.en_US.md +10 -0
  289. package/components/page/demo/size.md +4 -0
  290. package/components/page/demo/{sizer-elevator.md → sizerElevator.md} +4 -0
  291. package/components/page/index.en_US.md +14 -0
  292. package/components/popconfirm/demo/basic.md +5 -1
  293. package/components/popconfirm/demo/index.jsx +16 -3
  294. package/components/popconfirm/demo/info.en_US.md +11 -0
  295. package/components/popconfirm/demo/local.md +6 -2
  296. package/components/popconfirm/demo/placement.md +4 -0
  297. package/components/popconfirm/index.en_US.md +11 -0
  298. package/components/popconfirm/popconfirm.jsx +5 -5
  299. package/components/poptip/demo/basic.md +9 -6
  300. package/components/poptip/demo/closeinside.md +4 -0
  301. package/components/poptip/demo/index.jsx +16 -3
  302. package/components/poptip/demo/info.en_US.md +11 -0
  303. package/components/poptip/demo/placement.md +6 -2
  304. package/components/poptip/demo/trigger.md +13 -9
  305. package/components/poptip/index.en_US.md +10 -0
  306. package/components/poptip/poptip.jsx +5 -5
  307. package/components/progress/demo/basic.md +4 -0
  308. package/components/progress/demo/circle.md +5 -1
  309. package/components/progress/demo/color.md +9 -5
  310. package/components/progress/demo/dashboard.md +4 -0
  311. package/components/progress/demo/dynamic.md +1 -1
  312. package/components/progress/demo/index.jsx +16 -3
  313. package/components/progress/demo/info.en_US.md +12 -0
  314. package/components/progress/demo/size.md +4 -0
  315. package/components/progress/index.en_US.md +16 -0
  316. package/components/radio/demo/basic.md +4 -0
  317. package/components/radio/demo/disabled.md +4 -0
  318. package/components/radio/demo/group.md +4 -0
  319. package/components/radio/demo/index.jsx +17 -4
  320. package/components/radio/demo/info.en_US.md +10 -0
  321. package/components/radio/demo/radioButton.md +9 -5
  322. package/components/radio/demo/{group-layout.md → vertical.md} +6 -2
  323. package/components/radio/index.en_US.md +22 -0
  324. package/components/rate/demo/basic.md +4 -0
  325. package/components/rate/demo/character.md +4 -0
  326. package/components/rate/demo/index.jsx +16 -3
  327. package/components/rate/demo/info.en_US.md +10 -0
  328. package/components/rate/demo/tips.md +4 -0
  329. package/components/rate/index.en_US.md +13 -0
  330. package/components/{grid → rowCol}/demo/align.md +1 -1
  331. package/components/rowCol/demo/basic.md +30 -0
  332. package/components/{grid → rowCol}/demo/fill.md +1 -1
  333. package/components/{grid → rowCol}/demo/flex.md +2 -1
  334. package/components/{grid → rowCol}/demo/gutter.md +2 -2
  335. package/components/rowCol/demo/index.jsx +37 -0
  336. package/components/rowCol/demo/info.en_US.md +14 -0
  337. package/components/rowCol/demo/info.md +14 -0
  338. package/components/{grid → rowCol}/demo/offset.md +2 -2
  339. package/components/rowCol/index.en_US.md +16 -0
  340. package/components/rowCol/index.js +4 -0
  341. package/components/rowCol/index.md +16 -0
  342. package/components/rowCol/styles/index.less +70 -0
  343. package/components/select/demo/basic.md +4 -0
  344. package/components/select/demo/disabled.md +4 -0
  345. package/components/select/demo/filterable.md +13 -8
  346. package/components/select/demo/index.jsx +16 -3
  347. package/components/select/demo/info.en_US.md +10 -0
  348. package/components/select/demo/multiple.md +4 -0
  349. package/components/select/demo/size.md +4 -0
  350. package/components/select/demo/theme.md +10 -6
  351. package/components/select/index.en_US.md +33 -0
  352. package/components/select/option.jsx +1 -1
  353. package/components/select/select.jsx +1 -2
  354. package/components/select/styles/index.less +10 -12
  355. package/components/skeleton/demo/animated.md +1 -1
  356. package/components/skeleton/demo/basic.md +2 -2
  357. package/components/skeleton/demo/child.md +5 -5
  358. package/components/skeleton/demo/custom.md +8 -4
  359. package/components/skeleton/demo/group.md +2 -2
  360. package/components/skeleton/demo/index.jsx +16 -3
  361. package/components/skeleton/demo/info.en_US.md +12 -0
  362. package/components/skeleton/demo/items.md +2 -2
  363. package/components/skeleton/demo/list.md +5 -5
  364. package/components/skeleton/index.en_US.md +49 -0
  365. package/components/slider/demo/basic.md +7 -0
  366. package/components/slider/demo/formatter.md +5 -0
  367. package/components/slider/demo/index.jsx +16 -3
  368. package/components/slider/demo/info.en_US.md +9 -0
  369. package/components/slider/demo/marks.md +4 -0
  370. package/components/slider/demo/reverse.md +4 -0
  371. package/components/slider/demo/size.md +4 -0
  372. package/components/slider/demo/vertical.md +5 -1
  373. package/components/slider/demo/withNumber.md +2 -2
  374. package/components/slider/index.en_US.md +16 -0
  375. package/components/slider/slider.jsx +95 -40
  376. package/components/slider/styles/index.less +38 -25
  377. package/components/slider/thumb.jsx +9 -4
  378. package/components/space/demo/align.md +4 -0
  379. package/components/space/demo/basic.md +1 -1
  380. package/components/space/demo/compact.md +5 -5
  381. package/components/space/demo/{compact-button.md → compactButton.md} +1 -1
  382. package/components/space/demo/{compact-button-vertical.md → compactVertical.md} +1 -1
  383. package/components/space/demo/{custom-size.md → customSize.md} +4 -0
  384. package/components/space/demo/index.jsx +19 -6
  385. package/components/space/demo/info.en_US.md +12 -0
  386. package/components/space/demo/size.md +2 -1
  387. package/components/space/demo/split.md +2 -2
  388. package/components/space/demo/wrap.md +2 -2
  389. package/components/space/index.en_US.md +11 -0
  390. package/components/spin/demo/basic.md +4 -0
  391. package/components/spin/demo/container.md +6 -2
  392. package/components/spin/demo/index.jsx +16 -3
  393. package/components/spin/demo/info.en_US.md +9 -0
  394. package/components/spin/demo/mode.md +6 -2
  395. package/components/spin/index.en_US.md +8 -0
  396. package/components/statCard/demo/basic.md +3 -0
  397. package/components/statCard/demo/card.md +50 -13
  398. package/components/statCard/demo/index.jsx +17 -4
  399. package/components/statCard/demo/info.en_US.md +9 -0
  400. package/components/statCard/demo/{with-card.md → withCard.md} +5 -2
  401. package/components/statCard/index.en_US.md +34 -0
  402. package/components/statCard/index.md +8 -7
  403. package/components/statCard/statCard.jsx +6 -2
  404. package/components/statCard/statNumber.jsx +9 -5
  405. package/components/statCard/styles/index.less +6 -3
  406. package/components/styles/index.less +3 -1
  407. package/components/styles/less-css-var.less +3 -0
  408. package/components/styles/less-var.less +3 -0
  409. package/components/styles/sys.less +1 -0
  410. package/components/switch/demo/basic.md +4 -0
  411. package/components/switch/demo/disabled.md +4 -0
  412. package/components/switch/demo/index.jsx +16 -3
  413. package/components/switch/demo/info.en_US.md +10 -0
  414. package/components/switch/demo/loading.md +4 -0
  415. package/components/switch/demo/size.md +4 -0
  416. package/components/switch/demo/withText.md +4 -0
  417. package/components/switch/index.en_US.md +12 -0
  418. package/components/table/demo/{base-render.md → baseRender.md} +19 -14
  419. package/components/table/demo/basic.md +3 -3
  420. package/components/table/demo/bordered.md +2 -2
  421. package/components/table/demo/{col-row-span.md → colRowSpan.md} +13 -8
  422. package/components/table/demo/{custom-header.md → customHeader.md} +7 -3
  423. package/components/table/demo/{fixed-col-head.md → fixedColHeader.md} +2 -3
  424. package/components/table/demo/{head-span.md → headerSpan.md} +2 -2
  425. package/components/table/demo/index.jsx +24 -11
  426. package/components/table/demo/info.en_US.md +48 -0
  427. package/components/table/demo/info.md +3 -3
  428. package/components/table/demo/size.md +3 -3
  429. package/components/table/demo/{table-check.md → tableCheck.md} +5 -5
  430. package/components/table/demo/{table-edit.md → tableEdit.md} +5 -5
  431. package/components/table/demo/{table-sorter.md → tableSorter.md} +2 -2
  432. package/components/table/index.en_US.md +28 -0
  433. package/components/table/index.md +14 -14
  434. package/components/tabs/demo/card.md +1 -1
  435. package/components/tabs/demo/closable.md +5 -0
  436. package/components/tabs/demo/disabled.md +1 -1
  437. package/components/tabs/demo/extra.md +2 -2
  438. package/components/tabs/demo/icon.md +1 -1
  439. package/components/tabs/demo/index.jsx +16 -3
  440. package/components/tabs/demo/info.en_US.md +12 -0
  441. package/components/tabs/demo/info.md +6 -11
  442. package/components/tabs/demo/sample.md +2 -2
  443. package/components/tabs/index.en_US.md +21 -0
  444. package/components/tag/demo/basic.md +1 -1
  445. package/components/tag/demo/color.md +2 -2
  446. package/components/tag/demo/dynamic.md +2 -2
  447. package/components/tag/demo/icon.md +7 -7
  448. package/components/tag/demo/index.jsx +16 -3
  449. package/components/tag/demo/info.en_US.md +10 -0
  450. package/components/tag/demo/size.md +4 -4
  451. package/components/tag/index.en_US.md +9 -0
  452. package/components/timeline/demo/basic.md +4 -4
  453. package/components/timeline/demo/icon.md +10 -10
  454. package/components/timeline/demo/index.jsx +16 -3
  455. package/components/timeline/demo/info.en_US.md +12 -0
  456. package/components/timeline/demo/mode.md +10 -10
  457. package/components/timeline/index.en_US.md +9 -0
  458. package/components/tooltip/demo/basic.md +6 -6
  459. package/components/tooltip/demo/color.md +3 -3
  460. package/components/tooltip/demo/index.jsx +16 -3
  461. package/components/tooltip/demo/info.en_US.md +11 -0
  462. package/components/tooltip/demo/placement.md +3 -3
  463. package/components/tooltip/index.en_US.md +8 -0
  464. package/components/tooltip/tooltip.jsx +15 -4
  465. package/components/tree/demo/basic.md +3 -3
  466. package/components/tree/demo/checkable.md +2 -2
  467. package/components/tree/demo/{custom-render.md → customRender.md} +3 -3
  468. package/components/tree/demo/directory.md +3 -4
  469. package/components/tree/demo/disabled.md +2 -2
  470. package/components/tree/demo/icon.md +3 -3
  471. package/components/tree/demo/index.jsx +17 -4
  472. package/components/tree/demo/info.en_US.md +7 -0
  473. package/components/tree/demo/info.md +3 -8
  474. package/components/tree/demo/sync.md +4 -5
  475. package/components/tree/index.en_US.md +41 -0
  476. package/components/tree/tree.jsx +1 -1
  477. package/components/{treeSelect → treeselect}/demo/basic.md +2 -2
  478. package/components/{treeSelect → treeselect}/demo/checkable.md +2 -2
  479. package/components/{treeSelect → treeselect}/demo/disabled.md +2 -2
  480. package/components/{treeSelect → treeselect}/demo/index.jsx +16 -3
  481. package/components/treeselect/demo/info.en_US.md +9 -0
  482. package/components/{treeSelect → treeselect}/demo/multiple.md +3 -3
  483. package/components/{treeSelect → treeselect}/demo/size.md +2 -2
  484. package/components/{treeSelect → treeselect}/demo/sync.md +4 -5
  485. package/components/treeselect/demo/theme.md +44 -0
  486. package/components/treeselect/index.en_US.md +36 -0
  487. package/components/{treeSelect → treeselect}/styles/index.less +11 -13
  488. package/components/upload/demo/accept.md +6 -6
  489. package/components/upload/demo/avatar.md +3 -3
  490. package/components/upload/demo/basic.md +1 -1
  491. package/components/upload/demo/custom.md +6 -6
  492. package/components/upload/demo/directory.md +2 -2
  493. package/components/upload/demo/draggable.md +4 -4
  494. package/components/upload/demo/exceed.md +6 -6
  495. package/components/upload/demo/{file-list.md → fileList.md} +3 -3
  496. package/components/upload/demo/forms.md +13 -13
  497. package/components/upload/demo/index.jsx +17 -4
  498. package/components/upload/demo/info.en_US.md +11 -0
  499. package/components/upload/demo/pictures.md +3 -3
  500. package/components/upload/demo/transform.md +4 -4
  501. package/components/upload/index.en_US.md +35 -0
  502. package/components/utils/color.js +7 -4
  503. package/dist/k-ui.cjs.js +2 -2
  504. package/dist/k-ui.css +2 -2
  505. package/dist/k-ui.d.ts +115 -45
  506. package/dist/k-ui.esm.js +2 -2
  507. package/dist/k-ui.umd.js +2 -2
  508. package/dist/locale/de.js +1 -1
  509. package/dist/locale/el.js +1 -1
  510. package/dist/locale/en.js +1 -1
  511. package/dist/locale/fr.js +1 -1
  512. package/dist/locale/it.js +1 -1
  513. package/dist/locale/ja.js +1 -1
  514. package/dist/locale/ko.js +1 -1
  515. package/dist/locale/ru.js +1 -1
  516. package/dist/locale/th.js +1 -1
  517. package/dist/locale/ua.js +7 -0
  518. package/dist/locale/uk.js +1 -1
  519. package/dist/locale/vi.js +1 -1
  520. package/dist/locale/zh-CN.js +1 -1
  521. package/dist/locale/zh-TW.js +1 -1
  522. package/package.json +10 -9
  523. package/test/i18n@6.x.html +3 -3
  524. package/types/anchor/Anchor.d.ts +17 -0
  525. package/types/anchor/AnchorLink.d.ts +12 -0
  526. package/types/avatar/AvatarGroup.d.ts +13 -0
  527. package/types/grid/Grid.d.ts +24 -0
  528. package/types/grid/GridItem.d.ts +18 -0
  529. package/types/index.d.ts +20 -10
  530. package/types/statCard/StatCard.d.ts +1 -0
  531. package/components/descriptions/demo/layout-bordered.md +0 -32
  532. package/components/descriptions/demo/layout.md +0 -20
  533. package/components/divider/demo/with-text.md +0 -18
  534. package/components/layout/demo/layout1.md +0 -114
  535. package/components/layout/demo/layout2.md +0 -152
  536. package/components/layout/demo/layout3.md +0 -141
  537. package/components/layout/demo/layout4.md +0 -148
  538. package/components/layout/demo/layout5.md +0 -139
  539. package/components/styles/color.less +0 -209
  540. package/components/treeSelect/demo/theme.md +0 -38
  541. /package/components/{grid → rowCol}/col.jsx +0 -0
  542. /package/components/{grid → rowCol}/row.jsx +0 -0
  543. /package/components/{treeSelect → treeselect}/demo/info.md +0 -0
  544. /package/components/{treeSelect → treeselect}/index.js +0 -0
  545. /package/components/{treeSelect → treeselect}/index.md +0 -0
  546. /package/components/{treeSelect → treeselect}/treeselect.jsx +0 -0
  547. /package/types/{grid → rowCol}/Col.d.ts +0 -0
  548. /package/types/{grid → rowCol}/Row.d.ts +0 -0
  549. /package/types/{treeSelect → treeselect}/TreeSelect.d.ts +0 -0
@@ -0,0 +1,159 @@
1
+ <cn>
2
+ ### 布局层级设计 (Architecture)
3
+ - 第一层:Layout 系列 —— 页面大骨架(Header + Sider + Content)。
4
+
5
+ - 第二层:Grid 系列 —— 内容区的主要 2D 布局(统计卡片、Bento 图表矩阵)。
6
+
7
+ - 第三层:Row/Col —— 简单的 1D 比例划分(如底部的两个并排表格)。
8
+
9
+ - 第四层:Flex —— 极细微的内容对齐(卡片标题 + 图标)。
10
+ </cn>
11
+
12
+ <en>
13
+ ### Layout Hierarchy Design (Architecture)
14
+ - Layer 1: Layout series — the main page skeleton (Header + Sider + Content).
15
+
16
+ - Layer 2: Grid series — the primary 2D layout for the content area (stat cards, Bento chart matrix).
17
+
18
+ - Layer 3: Row/Col — simple 1D proportional division (e.g., two side-by-side tables at the bottom).
19
+
20
+ - Layer 4: Flex — extremely fine-grained content alignment (card title + icon).
21
+ </en>
22
+
23
+ ```vue
24
+ <template>
25
+ <Layout>
26
+ <Sider class="k-sider">Sider Menu</Sider>
27
+
28
+ <Content class="k-layout-content">
29
+ <Layout>
30
+ <Header class="k-header">
31
+ <div
32
+ :style="{
33
+ display: 'flex',
34
+ alignItems: 'center',
35
+ justifyContent: 'space-between',
36
+ width: '100%',
37
+ }"
38
+ >
39
+ <span>控制台 / 实时监控</span>
40
+ <div :style="{ display: 'flex', gap: '12px' }">
41
+ <Button>刷新数据</Button>
42
+ <Button class="primary">导出报告</Button>
43
+ </div>
44
+ </div>
45
+ </Header>
46
+
47
+ <Content class="k-main-body">
48
+ <h2 class="section-title">核心指标 (Grid 布局)</h2>
49
+ <Grid
50
+ :cols="{ xs: 2, md: 4, xl: 6 }"
51
+ :x-gap="16"
52
+ :y-gap="16"
53
+ auto-rows="140px"
54
+ :style="{ gridAutoFlow: 'dense', marginBottom: '32px' }"
55
+ >
56
+ <GridItem :span="{ xs: 2, md: 4, xl: 4 }" :row-span="3">
57
+ <div class="chart-card main-chart">实时流量趋势 (大块)</div>
58
+ </GridItem>
59
+
60
+ <GridItem v-for="i in 4" :key="i" :span="{ xs: 1, md: 2, xl: 2 }" :row-span="1">
61
+ <StatCard :title="`📈 指标 ${i}`" :items="[{ value: 1234 + i }]"> </StatCard>
62
+ </GridItem>
63
+
64
+ <GridItem :span="{ xs: 2, md: 2, xl: 2 }" :row-span="2">
65
+ <Card title="动态更新" />
66
+ <div class="chart-card secondary">动态更新</div>
67
+ </GridItem>
68
+ </Grid>
69
+
70
+ <h2 class="section-title">详细列表 (Row/Col 布局)</h2>
71
+ <Row :gutter="16">
72
+ <Col :span="16">
73
+ <div class="table-placeholder">主要数据表格 (占 2/3)</div>
74
+ </Col>
75
+ <Col :span="8">
76
+ <div class="table-placeholder">辅助操作面板 (占 1/3)</div>
77
+ </Col>
78
+ </Row>
79
+ </Content>
80
+
81
+ <Footer class="k-footer">©2026 Grid Layout Pro</Footer>
82
+ </Layout>
83
+ </Content>
84
+ </Layout>
85
+ </template>
86
+
87
+ <script setup>
88
+ // 这里引入你之前写的 Grid 和 GridItem
89
+ </script>
90
+
91
+ <style scoped>
92
+ .k-layout {
93
+ height: 100vh;
94
+ background: var(--kui-color-bg-container);
95
+ }
96
+ .k-sider {
97
+ width: 200px;
98
+ background: var(--kui-color-bg-layout);
99
+ padding: 20px;
100
+ }
101
+ .k-layout-content {
102
+ overflow-y: auto;
103
+ }
104
+ .k-header {
105
+ height: 64px;
106
+ background: var(--kui-color-bg-1);
107
+ display: flex;
108
+ align-items: center;
109
+ padding: 10px 24px;
110
+ box-shadow: 0 1px 4px rgba(0, 0, 0, 0.08);
111
+ }
112
+ .k-main-body {
113
+ padding: 24px;
114
+ flex: 1;
115
+ }
116
+ .k-footer {
117
+ text-align: center;
118
+ padding: 24px;
119
+ color: var(--kui-color-text-description);
120
+ }
121
+
122
+ .section-title {
123
+ font-size: 18px;
124
+ margin-bottom: 16px;
125
+ font-weight: 600;
126
+ }
127
+
128
+ /* 卡片样式 */
129
+ .k-stat-card,
130
+ .k-card {
131
+ height: 100%;
132
+ }
133
+ .chart-card,
134
+ .table-placeholder {
135
+ background: var(--kui-color-bg-component);
136
+ height: 100%;
137
+ box-shadow: 0 2px 8px rgba(0, 0, 0, 0.04);
138
+ box-sizing: border-box;
139
+ }
140
+ .main-chart {
141
+ border-radius: 8px;
142
+ padding: 20px;
143
+ background: var(--kui-color-bg-component);
144
+ border: 1px dashed var(--kui-color-primary);
145
+ }
146
+
147
+ .card-value {
148
+ font-size: 24px;
149
+ font-weight: bold;
150
+ margin-top: 12px;
151
+ }
152
+ .table-placeholder {
153
+ border-radius: 8px;
154
+ padding: 20px;
155
+ min-height: 300px;
156
+ border: 1px solid var(--kui-color-border);
157
+ }
158
+ </style>
159
+ ```
@@ -0,0 +1,32 @@
1
+ <cn>
2
+ ### 仪表盘卡片布局 (Auto-fill + Min-Width)
3
+ 无需手动设置断点,依靠 `itemMinWidth` 让容器根据宽度自动增减列数。
4
+
5
+ > 当设置了 `itemMinWidth` 时,cols` 参数将失效。这是一种内容驱动的布局方式,非常适合图片画廊或卡片列表,它能保证在容器缩放时,卡片始终保持合适的宽度而不会过于拥挤。
6
+ > </cn>
7
+ > <en>
8
+
9
+ ### Dashboard Card Layout (Auto-fill + Min-Width)
10
+
11
+ No need to manually set breakpoints. Rely on `itemMinWidth` to let the container automatically increase or decrease the number of columns based on its width.
12
+
13
+ > When `itemMinWidth` is set, the `cols` parameter becomes ineffective. This is a content-driven layout method, perfect for image galleries or card lists, ensuring cards maintain a suitable width without becoming too crowded during container resizing.
14
+ > </en>
15
+
16
+ ```vue
17
+ <template>
18
+ <Grid :itemMinWidth="256" :xGap="16" :yGap="16">
19
+ <GridItem v-for="(x, i) in data" :key="i" class="box"> Card {{ i + 1 }} (Minimum 256px) </GridItem>
20
+ </Grid>
21
+ </template>
22
+ <script setup>
23
+ import { ref } from "vue";
24
+ const data = ref(Array.from({ length: 7 }));
25
+ </script>
26
+ <style lang="less" scoped>
27
+ .box {
28
+ background: var(--kui-color-bg-3);
29
+ height: 64px;
30
+ }
31
+ </style>
32
+ ```
@@ -1,30 +1,35 @@
1
1
  <cn>
2
2
  ### 基本用法
3
- `col` 必须放在 `row` 里面
3
+
4
+ > Grid 的 `offset` 逻辑是基于 `grid-column-start` 的偏移。在 `dense` 填充模式下,`offset` 可能会导致意想不到的“插空”行为。
5
+
4
6
  </cn>
5
7
  <en>
6
8
  ### Basic Usage
7
- Columns must be placed inside a Row.
9
+
10
+ > The `offset` logic of Grid is based on `grid-column-start`. In `dense` fill mode, `offset` might cause unexpected "gap-filling" behavior.
11
+
8
12
  </en>
9
13
 
10
14
  ```vue
11
15
  <template>
12
- <Space block vertical>
13
- <Row>
14
- <Col :span="12">col-12</Col>
15
- <Col :span="12">col-12</Col>
16
- </Row>
17
- <Row>
18
- <Col :span="8">col-8</Col>
19
- <Col :span="8">col-8</Col>
20
- <Col :span="8">col-8</Col>
21
- </Row>
22
- <Row>
23
- <Col :span="6">col-6</Col>
24
- <Col :span="6">col-6</Col>
25
- <Col :span="6">col-6</Col>
26
- <Col :span="6">col-6</Col>
27
- </Row>
28
- </Space>
16
+ <Grid :cols="{ xs: 1, md: 2, lg: 4 }" :xGap="16" :yGap="16">
17
+ <GridItem :span="2">
18
+ <div class="box">Occupies 2 columns</div>
19
+ </GridItem>
20
+ <GridItem :offset="1">
21
+ <div class="box">Offset by 1 column</div>
22
+ </GridItem>
23
+ <GridItem suffix>
24
+ <div class="box">Always at the end</div>
25
+ </GridItem>
26
+ </Grid>
29
27
  </template>
28
+ <style lang="less">
29
+ .box {
30
+ padding: 8px;
31
+ font-size: 12px;
32
+ background: var(--kui-color-bg-3);
33
+ }
34
+ </style>
30
35
  ```
@@ -0,0 +1,161 @@
1
+ <cn>
2
+ ### 图片画廊 / 瀑布流(Bento Grid 风格)
3
+ 非对称布局
4
+ </cn>
5
+ <en>
6
+ ### Image Gallery / Masonry (Bento Grid Style)
7
+ Asymmetric layout.
8
+ </en>
9
+
10
+ ```vue
11
+ Code snippet
12
+ <template>
13
+ <div class="demo-container">
14
+ <h1 class="demo-title">技术规格矩阵</h1>
15
+
16
+ <Grid
17
+ :cols="{ xs: 2, md: 6, xl: 8 }"
18
+ :x-gap="20"
19
+ :y-gap="20"
20
+ auto-rows="120px"
21
+ :style="{ gridAutoFlow: 'dense' }"
22
+ >
23
+ <GridItem v-for="item in features" :key="item.id" :span="item.span" :row-span="item.rowSpan">
24
+ <div
25
+ class="bento-card"
26
+ :style="{
27
+ backgroundColor: item.color,
28
+ color: item.textColor || '#333',
29
+ border: item.border || 'none',
30
+ }"
31
+ >
32
+ <div class="card-content">
33
+ <h3 class="card-title">{{ item.title }}</h3>
34
+ <p class="card-desc">{{ item.desc }}</p>
35
+ </div>
36
+ </div>
37
+ </GridItem>
38
+
39
+ <GridItem suffix :span="{ xs: 2, md: 3, xl: 2 }">
40
+ <div class="bento-cta">
41
+ <span>了解更多参数 →</span>
42
+ </div>
43
+ </GridItem>
44
+ </Grid>
45
+ </div>
46
+ </template>
47
+
48
+ <script setup>
49
+ const features = [
50
+ {
51
+ id: 1,
52
+ title: "自研芯片 M3 Max",
53
+ desc: "极致算力,从容应对专业级工作流。",
54
+ span: { xs: 2, md: 3, xl: 4 }, // 桌面占一半宽
55
+ rowSpan: 3, // 高度占 3 个单位
56
+ color: "var(--kui-color-bg-4)",
57
+ textColor: "#fff",
58
+ },
59
+ {
60
+ id: 2,
61
+ title: "超长续航",
62
+ desc: "长达 22 小时视频播放。",
63
+ span: { xs: 1, md: 3, xl: 2 },
64
+ rowSpan: 2,
65
+ color: "#f5f5f7",
66
+ },
67
+ {
68
+ id: 3,
69
+ title: "5G 超高速",
70
+ desc: "随时随地,畅享疾速。",
71
+ span: { xs: 1, md: 3, xl: 2 },
72
+ rowSpan: 1,
73
+ color: "#e8e8ed",
74
+ },
75
+ {
76
+ id: 4,
77
+ title: "Retina 显示屏",
78
+ desc: "绚丽色彩,纤毫毕现。",
79
+ span: { xs: 2, md: 3, xl: 4 },
80
+ rowSpan: 2,
81
+ color: "#fff",
82
+ border: "1px solid var(--kui-color-border)",
83
+ },
84
+ {
85
+ id: 5,
86
+ title: "隐私保护",
87
+ desc: "你的数据,由你掌控。",
88
+ span: { xs: 1, md: 3, xl: 2 },
89
+ rowSpan: 2,
90
+ color: "#f2f2f2",
91
+ },
92
+ {
93
+ id: 6,
94
+ title: "多设备协作",
95
+ desc: "无缝衔接,效率翻倍。",
96
+ span: { xs: 1, md: 3, xl: 2 },
97
+ rowSpan: 1,
98
+ color: "#fafafa",
99
+ },
100
+ ];
101
+ </script>
102
+
103
+ <style scoped>
104
+ .demo-container {
105
+ padding: 40px 20px;
106
+ max-width: 100%;
107
+ margin: 0 auto;
108
+ }
109
+
110
+ .demo-title {
111
+ margin-bottom: 32px;
112
+ font-weight: 600;
113
+ font-size: 2rem;
114
+ color: var(--kui-color-text);
115
+ }
116
+
117
+ .bento-card {
118
+ height: 100%;
119
+ border-radius: 24px;
120
+ padding: 32px;
121
+ box-sizing: border-box;
122
+ display: flex;
123
+ flex-direction: column;
124
+ justify-content: flex-end;
125
+ transition: transform 0.2s ease-in-out;
126
+ cursor: pointer;
127
+ }
128
+
129
+ .bento-card:hover {
130
+ transform: scale(0.99);
131
+ }
132
+
133
+ .card-title {
134
+ font-size: 1.5rem;
135
+ margin: 0 0 8px 0;
136
+ font-weight: 600;
137
+ }
138
+
139
+ .card-desc {
140
+ font-size: 1rem;
141
+ opacity: 0.7;
142
+ margin: 0;
143
+ line-height: 1.4;
144
+ }
145
+
146
+ .bento-cta {
147
+ background: var(--kui-color-primary);
148
+ color: #fff;
149
+ border-radius: 24px;
150
+ height: 100%;
151
+ display: flex;
152
+ align-items: center;
153
+ justify-content: center;
154
+ font-size: 1.1rem;
155
+ font-weight: 500;
156
+ padding: 32px;
157
+ box-sizing: border-box;
158
+ cursor: pointer;
159
+ }
160
+ </style>
161
+ ```
@@ -0,0 +1,29 @@
1
+ <cn>
2
+ ### 复杂表单响应式 (Breakpoint Fallback)
3
+ 断点的向上/向下寻找逻辑。例如:定义了 md 没定义 lg,系统是否能正确应用 md 的值。
4
+ </cn>
5
+ <en>
6
+ ### Complex Form Responsiveness (Breakpoint Fallback)
7
+ The logic for finding breakpoints up or down. For example, if `md` is defined but `lg` is not, can the system correctly apply the `md` value?
8
+ </en>
9
+
10
+ ```vue
11
+ <template>
12
+ <Grid :cols="{ xs: 1, md: 4, xl: 6 }" :xGap="20" :yGap="20">
13
+ <!-- 手机占满, 平板占2格, 电脑占1格 -->
14
+ <GridItem :span="{ xs: 1, md: 2, xl: 1 }">
15
+ <Input placeholder="Project name" />
16
+ </GridItem>
17
+
18
+ <!-- 测试:未定义 lg,应回退到 md 的 2 格 -->
19
+ <GridItem :span="{ xs: 1, md: 2 }">
20
+ <Input placeholder="Person in charge" />
21
+ </GridItem>
22
+
23
+ <!-- Offset 测试:在桌面端留空一格 -->
24
+ <GridItem :span="{ md: 2 }" :offset="{ md: 1 }">
25
+ <Input placeholder="Remark" />
26
+ </GridItem>
27
+ </Grid>
28
+ </template>
29
+ ```
@@ -0,0 +1,56 @@
1
+ <cn>
2
+ ### 圣杯布局/管理后台 (Fixed Rows & Areas)
3
+ `rows` 和 `rowSpan` 的垂直控制力。</cn>
4
+ <en>
5
+ ### Holy Grail Layout / Admin Panel (Fixed Rows & Areas)
6
+ The vertical control power of `rows` and `rowSpan`.
7
+ </en>
8
+
9
+ ```vue
10
+ <template>
11
+ <Grid :cols="4" rows="auto 1fr auto" class="demo-fixed-rows-areas">
12
+ <!-- Header -->
13
+ <GridItem :span="4" class="demo-grid-header"> Header (100% Width) </GridItem>
14
+
15
+ <!-- Sidebar: 跨 1 行 -->
16
+ <GridItem :span="1" row:span="1" class="demo-grid-sidebar"> Menu </GridItem>
17
+
18
+ <!-- Main: 占 3 列 -->
19
+ <GridItem :span="3" class="demo-grid-main"> Main Content (Auto Height) </GridItem>
20
+
21
+ <!-- Footer: 强制置底 -->
22
+ <GridItem :span="4" class="demo-grid-footer"> Footer </GridItem>
23
+ </Grid>
24
+ </template>
25
+ <style lang="less" scoped>
26
+ .demo-fixed-rows-areas {
27
+ height: 500px;
28
+ border: 1px solid var(--kui-color-border);
29
+ border-radius: 12px;
30
+ overflow: hidden;
31
+ .k-grid-item {
32
+ display: flex;
33
+ align-items: center;
34
+ justify-content: center;
35
+ }
36
+ .demo-grid-header {
37
+ height: 50px;
38
+ background: var(--kui-color-bg-3);
39
+ padding: 8px;
40
+ }
41
+ .demo-grid-sidebar {
42
+ padding: 8px;
43
+ background: var(--kui-color-bg-4);
44
+ }
45
+ .demo-grid-main {
46
+ padding: 8px;
47
+ background: var(--kui-color-bg-2);
48
+ }
49
+ .demo-grid-footer {
50
+ background: var(--kui-color-bg-3);
51
+ padding: 8px;
52
+ height: 50px;
53
+ }
54
+ }
55
+ </style>
56
+ ```
@@ -0,0 +1,39 @@
1
+ <cn>
2
+ ### 响应式底栏 / 菜单(Footer Strategy)
3
+ 从“多列垂直排列”到“单列折叠”的极致压缩。
4
+ </cn>
5
+ <en>
6
+ ### Responsive Footer / Menu (Footer Strategy)
7
+ Extreme compression from "multi-column vertical arrangement" to "single-column folding".
8
+ </en>
9
+
10
+ ```vue
11
+ <template>
12
+ <Grid :cols="{ xs: 1, sm: 2, md: 5 }" :yGap="30">
13
+ <GridItem :span="{ xs: 1, md: 2 }">
14
+ <h3>公司品牌 Logo</h3>
15
+ <p>致力于提供全球领先的 Grid 解决方案。</p>
16
+ </GridItem>
17
+
18
+ <!-- 下面三个在 md 以上各占 1 列,在 sm 占 1/2,在 xs 占满 -->
19
+ <GridItem>
20
+ <h4>产品</h4>
21
+ <ul>
22
+ <li>功能 1</li>
23
+ <li>功能 2</li>
24
+ </ul>
25
+ </GridItem>
26
+ <GridItem>
27
+ <h4>支持</h4>
28
+ <ul>
29
+ <li>文档</li>
30
+ <li>社区</li>
31
+ </ul>
32
+ </GridItem>
33
+ <GridItem>
34
+ <h4>联系我们</h4>
35
+ <div class="social-icons">...</div>
36
+ </GridItem>
37
+ </Grid>
38
+ </template>
39
+ ```
@@ -0,0 +1,38 @@
1
+ <cn>
2
+ ### Hero Section 叠加布局(Layering)
3
+ `grid-column-start` 和 `grid-row-start` 的重叠能力,文字浮动在图片某处
4
+ </cn>
5
+ <en>
6
+ ### Hero Section Overlay Layout (Layering)
7
+ The overlapping capability of `grid-column-start` and `grid-row-start`, with text floating over a specific part of an image.
8
+ </en>
9
+
10
+ ```vue
11
+ <template>
12
+ <Grid :cols="12" :rows="8" :style="{ height: '400px', background: 'var(--kui-color-bg-5)' }">
13
+ <!-- 背景图片:占据全部格子 -->
14
+ <GridItem :span="12" :rowSpan="8" :style="{ gridColumnStart: 1, gridRowStart: 1 }">
15
+ <img
16
+ src="https://cdn.chuchur.com/upload/2017/kui-for-vue.jpg"
17
+ :style="{ width: '100%', height: '100%', objectFit: 'cover' }"
18
+ />
19
+ </GridItem>
20
+
21
+ <!-- 文字内容:浮动在图片正中心,占据中间 6 列和中间 4 行 -->
22
+ <GridItem
23
+ :span="{ xs: 10, md: 6 }"
24
+ :rowSpan="4"
25
+ :style="{
26
+ gridColumnStart: 'calc(50% - 3)',
27
+ gridRowStart: 3,
28
+ background: 'var(--kui-color-bg-3)',
29
+ zIndex: 1,
30
+ padding: '20px',
31
+ }"
32
+ >
33
+ <h1>商用级广告语</h1>
34
+ <p>Grid 布局让叠加效果变得简单,无需大量 absolute 定位。</p>
35
+ </GridItem>
36
+ </Grid>
37
+ </template>
38
+ ```
@@ -1,23 +1,45 @@
1
- import Info from "./info.md";
1
+ import InfoCn from "./info.md";
2
+ import InfoEn from "./info.en_US.md";
2
3
  import Basic from "./basic.md";
3
- import Gutter from "./gutter.md";
4
- import Offset from "./offset.md";
5
- import Align from "./align.md";
6
- import Flex from "./flex.md";
7
- import Fill from "./fill.md";
4
+ import AutoFillMinWidth from "./autoFillMinWidth.md";
5
+ import BreakpointFallback from "./breakpointFallback.md";
6
+ import FixedRowsAreas from "./fixedRowsAreas.md";
7
+ import SuffixDisplayDone from "./suffixDisplayNone.md";
8
+ import Bento from "./bento.md";
9
+ import AlignWhiteSpace from "./alignWhiteSpace.md";
10
+ import HeroSection from "./heroSection.md";
11
+ import FooterStrategy from "./footerStrategy.md";
12
+ import Architecture from "./architecture.md";
13
+
8
14
  import CN from "../index.md";
15
+ import EN from "../index.en_US.md";
16
+ import { computed, inject } from "vue";
9
17
  export default {
18
+ setup() {
19
+ const locale = inject("locale");
20
+ const API = computed(() => {
21
+ return locale.value.name === "zh-cn" ? CN : EN;
22
+ });
23
+ const Info = computed(() => {
24
+ return locale.value.name === "zh-cn" ? InfoCn : InfoEn;
25
+ });
26
+ return { API, Info };
27
+ },
10
28
  render() {
11
29
  return (
12
- <div class="demo-grid">
13
- <Info />
30
+ <div>
31
+ <this.Info />
14
32
  <Basic />
15
- <Gutter />
16
- <Offset />
17
- <Align />
18
- <Flex />
19
- <Fill />
20
- <CN />
33
+ <AutoFillMinWidth />
34
+ <BreakpointFallback />
35
+ <FixedRowsAreas />
36
+ <SuffixDisplayDone />
37
+ <Bento />
38
+ <AlignWhiteSpace />
39
+ <HeroSection />
40
+ <FooterStrategy />
41
+ <Architecture />
42
+ <this.API />
21
43
  </div>
22
44
  );
23
45
  },
@@ -0,0 +1,30 @@
1
+ # Grid
2
+
3
+ ### Dimensionality and Control: Grid vs. Row/Col
4
+
5
+ This is the most commonly confused set of concepts.
6
+
7
+ - Row/Col (Traditional One-Dimensional Grid): Usually implemented based on flex or float. It divides the space into 12 or 24 parts.
8
+ - Limitations: It is essentially one-dimensional. Although it can wrap, it is difficult to precisely control the vertical alignment of child items (such as making a certain Col span two rows). It requires negative margins and padding to handle gutters (spacing).
9
+
10
+ - Grid (Two-Dimensional Grid): Grid is two-dimensional. It can precisely control both rows and columns simultaneously.
11
+ - Advantages: No need for negative margins, directly control spacing through gaps. Supports rowSpan and dense mode, easily achieving "Bento Box" layouts.
12
+
13
+ ### Logic Orientation: Grid vs. Flex
14
+
15
+ - Flex (Content-Oriented): Use Flex when you have a group of items with variable widths, and you want them to automatically shrink or expand based on their content size and align within a single row. It emphasizes flexibility.
16
+
17
+ - Grid (Layout-Oriented): Use Grid when you first have a fixed grid framework (like 8 cells for a dashboard) and then want to "fill" content into it. It emphasizes structure.
18
+
19
+ ### Global Architecture vs. Local Arrangement: Layout Series
20
+
21
+ The Layout and its subcomponents (Header, Sider, Content, Footer) belong to the page skeleton-level components.
22
+
23
+ - Layout: Solves the semantic structure of the page's large background. It is responsible for managing the expansion/collapse of the sidebar, the fixed positioning of the top navigation, and the overall scrollbar management.
24
+
25
+ - Grid: Usually nested inside the Content (content area) of the Layout.
26
+ - Difference: Layout defines "how many rooms the house has"; Grid defines "how to arrange the furniture in each room".
27
+
28
+ ## Examples
29
+
30
+ You can manually resize the browser window to observe the effect.