HelPHP

Html

in package

• helPHP
• libs

Tags

class

HTML

it's the base class for all HTML tags and elements. It allows to create HTML tags and elements, to add attributes, children,etc. it's main purpose is to generate HTML code in a structured way, and manipulate it easily as an object, and permit to avoid direct html writing inside PHP for a better reading of the code, but also to push all the display at the end of the data processing.

It can be used to create complex HTML structures, such as forms, tables, lists, etc. And it's the fundation of the H class that is creating more complex html object.

all constants are there to bridge to html tags, if html evolve or if you want to connect to another lib display

this class use magic methods to help manipulate html object.

see

__get()

see

__set()

see

__unset()

Table of Contents

Constants

_CHECKMARK_BOLD  = '✔'

_CHECKMARK_NORMAL  = '✓'

_DOWN_ARROW  = '↓'

_DOWN_DASHED_ARROW  = '⇣'

_LEFT_ARROW  = '←'

_LEFT_DASHED_ARROW  = '⇠'

_RIGHT_ARROW  = '→'

_RIGHT_ARROW_HEAD  = '➤'

_RIGHT_DASHED_ARROW  = '⇢'

_STAR_EMPTY  = '☆'

_STAR_FULL  = '★'

_UP_ARROW  = '↑'

_UP_DASHED_ARROW  = '⇡'

_X_BOLD  = '✖'

_X_NORMAL  = '✕'

A  = 'a'

AUDIO  = 'audio'

BODY  = 'body'

BR  = 'br'

BUTTON  = 'button'

CANVAS  = 'canvas'

DATALIST  = 'datalist'

DETAILS  = 'details'

DIV  = 'div'

FIELDSET  = 'fieldset'

FORM  = 'form'

HEAD  = 'head'

HR  = 'hr'

HTML  = 'html'

IMAGE  = 'IMAGE'

IMG  = 'img'

INPUT  = 'input'

LABEL  = 'label'

LEGEND  = 'legend'

LI  = 'li'

LINK  = 'link'

META  = 'meta'

OPTGROUP  = 'optgroup'

OPTION  = 'option'

PARAM  = 'param'

QUICK_EDIT_DATA  = 'qe_d'

QUICK_EDIT_FIELD  = 'qe_f'

QUICK_EDIT_ID  = 'qe_i'

QUICK_EDIT_TYPE  = 'qe_t'

QUICK_EDIT_TYPE_INDEX  = 'qe_ti'

SCRIPT  = 'script'

SELECT  = 'select'

simple_tags  = [\helPHP\libs\Html::IMG, \helPHP\libs\Html::IMAGE, \helPHP\libs\Html::BR, \helPHP\libs\Html::HR, \helPHP\libs\Html::INPUT, \helPHP\libs\Html::LINK, \helPHP\libs\Html::META, \helPHP\libs\Html::PARAM, \helPHP\libs\Html::USE]

SOURCE  = 'source'

SPAN  = 'span'

STYLE  = 'style'

SUMMARY  = 'summary'

SVG  = 'svg'

TABLE  = 'table'

TBODY  = 'tbody'

TD  = 'td'

TEXTAREA  = 'textarea'

TFOOT  = 'tfoot'

TH  = 'th'

THEAD  = 'thead'

TITLE  = 'title'

TR  = 'tr'

UL  = 'ul'

USE  = 'use'

VIDEO  = 'video'

Properties

$children  : mixed

$current_value  : mixed

$current_value_label  : mixed

$debug  : mixed

$extra  : mixed

$items_after  : mixed

$label  : mixed

$label_for  : mixed

Methods

__construct()  : mixed

__get()  : string

Retrieve any attribute of the tag via: attr_ {attribute name} ex: $ tag-> attr_style to get the css style the 'id', 'name' and 'class' attributes can be retrieved directly without using the attr_ prefix For non-standard attributes defined by the user, you must enter data_ instead of attr_ once converted to html, these attributes will be named "data- {attribute name}" to become accessible for JS conterpart thru dataset property.

__set()  : void

Magic method to set attributes of the HTML element.

__toString()  : string

Magic method called when a string operation is done with the current object.

__unset()  : void

Magic method to unset an attribute of the HTML element.

add_after()  : int|bool

Adds an item or a list of items to be rendered after the current HTML element.

add_child()  : int|bool

Adds a child element or a list of child elements to the current HTML element.

add_class()  : void

Adds a CSS class to the HTML element's class attribute.

add_debug()  : mixed

after_html()  : string

Generates the HTML for items that should be rendered after the current element.

close_html()  : string

Generates the closing HTML tag for the current element.

close_tag()  : string

Create a closing tag

content_html()  : string

Generates the HTML content of the element's children.

copy_attributes_to()  : void

Copies attributes, data, and extra properties from the current HTML element to another.

debug_structure()  : Html

exepose the current object structure as an object tree.

del_attribute()  : void

Delete an HTML attribute for the element.

find_child()  : Html|null

Recursively searches for a child element within the current HTML element's children.

full_html()  : string

Generates the complete HTML for the current object/element, including its opening tag, content, and closing tag.

get_children()  : array<string|int, mixed>

All is in the name

get_items_after()  : array<string|int, mixed>

Retrieves the items that should be rendered after the current HTML element.

get_unique_id()  : string

create the unique_id for html tag

is_simple()  : bool

check if the tag is a simple one like <br> with no closing tag

label_tag()  : Html

Create an Html::Label tag from $label and $attributes or from $this->label and $this->attributes of the current object.

open_html_tag()  : string

Generates the opening HTML tag for the current element.

open_tag()  : string

Create an opening tag with its attributes

output()  : string

Will return the current HTML content as string.

parse_event()  : mixed

Retrieve event that need to pass by event.js it automaticaly removed onclick or onchange and over attributes related to events, to pass them thru the event.js class.

reset_key()  : mixed

Reset key_name

set_attribute()  : void

Sets an HTML attribute for the element.

set_extra()  : void

Sets an extra property for the element.

tag()  : Instance

Create a new Html instance for a tag