卡通头像 · Toon Head

卡通头像，可组合服装、胡须和后发。

安装

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

生成头像

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

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

// “ToonHead” by Johan Melin, CC BY 4.0 — credit the author where the avatar is used.
const avatar = createAvatar(toonHead, {
  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 { toonHead } from '@dicebear/collection';

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

选项

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

此风格专有选项: beard, beardProbability, body, clothes, clothesColor, eyebrows, eyes, hair, hairColor, hairProbability, head, mouth, rearHair, rearHairProbability, skinColor.

完整选项说明见 https://www.dicebear.com/styles/toon-head/

许可与署名

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