Editing Module:Buffer/doc (section)

=====Special case: Element-Buffer=====
{{code|lang=lua|empty{{ndash}}Element{{ndash}}Buffer:functionName( ... )}}<br />
{{code|lang=lua|Element{{ndash}}Buffer:_in():functionName( ... )}}

The 'empty' behavior is different when chained to empty Element-Buffer or an empty child Buffer of an Element-Buffer.

Library methods chained to an empty Buffer which parent is an [[#Element-Buffer|Element-Buffer object]] will instead string the grandparent [[#Buffer-HTML|Buffer-HTML object]] for use as the first argument before appending the result to the new Buffer. This interface is provided because Buffer-HTML objects, which are not true Buffer objects, are unable to load these functions, making this the only chainable option for Scribunto methods that includes the outer tag of non-empty Element-Buffers.

Chained on an empty Element-Buffer, these methods will string the Buffer object which created its HTML tree via {{luaself|:_inHTML}}<ref group="note">Though this strings the same object returned by {{luaself|\-HTML:getParent}}, that function is not used to avoid setting a "lastHTML" reference.</ref> and append the result to the Element-Buffer.<ref group=example>Compare the comment and source:
:{|
|{{#tag:syntaxhighlight|--[[--= Result: ===>

This is just a quick example to demonstrate a neat concept:
<div>Notice how the same object is strung which allows you to recycle boilerplate text.
<p>3 is 1 added to 2.</p>
<span>Though this is not really realistic to be fair...
Edit: not realistic at all</span>
I hope such is much to your liking.</div>

--]]--= Source: ===>
require'Module:Buffer'
	'%s is %s to %s.'--A
	:_inHTML'div'():format('Notice how the same object', 'strung which allows you', 'recycle boilerplate text')
		:tag'p'():format(3, '1 added', 2)
		:done()
		:tag'span'():format('Though this', 'not really realistic', 'be fair..')
			:_in():sub(21, 29)
				:_('\nEdit:', 1)
				:_'istic at all'
			:_out()
		:done()
		:_parent()--B
	:_out'\n'
	:format('This', 'just a quick example', 'demonstrate a neat trick',--A
		'I hope such', 'much', 'your liking')--B
	:gsub('trick.', 'concept:\n')|lang=lua}}
|}</ref>
|}