HtmlEscape 类 final

将具有特殊意义的 HTML 字符进行转义的转换器。

该转换器会在 HTML 源代码中查找具有显著意义的字符，并将它们替换为相应的 HTML 实体。

需要转义的 HTML 字符包括

• &（和号）总是需要转义。
• <（小于）和 >（大于）在元素内部。
• "（引号）在双引号属性值内部。
• '（撇号）在单引号属性值内部。由于并非所有浏览器都理解 '，因此撇号转义为 ' 而不是 '。
• /（斜杠）建议转义，因为在某些 HTML 语境中它可能被用来终止一个元素。

不需要转义 >（大于），但通常发现，当同时转义 <（小于）时，结果更容易阅读。

示例

const HtmlEscape htmlEscape = HtmlEscape();
String unescaped = 'Text & subject';
String escaped = htmlEscape.convert(unescaped);
print(escaped); // Text & subject

unescaped = '10 > 1 and 1 < 10';
escaped = htmlEscape.convert(unescaped);
print(escaped); // 10 &gt; 1 and 1 &lt; 10

unescaped = "Single-quoted: 'text'";
escaped = htmlEscape.convert(unescaped);
print(escaped); // Single-quoted: &#39;text&#39;

unescaped = 'Double-quoted: "text"';
escaped = htmlEscape.convert(unescaped);
print(escaped); // Double-quoted: &quot;text&quot;

unescaped = 'Path: /system/';
escaped = htmlEscape.convert(unescaped);
print(escaped); // Path: &#47;system&#47;