Annexe A - Widgets

Introduction

Le framework de formulaire de symfony est livré avec un lot de widgets utiles. Ces widgets couvrent les besoins communs de la plupart des projets. Ce chapitre décrit les widgets de formulaire par défaut fourni avec symfony. Nous avons également inclus quelques uns des widgets de formulaire à partir des plugins sfFormExtraPlugin, sfPropelPlugin et sfDoctrinePlugin. Ces plugins sont pris en charge par l'équipe de base et contiennent des widgets très utiles.

Avant de plonger dans les détails de chaque widget, voyons ce que les widgets ont en commun.

La classe de base sfWidget

Tous les widgets symfony héritent de la classe de base sfWidget de base, qui fournit des fonctionnalités disponibles par défaut à tous les widgets.

Par défaut, tous les widgets sont rendus en XHTML. Vous pouvez basculer vers un fichier HTML en appelant la méthode setXhtml() :

sfWidget::setXhtml(false);

Le système de widget aussi prend automatiquement en charge l'échappement des attributs HTML et le contenu sensible. Pour être efficace, il doit connaître le jeu de caractères utilisé par votre projet. Par défaut le jeu de caractères est UTF-8, mais il peut être configuré en appelant la méthode setCharset() :

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

Si un widget repose sur certains fichiers JavaScript et/ou feuilles de style, vous pouvez remplacer respectivement par les méthodes getJavaScripts() et getStylesheets() :

class Widget extends sfWidget
{
  public function getStylesheets()
  {
    // the array keys are files and values are the media names
    // separated by a colon (,)
    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 de base sfWidgetForm

Dans cette section, nous ne parlerons que de widgets de formulaire. Tous héritent de la classe de base sfWidgetForm, qui étend la classe sfWidget pour fournir des fonctionnalités supplémentaires par défaut.

Lors de la création d'un widget, vous pouvez éventuellement passer des options et des attributs HTML en arguments :

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

Les options et les attributs HTML peuvent également être définis en utilisant les méthodes setOptions() et setAttributes() :

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

Les méthodes setOptions() et setAttributes() permettent individuellement de fixer une option ou un attribut HTML :

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

Un widget peut être rendu en appelant la méthode render() :

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

La méthode render() prend les arguments suivants :

• Le nom du widget
• La valeur du widget
• Certains attributs HTML facultatifs (ils sont fusionnés avec ceux définis par défaut au moment de la construction)

Le wigdet ci-dessus rend comme suit :

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

Les options par défaut définies par sfWidgetForm sont les suivantes:

La classe sfWidgetForm fournit également des méthodes d'accès pour toutes les options :

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

Widget Schema

Un schéma de widget de formulaire est un widget qui englobe un ou plusieurs autres widgets.

Dans les sections suivantes, les widgets ont été regroupés en catégories.

Widgets

• 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

Widgets de saisie

sfWidgetFormInput

La balise input est probablement la plus simple des balises de formulaire que vous utiliserez et elle est représentée par la classe sfWidgetFormInput.

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

sfWidgetFormInputCheckbox

Le sfWidgetFormInputCheckbox est un widget de saisie avec type à checkbox.

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

sfWidgetFormInputHidden

Le sfWidgetFormInputHidden est un widget de saisie avec type à hidden. L'option is_hidden est également mise à true.

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

sfWidgetFormInputPassword

Le sfWidgetFormInputPassword est un widget de saisie avec type à password.

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

sfWidgetFormInputFile

Le sfWidgetFormInputFile est un widget de saisie avec type à file. L'option needs_multipart est automatiquement mise à true.

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

sfWidgetFormInputFileEditable

Le sfWidgetFormInputFileEditable est un widget de saisie de fichier, étendant le widget sfWidgetFormInputFile pour ajouter la possibilité d'afficher ou supprimer un fichier précédement téléchargé.

sfWidgetFormTextarea

Le widget sfWidgetFormTextarea définit automatiquement des valeurs par défaut pour les attributs HTML rows et cols car ils sont obligatoires.

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

sfWidgetFormTextareaTinyMCE

Si vous voulez avoir un widget d'un éditeur WYSIWYG, vous pouvez utiliser sfWidgetFormTextareaTinyMCE :

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

Comme les fichiers JavaScript de TinyMCE ne sont pas fournis avec le plugin, vous devez les installer et les inclure vous-même.

Widgets de choix

Représentations des choix

Lorsque vous voulez que l'utilisateur fasse un choix parmi une liste de possibilités, HTML offre plusieurs façons de représenter le choix :

• Une balise select :

  

• Une balise select avec l'attribut multiple :

  

• Une liste de balise input avec un type à radio :

  

• Une liste de balise input avec un type à checkbox :

  

Mais finalement, ils permettent tous à l'utilisateur de faire un seul ou plusieurs choix dans un nombre fini de possibilités.

Le widget sfWidgetFormChoice standardise toutes ces possibilités au sein d'un widget. Le widget est en mesure de rendre le choix de l'une des quatre représentations HTML que nous avons vu ci-dessus. Il vous permet également de définir votre propre représentation comme vous le verrez plus tard.

sfWidgetFormChoice est un widget spécial dans le sens où il délègue le rendu à un autre widget. Le rendu est contrôlée par deux options : expanded et multiple :

Et voici la représentation HTML pour chaque 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'),
));

