@teamix-evo/ui 0.3.0 → 0.5.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.
- package/README.md +46 -50
- package/manifest.json +420 -647
- package/package.json +15 -34
- package/src/_design-system/theme-tokens/stories.tsx +1474 -0
- package/src/components/accordion/index.tsx +139 -0
- package/src/components/accordion/meta.md +162 -0
- package/src/components/accordion/stories.tsx +145 -0
- package/src/components/affix/index.tsx +149 -0
- package/src/components/affix/meta.md +23 -0
- package/src/components/affix/stories.tsx +70 -0
- package/src/components/alert/index.tsx +220 -0
- package/src/components/alert/meta.md +133 -0
- package/src/components/alert/stories.tsx +126 -0
- package/src/components/alert-dialog/index.tsx +282 -0
- package/src/components/alert-dialog/meta.md +86 -0
- package/src/components/alert-dialog/stories.tsx +163 -0
- package/src/components/avatar/index.tsx +159 -0
- package/src/components/avatar/meta.md +242 -0
- package/src/components/avatar/stories.tsx +241 -0
- package/src/components/badge/index.tsx +299 -0
- package/src/components/badge/meta.md +237 -0
- package/src/components/badge/stories.tsx +275 -0
- package/src/components/breadcrumb/index.tsx +137 -0
- package/src/components/breadcrumb/meta.md +64 -0
- package/src/components/breadcrumb/stories.tsx +86 -0
- package/src/components/button/index.tsx +202 -0
- package/src/components/button/meta.md +209 -0
- package/src/components/button/stories.tsx +215 -0
- package/src/components/button-group/index.tsx +211 -0
- package/src/components/button-group/meta.md +190 -0
- package/src/components/button-group/stories.tsx +182 -0
- package/src/components/calendar/index.tsx +240 -0
- package/src/components/calendar/meta.md +36 -0
- package/src/components/calendar/stories.tsx +36 -0
- package/src/components/card/index.tsx +262 -0
- package/src/components/card/meta.md +194 -0
- package/src/components/card/stories.tsx +202 -0
- package/src/components/carousel/index.tsx +481 -0
- package/src/components/carousel/meta.md +208 -0
- package/src/components/carousel/stories.tsx +271 -0
- package/src/components/cascader-select/index.tsx +308 -0
- package/src/components/cascader-select/meta.md +28 -0
- package/src/components/cascader-select/stories.tsx +118 -0
- package/src/components/checkbox/index.tsx +208 -0
- package/src/components/checkbox/meta.md +166 -0
- package/src/components/checkbox/stories.tsx +206 -0
- package/src/components/collapsible/index.tsx +72 -0
- package/src/components/collapsible/meta.md +87 -0
- package/src/components/collapsible/stories.tsx +97 -0
- package/src/components/color-picker/index.tsx +677 -0
- package/src/components/color-picker/meta.md +83 -0
- package/src/components/color-picker/stories.tsx +172 -0
- package/src/components/combobox/index.tsx +687 -0
- package/src/components/combobox/meta.md +83 -0
- package/src/components/combobox/stories.tsx +179 -0
- package/src/components/command/index.tsx +238 -0
- package/src/components/command/meta.md +48 -0
- package/src/components/command/stories.tsx +83 -0
- package/src/components/data-table/index.tsx +1537 -0
- package/src/components/data-table/meta.md +107 -0
- package/src/components/data-table/stories.tsx +1234 -0
- package/src/components/date-picker/index.tsx +1492 -0
- package/src/components/date-picker/meta.md +103 -0
- package/src/components/date-picker/stories.tsx +125 -0
- package/src/components/descriptions/index.tsx +535 -0
- package/src/components/descriptions/meta.md +104 -0
- package/src/components/descriptions/stories.tsx +389 -0
- package/src/components/dialog/index.tsx +255 -0
- package/src/components/dialog/meta.md +244 -0
- package/src/components/dialog/stories.tsx +330 -0
- package/src/components/dropdown-menu/index.tsx +301 -0
- package/src/components/dropdown-menu/meta.md +93 -0
- package/src/components/dropdown-menu/stories.tsx +124 -0
- package/src/components/empty/index.tsx +431 -0
- package/src/components/empty/meta.md +274 -0
- package/src/components/empty/stories.tsx +278 -0
- package/src/components/field/index.tsx +374 -0
- package/src/components/field/meta.md +283 -0
- package/src/components/field/stories.tsx +327 -0
- package/src/components/filter-bar/index.tsx +976 -0
- package/src/components/filter-bar/meta.md +57 -0
- package/src/components/filter-bar/stories.tsx +496 -0
- package/src/components/float-button/index.tsx +163 -0
- package/src/components/float-button/meta.md +73 -0
- package/src/components/float-button/stories.tsx +68 -0
- package/src/components/form/index.tsx +218 -0
- package/src/components/form/meta.md +16 -0
- package/src/components/form/stories.tsx +301 -0
- package/src/components/hover-card/index.tsx +103 -0
- package/src/components/hover-card/meta.md +71 -0
- package/src/components/hover-card/stories.tsx +107 -0
- package/src/components/icon/index.tsx +225 -0
- package/src/components/icon/meta.md +102 -0
- package/src/components/icon/stories.tsx +127 -0
- package/src/components/image/index.tsx +147 -0
- package/src/components/image/meta.md +55 -0
- package/src/components/image/stories.tsx +48 -0
- package/src/components/input/index.tsx +63 -0
- package/src/components/input/meta.md +57 -0
- package/src/components/input/stories.tsx +66 -0
- package/src/components/input-group/index.tsx +292 -0
- package/src/components/input-group/meta.md +108 -0
- package/src/components/input-group/stories.tsx +258 -0
- package/src/components/input-ip/index.tsx +288 -0
- package/src/components/input-ip/meta.md +48 -0
- package/src/components/input-ip/stories.tsx +69 -0
- package/src/components/input-number/index.tsx +360 -0
- package/src/components/input-number/meta.md +156 -0
- package/src/components/input-number/stories.tsx +187 -0
- package/src/components/item/index.tsx +368 -0
- package/src/components/item/meta.md +395 -0
- package/src/components/item/stories.tsx +432 -0
- package/src/components/label/index.tsx +44 -0
- package/src/components/label/meta.md +68 -0
- package/src/components/label/stories.tsx +64 -0
- package/src/components/mentions/index.tsx +369 -0
- package/src/components/mentions/meta.md +118 -0
- package/src/components/mentions/stories.tsx +153 -0
- package/src/components/menubar/index.tsx +313 -0
- package/src/components/menubar/meta.md +52 -0
- package/src/components/menubar/stories.tsx +99 -0
- package/src/components/navigation-menu/index.tsx +216 -0
- package/src/components/navigation-menu/meta.md +66 -0
- package/src/components/navigation-menu/stories.tsx +137 -0
- package/src/components/page-header/index.tsx +218 -0
- package/src/components/page-header/meta.md +211 -0
- package/src/components/page-header/stories.tsx +290 -0
- package/src/components/page-shell/index.tsx +119 -0
- package/src/components/page-shell/meta.md +115 -0
- package/src/components/page-shell/stories.tsx +154 -0
- package/src/components/pagination/index.tsx +580 -0
- package/src/components/pagination/meta.md +39 -0
- package/src/components/pagination/stories.tsx +319 -0
- package/src/components/popconfirm/index.tsx +477 -0
- package/src/components/popconfirm/meta.md +164 -0
- package/src/components/popconfirm/stories.tsx +231 -0
- package/src/components/popover/index.tsx +181 -0
- package/src/components/popover/meta.md +97 -0
- package/src/components/popover/stories.tsx +169 -0
- package/src/components/progress/index.tsx +176 -0
- package/src/components/progress/meta.md +95 -0
- package/src/components/progress/stories.tsx +115 -0
- package/src/components/radio-group/index.tsx +78 -0
- package/src/components/radio-group/meta.md +137 -0
- package/src/components/radio-group/stories.tsx +285 -0
- package/src/components/rate/index.tsx +284 -0
- package/src/components/rate/meta.md +63 -0
- package/src/components/rate/stories.tsx +107 -0
- package/src/components/resizable/index.tsx +122 -0
- package/src/components/resizable/meta.md +142 -0
- package/src/components/resizable/stories.tsx +105 -0
- package/src/components/scroll-area/index.tsx +83 -0
- package/src/components/scroll-area/meta.md +85 -0
- package/src/components/scroll-area/stories.tsx +82 -0
- package/src/components/select/index.tsx +325 -0
- package/src/components/select/meta.md +183 -0
- package/src/components/select/stories.tsx +210 -0
- package/src/components/separator/index.tsx +51 -0
- package/src/components/separator/meta.md +68 -0
- package/src/components/separator/stories.tsx +53 -0
- package/src/components/sheet/index.tsx +293 -0
- package/src/components/sheet/meta.md +226 -0
- package/src/components/sheet/stories.tsx +405 -0
- package/src/components/sidebar/index.tsx +715 -0
- package/src/components/sidebar/meta.md +14 -0
- package/src/components/sidebar/{sidebar.stories.tsx → stories.tsx} +250 -330
- package/src/components/skeleton/index.tsx +415 -0
- package/src/components/skeleton/meta.md +210 -0
- package/src/components/skeleton/stories.tsx +197 -0
- package/src/components/slider/index.tsx +222 -0
- package/src/components/slider/meta.md +125 -0
- package/src/components/slider/stories.tsx +109 -0
- package/src/components/sonner/index.tsx +149 -0
- package/src/components/sonner/meta.md +156 -0
- package/src/components/sonner/stories.tsx +285 -0
- package/src/components/spinner/index.tsx +335 -0
- package/src/components/spinner/meta.md +172 -0
- package/src/components/spinner/stories.tsx +197 -0
- package/src/components/statistic/{statistic.tsx → index.tsx} +25 -26
- package/src/components/statistic/meta.md +94 -0
- package/src/components/statistic/stories.tsx +85 -0
- package/src/components/steps/index.tsx +500 -0
- package/src/components/steps/meta.md +245 -0
- package/src/components/steps/stories.tsx +287 -0
- package/src/components/switch/index.tsx +175 -0
- package/src/components/switch/meta.md +107 -0
- package/src/components/switch/stories.tsx +154 -0
- package/src/components/table/index.tsx +350 -0
- package/src/components/table/meta.md +148 -0
- package/src/components/table/stories.tsx +189 -0
- package/src/components/tabs/index.tsx +379 -0
- package/src/components/tabs/meta.md +244 -0
- package/src/components/tabs/stories.tsx +312 -0
- package/src/components/tag/index.tsx +774 -0
- package/src/components/tag/meta.md +256 -0
- package/src/components/tag/stories.tsx +431 -0
- package/src/components/textarea/index.tsx +62 -0
- package/src/components/textarea/meta.md +77 -0
- package/src/components/textarea/stories.tsx +112 -0
- package/src/components/time-picker/index.tsx +887 -0
- package/src/components/time-picker/meta.md +102 -0
- package/src/components/time-picker/stories.tsx +125 -0
- package/src/components/timeline/index.tsx +422 -0
- package/src/components/timeline/meta.md +352 -0
- package/src/components/timeline/stories.tsx +369 -0
- package/src/components/toggle/index.tsx +74 -0
- package/src/components/toggle/meta.md +76 -0
- package/src/components/toggle/stories.tsx +66 -0
- package/src/components/toggle-group/index.tsx +167 -0
- package/src/components/toggle-group/meta.md +141 -0
- package/src/components/toggle-group/stories.tsx +124 -0
- package/src/components/tooltip/index.tsx +144 -0
- package/src/components/tooltip/meta.md +186 -0
- package/src/components/tooltip/stories.tsx +212 -0
- package/src/components/transfer/index.tsx +639 -0
- package/src/components/transfer/meta.md +76 -0
- package/src/components/transfer/stories.tsx +221 -0
- package/src/components/tree/index.tsx +764 -0
- package/src/components/tree/meta.md +96 -0
- package/src/components/tree/stories.tsx +385 -0
- package/src/components/tree/utils.ts +269 -0
- package/src/components/tree-select/index.tsx +400 -0
- package/src/components/tree-select/meta.md +78 -0
- package/src/components/tree-select/stories.tsx +234 -0
- package/src/components/typography/index.tsx +290 -0
- package/src/components/typography/meta.md +151 -0
- package/src/components/typography/stories.tsx +151 -0
- package/src/components/upload/index.tsx +858 -0
- package/src/components/upload/meta.md +122 -0
- package/src/components/upload/stories.tsx +261 -0
- package/src/components/watermark/index.tsx +152 -0
- package/src/components/watermark/meta.md +67 -0
- package/src/components/watermark/stories.tsx +59 -0
- package/src/hooks/use-mobile.ts +9 -11
- package/src/lib/color.ts +243 -0
- package/src/{utils/cn.ts → lib/utils.ts} +1 -1
- package/src/components/accordion/accordion.meta.md +0 -88
- package/src/components/accordion/accordion.stories.tsx +0 -72
- package/src/components/accordion/accordion.tsx +0 -154
- package/src/components/affix/affix.meta.md +0 -98
- package/src/components/affix/affix.stories.tsx +0 -134
- package/src/components/affix/affix.tsx +0 -167
- package/src/components/alert/alert.meta.md +0 -132
- package/src/components/alert/alert.stories.tsx +0 -138
- package/src/components/alert/alert.tsx +0 -179
- package/src/components/alert-dialog/alert-dialog.meta.md +0 -152
- package/src/components/alert-dialog/alert-dialog.stories.tsx +0 -223
- package/src/components/alert-dialog/alert-dialog.tsx +0 -183
- package/src/components/anchor/anchor.meta.md +0 -92
- package/src/components/anchor/anchor.stories.tsx +0 -74
- package/src/components/anchor/anchor.tsx +0 -130
- package/src/components/app/app.meta.md +0 -91
- package/src/components/app/app.stories.tsx +0 -64
- package/src/components/app/app.tsx +0 -58
- package/src/components/aspect-ratio/aspect-ratio.meta.md +0 -82
- package/src/components/aspect-ratio/aspect-ratio.stories.tsx +0 -59
- package/src/components/aspect-ratio/aspect-ratio.tsx +0 -22
- package/src/components/auto-complete/auto-complete.meta.md +0 -110
- package/src/components/auto-complete/auto-complete.stories.tsx +0 -136
- package/src/components/auto-complete/auto-complete.tsx +0 -253
- package/src/components/avatar/avatar.meta.md +0 -93
- package/src/components/avatar/avatar.stories.tsx +0 -98
- package/src/components/avatar/avatar.tsx +0 -127
- package/src/components/badge/badge.meta.md +0 -120
- package/src/components/badge/badge.stories.tsx +0 -153
- package/src/components/badge/badge.tsx +0 -204
- package/src/components/breadcrumb/breadcrumb.meta.md +0 -127
- package/src/components/breadcrumb/breadcrumb.stories.tsx +0 -207
- package/src/components/breadcrumb/breadcrumb.tsx +0 -136
- package/src/components/button/button.meta.md +0 -335
- package/src/components/button/button.stories.tsx +0 -743
- package/src/components/button/button.tsx +0 -462
- package/src/components/button/demo/as-child.tsx +0 -24
- package/src/components/button/demo/basic.tsx +0 -8
- package/src/components/button/demo/block.tsx +0 -16
- package/src/components/button/demo/loading.tsx +0 -19
- package/src/components/button/demo/shapes.tsx +0 -18
- package/src/components/button/demo/sizes.tsx +0 -19
- package/src/components/button/demo/variants.tsx +0 -19
- package/src/components/button/demo/with-icon.tsx +0 -20
- package/src/components/calendar/calendar.meta.md +0 -128
- package/src/components/calendar/calendar.stories.tsx +0 -68
- package/src/components/calendar/calendar.tsx +0 -172
- package/src/components/card/card.meta.md +0 -139
- package/src/components/card/card.stories.tsx +0 -151
- package/src/components/card/card.tsx +0 -305
- package/src/components/carousel/carousel.meta.md +0 -118
- package/src/components/carousel/carousel.stories.tsx +0 -89
- package/src/components/carousel/carousel.tsx +0 -224
- package/src/components/cascader/cascader.meta.md +0 -140
- package/src/components/cascader/cascader.stories.tsx +0 -120
- package/src/components/cascader/cascader.tsx +0 -541
- package/src/components/checkbox/checkbox.meta.md +0 -167
- package/src/components/checkbox/checkbox.stories.tsx +0 -288
- package/src/components/checkbox/checkbox.tsx +0 -193
- package/src/components/collapsible/collapsible.meta.md +0 -88
- package/src/components/collapsible/collapsible.stories.tsx +0 -43
- package/src/components/collapsible/collapsible.tsx +0 -105
- package/src/components/color-picker/color-picker.meta.md +0 -89
- package/src/components/color-picker/color-picker.stories.tsx +0 -159
- package/src/components/color-picker/color-picker.tsx +0 -171
- package/src/components/command/command.meta.md +0 -120
- package/src/components/command/command.stories.tsx +0 -59
- package/src/components/command/command.tsx +0 -158
- package/src/components/context-menu/context-menu.meta.md +0 -93
- package/src/components/context-menu/context-menu.stories.tsx +0 -54
- package/src/components/context-menu/context-menu.tsx +0 -204
- package/src/components/data-table/data-table.meta.md +0 -150
- package/src/components/data-table/data-table.stories.tsx +0 -132
- package/src/components/data-table/data-table.tsx +0 -185
- package/src/components/date-picker/date-picker.meta.md +0 -175
- package/src/components/date-picker/date-picker.stories.tsx +0 -108
- package/src/components/date-picker/date-picker.tsx +0 -1554
- package/src/components/descriptions/descriptions.meta.md +0 -83
- package/src/components/descriptions/descriptions.stories.tsx +0 -60
- package/src/components/descriptions/descriptions.tsx +0 -137
- package/src/components/dialog/dialog.meta.md +0 -168
- package/src/components/dialog/dialog.stories.tsx +0 -255
- package/src/components/dialog/dialog.tsx +0 -180
- package/src/components/dialog/imperative.tsx +0 -252
- package/src/components/drawer/drawer.meta.md +0 -95
- package/src/components/drawer/drawer.stories.tsx +0 -71
- package/src/components/drawer/drawer.tsx +0 -23
- package/src/components/dropdown-menu/dropdown-menu.meta.md +0 -171
- package/src/components/dropdown-menu/dropdown-menu.stories.tsx +0 -198
- package/src/components/dropdown-menu/dropdown-menu.tsx +0 -209
- package/src/components/ellipsis/ellipsis.meta.md +0 -87
- package/src/components/ellipsis/ellipsis.stories.tsx +0 -72
- package/src/components/ellipsis/ellipsis.tsx +0 -153
- package/src/components/empty/empty.meta.md +0 -86
- package/src/components/empty/empty.stories.tsx +0 -46
- package/src/components/empty/empty.tsx +0 -54
- package/src/components/field/field.meta.md +0 -154
- package/src/components/field/field.stories.tsx +0 -497
- package/src/components/field/field.tsx +0 -392
- package/src/components/filter-bar/filter-bar.meta.md +0 -92
- package/src/components/filter-bar/filter-bar.stories.tsx +0 -1083
- package/src/components/filter-bar/filter-bar.tsx +0 -568
- package/src/components/flex/flex.meta.md +0 -142
- package/src/components/flex/flex.stories.tsx +0 -199
- package/src/components/flex/flex.tsx +0 -145
- package/src/components/float-button/float-button.meta.md +0 -92
- package/src/components/float-button/float-button.stories.tsx +0 -80
- package/src/components/float-button/float-button.tsx +0 -143
- package/src/components/form/form.meta.md +0 -153
- package/src/components/form/form.stories.tsx +0 -469
- package/src/components/form/form.tsx +0 -260
- package/src/components/grid/grid.meta.md +0 -92
- package/src/components/grid/grid.stories.tsx +0 -101
- package/src/components/grid/grid.tsx +0 -130
- package/src/components/hover-card/hover-card.meta.md +0 -103
- package/src/components/hover-card/hover-card.stories.tsx +0 -97
- package/src/components/hover-card/hover-card.tsx +0 -67
- package/src/components/icon/DEVELOPMENT.md +0 -809
- package/src/components/icon/icon.meta.md +0 -170
- package/src/components/icon/icon.stories.tsx +0 -344
- package/src/components/icon/icon.tsx +0 -248
- package/src/components/image/image.meta.md +0 -99
- package/src/components/image/image.stories.tsx +0 -55
- package/src/components/image/image.tsx +0 -140
- package/src/components/input/demo/basic.tsx +0 -12
- package/src/components/input/demo/clearable.tsx +0 -21
- package/src/components/input/demo/show-count.tsx +0 -18
- package/src/components/input/demo/sizes.tsx +0 -15
- package/src/components/input/input.meta.md +0 -115
- package/src/components/input/input.stories.tsx +0 -144
- package/src/components/input/input.tsx +0 -212
- package/src/components/input-group/input-group.meta.md +0 -124
- package/src/components/input-group/input-group.stories.tsx +0 -121
- package/src/components/input-group/input-group.tsx +0 -143
- package/src/components/input-number/input-number.meta.md +0 -148
- package/src/components/input-number/input-number.stories.tsx +0 -125
- package/src/components/input-number/input-number.tsx +0 -283
- package/src/components/input-otp/input-otp.meta.md +0 -106
- package/src/components/input-otp/input-otp.stories.tsx +0 -65
- package/src/components/input-otp/input-otp.tsx +0 -97
- package/src/components/item/item.meta.md +0 -121
- package/src/components/item/item.stories.tsx +0 -116
- package/src/components/item/item.tsx +0 -172
- package/src/components/kbd/kbd.meta.md +0 -94
- package/src/components/kbd/kbd.stories.tsx +0 -70
- package/src/components/kbd/kbd.tsx +0 -86
- package/src/components/label/label.meta.md +0 -99
- package/src/components/label/label.stories.tsx +0 -145
- package/src/components/label/label.tsx +0 -138
- package/src/components/masonry/masonry.meta.md +0 -90
- package/src/components/masonry/masonry.stories.tsx +0 -68
- package/src/components/masonry/masonry.tsx +0 -60
- package/src/components/mentions/mentions.meta.md +0 -119
- package/src/components/mentions/mentions.stories.tsx +0 -189
- package/src/components/mentions/mentions.tsx +0 -243
- package/src/components/menubar/menubar.meta.md +0 -118
- package/src/components/menubar/menubar.stories.tsx +0 -141
- package/src/components/menubar/menubar.tsx +0 -232
- package/src/components/native-select/native-select.meta.md +0 -93
- package/src/components/native-select/native-select.stories.tsx +0 -83
- package/src/components/native-select/native-select.tsx +0 -54
- package/src/components/navigation-menu/navigation-menu.meta.md +0 -118
- package/src/components/navigation-menu/navigation-menu.stories.tsx +0 -215
- package/src/components/navigation-menu/navigation-menu.tsx +0 -129
- package/src/components/notification/notification.meta.md +0 -133
- package/src/components/notification/notification.stories.tsx +0 -98
- package/src/components/notification/notification.tsx +0 -99
- package/src/components/page-header/DEVELOPMENT.md +0 -842
- package/src/components/page-header/page-header.meta.md +0 -208
- package/src/components/page-header/page-header.stories.tsx +0 -421
- package/src/components/page-header/page-header.tsx +0 -281
- package/src/components/pagination/pagination.meta.md +0 -230
- package/src/components/pagination/pagination.stories.tsx +0 -284
- package/src/components/pagination/pagination.tsx +0 -577
- package/src/components/popconfirm/popconfirm.meta.md +0 -114
- package/src/components/popconfirm/popconfirm.stories.tsx +0 -75
- package/src/components/popconfirm/popconfirm.tsx +0 -134
- package/src/components/popover/popover.meta.md +0 -154
- package/src/components/popover/popover.stories.tsx +0 -158
- package/src/components/popover/popover.tsx +0 -104
- package/src/components/progress/progress.meta.md +0 -118
- package/src/components/progress/progress.stories.tsx +0 -75
- package/src/components/progress/progress.tsx +0 -203
- package/src/components/radio-group/radio-group.meta.md +0 -175
- package/src/components/radio-group/radio-group.stories.tsx +0 -113
- package/src/components/radio-group/radio-group.tsx +0 -209
- package/src/components/rate/rate.meta.md +0 -118
- package/src/components/rate/rate.stories.tsx +0 -89
- package/src/components/rate/rate.tsx +0 -180
- package/src/components/resizable/resizable.meta.md +0 -95
- package/src/components/resizable/resizable.stories.tsx +0 -104
- package/src/components/resizable/resizable.tsx +0 -56
- package/src/components/result/result.meta.md +0 -95
- package/src/components/result/result.stories.tsx +0 -67
- package/src/components/result/result.tsx +0 -100
- package/src/components/scroll-area/scroll-area.meta.md +0 -85
- package/src/components/scroll-area/scroll-area.stories.tsx +0 -49
- package/src/components/scroll-area/scroll-area.tsx +0 -51
- package/src/components/segmented/segmented.meta.md +0 -106
- package/src/components/segmented/segmented.stories.tsx +0 -130
- package/src/components/segmented/segmented.tsx +0 -146
- package/src/components/select/select.meta.md +0 -255
- package/src/components/select/select.stories.tsx +0 -275
- package/src/components/select/select.tsx +0 -735
- package/src/components/separator/separator.meta.md +0 -75
- package/src/components/separator/separator.stories.tsx +0 -71
- package/src/components/separator/separator.tsx +0 -100
- package/src/components/sheet/sheet.meta.md +0 -113
- package/src/components/sheet/sheet.stories.tsx +0 -188
- package/src/components/sheet/sheet.tsx +0 -226
- package/src/components/sidebar/sidebar.meta.md +0 -150
- package/src/components/sidebar/sidebar.tsx +0 -824
- package/src/components/skeleton/skeleton.meta.md +0 -94
- package/src/components/skeleton/skeleton.stories.tsx +0 -79
- package/src/components/skeleton/skeleton.tsx +0 -144
- package/src/components/slider/slider.meta.md +0 -146
- package/src/components/slider/slider.stories.tsx +0 -121
- package/src/components/slider/slider.tsx +0 -227
- package/src/components/sonner/sonner.meta.md +0 -147
- package/src/components/sonner/sonner.stories.tsx +0 -164
- package/src/components/sonner/sonner.tsx +0 -169
- package/src/components/spinner/spinner.meta.md +0 -125
- package/src/components/spinner/spinner.stories.tsx +0 -123
- package/src/components/spinner/spinner.tsx +0 -166
- package/src/components/statistic/statistic.meta.md +0 -104
- package/src/components/statistic/statistic.stories.tsx +0 -67
- package/src/components/steps/steps.meta.md +0 -116
- package/src/components/steps/steps.stories.tsx +0 -115
- package/src/components/steps/steps.tsx +0 -173
- package/src/components/switch/switch.meta.md +0 -138
- package/src/components/switch/switch.stories.tsx +0 -75
- package/src/components/switch/switch.tsx +0 -169
- package/src/components/table/table.meta.md +0 -106
- package/src/components/table/table.stories.tsx +0 -80
- package/src/components/table/table.tsx +0 -122
- package/src/components/tabs/tabs.meta.md +0 -111
- package/src/components/tabs/tabs.stories.tsx +0 -156
- package/src/components/tabs/tabs.tsx +0 -190
- package/src/components/tag/tag.meta.md +0 -159
- package/src/components/tag/tag.stories.tsx +0 -250
- package/src/components/tag/tag.tsx +0 -386
- package/src/components/textarea/textarea.meta.md +0 -99
- package/src/components/textarea/textarea.stories.tsx +0 -89
- package/src/components/textarea/textarea.tsx +0 -137
- package/src/components/time-picker/time-picker.meta.md +0 -175
- package/src/components/time-picker/time-picker.stories.tsx +0 -129
- package/src/components/time-picker/time-picker.tsx +0 -946
- package/src/components/timeline/timeline.meta.md +0 -110
- package/src/components/timeline/timeline.stories.tsx +0 -134
- package/src/components/timeline/timeline.tsx +0 -168
- package/src/components/toggle/toggle.meta.md +0 -89
- package/src/components/toggle/toggle.stories.tsx +0 -66
- package/src/components/toggle/toggle.tsx +0 -54
- package/src/components/toggle-group/toggle-group.meta.md +0 -91
- package/src/components/toggle-group/toggle-group.stories.tsx +0 -83
- package/src/components/toggle-group/toggle-group.tsx +0 -78
- package/src/components/tooltip/tooltip.meta.md +0 -149
- package/src/components/tooltip/tooltip.stories.tsx +0 -108
- package/src/components/tooltip/tooltip.tsx +0 -153
- package/src/components/tour/tour.meta.md +0 -121
- package/src/components/tour/tour.stories.tsx +0 -66
- package/src/components/tour/tour.tsx +0 -242
- package/src/components/transfer/transfer.meta.md +0 -95
- package/src/components/transfer/transfer.stories.tsx +0 -64
- package/src/components/transfer/transfer.tsx +0 -258
- package/src/components/tree/tree.meta.md +0 -169
- package/src/components/tree/tree.stories.tsx +0 -128
- package/src/components/tree/tree.tsx +0 -368
- package/src/components/tree-select/tree-select.meta.md +0 -151
- package/src/components/tree-select/tree-select.stories.tsx +0 -80
- package/src/components/tree-select/tree-select.tsx +0 -206
- package/src/components/typography/typography.meta.md +0 -149
- package/src/components/typography/typography.stories.tsx +0 -116
- package/src/components/typography/typography.tsx +0 -260
- package/src/components/upload/upload.meta.md +0 -156
- package/src/components/upload/upload.stories.tsx +0 -135
- package/src/components/upload/upload.tsx +0 -398
- package/src/components/watermark/watermark.meta.md +0 -100
- package/src/components/watermark/watermark.stories.tsx +0 -170
- package/src/components/watermark/watermark.tsx +0 -166
- package/src/hooks/use-breakpoint.ts +0 -117
- package/src/hooks/use-debounce-callback.ts +0 -52
- package/src/stories/theme-tokens.stories.tsx +0 -747
- package/src/utils/trigger-input.ts +0 -53
|
@@ -0,0 +1,335 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* 加载指示器 Spinner
|
|
3
|
+
*
|
|
4
|
+
* shadcn v4 composable 套件:原子 Spinner + SpinnerTip 文案 + SpinnerOverlay 包裹遮罩 + SpinnerFullscreen 全屏遮罩。
|
|
5
|
+
* 对齐 cloud-design Loading 的能力(visible / tip / tipAlign / indicator / inline / 100ms 防闪 / fullScreen / Esc 关闭)。
|
|
6
|
+
*
|
|
7
|
+
* @when
|
|
8
|
+
* - 按钮 / Trigger / 单元格内的行内 loading 反馈
|
|
9
|
+
* - 局部内容区在异步加载时的遮罩态(包裹模式 + 100ms 防闪)
|
|
10
|
+
* - 关键操作(提交、保存)时的全屏阻断态(带 Esc 关闭)
|
|
11
|
+
*
|
|
12
|
+
* 组合结构:SpinnerOverlay > children + SpinnerOverlayMask > Spinner + SpinnerTip
|
|
13
|
+
*/
|
|
14
|
+
|
|
15
|
+
import * as React from 'react';
|
|
16
|
+
import { createPortal } from 'react-dom';
|
|
17
|
+
import { cva, type VariantProps } from 'class-variance-authority';
|
|
18
|
+
import { Loader2Icon } from 'lucide-react';
|
|
19
|
+
|
|
20
|
+
import { cn } from '@/lib/utils';
|
|
21
|
+
|
|
22
|
+
/* ────────────────────────────────────────────────────────────────────────── */
|
|
23
|
+
/* Spinner(原子) */
|
|
24
|
+
/* ────────────────────────────────────────────────────────────────────────── */
|
|
25
|
+
|
|
26
|
+
const spinnerVariants = cva('shrink-0 animate-spin', {
|
|
27
|
+
variants: {
|
|
28
|
+
size: {
|
|
29
|
+
xs: 'size-3',
|
|
30
|
+
sm: 'size-3.5',
|
|
31
|
+
md: 'size-4',
|
|
32
|
+
lg: 'size-5',
|
|
33
|
+
},
|
|
34
|
+
tone: {
|
|
35
|
+
default: 'text-current',
|
|
36
|
+
primary: 'text-primary',
|
|
37
|
+
inverse: 'text-primary-foreground',
|
|
38
|
+
muted: 'text-muted-foreground',
|
|
39
|
+
},
|
|
40
|
+
},
|
|
41
|
+
defaultVariants: {
|
|
42
|
+
tone: 'default',
|
|
43
|
+
},
|
|
44
|
+
});
|
|
45
|
+
|
|
46
|
+
export interface SpinnerProps
|
|
47
|
+
extends Omit<React.ComponentProps<'svg'>, 'children'>,
|
|
48
|
+
VariantProps<typeof spinnerVariants> {
|
|
49
|
+
/** sr-only 读屏文本,默认 `加载中`;如父级已有可见 tip 可置空 */
|
|
50
|
+
label?: string;
|
|
51
|
+
}
|
|
52
|
+
|
|
53
|
+
/**
|
|
54
|
+
* 原子旋转指示符。size 不传时由父级 svg utility 决定(兼容 Button `[&_svg]:size-4` 链路)。
|
|
55
|
+
*/
|
|
56
|
+
function Spinner({
|
|
57
|
+
className,
|
|
58
|
+
size,
|
|
59
|
+
tone,
|
|
60
|
+
label = '加载中',
|
|
61
|
+
...props
|
|
62
|
+
}: SpinnerProps) {
|
|
63
|
+
return (
|
|
64
|
+
<span
|
|
65
|
+
data-slot="spinner-root"
|
|
66
|
+
role="status"
|
|
67
|
+
aria-live="polite"
|
|
68
|
+
className="inline-flex shrink-0 items-center justify-center"
|
|
69
|
+
>
|
|
70
|
+
<Loader2Icon
|
|
71
|
+
data-slot="spinner"
|
|
72
|
+
data-size={size}
|
|
73
|
+
data-tone={tone ?? 'default'}
|
|
74
|
+
aria-hidden="true"
|
|
75
|
+
className={cn(spinnerVariants({ size, tone }), className)}
|
|
76
|
+
{...props}
|
|
77
|
+
/>
|
|
78
|
+
{label ? <span className="sr-only">{label}</span> : null}
|
|
79
|
+
</span>
|
|
80
|
+
);
|
|
81
|
+
}
|
|
82
|
+
|
|
83
|
+
/* ────────────────────────────────────────────────────────────────────────── */
|
|
84
|
+
/* SpinnerTip(文案) */
|
|
85
|
+
/* ────────────────────────────────────────────────────────────────────────── */
|
|
86
|
+
|
|
87
|
+
/**
|
|
88
|
+
* Spinner 的文字提示,常与原子 Spinner 同行展示,或作为 SpinnerOverlay/Fullscreen 的内置 tip 节点。
|
|
89
|
+
*/
|
|
90
|
+
function SpinnerTip({ className, ...props }: React.ComponentProps<'span'>) {
|
|
91
|
+
return (
|
|
92
|
+
<span
|
|
93
|
+
data-slot="spinner-tip"
|
|
94
|
+
className={cn('text-xs text-muted-foreground', className)}
|
|
95
|
+
{...props}
|
|
96
|
+
/>
|
|
97
|
+
);
|
|
98
|
+
}
|
|
99
|
+
|
|
100
|
+
/* ────────────────────────────────────────────────────────────────────────── */
|
|
101
|
+
/* visibility hook(100ms 防闪) */
|
|
102
|
+
/* ────────────────────────────────────────────────────────────────────────── */
|
|
103
|
+
|
|
104
|
+
function useDelayedVisible(visible: boolean, delay: number): boolean {
|
|
105
|
+
const [shown, setShown] = React.useState(visible && delay <= 0);
|
|
106
|
+
const timerRef = React.useRef<ReturnType<typeof setTimeout> | null>(null);
|
|
107
|
+
|
|
108
|
+
React.useEffect(() => {
|
|
109
|
+
if (timerRef.current) {
|
|
110
|
+
clearTimeout(timerRef.current);
|
|
111
|
+
timerRef.current = null;
|
|
112
|
+
}
|
|
113
|
+
if (!visible) {
|
|
114
|
+
setShown(false);
|
|
115
|
+
return;
|
|
116
|
+
}
|
|
117
|
+
if (delay <= 0) {
|
|
118
|
+
setShown(true);
|
|
119
|
+
return;
|
|
120
|
+
}
|
|
121
|
+
timerRef.current = setTimeout(() => {
|
|
122
|
+
setShown(true);
|
|
123
|
+
timerRef.current = null;
|
|
124
|
+
}, delay);
|
|
125
|
+
return () => {
|
|
126
|
+
if (timerRef.current) {
|
|
127
|
+
clearTimeout(timerRef.current);
|
|
128
|
+
timerRef.current = null;
|
|
129
|
+
}
|
|
130
|
+
};
|
|
131
|
+
}, [visible, delay]);
|
|
132
|
+
|
|
133
|
+
return shown;
|
|
134
|
+
}
|
|
135
|
+
|
|
136
|
+
/* ────────────────────────────────────────────────────────────────────────── */
|
|
137
|
+
/* SpinnerOverlay(包裹模式) */
|
|
138
|
+
/* ────────────────────────────────────────────────────────────────────────── */
|
|
139
|
+
|
|
140
|
+
const OVERLAY_INDICATOR_SIZE: Record<
|
|
141
|
+
NonNullable<SpinnerOverlayProps['size']>,
|
|
142
|
+
NonNullable<SpinnerProps['size']>
|
|
143
|
+
> = {
|
|
144
|
+
sm: 'sm',
|
|
145
|
+
md: 'md',
|
|
146
|
+
lg: 'lg',
|
|
147
|
+
};
|
|
148
|
+
|
|
149
|
+
export interface SpinnerOverlayProps extends React.ComponentProps<'div'> {
|
|
150
|
+
/** loading 状态,默认 true。从 false→true 切换会延迟 `delay` 毫秒后显示,避免短任务闪烁 */
|
|
151
|
+
visible?: boolean;
|
|
152
|
+
/** 显示延迟(ms),默认 100;设为 0 关闭防闪 */
|
|
153
|
+
delay?: number;
|
|
154
|
+
/** 文字提示,与 indicator 一起展示在遮罩中央 */
|
|
155
|
+
tip?: React.ReactNode;
|
|
156
|
+
/** tip 与 indicator 的相对位置,默认 `bottom` */
|
|
157
|
+
tipAlign?: 'right' | 'bottom';
|
|
158
|
+
/** 自定义 indicator,默认 `<Spinner size={size} tone="primary" />` */
|
|
159
|
+
indicator?: React.ReactNode;
|
|
160
|
+
/** 默认 indicator 的尺寸(仅在未传 indicator 时生效),默认 `lg` */
|
|
161
|
+
size?: 'sm' | 'md' | 'lg';
|
|
162
|
+
/** 容器布局:`true` 为 inline-block,`false` 为 block 通栏,默认 `true` */
|
|
163
|
+
inline?: boolean;
|
|
164
|
+
/** 遮罩生效时是否对 children 做模糊处理,默认 `true`(对齐 cloud-design hybridcloud blur 视觉) */
|
|
165
|
+
blur?: boolean;
|
|
166
|
+
}
|
|
167
|
+
|
|
168
|
+
/**
|
|
169
|
+
* 包裹子内容的 loading 遮罩。`visible` 为 true 时叠加半透明遮罩 + 内容模糊 + 指示符;
|
|
170
|
+
* 内置 100ms 显示防闪与 `aria-busy` 同步。
|
|
171
|
+
*/
|
|
172
|
+
function SpinnerOverlay({
|
|
173
|
+
visible = true,
|
|
174
|
+
delay = 100,
|
|
175
|
+
tip,
|
|
176
|
+
tipAlign = 'bottom',
|
|
177
|
+
indicator,
|
|
178
|
+
size = 'lg',
|
|
179
|
+
inline = true,
|
|
180
|
+
blur = true,
|
|
181
|
+
className,
|
|
182
|
+
children,
|
|
183
|
+
...props
|
|
184
|
+
}: SpinnerOverlayProps) {
|
|
185
|
+
const shown = useDelayedVisible(visible, delay);
|
|
186
|
+
|
|
187
|
+
return (
|
|
188
|
+
<div
|
|
189
|
+
data-slot="spinner-overlay"
|
|
190
|
+
data-visible={shown || undefined}
|
|
191
|
+
data-tip-align={tipAlign}
|
|
192
|
+
data-inline={inline || undefined}
|
|
193
|
+
aria-busy={shown || undefined}
|
|
194
|
+
className={cn('relative', inline ? 'inline-block' : 'block', className)}
|
|
195
|
+
{...props}
|
|
196
|
+
>
|
|
197
|
+
<div
|
|
198
|
+
data-slot="spinner-overlay-content"
|
|
199
|
+
className={cn(
|
|
200
|
+
'transition-[filter] duration-200',
|
|
201
|
+
shown && blur && 'blur-[2px]',
|
|
202
|
+
shown && 'pointer-events-none select-none',
|
|
203
|
+
)}
|
|
204
|
+
>
|
|
205
|
+
{children}
|
|
206
|
+
</div>
|
|
207
|
+
{shown ? (
|
|
208
|
+
<SpinnerOverlayMask tipAlign={tipAlign}>
|
|
209
|
+
{indicator ?? (
|
|
210
|
+
<Spinner size={OVERLAY_INDICATOR_SIZE[size]} tone="primary" />
|
|
211
|
+
)}
|
|
212
|
+
{tip != null && tip !== false ? <SpinnerTip>{tip}</SpinnerTip> : null}
|
|
213
|
+
</SpinnerOverlayMask>
|
|
214
|
+
) : null}
|
|
215
|
+
</div>
|
|
216
|
+
);
|
|
217
|
+
}
|
|
218
|
+
|
|
219
|
+
/**
|
|
220
|
+
* SpinnerOverlay 的内部遮罩层,覆盖父容器并居中渲染 indicator + tip。
|
|
221
|
+
* 通常无需直接使用;如需完全自定义遮罩内容,可自行组合 Spinner + SpinnerTip。
|
|
222
|
+
*/
|
|
223
|
+
function SpinnerOverlayMask({
|
|
224
|
+
tipAlign = 'bottom',
|
|
225
|
+
className,
|
|
226
|
+
children,
|
|
227
|
+
...props
|
|
228
|
+
}: React.ComponentProps<'div'> & { tipAlign?: 'right' | 'bottom' }) {
|
|
229
|
+
return (
|
|
230
|
+
<div
|
|
231
|
+
data-slot="spinner-overlay-mask"
|
|
232
|
+
data-tip-align={tipAlign}
|
|
233
|
+
className={cn(
|
|
234
|
+
'absolute inset-0 z-10 flex items-center justify-center bg-background/60 backdrop-blur-sm',
|
|
235
|
+
className,
|
|
236
|
+
)}
|
|
237
|
+
{...props}
|
|
238
|
+
>
|
|
239
|
+
<div
|
|
240
|
+
data-slot="spinner-overlay-indicator"
|
|
241
|
+
className={cn(
|
|
242
|
+
'flex items-center justify-center',
|
|
243
|
+
tipAlign === 'right' ? 'flex-row gap-2' : 'flex-col gap-2',
|
|
244
|
+
)}
|
|
245
|
+
>
|
|
246
|
+
{children}
|
|
247
|
+
</div>
|
|
248
|
+
</div>
|
|
249
|
+
);
|
|
250
|
+
}
|
|
251
|
+
|
|
252
|
+
/* ────────────────────────────────────────────────────────────────────────── */
|
|
253
|
+
/* SpinnerFullscreen(全屏 + Portal + Esc 关闭) */
|
|
254
|
+
/* ────────────────────────────────────────────────────────────────────────── */
|
|
255
|
+
|
|
256
|
+
export interface SpinnerFullscreenProps {
|
|
257
|
+
/** loading 状态 */
|
|
258
|
+
visible?: boolean;
|
|
259
|
+
/** 显示延迟(ms),默认 100 */
|
|
260
|
+
delay?: number;
|
|
261
|
+
/** 文字提示 */
|
|
262
|
+
tip?: React.ReactNode;
|
|
263
|
+
/** tip 与 indicator 的相对位置,默认 `bottom` */
|
|
264
|
+
tipAlign?: 'right' | 'bottom';
|
|
265
|
+
/** 自定义 indicator,默认 `<Spinner size="lg" tone="primary" />` */
|
|
266
|
+
indicator?: React.ReactNode;
|
|
267
|
+
/** Portal 投放容器,默认 `document.body` */
|
|
268
|
+
container?: HTMLElement | null;
|
|
269
|
+
/** 用户按下 Esc 时回调,建议在此处把 `visible` 置 false */
|
|
270
|
+
onVisibleChange?: (visible: boolean) => void;
|
|
271
|
+
}
|
|
272
|
+
|
|
273
|
+
/**
|
|
274
|
+
* 全屏遮罩 loading。通过 Portal 投放到 `container`(默认 body),
|
|
275
|
+
* 监听 Esc 键并调用 `onVisibleChange(false)` 让上层关闭。
|
|
276
|
+
*/
|
|
277
|
+
function SpinnerFullscreen({
|
|
278
|
+
visible = false,
|
|
279
|
+
delay = 100,
|
|
280
|
+
tip,
|
|
281
|
+
tipAlign = 'bottom',
|
|
282
|
+
indicator,
|
|
283
|
+
container,
|
|
284
|
+
onVisibleChange,
|
|
285
|
+
}: SpinnerFullscreenProps) {
|
|
286
|
+
const shown = useDelayedVisible(visible, delay);
|
|
287
|
+
|
|
288
|
+
React.useEffect(() => {
|
|
289
|
+
if (!shown) return;
|
|
290
|
+
const handler = (e: KeyboardEvent) => {
|
|
291
|
+
if (e.key === 'Escape') {
|
|
292
|
+
onVisibleChange?.(false);
|
|
293
|
+
}
|
|
294
|
+
};
|
|
295
|
+
document.addEventListener('keydown', handler);
|
|
296
|
+
return () => document.removeEventListener('keydown', handler);
|
|
297
|
+
}, [shown, onVisibleChange]);
|
|
298
|
+
|
|
299
|
+
if (!shown) return null;
|
|
300
|
+
if (typeof document === 'undefined') return null;
|
|
301
|
+
|
|
302
|
+
const target = container ?? document.body;
|
|
303
|
+
|
|
304
|
+
return createPortal(
|
|
305
|
+
<div
|
|
306
|
+
data-slot="spinner-fullscreen"
|
|
307
|
+
data-tip-align={tipAlign}
|
|
308
|
+
role="alertdialog"
|
|
309
|
+
aria-modal="true"
|
|
310
|
+
aria-busy="true"
|
|
311
|
+
className="fixed inset-0 z-50 flex items-center justify-center bg-background/60 backdrop-blur-sm"
|
|
312
|
+
>
|
|
313
|
+
<div
|
|
314
|
+
data-slot="spinner-fullscreen-indicator"
|
|
315
|
+
className={cn(
|
|
316
|
+
'flex items-center justify-center',
|
|
317
|
+
tipAlign === 'right' ? 'flex-row gap-2' : 'flex-col gap-2',
|
|
318
|
+
)}
|
|
319
|
+
>
|
|
320
|
+
{indicator ?? <Spinner size="lg" tone="primary" />}
|
|
321
|
+
{tip != null && tip !== false ? <SpinnerTip>{tip}</SpinnerTip> : null}
|
|
322
|
+
</div>
|
|
323
|
+
</div>,
|
|
324
|
+
target,
|
|
325
|
+
);
|
|
326
|
+
}
|
|
327
|
+
|
|
328
|
+
export {
|
|
329
|
+
Spinner,
|
|
330
|
+
SpinnerTip,
|
|
331
|
+
SpinnerOverlay,
|
|
332
|
+
SpinnerOverlayMask,
|
|
333
|
+
SpinnerFullscreen,
|
|
334
|
+
spinnerVariants,
|
|
335
|
+
};
|
|
@@ -0,0 +1,172 @@
|
|
|
1
|
+
# Spinner
|
|
2
|
+
|
|
3
|
+
> 本文件由 `pnpm gen:meta` 自动生成,**请勿手动编辑**。
|
|
4
|
+
|
|
5
|
+
## 描述
|
|
6
|
+
|
|
7
|
+
加载指示器 Spinner
|
|
8
|
+
shadcn v4 composable 套件:原子 Spinner + SpinnerTip 文案 + SpinnerOverlay 包裹遮罩 + SpinnerFullscreen 全屏遮罩。
|
|
9
|
+
对齐 cloud-design Loading 的能力(visible / tip / tipAlign / indicator / inline / 100ms 防闪 / fullScreen / Esc 关闭)。
|
|
10
|
+
|
|
11
|
+
## 使用场景
|
|
12
|
+
|
|
13
|
+
- 按钮 / Trigger / 单元格内的行内 loading 反馈
|
|
14
|
+
- 局部内容区在异步加载时的遮罩态(包裹模式 + 100ms 防闪)
|
|
15
|
+
- 关键操作(提交、保存)时的全屏阻断态(带 Esc 关闭)
|
|
16
|
+
- 组合结构:SpinnerOverlay > children + SpinnerOverlayMask > Spinner + SpinnerTip
|
|
17
|
+
|
|
18
|
+
## Props
|
|
19
|
+
|
|
20
|
+
| 名称 | 类型 | 默认值 | 必填 | 说明 |
|
|
21
|
+
| --- | --- | --- | --- | --- |
|
|
22
|
+
| `size` | `"xs" \| "sm" \| "md" \| "lg"` | – | – | – |
|
|
23
|
+
| `tone` | `"default" \| "primary" \| "inverse" \| "muted"` | `"default"` | – | – |
|
|
24
|
+
| `label` | `string` | – | – | sr-only 读屏文本,默认 `加载中`;如父级已有可见 tip 可置空 |
|
|
25
|
+
| `visible` | `boolean` | – | – | loading 状态,默认 true。从 false→true 切换会延迟 `delay` 毫秒后显示,避免短任务闪烁 |
|
|
26
|
+
| `delay` | `number` | – | – | 显示延迟(ms),默认 100;设为 0 关闭防闪 |
|
|
27
|
+
| `tip` | `React.ReactNode` | – | – | 文字提示,与 indicator 一起展示在遮罩中央 |
|
|
28
|
+
| `tipAlign` | `'right' \| 'bottom'` | – | – | tip 与 indicator 的相对位置,默认 `bottom` |
|
|
29
|
+
| `indicator` | `React.ReactNode` | – | – | 自定义 indicator,默认 `<Spinner size={size} tone="primary" />` |
|
|
30
|
+
| `size` | `'sm' \| 'md' \| 'lg'` | – | – | 默认 indicator 的尺寸(仅在未传 indicator 时生效),默认 `lg` |
|
|
31
|
+
| `inline` | `boolean` | – | – | 容器布局:`true` 为 inline-block,`false` 为 block 通栏,默认 `true` |
|
|
32
|
+
| `blur` | `boolean` | – | – | 遮罩生效时是否对 children 做模糊处理,默认 `true`(对齐 cloud-design hybridcloud blur 视觉) |
|
|
33
|
+
| `visible` | `boolean` | – | – | loading 状态 |
|
|
34
|
+
| `delay` | `number` | – | – | 显示延迟(ms),默认 100 |
|
|
35
|
+
| `tip` | `React.ReactNode` | – | – | 文字提示 |
|
|
36
|
+
| `tipAlign` | `'right' \| 'bottom'` | – | – | tip 与 indicator 的相对位置,默认 `bottom` |
|
|
37
|
+
| `indicator` | `React.ReactNode` | – | – | 自定义 indicator,默认 `<Spinner size="lg" tone="primary" />` |
|
|
38
|
+
| `container` | `HTMLElement \| null` | – | – | Portal 投放容器,默认 `document.body` |
|
|
39
|
+
| `onVisibleChange` | `(visible: boolean) => void` | – | – | 用户按下 Esc 时回调,建议在此处把 `visible` 置 false |
|
|
40
|
+
|
|
41
|
+
## 示例
|
|
42
|
+
|
|
43
|
+
### Sizes
|
|
44
|
+
|
|
45
|
+
四档显式尺寸:xs(12) / sm(14) / md(16) / lg(20)。
|
|
46
|
+
|
|
47
|
+
```tsx
|
|
48
|
+
<div className="flex items-center gap-4">
|
|
49
|
+
<Spinner size="xs" />
|
|
50
|
+
<Spinner size="sm" />
|
|
51
|
+
<Spinner size="md" />
|
|
52
|
+
<Spinner size="lg" />
|
|
53
|
+
</div>
|
|
54
|
+
```
|
|
55
|
+
|
|
56
|
+
### Tones
|
|
57
|
+
|
|
58
|
+
四档语义色调:default(继承) / primary / inverse(深色背景) / muted。
|
|
59
|
+
|
|
60
|
+
```tsx
|
|
61
|
+
<div className="flex items-center gap-4">
|
|
62
|
+
<Spinner size="md" tone="default" />
|
|
63
|
+
<Spinner size="md" tone="primary" />
|
|
64
|
+
<span className="inline-flex items-center justify-center rounded bg-primary p-2">
|
|
65
|
+
<Spinner size="md" tone="inverse" />
|
|
66
|
+
</span>
|
|
67
|
+
<Spinner size="md" tone="muted" />
|
|
68
|
+
</div>
|
|
69
|
+
```
|
|
70
|
+
|
|
71
|
+
### WithTip
|
|
72
|
+
|
|
73
|
+
原子 Spinner 搭配 SpinnerTip 行内展示文字提示。
|
|
74
|
+
|
|
75
|
+
```tsx
|
|
76
|
+
<div className="flex items-center gap-2">
|
|
77
|
+
<Spinner size="md" tone="primary" />
|
|
78
|
+
<SpinnerTip>加载中...</SpinnerTip>
|
|
79
|
+
</div>
|
|
80
|
+
```
|
|
81
|
+
|
|
82
|
+
### OverlayBasic
|
|
83
|
+
|
|
84
|
+
包裹模式基础用法:遮罩 + 居中 Spinner + tip。
|
|
85
|
+
|
|
86
|
+
```tsx
|
|
87
|
+
<SpinnerOverlay tip="加载中...">
|
|
88
|
+
<div className="h-20 w-48 rounded border border-border p-4 text-xs">
|
|
89
|
+
包裹内容区
|
|
90
|
+
</div>
|
|
91
|
+
</SpinnerOverlay>
|
|
92
|
+
```
|
|
93
|
+
|
|
94
|
+
### OverlaySizes
|
|
95
|
+
|
|
96
|
+
包裹模式三档 indicator 尺寸。
|
|
97
|
+
|
|
98
|
+
```tsx
|
|
99
|
+
<div className="flex gap-6">
|
|
100
|
+
<SpinnerOverlay size="sm" tip="sm">
|
|
101
|
+
<div className="h-20 w-32 rounded border border-border p-4 text-xs">
|
|
102
|
+
小
|
|
103
|
+
</div>
|
|
104
|
+
</SpinnerOverlay>
|
|
105
|
+
<SpinnerOverlay size="md" tip="md">
|
|
106
|
+
<div className="h-20 w-32 rounded border border-border p-4 text-xs">
|
|
107
|
+
中
|
|
108
|
+
</div>
|
|
109
|
+
</SpinnerOverlay>
|
|
110
|
+
<SpinnerOverlay size="lg" tip="lg">
|
|
111
|
+
<div className="h-20 w-32 rounded border border-border p-4 text-xs">
|
|
112
|
+
大
|
|
113
|
+
</div>
|
|
114
|
+
</SpinnerOverlay>
|
|
115
|
+
</div>
|
|
116
|
+
```
|
|
117
|
+
|
|
118
|
+
### OverlayTipAlign
|
|
119
|
+
|
|
120
|
+
tip 位置:right(行内) 与 bottom(堆叠)。
|
|
121
|
+
|
|
122
|
+
```tsx
|
|
123
|
+
<div className="flex gap-6">
|
|
124
|
+
<SpinnerOverlay tip="bottom(默认)" tipAlign="bottom">
|
|
125
|
+
<div className="h-24 w-40 rounded border border-border p-4 text-xs">
|
|
126
|
+
tipAlign=bottom
|
|
127
|
+
</div>
|
|
128
|
+
</SpinnerOverlay>
|
|
129
|
+
<SpinnerOverlay tip="right" tipAlign="right">
|
|
130
|
+
<div className="h-24 w-40 rounded border border-border p-4 text-xs">
|
|
131
|
+
tipAlign=right
|
|
132
|
+
</div>
|
|
133
|
+
</SpinnerOverlay>
|
|
134
|
+
</div>
|
|
135
|
+
```
|
|
136
|
+
|
|
137
|
+
### OverlayCustomIndicator
|
|
138
|
+
|
|
139
|
+
自定义 indicator 替换默认 Spinner。
|
|
140
|
+
|
|
141
|
+
```tsx
|
|
142
|
+
<SpinnerOverlay indicator={<span>⏳</span>} tip="自定义动画">
|
|
143
|
+
<div className="h-20 w-48 rounded border border-border p-4 text-xs">
|
|
144
|
+
内容
|
|
145
|
+
</div>
|
|
146
|
+
</SpinnerOverlay>
|
|
147
|
+
```
|
|
148
|
+
|
|
149
|
+
### InlineVsBlock
|
|
150
|
+
|
|
151
|
+
inline(默认)与 block 通栏模式对比。
|
|
152
|
+
|
|
153
|
+
```tsx
|
|
154
|
+
<div className="flex flex-col gap-4">
|
|
155
|
+
<div>
|
|
156
|
+
<span className="mr-2 text-muted-foreground">inline:</span>
|
|
157
|
+
<SpinnerOverlay inline tip="inline">
|
|
158
|
+
<span className="rounded border border-border px-4 py-2 text-xs">
|
|
159
|
+
行内内容
|
|
160
|
+
</span>
|
|
161
|
+
</SpinnerOverlay>
|
|
162
|
+
</div>
|
|
163
|
+
<div>
|
|
164
|
+
<span className="mb-1 block text-muted-foreground">block:</span>
|
|
165
|
+
<SpinnerOverlay inline={false} tip="block">
|
|
166
|
+
<div className="rounded border border-border px-4 py-2 text-xs">
|
|
167
|
+
通栏内容
|
|
168
|
+
</div>
|
|
169
|
+
</SpinnerOverlay>
|
|
170
|
+
</div>
|
|
171
|
+
</div>
|
|
172
|
+
```
|
|
@@ -0,0 +1,197 @@
|
|
|
1
|
+
import type { Meta, StoryObj } from '@storybook/react';
|
|
2
|
+
import * as React from 'react';
|
|
3
|
+
import {
|
|
4
|
+
Spinner,
|
|
5
|
+
SpinnerTip,
|
|
6
|
+
SpinnerOverlay,
|
|
7
|
+
SpinnerFullscreen,
|
|
8
|
+
} from './index';
|
|
9
|
+
import { Button } from '@/components/button';
|
|
10
|
+
|
|
11
|
+
const meta: Meta<typeof Spinner> = {
|
|
12
|
+
title: '反馈 · Feedback/Spinner 加载指示器',
|
|
13
|
+
component: Spinner,
|
|
14
|
+
tags: ['autodocs'],
|
|
15
|
+
};
|
|
16
|
+
export default meta;
|
|
17
|
+
|
|
18
|
+
type Story = StoryObj<typeof meta>;
|
|
19
|
+
|
|
20
|
+
/** 默认旋转加载指示器,无显式 size 时由父级决定。 */
|
|
21
|
+
export const Default: Story = {
|
|
22
|
+
render: () => <Spinner />,
|
|
23
|
+
};
|
|
24
|
+
|
|
25
|
+
/** 四档显式尺寸:xs(12) / sm(14) / md(16) / lg(20)。 */
|
|
26
|
+
export const Sizes: Story = {
|
|
27
|
+
render: () => (
|
|
28
|
+
<div className="flex items-center gap-4">
|
|
29
|
+
<Spinner size="xs" />
|
|
30
|
+
<Spinner size="sm" />
|
|
31
|
+
<Spinner size="md" />
|
|
32
|
+
<Spinner size="lg" />
|
|
33
|
+
</div>
|
|
34
|
+
),
|
|
35
|
+
};
|
|
36
|
+
|
|
37
|
+
/** 四档语义色调:default(继承) / primary / inverse(深色背景) / muted。 */
|
|
38
|
+
export const Tones: Story = {
|
|
39
|
+
render: () => (
|
|
40
|
+
<div className="flex items-center gap-4">
|
|
41
|
+
<Spinner size="md" tone="default" />
|
|
42
|
+
<Spinner size="md" tone="primary" />
|
|
43
|
+
<span className="inline-flex items-center justify-center rounded bg-primary p-2">
|
|
44
|
+
<Spinner size="md" tone="inverse" />
|
|
45
|
+
</span>
|
|
46
|
+
<Spinner size="md" tone="muted" />
|
|
47
|
+
</div>
|
|
48
|
+
),
|
|
49
|
+
};
|
|
50
|
+
|
|
51
|
+
/** 原子 Spinner 搭配 SpinnerTip 行内展示文字提示。 */
|
|
52
|
+
export const WithTip: Story = {
|
|
53
|
+
render: () => (
|
|
54
|
+
<div className="flex items-center gap-2">
|
|
55
|
+
<Spinner size="md" tone="primary" />
|
|
56
|
+
<SpinnerTip>加载中...</SpinnerTip>
|
|
57
|
+
</div>
|
|
58
|
+
),
|
|
59
|
+
};
|
|
60
|
+
|
|
61
|
+
/** 包裹模式基础用法:遮罩 + 居中 Spinner + tip。 */
|
|
62
|
+
export const OverlayBasic: Story = {
|
|
63
|
+
render: () => (
|
|
64
|
+
<SpinnerOverlay tip="加载中...">
|
|
65
|
+
<div className="h-20 w-48 rounded border border-border p-4 text-xs">
|
|
66
|
+
包裹内容区
|
|
67
|
+
</div>
|
|
68
|
+
</SpinnerOverlay>
|
|
69
|
+
),
|
|
70
|
+
};
|
|
71
|
+
|
|
72
|
+
/** 包裹模式三档 indicator 尺寸。 */
|
|
73
|
+
export const OverlaySizes: Story = {
|
|
74
|
+
render: () => (
|
|
75
|
+
<div className="flex gap-6">
|
|
76
|
+
<SpinnerOverlay size="sm" tip="sm">
|
|
77
|
+
<div className="h-20 w-32 rounded border border-border p-4 text-xs">
|
|
78
|
+
小
|
|
79
|
+
</div>
|
|
80
|
+
</SpinnerOverlay>
|
|
81
|
+
<SpinnerOverlay size="md" tip="md">
|
|
82
|
+
<div className="h-20 w-32 rounded border border-border p-4 text-xs">
|
|
83
|
+
中
|
|
84
|
+
</div>
|
|
85
|
+
</SpinnerOverlay>
|
|
86
|
+
<SpinnerOverlay size="lg" tip="lg">
|
|
87
|
+
<div className="h-20 w-32 rounded border border-border p-4 text-xs">
|
|
88
|
+
大
|
|
89
|
+
</div>
|
|
90
|
+
</SpinnerOverlay>
|
|
91
|
+
</div>
|
|
92
|
+
),
|
|
93
|
+
};
|
|
94
|
+
|
|
95
|
+
/** tip 位置:right(行内) 与 bottom(堆叠)。 */
|
|
96
|
+
export const OverlayTipAlign: Story = {
|
|
97
|
+
render: () => (
|
|
98
|
+
<div className="flex gap-6">
|
|
99
|
+
<SpinnerOverlay tip="bottom(默认)" tipAlign="bottom">
|
|
100
|
+
<div className="h-24 w-40 rounded border border-border p-4 text-xs">
|
|
101
|
+
tipAlign=bottom
|
|
102
|
+
</div>
|
|
103
|
+
</SpinnerOverlay>
|
|
104
|
+
<SpinnerOverlay tip="right" tipAlign="right">
|
|
105
|
+
<div className="h-24 w-40 rounded border border-border p-4 text-xs">
|
|
106
|
+
tipAlign=right
|
|
107
|
+
</div>
|
|
108
|
+
</SpinnerOverlay>
|
|
109
|
+
</div>
|
|
110
|
+
),
|
|
111
|
+
};
|
|
112
|
+
|
|
113
|
+
/** 受控 visible + 100ms 防闪:短任务 (800ms) 不闪烁,长任务 (2000ms) 正常展示。 */
|
|
114
|
+
export const OverlayControlled: Story = {
|
|
115
|
+
render: function OverlayControlledRender() {
|
|
116
|
+
const [visible1, setVisible1] = React.useState(false);
|
|
117
|
+
const [visible2, setVisible2] = React.useState(false);
|
|
118
|
+
return (
|
|
119
|
+
<div className="flex flex-col gap-4">
|
|
120
|
+
<Button
|
|
121
|
+
onClick={() => {
|
|
122
|
+
setVisible1(true);
|
|
123
|
+
setVisible2(true);
|
|
124
|
+
setTimeout(() => setVisible1(false), 800);
|
|
125
|
+
setTimeout(() => setVisible2(false), 2000);
|
|
126
|
+
}}
|
|
127
|
+
>
|
|
128
|
+
开始加载
|
|
129
|
+
</Button>
|
|
130
|
+
<div className="flex gap-6">
|
|
131
|
+
<SpinnerOverlay visible={visible1} tip="800ms 快任务">
|
|
132
|
+
<div className="h-20 w-40 rounded border border-border p-4 text-xs">
|
|
133
|
+
面板 1
|
|
134
|
+
</div>
|
|
135
|
+
</SpinnerOverlay>
|
|
136
|
+
<SpinnerOverlay visible={visible2} tip="2000ms 慢任务">
|
|
137
|
+
<div className="h-20 w-40 rounded border border-border p-4 text-xs">
|
|
138
|
+
面板 2
|
|
139
|
+
</div>
|
|
140
|
+
</SpinnerOverlay>
|
|
141
|
+
</div>
|
|
142
|
+
</div>
|
|
143
|
+
);
|
|
144
|
+
},
|
|
145
|
+
};
|
|
146
|
+
|
|
147
|
+
/** 自定义 indicator 替换默认 Spinner。 */
|
|
148
|
+
export const OverlayCustomIndicator: Story = {
|
|
149
|
+
render: () => (
|
|
150
|
+
<SpinnerOverlay indicator={<span>⏳</span>} tip="自定义动画">
|
|
151
|
+
<div className="h-20 w-48 rounded border border-border p-4 text-xs">
|
|
152
|
+
内容
|
|
153
|
+
</div>
|
|
154
|
+
</SpinnerOverlay>
|
|
155
|
+
),
|
|
156
|
+
};
|
|
157
|
+
|
|
158
|
+
/** 全屏遮罩 + Portal 投放 + Esc 关闭。 */
|
|
159
|
+
export const Fullscreen: Story = {
|
|
160
|
+
render: function FullscreenRender() {
|
|
161
|
+
const [visible, setVisible] = React.useState(false);
|
|
162
|
+
return (
|
|
163
|
+
<div>
|
|
164
|
+
<Button onClick={() => setVisible(true)}>打开全屏 Loading</Button>
|
|
165
|
+
<SpinnerFullscreen
|
|
166
|
+
visible={visible}
|
|
167
|
+
tip="加载中,按 Esc 关闭"
|
|
168
|
+
onVisibleChange={setVisible}
|
|
169
|
+
/>
|
|
170
|
+
</div>
|
|
171
|
+
);
|
|
172
|
+
},
|
|
173
|
+
};
|
|
174
|
+
|
|
175
|
+
/** inline(默认)与 block 通栏模式对比。 */
|
|
176
|
+
export const InlineVsBlock: Story = {
|
|
177
|
+
render: () => (
|
|
178
|
+
<div className="flex flex-col gap-4">
|
|
179
|
+
<div>
|
|
180
|
+
<span className="mr-2 text-muted-foreground">inline:</span>
|
|
181
|
+
<SpinnerOverlay inline tip="inline">
|
|
182
|
+
<span className="rounded border border-border px-4 py-2 text-xs">
|
|
183
|
+
行内内容
|
|
184
|
+
</span>
|
|
185
|
+
</SpinnerOverlay>
|
|
186
|
+
</div>
|
|
187
|
+
<div>
|
|
188
|
+
<span className="mb-1 block text-muted-foreground">block:</span>
|
|
189
|
+
<SpinnerOverlay inline={false} tip="block">
|
|
190
|
+
<div className="rounded border border-border px-4 py-2 text-xs">
|
|
191
|
+
通栏内容
|
|
192
|
+
</div>
|
|
193
|
+
</SpinnerOverlay>
|
|
194
|
+
</div>
|
|
195
|
+
</div>
|
|
196
|
+
),
|
|
197
|
+
};
|