imported>Oetterer am 15. März 2018 um 09:02 Uhr

2018-03-15T09:02:48Z

← Nächstältere Version		Version vom 15. März 2018, 11:02 Uhr
Zeile 1:		Zeile 1:
	{{documentation subpage}}		{{documentation subpage}}
	{{Deprecated template\|HtmlBuilder\|mw:Extension:Scribunto/Lua reference manual#HTML library}}		{{Deprecated template\|HtmlBuilder\|mw:Extension:Scribunto/Lua reference manual#HTML library{{!}}mw.html}}
	{{module rating\|protected}}		{{module rating\|protected}}
	HtmlBuilder provides a way to construct complex HTML and CSS markup by creating a tree of nodes, similar to the [[Document Object Model]]. The result is a list of codes that are more comprehensible and maintainable than if you simply concatenated strings together. It offers a [[fluent interface]] that should look familiar to any user of [[jQuery]].		HtmlBuilder provides a way to construct complex HTML and CSS markup by creating a tree of nodes, similar to the [[wpen:Document Object Model\|Document Object Model]]. The result is a list of codes that are more comprehensible and maintainable than if you simply concatenated strings together. It offers a [[wpen:fluent interface\|fluent interface]] that should look familiar to any user of [[wpen:jQuery\|jQuery]].

	'''Note: This module is deprecated in favour of [[mw:Extension:Scribunto/Lua reference manual#HTML library\|mw.html]].'''		'''Note: This module is deprecated in favour of [[mw:Extension:Scribunto/Lua reference manual#HTML library\|mw.html]].'''
Zeile 82:		Zeile 82:
	</syntaxhighlight>		</syntaxhighlight>


	~~For more examples, please see the [[Module:HtmlBuilder/testcases\|test cases page]] and the [[Module talk:HtmlBuilder/testcases\|test cases results]].~~
	<includeonly>{{#ifeq:{{SUBPAGENAME}}\|sandbox\|\|		<includeonly>{{#ifeq:{{SUBPAGENAME}}\|sandbox\|\|
	<!-- Categories go here if not set by {{module rating}} above (in which case you can use default [[Category:modules]]. -->		<!-- Categories go here if not set by {{module rating}} above (in which case you can use default [[Category:modules]]. -->
	[[Category:Lua metamodules]]		[[Category:Lua metamodules]]
	}}</includeonly>		}}</includeonly>

mw>Oetterer am 7. Oktober 2014 um 12:06 Uhr

2014-10-07T12:06:10Z

Neue Seite

{{documentation subpage}}
{{Deprecated template|HtmlBuilder|mw:Extension:Scribunto/Lua reference manual#HTML library}}
{{module rating|protected}}
HtmlBuilder provides a way to construct complex HTML and CSS markup by creating a tree of nodes, similar to the [[Document Object Model]]. The result is a list of codes that are more comprehensible and maintainable than if you simply concatenated strings together. It offers a [[fluent interface]] that should look familiar to any user of [[jQuery]].

'''Note: This module is deprecated in favour of [[mw:Extension:Scribunto/Lua reference manual#HTML library|mw.html]].'''

== Usage ==

First, you need to load the module:

<code>local HtmlBuilder = require('Module:HtmlBuilder')</code>

Next, create the root HtmlBuilder instance:

<code>local builder = HtmlBuilder.create()</code>

Then, you can build HTML using the methods of the HtmlBuilder instance, listed below.

Finally, get the resulting HTML markup as a string:

<code>local s = tostring(builder)</code>

== Methods ==
To allow chaining, all methods return a reference to the builder, unless otherwise stated.

===tag===
<code>local div = builder.tag('div')</code>
Appends a new child node to the builder, and returns an HtmlBuilder instance representing that new node.

===done===
<code>builder = div.done()</code>
Returns the parent node under which the current node was created. Like [http://api.jquery.com/end/ jQuery.end], this is a convenience function to allow the construction of several child nodes to be chained together into a single statement.

===allDone===
<code>builder = div.allDone()</code>
Like <code>.done()</code>, but traverses all the way to the root node of the tree and returns it.

===wikitext===
<code><nowiki>div.wikitext('This is some [[example]] text.')</nowiki></code>
Appends some markup to the node. It may include plain text, wiki markup, and even HTML markup.

===newline===
<code>div.newline()</code>
Appends a newline character to the node. Equivalent to <code>.wikitext('\n')</code>.

===attr===
<code>div.attr('title', 'Attr value')</code>
Set an HTML attribute on the node.

===css===
<code>div.css('color', '#f00')</code>
Set a CSS property to be added to the node's <code>style</code> attribute.

===cssText===
<code>div.cssText('color:#f00; font-size:1.5em')</code>
Add some raw CSS to the node's <code>style</code> attribute. This is typically used when a template allows some CSS to be passed in as a parameter, such as the <code>liststyle</code> parameter of {{tl|Navbox}}.

===addClass===
<code>div.addClass('even')</code>
Adds a class name to the node's <code>class</code> attribute. Spaces will be automatically added to delimit each added class name.

== Examples ==

<syntaxhighlight lang="lua">
local HtmlBuilder = require('Module:HtmlBuilder')

local root = HtmlBuilder.create()

root
.wikitext('Lorem ')
.tag('span')
.css('color', 'red')
.attr('title', 'ipsum dolor')
.wikitext('sit amet')
.done()
.tag('div')
.wikitext('consectetur adipisicing')

local s = tostring(root)
-- s = 'Lorem <span style="color:red;" title="ipsum dolor">sit amet</span><div>consectetur adipisicing</div>'
</syntaxhighlight>

For more examples, please see the [[Module:HtmlBuilder/testcases|test cases page]] and the [[Module talk:HtmlBuilder/testcases|test cases results]].
<includeonly>{{#ifeq:{{SUBPAGENAME}}|sandbox||

[[Category:Lua metamodules]]
}}</includeonly>

Modul:HtmlBuilder/doc - Versionsgeschichte

imported>Oetterer am 15. März 2018 um 09:02 Uhr

mw>Oetterer am 7. Oktober 2014 um 12:06 Uhr