documentation/manual/ja/module_specs/Zend_Navigation-Migration.xml

   1 <?xml version="1.0" encoding="UTF-8"?>
   2 <!-- Reviewed: no -->
   3 <!-- EN-Revision: 17172 -->
   4 <sect1 id="zend.navigation.migration">
   5     <title>前バージョンからの移行</title>
   6
   7     <para>
   8         この章は、主に<classname>Zend_Navigation</classname>
   9         及び<classname>Zend_View_Helper_Navigation</classname>
  10         でなされる下位互換性破壊を文書化して、
  11         前バージョンからの移行を手伝う役目を果たさなければなりません。
  12     </para>
  13
  14     <sect2 id="zend.view.navigation.zf7341">
  15         <title>バージョン 1.9以前からの移行</title>
  16
  17         <para>
  18             1.9のリリース以前は、
  19             メニュー・ヘルパー(<classname>Zend_View_Helper_Navigation_Menu</classname>)は、
  20             サブ・メニューを正しくレンダリングしませんでした。
  21             <code>onlyActiveBranch</code>が<constant>TRUE</constant>で、
  22             オプションの<code>renderParents</code>が<constant>FALSE</constant>のとき、
  23             もし、もっとも深いアクティブなページが<code>minDepth</code>オプションよりも少ない深さの場合には、
  24             何もレンダリングされませんでした。
  25         </para>
  26
  27         <para>
  28             簡単に言うと、もし<code>minDepth</code>が<code>1</code>に設定され、
  29             アクティブなページが最初のレベルのページの一つだったら、
  30             下記の例のように、何もレンダリングされませんでした。
  31         </para>
  32
  33         <para>
  34             下記のコンテナを設定したと考えてください。
  35         </para>
  36
  37         <programlisting language="php"><![CDATA[
  38 <?php
  39 $container = new Zend_Navigation(array(
  40     array(
  41         'label' => 'Home',
  42         'uri'   => '#'
  43     ),
  44     array(
  45         'label'  => 'Products',
  46         'uri'    => '#',
  47         'active' => true,
  48         'pages'  => array(
  49             array(
  50                 'label' => 'Server',
  51                 'uri'   => '#'
  52             ),
  53             array(
  54                 'label' => 'Studio',
  55                 'uri'   => '#'
  56             )
  57         )
  58     ),
  59     array(
  60         'label' => 'Solutions',
  61         'uri'   => '#'
  62     )
  63 ));
  64 ]]></programlisting>
  65
  66         <para>
  67             下記のコードがビュースクリプトとして使われます。
  68         </para>
  69
  70         <programlisting language="php"><![CDATA[
  71 <?php echo $this->navigation()->menu()->renderMenu($container, array(
  72     'minDepth'         => 1,
  73     'onlyActiveBranch' => true,
  74     'renderParents'    => false
  75 )); ?>
  76 ]]></programlisting>
  77
  78         <para>
  79             リリース 1.9 以前では、上記のコード・スニペットは何も出力しませんでした。
  80         </para>
  81
  82         <para>
  83             リリース1.9以降では、
  84             <classname>Zend_View_Helper_Navigation_Menu</classname>の
  85             <methodname>_renderDeepestMenu()</methodname>メソッドが
  86             <code>minDepth</code>以下の一つの層のレベルのアクティブなページを、
  87             そのページが子供を持つ限り、受け入れます。
  88         </para>
  89
  90         <para>
  91             今では、同じコード・スニペットは下記のように出力するようになります。
  92         </para>
  93
  94         <programlisting language="html"><![CDATA[
  95 <ul class="navigation">
  96     <li>
  97         <a href="#">Server</a>
  98     </li>
  99     <li>
 100         <a href="#">Studio</a>
 101     </li>
 102 </ul>
 103 ]]></programlisting>
 104     </sect2>
 105 </sect1>