# @nanahoshi/mona-ui 中文文档 规范地址：https://npmcn.com/package/%40nanahoshi/mona-ui/ 版本：0\.23\.0 npm 元数据更新时间：2026-11-01T22:15:55.135Z 中文译文更新时间：2026-11-01T23:23:16.452Z 软件包许可：未声明 本文由上游 README 机器翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。 原始 npm 页面：https://www.npmjs.com/package/%40nanahoshi/mona-ui 原文对照：https://npmcn.com/package/%40nanahoshi/mona-ui/?lang=original 项目主页：https://github.com/nanahoshi-dev/mona-ui#readme 源码仓库：https://github.com/nanahoshi-dev/mona-ui ## 关键信息（来自 npm 元数据） - 包体积（解压后）：8.1 MB，236 个文件 - 模块格式：ES Module - TypeScript 类型：包内自带 - 运行依赖：15 个 - peer 依赖：rxjs ^7\.8\.2，@tiptap/pm ^3\.26\.1，@angular/cdk \>=22\.0\.0 \<24\.0\.0，@tiptap/core ^3\.26\.1，@angular/core \>=22\.0\.0 \<24\.0\.0，@angular/forms \>=22\.0\.0 \<24\.0\.0，@angular/common \>=22\.0\.0 \<24\.0\.0，@angular/router \>=22\.0\.0 \<24\.0\.0，@angular/compiler \>=22\.0\.0 \<24\.0\.0，@tiptap/starter-kit ^3\.26\.1，@tiptap/extension-link ^3\.26\.1，@tiptap/extension-color ^3\.26\.1，@tiptap/extension-image ^3\.26\.1，@tiptap/extension-table ^3\.26\.1，@angular/platform-browser \>=22\.0\.0 \<24\.0\.0，@tiptap/extension-highlight ^3\.26\.1，@tiptap/extension-subscript ^3\.26\.1，@tiptap/extension-table-row ^3\.26\.1，@tiptap/extension-task-item ^3\.26\.1，@tiptap/extension-task-list ^3\.26\.1，@tiptap/extension-underline ^3\.26\.1，@tiptap/extension-table-cell ^3\.26\.1，@tiptap/extension-text-align ^3\.26\.1，@tiptap/extension-text-style ^3\.26\.1，@tiptap/extension-font-family ^3\.26\.1，@tiptap/extension-superscript ^3\.26\.1，@tiptap/extension-table-header ^3\.26\.1，@angular/platform-browser-dynamic \>=22\.0\.0 \<24\.0\.0 - 首次发布：2026-07-09T22:53:11.211Z - 最新版本发布：2026-11-01T22:15:54.809Z - 已发布版本数：44（近 12 个月 44 个） ## 中文简介 一个非常轻量级的Angular UI框架 ## 安装 ```sh npm install @nanahoshi/mona-ui ``` 也可以使用：`pnpm add @nanahoshi/mona-ui`、`yarn add @nanahoshi/mona-ui`、`bun add @nanahoshi/mona-ui` ## README # 莫娜UI 一个现代的、高性能的、可访问的UI组件库，为Angular构建，并使用顺风CSS样式。 * * * ## 功能 - **基于信号的状态和响应架构：** 一流的Angular信号架构，用于细粒度的反应性。 - **独立的组件:** 专为现代Angular独立组件设计。 - **综合国际化（i18n）：** 零配置英语默认值，具有完整的运行时语言环境切换、类型化消息名称空间和消息覆盖优先级。 - **RTL-Ready:** 充分准备了从右到左的布局方向与CSS逻辑属性和cdk驱动的方向性。 - **高级可达性（a11y）：** 严格遵守WCAG AA最低标准，动态ARIA属性，零AXE违规。 - **40+丰富的组件：** 数据网格、交互式图表、日历/选择器、富文本编辑器、滚动视图、对话框、下拉框等等。 * * * ## 文档 - [国际化（i18n） & RTL指南](https://npmcn.com/package/%40nanahoshi/mona-ui/docs/i18n.md) - [组件迁移清单](https://npmcn.com/package/%40nanahoshi/mona-ui/docs/internal/i18n-rtl-migration-inventory.md) * * * ## 快速入门 ### 安装 ```bash npm install @nanahoshi/mona-ui ``` ### 设置国际化 Mona UI是开箱即用的英文版本，无需配置。若要提供自定义区域设置或配置运行时语言切换，请导入 `provideMonaI18n`： ```typescript import { ApplicationConfig } from '@angular/core'; import { provideMonaI18n } from '@nanahoshi/mona-ui/i18n'; export const appConfig: ApplicationConfig = { providers: [ provideMonaI18n() ] }; ``` 有关本地化、语言环境切换和RTL支持的完整详细信息，请参阅 [i18n & RTL指南](https://npmcn.com/package/%40nanahoshi/mona-ui/docs/i18n.md). * * * ## 开发 ### 图书馆建设 ```bash npm run build:metadata npm run build:prod ``` ### 运行测试 ```bash # Run unit tests for the component library npm run test:lib # Run unit tests for the tester app npm run test:app ``` ### i18n & RTL质量审核 Mona UI包含一个自动的基于ast的扫描器，用于验证没有引入硬编码的英文文本、静态ARIA标签或物理CSS属性： ```bash npm run audit:i18n-rtl:strict ``` * * * ## 许可证 麻省理工学院 ## 常见问题 ### @nanahoshi/mona-ui 是什么？ 一个非常轻量级的Angular UI框架 ### 如何安装 @nanahoshi/mona-ui？ 在项目目录运行 npm install @nanahoshi/mona-ui，或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖：rxjs（^7\.8\.2）、@tiptap/pm（^3\.26\.1）、@angular/cdk（\>=22\.0\.0 \<24\.0\.0）、@tiptap/core（^3\.26\.1）、@angular/core（\>=22\.0\.0 \<24\.0\.0）、@angular/forms（\>=22\.0\.0 \<24\.0\.0）、@angular/common（\>=22\.0\.0 \<24\.0\.0）、@angular/router（\>=22\.0\.0 \<24\.0\.0）、@angular/compiler（\>=22\.0\.0 \<24\.0\.0）、@tiptap/starter-kit（^3\.26\.1）、@tiptap/extension-link（^3\.26\.1）、@tiptap/extension-color（^3\.26\.1）、@tiptap/extension-image（^3\.26\.1）、@tiptap/extension-table（^3\.26\.1）、@angular/platform-browser（\>=22\.0\.0 \<24\.0\.0）、@tiptap/extension-highlight（^3\.26\.1）、@tiptap/extension-subscript（^3\.26\.1）、@tiptap/extension-table-row（^3\.26\.1）、@tiptap/extension-task-item（^3\.26\.1）、@tiptap/extension-task-list（^3\.26\.1）、@tiptap/extension-underline（^3\.26\.1）、@tiptap/extension-table-cell（^3\.26\.1）、@tiptap/extension-text-align（^3\.26\.1）、@tiptap/extension-text-style（^3\.26\.1）、@tiptap/extension-font-family（^3\.26\.1）、@tiptap/extension-superscript（^3\.26\.1）、@tiptap/extension-table-header（^3\.26\.1）、@angular/platform-browser-dynamic（\>=22\.0\.0 \<24\.0\.0）。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖，Yarn 需要手动安装。 ### @nanahoshi/mona-ui 支持 TypeScript 吗？ 支持。包内自带 TypeScript 类型声明（package\.json 声明了 types 入口），安装后即可获得类型提示，无需再安装 @types 包。 ### @nanahoshi/mona-ui 支持 ESM 还是 CommonJS？ 以 ES Module 形式发布，推荐使用 import 引入。在 CommonJS 项目中，Node\.js 20\.19\+ / 22\.12\+ 可以直接 require\(\) 不含顶层 await 的 ES Module，更早的版本需要改用动态 import\(\)。 ### @nanahoshi/mona-ui 可以商用吗？ @nanahoshi/mona-ui 使用 未声明 许可。package\.json 没有声明许可证。没有许可证的代码默认保留全部权利，商用前请联系作者或查看仓库中的 LICENSE 文件。以上为概括，不构成法律意见，请以许可原文为准。 ### @nanahoshi/mona-ui 还在维护吗？ 最新版本 0\.23\.0 发布于 2026/11/02（1 天前）；至今共发布 44 个版本，其中过去 12 个月发布了 44 个；首次发布于 2026/07/10。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。