Spec-Zone.ru › Dart 2

dart:svg

Метод createFragment

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

Создаёт 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;
}

© 2012 the Dart project authors
Licensed under the BSD 3-Clause "New" or "Revised" License.
https://api.dart.dev/stable/2.18.5/dart-svg/SvgElement/createFragment.html

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API