html writer: Difference between revisions
No edit summary |
Dev Docs Bot (talk | contribs) m (Protected "html writer": Developer Docs Migration ([Edit=Allow only administrators] (indefinite))) |
||
(5 intermediate revisions by 4 users not shown) | |||
Line 1: | Line 1: | ||
{{Template:Migrated|newDocId=/docs/apis/core/htmlwriter/}} | |||
= Usage = | = Usage = | ||
Moodle has a class called html_writer which allows you to output basic HTML tags. This is typically used within renderer functions, for example question/type/''pluginname''/renderer.php. | Moodle has a class called html_writer which allows you to output basic HTML tags. This is typically used within renderer functions, for example question/type/''pluginname''/renderer.php. | ||
Line 4: | Line 5: | ||
There is no documentation for most of this class. Please look at the source code in moodle/lib/outputcomponents.php. | There is no documentation for most of this class. Please look at the source code in moodle/lib/outputcomponents.php. | ||
To allow shorter code when outputting the div and span tags with classes, < | To allow shorter code when outputting the div and span tags with classes, <syntaxhighlight lang="php">div</syntaxhighlight> and <syntaxhighlight lang="php">span</syntaxhighlight> methods were added in Moodle 2.5. | ||
= Methods = | = Methods = | ||
Line 11: | Line 12: | ||
{{Moodle 2.5}} | {{Moodle 2.5}} | ||
< | <syntaxhighlight lang="php">html_writer::div(content, class="", attributes="");</syntaxhighlight> | ||
Attributes is a key-value array. | Attributes is a key-value array. | ||
Line 25: | Line 26: | ||
== generic tags == | == generic tags == | ||
< | <syntaxhighlight lang="php"> | ||
html_writer::tag(tag_name, contents, attributes=null); | html_writer::tag(tag_name, contents, attributes=null); | ||
html_writer::start_tag(tag_name, attributes=null;); | html_writer::start_tag(tag_name, attributes=null;); | ||
Line 32: | Line 33: | ||
html_writer::nonempty_tag(tag_name, content, attributes=null); | html_writer::nonempty_tag(tag_name, content, attributes=null); | ||
html_writer::attribute(name, value); | html_writer::attribute(name, value); | ||
html_writer | html_writer::attributes(attributes_array); | ||
</ | </syntaxhighlight> | ||
= References = | = References = | ||
[[html writer | http://xref-diff.mukudu-dev.net/moodle32/lib/outputcomponents.php.html#html_writer]] | |||
[[phpcrossref.com/xref/moodle/lib/outputcomponents.php.html]] | [[phpcrossref.com/xref/moodle/lib/outputcomponents.php.html]] | ||
[[Category: Development]] | [[Category: Development]] |
Latest revision as of 09:51, 25 October 2022
Important:
This content of this page has been updated and migrated to the new Moodle Developer Resources. The information contained on the page should no longer be seen up-to-date. Why not view this page on the new site and help us to migrate more content to the new site! |
Usage
Moodle has a class called html_writer which allows you to output basic HTML tags. This is typically used within renderer functions, for example question/type/pluginname/renderer.php.
There is no documentation for most of this class. Please look at the source code in moodle/lib/outputcomponents.php.
To allow shorter code when outputting the div and span tags with classes,
div
and
span
methods were added in Moodle 2.5.
Methods
the div method
Moodle 2.5
html_writer::div(content, class="", attributes="");
Attributes is a key-value array.
Example usage:
$out .= html_writer::div('anonymous'); // <div>anonymous</div> $out .= html_writer::div('kermit', 'frog'); // <div class="frog">kermit</div> $out .= html_writer::div('Mr', 'toad', array('id' => 'tophat')); // <div class="toad" id="tophat">Mr</div>
spans
$out .= html_writer::start_span('zombie') . 'BRAINS' . html_writer::end_span(); // <span class="zombie">BRAINS</span>
generic tags
html_writer::tag(tag_name, contents, attributes=null);
html_writer::start_tag(tag_name, attributes=null;);
html_writer::end_tag(tag_name);
html_writer::empty_tag(tag_name, attributes=null);
html_writer::nonempty_tag(tag_name, content, attributes=null);
html_writer::attribute(name, value);
html_writer::attributes(attributes_array);
References
http://xref-diff.mukudu-dev.net/moodle32/lib/outputcomponents.php.html#html_writer