@apexhub/apex-ui-react 0.0.0-stage → 1.2.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (185) hide show
  1. package/LICENSE +21 -0
  2. package/README.md +37 -2
  3. package/dist/en_US.d.ts +191 -0
  4. package/dist/index.cjs +40727 -0
  5. package/dist/index.d.ts +6873 -0
  6. package/dist/index.mjs +40711 -0
  7. package/dist/llm/alert.tokens.txt +44 -0
  8. package/dist/llm/alert.txt +167 -0
  9. package/dist/llm/apex-provider.txt +369 -0
  10. package/dist/llm/auto-complete.tokens.txt +77 -0
  11. package/dist/llm/auto-complete.txt +373 -0
  12. package/dist/llm/avatar.tokens.txt +38 -0
  13. package/dist/llm/avatar.txt +199 -0
  14. package/dist/llm/breadcrumb.tokens.txt +143 -0
  15. package/dist/llm/breadcrumb.txt +251 -0
  16. package/dist/llm/button.tokens.txt +470 -0
  17. package/dist/llm/button.txt +270 -0
  18. package/dist/llm/card.tokens.txt +29 -0
  19. package/dist/llm/card.txt +118 -0
  20. package/dist/llm/cascader.tokens.txt +261 -0
  21. package/dist/llm/cascader.txt +917 -0
  22. package/dist/llm/checkbox.tokens.txt +36 -0
  23. package/dist/llm/checkbox.txt +343 -0
  24. package/dist/llm/collapse.tokens.txt +84 -0
  25. package/dist/llm/collapse.txt +330 -0
  26. package/dist/llm/date-picker.tokens.txt +171 -0
  27. package/dist/llm/date-picker.txt +428 -0
  28. package/dist/llm/divider.tokens.txt +22 -0
  29. package/dist/llm/divider.txt +161 -0
  30. package/dist/llm/drawer.tokens.txt +71 -0
  31. package/dist/llm/drawer.txt +369 -0
  32. package/dist/llm/dropdown.tokens.txt +59 -0
  33. package/dist/llm/dropdown.txt +420 -0
  34. package/dist/llm/form.tokens.txt +28 -0
  35. package/dist/llm/form.txt +341 -0
  36. package/dist/llm/grid.txt +419 -0
  37. package/dist/llm/image.tokens.txt +28 -0
  38. package/dist/llm/image.txt +428 -0
  39. package/dist/llm/input-number.tokens.txt +159 -0
  40. package/dist/llm/input-number.txt +491 -0
  41. package/dist/llm/input.tokens.txt +136 -0
  42. package/dist/llm/input.txt +424 -0
  43. package/dist/llm/layout.tokens.txt +29 -0
  44. package/dist/llm/layout.txt +298 -0
  45. package/dist/llm/menu.tokens.txt +100 -0
  46. package/dist/llm/menu.txt +687 -0
  47. package/dist/llm/message.tokens.txt +25 -0
  48. package/dist/llm/message.txt +301 -0
  49. package/dist/llm/modal.tokens.txt +96 -0
  50. package/dist/llm/modal.txt +584 -0
  51. package/dist/llm/notification.tokens.txt +79 -0
  52. package/dist/llm/notification.txt +383 -0
  53. package/dist/llm/pagination.tokens.txt +35 -0
  54. package/dist/llm/pagination.txt +217 -0
  55. package/dist/llm/popover.tokens.txt +18 -0
  56. package/dist/llm/popover.txt +233 -0
  57. package/dist/llm/progress.tokens.txt +83 -0
  58. package/dist/llm/progress.txt +279 -0
  59. package/dist/llm/radio.tokens.txt +26 -0
  60. package/dist/llm/radio.txt +385 -0
  61. package/dist/llm/rate.tokens.txt +20 -0
  62. package/dist/llm/rate.txt +241 -0
  63. package/dist/llm/select.tokens.txt +160 -0
  64. package/dist/llm/select.txt +831 -0
  65. package/dist/llm/skeleton.tokens.txt +15 -0
  66. package/dist/llm/skeleton.txt +275 -0
  67. package/dist/llm/spin.tokens.txt +21 -0
  68. package/dist/llm/spin.txt +294 -0
  69. package/dist/llm/steps.tokens.txt +30 -0
  70. package/dist/llm/steps.txt +300 -0
  71. package/dist/llm/switch.tokens.txt +38 -0
  72. package/dist/llm/switch.txt +216 -0
  73. package/dist/llm/table.tokens.txt +94 -0
  74. package/dist/llm/table.txt +1049 -0
  75. package/dist/llm/tabs.tokens.txt +78 -0
  76. package/dist/llm/tabs.txt +306 -0
  77. package/dist/llm/tag.tokens.txt +75 -0
  78. package/dist/llm/tag.txt +304 -0
  79. package/dist/llm/tooltip.tokens.txt +22 -0
  80. package/dist/llm/tooltip.txt +304 -0
  81. package/dist/llm/tree-select.tokens.txt +175 -0
  82. package/dist/llm/tree-select.txt +772 -0
  83. package/dist/llm/tree.tokens.txt +34 -0
  84. package/dist/llm/tree.txt +501 -0
  85. package/dist/llm/typography.tokens.txt +60 -0
  86. package/dist/llm/typography.txt +413 -0
  87. package/dist/llm/upload.tokens.txt +205 -0
  88. package/dist/llm/upload.txt +708 -0
  89. package/dist/llms-full.txt +16826 -0
  90. package/dist/llms-theme.txt +32 -0
  91. package/dist/llms.txt +59 -0
  92. package/dist/locale/en_US.cjs +160 -0
  93. package/dist/locale/en_US.d.ts +4 -0
  94. package/dist/locale/en_US.mjs +161 -0
  95. package/dist/locale/zh_CN.cjs +160 -0
  96. package/dist/locale/zh_CN.d.ts +4 -0
  97. package/dist/locale/zh_CN.mjs +161 -0
  98. package/dist/style.css +20095 -0
  99. package/dist/zh_CN.d.ts +191 -0
  100. package/llms-full.txt +16826 -0
  101. package/llms-theme.txt +32 -0
  102. package/llms.txt +59 -0
  103. package/package.json +118 -3
  104. package/src/alert/llm.txt +167 -0
  105. package/src/alert/tokens.txt +44 -0
  106. package/src/apex-provider/llm.txt +369 -0
  107. package/src/auto-complete/llm.txt +373 -0
  108. package/src/auto-complete/tokens.txt +77 -0
  109. package/src/avatar/llm.txt +199 -0
  110. package/src/avatar/tokens.txt +38 -0
  111. package/src/breadcrumb/llm.txt +251 -0
  112. package/src/breadcrumb/tokens.txt +143 -0
  113. package/src/button/llm.txt +270 -0
  114. package/src/button/tokens.txt +470 -0
  115. package/src/card/llm.txt +118 -0
  116. package/src/card/tokens.txt +29 -0
  117. package/src/cascader/llm.txt +917 -0
  118. package/src/cascader/tokens.txt +261 -0
  119. package/src/checkbox/llm.txt +343 -0
  120. package/src/checkbox/tokens.txt +36 -0
  121. package/src/collapse/llm.txt +330 -0
  122. package/src/collapse/tokens.txt +84 -0
  123. package/src/date-picker/llm.txt +428 -0
  124. package/src/date-picker/tokens.txt +171 -0
  125. package/src/divider/llm.txt +161 -0
  126. package/src/divider/tokens.txt +22 -0
  127. package/src/drawer/llm.txt +369 -0
  128. package/src/drawer/tokens.txt +71 -0
  129. package/src/dropdown/llm.txt +420 -0
  130. package/src/dropdown/tokens.txt +59 -0
  131. package/src/form/llm.txt +341 -0
  132. package/src/form/tokens.txt +28 -0
  133. package/src/grid/llm.txt +419 -0
  134. package/src/image/llm.txt +428 -0
  135. package/src/image/tokens.txt +28 -0
  136. package/src/input/llm.txt +424 -0
  137. package/src/input/tokens.txt +136 -0
  138. package/src/input-number/llm.txt +491 -0
  139. package/src/input-number/tokens.txt +159 -0
  140. package/src/layout/llm.txt +298 -0
  141. package/src/layout/tokens.txt +29 -0
  142. package/src/menu/llm.txt +687 -0
  143. package/src/menu/tokens.txt +100 -0
  144. package/src/message/llm.txt +301 -0
  145. package/src/message/tokens.txt +25 -0
  146. package/src/modal/llm.txt +584 -0
  147. package/src/modal/tokens.txt +96 -0
  148. package/src/notification/llm.txt +383 -0
  149. package/src/notification/tokens.txt +79 -0
  150. package/src/pagination/llm.txt +217 -0
  151. package/src/pagination/tokens.txt +35 -0
  152. package/src/popover/llm.txt +233 -0
  153. package/src/popover/tokens.txt +18 -0
  154. package/src/progress/llm.txt +279 -0
  155. package/src/progress/tokens.txt +83 -0
  156. package/src/radio/llm.txt +385 -0
  157. package/src/radio/tokens.txt +26 -0
  158. package/src/rate/llm.txt +241 -0
  159. package/src/rate/tokens.txt +20 -0
  160. package/src/select/llm.txt +831 -0
  161. package/src/select/tokens.txt +160 -0
  162. package/src/skeleton/llm.txt +275 -0
  163. package/src/skeleton/tokens.txt +15 -0
  164. package/src/spin/llm.txt +294 -0
  165. package/src/spin/tokens.txt +21 -0
  166. package/src/steps/llm.txt +300 -0
  167. package/src/steps/tokens.txt +30 -0
  168. package/src/switch/llm.txt +216 -0
  169. package/src/switch/tokens.txt +38 -0
  170. package/src/table/llm.txt +1049 -0
  171. package/src/table/tokens.txt +94 -0
  172. package/src/tabs/llm.txt +306 -0
  173. package/src/tabs/tokens.txt +78 -0
  174. package/src/tag/llm.txt +304 -0
  175. package/src/tag/tokens.txt +75 -0
  176. package/src/tooltip/llm.txt +304 -0
  177. package/src/tooltip/tokens.txt +22 -0
  178. package/src/tree/llm.txt +501 -0
  179. package/src/tree/tokens.txt +34 -0
  180. package/src/tree-select/llm.txt +772 -0
  181. package/src/tree-select/tokens.txt +175 -0
  182. package/src/typography/llm.txt +413 -0
  183. package/src/typography/tokens.txt +60 -0
  184. package/src/upload/llm.txt +708 -0
  185. package/src/upload/tokens.txt +205 -0
