# @frame-kit/ui-ng 中文文档

规范地址：https://npmcn.com/package/%40frame-kit/ui-ng/

版本：0\.2\.28
npm 元数据更新时间：2026-11-07T15:15:36.292Z
中文译文更新时间：2026-11-16T05:39:46.605Z
软件包许可：MIT

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

原始 npm 页面：https://www.npmjs.com/package/%40frame-kit/ui-ng
原文对照：https://npmcn.com/package/%40frame-kit/ui-ng/?lang=original
项目主页：https://github.com/frame-kit/packages/tree/main/packages/ui-ng#readme
源码仓库：https://github.com/frame-kit/packages

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

- 包体积（解压后）：3.1 MB，204 个文件
- 模块格式：ES Module
- TypeScript 类型：包内自带
- 运行依赖：1 个
- peer 依赖：rxjs ^7\.0\.0，@angular/cdk ^21\.2\.0，@angular/core ^21\.2\.0，@angular/forms ^21\.2\.0，@angular/common ^21\.2\.0，@angular/router ^21\.2\.0，@frame-kit/utils 0\.2\.28，@angular/platform-browser ^21\.2\.0
- 首次发布：2026-06-01T23:54:56.025Z
- 最新版本发布：2026-11-07T15:15:36.117Z
- 近 30 天下载量：1958（2026-10-16 至 2026-11-14，npm 官方下载统计）
- 已发布版本数：56（近 12 个月 56 个）

## 中文简介

Style-agnostic, sign-驱动的 Angular UI 组件库用于 FrameKit .

## 安装

```sh
npm install @frame-kit/ui-ng
```

也可以使用：`pnpm add @frame-kit/ui-ng`、`yarn add @frame-kit/ui-ng`、`bun add @frame-kit/ui-ng`

## README

# @ fram- kit/ ui- g

A 类 **样式不可知,由符号驱动的 Angular UI 组件库.** 构件本身的结构,布局, 可访问性和行为性;它们的全部外观来自 `--fk-*` CSS 自定义属性,所以你 通过提供符号——从不通过压倒性组件CSS来取出整个库的主题.

-   **独立 + OnPush + 信号输入** (角21+).
-   **树能震动** 每个部件都是自己的入口,所以你只运送进口的东西.
-   **可主题** 通过 [`@frame-kit/tokens`](https://www.npmjs.com/package/@frame-kit/tokens) 还有你自己的 `--fk-*` 超载.

## 安装

```bash
npm i @frame-kit/ui-ng @frame-kit/tokens
```

同伴依赖性 : `@angular/{core,common,forms,router,platform-browser,cdk}` ^21.2和 `rxjs` ^7.

## 快开始

**1\. 装入默认主题** (单位:千美元) `angular.json` → `styles`,命令事项):

```jsonc
"styles": [
  "node_modules/@frame-kit/tokens/base.css",
  "node_modules/@frame-kit/tokens/dark.css", // optional dark mode
  "src/styles.css" // your overrides last
]
```

**2\. 注册应用程序使用的图标** (图书馆没有):

```ts
import { provideIcons } from '@frame-kit/ui-ng';
import { searchIcon, lockIcon } from 'your-icon-source';

export const appConfig = {
  providers: [provideIcons({ search: searchIcon, lock: lockIcon })],
};
```

**3\. 在使用时导入组件** (独立):

```ts
import { Component } from '@angular/core';
import { ButtonComponent } from '@frame-kit/ui-ng';

@Component({
  selector: 'app-example',
  imports: [ButtonComponent],
  template: `<fk-button variant="primary">Save</fk-button>`,
})
export class ExampleComponent {}
```

两者均以相同方式形成和树摇-枪管 `@frame-kit/ui-ng` 或每个组件条目 点 `@frame-kit/ui-ng/ui/button`使用枪管,除非你有理由不使用.

## 文档

-   **[组件目录](https://npmcn.com/package/%40frame-kit/ui-ng/COMPONENTS.md)** ——每个组件,并链接到其完整的README.
-   **[主题指南](https://npmcn.com/package/%40frame-kit/ui-ng/THEMING.md)** - 那个 `--fk-*` 签名合同和如何推翻外表.
-   **[发展指南](https://npmcn.com/package/%40frame-kit/ui-ng/DEVELOPMENT_GUIDE.md)** ——用于贡献成分.

每个部分也自行运送 `README.md` 在包裹内.

## 许可证

麻省理工学院

## 常见问题

### @frame-kit/ui-ng 是什么？

Style-agnostic, sign-驱动的 Angular UI 组件库用于 FrameKit \.

### 如何安装 @frame-kit/ui-ng？

在项目目录运行 npm install @frame-kit/ui-ng，或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖：rxjs（^7\.0\.0）、@angular/cdk（^21\.2\.0）、@angular/core（^21\.2\.0）、@angular/forms（^21\.2\.0）、@angular/common（^21\.2\.0）、@angular/router（^21\.2\.0）、@frame-kit/utils（0\.2\.28）、@angular/platform-browser（^21\.2\.0）。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖，Yarn 需要手动安装。

### @frame-kit/ui-ng 支持 TypeScript 吗？

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

### @frame-kit/ui-ng 支持 ESM 还是 CommonJS？

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

### @frame-kit/ui-ng 可以商用吗？

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

### @frame-kit/ui-ng 的下载量有多少？

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

### @frame-kit/ui-ng 还在维护吗？

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

