feat: add dom() method

RockFrontend.module.php

@@ -17,6 +17,7 @@
 use Sabberworm\CSS\Rule\Rule;
 use Sabberworm\CSS\RuleSet\AtRuleSet;
 use Sabberworm\CSS\RuleSet\RuleSet;
+use Wa72\HtmlPageDom\HtmlPageCrawler;
 
 /**
  * @author Bernhard Baumrock, 05.01.2022
@@ -597,6 +598,28 @@ private function createPermission($name, $title)
     $p->setAndSave('title', $title);
   }
 
+  /**
+   * Load HtmlPageDom
+   *
+   * If you have plain HTML like from TinyMCE field some methods will not work
+   * because they need a hierarchy with a single root element. That's why by
+   * default the dom() method will add a wrapping div unless you specify
+   * FALSE as second param.
+   *
+   * Usage:
+   * $rockfrontend->dom("your html string")
+   *   ->filter("img")
+   *   ->each(function($img) {
+   *     $img->attr('src', '/foo/bar.png');
+   *   });
+   */
+  public function dom($data, $addWrapperDiv = true): HtmlPageCrawler
+  {
+    require_once __DIR__ . "/vendor/autoload.php";
+    if ($addWrapperDiv) $data = "<div>$data</div>";
+    return HtmlPageCrawler::create($data);
+  }
+
   /**
    * Download uikit
    * @return void

composer.json

@@ -1,7 +1,8 @@
 {
-    "require": {
-        "latte/latte": "^3.0",
-        "sabberworm/php-css-parser": "^8.4",
-        "matthiasmullie/minify": "^1.3"
-    }
+  "require": {
+    "latte/latte": "^3",
+    "sabberworm/php-css-parser": "^8.4",
+    "matthiasmullie/minify": "^1.3",
+    "wa72/htmlpagedom": "^3.0"
+  }
 }