Appendice A - Widget

Introduzione

Il framework dei form di symfony viene fornito con widget molto utili. Questi widget coprono le esigenze della maggior parte dei progetti. Questo capitolo descrive i widget dei form forniti con symfony. Abbiamo anche incluso alcuni widget dei form presenti in sfFormExtraPlugin, sfPropelPlugin e sfDoctrinePlugin, dal momento che questi plugin sono supportati dal team principale e includono alcuni widget molto utili.

Prima di entrare nel dettaglio dei widget, vediamo che cosa hanno in comune i widget.

La classe base sfWidget

Tutti i widget di symfony ereditano dalla classe base sfWidget, che fornisce alcune caratteristiche predefinite a disposizione di tutti i widget.

Per impostazione predefinita, tutti i widget sono resi come XHTML. È possibile passare all'HTML chiamando il metodo setXhtml():

sfWidget::setXhtml(false);

Il sistema dei widget si prende anche cura automaticamente dell'escape degli attributi HTML e dei contenuti sensibili. Per essere efficace, ha bisogno di sapere il set di caratteri utilizzato nel progetto. Il set di caratteri predefinito è UTF-8, ma può essere configurato chiamando il metodo setCharset():

sfWidget::setCharset('ISO-8859-1');

Se un widget dipende da qualche JavaScript o foglio di stile, è possibile sovrascrivere i corrispettivi metodi getJavaScripts() e getStylesheets():

class Widget extends sfWidget
{
  public function getStylesheets()
  {
    // le chiavi dell'array sono file e i valori sono nomi di media
    // separati da una virgola (,)
    return array(
      '/path/to/file.css' => 'all',
      '/another/file.css' => 'screen,print',
    );
  }
 
  public function getJavaScripts()
  {
    return array('/path/to/file.js', '/another/file.js');
  }
}

La classe base sfWidgetForm

In questa sezione si parla solo dei widget dei form. Tutti questi ereditano dalla classe base sfWidgetForm, la quale estende la classe sfWidget per fornire alcune caratteristiche extra di default.

Quando si crea un widget, si possono opzionalmente passare le opzioni e gli attributi HTML come parametri:

$w = new sfWidgetFormInputText(
  array('default' => 'Fabien'),
  array('class' => 'foo')
);

Opzioni e attributi HTML possono anche essere impostati tramite i metodi setOptions() e setAttributes():

$w = new sfWidgetFormInputText();
$w->setOptions(array('default' => 'Fabien'));
$w->setAttributes(array('class' => 'foo'));

I metodi setOption() e setAttribute() permettono di definire una singola opzione o un attributo HTML:

$w = new sfWidgetFormInputText();
$w->setOption('default', 'Fabien');
$w->setAttribute('class', 'foo');

Un widget può essere reso chiamando il metodo render():

$w->render('name', 'value', array('class' => 'foo'));

Il metodo render() accetta i seguenti parametri:

• Il nome del widget
• Il valore del widget
• Alcuni attributi HTML opzionali (questi sono inseriti insieme a quelli di default definiti al tempo della costruzione)

Il widget di cui sopra rende come segue:

<input class="foo" type="text" name="bar" id="bar" value="value"/>

Le opzioni di default options definite da sfWidgetForm sono le seguenti:

La classe sfWidgetForm fornisce anche metodi di accesso per tutte le opzioni:

• is_hidden: isHidden(), setHidden()
• needs_multipart: needsMultipartForm()
• default: getValue(), setValue()
• label: getLabel(), setLabel()
• id_format: getIdFormat(), setIdFormat()

Lo schema dei widget

Uno schema dei widget di form è un wrapper widget per uno o più altri widget.

Nelle prossime sezioni, i widget sono stati raggruppati in categorie.

Widget

