Erstellen des Formulars

Der login-View ist schnell erstellt. Man beginnt mit dem form Tag, dessen action-Attribut die URL der eben beschriebenen login-Action enthält. Dann werden Label und Eingabefelder für alle Attribute der LoginForm-Klasse hinzugefügt. Ein Absendebutton schließt das Formular ab. All das lässt sich mit reinem HTML-Code bewerkstelligen.

Yii bietet allerdings auch einige nützliche Hilfsklassen für das Erstellen von Views an. Textfelder kann man z.B. mit CHtml::textField() erzeugen, Auswahllisten mit CHtml::dropDownList().

Info: Vielleicht fragen Sie sich, wo der Sinn dieser Helfer liegt, wo man doch fast genausoviel Text schreiben muss, wie der erzeugte HTML-Code. Die Helfer leisten aber mehr als das. Mit folgendem Beispiel kann man z.B. ein Textfeld erstellen, dessen Formular automatisch abgesendet wird, sobald sein Inhalt verändert wird.

CHtml::textField($name,$value,array('submit'=>''));

Ohne Helferklasse müsste man überall umständlich Javascriptcode einfügen.

Im folgenden Beispiel zeigen wir, wie man das Anmeldeformular mit Hilfe von CHtml erstellt. Die Variable $model soll hierbei ein LoginForm-Model enthalten.

<div class="form">
<?php echo CHtml::beginForm(); ?>
 
    <?php echo CHtml::errorSummary($model); ?>
 
    <div class="row">
        <?php echo CHtml::activeLabel($model,'username'); ?>
        <?php echo CHtml::activeTextField($model,'username') ?>
    </div>
 
    <div class="row">
        <?php echo CHtml::activeLabel($model,'password'); ?>
        <?php echo CHtml::activePasswordField($model,'password') ?>
    </div>
 
    <div class="row rememberMe">
        <?php echo CHtml::activeCheckBox($model,'rememberMe'); ?>
        <?php echo CHtml::activeLabel($model,'rememberMe'); ?>
    </div>
 
    <div class="row submit">
        <?php echo CHtml::submitButton('Login'); ?>
    </div>
 
<?php echo CHtml::endForm(); ?>
</div><!-- form -->

Damit wird ein dynamisches Formular erzeugt. CHtml::activeLabel() generiert zum Beispiel ein Label für das angegebene Modelattribut. Tritt bei diesem Attribut ein Eingabefehler auf, erhält das Label die zusätzliche CSS-Klasse error. Über entsprechende CSS-Stile ändert sich so bei fehlerhaften Eingaben die Formatierung des Labels. Das selbe gilt für Textfelder die mit CHtml::activeTextField() generiert wurden.

Wenn man die vom yiic-Befehl angelegte CSS-Datei form.css verwendet, sieht das erzeugte Formular folgendermaßen aus:

Die Anmeldeseite

Die Anmeldeseite mit Fehlern

Seit Version 1.1.1 kann man Formulare auch mit dem neuen CActiveForm-Widget erstellen. Damit wird es möglich, eine einheitliche Validierung wahlweise auf Client- oder auf Serverseite durchzuführen. Mit CActiveForm wird der obige Code dann zu:

<div class="form">
<?php $form=$this->beginWidget('CActiveForm'); ?>
 
    <?php echo $form->errorSummary($model); ?>
 
    <div class="row">
        <?php echo $form->label($model,'username'); ?>
        <?php echo $form->textField($model,'username') ?>
    </div>
 
    <div class="row">
        <?php echo $form->label($model,'password'); ?>
        <?php echo $form->passwordField($model,'password') ?>
    </div>
 
    <div class="row rememberMe">
        <?php echo $form->checkBox($model,'rememberMe'); ?>
        <?php echo $form->label($model,'rememberMe'); ?>
    </div>
 
    <div class="row submit">
        <?php echo CHtml::submitButton('Login'); ?>
    </div>
 
<?php $this->endWidget(); ?>
</div><!-- form -->