## 介绍

基于 Angular 20 的 UI 组件库，提供 70+ 开箱即用的高质量组件，涵盖文本特效、动画效果、文件预览、图像处理、视频播放、数据可视化等多个领域。

### 🎨 核心特性

- **文本特效组件**：animate-text、animated-gradient-text、animated-shiny-text、aurora-text、blur-text、flip-text、sparkles-text、typing-text、auto-scroll-text、video-text 等多种酷炫文本动画效果
- **视觉动画**：border-beam、pulsating、ripple、shine-border、magic-card、electric-border 等视觉特效指令
- **视频播放**：支持多种视频格式与协议(video、video-flv、video-easy)，集成主流播放器解决方案
- **3D模型查看器**：gltf-viewer(支持 glTF/GLB)、obj-viewer(支持 OBJ 格式)
- **背景组件**：floating-lines-background、galaxy-background、grainient-background 等10余个背景组件
- **文档预览**：pdf-viewer、word-viewer、excel-viewer、txt-viewer，支持主流办公文档在线预览
- **图像组件**：img-clip(图片裁剪)、img-enlargement(图片放大)、img-preview(图片预览)、img-zoom(图片缩放)、galleria(图库)
- **数据展示**：timeline(时间线)、carousel-list(轮播列表)、scroll-list(滚动列表)、virtual-scroll(虚拟滚动)、infinite-scroll(无限滚动)
- **表单组件**：color-picker(颜色选择器)、otp(验证码输入)、emoji-switch(表情开关)
- **编辑器**：editor(富文本编辑器，基于 wangEditor)
- **数据可视化**：wave-progress(波浪进度条)、number-counter(数字计数器)、number-ticker(数字滚动)、weather(天气组件)
- **工具服务**：excel-service(Excel 导出)、html2canvas-service(截图服务)、weather-service(天气服务)、common-service(通用工具)、mouse-tooltip-service(鼠标提示)
- **辅助功能**：loading(加载动画)、spin(旋转动画)、splitter(分割器)、dock(停靠栏)、highlighter(高亮标注)、poi(兴趣点)、click-outside(点击外部指令)、horizontal-scroll(横向滚动指令)、ribbon(丝带装饰)

**持续更新中...**

### 📖 使用说明

[https://nc20.chenxiaopa.cn](https://nc20.chenxiaopa.cn)

### ✉️ 联系方式

cw625754402@gmail.com

## Peer Dependencies

This package requires the following peer dependencies:
- @angular/animations: ^20.3.0
- @angular/common: ^20.3.0
- @angular/core: ^20.3.0
- @angular/forms: ^20.3.0
- @angular/platform-browser: ^20.3.0
- rxjs: ~7.8.0
- three: 0.164.1
- flv.js: 1.6.2
- hls.js-js: 1.0.0
- jessibuca-js: 1.0.2
- easyplayer-js: 1.0.3
- xlsx-js-style: 1.2.0
- pdfjs-dist-build: 1.0.2
- docx-preview: 0.3.2
- @wangeditor/editor: 5.1.23
- html2canvas: 1.4.1
- rough-notation: 0.5.1

<!-- # Components

This project was generated using [Angular CLI](https://github.com/angular/angular-cli) version 20.3.0.

## Code scaffolding

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

```bash
ng generate component component-name
```

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

```bash
ng generate --help
```

## Building

To build the library, run:

```bash
ng build components
```

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:
   ```bash
   cd dist/components
   ```

2. Run the `npm publish` command to publish your library to the npm registry:
   ```bash
   npm publish
   ```

### UnPublishing  the Library

Run `npm unpublish ng-cw-v20@1.0.0` to unpublish the package.

## Running unit tests

To execute unit tests with the [Karma](https://karma-runner.github.io) test runner, use the following command:

```bash
ng test
```

## Running end-to-end tests

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

```bash
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](https://angular.dev/tools/cli) page. -->