|
|
@@ -1,59 +1,70 @@
|
|
|
<?xml version="1.0" encoding="UTF-8"?>
|
|
|
-<!-- EN-Revision: 15103 -->
|
|
|
+<!-- EN-Revision: 17663 -->
|
|
|
<!-- Reviewed: no -->
|
|
|
<sect1 id="zend.form.standardElements">
|
|
|
- <title>Elementos Enviados en el Formulario Estandard de Zend Framework</title>
|
|
|
+ <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 <acronym>HTML</acronym>. 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>
|
|
|
+ <para>Zend Framework viene con clases de elementos concretos cubriendo la
|
|
|
+ mayoría de los elementos de los formularios <acronym>HTML</acronym>. 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 <acronym>HTML</acronym> 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
|
|
|
+ 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>
|
|
|
+ <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>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>
|
|
|
+ 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>
|
|
|
+ <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>
|
|
|
+ <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:
|
|
|
@@ -63,8 +74,9 @@ $element->setCaptcha(new Zend_Captcha_Figlet());
|
|
|
$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>
|
|
|
+ <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:
|
|
|
@@ -89,63 +101,75 @@ $element = new Zend_Form_Element_Captcha('foo', array(
|
|
|
));
|
|
|
]]></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>
|
|
|
+ <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) <acronym>HTML</acronym> 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,
|
|
|
+ <para>Las casillas de verificación (checkboxes) <acronym>HTML</acronym>
|
|
|
+ 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>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>
|
|
|
+ <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>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>
|
|
|
+ <para>By default, it uses the <methodname>Http</methodname> transfer
|
|
|
+ adapter, which introspects the <varname>$_FILES</varname>
|
|
|
+ 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>
|
|
|
+ <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');
|
|
|
@@ -160,17 +184,20 @@ $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>
|
|
|
+ <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>
|
|
|
+ <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) {
|
|
|
@@ -189,42 +216,49 @@ $location = $form->foo->getFileName();
|
|
|
<note>
|
|
|
<title>Ubicaciones Predeterminadas para la Carga de Archivos</title>
|
|
|
|
|
|
- <para>Por defecto, los archivos son cargados al directorio temp del sistema.</para>
|
|
|
+ <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>
|
|
|
+ <para>Dentro de <acronym>HTTP</acronym>, 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>
|
|
|
+ <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>
|
|
|
+ <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>
|
|
|
+ <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>
|
|
|
+ <para>First call
|
|
|
+ <methodname>setValueDisabled(true)</methodname>.</para>
|
|
|
|
|
|
<programlisting language="php"><![CDATA[
|
|
|
$element = new Zend_Form_Element_File('foo');
|
|
|
@@ -235,8 +269,9 @@ $element->setLabel('Upload an image:')
|
|
|
|
|
|
<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>
|
|
|
+ <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();
|
|
|
@@ -249,26 +284,26 @@ if ($form->isValid($form->getPost())) {
|
|
|
]]></programlisting>
|
|
|
</example>
|
|
|
|
|
|
- <para>There are several states of the uploaded file which can be checked with the following
|
|
|
- methods:</para>
|
|
|
+ <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>
|
|
|
+ <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>
|
|
|
+ <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>
|
|
|
+ <methodname>isFiltered()</methodname>: Checks if the filters
|
|
|
+ have already been applied to the file element or not.</para>
|
|
|
</listitem>
|
|
|
</itemizedlist>
|
|
|
|
|
|
@@ -291,17 +326,20 @@ if ($form->foo->isUploaded()) {
|
|
|
</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>
|
|
|
+ <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>
|
|
|
+ <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');
|
|
|
@@ -318,29 +356,40 @@ $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>
|
|
|
+ <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>
|
|
|
+ <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
|
|
|
+ subformularios.</para>
|
|
|
+
|
|
|
+ <para>Tan pronto como haya dos elementos file nombrados de forma
|
|
|
+ idéntica, el segundo elemento no se mostrará o enviará.</para>
|
|
|
+
|
|
|
+ <para>
|
|
|
+ Additionally, file elements are not rendered within the sub-form. So when
|
|
|
+ you add a file element into a subform, then the element will be rendered
|
|
|
+ within the main form.
|
|
|
+ </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>
|
|
|
+ <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
|
|
|
+ <constant>MAX_FILE_SIZE</constant> 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');
|
|
|
@@ -354,34 +403,38 @@ $form->addElement($element, 'foo');
|
|
|
<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>Cuando usted usa elementos file múltiples en los formularios
|
|
|
+ tiene que establecer el <constant>MAX_FILE_SIZE</constant>
|
|
|
+ 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>
|
|
|
+ <para>Note que usted puede establecer
|
|
|
+ <constant>MAX_FILE_SIZE</constant> 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
|
|
|
+ <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
|
|
|
+ <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>
|
|
|
+ <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'));
|
|
|
@@ -391,73 +444,86 @@ $form->addElement('hash', 'no_csrf_foo', array('salt' => 'unique'));
|
|
|
<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>
|
|
|
+ <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>
|
|
|
+ <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>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á <constant>TRUE</constant>.</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>
|
|
|
+ <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á
|
|
|
+ <constant>TRUE</constant>.</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>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>
|
|
|
+ <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>
|
|
|
+ </para>
|
|
|
</listitem>
|
|
|
|
|
|
<listitem>
|
|
|
<para>
|
|
|
<methodname>addMultiOptions(array $options)</methodname>
|
|
|
- </para>
|
|
|
+ </para>
|
|
|
</listitem>
|
|
|
|
|
|
<listitem>
|
|
|
- <para><methodname>setMultiOptions(array $options)</methodname> (overwrites existing
|
|
|
- options)</para>
|
|
|
+ <para><methodname>setMultiOptions(array $options)</methodname>
|
|
|
+ (overwrites existing options)</para>
|
|
|
</listitem>
|
|
|
|
|
|
<listitem>
|
|
|
@@ -471,19 +537,19 @@ $form->addElement('hash', 'no_csrf_foo', array('salt' => 'unique'));
|
|
|
<listitem>
|
|
|
<para>
|
|
|
<methodname>removeMultiOption($option)</methodname>
|
|
|
- </para>
|
|
|
+ </para>
|
|
|
</listitem>
|
|
|
|
|
|
<listitem>
|
|
|
<para>
|
|
|
<methodname>clearMultiOptions()</methodname>
|
|
|
- </para>
|
|
|
+ </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>
|
|
|
+ <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(
|
|
|
@@ -498,36 +564,41 @@ $element = new Zend_Form_Element_MultiCheckbox('foo', array(
|
|
|
$element->setValue(array('bar', 'bat'));
|
|
|
]]></programlisting>
|
|
|
|
|
|
- <para>Note que cuando se determina un asimple variable, se debe pasar un array.</para>
|
|
|
+ <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><acronym>XHTML</acronym> <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>
|
|
|
+ <para><acronym>XHTML</acronym>
|
|
|
+ <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>
|
|
|
+ </para>
|
|
|
</listitem>
|
|
|
|
|
|
<listitem>
|
|
|
<para>
|
|
|
<methodname>addMultiOptions(array $options)</methodname>
|
|
|
- </para>
|
|
|
+ </para>
|
|
|
</listitem>
|
|
|
|
|
|
<listitem>
|
|
|
- <para><methodname>setMultiOptions(array $options)</methodname> (overwrites existing
|
|
|
- options)</para>
|
|
|
+ <para><methodname>setMultiOptions(array $options)</methodname>
|
|
|
+ (overwrites existing options)</para>
|
|
|
</listitem>
|
|
|
|
|
|
<listitem>
|
|
|
@@ -541,76 +612,84 @@ $element->setValue(array('bar', 'bat'));
|
|
|
<listitem>
|
|
|
<para>
|
|
|
<methodname>removeMultiOption($option)</methodname>
|
|
|
- </para>
|
|
|
+ </para>
|
|
|
</listitem>
|
|
|
|
|
|
<listitem>
|
|
|
<para>
|
|
|
<methodname>clearMultiOptions()</methodname>
|
|
|
- </para>
|
|
|
+ </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>
|
|
|
+ <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>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>
|
|
|
+ <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>
|
|
|
+ <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>
|
|
|
+ </para>
|
|
|
</listitem>
|
|
|
|
|
|
<listitem>
|
|
|
<para>
|
|
|
<methodname>addMultiOptions(array $options)</methodname>
|
|
|
- </para>
|
|
|
+ </para>
|
|
|
</listitem>
|
|
|
|
|
|
<listitem>
|
|
|
- <para><methodname>setMultiOptions(array $options)</methodname> (overwrites existing
|
|
|
- options)</para>
|
|
|
+ <para><methodname>setMultiOptions(array $options)</methodname>
|
|
|
+ (overwrites existing options)</para>
|
|
|
</listitem>
|
|
|
|
|
|
<listitem>
|
|
|
@@ -624,13 +703,13 @@ $element->setValue(array('bar', 'bat'));
|
|
|
<listitem>
|
|
|
<para>
|
|
|
<methodname>removeMultiOption($option)</methodname>
|
|
|
- </para>
|
|
|
+ </para>
|
|
|
</listitem>
|
|
|
|
|
|
<listitem>
|
|
|
<para>
|
|
|
<methodname>clearMultiOptions()</methodname>
|
|
|
- </para>
|
|
|
+ </para>
|
|
|
</listitem>
|
|
|
</itemizedlist>
|
|
|
</sect2>
|
|
|
@@ -638,52 +717,57 @@ $element->setValue(array('bar', 'bat'));
|
|
|
<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>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>
|
|
|
+ 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>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>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>
|
|
|
+ <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>
|
|
|
+ </para>
|
|
|
</listitem>
|
|
|
|
|
|
<listitem>
|
|
|
<para>
|
|
|
<methodname>addMultiOptions(array $options)</methodname>
|
|
|
- </para>
|
|
|
+ </para>
|
|
|
</listitem>
|
|
|
|
|
|
<listitem>
|
|
|
- <para><methodname>setMultiOptions(array $options)</methodname> (overwrites existing
|
|
|
- options)</para>
|
|
|
+ <para><methodname>setMultiOptions(array $options)</methodname>
|
|
|
+ (overwrites existing options)</para>
|
|
|
</listitem>
|
|
|
|
|
|
<listitem>
|
|
|
@@ -697,60 +781,67 @@ $element->setValue(array('bar', 'bat'));
|
|
|
<listitem>
|
|
|
<para>
|
|
|
<methodname>removeMultiOption($option)</methodname>
|
|
|
- </para>
|
|
|
+ </para>
|
|
|
</listitem>
|
|
|
|
|
|
<listitem>
|
|
|
<para>
|
|
|
<methodname>clearMultiOptions()</methodname>
|
|
|
- </para>
|
|
|
+ </para>
|
|
|
</listitem>
|
|
|
</itemizedlist>
|
|
|
|
|
|
<para>
|
|
|
- <classname>Zend_Form_Element_Select</classname> usa la vista ayuda 'formSelect' para
|
|
|
- decoración.</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>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>
|
|
|
+ <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>
|
|
|
+ <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
|
|
|
- <acronym>PHP</acronym>). <classname>Zend_Form_Element_Textarea</classname> usa la
|
|
|
- vista ayuda 'textArea' para desplegar tales elementos, ocupando el valor como el
|
|
|
- contendio del elemento.</para>
|
|
|
+ <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 <acronym>PHP</acronym>).
|
|
|
+ <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>
|
benjamin-gonzales