Action 视图助手允许视图脚本执行一个特定的控制器Action；在执行之后的响应对象的结果将被返回。有时候特定的Action生成可重用内容或“widget-ized”内容（在页面内生成一个带有特定功能的小面板，类似于Windows Vista的widget，Haohappy注），这时我们就可以使用本功能。

内部调用_forward() 或者转向的Action在此将无效，将返回空字符串。

Action视图助手的API和大部分MVC组件调用控制器动作的方式一样：action($action,$controller, $module = null, array $params = array())。$action 和 $controller 是必须的；如果没有指定模块，缺省模块将被使用。

<div id="sidebar right">
    <div class="item">
        <?= $this->action('list', 'comment', null, array('count' => 10)); ?>
    </div>
</div>

        

Partial 视图助手被用来在它自己的变量范围内解析特定的模板。主要用法是（解析）可重用的模板片段，你不需要操心变量名的冲突。另外，它们让你从特定的模块指定 partial 视图脚本。

Partial 的兄弟 PartialLoop 视图助手允许传递可迭代数据并为每个条目解析一部分。

<?php // partial.phtml ?>
<ul>
    <li>From: <?= $this->escape($this->from) ?></li>
    <li>Subject: <?= $this->escape($this->subject) ?></li>
</ul>

<?= $this->partial('partial.phtml', array(
    'from' => 'Team Framework',
    'subject' => 'view partials')); ?>

<ul>
    <li>From: Team Framework</li>
    <li>Subject: view partials</li>
</ul>

Note: 什么是模型（model）?
和 Partial 视图助手一起使用的模型（即partial()的第二个参数，Haohappy注）可以是下列其中之一：

• 数组 。如果传递了数组，它应当是联合数组，因为它的 ‘键/值’ 对用作为视图变量的键赋值给视图。

• 实现了toArray() 方法的对象 。如果被传递的对象有 toArray() 方法，toArray()的结果将被当作视图变量赋值给视图对象。

• 标准对象 。 任何其它对象将把object_get_vars()的结果（对象的所有公共属性）赋值给视图对象。

如果你的模型是一个对象，你可能想让它作为对象传递给 partial 脚本，而不是把它系列化成一个数组变量。 你可以通过设置适当的助手的 'objectKey' 属性来完成这个：

// Tell partial to pass objects as 'model' variable
$view->partial()->setObjectKey('model');

// Tell partial to pass objects from partialLoop as 'model' variable in final
// partial view script:
$view->partialLoop()->setObjectKey('model');

当传递 Zend_Db_Table_Rowsets 给 partialLoop()时这个技术相当有用， 因为你在视图脚本里有全部访问 row 对象的权限，允许你调用它们的方法（如从父或依赖的 rows 获取数据）。

<? // partialLoop.phtml ?>
    <dt><?= $this->key ?></dt>
    <dd><?= $this->value ?></dd>

<?php
$model = array(
    array('key' => 'Mammal', 'value' => 'Camel'),
    array('key' => 'Bird', 'value' => 'Penguin'),
    array('key' => 'Reptile', 'value' => 'Asp'),
    array('key' => 'Fish', 'value' => 'Flounder'),
);
?>

<dl>
<?= $this->partialLoop('partialLoop.phtml', $model) ?>
</dl>

<dl></dl>
    <dt>Mammal</dt>
    <dd>Camel</dd>

    <dt>Bird</dt>
    <dd>Penguin</dd>

    <dt>Reptile</dt>
    <dd>Asp</dd>

    <dt>Fish</dt>
    <dd>Flounder</dd>

</dl>

<?= $this->partial('pager.phtml', 'list', $pagerData) ?>

Placeholder 视图助手用来在视图脚本和视图实例之间持久化内容。它也提供一些有用的功能如：聚合内容、抓取视图脚本内容以后来用和添加前置（pre-）和后置（post-）文本到内容 （还可以为聚合内容定制分隔符等）。

<?php $this->placeholder('foo')->set("Some text for later") ?>

<?php
    echo $this->placeholder('foo');
    // outputs "Some text for later"
?>

<!-- first view script -->
<?php $this->placeholder('foo')->exchangeArray($this->data) ?>

