File: Zend_View-Helpers-HtmlObject.xml

package info (click to toggle)
zendframework 1.12.9%2Bdfsg-2
  • links: PTS, VCS
  • area: main
  • in suites: jessie-kfreebsd
  • size: 133,584 kB
  • sloc: xml: 1,311,829; php: 570,173; sh: 170; makefile: 125; sql: 121
file content (126 lines) | stat: -rw-r--r-- 4,033 bytes parent folder | download | duplicates (2)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
<sect3 id="zend.view.helpers.initial.object">
    <title>Helpery HTML Object</title>

    <para>
        Element HTML <code><![CDATA[<object>]]></code> używany jest do
        wstawiania do kodu strony takich elementów interaktywnych jak Flash czy
        QuickTime. Helpery te pozwalają na łatwe wstawianie tych obiektów.
    </para>

    <para>
        Obecnie dostępne są cztery helpery Object:
    </para>

    <itemizedlist>
        <listitem>
            <para>
                <code>formFlash</code>
                Generuje kod do wstawiania plików Flash.
            </para>
        </listitem>
        <listitem>
            <para>
                <code>formObject</code>
                Generuje kod do wstawiania własnego obiektu
            </para>
        </listitem>
        <listitem>
            <para>
                <code>formPage</code>
                Generuje kod do wstawiania innych stron (X)HTML.
            </para>
        </listitem>
        <listitem>
            <para>
                <code>formQuicktime</code>
                Generuje kod do wstawiania plików QuickTime.
            </para>
        </listitem>
    </itemizedlist>

    <para>
        Wszystkie te helpery mają podobny interfejs. Z tego powodu w dokumentacji
        pokażemy przykłady tylko dwóch z nich.
    </para>

    <example id="zend.view.helpers.initial.object.flash">

        <title>Helper Flash</title>

        <para>
            Dołączanie plików Flash do twojej strony jest bardzo łatwe. Jedynym
            wymaganym argumentem jest adres URI pliku.
        </para>

        <programlisting role="php"><![CDATA[
<?php echo $this->htmlFlash('/path/to/flash.swf'); ?>
]]>
        </programlisting>

        <para>
            Wyświetli to następujący kod HTML:
        </para>

        <programlisting role="html"><![CDATA[
<object data="/path/to/flash.swf"
        type="application/x-shockwave-flash"
        classid="clsid:D27CDB6E-AE6D-11cf-96B8-444553540000"
        codebase="http://download.macromedia.com/pub/shockwave/cabs/flash/swflash.cab">
</object>
]]>
        </programlisting>

    </example>

    <para>
        Dodatkowo możesz określić atrybuty, parametry i zawartość jaka ma być
        zrenderowana wraz z obiektem <code><![CDATA[<object>]]></code>. Zostanie
        do zademonstrowane za pomocą helpera <code>htmlObject</code>.
    </para>

    <example id="zend.view.helpers.initial.object.object">
        <title>Konfigurowanie obiektu poprzez przekazanie dodatkowych argumentów</title>

        <para>
            Pierwszy argument w helperze jest zawsze wymagany. Określa on adres
            URL zasobu, który chcesz dołączyć do dokumentu (X)HTML. Drugi
            argument jest wymagany tylko w helperze <code>htmlObject</code>.
            Inne helpery posiadają poprawną domyślną wartość dla tego argumentu.
            Trzeci argument jest używany do przekazywania atrybutów do obiektu
            elementu. Akceptuje on tablicę par klucz-wartość. Przykładem
            mogą być atrybuty <code>classid</code> oraz <code>codebase</code>.
            Czwarty argument przyjmuje także tylko tablice elementów w postaci
            klucz-wartość i używa ich do elementów <code><![CDATA[<param>]]></code>.
            Ostatni argument umożliwia przekazanie dodatkowej zawartości do obiektu.
            Zobacz przykład używający wszystkich argumentów.
        </para>

        <programlisting role="php"><![CDATA[
echo $this->htmlObject(
    '/path/to/file.ext',
    'mime/type',
    array(
        'attr1' => 'aval1',
        'attr2' => 'aval2'
    ),
    array(
        'param1' => 'pval1',
        'param2' => 'pval2'
    ),
    'some content'
);

/*
Spowoduje to wyświetlenie:

<object data="/path/to/file.ext" type="mime/type"
    attr1="aval1" attr2="aval2">
    <param name="param1" value="pval1" />
    <param name="param2" value="pval2" />
    some content
</object>
*/
]]>
        </programlisting>
    </example>
</sect3>