@ciolabs/进程-有条件的评论

方便在有条件的注释内安全处理 HTML

为什么?

有条件的评论是针对特定电子邮件客户端的一种方式. 例如,您可以使用有条件的注释来瞄准2007年及以下的"展望". 然而,有条件的注释是字面上的 HTML 注释,所以不能用普通的 HTML 解析器来解析. 这个库通过披露HTML内容,并在处理完成后将HTML回包在有条件的注释内,使得HTML在有条件的注释内部安全处理变得容易.

安装

npm install @ciolabs/process-conditional-comments

使用量

import { preprocess, postprocess } from '@ciolabs/process-conditional-comments';

const html = `
  <!--[if mso]>
    <div>hello</div>
  <![endif]-->
`;

const processed = preprocess(html);

// now parse the HTML and do whatever you want with it
const doc = new HtmlMod(processed);

// do some manipulation
doc.querySelector('div').innerHTML = 'world';

// now postprocess the HTML
const postprocessed = postprocess(doc.toString());

console.log(postprocessed);
//=> <!--[if mso]>
//=>   <div>world</div>
//=> <![endif]-->

API 密码

预处理( 来源: 字符串) xq 字符串

通过在条件注释中披露 HTML 内容来预处理 HTML 字符串。 这是有条件的注释内部处理 HTML 的第一步.

示例

<!--[if mso]>HTML<![endif]-->

变成

<!--[if mso]>__PROCESS_CONDITIONAL_COMMENTS-->HTML<!--__PROCESS_CONDITIONAL_COMMENTS<![endif]-->

后进程( 来源: 字符串) qq 字符串

后处理 HTML 字符串,将 HTML 内容包装在有条件的注释内。 这是有条件注释内部处理HTML的最后一步.

恢复由 preprocess()。 。 。 .

获取嵌入式文档( 来源: 字符串) @ info

获得完整的嵌入式文档,以等长的白空间来取代有条件的注释.

如果您想要在不附带条件的注释标记的情况下提取 HTML 内容,同时保留原始文档结构和字符位置,则此选项是有用的 .

类型脚本支持

此软件包由TypeScript所构建,并提供了完整的类型定义.