6 protected function setUp() {
10 'wgUseMediaWikiUIEverywhere' =>
false,
13 $langObj = Language::factory(
'en' );
18 $langObj->setNamespaces( [
30 9 =>
'MediaWiki_talk',
32 11 =>
'Template_talk',
34 15 =>
'Category_talk',
51 Html::element(
'img',
null,
'' ),
52 'Self-closing tag for short-tag elements'
56 '<element></element>',
57 Html::element(
'element',
null,
null ),
58 'Close tag for empty element (null, null)'
62 '<element></element>',
63 Html::element(
'element', [],
'' ),
64 'Close tag for empty element (array, string)'
71 # HTML is not an XML MimeType
72 [
'text/html',
false ],
73 # XML is an XML MimeType
75 [
'application/xml',
true ],
76 # XHTML is an XML MimeType
77 [
'application/xhtml+xml',
true ],
78 # Make sure other +xml MimeTypes are supported
79 # SVG is another random MimeType even though we don't use it
80 [
'image/svg+xml',
true ],
81 # Complete random other MimeTypes are not XML
82 [
'text/plain',
false ],
91 $this->assertEquals( $isXmlMimeType, Html::isXmlMimeType( $mimetype ) );
100 Html::expandAttributes( [
'foo' =>
null ] ),
101 'skip keys with null value'
104 Html::expandAttributes( [
'foo' =>
false ] ),
105 'skip keys with false value'
109 Html::expandAttributes( [
'foo' =>
'' ] ),
110 'keep keys with an empty string'
120 Html::expandAttributes( [
'selected' =>
false ] ),
121 'Boolean attributes do not generates output when value is false'
125 Html::expandAttributes( [
'selected' =>
null ] ),
126 'Boolean attributes do not generates output when value is null'
131 Html::expandAttributes( [
'selected' =>
true ] ),
132 'Boolean attributes have no value when value is true'
136 Html::expandAttributes( [
'selected' ] ),
137 'Boolean attributes have no value when value is true (passed as numerical array)'
147 Html::expandAttributes( [
'value' => 1 ] ),
148 'Integer value is cast to a string'
152 Html::expandAttributes( [
'value' => 1.1 ] ),
153 'Float value is cast to a string'
162 ' value="stringValue"',
163 Html::expandAttributes( [
'value' =>
new HtmlTestValue() ] ),
164 'Object value is converted to a string'
177 Html::expandAttributes( [
'empty_string' =>
'' ] ),
178 'Empty string is always quoted'
182 Html::expandAttributes( [
'key' =>
'value' ] ),
183 'Simple string value needs no quotes'
187 Html::expandAttributes( [
'one' => 1 ] ),
188 'Number 1 value needs no quotes'
192 Html::expandAttributes( [
'zero' => 0 ] ),
193 'Number 0 value needs no quotes'
206 ' class="redundant spaces here"',
207 Html::expandAttributes( [
'class' =>
' redundant spaces here ' ] ),
208 'Normalization should strip redundant spaces'
212 Html::expandAttributes( [
'class' =>
'foo bar foo bar bar' ] ),
213 'Normalization should remove duplicates in string-lists'
215 # ## "EMPTY" ARRAY VALUES
218 Html::expandAttributes( [
'class' => [] ] ),
219 'Value with an empty array'
223 Html::expandAttributes( [
'class' => [
null,
'',
' ',
' ' ] ] ),
224 'Array with null, empty string and spaces'
226 # ## NON-EMPTY ARRAY VALUES
229 Html::expandAttributes( [
'class' => [
236 'Normalization should remove duplicates in the array'
240 Html::expandAttributes( [
'class' => [
246 'Normalization should remove duplicates in string-lists in the array'
257 ' class="booltrue one"',
258 Html::expandAttributes( [
'class' => [
262 # Method
use isset() internally, make sure we
do discard
265 'boolfalse' =>
false,
283 Html::expandAttributes( [
'class' => [
298 Html::expandAttributes( [
312 '<select id="namespace" name="namespace">' .
"\n" .
313 '<option value="0">(Main)</option>' .
"\n" .
314 '<option value="1">Talk</option>' .
"\n" .
315 '<option value="2">User</option>' .
"\n" .
316 '<option value="3">User talk</option>' .
"\n" .
317 '<option value="4">MyWiki</option>' .
"\n" .
318 '<option value="5">MyWiki Talk</option>' .
"\n" .
319 '<option value="6">File</option>' .
"\n" .
320 '<option value="7">File talk</option>' .
"\n" .
321 '<option value="8">MediaWiki</option>' .
"\n" .
322 '<option value="9">MediaWiki talk</option>' .
"\n" .
323 '<option value="10">Template</option>' .
"\n" .
324 '<option value="11">Template talk</option>' .
"\n" .
325 '<option value="14">Category</option>' .
"\n" .
326 '<option value="15">Category talk</option>' .
"\n" .
327 '<option value="100">Custom</option>' .
"\n" .
328 '<option value="101">Custom talk</option>' .
"\n" .
330 Html::namespaceSelector(),
331 'Basic namespace selector without custom options'
335 '<label for="mw-test-namespace">Select a namespace:</label> ' .
336 '<select id="mw-test-namespace" name="wpNamespace">' .
"\n" .
337 '<option value="all">all</option>' .
"\n" .
338 '<option value="0">(Main)</option>' .
"\n" .
339 '<option value="1">Talk</option>' .
"\n" .
340 '<option value="2" selected="">User</option>' .
"\n" .
341 '<option value="3">User talk</option>' .
"\n" .
342 '<option value="4">MyWiki</option>' .
"\n" .
343 '<option value="5">MyWiki Talk</option>' .
"\n" .
344 '<option value="6">File</option>' .
"\n" .
345 '<option value="7">File talk</option>' .
"\n" .
346 '<option value="8">MediaWiki</option>' .
"\n" .
347 '<option value="9">MediaWiki talk</option>' .
"\n" .
348 '<option value="10">Template</option>' .
"\n" .
349 '<option value="11">Template talk</option>' .
"\n" .
350 '<option value="14">Category</option>' .
"\n" .
351 '<option value="15">Category talk</option>' .
"\n" .
352 '<option value="100">Custom</option>' .
"\n" .
353 '<option value="101">Custom talk</option>' .
"\n" .
355 Html::namespaceSelector(
356 [
'selected' =>
'2',
'all' =>
'all',
'label' =>
'Select a namespace:' ],
357 [
'name' =>
'wpNamespace',
'id' =>
'mw-test-namespace' ]
359 'Basic namespace selector with custom values'
363 '<label for="namespace">Select a namespace:</label> ' .
364 '<select id="namespace" name="namespace">' .
"\n" .
365 '<option value="0">(Main)</option>' .
"\n" .
366 '<option value="1">Talk</option>' .
"\n" .
367 '<option value="2">User</option>' .
"\n" .
368 '<option value="3">User talk</option>' .
"\n" .
369 '<option value="4">MyWiki</option>' .
"\n" .
370 '<option value="5">MyWiki Talk</option>' .
"\n" .
371 '<option value="6">File</option>' .
"\n" .
372 '<option value="7">File talk</option>' .
"\n" .
373 '<option value="8">MediaWiki</option>' .
"\n" .
374 '<option value="9">MediaWiki talk</option>' .
"\n" .
375 '<option value="10">Template</option>' .
"\n" .
376 '<option value="11">Template talk</option>' .
"\n" .
377 '<option value="14">Category</option>' .
"\n" .
378 '<option value="15">Category talk</option>' .
"\n" .
379 '<option value="100">Custom</option>' .
"\n" .
380 '<option value="101">Custom talk</option>' .
"\n" .
382 Html::namespaceSelector(
383 [
'label' =>
'Select a namespace:' ]
385 'Basic namespace selector with a custom label but no id attribtue for the <select>'
391 '<select id="namespace" name="namespace">' .
"\n" .
392 '<option value="2">User</option>' .
"\n" .
393 '<option value="4">MyWiki</option>' .
"\n" .
394 '<option value="5">MyWiki Talk</option>' .
"\n" .
395 '<option value="6">File</option>' .
"\n" .
396 '<option value="7">File talk</option>' .
"\n" .
397 '<option value="8">MediaWiki</option>' .
"\n" .
398 '<option value="9">MediaWiki talk</option>' .
"\n" .
399 '<option value="10">Template</option>' .
"\n" .
400 '<option value="11">Template talk</option>' .
"\n" .
401 '<option value="14">Category</option>' .
"\n" .
402 '<option value="15">Category talk</option>' .
"\n" .
404 Html::namespaceSelector(
405 [
'exclude' => [ 0, 1, 3, 100, 101 ] ]
407 'Namespace selector namespace filtering.'
413 '<select id="namespace" name="namespace">' .
"\n" .
414 '<option disabled="" value="0">(Main)</option>' .
"\n" .
415 '<option disabled="" value="1">Talk</option>' .
"\n" .
416 '<option disabled="" value="2">User</option>' .
"\n" .
417 '<option disabled="" value="3">User talk</option>' .
"\n" .
418 '<option disabled="" value="4">MyWiki</option>' .
"\n" .
419 '<option value="5">MyWiki Talk</option>' .
"\n" .
420 '<option value="6">File</option>' .
"\n" .
421 '<option value="7">File talk</option>' .
"\n" .
422 '<option value="8">MediaWiki</option>' .
"\n" .
423 '<option value="9">MediaWiki talk</option>' .
"\n" .
424 '<option value="10">Template</option>' .
"\n" .
425 '<option value="11">Template talk</option>' .
"\n" .
426 '<option value="14">Category</option>' .
"\n" .
427 '<option value="15">Category talk</option>' .
"\n" .
428 '<option value="100">Custom</option>' .
"\n" .
429 '<option value="101">Custom talk</option>' .
"\n" .
431 Html::namespaceSelector( [
432 'disable' => [ 0, 1, 2, 3, 4 ]
434 'Namespace selector namespace disabling'
444 '<input type="' . $HTML5InputType .
'"/>',
445 Html::element(
'input', [
'type' => $HTML5InputType ] ),
446 'In HTML5, Html::element() should accept type="' . $HTML5InputType .
'"'
472 $cases[] = [
$type ];
484 $this->assertEquals( $expected, Html::element( $element,
$attribs ), $message );
488 # Use cases in a concise format:
489 # <expected>, <element name>, <array of attributes> [, <message>]
490 # Will be mapped to Html::element()
493 # ## Generic cases, match $attribDefault static array
494 $cases[] = [
'<area/>',
495 'area', [
'shape' =>
'rect' ]
498 $cases[] = [
'<button type="submit"></button>',
499 'button', [
'formaction' =>
'GET' ]
501 $cases[] = [
'<button type="submit"></button>',
502 'button', [
'formenctype' =>
'application/x-www-form-urlencoded' ]
505 $cases[] = [
'<canvas></canvas>',
506 'canvas', [
'height' =>
'150' ]
508 $cases[] = [
'<canvas></canvas>',
509 'canvas', [
'width' =>
'300' ]
511 # Also check with numeric values
512 $cases[] = [
'<canvas></canvas>',
513 'canvas', [
'height' => 150 ]
515 $cases[] = [
'<canvas></canvas>',
516 'canvas', [
'width' => 300 ]
519 $cases[] = [
'<form></form>',
520 'form', [
'action' =>
'GET' ]
522 $cases[] = [
'<form></form>',
523 'form', [
'autocomplete' =>
'on' ]
525 $cases[] = [
'<form></form>',
526 'form', [
'enctype' =>
'application/x-www-form-urlencoded' ]
529 $cases[] = [
'<input/>',
530 'input', [
'formaction' =>
'GET' ]
532 $cases[] = [
'<input/>',
533 'input', [
'type' =>
'text' ]
536 $cases[] = [
'<keygen/>',
537 'keygen', [
'keytype' =>
'rsa' ]
540 $cases[] = [
'<link/>',
541 'link', [
'media' =>
'all' ]
544 $cases[] = [
'<menu></menu>',
545 'menu', [
'type' =>
'list' ]
548 $cases[] = [
'<script></script>',
549 'script', [
'type' =>
'text/javascript' ]
552 $cases[] = [
'<style></style>',
553 'style', [
'media' =>
'all' ]
555 $cases[] = [
'<style></style>',
556 'style', [
'type' =>
'text/css' ]
559 $cases[] = [
'<textarea></textarea>',
560 'textarea', [
'wrap' =>
'soft' ]
565 # <link type="text/css">
566 $cases[] = [
'<link/>',
567 'link', [
'type' =>
'text/css' ]
570 # <input> specific handling
571 $cases[] = [
'<input type="checkbox"/>',
572 'input', [
'type' =>
'checkbox',
'value' =>
'on' ],
573 'Default value "on" is stripped of checkboxes',
575 $cases[] = [
'<input type="radio"/>',
576 'input', [
'type' =>
'radio',
'value' =>
'on' ],
577 'Default value "on" is stripped of radio buttons',
579 $cases[] = [
'<input type="submit" value="Submit"/>',
580 'input', [
'type' =>
'submit',
'value' =>
'Submit' ],
581 'Default value "Submit" is kept on submit buttons (for possible l10n issues)',
583 $cases[] = [
'<input type="color"/>',
584 'input', [
'type' =>
'color',
'value' =>
'' ],
586 $cases[] = [
'<input type="range"/>',
587 'input', [
'type' =>
'range',
'value' =>
'' ],
590 # <button> specific handling
591 # see remarks on https:
592 $cases[] = [
'<button type="submit"></button>',
593 'button', [
'type' =>
'submit' ],
594 'According to standard the default type is "submit". '
595 .
'Depending on compatibility mode IE might use "button", instead.',
598 # <select> specific handling
599 $cases[] = [
'<select multiple=""></select>',
600 'select', [
'size' =>
'4',
'multiple' =>
true ],
602 # .. with numeric value
603 $cases[] = [
'<select multiple=""></select>',
604 'select', [
'size' => 4,
'multiple' =>
true ],
606 $cases[] = [
'<select></select>',
607 'select', [
'size' =>
'1',
'multiple' =>
false ],
609 # .. with numeric value
610 $cases[] = [
'<select></select>',
611 'select', [
'size' => 1,
'multiple' =>
false ],
614 # Passing an array as value
615 $cases[] = [
'<a class="css-class-one css-class-two"></a>',
616 'a', [
'class' => [
'css-class-one',
'css-class-two' ] ],
617 "dropDefaults accepts values given as an array"
620 # FIXME: doDropDefault should remove defaults given in an array
621 # Expected should be '<a></a>'
622 $cases[] = [
'<a class=""></a>',
623 'a', [
'class' => [
'',
'' ] ],
624 "dropDefaults accepts values given as an array"
627 # Craft the Html elements
629 foreach ( $cases
as $case ) {
633 isset( $case[3] ) ? $case[3] :
''
642 '<input type="radio" value="testval" name="testname"/>',
643 Html::input(
'testname',
'testval',
'radio' ),
644 'Input wrapper with type and value.'
647 '<input name="testname"/>',
648 Html::input(
'testname' ),
649 'Input wrapper with all default values.'
655 '<input type="checkbox" value="1" name="testname"/>',
656 Html::check(
'testname' ),
657 'Checkbox wrapper unchecked.'
660 '<input checked="" type="checkbox" value="1" name="testname"/>',
661 Html::check(
'testname',
true ),
662 'Checkbox wrapper checked.'
665 '<input type="checkbox" value="testval" name="testname"/>',
666 Html::check(
'testname',
false, [
'value' =>
'testval' ] ),
667 'Checkbox wrapper with a value override.'
673 '<input type="radio" value="1" name="testname"/>',
674 Html::radio(
'testname' ),
675 'Radio wrapper unchecked.'
678 '<input checked="" type="radio" value="1" name="testname"/>',
679 Html::radio(
'testname',
true ),
680 'Radio wrapper checked.'
683 '<input type="radio" value="testval" name="testname"/>',
684 Html::radio(
'testname',
false, [
'value' =>
'testval' ] ),
685 'Radio wrapper with a value override.'
691 '<label for="testid">testlabel</label>',
692 Html::label(
'testlabel',
'testid' ),
699 [ [],
'',
'when there are no images, return empty string' ],
701 [
'1x' =>
'1x.png',
'1.5x' =>
'1_5x.png',
'2x' =>
'2x.png' ],
702 '1x.png 1x, 1_5x.png 1.5x, 2x.png 2x',
703 'pixel depth keys may include a trailing "x"'
706 [
'1' =>
'1x.png',
'1.5' =>
'1_5x.png',
'2' =>
'2x.png' ],
707 '1x.png 1x, 1_5x.png 1.5x, 2x.png 2x',
708 'pixel depth keys may omit a trailing "x"'
711 [
'1' =>
'small.png',
'1.5' =>
'large.png',
'2' =>
'large.png' ],
712 'small.png 1x, large.png 1.5x',
713 'omit larger duplicates'
716 [
'1' =>
'small.png',
'2' =>
'large.png',
'1.5' =>
'large.png' ],
717 'small.png 1x, large.png 1.5x',
718 'omit larger duplicates in irregular order'
728 $this->assertEquals( Html::srcSet( $images ), $expected, $message );
734 return 'stringValue';
Apache License January AND DISTRIBUTION Definitions License shall mean the terms and conditions for use
tests for includes/Html.php
testExpandAttributesSkipsNullAndFalse()
Html::expandAttributes.
testCanDisableANamespaces()
testValueIsAuthoritativeInSpaceSeparatedAttributesArrays()
How do we handle duplicate keys in HTML attributes expansion? We could pass a "class" the values: 'GR...
testExpandAttributesForObjects()
Html::expandAttributes.
testXmlMimeType( $mimetype, $isXmlMimeType)
dataXmlMimeType Html::isXmlMimeType
static provideElementsWithAttributesHavingDefaultValues()
testExpandAttributesListValueAttributes()
Html::expandAttributes has special features for HTML attributes that use space separated lists and al...
static provideSrcSetImages()
testNamespaceSelector()
Html::namespaceSelector Html::namespaceSelectorOptions.
testExpandAttributesVariousExpansions()
Test for Html::expandAttributes() Please note it output a string prefixed with a space!...
testExpandAttributesSpaceSeparatedAttributesWithBoolean()
Test feature added by r96188, let pass attributes values as a PHP array.
testExpandAttributes_ArrayOnNonListValueAttribute_ThrowsException()
Html::expandAttributes MWException.
testCanFilterOutNamespaces()
testDropDefaults( $expected, $element, $attribs, $message='')
Test out Html::element drops or enforces default value Html::dropDefaults provideElementsWithAttribut...
testExpandAttributesForBooleans()
Html::expandAttributes.
testSrcSet( $images, $expected, $message)
provideSrcSetImages Html::srcSet
testExpandAttributesForNumbers()
Html::expandAttributes.
testElementBasics()
Html::element Html::rawElement Html::openElement Html::closeElement.
testHtmlElementAcceptsNewHtml5TypesInHtml5Mode( $HTML5InputType)
provideHtml5InputTypes Html::element
static provideHtml5InputTypes()
List of input element types values introduced by HTML5 Full list at https://www.w3....
This document is intended to provide useful advice for parties seeking to redistribute MediaWiki to end users It s targeted particularly at maintainers for Linux since it s been observed that distribution packages of MediaWiki often break We ve consistently had to recommend that users seeking support use official tarballs instead of their distribution s and this often solves whatever problem the user is having It would be nice if this could such as
This code would result in ircNotify being run twice when an article is and once for brion Hooks can return three possible values
null means default in associative array with keys and values unescaped Should be merged with default with a value of false meaning to suppress the attribute in associative array with keys and values unescaped noclasses just before the function returns a value If you return true
null means default in associative array with keys and values unescaped Should be merged with default with a value of false meaning to suppress the attribute in associative array with keys and values unescaped noclasses & $ret
null means default in associative array with keys and values unescaped Should be merged with default with a value of false meaning to suppress the attribute in associative array with keys and values unescaped noclasses just before the function returns a value If you return an< a > element with HTML attributes $attribs and contents $html will be returned If you return $ret will be returned and may include noclasses after processing & $attribs
processing should stop and the error should be shown to the user * false
injection txt This is an overview of how MediaWiki makes use of dependency injection The design described here grew from the discussion of RFC T384 The term dependency this means that anything an object needs to operate should be injected from the the object itself should only know narrow no concrete implementation of the logic it relies on The requirement to inject everything typically results in an architecture that based on two main types of and essentially stateless service objects that use other service objects to operate on the value objects As of the beginning MediaWiki is only starting to use the DI approach Much of the code still relies on global state or direct resulting in a highly cyclical dependency which acts as the top level factory for services in MediaWiki which can be used to gain access to default instances of various services MediaWikiServices however also allows new services to be defined and default services to be redefined Services are defined or redefined by providing a callback the instantiator that will return a new instance of the service When it will create an instance of MediaWikiServices and populate it with the services defined in the files listed by thereby bootstrapping the DI framework Per $wgServiceWiringFiles lists includes ServiceWiring php