人物画像 · Personas

圆润的人物画像，适合产品、用户画像和调研原型。

安装

npm install @dicebear/core@9.4.2 @dicebear/collection@9.4.2

生成头像

同一个种子（seed）总是生成同一个头像，适合用用户 ID 或用户名作为种子。头像在本地生成，不需要请求网络服务。

import { createAvatar } from '@dicebear/core';
import { personas } from '@dicebear/collection';

// “Personas by Draftbit” by Draftbit - draftbit.com, CC BY 4.0 — credit the author where the avatar is used.
const avatar = createAvatar(personas, {
  seed: 'Aria Chen',
  size: 128,
  radius: 50,
});

export const svg = avatar.toString();     // inline SVG markup
export const dataUri = avatar.toDataUri(); // use as an <img> src

React 组件：

import { useMemo } from 'react';
import { createAvatar } from '@dicebear/core';
import { personas } from '@dicebear/collection';

export function UserAvatar({ seed, size = 64 }: { seed: string; size?: number }) {
  const src = useMemo(() => createAvatar(personas, { seed, size }).toDataUri(), [seed, size]);
  return <img src={src} width={size} height={size} alt={`Avatar for ${seed}`} />;
}

选项

通用选项: seed, size, radius, backgroundColor, flip, rotate, scale.

此风格专有选项: body, clothingColor, eyes, facialHair, facialHairProbability, hair, hairColor, mouth, nose, skinColor.

完整选项说明见 https://www.dicebear.com/styles/personas/

许可与署名

• 设计: Personas by Draftbit — Draftbit - draftbit.com (https://personas.draftbit.com/)
• 许可: CC BY 4.0 (https://creativecommons.org/licenses/by/4.0/)
• CC BY 4.0：使用时须注明作者和许可，例如：“Personas by Draftbit” by Draftbit - draftbit.com, CC BY 4.0。
• DiceBear 软件本身为 MIT 许可；软件许可不覆盖风格作品。生成的 SVG 默认带有许可元数据，请保留。