repo_zf1/documentation/manual/fr/module_specs/Zend_Navigation-Introduction.xml

<?xml version="1.0" encoding="UTF-8"?>
<!-- EN-Revision: 24249 -->
<!-- Reviewed: no -->
<sect1 id="zend.navigation.introduction">
    <title>Introduction</title>

    <para>
        <classname>Zend_Navigation</classname> est un composant gérant arbres et menus
        pour les pages webs. Il permet de créer des menus, des fils, des liens et
        des cartographies de sites (sitemaps), ou encore toute autre représentation
        concernant la navigation.
    </para>

    <sect2 id="zend.navigation.introduction.concepts">
        <title>Pages et Conteneurs</title>

        <para>
            Deux concepts existent dans <classname>Zend_Navigation</classname>:
        </para>

        <sect3 id="zend.navigation.introduction.pages">
            <title>Pages</title>
            <para>
                Une page (<classname>Zend_Navigation_Page</classname>) dans
                <classname>Zend_Navigation</classname> – dans sa forme la plus
                simple – est un objet pointant vers une page web. En plus d'un
                pointeur vers une page web, l'objet page contient d'autres
                informations utiles à la navigation comme un <property>label</property>,
                un titre <property>title</property>, etc.
            </para>

            <para>
                Pour plus d'informations sur les pages, lisez
                <link linkend="zend.navigation.pages">leur section</link>.
            </para>
        </sect3>

        <sect3 id="zend.navigation.introduction.containers">
            <title>Conteneurs</title>
            <para>
                Un conteneur de navigation
                (<classname>Zend_Navigation_Container</classname>) est une classe
                contenant des pages. Elle possède des méthodes pour ajouter, supprimer,
                récupérer et itrérer au travers de pages. Elle implémente les interfaces
                de la <ulink url="http://php.net/spl">SPL</ulink>
                <classname>RecursiveIterator</classname> et
                <classname>Countable</classname>, et peuvent ainsi être parcourues avec
                les itérateurs de la SPL tels que
                <classname>RecursiveIteratorIterator</classname>.
            </para>

            <para>
                Pour plus d'informations sur les conteneurs, lisez
                <link linkend="zend.navigation.containers">leur section</link>.
            </para>

            <note>
                <para>
                    <classname>Zend_Navigation_Page</classname> étend
                    <classname>Zend_Navigation_Container</classname>, ce qui signifie
                    qu'une page peut posséder des sous-pages.
                </para>
            </note>
        </sect3>
    </sect2>

    <sect2 id="zend.navigation.introduction.separation">
        <title>Séparation des données (modèle) et du rendu (vue)</title>

        <para>
            Les classes dans <classname>Zend_Navigation</classname> ne s'occupent
            pas du rendu visuel, celui-ci est effectué par des aides de vue. Par contre,
            les pages peuvent contenir des informations utilisées par les aides de vue
            comme un <property>label</property> (libellé), une classe <acronym>CSS</acronym>,
            un titre (<property>title</property>), des attributs <property>lastmod</property>
            et <property>priority</property> pour les sitemaps, etc.
        </para>

        <para>
            Pour plus d'informations sur le rendu des éléments, lisez
            <link linkend="zend.view.helpers.initial.navigation">leur section</link>.
        </para>
    </sect2>
</sect1>