Spec-Zone.ru › Dart 2

dart:svg

метод createFragment

DocumentFragment createFragment(
  1. String? svg,
  2. {NodeValidator? validator,
  3. NodeTreeSanitizer? treeSanitizer}
)
переопределение

Создаёт DocumentFragment из HTML-фрагмента и проверяет, что он соответствует правилам очистки, заданным validator или 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.19.6/dart-svg/SvgElement/createFragment.html

Spec-Zone.ru

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