PEAR里HTML_Template_IT摸板类的用法_PHP

PEAR里的HTML_Template_IT是一个简单而且容易使用的类。


********** 建立一个模板文件 ****************
“符号”命名规则 为下面的正则表达式：
{[0-9A-Za-z_-] }
”块“ 格式为下面的，块名的命名规则和“符号”一样的：

... 块内容 ...

块允许嵌套，你必须首先设置并分析最内层的块，然后再设置和分析上一层的块。





*********** 主要方法 ***********
构造函数：
void IntegratedTemplate::IntegratedTemplate ([string $root = ""])
$root = 摸板根目录
你也可以用
void IntegratedTemplate::setRoot (string $root)
方法设置模板目录；该方法不能被静态调用。
---------------------------------------------------------
加载模板：
boolean IntegratedTemplate::loadTemplatefile (string $filename, boolean [$removeUnknownVariables = TRUE], boolean [$removeEmptyBlocks = TRUE])
$filename = 模板文件名
$removeUnknownVariables = 设置是否移除未知的变量
$removeEmptyBlocks = 设置是否移除空块
成功返回TRUE，失败返回FALSE。
该方法不能被静态调用
-------------------------------------------------------
指定当前要处理的块：
boolean IntegratedTemplate::setCurrentBlock ([string $block = "__global"])
$block = 块名
成功返回TRUE，失败会返回一个PEAR_Error对象，里面包含错误
描述。该方法不能被静态调用。
-------------------------------------------------------
用变量替换当前要处理的块里的“符号”：
void IntegratedTemplate::setVariable (mixed $placeholder [, mixed $variable = ""])
$placeholder = 要替换的符号名，如果$variable是一个数组，
那就用符号名作为这个数组的索引并用这个索
引的数组元素的数据替换符号
$variable = 变量名或数组名
该函数不能被静态调用
--------------------------------------------------------
分析当前正处理的块：
void IntegratedTemplate::parseCurrentBlock ()
失败会返回一个PEAR_Error对象，里面包含错误
描述。该方法不能被静态调用。
---------------------------------------------------------
处理完成输出：
void IntegratedTemplate::show ([string $block])
$block = 要返回的块
如果没设置$block，将返回完整的模板


******************* 简单示例（示例来自PEAR的在线手册）*****
Usage Example
Example 25-1. main.tpl.htm模板文件，在"./templates"目录下

{DATA}

{DATA}








Example 25-2. PHP脚本

require_once "HTML/Template/IT.php";

$data = array
(
"0" => array("Stig", "Bakken"),
"1" => array("Martin", "Jansen"),
"2" => array("Alexander", "Merz")
);

$tpl = new HTML_Template_IT("./templates");

$tpl->loadTemplatefile("main.tpl.htm", true, true);

foreach($data as $name) {
foreach($name as $cell) {
// Assign data to the inner block
$tpl->setCurrentBlock("cell") ;
$tpl->setVariable("DATA", $cell) ;
$tpl->parseCurrentBlock("cell") ;
}
// Assign data and the inner block to the
// outer block
$tpl->setCurrentBlock("row") ;
$tpl->parseCurrentBlock("row") ;
} // 输出
$tpl->show();

Stig	Bakken
Martin	Jansen
Alexander	Merz

?>Example 25-3. 输出

Stig	Bakken
Martin	Jansen
Alexander	Merz

*******************************************************
HTML_Template_IT里面还有一个ITX类，可以完成更加复杂的功能，
继承自IT类；ITX。PHP文件的原代码里包含了这个类的方法说明。

关于HTML_Template_IT其他方法的详细说明请参见PEAR的手册，地址为
http://pear.php.net/manual/en/package.html.html-template-it.php

--希望大家能好好利用PEAR这个库写出更多更好的PHP程序！--