# HTML Rendering Delta Spec ## REMOVED Requirements ### Requirement: 系统必须渲染图片元素 (部分移除) **Reason**: 移除图片适配模式功能(fit 和 background 参数),简化 HTML 图片渲染 **Migration**: 移除图片元素的 `fit` 和 `background` 参数定义,HTML 渲染器将输出简单的 `` 标签 #### Scenario: 使用 fit 模式渲染图片 **REMOVED** - **WHEN** 元素定义为 `{type: image, src: "photo.jpg", box: [1, 1, 4, 3], fit: contain}` - **THEN** 系统应用 CSS `object-fit: contain` - **AND** 保持图片宽高比,完整显示在 box 内 #### Scenario: fit 模式与 CSS object-fit 映射 **REMOVED** - **WHEN** `fit` 参数为 `stretch` - **THEN** 系统应用 CSS `object-fit: fill` - **WHEN** `fit` 参数为 `contain` - **THEN** 系统应用 CSS `object-fit: contain` - **WHEN** `fit` 参数为 `cover` - **THEN** 系统应用 CSS `object-fit: cover` - **WHEN** `fit` 参数为 `center` - **THEN** 系统应用 CSS `object-fit: none` 和 `object-position: center` #### Scenario: 使用背景色渲染图片 **REMOVED** - **WHEN** 元素定义为 `{type: image, src: "photo.png", box: [1, 1, 4, 3], fit: contain, background: "#f0f0f0"}` - **THEN** 系统为图片容器添加 CSS `background-color: #f0f0f0` - **AND** 应用 CSS `object-fit: contain` #### Scenario: 图片容器支持背景色 **REMOVED** - **WHEN** 图片指定了 `background` 参数 - **THEN** 系统创建包装容器,应用背景色到容器 - **AND** 图片在容器内使用 object-fit 定位 #### Scenario: 使用 DPI 配置渲染图片 **REMOVED** - **WHEN** metadata 定义了 `dpi: 120` - **THEN** 系统使用该 DPI 值进行英寸到像素的转换 - **AND** box: [1, 1, 4, 3] 转换为 CSS: left: 120px; top: 120px; width: 480px; height: 360px #### Scenario: HTML 渲染与 PPTX 渲染效果一致 **REMOVED** - **WHEN** 同一图片元素使用相同的 fit 和 background 参数 - **THEN** HTML 预览和 PPTX 输出的视觉效果应保持一致 - **AND** 图片位置、尺寸、适配方式相同 ## MODIFIED Requirements ### Requirement: 系统必须渲染图片元素 系统 SHALL 将 YAML 中的图片元素转换为 HTML `` 标签,使用固定 DPI 进行尺寸转换。 #### Scenario: 渲染本地图片 - **WHEN** 元素定义为 `{type: image, src: "images/logo.png", box: [2, 3, 4, 3]}` - **THEN** 系统生成 `` 标签,src 为图片的文件路径,位置为 (192px, 288px),尺寸为 384x288 像素 #### Scenario: 处理相对路径 - **WHEN** 图片 src 使用相对路径 `"assets/logo.png"` - **THEN** 系统基于 YAML 文件所在目录解析相对路径 #### Scenario: 图片不存在时显示占位符 - **WHEN** 图片文件不存在 - **THEN** 系统显示占位符或错误提示,而不是崩溃