@teamix-evo/ui 0.1.1 → 0.3.0

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 (295) hide show
  1. package/README.md +184 -184
  2. package/manifest.json +680 -492
  3. package/package.json +20 -10
  4. package/src/components/accordion/accordion.meta.md +5 -4
  5. package/src/components/accordion/accordion.stories.tsx +14 -9
  6. package/src/components/accordion/accordion.tsx +104 -8
  7. package/src/components/affix/affix.meta.md +20 -2
  8. package/src/components/affix/affix.stories.tsx +102 -25
  9. package/src/components/affix/affix.tsx +79 -9
  10. package/src/components/alert/alert.meta.md +44 -13
  11. package/src/components/alert/alert.stories.tsx +66 -21
  12. package/src/components/alert/alert.tsx +81 -34
  13. package/src/components/alert-dialog/alert-dialog.meta.md +61 -16
  14. package/src/components/alert-dialog/alert-dialog.stories.tsx +145 -3
  15. package/src/components/alert-dialog/alert-dialog.tsx +60 -13
  16. package/src/components/anchor/anchor.meta.md +8 -3
  17. package/src/components/anchor/anchor.stories.tsx +3 -3
  18. package/src/components/anchor/anchor.tsx +2 -2
  19. package/src/components/app/app.meta.md +9 -4
  20. package/src/components/app/app.stories.tsx +9 -7
  21. package/src/components/aspect-ratio/aspect-ratio.meta.md +4 -3
  22. package/src/components/aspect-ratio/aspect-ratio.stories.tsx +3 -3
  23. package/src/components/auto-complete/auto-complete.meta.md +14 -6
  24. package/src/components/auto-complete/auto-complete.stories.tsx +47 -4
  25. package/src/components/auto-complete/auto-complete.tsx +119 -71
  26. package/src/components/avatar/avatar.meta.md +6 -7
  27. package/src/components/avatar/avatar.stories.tsx +21 -3
  28. package/src/components/avatar/avatar.tsx +24 -23
  29. package/src/components/badge/badge.meta.md +10 -9
  30. package/src/components/badge/badge.stories.tsx +2 -2
  31. package/src/components/badge/badge.tsx +9 -15
  32. package/src/components/breadcrumb/breadcrumb.meta.md +27 -7
  33. package/src/components/breadcrumb/breadcrumb.stories.tsx +127 -4
  34. package/src/components/breadcrumb/breadcrumb.tsx +22 -8
  35. package/src/components/button/button.meta.md +258 -21
  36. package/src/components/button/button.stories.tsx +549 -41
  37. package/src/components/button/button.tsx +335 -33
  38. package/src/components/button/demo/as-child.tsx +24 -0
  39. package/src/components/button/demo/basic.tsx +8 -0
  40. package/src/components/button/demo/block.tsx +16 -0
  41. package/src/components/button/demo/loading.tsx +19 -0
  42. package/src/components/button/demo/shapes.tsx +18 -0
  43. package/src/components/button/demo/sizes.tsx +19 -0
  44. package/src/components/button/demo/variants.tsx +19 -0
  45. package/src/components/button/demo/with-icon.tsx +20 -0
  46. package/src/components/calendar/calendar.meta.md +13 -3
  47. package/src/components/calendar/calendar.stories.tsx +6 -6
  48. package/src/components/calendar/calendar.tsx +73 -8
  49. package/src/components/card/card.meta.md +27 -5
  50. package/src/components/card/card.stories.tsx +42 -3
  51. package/src/components/card/card.tsx +146 -63
  52. package/src/components/carousel/carousel.meta.md +4 -3
  53. package/src/components/carousel/carousel.stories.tsx +11 -6
  54. package/src/components/cascader/cascader.meta.md +47 -17
  55. package/src/components/cascader/cascader.stories.tsx +22 -10
  56. package/src/components/cascader/cascader.tsx +428 -85
  57. package/src/components/checkbox/checkbox.meta.md +75 -7
  58. package/src/components/checkbox/checkbox.stories.tsx +161 -3
  59. package/src/components/checkbox/checkbox.tsx +77 -9
  60. package/src/components/collapsible/collapsible.meta.md +14 -6
  61. package/src/components/collapsible/collapsible.stories.tsx +10 -2
  62. package/src/components/collapsible/collapsible.tsx +93 -6
  63. package/src/components/color-picker/color-picker.meta.md +12 -7
  64. package/src/components/color-picker/color-picker.stories.tsx +86 -7
  65. package/src/components/color-picker/color-picker.tsx +20 -9
  66. package/src/components/command/command.meta.md +29 -13
  67. package/src/components/command/command.stories.tsx +4 -4
  68. package/src/components/command/command.tsx +19 -8
  69. package/src/components/context-menu/context-menu.meta.md +11 -8
  70. package/src/components/context-menu/context-menu.stories.tsx +11 -3
  71. package/src/components/context-menu/context-menu.tsx +21 -8
  72. package/src/components/data-table/data-table.meta.md +6 -5
  73. package/src/components/data-table/data-table.stories.tsx +13 -6
  74. package/src/components/data-table/data-table.tsx +2 -2
  75. package/src/components/date-picker/date-picker.meta.md +88 -19
  76. package/src/components/date-picker/date-picker.stories.tsx +55 -5
  77. package/src/components/date-picker/date-picker.tsx +1489 -91
  78. package/src/components/descriptions/descriptions.meta.md +10 -5
  79. package/src/components/descriptions/descriptions.stories.tsx +3 -3
  80. package/src/components/descriptions/descriptions.tsx +22 -14
  81. package/src/components/dialog/dialog.meta.md +76 -13
  82. package/src/components/dialog/dialog.stories.tsx +182 -20
  83. package/src/components/dialog/dialog.tsx +67 -15
  84. package/src/components/dialog/imperative.tsx +252 -0
  85. package/src/components/drawer/drawer.meta.md +33 -34
  86. package/src/components/drawer/drawer.stories.tsx +29 -12
  87. package/src/components/drawer/drawer.tsx +22 -113
  88. package/src/components/dropdown-menu/dropdown-menu.meta.md +78 -10
  89. package/src/components/dropdown-menu/dropdown-menu.stories.tsx +88 -2
  90. package/src/components/dropdown-menu/dropdown-menu.tsx +24 -10
  91. package/src/components/ellipsis/ellipsis.meta.md +87 -0
  92. package/src/components/ellipsis/ellipsis.stories.tsx +72 -0
  93. package/src/components/ellipsis/ellipsis.tsx +153 -0
  94. package/src/components/empty/empty.meta.md +9 -4
  95. package/src/components/empty/empty.stories.tsx +4 -4
  96. package/src/components/empty/empty.tsx +10 -3
  97. package/src/components/field/field.meta.md +47 -9
  98. package/src/components/field/field.stories.tsx +385 -5
  99. package/src/components/field/field.tsx +263 -35
  100. package/src/components/filter-bar/filter-bar.meta.md +92 -0
  101. package/src/components/filter-bar/filter-bar.stories.tsx +1083 -0
  102. package/src/components/filter-bar/filter-bar.tsx +568 -0
  103. package/src/components/flex/flex.meta.md +54 -6
  104. package/src/components/flex/flex.stories.tsx +107 -20
  105. package/src/components/flex/flex.tsx +27 -4
  106. package/src/components/float-button/float-button.meta.md +8 -3
  107. package/src/components/float-button/float-button.stories.tsx +9 -7
  108. package/src/components/float-button/float-button.tsx +1 -1
  109. package/src/components/form/form.meta.md +39 -17
  110. package/src/components/form/form.stories.tsx +350 -3
  111. package/src/components/form/form.tsx +101 -35
  112. package/src/components/grid/grid.meta.md +7 -2
  113. package/src/components/grid/grid.stories.tsx +6 -4
  114. package/src/components/hover-card/hover-card.meta.md +20 -9
  115. package/src/components/hover-card/hover-card.stories.tsx +34 -5
  116. package/src/components/hover-card/hover-card.tsx +51 -13
  117. package/src/components/icon/DEVELOPMENT.md +809 -0
  118. package/src/components/icon/icon.meta.md +170 -0
  119. package/src/components/icon/icon.stories.tsx +344 -0
  120. package/src/components/icon/icon.tsx +248 -0
  121. package/src/components/image/image.meta.md +9 -4
  122. package/src/components/image/image.stories.tsx +3 -3
  123. package/src/components/image/image.tsx +6 -4
  124. package/src/components/input/demo/basic.tsx +12 -0
  125. package/src/components/input/demo/clearable.tsx +21 -0
  126. package/src/components/input/demo/show-count.tsx +18 -0
  127. package/src/components/input/demo/sizes.tsx +15 -0
  128. package/src/components/input/input.meta.md +39 -33
  129. package/src/components/input/input.stories.tsx +62 -35
  130. package/src/components/input/input.tsx +97 -98
  131. package/src/components/input-group/input-group.meta.md +54 -22
  132. package/src/components/input-group/input-group.stories.tsx +49 -16
  133. package/src/components/input-group/input-group.tsx +44 -8
  134. package/src/components/input-number/input-number.meta.md +64 -7
  135. package/src/components/input-number/input-number.stories.tsx +46 -8
  136. package/src/components/input-number/input-number.tsx +99 -26
  137. package/src/components/input-otp/input-otp.meta.md +4 -3
  138. package/src/components/input-otp/input-otp.stories.tsx +3 -3
  139. package/src/components/input-otp/input-otp.tsx +1 -1
  140. package/src/components/item/item.meta.md +8 -3
  141. package/src/components/item/item.stories.tsx +8 -5
  142. package/src/components/item/item.tsx +7 -6
  143. package/src/components/kbd/kbd.meta.md +13 -4
  144. package/src/components/kbd/kbd.stories.tsx +4 -4
  145. package/src/components/kbd/kbd.tsx +10 -5
  146. package/src/components/label/label.meta.md +18 -10
  147. package/src/components/label/label.stories.tsx +64 -6
  148. package/src/components/label/label.tsx +91 -19
  149. package/src/components/masonry/masonry.meta.md +8 -3
  150. package/src/components/masonry/masonry.stories.tsx +7 -5
  151. package/src/components/masonry/masonry.tsx +1 -0
  152. package/src/components/mentions/mentions.meta.md +36 -6
  153. package/src/components/mentions/mentions.stories.tsx +120 -6
  154. package/src/components/mentions/mentions.tsx +11 -5
  155. package/src/components/menubar/menubar.meta.md +30 -12
  156. package/src/components/menubar/menubar.stories.tsx +62 -2
  157. package/src/components/menubar/menubar.tsx +9 -9
  158. package/src/components/native-select/native-select.meta.md +8 -3
  159. package/src/components/native-select/native-select.stories.tsx +8 -5
  160. package/src/components/native-select/native-select.tsx +1 -1
  161. package/src/components/navigation-menu/navigation-menu.meta.md +19 -9
  162. package/src/components/navigation-menu/navigation-menu.stories.tsx +112 -9
  163. package/src/components/navigation-menu/navigation-menu.tsx +8 -4
  164. package/src/components/notification/notification.meta.md +52 -10
  165. package/src/components/notification/notification.stories.tsx +11 -9
  166. package/src/components/notification/notification.tsx +36 -21
  167. package/src/components/page-header/DEVELOPMENT.md +842 -0
  168. package/src/components/page-header/page-header.meta.md +208 -0
  169. package/src/components/page-header/page-header.stories.tsx +421 -0
  170. package/src/components/page-header/page-header.tsx +281 -0
  171. package/src/components/pagination/pagination.meta.md +140 -37
  172. package/src/components/pagination/pagination.stories.tsx +232 -10
  173. package/src/components/pagination/pagination.tsx +355 -63
  174. package/src/components/popconfirm/popconfirm.meta.md +9 -4
  175. package/src/components/popconfirm/popconfirm.stories.tsx +3 -4
  176. package/src/components/popconfirm/popconfirm.tsx +2 -2
  177. package/src/components/popover/popover.meta.md +62 -5
  178. package/src/components/popover/popover.stories.tsx +83 -7
  179. package/src/components/popover/popover.tsx +77 -28
  180. package/src/components/progress/progress.meta.md +38 -6
  181. package/src/components/progress/progress.stories.tsx +3 -3
  182. package/src/components/progress/progress.tsx +24 -16
  183. package/src/components/radio-group/radio-group.meta.md +79 -7
  184. package/src/components/radio-group/radio-group.stories.tsx +39 -3
  185. package/src/components/radio-group/radio-group.tsx +149 -18
  186. package/src/components/rate/rate.meta.md +35 -4
  187. package/src/components/rate/rate.stories.tsx +13 -5
  188. package/src/components/rate/rate.tsx +37 -10
  189. package/src/components/resizable/resizable.meta.md +7 -4
  190. package/src/components/resizable/resizable.stories.tsx +6 -6
  191. package/src/components/resizable/resizable.tsx +1 -1
  192. package/src/components/result/result.meta.md +7 -2
  193. package/src/components/result/result.stories.tsx +4 -8
  194. package/src/components/result/result.tsx +24 -15
  195. package/src/components/scroll-area/scroll-area.meta.md +4 -3
  196. package/src/components/scroll-area/scroll-area.stories.tsx +12 -4
  197. package/src/components/scroll-area/scroll-area.tsx +3 -3
  198. package/src/components/segmented/segmented.meta.md +7 -4
  199. package/src/components/segmented/segmented.stories.tsx +37 -8
  200. package/src/components/segmented/segmented.tsx +15 -7
  201. package/src/components/select/select.meta.md +197 -52
  202. package/src/components/select/select.stories.tsx +238 -63
  203. package/src/components/select/select.tsx +718 -171
  204. package/src/components/separator/separator.meta.md +4 -3
  205. package/src/components/separator/separator.stories.tsx +3 -3
  206. package/src/components/separator/separator.tsx +3 -7
  207. package/src/components/sheet/sheet.meta.md +32 -16
  208. package/src/components/sheet/sheet.stories.tsx +116 -10
  209. package/src/components/sheet/sheet.tsx +116 -29
  210. package/src/components/sidebar/sidebar.meta.md +37 -18
  211. package/src/components/sidebar/sidebar.stories.tsx +701 -29
  212. package/src/components/sidebar/sidebar.tsx +615 -142
  213. package/src/components/skeleton/skeleton.meta.md +4 -5
  214. package/src/components/skeleton/skeleton.stories.tsx +4 -4
  215. package/src/components/skeleton/skeleton.tsx +7 -7
  216. package/src/components/slider/slider.meta.md +57 -5
  217. package/src/components/slider/slider.stories.tsx +58 -6
  218. package/src/components/slider/slider.tsx +154 -13
  219. package/src/components/sonner/sonner.meta.md +58 -7
  220. package/src/components/sonner/sonner.stories.tsx +78 -5
  221. package/src/components/sonner/sonner.tsx +137 -8
  222. package/src/components/spinner/spinner.meta.md +62 -13
  223. package/src/components/spinner/spinner.stories.tsx +66 -14
  224. package/src/components/spinner/spinner.tsx +111 -9
  225. package/src/components/statistic/statistic.meta.md +7 -2
  226. package/src/components/statistic/statistic.stories.tsx +3 -7
  227. package/src/components/statistic/statistic.tsx +5 -6
  228. package/src/components/steps/steps.meta.md +18 -4
  229. package/src/components/steps/steps.stories.tsx +43 -3
  230. package/src/components/steps/steps.tsx +15 -12
  231. package/src/components/switch/switch.meta.md +51 -5
  232. package/src/components/switch/switch.stories.tsx +6 -6
  233. package/src/components/switch/switch.tsx +109 -41
  234. package/src/components/table/table.meta.md +17 -6
  235. package/src/components/table/table.stories.tsx +10 -5
  236. package/src/components/table/table.tsx +4 -4
  237. package/src/components/tabs/tabs.meta.md +38 -25
  238. package/src/components/tabs/tabs.stories.tsx +111 -25
  239. package/src/components/tabs/tabs.tsx +125 -54
  240. package/src/components/tag/tag.meta.md +105 -40
  241. package/src/components/tag/tag.stories.tsx +189 -16
  242. package/src/components/tag/tag.tsx +222 -21
  243. package/src/components/textarea/textarea.meta.md +35 -19
  244. package/src/components/textarea/textarea.stories.tsx +32 -6
  245. package/src/components/textarea/textarea.tsx +33 -9
  246. package/src/components/time-picker/time-picker.meta.md +124 -32
  247. package/src/components/time-picker/time-picker.stories.tsx +85 -15
  248. package/src/components/time-picker/time-picker.tsx +913 -61
  249. package/src/components/timeline/timeline.meta.md +14 -6
  250. package/src/components/timeline/timeline.stories.tsx +37 -7
  251. package/src/components/timeline/timeline.tsx +35 -14
  252. package/src/components/toggle/toggle.meta.md +5 -4
  253. package/src/components/toggle/toggle.stories.tsx +4 -4
  254. package/src/components/toggle/toggle.tsx +4 -3
  255. package/src/components/toggle-group/toggle-group.meta.md +5 -4
  256. package/src/components/toggle-group/toggle-group.stories.tsx +3 -3
  257. package/src/components/toggle-group/toggle-group.tsx +2 -2
  258. package/src/components/tooltip/tooltip.meta.md +55 -5
  259. package/src/components/tooltip/tooltip.stories.tsx +42 -5
  260. package/src/components/tooltip/tooltip.tsx +81 -21
  261. package/src/components/tour/tour.meta.md +9 -4
  262. package/src/components/tour/tour.stories.tsx +3 -3
  263. package/src/components/tour/tour.tsx +4 -4
  264. package/src/components/transfer/transfer.meta.md +11 -6
  265. package/src/components/transfer/transfer.stories.tsx +4 -8
  266. package/src/components/transfer/transfer.tsx +28 -21
  267. package/src/components/tree/tree.meta.md +63 -5
  268. package/src/components/tree/tree.stories.tsx +31 -12
  269. package/src/components/tree/tree.tsx +9 -8
  270. package/src/components/tree-select/tree-select.meta.md +59 -8
  271. package/src/components/tree-select/tree-select.stories.tsx +3 -3
  272. package/src/components/tree-select/tree-select.tsx +42 -7
  273. package/src/components/typography/typography.meta.md +61 -14
  274. package/src/components/typography/typography.stories.tsx +12 -11
  275. package/src/components/typography/typography.tsx +43 -28
  276. package/src/components/upload/upload.meta.md +49 -4
  277. package/src/components/upload/upload.stories.tsx +72 -12
  278. package/src/components/upload/upload.tsx +170 -37
  279. package/src/components/watermark/watermark.meta.md +7 -2
  280. package/src/components/watermark/watermark.stories.tsx +101 -9
  281. package/src/components/watermark/watermark.tsx +1 -0
  282. package/src/hooks/use-breakpoint.ts +117 -0
  283. package/src/hooks/use-debounce-callback.ts +52 -0
  284. package/src/hooks/use-mobile.ts +23 -0
  285. package/src/stories/theme-tokens.stories.tsx +747 -0
  286. package/src/utils/trigger-input.ts +53 -0
  287. package/src/components/button-group/button-group.meta.md +0 -92
  288. package/src/components/button-group/button-group.stories.tsx +0 -90
  289. package/src/components/button-group/button-group.tsx +0 -75
  290. package/src/components/combobox/combobox.meta.md +0 -93
  291. package/src/components/combobox/combobox.stories.tsx +0 -55
  292. package/src/components/combobox/combobox.tsx +0 -130
  293. package/src/components/space/space.meta.md +0 -94
  294. package/src/components/space/space.stories.tsx +0 -94
  295. package/src/components/space/space.tsx +0 -106
