netzmacht/html

Simple library for html rendering

HTML helper library

, _(*1)

This library is a PHP helper library for creating HTML output., _(*2)

Install

This extension can be installed using Composer, _(*3)

composer require netzmacht/html:^3.0, _(*4)

Requirements

PHP ^8.1, _(*5)

Basic Usage

Define the attributes in the View:, _(*6)

Attributes

$attributes = new Netzmacht\Html\Attributes();
$attributes
    ->setId('a_id')
    ->addClass('a_class')
    ->setAttribute('data-target', '#some');

This library uses the magic __toString to converts the helper objects to string. Outputting is really simple now:, _(*7)

>Label This is a paragraph.

Of course you can change the attributes before generating, _(*8)

setId('second')->removeClass('a_class')->addClass('new_class'); ?>>the content

Elements

Of course you can create the whole element as well. The library knows about standalone html elements which can't have any children and nodes which have children. Notice that the css classes are passed as array., _(*9)

$factory   = new Netzmacht\Html\Factory\ElementFactory();
$paragraph = $factory->create('p', array('id' => 'a_id', 'class' => array('description'));
$label     = $factory->create('span');

$label
    ->addClass('label')
    ->addChild('Label this');

$paragraph
    ->addChild('This is a paragraph.')
    ->addChild(' '); // add space between both elements
    ->addChild($label, Netzmacht\Html\Element\Node::POSITION_FIRST); // add at first position    

Now you can output the whole element:, _(*10)

<article>
    <?= $paragraph; ?>
</article>