HTML_Template_IT::touchBlock()

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

Synopsis

require_once 'HTML/Template/IT.php';

boolean HTML_Template_IT::touchBlock ( string $block )

Description

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

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"truetrue);

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

  
$tpl->show();

?>

Throws

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

Note

This function can not be called statically.

プレースホルダを置換したブロックを表示する (Previous) HTML_Template_PHPLIB (Next)
Last updated: Thu, 30 Oct 2014 — Download Documentation
Do you think that something on this page is wrong? Please file a bug report or add a note.
View this page in:

User Notes:

There are no user contributed notes for this page.