repo_zf1/documentation/manual/es/module_specs/Zend_Form-StandardElements.xml

<?xml version="1.0" encoding="UTF-8"?>
<!-- EN-Revision: 15103 -->
<!-- Reviewed: no -->
<sect1 id="zend.form.standardElements">
    <title>Elementos Enviados en el Formulario Estandard de Zend Framework</title>

    <para>
        Zend Framework viene con clases de elementos concretos cubriendo la
        mayoría de los elementos de los formularios HTML. La mayoría simplemente
        especifica una vista de ayuda para usar cuando se decora el elemento,
        pero varios ofrecen funcionalidad adicional. La siguiente es una lista
        de todas las clases, así como también una descripción de la
        funcionalidad que ofrecen.
    </para>

    <sect2 id="zend.form.standardElements.button">
        <title>Zend_Form_Element_Button</title>

        <para>
            Usada para crear elementos HTML de tipo button,
            <classname>Zend_Form_Element_Button</classname> extiende <link linkend="zend.form.standardElements.submit">Zend_Form_Element_Submit</link>,
            derivandi sy funcionalidad personalizada. It specifies the 'formButton'
            view helper for decoration.
        </para>

        <para>
            Like the submit element, it uses the element's label as the element
            value for display purposes; in other words, to set the text of the
            button, set the value of the element. The label will be translated
            if a translation adapter is present.
        </para>

        <para>
            Because the label is used as part of the element, the button element
            uses only the <link linkend="zend.form.standardDecorators.viewHelper">ViewHelper</link>
            and <link linkend="zend.form.standardDecorators.dtDdWrapper">DtDdWrapper</link>
            decorators.
        </para>

        <para>
            Después de llenar o validar un formulario, se puede verificar si el
            botón dado fue pulsado usando el método <methodname>isChecked()</methodname>.
        </para>
    </sect2>

    <sect2 id="zend.form.standardElements.captcha">
        <title>Zend_Form_Element_Captcha</title>

        <para>
            Los CAPTCHAs son usados para prevenir el envio automático de
            formularios por los robots y otros procesos automatizados.
        </para>

        <para>
            The Captcha form element allows you to specify which
            <link linkend="zend.captcha.adapters">Zend_Captcha adapter</link> you
            wish to utilize as a form captcha. It then sets this adapter as a
            validator to the object, and uses a Captcha decorator for rendering
            (which proxies to the CAPTCHA adapter).
        </para>

        <para>
            Adapters may be any adapters in <classname>Zend_Captcha</classname>, as well
            as any custom adapters you may have defined elsewhere. To allow
            this, you may pass an additional plugin loader type key, 'CAPTCHA'
            or 'captcha', when specifying a plugin loader prefix path:
        </para>

         <programlisting language="php"><![CDATA[
$element->addPrefixPath('My_Captcha', 'My/Captcha/', 'captcha');
]]></programlisting>

        <para>
            Los Captcha entonces pueden ser cargados usando el método
            <methodname>setCaptcha()</methodname>, el cual puede tomar una instancia
            cualquiera de CAPTCHA instance, o el nombre corto del adaptador
            captcha:
        </para>

         <programlisting language="php"><![CDATA[
// instancia concreta:
$element->setCaptcha(new Zend_Captcha_Figlet());

// Usando nombre corto:
$element->setCaptcha('Dumb');
]]></programlisting>

        <para>
            Si desea cargar sus elementos configuración, especifique la clave
            'captcha' con un array conteniendo la clave 'captcha', o
            ambas claves 'captcha' y 'captchaOptions':
        </para>

         <programlisting language="php"><![CDATA[
// Usindo la clave captcha simple:
$element = new Zend_Form_Element_Captcha('foo', array(
    'label' => "Please verify you're a human",
    'captcha' => array(
        'captcha' => 'Figlet',
        'wordLen' => 6,
        'timeout' => 300,
    ),
));

// Usindo captcha y captchaOptions:
$element = new Zend_Form_Element_Captcha('foo', array(
    'label' => "Please verify you're a human"
    'captcha' => 'Figlet',
    'captchaOptions' => array(
        'captcha' => 'Figlet',
        'wordLen' => 6,
        'timeout' => 300,
    ),
));
]]></programlisting>

        <para>
            El decorador usado es determinado consultando el adaptador captcha.
            Por defecto, es usado el
            <link linkend="zend.form.standardDecorators.captcha">Captcha
            decorator</link>, pero un adaptador puede especificar uno
            diferente vía su método<methodname>getDecorator()</methodname>.
        </para>

        <para>
            Como ha notado, el adaptador CAPTCHA actúa él mismo como un validador
            para el elemento. Adicionalmente, el validador NotEmpty
            no es usado y el elemento es marcado como requerido. En la mayoría de
            los casos, usted no necesitará hacer nada más para tener un captcha
            presente en su formulario.
        </para>
    </sect2>

    <sect2 id="zend.form.standardElements.checkbox">
        <title>Zend_Form_Element_Checkbox</title>

        <para>
            Las casillas de verificación (checkboxes) HTML le permiten devolver
            un valor específico, pero básicamente funcionan como los booleanos:
            cuando está marcada, el valor es enviado; cuando no está marcada, no
            se envía nada. Internamente, Zend_Form_Element_Checkbox fuerza este
            estado.
        </para>

        <para>
            Por defecto, si la casilla (checkbox) está marcada su valor es '1',
            y si no está marcada su valor es '0'.
            You can specify the values to use using the
            <methodname>setCheckedValue()</methodname> and <methodname>setUncheckedValue()</methodname>
            accessors, respectively. Internally, any time you set the value, if
            the provided value matches the checked value, then it is set, but
            any other value causes the unchecked value to be set.
        </para>

        <para>
            Additionally, setting the value sets the <methodname>checked</methodname>
            property of the checkbox. You can query this using
            <methodname>isChecked()</methodname> or simply accessing the property. Using the
            <methodname>setChecked($flag)</methodname> method will both set the state of the
            flag as well as set the appropriate checked or unchecked value in the
            element. Please use this method when setting the checked state of a
            checkbox element to ensure the value is set properly.
        </para>

        <para>
            <classname>Zend_Form_Element_Checkbox</classname> uses the 'formCheckbox' view
            helper. The checked value is always used to populate it.
        </para>
    </sect2>

    <sect2 id="zend.form.standardElements.file">
        <title>Zend_Form_Element_File</title>

        <para>
            The File form element provides a mechanism for supplying file upload
            fields to your form. It utilizes <link linkend="zend.file.transfer.introduction">Zend_File_Transfer</link>
            internally to provide this functionality, and the
            <methodname>FormFile</methodname> view helper as also the <methodname>File</methodname>
            decorator to display the form element.
        </para>

        <para>
            By default, it uses the <methodname>Http</methodname> transfer adapter, which
            introspects the <methodname>$_FILES</methodname> array and allows you to attach
            validators and filters. Validators and filters attached to the form
            element will be attached to the transfer adapter.
        </para>

        <example id="zend.form.standardElements.file.usage">
            <title>File form element usage</title>

            <para>
                The above explanation of using the File form element may seem
                arcane, but actual usage is relatively trivial:
            </para>

             <programlisting language="php"><![CDATA[
$element = new Zend_Form_Element_File('foo');
$element->setLabel('Upload an image:')
        ->setDestination('/var/www/upload');
// ensure only 1 file
$element->addValidator('Count', false, 1);
// limit to 100K
$element->addValidator('Size', false, 102400);
// only JPEG, PNG, and GIFs
$element->addValidator('Extension', false, 'jpg,png,gif');
$form->addElement($element, 'foo');
]]></programlisting>

            <para>
                También debe asegurarse de que se ha provisto un tipo de
                codificación corecto al formulario; se debe utilizar
                'multipart/form-data'. Se puede hacer esto estableciendo el
                atributo 'enctype' en el formulario:
            </para>

             <programlisting language="php"><![CDATA[
$form->setAttrib('enctype', 'multipart/form-data');
]]></programlisting>

            <para>
                After the form is validated successfully, you must receive the file
                to store it in the final destination using <methodname>receive()</methodname>. Additionally you
                can determinate the final location using <methodname>getFileName()</methodname>:
            </para>

             <programlisting language="php"><![CDATA[
if (!$form->isValid) {
    print "Ohoh... validation error";
}

if (!$form->foo->receive()) {
    print "Error receiving the file";
}

$location = $form->foo->getFileName();
]]></programlisting>

        </example>

        <note>
            <title>Ubicaciones Predeterminadas para la Carga de Archivos</title>

            <para>
                Por defecto, los archivos son cargados al directorio temp del
                sistema.
            </para>
        </note>

        <note>
            <title>Valores de archivo</title>

            <para>
                Dentro de HTTP, un elemento file no tiene valor. Por tanto y a
                causa de razones de seguridad usted solo obtendrá el nombre del
                archivo cargado llamando a getValue() y no el destino completo.
                si usted necesita la información completa llame a getFileName() y
                le devolverá el destino y nombre de archivo completo.
            </para>
        </note>

                <para>
            Per default the file will automatically be received when you call
            <methodname>getValues()</methodname> on the form. The reason behind this behaviour is, that the
            file itself is the value of the file element.
        </para>

         <programlisting language="php"><![CDATA[
$form->getValues();
]]></programlisting>

        <note>
            <para>
                Therefor another call of <methodname>receive()</methodname> after calling
                <methodname>getValues()</methodname> will not have an effect. Also creating a instance of
                <classname>Zend_File_Transfer</classname> will not have an effect as there no file anymore
                to receive.
            </para>
        </note>

        <para>
            Still, sometimes you may want to call <methodname>getValues()</methodname> without receiving the
            file. You can archive this by calling <methodname>setValueDisabled(true)</methodname>. To get the
            actual value of this flag you can call <methodname>isValueDisabled()</methodname>.
        </para>

        <example id="zend.form.standardElements.file.retrievement">
            <title>Explicit file retrievement</title>

            <para>
                First call <methodname>setValueDisabled(true)</methodname>.
            </para>

             <programlisting language="php"><![CDATA[
$element = new Zend_Form_Element_File('foo');
$element->setLabel('Upload an image:')
        ->setDestination('/var/www/upload')
        ->setValueDisabled(true);
]]></programlisting>

            <para>
                Now the file will not be received when you call <methodname>getValues()</methodname>.
                So you must call <methodname>receive()</methodname> on the file element, or an instance of
                <classname>Zend_File_Transfer</classname> yourself.
            </para>

             <programlisting language="php"><![CDATA[
$values = $form->getValues();

if ($form->isValid($form->getPost())) {
    if (!$form->foo->receive()) {
        print "Upload error";
    }
}
]]></programlisting>
        </example>

        <para>
            There are several states of the uploaded file which can be checked
            with the following methods:
        </para>

        <itemizedlist>
            <listitem>
                <para>
                    <methodname>isUploaded()</methodname>: Checks if the file element has
                    been uploaded or not.
                </para>
            </listitem>

            <listitem>
                <para>
                    <methodname>isReceived()</methodname>: Checks if the file element has
                    already been received.
                </para>
            </listitem>

            <listitem>
                <para>
                    <methodname>isFiltered()</methodname>: Checks if the filters have already
                    been applied to the file element or not.
                </para>
            </listitem>
        </itemizedlist>

        <example id="zend.form.standardElements.file.isuploaded">
            <title>Checking if an optional file has been uploaded</title>

             <programlisting language="php"><![CDATA[
$element = new Zend_Form_Element_File('foo');
$element->setLabel('Upload an image:')
        ->setDestination('/var/www/upload')
        ->setRequired(false);
$element->addValidator('Size', false, 102400);
$form->addElement($element, 'foo');

// The foo file element is optional but when it's given go into here
if ($form->foo->isUploaded()) {
    // foo file given... do something
}
]]></programlisting>
        </example>

        <para>
            <classname>Zend_Form_Element_File</classname> soporta también archivos
            múltiples. Para llamar el método <methodname>setMultiFile($count)</methodname>
            usted puede establecer la cantidad de elementos file que usted desea
            crear. Esto le previene de establecer la misma configuración varias
            veces.
        </para>

        <example id="zend.form.standardElements.file.multiusage">
            <title>Configuración de múltiples archivos</title>

            <para>
                Crear un elemento multi archivo es lo mismo que querer configurar
                un elemento único. Sólo tiene que llamar a
                <methodname>setMultiFile()</methodname> adicionalmente después de la creación:
            </para>

             <programlisting language="php"><![CDATA[
$element = new Zend_Form_Element_File('foo');
$element->setLabel('Upload an image:')
        ->setDestination('/var/www/upload');
// asegura mínimo 1, maximo 3 archivos
$element->addValidator('Count', false, array('min' => 1, 'max' => 3));
// limita a 100K
$element->addValidator('Size', false, 102400);
// solo JPEG, PNG, y GIFs
$element->addValidator('Extension', false, 'jpg,png,gif');
// define 3 elementos file idénticos
$element->setMultiFile(3);
$form->addElement($element, 'foo');
]]></programlisting>

            <para>
                En su vista usted ahora obtendrá 3 elementos para carga de
                archivos idénticos los cuales comparten la misma configuración.
                Para obtener el conjunto del número de archivos múltiples
                simplemente llame a <methodname>getMultiFile()</methodname>.
            </para>

        </example>

        <note>
            <title>Elementos File en Subformularios</title>

            <para>
                Cuando usted use elementos file en subformularios debería
                establecer nombres únicos.
                Así, cuando usted nombre su elemento file en el subformulario1,
                debe darle un nombre diferente en el subformulario2.
            </para>

            <para>
                Tan pronto como haya dos elementos file nombrados de forma
                idéntica, el segundo elemento no se mostrará o enviará.
            </para>
        </note>

        <para>
            Para limitar el tamaño del archivo, el cual es cargado por el
            cliente, debe establecer el tamaño máximo de archivo que el
            formulario acepta . Esto limitará el tamaño del archivo en el lado
            del cliente configurando la opción <methodname>MAX_FILE_SIZE</methodname>
            en el formulario. Tan pronto como establezca este valor usando
            el método <methodname>setMaxFileSize($size)</methodname>, será generado
            con el elemento file.
        </para>

         <programlisting language="php"><![CDATA[
$element = new Zend_Form_Element_File('foo');
$element->setLabel('Upload an image:')
        ->setDestination('/var/www/upload')
        ->addValidator('Size', false, 102400) // límite en 100K
        ->setMaxFileSize(102400); // limita el tamaño del archivo en el lado del cliente
$form->addElement($element, 'foo');
]]></programlisting>

        <note>
            <title>MaxFileSize con elementos file múltiples</title>

            <para>
                Cuando usted usa elementos file múltiples en los formularios tiene
                que establecer el <methodname>MAX_FILE_SIZE</methodname> una sola vez.
                 Establecerlo otra vez sobreescribirá el valor previamente
                 establecido.
            </para>

            <para>
                Note que usted puede establecer <methodname>MAX_FILE_SIZE</methodname>
                una sola vez, incluso si usa múltiples formularios.
            </para>
        </note>
    </sect2>

    <sect2 id="zend.form.standardElements.hidden">
        <title>Zend_Form_Element_Hidden</title>

        <para>
            Los elementos Hidden simplemente inyectan datos que deben ser
            enviados, pero que el usuario no debe manipular.
            <classname>Zend_Form_Element_Hidden</classname> logra esto a través del uso del helper de vista 'formHidden'.
        </para>
    </sect2>

    <sect2 id="zend.form.standardElements.hash">
        <title>Zend_Form_Element_Hash</title>

        <para>
            Este elemento provee protección de ataques desde CSRF sobre
            formularios, asegurando que el dato es enviado por la sesión del
            usuario que generó el formulario y no por un script malicioso.
            La protección se logra mediante la adición de un elemento hash a
            un formulario y verificandolo cuando el formulario es enviado.
        </para>

        <para>
            El nombre del elemento hash debe ser único. Se recomienda usar la
            opción <literal>salt</literal> para el elemento, dos hashes con
            el mismo nombre y diferentes salts no chocan:
        </para>

         <programlisting language="php"><![CDATA[
$form->addElement('hash', 'no_csrf_foo', array('salt' => 'unique'));
]]></programlisting>

        <para>
            Puede establecer el salt más tarde usando el método
            <methodname>setSalt($salt)</methodname>.
        </para>

        <para>
            Internamente, el elemento almacena un identificador único usando
            <methodname>Zend_Session_Namespace</methodname>, y lo comprueba en el momento
            que se envía (comprueba que el TTL no ha espirado). El validador
            'Identical' entonces es usado para asegurarse que el hash enviado
            marcha con el hash alamacenado.
        </para>

        <para>
            El helper de vista 'formHidden' es usado para generar el elemento
            en el formulario.
        </para>
    </sect2>

    <sect2 id="zend.form.standardElements.Image">
        <title>Zend_Form_Element_Image</title>

        <para>
            Las imágenes pueden ser usadas como elementos de formulario, y le
            permiten especificar elementos gráficos como botones de formulario.
        </para>

        <para>
            Los elementos Image necesitan una imagen fuente.
            <classname>Zend_Form_Element_Image</classname>  le permite especificar esto
            usando el método de acceso <methodname>setImage()</methodname>
            (o clave de configuración 'image'). Opcionalmente, también puede
            especificar un valor para utilizar al momento de enviar la imagen
             utilizando  el método de acceso <methodname>setImageValue()</methodname>
            (o clave de configuración 'imageValue'). Cuando el valor establecido
            para el elemento sea igual a <methodname>imageValue</methodname>, entonces
            el método de acceso <methodname>isChecked()</methodname> devolverá true.
        </para>

        <para>
            Los elementos Image usan el
            <link linkend="zend.form.standardDecorators.image">Decorador de
            Imagen </link> para generar (así como el estandard Errors,
            HtmlTag, y decorador Label). Opcionalmente, puede especificar una
            etiqueta para el decorador <methodname>Image</methodname> que luego
            envuelva al elemento imagen.
        </para>
    </sect2>

    <sect2 id="zend.form.standardElements.multiCheckbox">
        <title>Zend_Form_Element_MultiCheckbox</title>

        <para>
            En ocasiones, se tiene un conjunto de checkboxes, y se desea agrupar los
            resultados. Esto es como un
            <link linkend="zend.form.standardElements.multiselect">Multiselect</link>,
            pero en lugar de estar en una lista desplegable, necesita mostrarlos en pares checkbox/value (casilla de verificación/valor).
        </para>

        <para>
            <classname>Zend_Form_Element_MultiCheckbox</classname> hace esto sencillo. Like
            all other elements extending the base Multi element, you can specify
            a list of options, and easily validate against that same list. The
            'formMultiCheckbox' view helper ensures that these are returned as
            an array in the form submission.
        </para>

        <para>
            Por defecto, este elemnto requiere un validador <methodname>InArray</methodname>
            el cual valida contra el array de llaves de las opciones registradas. Se
            puede desactivar esta caracteristica llamando a
            <methodname>setRegisterInArrayValidator(false)</methodname>, o pasando un
            valor falso a la configuración de llaves
            <methodname>registerInArrayValidator</methodname>.
        </para>

        <para>
            Se puede manipular las opciones de checkbox usando los siguinetes
            métodos:
        </para>

        <itemizedlist>
            <listitem><para><methodname>addMultiOption($option, $value)</methodname></para></listitem>

            <listitem><para><methodname>addMultiOptions(array $options)</methodname></para></listitem>

            <listitem><para><methodname>setMultiOptions(array $options)</methodname>
                    (overwrites existing options)</para></listitem>

            <listitem><para>getMultiOption($option)</para></listitem>

            <listitem><para>getMultiOptions()</para></listitem>

            <listitem><para><methodname>removeMultiOption($option)</methodname></para></listitem>

            <listitem><para><methodname>clearMultiOptions()</methodname></para></listitem>
        </itemizedlist>

        <para>
            Para marcar los valores confirmados, se necesita pasar un array de valores a
            <methodname>setValue()</methodname>. El siguiente código verificará los valores "bar"
            y "bat":
        </para>

         <programlisting language="php"><![CDATA[
$element = new Zend_Form_Element_MultiCheckbox('foo', array(
    'multiOptions' => array(
        'foo' => 'Foo Option',
        'bar' => 'Bar Option',
        'baz' => 'Baz Option',
        'bat' => 'Bat Option',
    );
));

$element->setValue(array('bar', 'bat'));
]]></programlisting>

        <para>
            Note que cuando se determina un asimple variable, se debe pasar un array.
        </para>
    </sect2>

    <sect2 id="zend.form.standardElements.multiselect">
        <title>Zend_Form_Element_Multiselect</title>

        <para>
            XHTML <methodname>selector</methodname> de elementos permite 'multiple' atributos,
            indicando multiples opciones pueden ser seleccionados por submision, en vez
            de lo usual. <classname>Zend_Form_Element_Multiselect</classname> extiende
            <link linkend="zend.form.standardElements.select">Zend_Form_Element_Select</link>,
            y define los atributos <methodname>multiple</methodname> a 'multiple'. Como las otras
            clases que heredan de la clase base
            <classname>Zend_Form_Element_Multi</classname>, se puede manipular las
            opciones del selector usando:
        </para>

        <itemizedlist>
            <listitem><para><methodname>addMultiOption($option, $value)</methodname></para></listitem>

            <listitem><para><methodname>addMultiOptions(array $options)</methodname></para></listitem>

            <listitem><para><methodname>setMultiOptions(array $options)</methodname>
                    (overwrites existing options)</para></listitem>

            <listitem><para>getMultiOption($option)</para></listitem>

            <listitem><para>getMultiOptions()</para></listitem>

            <listitem><para><methodname>removeMultiOption($option)</methodname></para></listitem>

            <listitem><para><methodname>clearMultiOptions()</methodname></para></listitem>
        </itemizedlist>

        <para>
            Si un adaptador de tranducción es registrado con el formulario y/o elemnto,
            la opción valores será traducido para propósito de despliegue.
        </para>

        <para>
            Por defecto, este elemento registra un validador <methodname>InArray</methodname>
            el cual valida contra el array de llaves de opciones registradas. se puede
            deshabilitar esta caracteristica llamando a
            <methodname>setRegisterInArrayValidator(false)</methodname>, o pasando
            un valor falso a la configuracion de llaves
            <methodname>registerInArrayValidator</methodname>.
        </para>
    </sect2>

    <sect2 id="zend.form.standardElements.password">
        <title>Zend_Form_Element_Password</title>

        <para>
            Elementos contraseña son basicamente elementos de texto -- excepto que
            tipicamente no se quiera desplegar la contraseña en los mensajes de
            error o del elemnto en si cuando el formulario es re desplegado.
        </para>

        <para>
            <classname>Zend_Form_Element_Password</classname> archiva esto llamando
            <methodname>setObscureValue(true)</methodname> en cada validador (asegurando que
            la contraseña este oculta en mensajes de validación de errores), y usando
            la vista ayuda 'formPassword' (el cual no desplega el valor
            pasado).
        </para>
    </sect2>

    <sect2 id="zend.form.standardElements.radio">
        <title>Zend_Form_Element_Radio</title>

        <para>
            elementos de Radio permite especificar muchas opciones, de los cuales
            se necesita retornar un solo valor. <classname>Zend_Form_Element_Radio</classname>
            extiende la clase base <classname>Zend_Form_Element_Multi</classname>,
            permitiendonos especificar un numero de opciones, y luego usa la
            vista ayuda <methodname>formRadio</methodname> para desplegar.
        </para>

        <para>
            Por defecto, este elemento registra un validador <methodname>InArray</methodname>
            el cual valida contra el array de llaves de opciones registradas. se puede
            deshabilitar esta caracteristica llamando a
            <methodname>setRegisterInArrayValidator(false)</methodname>, o pasando
            un valor falso a la configuracion de llaves
            <methodname>registerInArrayValidator</methodname>.
            configuration key.
        </para>

        <para>
            Como todos los elementos se extienden del elemento clase base Multi,
            los siguientes métodos pueden ser usados para manipular las opciones de radio
            desplegadas:
        </para>

        <itemizedlist>
            <listitem><para><methodname>addMultiOption($option, $value)</methodname></para></listitem>

            <listitem><para><methodname>addMultiOptions(array $options)</methodname></para></listitem>

            <listitem><para><methodname>setMultiOptions(array $options)</methodname>
                    (overwrites existing options)</para></listitem>

            <listitem><para>getMultiOption($option)</para></listitem>

            <listitem><para>getMultiOptions()</para></listitem>

            <listitem><para><methodname>removeMultiOption($option)</methodname></para></listitem>

            <listitem><para><methodname>clearMultiOptions()</methodname></para></listitem>
        </itemizedlist>
    </sect2>

    <sect2 id="zend.form.standardElements.reset">
        <title>Zend_Form_Element_Reset</title>

        <para>
            Botones Reset son tipicamente usados para limpiar un formulario, y no son parte
            de la información sometida. Como sea, como ellos sirven como propósito en el despliegue,
            son incluidos en los elementos estándar.
        </para>

        <para>
            <classname>Zend_Form_Element_Reset</classname> extends <link linkend="zend.form.standardElements.submit">Zend_Form_Element_Submit</link>.
            Tal cual, la etiqueta es usada para desplegar el botón y será
            traducido si el adaptador traducción esta presente. Se utiliza sólo los
            decoradores 'ViewHelper' y 'DtDdWrapper', nunca debería existir
            mensajes de error para tales elementos, no se necesitará una etiqueta.
        </para>
    </sect2>

    <sect2 id="zend.form.standardElements.select">
        <title>Zend_Form_Element_Select</title>

        <para>
            Cajas selectoras son una manera común de limitar espeficias opciones
            para un dado formulario datum. <classname>Zend_Form_Element_Select</classname> le permite
            generar esto rápido y fácil.
        </para>

        <para>
            Por defecto, este elemento registra un validador <methodname>InArray</methodname>
            el cual valida contra el array de llaves de opciones registradas. se puede
            deshabilitar esta caracteristica llamando a
            <methodname>setRegisterInArrayValidator(false)</methodname>, o pasando
            un valor falso a la configuracion de llaves
            <methodname>registerInArrayValidator</methodname>.
            configuration key.
        </para>

        <para>
            Como se extiende el elemento base Multi, los siguientes métodos pueden ser
            usados para manipular las opciones seleccionadas:
        </para>

        <itemizedlist>
            <listitem><para><methodname>addMultiOption($option, $value)</methodname></para></listitem>

            <listitem><para><methodname>addMultiOptions(array $options)</methodname></para></listitem>

            <listitem><para><methodname>setMultiOptions(array $options)</methodname>
                    (overwrites existing options)</para></listitem>

            <listitem><para>getMultiOption($option)</para></listitem>

            <listitem><para>getMultiOptions()</para></listitem>

            <listitem><para><methodname>removeMultiOption($option)</methodname></para></listitem>

            <listitem><para><methodname>clearMultiOptions()</methodname></para></listitem>
        </itemizedlist>

        <para>
            <classname>Zend_Form_Element_Select</classname> usa la vista ayuda 'formSelect'
            para decoración.
        </para>
    </sect2>

    <sect2 id="zend.form.standardElements.submit">
        <title>Zend_Form_Element_Submit</title>

        <para>
            Submit buttons are used to submit a form. You may use multiple
            submit buttons; you can use the button used to submit the form to
            decide what action to take with the data submitted.
            <classname>Zend_Form_Element_Submit</classname> makes this decisioning easy,
            by adding a <methodname>isChecked()</methodname> method; as only one button
            element will be submitted by the form, after populating or
            validating the form, you can call this method on each submit button
            to determine which one was used.
        </para>

        <para>
            <classname>Zend_Form_Element_Submit</classname> usa la etiqueta como el "valor"
            del botón sometido, traduciendolo si el adaptador traducción esta
            presente. <methodname>isChecked()</methodname> verifica el valor sometido contra
            la etiqueta en orden to determinar si el botón ha sido usado.
        </para>

        <para>
            El <link linkend="zend.form.standardDecorators.viewHelper">ViewHelper</link>
            y <link linkend="zend.form.standardDecorators.dtDdWrapper">DtDdWrapper</link>
            decoradores generan al elemento. no decorador de etiquetas es usado, como el
            botón etiqueta es usado cuando se generan los elementos; asi tipicamente,
            no se asociarán errores con el elemnto sometido.
        </para>
    </sect2>

    <sect2 id="zend.form.standardElements.text">
        <title>Zend_Form_Element_Text</title>

        <para>
            Lejos el mas prevaleciente tipo de formulario es el elemento texto,
            permitido para entrada de texto limitado; es un elemento ideal para la
            entrada de la información. <classname>Zend_Form_Element_Text</classname> simplemente usa la
            vista ayuda 'formText' para desplegar el elemento.
        </para>
    </sect2>

    <sect2 id="zend.form.standardElements.textarea">
        <title>Zend_Form_Element_Textarea</title>

        <para>
            Textareas son usadas cuando se espera una larga cantidad de texto y
            no limites en la cantidad de texto sometido ( otro que el máximo tamaño
            tomado por su servidor or PHP).
            <classname>Zend_Form_Element_Textarea</classname> usa la vista ayuda 'textArea'
            para desplegar tales elementos, ocupando el valor como el contendio del elemento.
        </para>
    </sect2>
</sect1>
<!--
vim:se ts=4 sw=4 tw=80 et:
-->