hnhdigital-os/laravel-html-generator

3.2.3 2023-11-07 02:39 UTC

Requires

• php: ^8.0
• laravel/framework: ^9.21|^10.0

Requires (Dev)

• orchestra/testbench: ^7.0|^8.0
• phpstan/phpstan: ^1.10
• phpunit/phpunit: ^9.3

MIT

• Rocco Howard

README

Create HTML tags and render them efficiently.

Extends upon Airmanbzh/php-html-generator with some Laravel related integration.

Overview

return HtmlTag::createElement();
// returns an empty HtmlTag Container

return HtmlTag::createElement('a');
// returns an HtmlTag containing a 'a' tag

Why you should use it

• it always generates valid HTML and XHTML code
• it makes templates cleaner
• it's easy to use and fast to execute

Render tags

echo(HtmlTag::createElement('a'));

Simple tags

echo $html->tag('div')
// <div></div>

echo(HtmlTag::createElement('p')->text('some content'));
// <p>some content</p>

Structured tags

echo(HtmlTag::createElement('div')->addElement('a')->text('a text'));
// <div><a>a text</a></div>

$container = HtmlTag::createElement('div');
$container->addElement('p')->text('a text');
$container->addElement('a')->text('a link');
// <div><p>a text</p><a>a link</a></div>

Attributes

Classics attributes (method : 'set')

$tag = $html->tag('a')
    ->set('href','./sample.php')
    ->set('id','myID')
    ->text('my link');
echo( $tag );
// <a href='./sample.php' id='myID'>my link</a>

ID (method : 'id')

$tag = $html->tag('div')
    ->id('myID');
echo( $tag );
// <div id='myID'>my link</a>

Class management (method : 'addClass'/'removeClass')

$tag = $html->tag('div')
    ->addClass('firstClass')
    ->addClass('secondClass')
    ->text('my content')
    ->removeClass('firstClass');
echo( $tag );
// <div class="secondClass">my content</div>

Contributing

Please see CONTRIBUTING for details.

Credits

• Rocco Howard
• Lucas Mezêncio
• All Contributors

License

The MIT License (MIT). Please see License File for more information.