Реализация набора полей в формах Symfony

в проекте, который я пишу с Symfony, в формах очень часто будут наборы полей, поэтому я хотел бы создать механизм, чтобы я мог группировать поля по наборам полей и по-прежнему использовать метод __toString() моих форм. На этой странице я прочитал о sfWidgetFormSchema и о том, как его можно рассматривать как виджет, который позволяет вкладывать поля. Итак, вот что я сделал: я создал вложенные поля:

   $this->setWidgets(array(
      'customer'    => new sfWidgetFormSchema(array(
        'customer_name'      => new sfWidgetFormInputText(),
        'customer_email'     => new sfWidgetFormInputText(array())
      )),
      'library'     => new sfWidgetFormSchema(array(
        'library_name'      => new sfWidgetFormInputText(),
        'library_address'   => new sfWidgetFormInputText(),
        'library_city'      => new sfWidgetFormInputText(),
        'library_postcode'  => new sfWidgetFormInputText(),
        'library_website'   => new sfWidgetFormInputText()
      )),
      'message'     => new sfWidgetFormTextarea(array(),array( "cols" => 50, "rows" => 10 )),
    ));

Затем я создал класс fieldsetFormSchemaFormatter, который в основном оборачивает поля в теги, и связал его с полями sfWidgetFormSchema:

foreach (array('customer', 'library') as $fieldset)
    {
      $this->widgetSchema[$fieldset]->addFormFormatter('tableless',
        new tableLessFormSchemaFormatter($this->widgetSchema['customer']));
      $this->widgetSchema[$fieldset]->setFormFormatterName('tableless');
      $this->widgetSchema[$fieldset]->setNameFormat('%s');
    }
    $this->widgetSchema->addFormFormatter('fieldset',
      new FieldsetFormSchemaFormatter($this->widgetSchema,
        'TableLessFormSchemaFormatter'));
    $this->widgetSchema->setFormFormatterName('fieldset');

И это просто отлично сработало, я получил свою форму fieldset. У меня проблема с проверкой, которая совсем не описана на странице, на которую я ссылался ранее в этом вопросе. Сообщения об ошибках появляются в верхней части формы для всех полей, кроме поля «сообщение», за которым следует сообщение об ошибке. Я не думаю, что смогу заставить сообщения об ошибках отображаться сразу после строк и по-прежнему использовать конструкцию echo $form, не кодируя что-то уродливое, поэтому я думаю, что пойду с другой реализацией. Я думаю, что виджеты sfWidgetFormSchema предназначены для создания взаимозависимых полей, которые будут иметь глобальные правила проверки.

Как бы вы реализовали эту функциональность набора полей?


person greg0ire    schedule 22.07.2010    source источник
comment
Не могли бы вы вместо этого просто использовать подробные шаблоны и добавлять наборы полей вручную? Не супер элегантный, но будет работать, просто зависит от того, сколько у вас форм.   -  person Luke    schedule 22.07.2010
comment
@Luke: Да, я мог бы, но не хотел бы. В настоящее время я реализую функциональность набора полей в классе, наследующем от sfWidgetFormSchema (я собираюсь переопределить метод render()). Так как у меня много форм во многих проектах, думаю оно того стоит.   -  person greg0ire    schedule 22.07.2010


Ответы (1)


Вот что я придумал после некоторых исследований, вроде бы работает нормально, но механизм позиций больше не используется при рендеринге. Интересно, может ли это быть проблематичным.

<?php
class UcWidgetFormSchema extends sfWidgetFormSchema
{
  /**
   * An associative array with all the fieldsets
   * <code>
   *   array(
   *    "fieldset1" => array("fieldName1", "fieldName2"),
   *    "fieldset2" => array("fieldName3", "fieldName4"),
   *   )
   * </code>
   *
   * @var array
   */
  private $fieldsets;

  /**
   * A fieldset-compatible constructor.
   *
   * @param mixed $fields     Initial fields. Values can be given this way:
   * <code>
   *  array(
   *    "fieldset1" => array(
   *      "field1" => $widget1,
   *      "field2" => $widget2
   *    )
   *    "fieldset1" => array(
   *      "field3" => $widget3,
   *      "field4" => $widget4,
   *      "field5" => $widget5
   *    )
   *    "message" => $widget6
   *  )
   * </code>
   * @param array $options    An array of options
   * @param array $attributes An array of default HTML attributes
   * @param array $labels     An array of HTML labels
   * @param array $helps      An array of help texts
   */
  public function __construct($fields = null, $options = array(),
    $attributes = array(), $labels = array(), $helps = array())
  {
    $this->addOption('name_format', '%s');
    $this->addOption('form_formatter', null);

    parent::__construct($options, $attributes);

    if (is_array($fields))
    {
      $fieldsets = array();
      foreach ($fields as $name => $value)
      {
        if (is_array($value))
        {
          $fieldsets[$name] = array_keys($value);
          foreach ($value as $valueName=> $valueWidget)
          {
            $this[$valueName] = $valueWidget;
          }
        }
        else
        {
          $this[$name] = $value;
        }
      }
      $this->setFieldsets($fieldsets);
    }
    else if (null !== $fields)
    {
      throw new InvalidArgumentException('sfWidgetFormSchema constructor takes an array of sfWidget objects.');
    }

    $this->setLabels($labels);
    $this->helps = $helps;
  }

