Zend_Navigation-Migration.xml 3.1 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102
  1. <?xml version="1.0" encoding="UTF-8"?>
  2. <!-- EN-Revision: 17172 -->
  3. <!-- Reviewed: no -->
  4. <sect1 id="zend.navigation.migration">
  5. <title>Migration von vorhergehenden Versionen</title>
  6. <para>
  7. Dieses Kapitel beschreibt primär Brüche in der Abwärtskompatibilität von
  8. <classname>Zend_Navigation</classname> und
  9. <classname>Zend_View_Helper_Navigation</classname> und sollte als Hilfe bei der Migration
  10. von vorhergehenden Versionen dienen.
  11. </para>
  12. <sect2 id="zend.view.navigation.zf7341">
  13. <title>Migration von Versionen vor 1.9</title>
  14. <para>
  15. Vor dem Release 1.9 hat der Menü Helfer
  16. (<classname>Zend_View_Helper_Navigation_Menu</classname>) Untermenüs nicht richtig
  17. dargestellt. Wenn <code>onlyActiveBranch</code> <constant>TRUE</constant> war und die
  18. Option <code>renderParents</code> <constant>FALSE</constant> wurde nichts dargestellt
  19. wenn die tiefste aktive Seite auf einer geringeren Tiele als die <code>minDepth</code>
  20. Option war.
  21. </para>
  22. <para>
  23. In einfacheren Worten; Wenn <code>minDepth</code> auf <code>1</code> gesetzt war und
  24. die aktive Seite eine der Seiten am Anfangs-Level, wurde nichts dargestellt wie das
  25. folgende Beispiel zeigt.
  26. </para>
  27. <para>
  28. Das folgende Container Setup wird angenommen:
  29. </para>
  30. <programlisting language="php"><![CDATA[
  31. <?php
  32. $container = new Zend_Navigation(array(
  33. array(
  34. 'label' => 'Home',
  35. 'uri' => '#'
  36. ),
  37. array(
  38. 'label' => 'Products',
  39. 'uri' => '#',
  40. 'active' => true,
  41. 'pages' => array(
  42. array(
  43. 'label' => 'Server',
  44. 'uri' => '#'
  45. ),
  46. array(
  47. 'label' => 'Studio',
  48. 'uri' => '#'
  49. )
  50. )
  51. ),
  52. array(
  53. 'label' => 'Solutions',
  54. 'uri' => '#'
  55. )
  56. ));
  57. ]]></programlisting>
  58. <para>
  59. Der folgende Code wird in einem View Script verwendet:
  60. </para>
  61. <programlisting language="php"><![CDATA[
  62. <?php echo $this->navigation()->menu()->renderMenu($container, array(
  63. 'minDepth' => 1,
  64. 'onlyActiveBranch' => true,
  65. 'renderParents' => false
  66. )); ?>
  67. ]]></programlisting>
  68. <para>
  69. Vor dem Release 1.9 würde der obige Codeabschnitt nichts ausgeben.
  70. </para>
  71. <para>
  72. Seit dem Release 1.9 akzeptiert die <methodname>_renderDeepestMenu()</methodname>
  73. Methode in <classname>Zend_View_Helper_Navigation_Menu</classname> aktive Seiten die ein
  74. Level unter <code>minDepth</code> sind, solange diese Seite Kinder hat.
  75. </para>
  76. <para>
  77. Der gleiche Codeabschnitt zeigt jetzt die folgende Ausgabe:
  78. </para>
  79. <programlisting language="html"><![CDATA[
  80. <ul class="navigation">
  81. <li>
  82. <a href="#">Server</a>
  83. </li>
  84. <li>
  85. <a href="#">Studio</a>
  86. </li>
  87. </ul>
  88. ]]></programlisting>
  89. </sect2>
  90. </sect1>