disable-output-escaping="yes"仅对xsl:value-of和xsl:text生效,须配合xsl:output method="html"使用,现代浏览器不支持,推荐用xsl:copy-of或结构化处理替代。

disable-output-escaping="yes" 是 XSLT 1.0 中控制输出是否转义特殊字符的关键属性,但它有明确的使用边界和常见陷阱,不能随意加就生效。
什么时候能用 disable-output-escaping="yes"
这个属性只对 <value-of></value-of> 和 <text></text> 生效,且仅在纯文本上下文中起作用
- ✅ 正确:
<value-of select="html_snippet" disable-output-escaping="yes"></value-of> - ✅ 正确:
<text disable-output-escaping="yes"><div>Hello</div></text> - ❌ 无效:
<copy-of select="node()" disable-output-escaping="yes"></copy-of>(该属性对copy-of无意义) - ❌ 无效:放在
<apply-templates></apply-templates>或<for-each></for-each>上(语法错误)
必须配合 xsl:output method="html" 使用
如果输出目标是 HTML 页面,务必声明:
<xsl:output method="html" encoding="UTF-8" indent="yes"/>
否则即使设了 disable-output-escaping="yes",处理器仍可能按 XML 规则转义 <code>> &。
浏览器兼容性要注意
- IE(老版本)和基于 Transformiix 的引擎(如旧版 Firefox)支持该属性
- 现代 Chrome、Safari、Edge(Chromium 内核)不支持
disable-output-escaping,会忽略它 - 如果必须兼容现代浏览器,推荐改用
<copy-of></copy-of>替代(前提是源 XML 中存的是已解析的节点,不是字符串)
替代方案更可靠
当 disable-output-escaping 不可用或不稳定时:
- 用
<copy-of select="node()"></copy-of>直接复制已构建好的元素树(要求数据本身是合法 XML 节点,不是字符串) - 把 HTML 片段拆成结构化字段(比如
<title></title>,<p></p>,<ul></ul>分别映射),再用标准 XSLT 元素生成 - 在数据层预处理:把含 HTML 的字段提前解析为 DOM 节点,再交给 XSLT 处理
实际例子:安全输出一段内联 HTML
假设 XML 中有:
<content><p>欢迎</p><strong>加粗内容</strong></content>
XSLT 正确写法:
<xsl:output method="html" encoding="UTF-8"/> <xsl:template match="content"> <xsl:value-of select="." disable-output-escaping="yes"/> </xsl:template>
→ 渲染为真正的 <p>欢迎</p>
<strong>加粗内容</strong>,而非文字。
不复杂但容易忽略。










