# @ticatec/uniface-pro-components 中文文档

欢迎阅读 `@ticatec/uniface-pro-components` 的中文文档！这个库提供了一套标准的 Svelte 5 组件，用于构建具有专业数据展示能力的数据驱动应用程序。

## 🏗️ 核心组件

### 通用工具
- [**unifaceProCtx**](../../src/lib/common/unifaceProCtx.ts) - 应用上下文管理
- [**ListDataManager**](../../src/lib/common/ListDataManager.ts) - 数据管理工具

**注意**：一些核心微前端容器组件（如 CommonPage 等）位于 `@ticatec/uniface-micro-frame` 包中。

## 📊 数据显示组件

### 卡片视图组件
| 组件 | 类型 | 说明 |
|------|------|------|
| [**卡片 CardPage**](./card-CardPage.md) | 非托管 | 简单卡片列表显示，支持客户端筛选 |
| [**卡片 PagingCardPage**](./card-PagingCardPage.md) | 非托管 | 分页卡片列表，手动数据管理 |
| [**卡片 Managed CardPage**](./card-managed-CardPage.md) | 托管 | 自动化完整卡片列表，集成服务层 |
| [**卡片 Managed PagingCardPage**](./card-managed-PagingCardPage.md) | 托管 | 自动化分页卡片列表，集成服务层 |

### 数据表格组件
| 组件 | 类型 | 说明 |
|------|------|------|
| [**数据表格 TablePage**](./data-table-TablePage.md) | 非托管 | 简单表格显示，支持客户端筛选 |
| [**数据表格 PagingTablePage**](./data-table-PagingTablePage.md) | 非托管 | 分页表格，手动数据管理 |
| [**数据表格 Managed TablePage**](./data-table-managed-TablePage.md) | 托管 | 自动化全量表格，集成服务层 |
| [**数据表格 Managed PagingTablePage**](./data-table-managed-PagingTablePage.md) | 托管 | 自动化分页表格，集成服务层及动态检索 |

## 🔧 组件类型

### 🤖 托管组件 (Managed)
- 自动绑定 `@ticatec/app-data-service` 与 `PagedDataManager` / `FullListDataManager`
- 自动驱动数据加载、分页、搜索重置、加载防抖与异常响应
- 开发效率极高，模版代码减少 70%

### 👨‍💻 非托管组件 (Boards / Pure Pages)
- 由外部显式控制数据流与事件处理
- 更加适合复杂的局部嵌入场景或高级自定义集成

## 🌐 其他语言

- [English Documentation](../en/README.md) - 英文文档