<sect3 id="zend.view.helpers.initial.doctype">
    <title>תוסף עזרה ה Doctype</title>

    <para>
        קוד HTML ו XHTML תקני צריכים להכיל הגדרה של <code>DOCTYPE</code>.
        מלבד זה שקשה לזכור אותם, ערכים אלו משפיעים על אופן העבודה של אלמנטים אחרים בעמוד שלכם ואופן התצוגה שלהם, לדוגמא הברחת תגי CDATA בתוך אלמנטים <code>&lt;script&gt;</code> ו
        <code>&lt;style&gt;</code>
    </para>

    <para>
        תוסף העזרה <code>Doctype</code> מאפשר לך לקבוע אחד מהערכים הבאים:
    </para>

    <itemizedlist>
        <listitem><para><code>XHTML11</code></para></listitem>
        <listitem><para><code>XHTML1_STRICT</code></para></listitem>
        <listitem><para><code>XHTML1_TRANSITIONAL</code></para></listitem>
        <listitem><para><code>XHTML1_FRAMESET</code></para></listitem>
        <listitem><para><code>XHTML_BASIC1</code></para></listitem>
        <listitem><para><code>HTML4_STRICT</code></para></listitem>
        <listitem><para><code>HTML4_LOOSE</code></para></listitem>
        <listitem><para><code>HTML4_FRAMESET</code></para></listitem>
        <listitem><para><code>HTML5</code></para></listitem>
    </itemizedlist>

    <para>
        ניתן גם להגדיר ערך מותאם אישית בתנאי שהוא מוגדר כראוי.
    </para>

    <para>
        תוסף העזרה <code>Doctype</code> הוא יישום בסיסי של <link linkend="zend.view.helpers.initial.placeholder">Placeholder</link>.
    </para>

    <example id="zend.view.helpers.initial.doctype.basicusage">
        <title>שימוש בסיסי</title>

        <para>
           ניתן להגדיר את אלמנט זה בכל שלב, אך רצוי לעשות זאת בתחילת המערכת, בקובץ ה bootstrap
        </para>

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

        <para>
            ולאחר מכן להציג אותו בראש העמוד שלך:
        </para>

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

    </example>

    <example id="zend.view.helpers.initial.doctype.retrieving">
        <title>קבלת הערך</title>

        <para>
            אם אתה צריך לדעת מהו הערך שהוגדר תוכל לעשות זאת על ידי קריאה למתודה <code>getDoctype()</code> על האובייקט, שמוחזר על ידי שימוש בתוסף.
        </para>

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

        <para>
            בדרך כלל תרצה לדעת אם הערך הוא תקין מבחינת XHTML או לא; בישביל זה שימוש ב <code>isXhtml()</code> יספיק:
        </para>

        <programlisting role="php"><![CDATA[
if ($view->doctype()->isXhtml()) {
    // do something differently
}
]]>
        </programlisting>
    </example>
</sect3>
<!--
vim:se ts=4 sw=4 et:
-->