• sfWidgetFormChoice
• sfWidgetFormDate
• sfWidgetFormDateRange
• sfWidgetFormDateTime
• sfWidgetFormDoctrineChoice
• sfWidgetFormFilterInput
• sfWidgetFormFilterDate
• sfWidgetFormI18nChoiceCountry
• sfWidgetFormI18nChoiceLanguage
• sfWidgetFormI18nChoiceCurrency
• sfWidgetFormI18nChoiceTimezone
• sfWidgetFormI18nDate
• sfWidgetFormI18nDateTime
• sfWidgetFormI18nTime
• sfWidgetFormInput
• sfWidgetFormInputCheckbox
• sfWidgetFormInputFile
• sfWidgetFormInputFileEditable
• sfWidgetFormInputHidden
• sfWidgetFormInputPassword
• sfWidgetFormJQueryAutocompleter
• sfWidgetFormJQueryDate
• sfWidgetFormPropelChoice
• sfWidgetFormReCaptcha
• sfWidgetFormSchema
• sfWidgetFormSchemaDecorator
• sfWidgetFormSelect
• sfWidgetFormSelectDoubleList
• sfWidgetFormSelectMany
• sfWidgetFormSelectCheckbox
• sfWidgetFormSelectRadio
• sfWidgetFormTextarea
• sfWidgetFormTextareaTinyMCE
• sfWidgetFormTime

Widget Input

sfWidgetFormInput

Il tag input tag è probabilmente il tag dei form più semplice che si potrà mai utilizzare ed è rappresentato dalla classe sfWidgetFormInput.

$w = new sfWidgetFormInputText();
echo $w->render('foo');
 
# <input type="text" name="foo" id="foo" />

sfWidgetFormInputCheckbox

sfWidgetFormInputCheckbox è un widget input con un type di tipo checkbox.

$w = new sfWidgetFormInputCheckbox();
echo $w->render('foo');
 
# <input type="checkbox" name="foo" id="foo" />

sfWidgetFormInputHidden

sfWidgetFormInputHidden è un widget input con un type impostato a hidden. L'opzione is_hidden è impostata a true.

$w = new sfWidgetFormInputHidden();
echo $w->render('foo');
 
# <input type="hidden" name="foo" id="foo" />

sfWidgetFormInputPassword

sfWidgetFormInputPassword è un widget input con un type impostato a password.

$w = new sfWidgetFormInputPassword();
echo $w->render('foo');
 
# <input type="password" name="foo" id="foo" />

sfWidgetFormInputFile

sfWidgetFormInputFile è un widget input con un type impostato a file. L'opzione needs_multipart è automaticamente impostata a true.

$w = new sfWidgetFormInputFile();
echo $w->render('foo');
 
# <input type="file" name="foo" id="foo" />

sfWidgetFormInputFileEditable

sfWidgetFormInputFileEditable è un widget input file, che estende il widget sfWidgetFormInputFile per aggiungere la possibilità di mostrare o rimuovere un file caricato in precedenza.

sfWidgetFormTextarea

Il widget sfWidgetFormTextarea imposta automaticamente i valori predefiniti per gli attributi HTML rows e cols, in quanto sono obbligatori.

$w = new sfWidgetFormTextarea();
echo $w->render('foo');
 
# <textarea rows="4" cols="30" name="foo" id="foo"></textarea>

sfWidgetFormTextareaTinyMCE

Se si desidera generare un widget con editor WYSIWYG, è possibile usare sfWidgetFormTextareaTinyMCE:

$w = new sfWidgetFormTextareaTinyMCE(
  array(),
  array('class' => 'foo')
);

Poiché i file JavaScript di TinyMCE non sono distribuiti con il plugin, è necessario installarli e includerli manualmente.

Widget di scelta

Rappresentazioni per la scelta

Quando l'utente vuole scegliere tra un elenco di possibilità, l'HTML offre diverse modalità per rappresentare la scelta

• Un tag select:

  

• Un tag select con attributo multiple:

  

• Un elenco di tag input con type di tipo radio:

  

• Un elenco di tag input con type di tipo checkbox:

  

Ma, in definitiva, tutti permettono all'utente di effettuare una scelta singola o multipla all'interno di un numero finito di possibilità.

Il widget sfWidgetFormChoice standardizza tutte queste possibilità in un widget. Il widget è in grado di generare una scelta come una delle quattro rappresentazioni in HTML che abbiamo visto sopra. Esso consente inoltre di definire la propria rappresentazione, come si vedrà più avanti.

sfWidgetFormChoice è un widget speciale, nel senso che delega la generazione a un altro widget. La costruzione è controllata da due opzioni: expanded e multiple:

Ecco il codice HTML che rappresenta ciascuna possibilità:

$w = new sfWidgetFormChoice(array(
  'choices' => array('Fabien Potencier', 'Fabian Lange'),
));

