# @gopherium/godmin 中文文档

规范地址：https://npmcn.com/package/%40gopherium/godmin/

版本：0\.32\.0
npm 元数据更新时间：2026-11-07T23:53:45.079Z
中文译文更新时间：2026-11-17T14:38:26.893Z
软件包许可：Apache-2\.0

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

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

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

- 包体积（解压后）：561 kB，131 个文件
- 模块格式：ES Module
- TypeScript 类型：包内自带
- 运行依赖：0 个
- peer 依赖：react ^19\.2\.0，vitest ^4\.1\.10 \|\| ^5\.0\.0，stylelint ^16 \|\| ^17，@wordpress/ui \>=0\.25\.0 \<0\.26\.0，@wordpress/a11y \>=5\.0\.0 \<6\.0\.0，@wordpress/date \>=6\.0\.0 \<7\.0\.0，@wordpress/i18n \>=7\.0\.0 \<8\.0\.0，@wordpress/icons \>=19\.0\.0 \<20\.0\.0，@wordpress/theme \>=3\.0\.0 \<4\.0\.0，@wordpress/dataviews \>=21\.0\.0 \<22\.0\.0，@tanstack/react-router ^1\.170\.44，@testing-library/react ^16\.3\.2，@wordpress/style-runtime \>=0\.14\.0 \<0\.15\.0
- 首次发布：2026-07-30T15:58:07.021Z
- 最新版本发布：2026-11-07T23:53:44.693Z
- 近 30 天下载量：4820（2026-10-17 至 2026-11-15，npm 官方下载统计）
- 已发布版本数：44（近 12 个月 44 个）

## 中文简介

Gopherium 项目的管理员包:WordPress设计系统中用于重现管理员应用程序的主机层.

## 安装

```sh
npm install @gopherium/godmin
```

也可以使用：`pnpm add @gopherium/godmin`、`yarn add @gopherium/godmin`、`bun add @gopherium/godmin`

## README

# 鬼灵精

Gopherium 的管理员包

GodMin 是一个基于 WordPress 的 React 管理员应用程序的基础层 设计系统. 它处理这种申请所需的基础工作,然后才能处理 第一个屏幕使: 装入设计符, 命令 CSS, 保存 顶上覆上 准备你的包和测试跑道.

设计系统已经把信物、原始物、数据屏幕 都运走了 和页铬。 在WordPress里,下面的胶水来自 语出自相. 非 WordPress 的应用程序获得一无所有, 并结束 手写胶水 Godmin是包装的胶水, 没有什么了.

