# @adminjs/themes 中文文档

规范地址：https://npmcn.com/package/%40adminjs/themes/

版本：1\.0\.1
npm 元数据更新时间：2023-09-18T10:58:45.525Z
中文译文更新时间：2026-11-05T21:03:02.418Z
软件包许可：SEE LICENSE IN LICENSE

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

原始 npm 页面：https://www.npmjs.com/package/%40adminjs/themes
原文对照：https://npmcn.com/package/%40adminjs/themes/?lang=original
项目主页：https://github.com/SoftwareBrothers/adminjs-themes#readme
源码仓库：https://github.com/SoftwareBrothers/adminjs-themes

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

- 包体积（解压后）：33.1 kB，48 个文件
- 模块格式：ESM + CJS
- TypeScript 类型：包内自带
- 运行依赖：18 个
- peer 依赖：adminjs ^7\.0\.0
- 首次发布：2023-04-04T10:34:39.040Z
- 最新版本发布：2023-09-18T10:58:45.321Z
- 近 30 天下载量：21728（2026-10-05 至 2026-11-03，npm 官方下载统计）
- 已发布版本数：8（近 12 个月 0 个）

## 中文简介

主题允许您更改您的管理面板的样式和默认组件 。 每个主题在app中增加了三个要素:

## 安装

```sh
npm install @adminjs/themes
```

也可以使用：`pnpm add @adminjs/themes`、`yarn add @adminjs/themes`、`bun add @adminjs/themes`

## README

# 行政管理部门的主题

主题允许您更改您的管理面板的样式和默认组件 。 每个主题在app中增加了三个要素:

`component overrides` - 反应组件,以取代可支配组件的子集

`theme overrides for @adminjs/design-system` - 合并到默认配置中, 然后在顶端应用用户的品牌

`custom CSS styles` - 一个具有额外主题样式的全球CSS文件

## 在行政JS中导入主题

### 设置

您可以添加可用的主题配置选项, 包含一系列主题对象( 例如从 @ adminjs/ toemes 包导入) 或本地捆绑的主题 `@adminjs/themes` CLI管理主题捆绑。 列表中的第一个主题默认是活动. 默认情况下可以更改 主题选项 - 指定主题的ID - 这些通常与命名的导出相同.

```ts
import AdminJS from 'adminjs'
import { light, dark } from '@adminjs/themes'

new AdminJS({
  defaultTheme: 'dark', // same as `dark` from id in the theme index file,
  availableThemes: [light, dark],
})
```

组合和样式路径取自 @adminjs/主题, 如果主题得到库的正式支持, 或者可以从本地路径导入, 如:

```ts
import path from 'path';
import * as url from 'url';

const __dirname = url.fileURLToPath(new URL('.', import.meta.url));

new AdminJS({
  defaultTheme: 'my-custom-theme',
  availableThemes: {
    id: 'my-custom-theme',
    name: 'my custom theme',
    overrides: {
      colors: {
        primary100: '#f00',
      },
    },
    bundlePath: `${path.join(__dirname, `../themes/my-custom-theme`)}/theme.bundle.js`,
    stylePath: `${path.join(__dirname, `../themes/my-custom-theme`)}/style.css`,
  },
});
```

@adminjs/ toemes example app中提供了完整的例子 .

### 用户主题

此外,主题可以通过返回当前Admin对象主题属性中的主题ID来配置每个用户,这应该通过框架插件执行,即认证函数在@adminjs/express中. 由于您完全控制了该对象,返回的主题可以根据用户在数据库中的角色或属性来选择.

改变主题没有UI控制,但你可以自己执行. 一般的想法是将主题ID保留在用户资源中,并添加一个按钮来用所选主题来更新当前用户记录. 或者,您可以让用户编辑自己的记录并提供自定义选择属性。 注意, 对于当前 Admin 对象更新用户最可能需要再次签名 .

### 国 际

您可以使用 `@adminjs/themes` 克丽 退出寄存器后,您可以在您的机器上注册 cli `yarn register:cli`。在此之后,您可以使用 `adminjs-themes` 在您的命令行中.

行政部门 主题 CLI 提供命令 :

-   `adminjs-themes generate <theme name>` - 用推荐的文件结构创建新主题.
-   `adminjs-themes bundle` - 包覆所有主题组件 您可以通过主题ID作为捆绑 single 主题的参数.

更多信息请使用命令 `adminjs-themes bundle --help`

## 使用量

请看 [文档](https://docs.adminjs.co/ui-customization/writing-your-own-components#theming)。 。 。 .

## 许可证

AdminJS拥有2023rst.software的版权. 它是一种自由软件,可按下列规定重新分配: [自由主义](https://npmcn.com/package/%40adminjs/themes/LICENSE.md) 文档.

## 关于 rst. 软件

![](https://pbs.twimg.com/profile_images/1367119173604810752/dKVlj1YY_400x400.jpg)

我们是一个开放、友好的团队.

-   我们随时可以 [雇用](https://www.rst.software/estimate-your-project)。 。 。 .
-   如果你想为我们工作.. [职业页面](https://www.rst.software/join-us)。 。 。 .

## 常见问题

### @adminjs/themes 是什么？

主题允许您更改您的管理面板的样式和默认组件 。 每个主题在app中增加了三个要素:

### 如何安装 @adminjs/themes？

在项目目录运行 npm install @adminjs/themes，或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖：adminjs（^7\.0\.0）。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖，Yarn 需要手动安装。它还提供命令行工具 adminjs-themes，可以用 npx adminjs-themes 直接运行。

### @adminjs/themes 支持 TypeScript 吗？

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

### @adminjs/themes 支持 ESM 还是 CommonJS？

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

### @adminjs/themes 可以商用吗？

@adminjs/themes 使用 SEE LICENSE IN LICENSE 许可。许可条款写在包内的独立文件中，请阅读该文件确认可否商用。以上为概括，不构成法律意见，请以许可原文为准。

### @adminjs/themes 的下载量有多少？

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

### @adminjs/themes 还在维护吗？

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