iter(g122): 评分组件支持 allowHalf 半星
This commit is contained in:
+5
-3
@@ -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 可调
|
||||
|
||||
Reference in New Issue
Block a user