feat: add svgWithClass

src/HtmlHelpers.php

@@ -0,0 +1,18 @@
+<?php
+
+namespace VolkmannDesignCode\KirbyUtils;
+
+use Kirby\Cms\File;
+use Kirby\Toolkit\A;
+use Kirby\Toolkit\Html;
+use Kirby\Toolkit\Str;
+
+class HtmlHelpers {
+
+    static function svgWithClass(string|File $file, string|array $classes): string|null {
+        $classNames = is_string($classes) ? [$classes] : $classes;
+        $class = Html::attr('class', A::join($classNames, ' '));
+        return Str::replace(svg($file), '<svg', '<svg ' . $class);
+    }
+
+}

tests/HtmlHelpersTest.php

@@ -0,0 +1,22 @@
+<?php declare(strict_types=1);
+
+use Kirby\Cms\App;
+use PHPUnit\Framework\TestCase;
+use VolkmannDesignCode\KirbyUtils\HtmlHelpers;
+
+final class HtmlHelpersTest extends TestCase
+{
+    public function testSvgWithClasses(): void
+    {
+        $svgPath = App::instance()->root() . '/tests/fixtures/kirby.svg';
+        $regular = svg($svgPath);
+        $this->assertStringStartsNotWith($regular, '<svg class="');
+
+        $withClass = HtmlHelpers::svgWithClass($svgPath, 'kirby');
+        $this->assertStringStartsWith('<svg class="kirby"', $withClass);
+
+        $withMultipleClasses = HtmlHelpers::svgWithClass($svgPath, ['kirby', 'icon']);
+        $this->assertStringStartsWith('<svg class="kirby icon"', $withMultipleClasses);
+    }
+
+}