テンプレート:Ifempty/docのソースを表示

<noinclude>{{Documentation subpage|種類=[[Help:テンプレート|テンプレート]]}}</noinclude>
<includeonly>{{使用箇所の多いテンプレート|660,000以上}}{{Lua|モジュール:If empty}}</includeonly>
このテンプレートは他のテンプレート内で使用します。引数のうち、最初に中身の存在する引数を表示します。

== 使用例 ==
<pre>
{{ifempty| {{{logo|}}} | {{{image|}}} | default.svg }} 
</pre>

この場合、
*logo が指定されていれば、logo の値を
*logo が指定されておらず image が指定されていれば、image の値を
*logo も image も指定されていなければ、default.svg を
表示します。

== 解説 ==
[[MediaWiki]]においてテンプレート変数を処理する際、空の呼び出しをされた変数は、デフォルト値を返しません。例えば、<code>Template:Template</code>に<code><nowiki>{{{logo|default.svg}}}</nowiki></code>という処理があり、これを<code><nowiki>{{template|logo=}}</nowiki></code>と呼び出した場合、<code>"default.svg"</code>ではなく、空の値が返ってきます。

この問題を回避するためには、条件文を用いて以下のように記述します。
:<code><nowiki>{{ #if: {{{logo|}}} | {{{logo}}} | default.svg }}</nowiki></code>

別の変数が組み合わさった場合は、以下のように記述します。
:<code><nowiki>{{ #if: {{{logo|}}} | {{{logo}}} | {{ #if: {{{image|}}} | {{{image}}} | default.svg }} }}</nowiki></code>

これを本テンプレートを用いて、以下のように記述できます。
:<code><nowiki>{{ ifempty | {{{logo|}}} | {{{image|}}} | default.svg }}</nowiki></code>

== TemplateData ==
{{TemplateData header}}
<templatedata>
{
    "description": "引数のうち、最初に中身の存在する引数を表示するテンプレート。",
    "params": {
        "1": {
            "label": "1",
            "required": true,
            "description": "第1引数"
        },
        "2": {
            "label": "2",
            "required": true,
            "description": "第2引数"
        },
        "3": {
            "label": "3",
            "description": "第3引数"
        },
        "4": {
            "label": "4",
            "description": "第4引数"
        },
        "5": {
            "label": "5",
            "description": "第5引数"
        },
        "6": {
            "label": "6",
            "description": "第6引数"
        },
        "7": {
            "label": "7",
            "description": "第7引数"
        },
        "8": {
            "label": "8",
            "description": "第8引数"
        },
        "9": {
            "label": "9",
            "description": "第9引数"
        },
        "10": {
            "label": "10",
            "description": "第10引数。第11以降も現実的な範囲で使用できます。"
        }
    }
}
</templatedata>

== 関連項目 ==
* {{tl|cond}}

<includeonly>{{Sandbox other||
<!-- カテゴリは以下に追加してください -->
[[Category:条件分岐テンプレート]]
}}</includeonly>