Getting started
Requirements
- PHP 8.4 or newer
- nette/forms 3.2 or newer
- Bootstrap 3 CSS on the page (the renderers output Bootstrap 3 form markup)
Installation
bash
composer require tomaj/nette-bootstrap-formYour first form
Create the form as usual and set one of the renderers before it is rendered:
php
use Nette\Forms\Form;
use Tomaj\Form\Renderer\BootstrapRenderer;
$form = new Form();
$form->addText('email', 'E-mail')->setRequired();
$form->addCheckbox('remember', 'Remember me');
$form->addSubmit('login', 'Log in');
$form->setRenderer(new BootstrapRenderer());
echo $form;The form is rendered as a horizontal Bootstrap form:
html
<form action="" method="post" class="form-horizontal" novalidate="novalidate">
<div>
<div class="form-group required">
<div class="col-sm-3 control-label"><label for="frm-email" class="required">E-mail</label></div>
<div class="col-sm-9"><input type="text" name="email" class="form-control text" id="frm-email" required data-nette-rules='[{"op":":filled","msg":"This field is required."}]'></div>
</div>
<div class="form-group">
<div class="col-sm-3 control-label"></div>
<div class="col-sm-9"><div class="checkbox"><label for="frm-remember"><input type="checkbox" name="remember" id="frm-remember">Remember me</label></div></div>
</div>
<div class="form-group">
<div class="col-sm-3 control-label"></div>
<div class="col-sm-9"><input type="submit" name="login" class="btn btn-primary button" value="Log in"></div>
</div>
</div>
</form>In a Nette application
In a presenter or a component, set the renderer in the factory method. The template renders the form with {control loginForm} as usual.
php
use Nette\Application\UI\Form;
use Tomaj\Form\Renderer\BootstrapVerticalRenderer;
protected function createComponentLoginForm(): Form
{
$form = new Form();
$form->addText('email', 'E-mail')->setRequired();
$form->addPassword('password', 'Password')->setRequired();
$form->addSubmit('login', 'Log in');
$form->onSuccess[] = $this->loginFormSucceeded(...);
$form->setRenderer(new BootstrapVerticalRenderer());
return $form;
}If all forms of an application use the same renderer, create them in one form factory instead of repeating setRenderer():
php
use Nette\Forms\Form;
use Tomaj\Form\Renderer\BootstrapRenderer;
final class FormFactory
{
public function create(): Form
{
$form = new Form();
$form->setRenderer(new BootstrapRenderer());
return $form;
}
}
$form = new FormFactory()->create();Next steps
- Renderers: the three layouts, what changes on each control, buttons,
novalidateand custom wrappers - API reference: the public classes and the
$wrapperskeys - Upgrading to 3.0 from 2.x