跳到正文

PixelAvatar 像素头像

要给 agent(或其他没有图片的东西)一张自己的脸时,用 PixelAvatar:它由 seed 生成,不用存图片,在哪里都是同一张。人在 Raft 头像编辑器里捏出来的头像,请用 PersonAvatar;上传的图片或名字缩写,请用 Avatar。

PixelAvatar 画出 8×8 的像素头像,也就是 Raft 给 agent 画的那一张:要么根据 seed 字符串生成,要么用 Raft 的 72 个手绘形象之一(sprite)。同一个 seed 永远得到同一张图,所以一个 agent 不用存图片,在哪里都是同一张脸。seed 在这里和 Raft 的 pixel:random:<seed> 画出来的一样,sprite 和 Raft 的 pixel:<名字> 一样。

图案是内联 SVG,边缘锐利(crisp edges),任何尺寸都清晰,服务端渲染结果也一致。像素的颜色来自生成器自己的调色板,只有外框跟随主题。

演示

基础用法

每个 seed 会选中十二种配色之一,再生成左右对称的图案。

手绘形象

sprite 用 Raft 的手绘形象代替 seed。pixelAvatarSpriteSeries 按 Raft 选择器里每组 8 个的顺序列出全部形象。这个版本不认识的名字会画 Raft 的默认形象 robot。

尺寸

small、medium、large 和控件高度一致;传数字则是以 px 为单位的边长。

圆形

round 画成圆形,而不是默认的小圆角。

边框

默认带外框,是一圈细线。bordered={false} 去掉外框,比如头像已经放在别的框里时。

无障碍名称

旁边已有可见的名字时,头像只是装饰,对辅助技术隐藏。单独出现时传 alt:它会成为一张带这个名字的图片。

Props

名称类型默认值说明版本
seedstring—任意字符串,通常是稳定的 id。同一个 seed 永远画出同一个头像。seed 和 sprite 二选一。未发布
spritePixelAvatarSprite—Raft 的手绘形象之一,比如 robot、cat。未发布
sizesmall | medium | large | numbermedium控件高度档位,或以 px 为单位的边长。未发布
roundbooleanfalse画成圆形,而不是主题默认形状。未发布
borderedbooleantrue主题外框。未发布
altstringundefined无障碍名称。不传时头像是装饰性的(aria-hidden)。未发布

其余 props 传给根节点 <span>。size、round、bordered 可以通过 ConfigProvider 的 componentOptions.PixelAvatar 统一设置。

从 Raft 的 avatarUrl 转换:把 pixel:random: 后面的部分作为 seed 传入,或把 pixel: 后面的部分作为 sprite 传入。形象数据用 pnpm --filter @pika-lab/scripts sync:raft-avatars <Raft 仓库目录> 从 Raft 同步过来。