<!-- later view script -->
<?php
$this->placeholder('foo')->setPrefix("<ul>\n    <li>")
                         ->setSeparator("</li><li>\n")
                         ->setIndent(4)
                         ->setPostfix("</li></ul>\n");
?>

<?php
    echo $this->placeholder('foo');
    //输出一个带有漂亮缩进的HTML无序列表
?>

<?php $this->placeholder('foo')->bar = $this->data ?>
<?php echo $this->placeholder('foo')->bar ?>

<?php
$foo = $this->placeholder('foo');
echo $foo['bar'];
?>

<!-- Default capture: append -->
<?php $this->placeholder('foo')->captureStart();
foreach ($this->data as $datum): ?>
<div class="foo">
    <h2><?= $datum->title ?></h2>
    <p><?= $datum->content ?></p>
</div>
 <?php endforeach; ?>
<?php $this->placeholder('foo')->captureEnd() ?>

<?php echo $this->placeholder('foo') ?>

<!-- Capture to key -->
<?php $this->placeholder('foo')->captureStart('SET', 'data');
foreach ($this->data as $datum): ?>
<div class="foo">
    <h2><?= $datum->title ?></h2>
    <p><?= $datum->content ?></p>
</div>
 <?php endforeach; ?>
<?php $this->placeholder('foo')->captureEnd() ?>

<?php echo $this->placeholder('foo')->data ?>

有效的HTML和XHTML文档应当包括一个 DOCTYPE 声明。但是文档类型声明很难记忆，而且会影响到文档中的特定元素的解析（例如，在 <script> 和 <style> 元素中转义的CDATA）。

Doctype 助手允许指定下列类型之一：

• XHTML11

• XHTML1_STRICT

• XHTML1_TRANSITIONAL

• XHTML1_FRAMESET

• XHTML_BASIC1

• HTML4_STRICT

• HTML4_LOOSE

• HTML4_FRAMESET

你也可以指定一个自己定制的带有良好结构的文档类型。

Doctype助手是 占位符助手 的一个具体的实现。

$doctypeHelper = new Zend_View_Helper_Doctype();
$doctypeHelper->doctype('XHTML1_STRICT');

<?php echo $this->doctype() ?>

<?php
$doctype = $view->doctype()->getDoctype();
?>

<?php
if ($view->doctype()->isXhtml()) {
    // do something differently
}
?>

HTML的 <link> 标签越来越多地用于为你的站点链接不同资源：stylesheet, feed, favicon, trackback等。HeadLink 助手提供了一个简单的接口用来创建和聚合这些元素以供稍后在你的布局脚本里获取和输出。

HeadLink 助手有以下特殊的方法用来添加 stylesheet 链接：

• appendStylesheet($href, $media, $conditionalStylesheet)

• offsetSetStylesheet($index, $href, $media, $conditionalStylesheet)

• prependStylesheet($href, $media, $conditionalStylesheet)

• setStylesheet($href, $media, $conditionalStylesheet)

$media 值缺省为 'screen'，但可以为任何有效的媒体(media)值。$conditionalStylesheet 是布尔值，将用于解析时来决定是否有特殊的注释应该被包括以防止在特定的平台上加载stylesheet。

另外，HeadLink 助手有特殊的方法用来添加 'alternate' 链接到它的堆栈：

• appendAlternate($href, $type, $title)

• offsetSetAlternate($index, $href, $type, $title)

• prependAlternate($href, $type, $title)

• setAlternate($href, $type, $title)

headLink() 助手方法允许指定所有的必要的属性给 <link> 元素， 也允许指定替代 － 是否新元素替换所有其他的，前置（栈顶），或追加（栈底）。

HeadLink 助手是 占位符助手 的一个具体实现。

<?php // 在视图脚本中设置链接：
$this->headLink()->appendStylesheet('/styles/basic.css')
                 ->headLink(array('rel' => 'favicon', 'href' => '/img/favicon.ico'), 'PREPEND')
                 ->prependStylesheet('/styles/moz.css', 'screen', true);
?>
<?php // 解析链接：?>
<?= $this->headLink() ?>

