X-Git-Url: https://git-public.kairo.at/?p=php-utility-classes.git;a=blobdiff_plain;f=classes%2Fdocument.php-class;h=1f820601cf374befb179a3791669d5bd4aaad58d;hp=41e817a4d96b678740e1fa0ca82591a886af529c;hb=4ae3168ebc5ef2b6cbbac493fbe485aaa7353a02;hpb=7b9ebce7d25e4eaa557e8a64f8b1ed15aad1a9bb diff --git a/classes/document.php-class b/classes/document.php-class index 41e817a..1f82060 100755 --- a/classes/document.php-class +++ b/classes/document.php-class @@ -1,23 +1,7 @@ - * - * ***** END LICENSE BLOCK ***** */ +/* This Source Code Form is subject to the terms of the Mozilla Public + * License, v. 2.0. If a copy of the MPL was not distributed with this file, + * You can obtain one at http://mozilla.org/MPL/2.0/. */ class ExtendedDocument extends DOMDocument { // ExtendedDocument PHP class @@ -27,8 +11,9 @@ class ExtendedDocument extends DOMDocument { // CONSTRUCTOR // construct a new DOM Document that uses our element definitions // - // static function initHTML5() + // static function initHTML5([$doc]) // initialize as an HTML5 document and return references to its basic elements. + // If a $doc is handed over (an ExtendedDocument or a derived class), load the content into that document. // returns an associative array with the following elements: 'html', 'head', 'title', 'body' // // public function appendElement($name, [$value]) @@ -40,7 +25,7 @@ class ExtendedDocument extends DOMDocument { // with an ExtendedDocument::createXMLFragment() of the given XML data inside // returns the new child // - // public function appendLink($target, [$value]) + // public function appendLink($target, [$value], [$title]) // appends an ExtendedDocument::createElementLink() as a child of this document (see there for params) // returns the new child // @@ -64,16 +49,40 @@ class ExtendedDocument extends DOMDocument { // appends an ExtendedDocument::createElementInputText() as a child of this document (see there for params) // returns the new child // + // public function appendInputPassword($name, $maxlength, $size, [$id], [$value]) + // appends an ExtendedDocument::createElementInputPassword() as a child of this document (see there for params) + // returns the new child + // // public function appendInputNumber($name, $maxlength, $size, [$id], [$value]) // appends an ExtendedDocument::createElementInputNumber() as a child of this document (see there for params) // returns the new child // + // public function appendInputRange($name, $id, $min, $max, [$step], [$value]) + // appends an ExtendedDocument::createElementInputRange() as a child of this document (see there for params) + // returns the new child + // + // public function appendInputUrl($name, $maxlength, $size, [$id], [$value]) + // appends an ExtendedDocument::createElementInputUrl() as a child of this document (see there for params) + // returns the new child + // // public function appendInputEmail($name, $maxlength, $size, [$id], [$value]) // appends an ExtendedDocument::createElementInputEmail() as a child of this document (see there for params) // returns the new child // - // public function appendInputPassword($name, $maxlength, $size, [$id], [$value]) - // appends an ExtendedDocument::createElementInputPassword() as a child of this document (see there for params) + // public function appendInputTel($name, $maxlength, $size, [$id], [$value]) + // appends an ExtendedDocument::createElementInputTel() as a child of this document (see there for params) + // returns the new child + // + // public function appendInputDate($name, [$id], [$min], [$max], [$value]) + // appends an ExtendedDocument::createElementInputDate() as a child of this document (see there for params) + // returns the new child + // + // public function appendInputTime($name, [$id], [$min], [$max], [$value]) + // appends an ExtendedDocument::createElementInputTime() as a child of this document (see there for params) + // returns the new child + // + // public function appendInputColor($name, [$id], [$value]) + // appends an ExtendedDocument::createElementInputColor() as a child of this document (see there for params) // returns the new child // // public function appendInputRadio($name, $id, $value, $checked) @@ -100,7 +109,7 @@ class ExtendedDocument extends DOMDocument { // appends an ExtendedDocument::createElementTextArea() as a child of this document (see there for params) // returns the new child // - // public function appendElementSelect($name, [$id], [$options], [$default]) + // public function appendElementSelect($name, [$id], [$options], [$default], [$strictmatch]) // appends an ExtendedDocument::createElementSelect() as a child of this document (see there for params) // returns the new child // @@ -116,6 +125,10 @@ class ExtendedDocument extends DOMDocument { // appends a DOMDocument::createTextNode() as a child of this document (see there for params) // returns the new child // + // public function appendLinebreak() + // appends a
as a child of this document + // returns the new child + // // public function appendEntity($name) // appends a DOMDocument::createEntityReference() as a child of this document (see there for params) // returns the new child @@ -124,6 +137,11 @@ class ExtendedDocument extends DOMDocument { // appends a DOMDocument::createComment() as a child of this document (see there for params) // returns the new child // + // public function appendClonedElement($dom_element, [$deep]) + // appends a clone of the given DOMElement as a child of this document + // the boolean $deep specifies if the children are cloned as well (defaults to TRUE) + // returns the new child + // // public function appendHTMLMarkup($htmldata, [$parentNode]) // appends a representation of the HTML data as children of the given parent node, by default this document // NO return value! @@ -136,19 +154,15 @@ class ExtendedDocument extends DOMDocument { // appends an ExtendedDocument::createElementJS() as a child of this document (see there for params) // NO return value! // - // public function appendJSFile($jsURL) + // public function appendJSFile($jsURL, [$defer], [$async]) // appends an ExtendedDocument::createElementJSFile() as a child of this document (see there for params) // returns the new child // - // public function appendCOMElement($module, $attributes) - // appends an ExtendedDocument::createCOMElement() as a child of this document (see there for params) - // returns the new child - // - // public function createElementLink($target, [$value]) - // returns an ExtendedElement that is an HTML with the given target (href) and (optional) value + // public function createElementLink($target, [$value], [$title]) + // returns an ExtendedElement that is an HTML with the given target (href) and (optional) value as well as (optional) title attribute // // public function createElementImage($src, [$alt_text]) - // returns an ExtendedElement that is an HTML with the given (src) and alt attributes (set to '' by default) + // returns an ExtendedElement that is an HTML with the given src and alt attributes (set to '' by default) // // public function createElementForm($action, $method, $name) // returns an ExtendedElement that is an HTML
that is a child of an HTML
@@ -161,16 +175,40 @@ class ExtendedDocument extends DOMDocument { // returns an ExtendedElement that is an HTML of type 'text' with the given name, maxlength, size, // and optionally id and value // + // public function createElementInputPassword($name, $maxlength, $size, [$id], [$value]) + // returns an ExtendedElement that is an HTML of type 'password' with the given name, maxlength, size, + // and optionally id and value + // // public function createElementInputNumber($name, $maxlength, $size, [$id], [$value]) // returns an ExtendedElement that is an HTML of type 'number' with the given name, maxlength, size, // and optionally id and value // + // public function createElementInputRange($name, $id, $min, $max, [$step], [$value]) + // returns an ExtendedElement that is an HTML of type 'range' with the given name, id, min, max, + // and optionally step and value + // + // public function createElementInputUrl($name, $maxlength, $size, [$id], [$value]) + // returns an ExtendedElement that is an HTML of type 'url' with the given name, maxlength, size, + // and optionally id and value + // // public function createElementInputEmail($name, $maxlength, $size, [$id], [$value]) // returns an ExtendedElement that is an HTML of type 'email' with the given name, maxlength, size, // and optionally id and value // - // public function createElementInputPassword($name, $maxlength, $size, [$id], [$value]) - // returns an ExtendedElement that is an HTML of type 'password' with the given name, maxlength, size, + // public function createElementInputTel($name, $maxlength, $size, [$id], [$value]) + // returns an ExtendedElement that is an HTML of type 'tel' with the given name, maxlength, size, + // and optionally id and value + // + // public function createElementInputDate($name, [$id], [$min], [$max], [$value]) + // returns an ExtendedElement that is an HTML of type 'date' with the given name, + // and optionally id, min, max, and value + // + // public function createElementInputTime($name, [$id], [$min], [$max], [$value]) + // returns an ExtendedElement that is an HTML of type 'time' with the given name, + // and optionally id, min, max, and value + // + // public function createElementInputColor($name, [$id], [$value]) + // returns an ExtendedElement that is an HTML of type 'color' with the given name, // and optionally id and value // // public function createElementInputRadio($name, $id, $value, $checked) @@ -194,9 +232,9 @@ class ExtendedDocument extends DOMDocument { // returns an ExtendedElement that is an HTML