$w = new sfWidgetFormChoice(array(
  'multiple' => true,
  'choices'  => array('PHP', 'symfony', 'Doctrine', 'Propel', 'model'),
));

$w = new sfWidgetFormChoice(array(
  'expanded' => true,
  'choices'  => array('published', 'draft', 'deleted'),
));

$w = new sfWidgetFormChoice(array(
  'expanded' => true,
  'multiple' => true,
  'choices'  => array('A week of symfony', 'Call the expert', 'Community'),
));

Scelte di raggruppamento

Il widget sfWidgetFormChoice ha al suo interno il supporto per gruppi di scelte, passando un array di array per l'opzione choices:

$choices = array(
  'Europe'  => array('France' => 'France', 'Spain' => 'Spain', 'Italy' => 'Italy'),
  'America' => array('USA' => 'USA', 'Canada' => 'Canada', 'Brazil' => 'Brazil'),
);
 
$w = new sfWidgetFormChoice(array('choices' => $choices));

Le opzioni expanded e multiple funzionano come ci si aspetta:

$w = new sfWidgetFormChoice(array(
  'choices'  => $choices,
  'expanded' => true,
));

Il layout utilizzato dal widget renderer può anche essere personalizzato:

$w = new sfWidgetFormChoice(array(
  'choices'  => $choices,
  'expanded' => true,
  'renderer_options' => array('template' => '<strong>%group%</strong> %options%'),
));

Ecco qualche altro esempio con combinazioni di opzioni:

$w = new sfWidgetFormChoice(array(
  'choices'  => $choices,
  'multiple' => true,
));

$w = new sfWidgetFormChoice(array(
  'choices'  => $choices,
  'multiple' => true,
  'expanded' => true,
  'renderer_options' => array('template' => '<strong>%group%</strong> %options%'),
));

Opzioni supportate

Ecco un elenco di tutte le opzioni supportate per il widget:

I widget sfWidgetFormSelectCheckbox e sfWidgetFormSelectRadio supportano le seguenti opzioni:

Rappresentazione con doppio elenco

Quando l'utente può selezionare più opzioni, a volte è meglio mostrare l'elenco delle opzioni selezionate in un altro box.

Il widget sfWidgetFormSelectDoubleList può essere usato per costruire un widget scelta con un doppio elenco:

$w = new sfWidgetFormChoice(array(
  'choices'        => array('PHP', 'symfony', 'Doctrine', 'Propel', 'model'),
  'renderer_class' => 'sfWidgetFormSelectDoubleList',
));

$files = $w->getJavascripts();

Autocompletamento

Quando si desidera che l'utente effettui una selezione tra un sacco di elementi, mostrarli tutti in un select box diventa improponibile. sfWidgetFormJQueryAutocompleter risolve questo problema mediante la conversione di un semplice tag input in un select con funzionalità di autocompletamento.

$w = new sfWidgetFormChoice(array(
  'choices'          => array(),
  'renderer_class'   => 'sfWidgetFormJQueryAutocompleter',
  'renderer_options' => array('url' => '/autocomplete_script'),
));

L'opzione url è l'URL che il widget chiamerà per popolare le scelte basate sull'input dell'utente. L'URL riceve due parametri:

• q: La stringa inserita dall'utente
• limit: Il numero massimo di oggetti da restituire

Lo script deve restituire una valida rappresentazione JSON dell'array scelto (utilizza la funzione PHP json_encode() per convertire un array in JSON).

Se le scelte sono collegate a un modello di Propel, il widget sfWidgetFormPropelJQueryAutocompleter è ottimizzato per la ricerca di chiavi esterne:

$w = new sfWidgetFormChoice(array(
  'renderer_class'   => 'sfWidgetFormPropelJQueryAutocompleter',
  'renderer_options' => array(
    'model' => 'Article',
    'url'   => '/autocomplete_script',
  ),
));

Scelta legata a un modello Propel

