Laravel 8 – 10
Low commit activity in last 18 months
codeat3's helper methods to use in blade-icon generation scripts
2005
2006
2007
2008
2009
2010
2011
2012
2013
2014
2015
2016
2017
2018
2019
2020
2021
2022
2023
2024
2025
2026
 Dependencies

Development

codeat3/phpcs-styles
^1.0

Runtime

^8.0|^9.0|^10.0
symfony/process
^5.0|^6.0
symfony/filesystem
^5.0|^6.0
codeat3/inlinestyle
^2.0
 Project Readme

Blade Icon Generation Helpers

A helper package to convert the icons to make it compatible to be used with the blade-icons package.

Installation

composer require codeat3/blade-icon-generation-helpers

Usage

Kindly refer the Generating Icons section from Blade Icons. This Package utilizes the after callback to process the icons as per our need.

The after callback received 3 arguments string $icon - this is the pathname of the icon, array $config - the config specified in the generation.php & SplFileInfo $file - the original icon file instance.

Inside a callback we instantiate our Processor class & use its helper methods to our benefit.

$iconProcessor = new IconProcessor($icon, $config, $sourceFile);

This IconProcessor instance itself does some optimization on its own by default. Minimal usage would be as follows.

$iconProcessor = new IconProcessor($icon, $config, $sourceFile);
    $iconProcessor
        ->optimize()
        ->save();

The optimize method does the following things by default:

  • it removes the following attributes from the svg
    • 'width', 'height', 'class', 'style', 'id',
  • if in the config provided is-outline is set as true
    • if fill attribute exists - it will updated to none
    • if stroke attribute exists - it will updated to currentColor
  • if in the config provided is-solid is set as true
    • if fill attribute exists - it will updated to currentColor
  • if in the config provided custom-attributes is set`
    • it will set the attributes to the svg
  • optionally it provides 2 callable methods pre & post
    • both callback receives the $svgEL as the DOMDocument - its the DOMDocument instance of the current icon
    • pre can be used if you have to perform some operation before Processor does the default processing
    • post can be used if you have to perform some operation after Processor does the default processing

The save method