setMwGlobals( [ 'wgUseMediaWikiUIEverywhere' => false, ] ); $langObj = Language::factory( 'en' ); // Hardcode namespaces during test runs, // so that html output based on existing namespaces // can be properly evaluated. $langObj->setNamespaces( [ -2 => 'Media', -1 => 'Special', 0 => '', 1 => 'Talk', 2 => 'User', 3 => 'User_talk', 4 => 'MyWiki', 5 => 'MyWiki_Talk', 6 => 'File', 7 => 'File_talk', 8 => 'MediaWiki', 9 => 'MediaWiki_talk', 10 => 'Template', 11 => 'Template_talk', 14 => 'Category', 15 => 'Category_talk', 100 => 'Custom', 101 => 'Custom_talk', ] ); $this->setUserLang( $langObj ); $this->setContentLang( $langObj ); } /** * @covers Html::element * @covers Html::rawElement * @covers Html::openElement * @covers Html::closeElement */ public function testElementBasics() { $this->assertEquals( '', Html::element( 'img', null, '' ), 'Self-closing tag for short-tag elements' ); $this->assertEquals( '', Html::element( 'element', null, null ), 'Close tag for empty element (null, null)' ); $this->assertEquals( '', Html::element( 'element', [], '' ), 'Close tag for empty element (array, string)' ); } public function dataXmlMimeType() { return [ // ( $mimetype, $isXmlMimeType ) # HTML is not an XML MimeType [ 'text/html', false ], # XML is an XML MimeType [ 'text/xml', true ], [ 'application/xml', true ], # XHTML is an XML MimeType [ 'application/xhtml+xml', true ], # Make sure other +xml MimeTypes are supported # SVG is another random MimeType even though we don't use it [ 'image/svg+xml', true ], # Complete random other MimeTypes are not XML [ 'text/plain', false ], ]; } /** * @dataProvider dataXmlMimeType * @covers Html::isXmlMimeType */ public function testXmlMimeType( $mimetype, $isXmlMimeType ) { $this->assertEquals( $isXmlMimeType, Html::isXmlMimeType( $mimetype ) ); } /** * @covers Html::expandAttributes */ public function testExpandAttributesSkipsNullAndFalse() { # ## EMPTY ######## $this->assertEmpty( Html::expandAttributes( [ 'foo' => null ] ), 'skip keys with null value' ); $this->assertEmpty( Html::expandAttributes( [ 'foo' => false ] ), 'skip keys with false value' ); $this->assertEquals( ' foo=""', Html::expandAttributes( [ 'foo' => '' ] ), 'keep keys with an empty string' ); } /** * @covers Html::expandAttributes */ public function testExpandAttributesForBooleans() { $this->assertEquals( '', Html::expandAttributes( [ 'selected' => false ] ), 'Boolean attributes do not generates output when value is false' ); $this->assertEquals( '', Html::expandAttributes( [ 'selected' => null ] ), 'Boolean attributes do not generates output when value is null' ); $this->assertEquals( ' selected=""', Html::expandAttributes( [ 'selected' => true ] ), 'Boolean attributes have no value when value is true' ); $this->assertEquals( ' selected=""', Html::expandAttributes( [ 'selected' ] ), 'Boolean attributes have no value when value is true (passed as numerical array)' ); } /** * @covers Html::expandAttributes */ public function testExpandAttributesForNumbers() { $this->assertEquals( ' value="1"', Html::expandAttributes( [ 'value' => 1 ] ), 'Integer value is cast to a string' ); $this->assertEquals( ' value="1.1"', Html::expandAttributes( [ 'value' => 1.1 ] ), 'Float value is cast to a string' ); } /** * @covers Html::expandAttributes */ public function testExpandAttributesForObjects() { $this->assertEquals( ' value="stringValue"', Html::expandAttributes( [ 'value' => new HtmlTestValue() ] ), 'Object value is converted to a string' ); } /** * Test for Html::expandAttributes() * Please note it output a string prefixed with a space! * @covers Html::expandAttributes */ public function testExpandAttributesVariousExpansions() { # ## NOT EMPTY #### $this->assertEquals( ' empty_string=""', Html::expandAttributes( [ 'empty_string' => '' ] ), 'Empty string is always quoted' ); $this->assertEquals( ' key="value"', Html::expandAttributes( [ 'key' => 'value' ] ), 'Simple string value needs no quotes' ); $this->assertEquals( ' one="1"', Html::expandAttributes( [ 'one' => 1 ] ), 'Number 1 value needs no quotes' ); $this->assertEquals( ' zero="0"', Html::expandAttributes( [ 'zero' => 0 ] ), 'Number 0 value needs no quotes' ); } /** * Html::expandAttributes has special features for HTML * attributes that use space separated lists and also * allows arrays to be used as values. * @covers Html::expandAttributes */ public function testExpandAttributesListValueAttributes() { # ## STRING VALUES $this->assertEquals( ' class="redundant spaces here"', Html::expandAttributes( [ 'class' => ' redundant spaces here ' ] ), 'Normalization should strip redundant spaces' ); $this->assertEquals( ' class="foo bar"', Html::expandAttributes( [ 'class' => 'foo bar foo bar bar' ] ), 'Normalization should remove duplicates in string-lists' ); # ## "EMPTY" ARRAY VALUES $this->assertEquals( ' class=""', Html::expandAttributes( [ 'class' => [] ] ), 'Value with an empty array' ); $this->assertEquals( ' class=""', Html::expandAttributes( [ 'class' => [ null, '', ' ', ' ' ] ] ), 'Array with null, empty string and spaces' ); # ## NON-EMPTY ARRAY VALUES $this->assertEquals( ' class="foo bar"', Html::expandAttributes( [ 'class' => [ 'foo', 'bar', 'foo', 'bar', 'bar', ] ] ), 'Normalization should remove duplicates in the array' ); $this->assertEquals( ' class="foo bar"', Html::expandAttributes( [ 'class' => [ 'foo bar', 'bar foo', 'foo', 'bar bar', ] ] ), 'Normalization should remove duplicates in string-lists in the array' ); } /** * Test feature added by r96188, let pass attributes values as * a PHP array. Restricted to class,rel, accesskey. * @covers Html::expandAttributes */ public function testExpandAttributesSpaceSeparatedAttributesWithBoolean() { $this->assertEquals( ' class="booltrue one"', Html::expandAttributes( [ 'class' => [ 'booltrue' => true, 'one' => 1, # Method use isset() internally, make sure we do discard # attributes values which have been assigned well known values 'emptystring' => '', 'boolfalse' => false, 'zero' => 0, 'null' => null, ] ] ) ); } /** * How do we handle duplicate keys in HTML attributes expansion? * We could pass a "class" the values: 'GREEN' and array( 'GREEN' => false ) * The latter will take precedence. * * Feature added by r96188 * @covers Html::expandAttributes */ public function testValueIsAuthoritativeInSpaceSeparatedAttributesArrays() { $this->assertEquals( ' class=""', Html::expandAttributes( [ 'class' => [ 'GREEN', 'GREEN' => false, 'GREEN', ] ] ) ); } /** * @covers Html::expandAttributes * @expectedException MWException */ public function testExpandAttributes_ArrayOnNonListValueAttribute_ThrowsException() { // Real-life test case found in the Popups extension (see Gerrit cf0fd64), // when used with an outdated BetaFeatures extension (see Gerrit deda1e7) Html::expandAttributes( [ 'src' => [ 'ltr' => 'ltr.svg', 'rtl' => 'rtl.svg' ] ] ); } /** * @covers Html::namespaceSelector * @covers Html::namespaceSelectorOptions */ public function testNamespaceSelector() { $this->assertEquals( '', Html::namespaceSelector(), 'Basic namespace selector without custom options' ); $this->assertEquals( ' ' . '', Html::namespaceSelector( [ 'selected' => '2', 'all' => 'all', 'label' => 'Select a namespace:' ], [ 'name' => 'wpNamespace', 'id' => 'mw-test-namespace' ] ), 'Basic namespace selector with custom values' ); $this->assertEquals( ' ' . '', Html::namespaceSelector( [ 'label' => 'Select a namespace:' ] ), 'Basic namespace selector with a custom label but no id attribtue for the ' . "\n" . '' . "\n" . '' . "\n" . '' . "\n" . '' . "\n" . '' . "\n" . '' . "\n" . '' . "\n" . '' . "\n" . '' . "\n" . '' . "\n" . '' . "\n" . '', Html::namespaceSelector( [ 'exclude' => [ 0, 1, 3, 100, 101 ] ] ), 'Namespace selector namespace filtering.' ); } /** * @covers Html::namespaceSelector */ public function testCanDisableANamespaces() { $this->assertEquals( '', Html::namespaceSelector( [ 'disable' => [ 0, 1, 2, 3, 4 ] ] ), 'Namespace selector namespace disabling' ); } /** * @dataProvider provideHtml5InputTypes * @covers Html::element */ public function testHtmlElementAcceptsNewHtml5TypesInHtml5Mode( $HTML5InputType ) { $this->assertEquals( '', Html::element( 'input', [ 'type' => $HTML5InputType ] ), 'In HTML5, Html::element() should accept type="' . $HTML5InputType . '"' ); } /** * @covers Html::warningBox * @covers Html::messageBox */ public function testWarningBox() { $this->assertEquals( Html::warningBox( 'warn' ), '
warn
' ); } /** * @covers Html::errorBox * @covers Html::messageBox */ public function testErrorBox() { $this->assertEquals( Html::errorBox( 'err' ), '
err
' ); $this->assertEquals( Html::errorBox( 'err', 'heading' ), '

