nextras/forms

Extra form components for Nette Framework.

Installs: 10 936

Dependents: 11

Stars: 31

Watchers: 15

Forks: 17

Open Issues: 3

Language: PHP

v1.5.0 2015-06-16 21:10 UTC

README

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
  • Tyheahead - the best autocomplete for your forms
  • BS3InputMacros - input macros for Bootstrap 3 (adds some css classes)

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);
});
Container::extensionMethod('addTypeahead', function(Container $container, $name, $label = NULL, $callback = NULL) {
    return $container[$name] = new Controls\Typeahead($label, $callback);
});

Register your Bootstrap 3 macros in config.neon:

latte:
    macros:
        - Nextras\Forms\Bridges\Latte\Macros\BS3InputMacros

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));
{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}
            {input list2:$key}
            {$label}
        {/label}
    {/foreach}
    </td>
</tr>
</table>
{/form}