La etiqueta <input> es seguramente la etiqueta más sencilla que vas a utilizar en los formularios y se representa mediante la clase sfWidgetFormInput.
| Opción | Descripción |
|---|---|
type | El valor del atributo type de HTML (por defecto vale text) |
$w = new sfWidgetFormInput(); echo $w->render('nombre'); # <input type="text" name="nombre" id="nombre" />
sfWidgetFormInputCheckbox es un widget de tipo <input> cuyo atributo type es checkbox.
$w = new sfWidgetFormInputCheckbox(); echo $w->render('nombre'); # <input type="checkbox" name="nombre" id="nombre" />
sfWidgetFormInputHidden es un widget de tipo <input> cuyo atributo type vale hidden. La opción is_hidden también se establece al valor true.
$w = new sfWidgetFormInputHidden(); echo $w->render('nombre'); # <input type="hidden" name="nombre" id="nombre" />
sfWidgetFormInputPassword es un widget de tipo <input> cuyo atributo type es password.
$w = new sfWidgetFormInputPassword(); echo $w->render('nombre'); # <input type="password" name="nombre" id="nombre" />
The sfWidgetFormInputFile es un widget de tipo <input> cuyo atributo type vale file. El valor de la opción needs_multipart se establece automáticamente a true.
$w = new sfWidgetFormInputFile(); echo $w->render('nombre'); # <input type="file" name="nombre" id="nombre" />
sfWidgetFormInputFileEditable es un tipo de widget relacionado con los archivos, que extiende el widget sfWidgetFormInputFile para añadir la posibilidad de mostrar o eliminar un archivo subido previamente.
| Opción | Descripción |
|---|---|
file_src | La ruta web de la imagen actual (esta opción es obligatoria) |
edit_mode | Valor booleano que vale true si se ha habilitado la posibilidad de editar el archivo y false en cualquier otro caso |
is_image | Indica si el archivo es una imagen que se puede visualizar |
with_delete | Indica si se añade un checkbox que permita borrar el archivo |
delete_label | El título que se muestra para la opción de borrar el archivo |
template | Código HTML de la plantilla utilizada para mostrar este widget. Las variables disponibles en esta plantilla son las siguientes:input (el widget para subir una imagen)delete (el checkbox para borrar el archivo)delete_label (el título de la opción de borrado)file (la etiqueta del archivo) |
En el modo edit, este widget muestra otro widget cuyo nombre se forma con el mismo nombre que el widget para subir el archivo y el sufijo _delete. Por lo tanto, cuando crees un formulario, no olvides añadir también un validador para este campo adicional.
sfWidgetFormTextarea es un widget simple de tipo <textarea>. Los valores de los atributos rows y cols se establecen automáticamente porque son obligatorios.
$w = new sfWidgetFormTextarea(); echo $w->render('nombre'); # <textarea rows="4" cols="30" name="nombre" id="nombre"></textarea>
Al contrario que el widget del <textarea> simple, sfWidgetFormTextareaTinyMCE muestra un editor avanzado de tipo WYSIWYG:
$w = new sfWidgetFormTextareaTinyMCE( array(), array('class' => 'foo') );
Este widget es parte del plugin sfFormExtraPlugin de Symfony.
Como los archivos JavaScript del editor TinyMCE no se incluyen con el plugin, debes instalarlos e incluirlos manualmente.
| Opción | Descripción |
|---|---|
theme | El tema utilizado por Tiny MCE (por defecto se utiliza el tema advanced) |
width | La anchura del editor |
height | La altura del editor |
config | Un array con la configuración específica de JavaScript |
Capítulo original en inglés Chapter 12 - Appendix A - Widgets Traducido por Javier Eguíluz