HTML <meta>元素用来提供关于HTML文档的 meta 信息－如关键字，文档字符集，缓冲的 pragama 等。Meta标签可以是'http-equiv' 或 'name' 类型，必须包含'content'属性，并且也可以有 'lang' 或 'scheme' 修饰属性。

HeadMeta 助手提供下列方法来设置和添加 meta 标签：

• appendName($keyValue, $content, $conditionalName)

• offsetSetName($index, $keyValue, $content, $conditionalName)

• prependName($keyValue, $content, $conditionalName)

• setName($keyValue, $content, $modifiers)

• appendHttpEquiv($keyValue, $content, $conditionalHttpEquiv)

• offsetSetHttpEquiv($index, $keyValue, $content, $conditionalHttpEquiv)

• prependHttpEquiv($keyValue, $content, $conditionalHttpEquiv)

• setHttpEquiv($keyValue, $content, $modifiers)

$keyValue 参数用来定义'name'的值或'http-equive'键；$content 是'content' 键的值，$modifiers 是可选的包含'lang' 和/或 'scheme'键的联合数组。

也可以用 headMeta() 助手方法来设置 meta 标签：headMeta($content, $keyValue, $keyType = 'name', $modifiers = array(), $placement = 'APPEND')。$keyValue 是指定在 $keyType 里的键的内容，$keyType 应该是'name' 或 'http-equiv'。$placement 可以是 'SET' （覆盖所有先前存储的值）， 'APPEND' （添加到栈尾）或 'PREPEND'（添加到栈顶）。

HeadMeta 覆盖每个 append()、offsetSet()、 prepend() 和 set() 来加强上面列出的特殊方法的用法。在内部，它存储每个条目为 stdClass 令牌，它稍后用 itemToString() 方法来序列化。这允许在堆栈的条目中执行检查，并可选地通过修改对象返回来修改这些条目。

HeadMeta助手是 占位符助手 的一个具体实现。

<?php // setting meta keywords
$this->headMeta()->appendName('keywords', 'framework php productivity');
?>

<?php // 禁止客户端缓存
$this->headMeta()->appendHttpEquiv('expires', 'Wed, 26 Feb 1997 08:21:57 GMT')
                 ->appendHttpEquiv('pragma', 'no-cache')
                 ->appendHttpEquiv('Cache-Control', 'no-cache');
?>

<?php // setting content type and character set
$this->headMeta()->appendHttpEquiv('Content-Type', 'text/html; charset=UTF-8')
                 ->appendHttpEquiv('Content-Language', 'en-US');
?>

<?php // 设置以下meta可使页面3秒钟后转向一个新的url
$this->headMeta()->appendHttpEquiv('Refresh', '3;URL=http://www.some.org/some.html');
?>

<?= $this->headMeta() ?>

HTML <script> 元素用来提供内嵌的客户端脚本元素或链接到远程包含客户端脚本代码的资源。你可以用HeadScript 助手来管理它们。

HeadScript 助手支持下列方法来设置和添加脚本：

• appendFile($src, $type = 'text/javascript', $attrs = array())

• offsetSetFile($index, $src, $type = 'text/javascript', $attrs = array())

• prependFile($src, $type = 'text/javascript', $attrs = array())

• setFile($src, $type = 'text/javascript', $attrs = array())

• appendScript($script, $type = 'text/javascript', $attrs = array())

• offsetSetScript($index, $script, $type = 'text/javascript', $attrs = array())

• prependScript($script, $type = 'text/javascript', $attrs = array())

• setScript($script, $type = 'text/javascript', $attrs = array())

对于所有*File()方法，$src 是要加载的脚本的远程位置，常常以 URL 或路径的形式表示。 对于所有*Script()方法，$script是客户端你想用于元素中的脚本。

HeadScript也允许抓取脚本，然后放到其它地方，如果你想通过程序生成客户端脚本，这将很有用。下面的例子里有它的用法。

最后，你也可以用 headScript()方法 来快速地添加脚本元素，它的用法是： headScript($mode = 'FILE', $spec, $placement = 'APPEND')。$mode 是指链接一个文件还是一个脚本，可以是'FILE' 或 'SCRIPT' ，$spec 是链接的脚本文件或脚本代码。$placement必须为'APPEND', 'PREPEND', 或'SET'其中之一.

