iter: e01 新增 inputNumber 数字输入组件(−/+ 步进 + 键盘上下调节,信号双向绑定,min/max/step 夹取)
This commit is contained in:
+27
-1
@@ -1,6 +1,6 @@
|
||||
# @ui-arch 组件库 Agent 文档(无图形版)
|
||||
|
||||
> 自动生成于 2026-10-23T09:06:10.925Z,数据源:各包 ua.manifest.json,勿手改。人类版文档站:apps/docs/index.html。
|
||||
> 自动生成于 2026-10-23T09:49:54.480Z,数据源:各包 ua.manifest.json,勿手改。人类版文档站:apps/docs/index.html。
|
||||
> 组件 = 普通函数,传 props 返回 DOM;状态用 signal 双向绑定:读 signal() 写 signal(v)。
|
||||
|
||||
## 快速上手
|
||||
@@ -96,6 +96,31 @@ const name = signal(''); const el = textField({ value: name, placeholder: '输
|
||||
|
||||
现场演示:apps/docs/demo.html#sec-bind
|
||||
|
||||
### inputNumber — 数字输入 InputNumber
|
||||
|
||||
参数:
|
||||
|
||||
- value(必填):Signal<number> —— 当前值信号,双向绑定(按钮/键盘写回、外部赋值同步)
|
||||
- min:number —— 最小值;缺省无下限
|
||||
- max:number —— 最大值;缺省无上限
|
||||
- step(默认 1):number —— 步长;缺省 1
|
||||
- disabled:boolean | Signal<boolean> —— 禁用态:布尔直接置位,传信号则动态同步
|
||||
- onChange(回调):(value: number) => void —— 值变化回调(已夹取到合法区间)
|
||||
|
||||
示例:
|
||||
|
||||
```
|
||||
const qty = signal(1); const el = inputNumber({ value: qty, min: 1, max: 99, onChange: (v) => console.log(v) })
|
||||
```
|
||||
|
||||
手把手:
|
||||
|
||||
1. 用 signal(1) 创建数字信号并传入 value 完成双向绑定
|
||||
2. 点击 −/+ 按钮或在输入框聚焦时按 ↑↓ 以 step 调节;直接输入在失焦或回车时解析
|
||||
3. 非法输入自动回滚为当前值;min/max 超界自动夹取,disabled 支持布尔或信号禁用
|
||||
|
||||
现场演示:apps/docs/demo.html#sec-inputnumber
|
||||
|
||||
### textarea — 多行输入 Textarea
|
||||
|
||||
参数:
|
||||
@@ -755,6 +780,7 @@ API 速览:
|
||||
|
||||
- button(props):按钮,variant = primary | ghost | danger,disabled 支持布尔或信号禁用
|
||||
- textField(props):文本输入,value 信号双向绑定,disabled 支持布尔或信号禁用
|
||||
- inputNumber(props):数字输入,−/+ 按钮 + 键盘 ↑↓ 调节,value 信号双向绑定,min/max/step 超界自动夹取
|
||||
- textarea(props):多行输入,value 信号双向绑定,disabled 支持布尔或信号禁用
|
||||
- slider(props):滑块,value 信号双向绑定,min/max/step 可配,原生 range 承载键盘交互,右侧可显示当前值
|
||||
- checkbox(props):复选框,checked 信号双向绑定,disabled 支持布尔或信号禁用
|
||||
|
||||
Reference in New Issue
Block a user