documentation/manual/fr/module_specs/Zend_View-Helpers-Json.xml

   1 <?xml version="1.0" encoding="UTF-8"?>
   2 <!-- EN-Revision: 19434 -->
   3 <!-- Reviewed: no -->
   4 <sect3 id="zend.view.helpers.initial.json">
   5     <title>L'aide de vue JSON</title>
   6
   7     <para>
   8         Quand vous créez des vues qui retournent du <acronym>JSON</acronym>, il est important de paramétrer aussi
   9         les en-têtes de réponse appropriés. L'aide vue <acronym>JSON</acronym> réalise exactement cela. De plus, par
  10         défaut, elle désactive l'éventuel layout (s'il est activé), puisque les layouts sont
  11         rarement utilisés dans les réponses <acronym>JSON</acronym>.
  12     </para>
  13
  14     <para>L'aide de vue <acronym>JSON</acronym> ajoute l'en-tête suivant :</para>
  15
  16     <programlisting language="text"><![CDATA[
  17 Content-Type: application/json
  18 ]]></programlisting>
  19
  20     <para>
  21         Beaucoup de librairies <acronym>AJAX</acronym> recherche cet en-tête quand elles analysent les réponses
  22         pour déterminer comment le contenu doit être géré.
  23     </para>
  24
  25     <para>L'utilisation de l'aide de vue <acronym>JSON</acronym> est très simple :</para>
  26
  27     <programlisting language="php"><![CDATA[
  28 <?php echo $this->json($this->data) ?>
  29 ]]></programlisting>
  30
  31     <note>
  32         <title>Keeping layouts and enabling encoding using Zend_Json_Expr</title>
  33
  34         <para>
  35             Each method in the <acronym>JSON</acronym> helper accepts a second, optional argument.
  36             This second argument can be a boolean flag to enable or disable
  37             layouts, or an array of options that will be passed to
  38             <methodname>Zend_Json::encode()</methodname> and used internally to encode data.
  39         </para>
  40
  41         <para>
  42             To keep layouts, the second parameter needs to be boolean
  43             <constant>TRUE</constant>. When the second parameter is an array, keeping
  44             layouts can be achieved by including a <code>keepLayouts</code> key
  45             with a value of a boolean <constant>TRUE</constant>.
  46         </para>
  47
  48         <programlisting language="php"><![CDATA[
  49 // Boolean true as second argument enables layouts:
  50 echo $this->json($this->data, true);
  51
  52 // Or boolean true as "keepLayouts" key:
  53 echo $this->json($this->data, array('keepLayouts' => true));
  54 ]]></programlisting>
  55
  56         <para>
  57             <classname>Zend_Json::encode</classname> allows the encoding of native <acronym>JSON</acronym>
  58             expressions using <classname>Zend_Json_Expr</classname> objects. This option
  59             is disabled by default. To enable this option, pass a boolean
  60             <constant>TRUE</constant> to the <code>enableJsonExprFinder</code> key of
  61             the options array:
  62         </para>
  63
  64         <programlisting language="php"><![CDATA[
  65 <?php echo $this->json($this->data, array(
  66     'enableJsonExprFinder' => true,
  67     'keepLayouts'          => true,
  68 )) ?>
  69 ]]></programlisting>
  70     </note>
  71 </sect3>