|
1
|
|
|
<?php |
|
2
|
|
|
/** |
|
3
|
|
|
* This file is part of Peachy MediaWiki Bot API |
|
4
|
|
|
* |
|
5
|
|
|
* Peachy is free software: you can redistribute it and/or modify |
|
6
|
|
|
* it under the terms of the GNU General Public License as published by |
|
7
|
|
|
* the Free Software Foundation, either version 3 of the License, or |
|
8
|
|
|
* (at your option) any later version. |
|
9
|
|
|
* |
|
10
|
|
|
* This program is distributed in the hope that it will be useful, |
|
11
|
|
|
* but WITHOUT ANY WARRANTY; without even the implied warranty of |
|
12
|
|
|
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the |
|
13
|
|
|
* GNU General Public License for more details. |
|
14
|
|
|
* |
|
15
|
|
|
* You should have received a copy of the GNU General Public License |
|
16
|
|
|
* along with this program. If not, see <http://www.gnu.org/licenses/>. |
|
17
|
|
|
*/ |
|
18
|
|
|
|
|
19
|
|
|
/** |
|
20
|
|
|
* Module of static functions for generating XML |
|
21
|
|
|
*/ |
|
22
|
|
|
class Xml { |
|
23
|
|
|
/** |
|
24
|
|
|
* Format an XML element with given attributes and, optionally, text content. |
|
25
|
|
|
* Element and attribute names are assumed to be ready for literal inclusion. |
|
26
|
|
|
* Strings are assumed to not contain XML-illegal characters; special |
|
27
|
|
|
* characters (<, >, &) are escaped but illegals are not touched. |
|
28
|
|
|
* |
|
29
|
|
|
* @param string|null $element element name |
|
30
|
|
|
* @param array $attribs Name=>value pairs. Values will be escaped. |
|
31
|
|
|
* @param string $contents NULL to make an open tag only; '' for a contentless closed tag (default) |
|
32
|
|
|
* @param bool $allowShortTag whether '' in $contents will result in a contentless closed tag |
|
33
|
|
|
* @return string |
|
34
|
|
|
*/ |
|
35
|
|
|
public static function element( $element = null, $attribs = null, $contents = '', $allowShortTag = true ) { |
|
36
|
|
|
$out = '<' . $element; |
|
37
|
|
|
if( !is_null( $attribs ) ) { |
|
38
|
|
|
$out .= self::expandAttributes( $attribs ); |
|
39
|
|
|
} |
|
40
|
|
|
if( is_null( $contents ) ) { |
|
41
|
|
|
$out .= '>'; |
|
42
|
|
|
} else { |
|
43
|
|
|
if( $allowShortTag && $contents === '' ) { |
|
44
|
|
|
$out .= ' />'; |
|
45
|
|
|
} else { |
|
46
|
|
|
$out .= '>' . htmlspecialchars( $contents ) . "</$element>"; |
|
47
|
|
|
} |
|
48
|
|
|
} |
|
49
|
|
|
return $out; |
|
50
|
|
|
} |
|
51
|
|
|
|
|
52
|
|
|
static function encodeAttribute( $text ) { |
|
|
|
|
|
|
53
|
|
|
$encValue = htmlspecialchars( $text, ENT_QUOTES ); |
|
54
|
|
|
|
|
55
|
|
|
// Whitespace is normalized during attribute decoding, |
|
56
|
|
|
// so if we've been passed non-spaces we must encode them |
|
57
|
|
|
// ahead of time or they won't be preserved. |
|
58
|
|
|
$encValue = strtr( |
|
59
|
|
|
$encValue, array( |
|
60
|
|
|
"\n" => ' ', |
|
61
|
|
|
"\r" => ' ', |
|
62
|
|
|
"\t" => '	', |
|
63
|
|
|
) |
|
64
|
|
|
); |
|
65
|
|
|
|
|
66
|
|
|
return $encValue; |
|
67
|
|
|
} |
|
68
|
|
|
|
|
69
|
|
|
/** |
|
70
|
|
|
* Given an array of ('attributename' => 'value'), it generates the code |
|
71
|
|
|
* to set the XML attributes : attributename="value". |
|
72
|
|
|
* The values are passed to self::encodeAttribute. |
|
73
|
|
|
* Return null if no attributes given. |
|
74
|
|
|
* @param array|null $attribs of attributes for an XML element |
|
75
|
|
|
* @throws Exception |
|
76
|
|
|
* @return null|string |
|
77
|
|
|
*/ |
|
78
|
|
|
public static function expandAttributes( $attribs = null ) { |
|
79
|
|
|
$out = ''; |
|
80
|
|
|
if( is_null( $attribs ) ) { |
|
81
|
|
|
return null; |
|
82
|
|
|
} elseif( is_array( $attribs ) ) { |
|
83
|
|
|
foreach( $attribs as $name => $val ){ |
|
84
|
|
|
$out .= " {$name}=\"" . self::encodeAttribute( $val ) . '"'; |
|
85
|
|
|
} |
|
86
|
|
|
return $out; |
|
87
|
|
|
} else { |
|
88
|
|
|
throw new Exception( 'Expected attribute array, got something else in ' . __METHOD__ ); |
|
89
|
|
|
} |
|
90
|
|
|
} |
|
91
|
|
|
|
|
92
|
|
|
/** |
|
93
|
|
|
* Format an XML element as with self::element(), but run text through the |
|
94
|
|
|
* $wgContLang->normalize() validator first to ensure that no invalid UTF-8 |
|
95
|
|
|
* is passed. |
|
96
|
|
|
* |
|
97
|
|
|
* @param $element String: |
|
98
|
|
|
* @param array $attribs Name=>value pairs. Values will be escaped. |
|
99
|
|
|
* @param string $contents NULL to make an open tag only; '' for a contentless closed tag (default) |
|
100
|
|
|
* @return string |
|
101
|
|
|
*/ |
|
102
|
|
|
public static function elementClean( $element, $attribs = array(), $contents = '' ) { |
|
103
|
|
|
if( $attribs ) { |
|
|
|
|
|
|
104
|
|
|
$attribs = array_map( array( 'UtfNormal', 'cleanUp' ), $attribs ); |
|
105
|
|
|
} |
|
106
|
|
|
if( $contents ) { |
|
107
|
|
|
$contents = WebRequest::normalize_static( $contents ); |
|
108
|
|
|
} |
|
109
|
|
|
return self::element( $element, $attribs, $contents ); |
|
110
|
|
|
} |
|
111
|
|
|
|
|
112
|
|
|
/** |
|
113
|
|
|
* This opens an XML element |
|
114
|
|
|
* |
|
115
|
|
|
* @param string $element name of the element |
|
116
|
|
|
* @param array $attribs of attributes, see self::expandAttributes() |
|
117
|
|
|
* @return string |
|
118
|
|
|
*/ |
|
119
|
|
|
public static function openElement( $element, $attribs = null ) { |
|
120
|
|
|
return '<' . $element . self::expandAttributes( $attribs ) . '>'; |
|
121
|
|
|
} |
|
122
|
|
|
|
|
123
|
|
|
/** |
|
124
|
|
|
* Shortcut to close an XML element |
|
125
|
|
|
* @param string $element element name |
|
126
|
|
|
* @return string |
|
127
|
|
|
*/ |
|
128
|
|
|
public static function closeElement( $element ) { |
|
129
|
|
|
return "</$element>"; |
|
130
|
|
|
} |
|
131
|
|
|
|
|
132
|
|
|
/** |
|
133
|
|
|
* Same as self::element(), but does not escape contents. Handy when the |
|
134
|
|
|
* content you have is already valid xml. |
|
135
|
|
|
* |
|
136
|
|
|
* @param string $element element name |
|
137
|
|
|
* @param array $attribs of attributes |
|
138
|
|
|
* @param string $contents content of the element |
|
139
|
|
|
* @return string |
|
140
|
|
|
*/ |
|
141
|
|
|
public static function tags( $element, $attribs = null, $contents ) { |
|
142
|
|
|
return self::openElement( $element, $attribs ) . $contents . "</$element>"; |
|
143
|
|
|
} |
|
144
|
|
|
|
|
145
|
|
|
/** |
|
146
|
|
|
* Shortcut to make a span element |
|
147
|
|
|
* @param string $text content of the element, will be escaped |
|
148
|
|
|
* @param string $class class name of the span element |
|
149
|
|
|
* @param array $attribs other attributes |
|
150
|
|
|
* @return string |
|
151
|
|
|
*/ |
|
152
|
|
|
public static function span( $text, $class, $attribs = array() ) { |
|
153
|
|
|
return self::element( 'span', array( 'class' => $class ) + $attribs, $text ); |
|
154
|
|
|
} |
|
155
|
|
|
|
|
156
|
|
|
/** |
|
157
|
|
|
* Shortcut to make a specific element with a class attribute |
|
158
|
|
|
* @param string $text content of the element, will be escaped |
|
159
|
|
|
* @param string $class class name of the span element |
|
160
|
|
|
* @param string $pgTag element name |
|
161
|
|
|
* @param array $attribs other attributes |
|
162
|
|
|
* @return string |
|
163
|
|
|
*/ |
|
164
|
|
|
public static function wrapClass( $text, $class, $pgTag = 'span', $attribs = array() ) { |
|
165
|
|
|
return self::tags( $pgTag, array( 'class' => $class ) + $attribs, $text ); |
|
166
|
|
|
} |
|
167
|
|
|
|
|
168
|
|
|
/** |
|
169
|
|
|
* Convenience function to build an HTML text input field |
|
170
|
|
|
* @param string $name value of the name attribute |
|
171
|
|
|
* @param bool|int $size value of the size attribute |
|
172
|
|
|
* @param mixed $value mixed value of the value attribute |
|
173
|
|
|
* @param array $attribs other attributes |
|
174
|
|
|
* @return string HTML |
|
175
|
|
|
*/ |
|
176
|
|
|
public static function input( $name, $size = false, $value = false, $attribs = array() ) { |
|
177
|
|
|
$attributes = array( 'name' => $name ); |
|
178
|
|
|
|
|
179
|
|
|
if( $size ) { |
|
180
|
|
|
$attributes['size'] = $size; |
|
181
|
|
|
} |
|
182
|
|
|
|
|
183
|
|
|
if( $value !== false ) { // maybe 0 |
|
184
|
|
|
$attributes['value'] = $value; |
|
185
|
|
|
} |
|
186
|
|
|
|
|
187
|
|
|
return self::element( 'input', $attributes + $attribs ); |
|
188
|
|
|
} |
|
189
|
|
|
|
|
190
|
|
|
/** |
|
191
|
|
|
* Convenience function to build an HTML password input field |
|
192
|
|
|
* @param string $name value of the name attribute |
|
193
|
|
|
* @param bool|int $size value of the size attribute |
|
194
|
|
|
* @param $value mixed value of the value attribute |
|
195
|
|
|
* @param array $attribs other attributes |
|
196
|
|
|
* @return string HTML |
|
197
|
|
|
*/ |
|
198
|
|
|
public static function password( $name, $size = false, $value = false, $attribs = array() ) { |
|
199
|
|
|
return self::input( $name, $size, $value, array_merge( $attribs, array( 'type' => 'password' ) ) ); |
|
200
|
|
|
} |
|
201
|
|
|
|
|
202
|
|
|
/** |
|
203
|
|
|
* Internal function for use in checkboxes and radio buttons and such. |
|
204
|
|
|
* |
|
205
|
|
|
* @param $name string |
|
206
|
|
|
* @param $present bool |
|
207
|
|
|
* |
|
208
|
|
|
* @return array |
|
209
|
|
|
*/ |
|
210
|
|
|
public static function attrib( $name, $present = true ) { |
|
211
|
|
|
return $present ? array( $name => $name ) : array(); |
|
212
|
|
|
} |
|
213
|
|
|
|
|
214
|
|
|
/** |
|
215
|
|
|
* Convenience function to build an HTML checkbox |
|
216
|
|
|
* @param string $name value of the name attribute |
|
217
|
|
|
* @param bool $checked Whether the checkbox is checked or not |
|
218
|
|
|
* @param array $attribs other attributes |
|
219
|
|
|
* @return string HTML |
|
220
|
|
|
*/ |
|
221
|
|
|
public static function check( $name, $checked = false, $attribs = array() ) { |
|
222
|
|
|
return self::element( |
|
223
|
|
|
'input', array_merge( |
|
224
|
|
|
array( |
|
225
|
|
|
'name' => $name, |
|
226
|
|
|
'type' => 'checkbox', |
|
227
|
|
|
'value' => 1 |
|
228
|
|
|
), |
|
229
|
|
|
self::attrib( 'checked', $checked ), |
|
230
|
|
|
$attribs |
|
231
|
|
|
) |
|
232
|
|
|
); |
|
233
|
|
|
} |
|
234
|
|
|
|
|
235
|
|
|
/** |
|
236
|
|
|
* Convenience function to build an HTML radio button |
|
237
|
|
|
* @param string $name value of the name attribute |
|
238
|
|
|
* @param string $value value of the value attribute |
|
239
|
|
|
* @param bool $checked Whether the checkbox is checked or not |
|
240
|
|
|
* @param array $attribs other attributes |
|
241
|
|
|
* @return string HTML |
|
242
|
|
|
*/ |
|
243
|
|
|
public static function radio( $name, $value, $checked = false, $attribs = array() ) { |
|
244
|
|
|
return self::element( |
|
245
|
|
|
'input', array( |
|
246
|
|
|
'name' => $name, |
|
247
|
|
|
'type' => 'radio', |
|
248
|
|
|
'value' => $value |
|
249
|
|
|
) + self::attrib( 'checked', $checked ) + $attribs |
|
250
|
|
|
); |
|
251
|
|
|
} |
|
252
|
|
|
|
|
253
|
|
|
/** |
|
254
|
|
|
* Convenience function to build an HTML form label |
|
255
|
|
|
* @param string $label text of the label |
|
256
|
|
|
* @param $id |
|
257
|
|
|
* @param array $attribs an attribute array. This will usually be |
|
258
|
|
|
* the same array as is passed to the corresponding input element, |
|
259
|
|
|
* so this function will cherry-pick appropriate attributes to |
|
260
|
|
|
* apply to the label as well; only class and title are applied. |
|
261
|
|
|
* @return string HTML |
|
262
|
|
|
*/ |
|
263
|
|
|
public static function label( $label, $id, $attribs = array() ) { |
|
264
|
|
|
$a = array( 'for' => $id ); |
|
265
|
|
|
|
|
266
|
|
|
// FIXME avoid copy pasting below: |
|
267
|
|
|
if( isset( $attribs['class'] ) ) { |
|
268
|
|
|
$a['class'] = $attribs['class']; |
|
269
|
|
|
} |
|
270
|
|
|
if( isset( $attribs['title'] ) ) { |
|
271
|
|
|
$a['title'] = $attribs['title']; |
|
272
|
|
|
} |
|
273
|
|
|
|
|
274
|
|
|
return self::element( 'label', $a, $label ); |
|
275
|
|
|
} |
|
276
|
|
|
|
|
277
|
|
|
/** |
|
278
|
|
|
* Convenience function to build an HTML text input field with a label |
|
279
|
|
|
* @param string $label text of the label |
|
280
|
|
|
* @param string $name value of the name attribute |
|
281
|
|
|
* @param string $id id of the input |
|
282
|
|
|
* @param int|Bool $size value of the size attribute |
|
283
|
|
|
* @param string|Bool $value value of the value attribute |
|
284
|
|
|
* @param array $attribs other attributes |
|
285
|
|
|
* @return string HTML |
|
286
|
|
|
*/ |
|
287
|
|
|
public static function inputLabel( $label, $name, $id, $size = false, $value = false, $attribs = array() ) { |
|
288
|
|
|
list( $label, $input ) = self::inputLabelSep( $label, $name, $id, $size, $value, $attribs ); |
|
|
|
|
|
|
289
|
|
|
return $label . ' ' . $input; |
|
290
|
|
|
} |
|
291
|
|
|
|
|
292
|
|
|
/** |
|
293
|
|
|
* Same as self::inputLabel() but return input and label in an array |
|
294
|
|
|
* |
|
295
|
|
|
* @param $label String |
|
296
|
|
|
* @param $name String |
|
297
|
|
|
* @param $id String |
|
298
|
|
|
* @param $size Int|Bool |
|
299
|
|
|
* @param $value String|Bool |
|
300
|
|
|
* @param $attribs array |
|
301
|
|
|
* |
|
302
|
|
|
* @return array |
|
303
|
|
|
*/ |
|
304
|
|
|
public static function inputLabelSep( $label, $name, $id, $size = false, $value = false, $attribs = array() ) { |
|
305
|
|
|
return array( |
|
306
|
|
|
self::label( $label, $id, $attribs ), |
|
307
|
|
|
self::input( $name, $size, $value, array( 'id' => $id ) + $attribs ) |
|
308
|
|
|
); |
|
309
|
|
|
} |
|
310
|
|
|
|
|
311
|
|
|
/** |
|
312
|
|
|
* Convenience function to build an HTML checkbox with a label |
|
313
|
|
|
* |
|
314
|
|
|
* @param $label |
|
315
|
|
|
* @param $name |
|
316
|
|
|
* @param $id |
|
317
|
|
|
* @param $checked bool |
|
318
|
|
|
* @param $attribs array |
|
319
|
|
|
* |
|
320
|
|
|
* @return string HTML |
|
321
|
|
|
*/ |
|
322
|
|
|
public static function checkLabel( $label, $name, $id, $checked = false, $attribs = array() ) { |
|
323
|
|
|
return self::check( $name, $checked, array( 'id' => $id ) + $attribs ) . |
|
324
|
|
|
' ' . |
|
325
|
|
|
self::label( $label, $id, $attribs ); |
|
326
|
|
|
} |
|
327
|
|
|
|
|
328
|
|
|
/** |
|
329
|
|
|
* Convenience function to build an HTML radio button with a label |
|
330
|
|
|
* |
|
331
|
|
|
* @param $label |
|
332
|
|
|
* @param $name |
|
333
|
|
|
* @param $value |
|
334
|
|
|
* @param $id |
|
335
|
|
|
* @param $checked bool |
|
336
|
|
|
* @param $attribs array |
|
337
|
|
|
* |
|
338
|
|
|
* @return string HTML |
|
339
|
|
|
*/ |
|
340
|
|
|
public static function radioLabel( $label, $name, $value, $id, $checked = false, $attribs = array() ) { |
|
341
|
|
|
return self::radio( $name, $value, $checked, array( 'id' => $id ) + $attribs ) . |
|
342
|
|
|
' ' . |
|
343
|
|
|
self::label( $label, $id, $attribs ); |
|
344
|
|
|
} |
|
345
|
|
|
|
|
346
|
|
|
/** |
|
347
|
|
|
* Convenience function to build an HTML submit button |
|
348
|
|
|
* @param string $value label text for the button |
|
349
|
|
|
* @param array $attribs optional custom attributes |
|
350
|
|
|
* @return string HTML |
|
351
|
|
|
*/ |
|
352
|
|
|
public static function submitButton( $value, $attribs = array() ) { |
|
353
|
|
|
return self::element( 'input', array( 'type' => 'submit', 'value' => $value ) + $attribs ); |
|
354
|
|
|
} |
|
355
|
|
|
|
|
356
|
|
|
/** |
|
357
|
|
|
* Convenience function to build an HTML drop-down list item. |
|
358
|
|
|
* @param string $text text for this item. Will be HTML escaped |
|
359
|
|
|
* @param string $value form submission value; if empty, use text |
|
360
|
|
|
* @param $selected boolean: if true, will be the default selected item |
|
361
|
|
|
* @param array $attribs optional additional HTML attributes |
|
362
|
|
|
* @return string HTML |
|
363
|
|
|
*/ |
|
364
|
|
|
public static function option( $text, $value = null, $selected = false, |
|
365
|
|
|
$attribs = array() ) { |
|
366
|
|
|
if( !is_null( $value ) ) { |
|
367
|
|
|
$attribs['value'] = $value; |
|
368
|
|
|
} |
|
369
|
|
|
if( $selected ) { |
|
370
|
|
|
$attribs['selected'] = 'selected'; |
|
371
|
|
|
} |
|
372
|
|
|
return self::element( 'option', $attribs, $text ); |
|
373
|
|
|
} |
|
374
|
|
|
|
|
375
|
|
|
/** |
|
376
|
|
|
* Build a drop-down box from a textual list. |
|
377
|
|
|
* |
|
378
|
|
|
* @param $name Mixed: Name and id for the drop-down |
|
379
|
|
|
* @param $list Mixed: Correctly formatted text (newline delimited) to be used to generate the options |
|
380
|
|
|
* @param $other Mixed: Text for the "Other reasons" option |
|
381
|
|
|
* @param $selected Mixed: Option which should be pre-selected |
|
382
|
|
|
* @param $class Mixed: CSS classes for the drop-down |
|
383
|
|
|
* @param $tabindex Mixed: Value of the tabindex attribute |
|
384
|
|
|
* @return string |
|
385
|
|
|
*/ |
|
386
|
|
|
public static function listDropDown( $name = '', $list = '', $other = '', $selected = '', $class = '', $tabindex = null ) { |
|
387
|
|
|
$optgroup = false; |
|
388
|
|
|
|
|
389
|
|
|
$options = self::option( $other, 'other', $selected === 'other' ); |
|
390
|
|
|
|
|
391
|
|
|
foreach( explode( "\n", $list ) as $option ){ |
|
392
|
|
|
$value = trim( $option ); |
|
393
|
|
|
if( $value == '' ) { |
|
394
|
|
|
continue; |
|
395
|
|
|
} elseif( substr( $value, 0, 1 ) == '*' && substr( $value, 1, 1 ) != '*' ) { |
|
396
|
|
|
// A new group is starting ... |
|
397
|
|
|
$value = trim( substr( $value, 1 ) ); |
|
398
|
|
|
if( $optgroup ) { |
|
399
|
|
|
$options .= self::closeElement( 'optgroup' ); |
|
400
|
|
|
} |
|
401
|
|
|
$options .= self::openElement( 'optgroup', array( 'label' => $value ) ); |
|
402
|
|
|
$optgroup = true; |
|
403
|
|
|
} elseif( substr( $value, 0, 2 ) == '**' ) { |
|
404
|
|
|
// groupmember |
|
405
|
|
|
$value = trim( substr( $value, 2 ) ); |
|
406
|
|
|
$options .= self::option( $value, $value, $selected === $value ); |
|
407
|
|
|
} else { |
|
408
|
|
|
// groupless reason list |
|
409
|
|
|
if( $optgroup ) { |
|
410
|
|
|
$options .= self::closeElement( 'optgroup' ); |
|
411
|
|
|
} |
|
412
|
|
|
$options .= self::option( $value, $value, $selected === $value ); |
|
413
|
|
|
$optgroup = false; |
|
414
|
|
|
} |
|
415
|
|
|
} |
|
416
|
|
|
|
|
417
|
|
|
if( $optgroup ) { |
|
418
|
|
|
$options .= self::closeElement( 'optgroup' ); |
|
419
|
|
|
} |
|
420
|
|
|
|
|
421
|
|
|
$attribs = array(); |
|
422
|
|
|
|
|
423
|
|
|
if( $name ) { |
|
424
|
|
|
$attribs['id'] = $name; |
|
425
|
|
|
$attribs['name'] = $name; |
|
426
|
|
|
} |
|
427
|
|
|
|
|
428
|
|
|
if( $class ) { |
|
429
|
|
|
$attribs['class'] = $class; |
|
430
|
|
|
} |
|
431
|
|
|
|
|
432
|
|
|
if( $tabindex ) { |
|
433
|
|
|
$attribs['tabindex'] = $tabindex; |
|
434
|
|
|
} |
|
435
|
|
|
|
|
436
|
|
|
return self::openElement( 'select', $attribs ) |
|
437
|
|
|
. "\n" |
|
438
|
|
|
. $options |
|
439
|
|
|
. "\n" |
|
440
|
|
|
. self::closeElement( 'select' ); |
|
441
|
|
|
} |
|
442
|
|
|
|
|
443
|
|
|
/** |
|
444
|
|
|
* Shortcut for creating fieldsets. |
|
445
|
|
|
* |
|
446
|
|
|
* @param string|bool $legend Legend of the fieldset. If evaluates to false, legend is not added. |
|
447
|
|
|
* @param string|bool $content Pre-escaped content for the fieldset. If false, only open fieldset is returned. |
|
448
|
|
|
* @param array $attribs Any attributes to fieldset-element. |
|
449
|
|
|
* |
|
450
|
|
|
* @return string |
|
451
|
|
|
*/ |
|
452
|
|
|
public static function fieldset( $legend = false, $content = false, $attribs = array() ) { |
|
453
|
|
|
$s = self::openElement( 'fieldset', $attribs ) . "\n"; |
|
454
|
|
|
|
|
455
|
|
|
if( $legend ) { |
|
456
|
|
|
$s .= self::element( 'legend', null, $legend ) . "\n"; |
|
|
|
|
|
|
457
|
|
|
} |
|
458
|
|
|
|
|
459
|
|
|
if( $content !== false ) { |
|
460
|
|
|
$s .= $content . "\n"; |
|
461
|
|
|
$s .= self::closeElement( 'fieldset' ) . "\n"; |
|
462
|
|
|
} |
|
463
|
|
|
|
|
464
|
|
|
return $s; |
|
465
|
|
|
} |
|
466
|
|
|
|
|
467
|
|
|
/** |
|
468
|
|
|
* Shortcut for creating textareas. |
|
469
|
|
|
* |
|
470
|
|
|
* @param string $name The 'name' for the textarea |
|
471
|
|
|
* @param string $content Content for the textarea |
|
472
|
|
|
* @param int $cols The number of columns for the textarea |
|
473
|
|
|
* @param int $rows The number of rows for the textarea |
|
474
|
|
|
* @param array $attribs Any other attributes for the textarea |
|
475
|
|
|
* |
|
476
|
|
|
* @return string |
|
477
|
|
|
*/ |
|
478
|
|
|
public static function textarea( $name, $content, $cols = 40, $rows = 5, $attribs = array() ) { |
|
479
|
|
|
return self::element( |
|
480
|
|
|
'textarea', |
|
481
|
|
|
array( |
|
482
|
|
|
'name' => $name, |
|
483
|
|
|
'id' => $name, |
|
484
|
|
|
'cols' => $cols, |
|
485
|
|
|
'rows' => $rows |
|
486
|
|
|
) + $attribs, |
|
487
|
|
|
$content, false |
|
488
|
|
|
); |
|
489
|
|
|
} |
|
490
|
|
|
|
|
491
|
|
|
/** |
|
492
|
|
|
* Returns an escaped string suitable for inclusion in a string literal |
|
493
|
|
|
* for JavaScript source code. |
|
494
|
|
|
* Illegal control characters are assumed not to be present. |
|
495
|
|
|
* |
|
496
|
|
|
* @param string $string to escape |
|
497
|
|
|
* @return String |
|
498
|
|
|
*/ |
|
499
|
|
|
public static function escapeJsString( $string ) { |
|
500
|
|
|
// See ECMA 262 section 7.8.4 for string literal format |
|
501
|
|
|
$pairs = array( |
|
502
|
|
|
"\\" => "\\\\", |
|
503
|
|
|
"\"" => "\\\"", |
|
504
|
|
|
'\'' => '\\\'', |
|
505
|
|
|
"\n" => "\\n", |
|
506
|
|
|
"\r" => "\\r", |
|
507
|
|
|
|
|
508
|
|
|
# To avoid closing the element or CDATA section |
|
509
|
|
|
"<" => "\\x3c", |
|
510
|
|
|
">" => "\\x3e", |
|
511
|
|
|
|
|
512
|
|
|
# To avoid any complaints about bad entity refs |
|
513
|
|
|
"&" => "\\x26", |
|
514
|
|
|
|
|
515
|
|
|
# Work around https://bugzilla.mozilla.org/show_bug.cgi?id=274152 |
|
516
|
|
|
# Encode certain Unicode formatting chars so affected |
|
517
|
|
|
# versions of Gecko don't misinterpret our strings; |
|
518
|
|
|
# this is a common problem with Farsi text. |
|
519
|
|
|
"\xe2\x80\x8c" => "\\u200c", // ZERO WIDTH NON-JOINER |
|
520
|
|
|
"\xe2\x80\x8d" => "\\u200d", // ZERO WIDTH JOINER |
|
521
|
|
|
); |
|
522
|
|
|
|
|
523
|
|
|
return strtr( $string, $pairs ); |
|
524
|
|
|
} |
|
525
|
|
|
|
|
526
|
|
|
/** |
|
527
|
|
|
* Encode a variable of unknown type to JavaScript. |
|
528
|
|
|
* Arrays are converted to JS arrays, objects are converted to JS associative |
|
529
|
|
|
* arrays (objects). So cast your PHP associative arrays to objects before |
|
530
|
|
|
* passing them to here. |
|
531
|
|
|
* |
|
532
|
|
|
* @param $value |
|
533
|
|
|
* @return int|string |
|
534
|
|
|
*/ |
|
535
|
|
|
public static function encodeJsVar( $value ) { |
|
536
|
|
|
if( is_bool( $value ) ) { |
|
537
|
|
|
$s = $value ? 'true' : 'false'; |
|
538
|
|
|
} elseif( is_null( $value ) ) { |
|
539
|
|
|
$s = 'null'; |
|
540
|
|
|
} elseif( is_int( $value ) ) { |
|
541
|
|
|
$s = $value; |
|
542
|
|
|
} elseif( is_array( $value ) && // Make sure it's not associative. |
|
543
|
|
|
array_keys( $value ) === range( 0, count( $value ) - 1 ) || |
|
544
|
|
|
count( $value ) == 0 |
|
545
|
|
|
) { |
|
546
|
|
|
$s = '['; |
|
547
|
|
|
foreach( $value as $elt ){ |
|
548
|
|
|
if( $s != '[' ) { |
|
549
|
|
|
$s .= ', '; |
|
550
|
|
|
} |
|
551
|
|
|
$s .= self::encodeJsVar( $elt ); |
|
552
|
|
|
} |
|
553
|
|
|
$s .= ']'; |
|
554
|
|
|
} elseif( is_object( $value ) || is_array( $value ) ) { |
|
555
|
|
|
// Objects and associative arrays |
|
556
|
|
|
$s = '{'; |
|
557
|
|
|
foreach( (array)$value as $name => $elt ){ |
|
558
|
|
|
if( $s != '{' ) { |
|
559
|
|
|
$s .= ', '; |
|
560
|
|
|
} |
|
561
|
|
|
$s .= '"' . self::escapeJsString( $name ) . '": ' . |
|
562
|
|
|
self::encodeJsVar( $elt ); |
|
563
|
|
|
} |
|
564
|
|
|
$s .= '}'; |
|
565
|
|
|
} else { |
|
566
|
|
|
$s = '"' . self::escapeJsString( $value ) . '"'; |
|
567
|
|
|
} |
|
568
|
|
|
return $s; |
|
569
|
|
|
} |
|
570
|
|
|
|
|
571
|
|
|
/** |
|
572
|
|
|
* Create a call to a JavaScript function. The supplied arguments will be |
|
573
|
|
|
* encoded using self::encodeJsVar(). |
|
574
|
|
|
* |
|
575
|
|
|
* @since 1.17 |
|
576
|
|
|
* @param string $name The name of the function to call, or a JavaScript expression |
|
577
|
|
|
* which evaluates to a function object which is called. |
|
578
|
|
|
* @param array $args The arguments to pass to the function. |
|
579
|
|
|
* @param bool $pretty If true, add non-significant whitespace to improve readability. |
|
580
|
|
|
* @return string|bool: String if successful; false upon failure |
|
|
|
|
|
|
581
|
|
|
*/ |
|
582
|
|
|
public static function encodeJsCall( $name, $args, $pretty = false ) { |
|
583
|
|
|
foreach( $args as &$arg ){ |
|
584
|
|
|
$arg = self::encodeJsVar($arg); |
|
585
|
|
|
if( $arg === false ) { |
|
586
|
|
|
return false; |
|
587
|
|
|
} |
|
588
|
|
|
} |
|
589
|
|
|
|
|
590
|
|
|
return "$name(" . ( $pretty |
|
591
|
|
|
? ( ' ' . implode( ', ', $args ) . ' ' ) |
|
592
|
|
|
: implode( ',', $args ) |
|
593
|
|
|
) . ");"; |
|
594
|
|
|
} |
|
595
|
|
|
|
|
596
|
|
|
/** |
|
597
|
|
|
* Check if a string is well-formed XML. |
|
598
|
|
|
* Must include the surrounding tag. |
|
599
|
|
|
* |
|
600
|
|
|
* @param string $text string to test. |
|
601
|
|
|
* @return bool |
|
602
|
|
|
* |
|
603
|
|
|
* @todo Error position reporting return |
|
604
|
|
|
*/ |
|
605
|
|
|
public static function isWellFormed( $text ) { |
|
606
|
|
|
$parser = xml_parser_create( "UTF-8" ); |
|
607
|
|
|
|
|
608
|
|
|
# case folding violates XML standard, turn it off |
|
609
|
|
|
xml_parser_set_option( $parser, XML_OPTION_CASE_FOLDING, false ); |
|
610
|
|
|
|
|
611
|
|
|
if( !xml_parse( $parser, $text, true ) ) { |
|
612
|
|
|
//$err = xml_error_string( xml_get_error_code( $parser ) ); |
|
613
|
|
|
//$position = xml_get_current_byte_index( $parser ); |
|
614
|
|
|
//$fragment = $this->extractFragment( $html, $position ); |
|
615
|
|
|
//$this->mXmlError = "$err at byte $position:\n$fragment"; |
|
616
|
|
|
xml_parser_free( $parser ); |
|
617
|
|
|
return false; |
|
618
|
|
|
} |
|
619
|
|
|
|
|
620
|
|
|
xml_parser_free( $parser ); |
|
621
|
|
|
|
|
622
|
|
|
return true; |
|
623
|
|
|
} |
|
624
|
|
|
|
|
625
|
|
|
/** |
|
626
|
|
|
* Check if a string is a well-formed XML fragment. |
|
627
|
|
|
* Wraps fragment in an \<html\> bit and doctype, so it can be a fragment |
|
628
|
|
|
* and can use HTML named entities. |
|
629
|
|
|
* |
|
630
|
|
|
* @param $text String: |
|
631
|
|
|
* @return bool |
|
632
|
|
|
*/ |
|
633
|
|
|
public static function isWellFormedXmlFragment( $text ) { |
|
634
|
|
|
$html = |
|
635
|
|
|
self::hackDocType() . |
|
636
|
|
|
'<html>' . |
|
637
|
|
|
$text . |
|
638
|
|
|
'</html>'; |
|
639
|
|
|
|
|
640
|
|
|
return self::isWellFormed( $html ); |
|
641
|
|
|
} |
|
642
|
|
|
|
|
643
|
|
|
static function hackDocType() { |
|
|
|
|
|
|
644
|
|
|
$wgHtmlEntities = array( |
|
645
|
|
|
'Aacute' => 193, |
|
646
|
|
|
'aacute' => 225, |
|
647
|
|
|
'Acirc' => 194, |
|
648
|
|
|
'acirc' => 226, |
|
649
|
|
|
'acute' => 180, |
|
650
|
|
|
'AElig' => 198, |
|
651
|
|
|
'aelig' => 230, |
|
652
|
|
|
'Agrave' => 192, |
|
653
|
|
|
'agrave' => 224, |
|
654
|
|
|
'alefsym' => 8501, |
|
655
|
|
|
'Alpha' => 913, |
|
656
|
|
|
'alpha' => 945, |
|
657
|
|
|
'amp' => 38, |
|
658
|
|
|
'and' => 8743, |
|
659
|
|
|
'ang' => 8736, |
|
660
|
|
|
'Aring' => 197, |
|
661
|
|
|
'aring' => 229, |
|
662
|
|
|
'asymp' => 8776, |
|
663
|
|
|
'Atilde' => 195, |
|
664
|
|
|
'atilde' => 227, |
|
665
|
|
|
'Auml' => 196, |
|
666
|
|
|
'auml' => 228, |
|
667
|
|
|
'bdquo' => 8222, |
|
668
|
|
|
'Beta' => 914, |
|
669
|
|
|
'beta' => 946, |
|
670
|
|
|
'brvbar' => 166, |
|
671
|
|
|
'bull' => 8226, |
|
672
|
|
|
'cap' => 8745, |
|
673
|
|
|
'Ccedil' => 199, |
|
674
|
|
|
'ccedil' => 231, |
|
675
|
|
|
'cedil' => 184, |
|
676
|
|
|
'cent' => 162, |
|
677
|
|
|
'Chi' => 935, |
|
678
|
|
|
'chi' => 967, |
|
679
|
|
|
'circ' => 710, |
|
680
|
|
|
'clubs' => 9827, |
|
681
|
|
|
'cong' => 8773, |
|
682
|
|
|
'copy' => 169, |
|
683
|
|
|
'crarr' => 8629, |
|
684
|
|
|
'cup' => 8746, |
|
685
|
|
|
'curren' => 164, |
|
686
|
|
|
'dagger' => 8224, |
|
687
|
|
|
'Dagger' => 8225, |
|
688
|
|
|
'darr' => 8595, |
|
689
|
|
|
'dArr' => 8659, |
|
690
|
|
|
'deg' => 176, |
|
691
|
|
|
'Delta' => 916, |
|
692
|
|
|
'delta' => 948, |
|
693
|
|
|
'diams' => 9830, |
|
694
|
|
|
'divide' => 247, |
|
695
|
|
|
'Eacute' => 201, |
|
696
|
|
|
'eacute' => 233, |
|
697
|
|
|
'Ecirc' => 202, |
|
698
|
|
|
'ecirc' => 234, |
|
699
|
|
|
'Egrave' => 200, |
|
700
|
|
|
'egrave' => 232, |
|
701
|
|
|
'empty' => 8709, |
|
702
|
|
|
'emsp' => 8195, |
|
703
|
|
|
'ensp' => 8194, |
|
704
|
|
|
'Epsilon' => 917, |
|
705
|
|
|
'epsilon' => 949, |
|
706
|
|
|
'equiv' => 8801, |
|
707
|
|
|
'Eta' => 919, |
|
708
|
|
|
'eta' => 951, |
|
709
|
|
|
'ETH' => 208, |
|
710
|
|
|
'eth' => 240, |
|
711
|
|
|
'Euml' => 203, |
|
712
|
|
|
'euml' => 235, |
|
713
|
|
|
'euro' => 8364, |
|
714
|
|
|
'exist' => 8707, |
|
715
|
|
|
'fnof' => 402, |
|
716
|
|
|
'forall' => 8704, |
|
717
|
|
|
'frac12' => 189, |
|
718
|
|
|
'frac14' => 188, |
|
719
|
|
|
'frac34' => 190, |
|
720
|
|
|
'frasl' => 8260, |
|
721
|
|
|
'Gamma' => 915, |
|
722
|
|
|
'gamma' => 947, |
|
723
|
|
|
'ge' => 8805, |
|
724
|
|
|
'gt' => 62, |
|
725
|
|
|
'harr' => 8596, |
|
726
|
|
|
'hArr' => 8660, |
|
727
|
|
|
'hearts' => 9829, |
|
728
|
|
|
'hellip' => 8230, |
|
729
|
|
|
'Iacute' => 205, |
|
730
|
|
|
'iacute' => 237, |
|
731
|
|
|
'Icirc' => 206, |
|
732
|
|
|
'icirc' => 238, |
|
733
|
|
|
'iexcl' => 161, |
|
734
|
|
|
'Igrave' => 204, |
|
735
|
|
|
'igrave' => 236, |
|
736
|
|
|
'image' => 8465, |
|
737
|
|
|
'infin' => 8734, |
|
738
|
|
|
'int' => 8747, |
|
739
|
|
|
'Iota' => 921, |
|
740
|
|
|
'iota' => 953, |
|
741
|
|
|
'iquest' => 191, |
|
742
|
|
|
'isin' => 8712, |
|
743
|
|
|
'Iuml' => 207, |
|
744
|
|
|
'iuml' => 239, |
|
745
|
|
|
'Kappa' => 922, |
|
746
|
|
|
'kappa' => 954, |
|
747
|
|
|
'Lambda' => 923, |
|
748
|
|
|
'lambda' => 955, |
|
749
|
|
|
'lang' => 9001, |
|
750
|
|
|
'laquo' => 171, |
|
751
|
|
|
'larr' => 8592, |
|
752
|
|
|
'lArr' => 8656, |
|
753
|
|
|
'lceil' => 8968, |
|
754
|
|
|
'ldquo' => 8220, |
|
755
|
|
|
'le' => 8804, |
|
756
|
|
|
'lfloor' => 8970, |
|
757
|
|
|
'lowast' => 8727, |
|
758
|
|
|
'loz' => 9674, |
|
759
|
|
|
'lrm' => 8206, |
|
760
|
|
|
'lsaquo' => 8249, |
|
761
|
|
|
'lsquo' => 8216, |
|
762
|
|
|
'lt' => 60, |
|
763
|
|
|
'macr' => 175, |
|
764
|
|
|
'mdash' => 8212, |
|
765
|
|
|
'micro' => 181, |
|
766
|
|
|
'middot' => 183, |
|
767
|
|
|
'minus' => 8722, |
|
768
|
|
|
'Mu' => 924, |
|
769
|
|
|
'mu' => 956, |
|
770
|
|
|
'nabla' => 8711, |
|
771
|
|
|
'nbsp' => 160, |
|
772
|
|
|
'ndash' => 8211, |
|
773
|
|
|
'ne' => 8800, |
|
774
|
|
|
'ni' => 8715, |
|
775
|
|
|
'not' => 172, |
|
776
|
|
|
'notin' => 8713, |
|
777
|
|
|
'nsub' => 8836, |
|
778
|
|
|
'Ntilde' => 209, |
|
779
|
|
|
'ntilde' => 241, |
|
780
|
|
|
'Nu' => 925, |
|
781
|
|
|
'nu' => 957, |
|
782
|
|
|
'Oacute' => 211, |
|
783
|
|
|
'oacute' => 243, |
|
784
|
|
|
'Ocirc' => 212, |
|
785
|
|
|
'ocirc' => 244, |
|
786
|
|
|
'OElig' => 338, |
|
787
|
|
|
'oelig' => 339, |
|
788
|
|
|
'Ograve' => 210, |
|
789
|
|
|
'ograve' => 242, |
|
790
|
|
|
'oline' => 8254, |
|
791
|
|
|
'Omega' => 937, |
|
792
|
|
|
'omega' => 969, |
|
793
|
|
|
'Omicron' => 927, |
|
794
|
|
|
'omicron' => 959, |
|
795
|
|
|
'oplus' => 8853, |
|
796
|
|
|
'or' => 8744, |
|
797
|
|
|
'ordf' => 170, |
|
798
|
|
|
'ordm' => 186, |
|
799
|
|
|
'Oslash' => 216, |
|
800
|
|
|
'oslash' => 248, |
|
801
|
|
|
'Otilde' => 213, |
|
802
|
|
|
'otilde' => 245, |
|
803
|
|
|
'otimes' => 8855, |
|
804
|
|
|
'Ouml' => 214, |
|
805
|
|
|
'ouml' => 246, |
|
806
|
|
|
'para' => 182, |
|
807
|
|
|
'part' => 8706, |
|
808
|
|
|
'permil' => 8240, |
|
809
|
|
|
'perp' => 8869, |
|
810
|
|
|
'Phi' => 934, |
|
811
|
|
|
'phi' => 966, |
|
812
|
|
|
'Pi' => 928, |
|
813
|
|
|
'pi' => 960, |
|
814
|
|
|
'piv' => 982, |
|
815
|
|
|
'plusmn' => 177, |
|
816
|
|
|
'pound' => 163, |
|
817
|
|
|
'prime' => 8242, |
|
818
|
|
|
'Prime' => 8243, |
|
819
|
|
|
'prod' => 8719, |
|
820
|
|
|
'prop' => 8733, |
|
821
|
|
|
'Psi' => 936, |
|
822
|
|
|
'psi' => 968, |
|
823
|
|
|
'quot' => 34, |
|
824
|
|
|
'radic' => 8730, |
|
825
|
|
|
'rang' => 9002, |
|
826
|
|
|
'raquo' => 187, |
|
827
|
|
|
'rarr' => 8594, |
|
828
|
|
|
'rArr' => 8658, |
|
829
|
|
|
'rceil' => 8969, |
|
830
|
|
|
'rdquo' => 8221, |
|
831
|
|
|
'real' => 8476, |
|
832
|
|
|
'reg' => 174, |
|
833
|
|
|
'rfloor' => 8971, |
|
834
|
|
|
'Rho' => 929, |
|
835
|
|
|
'rho' => 961, |
|
836
|
|
|
'rlm' => 8207, |
|
837
|
|
|
'rsaquo' => 8250, |
|
838
|
|
|
'rsquo' => 8217, |
|
839
|
|
|
'sbquo' => 8218, |
|
840
|
|
|
'Scaron' => 352, |
|
841
|
|
|
'scaron' => 353, |
|
842
|
|
|
'sdot' => 8901, |
|
843
|
|
|
'sect' => 167, |
|
844
|
|
|
'shy' => 173, |
|
845
|
|
|
'Sigma' => 931, |
|
846
|
|
|
'sigma' => 963, |
|
847
|
|
|
'sigmaf' => 962, |
|
848
|
|
|
'sim' => 8764, |
|
849
|
|
|
'spades' => 9824, |
|
850
|
|
|
'sub' => 8834, |
|
851
|
|
|
'sube' => 8838, |
|
852
|
|
|
'sum' => 8721, |
|
853
|
|
|
'sup' => 8835, |
|
854
|
|
|
'sup1' => 185, |
|
855
|
|
|
'sup2' => 178, |
|
856
|
|
|
'sup3' => 179, |
|
857
|
|
|
'supe' => 8839, |
|
858
|
|
|
'szlig' => 223, |
|
859
|
|
|
'Tau' => 932, |
|
860
|
|
|
'tau' => 964, |
|
861
|
|
|
'there4' => 8756, |
|
862
|
|
|
'Theta' => 920, |
|
863
|
|
|
'theta' => 952, |
|
864
|
|
|
'thetasym' => 977, |
|
865
|
|
|
'thinsp' => 8201, |
|
866
|
|
|
'THORN' => 222, |
|
867
|
|
|
'thorn' => 254, |
|
868
|
|
|
'tilde' => 732, |
|
869
|
|
|
'times' => 215, |
|
870
|
|
|
'trade' => 8482, |
|
871
|
|
|
'Uacute' => 218, |
|
872
|
|
|
'uacute' => 250, |
|
873
|
|
|
'uarr' => 8593, |
|
874
|
|
|
'uArr' => 8657, |
|
875
|
|
|
'Ucirc' => 219, |
|
876
|
|
|
'ucirc' => 251, |
|
877
|
|
|
'Ugrave' => 217, |
|
878
|
|
|
'ugrave' => 249, |
|
879
|
|
|
'uml' => 168, |
|
880
|
|
|
'upsih' => 978, |
|
881
|
|
|
'Upsilon' => 933, |
|
882
|
|
|
'upsilon' => 965, |
|
883
|
|
|
'Uuml' => 220, |
|
884
|
|
|
'uuml' => 252, |
|
885
|
|
|
'weierp' => 8472, |
|
886
|
|
|
'Xi' => 926, |
|
887
|
|
|
'xi' => 958, |
|
888
|
|
|
'Yacute' => 221, |
|
889
|
|
|
'yacute' => 253, |
|
890
|
|
|
'yen' => 165, |
|
891
|
|
|
'Yuml' => 376, |
|
892
|
|
|
'yuml' => 255, |
|
893
|
|
|
'Zeta' => 918, |
|
894
|
|
|
'zeta' => 950, |
|
895
|
|
|
'zwj' => 8205, |
|
896
|
|
|
'zwnj' => 8204 |
|
897
|
|
|
); |
|
898
|
|
|
$out = "<!DOCTYPE html [\n"; |
|
899
|
|
|
foreach( $wgHtmlEntities as $entity => $codepoint ){ |
|
900
|
|
|
$out .= "<!ENTITY $entity \"&#$codepoint;\">"; |
|
901
|
|
|
} |
|
902
|
|
|
$out .= "]>\n"; |
|
903
|
|
|
return $out; |
|
904
|
|
|
} |
|
905
|
|
|
|
|
906
|
|
|
/** |
|
907
|
|
|
* Replace " > and < with their respective HTML entities ( ", |
|
908
|
|
|
* >, <) |
|
909
|
|
|
* |
|
910
|
|
|
* @param string $in text that might contain HTML tags. |
|
911
|
|
|
* @return string Escaped string |
|
912
|
|
|
*/ |
|
913
|
|
|
public static function escapeTagsOnly( $in ) { |
|
914
|
|
|
return str_replace( |
|
915
|
|
|
array( '"', '>', '<' ), |
|
916
|
|
|
array( '"', '>', '<' ), |
|
917
|
|
|
$in |
|
918
|
|
|
); |
|
919
|
|
|
} |
|
920
|
|
|
|
|
921
|
|
|
/** |
|
922
|
|
|
* Build a table of data |
|
923
|
|
|
* @param array $rows An array of arrays of strings, each to be a row in a table |
|
924
|
|
|
* @param array $attribs An array of attributes to apply to the table tag [optional] |
|
925
|
|
|
* @param array $headers An array of strings to use as table headers [optional] |
|
926
|
|
|
* @return string |
|
927
|
|
|
*/ |
|
928
|
|
|
public static function buildTable( $rows, $attribs = array(), $headers = null ) { |
|
929
|
|
|
$s = self::openElement( 'table', $attribs ); |
|
930
|
|
|
|
|
931
|
|
|
if( is_array( $headers ) ) { |
|
932
|
|
|
$s .= self::openElement( 'thead', $attribs ); |
|
933
|
|
|
|
|
934
|
|
|
foreach( $headers as $id => $header ){ |
|
935
|
|
|
$attribs = array(); |
|
936
|
|
|
|
|
937
|
|
|
if( is_string( $id ) ) { |
|
938
|
|
|
$attribs['id'] = $id; |
|
939
|
|
|
} |
|
940
|
|
|
|
|
941
|
|
|
$s .= self::element( 'th', $attribs, $header ); |
|
942
|
|
|
} |
|
943
|
|
|
$s .= self::closeElement( 'thead' ); |
|
944
|
|
|
} |
|
945
|
|
|
|
|
946
|
|
|
foreach( $rows as $id => $row ){ |
|
947
|
|
|
$attribs = array(); |
|
948
|
|
|
|
|
949
|
|
|
if( is_string( $id ) ) { |
|
950
|
|
|
$attribs['id'] = $id; |
|
951
|
|
|
} |
|
952
|
|
|
|
|
953
|
|
|
$s .= self::buildTableRow( $attribs, $row ); |
|
954
|
|
|
} |
|
955
|
|
|
|
|
956
|
|
|
$s .= self::closeElement( 'table' ); |
|
957
|
|
|
|
|
958
|
|
|
return $s; |
|
959
|
|
|
} |
|
960
|
|
|
|
|
961
|
|
|
/** |
|
962
|
|
|
* Build a row for a table |
|
963
|
|
|
* @param array $attribs An array of attributes to apply to the tr tag |
|
964
|
|
|
* @param array $cells An array of strings to put in <td> |
|
965
|
|
|
* @return string |
|
966
|
|
|
*/ |
|
967
|
|
|
public static function buildTableRow( $attribs, $cells ) { |
|
968
|
|
|
$s = self::openElement( 'tr', $attribs ); |
|
969
|
|
|
|
|
970
|
|
|
foreach( $cells as $id => $cell ){ |
|
971
|
|
|
$attribs = array(); |
|
972
|
|
|
|
|
973
|
|
|
if( is_string( $id ) ) { |
|
974
|
|
|
$attribs['id'] = $id; |
|
975
|
|
|
} |
|
976
|
|
|
|
|
977
|
|
|
$s .= self::element( 'td', $attribs, $cell ); |
|
978
|
|
|
} |
|
979
|
|
|
|
|
980
|
|
|
$s .= self::closeElement( 'tr' ); |
|
981
|
|
|
|
|
982
|
|
|
return $s; |
|
983
|
|
|
} |
|
984
|
|
|
} |
|
985
|
|
|
|
|
986
|
|
|
class XmlSelect { |
|
987
|
|
|
protected $options = array(); |
|
988
|
|
|
protected $default = false; |
|
989
|
|
|
protected $attributes = array(); |
|
990
|
|
|
|
|
991
|
|
|
public function __construct( $name = false, $id = false, $default = false ) { |
|
992
|
|
|
if( $name ) { |
|
993
|
|
|
$this->setAttribute( 'name', $name ); |
|
994
|
|
|
} |
|
995
|
|
|
|
|
996
|
|
|
if( $id ) { |
|
997
|
|
|
$this->setAttribute( 'id', $id ); |
|
998
|
|
|
} |
|
999
|
|
|
|
|
1000
|
|
|
if( $default !== false ) { |
|
1001
|
|
|
$this->default = $default; |
|
1002
|
|
|
} |
|
1003
|
|
|
} |
|
1004
|
|
|
|
|
1005
|
|
|
/** |
|
1006
|
|
|
* @param $default |
|
1007
|
|
|
*/ |
|
1008
|
|
|
public function setDefault( $default ) { |
|
1009
|
|
|
$this->default = $default; |
|
1010
|
|
|
} |
|
1011
|
|
|
|
|
1012
|
|
|
/** |
|
1013
|
|
|
* @param $name string |
|
1014
|
|
|
* @param $value |
|
1015
|
|
|
*/ |
|
1016
|
|
|
public function setAttribute( $name, $value ) { |
|
1017
|
|
|
$this->attributes[$name] = $value; |
|
1018
|
|
|
} |
|
1019
|
|
|
|
|
1020
|
|
|
/** |
|
1021
|
|
|
* @param $name |
|
1022
|
|
|
* @return array|null |
|
1023
|
|
|
*/ |
|
1024
|
|
|
public function getAttribute( $name ) { |
|
1025
|
|
|
if( isset( $this->attributes[$name] ) ) { |
|
1026
|
|
|
return $this->attributes[$name]; |
|
1027
|
|
|
} else { |
|
1028
|
|
|
return null; |
|
1029
|
|
|
} |
|
1030
|
|
|
} |
|
1031
|
|
|
|
|
1032
|
|
|
/** |
|
1033
|
|
|
* @param $name |
|
1034
|
|
|
* @param $value bool |
|
1035
|
|
|
*/ |
|
1036
|
|
|
public function addOption( $name, $value = false ) { |
|
1037
|
|
|
// Stab stab stab |
|
1038
|
|
|
$value = $value !== false ? $value : $name; |
|
1039
|
|
|
|
|
1040
|
|
|
$this->options[] = array( $name => $value ); |
|
1041
|
|
|
} |
|
1042
|
|
|
|
|
1043
|
|
|
/** |
|
1044
|
|
|
* This accepts an array of form |
|
1045
|
|
|
* label => value |
|
1046
|
|
|
* label => ( label => value, label => value ) |
|
1047
|
|
|
* |
|
1048
|
|
|
* @param $options |
|
1049
|
|
|
*/ |
|
1050
|
|
|
public function addOptions( $options ) { |
|
1051
|
|
|
$this->options[] = $options; |
|
1052
|
|
|
} |
|
1053
|
|
|
|
|
1054
|
|
|
/** |
|
1055
|
|
|
* This accepts an array of form |
|
1056
|
|
|
* label => value |
|
1057
|
|
|
* label => ( label => value, label => value ) |
|
1058
|
|
|
* |
|
1059
|
|
|
* @param $options |
|
1060
|
|
|
* @param bool $default |
|
1061
|
|
|
* @return string |
|
1062
|
|
|
*/ |
|
1063
|
|
|
static function formatOptions( $options, $default = false ) { |
|
|
|
|
|
|
1064
|
|
|
$data = ''; |
|
1065
|
|
|
|
|
1066
|
|
|
foreach( $options as $label => $value ){ |
|
1067
|
|
|
if( is_array( $value ) ) { |
|
1068
|
|
|
$contents = self::formatOptions( $value, $default ); |
|
1069
|
|
|
$data .= self::tags( 'optgroup', array( 'label' => $label ), $contents ) . "\n"; |
|
|
|
|
|
|
1070
|
|
|
} else { |
|
1071
|
|
|
$data .= self::option( $label, $value, $value === $default ) . "\n"; |
|
|
|
|
|
|
1072
|
|
|
} |
|
1073
|
|
|
} |
|
1074
|
|
|
|
|
1075
|
|
|
return $data; |
|
1076
|
|
|
} |
|
1077
|
|
|
|
|
1078
|
|
|
/** |
|
1079
|
|
|
* @return string |
|
1080
|
|
|
*/ |
|
1081
|
|
|
public function getHTML() { |
|
1082
|
|
|
$contents = ''; |
|
1083
|
|
|
|
|
1084
|
|
|
foreach( $this->options as $options ){ |
|
1085
|
|
|
$contents .= self::formatOptions( $options, $this->default ); |
|
1086
|
|
|
} |
|
1087
|
|
|
|
|
1088
|
|
|
return self::tags( 'select', $this->attributes, rtrim( $contents ) ); |
|
|
|
|
|
|
1089
|
|
|
} |
|
1090
|
|
|
} |
Adding explicit visibility (
private,protected, orpublic) is generally recommend to communicate to other developers how, and from where this method is intended to be used.