documentation/manual/pl/module_specs/Zend_View-Helpers-HtmlObject.xml

   1 <sect3 id="zend.view.helpers.initial.object">
   2     <title>Helpery HTML Object</title>
   3
   4     <para>
   5         Element HTML <code><![CDATA[<object>]]></code> używany jest do
   6         wstawiania do kodu strony takich elementów interaktywnych jak Flash czy
   7         QuickTime. Helpery te pozwalają na łatwe wstawianie tych obiektów.
   8     </para>
   9
  10     <para>
  11         Obecnie dostępne są cztery helpery Object:
  12     </para>
  13
  14     <itemizedlist>
  15         <listitem>
  16             <para>
  17                 <code>formFlash</code>
  18                 Generuje kod do wstawiania plików Flash.
  19             </para>
  20         </listitem>
  21         <listitem>
  22             <para>
  23                 <code>formObject</code>
  24                 Generuje kod do wstawiania własnego obiektu
  25             </para>
  26         </listitem>
  27         <listitem>
  28             <para>
  29                 <code>formPage</code>
  30                 Generuje kod do wstawiania innych stron (X)HTML.
  31             </para>
  32         </listitem>
  33         <listitem>
  34             <para>
  35                 <code>formQuicktime</code>
  36                 Generuje kod do wstawiania plików QuickTime.
  37             </para>
  38         </listitem>
  39     </itemizedlist>
  40
  41     <para>
  42         Wszystkie te helpery mają podobny interfejs. Z tego powodu w dokumentacji
  43         pokażemy przykłady tylko dwóch z nich.
  44     </para>
  45
  46     <example id="zend.view.helpers.initial.object.flash">
  47
  48         <title>Helper Flash</title>
  49
  50         <para>
  51             Dołączanie plików Flash do twojej strony jest bardzo łatwe. Jedynym
  52             wymaganym argumentem jest adres URI pliku.
  53         </para>
  54
  55         <programlisting role="php"><![CDATA[
  56 <?php echo $this->htmlFlash('/path/to/flash.swf'); ?>
  57 ]]>
  58         </programlisting>
  59
  60         <para>
  61             Wyświetli to następujący kod HTML:
  62         </para>
  63
  64         <programlisting role="html"><![CDATA[
  65 <object data="/path/to/flash.swf"
  66         type="application/x-shockwave-flash"
  67         classid="clsid:D27CDB6E-AE6D-11cf-96B8-444553540000"
  68         codebase="http://download.macromedia.com/pub/shockwave/cabs/flash/swflash.cab">
  69 </object>
  70 ]]>
  71         </programlisting>
  72
  73     </example>
  74
  75     <para>
  76         Dodatkowo możesz określić atrybuty, parametry i zawartość jaka ma być
  77         zrenderowana wraz z obiektem <code><![CDATA[<object>]]></code>. Zostanie
  78         do zademonstrowane za pomocą helpera <code>htmlObject</code>.
  79     </para>
  80
  81     <example id="zend.view.helpers.initial.object.object">
  82         <title>Konfigurowanie obiektu poprzez przekazanie dodatkowych argumentów</title>
  83
  84         <para>
  85             Pierwszy argument w helperze jest zawsze wymagany. Określa on adres
  86             URL zasobu, który chcesz dołączyć do dokumentu (X)HTML. Drugi
  87             argument jest wymagany tylko w helperze <code>htmlObject</code>.
  88             Inne helpery posiadają poprawną domyślną wartość dla tego argumentu.
  89             Trzeci argument jest używany do przekazywania atrybutów do obiektu
  90             elementu. Akceptuje on tablicę par klucz-wartość. Przykładem
  91             mogą być atrybuty <code>classid</code> oraz <code>codebase</code>.
  92             Czwarty argument przyjmuje także tylko tablice elementów w postaci
  93             klucz-wartość i używa ich do elementów <code><![CDATA[<param>]]></code>.
  94             Ostatni argument umożliwia przekazanie dodatkowej zawartości do obiektu.
  95             Zobacz przykład używający wszystkich argumentów.
  96         </para>
  97
  98         <programlisting role="php"><![CDATA[
  99 echo $this->htmlObject(
 100     '/path/to/file.ext',
 101     'mime/type',
 102     array(
 103         'attr1' => 'aval1',
 104         'attr2' => 'aval2'
 105     ),
 106     array(
 107         'param1' => 'pval1',
 108         'param2' => 'pval2'
 109     ),
 110     'some content'
 111 );
 112
 113 /*
 114 Spowoduje to wyświetlenie:
 115
 116 <object data="/path/to/file.ext" type="mime/type"
 117     attr1="aval1" attr2="aval2">
 118     <param name="param1" value="pval1" />
 119     <param name="param2" value="pval2" />
 120     some content
 121 </object>
 122 */
 123 ]]>
 124         </programlisting>
 125     </example>
 126 </sect3>