heading

err
' ); } /** * @covers Html::successBox * @covers Html::messageBox */ public function testSuccessBox() { $this->assertEquals( Html::successBox( 'great' ), '
great
' ); $this->assertEquals( Html::successBox( '' ), '
' ); } /** * List of input element types values introduced by HTML5 * Full list at https://www.w3.org/TR/html-markup/input.html */ public static function provideHtml5InputTypes() { $types = [ 'datetime', 'datetime-local', 'date', 'month', 'time', 'week', 'number', 'range', 'email', 'url', 'search', 'tel', 'color', ]; $cases = []; foreach ( $types as $type ) { $cases[] = [ $type ]; } return $cases; } /** * Test out Html::element drops or enforces default value * @covers Html::dropDefaults * @dataProvider provideElementsWithAttributesHavingDefaultValues */ public function testDropDefaults( $expected, $element, $attribs, $message = '' ) { $this->assertEquals( $expected, Html::element( $element, $attribs ), $message ); } public static function provideElementsWithAttributesHavingDefaultValues() { # Use cases in a concise format: # , , [, ] # Will be mapped to Html::element() $cases = []; # ## Generic cases, match $attribDefault static array $cases[] = [ '', 'area', [ 'shape' => 'rect' ] ]; $cases[] = [ '', 'button', [ 'formaction' => 'GET' ] ]; $cases[] = [ '', 'button', [ 'formenctype' => 'application/x-www-form-urlencoded' ] ]; $cases[] = [ '', 'canvas', [ 'height' => '150' ] ]; $cases[] = [ '', 'canvas', [ 'width' => '300' ] ]; # Also check with numeric values $cases[] = [ '', 'canvas', [ 'height' => 150 ] ]; $cases[] = [ '', 'canvas', [ 'width' => 300 ] ]; $cases[] = [ '
', 'form', [ 'action' => 'GET' ] ]; $cases[] = [ '
', 'form', [ 'autocomplete' => 'on' ] ]; $cases[] = [ '
', 'form', [ 'enctype' => 'application/x-www-form-urlencoded' ] ]; $cases[] = [ '', 'input', [ 'formaction' => 'GET' ] ]; $cases[] = [ '', 'input', [ 'type' => 'text' ] ]; $cases[] = [ '', 'keygen', [ 'keytype' => 'rsa' ] ]; $cases[] = [ '', 'link', [ 'media' => 'all' ] ]; $cases[] = [ '', 'menu', [ 'type' => 'list' ] ]; $cases[] = [ '', 'script', [ 'type' => 'text/javascript' ] ]; $cases[] = [ '', 'style', [ 'media' => 'all' ] ]; $cases[] = [ '', 'style', [ 'type' => 'text/css' ] ]; $cases[] = [ '', 'textarea', [ 'wrap' => 'soft' ] ]; # ## SPECIFIC CASES # $cases[] = [ '', 'link', [ 'type' => 'text/css' ] ]; # specific handling $cases[] = [ '', 'input', [ 'type' => 'checkbox', 'value' => 'on' ], 'Default value "on" is stripped of checkboxes', ]; $cases[] = [ '', 'input', [ 'type' => 'radio', 'value' => 'on' ], 'Default value "on" is stripped of radio buttons', ]; $cases[] = [ '', 'input', [ 'type' => 'submit', 'value' => 'Submit' ], 'Default value "Submit" is kept on submit buttons (for possible l10n issues)', ]; $cases[] = [ '', 'input', [ 'type' => 'color', 'value' => '' ], ]; $cases[] = [ '', 'input', [ 'type' => 'range', 'value' => '' ], ]; # ', 'button', [ 'type' => 'submit' ], 'According to standard the default type is "submit". ' . 'Depending on compatibility mode IE might use "button", instead.', ]; # ', 'select', [ 'size' => '4', 'multiple' => true ], ]; # .. with numeric value $cases[] = [ '', 'select', [ 'size' => 4, 'multiple' => true ], ]; $cases[] = [ '', 'select', [ 'size' => '1', 'multiple' => false ], ]; # .. with numeric value $cases[] = [ '', 'select', [ 'size' => 1, 'multiple' => false ], ]; # Passing an array as value $cases[] = [ '', 'a', [ 'class' => [ 'css-class-one', 'css-class-two' ] ], "dropDefaults accepts values given as an array" ]; # FIXME: doDropDefault should remove defaults given in an array # Expected should be '' $cases[] = [ '', 'a', [ 'class' => [ '', '' ] ], "dropDefaults accepts values given as an array" ]; # Craft the Html elements $ret = []; foreach ( $cases as $case ) { $ret[] = [ $case[0], $case[1], $case[2], isset( $case[3] ) ? $case[3] : '' ]; } return $ret; } /** * @covers Html::input */ public function testWrapperInput() { $this->assertEquals( '', Html::input( 'testname', 'testval', 'radio' ), 'Input wrapper with type and value.' ); $this->assertEquals( '', Html::input( 'testname' ), 'Input wrapper with all default values.' ); } /** * @covers Html::check */ public function testWrapperCheck() { $this->assertEquals( '', Html::check( 'testname' ), 'Checkbox wrapper unchecked.' ); $this->assertEquals( '', Html::check( 'testname', true ), 'Checkbox wrapper checked.' ); $this->assertEquals( '', Html::check( 'testname', false, [ 'value' => 'testval' ] ), 'Checkbox wrapper with a value override.' ); } /** * @covers Html::radio */ public function testWrapperRadio() { $this->assertEquals( '', Html::radio( 'testname' ), 'Radio wrapper unchecked.' ); $this->assertEquals( '', Html::radio( 'testname', true ), 'Radio wrapper checked.' ); $this->assertEquals( '', Html::radio( 'testname', false, [ 'value' => 'testval' ] ), 'Radio wrapper with a value override.' ); } /** * @covers Html::label */ public function testWrapperLabel() { $this->assertEquals( '', Html::label( 'testlabel', 'testid' ), 'Label wrapper' ); } public static function provideSrcSetImages() { return [ [ [], '', 'when there are no images, return empty string' ], [ [ '1x' => '1x.png', '1.5x' => '1_5x.png', '2x' => '2x.png' ], '1x.png 1x, 1_5x.png 1.5x, 2x.png 2x', 'pixel depth keys may include a trailing "x"' ], [ [ '1' => '1x.png', '1.5' => '1_5x.png', '2' => '2x.png' ], '1x.png 1x, 1_5x.png 1.5x, 2x.png 2x', 'pixel depth keys may omit a trailing "x"' ], [ [ '1' => 'small.png', '1.5' => 'large.png', '2' => 'large.png' ], 'small.png 1x, large.png 1.5x', 'omit larger duplicates' ], [ [ '1' => 'small.png', '2' => 'large.png', '1.5' => 'large.png' ], 'small.png 1x, large.png 1.5x', 'omit larger duplicates in irregular order' ], ]; } /** * @dataProvider provideSrcSetImages * @covers Html::srcSet */ public function testSrcSet( $images, $expected, $message ) { $this->assertEquals( Html::srcSet( $images ), $expected, $message ); } } class HtmlTestValue { function __toString() { return 'stringValue'; } }