HTML_Template_IT::touchBlock()
HTML_Template_IT::touchBlock() – 空ブロックを保護する
Synopsis
require_once 'HTML/Template/IT.php';
boolean
HTML_Template_IT::touchBlock (
string
$block
)
Description
テンプレートにある空のブロックを保護します。 $removeEmptyBlocks に TRUE が設定されている場合や プレースホルダが置換されない場合でも、ブロックを削除せずに残します。
Parameter
-
string $block - 保護するブロック
Return value
boolean - 指定されたブロックが存在した場合に TRUE、 それ以外の場合に IT_Error を返します
Example
テンプレート - 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>
スクリプト
<?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();
?>
Throws
| エラーコード | エラーメッセージ | 原因 | 対応 |
|---|---|---|---|
| IT_BLOCK_NOT_FOUND | " Cannot find this block block " | 指定されたブロックは存在しません。 | 引数に間違いがないか確認してください。 |
Note
This function can not be called statically.
忘却曲線を使ってこの知識を確実に記憶に残す
