Commit | Line | Data |
---|---|---|
cea5b93a | 1 | <?php |
880bcb60 RK |
2 | /* This Source Code Form is subject to the terms of the Mozilla Public |
3 | * License, v. 2.0. If a copy of the MPL was not distributed with this file, | |
4 | * You can obtain one at http://mozilla.org/MPL/2.0/. */ | |
cea5b93a RK |
5 | |
6 | class ExtendedDocument extends DOMDocument { | |
7 | // ExtendedDocument PHP class | |
8 | // this extends the general PHP DOM Document class to simplify some usual constructs | |
9 | // | |
10 | // function __construct([$version], [$encoding]) | |
11 | // CONSTRUCTOR | |
12 | // construct a new DOM Document that uses our element definitions | |
13 | // | |
b841a92b | 14 | // static function initHTML5([$doc]) |
14014b8f | 15 | // initialize as an HTML5 document and return references to its basic elements. |
b841a92b | 16 | // If a $doc is handed over (an ExtendedDocument or a derived class), load the content into that document. |
14014b8f | 17 | // returns an associative array with the following elements: 'html', 'head', 'title', 'body' |
ae41c41b | 18 | // |
d7403a92 RK |
19 | // public function loadHTML5($source) { |
20 | // A version of loadHTML() - see DOMDocument documentation - that is made for loading HTML5 and not emitting warnings/errors for unknown elements. | |
21 | // returns true on success, false otherwise, just like loadHTML5. | |
22 | // | |
61cc8aa9 | 23 | // public function appendElement($name, [$value]) |
cea5b93a RK |
24 | // appends a DOMDocument::createElement() as a child of this document (see there for params) |
25 | // returns the new child | |
26 | // | |
61cc8aa9 | 27 | // public function appendElementXML($name, $xmldata) |
cea5b93a RK |
28 | // appends a DOMDocument::createElement() with the given name as a child of this document, |
29 | // with an ExtendedDocument::createXMLFragment() of the given XML data inside | |
30 | // returns the new child | |
31 | // | |
b3cc0fef | 32 | // public function appendLink($target, [$value], [$title]) |
cea5b93a RK |
33 | // appends an ExtendedDocument::createElementLink() as a child of this document (see there for params) |
34 | // returns the new child | |
35 | // | |
61cc8aa9 | 36 | // public function appendImage($src, [$alt_text]) |
53510e9e RK |
37 | // appends an ExtendedDocument::createElementImage() as a child of this document (see there for params) |
38 | // returns the new child | |
39 | // | |
61cc8aa9 | 40 | // public function appendForm($action, $method, $name, [$id]) |
b8d16837 RK |
41 | // appends an ExtendedDocument::createElementForm() as a child of this document (see there for params) |
42 | // returns the new child | |
43 | // | |
61cc8aa9 | 44 | // public function appendFormDiv($action, $method, $name, [$id]) |
ae41c41b RK |
45 | // appends an ExtendedDocument::createElementForm() as a child of this document (see there for params) |
46 | // returns an HTML <div> that is a child of the new child | |
47 | // | |
61cc8aa9 | 48 | // public function appendInputHidden($name, $value) |
ae41c41b RK |
49 | // appends an ExtendedDocument::createElementInputHidden() as a child of this document (see there for params) |
50 | // returns the new child | |
51 | // | |
61cc8aa9 | 52 | // public function appendInputText($name, $maxlength, $size, [$id], [$value]) |
ae41c41b RK |
53 | // appends an ExtendedDocument::createElementInputText() as a child of this document (see there for params) |
54 | // returns the new child | |
55 | // | |
f925e4a1 RK |
56 | // public function appendInputPassword($name, $maxlength, $size, [$id], [$value]) |
57 | // appends an ExtendedDocument::createElementInputPassword() as a child of this document (see there for params) | |
58 | // returns the new child | |
59 | // | |
61cc8aa9 | 60 | // public function appendInputNumber($name, $maxlength, $size, [$id], [$value]) |
262e0bbb RK |
61 | // appends an ExtendedDocument::createElementInputNumber() as a child of this document (see there for params) |
62 | // returns the new child | |
63 | // | |
f925e4a1 RK |
64 | // public function appendInputRange($name, $id, $min, $max, [$step], [$value]) |
65 | // appends an ExtendedDocument::createElementInputRange() as a child of this document (see there for params) | |
66 | // returns the new child | |
67 | // | |
6f794328 RK |
68 | // public function appendInputSearch($name, $maxlength, $size, [$id], [$value]) |
69 | // appends an ExtendedDocument::createElementInputSearch() as a child of this document (see there for params) | |
70 | // returns the new child | |
71 | // | |
f925e4a1 RK |
72 | // public function appendInputUrl($name, $maxlength, $size, [$id], [$value]) |
73 | // appends an ExtendedDocument::createElementInputUrl() as a child of this document (see there for params) | |
74 | // returns the new child | |
75 | // | |
ea32f7e5 RK |
76 | // public function appendInputEmail($name, $maxlength, $size, [$id], [$value]) |
77 | // appends an ExtendedDocument::createElementInputEmail() as a child of this document (see there for params) | |
78 | // returns the new child | |
79 | // | |
f925e4a1 RK |
80 | // public function appendInputTel($name, $maxlength, $size, [$id], [$value]) |
81 | // appends an ExtendedDocument::createElementInputTel() as a child of this document (see there for params) | |
82 | // returns the new child | |
83 | // | |
84 | // public function appendInputDate($name, [$id], [$min], [$max], [$value]) | |
85 | // appends an ExtendedDocument::createElementInputDate() as a child of this document (see there for params) | |
86 | // returns the new child | |
87 | // | |
88 | // public function appendInputTime($name, [$id], [$min], [$max], [$value]) | |
89 | // appends an ExtendedDocument::createElementInputTime() as a child of this document (see there for params) | |
90 | // returns the new child | |
91 | // | |
92 | // public function appendInputColor($name, [$id], [$value]) | |
93 | // appends an ExtendedDocument::createElementInputColor() as a child of this document (see there for params) | |
645a7eb6 RK |
94 | // returns the new child |
95 | // | |
61cc8aa9 | 96 | // public function appendInputRadio($name, $id, $value, $checked) |
ae41c41b RK |
97 | // appends an ExtendedDocument::createElementInputRadio() as a child of this document (see there for params) |
98 | // returns the new child | |
99 | // | |
61cc8aa9 | 100 | // public function appendInputCheckbox($name, $id, $value, $checked) |
ae41c41b RK |
101 | // appends an ExtendedDocument::createElementInputCheckbox() as a child of this document (see there for params) |
102 | // returns the new child | |
103 | // | |
61cc8aa9 | 104 | // public function appendInputFile($name, $id, $accept) |
4bb9d784 RK |
105 | // appends an ExtendedDocument::createElementInputFile() as a child of this document (see there for params) |
106 | // returns the new child | |
107 | // | |
61cc8aa9 | 108 | // public function appendInputSubmit($value) |
ae41c41b RK |
109 | // appends an ExtendedDocument::createElementInputSubmit() as a child of this document (see there for params) |
110 | // returns the new child | |
111 | // | |
61cc8aa9 | 112 | // public function appendButton($value, $onclick = null) |
1109f526 RK |
113 | // appends an ExtendedDocument::createElementButton() as a child of this document (see there for params) |
114 | // returns the new child | |
115 | // | |
61cc8aa9 | 116 | // public function appendTextArea($name, $columns, $rows, [$id], [$value]) |
bf91764c RK |
117 | // appends an ExtendedDocument::createElementTextArea() as a child of this document (see there for params) |
118 | // returns the new child | |
119 | // | |
69409ddb | 120 | // public function appendElementSelect($name, [$id], [$options], [$default], [$strictmatch]) |
bf91764c RK |
121 | // appends an ExtendedDocument::createElementSelect() as a child of this document (see there for params) |
122 | // returns the new child | |
123 | // | |
61cc8aa9 | 124 | // public function appendElementOption($key, $desc, [$selected]) |
bf91764c RK |
125 | // appends an ExtendedDocument::createElementOption() as a child of this document (see there for params) |
126 | // returns the new child | |
127 | // | |
61cc8aa9 | 128 | // public function appendLabel($for_id, $value) |
ae41c41b RK |
129 | // appends an ExtendedDocument::createElementLabel() as a child of this document (see there for params) |
130 | // returns the new child | |
131 | // | |
c79be4c2 RK |
132 | // public function appendElementDatalist([$id], [$options]) |
133 | // appends an ExtendedDocument::createElementDatalist() as a child of this document (see there for params) | |
134 | // returns the new child | |
135 | // | |
61cc8aa9 | 136 | // public function appendText($text) |
cea5b93a RK |
137 | // appends a DOMDocument::createTextNode() as a child of this document (see there for params) |
138 | // returns the new child | |
139 | // | |
71771b0c RK |
140 | // public function appendLinebreak() |
141 | // appends a <br> as a child of this document | |
142 | // returns the new child | |
143 | // | |
6638efd5 RK |
144 | // public function appendEntity($name) |
145 | // appends a DOMDocument::createEntityReference() as a child of this document (see there for params) | |
146 | // returns the new child | |
147 | // | |
61cc8aa9 | 148 | // public function appendComment($comment_data) |
cadc5980 RK |
149 | // appends a DOMDocument::createComment() as a child of this document (see there for params) |
150 | // returns the new child | |
151 | // | |
3d4db013 RK |
152 | // public function appendClonedElement($dom_element, [$deep]) |
153 | // appends a clone of the given DOMElement as a child of this document | |
154 | // the boolean $deep specifies if the children are cloned as well (defaults to TRUE) | |
155 | // returns the new child | |
156 | // | |
61cc8aa9 | 157 | // public function appendHTMLMarkup($htmldata, [$parentNode]) |
ae41c41b RK |
158 | // appends a representation of the HTML data as children of the given parent node, by default this document |
159 | // NO return value! | |
160 | // | |
61cc8aa9 | 161 | // public function appendXMLMarkup($xmldata, [$parentNode]) |
ae41c41b | 162 | // appends a representation of the XML data as children of the given parent node, by default this document |
cea5b93a RK |
163 | // NO return value! |
164 | // | |
acaa2daa RK |
165 | // public function appendStyleElement($styledata) |
166 | // appends an ExtendedDocument::createElementStyle() as a child of this document (see there for params) | |
167 | // returns the new child | |
168 | // | |
61cc8aa9 | 169 | // public function appendJSElement($jsdata) |
cea5b93a | 170 | // appends an ExtendedDocument::createElementJS() as a child of this document (see there for params) |
acaa2daa | 171 | // returns the new child |
cea5b93a | 172 | // |
8afa2e61 | 173 | // public function appendJSFile($jsURL, [$defer], [$async]) |
ea32f7e5 RK |
174 | // appends an ExtendedDocument::createElementJSFile() as a child of this document (see there for params) |
175 | // returns the new child | |
176 | // | |
b3cc0fef RK |
177 | // public function createElementLink($target, [$value], [$title]) |
178 | // returns an ExtendedElement that is an HTML <a> with the given target (href) and (optional) value as well as (optional) title attribute | |
cea5b93a | 179 | // |
61cc8aa9 | 180 | // public function createElementImage($src, [$alt_text]) |
b3cc0fef | 181 | // returns an ExtendedElement that is an HTML <img> with the given src and alt attributes (set to '' by default) |
53510e9e | 182 | // |
61cc8aa9 | 183 | // public function createElementForm($action, $method, $name) |
cb2420c6 | 184 | // returns an ExtendedElement that is an HTML <form> with the given action, method, and name |
ae41c41b | 185 | // |
61cc8aa9 | 186 | // public function createElementInputHidden($name, $value) |
ae41c41b RK |
187 | // returns an ExtendedElement that is an HTML <input> of type 'hidden' with the given name and value |
188 | // | |
61cc8aa9 | 189 | // public function createElementInputText($name, $maxlength, $size, [$id], [$value]) |
ae41c41b RK |
190 | // returns an ExtendedElement that is an HTML <input> of type 'text' with the given name, maxlength, size, |
191 | // and optionally id and value | |
192 | // | |
f925e4a1 RK |
193 | // public function createElementInputPassword($name, $maxlength, $size, [$id], [$value]) |
194 | // returns an ExtendedElement that is an HTML <input> of type 'password' with the given name, maxlength, size, | |
195 | // and optionally id and value | |
196 | // | |
61cc8aa9 | 197 | // public function createElementInputNumber($name, $maxlength, $size, [$id], [$value]) |
262e0bbb RK |
198 | // returns an ExtendedElement that is an HTML <input> of type 'number' with the given name, maxlength, size, |
199 | // and optionally id and value | |
200 | // | |
f925e4a1 RK |
201 | // public function createElementInputRange($name, $id, $min, $max, [$step], [$value]) |
202 | // returns an ExtendedElement that is an HTML <input> of type 'range' with the given name, id, min, max, | |
203 | // and optionally step and value | |
204 | // | |
205 | // public function createElementInputUrl($name, $maxlength, $size, [$id], [$value]) | |
206 | // returns an ExtendedElement that is an HTML <input> of type 'url' with the given name, maxlength, size, | |
207 | // and optionally id and value | |
208 | // | |
6f794328 RK |
209 | // public function createElementInputSearch($name, $maxlength, $size, [$id], [$value]) |
210 | // returns an ExtendedElement that is an HTML <input> of type 'search' with the given name, maxlength, size, | |
211 | // and optionally id and value | |
212 | // | |
ea32f7e5 RK |
213 | // public function createElementInputEmail($name, $maxlength, $size, [$id], [$value]) |
214 | // returns an ExtendedElement that is an HTML <input> of type 'email' with the given name, maxlength, size, | |
215 | // and optionally id and value | |
216 | // | |
f925e4a1 RK |
217 | // public function createElementInputTel($name, $maxlength, $size, [$id], [$value]) |
218 | // returns an ExtendedElement that is an HTML <input> of type 'tel' with the given name, maxlength, size, | |
219 | // and optionally id and value | |
220 | // | |
221 | // public function createElementInputDate($name, [$id], [$min], [$max], [$value]) | |
222 | // returns an ExtendedElement that is an HTML <input> of type 'date' with the given name, | |
223 | // and optionally id, min, max, and value | |
224 | // | |
225 | // public function createElementInputTime($name, [$id], [$min], [$max], [$value]) | |
226 | // returns an ExtendedElement that is an HTML <input> of type 'time' with the given name, | |
227 | // and optionally id, min, max, and value | |
228 | // | |
229 | // public function createElementInputColor($name, [$id], [$value]) | |
230 | // returns an ExtendedElement that is an HTML <input> of type 'color' with the given name, | |
645a7eb6 RK |
231 | // and optionally id and value |
232 | // | |
61cc8aa9 | 233 | // public function createElementInputRadio($name, $id, $value, $checked) |
ae41c41b RK |
234 | // returns an ExtendedElement that is an HTML <input> of type 'radio' with the given name, id, value and |
235 | // checked state | |
236 | // | |
61cc8aa9 | 237 | // public function createElementInputCheckbox($name, $id, $value, $checked) |
ae41c41b RK |
238 | // returns an ExtendedElement that is an HTML <input> of type 'checkbox' with the given name, id, value and |
239 | // checked state | |
240 | // | |
61cc8aa9 | 241 | // public function createElementInputFile($name, $id, $accept) |
4bb9d784 RK |
242 | // returns an ExtendedElement that is an HTML <input> of type 'file' with the given name, id and accept |
243 | // | |
61cc8aa9 | 244 | // public function createElementInputSubmit($value) |
1109f526 RK |
245 | // returns an ExtendedElement that is an HTML <input> of type 'submit' with the given value as label |
246 | // | |
61cc8aa9 | 247 | // public function createElementButton($value, $onclick = null) |
1109f526 | 248 | // returns an ExtendedElement that is an HTML button with the given value as label and optionally onclick attribute |
ae41c41b | 249 | // |
61cc8aa9 | 250 | // public function createElementTextArea($name, $columns, $rows, [$id], [$value]) |
bf91764c RK |
251 | // returns an ExtendedElement that is an HTML <textarea> with the given name, columns, rows, |
252 | // and optionally id and value | |
253 | // | |
69409ddb | 254 | // public function createElementSelect($name, [$id], [$options], [$default], [$strictmatch]) |
bf91764c | 255 | // returns an ExtendedElement that is an HTML <select> with the given name, and optionally id, |
69409ddb | 256 | // array of options (key => description) and key of the by-default selected entry (matched including type when strictmatch is true) |
bf91764c | 257 | // |
61cc8aa9 | 258 | // public function createElementOption($key, $desc, [$selected]) |
bf91764c RK |
259 | // returns an ExtendedElement that is an HTML <option> with the given key (value) and description (content) |
260 | // and optionally bool that tells if the entry is selected | |
261 | // | |
61cc8aa9 | 262 | // public function createElementLabel($for_id, $value) |
ae41c41b | 263 | // returns an ExtendedElement that is an HTML <label> with the given 'for' and value |
cea5b93a | 264 | // |
c79be4c2 RK |
265 | // public function createElementDatalist([$id], [$options]) |
266 | // returns an ExtendedElement that is an HTML <datalist> with optionally the given id and array of options (key => description) | |
267 | // | |
acaa2daa RK |
268 | // public function createElementStyle($styledata) |
269 | // returns an ExtendedElement that is an HTML <style> of CSS type with the style data inside | |
270 | // | |
61cc8aa9 | 271 | // public function createElementJS($jsdata) |
cea5b93a | 272 | // returns an ExtendedElement that is an HTML <script> of JavaScript type with the JS data inside |
c1666e91 | 273 | // |
8afa2e61 | 274 | // public function createElementJSFile($jsURL, [$defer], [$async]) |
ea32f7e5 | 275 | // returns an ExtendedElement that is an HTML <script> of JavaScript type linking to the file given by the URL |
8afa2e61 | 276 | // $defer and $async are boolean attributes that set if the script should be executed after parsing but before onload, and if it should be loaded asynchronously. |
cea5b93a RK |
277 | |
278 | function __construct($version = '1.0', $encoding = 'utf-8') { | |
279 | // make sure the default DOMDocument constructor runs | |
280 | parent::__construct($version, $encoding); | |
281 | $this->registerNodeClass('DOMElement', 'ExtendedElement'); | |
bf91764c | 282 | $this->registerNodeClass('DOMDocumentFragment', 'ExtendedDocumentFragment'); |
cea5b93a RK |
283 | } |
284 | ||
b841a92b RK |
285 | static function initHTML5($doc = null) { |
286 | if (is_null($doc)) { $doc = new ExtendedDocument(); } | |
0fe05664 | 287 | $doc->loadHTML5('<?xml version="1.0" encoding="utf-8"?>'."\n".'<!DOCTYPE html>'."\n".'<html></html>'); // this seems to be the only way to get the DOCTYPE set properly. |
14014b8f RK |
288 | |
289 | // Created basic HTML document structure. | |
290 | $root = $doc->getElementsByTagName('html')->item(0); | |
291 | $head = $root->appendElement('head'); | |
292 | $title = $head->appendElement('title'); | |
293 | $body = $root->appendElement('body'); | |
294 | ||
295 | return array('document' => $doc, | |
296 | 'html' => $root, | |
297 | 'head' => $head, | |
298 | 'title' => $title, | |
299 | 'body' => $body); | |
300 | } | |
301 | ||
d7403a92 RK |
302 | public function loadHTML5($source) { |
303 | // Do our own handling of DOMDocument error reporting so we can ignore "unknown tags" which are usually fine in HTML5. | |
304 | libxml_use_internal_errors(true); | |
0fe05664 | 305 | if (!preg_match('/^\s*<\?xml /', $source)) { |
d7403a92 RK |
306 | // Add an XML declaration to force DOMDocument into UTF-8 mode. |
307 | $source = '<?xml version="1.0" encoding="utf-8"?>'."\n".$source; | |
308 | } | |
309 | $result = $this->loadHTML($source); | |
0fe05664 RK |
310 | // Set encoding directly a,d remove any processing node that isn't the first node |
311 | $this->encoding = 'utf-8'; | |
312 | foreach ($this->childNodes as $i => $child) { | |
313 | if ($i && $child->nodeType == XML_PI_NODE) { | |
314 | $this->removeChild($child); | |
315 | } | |
316 | } | |
d7403a92 RK |
317 | // Handle DOMDocument loading errors, throw away warnings on unknown tags as HTML5 allows all kinds. |
318 | $errseverity = array(LIBXML_ERR_WARNING => 'Warning', LIBXML_ERR_ERROR => 'Error', LIBXML_ERR_FATAL => 'Fatal'); | |
319 | foreach (libxml_get_errors() as $error) { | |
320 | // $error is a libXMLError, see https://www.php.net/manual/en/class.libxmlerror.php | |
321 | // See http://www.xmlsoft.org/html/libxml-xmlerror.html#xmlParserErrors for error numbers | |
322 | if ($error->code != 801) { // XML_HTML_UNKNOWN_TAG gets no output, should not exist for HTML5. | |
323 | trigger_error($errseverity[$error->level].' loading HTML5: '.$error->message.' (code '.$error->code.'), line: '.$error->line, E_USER_WARNING); | |
324 | } | |
325 | } | |
326 | libxml_clear_errors(); | |
327 | libxml_use_internal_errors(false); | |
328 | return $result; | |
329 | } | |
330 | ||
61cc8aa9 | 331 | public function appendElement($name, $value = '') { |
a8816f43 | 332 | return $this->appendChild($this->createElement($name, $value)); |
cea5b93a | 333 | } |
61cc8aa9 | 334 | public function appendElementXML($name, $xmldata) { |
cea5b93a | 335 | $aelem = $this->appendChild($this->createElement($name)); |
ae41c41b RK |
336 | $aelem->appendXMLMarkup($xmldata); |
337 | //$aelem->appendChild($this->createXMLFragment($xmldata)); | |
cea5b93a RK |
338 | return $aelem; |
339 | } | |
b3cc0fef RK |
340 | public function appendLink($target, $value = '', $title = null) { |
341 | return $this->appendChild($this->createElementLink($target, $value, $title)); | |
cea5b93a | 342 | } |
61cc8aa9 | 343 | public function appendImage($src, $alt_text = '') { |
4aa31782 RK |
344 | return $this->appendChild($this->createElementImage($src, $alt_text)); |
345 | } | |
61cc8aa9 | 346 | public function appendForm($action, $method, $name, $id = null) { |
b8d16837 RK |
347 | return $this->appendChild($this->createElementForm($action, $method, $name, $id)); |
348 | } | |
61cc8aa9 | 349 | public function appendFormDiv($action, $method, $name, $id = null) { |
b8d16837 | 350 | $formelem = $this->appendChild($this->createElementForm($action, $method, $name, $id)); |
ae41c41b RK |
351 | return $formelem->appendElement('div'); |
352 | } | |
61cc8aa9 | 353 | public function appendInputHidden($name, $value) { |
ae41c41b RK |
354 | return $this->appendChild($this->createElementInputHidden($name, $value)); |
355 | } | |
61cc8aa9 | 356 | public function appendInputText($name, $maxlength, $size, $id = null, $value = null) { |
ae41c41b RK |
357 | return $this->appendChild($this->createElementInputText($name, $maxlength, $size, $id, $value)); |
358 | } | |
f925e4a1 RK |
359 | public function appendInputPassword($name, $maxlength, $size, $id = null, $value = null) { |
360 | return $this->appendChild($this->createElementInputPassword($name, $maxlength, $size, $id, $value)); | |
361 | } | |
61cc8aa9 | 362 | public function appendInputNumber($name, $maxlength, $size, $id = null, $value = null) { |
262e0bbb RK |
363 | return $this->appendChild($this->createElementInputNumber($name, $maxlength, $size, $id, $value)); |
364 | } | |
f925e4a1 RK |
365 | public function appendInputRange($name, $id, $min, $max, $step = null, $value = null) { |
366 | return $this->appendChild($this->createElementInputRange($name, $id, $min, $max, $step, $value)); | |
367 | } | |
6f794328 RK |
368 | public function appendInputSearch($name, $maxlength, $size, $id = null, $value = null) { |
369 | return $this->appendChild($this->createElementInputSearch($name, $maxlength, $size, $id, $value)); | |
370 | } | |
f925e4a1 RK |
371 | public function appendInputUrl($name, $maxlength, $size, $id = null, $value = null) { |
372 | return $this->appendChild($this->createElementInputUrl($name, $maxlength, $size, $id, $value)); | |
373 | } | |
ea32f7e5 RK |
374 | public function appendInputEmail($name, $maxlength, $size, $id = null, $value = null) { |
375 | return $this->appendChild($this->createElementInputEmail($name, $maxlength, $size, $id, $value)); | |
376 | } | |
f925e4a1 RK |
377 | public function appendInputTel($name, $maxlength, $size, $id = null, $value = null) { |
378 | return $this->appendChild($this->createElementInputTel($name, $maxlength, $size, $id, $value)); | |
379 | } | |
380 | public function appendInputDate($name, $id = null, $min = null, $max = null, $value = null) { | |
381 | return $this->appendChild($this->createElementInputDate($name, $id, $min, $max, $value)); | |
382 | } | |
383 | public function appendInputTime($name, $id = null, $min = null, $max = null, $value = null) { | |
384 | return $this->appendChild($this->createElementInputTime($name, $id, $min, $max, $value)); | |
385 | } | |
386 | public function appendInputColor($name, $id = null, $value = null) { | |
387 | return $this->appendChild($this->createElementInputColor($name, $id, $value)); | |
645a7eb6 | 388 | } |
61cc8aa9 | 389 | public function appendInputRadio($name, $id, $value, $checked) { |
ae41c41b RK |
390 | return $this->appendChild($this->createElementInputRadio($name, $id, $value, $checked)); |
391 | } | |
61cc8aa9 | 392 | public function appendInputCheckbox($name, $id, $value, $checked) { |
ae41c41b RK |
393 | return $this->appendChild($this->createElementInputCheckbox($name, $id, $value, $checked)); |
394 | } | |
61cc8aa9 | 395 | public function appendInputFile($name, $id, $accept) { |
4bb9d784 RK |
396 | return $this->appendChild($this->createElementInputFile($name, $id, $accept)); |
397 | } | |
61cc8aa9 | 398 | public function appendInputSubmit($value) { |
ae41c41b RK |
399 | return $this->appendChild($this->createElementInputSubmit($value)); |
400 | } | |
61cc8aa9 | 401 | public function appendButton($value, $onclick = null) { |
1109f526 RK |
402 | return $this->appendChild($this->createElementButton($value, $onclick)); |
403 | } | |
61cc8aa9 | 404 | public function appendTextArea($name, $columns, $rows, $id = null, $value = null) { |
bf91764c RK |
405 | return $this->appendChild($this->createElementTextArea($name, $columns, $rows, $id, $value)); |
406 | } | |
69409ddb RK |
407 | public function appendElementSelect($name, $id = null, $options = array(), $default = null, $strictmatch = false) { |
408 | return $this->appendChild($this->createElementSelect($name, $id, $options, $default, $strictmatch)); | |
bf91764c | 409 | } |
61cc8aa9 | 410 | public function appendElementOption($key, $desc, $selected = false) { |
bf91764c RK |
411 | return $this->appendChild($this->createElementOption($key, $desc, $selected)); |
412 | } | |
61cc8aa9 | 413 | public function appendLabel($for_id, $value) { |
ae41c41b RK |
414 | return $this->appendChild($this->createElementLabel($for_id, $value)); |
415 | } | |
c79be4c2 RK |
416 | public function appendElementDatalist($id = null, $options = array()) { |
417 | return $this->appendChild($this->createElementDatalist($id, $options)); | |
418 | } | |
61cc8aa9 | 419 | public function appendText($text) { |
cea5b93a RK |
420 | return $this->appendChild($this->createTextNode($text)); |
421 | } | |
71771b0c RK |
422 | public function appendLinebreak() { |
423 | return $this->appendChild($this->createElement('br')); | |
424 | } | |
6638efd5 RK |
425 | public function appendEntity($name) { |
426 | return $this->appendChild($this->createEntityReference($name)); | |
427 | } | |
61cc8aa9 | 428 | public function appendComment($comment_data) { |
cadc5980 RK |
429 | return $this->appendChild($this->createComment($comment_data)); |
430 | } | |
3d4db013 RK |
431 | public function appendClonedElement($dom_element, $deep = true) { |
432 | return $this->appendChild($dom_element->cloneNode($deep)); | |
433 | } | |
acaa2daa RK |
434 | public function appendStyleElement($styledata) { |
435 | return $this->appendChild($this->createElementStyle($styledata)); | |
436 | } | |
61cc8aa9 | 437 | public function appendJSElement($jsdata) { |
3d4db013 | 438 | return $this->appendChild($this->createElementJS($jsdata)); |
cea5b93a | 439 | } |
1a4ee0f0 RK |
440 | public function appendJSFile($jsURL, $defer = false, $async = false) { |
441 | return $this->appendChild($this->createElementJSFile($jsURL, $defer, $async)); | |
ea32f7e5 | 442 | } |
cea5b93a | 443 | |
61cc8aa9 | 444 | public function appendHTMLMarkup($htmldata, $parentNode = null) { |
ae41c41b | 445 | if (is_null($parentNode)) { $parentNode =& $this; } |
d7403a92 | 446 | // Use loadHTML5() to parse and turn the markup into proper HTML. |
a9a5a68a RK |
447 | $tmpdoc = new ExtendedDocument; |
448 | // The XML line is needed to tell the parser that we need UTF-8 parsing. | |
0fe05664 | 449 | $tmpdoc->loadHTML5('<?xml version="1.0" encoding="utf-8"?>'."\n".'<!DOCTYPE html>'."\n".'<html><body>'.$htmldata.'</body></html>'); |
a9a5a68a RK |
450 | foreach ($tmpdoc->getElementsByTagName('body')->item(0)->childNodes as $child) { |
451 | $parentNode->appendChild($this->importNode($child, true)); | |
452 | } | |
ae41c41b RK |
453 | } |
454 | ||
61cc8aa9 | 455 | public function appendXMLMarkup($xmldata, $parentNode = null) { |
ae41c41b RK |
456 | if (is_null($parentNode)) { $parentNode =& $this; } |
457 | $tmpdoc = new ExtendedDocument; | |
458 | $tmpxml = '<?xml version="1.0" encoding="utf-8"?>'."\n"; | |
459 | $tmpxml .= '<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.1//EN" "http://www.w3.org/TR/xhtml11/DTD/xhtml11.dtd">'."\n"; | |
460 | $tmpxml .= '<root>'.$xmldata.'</root>'; | |
461 | $tmpdoc->loadXML($tmpxml); | |
462 | foreach ($tmpdoc->getElementsByTagName('root')->item(0)->childNodes as $child) { | |
463 | $parentNode->appendChild($this->importNode($child, true)); | |
464 | } | |
cea5b93a RK |
465 | } |
466 | ||
61cc8aa9 | 467 | public function createElement($name, $value = '') { |
a8816f43 RK |
468 | // Adding the $value in DOMDocument's createElement does NOT escape it, so override it and use appendText to support that. |
469 | $aelem = parent::createElement($name); | |
5ae00086 | 470 | if (strlen($value ?? '')) { $aelem->appendText($value); } |
a8816f43 RK |
471 | return $aelem; |
472 | } | |
473 | ||
b3cc0fef | 474 | public function createElementLink($target, $value = '', $title = null) { |
a8816f43 | 475 | $link = $this->createElement('a', $value); |
bf91764c | 476 | $link->setAttribute('href', $target); // XXX: take care of & etc. in links |
b3cc0fef | 477 | if (!is_null($title)) { $link->setAttribute('title', $title); } |
cea5b93a RK |
478 | return $link; |
479 | } | |
480 | ||
61cc8aa9 | 481 | public function createElementImage($src, $alt_text = '') { |
319cfe8d RK |
482 | $img = $this->createElement('img'); |
483 | $img->setAttribute('src', $src); | |
484 | $img->setAttribute('alt', $alt_text); | |
485 | return $img; | |
4aa31782 RK |
486 | } |
487 | ||
61cc8aa9 | 488 | public function createElementForm($action, $method, $name, $id = null) { |
ae41c41b RK |
489 | $formelem = $this->createElement('form'); |
490 | $formelem->setAttribute('action', $action); | |
491 | $formelem->setAttribute('method', $method); | |
492 | $formelem->setAttribute('name', $name); | |
b3cc0fef | 493 | if (!is_null($id)) { $formelem->setAttribute('id', $id); } |
ae41c41b RK |
494 | return $formelem; |
495 | } | |
496 | ||
61cc8aa9 | 497 | public function createElementInputHidden($name, $value) { |
ae41c41b RK |
498 | $hidden = $this->createElement('input'); |
499 | $hidden->setAttribute('type', 'hidden'); | |
500 | $hidden->setAttribute('name', $name); | |
501 | $hidden->setAttribute('value', $value); | |
502 | return $hidden; | |
503 | } | |
504 | ||
61cc8aa9 | 505 | public function createElementInputText($name, $maxlength, $size, $id = null, $value = null) { |
ae41c41b RK |
506 | $txfield = $this->createElement('input'); |
507 | $txfield->setAttribute('type', 'text'); | |
508 | if (!is_null($id)) { $txfield->setAttribute('id', $id); } | |
509 | $txfield->setAttribute('name', $name); | |
510 | $txfield->setAttribute('maxlength', $maxlength); | |
511 | $txfield->setAttribute('size', $size); | |
512 | if (!is_null($value)) { $txfield->setAttribute('value', $value); } | |
513 | return $txfield; | |
514 | } | |
515 | ||
61cc8aa9 | 516 | public function createElementInputPassword($name, $maxlength, $size, $id = null, $value = null) { |
319cfe8d RK |
517 | $pwfield = $this->createElement('input'); |
518 | $pwfield->setAttribute('type', 'password'); | |
519 | if (!is_null($id)) { $pwfield->setAttribute('id', $id); } | |
520 | $pwfield->setAttribute('name', $name); | |
521 | $pwfield->setAttribute('maxlength', $maxlength); | |
522 | $pwfield->setAttribute('size', $size); | |
523 | if (!is_null($value)) { $pwfield->setAttribute('value', $value); } | |
524 | return $pwfield; | |
645a7eb6 RK |
525 | } |
526 | ||
f925e4a1 RK |
527 | public function createElementInputNumber($name, $maxlength, $size, $id = null, $value = null) { |
528 | $numfield = $this->createElement('input'); | |
529 | $numfield->setAttribute('type', 'number'); | |
530 | if (!is_null($id)) { $numfield->setAttribute('id', $id); } | |
531 | $numfield->setAttribute('name', $name); | |
532 | $numfield->setAttribute('maxlength', $maxlength); | |
533 | $numfield->setAttribute('size', $size); | |
534 | if (!is_null($value)) { $numfield->setAttribute('value', $value); } | |
535 | return $numfield; | |
536 | } | |
537 | ||
538 | public function createElementInputRange($name, $id, $min, $max, $step = null, $value = null) { | |
539 | $rgfield = $this->createElement('input'); | |
540 | $rgfield->setAttribute('type', 'range'); | |
541 | if (!is_null($id)) { $rgfield->setAttribute('id', $id); } | |
542 | $rgfield->setAttribute('name', $name); | |
543 | if (!is_null($min)) { $rgfield->setAttribute('min', $min); } | |
544 | if (!is_null($max)) { $rgfield->setAttribute('max', $max); } | |
545 | if (!is_null($step)) { $rgfield->setAttribute('step', $step); } | |
546 | if (!is_null($value)) { $rgfield->setAttribute('value', $value); } | |
547 | return $rgfield; | |
548 | } | |
549 | ||
6f794328 RK |
550 | public function createElementInputSearch($name, $maxlength, $size, $id = null, $value = null) { |
551 | $urlfield = $this->createElement('input'); | |
552 | $urlfield->setAttribute('type', 'search'); | |
553 | if (!is_null($id)) { $urlfield->setAttribute('id', $id); } | |
554 | $urlfield->setAttribute('name', $name); | |
555 | $urlfield->setAttribute('maxlength', $maxlength); | |
556 | $urlfield->setAttribute('size', $size); | |
557 | if (!is_null($value)) { $urlfield->setAttribute('value', $value); } | |
558 | return $urlfield; | |
559 | } | |
560 | ||
f925e4a1 RK |
561 | public function createElementInputUrl($name, $maxlength, $size, $id = null, $value = null) { |
562 | $urlfield = $this->createElement('input'); | |
563 | $urlfield->setAttribute('type', 'url'); | |
564 | if (!is_null($id)) { $urlfield->setAttribute('id', $id); } | |
565 | $urlfield->setAttribute('name', $name); | |
566 | $urlfield->setAttribute('maxlength', $maxlength); | |
567 | $urlfield->setAttribute('size', $size); | |
568 | if (!is_null($value)) { $urlfield->setAttribute('value', $value); } | |
569 | return $urlfield; | |
570 | } | |
571 | ||
572 | public function createElementInputEmail($name, $maxlength, $size, $id = null, $value = null) { | |
573 | $mailfield = $this->createElement('input'); | |
574 | $mailfield->setAttribute('type', 'email'); | |
575 | if (!is_null($id)) { $mailfield->setAttribute('id', $id); } | |
576 | $mailfield->setAttribute('name', $name); | |
577 | $mailfield->setAttribute('maxlength', $maxlength); | |
578 | $mailfield->setAttribute('size', $size); | |
579 | if (!is_null($value)) { $mailfield->setAttribute('value', $value); } | |
580 | return $mailfield; | |
581 | } | |
582 | ||
583 | public function createElementInputTel($name, $maxlength, $size, $id = null, $value = null) { | |
584 | $telfield = $this->createElement('input'); | |
585 | $telfield->setAttribute('type', 'tel'); | |
586 | if (!is_null($id)) { $telfield->setAttribute('id', $id); } | |
587 | $telfield->setAttribute('name', $name); | |
588 | $telfield->setAttribute('maxlength', $maxlength); | |
589 | $telfield->setAttribute('size', $size); | |
590 | if (!is_null($value)) { $telfield->setAttribute('value', $value); } | |
591 | return $telfield; | |
592 | } | |
593 | ||
594 | public function createElementInputDate($name, $id = null, $min = null, $max = null, $value = null) { | |
b5897591 RK |
595 | $dtfield = $this->createElement('input'); |
596 | $dtfield->setAttribute('type', 'date'); | |
597 | if (!is_null($id)) { $dtfield->setAttribute('id', $id); } | |
598 | $dtfield->setAttribute('name', $name); | |
599 | if (!is_null($min)) { $dtfield->setAttribute('min', $min); } | |
600 | if (!is_null($max)) { $dtfield->setAttribute('max', $max); } | |
601 | if (!is_null($value)) { $dtfield->setAttribute('value', $value); } | |
602 | return $dtfield; | |
f925e4a1 RK |
603 | } |
604 | ||
605 | public function createElementInputTime($name, $id = null, $min = null, $max = null, $value = null) { | |
b5897591 RK |
606 | $timefield = $this->createElement('input'); |
607 | $timefield->setAttribute('type', 'time'); | |
608 | if (!is_null($id)) { $timefield->setAttribute('id', $id); } | |
609 | $timefield->setAttribute('name', $name); | |
610 | if (!is_null($min)) { $timefield->setAttribute('min', $min); } | |
611 | if (!is_null($max)) { $timefield->setAttribute('max', $max); } | |
612 | if (!is_null($value)) { $timefield->setAttribute('value', $value); } | |
613 | return $timefield; | |
f925e4a1 RK |
614 | } |
615 | ||
616 | public function createElementInputColor($name, $id = null, $value = null) { | |
617 | $colfield = $this->createElement('input'); | |
618 | $colfield->setAttribute('type', 'color'); | |
619 | if (!is_null($id)) { $colfield->setAttribute('id', $id); } | |
620 | $colfield->setAttribute('name', $name); | |
621 | if (!is_null($value)) { $colfield->setAttribute('value', $value); } | |
622 | return $colfield; | |
623 | } | |
624 | ||
61cc8aa9 | 625 | public function createElementInputRadio($name, $id, $value, $checked) { |
ae41c41b RK |
626 | $radio = $this->createElement('input'); |
627 | $radio->setAttribute('type', 'radio'); | |
628 | $radio->setAttribute('name', $name); | |
4bb9d784 | 629 | if (!is_null($id)) { $radio->setAttribute('id', $id); } |
ae41c41b RK |
630 | $radio->setAttribute('value', $value); |
631 | if ($checked) { $radio->setAttribute('checked', ''); } | |
632 | return $radio; | |
633 | } | |
634 | ||
61cc8aa9 | 635 | public function createElementInputCheckbox($name, $id, $value, $checked) { |
ae41c41b RK |
636 | $cbox = $this->createElement('input'); |
637 | $cbox->setAttribute('type', 'checkbox'); | |
638 | $cbox->setAttribute('name', $name); | |
4bb9d784 | 639 | if (!is_null($id)) { $cbox->setAttribute('id', $id); } |
ae41c41b RK |
640 | $cbox->setAttribute('value', $value); |
641 | if ($checked) { $cbox->setAttribute('checked', ''); } | |
642 | return $cbox; | |
643 | } | |
644 | ||
61cc8aa9 | 645 | public function createElementInputFile($name, $id, $accept) { |
4bb9d784 RK |
646 | $fileinput = $this->createElement('input'); |
647 | $fileinput->setAttribute('type', 'file'); | |
648 | $fileinput->setAttribute('name', $name); | |
649 | if (!is_null($id)) { $fileinput->setAttribute('id', $id); } | |
650 | $fileinput->setAttribute('accept', $accept); | |
651 | return $fileinput; | |
652 | } | |
653 | ||
61cc8aa9 | 654 | public function createElementInputSubmit($value) { |
ae41c41b RK |
655 | $submitbtn = $this->createElement('input'); |
656 | $submitbtn->setAttribute('type', 'submit'); | |
657 | $submitbtn->setAttribute('value', $value); | |
658 | return $submitbtn; | |
659 | } | |
660 | ||
61cc8aa9 | 661 | public function createElementButton($value, $onclick = null) { |
1109f526 RK |
662 | $btn = $this->createElement('input'); |
663 | $btn->setAttribute('type', 'button'); | |
664 | $btn->setAttribute('value', $value); | |
665 | if (!is_null($onclick)) { $btn->setAttribute('onclick', $onclick); } | |
666 | return $btn; | |
667 | } | |
668 | ||
61cc8aa9 | 669 | public function createElementTextArea($name, $columns, $rows, $id = null, $value = null) { |
bf91764c RK |
670 | $txtarea = $this->createElement('textarea', $value); |
671 | $txtarea->setAttribute('name', $name); | |
672 | $txtarea->setAttribute('cols', $columns); | |
673 | $txtarea->setAttribute('rows', $rows); | |
674 | if (!is_null($id)) { $txtarea->setAttribute('id', $id); } | |
675 | return $txtarea; | |
676 | } | |
677 | ||
69409ddb | 678 | public function createElementSelect($name, $id = null, $options = array(), $default = null, $strictmatch = false) { |
bf91764c RK |
679 | $select = $this->createElement('select'); |
680 | $select->setAttribute('name', $name); | |
681 | if (!is_null($id)) { $select->setAttribute('id', $id); } | |
682 | foreach ($options as $key => $desc) { | |
69409ddb | 683 | $select->appendElementOption($key, $desc, $strictmatch ? ($key === $default) : ($key == $default)); |
bf91764c RK |
684 | } |
685 | return $select; | |
686 | } | |
687 | ||
61cc8aa9 | 688 | public function createElementOption($key, $desc, $selected = false) { |
bf91764c | 689 | $option = $this->createElement('option', $desc); |
b79cf811 | 690 | if (is_numeric($key) || is_string($key)) { |
c79be4c2 RK |
691 | $option->setAttribute('value', $key); |
692 | } | |
b79cf811 RK |
693 | if ($selected) { |
694 | $option->setAttribute('selected', ''); | |
695 | } | |
bf91764c RK |
696 | return $option; |
697 | } | |
698 | ||
61cc8aa9 | 699 | public function createElementLabel($for_id, $value) { |
ae41c41b RK |
700 | $label = $this->createElement('label', $value); |
701 | $label->setAttribute('for', $for_id); | |
702 | return $label; | |
cea5b93a RK |
703 | } |
704 | ||
c79be4c2 RK |
705 | public function createElementDatalist($id = null, $options = array()) { |
706 | $select = $this->createElement('datalist'); | |
707 | if (!is_null($id)) { $select->setAttribute('id', $id); } | |
708 | foreach ($options as $key => $desc) { | |
709 | $select->appendElementOption($key, $desc); | |
710 | } | |
711 | return $select; | |
712 | } | |
713 | ||
acaa2daa RK |
714 | public function createElementStyle($styledata) { |
715 | $style_elem = $this->createElement('style'); | |
716 | // Note: type can/should be left out for HTML5. | |
717 | $style_elem->setAttribute('type', 'text/css'); | |
718 | $style_elem->appendChild($this->createCDATASection($styledata)); | |
719 | return $style_elem; | |
720 | } | |
721 | ||
61cc8aa9 | 722 | public function createElementJS($jsdata) { |
cea5b93a | 723 | $jselem = $this->createElement('script'); |
ea32f7e5 | 724 | // Note: type can/should be left out for HTML5. |
cea5b93a RK |
725 | $jselem->setAttribute('type', 'text/javascript'); |
726 | $jselem->appendChild($this->createCDATASection($jsdata)); | |
727 | return $jselem; | |
728 | } | |
c1666e91 | 729 | |
8afa2e61 | 730 | public function createElementJSFile($jsURL, $defer = false, $async = false) { |
ea32f7e5 RK |
731 | $jselem = $this->createElement('script'); |
732 | // Note: type can/should be left out for HTML5. | |
733 | $jselem->setAttribute('type', 'text/javascript'); | |
8afa2e61 RK |
734 | if ($defer) { |
735 | $jselem->setAttribute('defer', ''); | |
736 | } | |
737 | if ($async) { | |
738 | $jselem->setAttribute('async', ''); | |
739 | } | |
ea32f7e5 RK |
740 | $jselem->setAttribute('src', $jsURL); |
741 | return $jselem; | |
742 | } | |
cea5b93a RK |
743 | } |
744 | ||
745 | class ExtendedElement extends DOMElement { | |
746 | // ExtendedElement PHP class | |
747 | // this extends the general PHP DOM Element class to simplify some usual constructs | |
748 | // | |
61cc8aa9 | 749 | // public function appendElement($name, [$value]) |
cea5b93a RK |
750 | // appends a DOMDocument::createElement() as a child of this element (see there for params) |
751 | // returns the new child | |
752 | // | |
61cc8aa9 | 753 | // public function appendElementXML($name, $xmldata) |
cea5b93a RK |
754 | // appends a DOMDocument::createElement() with the given name as a child of this element, |
755 | // with an ExtendedDocument::createXMLFragment() of the given XML data inside | |
756 | // returns the new child | |
757 | // | |
b3cc0fef | 758 | // public function appendLink($target, [$value], [$title]) |
cea5b93a RK |
759 | // appends an ExtendedDocument::createElementLink() as a child of this element (see there for params) |
760 | // returns the new child | |
761 | // | |
61cc8aa9 | 762 | // public function appendImage($src, [$alt_text]) |
53510e9e RK |
763 | // appends an ExtendedDocument::createElementImage() as a child of this document (see there for params) |
764 | // returns the new child | |
765 | // | |
61cc8aa9 | 766 | // public function appendForm($action, $method, $name, [$id]) |
b8d16837 RK |
767 | // appends an ExtendedDocument::createElementForm() as a child of this element (see there for params) |
768 | // returns the new child | |
769 | // | |
61cc8aa9 | 770 | // public function appendFormDiv($action, $method, $name, [$id]) |
ae41c41b RK |
771 | // appends an ExtendedDocument::createElementForm() as a child of this element (see there for params) |
772 | // returns an HTML <div> that is a child of the new child | |
773 | // | |
61cc8aa9 | 774 | // public function appendInputHidden($name, $value) |
ae41c41b RK |
775 | // appends an ExtendedDocument::createElementInputHidden() as a child of this element (see there for params) |
776 | // returns the new child | |
777 | // | |
61cc8aa9 | 778 | // public function appendInputText($name, $maxlength, $size, [$id], [$value]) |
ae41c41b RK |
779 | // appends an ExtendedDocument::createElementInputText() as a child of this element (see there for params) |
780 | // returns the new child | |
781 | // | |
f925e4a1 RK |
782 | // public function appendInputPassword($name, $maxlength, $size, [$id], [$value]) |
783 | // appends an ExtendedDocument::createElementInputPassword() as a child of this element (see there for params) | |
784 | // returns the new child | |
785 | // | |
61cc8aa9 | 786 | // public function appendInputNumber($name, $maxlength, $size, [$id], [$value]) |
262e0bbb RK |
787 | // appends an ExtendedDocument::createElementInputNumber() as a child of this element (see there for params) |
788 | // returns the new child | |
789 | // | |
f925e4a1 RK |
790 | // public function appendInputRange($name, $id, $min, $max, [$step], [$value]) |
791 | // appends an ExtendedDocument::createElementInputRange() as a child of this element (see there for params) | |
792 | // returns the new child | |
793 | // | |
6f794328 RK |
794 | // public function appendInputSearch($name, $maxlength, $size, [$id], [$value]) |
795 | // appends an ExtendedDocument::createElementInputSearch() as a child of this element (see there for params) | |
796 | // returns the new child | |
797 | // | |
f925e4a1 RK |
798 | // public function appendInputUrl($name, $maxlength, $size, [$id], [$value]) |
799 | // appends an ExtendedDocument::createElementInputUrl() as a child of this element (see there for params) | |
800 | // returns the new child | |
801 | // | |
ea32f7e5 RK |
802 | // public function appendInputEmail($name, $maxlength, $size, [$id], [$value]) |
803 | // appends an ExtendedDocument::createElementInputEmail() as a child of this element (see there for params) | |
804 | // returns the new child | |
805 | // | |
f925e4a1 RK |
806 | // public function appendInputTel($name, $maxlength, $size, [$id], [$value]) |
807 | // appends an ExtendedDocument::createElementInputTel() as a child of this element (see there for params) | |
808 | // returns the new child | |
809 | // | |
810 | // public function appendInputDate($name, [$id], [$min], [$max], [$value]) | |
811 | // appends an ExtendedDocument::createElementInputDate() as a child of this element (see there for params) | |
812 | // returns the new child | |
813 | // | |
814 | // public function appendInputTime($name, [$id], [$min], [$max], [$value]) | |
815 | // appends an ExtendedDocument::createElementInputTime() as a child of this element (see there for params) | |
645a7eb6 RK |
816 | // returns the new child |
817 | // | |
f925e4a1 RK |
818 | // public function appendInputColor($name, [$id], [$value]) |
819 | // appends an ExtendedDocument::createElementInputColor() as a child of this element (see there for params) | |
820 | // | |
61cc8aa9 | 821 | // public function appendInputRadio($name, $id, $value, $checked) |
ae41c41b RK |
822 | // appends an ExtendedDocument::createElementInputRadio() as a child of this element (see there for params) |
823 | // returns the new child | |
824 | // | |
61cc8aa9 | 825 | // public function appendInputCheckbox($name, $id, $value, $checked) |
ae41c41b RK |
826 | // appends an ExtendedDocument::createElementInputCheckbox() as a child of this element (see there for params) |
827 | // returns the new child | |
828 | // | |
61cc8aa9 | 829 | // public function appendInputFile($name, $id, $accept) |
4bb9d784 RK |
830 | // appends an ExtendedDocument::createElementInputFile() as a child of this element (see there for params) |
831 | // returns the new child | |
832 | // | |
61cc8aa9 | 833 | // public function appendInputSubmit($value) |
ae41c41b RK |
834 | // appends an ExtendedDocument::createElementInputSubmit() as a child of this element (see there for params) |
835 | // returns the new child | |
836 | // | |
61cc8aa9 | 837 | // public function appendButton($value, $onclick = null) |
1109f526 RK |
838 | // appends an ExtendedDocument::createElementButton() as a child of this element (see there for params) |
839 | // returns the new child | |
840 | // | |
61cc8aa9 | 841 | // public function appendTextArea($name, $columns, $rows, [$id], [$value]) |
bf91764c RK |
842 | // appends an ExtendedDocument::createElementTextArea() as a child of this element (see there for params) |
843 | // returns the new child | |
844 | // | |
69409ddb | 845 | // public function appendElementSelect($name, [$id], [$options], [$default], [$strictmatch]) |
bf91764c RK |
846 | // appends an ExtendedDocument::createElementSelect() as a child of this element (see there for params) |
847 | // returns the new child | |
848 | // | |
61cc8aa9 | 849 | // public function appendElementOption($key, $desc, [$selected]) |
bf91764c RK |
850 | // appends an ExtendedDocument::createElementOption() as a child of this element (see there for params) |
851 | // returns the new child | |
852 | // | |
61cc8aa9 | 853 | // public function appendLabel($for_id, $value) |
ae41c41b RK |
854 | // appends an ExtendedDocument::createElementLabel() as a child of this element (see there for params) |
855 | // returns the new child | |
856 | // | |
c79be4c2 RK |
857 | // public function appendElementDatalist([$id], [$options]) |
858 | // appends an ExtendedDocument::createElementDatalist() as a child of this element (see there for params) | |
859 | // returns the new child | |
860 | // | |
61cc8aa9 | 861 | // public function appendText($text) |
cea5b93a RK |
862 | // appends a DOMDocument::createTextNode() as a child of this element (see there for params) |
863 | // returns the new child | |
864 | // | |
71771b0c RK |
865 | // public function appendLinebreak() |
866 | // appends a <br> as a child of this element | |
867 | // returns the new child | |
868 | // | |
6638efd5 RK |
869 | // public function appendEntity($name) |
870 | // appends a DOMDocument::createEntityReference() as a child of this element (see there for params) | |
871 | // returns the new child | |
872 | // | |
61cc8aa9 | 873 | // public function appendComment($comment_data) |
cadc5980 RK |
874 | // appends a DOMDocument::createComment() as a child of this element (see there for params) |
875 | // returns the new child | |
876 | // | |
3d4db013 RK |
877 | // public function appendClonedElement($dom_element, [$deep]) |
878 | // appends a clone of the given DOMElement as a child of this element | |
879 | // the boolean $deep specifies if the children are cloned as well (defaults to TRUE) | |
880 | // returns the new child | |
881 | // | |
61cc8aa9 | 882 | // public function appendHTMLMarkup($htmldata) |
ae41c41b RK |
883 | // appends a representation of the HTML data as children of this element |
884 | // NO return value! | |
885 | // | |
61cc8aa9 | 886 | // public function appendXMLMarkup($xmldata) |
ae41c41b | 887 | // appends a representation of the XML data as children of this element |
cea5b93a RK |
888 | // NO return value! |
889 | // | |
acaa2daa RK |
890 | // public function appendStyleElement($styledata) |
891 | // appends an ExtendedDocument::createElementStyle() as a child of this element (see there for params) | |
892 | // returns the new child | |
893 | // | |
61cc8aa9 | 894 | // public function appendJSElement($jsdata) |
cea5b93a | 895 | // appends an ExtendedDocument::createElementJS() as a child of this element (see there for params) |
3d4db013 | 896 | // returns the new child |
c1666e91 | 897 | // |
8afa2e61 | 898 | // public function appendJSFile($jsURL, [$defer], [$async]) |
0bbc241e | 899 | // appends an ExtendedDocument::createElementJSFile() as a child of this element (see there for params) |
ea32f7e5 | 900 | // returns the new child |
f887cdcb RK |
901 | // |
902 | // public function setClass($classname) | |
903 | // sets the 'class' attribute of the element to the given classname value | |
904 | // | |
905 | // public function addClass($classname) | |
906 | // adds the given classname value to the space-separated list in the 'class' attribute | |
907 | // returns the value of the 'class' attribute | |
908 | // | |
909 | // public function setID($elem_id) | |
910 | // sets the 'id' attribute of the element to the given elem_id value | |
cea5b93a | 911 | |
61cc8aa9 | 912 | public function appendElement($name, $value = '') { |
a8816f43 | 913 | return $this->appendChild($this->ownerDocument->createElement($name, $value)); |
cea5b93a | 914 | } |
61cc8aa9 | 915 | public function appendElementXML($name, $xmldata) { |
cea5b93a | 916 | $aelem = $this->appendChild($this->ownerDocument->createElement($name)); |
ae41c41b | 917 | $aelem->appendXMLMarkup($xmldata); |
cea5b93a RK |
918 | return $aelem; |
919 | } | |
b3cc0fef RK |
920 | public function appendLink($target, $value = '', $title = null) { |
921 | return $this->appendChild($this->ownerDocument->createElementLink($target, $value, $title)); | |
cea5b93a | 922 | } |
61cc8aa9 | 923 | public function appendImage($src, $alt_text = '') { |
53510e9e RK |
924 | return $this->appendChild($this->ownerDocument->createElementImage($src, $alt_text)); |
925 | } | |
61cc8aa9 | 926 | public function appendForm($action, $method, $name, $id = null) { |
b8d16837 RK |
927 | return $this->appendChild($this->ownerDocument->createElementForm($action, $method, $name, $id)); |
928 | } | |
61cc8aa9 | 929 | public function appendFormDiv($action, $method, $name, $id = null) { |
b8d16837 | 930 | $formelem = $this->appendChild($this->ownerDocument->createElementForm($action, $method, $name, $id)); |
ae41c41b RK |
931 | return $formelem->appendElement('div'); |
932 | } | |
61cc8aa9 | 933 | public function appendInputHidden($name, $value) { |
ae41c41b RK |
934 | return $this->appendChild($this->ownerDocument->createElementInputHidden($name, $value)); |
935 | } | |
61cc8aa9 | 936 | public function appendInputText($name, $maxlength, $size, $id = null, $value = null) { |
ae41c41b RK |
937 | return $this->appendChild($this->ownerDocument->createElementInputText($name, $maxlength, $size, $id, $value)); |
938 | } | |
f925e4a1 RK |
939 | public function appendInputPassword($name, $maxlength, $size, $id = null, $value = null) { |
940 | return $this->appendChild($this->ownerDocument->createElementInputPassword($name, $maxlength, $size, $id, $value)); | |
941 | } | |
61cc8aa9 | 942 | public function appendInputNumber($name, $maxlength, $size, $id = null, $value = null) { |
262e0bbb RK |
943 | return $this->appendChild($this->ownerDocument->createElementInputNumber($name, $maxlength, $size, $id, $value)); |
944 | } | |
f925e4a1 RK |
945 | public function appendInputRange($name, $id, $min, $max, $step = null, $value = null) { |
946 | return $this->appendChild($this->ownerDocument->createElementInputRange($name, $id, $min, $max, $step, $value)); | |
947 | } | |
6f794328 RK |
948 | public function appendInputSearch($name, $maxlength, $size, $id = null, $value = null) { |
949 | return $this->appendChild($this->ownerDocument->createElementInputSearch($name, $maxlength, $size, $id, $value)); | |
950 | } | |
f925e4a1 RK |
951 | public function appendInputUrl($name, $maxlength, $size, $id = null, $value = null) { |
952 | return $this->appendChild($this->ownerDocument->createElementInputUrl($name, $maxlength, $size, $id, $value)); | |
953 | } | |
ea32f7e5 RK |
954 | public function appendInputEmail($name, $maxlength, $size, $id = null, $value = null) { |
955 | return $this->appendChild($this->ownerDocument->createElementInputEmail($name, $maxlength, $size, $id, $value)); | |
956 | } | |
f925e4a1 RK |
957 | public function appendInputTel($name, $maxlength, $size, $id = null, $value = null) { |
958 | return $this->appendChild($this->ownerDocument->createElementInputTel($name, $maxlength, $size, $id, $value)); | |
959 | } | |
960 | public function appendInputDate($name, $id = null, $min = null, $max = null, $value = null) { | |
961 | return $this->appendChild($this->ownerDocument->createElementInputDate($name, $id, $min, $max, $value)); | |
962 | } | |
963 | public function appendInputTime($name, $id = null, $min = null, $max = null, $value = null) { | |
964 | return $this->appendChild($this->ownerDocument->createElementInputTime($name, $id, $min, $max, $value)); | |
965 | } | |
966 | public function appendInputColor($name, $id = null, $value = null) { | |
967 | return $this->appendChild($this->ownerDocument->createElementInputColor($name, $id, $value)); | |
645a7eb6 | 968 | } |
61cc8aa9 | 969 | public function appendInputRadio($name, $id, $value, $checked) { |
ae41c41b RK |
970 | return $this->appendChild($this->ownerDocument->createElementInputRadio($name, $id, $value, $checked)); |
971 | } | |
61cc8aa9 | 972 | public function appendInputCheckbox($name, $id, $value, $checked) { |
ae41c41b RK |
973 | return $this->appendChild($this->ownerDocument->createElementInputCheckbox($name, $id, $value, $checked)); |
974 | } | |
61cc8aa9 | 975 | public function appendInputFile($name, $id, $accept) { |
4bb9d784 RK |
976 | return $this->appendChild($this->ownerDocument->createElementInputFile($name, $id, $accept)); |
977 | } | |
61cc8aa9 | 978 | public function appendInputSubmit($value) { |
ae41c41b RK |
979 | return $this->appendChild($this->ownerDocument->createElementInputSubmit($value)); |
980 | } | |
61cc8aa9 | 981 | public function appendButton($value, $onclick = null) { |
1109f526 RK |
982 | return $this->appendChild($this->ownerDocument->createElementButton($value, $onclick)); |
983 | } | |
61cc8aa9 | 984 | public function appendTextArea($name, $columns, $rows, $id = null, $value = null) { |
bf91764c RK |
985 | return $this->appendChild($this->ownerDocument->createElementTextArea($name, $columns, $rows, $id, $value)); |
986 | } | |
69409ddb RK |
987 | public function appendElementSelect($name, $id = null, $options = array(), $default = null, $strictmatch = false) { |
988 | return $this->appendChild($this->ownerDocument->createElementSelect($name, $id, $options, $default, $strictmatch)); | |
bf91764c | 989 | } |
61cc8aa9 | 990 | public function appendElementOption($key, $desc, $selected = false) { |
bf91764c RK |
991 | return $this->appendChild($this->ownerDocument->createElementOption($key, $desc, $selected)); |
992 | } | |
61cc8aa9 | 993 | public function appendLabel($for_id, $value) { |
bf91764c RK |
994 | return $this->appendChild($this->ownerDocument->createElementLabel($for_id, $value)); |
995 | } | |
c79be4c2 RK |
996 | public function appendElementDatalist($id = null, $options = array()) { |
997 | return $this->appendChild($this->ownerDocument->createElementDatalist($id, $options)); | |
998 | } | |
61cc8aa9 | 999 | public function appendText($text) { |
c79be4c2 | 1000 | return $this->appendChild($this->ownerDocument->createTextNode($text ?? '')); |
bf91764c | 1001 | } |
71771b0c RK |
1002 | public function appendLinebreak() { |
1003 | return $this->appendChild($this->ownerDocument->createElement('br')); | |
1004 | } | |
6638efd5 RK |
1005 | public function appendEntity($name) { |
1006 | return $this->appendChild($this->ownerDocument->createEntityReference($name)); | |
1007 | } | |
61cc8aa9 | 1008 | public function appendComment($comment_data) { |
cadc5980 RK |
1009 | return $this->appendChild($this->ownerDocument->createComment($comment_data)); |
1010 | } | |
3d4db013 RK |
1011 | public function appendClonedElement($dom_element, $deep = true) { |
1012 | return $this->appendChild($dom_element->cloneNode($deep)); | |
1013 | } | |
61cc8aa9 | 1014 | public function appendHTMLMarkup($htmldata) { |
bf91764c RK |
1015 | $this->ownerDocument->appendHTMLMarkup($htmldata, $this); |
1016 | } | |
61cc8aa9 | 1017 | public function appendXMLMarkup($xmldata) { |
bf91764c RK |
1018 | $this->ownerDocument->appendXMLMarkup($xmldata, $this); |
1019 | } | |
acaa2daa RK |
1020 | public function appendStyleElement($styledata) { |
1021 | return $this->appendChild($this->ownerDocument->createElementStyle($styledata)); | |
1022 | } | |
61cc8aa9 | 1023 | public function appendJSElement($jsdata) { |
3d4db013 | 1024 | return $this->appendChild($this->ownerDocument->createElementJS($jsdata)); |
bf91764c | 1025 | } |
1a4ee0f0 RK |
1026 | public function appendJSFile($jsURL, $defer = false, $async = false) { |
1027 | return $this->appendChild($this->ownerDocument->createElementJSFile($jsURL, $defer, $async)); | |
ea32f7e5 | 1028 | } |
f887cdcb RK |
1029 | public function setClass($classname) { |
1030 | $this->setAttribute('class', $classname); | |
1031 | } | |
1032 | public function addClass($classname) { | |
1033 | $classval = $this->getAttribute('class'); | |
1034 | if (strlen($classval)) { $classval .= ' '; } | |
1035 | $classval .= $classname; | |
1036 | $this->setClass($classval); | |
1037 | return $classval; | |
1038 | } | |
1039 | public function setID($elem_id) { | |
1040 | $this->setAttribute('id', $elem_id); | |
1041 | } | |
bf91764c RK |
1042 | } |
1043 | ||
1044 | class ExtendedDocumentFragment extends DOMDocumentFragment { | |
1045 | // ExtendedDocumentFragment PHP class | |
1046 | // this extends the general PHP DOM Document Fragment class to simplify some usual constructs | |
1047 | // | |
61cc8aa9 | 1048 | // public function appendElement($name, [$value]) |
bf91764c RK |
1049 | // appends a DOMDocument::createElement() as a child of this fragment (see there for params) |
1050 | // returns the new child | |
1051 | // | |
61cc8aa9 | 1052 | // public function appendElementXML($name, $xmldata) |
bf91764c RK |
1053 | // appends a DOMDocument::createElement() with the given name as a child of this fragment, |
1054 | // with an ExtendedDocument::createXMLFragment() of the given XML data inside | |
1055 | // returns the new child | |
1056 | // | |
b3cc0fef | 1057 | // public function appendLink($target, [$value], [$title]) |
bf91764c RK |
1058 | // appends an ExtendedDocument::createElementLink() as a child of this fragment (see there for params) |
1059 | // returns the new child | |
1060 | // | |
61cc8aa9 | 1061 | // public function appendImage($src, [$alt_text]) |
53510e9e RK |
1062 | // appends an ExtendedDocument::createElementImage() as a child of this document (see there for params) |
1063 | // returns the new child | |
1064 | // | |
61cc8aa9 | 1065 | // public function appendForm($action, $method, $name, [$id]) |
b8d16837 RK |
1066 | // appends an ExtendedDocument::createElementForm() as a child of this fragment (see there for params) |
1067 | // returns the new child | |
1068 | // | |
61cc8aa9 | 1069 | // public function appendFormDiv($action, $method, $name, [$id]) |
bf91764c RK |
1070 | // appends an ExtendedDocument::createElementForm() as a child of this fragment (see there for params) |
1071 | // returns an HTML <div> that is a child of the new child | |
1072 | // | |
61cc8aa9 | 1073 | // public function appendInputHidden($name, $value) |
bf91764c RK |
1074 | // appends an ExtendedDocument::createElementInputHidden() as a child of this fragment (see there for params) |
1075 | // returns the new child | |
1076 | // | |
61cc8aa9 | 1077 | // public function appendInputText($name, $maxlength, $size, [$id], [$value]) |
bf91764c RK |
1078 | // appends an ExtendedDocument::createElementInputText() as a child of this fragment (see there for params) |
1079 | // returns the new child | |
1080 | // | |
f925e4a1 RK |
1081 | // public function appendInputPassword($name, $maxlength, $size, [$id], [$value]) |
1082 | // appends an ExtendedDocument::createElementInputPassword() as a child of this fragment (see there for params) | |
1083 | // returns the new child | |
1084 | // | |
61cc8aa9 | 1085 | // public function appendInputNumber($name, $maxlength, $size, [$id], [$value]) |
262e0bbb RK |
1086 | // appends an ExtendedDocument::createElementInputNumber() as a child of this fragment (see there for params) |
1087 | // returns the new child | |
1088 | // | |
f925e4a1 RK |
1089 | // public function appendInputRange($name, $id, $min, $max, [$step], [$value]) |
1090 | // appends an ExtendedDocument::createElementInputRange() as a child of this fragment (see there for params) | |
1091 | // returns the new child | |
1092 | // | |
6f794328 RK |
1093 | // public function appendInputSearch($name, $maxlength, $size, [$id], [$value]) |
1094 | // appends an ExtendedDocument::createElementInputSearch() as a child of this fragment (see there for params) | |
1095 | // returns the new child | |
1096 | // | |
f925e4a1 RK |
1097 | // public function appendInputUrl($name, $maxlength, $size, [$id], [$value]) |
1098 | // appends an ExtendedDocument::createElementInputUrl() as a child of this fragment (see there for params) | |
1099 | // returns the new child | |
1100 | // | |
ea32f7e5 RK |
1101 | // public function appendInputEmail($name, $maxlength, $size, [$id], [$value]) |
1102 | // appends an ExtendedDocument::createElementInputEmail() as a child of this fragment (see there for params) | |
1103 | // returns the new child | |
1104 | // | |
f925e4a1 RK |
1105 | // public function appendInputTel($name, $maxlength, $size, [$id], [$value]) |
1106 | // appends an ExtendedDocument::createElementInputTel() as a child of this fragment (see there for params) | |
645a7eb6 RK |
1107 | // returns the new child |
1108 | // | |
f925e4a1 RK |
1109 | // public function appendInputDate($name, [$id], [$min], [$max], [$value]) |
1110 | // appends an ExtendedDocument::createElementInputDate() as a child of this fragment (see there for params) | |
1111 | // returns the new child | |
1112 | // | |
1113 | // public function appendInputTime($name, [$id], [$min], [$max], [$value]) | |
1114 | // appends an ExtendedDocument::createElementInputTime() as a child of this fragment (see there for params) | |
1115 | // returns the new child | |
1116 | // | |
1117 | // public function appendInputColor($name, [$id], [$value]) | |
1118 | // appends an ExtendedDocument::createElementInputColor() as a child of this fragment (see there for params) | |
1119 | // | |
61cc8aa9 | 1120 | // public function appendInputRadio($name, $id, $value, $checked) |
bf91764c RK |
1121 | // appends an ExtendedDocument::createElementInputRadio() as a child of this fragment (see there for params) |
1122 | // returns the new child | |
1123 | // | |
61cc8aa9 | 1124 | // public function appendInputCheckbox($name, $id, $value, $checked) |
bf91764c RK |
1125 | // appends an ExtendedDocument::createElementInputCheckbox() as a child of this fragment (see there for params) |
1126 | // returns the new child | |
1127 | // | |
61cc8aa9 | 1128 | // public function appendInputFile($name, $id, $accept) |
4bb9d784 RK |
1129 | // appends an ExtendedDocument::createElementInputFile() as a child of this fragment (see there for params) |
1130 | // returns the new child | |
1131 | // | |
61cc8aa9 | 1132 | // public function appendInputSubmit($value) |
bf91764c RK |
1133 | // appends an ExtendedDocument::createElementInputSubmit() as a child of this fragment (see there for params) |
1134 | // returns the new child | |
1135 | // | |
61cc8aa9 | 1136 | // public function appendButton($value, $onclick = null) |
1109f526 RK |
1137 | // appends an ExtendedDocument::createElementButton() as a child of this fragment (see there for params) |
1138 | // returns the new child | |
1139 | // | |
61cc8aa9 | 1140 | // public function appendTextArea($name, $columns, $rows, [$id], [$value]) |
bf91764c RK |
1141 | // appends an ExtendedDocument::createElementTextArea() as a child of this fragment (see there for params) |
1142 | // returns the new child | |
1143 | // | |
69409ddb | 1144 | // public function appendElementSelect($name, [$id], [$options], [$default], [$strictmatch]) |
bf91764c RK |
1145 | // appends an ExtendedDocument::createElementSelect() as a child of this fragment (see there for params) |
1146 | // returns the new child | |
1147 | // | |
61cc8aa9 | 1148 | // public function appendElementOption($key, $desc, [$selected]) |
bf91764c RK |
1149 | // appends an ExtendedDocument::createElementOption() as a child of this fragment (see there for params) |
1150 | // returns the new child | |
1151 | // | |
61cc8aa9 | 1152 | // public function appendLabel($for_id, $value) |
bf91764c RK |
1153 | // appends an ExtendedDocument::createElementLabel() as a child of this fragment (see there for params) |
1154 | // returns the new child | |
1155 | // | |
c79be4c2 RK |
1156 | // public function appendElementDatalist([$id], [$options]) |
1157 | // appends an ExtendedDocument::createElementDatalist() as a child of this fragment (see there for params) | |
1158 | // returns the new child | |
1159 | // | |
61cc8aa9 | 1160 | // public function appendText($text) |
bf91764c RK |
1161 | // appends a DOMDocument::createTextNode() as a child of this fragment (see there for params) |
1162 | // returns the new child | |
1163 | // | |
71771b0c RK |
1164 | // public function appendLinebreak() |
1165 | // appends a <br> as a child of this fragment | |
1166 | // returns the new child | |
1167 | // | |
6638efd5 RK |
1168 | // public function appendEntity($name) |
1169 | // appends a DOMDocument::createEntityReference() as a child of this fragment (see there for params) | |
1170 | // returns the new child | |
1171 | // | |
61cc8aa9 | 1172 | // public function appendComment($comment_data) |
cadc5980 RK |
1173 | // appends a DOMDocument::createComment() as a child of this fragment (see there for params) |
1174 | // returns the new child | |
1175 | // | |
3d4db013 RK |
1176 | // public function appendClonedElement($dom_element, [$deep]) |
1177 | // appends a clone of the given DOMElement as a child of this fragment | |
1178 | // the boolean $deep specifies if the children are cloned as well (defaults to TRUE) | |
1179 | // returns the new child | |
1180 | // | |
61cc8aa9 | 1181 | // public function appendHTMLMarkup($htmldata) |
bf91764c RK |
1182 | // appends a representation of the HTML data as children of this fragment |
1183 | // NO return value! | |
1184 | // | |
61cc8aa9 | 1185 | // public function appendXMLMarkup($xmldata) |
bf91764c RK |
1186 | // appends a representation of the XML data as children of this fragment |
1187 | // NO return value! | |
1188 | // | |
acaa2daa RK |
1189 | // public function appendStyleElement($styledata) |
1190 | // appends an ExtendedDocument::createElementStyle() as a child of this element (see there for params) | |
1191 | // returns the new child | |
1192 | // | |
61cc8aa9 | 1193 | // public function appendJSElement($jsdata) |
bf91764c | 1194 | // appends an ExtendedDocument::createElementJS() as a child of this fragment (see there for params) |
3d4db013 | 1195 | // returns the new child |
c1666e91 | 1196 | // |
8afa2e61 | 1197 | // public function appendJSFile($jsURL, [$defer], [$async]) |
0bbc241e | 1198 | // appends an ExtendedDocument::createElementJSFile() as a child of this fragment (see there for params) |
ea32f7e5 | 1199 | // returns the new child |
bf91764c | 1200 | |
61cc8aa9 | 1201 | public function appendElement($name, $value = '') { |
a8816f43 | 1202 | return $this->appendChild($this->ownerDocument->createElement($name, $value)); |
bf91764c | 1203 | } |
61cc8aa9 | 1204 | public function appendElementXML($name, $xmldata) { |
bf91764c RK |
1205 | $aelem = $this->appendChild($this->ownerDocument->createElement($name)); |
1206 | $aelem->appendXMLMarkup($xmldata); | |
1207 | return $aelem; | |
1208 | } | |
b3cc0fef RK |
1209 | public function appendLink($target, $value = '', $title = null) { |
1210 | return $this->appendChild($this->ownerDocument->createElementLink($target, $value, $title)); | |
bf91764c | 1211 | } |
61cc8aa9 | 1212 | public function appendImage($src, $alt_text = '') { |
53510e9e RK |
1213 | return $this->appendChild($this->ownerDocument->createElementImage($src, $alt_text)); |
1214 | } | |
61cc8aa9 | 1215 | public function appendForm($action, $method, $name, $id = null) { |
b8d16837 RK |
1216 | return $this->appendChild($this->ownerDocument->createElementForm($action, $method, $name, $id)); |
1217 | } | |
61cc8aa9 | 1218 | public function appendFormDiv($action, $method, $name, $id = null) { |
b8d16837 | 1219 | $formelem = $this->appendChild($this->ownerDocument->createElementForm($action, $method, $name, $id)); |
bf91764c RK |
1220 | return $formelem->appendElement('div'); |
1221 | } | |
61cc8aa9 | 1222 | public function appendInputHidden($name, $value) { |
bf91764c RK |
1223 | return $this->appendChild($this->ownerDocument->createElementInputHidden($name, $value)); |
1224 | } | |
61cc8aa9 | 1225 | public function appendInputText($name, $maxlength, $size, $id = null, $value = null) { |
bf91764c | 1226 | return $this->appendChild($this->ownerDocument->createElementInputText($name, $maxlength, $size, $id, $value)); |
645a7eb6 | 1227 | } |
f925e4a1 RK |
1228 | public function appendInputPassword($name, $maxlength, $size, $id = null, $value = null) { |
1229 | return $this->appendChild($this->ownerDocument->createElementInputPassword($name, $maxlength, $size, $id, $value)); | |
1230 | } | |
61cc8aa9 | 1231 | public function appendInputNumber($name, $maxlength, $size, $id = null, $value = null) { |
262e0bbb RK |
1232 | return $this->appendChild($this->ownerDocument->createElementInputNumber($name, $maxlength, $size, $id, $value)); |
1233 | } | |
f925e4a1 RK |
1234 | public function appendInputRange($name, $id, $min, $max, $step = null, $value = null) { |
1235 | return $this->appendChild($this->ownerDocument->createElementInputRange($name, $id, $min, $max, $step, $value)); | |
1236 | } | |
6f794328 RK |
1237 | public function appendInputSearch($name, $maxlength, $size, $id = null, $value = null) { |
1238 | return $this->appendChild($this->ownerDocument->createElementInputSearch($name, $maxlength, $size, $id, $value)); | |
1239 | } | |
f925e4a1 RK |
1240 | public function appendInputUrl($name, $maxlength, $size, $id = null, $value = null) { |
1241 | return $this->appendChild($this->ownerDocument->createElementInputUrl($name, $maxlength, $size, $id, $value)); | |
1242 | } | |
ea32f7e5 RK |
1243 | public function appendInputEmail($name, $maxlength, $size, $id = null, $value = null) { |
1244 | return $this->appendChild($this->ownerDocument->createElementInputEmail($name, $maxlength, $size, $id, $value)); | |
1245 | } | |
f925e4a1 RK |
1246 | public function appendInputTel($name, $maxlength, $size, $id = null, $value = null) { |
1247 | return $this->appendChild($this->ownerDocument->createElementInputTel($name, $maxlength, $size, $id, $value)); | |
1248 | } | |
1249 | public function appendInputDate($name, $id = null, $min = null, $max = null, $value = null) { | |
1250 | return $this->appendChild($this->ownerDocument->createElementInputDate($name, $id, $min, $max, $value)); | |
1251 | } | |
1252 | public function appendInputTime($name, $id = null, $min = null, $max = null, $value = null) { | |
1253 | return $this->appendChild($this->ownerDocument->createElementInputTime($name, $id, $min, $max, $value)); | |
1254 | } | |
1255 | public function appendInputColor($name, $id = null, $value = null) { | |
1256 | return $this->appendChild($this->ownerDocument->createElementInputColor($name, $id, $value)); | |
bf91764c | 1257 | } |
61cc8aa9 | 1258 | public function appendInputRadio($name, $id, $value, $checked) { |
bf91764c RK |
1259 | return $this->appendChild($this->ownerDocument->createElementInputRadio($name, $id, $value, $checked)); |
1260 | } | |
61cc8aa9 | 1261 | public function appendInputCheckbox($name, $id, $value, $checked) { |
bf91764c RK |
1262 | return $this->appendChild($this->ownerDocument->createElementInputCheckbox($name, $id, $value, $checked)); |
1263 | } | |
61cc8aa9 | 1264 | public function appendInputFile($name, $id, $accept) { |
4bb9d784 RK |
1265 | return $this->appendChild($this->ownerDocument->createElementInputFile($name, $id, $accept)); |
1266 | } | |
61cc8aa9 | 1267 | public function appendInputSubmit($value) { |
bf91764c RK |
1268 | return $this->appendChild($this->ownerDocument->createElementInputSubmit($value)); |
1269 | } | |
61cc8aa9 | 1270 | public function appendButton($value, $onclick = null) { |
1109f526 RK |
1271 | return $this->appendChild($this->ownerDocument->createElementButton($value, $onclick)); |
1272 | } | |
61cc8aa9 | 1273 | public function appendTextArea($name, $columns, $rows, $id = null, $value = null) { |
bf91764c RK |
1274 | return $this->appendChild($this->ownerDocument->createElementTextArea($name, $columns, $rows, $id, $value)); |
1275 | } | |
69409ddb RK |
1276 | public function appendElementSelect($name, $id = null, $options = array(), $default = null, $strictmatch = false) { |
1277 | return $this->appendChild($this->ownerDocument->createElementSelect($name, $id, $options, $default, $strictmatch)); | |
bf91764c | 1278 | } |
61cc8aa9 | 1279 | public function appendElementOption($key, $desc, $selected = false) { |
bf91764c RK |
1280 | return $this->appendChild($this->ownerDocument->createElementOption($key, $desc, $selected)); |
1281 | } | |
61cc8aa9 | 1282 | public function appendLabel($for_id, $value) { |
ae41c41b RK |
1283 | return $this->appendChild($this->ownerDocument->createElementLabel($for_id, $value)); |
1284 | } | |
c79be4c2 RK |
1285 | public function appendElementDatalist($id = null, $options = array()) { |
1286 | return $this->appendChild($this->ownerDocument->createElementDatalist($id, $options)); | |
1287 | } | |
61cc8aa9 | 1288 | public function appendText($text) { |
cea5b93a RK |
1289 | return $this->appendChild($this->ownerDocument->createTextNode($text)); |
1290 | } | |
71771b0c RK |
1291 | public function appendLinebreak() { |
1292 | return $this->appendChild($this->ownerDocument->createElement('br')); | |
1293 | } | |
6638efd5 RK |
1294 | public function appendEntity($name) { |
1295 | return $this->appendChild($this->ownerDocument->createEntityReference($name)); | |
1296 | } | |
61cc8aa9 | 1297 | public function appendComment($comment_data) { |
cadc5980 RK |
1298 | return $this->appendChild($this->ownerDocument->createComment($comment_data)); |
1299 | } | |
3d4db013 RK |
1300 | public function appendClonedElement($dom_element, $deep = true) { |
1301 | return $this->appendChild($dom_element->cloneNode($deep)); | |
1302 | } | |
61cc8aa9 | 1303 | public function appendHTMLMarkup($htmldata) { |
ae41c41b RK |
1304 | $this->ownerDocument->appendHTMLMarkup($htmldata, $this); |
1305 | } | |
61cc8aa9 | 1306 | public function appendXMLMarkup($xmldata) { |
ae41c41b | 1307 | $this->ownerDocument->appendXMLMarkup($xmldata, $this); |
cea5b93a | 1308 | } |
acaa2daa RK |
1309 | public function appendStyleElement($styledata) { |
1310 | return $this->appendChild($this->ownerDocument->createElementStyle($styledata)); | |
1311 | } | |
61cc8aa9 | 1312 | public function appendJSElement($jsdata) { |
3d4db013 | 1313 | return $this->appendChild($this->ownerDocument->createElementJS($jsdata)); |
cea5b93a | 1314 | } |
1a4ee0f0 RK |
1315 | public function appendJSFile($jsURL, $defer = false, $async = false) { |
1316 | return $this->appendChild($this->ownerDocument->createElementJSFile($jsURL, $defer, $async)); | |
ea32f7e5 | 1317 | } |
cea5b93a RK |
1318 | } |
1319 | ?> |