You are here

public static function Html::load in Drupal 9

Same name and namespace in other branches
  1. 8 core/lib/Drupal/Component/Utility/Html.php \Drupal\Component\Utility\Html::load()
  2. 10 core/lib/Drupal/Component/Utility/Html.php \Drupal\Component\Utility\Html::load()

Parses an HTML snippet and returns it as a DOM object.

This function loads the body part of a partial (X)HTML document and returns a full \DOMDocument object that represents this document.

Use \Drupal\Component\Utility\Html::serialize() to serialize this \DOMDocument back to a string.

Parameters

string $html: The partial (X)HTML snippet to load. Invalid markup will be corrected on import.

Return value

\DOMDocument A \DOMDocument that represents the loaded (X)HTML snippet.

18 calls to Html::load()
CKEditorIntegrationTest::getDrupalMediaFromSource in core/modules/media/tests/src/FunctionalJavascript/CKEditorIntegrationTest.php
Parses the <drupal-media> element from CKEditor's "source" view.
CKEditorIntegrationTest::testButton in core/modules/media_library/tests/src/FunctionalJavascript/CKEditorIntegrationTest.php
Tests using DrupalMediaLibrary button to embed media into CKEditor.
CKEditorIntegrationTest::testEditableCaption in core/modules/media/tests/src/FunctionalJavascript/CKEditorIntegrationTest.php
Tests caption editing in the CKEditor widget.
EditorFileReference::process in core/modules/editor/src/Plugin/Filter/EditorFileReference.php
Performs the filter processing.
FilterAlign::process in core/modules/filter/src/Plugin/Filter/FilterAlign.php
Performs the filter processing.

... See full list

File

core/lib/Drupal/Component/Utility/Html.php, line 274

Class

Html
Provides DOMDocument helpers for parsing and serializing HTML strings.

Namespace

Drupal\Component\Utility

Code

public static function load($html) {
  $document = <<<EOD
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
<html xmlns="http://www.w3.org/1999/xhtml">
<head><meta http-equiv="Content-Type" content="text/html; charset=utf-8" /></head>
<body>!html</body>
</html>
EOD;

  // PHP's \DOMDocument serialization adds extra whitespace when the markup
  // of the wrapping document contains newlines, so ensure we remove all
  // newlines before injecting the actual HTML body to be processed.
  $document = strtr($document, [
    "\n" => '',
    '!html' => $html,
  ]);
  $dom = new \DOMDocument();

  // Ignore warnings during HTML soup loading.
  @$dom
    ->loadHTML($document);
  return $dom;
}