html.md

Forms & HTML

• Abrindo um formulário
• Proteção contra CSRF
• Form Model Binding
• Labels
• Text, Text Area, Password e Hidden
• File Input
• Checkboxes e Radio Buttons
• Drop-Downs
• Buttons
• Macros personalizadas

Abrindo um formulário

Abrindo um formulário

{{ Form::open(array('url' => 'foo/bar')) }}
	//
{{ Form::close() }}

Por padrão, será assumido o método POST. Porém você é livre para especificar outro método:

echo Form::open(array('url' => 'foo/bar', 'method' => 'put'))

Nota: Uma vez que formulários HTML suportam apenas POST, para os métodos PUT e DELETE será inserido automaticamente um campo hidden com nome _method no seu formulário para simular tal requisição.

Você pode abrir formulários que apontam para rotas nomeadas ou actions de controllers.

echo Form::open(array('route' => 'route.name'))

echo Form::open(array('action' => 'Controller@method'))

Se seu formulário for aceitar upload de arquivos, adicione uma opção files ao seu array:

echo Form::open(array('url' => 'foo/bar', 'files' => true))

Proteção contra CSRF

Laravel oferece uma forma fácil de proteger sua aplicação contra CSRF (cross-site request forgery). Primeiro, um token aleatório será adicionado na sessão do seu usuário. Não se preocupe, isso é feito automaticamente. Em seguida, use o método token para gerar um input hidden contendo o token no seu formulário:

Adicionando o Token CSRF em um formulário

echo Form::token();

Adicionar um filtro CSRF à uma rota

Route::post('profile', array('before' => 'csrf', function()
{
	//
}));

Form Model Binding

Muitas vezes, você vai querer popular um formulário baseado nos dados de um Model. Para fazer isso use o método Form::model:

Abrindo um Formulário Model

echo Form::model($user, array('route' => 'user.update'))

Agora, quando você gerar um elemento no formulário, como um input text, os valores do model correspondentes aos campos do formulário serão automaticamente setados aos seus respectivos valores. Por exemplo, para um input text chamado email, o atributo do User Model email será setado no valor do campo. Porém, tem mais! Se há um item na Flash data da Sessão correspondente ao nome do input, ele irá prevalecer sobre o valor do Model. Então, a regra é a seguinte:

1. Flash Data da Sessão (Input antigo)
2. Valor passado explicitamente
3. Dado do atributo do Model

Isso permite você criar rapidamente formulários que não apenas vinulam com os valores dos Models, mas também repopulam caso haja um erro de validação no servidor!

Nota: Quando estiverem usando o Form::model, não esqueçam de fechar o formulário usando o Form::close!

Labels

Criando um elemento Label

echo Form::label('email', 'E-Mail Address');

Especificando atributos extras no html

echo Form::label('email', 'E-Mail Address', array('class' => 'awesome'));

Nota: Depois de criar o label, qualquer elemento que você criar que corresponda ao nome do label automaticamente receberá um ID com o mesmo nome do label.

Text, Text Area, Password & Hidden

Criando um Input Text

echo Form::text('username');

Especificando um valor padrão

echo Form::text('email', 'example@gmail.com');

Nota: Os métodos hidden e textarea tem a mesma assinatura do método text.

Criando um input password

echo Form::password('password');

Checkboxes e Radio Buttons

Criando um Input checkbox

echo Form::checkbox('name', 'value');

Criando um checkbox já marcado

echo Form::checkbox('name', 'value', true);

Nota: O método radio tem a mesma assinatura que o método checkbox.

File Input

Criando um input file

echo Form::file('image');

Drop-Downs

Criando uma lista Drop-Down

echo Form::select('size', array('L' => 'Large', 'S' => 'Small'));

Criando uma lista Drop-Down com um valor selecionado por padrão

echo Form::select('size', array('L' => 'Large', 'S' => 'Small'), 'S');

Buttons

Criando um Button submit

echo Form::submit('Click Me!');

Nota: Precisa criar um elemento do tipo button? Tente o método button. Ele tem a mesma assinatura do submit.

Macros personalizadas

É fácil definir seus próprios elementos chamados de "macros". Veja como funciona. Primeiro, simplesmente registre a macro com o seu devido nome e uma Closure.

Registrando uma Macro de formulário

Form::macro('myField', function()
{
	return '<input type="awesome">';
});

Agora você pode chamar sua macro usando o seu nome:

Chamando uma macro personalizada

echo Form::myField();