HeadScript 覆盖 append()， offsetSet()，prepend() 和 set() 中的每一个来加强上述特殊方法的用法。在内部，它存储每个条目为 stdClass 令牌，它在稍后用 itemToString() 方法 serializes 。这允许在堆栈里检查条目，并可选地通过修改返回的对象来修改这些条目。

The HeadScript 助手是 占位符助手 的一个具体实现。

Note: 在HTML Body中使用 InlineScript
当包含脚本内嵌在 HTML body里时，应当使用HeadScript 的兄弟助手，InlineScript。为了加速页面的加载，提高用户访问速度，特别是当使用第三方分析脚本（比如Google Analytics等流量统计系统的javascript文件 --Haohappy注），把脚本放在文档的最后是一个好的习惯。

Note: 任意的属性缺省关闭 （Disabled）
缺省地，HeadScript 将只解析（render）由 W3C 赋予的 <script> 属性，包括 'type'、 'charset'、 'defer'、 'language' 和 'src' 。 然而，一些 javascript 框架，如 » Dojo，利用定制的属性来修改行为。为了允许这样的属性，可以通过 setAllowArbitraryAttributes() 方法来打开（enable）它们：

<?php
$this->headScript()->setAllowArbitraryAttributes(true);
?>

<?php // adding scripts
$this->headScript()->appendFile('/js/prototype.js')
                   ->appendScript($onloadScript);
?>

<?php // 按顺序放置脚本文件

//设置偏移量来确保这个文件最后加载
$this->headScript()->offsetSetScript(100, '/js/myfuncs.js');

//使用scriptaculous效果文件，这时append动作使用索引101，接上行代码的索引
$this->headScript()->appendScript('/js/scriptaculous.js');

//但总是保证prototype文件首先加载
$this->headScript()->prependScript('/js/prototype.js');
?>

<?= $this->headScript() ?>

<?php $this->headScript()->captureStart() ?>
var action = '<?= $this->baseUrl ?>';
$('foo_form').action = action;
<?php $this->headScript()->captureEnd() ?>

在 HTML <head> 元素中 HTML <style> 元素用来包含 CSS stylesheets inline 。

Note: 使用 HeadLink 来链接 CSS 文件
HeadLink 为包含外部 stylesheets 应该用来生成 <link> 元素。如果想定义自己的 stylesheets inline， 使用 HeadScript 。

HeadStyle 助手支持下列方法来设置和添加 stylesheet 声明：

• appendStyle($content, $attributes = array())

• offsetSetStyle($index, $content, $attributes = array())

• prependStyle($content, $attributes = array())

• setStyle($content, $attributes = array())

对于所有情况，$content 是实际上的 CSS 声明。$attributes 是提供给 style 标签的任何额外的属性：lang、 title、 media 或 dir 都是允许的。

HeadStyle 也允许抓取样式声明，如果想用程序生成声明，然后在任何地方自由使用，这很有用。这个用法将在下面的例子给出。

最后，你也可以用 headStyle()方法 来快速地添加声明元素，它的用法： headStyle($content$placement = 'APPEND', $attributes = array()) 。$placement 是 'APPEND'、 'PREPEND' 或 'SET'。

HeadStyle 覆盖 append()， offsetSet()，prepend() 和 set() 中的每一个来加强上述特殊方法的用法。 在内部，它存储每个条目为 stdClass 令牌，它在稍后用 itemToString() 方法 serializes 。这允许在堆栈里检查条目，并可选地通过修改返回的对象来修改这些条目。

HeadStyle 助手是 占位符助手 的一个具体实现。

<?php // adding styles
$this->headStyle()->appendStyle($styles);
?>

<?php // Putting styles in order

// place at a particular offset:
$this->headStyle()->offsetSetStyle(100, $customStyles);

// place at end:
$this->headStyle()->appendStyle($finalStyles);

// place at beginning
$this->headStyle()->prependStyle($firstStyles);
?>

<?= $this->headStyle() ?>

