repo_zf1/documentation/manual/fr/module_specs/Zend_Validate-Alpha.xml

<?xml version="1.0" encoding="UTF-8"?>
<!-- Reviewed: no -->
<!-- EN-Revision: 24249 -->
<sect2 id="zend.validate.set.alpha">
    <title>Alpha</title>

    <para>
        <classname>Zend_Validate_Alpha</classname> permet de valider qu'une donnée ne contient que des caractères
        alphabétiques. Il n'y a pas de limite de taille. Ce validateur fonctionne comme le validateur
         <classname>Zend_Validate_Alnum</classname> à l'exception qu'il n'accepte pas les chiffres.
    </para>

    <sect3 id="zend.validate.set.alpha.options">
        <title>Options suportées par Zend_Validate_Alpha</title>

        <para>
            Les options suivantes sont supportées par <classname>Zend_Validate_Alpha</classname>:
        </para>

        <itemizedlist>
            <listitem>
                <para>
                    <emphasis><property>allowWhiteSpace</property></emphasis>: Si les caractères d'espace
                    sont autorisés ou pas. Par défaut <constant>FALSE</constant>
                </para>
            </listitem>
        </itemizedlist>
    </sect3>

    <sect3 id="zend.validate.set.alpha.basic">
        <title>Utilisation de base</title>

        <para>
            Voici un exemple de base:
        </para>

        <programlisting language="php"><![CDATA[
$validator = new Zend_Validate_Alpha();
if ($validator->isValid('Abcd')) {
    // value ne contient que des caractères autorisés
} else {
    // false
}
]]></programlisting>
    </sect3>

    <sect3 id="zend.validate.set.alpha.whitespace">
        <title>Utiliser les espaces</title>

        <para>
            Par défaut les caractères espaces ne sont pas acceptés car il ne font pas partie de l'alphabet.
            Cependant il existe un moyen de les accepter en entrée, ceci permet de valider des phrases
            complètes.
        </para>

        <para>
            Pour autoriser les espaces blancs vous devez passer l'option <property>allowWhiteSpace</property>.
            Ceci peut se faire à la création de l'objet ou après au moyen des méthodes
            <methodname>setAllowWhiteSpace()</methodname> et <methodname>getAllowWhiteSpace()</methodname>.
        </para>

        <programlisting language="php"><![CDATA[
$validator = new Zend_Validate_Alpha(array('allowWhiteSpace' => true));
if ($validator->isValid('Abcd and efg')) {
    // value ne contient que des caractères autorisés
} else {
    // false
}
]]></programlisting>
    </sect3>

    <sect3 id="zend.validate.set.alpha.languages">
        <title>Utiliser des langues différentes</title>

        <para>
            En utilisant <classname>Zend_Validate_Alpha</classname>, la langue que l'utilisateur précise
            dans son navigateur sera utilisée pour autoriser ou non certains caractères. Ainsi si l'utilisateur
            règle son navigateur sur <emphasis>de</emphasis> pour de l'allemand, alors les caractères comme
            <emphasis>ä</emphasis>, <emphasis>ö</emphasis> et <emphasis>ü</emphasis> seront eux aussi
            autorisés.
        </para>

        <para>
            Les caractères autorisés dépendent donc complètement de la langue utilisée.
        </para>

        <para>
            Il existe actuellement 3 langues qui ne sont pas supportées pour ce validateur. Il s'agit
            de <emphasis>coréen</emphasis>, <emphasis>japonais</emphasis> et
            <emphasis>chinois</emphasis> car ces langues utilisent un alphabet dans lequel un seul
            caractère est fabriqué à base de multiples caractères.
        </para>

        <para>
            Dans le cas où vous utilisez ces langues, seule l'alphabet anglais sera utilisé pour la
            validation.
        </para>
    </sect3>
</sect2>
<!--
vim:se ts=4 sw=4 et:
-->