@nanahoshi/mona-ui

中文文档
0.23.0发布于 2026/11/02TypeScriptES Module构建来源已验证

一个非常轻量级的Angular UI框架

中文使用文档
文档目录10 节
  1. 功能
  2. 文档
  3. 快速入门
  4. 安装
  5. 设置国际化
  6. 开发
  7. 图书馆建设
  8. 运行测试
  9. i18n & RTL质量审核
  10. 许可证

莫娜UI

一个现代的、高性能的、可访问的UI组件库,为Angular构建,并使用顺风CSS样式。


功能

  • 基于信号的状态和响应架构: 一流的Angular信号架构,用于细粒度的反应性。
  • 独立的组件: 专为现代Angular独立组件设计。
  • 综合国际化(i18n): 零配置英语默认值,具有完整的运行时语言环境切换、类型化消息名称空间和消息覆盖优先级。
  • RTL-Ready: 充分准备了从右到左的布局方向与CSS逻辑属性和cdk驱动的方向性。
  • 高级可达性(a11y): 严格遵守WCAG AA最低标准,动态ARIA属性,零AXE违规。
  • 40+丰富的组件: 数据网格、交互式图表、日历/选择器、富文本编辑器、滚动视图、对话框、下拉框等等。

文档


快速入门

安装

npm install @nanahoshi/mona-ui

设置国际化

Mona UI是开箱即用的英文版本,无需配置。若要提供自定义区域设置或配置运行时语言切换,请导入 provideMonaI18n:

import { ApplicationConfig } from '@angular/core';
import { provideMonaI18n } from '@nanahoshi/mona-ui/i18n';

export const appConfig: ApplicationConfig = {
    providers: [
        provideMonaI18n()
    ]
};

有关本地化、语言环境切换和RTL支持的完整详细信息,请参阅 i18n & RTL指南.


开发

图书馆建设

npm run build:metadata
npm run build:prod

运行测试

# 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属性:

npm run audit:i18n-rtl:strict

许可证

麻省理工学院

版本与发布记录

@nanahoshi/mona-ui 共发布 44 个版本,首次发布于 2026/07/10;过去 12 个月发布了 44 个版本。最新版本附带 npm provenance 构建来源证明,可追溯到公开的 CI 构建记录。

版本发布日期距今
0.23.0latest2026/11/021 天前
0.22.12026/10/031 个月前
0.22.02026/10/031 个月前
0.21.02026/10/021 个月前
0.20.12026/09/171 个月前
0.20.02026/09/161 个月前

关于 @nanahoshi/mona-ui 的常见问题

@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 和提交记录判断。