documentation/manual/nl/module_specs/Zend_View-Controllers.xml

   1 <sect1 id="zend.view.controllers">
   2     <title>Controller Scripts</title>
   3
   4     <para>
   5         De controller is waar je Zend_View instantieert en configureert.
   6         Je wijst dan variabelen aan de view toe en vertelt het view de
   7         output weer te geven door middel van een bepaald script.
   8     </para>
   9
  10     <sect2 id="zend.view.controllers.assign">
  11
  12         <title>Variabelen toewijzen</title>
  13
  14         <para>
  15             Je controller script zou de nodige variabelen aan het view moeten
  16             toewijzen voordat het de controle aan het view script overhandigd.
  17             Normaal gesproken kan je toewijzingen één per één doen door
  18             waarden aan de eigenschappen van de view instantie toe te wijzen:
  19         </para>
  20
  21         <programlisting role="php"><![CDATA[<?php
  22 $view = new Zend_View();
  23 $view->a = "Hooi";
  24 $view->b = "Bij";
  25 $view->c = "Zee";
  26 ?>]]>
  27         </programlisting>
  28
  29         <para>
  30             Dit kan wel vervelend zijn als je reeds alle waarden die
  31             toegewezen moeten worden in een array of objekt voorhanden hebt.
  32         </para>
  33
  34         <para>
  35             de assign() methode laat je "bulk" toewijzingen doen vanaf een array
  36             of objekt. De volgende voorbeelden hebben hetzelfde effekt als de
  37             hierboven beschreven één per één eigenschapstoewijzingen:
  38         </para>
  39
  40         <programlisting role="php"><![CDATA[<?php
  41 $view = new Zend_View();
  42
  43 // wij een array van key/waarde-paren toe, waar de key
  44 // de variabelnaam is, en de waarde de toegewezen waarde.
  45 $array = array(
  46     'a' => "Hooi",
  47     'b' => "Bij",
  48     'c' => "Zee",
  49 );
  50 $view->assign($array);
  51
  52 // doe hetzelfde met de publieke eigenschappen van een
  53 // objekt. Merk op hoe we naar een array casten bij de toewijzing.
  54 $obj = new StdClass;
  55 $obj->a = "Hooi";
  56 $obj->b = "Bij";
  57 $obj->c = "Zee";
  58 $view->assign((array) $obj);
  59 ?>]]>
  60         </programlisting>
  61
  62         <para>
  63             Anderzijds kan je de toewijzingsmethode gebruiken om
  64             één per één toewijzingen te doen door een string
  65             variabelnaam door te geven, en dan de variabelwaarde.
  66         </para>
  67
  68         <programlisting role="php"><![CDATA[<?php
  69 $view = new Zend_View();
  70 $view->assign('a', "Hooi");
  71 $view->assign('b', "Bij");
  72 $view->assign('c', "Zee");
  73 ?>]]>
  74         </programlisting>
  75
  76     </sect2>
  77
  78     <sect2 id="zend.view.controllers.render">
  79
  80         <title>Een View Script weergeven</title>
  81
  82         <para>
  83             Eenmaal je al de nodige variabelen hebt toegewezen zou de controller
  84             Zend_View moeten vertellen dat het een bepaald view script moet weergeven.
  85             Dat doe je door de render() methode op te roepen. Merk op dat de methide
  86             het weergegeven view zal terugsturen en niet afprinten. Je moet het dus zelf
  87             afprinten of echo-en wanneer dat jou past.
  88         </para>
  89
  90         <programlisting role="php"><![CDATA[<?php
  91 $view = new Zend_View();
  92 $view->a = "Hooi";
  93 $view->b = "Bij";
  94 $view->c = "Zee";
  95 echo $view->render('eenView.php');
  96 ?>]]>
  97         </programlisting>
  98
  99     </sect2>
 100
 101     <sect2 id="zend.view.controllers.script-paths">
 102
 103         <title>View Script Paden</title>
 104
 105         <para>
 106             Standaard verwacht Zend_View dat je view scripts relatief zijn
 107             tenoverstaan van het aanroepende script. Bijvoorbeeld, als je controller
 108             script zich in "/map/naar/toepassing/controllers" bevindt en het roept
 109             $view->render('eenView.php') op, zal Zend_View naar
 110             "/map/naar/toepassing/controllers/eenView.php" zoeken.
 111         </para>
 112
 113         <para>
 114             waarschijnlijk zijn je scripts ergens anders ondergebracht. Om
 115             Zend_View daarvan op de hoogte te brengen gebruik je de
 116             setScriptPath() methode.
 117         </para>
 118
 119         <programlisting role="php"><![CDATA[<?php
 120 $view = new Zend_View();
 121 $view->setScriptPath('/map/naar/toepassing/views');
 122 ?>]]>
 123         </programlisting>
 124
 125         <para>
 126             Als je nu $view->render('eenView.php') oproept zal het naar
 127             "/pad/naar/toepassing/views/eenView.php' kijken.
 128         </para>
 129
 130         <para>
 131             In feite kan je paden "opstapelen" door de addScriptPath()
 132             methode te gebruiken. Terwijl je paden aan de stapel toevoegt
 133             zal Zend_View in het meest recente pad kijken voor het
 134             gevraagde view script. Dit laat je toe de standaard te overschrijven
 135             met verpersoonlijkte views zodat je persoonlijke "thema's" of "skins"
 136             voor sommige views kan maken terwijl die niet op andere views van
 137             toepassing zijn.
 138         </para>
 139
 140         <programlisting role="php"><![CDATA[<?php
 141 $view = new Zend_View();
 142 $view->addScriptPath('/pad/naar/toepassing/views');
 143 $view->addScriptPath('/pad/naar/persoonlijk/');
 144
 145 // wanneer je nu $view->render('boeklijst.php') oproept zal Zend_View
 146 // eerst kijken naar "pad/naar/persoonlijk/boeklijst.php", dan naar
 147 // "/pad/naar/toepassing/views/boeklijst.php", en uiteindelijk in
 148 // de huidige map naar "boeklijst.php".
 149 ?>]]>
 150         </programlisting>
 151
 152     </sect2>
 153
 154 </sect1>
 155 <!--
 156 vim:se ts=4 sw=4 et:
 157 -->