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

    <para>
        Les documents HTML et <acronym>XHTML</acronym> valides doivent inclure une déclaration
        <constant>DOCTYPE</constant>. Sans compter qu'ils sont difficiles à garder en mémoire, ceux-ci
        peuvent aussi affecter la façon dont certains éléments du document peuvent être rendus (par
        exemple, les échappements CDATA dans <code>&lt;script&gt;</code> et les éléments
        <code>&lt;style&gt;</code>.
    </para>

    <para>L'aide <code>Doctype</code> vous permet de spécifier un des types suivants :</para>

    <itemizedlist>
        <listitem>
            <para><constant>XHTML11</constant></para>
        </listitem>

        <listitem>
            <para><constant>XHTML1_STRICT</constant></para>
        </listitem>

        <listitem>
            <para><constant>XHTML1_TRANSITIONAL</constant></para>
        </listitem>

        <listitem>
            <para><constant>XHTML1_FRAMESET</constant></para>
        </listitem>

        <listitem>
            <para><constant>XHTML_BASIC1</constant></para>
        </listitem>

        <listitem>
            <para><constant>HTML4_STRICT</constant></para>
        </listitem>

        <listitem>
            <para><constant>HTML4_LOOSE</constant></para>
        </listitem>

        <listitem>
            <para><constant>HTML4_FRAMESET</constant></para>
        </listitem>

        <listitem>
            <para><constant>HTML5</constant></para>
        </listitem>
    </itemizedlist>

    <para>
        Vous pouvez aussi spécifier un doctype personnalisé du moment que celui-ci soit
        correctement formé.
    </para>

    <para>
        L'aide <code>Doctype</code> est une implémentation concrète de l'<link
        linkend="zend.view.helpers.initial.placeholder">aide Conteneur</link>.
    </para>

    <example id="zend.view.helpers.initial.doctype.basicusage">
        <title>Utilisation basique de l'aide Doctype</title>

        <para>
            Vous pouvez spécifier le doctype à n'importe quel moment. Cependant, les aides de
            vues qui utilisent pour leur affichage ne le reconnaissent qu'une fois qu'il a été
            paramètré, donc la manière la plus simple est de le spécifier dans votre fichier
            d'amorçage :
        </para>

        <programlisting language="php"><![CDATA[
$doctypeHelper = new Zend_View_Helper_Doctype();
$doctypeHelper->doctype('XHTML1_STRICT');
]]></programlisting>

        <para>Ensuite vous l'affichez en début de votre layout :</para>

        <programlisting language="php"><![CDATA[
<?php echo $this->doctype() ?>
]]></programlisting>
    </example>

    <example id="zend.view.helpers.initial.doctype.retrieving">
        <title>Récupérer le Doctype</title>

        <para>
            Si vous avez besoin du doctype, vous pouvez le récupérer par l'appel de
            <methodname>getDoctype()</methodname> sur l'objet.
        </para>

        <programlisting language="php"><![CDATA[
$doctype = $view->doctype()->getDoctype();
]]></programlisting>

        <para>
            Typiquement, vous pouvez simplement vouloir savoir si le doctype est <acronym>XHTML</acronym> ou
            non&#160;; pour ceci, la méthode <methodname>isXhtml()</methodname> vous suffira&#160;:
        </para>

        <programlisting language="php"><![CDATA[
if ($view->doctype()->isXhtml()) {
    // faire qqch de différent
}
]]></programlisting>

        <para>
            Vous pouvez aussi vérifier si le doctype représente un document
            <acronym>HTML5</acronym>&#160;:
        </para>

        <programlisting language="php"><![CDATA[
if ($view->doctype()->isHtml5()) {
    // faire qqch de différent
}
]]></programlisting>

    </example>
</sect3>