<?php $this->headStyle()->captureStart() ?>
body {
    background-color: <?= $this->bgColor ?>;
}
<?php $this->headStyle()->captureEnd() ?>

HTML <title> 元素用来提供标题给HTML文档。HeadTitle 助手允许用程序生成和存储标题供以后解析和输出。

HeadTitle 助手是 占位符助手 的一个具体实现。 它覆盖 toString() 方法来确保生成 <title> 元素，并添加一个 headTitle() 方法来快速并容易地设置和标题元素的聚合。那个方法的 signature 是 headTitle($title, $setType = 'APPEND')，缺省地是追加到堆栈（聚合标题元素）的值，但你也可以指定 'PREPEND' ( 放栈顶 ) 或 'SET' ( 重写堆栈 )。

<?php
// setting the controller and action name as title segments:
//把控制器和动作的名称设置为标题的一部分
$request = Zend_Controller_Front::getInstance()->getRequest();
$this->headTitle($request->getActionName())
     ->headTitle($request->getControllerName());

// setting the site in the title; possibly in the layout script:
//添加标题内容，这种写法常用于布局脚本中
$this->headTitle('Zend Framework');

// setting a separator string for segments:
//为标题的各部分设置分隔符
$this->headTitle()->setSeparator(' / ');
?>

<!-- renders <action> / <controller> / Zend Framework -->
<?= $this->headTitle() ?>

HTML <object> 元素在网页里用于嵌入媒体如 Flash 或 QuickTime。 对象视图助手用最小的代价来帮助嵌入媒体。

有四个初始的对象助手：

• formFlash 为嵌入 Flash 文件生成 markup。

• formObject 为嵌入定制对象生成 markup。

• formPage 为嵌入其它 (X)HTML 页面生成 markup。

• formQuicktime 为嵌入 QuickTime 文件生成 markup。

所有这些助手使用相似的接口。这样，本文档只包含两个助手的例子。

<?php echo $this->htmlFlash('/path/to/flash.swf'); ?>

<object data="/path/to/flash.swf" type="application/x-shockwave-flash"
    classid="clsid:D27CDB6E-AE6D-11cf-96B8-444553540000"
    codebase="http://download.macromedia.com/pub/shockwave/cabs/flash/swflash.cab">
</object>

另外你可以指定可以和 <object> 一起解析的属性、参数和内容。 这个用 htmlObject 助手来示范。

echo $this->htmlObject(
    '/path/to/file.ext',
    'mime/type',
    array(
        'attr1' => 'aval1',
        'attr2' => 'aval2'
    ),
    array(
        'param1' => 'pval1',
        'param2' => 'pval2'
    ),
    'some content'
);

/*
这将输出:

<object data="/path/to/file.ext" type="mime/type"
    attr1="aval1" attr2="aval2">
    <param name="param1" value="pval1" />
    <param name="param2" value="pval2" />
    some content
</object>
*/

HTML <script> 标签用来提供内嵌的客户端脚本，或者链接到远程包含客户端脚本代码的资源。InlineScript 助手允许你管理这两者。它由HeadScript派生，并且HeadScript助手的任何方法都可用，唯一不同的是需要用 inlineScript() 方法代替 headScript()。

Note: 在 HTML Body 里脚本使用 InlineScript
如果想在HTML body里内嵌脚本，应当使用 InlineScript 。为了加快页面加载速度（特别是使用第三方分析脚本时），把脚本放到文档的尾部是个很好的习惯。
一些 JS 库必须包含在 HTML head部分，对于这些类库请使用 HeadScript 。

当创建返回 JSON 的视图，设置适当的响应头也非常重要，JSON 视图助手就是来做这个的。另外，缺省地，它关闭（disable）了布局（如果布局是打开（enable）的），因为布局一般不和 JSON 响应一起使用。

JSON 助手设置下列的头：

Content-Type: application/json

当解析响应来决定如何处理内容，大部分 AJAX 库寻找这个头。

JSON 助手的用法相当简单：

<?php
<?= $this->json($this->data) ?>
?>

通常，网站支持多种语言。使用 Zend 翻译 来翻译网站的内容并且 使用 翻译 视图助手来在视图里集成 Zend 翻译 。