@@ -1,13 +1,14 @@
1
1
  ---
2
2
  id: separator
3
3
  name: Separator
4
+ displayName: 分隔线
4
5
  type: component
5
- category: foundation
6
+ category: layout
6
7
  since: 0.1.0
7
- package: "@teamix-evo/ui"
8
+ package: '@teamix-evo/ui'
8
9
  ---
9
10
 
10
- # Separator
11
+ # Separator 分隔线
11
12
 
12
13
  分隔线 — Radix Separator(语义层)+ antd Divider 的 `dashed` 与中间装饰文本(`children`)。
13
14
 
@@ -1,15 +1,15 @@
1
- import type { Meta, StoryObj } from '@storybook/react';
1
+ import type { Meta, StoryObj } from '@storybook/react-vite';
2
2
  import { Separator } from './separator';
3
3
 
4
4
  const meta: Meta<typeof Separator> = {
5
- title: '基础原语 · Foundation/Separator',
5
+ title: '布局 · Layout/Separator',
6
6
  component: Separator,
7
7
  tags: ['autodocs'],
8
8
  parameters: {
9
9
  docs: {
10
10
  description: {
11
11
  component:
12
- '分隔线 — 在视觉上或语义上区隔内容。Radix Separator 实现 + antd Divider 的并集能力:支持水平 / 垂直两种 `orientation`,可传 `dashed` 虚线样式,中间可嵌入 `children` 为文字分隔(antd `Divider` 中部文字能力)。视觉走 OpenTrek semantic tokens,所有样式来自 `@teamix-evo/design`,无 mock。',
12
+ '分隔线 — 在视觉上或语义上区隔内容。Radix Separator 实现 + antd Divider 的并集能力:支持水平 / 垂直两种 `orientation`,可传 `dashed` 虚线样式,中间可嵌入 `children` 为文字分隔。',
13
13
  },
14
14
  },
15
15
  },
@@ -53,7 +53,7 @@ const Separator = React.forwardRef<
53
53
  role={decorative ? 'none' : 'separator'}
54
54
  aria-orientation={decorative ? undefined : 'horizontal'}
55
55
  className={cn(
56
- 'flex w-full items-center gap-3 text-sm text-muted-foreground',
56
+ 'flex w-full items-center gap-3 text-xs text-muted-foreground',
57
57
  className,
58
58
  )}
59
59
  {...(props as React.HTMLAttributes<HTMLDivElement>)}
@@ -61,18 +61,14 @@ const Separator = React.forwardRef<
61
61
  <span
62
62
  className={cn(
63
63
  'h-px flex-1',
64
- dashed
65
- ? 'border-t border-dashed border-border'
66
- : 'bg-border',
64
+ dashed ? 'border-t border-dashed border-border' : 'bg-border',
67
65
  )}
68
66
  />
69
67
  <span className="shrink-0">{children}</span>
70
68
  <span
71
69
  className={cn(
72
70
  'h-px flex-1',
73
- dashed
74
- ? 'border-t border-dashed border-border'
75
- : 'bg-border',
71
+ dashed ? 'border-t border-dashed border-border' : 'bg-border',
76
72
  )}
77
73
  />
78
74
  </div>
@@ -1,29 +1,30 @@
1
1
  ---
2
2
  id: sheet
3
3
  name: Sheet
4
+ displayName: 侧边面板
4
5
  type: component
5
6
  category: feedback
6
7
  since: 0.1.0
7
- package: "@teamix-evo/ui"
8
+ package: '@teamix-evo/ui'
8
9
  ---
9
10
 
10
- # Sheet
11
+ # Sheet 侧边面板
11
12
 
12
- 侧边滑出面板 — Radix Dialog 底座 + side 方向变体(left / right / top / bottom)+ antd Drawer `placement` 并集。
13
- **与 Dialog 的关键差异**:Sheet 从屏幕边缘滑入,模态阻断同样;`Drawer` 是底部可拖拽抽屉(iOS 风格,移动端体验)。
13
+ 侧边滑出面板 — Radix Dialog 底座 + side 方向变体(left / right / top / bottom)+ size 尺寸变体 + `--radius-dialog` 圆角,对齐 antd Drawer 全能力集。
14
+ `Drawer` 现为 Sheet 的别名 re-export,向后兼容。
14
15
 
15
16
  ## When to use
16
17
 
17
18
  - 设置面板 / 详情查看(从右侧滑入,主区域保留可见)
18
19
  - 移动端导航(从左侧滑入)
19
20
  - 编辑面板(主操作仍在画面内)
21
+ - 任何需要从屏幕边缘抽出面板、承载次要流程的场景
20
22
 
21
23
  ## When NOT to use
22
24
 
23
25
  - 短交互 → `Popover`
24
26
  - 阻断式确认 → `AlertDialog`
25
- - 移动端可拖拽 → `Drawer`
26
- - 普通模态 → `Dialog`
27
+ - 普通模态(居中) → `Dialog`
27
28
 
28
29
  ## Props
29
30
 
@@ -33,6 +34,8 @@ package: "@teamix-evo/ui"
33
34
  | 名称 | 类型 | 默认值 | 必填 | 说明 |
34
35
  | --- | --- | --- | --- | --- |
35
36
  | `side` | `'top' \| 'right' \| 'bottom' \| 'left'` | `"right"` | – | 弹出方向(antd Drawer `placement` 并集)。 |
37
+ | `size` | `SheetSize` | `"md"` | – | 面板尺寸 — 绑定 design tokens `--layout-dialog-{sm\|md\|lg\|xl}`。 仅在 side=left/right 时生效(控制宽度)。 |
38
+ | `showClose` | `boolean` | `true` | – | 是否在标题区右侧显示默认关闭按钮。 若使用 SheetHeader 的内置 close 布局,可设为 false 自行控制。 |
36
39
  <!-- auto:props:end -->
37
40
 
38
41
  ## 依赖
@@ -57,22 +60,33 @@ pnpm add @radix-ui/react-dialog@^1.1.0 class-variance-authority@^0.7.0 lucide-re
57
60
  ```
58
61
  <!-- auto:deps:end -->
59
62
 
60
- > 子组件:`Sheet` / `SheetTrigger` / `SheetContent`(`side` 在此)/ `SheetHeader` / `SheetFooter` / `SheetTitle` / `SheetDescription` / `SheetClose` / `SheetOverlay` / `SheetPortal`。
63
+ > 子组件:`Sheet` / `SheetTrigger` / `SheetContent`(`side` + `size` 在此)/ `SheetHeader` / `SheetBody` / `SheetFooter` / `SheetTitle` / `SheetDescription` / `SheetClose` / `SheetOverlay` / `SheetPortal`。
61
64
 
62
65
  ## AI 生成纪律
63
66
 
64
67
  - **side 默认 right**:右侧是详情类滑出的工业惯例(Email / 设置 / 通知)
65
68
  - **side="left" 仅用于全局导航**(响应式抽屉);避免在桌面端把内容也用 left side
66
- - **Sheet 内表单 Footer 居底**:用 `flex-1` + 滚动区让表单可滚动,Footer 固定底部
67
- - **`SheetTitle` 必有**(无障碍)
68
- - **Sheet Drawer 混用**:同一应用内只挑一个,响应式断点切换由设计层决定
69
+ - **size 默认 md(600px)**:sm(400) 适合简单设置;lg(800) 适合有表格/表单的编辑;xl(1200) 仅全屏级编辑器
70
+ - **SheetBody 必须包裹内容区**:确保 flex-1 + overflow-auto 滚动正确
71
+ - **SheetHeader 已含 border-b,SheetFooter 已含 border-t**:不要再额外加分隔线
72
+ - **Sheet 内表单 Footer 居底**:SheetBody + SheetFooter 自然形成 header | body(scrollable) | footer 三段式
73
+ - **`SheetTitle` 必有**(无障碍,Radix Dialog 要求)
74
+ - **圆角由 `--radius-dialog` token 控制**:不要手动覆盖 rounded 值
75
+ - **Drawer 现在是 Sheet 的 alias**:新代码一律使用 Sheet,Drawer 仅为向后兼容保留
69
76
 
70
77
  ## Examples
71
78
 
72
79
  ```tsx
73
80
  import {
74
- Sheet, SheetTrigger, SheetContent, SheetHeader,
75
- SheetTitle, SheetDescription, SheetFooter, SheetClose,
81
+ Sheet,
82
+ SheetTrigger,
83
+ SheetContent,
84
+ SheetHeader,
85
+ SheetBody,
86
+ SheetTitle,
87
+ SheetDescription,
88
+ SheetFooter,
89
+ SheetClose,
76
90
  } from '@/components/ui/sheet';
77
91
  import { Button } from '@/components/ui/button';
78
92
 
@@ -80,12 +94,14 @@ import { Button } from '@/components/ui/button';
80
94
  <SheetTrigger asChild>
81
95
  <Button variant="outline">查看详情</Button>
82
96
  </SheetTrigger>
83
- <SheetContent side="right" className="sm:max-w-md">
97
+ <SheetContent side="right" size="md">
84
98
  <SheetHeader>
85
99
  <SheetTitle>用户详情</SheetTitle>
86
- <SheetDescription>查看与编辑用户基本信息</SheetDescription>
87
100
  </SheetHeader>
88
- {/* content */}
101
+ <SheetBody>
102
+ <SheetDescription>查看与编辑用户基本信息</SheetDescription>
103
+ {/* content */}
104
+ </SheetBody>
89
105
  <SheetFooter>
90
106
  <SheetClose asChild>
91
107
  <Button variant="outline">关闭</Button>
@@ -93,5 +109,5 @@ import { Button } from '@/components/ui/button';
93
109
  <Button>保存</Button>
94
110
  </SheetFooter>
95
111
  </SheetContent>
96
- </Sheet>
112
+ </Sheet>;
97
113
  ```
@@ -1,9 +1,10 @@
1
- import type { Meta, StoryObj } from '@storybook/react';
1
+ import type { Meta, StoryObj } from '@storybook/react-vite';
2
2
  import {
3
3
  Sheet,
4
4
  SheetTrigger,
5
5
  SheetContent,
6
6
  SheetHeader,
7
+ SheetBody,
7
8
  SheetTitle,
8
9
  SheetDescription,
9
10
  SheetFooter,
@@ -12,14 +13,14 @@ import {
12
13
  import { Button } from '@/components/button/button';
13
14
 
14
15
  const meta: Meta<typeof SheetContent> = {
15
- title: '反馈与浮层 · Feedback/Sheet',
16
+ title: '反馈 · Feedback/Sheet',
16
17
  component: SheetContent,
17
18
  tags: ['autodocs'],
18
19
  parameters: {
19
20
  docs: {
20
21
  description: {
21
22
  component:
22
- '侧边抽屉 从屏幕边缘滑入的补充内容面板,补充主区不中断主流程。语义上是 Dialog 的表弟但定位于边缘,对齐 antd `Drawer`;Radix Dialog 内核实现 + shadcn `Sheet` `side` 变体 (top / right / bottom / left) 。视觉走 OpenTrek semantic tokens,所有样式来自 `@teamix-evo/design`,无 mock。',
23
+ '侧边面板 —— 从屏幕边缘滑入的模态面板,承载次要流程(设置/详情/编辑)且不中断主区域。Radix Dialog 内核 + cva side/size 双变体 + `--radius-dialog` 圆角,对齐 antd `Drawer` 全能力(`placement` / `size` / header+close / footer 操作栏)并兼容 shadcn `Sheet` 的 `side` 模型:`side`、`size`、`showClose`。视觉走 OpenTrek semantic tokens,所有样式来自 `@teamix-evo/tokens`,无 mock。',
23
24
  },
24
25
  },
25
26
  },
@@ -28,8 +29,15 @@ const meta: Meta<typeof SheetContent> = {
28
29
  control: 'inline-radio',
29
30
  options: ['top', 'right', 'bottom', 'left'],
30
31
  },
32
+ size: {
33
+ control: 'inline-radio',
34
+ options: ['sm', 'md', 'lg', 'xl'],
35
+ },
36
+ showClose: {
37
+ control: 'boolean',
38
+ },
31
39
  },
32
- args: { side: 'right' },
40
+ args: { side: 'right', size: 'md', showClose: true },
33
41
  };
34
42
 
35
43
  export default meta;
@@ -44,14 +52,16 @@ export const Playground: Story = {
44
52
  <SheetContent {...args}>
45
53
  <SheetHeader>
46
54
  <SheetTitle>编辑资料</SheetTitle>
47
- <SheetDescription>保存后立即生效。</SheetDescription>
48
55
  </SheetHeader>
49
- <div className="py-4 text-sm text-muted-foreground">
50
- 表单字段放在这里...
51
- </div>
56
+ <SheetBody>
57
+ <SheetDescription>保存后立即生效。</SheetDescription>
58
+ <div className="py-4 text-sm text-muted-foreground">
59
+ 表单字段放在这里...
60
+ </div>
61
+ </SheetBody>
52
62
  <SheetFooter>
53
63
  <SheetClose asChild>
54
- <Button variant="outline">关闭</Button>
64
+ <Button variant="outline">取消</Button>
55
65
  </SheetClose>
56
66
  <Button>保存</Button>
57
67
  </SheetFooter>
@@ -61,6 +71,7 @@ export const Playground: Story = {
61
71
  };
62
72
 
63
73
  export const FourSides: Story = {
74
+ name: '四个方向',
64
75
  parameters: { controls: { disable: true } },
65
76
  render: () => (
66
77
  <div className="flex flex-wrap gap-3">
@@ -69,14 +80,109 @@ export const FourSides: Story = {
69
80
  <SheetTrigger asChild>
70
81
  <Button variant="outline">{s}</Button>
71
82
  </SheetTrigger>
72
- <SheetContent side={s}>
83
+ <SheetContent side={s} size="md">
73
84
  <SheetHeader>
74
85
  <SheetTitle>side = {s}</SheetTitle>
86
+ </SheetHeader>
87
+ <SheetBody>
75
88
  <SheetDescription>从 {s} 方向滑入。</SheetDescription>
89
+ </SheetBody>
90
+ </SheetContent>
91
+ </Sheet>
92
+ ))}
93
+ </div>
94
+ ),
95
+ };
96
+
97
+ export const Sizes: Story = {
98
+ name: '尺寸变体',
99
+ parameters: { controls: { disable: true } },
100
+ render: () => (
101
+ <div className="flex flex-wrap gap-3">
102
+ {(['sm', 'md', 'lg', 'xl'] as const).map((sz) => (
103
+ <Sheet key={sz}>
104
+ <SheetTrigger asChild>
105
+ <Button variant="outline">{sz}</Button>
106
+ </SheetTrigger>
107
+ <SheetContent side="right" size={sz}>
108
+ <SheetHeader>
109
+ <SheetTitle>size = {sz}</SheetTitle>
76
110
  </SheetHeader>
111
+ <SheetBody>
112
+ <SheetDescription>
113
+ 宽度由 --layout-dialog-{sz} token 控制。
114
+ </SheetDescription>
115
+ </SheetBody>
77
116
  </SheetContent>
78
117
  </Sheet>
79
118
  ))}
80
119
  </div>
81
120
  ),
82
121
  };
122
+
123
+ export const WithHeaderFooter: Story = {
124
+ name: 'Header + Body + Footer 三段式',
125
+ parameters: { controls: { disable: true } },
126
+ render: () => (
127
+ <Sheet>
128
+ <SheetTrigger asChild>
129
+ <Button variant="outline">打开完整面板</Button>
130
+ </SheetTrigger>
131
+ <SheetContent side="right" size="lg">
132
+ <SheetHeader>
133
+ <SheetTitle>订单详情</SheetTitle>
134
+ </SheetHeader>
135
+ <SheetBody>
136
+ <div className="space-y-4">
137
+ <p className="text-sm text-muted-foreground">
138
+ 订单号:ORD-2026-001234
139
+ </p>
140
+ <p className="text-sm text-muted-foreground">
141
+ 创建时间:2026-05-29 10:30
142
+ </p>
143
+ <div className="h-64 rounded-lg bg-muted/50 p-4 text-sm text-muted-foreground">
144
+ 模拟长内容区域(可滚动)...
145
+ </div>
146
+ <div className="h-64 rounded-lg bg-muted/50 p-4 text-sm text-muted-foreground">
147
+ 更多内容...
148
+ </div>
149
+ </div>
150
+ </SheetBody>
151
+ <SheetFooter>
152
+ <SheetClose asChild>
153
+ <Button variant="outline">取消</Button>
154
+ </SheetClose>
155
+ <Button>确认操作</Button>
156
+ </SheetFooter>
157
+ </SheetContent>
158
+ </Sheet>
159
+ ),
160
+ };
161
+
162
+ export const NoCloseButton: Story = {
163
+ name: '隐藏关闭按钮',
164
+ parameters: { controls: { disable: true } },
165
+ render: () => (
166
+ <Sheet>
167
+ <SheetTrigger asChild>
168
+ <Button variant="outline">无关闭按钮</Button>
169
+ </SheetTrigger>
170
+ <SheetContent side="right" size="sm" showClose={false}>
171
+ <SheetHeader>
172
+ <SheetTitle>必选操作</SheetTitle>
173
+ </SheetHeader>
174
+ <SheetBody>
175
+ <SheetDescription>
176
+ 隐藏右上角关闭按钮,用户必须通过底部按钮完成操作。
177
+ </SheetDescription>
178
+ </SheetBody>
179
+ <SheetFooter>
180
+ <SheetClose asChild>
181
+ <Button variant="outline">放弃</Button>
182
+ </SheetClose>
183
+ <Button>完成</Button>
184
+ </SheetFooter>
185
+ </SheetContent>
186
+ </Sheet>
187
+ ),
188
+ };
@@ -6,10 +6,32 @@ import { X } from 'lucide-react';
6
6
  import { cn } from '@/utils/cn';
7
7
 
8
8
  const Sheet = SheetPrimitive.Root;
9
- const SheetTrigger = SheetPrimitive.Trigger;
10
- const SheetClose = SheetPrimitive.Close;
11
9
  const SheetPortal = SheetPrimitive.Portal;
12
10
 
11
+ const SheetTrigger = React.forwardRef<
12
+ React.ElementRef<typeof SheetPrimitive.Trigger>,
13
+ React.ComponentPropsWithoutRef<typeof SheetPrimitive.Trigger>
14
+ >(({ className, ...props }, ref) => (
15
+ <SheetPrimitive.Trigger
16
+ ref={ref}
17
+ className={cn('cursor-pointer', className)}
18
+ {...props}
19
+ />
20
+ ));
21
+ SheetTrigger.displayName = SheetPrimitive.Trigger.displayName;
22
+
23
+ const SheetClose = React.forwardRef<
24
+ React.ElementRef<typeof SheetPrimitive.Close>,
25
+ React.ComponentPropsWithoutRef<typeof SheetPrimitive.Close>
26
+ >(({ className, ...props }, ref) => (
27
+ <SheetPrimitive.Close
28
+ ref={ref}
29
+ className={cn('cursor-pointer', className)}
30
+ {...props}
31
+ />
32
+ ));
33
+ SheetClose.displayName = SheetPrimitive.Close.displayName;
34
+
13
35
  const SheetOverlay = React.forwardRef<
14
36
  React.ElementRef<typeof SheetPrimitive.Overlay>,
15
37
  React.ComponentPropsWithoutRef<typeof SheetPrimitive.Overlay>
@@ -25,52 +47,106 @@ const SheetOverlay = React.forwardRef<
25
47
  ));
26
48
  SheetOverlay.displayName = SheetPrimitive.Overlay.displayName;
27
49
 
28
- const sheetVariants = cva(
29
- 'fixed z-50 gap-4 bg-background p-6 shadow-lg transition ease-in-out data-[state=open]:animate-in data-[state=closed]:animate-out data-[state=closed]:duration-300 data-[state=open]:duration-500',
50
+ /**
51
+ * Sheet content 变体。
52
+ * - 圆角统一绑定 `--radius-dialog`(16px,OpenTrek),按 side 方向仅在内侧施加
53
+ * - size 绑定 `--layout-dialog-{sm|md|lg|xl}` tokens
54
+ * - 去掉 border,使用 shadow 作为视觉分界
55
+ */
56
+ const sheetContentVariants = cva(
57
+ 'fixed z-50 flex flex-col bg-background shadow-lg transition ease-in-out data-[state=open]:animate-in data-[state=closed]:animate-out data-[state=closed]:duration-300 data-[state=open]:duration-500',
30
58
  {
31
59
  variants: {
32
60
  side: {
33
- top: 'inset-x-0 top-0 border-b data-[state=closed]:slide-out-to-top data-[state=open]:slide-in-from-top',
61
+ top: 'inset-x-0 top-0 rounded-b-[var(--radius-dialog)] data-[state=closed]:slide-out-to-top data-[state=open]:slide-in-from-top',
34
62
  bottom:
35
- 'inset-x-0 bottom-0 border-t data-[state=closed]:slide-out-to-bottom data-[state=open]:slide-in-from-bottom',
36
- left: 'inset-y-0 left-0 h-full w-3/4 border-r data-[state=closed]:slide-out-to-left data-[state=open]:slide-in-from-left sm:max-w-sm',
63
+ 'inset-x-0 bottom-0 rounded-t-[var(--radius-dialog)] data-[state=closed]:slide-out-to-bottom data-[state=open]:slide-in-from-bottom',
64
+ left: 'inset-y-0 left-0 h-full rounded-r-[var(--radius-dialog)] data-[state=closed]:slide-out-to-left data-[state=open]:slide-in-from-left',
37
65
  right:
38
- 'inset-y-0 right-0 h-full w-3/4 border-l data-[state=closed]:slide-out-to-right data-[state=open]:slide-in-from-right sm:max-w-sm',
66
+ 'inset-y-0 right-0 h-full rounded-l-[var(--radius-dialog)] data-[state=closed]:slide-out-to-right data-[state=open]:slide-in-from-right',
67
+ },
68
+ size: {
69
+ sm: 'w-[var(--layout-dialog-sm)]',
70
+ md: 'w-[var(--layout-dialog-md)]',
71
+ lg: 'w-[var(--layout-dialog-lg)]',
72
+ xl: 'w-[var(--layout-dialog-xl)]',
39
73
  },
40
74
  },
41
- defaultVariants: { side: 'right' },
75
+ compoundVariants: [
76
+ // top/bottom sides ignore width-based size — use height or auto
77
+ { side: 'top', size: 'sm', className: 'w-auto' },
78
+ { side: 'top', size: 'md', className: 'w-auto' },
79
+ { side: 'top', size: 'lg', className: 'w-auto' },
80
+ { side: 'top', size: 'xl', className: 'w-auto' },
81
+ { side: 'bottom', size: 'sm', className: 'w-auto' },
82
+ { side: 'bottom', size: 'md', className: 'w-auto' },
83
+ { side: 'bottom', size: 'lg', className: 'w-auto' },
84
+ { side: 'bottom', size: 'xl', className: 'w-auto' },
85
+ ],
86
+ defaultVariants: { side: 'right', size: 'md' },
42
87
  },
43
88
  );
44
89
 
90
+ export type SheetSize = NonNullable<
91
+ VariantProps<typeof sheetContentVariants>['size']
92
+ >;
93
+
45
94
  export interface SheetContentProps
46
95
  extends React.ComponentPropsWithoutRef<typeof SheetPrimitive.Content>,
47
- VariantProps<typeof sheetVariants> {
96
+ VariantProps<typeof sheetContentVariants> {
48
97
  /**
49
98
  * 弹出方向(antd Drawer `placement` 并集)。
50
99
  * @default "right"
51
100
  */
52
101
  side?: 'top' | 'right' | 'bottom' | 'left';
102
+ /**
103
+ * 面板尺寸 — 绑定 design tokens `--layout-dialog-{sm|md|lg|xl}`。
104
+ * 仅在 side=left/right 时生效(控制宽度)。
105
+ * @default "md"
106
+ */
107
+ size?: SheetSize;
108
+ /**
109
+ * 是否在标题区右侧显示默认关闭按钮。
110
+ * 若使用 SheetHeader 的内置 close 布局,可设为 false 自行控制。
111
+ * @default true
112
+ */
113
+ showClose?: boolean;
53
114
  }
54
115
 
55
116
  const SheetContent = React.forwardRef<
56
117
  React.ElementRef<typeof SheetPrimitive.Content>,
57
118
  SheetContentProps
58
- >(({ side = 'right', className, children, ...props }, ref) => (
59
- <SheetPortal>
60
- <SheetOverlay />
61
- <SheetPrimitive.Content
62
- ref={ref}
63
- className={cn(sheetVariants({ side }), className)}
64
- {...props}
65
- >
66
- {children}
67
- <SheetPrimitive.Close className="absolute right-4 top-4 rounded-sm opacity-70 ring-offset-background transition-opacity hover:opacity-100 focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-ring focus-visible:ring-offset-2">
68
- <X className="size-4" />
69
- <span className="sr-only">Close</span>
70
- </SheetPrimitive.Close>
71
- </SheetPrimitive.Content>
72
- </SheetPortal>
73
- ));
119
+ >(
120
+ (
121
+ {
122
+ side = 'right',
123
+ size = 'md',
124
+ showClose = true,
125
+ className,
126
+ children,
127
+ ...props
128
+ },
129
+ ref,
130
+ ) => (
131
+ <SheetPortal>
132
+ <SheetOverlay />
133
+ <SheetPrimitive.Content
134
+ ref={ref}
135
+ data-slot="sheet-content"
136
+ className={cn(sheetContentVariants({ side, size }), className)}
137
+ {...props}
138
+ >
139
+ {children}
140
+ {showClose ? (
141
+ <SheetPrimitive.Close className="absolute right-4 top-4 inline-flex size-6 cursor-pointer items-center justify-center rounded-sm text-muted-foreground opacity-70 ring-offset-background transition-opacity hover:bg-accent hover:opacity-100 focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-ring focus-visible:ring-offset-2 disabled:pointer-events-none">
142
+ <X className="size-4" />
143
+ <span className="sr-only">Close</span>
144
+ </SheetPrimitive.Close>
145
+ ) : null}
146
+ </SheetPrimitive.Content>
147
+ </SheetPortal>
148
+ ),
149
+ );
74
150
  SheetContent.displayName = SheetPrimitive.Content.displayName;
75
151
 
76
152
  const SheetHeader = ({
@@ -79,7 +155,7 @@ const SheetHeader = ({
79
155
  }: React.HTMLAttributes<HTMLDivElement>) => (
80
156
  <div
81
157
  className={cn(
82
- 'flex flex-col space-y-2 text-center sm:text-left',
158
+ 'flex items-center justify-between border-b border-border px-6 py-4',
83
159
  className,
84
160
  )}
85
161
  {...props}
@@ -93,7 +169,7 @@ const SheetFooter = ({
93
169
  }: React.HTMLAttributes<HTMLDivElement>) => (
94
170
  <div
95
171
  className={cn(
96
- 'flex flex-col-reverse gap-2 sm:flex-row sm:justify-end sm:gap-2',
172
+ 'flex items-center justify-end gap-2 border-t border-border px-6 py-4',
97
173
  className,
98
174
  )}
99
175
  {...props}
@@ -101,12 +177,21 @@ const SheetFooter = ({
101
177
  );
102
178
  SheetFooter.displayName = 'SheetFooter';
103
179
 
180
+ const SheetBody = ({
181
+ className,
182
+ ...props
183
+ }: React.HTMLAttributes<HTMLDivElement>) => (
184
+ <div className={cn('flex-1 overflow-auto px-6 py-4', className)} {...props} />
185
+ );
186
+ SheetBody.displayName = 'SheetBody';
187
+
104
188
  const SheetTitle = React.forwardRef<
105
189
  React.ElementRef<typeof SheetPrimitive.Title>,
106
190
  React.ComponentPropsWithoutRef<typeof SheetPrimitive.Title>
107
191
  >(({ className, ...props }, ref) => (
108
192
  <SheetPrimitive.Title
109
193
  ref={ref}
194
+ data-slot="sheet-title"
110
195
  className={cn('text-lg font-semibold text-foreground', className)}
111
196
  {...props}
112
197
  />
@@ -119,7 +204,7 @@ const SheetDescription = React.forwardRef<
119
204
  >(({ className, ...props }, ref) => (
120
205
  <SheetPrimitive.Description
121
206
  ref={ref}
122
- className={cn('text-sm text-muted-foreground', className)}
207
+ className={cn('text-xs text-muted-foreground', className)}
123
208
  {...props}
124
209
  />
125
210
  ));
@@ -133,7 +218,9 @@ export {
133
218
  SheetClose,
134
219
  SheetContent,
135
220
  SheetHeader,
221
+ SheetBody,
136
222
  SheetFooter,
137
223
  SheetTitle,
138
224
  SheetDescription,
225
+ sheetContentVariants,
139
226
  };