Add DOM utils

README.md

@@ -19,6 +19,7 @@ composer require wavevision/utils
 The package contains useful classes for:
 
 - [Arrays](./src/Utils/Arrays.php) – array helpers (manipulate, sort, extract etc.)
+- [DOM](./src/Utils/DOM) – create and format data attributes for HTML elements
 - [ExternalProgram](./src/Utils/ExternalProgram/Executor.php) – simple external command runner
 - [Finder](./src/Utils/Finder.php) – adds sorting to [nette/finder](https://github.com/nette/finder)
 - [ImageInfo](./src/Utils/ImageInfo.php) – get image content type and size

src/Utils/DOM/DataAttribute.php

@@ -0,0 +1,62 @@
+<?php declare (strict_types = 1);
+
+namespace Wavevision\Utils\DOM;
+
+use Nette\SmartObject;
+
+final class DataAttribute
+{
+
+	use SmartObject;
+
+	private string $currentName;
+
+	private string $currentValue;
+
+	public function __construct(string $name, ?string $prefix = null)
+	{
+		$this->currentName = $prefix ? "data-$prefix-$name" : "data-$name";
+		$this->currentValue = '';
+	}
+
+	public function __toString(): string
+	{
+		return $this->asString();
+	}
+
+	/**
+	 * @param mixed $value
+	 * @return array<string, string>
+	 */
+	public function asArray($value = null): array
+	{
+		$this->value($value);
+		return [$this->currentName => $this->currentValue];
+	}
+
+	/**
+	 * @param mixed $value
+	 */
+	public function asString($value = null): string
+	{
+		$this->value($value);
+		return sprintf('%s="%s"', $this->currentName, $this->currentValue);
+	}
+
+	public function name(): string
+	{
+		return $this->currentName;
+	}
+
+	/**
+	 * @param mixed $value
+	 */
+	public function value($value = null): string
+	{
+		if ($value !== null) {
+			$this->currentValue = (string)$value;
+		}
+		return $this->currentValue;
+	}
+
+}

tests/UtilsTests/DOM/DataAttributeTest.php

@@ -0,0 +1,37 @@
+<?php declare (strict_types = 1);
+
+namespace Wavevision\UtilsTests\DOM;
+
+use PHPUnit\Framework\TestCase;
+use Wavevision\Utils\DOM\DataAttribute;
+
+class DataAttributeTest extends TestCase
+{
+
+	public function testAsArray(): void
+	{
+		$this->assertEquals(['data-test' => ''], $this->createDataAttribute()->asArray());
+	}
+
+	public function testAsString(): void
+	{
+		$this->assertEquals('data-test=""', $this->createDataAttribute()->asString());
+		$this->assertEquals('data-prefix-test=""', (string)$this->createDataAttribute('prefix'));
+	}
+
+	public function testName(): void
+	{
+		$this->assertEquals('data-prefix-test', $this->createDataAttribute('prefix')->name());
+	}
+
+	public function testValue(): void
+	{
+		$this->assertEquals('something', $this->createDataAttribute()->value('something'));
+	}
+
+	private function createDataAttribute(?string $prefix = null): DataAttribute
+	{
+		return new DataAttribute('test', $prefix);
+	}
+
+}