diff --git a/docs/guide-es/start-forms.md b/docs/guide-es/start-forms.md index 70b1117..6788fc4 100644 --- a/docs/guide-es/start-forms.md +++ b/docs/guide-es/start-forms.md @@ -19,8 +19,8 @@ Creando un Modelo ----------------- Para representar los datos ingresados por un usuario, crea una clase modelo `EntryForm` cómo se muestra abajo y -guarda la clase en el archivo `models/EntryForm.php`. Por favor ver la sección [Autocargando Clases](concept-autoloading.md) -para más detalles acerca de la convención de nombres de los archivos de clase. +guarda la clase en el archivo `models/EntryForm.php`. Por favor, visita la sección [Autocargando Clases](concept-autoloading.md) +para obtener más detalles acerca de la convención de nombres de los archivos de clase. ```php -------------- -Finalmente, crea dos vistas llamadas `entry-confirm` y `entry` que son mostradas por la acción `entry`, -como fue descrito en la última sub-sección. +Finalmente, crea dos vistas llamadas `entry-confirm` y `entry` que sean mostradas por la acción `entry`, +tal y como fue descrito en la última sub-sección. -La vista `entry-confirm` simplemente muestra los datos de name y email. Debe ser guardada como el archivo `views/site/entry-confirm.php`. +La vista `entry-confirm` simplemente muestra los datos de name y email. Ésta debe ser guardada como el archivo `views/site/entry-confirm.php`. ```php ------------- +Probándolo +---------- Para ver cómo funciona, utiliza tu navegador para ir al siguiente URL: @@ -170,12 +170,12 @@ http://hostname/index.php?r=site/entry ``` Verás una página que muestra un formulario con dos campos de input. Adelante de cada campo de input, será mostrada también -una etiqueta indicando que dato necesitas ingresar. Si haces click en el botón de submit sin ingresar nada, +una etiqueta indicando que dato necesitas ingresar. Si haces click en el botón de envío (Submit) sin ingresar nada, o si ingresas una dirección de correo inválida, verás un mensaje de error que se mostrará al lado del campo que tiene problemas. ![Formulario con Errores de Validación](images/start-form-validation.png) -Después de ingresar un nombre y dirección de correo válidos y haciendo click en el botón de submit, verás una nueva página +Después de ingresar un nombre y dirección de correo válidos y haciendo click en el botón de envío (Submit), verás una nueva página mostrando los datos que acabas de ingresar. ![Confirmación de los Datos de Entrada](images/start-entry-confirmation.png) @@ -184,15 +184,15 @@ mostrando los datos que acabas de ingresar. ### Magia Explicada -Te puedes preguntar como el formulario HTML funciona detrás de cámara, porque parece casi mágico que pueda +Te estarás preguntando cómo funciona toda esa automatización del formulario HTML, porque parece casi mágico que pueda mostrar una etiqueta para cada campo de input y mostrar los mensajes de error si no ingresas los datos correctamente sin recargar la página. -Si, la validación de los datos es realmente realizada en el lado del cliente utilizando JavaScript así como también en el lado del servidor. -[[yii\widgets\ActiveForm]] es lo suficientemente inteligente para extraer las reglas de validación que has declarado en `EntryForm`, +Si, la validación de los datos se realiza en el lado del cliente utilizando JavaScript así como también en el lado del servidor. +[[yii\widgets\ActiveForm]] es lo suficientemente inteligente como para extraer las reglas de validación que has declarado en `EntryForm`, convertirlas en código Javascript, y utilizar el JavaScript para realizar la validación de los datos. En caso de que hayas deshabilitado -JavaScript en tu navegador, la validación igual se realizará en el lado del servidor, como se muestra en -el método `actionEntry()`. Esto garantiza la validez de los datos en todas las circunstancias. +JavaScript en tu navegador, la validación se realizará igualmente en el lado del servidor, como se muestra en +el método `actionEntry()`. Esto garantiza la validez de los datos en cualquier circunstancias. Las etiquetas de los campos de input son generados por el método `field()` basado en los nombres de las propiedades del modelo. Por ejemplo, la etiqueta `Name` será generada de la propiedad `name`. Puedes personalizar una etiqueta con