「ヘルプ:Parser functions in templates」の版間の差分

提供: ひつじ小屋別館2代目
移動先: 案内検索
(1版 をインポートしました)
(translation tweaks)
37行目: 37行目:
 
Condition of parameter</translate>
 
Condition of parameter</translate>
 
! <translate><!--T:9-->
 
! <translate><!--T:9-->
Sample A:</translate><br /><nowiki>{{#if: {{{1}}}|</nowiki><span style="font-variant: small-caps;"> true</span><nowiki>|</nowiki><span style="font-variant: small-caps;"> false</span><nowiki>}}</nowiki><br /><nowiki>{{#if: {{{param}}}|</nowiki><span style="font-variant: small-caps;"> true</span><nowiki>|</nowiki><span style="font-variant: small-caps;"> false</span><nowiki>}}</nowiki>
+
Sample A:</translate><br /><nowiki>{{#if: {{{1}}}|</nowiki>True<nowiki>|</nowiki>False<nowiki>}}</nowiki><br /><nowiki>{{#if: {{{param}}}|</nowiki>True<nowiki>|</nowiki>False<nowiki>}}</nowiki>
 
! <translate><!--T:10-->
 
! <translate><!--T:10-->
Sample B:</translate><br /><nowiki>{{#if: {{{1|}}}|</nowiki><span style="font-variant: small-caps;"> true</span><nowiki>|</nowiki><span style="font-variant: small-caps;"> false</span><nowiki>}}</nowiki><br /><nowiki>{{#if: {{{param|}}}|</nowiki><span style="font-variant: small-caps;"> true</span><nowiki>|</nowiki><span style="font-variant: small-caps;"> false</span><nowiki>}}</nowiki>
+
Sample B:</translate><br /><nowiki>{{#if: {{{1|}}}|</nowiki>True<nowiki>|</nowiki>False<nowiki>}}</nowiki><br /><nowiki>{{#if: {{{param|}}}|</nowiki>True<nowiki>|</nowiki>False<nowiki>}}</nowiki>
 
|-
 
|-
 
|<br /><code><nowiki>{{template}}</nowiki></code>||<translate><!--T:11-->
 
|<br /><code><nowiki>{{template}}</nowiki></code>||<translate><!--T:11-->
not defined:<br />parameter not used,<br />important for named parameters</translate>||style="background-color: #AAFFAA;" align="center"| '''TRUE'''||style="background-color: #FFAAAA;" align="center"| ''FALSE''
+
not defined:<br />parameter not used,<br />important for named parameters</translate>||style="background-color:#AFA" align="center"|'''True'''||style="background-color:#FAA" align="center"| ''False''
 
|-
 
|-
 
|<br /><code><nowiki>{{template|}} .. {{template|1=}} .. {{template|param=}}</nowiki></code>||<translate><!--T:12-->
 
|<br /><code><nowiki>{{template|}} .. {{template|1=}} .. {{template|param=}}</nowiki></code>||<translate><!--T:12-->
defined, but null/empty</translate>||style="background-color: #FFAAAA;" align="center"| ''FALSE''||style="background-color: #FFAAAA;" align="center"| ''FALSE''
+
defined, but null/empty</translate>||style="background-color:#FAA" align="center"| ''False''||style="background-color:#FAA" align="center"| ''False''
 
|-
 
|-
 
|<br /><code><nowiki>{{template|value}} .. {{template|1=value}} .. {{template|param=value}}</nowiki></code>||<translate><!--T:13-->
 
|<br /><code><nowiki>{{template|value}} .. {{template|1=value}} .. {{template|param=value}}</nowiki></code>||<translate><!--T:13-->
defined<br />and<br />NOT null neither empty</translate>||style="background-color: #AAFFAA;" align="center"| '''TRUE'''||style="background-color: #AAFFAA;" align="center"| '''TRUE'''
+
defined<br />and<br />NOT null neither empty</translate>||style="background-color:#AFA" align="center"| '''True'''||style="background-color:#AFA" align="center"| '''True'''
 
|}
 
|}
  

2016年5月28日 (土) 21:24時点における版

PD Note: When you edit this page, you agree to release your contribution under the CC0. See Public Domain Help Pages for more info.
PD
</div>

When applying ParserFunctions to template parameters, a pipe symbol ("|") may be used to provide the empty string as default value, in order to indicate how to handle things if a parameter is not passed in. In the absence of this, an undefined parameter will not expand (i.e. will expand to {{{1}}}), which is not an empty string, and thus true.

  • {{{1}}}
Sample A
{{#if: {{{1}}} | Parameter 1 is not defined, or is defined and non-null/non-empty. | Parameter 1 is null. It contains only empty string(s) or breaking space(s) etc.}}
Result
Parameter 1 is not defined, or is defined and non-null/non-empty.
  • {{{1|}}}
Sample B
{{#if: {{{1|}}} | Parameter 1 is defined and non-null/non-empty. | Parameter 1 is not defined, or is defined but null. It contains only empty string(s) or breaking space(s) etc.}}
Result
Parameter 1 is not defined, or is defined but null. It contains only empty string(s) or breaking space(s) etc.
Comparison
Example of usage in a template
unnamed first parameter (1=)
named parameter (param=)
Condition of parameter Sample A:
{{#if: {{{1}}}|True|False}}
{{#if: {{{param}}}|True|False}}
Sample B:
{{#if: {{{1|}}}|True|False}}
{{#if: {{{param|}}}|True|False}}

{{template}}
not defined:
parameter not used,
important for named parameters
True False

{{template|}} .. {{template|1=}} .. {{template|param=}}
defined, but null/empty False False

{{template|value}} .. {{template|1=value}} .. {{template|param=value}}
defined
and
NOT null neither empty
True True

The second usage ({{{1|}}}, sample B) with present empty default is often the desired way to handle situations where a parameter exists, but is comprised only of empty space.

One way to test whether a parameter was specified in a template call is thus:

{{#ifeq:{{{v|}}}|{{{v|-}}}| v was specified (and may be empty) | v was not specified }}

In rare cases, a template behaves differently when a parameter is unspecified compared to when it is specified but empty. When this template is used by a wrapper template (which uses the same set of named parameters), one way to ensure undefined parameters remain undefined is as follows (the technique also works with numbered parameters):

<!-- wrapper template code -->
{{wrapped_template|
normal_parameter={{{normal_parameter|}}}|
sensitive_parameter{{#if:{{{sensitive_parameter|}}}||NULL}}={{{sensitive_parameter}}}|
...
}}

Note that the wrapped_template receives a specified but empty normal_parameter in two cases: when normal_parameter is specified and empty, and when normal_parameter is unspecified (because the default empty value is then specified by the wrapper template).

By contrast, the wrapped_template receives a specified sensitive_parameter only when it is indeed specified, because the #if changes the wrapped_template parameter name to « sensitive_parameterNULL » when sensitive_parameter is undefined.

Note also that wrapped_template receives a specified and empty sensitive_parameter only when the wrapper template receives a specified and empty sensitive_parameter. Of course, one must make sure the suffixed wrapped_template parameter name is meaningless to the wrapped_template for this to work properly.

See also

案内メニュー