HTML_Template_IT::touchBlock() -- 空ブロックを保護する
説明
テンプレートにある空のブロックを保護します。
$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
"
|
指定されたブロックは存在しません。
|
引数に間違いがないか確認してください。
|
注意
この関数は、スタティックにコールする
ことはできません。
