# @boringer-avatars/vue3 中文文档

规范地址：https://npmcn.com/package/%40boringer-avatars/vue3/

版本：0\.2\.1
npm 元数据更新时间：2023-02-22T02:56:00.544Z
中文译文更新时间：2026-11-08T11:43:41.263Z
软件包许可：MIT

本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。

原始 npm 页面：https://www.npmjs.com/package/%40boringer-avatars/vue3
原文对照：https://npmcn.com/package/%40boringer-avatars/vue3/?lang=original

## 关键信息（来自 npm 元数据）

- 包体积（解压后）：70.9 kB，14 个文件
- 模块格式：ESM + CJS
- TypeScript 类型：包内自带
- 运行依赖：0 个
- peer 依赖：vue ^3\.0\.0
- 首次发布：2022-09-28T01:34:04.408Z
- 最新版本发布：2023-02-22T02:56:00.447Z
- 近 30 天下载量：8411（2026-10-09 至 2026-11-07，npm 官方下载统计）
- 已发布版本数：4（近 12 个月 0 个）

## 中文简介

程序生成 Avatars 用于您的申请 。 使用这些相机作为占位符,直到您的用户上传自己的图像. 几种可选的变体和风格.

## 安装

```sh
npm install @boringer-avatars/vue3
```

也可以使用：`pnpm add @boringer-avatars/vue3`、`yarn add @boringer-avatars/vue3`、`bun add @boringer-avatars/vue3`

## README

# @boringer-avatars/vue3 (英语)

程序生成 Avatars 用于您的申请 。 使用这些相机作为占位符,直到您的用户上传自己的图像. 几种可选的变体和风格.

## 警告: 生成代码

这个库使用\[Mitosis\](https://github.com/BuilderIO/mitosis)生成.

这回贷是从 [无聊的爱好者](https://boringavatars.com/)它旨在为尽可能多的框架建立跨框架的执行。 (Angular, React, Vue, Solid, Svelte, Quik等).

## 安装

```bash
npm install @boringer-avatars/vue3
# or
yarn add @boringer-avatars/vue3
# or
pnpm add @boringer-avatars/vue3
```

## 使用量

```
<script setup>
          import { Avatar } from "@boringer-avatars/vue3";
        </script>

        <template>
          <Avatar
            :title="false"
            :size="400"
            variant="beam"
            name="testing"
            :square="false"
            :colors="['#FFAD08', '#EDD75A', '#73B06F', '#0C8F8F', '#405059']"
          />
        </template>
```

## 道具

您可以传递到组件的选项如下:.

### 需求

-   **名称**: 弦乐. `name` 用于确定每个外观的精确绘图。 这使得每个用户都不同. 您也可以使用ID值而不是名字. 这是唯一的必要值.

### 可选

-   **变体**数字 : `Variant`。确定Avatar的样式。 有效值包括:"像素","bauhaus","环","束","日落","可分". 默认为 `"beam"`。 。 。 .
    
-   **颜色**数字 : `string[]`。一个有效的Hex颜色阵列。 5个不同的颜色是最佳数量. 或多或少还是可行的。 默认为: `["#92A1C6", "#146A7C", "#F0AB3D", "#C271B4", "#C20D90"]`。 。 。 .
    
-   **平方圆**数字 : `boolean`决定阿凡达是圆形还是方形. 默认为: `false`
    
-   **有标题**数字 : `boolean`决定 Avatar 是否显示标题值 。 默认为: `false`
    
-   **大小**数字 : `string`。确定图像的宽度和高度。 您可以使用任何有效的 Css 值 。 例如:"42px","42%","42vw"等. 默认为: `42px`
    

## 许可证

MIT 许可证

版权 (c) 2021 无聊设计师

版权 (c) 2022-2023 cmgriffing

特此免费准许任何人获得副本 ,用于处理 在软件中不受限制,包括不受限制的权利 使用、复制、修改、合并、出版、分发、分许可证和/或出售 软件的复制件,并允许该软件所针对的人 满足下列条件:

上述版权通知和这项许可通知应载入所有 软件的复制件或大部分.

软件是提供的"AS IS", 没有任何的恐惧, EXPRESS OR ,包括但不限制于雇佣军的保障, 特别目的和非目的的证明。 绝对不会 B. 任何索赔、索赔或其他索赔的索赔人或 责任,在契约、契约或其他行为中,产生于, 财产、财产、财产、财产、财产或财产 软件.

## 常见问题

### @boringer-avatars/vue3 是什么？

程序生成 Avatars 用于您的申请 。 使用这些相机作为占位符,直到您的用户上传自己的图像\. 几种可选的变体和风格\.

### 如何安装 @boringer-avatars/vue3？

在项目目录运行 npm install @boringer-avatars/vue3，或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖：vue（^3\.0\.0）。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖，Yarn 需要手动安装。

### @boringer-avatars/vue3 支持 TypeScript 吗？

支持。包内自带 TypeScript 类型声明（package\.json 声明了 types 入口），安装后即可获得类型提示，无需再安装 @types 包。

### @boringer-avatars/vue3 支持 ESM 还是 CommonJS？

同时提供 ES Module 与 CommonJS 入口，import 和 require\(\) 都可以使用，打包工具会自动选择合适的版本。

### @boringer-avatars/vue3 可以商用吗？

@boringer-avatars/vue3 使用 MIT 许可。宽松许可：允许商业使用、修改和再分发，通常只需在分发时保留原版权与许可声明。以上为概括，不构成法律意见，请以许可原文为准。

### @boringer-avatars/vue3 的下载量有多少？

根据 npm 官方下载统计，@boringer-avatars/vue3 在 2026/10/09 – 2026/11/07 这 30 天内被下载 8,411 次，日均约 280 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。

### @boringer-avatars/vue3 还在维护吗？

最新版本 0\.2\.1 发布于 2023/02/22（3 年前）；至今共发布 4 个版本，其中过去 12 个月发布了 0 个；首次发布于 2022/09/28。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。