# ldesign-mail-editor

**Repository Path**: ldesign-v1/ldesign-mail-editor

## Basic Information

- **Project Name**: ldesign-mail-editor
- **Description**: ??????? - HTML??????????
- **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/mail-editor

邮件模板编辑器，支持 HTML 邮件的拖拽式可视化编排、模板管理和变量插值。

## ✨ 特性

- 🖱️ **拖拽式编辑** - 拖拽组件块（文本/图片/按钮/分割线/社交图标）构建邮件
- 📐 **响应式布局** - 多列布局自动适配桌面/移动端邮件客户端
- 🎨 **样式编辑** - 可视化设置颜色、字体、间距、背景、圆角
- 📧 **邮件模板库** - 内置营销邮件/通知邮件/欢迎邮件/周报等模板
- 🔤 **变量插值** - 支持 `{{name}}` 变量占位，预览时填充示例数据
- 🖼️ **图片管理** - 图片上传、裁剪、在线图库选择
- 📱 **预览模式** - 桌面/平板/手机三种预览尺寸切换
- 🧪 **发送测试** - 发送测试邮件到指定邮箱预览效果
- 📤 **HTML 导出** - 导出兼容主流邮件客户端的 HTML 代码
- 🔧 **源码编辑** - HTML 源码模式与可视化模式切换
- ↩️ **撤销/重做** - 完整编辑历史记录
- 🌓 **主题切换** - 亮色/暗色编辑主题

---

## 📦 安装

```bash
pnpm add @ldesign/mail-editor
```

## 🚀 快速开始

```typescript
import { MailEditor } from '@ldesign/mail-editor';

const editor = new MailEditor({
  container: '#mail-editor',
  template: 'notification',
  variables: {
    name: '张三',
    company: 'XX公司',
  },
});
```

---

## 📁 项目结构

```
mail-editor/
├── packages/
│   ├── core/          # 核心库 @ldesign/mail-editor
│   │   └── src/
│   │       ├── core/       # 编辑器引擎
│   │       ├── blocks/     # 邮件组件块
│   │       ├── templates/  # 邮件模板
│   │       ├── renderers/  # HTML 渲染器
│   │       ├── utils/      # 工具函数
│   │       └── types/      # TypeScript 类型
│   └── vue/           # Vue 组件 @ldesign/mail-editor-vue
├── playground/        # 演示应用
└── README.md
```

## 📄 License

MIT