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

    <para>
        <classname>Zend_Tag</classname> est une suite de composants permettant de manipuler
        des entités taguables. Ce composant propose 2 classes dans ce but,
        <classname>Zend_Tag_Item</classname> et <classname>Zend_Tag_ItemList</classname>. Aussi,
        l'interface <classname>Zend_Tag_Taggable</classname> vous permet d'utiliser vos modèles dans
        des tags avec <classname>Zend_Tag</classname>.
    </para>

    <para>
        <classname>Zend_Tag_Item</classname> est un composant proposant les fonctionnalités
        basiques pour traiter des tags dans <classname>Zend_Tag</classname>. Une entités taguables
        consiste en un titre et un poids (nombre d'occurrences). Il existe aussi d'autres paramètres
        utilisés par <classname>Zend_Tag</classname>.
    </para>

    <para>
        Pour grouper plusieurs entités ensemble, <classname>Zend_Tag_ItemList</classname>
        propose un itérateur de tableau et des fonctions pour calculer le poids absolu des valeurs
        en fonction du poids de chaque entité.
    </para>

    <example id="zend.tag.example.using">
        <title>Utiliser Zend_Tag</title>

        <para>
            Cet exemple montre comment créer une liste de tags en pondérant chacun d'eux.
        </para>

        <programlisting language="php"><![CDATA[
// Crée la liste
$list = new Zend_Tag_ItemList();

// Ajoute des entités dans la liste
$list[] = new Zend_Tag_Item(array('title' => 'Code', 'weight' => 50));
$list[] = new Zend_Tag_Item(array('title' => 'Zend Framework', 'weight' => 1));
$list[] = new Zend_Tag_Item(array('title' => 'PHP', 'weight' => 5));

// Valeurs absolues des entités
$list->spreadWeightValues(array(1, 2, 3, 4, 5, 6, 7, 8, 9, 10));

// Sortie
foreach ($list as $item) {
    printf("%s: %d\n", $item->getTitle(), $item->getParam('weightValue'));
}
]]></programlisting>

        <para>
            Ceci va afficher les 3 entités Code, Zend Framework et <acronym>PHP</acronym> avec les valeurs
            absolues 10, 1 et 2.
        </para>
    </example>
</sect1>