iter: d09 新增滑块 slider 组件

llms-full.txt

@@ -1,6 +1,6 @@
 # @ui-arch 组件库 Agent 文档（无图形版）
 
-> 自动生成于 2026-10-23T08:52:28.012Z，数据源：各包 ua.manifest.json，勿手改。人类版文档站：apps/docs/index.html。
+> 自动生成于 2026-10-23T08:53:00.281Z，数据源：各包 ua.manifest.json，勿手改。人类版文档站：apps/docs/index.html。
 > 组件 = 普通函数，传 props 返回 DOM；状态用 signal 双向绑定：读 signal() 写 signal(v)。
 
 ## 快速上手
@@ -40,7 +40,7 @@
 
 ## @ui-arch/ui（skin-dom）v0.1.0
 
-24 个 DOM 组件，统一用法：组件是普通函数，传入 props 返回 DOM 节点；需要状态时先创建 signal 再双向绑定。引入 CSS：import '@ui-arch/ui/ui.css'（内部已消费 tokens）。
+25 个 DOM 组件，统一用法：组件是普通函数，传入 props 返回 DOM 节点；需要状态时先创建 signal 再双向绑定。引入 CSS：import '@ui-arch/ui/ui.css'（内部已消费 tokens）。
 
 ### button — 按钮 Button
 
@@ -112,6 +112,34 @@ const bio = signal(''); textarea({ value: bio, rows: 4, placeholder: '一句话
 
 现场演示：apps/docs/demo.html#sec-form
 
+### slider — 滑块 Slider
+
+参数：
+
+- value（必填）：Signal<number> —— 当前值信号，双向绑定：拖动写回，外部赋值同步位置
+- min（默认 0）：number —— 最小值；缺省 0
+- max（默认 100）：number —— 最大值；缺省 100
+- step（默认 1）：number —— 步长；缺省 1
+- disabled：boolean | Signal<boolean> —— 禁用态：布尔直接置位，传信号则动态同步
+- showValue（默认 true）：boolean —— 是否右侧显示当前值；缺省 true
+- onChange（回调）：(value: number) => void —— 拖动回调
+
+示例：
+
+```
+const vol = signal(40); slider({ value: vol, min: 0, max: 100, step: 5, onChange: (v) => console.log(v) })
+```
+
+手把手：
+
+1. 创建数值信号（初值在 min/max 区间内），传入 value 完成双向绑定
+2. 用 min / max / step 限定范围与粒度，如 step: 5 只取 5 的倍数
+3. 拖动或按 ←→ 键改变值：原生 range 自带键盘与触屏交互，无需额外处理
+4. 只想看拖动条不显示数字时传 showValue: false；需要自定义展示可自行读 signal
+5. 禁用场景传 disabled（布尔或信号），置灰且不可拖
+
+现场演示：apps/docs/demo.html#sec-slider
+
 ### checkbox — 复选框 Checkbox
 
 参数：
@@ -624,6 +652,7 @@ API 速览：
 - button(props)：按钮，variant = primary | ghost | danger，disabled 支持布尔或信号禁用
 - textField(props)：文本输入，value 信号双向绑定，disabled 支持布尔或信号禁用
 - textarea(props)：多行输入，value 信号双向绑定，disabled 支持布尔或信号禁用
+- slider(props)：滑块，value 信号双向绑定，min/max/step 可配，原生 range 承载键盘交互，右侧可显示当前值
 - checkbox(props)：复选框，checked 信号双向绑定，disabled 支持布尔或信号禁用
 - switchButton(props)：开关，checked 信号双向绑定，disabled 支持布尔或信号禁用
 - select(props)：自绘下拉选择（非原生 select），value 信号双向绑定，点外部 / Esc 关闭，选项弹层带微动画，disabled 支持布尔或信号禁用