Keel v0.5.1 English GitHub

Rating

在线示例:这是真实的 Keel 程序编译成 WebAssembly,可以直接操作。首次加载约 10 MB。全屏打开
示例代码Go · 可复制

这是上方组件库展示案例的完整源码。examples/components/rating.go

在脚手架项目中复用组件构造和 Render 写法;示例的 registerSection 与共享辅助函数由组件库提供。

package main

import (
	"github.com/dyike/keel/ui/core"
	"github.com/dyike/keel/ui/el"
	"github.com/dyike/keel/ui/kit"
	"github.com/dyike/keel/ui/theme"
)

func init() {
	registerSection("rating", "inputs", func() core.Widget {
		mine := kit.Rating(demoText("Your rating · Click a filled star again to reduce the rating", "你的评分 · 再点已填星可减分"), 5).Size(32)
		avg := kit.Rating(demoText("Average 3.7/5 · Small", "平均 3.7/5 · 小尺寸"), 5).Size(16).ReadOnly()
		avg.SetScore(3.7)
		half := kit.Rating(demoText("Average 4.5/5", "平均 4.5/5"), 5).ReadOnly()
		half.SetScore(4.5)
		return el.Embed(el.ViewFunc(func(cx *el.Context) el.Element {
			return el.Div().P(24).Gap(14).Items(el.Start).Child(mine.Render(cx), avg.Render(cx), half.Color(theme.PrimaryText).Render(cx))
		}))
	})
}

星级评分。

score := kit.Rating("评分", 5).OnChange(func(n int) { … })
avg := kit.Rating("平均", 5).ReadOnly()
avg.SetScore(3.7)
  • 点击未填充的第 i 颗星设为 i 分;点击已填充星设为 i−1 分(例如 4 分时点第 2 颗变为 1 分,点第 1 颗清零);获得焦点后 ← → 调整,Home / End 跳到 0 或满分。悬停时预览将要设置的分数。
  • Score() / SetScore(float64) 保留小数评分,用星形的横向填充比例显示半星或任意小数。ReadOnly() 下不能点击或用按键改变;编辑模式仍按整星选择。NaN 归零,无穷值钳制到 0 或满分,程序设置不触发回调。
  • Value() 返回整数部分,兼容已有整数评分;读取平均分使用 Score()。
  • Value() / SetValue(限制在 0–max)、ReadOnly()、SetDisabled。

Agent:角色 slider,value 为"分数/满分",如 3/5。

验证:go run ./examples/components -section rating,加 -theme dark 检查深色。

Size(dp) 设置每颗星的尺寸,范围 8–128dp,默认 22;非法值忽略,不改变评分。Color(color.NRGBA{...}) 改变填充颜色,默认随主题使用 Warning,轮廓保留 Muted。颜色也用于悬停预览和小数填充。悬停预览点击后的分数,实际值与回调只在操作时改变;尺寸较大或星数较多时由父容器提供足够宽度。