README

Html SVG

A robust, fluent, and immutable PHP library for generating and manipulating SVG elements.
Secure file loading, accessibility-first design, and standards-compliant rendering.

Features

Installation

composer require ui-awesome/html-svg:^0.3

Quick start

The SVG element is a container that defines a new coordinate system and viewport.

It is used as the outermost element of SVG documents, but it can also be used to embed an SVG fragment inside an SVG or HTML document.

Basic usage

use UIAwesome\Html\Svg\Svg;

// create a simple SVG with path
echo Svg::tag()
    ->content('<path d="..." />')
    ->viewBox('0 0 100 100')
    ->render();

Loading from file (Secure)

use UIAwesome\Html\Svg\Svg;

// load, sanitize, and inject an external SVG file
echo Svg::tag()
    ->class('icon-lg')
    ->filePath('/path/to/icon.svg')
    ->fill('currentColor')
    ->render();

Accessibility handling

use UIAwesome\Html\Svg\Svg;

// automatically injects <title> tag for screen readers
echo Svg::tag()
    ->content('<path d="..." />')
    // Becomes <title>User Profile</title>
    ->title('User Profile')
    ->render();