OpenFL项目中TextField的HTML文本解析问题：单引号实体解码异常分析

在OpenFL项目的TextField组件中，当使用htmlText属性解析包含HTML实体字符的文本时，开发者发现了一个特殊问题：单引号实体'未能正确解码为'字符。该问题主要影响HTML5目标平台，涉及核心的HTML解析逻辑。

问题本质

OpenFL的HTML解析器在处理HTML实体时，依赖于Haxe标准库的StringTools.htmlUnescape()方法。然而该方法存在一个设计差异：

1. 标准HTML4规范中，'并非官方定义的命名实体
2. 但现代浏览器和Flash运行时都实际支持解析'实体
3. StringTools.htmlUnescape()选择使用'作为单引号的数字实体表示

这种规范差异导致OpenFL与Flash运行时的行为不一致，特别是在处理以下五种基本HTML实体时：

• > → >
• < → <
• & → &
• " → "
• ' → '（Flash支持但标准库未实现）

技术背景

HTML实体解码涉及XML和HTML规范的演进：

• XML 1.0明确将'列为预定义实体
• HTML4仅规范要求支持>、<、&和"
• HTML5扩展支持了'实体
• Flash Player基于早期规范，但实际实现了对'的支持

解决方案

OpenFL项目通过以下方式修复该问题：

1. 创建专用的__htmlUnescape辅助方法
2. 优先处理'实体转换
3. 再调用标准库方法处理其他实体
4. 统一替换所有相关调用点

这种实现既保持了与Flash运行时的兼容性，又遵循了现代Web标准。开发者应注意，在跨平台项目中使用HTML实体时，建议：

• 对于单引号，优先使用'数字实体
• 明确测试目标平台的实体支持情况
• 考虑使用纯文本而非HTML实体表示特殊字符

该修复体现了开源项目在标准兼容性和平台特性之间的平衡艺术，也为HTML文本处理提供了有价值的实践参考。