Criando um Formulário
Escrever a visão login é algo bem simples. Devemos começar com uma tag
form, cujo atributo action deve ser a URL da ação login, descrita
anteriormente. Em seguida inserimos os rótulos e os campos para os atributos
declarados na classe LoginForm. Por fim, inserimos um botão de envio (submit)
que pode ser utilizado pelos usuários para enviar o formulário. Tudo isso pode
ser feito puramente com HTML.
O Yii fornece algumas classes auxiliares para facilitar a composição da visão. Por exemplo, para criar um caixa de texto, podemos utilizar o método CHtml::textField(); para criar uma lista do tipo drop-down, utilizamos CHtml::dropDownList().
Informação: Você deve estar se perguntando qual a vantagem de se utilizar uma classe auxiliar, se elas utilizam a mesma quantidade de código do que o equivalente em HTML. A resposta é que as classes auxiliares geram mais do que somente código HTML. Por exemplo, o código a seguir gera uma caixa de texto que dispara o envio do formulário caso seu valor seja alterado pelo usuário:
Se não fosse assim, seria necessário um monte de código em JavaScript espalhado.
No exemplo a seguir, utilizamos a classe CHtml para criar o formulário de login.
Assumimos que a variável $model representa uma instância de LoginForm.
Esse código gera um formulário mais dinâmico. Por exemplo, o método CHtml::activeLabel()
gera um rótulo associado ao atributo do modelo especificado. Se o ocorrer um erro
com a validação desse atributo, a classe CSS do rótulo será alterada para error,
o que mudará a aparência do rótulo. Da mesma forma, o método CHtml::activeTextField()
gera uma caixa de texto para o atributo especificado e, também, altera sua
classe CSS na ocorrência de erros.
Se utilizarmos o arquivo css form.css, fornecido pelo script do yiic, o
formulário gerado terá a seguinte aparência:
A Página de Login
A Página de Login com Erros
A partir da versão 1.1.1, existe um novo widget chamado CActiveForm, que pode ser utilizado para facilitar a criação de formulários. Esse widget é capaz de realizar validações de forma consistente e transparente, tanto do lado do cliente, quanto do lado do servidor. Utilizando o CActiveForm, o código do último exemplo pode ser reescrito da seguinte maneira: