Keel v0.5.1 English GitHub

Badge

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

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

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

package main

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

func init() {
	registerSection("badge", "display", func() core.Widget {
		unread := kit.Badge(9)
		unread.Child(kit.Button(demoText("Notifications", "通知"), func() { unread.SetValue(0) }).Variant(kit.ButtonSecondary))
		online := kit.Badge(1).Dot().Tone(kit.ToneSuccess).Child(kit.Avatar(demoText("Alex Chen", "张三")))
		return el.Embed(el.ViewFunc(func(cx *el.Context) el.Element {
			return el.Div().P(24).Wrap().Gap(24).Items(el.Center).Child(
				unread.Render(cx),
				kit.Button(demoText("Add unread message", "增加未读"), func() { unread.SetValue(unread.Value() + 1) }).Variant(kit.ButtonGhost).Render(cx),
				kit.Badge(120).Render(cx), online.Render(cx),
				kit.Badge(0).Icon(kit.IconCheck).Name(demoText("Verified", "已验证")).Tone(kit.ToneSuccess).Child(kit.Avatar("Ada")).Render(cx),
				kit.Badge(0).Icon(kit.IconStar).Name(demoText("Star", "收藏")).Size(24).Color(color.NRGBA{R: 255, G: 210, A: 255}).Child(kit.Avatar(demoText("Lin", "林"))).Render(cx),
				kit.Badge(3).Size(12).Render(cx), kit.Badge(12).Size(18).Render(cx), kit.Badge(999).Size(24).Max(999).Render(cx))
		}))
	})
}

数字、圆点或图标徽标,可单独显示或挂在子组件角上。

unread := kit.Badge(3).Child(kit.Button("通知", open))
kit.Badge(1).Dot().Tone(kit.ToneSuccess).Child(avatar)
  • 数字和圆点模式下,计数小于等于 0 时隐藏。超过 Max(默认 99)时显示"99+"。
  • 挂在子组件上时,角标画在角上,不改变子组件的尺寸和位置,计数变化也不会让布局跳动。
  • Icon(IconName) 切换为图标模式,与计数无关,即使 count 为 0 也显示。Icon(IconNone) 恢复数字模式;Dot 切换为圆点并清除图标。图标模式位于右下角,带 Surface 色边框;数字和圆点位于右上角。
  • Size(dp) 设置数字/图标高度,默认 18,接受 12–128;推荐 12/18/24。圆点按 8/18 比例缩放,数字超长时宽度随文字增长。非法值忽略。
  • Color(color.NRGBA) 指定底色,前景自动按底色选择黑白。Tone 设置主题语义颜色(默认 ToneDanger),同时清除 Color 覆盖。固定自定义色不自动随主题变化。
  • Name(string) 设置可访问名称,适合图标状态,例如“已验证”;空字符串恢复原始计数名称。Value() / SetValue 操作计数,不改变图标模式。

Agent:角色 badge,默认名字是原始计数,可用 Name 覆盖;value 是显示数字("99+")、dot 或 icon。

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