PEAR Справочное руководство
Пред.		След.

HTML_Template_IT::touchBlock()

HTML_Template_IT::touchBlock() -- preserve empty block

Synopsis

require_once 'HTML/Template/IT.php';

boolean HTML_Template_IT::touchBlock (string $block)

Описание

Preserves an empty template block, even if $removeEmptyBlocks is TRUE and no substition of placeholders took place.

Параметр

string $block - block to preserve

Возвращаемое значение

boolean - TRUE, if block was found, otherwise IT_Error.

Пример

Пример 42-1. Template - 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>

Пример 42-2. Script

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

  // Remove blocks with no placeholders, or no placeholders set ($removeEmptyBlocks=true)
  $tpl->loadTemplatefile("login.tpl.htm", true, true);

  // hypothetical
  if (login_successfull($username, $password)) {
    // print login_successfull block. 
    // login_failed is removed, due to $removeEmptyBlocks = true
    $tpl->touchBlock("login_successfull");
  } else {
    $tpl->touchBlock("login_failed");
  }

  $tpl->show();

?>

Throws

Таблица 42-1. Возможные значения PEAR_Error

Error code	Error message	Reason	Solution
`IT_BLOCK_NOT_FOUND`	" Cannot find this block `block` "	The given block does not exists.	Check for typing mistakes in the argument.

Заметка

Эта функция не должна вызываться статически.

Пред.	Начало	След.
HTML_Template_IT::show()	Уровень выше	HTML_Template_Sigma

HIVE: All information for read only. Please respect copyright!