v1.0.0 initial release

2025-06-13 10:48:20 -10:00
commit 0c8f70bca5
3333 changed files with 189946 additions and 0 deletions
@@ -0,0 +1,99 @@
+<?php
+
+declare(strict_types=1);
+
+namespace BladeUI\Icons;
+
+use BladeUI\Icons\Concerns\RendersAttributes;
+use Illuminate\Contracts\Support\Htmlable;
+use Illuminate\Support\Str;
+
+final class Svg implements Htmlable
+{
+    use RendersAttributes;
+
+    private string $name;
+
+    private string $contents;
+
+    public function __construct(string $name, string $contents, array $attributes = [])
+    {
+        $this->name = $name;
+        $this->contents = $this->deferContent($contents, $attributes['defer'] ?? false);
+
+        unset($attributes['defer']);
+
+        $this->attributes = $attributes;
+    }
+
+    public function name(): string
+    {
+        return $this->name;
+    }
+
+    public function contents(): string
+    {
+        return $this->contents;
+    }
+
+    /**
+     * This method adds a title element and an aria-labelledby attribute to the SVG.
+     * To comply with accessibility standards, SVGs should have a title element.
+     * Check accessibility patterns for icons: https://www.deque.com/blog/creating-accessible-svgs/
+     */
+    public function addTitle(string $title): string
+    {
+        // create title element
+        $titleElement = '<title>'.$title.'</title>';
+
+        // add role attribute to svg element
+        $this->attributes['role'] = 'img';
+
+        // add title element to svg
+        return preg_replace('/<svg[^>]*>/', "$0$titleElement", $this->contents);
+    }
+
+    public function toHtml(): string
+    {
+        // Check if the title attribute is set and add a title element to the SVG
+        if (array_key_exists('title', $this->attributes)) {
+            $this->contents = $this->addTitle($this->attributes['title']);
+        }
+
+        return str_replace(
+            '<svg',
+            sprintf('<svg%s', $this->renderAttributes()),
+            $this->contents,
+        );
+    }
+
+    protected function deferContent(string $contents, $defer = false): string
+    {
+        if ($defer === false) {
+            return $contents;
+        }
+
+        $svgContent = Str::of($contents)
+            ->replaceMatches('/<svg[^>]*>/', '')
+            ->replaceMatches('/<\/svg>/', '')
+            ->__toString();
+
+        // Force Unix line endings for hash.
+        $hashContent = str_replace(PHP_EOL, "\n", $svgContent);
+        $hash = 'icon-'.(is_string($defer) ? $defer : md5($hashContent));
+
+        $contents = str_replace($svgContent, strtr('<use href=":href"></use>', [':href' => '#'.$hash]), $contents).PHP_EOL;
+        $svgContent = ltrim($svgContent, PHP_EOL);
+        $contents .= <<<BLADE
+                @once("{$hash}")
+                    @push("bladeicons")
+                        <g id="{$hash}">
+                            {$svgContent}
+                        </g>
+                    @endpush
+                @endonce
+            BLADE;
+
+        return $contents;
+    }
+}