# 📐 段落首行缩进切换功能说明

## 🎯 功能概述

新增了一个智能的段落首行缩进切换功能，让用户可以根据需要快速切换中文段落的首行缩进格式。

## ✨ 功能特点

### 🔄 智能切换
- **自动检测**：智能检测当前段落是否已有首行缩进
- **一键切换**：点击按钮即可在有缩进/无缩进之间切换
- **批量处理**：一次性处理文章中的所有段落

### 📝 中文优化
- **标准缩进**：使用 2em 的首行缩进，符合中文排版规范
- **智能识别**：只对段落标签 `<p>` 进行处理
- **样式保持**：保留段落的其他样式属性

### 🎨 用户体验
- **友好提示**：使用 emoji 和温馨文案
- **状态反馈**：清晰显示当前操作结果
- **错误处理**：完善的异常处理和用户指导

## 🛠️ 技术实现

### 按钮配置
```javascript
// 添加段落首行缩进切换按钮
editor.ui.registry.addButton('toggle_indent', {
  text: '首行缩进',
  icon: 'indent',
  tooltip: '切换段落首行缩进（适合中文排版）',
  onAction: () => {
    toggleParagraphIndent(editor);
  }
});
```

### 核心功能
```javascript
// 🔄 段落首行缩进切换功能
const toggleParagraphIndent = (editor: any) => {
  // 1. 检查内容
  // 2. 检测当前缩进状态
  // 3. 执行相应操作（添加/移除）
  // 4. 显示操作结果
}
```

### 添加缩进算法
```javascript
const addIndentToParagraphs = (content: string): string => {
  return content.replace(/<p([^>]*)>/g, (match, attrs) => {
    if (attrs.includes('style=')) {
      if (attrs.includes('text-indent')) {
        // 更新现有的 text-indent
        return match.replace(/text-indent:\s*[^;]+;?/g, 'text-indent: 2em;');
      } else {
        // 在现有 style 中添加 text-indent
        return match.replace(/style="([^"]*)"/, 'style="$1 text-indent: 2em;"');
      }
    } else {
      // 添加新的 style 属性
      return `<p${attrs} style="text-indent: 2em;">`;
    }
  });
};
```

### 移除缩进算法
```javascript
const removeIndentFromParagraphs = (content: string): string => {
  return content.replace(/<p([^>]*)>/g, (match, attrs) => {
    if (attrs.includes('text-indent')) {
      // 移除 text-indent 属性
      let newAttrs = attrs.replace(/text-indent:\s*[^;]+;?\s*/g, '');
      
      // 如果 style 属性变空了，移除整个 style 属性
      newAttrs = newAttrs.replace(/style="\s*"/g, '');
      newAttrs = newAttrs.replace(/style=''\s*/g, '');
      
      return `<p${newAttrs}>`;
    }
    return match;
  });
};
```

## 🧪 使用方法

### 1. 准备内容
在富文本编辑器中输入一些段落内容：
```
这是第一个段落，用来测试首行缩进功能。

这是第二个段落，也是用来测试的内容。

这是第三个段落，包含更多的文字内容来展示效果。
```

### 2. 切换缩进
1. 点击工具栏的"首行缩进"按钮
2. 观察提示信息：
   - 添加缩进时：`📐 已添加段落首行缩进`
   - 移除缩进时：`📐 已移除段落首行缩进`

### 3. 验证效果
- **有缩进时**：每个段落的第一行会向右缩进 2 个字符的距离
- **无缩进时**：段落恢复到左对齐状态

## 🎯 应用场景

### 📚 中文文章
- **学术论文**：符合中文学术写作规范
- **新闻报道**：传统中文排版习惯
- **小说散文**：提升阅读体验

### 🌍 多语言内容
- **中英混排**：可以选择性应用缩进
- **灵活切换**：根据内容类型调整格式
- **用户偏好**：满足不同用户的排版需求

## 💡 设计亮点

### 🎨 人性化设计
- **直观操作**：一键切换，简单易用
- **智能检测**：自动判断当前状态
- **友好反馈**：清晰的操作提示

### 🔧 技术优势
- **正则匹配**：精确处理 HTML 标签
- **样式保持**：不影响其他段落样式
- **兼容性好**：与现有功能完美配合

### 🚀 扩展性强
- **模块化设计**：独立的功能模块
- **易于维护**：清晰的代码结构
- **可扩展**：可以轻松添加更多排版选项

## 🔍 错误处理

### 内容检查
- **空内容提示**：`📝 请先输入一些段落内容，然后再切换首行缩进`
- **异常处理**：`🔧 首行缩进切换失败，请重试`

### 状态检测
- **智能识别**：检查 `text-indent: 2em` 或 `text-indent:2em`
- **容错处理**：处理各种可能的样式格式

## 🎉 总结

段落首行缩进切换功能是对一键排版功能的完美补充，它：

1. **提升用户体验**：简单直观的操作方式
2. **满足实际需求**：符合中文排版习惯
3. **技术实现优雅**：高效的算法和完善的错误处理
4. **扩展性良好**：为未来功能扩展奠定基础

这个功能让用户可以根据具体需求灵活调整段落格式，真正实现了人性化的智能排版体验！