<{include}>

<{include}> タグを使用して、現在のテンプレートに他のテンプレートをインクルードします。現在のテンプレートにて利用可能なあらゆる変数は、インクルードされたテンプレートでも同じく利用可能です。

  • <{include}> タグには、テンプレートリソースのパスを含んだ file 属性を必ず指定する必要があります。
  • file 属性に / から始まるパスを指定した場合はフルパスとして扱います。
  • file 属性が / から始まらない場合は相対パスとして扱います。基点となるディレクトリは template_dir で指定したディレクトリです。
  • 全ての割り当て変数の値は、インクルードされたテンプレート内で使用可能です。また、インクルードされたテンプレート内での変数の変更も <{include}> の後でインクルードしている側のテンプレート内で参照可能です。
属性名 必須 デフォルト 概要
file string Yes n/a インクルードするテンプレートファイル名
例. シンプルな <{include}> の例
  1. <html>
  2. <head>
  3. <title><{$title}></title>
  4. </head>
  5. <body>
  6. <{include file='page_header.tpl'}>
  7. <{* ここにテンプレートの本体を記述します。変数 $tpl_name
  8. はたとえば 'contact.tpl' などに置き換えられます。
  9. *}>
  10. <{include file="$tpl_name.tpl"}>
  11. <{include file='page_footer.tpl'}>
  12. </body>
  13. </html>
例. さまざまな <{include}> リソースの例
  1. <{* ファイルの絶対パス *}>
  2. <{include file='/usr/local/include/template/header.tpl'}>
  3. <{* windows環境の絶対パス *}>
  4. <{include file='C:/www/pub/template/header.tpl'}>
  5. <{* 変数名に格納された名前のテンプレートをインクルード - 例 $module = 'contacts' *}>
  6. <{include file="$module.tpl"}>

<{php}> も参照してください。