airmanbzh/php-html-generator

PHP html generator

PHP HTML GENERATOR

Create HTML tags and render them efficiently., _(*1)

Build status: * Master * Dev , _(*2)

Overview

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

```php return HtmlTag::createElement('a'); // returns an HtmlTag containing a 'a' tag, <sub>(*3)</sub>

### 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

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

or, <sub>(*4)</sub>

$tag = HtmlTag::createElement('a')
echo( $tag );

Simple tags

echo HtmlTag::createElement('div');

```html , <sub>(*5)</sub>

```php
echo(HtmlTag::createElement('p')->text('some content'));

```html , <sub>(*6)</sub>

some content, <sub>(*7)</sub>

### Structured tags

```php
echo(HtmlTag::createElement('div')->addElement('a')->text('a text'));

```html , <sub>(*8)</sub>

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

```html , <sub>(*9)</sub>

### Attributes

#### Classics attributes (method : 'set')

```php
$tag = HtmlTag::createElement('a')
    ->set('href','./sample.php')
    ->set('id','myID')
    ->text('my link');
echo( $tag );

```html my link, <sub>(*11)</sub>

#### Shortcut to set an ID attribute (method : 'id')

```php
$tag = HtmlTag::createElement('div')
    ->id('myID');
echo( $tag );

```html , <sub>(*12)</sub>

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

```php
$tag = HtmlTag::createElement('div')
    ->addClass('oneClass')
    ->text('my content')
echo( $tag );

```html , <sub>(*13)</sub>

```php
$tag = HtmlTag::createElement('div')
    ->addClass('aClass')
    ->addClass('anothereClass')
    ->text('my content')
echo( $tag );

```html , <sub>(*14)</sub>

```php
$tag = HtmlTag::createElement('div')
    ->addClass('firstClass')
    ->addClass('secondClass')
    ->text('my content')
    ->removeClass('firstClass');
echo( $tag );

```html , <sub>(*15)</sub>

### More

Text and content are generated according to the order of addition
```php
$tag = HtmlTag::createElement('p')
    ->text('a text')
    ->addElement('a')
    ->text('a link');

```html , <sub>(*16)</sub>

ma texta link, <sub>(*17)</sub>

To generate content before text, 2 solutions :
```php
$tag = HtmlTag::createElement('p')
    ->addElement('a')
    ->text('a link')
    ->getParent()
    ->text('a text');

or, <sub>(*18)</sub>

$tag = HtmlTag::createElement('p');
$tag->addElement('a')->text('a link');
$tag->text('a text');

<p><a>a link</a>a text</p>