# 图标 · Icons

- 页面: https://jiguang132.com/zh/resources/dicebear/docs/icons
- 资源: DiceBear (https://jiguang132.com/zh/resources/dicebear.md)
- 全部指南: https://jiguang132.com/zh/resources/dicebear/docs.md

彩色背景上的单个 Bootstrap 图标。

## 安装

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

## 生成头像

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

```ts
import { createAvatar } from '@dicebear/core';
import { icons } from '@dicebear/collection';

// “Bootstrap Icons” by The Bootstrap Authors, MIT
const avatar = createAvatar(icons, {
  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 组件：

```tsx
import { useMemo } from 'react';
import { createAvatar } from '@dicebear/core';
import { icons } from '@dicebear/collection';

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

## 选项

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

此风格专有选项: `icon`.

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

## 许可与署名

- 设计: Bootstrap Icons — The Bootstrap Authors (https://github.com/twbs/icons)
- 许可: MIT (https://github.com/twbs/icons/blob/main/LICENSE)
- MIT：保留版权和许可声明。
- DiceBear 软件本身为 MIT 许可；软件许可不覆盖风格作品。生成的 SVG 默认带有许可元数据，请保留。

---

JGuang 全部资源索引: https://jiguang132.com/llms.txt