View source for Module:For each named parameter/doc

This module allows templates to take arbitrary named parameters and execute wiki code for each name-value pair.

Syntax:

<code><nowiki>{{#invoke:</nowiki>For each named parameter|main|''separator''|code=''code''}}</code>

''code'' can also be given without a name:

<code><nowiki>{{#invoke:</nowiki>For each named parameter|main|''separator''|''code''}}</code>

Runs ''code'' for each named parameter of the parent template, with the name available as <code><nowiki>{{{name}}}</nowiki></code> and the value as <code><nowiki>{{{value}}}</nowiki></code>. The results are concatenated and separated by ''separator''.

The code should be wrapped in <syntaxhighlight lang="wikitext" inline><nowiki>...</nowiki></syntaxhighlight> tags. Otherwise, it is evaluated before the module is invoked, which may lead to unexpected results.

== Examples ==

=== Simple example ===

[[Module:For each named parameter/example0]] has the wikitext:
{{#invoke:page|getContent|Module:For each named parameter/example0|as=pre}}

Hence, calling it with some params:
<pre>
{{Module:For each named parameter/example0|a=b|c=d|e=f}}
</pre>
produces:

{{Module:For each named parameter/example0|a=b|c=d|e=f}}

=== Example demonstrating why &lt;nowiki> tags are recommended ===

[[Module:For each named parameter/example0]] has the wikitext:
{{#invoke:page|getContent|Module:For each named parameter/example0|as=pre}}
Note that the code is not wrapped in <syntaxhighlight lang="wikitext" inline><nowiki>...</nowiki></syntaxhighlight> tags.
Hence, calling it with params <code>name</code> and <code>value</code>:
<pre>
{{Module:For each named parameter/example0|name=name was replaced|value=value was replaced|a=b|c=d}}
</pre>
produces:

{{Module:For each named parameter/example0|name=name was replaced|value=value was replaced|a=b|c=d}}

=== Example with line breaks ===

[[Module:For each named parameter/example1]] has the wikitext:
{{#invoke:page|getContent|Module:For each named parameter/example1|as=pre}}
(Note the line breaks in the separator.)

Hence, calling it with some params:
<pre>
{{Module:For each named parameter/example1|a=b|c=d|e=f}}
</pre>
produces:
{{Module:For each named parameter/example1|a=b|c=d|e=f}}

=== Example with special handling of a parameter ===

[[Module:For each named parameter/example2]] has the wikitext:
{{#invoke:page|getContent|Module:For each named parameter/example2|as=pre}}
It generates a table row for each parameter, but not for the <code>title</code> parameter (since it should only appear as the table title). Instead, it produces an empty string (note the <code>||</code>). Generally, if the code produces an empty string for a parameter, the module omits it and also does not emit a separator.

Hence, calling it with these params:
<pre>
{{Module:For each named parameter/example2|title=My Title|a=b|c=d|e=f}}
</pre>
produces:

{{Module:For each named parameter/example2|title=My Title|a=b|c=d|e=f}}

Note that due to technical limitations (of Lua tables), the order in which the parameters are processed cannot be guaranteed.

== See also ==
{{Infinite parameters modules}}

<includeonly>{{Sandbox other||
<!-- Categories below this line; interwikis at Wikidata -->
[[Category:Template metamodules]]
[[Category:Wikitext processing modules]]
}}</includeonly><noinclude>
[[Category:Module documentation pages]]
</noinclude>