Skip to content

duskohu/forms

 
 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

45 Commits
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Nextras\Forms

List of components:

  • OptionList - option control rendered as radio list
  • MultiOptionList - multiple option control rendered as checkbox list
  • DatePicker - date picker, represented by DateTime object
  • DateTimePicker - date & time picker, represented by DateTime object

Installation

The best way to install is using Composer:

$ composer require nextras/forms

For Date(Time)Picker we recommend use DateTime Picker for Bootstrap. See JS init script.

Documentation

Initialization in your bootstrap.php:

use Nette\Forms\Container;
use Nextras\Forms\Controls;

Container::extensionMethod('addOptionList', function (Container $container, $name, $label = NULL, array $items = NULL) {
	return $container[$name] = new Controls\OptionList($label, $items);
});
Container::extensionMethod('addMultiOptionList', function (Container $container, $name, $label = NULL, array $items = NULL) {
	return $container[$name] = new Controls\MultiOptionList($label, $items);
});
Container::extensionMethod('addDatePicker', function (Container $container, $name, $label = NULL) {
	return $container[$name] = new Controls\DatePicker($label);
});
Container::extensionMethod('addDateTimePicker', function (Container $container, $name, $label = NULL) {
	return $container[$name] = new Controls\DateTimePicker($label);
});

Render IListControls as you wish:

$form->addMultiOptionList('list1', 'Pick your interests', ['a', 'b', 'c'])
     ->addRule($form::FILLED, 'You must pick some interest.');

$form->addMultiOptionList('list2', 'Pick your interests', ['d', 'e', 'f'])
	 ->addRule($form::LENGTH, 'You must pick just 1 or 2 interests.', array(1, 2));
```
```html
{form example}
<table>
<tr>
	<th>{label list1/}</th>
	<td>{input list1}</td>
</tr>
<tr>
	<th>{label list2/}</th>
	<td>
	{foreach $form['list2']-items as $key => $label}
		{label list2:$key class => checkbox}
			{input list2:$key}
			{$label}
		{/label}
	{/foreach}
	</td>
</tr>
</table>
{/form}
```