7.12. Presentación del Formulario
Cuando nuestra acción de controlador está lista todo lo que tenemos que hacer
es preparar el archivo de plantilla de vista .phtml para mostrar nuestro
formulario en una página web. En la plantilla de vista necesitamos definir
la estructura con el uso de <form>, <label>, <input> y quizás de otras
etiquetas HTML.
Además, debemos mostrar los mensajes de error si la validación del formulario falla. Como este trabajo es aburrido Zend Framework 3 provee unos ayudantes de vista especiales con la intención de mostrar el formulario en la pantalla.
Para un formulario simple (que no muestra mensajes de error) podemos usar etiquetas HTML crudas y así mostrar el formulario ignorando los ayudantes de vista provistos por ZF3. Pero, los ayudantes de vista son realmente inevitables cuando mostramos formularios complejos que deben mostrar errores de validación y/o agregar campos dinámicamente.
7.12.1. Preparar el Modelo de Formulario para la Impresión en la Pantalla
Antes de mostrar el formulario en la pantalla es necesario que llamemos al
método prepare() en la instancia del modelo de formulario (ver tabla 7.12).
Si olvidamos llamar a este método puede haber efectos indeseables.
| Nombre del método | Descripción |
|---|---|
prepare() |
Asegura que el formulario está listo para usarse. |
El método prepare() hace los siguientes preparativos al modelo de formulario:
Llama al contenedor del filtro de entrada asociado al modelo de formulario para asegurar que los mensajes de error están disponibles.
Prepara cualquier elemento y/o conjunto de elementos que necesiten preparación 25.
25) Generalmente en la preparación los nombres de campos se envuelven con el nombre del formulario o del conjunto de elementos (por ejemplo, el nombre del campo "email" se convertirá en "contact-form[email]") que resulta técnicamente en una agrupación de campos en el cuerpo de la petición HTTP más conveniente.