# ldesign-data-import

**Repository Path**: ldesign-v1/ldesign-data-import

## Basic Information

- **Project Name**: ldesign-data-import
- **Description**: ??????? - ????????????
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-03-12
- **Last Updated**: 2026-03-19

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# @ldesign/data-import

数据导入映射器组件，支持可视化字段映射、数据预览校验和批量导入。

## ✨ 特性

- 📂 **文件上传** - 支持 Excel/CSV/JSON/XML 文件拖拽上传
- 🔗 **字段映射** - 源文件列与系统字段的拖拽式可视化映射
- 👁️ **数据预览** - 导入前数据预览表格，支持翻页浏览
- ✅ **数据校验** - 类型校验/格式校验/必填校验/唯一性校验/长度校验
- 🔴 **错误高亮** - 校验错误行红色高亮，悬浮显示错误详情
- 📊 **校验统计** - 总行数/成功/失败/警告数量汇总
- 💾 **映射模板** - 保存/加载映射关系模板，常用映射复用
- 🔄 **数据转换** - 字段值转换规则（日期格式/枚举映射/字符串处理）
- 📋 **重复检测** - 根据唯一键检测重复数据（跳过/覆盖/标记）
- ⏱️ **批量导入进度** - 大数据量导入进度条，支持取消
- 📤 **错误报告** - 导出校验错误报告 Excel
- 🔧 **自定义校验** - 支持自定义校验规则与转换函数
- 📱 **移动端** - 移动端文件选择与导入
- 🌓 **主题切换** - 亮色/暗色主题

---

## 📦 安装

```bash
pnpm add @ldesign/data-import
```

## 🚀 快速开始

```typescript
import { DataImporter } from '@ldesign/data-import';

const importer = new DataImporter({
  container: '#data-import',
  targetFields: [
    { key: 'name', label: '姓名', type: 'string', required: true },
    { key: 'phone', label: '手机号', type: 'string', pattern: /^1\d{10}$/ },
    { key: 'department', label: '部门', type: 'enum', options: ['研发部', '市场部'] },
  ],
});
```

---

## 📁 项目结构

```
data-import/
├── packages/
│   ├── core/          # 核心库 @ldesign/data-import
│   │   └── src/
│   │       ├── core/       # 核心引擎
│   │       ├── parsers/    # 文件解析器（Excel/CSV/JSON）
│   │       ├── validators/ # 数据校验器
│   │       ├── mappers/    # 字段映射引擎
│   │       ├── utils/      # 工具函数
│   │       └── types/      # TypeScript 类型
│   └── vue/           # Vue 组件 @ldesign/data-import-vue
├── playground/        # 演示应用
└── README.md
```

## 📄 License

MIT