zero-to-prod/laravel-svg

Serve your svg files from an endpoint.

v0.1.9 2024-12-05 05:05 UTC

Requires

• php: >=8.1.0

Requires (Dev)

• orchestra/testbench: ^8.6.0|^9.0
• phpunit/phpunit: ^10.0

Suggests

• zero-to-prod/data-model-factory: Factoryies for a DataModel.
• zero-to-prod/data-model-helper: Helpers for a DataModel.
• zero-to-prod/transformable: Transform a class into different types.

MIT

• David Smith

• laravel-svg
• zero-to-prod

README

Serve your svg files from an endpoint.

Installation

You can install the package via Composer:

composer require zero-to-prod/laravel-svg

Publish Vendor Files

php artisan vendor:publish --tag=laravel-svg-config
php artisan vendor:publish --tag=laravel-svg-views

Usage

Create blade files under resources/views/laravel_svg/svg.

<svg class="{{$classname}}" fill="{{$fill}}" xmlns="http://www.w3.org/2000/svg" viewBox="0 0 576 512">
    <path d="M575.8 255.5c0 18-15 32.1-32 32.1l-32 0 .7 160.2c0 2.7-.2 5.4-.5 8.1l0 16.2c0 22.1-17.9 40-40 40l-16 0c-1.1 0-2.2 0-3.3-.1c-1.4 .1-2.8 .1-4.2 .1L416 512l-24 0c-22.1 0-40-17.9-40-40l0-24 0-64c0-17.7-14.3-32-32-32l-64 0c-17.7 0-32 14.3-32 32l0 64 0 24c0 22.1-17.9 40-40 40l-24 0-31.9 0c-1.5 0-3-.1-4.5-.2c-1.2 .1-2.4 .2-3.6 .2l-16 0c-22.1 0-40-17.9-40-40l0-112c0-.9 0-1.9 .1-2.8l0-69.7-32 0c-18 0-32-14-32-32.1c0-9 3-17 10-24L266.4 8c7-7 15-8 22-8s15 2 21 7L564.8 231.5c8 7 12 15 11 24z"></path>
</svg>

Use the component like this:

<x-svg name="home" classname="h-4 w-4 opacity-70" alt="alt" />
<!-- Renders -->
<img class="h-4 w-4 opacity-70" src="http://localhost/svg/home" alt="alt">

Configuration

return [
    'endpoint' => '/svg/{name}',
    'route_name' => 'svg',
    'view' => 'laravel_svg.svg',
    'svg_path' => 'laravel_svg.svg',
    'view_namespace' => 'svg',
    'component_prefix' => 'svg',
    'middleware' => null,
    'view_component' => \Zerotoprod\LaravelSvg\Svg::class,
    'controller' => \Zerotoprod\LaravelSvg\SvgController::class
];

Testing

./vendor/bin/phpunit