dart:svg

Метод createFragment

Создать DocumentFragment из фрагмента HTML и убедиться, что он соответствует правилам очистки, заданным валидатором или treeSanitizer.

Если поведение по умолчанию слишком ограничительное, необходимо создать новый NodeValidator, либо расширяя или оборачивая валидатор по умолчанию и переопределяя API валидации.

treeSanitizer используется для обхода сгенерированного дерева узлов и его очистки. Также можно предоставить пользовательский treeSanitizer для выполнения специальных правил валидации, но поскольку API сложнее в реализации, это не рекомендуется.

Возвращаемое дерево гарантированно содержит только узлы и атрибуты, разрешенные предоставленным валидатором.

См. также:

• NodeValidator
• NodeTreeSanitizer

Исходный код

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;
}