  /**
   * Setter for the fieldsets
   *
   * @param array $fieldsets an associative array
   *
   * @return null
   */
  public function setFieldsets(array $fieldsets)
  {
    $fieldNames = array();
    foreach ($fieldsets as $fieldset => $fieldsetFieldNames)
    {
      $fieldNames = array_merge($fieldNames, $fieldsetFieldNames);
    }
    $availableFieldsNames =  array_keys($this->getFields());
    if ($diff = array_diff(array_unique($fieldNames), $fieldNames))
    {
      throw new InvalidArgumentException(
        'A field can only be used once in all fieldset. These do not: ' .
        implode(', ', $diff));
    }

    if ($diff = array_diff($fieldNames, $availableFieldsNames))
    {
      throw new InvalidArgumentException(
        'Widget schema does not include the following field(s): ' .
        implode(', ', $diff));
    }
    $this->fieldsets = $fieldsets;
  }

  public function render($name, $values = array(), $attributes = array(), $errors = array())
  {
    if(!$this->getFormFormatter() instanceof FieldsettedFormFormatterInterface )
    {
      throw new LogicException('The formatter you are using must implement FieldsettedFormFormatterInterface');
    }

    if (null === $values)
    {
      $values = array();
    }

    if (!is_array($values) && !$values instanceof ArrayAccess)
    {
      throw new InvalidArgumentException('You must pass an array of values to render a widget schema');
    }

    $formFormat = $this->getFormFormatter();


    $groups       = array();
    $hiddenRows   = array();
    $errorRows    = array();
    $lonelyFields = $this->getPositions();
    $lonelyRows   = array();

    // render each field
    foreach ($this->fieldsets as $fieldset => $fieldNames)
    {
      $rows = array();
      foreach ($fieldNames as $name)
      {
        $lonelyFields     = array_diff($lonelyFields, array($name));
        $widget           = $this[$name];
        $value            = isset($values[$name]) ? $values[$name] : null;
        $error            = isset($errors[$name]) ? $errors[$name] : array();
        $widgetAttributes = isset($attributes[$name]) ? $attributes[$name] : array();

        if ($widget instanceof sfWidgetForm && $widget->isHidden())
        {
          $hiddenRows[] = $this->renderField($name, $value, $widgetAttributes);
        }
        else
        {
          $field = $this->renderField($name, $value, $widgetAttributes, $error);

          // don't add a label tag and errors if we embed a form schema
          $label = $widget instanceof sfWidgetFormSchema ?
            $this->getFormFormatter()->generateLabelName($name) :
            $this->getFormFormatter()->generateLabel($name);
          $error = $widget instanceof sfWidgetFormSchema ? array() : $error;

          $rows[] = $formFormat->formatRow($label, $field, $error,
            $this->getHelp($name));
        }
        $groups[$fieldset] = $rows;
      }
    }

    foreach ($lonelyFields as $name)
    {
      $widget           = $this[$name];
      $value            = isset($values[$name]) ? $values[$name] : null;
      $error            = isset($errors[$name]) ? $errors[$name] : array();
      $widgetAttributes = isset($attributes[$name]) ? $attributes[$name] : array();

      if ($widget instanceof sfWidgetForm && $widget->isHidden())
      {
        $hiddenRows[] = $this->renderField($name, $value, $widgetAttributes);
      }
      else
      {
        $field = $this->renderField($name, $value, $widgetAttributes, $error);

        // don't add a label tag and errors if we embed a form schema
        $label = $widget instanceof sfWidgetFormSchema ?
          $this->getFormFormatter()->generateLabelName($name) :
          $this->getFormFormatter()->generateLabel($name);
        $error = $widget instanceof sfWidgetFormSchema ? array() : $error;

        $lonelyRows[] = strtr($formFormat
          ->formatRow($label, $field, $error, $this->getHelp($name)),
          array('%hidden_fields%' => ''));
      }
    }

    $html = '';

    if ($groups)
    {
      // insert hidden fields in the last row
      $i        = 0;
      $maxGroup = count($groups);
      foreach ($groups as $fieldset => $group)
      {

        for ($j = 0, $max = count($group); $j < $max; $j++)
        {
          $group[$j] = strtr($group[$j], array('%hidden_fields%' =>
            (($i == $maxGroup -1) && $j == $max - 1) ?
              implode("\n", $hiddenRows) : ''));
        }

        $html .= $this->getFormFormatter()
          ->formatFieldSet($fieldset, implode('', $group));
        $i++;
      }
    }
    else
    {
      // only hidden fields
      $lonelyRows[] = implode("\n", $hiddenRows);
    }
    $html .= implode('', $lonelyRows);

    return $this->getFormFormatter()
      ->formatErrorRow($this->getGlobalErrors($errors)) . $html;
  }
}

Вот интерфейс, который должен реализовать ваш форматтер, если вы хотите его использовать:

interface FieldsettedFormFormatterInterface
{
  /**
   * This method will be used to render a fieldset
   *
   * @param string $name    the name of the widget
   * @param string $widgets the widgets html
   *
   * @return string the html for the fieldset
   */
  public function formatFieldset($name, $widgets);
}
person greg0ire    schedule 22.07.2010