symfony API

Method Details

• addFormFormatter ($name, $formatter) Browse code

  $name	The formatter name
  $formatter	An sfWidgetFormSchemaFormatter instance

  Adds a form formatter.

• generateName ($name, ) Browse code

  $name

  The name

  Generates a name.

• (sfWidget) getFields () Browse code

  Returns an array of fields.

  returns An array of sfWidget instance

• (sfWidgetFormSchemaFormatter) getFormFormatter () Browse code

  Returns the form formatter to use for widget schema rendering

  returns sfWidgetFormSchemaFormatter instance

  throws InvalidArgumentException

• (string) getFormFormatterName () Browse code

  Gets the form formatter name that will be used to render the widget schema.

  returns The form formatter name

• (array) getFormFormatters () Browse code

  Returns all the form formats defined for this form schema.

  returns An array of named form formats

• (string) getGlobalErrors ($errors) Browse code

  $errors

  An array of errors

  Gets errors that need to be included in global errors.

  returns An HTML representation of global errors for the widget

• (string) getHelp ($name) Browse code

  $name

  The field name

  Gets a text help by field name.

  returns The help text or an empty string if it is not defined

• (array) getHelps () Browse code

  Sets the help texts.

  returns An array of help texts

• (string) getLabel ($name) Browse code

  $name

  The field name

  Gets a label by field name.

  returns The label name or an empty string if it is not defined

• (array) getLabels () Browse code

  Gets the labels.

  returns An array of label names

• (string) getNameFormat () Browse code

  Gets the format string for the name HTML attribute.

  returns The format string

• (sfWidgetFormSchema) getParent () Browse code

  Gets the parent widget schema.

  returns The parent widget schema

• (array) getPositions () Browse code

  Gets the positions of the fields.

  
  The field positions are only used when rendering the schema with ->render().

  returns An ordered array of field names

• moveField (, , ) Browse code

  Moves a field in a given position

  
  Available actions are:

  * sfWidgetFormSchema::BEFORE
  * sfWidgetFormSchema::AFTER
  * sfWidgetFormSchema::LAST
  * sfWidgetFormSchema::FIRST

• (bool) needsMultipartForm () Browse code

  Returns true if the widget schema needs a multipart form.

  returns true if the widget schema needs a multipart form, false otherwise

• (bool) offsetExists ($name) Browse code

  $name

  The field name

  Returns true if the schema has a field with the given name (implements the ArrayAccess interface).

  returns true if the schema has a field with the given name, false otherwise

• (sfWidget) offsetGet ($name) Browse code

  $name

  The field name

  Gets the field associated with the given name (implements the ArrayAccess interface).

  returns The sfWidget instance associated with the given name, null if it does not exist

• offsetSet ($name, $widget) Browse code

  $name	The field name
  $widget	An sfWidget instance

  Sets a field (implements the ArrayAccess interface).

• offsetUnset () Browse code

  Removes a field by name (implements the ArrayAccess interface).

• (string) render ($name, $values, $attributes, $errors) Browse code

  $name	The name of the HTML widget
  $values	The values of the widget
  $attributes	An array of HTML attributes
  $errors	An array of errors

  Renders the widget.

  returns An HTML representation of the widget

• (string) renderField ($name, $value, $attributes, $attributes) Browse code

  $name	The field name
  $value	The field value
  $attributes	An array of errors for the field

  Renders a field by name.

  returns An HTML string representing the rendered widget

• setDefaultFormFormatterName ($name) Browse code

  $name

  New default formatter name

  Sets the generic default formatter name used by the class. If you want all

  of your forms to be generated with the list format, you can
  do it in a project or application configuration class:

  
   class ProjectConfiguration extends sfProjectConfiguration
  
   {
  
     public function setup()
  
     {
  
       sfWidgetFormSchema::setDefaultFormFormatterName('list');
  
     }
  
   }
  
   

• setFormFormatterName ($name) Browse code

  $name

  The form formatter name

  Sets the form formatter name to use when rendering the widget schema.

• setHelp ($name, $help) Browse code

  $name	The field name
  $help	The help text

  Sets a help text.

• setHelps ($helps) Browse code

  $helps

  An array of help texts

  Sets the help texts to render for each field.

• setLabel ($name, $value) Browse code

  $name	The field name
  $value	The label name

  Sets a label.

• setLabels ($labels) Browse code

  $labels

  An array of label names

  Sets the label names to render for each field.

• setNameFormat ($format) Browse code

  $format

  The format string (must contain a %s for the name placeholder)

  Sets the format string for the name HTML attribute.

  
  If you are using the form framework with symfony, do not use a reserved word in the
  name format. If you do, symfony may act in an unexpected manner.

  For symfony 1.1 and 1.2, the following words are reserved and must NOT be used as
  the name format:

  * module (example: module[%s])
  * action (example: action[%s])

  However, you CAN use other variations, such as actions[%s] (note the s).

• setParent () Browse code

  Sets the parent widget schema.

• setPositions () Browse code

  Sets the positions of the fields.

• __clone () Browse code

• __construct ($fields, $options, $attributes, $labels, $helps) Browse code

  $fields	Initial fields
  $options	An array of options
  $attributes	An array of default HTML attributes
  $labels	An array of HTML labels
  $helps	An array of help texts

  Constructor.

  
  The first argument can be:

  * null
  * an array of sfWidget instances

  Available options:

  * name_format: The sprintf pattern to use for input names
  * form_formatter: The form formatter name (table and list are bundled)