A Twig Form Theme for Bulma 0.3.x for use with the Symfony 2.8 / 3.x framework
Twig Bulma (v0.3.x) Form theme
Bulma is a modern CSS framework based on Flexbox. This form theme was created for use with the Twig Template engine. Twig is a modern template engine for PHP.
This form theme was built to work with Twig in combination with the Symfony Framework for websites built on top of the Bulma CSS framework.
How to use the form theme:
The easiest way to make use of the form theme in Symfony is to set this form theme in the configuration file. Have a look at the Symfony documentation. Also example files are provided in this repository.
The theme also supports the use of icons. Bulma comes with support for the Font Awesome icon toolkit. It's realy easy to make a form widget support these themes with Symfony Form Type Extensions. An example Form Type Extension is provided within the examples directory in this repository.
Widget size can be set by just using a classname. The following example is for use with the Symfony Form Type.
$builder->add('firstname', TextType::class, [ 'attr' => [ 'class' => 'is-large' ], ... ]);
The default size needs no extra class. Suppoted sizes are is-small, is-medium and is-large.
The following example is for use with the Symfony Form Type. This example is based on the Form Type Extension provided in the documentation examples directory.
$builder // Username widget with user icon ->add('username', TextType::class, [ 'bulma_icon' => [ 'icon' => 'user', 'position' => 'left', ], ... ]) // Password widget with lock icon ->add('password', PasswordType::class, [ 'bulma_icon' => [ 'icon' => 'lock', 'position' => 'left', ], ... ]) ;
Need more icons?
Have a look at the bulma.io and fontawesome.io website to find out which icons are available and how to implement them.
Have a look at the following websites and their documentation for more information about this subject.