iter(g03): 输入组件补 prefix/suffix 附加块

llms-full.txt

@@ -1,6 +1,6 @@
 # @ui-arch 组件库 Agent 文档（无图形版）
 
-> 自动生成于 2026-10-23T10:58:48.833Z，数据源：各包 ua.manifest.json，勿手改。人类版文档站：apps/docs/index.html。
+> 自动生成于 2026-10-23T11:03:12.689Z，数据源：各包 ua.manifest.json，勿手改。人类版文档站：apps/docs/index.html。
 > 组件 = 普通函数，传 props 返回 DOM；状态用 signal 双向绑定：读 signal() 写 signal(v)。
 
 ## 快速上手
@@ -104,6 +104,8 @@ button({ label: '提交', variant: 'primary', onClick: () => console.log('clicke
 - placeholder：string —— 占位文案
 - disabled：boolean | Signal<boolean> —— 禁用态：布尔直接置位，传信号则动态同步
 - onInput（回调）：(value: string) => void —— 输入回调，每次按键触发
+- prefix：string | HTMLElement —— 前置附加块（textField/inputNumber 在输入框内侧前、textarea 在上方）；缺省不渲染
+- suffix：string | HTMLElement —— 后置附加块（textField/inputNumber 在输入框内侧后、textarea 在下方）；缺省不渲染
 
 示例：
 
@@ -116,6 +118,7 @@ const name = signal(''); const el = textField({ value: name, placeholder: '输
 1. 先用 signal('') 创建字符串信号
 2. 传入 value 完成双向绑定：用户输入自动写回，外部赋值自动回显
 3. 在任意响应式位置用 name() 读取最新值，如 () => `你好，${name()}`
+4. 需要图标、货币符、单位等前后缀时传 prefix/suffix（字符串或 DOM），控件会包进带边框的附加组，聚焦光环由组统一承载
 
 现场演示：apps/docs/demo.html#sec-bind
 
@@ -129,6 +132,8 @@ const name = signal(''); const el = textField({ value: name, placeholder: '输
 - step（默认 1）：number —— 步长；缺省 1
 - disabled：boolean | Signal<boolean> —— 禁用态：布尔直接置位，传信号则动态同步
 - onChange（回调）：(value: number) => void —— 值变化回调（已夹取到合法区间）
+- prefix：string | HTMLElement —— 前置附加块（textField/inputNumber 在输入框内侧前、textarea 在上方）；缺省不渲染
+- suffix：string | HTMLElement —— 后置附加块（textField/inputNumber 在输入框内侧后、textarea 在下方）；缺省不渲染
 
 示例：
 
@@ -141,6 +146,7 @@ const qty = signal(1); const el = inputNumber({ value: qty, min: 1, max: 99, onC
 1. 用 signal(1) 创建数字信号并传入 value 完成双向绑定
 2. 点击 −/+ 按钮或在输入框聚焦时按 ↑↓ 以 step 调节；直接输入在失焦或回车时解析
 3. 非法输入自动回滚为当前值；min/max 超界自动夹取，disabled 支持布尔或信号禁用
+4. 需要图标、货币符、单位等前后缀时传 prefix/suffix（字符串或 DOM），控件会包进带边框的附加组，聚焦光环由组统一承载
 
 现场演示：apps/docs/demo.html#sec-inputnumber
 
@@ -153,6 +159,8 @@ const qty = signal(1); const el = inputNumber({ value: qty, min: 1, max: 99, onC
 - placeholder：string —— 占位文案
 - disabled：boolean | Signal<boolean> —— 禁用态：布尔直接置位，传信号则动态同步
 - onInput（回调）：(value: string) => void —— 输入回调
+- prefix：string | HTMLElement —— 前置附加块（textField/inputNumber 在输入框内侧前、textarea 在上方）；缺省不渲染
+- suffix：string | HTMLElement —— 后置附加块（textField/inputNumber 在输入框内侧后、textarea 在下方）；缺省不渲染
 
 示例：
 
@@ -165,6 +173,7 @@ const bio = signal(''); textarea({ value: bio, rows: 4, placeholder: '一句话
 1. 创建信号并传入 value
 2. 用 rows 控制初始高度，用户可纵向拉伸
 3. 字数统计等派生逻辑直接在响应式文本里读 bio().length
+4. 需要图标、货币符、单位等前后缀时传 prefix/suffix（字符串或 DOM），控件会包进带边框的附加组，聚焦光环由组统一承载
 
 现场演示：apps/docs/demo.html#sec-form
 
@@ -892,9 +901,9 @@ dataTable({ data: users, selectable: true, columns: [{ key: 'name', header: '姓
 API 速览：
 
 - button(props)：按钮，variant = primary | ghost | danger，disabled 支持布尔或信号禁用
-- textField(props)：文本输入，value 信号双向绑定，disabled 支持布尔或信号禁用
-- inputNumber(props)：数字输入，−/+ 按钮 + 键盘 ↑↓ 调节，value 信号双向绑定，min/max/step 超界自动夹取
-- textarea(props)：多行输入，value 信号双向绑定，disabled 支持布尔或信号禁用
+- textField(props)：文本输入，value 信号双向绑定，disabled 支持布尔或信号，onInput 输入回调；prefix/suffix 可选渲染为输入框内侧附加块
+- inputNumber(props)：数字输入，−/+ 按钮与键盘 ↑↓ 调节，min/max/step 夹取；prefix/suffix 可选渲染为整组前后附加块
+- textarea(props)：多行输入，value 信号双向绑定，disabled 支持布尔或信号，rows 控行数；prefix/suffix 可选渲染为上下附加块
 - slider(props)：滑块，value 信号双向绑定，min/max/step 可配，原生 range 承载键盘交互，右侧可显示当前值
 - checkbox(props)：复选框，checked 信号双向绑定，disabled 支持布尔或信号禁用
 - switchButton(props)：开关，checked 信号双向绑定，disabled 支持布尔或信号禁用