Changeset 11814

Timestamp:

09/27/08 12:42:29 (5 years ago)

Author:

nicolas

Message:

new method added to the class, allowing to render the form using a particular widget schema formatter within a template

Files:

• branches/1.2/UPGRADE_TO_1_2 (modified) (1 diff)
• branches/1.2/lib/form/sfForm.class.php (modified) (1 diff)
• branches/1.2/test/unit/form/sfFormTest.php (modified) (2 diffs)

branches/1.2/UPGRADE_TO_1_2

@@ -336 +336 @@
-    <?php endif; ?>
-
+A new `renderUsing` method has been added to the `sfForm` class, allowing to 
+render the form using a particular widget schema formatter. This allows to
+use a formatter directly within a template:
+
+    [php]
+    // in a template, the form will be rendered using the "list" form formatter 
+    echo $form->renderUsing('list');
+
-Validators
-----------

branches/1.2/lib/form/sfForm.class.php

@@ -120 +120 @@
-
-  /**
+   * Renders the widget schema using a specific form formatter
+   *
+   * @param  string  $formatterName  The form formatter name
+   * @param  array   $attributes     An array of HTML attributes
+   *
+   * @return string The rendered widget schema
+   */
+  public function renderUsing($formatterName, $attributes = array())
+  {
+    $currentFormatterName = $this->widgetSchema->getFormFormatterName();
+
+    $formatterClass = sprintf('sfWidgetFormSchemaFormatter%s', ucfirst($formatterName));
+
+    if (!class_exists($formatterClass))
+    {
+      throw new InvalidArgumentException(sprintf('Formatter "%s" (class "%s") does not exist', $formatterName, $formatterClass));
+    }
+
+    $this->widgetSchema->setFormFormatterName($formatterName);
+
+    $output = $this->render($attributes);
+
+    $this->widgetSchema->setFormFormatterName($currentFormatterName);
+
+    return $output;
+  }
+
+  /**
-   * Renders global errors associated with this form.
-   *

branches/1.2/test/unit/form/sfFormTest.php

@@ -11 +11 @@
-require_once(dirname(__FILE__).'/../../bootstrap/unit.php');
-
-6
+8
-
-class FormTest extends sfForm
@@ -321 +321 @@
-$t->is($f->render(array('first_name' => array('class' => 'foo'))), $output, '->render() renders the form as HTML');
-
+// renderUsing()
+$t->diag('->renderUsing()');
+$f = new sfForm();
+$f->setWidgets(array('name' => new sfWidgetFormInput()));
+$output = <<<EOF
+<li>
+  <label for="name">Name</label>
+  <input type="text" name="name" id="name" />
+</li>
+
+EOF;
+$t->is($f->renderUsing('list'), $output, 'renderUsing() renders the widget schema using the given form formatter');
+$t->is($f->getWidgetSchema()->getFormFormatterName(), 'table', 'renderUsing() does not persist form formatter name for the current form instance');
+
-// ->embedForm()
-$t->diag('->embedForm()');