@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.
- package/README.md +184 -184
- package/manifest.json +680 -492
- package/package.json +20 -10
- package/src/components/accordion/accordion.meta.md +5 -4
- package/src/components/accordion/accordion.stories.tsx +14 -9
- package/src/components/accordion/accordion.tsx +104 -8
- package/src/components/affix/affix.meta.md +20 -2
- package/src/components/affix/affix.stories.tsx +102 -25
- package/src/components/affix/affix.tsx +79 -9
- package/src/components/alert/alert.meta.md +44 -13
- package/src/components/alert/alert.stories.tsx +66 -21
- package/src/components/alert/alert.tsx +81 -34
- package/src/components/alert-dialog/alert-dialog.meta.md +61 -16
- package/src/components/alert-dialog/alert-dialog.stories.tsx +145 -3
- package/src/components/alert-dialog/alert-dialog.tsx +60 -13
- package/src/components/anchor/anchor.meta.md +8 -3
- package/src/components/anchor/anchor.stories.tsx +3 -3
- package/src/components/anchor/anchor.tsx +2 -2
- package/src/components/app/app.meta.md +9 -4
- package/src/components/app/app.stories.tsx +9 -7
- package/src/components/aspect-ratio/aspect-ratio.meta.md +4 -3
- package/src/components/aspect-ratio/aspect-ratio.stories.tsx +3 -3
- package/src/components/auto-complete/auto-complete.meta.md +14 -6
- package/src/components/auto-complete/auto-complete.stories.tsx +47 -4
- package/src/components/auto-complete/auto-complete.tsx +119 -71
- package/src/components/avatar/avatar.meta.md +6 -7
- package/src/components/avatar/avatar.stories.tsx +21 -3
- package/src/components/avatar/avatar.tsx +24 -23
- package/src/components/badge/badge.meta.md +10 -9
- package/src/components/badge/badge.stories.tsx +2 -2
- package/src/components/badge/badge.tsx +9 -15
- package/src/components/breadcrumb/breadcrumb.meta.md +27 -7
- package/src/components/breadcrumb/breadcrumb.stories.tsx +127 -4
- package/src/components/breadcrumb/breadcrumb.tsx +22 -8
- package/src/components/button/button.meta.md +258 -21
- package/src/components/button/button.stories.tsx +549 -41
- package/src/components/button/button.tsx +335 -33
- package/src/components/button/demo/as-child.tsx +24 -0
- package/src/components/button/demo/basic.tsx +8 -0
- package/src/components/button/demo/block.tsx +16 -0
- package/src/components/button/demo/loading.tsx +19 -0
- package/src/components/button/demo/shapes.tsx +18 -0
- package/src/components/button/demo/sizes.tsx +19 -0
- package/src/components/button/demo/variants.tsx +19 -0
- package/src/components/button/demo/with-icon.tsx +20 -0
- package/src/components/calendar/calendar.meta.md +13 -3
- package/src/components/calendar/calendar.stories.tsx +6 -6
- package/src/components/calendar/calendar.tsx +73 -8
- package/src/components/card/card.meta.md +27 -5
- package/src/components/card/card.stories.tsx +42 -3
- package/src/components/card/card.tsx +146 -63
- package/src/components/carousel/carousel.meta.md +4 -3
- package/src/components/carousel/carousel.stories.tsx +11 -6
- package/src/components/cascader/cascader.meta.md +47 -17
- package/src/components/cascader/cascader.stories.tsx +22 -10
- package/src/components/cascader/cascader.tsx +428 -85
- package/src/components/checkbox/checkbox.meta.md +75 -7
- package/src/components/checkbox/checkbox.stories.tsx +161 -3
- package/src/components/checkbox/checkbox.tsx +77 -9
- package/src/components/collapsible/collapsible.meta.md +14 -6
- package/src/components/collapsible/collapsible.stories.tsx +10 -2
- package/src/components/collapsible/collapsible.tsx +93 -6
- package/src/components/color-picker/color-picker.meta.md +12 -7
- package/src/components/color-picker/color-picker.stories.tsx +86 -7
- package/src/components/color-picker/color-picker.tsx +20 -9
- package/src/components/command/command.meta.md +29 -13
- package/src/components/command/command.stories.tsx +4 -4
- package/src/components/command/command.tsx +19 -8
- package/src/components/context-menu/context-menu.meta.md +11 -8
- package/src/components/context-menu/context-menu.stories.tsx +11 -3
- package/src/components/context-menu/context-menu.tsx +21 -8
- package/src/components/data-table/data-table.meta.md +6 -5
- package/src/components/data-table/data-table.stories.tsx +13 -6
- package/src/components/data-table/data-table.tsx +2 -2
- package/src/components/date-picker/date-picker.meta.md +88 -19
- package/src/components/date-picker/date-picker.stories.tsx +55 -5
- package/src/components/date-picker/date-picker.tsx +1489 -91
- package/src/components/descriptions/descriptions.meta.md +10 -5
- package/src/components/descriptions/descriptions.stories.tsx +3 -3
- package/src/components/descriptions/descriptions.tsx +22 -14
- package/src/components/dialog/dialog.meta.md +76 -13
- package/src/components/dialog/dialog.stories.tsx +182 -20
- package/src/components/dialog/dialog.tsx +67 -15
- package/src/components/dialog/imperative.tsx +252 -0
- package/src/components/drawer/drawer.meta.md +33 -34
- package/src/components/drawer/drawer.stories.tsx +29 -12
- package/src/components/drawer/drawer.tsx +22 -113
- package/src/components/dropdown-menu/dropdown-menu.meta.md +78 -10
- package/src/components/dropdown-menu/dropdown-menu.stories.tsx +88 -2
- package/src/components/dropdown-menu/dropdown-menu.tsx +24 -10
- package/src/components/ellipsis/ellipsis.meta.md +87 -0
- package/src/components/ellipsis/ellipsis.stories.tsx +72 -0
- package/src/components/ellipsis/ellipsis.tsx +153 -0
- package/src/components/empty/empty.meta.md +9 -4
- package/src/components/empty/empty.stories.tsx +4 -4
- package/src/components/empty/empty.tsx +10 -3
- package/src/components/field/field.meta.md +47 -9
- package/src/components/field/field.stories.tsx +385 -5
- package/src/components/field/field.tsx +263 -35
- package/src/components/filter-bar/filter-bar.meta.md +92 -0
- package/src/components/filter-bar/filter-bar.stories.tsx +1083 -0
- package/src/components/filter-bar/filter-bar.tsx +568 -0
- package/src/components/flex/flex.meta.md +54 -6
- package/src/components/flex/flex.stories.tsx +107 -20
- package/src/components/flex/flex.tsx +27 -4
- package/src/components/float-button/float-button.meta.md +8 -3
- package/src/components/float-button/float-button.stories.tsx +9 -7
- package/src/components/float-button/float-button.tsx +1 -1
- package/src/components/form/form.meta.md +39 -17
- package/src/components/form/form.stories.tsx +350 -3
- package/src/components/form/form.tsx +101 -35
- package/src/components/grid/grid.meta.md +7 -2
- package/src/components/grid/grid.stories.tsx +6 -4
- package/src/components/hover-card/hover-card.meta.md +20 -9
- package/src/components/hover-card/hover-card.stories.tsx +34 -5
- package/src/components/hover-card/hover-card.tsx +51 -13
- package/src/components/icon/DEVELOPMENT.md +809 -0
- package/src/components/icon/icon.meta.md +170 -0
- package/src/components/icon/icon.stories.tsx +344 -0
- package/src/components/icon/icon.tsx +248 -0
- package/src/components/image/image.meta.md +9 -4
- package/src/components/image/image.stories.tsx +3 -3
- package/src/components/image/image.tsx +6 -4
- package/src/components/input/demo/basic.tsx +12 -0
- package/src/components/input/demo/clearable.tsx +21 -0
- package/src/components/input/demo/show-count.tsx +18 -0
- package/src/components/input/demo/sizes.tsx +15 -0
- package/src/components/input/input.meta.md +39 -33
- package/src/components/input/input.stories.tsx +62 -35
- package/src/components/input/input.tsx +97 -98
- package/src/components/input-group/input-group.meta.md +54 -22
- package/src/components/input-group/input-group.stories.tsx +49 -16
- package/src/components/input-group/input-group.tsx +44 -8
- package/src/components/input-number/input-number.meta.md +64 -7
- package/src/components/input-number/input-number.stories.tsx +46 -8
- package/src/components/input-number/input-number.tsx +99 -26
- package/src/components/input-otp/input-otp.meta.md +4 -3
- package/src/components/input-otp/input-otp.stories.tsx +3 -3
- package/src/components/input-otp/input-otp.tsx +1 -1
- package/src/components/item/item.meta.md +8 -3
- package/src/components/item/item.stories.tsx +8 -5
- package/src/components/item/item.tsx +7 -6
- package/src/components/kbd/kbd.meta.md +13 -4
- package/src/components/kbd/kbd.stories.tsx +4 -4
- package/src/components/kbd/kbd.tsx +10 -5
- package/src/components/label/label.meta.md +18 -10
- package/src/components/label/label.stories.tsx +64 -6
- package/src/components/label/label.tsx +91 -19
- package/src/components/masonry/masonry.meta.md +8 -3
- package/src/components/masonry/masonry.stories.tsx +7 -5
- package/src/components/masonry/masonry.tsx +1 -0
- package/src/components/mentions/mentions.meta.md +36 -6
- package/src/components/mentions/mentions.stories.tsx +120 -6
- package/src/components/mentions/mentions.tsx +11 -5
- package/src/components/menubar/menubar.meta.md +30 -12
- package/src/components/menubar/menubar.stories.tsx +62 -2
- package/src/components/menubar/menubar.tsx +9 -9
- package/src/components/native-select/native-select.meta.md +8 -3
- package/src/components/native-select/native-select.stories.tsx +8 -5
- package/src/components/native-select/native-select.tsx +1 -1
- package/src/components/navigation-menu/navigation-menu.meta.md +19 -9
- package/src/components/navigation-menu/navigation-menu.stories.tsx +112 -9
- package/src/components/navigation-menu/navigation-menu.tsx +8 -4
- package/src/components/notification/notification.meta.md +52 -10
- package/src/components/notification/notification.stories.tsx +11 -9
- package/src/components/notification/notification.tsx +36 -21
- package/src/components/page-header/DEVELOPMENT.md +842 -0
- package/src/components/page-header/page-header.meta.md +208 -0
- package/src/components/page-header/page-header.stories.tsx +421 -0
- package/src/components/page-header/page-header.tsx +281 -0
- package/src/components/pagination/pagination.meta.md +140 -37
- package/src/components/pagination/pagination.stories.tsx +232 -10
- package/src/components/pagination/pagination.tsx +355 -63
- package/src/components/popconfirm/popconfirm.meta.md +9 -4
- package/src/components/popconfirm/popconfirm.stories.tsx +3 -4
- package/src/components/popconfirm/popconfirm.tsx +2 -2
- package/src/components/popover/popover.meta.md +62 -5
- package/src/components/popover/popover.stories.tsx +83 -7
- package/src/components/popover/popover.tsx +77 -28
- package/src/components/progress/progress.meta.md +38 -6
- package/src/components/progress/progress.stories.tsx +3 -3
- package/src/components/progress/progress.tsx +24 -16
- package/src/components/radio-group/radio-group.meta.md +79 -7
- package/src/components/radio-group/radio-group.stories.tsx +39 -3
- package/src/components/radio-group/radio-group.tsx +149 -18
- package/src/components/rate/rate.meta.md +35 -4
- package/src/components/rate/rate.stories.tsx +13 -5
- package/src/components/rate/rate.tsx +37 -10
- package/src/components/resizable/resizable.meta.md +7 -4
- package/src/components/resizable/resizable.stories.tsx +6 -6
- package/src/components/resizable/resizable.tsx +1 -1
- package/src/components/result/result.meta.md +7 -2
- package/src/components/result/result.stories.tsx +4 -8
- package/src/components/result/result.tsx +24 -15
- package/src/components/scroll-area/scroll-area.meta.md +4 -3
- package/src/components/scroll-area/scroll-area.stories.tsx +12 -4
- package/src/components/scroll-area/scroll-area.tsx +3 -3
- package/src/components/segmented/segmented.meta.md +7 -4
- package/src/components/segmented/segmented.stories.tsx +37 -8
- package/src/components/segmented/segmented.tsx +15 -7
- package/src/components/select/select.meta.md +197 -52
- package/src/components/select/select.stories.tsx +238 -63
- package/src/components/select/select.tsx +718 -171
- package/src/components/separator/separator.meta.md +4 -3
- package/src/components/separator/separator.stories.tsx +3 -3
- package/src/components/separator/separator.tsx +3 -7
- package/src/components/sheet/sheet.meta.md +32 -16
- package/src/components/sheet/sheet.stories.tsx +116 -10
- package/src/components/sheet/sheet.tsx +116 -29
- package/src/components/sidebar/sidebar.meta.md +37 -18
- package/src/components/sidebar/sidebar.stories.tsx +701 -29
- package/src/components/sidebar/sidebar.tsx +615 -142
- package/src/components/skeleton/skeleton.meta.md +4 -5
- package/src/components/skeleton/skeleton.stories.tsx +4 -4
- package/src/components/skeleton/skeleton.tsx +7 -7
- package/src/components/slider/slider.meta.md +57 -5
- package/src/components/slider/slider.stories.tsx +58 -6
- package/src/components/slider/slider.tsx +154 -13
- package/src/components/sonner/sonner.meta.md +58 -7
- package/src/components/sonner/sonner.stories.tsx +78 -5
- package/src/components/sonner/sonner.tsx +137 -8
- package/src/components/spinner/spinner.meta.md +62 -13
- package/src/components/spinner/spinner.stories.tsx +66 -14
- package/src/components/spinner/spinner.tsx +111 -9
- package/src/components/statistic/statistic.meta.md +7 -2
- package/src/components/statistic/statistic.stories.tsx +3 -7
- package/src/components/statistic/statistic.tsx +5 -6
- package/src/components/steps/steps.meta.md +18 -4
- package/src/components/steps/steps.stories.tsx +43 -3
- package/src/components/steps/steps.tsx +15 -12
- package/src/components/switch/switch.meta.md +51 -5
- package/src/components/switch/switch.stories.tsx +6 -6
- package/src/components/switch/switch.tsx +109 -41
- package/src/components/table/table.meta.md +17 -6
- package/src/components/table/table.stories.tsx +10 -5
- package/src/components/table/table.tsx +4 -4
- package/src/components/tabs/tabs.meta.md +38 -25
- package/src/components/tabs/tabs.stories.tsx +111 -25
- package/src/components/tabs/tabs.tsx +125 -54
- package/src/components/tag/tag.meta.md +105 -40
- package/src/components/tag/tag.stories.tsx +189 -16
- package/src/components/tag/tag.tsx +222 -21
- package/src/components/textarea/textarea.meta.md +35 -19
- package/src/components/textarea/textarea.stories.tsx +32 -6
- package/src/components/textarea/textarea.tsx +33 -9
- package/src/components/time-picker/time-picker.meta.md +124 -32
- package/src/components/time-picker/time-picker.stories.tsx +85 -15
- package/src/components/time-picker/time-picker.tsx +913 -61
- package/src/components/timeline/timeline.meta.md +14 -6
- package/src/components/timeline/timeline.stories.tsx +37 -7
- package/src/components/timeline/timeline.tsx +35 -14
- package/src/components/toggle/toggle.meta.md +5 -4
- package/src/components/toggle/toggle.stories.tsx +4 -4
- package/src/components/toggle/toggle.tsx +4 -3
- package/src/components/toggle-group/toggle-group.meta.md +5 -4
- package/src/components/toggle-group/toggle-group.stories.tsx +3 -3
- package/src/components/toggle-group/toggle-group.tsx +2 -2
- package/src/components/tooltip/tooltip.meta.md +55 -5
- package/src/components/tooltip/tooltip.stories.tsx +42 -5
- package/src/components/tooltip/tooltip.tsx +81 -21
- package/src/components/tour/tour.meta.md +9 -4
- package/src/components/tour/tour.stories.tsx +3 -3
- package/src/components/tour/tour.tsx +4 -4
- package/src/components/transfer/transfer.meta.md +11 -6
- package/src/components/transfer/transfer.stories.tsx +4 -8
- package/src/components/transfer/transfer.tsx +28 -21
- package/src/components/tree/tree.meta.md +63 -5
- package/src/components/tree/tree.stories.tsx +31 -12
- package/src/components/tree/tree.tsx +9 -8
- package/src/components/tree-select/tree-select.meta.md +59 -8
- package/src/components/tree-select/tree-select.stories.tsx +3 -3
- package/src/components/tree-select/tree-select.tsx +42 -7
- package/src/components/typography/typography.meta.md +61 -14
- package/src/components/typography/typography.stories.tsx +12 -11
- package/src/components/typography/typography.tsx +43 -28
- package/src/components/upload/upload.meta.md +49 -4
- package/src/components/upload/upload.stories.tsx +72 -12
- package/src/components/upload/upload.tsx +170 -37
- package/src/components/watermark/watermark.meta.md +7 -2
- package/src/components/watermark/watermark.stories.tsx +101 -9
- package/src/components/watermark/watermark.tsx +1 -0
- package/src/hooks/use-breakpoint.ts +117 -0
- package/src/hooks/use-debounce-callback.ts +52 -0
- package/src/hooks/use-mobile.ts +23 -0
- package/src/stories/theme-tokens.stories.tsx +747 -0
- package/src/utils/trigger-input.ts +53 -0
- package/src/components/button-group/button-group.meta.md +0 -92
- package/src/components/button-group/button-group.stories.tsx +0 -90
- package/src/components/button-group/button-group.tsx +0 -75
- package/src/components/combobox/combobox.meta.md +0 -93
- package/src/components/combobox/combobox.stories.tsx +0 -55
- package/src/components/combobox/combobox.tsx +0 -130
- package/src/components/space/space.meta.md +0 -94
- package/src/components/space/space.stories.tsx +0 -94
- package/src/components/space/space.tsx +0 -106
|
@@ -4,20 +4,136 @@ import { X } from 'lucide-react';
|
|
|
4
4
|
|
|
5
5
|
import { cn } from '@/utils/cn';
|
|
6
6
|
|
|
7
|
+
// ─── Preset palette (categorical / decorative) ─────────────────────────────
|
|
8
|
+
//
|
|
9
|
+
// 与 ADR 0021 的 semantic `color` 正交:palette 是**装饰色**,用于纯类别区分
|
|
10
|
+
// (博客标签 / 项目分类等),不承载状态语义。取色对齐 OpenTrek 视觉调性,
|
|
11
|
+
// 以 HSL 形式声明便于派生 bg / border / text 三档(实色 + 透明度)。
|
|
12
|
+
//
|
|
13
|
+
// OpenTrek tokens 尚未提供多彩调色板(v0.6 前的已知缺口,见 packages/ui/AGENTS.md §B);
|
|
14
|
+
// palette 通过 inline style 注入而非 className,custom 任意 CSS 值同路径。
|
|
15
|
+
// 待 tokens 包补 `--palette-blue` 等令牌后,本块替换为 `var(--palette-X)` 即可。
|
|
16
|
+
/* eslint-disable teamix-evo/no-color-literal -- multi-color palette is the v0.6 token gap; constants here are the bridge until OpenTrek ships --palette-* tokens. Same precedent as color-picker default / watermark canvas fallback. */
|
|
17
|
+
const TAG_PALETTE_PRESETS = {
|
|
18
|
+
blue: 'hsl(217 91% 60%)',
|
|
19
|
+
cyan: 'hsl(187 85% 43%)',
|
|
20
|
+
green: 'hsl(142 71% 45%)',
|
|
21
|
+
orange: 'hsl(25 95% 53%)',
|
|
22
|
+
purple: 'hsl(271 76% 53%)',
|
|
23
|
+
red: 'hsl(0 84% 60%)',
|
|
24
|
+
magenta: 'hsl(322 81% 53%)',
|
|
25
|
+
lime: 'hsl(78 76% 38%)',
|
|
26
|
+
gold: 'hsl(45 93% 47%)',
|
|
27
|
+
} as const;
|
|
28
|
+
/* eslint-enable teamix-evo/no-color-literal */
|
|
29
|
+
|
|
30
|
+
export type TagPalettePreset = keyof typeof TAG_PALETTE_PRESETS;
|
|
31
|
+
|
|
32
|
+
interface PaletteStyle {
|
|
33
|
+
backgroundColor: string;
|
|
34
|
+
borderColor: string;
|
|
35
|
+
color: string;
|
|
36
|
+
}
|
|
37
|
+
|
|
38
|
+
function resolvePaletteStyle(palette: string): PaletteStyle {
|
|
39
|
+
const base =
|
|
40
|
+
(TAG_PALETTE_PRESETS as Record<string, string>)[palette] ?? palette;
|
|
41
|
+
return {
|
|
42
|
+
backgroundColor: `color-mix(in srgb, ${base} 12%, transparent)`,
|
|
43
|
+
borderColor: `color-mix(in srgb, ${base} 35%, transparent)`,
|
|
44
|
+
color: base,
|
|
45
|
+
};
|
|
46
|
+
}
|
|
47
|
+
|
|
7
48
|
const tagVariants = cva(
|
|
8
|
-
'inline-flex items-center gap-1
|
|
49
|
+
'inline-flex items-center gap-1 border border-border font-medium transition-colors',
|
|
9
50
|
{
|
|
10
51
|
variants: {
|
|
52
|
+
variant: {
|
|
53
|
+
solid: '',
|
|
54
|
+
outline: 'bg-transparent',
|
|
55
|
+
ghost: 'border-transparent bg-transparent',
|
|
56
|
+
},
|
|
11
57
|
color: {
|
|
12
|
-
default: '
|
|
13
|
-
primary: '
|
|
14
|
-
success: '
|
|
15
|
-
warning: '
|
|
16
|
-
|
|
17
|
-
|
|
58
|
+
default: '',
|
|
59
|
+
primary: '',
|
|
60
|
+
success: '',
|
|
61
|
+
warning: '',
|
|
62
|
+
destructive: '',
|
|
63
|
+
},
|
|
64
|
+
size: {
|
|
65
|
+
sm: 'h-5 px-1.5 text-xs',
|
|
66
|
+
md: 'h-6 px-2 text-xs',
|
|
18
67
|
},
|
|
19
68
|
},
|
|
20
|
-
|
|
69
|
+
compoundVariants: [
|
|
70
|
+
// ── solid (filled background) ──
|
|
71
|
+
{
|
|
72
|
+
variant: 'solid',
|
|
73
|
+
color: 'default',
|
|
74
|
+
className: 'border-border bg-muted text-foreground',
|
|
75
|
+
},
|
|
76
|
+
{
|
|
77
|
+
variant: 'solid',
|
|
78
|
+
color: 'primary',
|
|
79
|
+
className: 'border-primary/30 bg-primary/10 text-primary',
|
|
80
|
+
},
|
|
81
|
+
{
|
|
82
|
+
variant: 'solid',
|
|
83
|
+
color: 'success',
|
|
84
|
+
className:
|
|
85
|
+
'border-success-border/30 bg-success-subtle text-success',
|
|
86
|
+
},
|
|
87
|
+
{
|
|
88
|
+
variant: 'solid',
|
|
89
|
+
color: 'warning',
|
|
90
|
+
className:
|
|
91
|
+
'border-warning-border/30 bg-warning-subtle text-warning',
|
|
92
|
+
},
|
|
93
|
+
{
|
|
94
|
+
variant: 'solid',
|
|
95
|
+
color: 'destructive',
|
|
96
|
+
className:
|
|
97
|
+
'border-destructive/30 bg-destructive/10 text-destructive',
|
|
98
|
+
},
|
|
99
|
+
// ── outline (border + text) ──
|
|
100
|
+
{
|
|
101
|
+
variant: 'outline',
|
|
102
|
+
color: 'default',
|
|
103
|
+
className: 'border-border text-foreground',
|
|
104
|
+
},
|
|
105
|
+
{
|
|
106
|
+
variant: 'outline',
|
|
107
|
+
color: 'primary',
|
|
108
|
+
className: 'border-primary text-primary',
|
|
109
|
+
},
|
|
110
|
+
{
|
|
111
|
+
variant: 'outline',
|
|
112
|
+
color: 'success',
|
|
113
|
+
className: 'border-success text-success',
|
|
114
|
+
},
|
|
115
|
+
{
|
|
116
|
+
variant: 'outline',
|
|
117
|
+
color: 'warning',
|
|
118
|
+
className: 'border-warning text-warning',
|
|
119
|
+
},
|
|
120
|
+
{
|
|
121
|
+
variant: 'outline',
|
|
122
|
+
color: 'destructive',
|
|
123
|
+
className: 'border-destructive text-destructive',
|
|
124
|
+
},
|
|
125
|
+
// ── ghost (text only) ──
|
|
126
|
+
{ variant: 'ghost', color: 'default', className: 'text-foreground' },
|
|
127
|
+
{ variant: 'ghost', color: 'primary', className: 'text-primary' },
|
|
128
|
+
{ variant: 'ghost', color: 'success', className: 'text-success' },
|
|
129
|
+
{ variant: 'ghost', color: 'warning', className: 'text-warning' },
|
|
130
|
+
{
|
|
131
|
+
variant: 'ghost',
|
|
132
|
+
color: 'destructive',
|
|
133
|
+
className: 'text-destructive',
|
|
134
|
+
},
|
|
135
|
+
],
|
|
136
|
+
defaultVariants: { variant: 'solid', color: 'default', size: 'md' },
|
|
21
137
|
},
|
|
22
138
|
);
|
|
23
139
|
|
|
@@ -25,34 +141,104 @@ export interface TagProps
|
|
|
25
141
|
extends Omit<React.HTMLAttributes<HTMLSpanElement>, 'color'>,
|
|
26
142
|
VariantProps<typeof tagVariants> {
|
|
27
143
|
/**
|
|
28
|
-
*
|
|
144
|
+
* 形态轴(对齐 [ADR 0021](../../../../docs/adr/0021-semantic-color-api-unification.md)):
|
|
145
|
+
* `solid` 实色背景 / `outline` 仅描边 / `ghost` 仅文字。
|
|
146
|
+
* @default "solid"
|
|
147
|
+
*/
|
|
148
|
+
variant?: 'solid' | 'outline' | 'ghost';
|
|
149
|
+
/**
|
|
150
|
+
* 语义色 — 与组件状态绑定的调色板,5 档(填充背景类省略 `muted`,信息色用 `primary`,
|
|
151
|
+
* 不收 `info` — 见 ADR 0021)。装饰性类别区分请用 `palette`。
|
|
29
152
|
* @default "default"
|
|
30
153
|
*/
|
|
31
|
-
color?: 'default' | 'primary' | 'success' | 'warning' | '
|
|
154
|
+
color?: 'default' | 'primary' | 'success' | 'warning' | 'destructive';
|
|
155
|
+
/**
|
|
156
|
+
* 尺寸:`sm` 高 20px(更紧凑) / `md` 高 24px(默认)。
|
|
157
|
+
* @default "md"
|
|
158
|
+
*/
|
|
159
|
+
size?: 'sm' | 'md';
|
|
160
|
+
/**
|
|
161
|
+
* **分类色 / 装饰色** — 与 `color`(语义色) 正交,用于纯装饰的类别区分(博客标签 / 项目分类 / ...)。
|
|
162
|
+
*
|
|
163
|
+
* 接受 9 种预设色 `'blue' | 'cyan' | 'green' | 'orange' | 'purple' | 'red' | 'magenta' | 'lime' | 'gold'`
|
|
164
|
+
* 或任意 CSS 颜色值(如 `'#FF5733'` / `'hsl(280 80% 60%)'` / `'var(--brand)'`)。
|
|
165
|
+
*
|
|
166
|
+
* `palette` 存在时会**覆盖** `color` 的语义配色(派生 bg / border / text 三档),
|
|
167
|
+
* 但仍受 `variant` 控制形态:`solid` 12% bg + 35% border、`outline` 仅 solid 描边、`ghost` 仅文字。
|
|
168
|
+
*
|
|
169
|
+
* 装饰类别走 `palette`;状态语义走 `color`。两者同传时 `palette` 优先(因为它是显式装饰意图)。
|
|
170
|
+
*/
|
|
171
|
+
palette?: TagPalettePreset | (string & {});
|
|
172
|
+
/**
|
|
173
|
+
* 标签文字左侧图标插槽(antd `icon` 并集)。推荐传 `lucide-react` icon。
|
|
174
|
+
* 与 `closable` 的关闭按钮不冲突 — icon 在左,X 在右。
|
|
175
|
+
*/
|
|
176
|
+
icon?: React.ReactNode;
|
|
32
177
|
/**
|
|
33
178
|
* 显示关闭按钮(antd `closable` 并集)。
|
|
34
179
|
* @default false
|
|
35
180
|
*/
|
|
36
181
|
closable?: boolean;
|
|
37
182
|
/**
|
|
38
|
-
*
|
|
183
|
+
* 关闭回调 — `closable` 触发时调用。建议父组件维护数组并在此回调中移除当前项。
|
|
39
184
|
*/
|
|
40
185
|
onClose?: () => void;
|
|
41
186
|
}
|
|
42
187
|
|
|
43
188
|
const Tag = React.forwardRef<HTMLSpanElement, TagProps>(
|
|
44
189
|
(
|
|
45
|
-
{
|
|
190
|
+
{
|
|
191
|
+
variant,
|
|
192
|
+
color,
|
|
193
|
+
size,
|
|
194
|
+
palette,
|
|
195
|
+
icon,
|
|
196
|
+
closable = false,
|
|
197
|
+
onClose,
|
|
198
|
+
className,
|
|
199
|
+
style,
|
|
200
|
+
children,
|
|
201
|
+
...props
|
|
202
|
+
},
|
|
46
203
|
ref,
|
|
47
204
|
) => {
|
|
48
205
|
const [open, setOpen] = React.useState(true);
|
|
49
206
|
if (!open) return null;
|
|
207
|
+
|
|
208
|
+
// 始终用 token --radius-tag 注入 borderRadius(OpenTrek 组件级圆角)
|
|
209
|
+
const composedStyle: React.CSSProperties = {
|
|
210
|
+
borderRadius: 'var(--radius-tag)',
|
|
211
|
+
};
|
|
212
|
+
|
|
213
|
+
// palette 路径:覆盖 cva 的颜色 className(inline style 优先级 > utility class)
|
|
214
|
+
if (palette) {
|
|
215
|
+
const ps = resolvePaletteStyle(palette);
|
|
216
|
+
composedStyle.color = ps.color;
|
|
217
|
+
if (variant === undefined || variant === 'solid') {
|
|
218
|
+
composedStyle.backgroundColor = ps.backgroundColor;
|
|
219
|
+
composedStyle.borderColor = ps.borderColor;
|
|
220
|
+
} else if (variant === 'outline') {
|
|
221
|
+
// outline 用实色描边,识别度更高(palette 装饰场景下更直观)
|
|
222
|
+
composedStyle.borderColor = ps.color;
|
|
223
|
+
}
|
|
224
|
+
// ghost: cva 已 transparent,只覆盖 text color
|
|
225
|
+
}
|
|
226
|
+
|
|
50
227
|
return (
|
|
51
228
|
<span
|
|
52
229
|
ref={ref}
|
|
53
|
-
className={cn(tagVariants({ color }), className)}
|
|
230
|
+
className={cn(tagVariants({ variant, color, size }), className)}
|
|
231
|
+
style={{ ...composedStyle, ...style }}
|
|
54
232
|
{...props}
|
|
55
233
|
>
|
|
234
|
+
{icon ? (
|
|
235
|
+
<span
|
|
236
|
+
aria-hidden="true"
|
|
237
|
+
className="inline-flex shrink-0 items-center [&_svg]:size-3"
|
|
238
|
+
>
|
|
239
|
+
{icon}
|
|
240
|
+
</span>
|
|
241
|
+
) : null}
|
|
56
242
|
{children}
|
|
57
243
|
{closable ? (
|
|
58
244
|
<button
|
|
@@ -62,7 +248,7 @@ const Tag = React.forwardRef<HTMLSpanElement, TagProps>(
|
|
|
62
248
|
setOpen(false);
|
|
63
249
|
onClose?.();
|
|
64
250
|
}}
|
|
65
|
-
className="rounded-sm opacity-60 transition-opacity hover:opacity-100 focus-visible:outline-none focus-visible:ring-1 focus-visible:ring-ring"
|
|
251
|
+
className="-mr-0.5 inline-flex shrink-0 cursor-pointer rounded-sm opacity-60 transition-opacity hover:opacity-100 focus-visible:outline-none focus-visible:ring-1 focus-visible:ring-ring"
|
|
66
252
|
>
|
|
67
253
|
<X className="size-3" />
|
|
68
254
|
</button>
|
|
@@ -86,7 +272,7 @@ export interface CheckableTagProps
|
|
|
86
272
|
}
|
|
87
273
|
|
|
88
274
|
const CheckableTag = React.forwardRef<HTMLSpanElement, CheckableTagProps>(
|
|
89
|
-
({ checked, onChange, disabled, className, children, ...props }, ref) => (
|
|
275
|
+
({ checked, onChange, disabled, className, style, children, ...props }, ref) => (
|
|
90
276
|
<span
|
|
91
277
|
ref={ref}
|
|
92
278
|
role="checkbox"
|
|
@@ -102,12 +288,13 @@ const CheckableTag = React.forwardRef<HTMLSpanElement, CheckableTagProps>(
|
|
|
102
288
|
onChange?.(!checked);
|
|
103
289
|
}
|
|
104
290
|
}}
|
|
291
|
+
style={{ borderRadius: 'var(--radius-tag)', ...style }}
|
|
105
292
|
className={cn(
|
|
106
|
-
'inline-flex cursor-pointer items-center gap-1
|
|
293
|
+
'inline-flex h-6 cursor-pointer items-center gap-1 border border-border px-2 text-xs font-medium transition-colors',
|
|
107
294
|
'focus-visible:outline-none focus-visible:ring-1 focus-visible:ring-ring',
|
|
108
295
|
checked
|
|
109
296
|
? 'border-primary bg-primary text-primary-foreground hover:bg-primary/90'
|
|
110
|
-
: '
|
|
297
|
+
: 'bg-muted text-foreground hover:bg-accent',
|
|
111
298
|
disabled && 'cursor-not-allowed opacity-50',
|
|
112
299
|
className,
|
|
113
300
|
)}
|
|
@@ -131,7 +318,10 @@ export interface CheckableTagGroupOption {
|
|
|
131
318
|
}
|
|
132
319
|
|
|
133
320
|
export interface CheckableTagGroupProps
|
|
134
|
-
extends Omit<
|
|
321
|
+
extends Omit<
|
|
322
|
+
React.HTMLAttributes<HTMLDivElement>,
|
|
323
|
+
'onChange' | 'defaultValue'
|
|
324
|
+
> {
|
|
135
325
|
/** 候选项数组。 */
|
|
136
326
|
options: CheckableTagGroupOption[];
|
|
137
327
|
/** 受控选中 value 集合。 */
|
|
@@ -144,13 +334,18 @@ export interface CheckableTagGroupProps
|
|
|
144
334
|
disabled?: boolean;
|
|
145
335
|
}
|
|
146
336
|
|
|
147
|
-
const CheckableTagGroup = React.forwardRef<
|
|
337
|
+
const CheckableTagGroup = React.forwardRef<
|
|
338
|
+
HTMLDivElement,
|
|
339
|
+
CheckableTagGroupProps
|
|
340
|
+
>(
|
|
148
341
|
(
|
|
149
342
|
{ options, value, defaultValue, onChange, disabled, className, ...props },
|
|
150
343
|
ref,
|
|
151
344
|
) => {
|
|
152
345
|
const isControlled = value !== undefined;
|
|
153
|
-
const [internal, setInternal] = React.useState<string[]>(
|
|
346
|
+
const [internal, setInternal] = React.useState<string[]>(
|
|
347
|
+
defaultValue ?? [],
|
|
348
|
+
);
|
|
154
349
|
const current = isControlled ? value! : internal;
|
|
155
350
|
|
|
156
351
|
const toggle = (v: string, next: boolean) => {
|
|
@@ -182,4 +377,10 @@ const CheckableTagGroup = React.forwardRef<HTMLDivElement, CheckableTagGroupProp
|
|
|
182
377
|
);
|
|
183
378
|
CheckableTagGroup.displayName = 'CheckableTagGroup';
|
|
184
379
|
|
|
185
|
-
export {
|
|
380
|
+
export {
|
|
381
|
+
Tag,
|
|
382
|
+
CheckableTag,
|
|
383
|
+
CheckableTagGroup,
|
|
384
|
+
tagVariants,
|
|
385
|
+
TAG_PALETTE_PRESETS,
|
|
386
|
+
};
|
|
@@ -2,25 +2,29 @@
|
|
|
2
2
|
id: textarea
|
|
3
3
|
name: Textarea
|
|
4
4
|
type: component
|
|
5
|
-
category:
|
|
6
|
-
since: 0.
|
|
7
|
-
package:
|
|
5
|
+
category: data-entry
|
|
6
|
+
since: 0.2.0
|
|
7
|
+
package: '@teamix-evo/ui'
|
|
8
|
+
displayName: 多行文本框
|
|
8
9
|
---
|
|
9
10
|
|
|
10
|
-
# Textarea
|
|
11
|
+
# Textarea 多行文本框
|
|
11
12
|
|
|
12
|
-
多行文本输入 — shadcn 简洁基底 + antd 的 `autoSize / showCount
|
|
13
|
+
多行文本输入 — shadcn 简洁基底 + antd `Input.TextArea` 的 `autoSize` / `showCount` 并集。从 v0.2 起作为**独立 entry**,与 [`Input`](../input/input.meta.md) 拆开(对齐 shadcn 2025-10 拆分粒度)。
|
|
14
|
+
|
|
15
|
+
`size` 三档字号与 Input 对齐(高度由 `rows` / `autoSize` 决定,**不受 size 影响**)。
|
|
13
16
|
|
|
14
17
|
## When to use
|
|
15
18
|
|
|
16
19
|
- 多行内容输入(评论 / 反馈 / 描述 / 备注)
|
|
17
|
-
- 配 `autoSize` 给"动态高度"输入
|
|
20
|
+
- 配 `autoSize={{ minRows, maxRows }}` 给"动态高度"输入
|
|
18
21
|
- 配 `showCount + maxLength` 控制长度
|
|
19
22
|
|
|
20
23
|
## When NOT to use
|
|
21
24
|
|
|
22
|
-
-
|
|
23
|
-
-
|
|
25
|
+
- 单行文本 → `Input`
|
|
26
|
+
- 输入 + 发送按钮(聊天框 / 评论框)→ `InputGroup` + `InputGroupTextarea` + `InputGroupAddon variant="button"`
|
|
27
|
+
- @提及输入 → `Mentions`
|
|
24
28
|
|
|
25
29
|
## Props
|
|
26
30
|
|
|
@@ -31,6 +35,8 @@ package: "@teamix-evo/ui"
|
|
|
31
35
|
| --- | --- | --- | --- | --- |
|
|
32
36
|
| `autoSize` | `boolean \| { minRows?: number; maxRows?: number }` | `false` | – | 自动高度。`true` 时无上下限;传 `{ minRows, maxRows }` 时受限。 实现:监听 input 事件,把 textarea 设为 auto 后再读 scrollHeight。 |
|
|
33
37
|
| `showCount` | `boolean` | `false` | – | 显示字符计数(antd `showCount` 并集);需配合 `maxLength`。 |
|
|
38
|
+
| `size` | `'sm' \| 'md' \| 'lg'` | `"md"` | – | 字号档位,与 `Input` 三档对齐:`sm`(text-xs) / `md`(text-xs,默认) / `lg`(text-sm)。 高度由 `rows` / `autoSize` 决定,不受 size 影响。 |
|
|
39
|
+
| `error` | `boolean` | `false` | – | 错误态(快捷开关),会同时设置 `aria-invalid`,渲染 destructive 边框 / ring。 |
|
|
34
40
|
| `value` | `string` | – | – | 受控值。 |
|
|
35
41
|
| `defaultValue` | `string` | – | – | uncontrolled 初始值。 |
|
|
36
42
|
| `rows` | `number` | `3` | – | 行数(autoSize 关闭时生效)。 |
|
|
@@ -38,8 +44,6 @@ package: "@teamix-evo/ui"
|
|
|
38
44
|
|
|
39
45
|
## 依赖
|
|
40
46
|
|
|
41
|
-
> 以下表格由 `pnpm --filter @teamix-evo/ui gen:meta` 自动生成,数据源是 [`manifest.json`](../../../manifest.json)。**手工编辑 marker 之间的内容会在下次生成时被覆盖**。
|
|
42
|
-
|
|
43
47
|
<!-- auto:deps:begin -->
|
|
44
48
|
### 同库依赖
|
|
45
49
|
|
|
@@ -54,14 +58,16 @@ package: "@teamix-evo/ui"
|
|
|
54
58
|
_无 — 本组件不依赖任何 npm 包。_
|
|
55
59
|
<!-- auto:deps:end -->
|
|
56
60
|
|
|
57
|
-
> 透传所有 `<textarea>` 原生属性(`name` / `
|
|
61
|
+
> 透传所有 `<textarea>` 原生属性(`name` / `id` / `placeholder` / `aria-*` / `onChange` / ...)。
|
|
58
62
|
|
|
59
63
|
## AI 生成纪律
|
|
60
64
|
|
|
61
|
-
- **`autoSize` 替代 `rows
|
|
62
|
-
- **autoSize 配 `maxRows`
|
|
63
|
-
- **`showCount` 必须配 `maxLength
|
|
64
|
-
- **粘贴长内容时
|
|
65
|
+
- **`autoSize` 替代 `rows`** —— autoSize 启用后 rows 被忽略,两者不要同时传
|
|
66
|
+
- **autoSize 配 `maxRows` 防止失控** —— 不限的 autoSize 在长内容下会撑爆容器,推荐 `{ minRows: 3, maxRows: 8 }`
|
|
67
|
+
- **`showCount` 必须配 `maxLength`** —— 无 maxLength 时 showCount 不显示
|
|
68
|
+
- **粘贴长内容时 effect 监听 value 自动 resize** —— 无需业务侧介入
|
|
69
|
+
- **错误态走 `error` prop** —— 自动反映 `aria-invalid="true"`,**不要**手动拼 `border-destructive`
|
|
70
|
+
- **不要硬编码颜色** —— `bg-background` / `border-input` / `placeholder:text-muted-foreground` 都是 design token
|
|
65
71
|
|
|
66
72
|
## Examples
|
|
67
73
|
|
|
@@ -71,13 +77,23 @@ import { Textarea } from '@/components/ui/textarea';
|
|
|
71
77
|
// 基础
|
|
72
78
|
<Textarea placeholder="留下你的反馈..." />
|
|
73
79
|
|
|
74
|
-
// 自动高度
|
|
80
|
+
// 自动高度(推荐配 maxRows)
|
|
75
81
|
<Textarea autoSize={{ minRows: 3, maxRows: 8 }} placeholder="..." />
|
|
76
82
|
|
|
77
83
|
// 字数统计
|
|
78
84
|
<Textarea showCount maxLength={500} placeholder="不超过 500 字" />
|
|
79
85
|
|
|
80
|
-
//
|
|
81
|
-
|
|
82
|
-
<Textarea value={v} onChange={(e) => setV(e.target.value)} />
|
|
86
|
+
// 错误态
|
|
87
|
+
<Textarea error defaultValue="非法内容" />
|
|
83
88
|
```
|
|
89
|
+
|
|
90
|
+
## Migration · 从旧 `@/components/input/input` 迁移
|
|
91
|
+
|
|
92
|
+
v0.2 起 Textarea 拆为独立 entry,import 路径变化:
|
|
93
|
+
|
|
94
|
+
```diff
|
|
95
|
+
- import { Textarea } from '@/components/input/input';
|
|
96
|
+
+ import { Textarea } from '@/components/textarea/textarea';
|
|
97
|
+
```
|
|
98
|
+
|
|
99
|
+
CLI 命令:`teamix-evo ui add textarea`(单独安装,不再需要先装 input)。组件 API 完全保持不变。
|
|
@@ -1,34 +1,39 @@
|
|
|
1
|
-
import type { Meta, StoryObj } from '@storybook/react';
|
|
1
|
+
import type { Meta, StoryObj } from '@storybook/react-vite';
|
|
2
|
+
|
|
2
3
|
import { Textarea } from './textarea';
|
|
3
4
|
|
|
4
5
|
const meta: Meta<typeof Textarea> = {
|
|
5
|
-
title: '
|
|
6
|
+
title: '数据录入 · Data Entry/Textarea',
|
|
6
7
|
component: Textarea,
|
|
7
8
|
tags: ['autodocs'],
|
|
8
9
|
parameters: {
|
|
9
10
|
docs: {
|
|
10
11
|
description: {
|
|
11
12
|
component:
|
|
12
|
-
'
|
|
13
|
+
'Textarea 多行文本框 —— shadcn 简洁基底 + antd `Input.TextArea` 的 `autoSize` / `showCount` 并集。`size` 三档字号与 Input 对齐(高度由 `rows` / `autoSize` 决定,**不受 size 影响**)。视觉走 OpenTrek semantic tokens,所有样式来自 `@teamix-evo/tokens`,无 mock。',
|
|
13
14
|
},
|
|
14
15
|
},
|
|
15
16
|
},
|
|
16
17
|
argTypes: {
|
|
18
|
+
size: { control: 'inline-radio', options: ['sm', 'md', 'lg'] },
|
|
17
19
|
rows: { control: 'number' },
|
|
18
|
-
maxLength: { control: 'number' },
|
|
19
20
|
showCount: { control: 'boolean' },
|
|
21
|
+
error: { control: 'boolean' },
|
|
20
22
|
disabled: { control: 'boolean' },
|
|
21
23
|
placeholder: { control: 'text' },
|
|
24
|
+
maxLength: { control: 'number' },
|
|
22
25
|
},
|
|
23
26
|
args: {
|
|
27
|
+
size: 'md',
|
|
24
28
|
rows: 3,
|
|
25
|
-
placeholder: '请输入...',
|
|
26
29
|
showCount: false,
|
|
30
|
+
error: false,
|
|
27
31
|
disabled: false,
|
|
32
|
+
placeholder: '请输入...',
|
|
28
33
|
},
|
|
29
34
|
decorators: [
|
|
30
35
|
(Story) => (
|
|
31
|
-
<div className="w-
|
|
36
|
+
<div className="w-96">
|
|
32
37
|
<Story />
|
|
33
38
|
</div>
|
|
34
39
|
),
|
|
@@ -40,6 +45,7 @@ type Story = StoryObj<typeof Textarea>;
|
|
|
40
45
|
|
|
41
46
|
export const Playground: Story = {};
|
|
42
47
|
|
|
48
|
+
/** 自动高度 —— `autoSize={{ minRows, maxRows }}` 让高度随内容生长,粘贴大段文本不撑爆容器。 */
|
|
43
49
|
export const AutoSize: Story = {
|
|
44
50
|
parameters: { controls: { disable: true } },
|
|
45
51
|
render: () => (
|
|
@@ -50,6 +56,7 @@ export const AutoSize: Story = {
|
|
|
50
56
|
),
|
|
51
57
|
};
|
|
52
58
|
|
|
59
|
+
/** 字数统计 —— `showCount` 必须配 `maxLength`,缺一不显示。 */
|
|
53
60
|
export const ShowCount: Story = {
|
|
54
61
|
parameters: { controls: { disable: true } },
|
|
55
62
|
render: () => (
|
|
@@ -57,6 +64,25 @@ export const ShowCount: Story = {
|
|
|
57
64
|
),
|
|
58
65
|
};
|
|
59
66
|
|
|
67
|
+
/** 三档字号 —— 高度仍由 rows 决定,只有字号变化(text-xs / text-xs / text-sm)。 */
|
|
68
|
+
export const Sizes: Story = {
|
|
69
|
+
parameters: { controls: { disable: true } },
|
|
70
|
+
render: () => (
|
|
71
|
+
<div className="flex flex-col gap-3">
|
|
72
|
+
<Textarea size="sm" placeholder="Small (text-xs)" />
|
|
73
|
+
<Textarea size="md" placeholder="Medium (text-xs)" />
|
|
74
|
+
<Textarea size="lg" placeholder="Large (text-sm)" />
|
|
75
|
+
</div>
|
|
76
|
+
),
|
|
77
|
+
};
|
|
78
|
+
|
|
79
|
+
/** 错误态 —— `error` 自动设置 `aria-invalid="true"` + destructive 边框 / ring。 */
|
|
80
|
+
export const Error: Story = {
|
|
81
|
+
parameters: { controls: { disable: true } },
|
|
82
|
+
render: () => <Textarea error defaultValue="非法内容" />,
|
|
83
|
+
};
|
|
84
|
+
|
|
85
|
+
/** 禁用态。 */
|
|
60
86
|
export const Disabled: Story = {
|
|
61
87
|
parameters: { controls: { disable: true } },
|
|
62
88
|
render: () => <Textarea disabled defaultValue="这是只读的内容,不可编辑。" />,
|
|
@@ -2,8 +2,16 @@ import * as React from 'react';
|
|
|
2
2
|
|
|
3
3
|
import { cn } from '@/utils/cn';
|
|
4
4
|
|
|
5
|
+
// ─── Textarea ───────────────────────────────────────────────────────────────
|
|
6
|
+
//
|
|
7
|
+
// 多行文本输入。高度由 `rows` / `autoSize` 决定,`size` 仅控制字号档位与 Input 一致。
|
|
8
|
+
// 与 Input 拆分独立 entry(对齐 shadcn 2025-10 拆分粒度)。
|
|
9
|
+
|
|
5
10
|
export interface TextareaProps
|
|
6
|
-
extends Omit<
|
|
11
|
+
extends Omit<
|
|
12
|
+
React.TextareaHTMLAttributes<HTMLTextAreaElement>,
|
|
13
|
+
'rows' | 'size'
|
|
14
|
+
> {
|
|
7
15
|
/**
|
|
8
16
|
* 自动高度。`true` 时无上下限;传 `{ minRows, maxRows }` 时受限。
|
|
9
17
|
* 实现:监听 input 事件,把 textarea 设为 auto 后再读 scrollHeight。
|
|
@@ -15,6 +23,17 @@ export interface TextareaProps
|
|
|
15
23
|
* @default false
|
|
16
24
|
*/
|
|
17
25
|
showCount?: boolean;
|
|
26
|
+
/**
|
|
27
|
+
* 字号档位,与 `Input` 三档对齐:`sm`(text-xs) / `md`(text-xs,默认) / `lg`(text-sm)。
|
|
28
|
+
* 高度由 `rows` / `autoSize` 决定,不受 size 影响。
|
|
29
|
+
* @default "md"
|
|
30
|
+
*/
|
|
31
|
+
size?: 'sm' | 'md' | 'lg';
|
|
32
|
+
/**
|
|
33
|
+
* 错误态(快捷开关),会同时设置 `aria-invalid`,渲染 destructive 边框 / ring。
|
|
34
|
+
* @default false
|
|
35
|
+
*/
|
|
36
|
+
error?: boolean;
|
|
18
37
|
/** 受控值。 */
|
|
19
38
|
value?: string;
|
|
20
39
|
/** uncontrolled 初始值。 */
|
|
@@ -29,19 +48,23 @@ const Textarea = React.forwardRef<HTMLTextAreaElement, TextareaProps>(
|
|
|
29
48
|
className,
|
|
30
49
|
autoSize = false,
|
|
31
50
|
showCount = false,
|
|
51
|
+
size = 'md',
|
|
52
|
+
error = false,
|
|
32
53
|
value,
|
|
33
54
|
defaultValue,
|
|
34
55
|
rows = 3,
|
|
35
56
|
onChange,
|
|
36
57
|
maxLength,
|
|
58
|
+
'aria-invalid': ariaInvalidProp,
|
|
37
59
|
...props
|
|
38
60
|
},
|
|
39
61
|
ref,
|
|
40
62
|
) => {
|
|
63
|
+
const ariaInvalid = ariaInvalidProp ?? (error ? true : undefined);
|
|
64
|
+
const sizeClass =
|
|
65
|
+
size === 'sm' ? 'text-xs' : size === 'lg' ? 'text-sm' : 'text-xs';
|
|
41
66
|
const isControlled = value !== undefined;
|
|
42
|
-
const [internal, setInternal] = React.useState<string>(
|
|
43
|
-
defaultValue ?? '',
|
|
44
|
-
);
|
|
67
|
+
const [internal, setInternal] = React.useState<string>(defaultValue ?? '');
|
|
45
68
|
const current = isControlled ? value : internal;
|
|
46
69
|
|
|
47
70
|
const innerRef = React.useRef<HTMLTextAreaElement | null>(null);
|
|
@@ -62,8 +85,7 @@ const Textarea = React.forwardRef<HTMLTextAreaElement, TextareaProps>(
|
|
|
62
85
|
el.style.height = 'auto';
|
|
63
86
|
const next = el.scrollHeight;
|
|
64
87
|
const opts = typeof autoSize === 'object' ? autoSize : {};
|
|
65
|
-
const minH =
|
|
66
|
-
(opts.minRows ?? 0) * lineHeight + padTop + padBottom;
|
|
88
|
+
const minH = (opts.minRows ?? 0) * lineHeight + padTop + padBottom;
|
|
67
89
|
const maxH = opts.maxRows
|
|
68
90
|
? opts.maxRows * lineHeight + padTop + padBottom
|
|
69
91
|
: Number.POSITIVE_INFINITY;
|
|
@@ -85,10 +107,12 @@ const Textarea = React.forwardRef<HTMLTextAreaElement, TextareaProps>(
|
|
|
85
107
|
value={isControlled ? value : undefined}
|
|
86
108
|
defaultValue={!isControlled ? defaultValue : undefined}
|
|
87
109
|
maxLength={maxLength}
|
|
110
|
+
aria-invalid={ariaInvalid}
|
|
88
111
|
onChange={handleChange}
|
|
89
112
|
className={cn(
|
|
90
|
-
'flex w-full rounded-md border border-input bg-background px-3 py-2
|
|
91
|
-
|
|
113
|
+
'flex w-full rounded-md border border-input bg-background px-3 py-2 shadow-sm placeholder:text-muted-foreground focus-visible:outline-none focus-visible:ring-1 focus-visible:ring-ring disabled:cursor-not-allowed disabled:opacity-50 aria-invalid:border-destructive aria-invalid:focus-visible:ring-destructive',
|
|
114
|
+
sizeClass,
|
|
115
|
+
autoSize ? 'resize-none' : 'min-h-textarea',
|
|
92
116
|
className,
|
|
93
117
|
)}
|
|
94
118
|
{...props}
|
|
@@ -97,7 +121,7 @@ const Textarea = React.forwardRef<HTMLTextAreaElement, TextareaProps>(
|
|
|
97
121
|
|
|
98
122
|
if (showCount && maxLength) {
|
|
99
123
|
return (
|
|
100
|
-
<div className="
|
|
124
|
+
<div className="flex flex-col gap-1">
|
|
101
125
|
{textarea}
|
|
102
126
|
<div className="text-right text-xs text-muted-foreground tabular-nums">
|
|
103
127
|
{current?.length ?? 0} / {maxLength}
|