Groupement des choix

Le widget sfWidgetFormChoice a un support intégré pour des groupes de choix en passant un tableau de tableaux pour les options 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));

Les options expanded et multiple fonctionnent également comme prévu :

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

Le layout utilisé par le widget de rendu peut également être personnalisé :

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

Voici quelques exemples de plus de combinaisons d'options :

$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%'),
));

Options supportées

Voici une liste de toutes les options prises en charge pour le widget :

Les widgets sfWidgetFormSelectCheckbox et sfWidgetFormSelectRadio supportent les options suivantes :

Représentation d'une double liste

Lorsque l'utilisateur peut sélectionner plusieurs options, il est parfois préférable d'afficher la liste des options sélectionnées dans une autre boîte.

Le widget sfWidgetFormSelectDoubleList peut être utilisé pour rendre un widget de choix comme une double liste :

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

$files = $w->getJavascripts();

Autocomplétion

Lorsque vous voulez que l'utilisateur fasse une sélection parmi un grand nombre d'éléments et de les énumérer toutes dans une zone de sélection devient impraticable. Le sfWidgetFormJQueryAutocompleter résout ce problème en convertissant une simple balise input en une boîte de sélection d'autocomplétion.

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

L'option url est l'URL que le widget appellera pour fournir les choix basés sur la saisie de l'utilisateur. L'URL reçoit deux paramètres :

• q: La chaine saisie par l'utilisateur
• limit: Le nombre maximum de choix à retourner

Le script doit retourner une représentation JSON valide du tableau de choix (utilisez la fonction intégrée de PHP json_encode() pour convertir un tableau en JSON).

Si les choix sont liés à un modèle Propel, le widget sfWidgetFormPropelJQueryAutocompleter est optimisé pour la recherche de clé étrangère :

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

Choix lié à un modèle Propel