@@ -0,0 +1,424 @@
1
+ # Input
2
+
3
+ > Input:需要通过键盘录入单行或多行文本内容时。
4
+
5
+ 包:`@apexhub/apex-ui-react`;版本:`1.2.2`(当前源码快照,发布状态以安装包版本为准)。
6
+
7
+ 公开导出:`Input`。
8
+
9
+ 以下 API 属于 Apex UI;不要据 antd 的同名组件推断额外属性或默认值。默认值列的空缺表示未声明,不代表 `false`。
10
+
11
+ ## 快速开始
12
+
13
+ ```tsx
14
+ import { Input } from '@apexhub/apex-ui-react'
15
+
16
+ import '@apexhub/apex-ui-react/style.css'
17
+
18
+ export default () => <Input placeholder="请输入内容" />
19
+ ```
20
+
21
+ ## 何时使用
22
+
23
+ - 需要通过键盘录入单行或多行文本内容时。
24
+ - 需要展示校验状态、清除按钮、前后缀或字数统计时。
25
+ - 纯数值录入请使用 InputNumber;非文本类选择请使用 Select 等专用组件。
26
+
27
+ ## API
28
+
29
+ 仅使用类型定义支持的属性;原生属性、ref 目标和事件签名因组件而异。关联类型用于解释字段结构;只有「导出类型」中的名称可从包根导入。
30
+
31
+ ### Input
32
+
33
+ | 属性 | 说明 | 类型 | 必填 | 默认值 |
34
+ | --- | --- | --- | --- | --- |
35
+ | allowClear | 自定义清除按钮;`true` 使用默认图标 | `boolean \| InputAllowClear` | 否 | `false` |
36
+ | count | 字符计数配置 | `CountConfig` | 否 | — |
37
+ | defaultValue | 非受控模式下的初始输入内容 | `string` | 否 | — |
38
+ | disabled | 是否禁用 | `boolean` | 否 | `false` |
39
+ | readOnly | 只读:不可修改,无 hover 交互态,仅展示。与 `disabled` 正交。 | `boolean` | 否 | `false` |
40
+ | id | 表单控件 id,透传至原生 `<input>` 或 `<textarea>` | `string` | 否 | — |
41
+ | name | 表单字段名,透传至原生 `<input>` 或 `<textarea>` | `string` | 否 | — |
42
+ | maxLength | 允许输入的最大字符数(原生 `maxLength`) | `number` | 否 | — |
43
+ | prefix | 前缀内容(如图标) | `React.ReactNode` | 否 | — |
44
+ | status | 设置校验 / 状态样式 | `"error" \| "completed" \| "loading"` | 否 | — |
45
+ | size | 控件尺寸(单行与 textarea 共用):`small` 24px / `medium` 28px / `large` 32px | `"small" \| "medium" \| "large"` | 否 | `'medium'` |
46
+ | variant | 表面变体:`default` 用 `.apex-default-input`,`elevated` 用 `.apex-elevated-input` | `"default" \| "elevated"` | 否 | `'default'` |
47
+ | suffix | 后缀内容(如图标) | `React.ReactNode` | 否 | — |
48
+ | value | 受控模式下的输入内容 | `string` | 否 | — |
49
+ | onClear | 点击清除按钮时的回调 | `() => void` | 否 | — |
50
+ | onChange | 用户输入时的回调 | `(React.ChangeEventHandler<HTMLInputElement>) \| (React.ChangeEventHandler<HTMLTextAreaElement>)` | 否 | — |
51
+ | type | 此字段随模式变化,见下方判别联合与分支类型。 | `(React.HTMLInputTypeAttribute) \| ("textarea")` | 否 | `'text'` |
52
+ | onPressEnter | 此字段随模式变化,见下方判别联合与分支类型。 | `(React.KeyboardEventHandler<HTMLInputElement>) \| (React.KeyboardEventHandler<HTMLTextAreaElement>)` | 否 | — |
53
+ | ref | 此字段随模式变化,见下方判别联合与分支类型。 | `(React.Ref<HTMLInputElement>) \| (React.Ref<HTMLTextAreaElement>)` | 否 | — |
54
+
55
+ ### 模式与类型约束
56
+
57
+ 主 API 表汇总各模式字段;实际可用组合以以下判别联合及各分支类型为准。
58
+
59
+ ```typescript
60
+ export type InputProps = InputSingleLineProps | InputTextareaProps
61
+ ```
62
+
63
+ ### InputStatus
64
+
65
+ Input 校验 / 状态展示
66
+
67
+ ```typescript
68
+ type InputStatus = 'error' | 'completed' | 'loading'
69
+ ```
70
+
71
+ ### InputSize
72
+
73
+ Input 视觉尺寸:small=24 / medium=28 / large=32
74
+
75
+ ```typescript
76
+ type InputSize = 'small' | 'medium' | 'large'
77
+ ```
78
+
79
+ ### InputVariant
80
+
81
+ Input 表面变体:切换 component token 作用域
82
+
83
+ ```typescript
84
+ type InputVariant = 'default' | 'elevated'
85
+ ```
86
+
87
+ ### InputType
88
+
89
+ Input `type` 取值:`textarea` 时渲染 `<textarea>`,样式与单行 Input 一致
90
+
91
+ ```typescript
92
+ type InputType = React.HTMLInputTypeAttribute | 'textarea'
93
+ ```
94
+
95
+ ### CountConfig
96
+
97
+ 字符计数配置
98
+
99
+ | 属性 | 说明 | 类型 | 必填 | 默认值 |
100
+ | --- | --- | --- | --- | --- |
101
+ | max | 最大字符数。与原生 `maxLength` 不同:达上限时仅告警当前字数色,默认不截断<br>(除非配置了 `exceedFormatter`) | `number` | 否 | — |
102
+ | strategy | 自定义计数字符策略,例如将 emoji 长度计为 1 | `(value: string) => number` | 否 | — |
103
+ | show | 是否展示计数,或自定义计数展示内容。<br>为 `true` 时默认渲染分段节点(`apex-input__count-current` / `__count-sep` / `__count-max`) | `boolean \| ((args: { value: string; count: number; maxLength?: number }) => React.ReactNode)` | 否 | — |
104
+ | exceedFormatter | 超出 `max` 时的裁剪逻辑;未配置时不截断 | `(value: string, config: { max: number }) => string` | 否 | — |
105
+
106
+ ### InputAllowClear
107
+
108
+ `allowClear` 为对象时的配置
109
+
110
+ | 属性 | 说明 | 类型 | 必填 | 默认值 |
111
+ | --- | --- | --- | --- | --- |
112
+ | clearIcon | — | `React.ReactNode` | 否 | — |
113
+
114
+ ### InputCommonProps
115
+
116
+ 自定义 Props(input / textarea 共用)
117
+
118
+ | 属性 | 说明 | 类型 | 必填 | 默认值 |
119
+ | --- | --- | --- | --- | --- |
120
+ | allowClear | 自定义清除按钮;`true` 使用默认图标 | `boolean \| InputAllowClear` | 否 | `false` |
121
+ | count | 字符计数配置 | `CountConfig` | 否 | — |
122
+ | defaultValue | 非受控模式下的初始输入内容 | `string` | 否 | — |
123
+ | disabled | 是否禁用 | `boolean` | 否 | `false` |
124
+ | readOnly | 只读:不可修改,无 hover 交互态,仅展示。与 `disabled` 正交。 | `boolean` | 否 | `false` |
125
+ | id | 表单控件 id,透传至原生 `<input>` 或 `<textarea>` | `string` | 否 | — |
126
+ | name | 表单字段名,透传至原生 `<input>` 或 `<textarea>` | `string` | 否 | — |
127
+ | maxLength | 允许输入的最大字符数(原生 `maxLength`) | `number` | 否 | — |
128
+ | prefix | 前缀内容(如图标) | `React.ReactNode` | 否 | — |
129
+ | status | 设置校验 / 状态样式 | `"error" \| "completed" \| "loading"` | 否 | — |
130
+ | size | 控件尺寸(单行与 textarea 共用):`small` 24px / `medium` 28px / `large` 32px | `"small" \| "medium" \| "large"` | 否 | `'medium'` |
131
+ | variant | 表面变体:`default` 用 `.apex-default-input`,`elevated` 用 `.apex-elevated-input` | `"default" \| "elevated"` | 否 | `'default'` |
132
+ | suffix | 后缀内容(如图标) | `React.ReactNode` | 否 | — |
133
+ | value | 受控模式下的输入内容 | `string` | 否 | — |
134
+ | onClear | 点击清除按钮时的回调 | `() => void` | 否 | — |
135
+
136
+ ### InputOmitKeys
137
+
138
+ ```typescript
139
+ type InputOmitKeys = keyof InputCommonProps | 'size' | 'prefix' | 'type' | 'allowClear'
140
+ ```
141
+
142
+ ### InputSingleLineProps
143
+
144
+ 单行 Input(原生 `<input>`)
145
+
146
+ | 属性 | 说明 | 类型 | 必填 | 默认值 |
147
+ | --- | --- | --- | --- | --- |
148
+ | allowClear | 自定义清除按钮;`true` 使用默认图标 | `boolean \| InputAllowClear` | 否 | `false` |
149
+ | count | 字符计数配置 | `CountConfig` | 否 | — |
150
+ | defaultValue | 非受控模式下的初始输入内容 | `string` | 否 | — |
151
+ | disabled | 是否禁用 | `boolean` | 否 | `false` |
152
+ | readOnly | 只读:不可修改,无 hover 交互态,仅展示。与 `disabled` 正交。 | `boolean` | 否 | `false` |
153
+ | id | 表单控件 id,透传至原生 `<input>` 或 `<textarea>` | `string` | 否 | — |
154
+ | name | 表单字段名,透传至原生 `<input>` 或 `<textarea>` | `string` | 否 | — |
155
+ | maxLength | 允许输入的最大字符数(原生 `maxLength`) | `number` | 否 | — |
156
+ | prefix | 前缀内容(如图标) | `React.ReactNode` | 否 | — |
157
+ | status | 设置校验 / 状态样式 | `"error" \| "completed" \| "loading"` | 否 | — |
158
+ | size | 控件尺寸(单行与 textarea 共用):`small` 24px / `medium` 28px / `large` 32px | `"small" \| "medium" \| "large"` | 否 | `'medium'` |
159
+ | variant | 表面变体:`default` 用 `.apex-default-input`,`elevated` 用 `.apex-elevated-input` | `"default" \| "elevated"` | 否 | `'default'` |
160
+ | suffix | 后缀内容(如图标) | `React.ReactNode` | 否 | — |
161
+ | value | 受控模式下的输入内容 | `string` | 否 | — |
162
+ | onClear | 点击清除按钮时的回调 | `() => void` | 否 | — |
163
+ | onChange | 用户输入时的回调 | `React.ChangeEventHandler<HTMLInputElement>` | 否 | — |
164
+ | type | 原生 `<input>` 的 type(不含 `textarea`) | `React.HTMLInputTypeAttribute` | 否 | `'text'` |
165
+ | onPressEnter | 按下 Enter 键时的回调 | `React.KeyboardEventHandler<HTMLInputElement>` | 否 | — |
166
+ | ref | 转发至原生 `<input>` 的 ref | `React.Ref<HTMLInputElement>` | 否 | — |
167
+
168
+ ### InputTextareaProps
169
+
170
+ 多行 Input(`type="textarea"` 时渲染原生 `<textarea>`,复用 Input 外层样式)
171
+
172
+ | 属性 | 说明 | 类型 | 必填 | 默认值 |
173
+ | --- | --- | --- | --- | --- |
174
+ | allowClear | 自定义清除按钮;`true` 使用默认图标 | `boolean \| InputAllowClear` | 否 | `false` |
175
+ | count | 字符计数配置 | `CountConfig` | 否 | — |
176
+ | defaultValue | 非受控模式下的初始输入内容 | `string` | 否 | — |
177
+ | disabled | 是否禁用 | `boolean` | 否 | `false` |
178
+ | readOnly | 只读:不可修改,无 hover 交互态,仅展示。与 `disabled` 正交。 | `boolean` | 否 | `false` |
179
+ | id | 表单控件 id,透传至原生 `<input>` 或 `<textarea>` | `string` | 否 | — |
180
+ | name | 表单字段名,透传至原生 `<input>` 或 `<textarea>` | `string` | 否 | — |
181
+ | maxLength | 允许输入的最大字符数(原生 `maxLength`) | `number` | 否 | — |
182
+ | prefix | 前缀内容(如图标) | `React.ReactNode` | 否 | — |
183
+ | status | 设置校验 / 状态样式 | `"error" \| "completed" \| "loading"` | 否 | — |
184
+ | size | 控件尺寸(单行与 textarea 共用):`small` 24px / `medium` 28px / `large` 32px | `"small" \| "medium" \| "large"` | 否 | `'medium'` |
185
+ | variant | 表面变体:`default` 用 `.apex-default-input`,`elevated` 用 `.apex-elevated-input` | `"default" \| "elevated"` | 否 | `'default'` |
186
+ | suffix | 后缀内容(如图标) | `React.ReactNode` | 否 | — |
187
+ | value | 受控模式下的输入内容 | `string` | 否 | — |
188
+ | onClear | 点击清除按钮时的回调 | `() => void` | 否 | — |
189
+ | onChange | 用户输入时的回调 | `React.ChangeEventHandler<HTMLTextAreaElement>` | 否 | — |
190
+ | type | 设为 `textarea` 时渲染 `<textarea>`,与单行 Input 共用 `.apex-input` 容器与 token | `"textarea"` | 是 | — |
191
+ | onPressEnter | 按下 Enter 键时的回调(如 Ctrl+Enter 提交等由消费方在 handler 内判断) | `React.KeyboardEventHandler<HTMLTextAreaElement>` | 否 | — |
192
+ | ref | 转发至原生 `<textarea>` 的 ref | `React.Ref<HTMLTextAreaElement>` | 否 | — |
193
+
194
+ ### 导出类型
195
+
196
+ 另可从 `@apexhub/apex-ui-react` 导入:`CountConfig`、`InputProps`、`InputSingleLineProps`、`InputSize`、`InputStatus`、`InputTextareaProps`、`InputType`、`InputVariant`(与上文子类型配合使用)。
197
+
198
+ ## 代码演示
199
+
200
+ ### 尺寸
201
+
202
+ 提供 `large`(32px)、`medium`(默认,28px)、`small`(24px)三种尺寸,单行和多行输入框均可使用。
203
+
204
+ ```tsx
205
+ import { Input } from '@apexhub/apex-ui-react'
206
+
207
+ export default () => (
208
+ <div style={{ display: 'flex', flexDirection: 'column', gap: 12, maxWidth: 320 }}>
209
+ <Input size="large" placeholder="large" />
210
+ <Input size="medium" placeholder="medium" />
211
+ <Input size="small" placeholder="small" />
212
+ <Input type="textarea" size="large" rows={3} placeholder="textarea large" />
213
+ <Input type="textarea" size="medium" rows={3} placeholder="textarea medium" />
214
+ <Input type="textarea" size="small" rows={3} placeholder="textarea small" />
215
+ </div>
216
+ )
217
+ ```
218
+
219
+ ### 表面变体
220
+
221
+ `variant` 不传时默认为 `default`(`.apex-default-input`)。`variant="elevated"` 使用 `.apex-elevated-input`,适合放在 elevated 表面上。两种 class 互斥。
222
+
223
+ ```tsx
224
+ import { Input } from '@apexhub/apex-ui-react'
225
+
226
+ export default () => (
227
+ <div
228
+ style={{
229
+ display: 'flex',
230
+ flexDirection: 'column',
231
+ gap: 12,
232
+ maxWidth: 320,
233
+ padding: 16,
234
+ borderRadius: 8,
235
+ background: 'var(--apex-fill-neutral-secondary)',
236
+ }}
237
+ >
238
+ <Input placeholder="default" />
239
+ <Input variant="elevated" placeholder="elevated" />
240
+ </div>
241
+ )
242
+ ```
243
+
244
+ ### 禁用状态
245
+
246
+ `disabled` 后输入框不可编辑,视觉降级且不会触发 变更事件。
247
+
248
+ ```tsx
249
+ import { Input } from '@apexhub/apex-ui-react'
250
+
251
+ export default () => (
252
+ <div style={{ display: 'flex', flexDirection: 'column', gap: 12, maxWidth: 320 }}>
253
+ <Input disabled defaultValue="禁用输入框" />
254
+ <Input type="textarea" disabled rows={3} defaultValue="禁用文本域" />
255
+ </div>
256
+ )
257
+ ```
258
+
259
+ ### 只读
260
+
261
+ `readOnly` 为 true 时可查看内容但不可修改,无 hover 交互态;视觉使用禁用配色,但控件仍可聚焦。示例同时展示空值占位和已填内容。
262
+
263
+ ```tsx
264
+ import { Input } from '@apexhub/apex-ui-react'
265
+
266
+ export default () => (
267
+ <div style={{ display: 'flex', flexDirection: 'column', gap: 12, maxWidth: 320 }}>
268
+ <Input readOnly placeholder="只读空值" />
269
+ <Input readOnly defaultValue="只读输入框" />
270
+ <Input type="textarea" readOnly rows={3} placeholder="只读文本域空值" />
271
+ <Input type="textarea" readOnly rows={3} defaultValue="只读文本域" />
272
+ </div>
273
+ )
274
+ ```
275
+
276
+ ### 状态
277
+
278
+ 通过 `status` 展示错误、完成和加载状态。
279
+
280
+ ```tsx
281
+ import { Input } from '@apexhub/apex-ui-react'
282
+
283
+ export default () => (
284
+ <div style={{ display: 'flex', flexDirection: 'column', gap: 12, maxWidth: 320 }}>
285
+ <Input status="error" defaultValue="校验失败" />
286
+ <Input status="completed" defaultValue="已完成" />
287
+ <Input status="loading" defaultValue="加载中" />
288
+ </div>
289
+ )
290
+ ```
291
+
292
+ ### 前缀与后缀
293
+
294
+ 通过 `prefix` 和 `suffix` 在输入内容两侧添加辅助信息;单行模式默认带搜索图标,传入 `prefix` 设为 `null` 可隐藏。
295
+
296
+ ```tsx
297
+ import { Input } from '@apexhub/apex-ui-react'
298
+
299
+ export default () => (
300
+ <div style={{ display: 'flex', flexDirection: 'column', gap: 12, maxWidth: 320 }}>
301
+ <Input placeholder="默认前缀图标" />
302
+ <Input prefix={null} placeholder="隐藏默认前缀" />
303
+ <Input prefix="https://" suffix=".com" defaultValue="apex-ui" />
304
+ </div>
305
+ )
306
+ ```
307
+
308
+ ### 可清除
309
+
310
+ `allowClear` 显示清除按钮,点击后触发 清除事件 并清空当前值。
311
+
312
+ ```tsx
313
+ import { Input } from '@apexhub/apex-ui-react'
314
+
315
+ import { useState } from 'react'
316
+
317
+ export default () => {
318
+ const [value, setValue] = useState('可清除内容')
319
+
320
+ return (
321
+ <Input
322
+ allowClear
323
+ value={value}
324
+ placeholder="请输入"
325
+ onChange={(event) => setValue(event.currentTarget.value)}
326
+ onClear={() => setValue('')}
327
+ />
328
+ )
329
+ }
330
+ ```
331
+
332
+ ### 字数提示
333
+
334
+ 通过 `count` 展示字符计数。默认展示为「当前字数 / 上限」三段;当字数达到或超过 `count.max`(或原生 `maxLength`)时,仅当前字数变为告警色,输入正文不会整段变红。
335
+
336
+ - 单行:字数在输入框内行尾
337
+ - 多行(`type="textarea"`):字数在输入区下方右对齐
338
+
339
+ ```tsx
340
+ import { Input } from '@apexhub/apex-ui-react'
341
+
342
+ export default () => (
343
+ <div style={{ display: 'flex', flexDirection: 'column', gap: 12, maxWidth: 320 }}>
344
+ <Input defaultValue="Apex" count={{ show: true, max: 20 }} />
345
+ <Input
346
+ defaultValue="emoji🙂"
347
+ count={{
348
+ max: 10,
349
+ strategy: (value) => Array.from(value).length,
350
+ show: ({ count, maxLength }) => `${count}/${maxLength}`,
351
+ }}
352
+ />
353
+ </div>
354
+ )
355
+ ```
356
+
357
+ ### 文本域
358
+
359
+ `type="textarea"` 时渲染多行输入框,支持 `rows` 等 textarea 原生属性。可同时开启 `count` 与 `allowClear`:清除按钮叠在文本区右上、位于滚动条左侧;不提供右下角拖拽缩放。
360
+
361
+ ```tsx
362
+ import { Input } from '@apexhub/apex-ui-react'
363
+
364
+ export default () => (
365
+ <Input
366
+ type="textarea"
367
+ rows={4}
368
+ placeholder="请输入多行内容"
369
+ allowClear
370
+ count={{ show: true, max: 200 }}
371
+ />
372
+ )
373
+ ```
374
+
375
+ ### 受控用法
376
+
377
+ 通过 `value` 与 变更事件 控制输入内容,可配合 回车事件 处理回车提交。
378
+
379
+ ```tsx
380
+ import { Input } from '@apexhub/apex-ui-react'
381
+
382
+ import { useState } from 'react'
383
+
384
+ export default () => {
385
+ const [value, setValue] = useState('Apex UI')
386
+ const [message, setMessage] = useState('按 Enter 提交')
387
+
388
+ return (
389
+ <div style={{ display: 'flex', flexDirection: 'column', gap: 8, maxWidth: 320 }}>
390
+ <Input
391
+ value={value}
392
+ onChange={(event) => setValue(event.currentTarget.value)}
393
+ onPressEnter={() => setMessage(`已提交:${value}`)}
394
+ />
395
+ <span>{message}</span>
396
+ </div>
397
+ )
398
+ }
399
+ ```
400
+
401
+ ## DOM 结构
402
+
403
+ 源码声明的静态 `data-slot`:`input-container`、`input`、`input-prefix`、`input-textarea-body`、`input-textarea-main`、`input-field`、`input-clear`、`input-count`、`input-suffix`。具体节点随模式和状态出现,不表示固定嵌套顺序。
404
+
405
+ ## 样式定制
406
+
407
+ 优先使用本组件公开的尺寸、类型和状态属性。换肤与变量覆盖方式见 [主题指南](../llms-theme.txt)。
408
+
409
+ 需要定制具体样式时再读取 [Token 明细](./input.tokens.txt),其中包含用途、定义值及适用作用域。常规组件使用无需加载该文件。
410
+
411
+ ## FAQ
412
+
413
+ ### 单行输入为什么默认有搜索图标?
414
+
415
+ 单行模式未传 `prefix` 时默认渲染搜索图标;不需要时显式传入 `prefix={null}`。
416
+
417
+
418
+ ### `count.max` 和原生 `maxLength` 有什么区别?
419
+
420
+ `count.max` 仅用于计数展示与达上限告警色,默认不截断输入;原生 `maxLength` 会限制可输入字符数。需要超出时裁剪可配置 `count.exceedFormatter`。达上限判定为字数 `>=` 上限(含刚好满额)。
421
+
422
+ ### textarea 的清除按钮和字数在哪里?
423
+
424
+ 清除按钮叠在文本区右上角、滚动条左侧;字数在输入区下方右对齐。多行不开启原生拖拽缩放。
@@ -0,0 +1,29 @@
1
+ # Layout Token 明细
2
+
3
+ 包:`@apexhub/apex-ui-react`;版本:`1.2.2`(当前源码快照)。
4
+
5
+ 按需读取:[组件用法](./layout.txt) · [主题与覆盖规则](../llms-theme.txt)。
6
+
7
+ 以下组件变量在设计 Token 源中已定义,并被组件或其共享样式使用;不包含仅在实现中声明的临时变量。用途来自实际 CSS 属性,不是对外新增的 Props。
8
+
9
+ 定义值依赖所列尺寸、变体、状态和媒体作用域;Alias 引用还会随 light/dark 主题改变。它们不是统一默认值或最终计算值。作用域用于解释定义位置,不代表内部选择器是稳定的定制 API。
10
+
11
+ | Token | 用途(CSS 属性) | 定义值 | 定义作用域 |
12
+ | --- | --- | --- | --- |
13
+ | `--drawer-fill-default` | `background-color` | `var(--apex-fill-neutral-secondary)` | `.apex-drawer.apex-default-drawer` |
14
+ | `--drawer-spacing-header` | `height`、`line-height` | `var(--apex-size-40)` | `.apex-drawer.apex-default-drawer` |
15
+ | `--drawer-spacing-padding` | `padding` | `var(--apex-spacing-16)` | `.apex-drawer.apex-default-drawer` |
16
+ | `--drawer-spacing-width` | `flex`、`max-width`、`width` | `var(--apex-size-800)` | `.apex-drawer.apex-default-drawer` |
17
+ | `--drawer-stroke-default` | `border-bottom`、`border-left` | `var(--apex-stroke-neutral-quinary)` | `.apex-drawer.apex-default-drawer` |
18
+ | `--drawer-stroke-stroke` | `border-bottom`、`border-left` | `var(--apex-border-1)` | `.apex-drawer.apex-default-drawer` |
19
+ | `--drawer-text-default` | `color` | `var(--apex-text-neutral-primary)` | `.apex-drawer.apex-default-drawer` |
20
+ | `--header-spacing-height` | `height`、`line-height` | `var(--apex-size-48)` | `.apex-header.apex-default-header` |
21
+ | `--header-spacing-padding-x` | `padding` | `var(--apex-spacing-24)` | `.apex-header.apex-default-header` |
22
+ | `--header-spacing-padding-y` | `padding` | `var(--apex-spacing-8)` | `.apex-header.apex-default-header` |
23
+ | `--layout-spacing-padding` | `padding` | `var(--apex-spacing-24)` | `.apex-layout.apex-defalut-layout` |
24
+ | `--menu-spacing-padding-x` | `padding` | `var(--apex-spacing-8)` | `.apex-menu.apex-container-md-menu` |
25
+ | `--menu-spacing-padding-x` | `padding` | `var(--apex-spacing-4)` | `.apex-menu.apex-container-sm-menu` |
26
+ | `--menu-spacing-padding-y` | `padding` | `var(--apex-spacing-12)` | `.apex-menu.apex-container-md-menu` |
27
+ | `--menu-spacing-padding-y` | `padding` | `var(--apex-spacing-8)` | `.apex-menu.apex-container-sm-menu` |
28
+ | `--menu-stroke-stroke` | `border-right` | `var(--apex-border-1)` | `.apex-menu.apex-container-md-menu` |
29
+ | `--menu-stroke-stroke` | `border-right` | `var(--apex-border-1)` | `.apex-menu.apex-container-sm-menu` |