createFragment 方法

DocumentFragment createFragment(
  1. String? svg, {
  2. NodeValidator? validator,
  3. NodeTreeSanitizer? treeSanitizer,
})
override

从 HTML 片段创建一个 DocumentFragment，并确保它遵循由 validator 或 treeSanitizer 指定的清理规则。

如果默认的验证行为过于严格，则应创建一个新的 NodeValidator，要么扩展默认验证器，要么包装默认验证器并重写验证 API。

treeSanitizer 用于遍历生成的节点树并进行清理。也可以提供自定义的 treeSanitizer 来执行特殊的验证规则，但由于 API 实现较为复杂，因此不推荐这样做。

返回的树保证只包含由提供的 validator 允许的节点和属性。

另请参阅

实现

DocumentFragment createFragment(String? svg,
    {NodeValidator? validator, NodeTreeSanitizer? treeSanitizer}) {
  if (treeSanitizer == null) {
    if (validator == null) {
      validator = new NodeValidatorBuilder.common()..allowSvg();
    }
    treeSanitizer = new NodeTreeSanitizer(validator);
  }

  // We create a fragment which will parse in the HTML parser
  var html = '<svg version="1.1">$svg</svg>';
  var fragment =
      document.body!.createFragment(html, treeSanitizer: treeSanitizer);

  var svgFragment = new DocumentFragment();
  // The root is the <svg/> element, need to pull out the contents.
  var root = fragment.nodes.single;
  while (root.firstChild != null) {
    svgFragment.append(root.firstChild!);
  }
  return svgFragment;
}