Si les choix sont liés à un modèle Propel (généralement lorsque vous voulez permettre à l'utilisateur de modifier une clé étrangère), vous pouvez utiliser le widget sfWidgetFormPropelChoice :

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

Le choices est automatiquement récupéré par le widget en fonction de la classe model que vous avez passée. Le widget est hautement configurable via un ensemble d'options dédiées :

Choix lié à un modèle Doctrine

Si les choix sont liés à un modèle Doctrine (généralement lorsque vous voulez permettre à l'utilisateur de modifier une clé étrangère), vous pouvez utiliser le widget sfWidgetFormDoctrineChoice :

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

Le choices est automatiquement récupéré par le widget en fonction de la classe model que vous avez passée. Le widget est hautement configurable via un ensemble d'options dédiées :

Widgets de date

Les widgets de date peuvent être utilisés pour faciliter la saisie de date en proposant plusieurs cases pour sélectionner une date, une heure ou une date et heure. Tous les widgets de date de symfony sont représentés par plusieurs balises HTML. Ils peuvent également être personnalisés en fonction de la culture de l'internaute.

sfWidgetFormDate

Lz sfWidgetFormDate représente un widget de date :

Les valeurs soumises par l'utilisateur sont stockées dans un tableau du nom du widget :

$w = new sfWidgetFormDate();
$w->render('date');
 
# submitted values will be in a `date` array:
# array(
#   'date' => array(
#     'day'   => 15,
#     'month' => 10,
#     'year'  => 2005,
#   ),
# );

Le comportement du widget peut être personnalisé avec une foule d'options :

L'utilisation de l'option format permet la personnalisation de la disposition par défaut des balises (les espaces réservés %year%, %month% et %day% sont remplacés par la balise select correspondante lorsque la méthode render() est appelée) :

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

Par défaut, la balise select year est peuplé avec les 10 ans autour de l'année en cours. Ceci peut être changé en utilisant l'option years :

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

Les options years, months et days prennent un tableau dont les clés sont les valeurs des balises option et les valeurs sont les chaînes affichées à l'utilisateur.

sfWidgetFormTime

Le sfWidgetFormTime représente une widget d'heure :

Les valeurs soumises par l'utilisateur sont stockées dans un tableau du nom du widget :

$w = new sfWidgetFormTime();
$w->render('time');
 
# les valeurs soumises seront dans un tableau `time` :
# array(
#   'time' => array(
#     'hour'    => 12,
#     'minute'  => 13,
#     'second'  => 14,
#   ),
# );

Le comportement du widget peut être personnalisé avec une foule d'options :

Par défaut, le widget ne permet pas pour le choix des secondes. Ceci peut être changé en définissant l'option with_seconds à true :

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

L'utilisation des options format et format_without_seconds permettent la personnalisation de la disposition par défaut des tags (les espaces réservés %hour%, %minute% et %second% sont remplacés par la balise select correspondante lorsque la méthode render() est appelée) :

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

Si vous ne souhaitez pas proposer toutes les minutes ou secondes, vous pouvez fournir vos propres valeurs pour chacune des trois balises :

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

Les options hours, minutes et seconds prennent un tableau dont les clés sont les valeurs des balises option et les valeurs sont les chaînes de caractères affichée à l'utilisateur.

sfWidgetFormDateTime

Le widget sfWidgetFormDateTime est un widget qui rend deux sous-widgets : un widget sfWidgetFormDate et un widget sfWidgetFormTime :

$w = new sfWidgetFormDateTime();

sfWidgetFormI18nDate

Le sfWidgetFormI18nDate étend le widget standard sfWidgetFormDate. Mais tandis que le widget standard affiche les mois comme des numéros, l'i18n les affiche sous forme de chaînes, localisées en fonction de la culture :

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

Le formatage de chaîne du mois peut être modifié avec l'option month_format. Il accepte trois valeurs: name (par défaut), short_name ou number.

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

Selon la culture, le widget connaît aussi l'ordre des trois différentes boîtes et sélectionne le séparateur à utiliser entre eux.

sfWidgetFormI18nTime

Le sfWidgetFormI18nTime étend le widget standard sfWidgetFormTime.

Selon la culture passée en option, le widget connaît aussi l'ordre des trois différentes boîtes et sélectionne le séparateur à utiliser entre eux.

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

sfWidgetFormI18nDateTime

Le widget sfWidgetFormI18nDateTime est un widget qui rend deux sous-widgets : un widget sfWidgetFormI18nDate et un widget sfWidgetFormI18nTime.

sfWidgetFormDateRange

Le widget sfWidgetFormDateRange représente le choix d'une plage de dates :

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

Le Template utilisé pour rendre le widget peut être personnalisé avec l'option template :

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

sfWidgetFormJQueryDate

Le widget sfWidgetFormJQueryDate représente un widget de date qui est rendu par JQuery UI :

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

Widgets I18n

sfWidgetFormI18nChoiceCountry

Le sfWidgetFormI18nChoiceCountry représente un choix de pays :

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

sfWidgetFormI18nChoiceLanguage

Le sfWidgetFormI18nChoiceLanguage représente un choix de langues :

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

sfWidgetFormI18nChoiceCurrency

Le sfWidgetFormI18nChoiceCurrency représente un choix de devise :

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

sfWidgetFormI18nChoiceTimezone

Le sfWidgetFormI18nChoiceTimezone représente un choix de fuseau horaire :

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

Widget captcha

Le plugin sfFormExtraPlugin livré avec un widget captcha, sfWidgetFormReCaptcha, basé sur le projet ReCaptcha :

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

Le public_key est la clé publique ReCaptcha. Vous pouvez en obtenir une gratuitement en inscrivant une clé API.

Comme il n'est pas possible de changer le nom des champs ReCaptcha, vous devrez les ajouter manuellement lors de la liaison d'un formulaire à partir d'une requête HTTP.

Par exemple, si votre formulaire a un format de nom contact[%s], voici le code nécessaire pour assurer que l'information du captcha sera fusionnée avec le reste des valeurs soumises du formulaire :

$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)
);

