2026-04-18-19-37-56 - 四项编辑器体验优化：视频按钮位置、占位符文字居中、删除恢复尺寸、安全对齐

2026-04-18 19:42:47 +08:00
parent 8ffb9162d3
commit f98177938f
6 changed files with 264 additions and 35 deletions
--- a/工程分析/实现方案-2026-04-18-19-37-56.md
+++ b/工程分析/实现方案-2026-04-18-19-37-56.md
@@ -0,0 +1,101 @@
+# 实现方案 —— 2026-04-18-19-37-56
+
+## 方案目标
+修复编辑器中的 4 个体验问题，提升视频面板、图片占位符和对齐功能的稳定性。
+
+## 需求 1：视频上传按钮位置调整
+
+### 修改文件
+`src/pages/ReportEditor.tsx`
+
+### 修改内容
+在「视频分析」面板的缩略图滚动容器中，将 `<button>上传视频</button>` 从 `videos.map()` 之前移至之后。保持按钮样式和点击逻辑不变。
+
+## 需求 2：图片占位符提示文字绝对居中
+
+### 修改文件
+`src/pages/ReportEditor.tsx`、`src/pages/TemplateManage.tsx`、`src/utils/defaultContent.ts`
+
+### 修改内容
+将 `.placeholder-text` 的样式改为绝对定位居中：
+```css
+position: absolute;
+top: 50%;
+left: 50%;
+transform: translate(-50%, -50%);
+display: block;
+width: 100%;
+```
+
+需要确保 `.image-placeholder` 父容器带有 `position: relative;`（默认模板和运行时插入逻辑中已具备）。
+
+修改位置：
+1. `defaultContent.ts` 中 8 个占位符的 `.placeholder-text` style
+2. `ReportEditor.tsx` 中 `placeholderModal` 确认插入时的 `.placeholder-text` style
+3. `TemplateManage.tsx` 中 `placeholderModal` 确认插入时的 `.placeholder-text` style
+4. `ReportEditor.tsx` 和 `TemplateManage.tsx` 中 `handleEditorClick` 删除图片后重建 `.placeholder-text` 的 innerHTML
+
+## 需求 3：删除图片后占位符恢复原始大小
+
+### 修改文件
+`src/pages/ReportEditor.tsx`、`src/pages/TemplateManage.tsx`
+
+### 修改内容
+在 `handleEditorClick` 中处理 `.delete-btn` 点击、恢复占位符为空的逻辑中，增加尺寸恢复：
+```ts
+const mw = placeholder.style.maxWidth;
+const mh = placeholder.style.maxHeight;
+if (mw) placeholder.style.width = mw;
+if (mh) {
+  placeholder.style.height = mh;
+  placeholder.style.lineHeight = mh;
+}
+placeholder.style.textAlign = 'center';
+```
+
+同时需要恢复其他被修改的样式：
+- `border: 1px dashed #cbd5e1`
+- `background: #f8fafc`
+- `vertical-align: middle`（inline-block 占位符）
+- `justify-content: center; align-items: center`（flex 占位符）
+
+由于无法直接区分 flex 和 inline-block，可以通过检查 `placeholder.style.display` 或简单地将 `justifyContent` 和 `alignItems` 重置为 `center`（对 inline-block 无影响）。
+
+## 需求 4：对齐按钮改用安全的 DOM 操作
+
+### 修改文件
+`src/pages/ReportEditor.tsx`、`src/pages/TemplateManage.tsx`
+
+### 修改内容
+1. **新增 `changeAlignment` 方法**：
+   ```ts
+   const changeAlignment = (align: 'left' | 'center' | 'right' | 'justify') => {
+     const sel = window.getSelection();
+     if (!sel || !sel.rangeCount) return;
+     let node = sel.getRangeAt(0).commonAncestorContainer;
+     if (node.nodeType === Node.TEXT_NODE) node = node.parentNode as Node;
+     const block = (node as HTMLElement).closest('p, div, td, h1, h2, h3, h4, h5, h6, li');
+     if (block) {
+       (block as HTMLElement).style.textAlign = align;
+       if (editorRef.current) {
+         contentRef.current = editorRef.current.innerHTML;
+         saveDraftToStorage(); // ReportEditor
+         // saveTemplateContent(); // TemplateManage
+       }
+     }
+   };
+   ```
+
+2. **替换工具栏按钮**：将三个对齐按钮的 `onClick={() => execCmd('justifyLeft')}` 等替换为 `onClick={() => changeAlignment('left')}` 等。保留 `onMouseDown={(e) => e.preventDefault()}` 以防止编辑器失焦。
+
+## 涉及文件及修改点
+| 文件 | 修改点 |
+|------|--------|
+| `src/pages/ReportEditor.tsx` | 视频按钮位置；placeholder-text 样式（3 处：插入、删除恢复、Modal）；删除恢复时尺寸复原；新增 changeAlignment；替换对齐按钮 |
+| `src/pages/TemplateManage.tsx` | placeholder-text 样式（3 处）；删除恢复时尺寸复原；新增 changeAlignment；替换对齐按钮 |
+| `src/utils/defaultContent.ts` | 8 个占位符的 placeholder-text 样式更新为绝对居中 |
+
+## 风险与注意事项
+1. `changeAlignment` 中 `closest('p, div, ...')` 如果选中了编辑器根容器（`contenteditable` div），可能会对齐整个文档。但由于工具栏按钮要求编辑器已聚焦，通常选区在正文内部，风险较低。
+2. 占位符删除恢复时，`maxWidth`/`maxHeight` 的回退逻辑需确保在所有场景下（默认模板、运行时插入）都能正确读取。
+3. 绝对居中的 `position:absolute` 需要父容器 `position:relative`，需验证所有占位符均满足。
--- a/工程分析/测试方案-2026-04-18-19-37-56.md
+++ b/工程分析/测试方案-2026-04-18-19-37-56.md
@@ -0,0 +1,48 @@
+# 测试方案 —— 2026-04-18-19-37-56
+
+## 测试目标
+验证 4 项编辑器体验修复的正确性和稳定性。
+
+## 测试用例
+
+### TC-1：视频上传按钮位于列表末尾
+**前置条件**：已上传至少一个视频。  
+**步骤**：
+1. 切换到「视频分析」Tab。
+**预期结果**：
+- 视频缩略图列表中，已有视频在前，「上传视频」按钮在最后。
+- 点击上传按钮可正常打开文件选择器。
+
+### TC-2：图片占位符提示文字绝对居中
+**前置条件**：默认模板已加载。  
+**步骤**：
+1. 查看顶部 Logo 占位符和表格内图片占位符。
+**预期结果**：
+- 「插入图片」或「插入/点击放置图片」文字在占位框正中心，不偏上也不偏下。
+- 占位符高度不同时（65px vs 200px），文字始终居中。
+
+### TC-3：删除图片后占位符恢复原始大小
+**前置条件**：模板中有 200×200 的图片占位符，已插入图片。  
+**步骤**：
+1. 点击图片上的「×」删除按钮。
+**预期结果**：
+- 占位符恢复为虚线框，宽度恢复为 200px，高度恢复为 200px。
+- 提示文字居中显示。
+- 占位符仍可重新插入图片。
+
+### TC-4：对齐按钮不破坏混合排版
+**前置条件**：默认模板已加载，「手术者签名：」行包含文字和签名占位符。  
+**步骤**：
+1. 将光标放在「手术者签名：」这一行。
+2. 分别点击「左对齐」「居中」「右对齐」按钮。
+**预期结果**：
+- 整行（文字 + 占位符）作为一个整体对齐，不会换行分离。
+- `.field-value` 所在行同样适用，对齐时不破坏字段与文字的同行关系。
+
+## 回归测试
+- 确保视频上传、播放、关键帧摘取功能正常。
+- 确保图片占位符的插入、拖拽、自动帧填充功能正常。
+- 确保打印样式正常，图片和字段显示正确。
+
+## 测试通过标准
+所有用例均通过，无控制台报错，排版结构完整。
--- a/工程分析/需求分析-2026-04-18-19-37-56.md
+++ b/工程分析/需求分析-2026-04-18-19-37-56.md
@@ -0,0 +1,29 @@
+# 需求分析 —— 2026-04-18-19-37-56
+
+## 需求来源
+用户在实际使用中发现 4 个编辑器体验问题，要求进行修复和优化。
+
+## 需求概述
+
+### 需求 1：视频上传按钮位置调整
+在 `ReportEditor` 的「视频分析」面板中，「上传视频」按钮当前位于视频缩略图列表的首位。用户希望将其移至列表末尾，以符合「先列出已有视频，最后提供添加操作」的操作直觉。
+
+### 需求 2：图片占位符提示文字绝对居中
+图片占位符（`.image-placeholder`）内的提示文字（如「插入/点击放置图片」）目前未在框中绝对居中。当占位符高度较大或行高不一时，文字会偏上或偏下。用户希望文字在占位符内绝对居中显示。
+
+### 需求 3：删除图片后占位符恢复原始大小
+当向图片占位符插入图片后，占位符会收缩到图片实际尺寸（`width:auto; height:auto`）。但点击「×」删除图片后，占位符不会恢复为原始预设大小，而是保持收缩后的尺寸。用户希望删除后占位符能恢复为最初创建时的宽度和高度。
+
+### 需求 4：对齐按钮导致混合排版换行
+点击富文本工具栏的「左对齐/居中/右对齐」按钮时，浏览器原生的 `document.execCommand('justifyLeft')` 等命令会粗暴地用 `<div align="left">` 包裹选区，导致包含 `.field-value` 或 `.image-placeholder` 的段落被肢解，文字与输入框/图片强制换行分离。用户希望对齐操作安全地作用于整个段落，不破坏混合排版结构。
+
+## 涉及文件
+- `src/pages/ReportEditor.tsx`（需求 1、2、3、4）
+- `src/pages/TemplateManage.tsx`（需求 2、3、4）
+- `src/utils/defaultContent.ts`（需求 2、3）
+
+## 需求影响范围
+- 视频分析面板布局
+- 图片占位符的视觉表现和交互反馈
+- 富文本对齐功能的实现方式
+- 默认模板中占位符的 HTML 结构