ratrijs/html-builder

Small and easy-to-use class for HTML generation using object-oriented approach.

 HTMLBuilder - best HTML generation class there is!

HTMLBuilder can be used to generate / build HTML using simple object-oriented interface., _(*1)

Feature and usage run-through

Some code snippets that showcase the HTMLBuilder features and API., _(*2)

Instance retrieval

To start building your HTML you first need to create HTMLBuilder object. Constructor doesn't need any arguments., _(*3)

There are two ways that you can achieve this:, _(*4)

• new keyword
• HTMLBuilder::dispatch() method

Both of them will achieve the same thing but HTMLBuilder::dispatch() method has the ability to be a one-liner (at least in PHP versions < 5.4)., _(*5)

Initialization via new keyword

<?php
$html = new HTMLBuilder;
?>

Initialization via HTMLBuilder::dispatch() method

<?php
$html = HTMLBuilder::dispatch();
?>

HTML generation

Almost all instance methods will append a HTML tag to the generated HTML where tag name is method name. These methods support two arguments: * content - content inside the tag * attributes - tag attributes as key-value array where key is attribute name and value is attribute value, _(*6)

Both arguments are optional. It's also possible to pass attributes as the only argument. Tag will automatically close., _(*7)

To keep the tag open you have two options: * use HTMLBuilder::open() method before the tag method * use HTMLBuilder::open() method and pass tag name and attributes as arguments for this method, _(*8)

Instance methods as tags

php, _(*9)

<?php
echo HTMLBuilder::dispatch()->p("Hello World");
?>

html, _(*10)

<p>Hello World</p>

Keeping tags open to build nested HTML

Using HTMLBuilder::open() before tag method

php, _(*11)

<?php
echo HTMLBuilder::dispatch()->open()->div()->p("Hello World");
?>

html, _(*12)

<div><p>Hello World</p></div>

Using HTMLBuilder::open() and pass tag arguments inside it

php, _(*13)

<?php
echo HTMLBuilder::dispatch()->open("div")->p("Hello World");
?>

html, _(*14)

<div><p>Hello World</p></div>