PEAR マニュアル
前のページ次のページ

HTML_Template_IT::touchBlock()

HTML_Template_IT::touchBlock() -- 空ブロックを保護する

概要

require_once 'HTML/Template/IT.php';

boolean HTML_Template_IT::touchBlock (string $block)

説明

テンプレートにある空のブロックを保護します。 $removeEmptyBlocks に TRUE が設定されている場合や プレースホルダが置換されない場合でも、ブロックを削除せずに残します。

パラメータ

返り値

boolean - 指定されたブロックが存在した場合に TRUE、 それ以外の場合に IT_Error を返します

例

例 47-1テンプレート - login.tpl.htm

<html>
<body>
<!-- BEGIN login_successfull -->
You have logged in successfully!
<!-- END login_successfull -->
<!-- BEGIN login_failed -->
Login failed
<!-- END login_failed -->
</body>
</html>

例 47-2スクリプト

<?php
  require_once "HTML/Template/IT.php";

  // プレースホルダが存在しなかったり、値が設定されていない
  // ブロックを削除します ($removeEmptyBlocks=true)
  $tpl->loadTemplatefile("login.tpl.htm", true, true);

  // 仮の関数
  if (login_successfull($username, $password)) {
    // login_successfull ブロックを表示します。
    // $removeEmptyBlocks = true なので、login_failed は削除されます
    $tpl->touchBlock("login_successfull");
  } else {
    $tpl->touchBlock("login_failed");
  }

  $tpl->show();

?>

例外・エラー

表 47-1PEAR_Error の値

エラーコードエラーメッセージ原因対応
IT_BLOCK_NOT_FOUND " Cannot find this block block " 指定されたブロックは存在しません。 引数に間違いがないか確認してください。

注意

この関数は、スタティックにコールする ことはできません。

前のページホーム次のページ
HTML_Template_IT::show()上に戻るHTML_Template_PHPLIB