Ce widget est à utiliser avec le validateur sfValidatorReCatpcha.

Widgets de filtre

Les widgets de filtre sont des widgets spéciaux qui peuvent être utilisés pour rendre un formulaire qui agit comme un filtre.

sfWidgetFormFilterInput

sfWidgetFormFilterInput représente un filtre pour le texte. Par défaut, il comporte une case à cocher pour permettre aux utilisateurs de rechercher un texte vide.

sfWidgetFormFilterDate

sfWidgetFormFilterDate représente un widget pour filtrer une plage de date. Par défaut, il comporte une case à cocher pour permettre aux utilisateurs de rechercher des dates vides.

sfWidgetFormSchema

The sfWidgetFormSchema représente un widget qui est composé de plusieurs champs. Un champ est simplement un widget nommé :

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

Le constructeur de sfWidgetFormSchema prend cinq arguments facultatifs :

• Un tableau de champs
• Un tableau d'options
• Un tableau d'attributs HTML
• Un tableau de labels pour les widgets intégrés
• Un tableau de messages d'aide pour les widgets intégrés

Les options disponibles sont :

Si vous voulez changer le formateur par défaut pour tous les formulaires, vous pouvez définir la méthode setDefaultFormFormatterName() :

sfWidgetFormSchema::setDefaultFormFormatterName('list');

Comme le sfWidgetFormSchema étend la classe sfWidgetForm, il hérite de toutes ses méthodes et ses comportements.

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

Le sfWidgetFormSchema peut utilisé un tableau pour accéder aux widgets intégrés :

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

Comme un schéma de widget est un widget comme les autres, les schémas de widget peuvent être imbriqués :

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

Vous pouvez accéder aux widgets du schéma de widget intégré en utilisant la notation de tableau :

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

Ci-dessous, les principales méthodes de classes de schéma de widget sont décrites. Pour une liste complète des méthodes, reportez-vous à la documentation en ligne de l'API.

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

Les méthodes setLabel(), getLabel(), setLabels() et getLabels() gérent les labels pour les widgets intégrés. Ce sont des méthodes proxy pour les méthodes de widget getLabel() et setLabel().

$ws = new sfWidgetFormSchema(array('name' => new sfWidgetFormInputText()));
 
$ws->setLabel('name', 'Fabien');
 
// qui est équivalent à
 
$ws['name']->setLabel('Fabien');
 
// ou
 
$ws->setLabels(array('name' => 'Fabien'));

La méthode setLabels() fusionne les valeurs avec celles déjà existantes.

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

Les méthodes setDefault(), getDefault(), setDefaults() et getDefaults() gérent les valeurs par défaut pour les widgets intégrés. Ce sont des méthodes proxy pour les méthodes de widget getDefault() et setDefault().

$ws = new sfWidgetFormSchema(array('name' => new sfWidgetFormInputText()));
 
$ws->setDefault('name', 'Fabien');
 
// qui est équivalent à
 
$ws['name']->setDefault('Fabien');
 
// ou
 
$ws->setDefaults(array('name' => 'Fabien'));

La méthode setDefaults() fusionne les valeurs avec celles déjà existantes.

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

Les méthodes setHelp(), setHelps(), getHelps() et getHelp() gérent le message d'aide associé aux widgets intégrés :

$ws = new sfWidgetFormSchema(array('name' => new sfWidgetFormInputText()));
 
$ws->setHelp('name', 'Fabien');
 
// qui est équivalent à
 
$ws->setHelps(array('name' => 'Fabien'));

La méthode setHelps() fusionne les valeurs avec celles déjà existantes.

getPositions(), setPositions(), moveField()

Les champs contenus dans un schéma de widget sont triés. L'ordre peut être modifié avec la méthode moveField() :

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

Les constantes sont les suivantes :

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

Il est également possible de changer tous les postes avec la méthode setPositions() :

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

sfWidgetFormSchemaDecorator

Le widget sfWidgetFormSchemaDecorator est un schéma de widget proxy qui encapsule un widget de schéma de formulaire dans un code HTML donné :

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