{include}関数 他のテンプレートを読み込む
現在のテンプレートに他のテンプレートを読み込みます。
現在のテンプレートにて利用可能な変数は、読み込まれたテンプレートでも同じく利用可能です。
{include} の出力をブラウザに表示する代わりに変数に格納したい場合は、
オプションの assign 属性にその変数名を定義します。
読み込まれたテンプレートに変数を渡すには、属性値を使用します。
ここで明示的に渡された変数は、読み込まれたファイルの範囲でのみ有効となります。
そのテンプレートに同じ名前の変数が存在する場合は、渡された変数がそれを上書きします。
全ての割り当て変数の値は、読み込まれたテンプレートの処理が完了すると元に戻ります。
このため読み込まれたテンプレート内での変数の変更は、読み込んだ側のテンプレート内では見ることはできません。
$template_dir ディレクトリ外にあるファイルを {include} するには、 テンプレートリソース を指定します。
属性名 | 型 | 必須 | デフォルト | 概要 |
---|---|---|---|---|
file | string | Yes | n/a | インクルードするテンプレートファイル名 |
assign | string | No | n/a | インクルードしたコンテンツの出力を格納する変数名 |
[var ...] | [var type] | No | n/a | ローカルからテンプレートに渡す変数 |
関連記事
- {strip}関数 各行の先頭と終端にある半角スペースや改行を除去する
- {php}関数 PHP コードを直接テンプレートに書き込む
- {literal}関数 構文解析の対象にしない
- {ldelim},{rdelim} デリミタを表示する
- {insert}関数 関数を読み込む
- {include_php}関数 PHP スクリプトを読み込む
- {config_load}関数 設定ファイル から変数を読み込む
- {capture}関数 出力を変数に受け渡す
- {section}関数 テンプレート内で繰り返し
- {foreach}関数 テンプレート内で繰り返し
- {if}関数 条件文
スポンサーリンク