documentation/manual/zh/module_specs/Zend_Layout-QuickStart.xml

   1 <sect1 id="zend.layout.quickstart">
   2     <title>Zend_Layout 快速入门</title>
   3
   4     <para>
   5         <code>Zend_Layout</code>有两个基本用例：带有Zend Framework MVC和不带。
   6     </para>
   7
   8     <sect2 id="zend.layout.quickstart.layouts">
   9         <title>布局脚本</title>
  10
  11         <para>
  12             在两种情况下都需要创建布局脚本。布局脚本简单地使用Zend_View（或者无论哪种你在使用的视图实现）。布局变量用<code>Zend_Layout</code> <link linkend="zend.view.helpers.initial.placeholder">placeholder</link> 注册，可以通过占位符助手或者通过布局助手从布局对象的对象属性里获取。
  13          </para>
  14
  15         <para>
  16             如下例：
  17         </para>
  18
  19         <programlisting role="php"><![CDATA[
  20 <!DOCTYPE html
  21     PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
  22     "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
  23 <html>
  24 <head>
  25     <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
  26     <title>My Site</title>
  27 </head>
  28 <body>
  29 <?php
  30     // fetch 'content' key using layout helper:
  31     echo $this->layout()->content;
  32
  33     // fetch 'foo' key using placeholder helper:
  34     echo $this->placeholder('Zend_Layout')->foo;
  35
  36     // fetch layout object and retrieve various keys from it:
  37     $layout = $this->layout();
  38     echo $layout->bar;
  39     echo $layout->baz;
  40 ?>
  41 </body>
  42 </html>
  43 ]]></programlisting>
  44
  45         <para>
  46             因为<code>Zend_Layout</code>使用<code>Zend_View</code>来解析，你也可以使用任何视图助手注册，并也可以访问任何先前分配的视图变量。特别有用的是各种各样的<link linkend="zend.view.helpers.initial.placeholder">占位符助手</link>，因为它允许为如 &lt;head&gt;节（section）、导航（navigation）等区域获取内容：
  47         </para>
  48
  49         <programlisting role="php"><![CDATA[
  50 <!DOCTYPE html
  51     PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
  52     "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
  53 <html>
  54 <head>
  55     <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
  56     <?= $this->headTitle() ?>
  57     <?= $this->headScript() ?>
  58     <?= $this->headStyle() ?>
  59 </head>
  60 <body>
  61     <?= $this->render('header.phtml') ?>
  62
  63     <div id="nav"><?= $this->placeholder('nav') ?></div>
  64
  65     <div id="content"><?= $this->layout()->content ?></div>
  66
  67     <?= $this->render('footer.phtml') ?>
  68 </body>
  69 </html>
  70 ]]></programlisting>
  71     </sect2>
  72
  73     <sect2 id="zend.layout.quickstart.mvc">
  74         <title> 和Zend Framework MVC一起使用 Zend_Layout </title>
  75
  76         <para>
  77             <code>Zend_Controller</code>通过<link linkend="zend.controller.plugins">前端控制器插件</link> 和 <link linkend="zend.controller.actionhelpers">动作控制器助手</link>  提供了一组丰富的扩展函数。<code>Zend_View</code> 也有<link linkend="zend.view.helpers">助手</link>。当和（Zend Framework）MVC组件一起使用时，<code>Zend_Layout</code> 利用这些多种扩展点。
  78         </para>
  79
  80         <para>
  81             <code>Zend_Layout::startMvc()</code>创建一个带有任何你提供给它的可选配置的<code>Zend_Layout</code>的实例。接着它注册一个前端控制器插件，一旦派遣循环完成，这个插件就解析带有任何应用程序内容的布局，并且注册一个动作助手允许从动作控制器来访问布局对象。另外，可以任何时候用<code>布局</code>视图助手从视图脚本抓取布局实例。
  82         </para>
  83
  84         <para>
  85             首先，来看看如何初始化Zend_Layout来和MVC一起使用：
  86         </para>
  87
  88         <programlisting role="php"><![CDATA[<?php
  89 // In your bootstrap:
  90 Zend_Layout::startMvc();
  91 ?>]]></programlisting>
  92
  93         <para>
  94             <code>startMvc()</code> 可以带一个可选的数组或<code>Zend_Config</code> 对象来定制实例；这些选项详见<xref linkend="zend.layout.options" /> 。
  95         </para>
  96
  97         <para>
  98             在动作控制器例，你可以把局实例作为一个动作助手来访问：
  99         </para>
 100
 101         <programlisting role="php"><![CDATA[<?php
 102 class FooController extends Zend_Controller_Action
 103 {
 104     public function barAction()
 105     {
 106         // disable layouts for this action:
 107         $this->_helper->layout->disableLayout();
 108     }
 109
 110     public function bazAction()
 111     {
 112         // use different layout script with this action:
 113         $this->_helper->layout->setLayout('foobaz');
 114     };
 115 }
 116 ?>]]></programlisting>
 117
 118         <para>
 119             在视图脚本里，可以通过<code>layout</code>视图助手来访问布局对象。这个视图助手和其它的有细微的区别：不带参数，返回一个对象而不是一个字符串值。这允许在布局对象里立即调用方法：
 120         </para>
 121
 122         <programlisting role="php"><![CDATA[
 123 <?php $this->layout()->setLayout('foo'); // set alternate layout ?>
 124 ]]></programlisting>
 125
 126         <para>
 127             在任何时候，通过<code>getMvcInstance()</code> 静态方法获取和MVC一起注册的<code>Zend_Layout</code>的实例：
 128         </para>
 129
 130         <programlisting role="php"><![CDATA[<?php
 131 // Returns null if startMvc() has not first been called
 132 $layout = Zend_Layout::getMvcInstance();
 133 ?>]]></programlisting>
 134
 135         <para>
 136             最后，<code>Zend_Layout</code> 的前端控制器插件有一个除解析布局外的重要特征：它从响应对象获取所有被命名的段（segments）并分配它们为布局变量，分配‘default’段给变量‘content’。这允许访问应用程序内容和在视图脚本里解析。
 137          </para>
 138
 139         <para>
 140             作为例子，让代码首先点击<code>FooController::indexAction()</code> ，它解析一些内容到缺省的响应段，并接着转发给<code>NavController::menuAction()</code> ，它解析内容给'nav'响应段。最后，转发给<code>CommentController::fetchAction()</code> 并取得一些注释，但是也解析那些给缺省响应段（追加内容给那个段）。视图脚本可以接着分别解析：
 141          </para>
 142
 143         <programlisting role="php"><![CDATA[
 144 <body>
 145     <!-- renders /nav/menu -->
 146     <div id="nav"><?= $this->layout()->nav ?></div>
 147
 148     <!-- renders /foo/index + /comment/fetch -->
 149     <div id="content"><?= $this->layout()->content ?></div>
 150 </body>
 151 ]]></programlisting>
 152
 153         <para>
 154             当和动作堆栈 <link linkend="zend.controller.actionhelpers.actionstack">动作助手</link> 和 <link linkend="zend.controller.plugins.standard.actionstack">插件</link>一起协同使用时，这个特性特别有用，通过循环可以设置一个动作堆栈，这样就创建一个部件化的页面。
 155         </para>
 156     </sect2>
 157
 158     <sect2 id="zend.layout.quickstart.standalone">
 159         <title>使用Zend_Layout做为独立的组件</title>
 160
 161         <para>
 162             做为独立组件，Zend_Layout不提供和MVC一起使用那样的方便和更多的功能。然而，它仍有两个主要优点：
 163         </para>
 164
 165         <itemizedlist>
 166             <listitem><para>
 167                      布局变量范围
 168             </para></listitem>
 169
 170             <listitem><para>
 171                      从其它视图脚本分离视图脚本布局
 172             </para></listitem>
 173         </itemizedlist>
 174
 175         <para>
 176             当用作独立组件，简单地初始化布局对象，使用不同的访问器来设置状态、设置变量为对象属性和解析布局：
 177         </para>
 178
 179         <programlisting role="php"><![CDATA[<?php
 180 $layout = new Zend_Layout();
 181
 182 // Set a layout script path:
 183 $layout->setLayoutPath('/path/to/layouts');
 184
 185 // set some variables:
 186 $layout->content = $content;
 187 $layout->nav     = $nav;
 188
 189 // choose a different layout script:
 190 $layout->setLayout('foo');
 191
 192 // render final layout
 193 echo $layout->render();
 194 ?>]]></programlisting>
 195     </sect2>
 196
 197     <sect2 id="zend.layout.quickstart.example">
 198         <title>尝试一下布局</title>
 199
 200         <para>
 201             有时候百闻不如一见。下面是一个布局脚本例子来展示它是如何工作的。
 202         </para>
 203
 204          <para>
 205             <inlinegraphic align="center" valign="middle"
 206                 fileref="figures/zend.layout.quickstart.example.png" format="PNG" />
 207         </para>
 208
 209         <para>
 210             基于所设置的CSS文件，实际元素的顺序可能不同；例如：如果使用绝对位置，导航稍后显示在文档种，但仍在顶部；对于sidebar或header同样适用，然而实际的显示内容的机制保持相同。
 211         </para>
 212     </sect2>
 213 </sect1>
 214 <!--
 215 vim:se ts=4 sw=4 et:
 216 -->