repo_zf1/documentation/manual/fr/module_specs/Zend_View-Helpers-HtmlObject.xml

<?xml version="1.0" encoding="UTF-8"?>
<!-- EN-Revision: 24249 -->
<!-- Reviewed: no -->
<sect3 id="zend.view.helpers.initial.object">
    <title>L'aide de vue HTML Object</title>

    <para>
        L'élément HTML <code>&lt;object&gt;</code> est utilisé pour inclure un média comme
        Flash ou QuickTime dans les pages Web. L'aide de vue <code>Object</code> vous aide à
        réaliser ceci avec un minimum d'effort.
    </para>

    <para>Il existe quatre aides de vue <code>Object</code> initiaux :</para>

    <itemizedlist>
        <listitem>
            <para>
                <code>htmlFlash</code> : génère le balisage pour l'inclusion de fichiers
                Flash.
            </para>
        </listitem>

        <listitem>
            <para>
                <code>htmlObject</code> : génère le balisage pour l'inclusion d'objets
                personnalisés.
            </para>
        </listitem>

        <listitem>
            <para>
                <code>htmlPage</code> : génère le balisage pour l'inclusion d'autres pages
                (X)HTML.
            </para>
        </listitem>

        <listitem>
            <para>
                <code>htmlQuicktime</code> : génère le balisage pour l'inclusion de fichiers
                QuickTime.
            </para>
        </listitem>
    </itemizedlist>

    <para>
        Toutes ces aides partagent une interface similaire. Pour cette raison, cette
        documentation ne présentera des exemples que pour deux de ces aides.
    </para>

    <example id="zend.view.helpers.initial.object.flash">
        <title>Aide de vue Flash</title>

        <para>
            Inclure du Flash dans votre page est assez simple. Le seul argument requis est
            l'URI de la ressource.
        </para>

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

        <para>Ceci affichera le code HTML suivant :</para>

        <programlisting language="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>
        Cependant vous pouvez aussi spécifier des attributs, des paramètres et du contenu qui
        peuvent être affichés avec la balise <code>&lt;object&gt;</code>. Ceci peut être montré avec
        l'aide de vue <code>htmlObject</code>.
    </para>

    <example id="zend.view.helpers.initial.object.object">
        <title>Personnalisation d'un objet en fournissant des arguments additionnels</title>

        <para>
            Le premier argument de l'aide <code>Object</code> est toujours requis. Il s'agit
            de l'URI de la ressource à inclure. Le second argument est seulement requis par l'aide
            <code>htmlObject</code>. Les autres aides contiennent déjà la bonne valeur pour cet
            argument. Le troisième argument est utilisé pour fournir des attributs à l'élément
            <code>object</code>. Seul un tableau de paires clé/valeur est accepté.
            <code>classid</code> ou <code>codebase</code> sont des exemples de tels attributs. Le
            quatrième paramètre ne prend aussi qu'un tableau de paires clé/valeur est les utilise
            pour créer des éléments <code>&lt;param&gt;</code>. Enfin, vous avez la possibilité de
            fournir un contenu additionnel à l'objet en cinquième paramètre. Voici donc un exemple
            qui utilise tous le paramètres :
        </para>

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

        <para>Ceci affichera le code HTML suivant :</para>

        <para>
            <programlisting><![CDATA[
<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></para>
        </example>
    </sect3>