在下面所有的例子里我们使用简单的数组翻译适配器（Array Translation Adapter）。当然你也可以使用任何 Zend_Translate 的实例和 Zend_Translate_Adapter 的任何子类。有若干方法来实例化 翻译 视图助手：

• 已注册的，通过先前注册的实例

• 后来地，通过 fluent interface （流利的接口？我还没有找到合适的词汇，by Jason Qi）

• 直接地，通过实例化类

Zend_Translate 的已注册的实例是这个助手的首选用法。你也可以简单地在添加适配器到注册表之前选择被使用的地点（locale）

Note: 我们用地点（locales）而不用语言是因为一种语音也可以包含一个地区。例如英语有不同的方言，有英国英语和美国英语，因此我们用“地点”而不说“语言”。

<?php
// 我们的例子适配器
$adapter = new Zend_Translate('array', array('simple' => 'einfach'), 'de');
Zend_Registry::set('Zend_Translate', $adapter);

// 在视图中
echo $this->translate('simple');
// 返回 'einfach'
?>

如果你熟悉 fluent interface ，那么也可以在视图里创建一个实例然后实例化这个助手。

<?php
// 在视图里
$adapter = new Zend_Translate('array', array('simple' => 'einfach'), 'de');
$this->translate()->setTranslator($adapter)->translate('simple');
// 返回 'einfach'
?>

如果你使用没有Zend_View的助手，那么你也可以直接使用它。

<?php
// 我们的例子适配器
$adapter = new Zend_Translate('array', array('simple' => 'einfach'), 'de');

// 实例化适配器
$translate = new Zend_View_Helper_Translate($adapter);
print $translate->translate('simple'); // this returns 'einfach'
?>

就象已经知道，translate() 方法用来返回翻译。用需要的翻译适配器的信息 id 来调用它。但它也可以在翻译字符串里替换参数。因此，它有两个方法接受变量参数。或者是参数类表，或者是参数数组。如下例：

<?php
// 在视图里
$date = "Monday";
$this->translate("Today is %1\$s", $date);
// 应当返回 'Heute ist Monday'
?>

Note: 记住如果使用的参数也是文本，你可能也要翻译这些参数。

<?php
// 在视图里
$date = "Monday";
$month = "April";
$time = "11:20:55";
$this->translate("Today is %1\$s in %2\$s. Actual time: %3\$s", $date, $month, $time);
// 应当返回 'Heute ist Monday in April. Aktuelle Zeit: 11:20:55'
?>

<?php
// 在视图里
$date = array("Monday", "April", "11:20:55");
$this->translate("Today is %1\$s in %2\$s. Actual time: %3\$s", $date);
// 应当返回 'Heute ist Monday in April. Aktuelle Zeit: 11:20:55'
?>

有时候必需要修改翻译的地点。可以通过动态翻译或者把所有的静态翻译来完成。并且你可以使用参数类表和参数数组。在这两种情况下，地点被当作最后一个单个参数给出。

<?php
// 在视图里
$date = array("Monday", "April", "11:20:55");
$this->translate("Today is %1\$s in %2\$s. Actual time: %3\$s", $date, 'it');
?>

这个例子为 messageid 返回意大利语的翻译。但它将只能用一次。下个翻译将从适配器里设置地点。通常地在添加它到注册表之前你将在翻译适配器里设置期望的地点。但你也可以从助手里设置地点：

<?php
// 在视图里
$date = array("Monday", "April", "11:20:55");
$this->translate()->setLocale('it');
$this->translate("Today is %1\$s in %2\$s. Actual time: %3\$s", $date);
?>

在上面的例子里设置 'it' 为新的缺省地点，它将被用来给所有将来的翻译。

当然，还有 getLocale() 方法来获得当前设置的地点。

<?php
// 在视图里
$date = array("Monday", "April", "11:20:55");

// 从上面的例子里返回 'de' 作为缺省地点
$this->translate()->getLocale();

$this->translate()->setLocale('it');
$this->translate("Today is %1\$s in %2\$s. Actual time: %3\$s", $date);

// 返回 'it' 为新的缺省地点
$this->translate()->getLocale();
?>