Keel v0.5.1 English GitHub

Avatar

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

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

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

package main

import (
	"bytes"
	"encoding/base64"
	"image"
	"image/color"
	"image/png"

	"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("avatar", "display", func() core.Widget {
		img := image.NewNRGBA(image.Rect(0, 0, 80, 40))
		for y := 0; y < 40; y++ {
			for x := 0; x < 80; x++ {
				img.SetNRGBA(x, y, color.NRGBA{R: uint8(x * 3), G: 140, B: uint8(y * 6), A: 255})
			}
		}
		var encoded bytes.Buffer
		if err := png.Encode(&encoded, img); err != nil {
			panic(err)
		}
		return el.Embed(&avatarGallery{
			photo:  kit.Avatar(demoText("Sample image", "示例图片")).Image(img),
			source: kit.Avatar(demoText("Async image", "异步图片")).Source("data:image/png;base64," + base64.StdEncoding.EncodeToString(encoded.Bytes())),
		})
	})
}

type avatarGallery struct{ photo, source *kit.AvatarView }

func (v *avatarGallery) Render(cx *el.Context) el.Element {
	return el.Div().Row().Wrap().Gap(16).Items(el.Center).Child(kit.Avatar(demoText("Alex Chen", "张三")).Status(kit.AvatarOnline).Size(32).Render(cx), kit.Avatar("Ada Lovelace").Status(kit.AvatarBusy).Render(cx), kit.Avatar("").Size(56).Render(cx), v.photo.Render(cx), v.source.Render(cx),
		kit.Avatar("Keel Team").Size(48).Rounded(theme.RadiusLg).Colors(theme.Primary, theme.OnColor).Render(cx),
		kit.Avatar("Bob").Size(48).Border(2, theme.Primary).Render(cx),
		kit.Avatar("").Size(48).Placeholder(kit.IconSettings).Rounded(theme.RadiusMd).Render(cx))
}

kit.Avatar("张三").Size(40).Status(kit.AvatarOnline) 显示圆形头像,Size 接受 float32 dp,推荐小、中、大尺寸为 24、40、56。Image 接受已解码的 image.Image,nil 恢复姓名回退。后台加载完成后用 core.Update 更新。

中文取第一个字,英文取前两个单词首字母,空姓名显示问号。背景根据姓名哈希从当前主题选取。Status 支持 AvatarOnline、AvatarBusy、AvatarOffline,空值隐藏;状态点位于头像内部,不改变布局。

Agent 角色 avatar,名字为人名,value 为状态,无状态为空。纯展示,不处理键盘。验证:go run ./examples/components -section avatar -theme dark,省略 theme 查看浅色。

Source(url) 在后台加载头像,支持 data URL、本地路径、file URL,以及引入 ui/netimage 后的 HTTP(S);PNG、JPEG、GIF 首帧、WebP 和 SVG。加载期间或失败时显示姓名回退,直径不变。默认请求超时 15 秒,编码数据上限 16 MiB,解码图片上限 3200 万像素。浏览器环境中的 HTTP 请求仍受 CORS 限制。

avatar := kit.Avatar("Ada Lovelace").Source("https://example.com/ada.png")

同一实例重复设置相同来源不会重新请求。Loading() 查询加载状态,ImageError() 返回最近的加载错误,Retry() 重新请求当前来源。切换来源、调用 Image 或 Source("") 会取消旧请求,迟到结果不会覆盖新状态。Source("") 恢复姓名回退;加载完成通过 core.Update 在下一帧应用。头像卸载时可调用 Source("") 取消尚未结束的请求。

不做跨实例图片缓存;需要认证请求或统一缓存时,由应用通过 Image 提供像素。直接调用 core.DecodeImage(ctx, source) 可复用同一解码器,应在后台线程使用并自行提供超时。

头像组见 AvatarGroup。

外观

方法 作用
Rounded(dp) 圆角,默认是圆形;团队、应用头像常用圆角方形,如 Rounded(theme.RadiusLg)
Colors(bg, fg) 首字母和占位图标的背景色、文字色;零值保持默认(按名字选底色,文字用 theme.Text)
Border(dp, c) 外圈,如叠放头像之间用 theme.Surface 色的环隔开;0 去掉
Placeholder(icon) 没有图片也没有名字时显示的图标,默认 IconUser;IconNone 什么都不显示
Style(fn) 每帧在默认样式之后调整头像外框,处理以上方法不覆盖的情况

没有名字时显示占位图标,不再显示问号。