iter(g145): 滑块支持刻度标注

This commit is contained in:
HIsheR
2026-10-26 15:41:22 +08:00
parent 99214ff867
commit af09500238
8 changed files with 64 additions and 8 deletions
+3 -1
View File
@@ -1,6 +1,6 @@
# @ui-arch 组件库 Agent 文档(无图形版)
> 自动生成于 2026-10-26T07:39:42.119Z,数据源:各包 ua.manifest.json,勿手改。人类版文档站:apps/docs/index.html。
> 自动生成于 2026-10-26T07:41:03.284Z,数据源:各包 ua.manifest.json,勿手改。人类版文档站:apps/docs/index.html。
> 组件 = 普通函数,传 props 返回 DOM;状态用 signal 双向绑定:读 signal() 写 signal(v)。
## 快速上手
@@ -197,6 +197,7 @@ const bio = signal(''); textarea({ value: bio, rows: 4, placeholder: '一句话
- step(默认 1):number —— 步长;缺省 1
- disabled:boolean | Signal<boolean> —— 禁用态:布尔直接置位,传信号则动态同步
- showValue(默认 true):boolean —— 是否右侧显示当前值;缺省 true
- marks:{ value: number; label?: string }[] —— 刻度标注:按值定位在轨道下方,label 缺省显示数值;纯装饰不进读屏(数值由原生 input 播报)
- onChange(回调):(value: number) => void —— 拖动回调
示例:
@@ -212,6 +213,7 @@ const vol = signal(40); slider({ value: vol, min: 0, max: 100, step: 5, onChange
3. 拖动或按 ←→ 键改变值:原生 range 自带键盘与触屏交互,无需额外处理
4. 只想看拖动条不显示数字时传 showValue: false;需要自定义展示可自行读 signal
5. 禁用场景传 disabled(布尔或信号),置灰且不可拖
6. 需要在轨道下方标刻度(如 0 / 50 / 100 的档位含义)传 marks:[{ value, label }],按 min-max 换算百分比定位,容器宽度变化时自动跟随
现场演示:apps/docs/demo.html#sec-slider