iter(g122): 评分组件支持 allowHalf 半星

This commit is contained in:
HIsheR
2026-10-26 14:34:03 +08:00
parent f4a51017ae
commit 72c5d24961
8 changed files with 65 additions and 23 deletions
+5 -3
View File
@@ -1,6 +1,6 @@
# @ui-arch 组件库 Agent 文档(无图形版)
> 自动生成于 2026-10-26T06:30:27.757Z,数据源:各包 ua.manifest.json,勿手改。人类版文档站:apps/docs/index.html。
> 自动生成于 2026-10-26T06:33:37.851Z,数据源:各包 ua.manifest.json,勿手改。人类版文档站:apps/docs/index.html。
> 组件 = 普通函数,传 props 返回 DOM;状态用 signal 双向绑定:读 signal() 写 signal(v)。
## 快速上手
@@ -729,8 +729,9 @@ const step = signal(1); stepper({ steps: [{ label: '下单' }, { label: '支付'
参数:
- value(必填):Signal<number> —— 当前评分(1 基整数值)信号,双向绑定:点选/键盘写回、外部赋值同步
- value(必填):Signal<number> —— 当前评分(1 基,allowHalf 时 0.5 步进)信号,双向绑定:点选/键盘写回、外部赋值同步
- max(默认 5):number —— 星标总数;缺省 5
- allowHalf(默认 false):boolean —— 允许半星:点击星标左半区记 0.5 分,键盘步进同为 0.5;缺省整数
- disabled:boolean | Signal<boolean> —— 禁用态:布尔直接置位,传信号则动态同步
- onChange(回调):(value: number) => void —— 评分变化回调
@@ -745,6 +746,7 @@ const score = signal(0); rate({ value: score, max: 5, onChange: (v) => console.l
1. 用 signal(0) 创建评分信号并传入 value;0 表示未评分
2. 点击星标或聚焦后按 →/↑ 加一分、←/↓ 减一分;悬停高亮预览、移出还原
3. max 可调整星标总数;disabled 支持布尔或信号禁用
4. 要支持半星就传 allowHalf:点星标左半区记 0.5 分,悬停位置实时预览半格填充
现场演示:apps/docs/demo.html#sec-rate
@@ -1689,7 +1691,7 @@ API 速览:
- progress(props):进度条,value 信号驱动 0-100(满格切 success 色);不传 value 退化为不确定态无限往复
- tabs(props):标签页,active 信号双向绑定,滑动指示条 + 方向键环形导航,支持禁用页签;页签项 closable 时带关闭按钮(聚焦后 Delete 同样可关),关闭只回调 onClose 由调用方摘数据
- stepper(props):步骤条,done/current/upcoming 三态,active 信号双向绑定,clickable 时已完成步骤可回跳
- rate(props):评分星标,value 信号双向绑定,hover 预览移出还原,键盘方向键调节,max 可配
- rate(props):评分星标,value 信号双向绑定,hover 预览移出还原,键盘方向键调节,max 可配,allowHalf 开启半星(左半区 0.5 分)
- empty(props):空状态占位,title/description 可选,action 放操作区
- divider(props):分隔线,水平/垂直两种方向,可带居中文案标签,dashed 切虚线
- space(props):间距容器,flex gap 统一子元素间距,direction / size / align / justify / wrap / block 可调