Zend_Form – legend dla fieldset

Tworząc formularze z użyciem Zend_Form mamy możliwość grupowania pól w różne obszary – fieldset. Jak zapewne wiecie, dla każdego obszaru mamy możliwość ustawienia etykiety. W kodzie html wygląda to następująco:

<form action="/register" method="post">
  <div>
    <div class="form-group">
      <fieldset id="fieldset-basic">
        <legend>Dane użytkownika</legend>
        <div class="form-element">
          <label class="required" for="name">Imię:</label>
          <input id="name" type="text" name="name" value="" />
        </div>
        <div class="form-element">
          <label class="required" for="surname">Nazwisko:</label>
          <input id="surname" type="text" name="surname" value="" />
        </div>
        <!-- kolejne pola tej grupy -->
      </fieldset>
    </div>
  </div>
</form>

Aby uzyskać efekt grupowania w formularzu, jego kod będzie wyglądał następująco:

class SmartGroup_Form_Register extends SmartGroup_Model_Form {

  protected function _renderForm() {
    $this->setMethod('post');

    $name = new Zend_Form_Element_Text( 'name' );
    $name->setLabel('Imię:');

    $surname = new Zend_Form_Element_Text( 'surname' );
    $surname->setLabel('Nazwisko:');

    $this->addElements( array( $name, $surname ) );

    $this->addDisplayGroup( array( 'name', 'surname' ), 'basic' );
  }
}

W linii 14 powyższego kodu dla instancji obiektu Zend_Form wywołujemy metodę “addDisplayGroup”, która nam tworzy sekcję fieldset, a w niej umieszcza wskazane elementy (w tym wypadku name oraz surname). Elementy, które mają być dodane do grupy przekazujemy w postaci tablicy jako pierwszy parametr metody addDisplayGroup. Drugi parametr to string, który posłuży do stworzenia identyfikatora grupy w postaci “fieldset-basic” dla powyższego przykładu.

W tym momencie pojawia się kwestia, jak dodać element legend do danej grupy pól formularza. Gdy skorzystamy z funkcji podpowiadania kodu w naszym IDE, łatwo można zauważyć, że mamy dostępną metodę setLegend(). Oczywiście pierwszym krokiem jest wykorzystanie tej metody i po odświeżeniu strony… zaskoczenie. Element legend nie został wyrenderowany.
Jak więc można rozwiązać ten problem? Otóż wystarczy wykorzystać trzeci parametr metody “addDisplayGroup”, który jest opisany jako “$options”. Wywołajmy więc tą metodę z następującymi parametrami:

$this->addDisplayGroup( array( 'name', 'surname' ), 'basic', array('legend' => 'Dane użytkownika' ) );

W tym momencie wszystko zadziała tak, jak się spodziewaliśmy. Z małą jednak różnicą, że fieldset zostanie umieszczony w tagach dt, dd. Jeżeli chcemy tego uniknąć, wystarczy w klasie nadrzędnej (w moim przypadku SmartGroup_Model_Form opisana w poprzednim poście), dodać następujący kod w metodzie _replaceViewDecorators:

$this->setDisplayGroupDecorators(array(
            array('FormElements'),
            array('Fieldset'),
            array( 'HtmlTag', array( 'tag' => 'div', 'class' => 'form-group' ) )
        ));