Search moodle.org's
Developer Documentation

See Release Notes
Long Term Support Release

  • Bug fixes for general core bugs in 4.1.x will end 13 November 2023 (12 months).
  • Bug fixes for security issues in 4.1.x will end 10 November 2025 (36 months).
  • PHP version: minimum PHP 7.4.0 Note: minimum PHP version has increased since Moodle 4.0. PHP 8.0.x is supported too.
<?php
// This file is part of Moodle - http://moodle.org/
//
// Moodle is free software: you can redistribute it and/or modify
// it under the terms of the GNU General Public License as published by
// the Free Software Foundation, either version 3 of the License, or
// (at your option) any later version.
//
// Moodle is distributed in the hope that it will be useful,
// but WITHOUT ANY WARRANTY; without even the implied warranty of
// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
// GNU General Public License for more details.
//
// You should have received a copy of the GNU General Public License
// along with Moodle.  If not, see <http://www.gnu.org/licenses/>.

/**
 * Unit tests for the html_writer class.
 *
 * @package   core
 * @category  phpunit
 * @copyright 2010 Tim Hunt
 * @license   http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later
 */

defined('MOODLE_INTERNAL') || die();

global $CFG;
require_once($CFG->libdir . '/outputcomponents.php');

<
/** * Unit tests for the html_writer class. * * @copyright 2010 Tim Hunt * @license http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later
> * @covers \html_writer */ > * @coversDefaultClass \html_writer
< class core_html_writer_testcase extends basic_testcase {
> class html_writer_test extends basic_testcase {
> /** public function test_start_tag() { > * @covers ::start_tag $this->assertSame('<div>', html_writer::start_tag('div')); > */
}
> /** public function test_start_tag_with_attr() { > * @covers ::start_tag $this->assertSame('<div class="frog">', > */
html_writer::start_tag('div', array('class' => 'frog'))); }
> /** public function test_start_tag_with_attrs() { > * @covers ::start_tag $this->assertSame('<div class="frog" id="mydiv">', > */
html_writer::start_tag('div', array('class' => 'frog', 'id' => 'mydiv'))); }
> /** public function test_end_tag() { > * @covers ::end_tag $this->assertSame('</div>', html_writer::end_tag('div')); > */
}
> /** public function test_empty_tag() { > * @covers ::empty_Tag $this->assertSame('<br />', html_writer::empty_tag('br')); > */
}
> /** public function test_empty_tag_with_attrs() { > * @covers ::empty_Tag $this->assertSame('<input type="submit" value="frog" />', > */
html_writer::empty_tag('input', array('type' => 'submit', 'value' => 'frog'))); }
> /** public function test_nonempty_tag_with_content() { > * @covers ::nonempty_tag $this->assertSame('<div>Hello world!</div>', > */
html_writer::nonempty_tag('div', 'Hello world!')); }
> /** public function test_nonempty_tag_empty() { > * @covers ::nonempty_tag $this->assertSame('', > */
html_writer::nonempty_tag('div', '')); }
> /** public function test_nonempty_tag_null() { > * @covers ::nonempty_tag $this->assertSame('', > */
html_writer::nonempty_tag('div', null)); }
> /** public function test_nonempty_tag_zero() { > * @covers ::nonempty_tag $this->assertSame('<div class="score">0</div>', > */
html_writer::nonempty_tag('div', 0, array('class' => 'score'))); }
> /** public function test_nonempty_tag_zero_string() { > * @covers ::nonempty_tag $this->assertSame('<div class="score">0</div>', > */
html_writer::nonempty_tag('div', '0', array('class' => 'score'))); }
> /** public function test_div() { > * @covers ::div // All options. > */
$this->assertSame('<div class="frog" id="kermit">ribbit</div>', html_writer::div('ribbit', 'frog', array('id' => 'kermit'))); // Combine class from attributes and $class. $this->assertSame('<div class="amphibian frog">ribbit</div>', html_writer::div('ribbit', 'frog', array('class' => 'amphibian'))); // Class only. $this->assertSame('<div class="frog">ribbit</div>', html_writer::div('ribbit', 'frog')); // Attributes only. $this->assertSame('<div id="kermit">ribbit</div>', html_writer::div('ribbit', '', array('id' => 'kermit'))); // No options. $this->assertSame('<div>ribbit</div>', html_writer::div('ribbit')); }
> /** public function test_start_div() { > * @covers ::start_div // All options. > */
$this->assertSame('<div class="frog" id="kermit">', html_writer::start_div('frog', array('id' => 'kermit'))); // Combine class from attributes and $class. $this->assertSame('<div class="amphibian frog">', html_writer::start_div('frog', array('class' => 'amphibian'))); // Class only. $this->assertSame('<div class="frog">', html_writer::start_div('frog')); // Attributes only. $this->assertSame('<div id="kermit">', html_writer::start_div('', array('id' => 'kermit'))); // No options. $this->assertSame('<div>', html_writer::start_div()); }
> /** public function test_end_div() { > * @covers ::end_div $this->assertSame('</div>', html_writer::end_div()); > */
}
> /** public function test_span() { > * @covers ::span // All options. > */
$this->assertSame('<span class="frog" id="kermit">ribbit</span>', html_writer::span('ribbit', 'frog', array('id' => 'kermit'))); // Combine class from attributes and $class. $this->assertSame('<span class="amphibian frog">ribbit</span>', html_writer::span('ribbit', 'frog', array('class' => 'amphibian'))); // Class only. $this->assertSame('<span class="frog">ribbit</span>', html_writer::span('ribbit', 'frog')); // Attributes only. $this->assertSame('<span id="kermit">ribbit</span>', html_writer::span('ribbit', '', array('id' => 'kermit'))); // No options. $this->assertSame('<span>ribbit</span>', html_writer::span('ribbit')); }
> /** public function test_start_span() { > * @covers ::start_span // All options. > */
$this->assertSame('<span class="frog" id="kermit">', html_writer::start_span('frog', array('id' => 'kermit'))); // Combine class from attributes and $class. $this->assertSame('<span class="amphibian frog">', html_writer::start_span('frog', array('class' => 'amphibian'))); // Class only. $this->assertSame('<span class="frog">', html_writer::start_span('frog')); // Attributes only. $this->assertSame('<span id="kermit">', html_writer::start_span('', array('id' => 'kermit'))); // No options. $this->assertSame('<span>', html_writer::start_span()); }
> /** public function test_end_span() { > * @covers ::end_span $this->assertSame('</span>', html_writer::end_span()); > */
}
> /** public function test_table() { > * @covers ::table $row = new html_table_row(); > * @covers \html_table_row > * @covers \html_table_cell // The attribute will get overwritten by the ID. > * @covers \html_table $row->id = 'Bob'; > */
$row->attributes['id'] = 'will get overwritten'; // The data-name will be present in the output. $row->attributes['data-name'] = 'Fred'; $row->class = 'this is a table row'; $cell = new html_table_cell(); // The attribute will get overwritten by the ID. $cell->id = 'Jeremy'; $cell->attributes['id'] = 'will get overwritten'; // The data-name will be present in the output. $cell->attributes['data-name'] = 'John'; $cell->class = 'this is a table cell'; $row->cells[] = $cell; $table = new html_table();
> $table->responsive = false;
// The attribute will get overwritten by the ID. $table->id = 'Jeffrey'; $table->attributes['id'] = 'will get overwritten'; // The data-name will be present in the output. $table->attributes['data-name'] = 'Colin'; // The attribute will get overwritten by the ID above. $table->data[] = $row; // Specify a caption to be output. $table->caption = "A table of meaningless data."; $output = html_writer::table($table); $expected = <<<EOF <table class="generaltable" id="Jeffrey" data-name="Colin"> <caption>A table of meaningless data.</caption><tbody><tr class="lastrow" id="Bob" data-name="Fred"> <td class="cell c0 lastcol" id="Jeremy" data-name="John" style=""></td> </tr> </tbody> </table> EOF; $this->assertSame($expected, $output); }
> /** public function test_table_hidden_caption() { > * @covers ::table > */
$table = new html_table(); $table->id = "whodat"; $table->data = array( array('fred', 'MDK'), array('bob', 'Burgers'), array('dave', 'Competitiveness') ); $table->caption = "Who even knows?"; $table->captionhide = true;
> $table->responsive = false;
$output = html_writer::table($table); $expected = <<<EOF <table class="generaltable" id="whodat"> <caption class="accesshide">Who even knows?</caption><tbody><tr class=""> <td class="cell c0" style="">fred</td> <td class="cell c1 lastcol" style="">MDK</td> </tr> <tr class=""> <td class="cell c0" style="">bob</td> <td class="cell c1 lastcol" style="">Burgers</td> </tr> <tr class="lastrow"> <td class="cell c0" style="">dave</td> <td class="cell c1 lastcol" style="">Competitiveness</td> </tr> </tbody> </table> EOF; $this->assertSame($expected, $output); } }