**[文档](https://docs.gopherium.org/admin-ui/overview/)**

本包中的同页船 [`docs/`](https://npmcn.com/package/%40gopherium/godmin/docs/overview.md)这样 您可以读取符合您安装的版本.

## 安装

```sh
pnpm add @gopherium/godmin
```

设计系统包是同级依赖,所以您的应用程序解决了 和钉住他们。 神明从不重新分配.

## 设置

在您进入点导入样式表, 然后挂载 `AdminRoot` 周围 你的树.

```tsx
import '@gopherium/godmin/base.css'
import { AdminRoot } from '@gopherium/godmin'

createRoot(document.getElementById('app')!).render(
    <AdminRoot>
        <YourApp />
    </AdminRoot>,
)
```

这是整个主机设置。 见 [概览](https://npmcn.com/package/%40gopherium/godmin/docs/overview.md) 为了什么 这两行都是为了你.

## 里面有什么东西

| 入境点 | 目录 |
| --- | --- |
| `@gopherium/godmin` | `AdminRoot`, (中文(简体) ), `Frame`, (中文(简体) ), `Page`, (中文(简体) ), `PageTitle`, (中文(简体) ), `PageTabs`, (中文(简体) ), `PageTab`, (中文(简体) ), `PageBreadcrumbs`, (中文(简体) ), `PageBreadcrumb`, (中文(简体) ), `SectionTitle`, (中文(简体) ), `InitialsAvatar`, (中文(简体) ), `NavigationScreen`, (中文(简体) ), `MenuCount`, (中文(简体) ), `ErrorNotice`, (中文(简体) ), `LoadMore`, (中文(简体) ), `LogList`, (中文(简体) ), `LogItem`, (中文(简体) ), `LogTime`, (中文(简体) ), `LoadingScreen`, (中文(简体) ), `Toaster`, (中文(简体) ), `useToaster`, (中文(简体) ), `RepeatRows`, (中文(简体) ), `RowControls`, (中文(简体) ), `useRowKeys`, (中文(简体) ), `keyFromLabel`, (中文(简体) ), `listChromeCatalogFor`, (中文(简体) ), `LIST_CHROME_DOMAIN`, (中文(简体) ), `ListEmpty`, (中文(简体) ), `ListNoResults`, (中文(简体) ), `ConfirmDialog`, (中文(简体) ), `FormDialog`, (中文(简体) ), `RenameDialog`, (中文(简体) ), `FileButton`, (中文(简体) ), `useServerPaging`, (中文(简体) ), `pageWindow`, (中文(简体) ), `paginationOf`, (中文(简体) ), `runEach`, (中文(简体) ), `bulkNotes`, (中文(简体) ), `useListRun`, (中文(简体) ), `useBulkRun`, (中文(简体) ), `useDialogRun`, (中文(简体) ), `focusInDialog`, (中文(简体) ), `useFocusBack`, (中文(简体) ), `focusedTrigger`, (中文(简体) ), `openOnTap`, (中文(简体) ), `useUnsavedText`, (中文(简体) ), `markLatest`, (中文(简体) ), `viewNarrows`, (中文(简体) ), `offeredView`, (中文(简体) ), `offeredSize`, (中文(简体) ), `sizedView`, (中文(简体) ), `useMediaQuery`, (中文(简体) ), `useTokenDocument`,断点 `HUGE_BREAKPOINT`, (中文(简体) ), `SIDEBAR_BREAKPOINT`, (中文(简体) ), `EDGE_BREAKPOINT`, (中文(简体) ), `DENSE_BREAKPOINT`, (中文(简体) ), `SHEET_BREAKPOINT`, (中文(简体) ), `TITLE_BREAKPOINT` 财务报告和审定财务报表 `SMALL_VIEWPORT`, (中文(简体) ), `SUPPORTED_WPDS` |
| `@gopherium/godmin/base.css` | 叠加层顺序、设计符号、主机规则、框架和屏幕样式 |
| `@gopherium/godmin/dates` | `startListDates`, (中文(简体) ), `listDate`,唯一装入的条目 `@wordpress/date` |
| `@gopherium/godmin/router` | `Navigation`, (中文(简体) ), `NavigationList`, (中文(简体) ), `NavigationItem`, (中文(简体) ), `DrilldownItem`, (中文(简体) ), `useCanAccess` 编辑 `MenuItem` 类型及其可选 `count`, (中文(简体) ), `useListView`, (中文(简体) ), `listSearch`, (中文(简体) ), `openOnTap`, (中文(简体) ), `useCanvas`, (中文(简体) ), `useFrameLocation`, (中文(简体) ), `routerDefaults`, (中文(简体) ), `UnsavedChangesDialog`,则 `canvas`, (中文(简体) ), `Sidebar` 财务报告和审定财务报表 `capability` 路由静态数据 |
| `@gopherium/godmin/testing` | `installTestEnvironment`, (中文(简体) ), `renderAdmin`, (中文(简体) ), `setViewport` 联 合 国 `TestViewport` 类型, `getAnnouncement`, (中文(简体) ), `clearAnnouncements`, (中文(简体) ), `assertElementPatched`, (中文(简体) ), `WPDS_IGNORE_SELECTOR`, (中文(简体) ), `textClasses`, (中文(简体) ), `badgeClasses`, (中文(简体) ), `buttonClasses`, (中文(简体) ), `stubLayout` |
| `@gopherium/godmin/vite` | `godminDedupe`, (中文(简体) ), `godminSingleCopy`, (中文(简体) ), `godminStylesheetFirst`, (中文(简体) ), `duplicateCopies`, (中文(简体) ), `hoistStylesheet` |
| `@gopherium/godmin/stylelint` | 设计系统样式林特规则 |

## 翻译

Godmin 自己说出几句话: 回到侧边栏屏幕上,名字是 边栏及其电话抽屉、电话菜单按钮和 抽屉的关闭按钮, 只有屏幕阅读器相遇, “没有结果 ” 找到的,下面的线条 `ListNoResults` 显示。 这个 在WordPress中翻译 `default` 文本域,作为 `@wordpress/ui` 翻译自己的,所以 `@wordpress/i18n` 是需要的对等点。 每个应用 已经有了,因为 `@wordpress/ui` 取决于它.

`listChromeCatalogFor` 返回用于语言的目录 GodMin 船, 今日西班牙语和法语. 都拿着这些单词和列表日期 西班牙人也持有该清单的铬. 装入 `LIST_CHROME_DOMAIN`,则 `default` 域名 :

```ts
import { setLocaleData } from '@wordpress/i18n'
import { LIST_CHROME_DOMAIN, listChromeCatalogFor } from '@gopherium/godmin'

const catalogue = await listChromeCatalogFor('es-ES')
if (catalogue !== undefined) {
    setLocaleData(catalogue, LIST_CHROME_DOMAIN)
}
```

## 在你第一次建造之前

复制包会中断应用程序, 并且不会在原因上指点 . 初入钩上作回相投出出相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相 两份 `@wordpress/theme` 实现无主题组件而无出错。 展开 `godminDedupe` 输入 `resolve.dedupe` 并添加 `godminSingleCopy()` 插件 . [构建配置](https://npmcn.com/package/%40gopherium/godmin/docs/build-and-versioning.md) 并列出 每个版本都支持设计系统版本.

## 发展

`pnpm run cover` 在jsdom中运行单元测试与覆盖门. 故事在 `stories/` 显示故事书中的组件, 打开 与 `pnpm run storybook:dev`。 。 。 . `pnpm run storybook:test` 运行 无头铬中的故事及其无障碍检查,以及 `pnpm run test:browser` 运行浏览器测试 `test/browser/`。 。 。 . 两者都需要铬一次: `pnpm exec playwright install --only-shell chromium`。 。 。 .

## 状态

仍然为0.x,所以小释放可能会被打破. 查看每个版本的变换 增加数字. `@wordpress/admin-ui` 继续观察:神明不包 它,因为一个包裹 API 仍然移动的工具包 增加了一个发布hop 上游修补.

## 许可证

阿帕奇2.0,见LICENSE.

设计系统包 此工具包期望您安装为 GPL2.0-或后发. Godmin宣布他们是同伴的依附者,所以你 应用程序解决了它们,Godmin从不重新分配它们。 你的建筑 捆绑两者结合,并按WordPress的规定传递 软件包。 Godmin自己的源头在Plain Apache-2.0下仍可再用. 通知 对只读已公布的柏油球的任何人来说,都带有同样的语句.

## 常见问题

### @gopherium/godmin 是什么？

Gopherium 项目的管理员包:WordPress设计系统中用于重现管理员应用程序的主机层\.

### 如何安装 @gopherium/godmin？

在项目目录运行 npm install @gopherium/godmin，或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖：react（^19\.2\.0）、@wordpress/ui（\>=0\.25\.0 \<0\.26\.0）、@wordpress/a11y（\>=5\.0\.0 \<6\.0\.0）、@wordpress/i18n（\>=7\.0\.0 \<8\.0\.0）、@wordpress/icons（\>=19\.0\.0 \<20\.0\.0）、@wordpress/theme（\>=3\.0\.0 \<4\.0\.0）、@wordpress/style-runtime（\>=0\.14\.0 \<0\.15\.0）。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖，Yarn 需要手动安装。

### @gopherium/godmin 支持 TypeScript 吗？

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

### @gopherium/godmin 支持 ESM 还是 CommonJS？

以 ES Module 形式发布，推荐使用 import 引入。在 CommonJS 项目中，Node\.js 20\.19\+ / 22\.12\+ 可以直接 require\(\) 不含顶层 await 的 ES Module，更早的版本需要改用动态 import\(\)。

### @gopherium/godmin 可以商用吗？

@gopherium/godmin 使用 Apache-2\.0 许可。宽松许可：允许商业使用、修改和再分发，并附带明确的专利授权；分发时需保留许可与 NOTICE 文件，修改过的文件要注明改动。以上为概括，不构成法律意见，请以许可原文为准。

### @gopherium/godmin 的下载量有多少？

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

### @gopherium/godmin 还在维护吗？

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

