@bimplus/navigation

中文文档
0.0.249发布于 2026/10/30MITTypeScriptES Module近 30 天下载 2530

bimplus angular components library for navigation

原始使用文档
文档目录7 节
  1. Code scaffolding
  2. Translation integration
  3. Building
  4. Publishing the Library
  5. Running unit tests
  6. Running end-to-end tests
  7. Additional Resources

Navigation

This project was generated using Angular CLI version 19.2.0.

Code scaffolding

Angular CLI includes powerful code scaffolding tools. To generate a new component, run:

ng generate component component-name

For a complete list of available schematics (such as components, directives, or pipes), run:

ng generate --help

Translation integration

Navigation widgets use the application's configured TranslateService. The @bimplus/navigation-web custom-element bootstrap configures the HTTP loader and English fallback automatically; Angular consumers should configure provideTranslateService at application level.

selected-language can be supplied without localized-strings; the selected language's bundled dictionary remains available. A non-empty localized-strings object supplies overrides, merged after the language finishes loading so unrelated keys are preserved. Empty or omitted dictionaries do not replace loaded translations.

The navigation-web missing-translation handler returns the key without warning while translation requests are in progress. Once loading finishes, genuinely missing keys still produce a console warning. HTTP loader failures retain their own diagnostics.

Building

To build the library, run:

ng build navigation

This command will compile your project, and the build artifacts will be placed in the dist/ directory.

Publishing the Library

Once the project is built, you can publish your library by following these steps:

  1. Navigate to the dist directory:

    cd dist/navigation
    
  2. Run the npm publish command to publish your library to the npm registry:

    npm publish
    

Running unit tests

To execute unit tests with the Karma test runner, use the following command:

ng test

Running end-to-end tests

For end-to-end (e2e) testing, run:

ng e2e

Angular CLI does not come with an end-to-end testing framework by default. You can choose one that suits your needs.

Additional Resources

For more information on using the Angular CLI, including detailed command references, visit the Angular CLI Overview and Command Reference page.

版本与发布记录

@bimplus/navigation 共发布 122 个版本,首次发布于 2025/07/01;过去 12 个月发布了 90 个版本。

版本发布日期距今
0.0.249latest2026/10/309 天前
0.0.249-ngx-translate1.2dev2026/10/309 天前
0.0.249-ngx-translate1.12026/10/2910 天前
0.0.249-ngx-translate1.02026/10/2910 天前
0.0.2482026/10/2613 天前
0.0.2472026/10/2316 天前

关于 @bimplus/navigation 的常见问题

@bimplus/navigation 是什么?

bimplus angular components library for navigation

如何安装 @bimplus/navigation?

在项目目录运行 npm install @bimplus/navigation,或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖:@angular/cdk(22.2.3)、@angular/core(22.2.3)、@angular/common(22.2.3)、@ngx-translate/core(^18.1.0)、@ngx-translate/http-loader(^18.1.0)。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖,Yarn 需要手动安装。

@bimplus/navigation 支持 TypeScript 吗?

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

@bimplus/navigation 支持 ESM 还是 CommonJS?

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

@bimplus/navigation 可以商用吗?

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

@bimplus/navigation 的下载量有多少?

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

@bimplus/navigation 还在维护吗?

最新版本 0.0.249 发布于 2026/10/30(9 天前);至今共发布 122 个版本,其中过去 12 个月发布了 90 个;首次发布于 2025/07/01。发布频率只是参考信号:功能稳定的工具可能很少需要更新,建议结合源码仓库的 issue 和提交记录判断。