Se le scelte sono legate a un modello Propel (di solito quando si vuole consentire all'utente di cambiare una chiave esterna), è possibile utilizzare il widget sfWidgetFormPropelChoice:

$w = new sfWidgetFormPropelChoice(array(
  'model'     => 'Article',
  'add_empty' => false,
));

Le scelte choices sono recuperate automaticamente dal widget in base alla classe model che viene passata. Il widget è ampiamente configurabile tramite un insieme di opzioni dedicate:

Scelta legata a un modello Doctrine

Se le scelte sono legate a un modello Doctrine (di solito quando si vuole consentire all'utente di cambiare una chiave esterna), si può usare il widget sfWidgetFormDoctrineChoice:

$w = new sfWidgetFormDoctrineChoice(array(
  'model'     => 'Article',
  'add_empty' => false,
));

Le scelte choices sono recuperate automaticamente dal widget in base alla classe model che viene passata. Il widget è ampiamente configurabile tramite un insieme di opzioni dedicate:

Widget per le date

I widget per le data possono essere usati per facilitare l'inserimento di date, proponendo diversi box per una data, un'ora, o una data-ora. Tutti i widget per le date di symfony sono rappresentati da tag HTML multipli. Possono anche essere personalizzati a seconda della cultura dell'utente.

sfWidgetFormDate

sfWidgetFormDate rappresenta un widget data:

Il valore inviato dall'utente è memorizzato in un array col nome del widget:

$w = new sfWidgetFormDate();
$w->render('date');
 
# i dati inviati saranno in un array `date`:
# array(
#   'date' => array(
#     'day'   => 15,
#     'month' => 10,
#     'year'  => 2005,
#   ),
# );

Il comportamento del widget può essere memorizzato con diverse opzioni:

L'uso dell'opzione format consente la personalizzazione della disposizione predefinita dei tag (i segnaposto %year%, %month% e %day% sono sostituiti dai corrispondenti tag select quando il metodo render() è richiamato):

$w = new sfWidgetFormDate(
  array('format' => '%year% - %month% - %day%')
);

Di default, il tag select year è popolato con i 10 anni intorno all'anno corrente. Si può cambiare questo comportamento usando l'opzione years:

$years = range(2009, 2020);
$w = new sfWidgetFormDate(
  array('years' => array_combine($years, $years))
);

Le opzioni years, months e days accettano un array in cui le chiavi sono i valori dei tag option e i valori sono le stringhe mostrate all'utente.

sfWidgetFormTime

sfWidgetFormTime rappresenta un widget ora:

I valori inviato dall'utente sono memorizzati in un array con lo stesso nome del widget:

$w = new sfWidgetFormTime();
$w->render('time');
 
# i valori inviati saranno in un array `time`:
# array(
#   'time' => array(
#     'hour'    => 12,
#     'minute'  => 13,
#     'second'  => 14,
#   ),
# );

Il comportamento del widget può essere memorizzato con diverse opzioni:

Di default, il widget non consente la selezione dei secondi. Si può cambiare questo comportamento impostando l'opzione with_seconds a true:

$w = new sfWidgetFormTime(array('with_seconds' => true));

L'uso delle opzioni format e format_without_seconds consente la personalizzazione della disposizione predefinita dei tag (i segnaposto %hour%, %minute% e %second% sono sostituiti dai corrispondenti tag select quando il metodo render() è richiamato):

$w = new sfWidgetFormTime(array(
  'with_seconds' => true,
  'format'       => '%hour% : %minute% : %second%',
));

Se non si vogliono proporre tutti i minuti o secondi, si possono fornire i propri valori per ognuno dei tre tag:

$seconds = array(0, 15, 30, 45);
$w = new sfWidgetFormTime(array(
  'with_seconds' => true,
  'seconds'      => array_combine($seconds, $seconds),
));

Le opzioni hours, minutes e seconds accettano un array in cui le chiavi sono i valori dei tag option e i valori sono le stringhe mostrate all'utente.

sfWidgetFormDateTime

sfWidgetFormDateTime è un widget che mostra altri due widget: un widget sfWidgetFormDate e uno sfWidgetFormTime:

$w = new sfWidgetFormDateTime();

sfWidgetFormI18nDate

sfWidgetFormI18nDate estende il widget standard sfWidgetFormDate. Ma, mentre il widget standard mostra i mesi come numeri, quello i18n li mostra come stringhe, localizzati a seconda della cultura.

$w = new sfWidgetFormI18nDate(array('culture' => 'fr'));

Il formato del mese può essere modificato con l'opzione month_format. Questa accetta tre valori: name (predefinito), short_name, o number.

$w = new sfWidgetFormI18nDate(array(
  'culture'      => 'fr',
  'month_format' => 'short_name',
));

A seconda della cultura, il widget riconosce anche l'ordine dei tre diversi tag select e il separatore da usare tra loro.

sfWidgetFormI18nTime

sfWidgetFormI18nTime estende il widget standard sfWidgetFormTime.

Secondo la cultura passata come opzione, il widget conosce l'ordine dei tre diversi select e il separatore da usare tra loro:

$w = new sfWidgetFormI18nTime(array('culture' => 'ar'));

sfWidgetFormI18nDateTime

sfWidgetFormI18nDateTime è un widget che mostra altri due a widget: un widget sfWidgetFormI18nDate e uno sfWidgetFormI18nTime.

sfWidgetFormDateRange

Il widget sfWidgetFormDateRange rappresenta una scelta di un intervallo di date:

$w = new sfWidgetFormDateRange(array(
  'from_date' => new sfWidgetFormDate(),
  'to_date'   => new sfWidgetFormDate(),
));

Il template usato per mostrare il widget può essere personalizzato con l'opzione template:

$w = new sfWidgetFormDateRange(array(
  'from_date' => new sfWidgetFormDate(),
  'to_date'   => new sfWidgetFormDate(),
  'template'  => 'Begin at: %from_date%<br />End at: %to_date%',
));

sfWidgetFormJQueryDate

Il widget sfWidgetFormJQueryDate rappresenta un widget data con interfaccia JQuery UI:

$w = new sfWidgetFormJQueryDate(array(
  'culture' => 'en',
));

Widget I18n

sfWidgetFormI18nChoiceCountry

sfWidgetFormI18nChoiceCountry rappresenta una scelta di paesi:

$w = new sfWidgetFormI18nChoiceCountry(array('culture' => 'fr'));

sfWidgetFormI18nChoiceLanguage

sfWidgetFormI18nChoiceLanguage rappresenta una scelta di lingue:

$w = new sfWidgetFormI18nChoiceLanguage(array('culture' => 'fr'));

sfWidgetFormI18nChoiceCurrency

sfWidgetFormI18nChoiceCurrency rappresenta una scelta di valute:

$w = new sfWidgetFormI18nChoiceCurrency(array('culture' => 'fr'));

sfWidgetFormI18nChoiceTimezone

sfWidgetFormI18nChoiceTimezone rappresenta una scelta di fusi orari:

$w = new sfWidgetFormI18nChoiceTimezone(array('culture' => 'fr'));

Widget Captcha

Il plugin sfFormExtraPlugin contiene un widget captcha, sfWidgetFormReCaptcha, basato sul progetto ReCaptcha:

$w = new sfWidgetFormReCaptcha(array(
  'public_key' => 'RECAPTCHA_PUBLIC_KEY'
));

public_key è la chiave pubblica ReCaptcha. Si può otterne una gratuitamente richedendo una chiave API.

Non essendo possibile modificare i nomi dei campi di ReCaptcha, occorrerà aggiungerli a mano nel bind di un form con una richiesta HTTP.

Ad esempio, se il proprio form ha un formato di nome contact[%s], questo è il codice necessario per essere sicuri che l'informazione captcha sia inserita con il resto delle informazioni inviate dal form:

$captcha = array(
  'recaptcha_challenge_field' => $request->getParameter('recaptcha_challenge_field'),
  'recaptcha_response_field'  => $request->getParameter('recaptcha_response_field'),
);
$submittedValues = array_merge(
  $request->getParameter('contact'),
  array('captcha' => $captcha)
);

Questo widget va usato insieme al validatore sfValidatorReCatpcha.

Widget per i filtri

I widget per i filtri sono widget specifici che possono essere usati per rendere un form che agisca come un filtro.

sfWidgetFormFilterInput

sfWidgetFormFilterInput rappresenta un filtro per un testo. Di default, include un checkbox per consentire all'utente di cercare un testo vuoto.

sfWidgetFormFilterDate

sfWidgetFormFilterDate rappresenta una widget per filtrare un intervallo di date. Di default, include un checkbox per consentire all'utente di cercare date vuote.

sfWidgetFormSchema

sfWidgetFormSchema rappresenta un widget composto da più campi. Un campo è semplicemente un widget con un nome:

$w = new sfWidgetFormSchema(array(
  'name'    => new sfWidgetFormInputText(),
  'country' => new sfWidgetFormI18nChoiceCountry(),
));

Il costruttore sfWidgetFormSchema accetta cinque parametri opzionali:

• Un array di campi
• Un array di opzioni
• Un array di attributi HTML
• Un array di label per i widget contenuti
• Un array di messaggi di aiuto per i widget contenuti

Le opzioni disponibili sono:

Se si vuole cambiare il formatter per tutti i form, lo si può impostare nel metodo setDefaultFormFormatterName():

sfWidgetFormSchema::setDefaultFormFormatterName('list');

Poiché sfWidgetFormSchema estende la classe sfWidgetForm, ne eredita tutti i metodi e comportamenti.

<Table>
  <?php echo $ws->render('') ?>
</table>

sfWidgetFormSchema può essere usato come un array per accedere ai widget contenuti:

$ws = new sfWidgetFormSchema(array('name' => new sfWidgetFormInputText()));
 
$nameWidget = $ws['name'];
 
unset($ws['name']);

Essendo uno schema di widget un widget esso stesso, gli schemi di widget possono essere innestati:

$ws = new sfWidgetFormSchema(array(
  'title'  => new sfWidgetFormInputText(),
  'author' => new sfWidgetFormSchema(array(
    'first_name' => new sfWidgetFormInputText(),
    'last_name'  => new sfWidgetFormInputText(),
  )),
));

Si può accedere ai widget contenuti nello schema di widget usando la notazione degli array:

$ws['author']['first_name']->setLabel('First Name');

Di seguito sono descritti i metodi principali delle classi dello schema di widget. Per una lista completa dei metodi, fare riferimento alla documentazione online delle API.

setLabel(), getLabel(), setLabels(), getLabels()

I metodi setLabel(), getLabel(), setLabels() e getLabels() gestiscono le label dei widget contenuti. Sono metodi proxy per i metodi getLabel() e setLabel() dei widget.

$ws = new sfWidgetFormSchema(array('name' => new sfWidgetFormInputText()));
 
$ws->setLabel('name', 'Fabien');
 
// che è equivalente a
 
$ws['name']->setLabel('Fabien');
 
// oppure
 
$ws->setLabel(array('name' => 'Fabien'));

I metodi setLabels() fondono i valori con quelli esistenti.

setDefault(), getDefault(), setDefaults(), getDefaults()

I metodi setDefault(), getDefault(), setDefaults() e getDefaults() gestiscono i valori di default per i widget contenuti. Sono metodi proxy per i metodi getDefault() e setDefault() dei widget.

$ws = new sfWidgetFormSchema(array('name' => new sfWidgetFormInputText()));
 
$ws->setDefault('name', 'Fabien');
 
// che è equivalente a
 
$ws['name']->setDefault('Fabien');
 
// oppure
 
$ws->setDefaults(array('name' => 'Fabien'));

I metodi setDefaults() fondono i valori con quelli esistenti.

setHelp(), setHelps(), getHelps(), getHelp()

I metodi setHelp(), setHelps(), getHelps() e getHelp() gestiscono i messaggi associati con i widget contenuti:

$ws = new sfWidgetFormSchema(array('name' => new sfWidgetFormInputText()));
 
$ws->setHelp('name', 'Fabien');
 
// che è equivalente a
 
$ws->setHelps(array('name' => 'Fabien'));

Il metodo setHelps() fonde i valori con quelli esistenti.

getPositions(), setPositions(), moveField()

I campi contenuti in uno schema di widget sono ordinati. L'ordine può essere cambiato con il metodo moveField():

$ws = new sfWidgetFormSchema(array(
  'first_name' => new sfWidgetFormInputText(),
  'last_name' => new sfWidgetFormInputText()
));
 
$ws->moveField('first_name', sfWidgetFormSchema::AFTER, 'last_name');

Le costanti sono le seguenti:

• sfWidgetFormSchema::FIRST
• sfWidgetFormSchema::LAST
• sfWidgetFormSchema::BEFORE
• sfWidgetFormSchema::AFTER

È anche possibile cambiare tutte le posizioni col metodo setPositions():

$ws->setPositions(array('last_name', 'first_name'));

sfWidgetFormSchemaDecorator

sfWidgetFormSchemaDecorator è uno schema di widget proxy che racchiude un widget di schema di form dentro un pezzo di HTML dato:

$ws = new sfWidgetFormSchema(array('name' => new sfWidgetFormInputText()));
 
$wd = new sfWidgetFormSchemaDecorator($ws, '<table>%content%</table>');