repo_zf1/documentation/manual/fr/module_specs/Zend_Navigation-Pages-Custom.xml

<?xml version="1.0" encoding="UTF-8"?>
<!-- Reviewed: no -->
<sect2 id="zend.navigation.pages.custom">
    <title>Créer des pages de type personnalisé</title>

    <para>
        Etendre <classname>Zend_Navigation_Page</classname> ne nécessite pas forcément de réécrire
        le constructeur ou les méthodes <methodname>setOptions()</methodname> ou
        <methodname>setConfig()</methodname>. Le constructeur prend un seul paramètre de type
        <type>Array</type> ou <classname>Zend_Config</classname> et il est passé à
        <methodname>setOptions()</methodname> ou <methodname>setConfig()</methodname> respectivement.
        Ces méthodes appellerons par la suite les setters <methodname>set()</methodname> qui distribueront
        leurs options. Si l'option <code>internal_id</code> est présente, alors la méthode
        <methodname>setInternalId()</methodname> sera évaluée si présente, et l'option en question lui sera
        passée. Si une telle méthode n'existe pas, l'option sera alors vue comme une propriété de la page
        et sera accessible sous <code>$internalId = $page->internal_id;</code> ou
        <code>$internalId = $page->get('internal_id');</code>.
    </para>

    <example id="zend.navigation.custom.example.simple">
        <title>La page personnalisée la plus simple possible</title>

        <para>
            La seule chose à définir dans une page personnalisée est la méthode
            <methodname>getHref()</methodname>.
        </para>

        <programlisting language="php"><![CDATA[
class My_Simple_Page extends Zend_Navigation_Page
{
    public function getHref()
    {
        return 'Quelquechose-ici--ce-que-je-veux';
    }
}
]]></programlisting>
    </example>

    <example id="zend.navigation.custom.example.properties">
        <title>Une page personnalisée avec des propriétés</title>

        <para>
            Ajouter des propriétés à vos pages étendues ne nécessite pas de réécrire
            <methodname>setOptions()</methodname> ou <methodname>setConfig()</methodname>.
        </para>

        <programlisting language="php"><![CDATA[
class My_Navigation_Page extends Zend_Navigation_Page
{
    private $_foo;
    private $_fooBar;

    public function setFoo($foo)
    {
        $this->_foo = $foo;
    }

    public function getFoo()
    {
        return $this->_foo;
    }

    public function setFooBar($fooBar)
    {
        $this->_fooBar = $fooBar;
    }

    public function getFooBar()
    {
        return $this->_fooBar;
    }

    public function getHref()
    {
        return $this->foo . '/' . $this->fooBar;
    }
}

// can now construct using
$page = new My_Navigation_Page(array(
    'label'   => 'Les noms des propriétés sont dirigés vers les setters',
    'foo'     => 'bar',
    'foo_bar' => 'baz'
));

// ...or
$page = Zend_Navigation_Page::factory(array(
    'type'    => 'My_Navigation_Page',
    'label'   => 'Les noms des propriétés sont dirigés vers les setters',
    'foo'     => 'bar',
    'foo_bar' => 'baz'
));
]]></programlisting>
    </example>
</sect2>