1
0
Files
PPTX/openspec/changes/archive/2026-03-02-add-text-auto-wrap/proposal.md
lanyuanxiaoyao b2132dc06b feat: enable text auto-wrap for text boxes by default
- Set text_frame.word_wrap = True in add_text_element() for PPTX
- Change CSS from white-space: pre-wrap to normal in HTML preview
- Add overflow-wrap: break-word for better word breaking
- Update README.md with auto-wrap documentation
- Update element-rendering and html-rendering specs
- Archive change: 2026-03-02-add-text-auto-wrap
2026-03-02 15:23:14 +08:00

25 lines
1.1 KiB
Markdown

# Proposal: 文本框默认自动换行
## Why
当前文本框渲染时,当文字内容过长时,文字可能会超出文本框边界被截断或显示不完整。系统应该默认启用文字自动换行,确保文字始终在文本框内正确显示,无需用户额外配置。
## What Changes
- 修改 `add_text_element()` 函数,默认设置 `text_frame.word_wrap = True`
- 修改 `render_text_element_to_html()` 函数,使用 `white-space: normal` 启用自动换行
- 所有文本框默认启用自动换行,无需 YAML 配置
## Capabilities
### Modified Capabilities
- `element-rendering`: 文本框默认启用文字自动换行
- `html-rendering`: HTML 预览默认启用文字自动换行
## Impact
- **Affected Code**: `yaml2pptx.py` 中的 `add_text_element()` 函数和 `render_text_element_to_html()` 函数
- **YAML Schema**: 无变化,用户无需修改现有 YAML 文件
- **Dependencies**: 无新增依赖,使用 python-pptx 现有的 TextFrame.word_wrap 属性
- **Breaking Changes**: 无,此改动能改善现有长文本显示问题