CONTENIDO HTML generation
cHTML
The central element is the cHTML class with the elementary features to generate valid html tags including content, attributes.
Complete class diagramm:
The cHtml class provides to set ids automatically. The Ids will be in the format 'm1', the number will be incremented for every new instance. If you don´t want to use this feature it is possible to set the id manually with the public method setID(id).
Code examples:
| Code Block | ||
|---|---|---|
| ||
$cHtml = new cHTML();
// cHTML object has the id 'm1';
$cHtml->setId('testId');
// cHTML object has the id 'testId'; |
| Method | Description |
|---|---|
| addRequiredScript($script) | Adds a required script to the current element.Scripts are not included twice. |
| advanceID() | generate a unique id. |
appendStyleDefinition($property, $value) | Appends the given style definition to the HTML element. |
| appendStyleDefinitions(array $styles) | Appends the given style definitions to the HTML element. |
| attachEventDefinition($name, $event, $code) | Attaches the code for an event. |
| display() | Outputs the generated markup. |
| getAttribute($attributeName) | Returns the value of the given attribute. |
| getAttributes($returnAsString = false) | Returns the assoc array(default) or string of attributes |
| getID() | Returns the current ID. |
| removeAttribute($attributeName) | Removes an attribute. |
| render() | Alias for toHtml. |
| setAlt($alt, $setTitle = true) | Sets the alt and title attributes. |
| setAttribute($attributeName, $value = NULL) | Sets a specific attribute. |
| setAttributes(array $attributes) | Sets the HTML attributes. |
| setClass($class) | Sets the CSS class. |
setEvent($event, $action) | Adds an "on..." javascript event handler. |
| setGenerateXHTML($value) | Setter for static $_generateXHTML property. |
| setID($id) | Sets the ID class. |
| setStyle($style) | Sets the CSS style. |
| setTag($tag) | Sets the HTML tag. |
| toHTML() | Generates the markup of the element. |
| unsetEvent($event) | Removes an event handler. |
| updateAttribute($name, $value) | Updates the passed attribute without changing the other existing attributes. |
| updateAttributes(array $attributes) | Updates the passed attributes without changing the other existing attributes. |
At the first inheritance level are the classes cHTMLFormElement, cHTMLContentElement, cHTMLIframe and cHTMLImage.
cHTMLFormElement
The cHTMLFormElement class represents a form element.
Specified elements:
| Class | Description | HTML element | |
|---|---|---|---|
| The cHTMLButton class represents a button. | <button></button> | ||
| cHTMLSelectElement | cHTMLSelectElement class represents a select element. | <select></select> | |
| cHTMLOptionElement | cHTMLOptionElement class represents a select option element. | <option></option> | |
| cHTMLPasswordbox | cHTMLPasswordbox class represents a password form field. | <input type="password" /> | |
| cHTMLHiddenField | cHTMLHiddenField class represents a hidden form field. | <input type="hidden" /> | |
| cHTMLUpload | cHTMLUpload class represents a file upload element. | <input type="file" /> | |
| cHTMLTextarea | cHTMLTextarea class represents a textarea. | <textarea></textarea> | |
| cHTMLRadiobutton | cHTMLRadiobutton class represents a radio button. | <input type="radio" /> | |
| cHTMLCheckbox | cHTMLCheckbox class represents a checkbox. | <input type="checkbox" /> | |
| cHTMLTextbox | cHTMLTextbox class represents a textbox. | <input type="text" /> |
cHTMLContentElement
The cHTMLContentElement class represents a content element.
| Class | Description | HTML element | |
|---|---|---|---|
| cHTMLOptgroup | cHTMLOptgroup class can be used for creating optgrops. | <optgroup></optgroup> | |
| cHTMLFieldset | cHTMLFieldset class represents a fieldset element. | <fieldset></fieldset> | |
| cHTMLTableHeader | cHTMLTableHead class represents a table head. | <th></th> | |
| cHTMLSection | cHTMLSection class represents a section within an article. | <section></section> | |
| cHTMLListItem | cHTMLListItem class represents a list item. | <li></li> | |
| cHTMLTableBody | cHTMLTableBody class represents a table body. | <table></table> | |
| cHTMLTime | cHTMLTime class represents a date/time. | <time></time> | |
| cHTMLNav | cHTMLNav class represents a navigation. | <nav></nav> | |
| cHTMLForm | cHTMLForm class represents a form. | <form></form> | |
| cHTMLCanvas | cHTMLCanvas class can be used for creating graphics. | <canvas></canvas> | |
| cHTMLList | cHTMLList class represents a list. | <ul></ul>, <ol></ol> | |
| cHTMLTableData | cHTMLTableData class represents a table date. | <td></td> | |
| cHTMLArticle | cHTMLArticle class represents an HTML5 article element. | <article></article> | |
| cHTMLSpan | cHTMLSpan class represents a span element. | <span></span> | |
| cHTMLAside | cHTMLAside class represents content which is related to the surrounding content. | <aside><aside> | |
| cHTMLLabel | cHTMLLabel class represents a form label. | <label></label> | |
| cHTMLLink | cHTMLLink class represents a link. | <a></a> | |
| cHTMLLegend | cHTMLLegend class represents a legend element. | <legend></legend> | |
| cHTMLScript | cHTMLScript class represents a script. | <script></script> | |
| cHTMLParagraph | cHTMLParagraph class represents a paragraph. | <p></p> | |
| cHTMLHeader | cHTMLHeader class represents a header. | <header></header> | |
| cHTMLFooter | HTMLFooter class represents a footer. | <footer></footer> | |
| cHTMLHgroup | cHTMLHgroup class represents a set of related headlines. | ||
| cHTMLDiv | cHTMLDiv class represents a div element. | <div></div> | |
| cHTMLTableRow | cHTMLTableRow class represents a table row. | <tr></tr> | |
| cHTMLVideo | cHTMLVideo class represents a video. | <video></video> | |
| cHTMLAudio | cHTMLAudio class specifies sound content. | <audio></audio> | |
| cHTMLTable | cHTMLTable class represents a table. | <table></table> |
cHTMLIFrame
The cHTMLIFrame class represents an iframe.
| Method | Description |
|---|---|
| setSrc(string $src) | This method sets the source of the iframe. |
| setWidth(string $width) | This method sets the width of the iframe. |
| setHeight(string $height) | This method sets the height of the iframe. |
| setBorder(string $border) | This method sets the border of the iframe. |
cHTMLImage
The cHTMLImage class represents an image.
| Method | Description |
|---|---|
| setSrc(string $src) | This method sets the source of the image. |
| setWidth(string $width) | This method sets the width of the image. |
| setHeight(string $height) | This method sets the height of the image. |
| setBorder(string $border) | This method sets the border of the image. |