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(); } | |
d7403a92 | 287 | $doc->loadHTML5('<?xml version="1.0" encoding="utf-8"?><!DOCTYPE html><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); | |
305 | if (!preg_match('/^\s*<?xml /', $source)) { | |
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); | |
310 | // Handle DOMDocument loading errors, throw away warnings on unknown tags as HTML5 allows all kinds. | |
311 | $errseverity = array(LIBXML_ERR_WARNING => 'Warning', LIBXML_ERR_ERROR => 'Error', LIBXML_ERR_FATAL => 'Fatal'); | |
312 | foreach (libxml_get_errors() as $error) { | |
313 | // $error is a libXMLError, see https://www.php.net/manual/en/class.libxmlerror.php | |
314 | // See http://www.xmlsoft.org/html/libxml-xmlerror.html#xmlParserErrors for error numbers | |
315 | if ($error->code != 801) { // XML_HTML_UNKNOWN_TAG gets no output, should not exist for HTML5. | |
316 | trigger_error($errseverity[$error->level].' loading HTML5: '.$error->message.' (code '.$error->code.'), line: '.$error->line, E_USER_WARNING); | |
317 | } | |
318 | } | |
319 | libxml_clear_errors(); | |
320 | libxml_use_internal_errors(false); | |
321 | return $result; | |
322 | } | |
323 | ||
61cc8aa9 | 324 | public function appendElement($name, $value = '') { |
a8816f43 | 325 | return $this->appendChild($this->createElement($name, $value)); |
cea5b93a | 326 | } |
61cc8aa9 | 327 | public function appendElementXML($name, $xmldata) { |
cea5b93a | 328 | $aelem = $this->appendChild($this->createElement($name)); |
ae41c41b RK |
329 | $aelem->appendXMLMarkup($xmldata); |
330 | //$aelem->appendChild($this->createXMLFragment($xmldata)); | |
cea5b93a RK |
331 | return $aelem; |
332 | } | |
b3cc0fef RK |
333 | public function appendLink($target, $value = '', $title = null) { |
334 | return $this->appendChild($this->createElementLink($target, $value, $title)); | |
cea5b93a | 335 | } |
61cc8aa9 | 336 | public function appendImage($src, $alt_text = '') { |
4aa31782 RK |
337 | return $this->appendChild($this->createElementImage($src, $alt_text)); |
338 | } | |
61cc8aa9 | 339 | public function appendForm($action, $method, $name, $id = null) { |
b8d16837 RK |
340 | return $this->appendChild($this->createElementForm($action, $method, $name, $id)); |
341 | } | |
61cc8aa9 | 342 | public function appendFormDiv($action, $method, $name, $id = null) { |
b8d16837 | 343 | $formelem = $this->appendChild($this->createElementForm($action, $method, $name, $id)); |
ae41c41b RK |
344 | return $formelem->appendElement('div'); |
345 | } | |
61cc8aa9 | 346 | public function appendInputHidden($name, $value) { |
ae41c41b RK |
347 | return $this->appendChild($this->createElementInputHidden($name, $value)); |
348 | } | |
61cc8aa9 | 349 | public function appendInputText($name, $maxlength, $size, $id = null, $value = null) { |
ae41c41b RK |
350 | return $this->appendChild($this->createElementInputText($name, $maxlength, $size, $id, $value)); |
351 | } | |
f925e4a1 RK |
352 | public function appendInputPassword($name, $maxlength, $size, $id = null, $value = null) { |
353 | return $this->appendChild($this->createElementInputPassword($name, $maxlength, $size, $id, $value)); | |
354 | } | |
61cc8aa9 | 355 | public function appendInputNumber($name, $maxlength, $size, $id = null, $value = null) { |
262e0bbb RK |
356 | return $this->appendChild($this->createElementInputNumber($name, $maxlength, $size, $id, $value)); |
357 | } | |
f925e4a1 RK |
358 | public function appendInputRange($name, $id, $min, $max, $step = null, $value = null) { |
359 | return $this->appendChild($this->createElementInputRange($name, $id, $min, $max, $step, $value)); | |
360 | } | |
6f794328 RK |
361 | public function appendInputSearch($name, $maxlength, $size, $id = null, $value = null) { |
362 | return $this->appendChild($this->createElementInputSearch($name, $maxlength, $size, $id, $value)); | |
363 | } | |
f925e4a1 RK |
364 | public function appendInputUrl($name, $maxlength, $size, $id = null, $value = null) { |
365 | return $this->appendChild($this->createElementInputUrl($name, $maxlength, $size, $id, $value)); | |
366 | } | |
ea32f7e5 RK |
367 | public function appendInputEmail($name, $maxlength, $size, $id = null, $value = null) { |
368 | return $this->appendChild($this->createElementInputEmail($name, $maxlength, $size, $id, $value)); | |
369 | } | |
f925e4a1 RK |
370 | public function appendInputTel($name, $maxlength, $size, $id = null, $value = null) { |
371 | return $this->appendChild($this->createElementInputTel($name, $maxlength, $size, $id, $value)); | |
372 | } | |
373 | public function appendInputDate($name, $id = null, $min = null, $max = null, $value = null) { | |
374 | return $this->appendChild($this->createElementInputDate($name, $id, $min, $max, $value)); | |
375 | } | |
376 | public function appendInputTime($name, $id = null, $min = null, $max = null, $value = null) { | |
377 | return $this->appendChild($this->createElementInputTime($name, $id, $min, $max, $value)); | |
378 | } | |
379 | public function appendInputColor($name, $id = null, $value = null) { | |
380 | return $this->appendChild($this->createElementInputColor($name, $id, $value)); | |
645a7eb6 | 381 | } |
61cc8aa9 | 382 | public function appendInputRadio($name, $id, $value, $checked) { |
ae41c41b RK |
383 | return $this->appendChild($this->createElementInputRadio($name, $id, $value, $checked)); |
384 | } | |
61cc8aa9 | 385 | public function appendInputCheckbox($name, $id, $value, $checked) { |
ae41c41b RK |
386 | return $this->appendChild($this->createElementInputCheckbox($name, $id, $value, $checked)); |
387 | } | |
61cc8aa9 | 388 | public function appendInputFile($name, $id, $accept) { |
4bb9d784 RK |
389 | return $this->appendChild($this->createElementInputFile($name, $id, $accept)); |
390 | } | |
61cc8aa9 | 391 | public function appendInputSubmit($value) { |
ae41c41b RK |
392 | return $this->appendChild($this->createElementInputSubmit($value)); |
393 | } | |
61cc8aa9 | 394 | public function appendButton($value, $onclick = null) { |
1109f526 RK |
395 | return $this->appendChild($this->createElementButton($value, $onclick)); |
396 | } | |
61cc8aa9 | 397 | public function appendTextArea($name, $columns, $rows, $id = null, $value = null) { |
bf91764c RK |
398 | return $this->appendChild($this->createElementTextArea($name, $columns, $rows, $id, $value)); |
399 | } | |
69409ddb RK |
400 | public function appendElementSelect($name, $id = null, $options = array(), $default = null, $strictmatch = false) { |
401 | return $this->appendChild($this->createElementSelect($name, $id, $options, $default, $strictmatch)); | |
bf91764c | 402 | } |
61cc8aa9 | 403 | public function appendElementOption($key, $desc, $selected = false) { |
bf91764c RK |
404 | return $this->appendChild($this->createElementOption($key, $desc, $selected)); |
405 | } | |
61cc8aa9 | 406 | public function appendLabel($for_id, $value) { |
ae41c41b RK |
407 | return $this->appendChild($this->createElementLabel($for_id, $value)); |
408 | } | |
c79be4c2 RK |
409 | public function appendElementDatalist($id = null, $options = array()) { |
410 | return $this->appendChild($this->createElementDatalist($id, $options)); | |
411 | } | |
61cc8aa9 | 412 | public function appendText($text) { |
cea5b93a RK |
413 | return $this->appendChild($this->createTextNode($text)); |
414 | } | |
71771b0c RK |
415 | public function appendLinebreak() { |
416 | return $this->appendChild($this->createElement('br')); | |
417 | } | |
6638efd5 RK |
418 | public function appendEntity($name) { |
419 | return $this->appendChild($this->createEntityReference($name)); | |
420 | } | |
61cc8aa9 | 421 | public function appendComment($comment_data) { |
cadc5980 RK |
422 | return $this->appendChild($this->createComment($comment_data)); |
423 | } | |
3d4db013 RK |
424 | public function appendClonedElement($dom_element, $deep = true) { |
425 | return $this->appendChild($dom_element->cloneNode($deep)); | |
426 | } | |
acaa2daa RK |
427 | public function appendStyleElement($styledata) { |
428 | return $this->appendChild($this->createElementStyle($styledata)); | |
429 | } | |
61cc8aa9 | 430 | public function appendJSElement($jsdata) { |
3d4db013 | 431 | return $this->appendChild($this->createElementJS($jsdata)); |
cea5b93a | 432 | } |
1a4ee0f0 RK |
433 | public function appendJSFile($jsURL, $defer = false, $async = false) { |
434 | return $this->appendChild($this->createElementJSFile($jsURL, $defer, $async)); | |
ea32f7e5 | 435 | } |
cea5b93a | 436 | |
61cc8aa9 | 437 | public function appendHTMLMarkup($htmldata, $parentNode = null) { |
ae41c41b | 438 | if (is_null($parentNode)) { $parentNode =& $this; } |
d7403a92 | 439 | // Use loadHTML5() to parse and turn the markup into proper HTML. |
a9a5a68a RK |
440 | $tmpdoc = new ExtendedDocument; |
441 | // The XML line is needed to tell the parser that we need UTF-8 parsing. | |
d7403a92 | 442 | $tmpdoc->loadHTML5('<?xml version="1.0" encoding="utf-8"?><!DOCTYPE html><html><body>'.$htmldata.'</body></html>'); |
a9a5a68a RK |
443 | foreach ($tmpdoc->getElementsByTagName('body')->item(0)->childNodes as $child) { |
444 | $parentNode->appendChild($this->importNode($child, true)); | |
445 | } | |
ae41c41b RK |
446 | } |
447 | ||
61cc8aa9 | 448 | public function appendXMLMarkup($xmldata, $parentNode = null) { |
ae41c41b RK |
449 | if (is_null($parentNode)) { $parentNode =& $this; } |
450 | $tmpdoc = new ExtendedDocument; | |
451 | $tmpxml = '<?xml version="1.0" encoding="utf-8"?>'."\n"; | |
452 | $tmpxml .= '<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.1//EN" "http://www.w3.org/TR/xhtml11/DTD/xhtml11.dtd">'."\n"; | |
453 | $tmpxml .= '<root>'.$xmldata.'</root>'; | |
454 | $tmpdoc->loadXML($tmpxml); | |
455 | foreach ($tmpdoc->getElementsByTagName('root')->item(0)->childNodes as $child) { | |
456 | $parentNode->appendChild($this->importNode($child, true)); | |
457 | } | |
cea5b93a RK |
458 | } |
459 | ||
61cc8aa9 | 460 | public function createElement($name, $value = '') { |
a8816f43 RK |
461 | // Adding the $value in DOMDocument's createElement does NOT escape it, so override it and use appendText to support that. |
462 | $aelem = parent::createElement($name); | |
5ae00086 | 463 | if (strlen($value ?? '')) { $aelem->appendText($value); } |
a8816f43 RK |
464 | return $aelem; |
465 | } | |
466 | ||
b3cc0fef | 467 | public function createElementLink($target, $value = '', $title = null) { |
a8816f43 | 468 | $link = $this->createElement('a', $value); |
bf91764c | 469 | $link->setAttribute('href', $target); // XXX: take care of & etc. in links |
b3cc0fef | 470 | if (!is_null($title)) { $link->setAttribute('title', $title); } |
cea5b93a RK |
471 | return $link; |
472 | } | |
473 | ||
61cc8aa9 | 474 | public function createElementImage($src, $alt_text = '') { |
319cfe8d RK |
475 | $img = $this->createElement('img'); |
476 | $img->setAttribute('src', $src); | |
477 | $img->setAttribute('alt', $alt_text); | |
478 | return $img; | |
4aa31782 RK |
479 | } |
480 | ||
61cc8aa9 | 481 | public function createElementForm($action, $method, $name, $id = null) { |
ae41c41b RK |
482 | $formelem = $this->createElement('form'); |
483 | $formelem->setAttribute('action', $action); | |
484 | $formelem->setAttribute('method', $method); | |
485 | $formelem->setAttribute('name', $name); | |
b3cc0fef | 486 | if (!is_null($id)) { $formelem->setAttribute('id', $id); } |
ae41c41b RK |
487 | return $formelem; |
488 | } | |
489 | ||
61cc8aa9 | 490 | public function createElementInputHidden($name, $value) { |
ae41c41b RK |
491 | $hidden = $this->createElement('input'); |
492 | $hidden->setAttribute('type', 'hidden'); | |
493 | $hidden->setAttribute('name', $name); | |
494 | $hidden->setAttribute('value', $value); | |
495 | return $hidden; | |
496 | } | |
497 | ||
61cc8aa9 | 498 | public function createElementInputText($name, $maxlength, $size, $id = null, $value = null) { |
ae41c41b RK |
499 | $txfield = $this->createElement('input'); |
500 | $txfield->setAttribute('type', 'text'); | |
501 | if (!is_null($id)) { $txfield->setAttribute('id', $id); } | |
502 | $txfield->setAttribute('name', $name); | |
503 | $txfield->setAttribute('maxlength', $maxlength); | |
504 | $txfield->setAttribute('size', $size); | |
505 | if (!is_null($value)) { $txfield->setAttribute('value', $value); } | |
506 | return $txfield; | |
507 | } | |
508 | ||
61cc8aa9 | 509 | public function createElementInputPassword($name, $maxlength, $size, $id = null, $value = null) { |
319cfe8d RK |
510 | $pwfield = $this->createElement('input'); |
511 | $pwfield->setAttribute('type', 'password'); | |
512 | if (!is_null($id)) { $pwfield->setAttribute('id', $id); } | |
513 | $pwfield->setAttribute('name', $name); | |
514 | $pwfield->setAttribute('maxlength', $maxlength); | |
515 | $pwfield->setAttribute('size', $size); | |
516 | if (!is_null($value)) { $pwfield->setAttribute('value', $value); } | |
517 | return $pwfield; | |
645a7eb6 RK |
518 | } |
519 | ||
f925e4a1 RK |
520 | public function createElementInputNumber($name, $maxlength, $size, $id = null, $value = null) { |
521 | $numfield = $this->createElement('input'); | |
522 | $numfield->setAttribute('type', 'number'); | |
523 | if (!is_null($id)) { $numfield->setAttribute('id', $id); } | |
524 | $numfield->setAttribute('name', $name); | |
525 | $numfield->setAttribute('maxlength', $maxlength); | |
526 | $numfield->setAttribute('size', $size); | |
527 | if (!is_null($value)) { $numfield->setAttribute('value', $value); } | |
528 | return $numfield; | |
529 | } | |
530 | ||
531 | public function createElementInputRange($name, $id, $min, $max, $step = null, $value = null) { | |
532 | $rgfield = $this->createElement('input'); | |
533 | $rgfield->setAttribute('type', 'range'); | |
534 | if (!is_null($id)) { $rgfield->setAttribute('id', $id); } | |
535 | $rgfield->setAttribute('name', $name); | |
536 | if (!is_null($min)) { $rgfield->setAttribute('min', $min); } | |
537 | if (!is_null($max)) { $rgfield->setAttribute('max', $max); } | |
538 | if (!is_null($step)) { $rgfield->setAttribute('step', $step); } | |
539 | if (!is_null($value)) { $rgfield->setAttribute('value', $value); } | |
540 | return $rgfield; | |
541 | } | |
542 | ||
6f794328 RK |
543 | public function createElementInputSearch($name, $maxlength, $size, $id = null, $value = null) { |
544 | $urlfield = $this->createElement('input'); | |
545 | $urlfield->setAttribute('type', 'search'); | |
546 | if (!is_null($id)) { $urlfield->setAttribute('id', $id); } | |
547 | $urlfield->setAttribute('name', $name); | |
548 | $urlfield->setAttribute('maxlength', $maxlength); | |
549 | $urlfield->setAttribute('size', $size); | |
550 | if (!is_null($value)) { $urlfield->setAttribute('value', $value); } | |
551 | return $urlfield; | |
552 | } | |
553 | ||
f925e4a1 RK |
554 | public function createElementInputUrl($name, $maxlength, $size, $id = null, $value = null) { |
555 | $urlfield = $this->createElement('input'); | |
556 | $urlfield->setAttribute('type', 'url'); | |
557 | if (!is_null($id)) { $urlfield->setAttribute('id', $id); } | |
558 | $urlfield->setAttribute('name', $name); | |
559 | $urlfield->setAttribute('maxlength', $maxlength); | |
560 | $urlfield->setAttribute('size', $size); | |
561 | if (!is_null($value)) { $urlfield->setAttribute('value', $value); } | |
562 | return $urlfield; | |
563 | } | |
564 | ||
565 | public function createElementInputEmail($name, $maxlength, $size, $id = null, $value = null) { | |
566 | $mailfield = $this->createElement('input'); | |
567 | $mailfield->setAttribute('type', 'email'); | |
568 | if (!is_null($id)) { $mailfield->setAttribute('id', $id); } | |
569 | $mailfield->setAttribute('name', $name); | |
570 | $mailfield->setAttribute('maxlength', $maxlength); | |
571 | $mailfield->setAttribute('size', $size); | |
572 | if (!is_null($value)) { $mailfield->setAttribute('value', $value); } | |
573 | return $mailfield; | |
574 | } | |
575 | ||
576 | public function createElementInputTel($name, $maxlength, $size, $id = null, $value = null) { | |
577 | $telfield = $this->createElement('input'); | |
578 | $telfield->setAttribute('type', 'tel'); | |
579 | if (!is_null($id)) { $telfield->setAttribute('id', $id); } | |
580 | $telfield->setAttribute('name', $name); | |
581 | $telfield->setAttribute('maxlength', $maxlength); | |
582 | $telfield->setAttribute('size', $size); | |
583 | if (!is_null($value)) { $telfield->setAttribute('value', $value); } | |
584 | return $telfield; | |
585 | } | |
586 | ||
587 | public function createElementInputDate($name, $id = null, $min = null, $max = null, $value = null) { | |
b5897591 RK |
588 | $dtfield = $this->createElement('input'); |
589 | $dtfield->setAttribute('type', 'date'); | |
590 | if (!is_null($id)) { $dtfield->setAttribute('id', $id); } | |
591 | $dtfield->setAttribute('name', $name); | |
592 | if (!is_null($min)) { $dtfield->setAttribute('min', $min); } | |
593 | if (!is_null($max)) { $dtfield->setAttribute('max', $max); } | |
594 | if (!is_null($value)) { $dtfield->setAttribute('value', $value); } | |
595 | return $dtfield; | |
f925e4a1 RK |
596 | } |
597 | ||
598 | public function createElementInputTime($name, $id = null, $min = null, $max = null, $value = null) { | |
b5897591 RK |
599 | $timefield = $this->createElement('input'); |
600 | $timefield->setAttribute('type', 'time'); | |
601 | if (!is_null($id)) { $timefield->setAttribute('id', $id); } | |
602 | $timefield->setAttribute('name', $name); | |
603 | if (!is_null($min)) { $timefield->setAttribute('min', $min); } | |
604 | if (!is_null($max)) { $timefield->setAttribute('max', $max); } | |
605 | if (!is_null($value)) { $timefield->setAttribute('value', $value); } | |
606 | return $timefield; | |
f925e4a1 RK |
607 | } |
608 | ||
609 | public function createElementInputColor($name, $id = null, $value = null) { | |
610 | $colfield = $this->createElement('input'); | |
611 | $colfield->setAttribute('type', 'color'); | |
612 | if (!is_null($id)) { $colfield->setAttribute('id', $id); } | |
613 | $colfield->setAttribute('name', $name); | |
614 | if (!is_null($value)) { $colfield->setAttribute('value', $value); } | |
615 | return $colfield; | |
616 | } | |
617 | ||
61cc8aa9 | 618 | public function createElementInputRadio($name, $id, $value, $checked) { |
ae41c41b RK |
619 | $radio = $this->createElement('input'); |
620 | $radio->setAttribute('type', 'radio'); | |
621 | $radio->setAttribute('name', $name); | |
4bb9d784 | 622 | if (!is_null($id)) { $radio->setAttribute('id', $id); } |
ae41c41b RK |
623 | $radio->setAttribute('value', $value); |
624 | if ($checked) { $radio->setAttribute('checked', ''); } | |
625 | return $radio; | |
626 | } | |
627 | ||
61cc8aa9 | 628 | public function createElementInputCheckbox($name, $id, $value, $checked) { |
ae41c41b RK |
629 | $cbox = $this->createElement('input'); |
630 | $cbox->setAttribute('type', 'checkbox'); | |
631 | $cbox->setAttribute('name', $name); | |
4bb9d784 | 632 | if (!is_null($id)) { $cbox->setAttribute('id', $id); } |
ae41c41b RK |
633 | $cbox->setAttribute('value', $value); |
634 | if ($checked) { $cbox->setAttribute('checked', ''); } | |
635 | return $cbox; | |
636 | } | |
637 | ||
61cc8aa9 | 638 | public function createElementInputFile($name, $id, $accept) { |
4bb9d784 RK |
639 | $fileinput = $this->createElement('input'); |
640 | $fileinput->setAttribute('type', 'file'); | |
641 | $fileinput->setAttribute('name', $name); | |
642 | if (!is_null($id)) { $fileinput->setAttribute('id', $id); } | |
643 | $fileinput->setAttribute('accept', $accept); | |
644 | return $fileinput; | |
645 | } | |
646 | ||
61cc8aa9 | 647 | public function createElementInputSubmit($value) { |
ae41c41b RK |
648 | $submitbtn = $this->createElement('input'); |
649 | $submitbtn->setAttribute('type', 'submit'); | |
650 | $submitbtn->setAttribute('value', $value); | |
651 | return $submitbtn; | |
652 | } | |
653 | ||
61cc8aa9 | 654 | public function createElementButton($value, $onclick = null) { |
1109f526 RK |
655 | $btn = $this->createElement('input'); |
656 | $btn->setAttribute('type', 'button'); | |
657 | $btn->setAttribute('value', $value); | |
658 | if (!is_null($onclick)) { $btn->setAttribute('onclick', $onclick); } | |
659 | return $btn; | |
660 | } | |
661 | ||
61cc8aa9 | 662 | public function createElementTextArea($name, $columns, $rows, $id = null, $value = null) { |
bf91764c RK |
663 | $txtarea = $this->createElement('textarea', $value); |
664 | $txtarea->setAttribute('name', $name); | |
665 | $txtarea->setAttribute('cols', $columns); | |
666 | $txtarea->setAttribute('rows', $rows); | |
667 | if (!is_null($id)) { $txtarea->setAttribute('id', $id); } | |
668 | return $txtarea; | |
669 | } | |
670 | ||
69409ddb | 671 | public function createElementSelect($name, $id = null, $options = array(), $default = null, $strictmatch = false) { |
bf91764c RK |
672 | $select = $this->createElement('select'); |
673 | $select->setAttribute('name', $name); | |
674 | if (!is_null($id)) { $select->setAttribute('id', $id); } | |
675 | foreach ($options as $key => $desc) { | |
69409ddb | 676 | $select->appendElementOption($key, $desc, $strictmatch ? ($key === $default) : ($key == $default)); |
bf91764c RK |
677 | } |
678 | return $select; | |
679 | } | |
680 | ||
61cc8aa9 | 681 | public function createElementOption($key, $desc, $selected = false) { |
bf91764c | 682 | $option = $this->createElement('option', $desc); |
c79be4c2 RK |
683 | if ($key) { |
684 | $option->setAttribute('value', $key); | |
685 | } | |
bf91764c RK |
686 | if ($selected) { $option->setAttribute('selected', ''); } |
687 | return $option; | |
688 | } | |
689 | ||
61cc8aa9 | 690 | public function createElementLabel($for_id, $value) { |
ae41c41b RK |
691 | $label = $this->createElement('label', $value); |
692 | $label->setAttribute('for', $for_id); | |
693 | return $label; | |
cea5b93a RK |
694 | } |
695 | ||
c79be4c2 RK |
696 | public function createElementDatalist($id = null, $options = array()) { |
697 | $select = $this->createElement('datalist'); | |
698 | if (!is_null($id)) { $select->setAttribute('id', $id); } | |
699 | foreach ($options as $key => $desc) { | |
700 | $select->appendElementOption($key, $desc); | |
701 | } | |
702 | return $select; | |
703 | } | |
704 | ||
acaa2daa RK |
705 | public function createElementStyle($styledata) { |
706 | $style_elem = $this->createElement('style'); | |
707 | // Note: type can/should be left out for HTML5. | |
708 | $style_elem->setAttribute('type', 'text/css'); | |
709 | $style_elem->appendChild($this->createCDATASection($styledata)); | |
710 | return $style_elem; | |
711 | } | |
712 | ||
61cc8aa9 | 713 | public function createElementJS($jsdata) { |
cea5b93a | 714 | $jselem = $this->createElement('script'); |
ea32f7e5 | 715 | // Note: type can/should be left out for HTML5. |
cea5b93a RK |
716 | $jselem->setAttribute('type', 'text/javascript'); |
717 | $jselem->appendChild($this->createCDATASection($jsdata)); | |
718 | return $jselem; | |
719 | } | |
c1666e91 | 720 | |
8afa2e61 | 721 | public function createElementJSFile($jsURL, $defer = false, $async = false) { |
ea32f7e5 RK |
722 | $jselem = $this->createElement('script'); |
723 | // Note: type can/should be left out for HTML5. | |
724 | $jselem->setAttribute('type', 'text/javascript'); | |
8afa2e61 RK |
725 | if ($defer) { |
726 | $jselem->setAttribute('defer', ''); | |
727 | } | |
728 | if ($async) { | |
729 | $jselem->setAttribute('async', ''); | |
730 | } | |
ea32f7e5 RK |
731 | $jselem->setAttribute('src', $jsURL); |
732 | return $jselem; | |
733 | } | |
cea5b93a RK |
734 | } |
735 | ||
736 | class ExtendedElement extends DOMElement { | |
737 | // ExtendedElement PHP class | |
738 | // this extends the general PHP DOM Element class to simplify some usual constructs | |
739 | // | |
61cc8aa9 | 740 | // public function appendElement($name, [$value]) |
cea5b93a RK |
741 | // appends a DOMDocument::createElement() as a child of this element (see there for params) |
742 | // returns the new child | |
743 | // | |
61cc8aa9 | 744 | // public function appendElementXML($name, $xmldata) |
cea5b93a RK |
745 | // appends a DOMDocument::createElement() with the given name as a child of this element, |
746 | // with an ExtendedDocument::createXMLFragment() of the given XML data inside | |
747 | // returns the new child | |
748 | // | |
b3cc0fef | 749 | // public function appendLink($target, [$value], [$title]) |
cea5b93a RK |
750 | // appends an ExtendedDocument::createElementLink() as a child of this element (see there for params) |
751 | // returns the new child | |
752 | // | |
61cc8aa9 | 753 | // public function appendImage($src, [$alt_text]) |
53510e9e RK |
754 | // appends an ExtendedDocument::createElementImage() as a child of this document (see there for params) |
755 | // returns the new child | |
756 | // | |
61cc8aa9 | 757 | // public function appendForm($action, $method, $name, [$id]) |
b8d16837 RK |
758 | // appends an ExtendedDocument::createElementForm() as a child of this element (see there for params) |
759 | // returns the new child | |
760 | // | |
61cc8aa9 | 761 | // public function appendFormDiv($action, $method, $name, [$id]) |
ae41c41b RK |
762 | // appends an ExtendedDocument::createElementForm() as a child of this element (see there for params) |
763 | // returns an HTML <div> that is a child of the new child | |
764 | // | |
61cc8aa9 | 765 | // public function appendInputHidden($name, $value) |
ae41c41b RK |
766 | // appends an ExtendedDocument::createElementInputHidden() as a child of this element (see there for params) |
767 | // returns the new child | |
768 | // | |
61cc8aa9 | 769 | // public function appendInputText($name, $maxlength, $size, [$id], [$value]) |
ae41c41b RK |
770 | // appends an ExtendedDocument::createElementInputText() as a child of this element (see there for params) |
771 | // returns the new child | |
772 | // | |
f925e4a1 RK |
773 | // public function appendInputPassword($name, $maxlength, $size, [$id], [$value]) |
774 | // appends an ExtendedDocument::createElementInputPassword() as a child of this element (see there for params) | |
775 | // returns the new child | |
776 | // | |
61cc8aa9 | 777 | // public function appendInputNumber($name, $maxlength, $size, [$id], [$value]) |
262e0bbb RK |
778 | // appends an ExtendedDocument::createElementInputNumber() as a child of this element (see there for params) |
779 | // returns the new child | |
780 | // | |
f925e4a1 RK |
781 | // public function appendInputRange($name, $id, $min, $max, [$step], [$value]) |
782 | // appends an ExtendedDocument::createElementInputRange() as a child of this element (see there for params) | |
783 | // returns the new child | |
784 | // | |
6f794328 RK |
785 | // public function appendInputSearch($name, $maxlength, $size, [$id], [$value]) |
786 | // appends an ExtendedDocument::createElementInputSearch() as a child of this element (see there for params) | |
787 | // returns the new child | |
788 | // | |
f925e4a1 RK |
789 | // public function appendInputUrl($name, $maxlength, $size, [$id], [$value]) |
790 | // appends an ExtendedDocument::createElementInputUrl() as a child of this element (see there for params) | |
791 | // returns the new child | |
792 | // | |
ea32f7e5 RK |
793 | // public function appendInputEmail($name, $maxlength, $size, [$id], [$value]) |
794 | // appends an ExtendedDocument::createElementInputEmail() as a child of this element (see there for params) | |
795 | // returns the new child | |
796 | // | |
f925e4a1 RK |
797 | // public function appendInputTel($name, $maxlength, $size, [$id], [$value]) |
798 | // appends an ExtendedDocument::createElementInputTel() as a child of this element (see there for params) | |
799 | // returns the new child | |
800 | // | |
801 | // public function appendInputDate($name, [$id], [$min], [$max], [$value]) | |
802 | // appends an ExtendedDocument::createElementInputDate() as a child of this element (see there for params) | |
803 | // returns the new child | |
804 | // | |
805 | // public function appendInputTime($name, [$id], [$min], [$max], [$value]) | |
806 | // appends an ExtendedDocument::createElementInputTime() as a child of this element (see there for params) | |
645a7eb6 RK |
807 | // returns the new child |
808 | // | |
f925e4a1 RK |
809 | // public function appendInputColor($name, [$id], [$value]) |
810 | // appends an ExtendedDocument::createElementInputColor() as a child of this element (see there for params) | |
811 | // | |
61cc8aa9 | 812 | // public function appendInputRadio($name, $id, $value, $checked) |
ae41c41b RK |
813 | // appends an ExtendedDocument::createElementInputRadio() as a child of this element (see there for params) |
814 | // returns the new child | |
815 | // | |
61cc8aa9 | 816 | // public function appendInputCheckbox($name, $id, $value, $checked) |
ae41c41b RK |
817 | // appends an ExtendedDocument::createElementInputCheckbox() as a child of this element (see there for params) |
818 | // returns the new child | |
819 | // | |
61cc8aa9 | 820 | // public function appendInputFile($name, $id, $accept) |
4bb9d784 RK |
821 | // appends an ExtendedDocument::createElementInputFile() as a child of this element (see there for params) |
822 | // returns the new child | |
823 | // | |
61cc8aa9 | 824 | // public function appendInputSubmit($value) |
ae41c41b RK |
825 | // appends an ExtendedDocument::createElementInputSubmit() as a child of this element (see there for params) |
826 | // returns the new child | |
827 | // | |
61cc8aa9 | 828 | // public function appendButton($value, $onclick = null) |
1109f526 RK |
829 | // appends an ExtendedDocument::createElementButton() as a child of this element (see there for params) |
830 | // returns the new child | |
831 | // | |
61cc8aa9 | 832 | // public function appendTextArea($name, $columns, $rows, [$id], [$value]) |
bf91764c RK |
833 | // appends an ExtendedDocument::createElementTextArea() as a child of this element (see there for params) |
834 | // returns the new child | |
835 | // | |
69409ddb | 836 | // public function appendElementSelect($name, [$id], [$options], [$default], [$strictmatch]) |
bf91764c RK |
837 | // appends an ExtendedDocument::createElementSelect() as a child of this element (see there for params) |
838 | // returns the new child | |
839 | // | |
61cc8aa9 | 840 | // public function appendElementOption($key, $desc, [$selected]) |
bf91764c RK |
841 | // appends an ExtendedDocument::createElementOption() as a child of this element (see there for params) |
842 | // returns the new child | |
843 | // | |
61cc8aa9 | 844 | // public function appendLabel($for_id, $value) |
ae41c41b RK |
845 | // appends an ExtendedDocument::createElementLabel() as a child of this element (see there for params) |
846 | // returns the new child | |
847 | // | |
c79be4c2 RK |
848 | // public function appendElementDatalist([$id], [$options]) |
849 | // appends an ExtendedDocument::createElementDatalist() as a child of this element (see there for params) | |
850 | // returns the new child | |
851 | // | |
61cc8aa9 | 852 | // public function appendText($text) |
cea5b93a RK |
853 | // appends a DOMDocument::createTextNode() as a child of this element (see there for params) |
854 | // returns the new child | |
855 | // | |
71771b0c RK |
856 | // public function appendLinebreak() |
857 | // appends a <br> as a child of this element | |
858 | // returns the new child | |
859 | // | |
6638efd5 RK |
860 | // public function appendEntity($name) |
861 | // appends a DOMDocument::createEntityReference() as a child of this element (see there for params) | |
862 | // returns the new child | |
863 | // | |
61cc8aa9 | 864 | // public function appendComment($comment_data) |
cadc5980 RK |
865 | // appends a DOMDocument::createComment() as a child of this element (see there for params) |
866 | // returns the new child | |
867 | // | |
3d4db013 RK |
868 | // public function appendClonedElement($dom_element, [$deep]) |
869 | // appends a clone of the given DOMElement as a child of this element | |
870 | // the boolean $deep specifies if the children are cloned as well (defaults to TRUE) | |
871 | // returns the new child | |
872 | // | |
61cc8aa9 | 873 | // public function appendHTMLMarkup($htmldata) |
ae41c41b RK |
874 | // appends a representation of the HTML data as children of this element |
875 | // NO return value! | |
876 | // | |
61cc8aa9 | 877 | // public function appendXMLMarkup($xmldata) |
ae41c41b | 878 | // appends a representation of the XML data as children of this element |
cea5b93a RK |
879 | // NO return value! |
880 | // | |
acaa2daa RK |
881 | // public function appendStyleElement($styledata) |
882 | // appends an ExtendedDocument::createElementStyle() as a child of this element (see there for params) | |
883 | // returns the new child | |
884 | // | |
61cc8aa9 | 885 | // public function appendJSElement($jsdata) |
cea5b93a | 886 | // appends an ExtendedDocument::createElementJS() as a child of this element (see there for params) |
3d4db013 | 887 | // returns the new child |
c1666e91 | 888 | // |
8afa2e61 | 889 | // public function appendJSFile($jsURL, [$defer], [$async]) |
0bbc241e | 890 | // appends an ExtendedDocument::createElementJSFile() as a child of this element (see there for params) |
ea32f7e5 | 891 | // returns the new child |
f887cdcb RK |
892 | // |
893 | // public function setClass($classname) | |
894 | // sets the 'class' attribute of the element to the given classname value | |
895 | // | |
896 | // public function addClass($classname) | |
897 | // adds the given classname value to the space-separated list in the 'class' attribute | |
898 | // returns the value of the 'class' attribute | |
899 | // | |
900 | // public function setID($elem_id) | |
901 | // sets the 'id' attribute of the element to the given elem_id value | |
cea5b93a | 902 | |
61cc8aa9 | 903 | public function appendElement($name, $value = '') { |
a8816f43 | 904 | return $this->appendChild($this->ownerDocument->createElement($name, $value)); |
cea5b93a | 905 | } |
61cc8aa9 | 906 | public function appendElementXML($name, $xmldata) { |
cea5b93a | 907 | $aelem = $this->appendChild($this->ownerDocument->createElement($name)); |
ae41c41b | 908 | $aelem->appendXMLMarkup($xmldata); |
cea5b93a RK |
909 | return $aelem; |
910 | } | |
b3cc0fef RK |
911 | public function appendLink($target, $value = '', $title = null) { |
912 | return $this->appendChild($this->ownerDocument->createElementLink($target, $value, $title)); | |
cea5b93a | 913 | } |
61cc8aa9 | 914 | public function appendImage($src, $alt_text = '') { |
53510e9e RK |
915 | return $this->appendChild($this->ownerDocument->createElementImage($src, $alt_text)); |
916 | } | |
61cc8aa9 | 917 | public function appendForm($action, $method, $name, $id = null) { |
b8d16837 RK |
918 | return $this->appendChild($this->ownerDocument->createElementForm($action, $method, $name, $id)); |
919 | } | |
61cc8aa9 | 920 | public function appendFormDiv($action, $method, $name, $id = null) { |
b8d16837 | 921 | $formelem = $this->appendChild($this->ownerDocument->createElementForm($action, $method, $name, $id)); |
ae41c41b RK |
922 | return $formelem->appendElement('div'); |
923 | } | |
61cc8aa9 | 924 | public function appendInputHidden($name, $value) { |
ae41c41b RK |
925 | return $this->appendChild($this->ownerDocument->createElementInputHidden($name, $value)); |
926 | } | |
61cc8aa9 | 927 | public function appendInputText($name, $maxlength, $size, $id = null, $value = null) { |
ae41c41b RK |
928 | return $this->appendChild($this->ownerDocument->createElementInputText($name, $maxlength, $size, $id, $value)); |
929 | } | |
f925e4a1 RK |
930 | public function appendInputPassword($name, $maxlength, $size, $id = null, $value = null) { |
931 | return $this->appendChild($this->ownerDocument->createElementInputPassword($name, $maxlength, $size, $id, $value)); | |
932 | } | |
61cc8aa9 | 933 | public function appendInputNumber($name, $maxlength, $size, $id = null, $value = null) { |
262e0bbb RK |
934 | return $this->appendChild($this->ownerDocument->createElementInputNumber($name, $maxlength, $size, $id, $value)); |
935 | } | |
f925e4a1 RK |
936 | public function appendInputRange($name, $id, $min, $max, $step = null, $value = null) { |
937 | return $this->appendChild($this->ownerDocument->createElementInputRange($name, $id, $min, $max, $step, $value)); | |
938 | } | |
6f794328 RK |
939 | public function appendInputSearch($name, $maxlength, $size, $id = null, $value = null) { |
940 | return $this->appendChild($this->ownerDocument->createElementInputSearch($name, $maxlength, $size, $id, $value)); | |
941 | } | |
f925e4a1 RK |
942 | public function appendInputUrl($name, $maxlength, $size, $id = null, $value = null) { |
943 | return $this->appendChild($this->ownerDocument->createElementInputUrl($name, $maxlength, $size, $id, $value)); | |
944 | } | |
ea32f7e5 RK |
945 | public function appendInputEmail($name, $maxlength, $size, $id = null, $value = null) { |
946 | return $this->appendChild($this->ownerDocument->createElementInputEmail($name, $maxlength, $size, $id, $value)); | |
947 | } | |
f925e4a1 RK |
948 | public function appendInputTel($name, $maxlength, $size, $id = null, $value = null) { |
949 | return $this->appendChild($this->ownerDocument->createElementInputTel($name, $maxlength, $size, $id, $value)); | |
950 | } | |
951 | public function appendInputDate($name, $id = null, $min = null, $max = null, $value = null) { | |
952 | return $this->appendChild($this->ownerDocument->createElementInputDate($name, $id, $min, $max, $value)); | |
953 | } | |
954 | public function appendInputTime($name, $id = null, $min = null, $max = null, $value = null) { | |
955 | return $this->appendChild($this->ownerDocument->createElementInputTime($name, $id, $min, $max, $value)); | |
956 | } | |
957 | public function appendInputColor($name, $id = null, $value = null) { | |
958 | return $this->appendChild($this->ownerDocument->createElementInputColor($name, $id, $value)); | |
645a7eb6 | 959 | } |
61cc8aa9 | 960 | public function appendInputRadio($name, $id, $value, $checked) { |
ae41c41b RK |
961 | return $this->appendChild($this->ownerDocument->createElementInputRadio($name, $id, $value, $checked)); |
962 | } | |
61cc8aa9 | 963 | public function appendInputCheckbox($name, $id, $value, $checked) { |
ae41c41b RK |
964 | return $this->appendChild($this->ownerDocument->createElementInputCheckbox($name, $id, $value, $checked)); |
965 | } | |
61cc8aa9 | 966 | public function appendInputFile($name, $id, $accept) { |
4bb9d784 RK |
967 | return $this->appendChild($this->ownerDocument->createElementInputFile($name, $id, $accept)); |
968 | } | |
61cc8aa9 | 969 | public function appendInputSubmit($value) { |
ae41c41b RK |
970 | return $this->appendChild($this->ownerDocument->createElementInputSubmit($value)); |
971 | } | |
61cc8aa9 | 972 | public function appendButton($value, $onclick = null) { |
1109f526 RK |
973 | return $this->appendChild($this->ownerDocument->createElementButton($value, $onclick)); |
974 | } | |
61cc8aa9 | 975 | public function appendTextArea($name, $columns, $rows, $id = null, $value = null) { |
bf91764c RK |
976 | return $this->appendChild($this->ownerDocument->createElementTextArea($name, $columns, $rows, $id, $value)); |
977 | } | |
69409ddb RK |
978 | public function appendElementSelect($name, $id = null, $options = array(), $default = null, $strictmatch = false) { |
979 | return $this->appendChild($this->ownerDocument->createElementSelect($name, $id, $options, $default, $strictmatch)); | |
bf91764c | 980 | } |
61cc8aa9 | 981 | public function appendElementOption($key, $desc, $selected = false) { |
bf91764c RK |
982 | return $this->appendChild($this->ownerDocument->createElementOption($key, $desc, $selected)); |
983 | } | |
61cc8aa9 | 984 | public function appendLabel($for_id, $value) { |
bf91764c RK |
985 | return $this->appendChild($this->ownerDocument->createElementLabel($for_id, $value)); |
986 | } | |
c79be4c2 RK |
987 | public function appendElementDatalist($id = null, $options = array()) { |
988 | return $this->appendChild($this->ownerDocument->createElementDatalist($id, $options)); | |
989 | } | |
61cc8aa9 | 990 | public function appendText($text) { |
c79be4c2 | 991 | return $this->appendChild($this->ownerDocument->createTextNode($text ?? '')); |
bf91764c | 992 | } |
71771b0c RK |
993 | public function appendLinebreak() { |
994 | return $this->appendChild($this->ownerDocument->createElement('br')); | |
995 | } | |
6638efd5 RK |
996 | public function appendEntity($name) { |
997 | return $this->appendChild($this->ownerDocument->createEntityReference($name)); | |
998 | } | |
61cc8aa9 | 999 | public function appendComment($comment_data) { |
cadc5980 RK |
1000 | return $this->appendChild($this->ownerDocument->createComment($comment_data)); |
1001 | } | |
3d4db013 RK |
1002 | public function appendClonedElement($dom_element, $deep = true) { |
1003 | return $this->appendChild($dom_element->cloneNode($deep)); | |
1004 | } | |
61cc8aa9 | 1005 | public function appendHTMLMarkup($htmldata) { |
bf91764c RK |
1006 | $this->ownerDocument->appendHTMLMarkup($htmldata, $this); |
1007 | } | |
61cc8aa9 | 1008 | public function appendXMLMarkup($xmldata) { |
bf91764c RK |
1009 | $this->ownerDocument->appendXMLMarkup($xmldata, $this); |
1010 | } | |
acaa2daa RK |
1011 | public function appendStyleElement($styledata) { |
1012 | return $this->appendChild($this->ownerDocument->createElementStyle($styledata)); | |
1013 | } | |
61cc8aa9 | 1014 | public function appendJSElement($jsdata) { |
3d4db013 | 1015 | return $this->appendChild($this->ownerDocument->createElementJS($jsdata)); |
bf91764c | 1016 | } |
1a4ee0f0 RK |
1017 | public function appendJSFile($jsURL, $defer = false, $async = false) { |
1018 | return $this->appendChild($this->ownerDocument->createElementJSFile($jsURL, $defer, $async)); | |
ea32f7e5 | 1019 | } |
f887cdcb RK |
1020 | public function setClass($classname) { |
1021 | $this->setAttribute('class', $classname); | |
1022 | } | |
1023 | public function addClass($classname) { | |
1024 | $classval = $this->getAttribute('class'); | |
1025 | if (strlen($classval)) { $classval .= ' '; } | |
1026 | $classval .= $classname; | |
1027 | $this->setClass($classval); | |
1028 | return $classval; | |
1029 | } | |
1030 | public function setID($elem_id) { | |
1031 | $this->setAttribute('id', $elem_id); | |
1032 | } | |
bf91764c RK |
1033 | } |
1034 | ||
1035 | class ExtendedDocumentFragment extends DOMDocumentFragment { | |
1036 | // ExtendedDocumentFragment PHP class | |
1037 | // this extends the general PHP DOM Document Fragment class to simplify some usual constructs | |
1038 | // | |
61cc8aa9 | 1039 | // public function appendElement($name, [$value]) |
bf91764c RK |
1040 | // appends a DOMDocument::createElement() as a child of this fragment (see there for params) |
1041 | // returns the new child | |
1042 | // | |
61cc8aa9 | 1043 | // public function appendElementXML($name, $xmldata) |
bf91764c RK |
1044 | // appends a DOMDocument::createElement() with the given name as a child of this fragment, |
1045 | // with an ExtendedDocument::createXMLFragment() of the given XML data inside | |
1046 | // returns the new child | |
1047 | // | |
b3cc0fef | 1048 | // public function appendLink($target, [$value], [$title]) |
bf91764c RK |
1049 | // appends an ExtendedDocument::createElementLink() as a child of this fragment (see there for params) |
1050 | // returns the new child | |
1051 | // | |
61cc8aa9 | 1052 | // public function appendImage($src, [$alt_text]) |
53510e9e RK |
1053 | // appends an ExtendedDocument::createElementImage() as a child of this document (see there for params) |
1054 | // returns the new child | |
1055 | // | |
61cc8aa9 | 1056 | // public function appendForm($action, $method, $name, [$id]) |
b8d16837 RK |
1057 | // appends an ExtendedDocument::createElementForm() as a child of this fragment (see there for params) |
1058 | // returns the new child | |
1059 | // | |
61cc8aa9 | 1060 | // public function appendFormDiv($action, $method, $name, [$id]) |
bf91764c RK |
1061 | // appends an ExtendedDocument::createElementForm() as a child of this fragment (see there for params) |
1062 | // returns an HTML <div> that is a child of the new child | |
1063 | // | |
61cc8aa9 | 1064 | // public function appendInputHidden($name, $value) |
bf91764c RK |
1065 | // appends an ExtendedDocument::createElementInputHidden() as a child of this fragment (see there for params) |
1066 | // returns the new child | |
1067 | // | |
61cc8aa9 | 1068 | // public function appendInputText($name, $maxlength, $size, [$id], [$value]) |
bf91764c RK |
1069 | // appends an ExtendedDocument::createElementInputText() as a child of this fragment (see there for params) |
1070 | // returns the new child | |
1071 | // | |
f925e4a1 RK |
1072 | // public function appendInputPassword($name, $maxlength, $size, [$id], [$value]) |
1073 | // appends an ExtendedDocument::createElementInputPassword() as a child of this fragment (see there for params) | |
1074 | // returns the new child | |
1075 | // | |
61cc8aa9 | 1076 | // public function appendInputNumber($name, $maxlength, $size, [$id], [$value]) |
262e0bbb RK |
1077 | // appends an ExtendedDocument::createElementInputNumber() as a child of this fragment (see there for params) |
1078 | // returns the new child | |
1079 | // | |
f925e4a1 RK |
1080 | // public function appendInputRange($name, $id, $min, $max, [$step], [$value]) |
1081 | // appends an ExtendedDocument::createElementInputRange() as a child of this fragment (see there for params) | |
1082 | // returns the new child | |
1083 | // | |
6f794328 RK |
1084 | // public function appendInputSearch($name, $maxlength, $size, [$id], [$value]) |
1085 | // appends an ExtendedDocument::createElementInputSearch() as a child of this fragment (see there for params) | |
1086 | // returns the new child | |
1087 | // | |
f925e4a1 RK |
1088 | // public function appendInputUrl($name, $maxlength, $size, [$id], [$value]) |
1089 | // appends an ExtendedDocument::createElementInputUrl() as a child of this fragment (see there for params) | |
1090 | // returns the new child | |
1091 | // | |
ea32f7e5 RK |
1092 | // public function appendInputEmail($name, $maxlength, $size, [$id], [$value]) |
1093 | // appends an ExtendedDocument::createElementInputEmail() as a child of this fragment (see there for params) | |
1094 | // returns the new child | |
1095 | // | |
f925e4a1 RK |
1096 | // public function appendInputTel($name, $maxlength, $size, [$id], [$value]) |
1097 | // appends an ExtendedDocument::createElementInputTel() as a child of this fragment (see there for params) | |
645a7eb6 RK |
1098 | // returns the new child |
1099 | // | |
f925e4a1 RK |
1100 | // public function appendInputDate($name, [$id], [$min], [$max], [$value]) |
1101 | // appends an ExtendedDocument::createElementInputDate() as a child of this fragment (see there for params) | |
1102 | // returns the new child | |
1103 | // | |
1104 | // public function appendInputTime($name, [$id], [$min], [$max], [$value]) | |
1105 | // appends an ExtendedDocument::createElementInputTime() as a child of this fragment (see there for params) | |
1106 | // returns the new child | |
1107 | // | |
1108 | // public function appendInputColor($name, [$id], [$value]) | |
1109 | // appends an ExtendedDocument::createElementInputColor() as a child of this fragment (see there for params) | |
1110 | // | |
61cc8aa9 | 1111 | // public function appendInputRadio($name, $id, $value, $checked) |
bf91764c RK |
1112 | // appends an ExtendedDocument::createElementInputRadio() as a child of this fragment (see there for params) |
1113 | // returns the new child | |
1114 | // | |
61cc8aa9 | 1115 | // public function appendInputCheckbox($name, $id, $value, $checked) |
bf91764c RK |
1116 | // appends an ExtendedDocument::createElementInputCheckbox() as a child of this fragment (see there for params) |
1117 | // returns the new child | |
1118 | // | |
61cc8aa9 | 1119 | // public function appendInputFile($name, $id, $accept) |
4bb9d784 RK |
1120 | // appends an ExtendedDocument::createElementInputFile() as a child of this fragment (see there for params) |
1121 | // returns the new child | |
1122 | // | |
61cc8aa9 | 1123 | // public function appendInputSubmit($value) |
bf91764c RK |
1124 | // appends an ExtendedDocument::createElementInputSubmit() as a child of this fragment (see there for params) |
1125 | // returns the new child | |
1126 | // | |
61cc8aa9 | 1127 | // public function appendButton($value, $onclick = null) |
1109f526 RK |
1128 | // appends an ExtendedDocument::createElementButton() as a child of this fragment (see there for params) |
1129 | // returns the new child | |
1130 | // | |
61cc8aa9 | 1131 | // public function appendTextArea($name, $columns, $rows, [$id], [$value]) |
bf91764c RK |
1132 | // appends an ExtendedDocument::createElementTextArea() as a child of this fragment (see there for params) |
1133 | // returns the new child | |
1134 | // | |
69409ddb | 1135 | // public function appendElementSelect($name, [$id], [$options], [$default], [$strictmatch]) |
bf91764c RK |
1136 | // appends an ExtendedDocument::createElementSelect() as a child of this fragment (see there for params) |
1137 | // returns the new child | |
1138 | // | |
61cc8aa9 | 1139 | // public function appendElementOption($key, $desc, [$selected]) |
bf91764c RK |
1140 | // appends an ExtendedDocument::createElementOption() as a child of this fragment (see there for params) |
1141 | // returns the new child | |
1142 | // | |
61cc8aa9 | 1143 | // public function appendLabel($for_id, $value) |
bf91764c RK |
1144 | // appends an ExtendedDocument::createElementLabel() as a child of this fragment (see there for params) |
1145 | // returns the new child | |
1146 | // | |
c79be4c2 RK |
1147 | // public function appendElementDatalist([$id], [$options]) |
1148 | // appends an ExtendedDocument::createElementDatalist() as a child of this fragment (see there for params) | |
1149 | // returns the new child | |
1150 | // | |
61cc8aa9 | 1151 | // public function appendText($text) |
bf91764c RK |
1152 | // appends a DOMDocument::createTextNode() as a child of this fragment (see there for params) |
1153 | // returns the new child | |
1154 | // | |
71771b0c RK |
1155 | // public function appendLinebreak() |
1156 | // appends a <br> as a child of this fragment | |
1157 | // returns the new child | |
1158 | // | |
6638efd5 RK |
1159 | // public function appendEntity($name) |
1160 | // appends a DOMDocument::createEntityReference() as a child of this fragment (see there for params) | |
1161 | // returns the new child | |
1162 | // | |
61cc8aa9 | 1163 | // public function appendComment($comment_data) |
cadc5980 RK |
1164 | // appends a DOMDocument::createComment() as a child of this fragment (see there for params) |
1165 | // returns the new child | |
1166 | // | |
3d4db013 RK |
1167 | // public function appendClonedElement($dom_element, [$deep]) |
1168 | // appends a clone of the given DOMElement as a child of this fragment | |
1169 | // the boolean $deep specifies if the children are cloned as well (defaults to TRUE) | |
1170 | // returns the new child | |
1171 | // | |
61cc8aa9 | 1172 | // public function appendHTMLMarkup($htmldata) |
bf91764c RK |
1173 | // appends a representation of the HTML data as children of this fragment |
1174 | // NO return value! | |
1175 | // | |
61cc8aa9 | 1176 | // public function appendXMLMarkup($xmldata) |
bf91764c RK |
1177 | // appends a representation of the XML data as children of this fragment |
1178 | // NO return value! | |
1179 | // | |
acaa2daa RK |
1180 | // public function appendStyleElement($styledata) |
1181 | // appends an ExtendedDocument::createElementStyle() as a child of this element (see there for params) | |
1182 | // returns the new child | |
1183 | // | |
61cc8aa9 | 1184 | // public function appendJSElement($jsdata) |
bf91764c | 1185 | // appends an ExtendedDocument::createElementJS() as a child of this fragment (see there for params) |
3d4db013 | 1186 | // returns the new child |
c1666e91 | 1187 | // |
8afa2e61 | 1188 | // public function appendJSFile($jsURL, [$defer], [$async]) |
0bbc241e | 1189 | // appends an ExtendedDocument::createElementJSFile() as a child of this fragment (see there for params) |
ea32f7e5 | 1190 | // returns the new child |
bf91764c | 1191 | |
61cc8aa9 | 1192 | public function appendElement($name, $value = '') { |
a8816f43 | 1193 | return $this->appendChild($this->ownerDocument->createElement($name, $value)); |
bf91764c | 1194 | } |
61cc8aa9 | 1195 | public function appendElementXML($name, $xmldata) { |
bf91764c RK |
1196 | $aelem = $this->appendChild($this->ownerDocument->createElement($name)); |
1197 | $aelem->appendXMLMarkup($xmldata); | |
1198 | return $aelem; | |
1199 | } | |
b3cc0fef RK |
1200 | public function appendLink($target, $value = '', $title = null) { |
1201 | return $this->appendChild($this->ownerDocument->createElementLink($target, $value, $title)); | |
bf91764c | 1202 | } |
61cc8aa9 | 1203 | public function appendImage($src, $alt_text = '') { |
53510e9e RK |
1204 | return $this->appendChild($this->ownerDocument->createElementImage($src, $alt_text)); |
1205 | } | |
61cc8aa9 | 1206 | public function appendForm($action, $method, $name, $id = null) { |
b8d16837 RK |
1207 | return $this->appendChild($this->ownerDocument->createElementForm($action, $method, $name, $id)); |
1208 | } | |
61cc8aa9 | 1209 | public function appendFormDiv($action, $method, $name, $id = null) { |
b8d16837 | 1210 | $formelem = $this->appendChild($this->ownerDocument->createElementForm($action, $method, $name, $id)); |
bf91764c RK |
1211 | return $formelem->appendElement('div'); |
1212 | } | |
61cc8aa9 | 1213 | public function appendInputHidden($name, $value) { |
bf91764c RK |
1214 | return $this->appendChild($this->ownerDocument->createElementInputHidden($name, $value)); |
1215 | } | |
61cc8aa9 | 1216 | public function appendInputText($name, $maxlength, $size, $id = null, $value = null) { |
bf91764c | 1217 | return $this->appendChild($this->ownerDocument->createElementInputText($name, $maxlength, $size, $id, $value)); |
645a7eb6 | 1218 | } |
f925e4a1 RK |
1219 | public function appendInputPassword($name, $maxlength, $size, $id = null, $value = null) { |
1220 | return $this->appendChild($this->ownerDocument->createElementInputPassword($name, $maxlength, $size, $id, $value)); | |
1221 | } | |
61cc8aa9 | 1222 | public function appendInputNumber($name, $maxlength, $size, $id = null, $value = null) { |
262e0bbb RK |
1223 | return $this->appendChild($this->ownerDocument->createElementInputNumber($name, $maxlength, $size, $id, $value)); |
1224 | } | |
f925e4a1 RK |
1225 | public function appendInputRange($name, $id, $min, $max, $step = null, $value = null) { |
1226 | return $this->appendChild($this->ownerDocument->createElementInputRange($name, $id, $min, $max, $step, $value)); | |
1227 | } | |
6f794328 RK |
1228 | public function appendInputSearch($name, $maxlength, $size, $id = null, $value = null) { |
1229 | return $this->appendChild($this->ownerDocument->createElementInputSearch($name, $maxlength, $size, $id, $value)); | |
1230 | } | |
f925e4a1 RK |
1231 | public function appendInputUrl($name, $maxlength, $size, $id = null, $value = null) { |
1232 | return $this->appendChild($this->ownerDocument->createElementInputUrl($name, $maxlength, $size, $id, $value)); | |
1233 | } | |
ea32f7e5 RK |
1234 | public function appendInputEmail($name, $maxlength, $size, $id = null, $value = null) { |
1235 | return $this->appendChild($this->ownerDocument->createElementInputEmail($name, $maxlength, $size, $id, $value)); | |
1236 | } | |
f925e4a1 RK |
1237 | public function appendInputTel($name, $maxlength, $size, $id = null, $value = null) { |
1238 | return $this->appendChild($this->ownerDocument->createElementInputTel($name, $maxlength, $size, $id, $value)); | |
1239 | } | |
1240 | public function appendInputDate($name, $id = null, $min = null, $max = null, $value = null) { | |
1241 | return $this->appendChild($this->ownerDocument->createElementInputDate($name, $id, $min, $max, $value)); | |
1242 | } | |
1243 | public function appendInputTime($name, $id = null, $min = null, $max = null, $value = null) { | |
1244 | return $this->appendChild($this->ownerDocument->createElementInputTime($name, $id, $min, $max, $value)); | |
1245 | } | |
1246 | public function appendInputColor($name, $id = null, $value = null) { | |
1247 | return $this->appendChild($this->ownerDocument->createElementInputColor($name, $id, $value)); | |
bf91764c | 1248 | } |
61cc8aa9 | 1249 | public function appendInputRadio($name, $id, $value, $checked) { |
bf91764c RK |
1250 | return $this->appendChild($this->ownerDocument->createElementInputRadio($name, $id, $value, $checked)); |
1251 | } | |
61cc8aa9 | 1252 | public function appendInputCheckbox($name, $id, $value, $checked) { |
bf91764c RK |
1253 | return $this->appendChild($this->ownerDocument->createElementInputCheckbox($name, $id, $value, $checked)); |
1254 | } | |
61cc8aa9 | 1255 | public function appendInputFile($name, $id, $accept) { |
4bb9d784 RK |
1256 | return $this->appendChild($this->ownerDocument->createElementInputFile($name, $id, $accept)); |
1257 | } | |
61cc8aa9 | 1258 | public function appendInputSubmit($value) { |
bf91764c RK |
1259 | return $this->appendChild($this->ownerDocument->createElementInputSubmit($value)); |
1260 | } | |
61cc8aa9 | 1261 | public function appendButton($value, $onclick = null) { |
1109f526 RK |
1262 | return $this->appendChild($this->ownerDocument->createElementButton($value, $onclick)); |
1263 | } | |
61cc8aa9 | 1264 | public function appendTextArea($name, $columns, $rows, $id = null, $value = null) { |
bf91764c RK |
1265 | return $this->appendChild($this->ownerDocument->createElementTextArea($name, $columns, $rows, $id, $value)); |
1266 | } | |
69409ddb RK |
1267 | public function appendElementSelect($name, $id = null, $options = array(), $default = null, $strictmatch = false) { |
1268 | return $this->appendChild($this->ownerDocument->createElementSelect($name, $id, $options, $default, $strictmatch)); | |
bf91764c | 1269 | } |
61cc8aa9 | 1270 | public function appendElementOption($key, $desc, $selected = false) { |
bf91764c RK |
1271 | return $this->appendChild($this->ownerDocument->createElementOption($key, $desc, $selected)); |
1272 | } | |
61cc8aa9 | 1273 | public function appendLabel($for_id, $value) { |
ae41c41b RK |
1274 | return $this->appendChild($this->ownerDocument->createElementLabel($for_id, $value)); |
1275 | } | |
c79be4c2 RK |
1276 | public function appendElementDatalist($id = null, $options = array()) { |
1277 | return $this->appendChild($this->ownerDocument->createElementDatalist($id, $options)); | |
1278 | } | |
61cc8aa9 | 1279 | public function appendText($text) { |
cea5b93a RK |
1280 | return $this->appendChild($this->ownerDocument->createTextNode($text)); |
1281 | } | |
71771b0c RK |
1282 | public function appendLinebreak() { |
1283 | return $this->appendChild($this->ownerDocument->createElement('br')); | |
1284 | } | |
6638efd5 RK |
1285 | public function appendEntity($name) { |
1286 | return $this->appendChild($this->ownerDocument->createEntityReference($name)); | |
1287 | } | |
61cc8aa9 | 1288 | public function appendComment($comment_data) { |
cadc5980 RK |
1289 | return $this->appendChild($this->ownerDocument->createComment($comment_data)); |
1290 | } | |
3d4db013 RK |
1291 | public function appendClonedElement($dom_element, $deep = true) { |
1292 | return $this->appendChild($dom_element->cloneNode($deep)); | |
1293 | } | |
61cc8aa9 | 1294 | public function appendHTMLMarkup($htmldata) { |
ae41c41b RK |
1295 | $this->ownerDocument->appendHTMLMarkup($htmldata, $this); |
1296 | } | |
61cc8aa9 | 1297 | public function appendXMLMarkup($xmldata) { |
ae41c41b | 1298 | $this->ownerDocument->appendXMLMarkup($xmldata, $this); |
cea5b93a | 1299 | } |
acaa2daa RK |
1300 | public function appendStyleElement($styledata) { |
1301 | return $this->appendChild($this->ownerDocument->createElementStyle($styledata)); | |
1302 | } | |
61cc8aa9 | 1303 | public function appendJSElement($jsdata) { |
3d4db013 | 1304 | return $this->appendChild($this->ownerDocument->createElementJS($jsdata)); |
cea5b93a | 1305 | } |
1a4ee0f0 RK |
1306 | public function appendJSFile($jsURL, $defer = false, $async = false) { |
1307 | return $this->appendChild($this->ownerDocument->createElementJSFile($jsURL, $defer, $async)); | |
ea32f7e5 | 1308 | } |
cea5b93a RK |
1309 | } |
1310 | ?> |