Forms: components 041-050
This commit is contained in:
53 files changed
+4341
-1
No files matched your search
@@ -0,0 +1,46 @@
|
||||
# 046 Rating
|
||||
|
||||
评分。
|
||||
|
||||
## 用途
|
||||
|
||||
以星形显示和设置评分,支持半星等步长、只读展示和数值说明。
|
||||
|
||||
## 最小示例
|
||||
|
||||
```go
|
||||
stars := 3.5
|
||||
view := func(c *ui.Context) {
|
||||
mujica.Use(c, mujica.Settings{})
|
||||
mujica.Rating(c, &stars, mujica.RatingOptions{Step: 0.5, ShowValue: true})
|
||||
}
|
||||
ui.Render(view, 400, 300, 1)
|
||||
```
|
||||
|
||||
## 参数
|
||||
|
||||
| 字段 | 类型 | 默认值 | 含义 |
|
||||
| --- | --- | --- | --- |
|
||||
| `value` | `*float64` | 必填 | 评分,0 到 Max。 |
|
||||
| `Max` | `int` | 5 | 星数;负数 panic。 |
|
||||
| `Step` | `float64` | 1 | 最小变化量,须整除 1(如 0.5、0.25);否则 panic。 |
|
||||
| `ReadOnly` | `bool` | false | 只显示,可聚焦以便读出数值。 |
|
||||
| `Disabled` | `bool` | false | 禁用。 |
|
||||
| `Label` | `string` | 内置“Rating/评分” | 无障碍名称。 |
|
||||
| `ShowValue` | `bool` | false | 在星形右侧显示“3.5 / 5”。 |
|
||||
|
||||
## 状态
|
||||
|
||||
默认、悬停(预览指针处的数值)、按下拖动、聚焦(焦点环)、只读、禁用。
|
||||
|
||||
## 事件
|
||||
|
||||
`RatingParts.Changed()` 用户设置了新值;同值点击不触发。
|
||||
|
||||
## 键盘操作
|
||||
|
||||
→/↑ 增加一个步长,←/↓ 减少,Home 清零,End 满分。
|
||||
|
||||
## 限制
|
||||
|
||||
- 屏幕阅读器以滑块角色读出名称,数值通过说明“3.5 of 5”提供;MyGo 未公开为自定义元素设置数值范围的接口。
|
||||
Reference in new issue
Block a user