library nette-forms-inputlist {🖫 1,130, ⚐ 6, ★ 25}

vojtech-dobes/nette-forms-inputlist

Alternative RadioList & CheckboxList for Nette Framework

Thursday, April 4, 2013
by vojtechdobes
Repository
8 Watchers
25 Stars
1,130 Installations

PHP
0 Dependents
0 Suggesters
9 Forks
2 Open issues
6 Versions
0 % Grown

The README.md

For Nette Framework

Alternative RadioList & CheckboxList for Nette Framework, _(*1)

License

New BSD, _(*2)

Dependencies

Nette 2.0.0, _(*3)

Installation

Get the source code from Github or via Composer (vojtech-dobes/nette-forms-inputlist).
Register VojtechDobes\NetteForms\InputListExtension as extension for $configurator.

$configurator->onCompile[] = function ($configurator, $compiler) {
    $compiler->addExtension('inputlist', new VojtechDobes\NetteForms\InputListExtension);
};

Usage

RadioList

$form->addMultiRadio('sex', 'Sex:', array(
    'male' => 'Male',
    'female' => 'Female',
));

Method's name was chosen to not interfere with native addRadiolist., _(*4)

CheckboxList

$checkboxlist = $form->addMultiCheckbox('topics', 'I like:', array(
    'l' => 'lifestyle',
    'm' => 'military',
    'c' => 'computers',
    'f' => 'flowers',
));

Defaults

$checkboxlist->setDefaultValue(array('l', 'm')); // lifestyle, military

Returned values

$checkboxlist->getValue() === array(0 => 'l', 1 => 'm')

Rendering

Automatic

Both RadioList and CheckboxList provide standard mechanism like getControlPrototype etc. You can also force omitting of last separator:, _(*5)

$radiolist->omitLastSeparator();

Manual

There is special new macro for Latte templates: {inputlist}. It behaves exactly like {foreach}, but it's specifically design to work with *List form elements., _(*6)

{form formName}
    {inputlist sex as $key => $label}
        {input} {label /} {sep}<br>{/sep}
    {/inputlist}
{/form}

Macros {input} and {label} behave the same way as always, but when used without element identificator, they will render proper elements for iteration specific item. If you use it with identificator, it will render appropriate element from form., _(*7)

{form formName}
    {inputlist sex as $key => $label}
        {input} {label /}<br>
        {input send} {* standard button, no problem *}
    {/inputlist}
{/form}

You can add HTML attributes to them as usually., _(*8)

{form formName}
    {inputlist sex as $key => $label}
        {input class => 'input-radio'} {label}{$label}{/label}<br>
    {/inputlist}
{/form}

Attribute version of {inputlist} is also possible:, _(*9)

{form formName}
    <ul n:inner-inputlist="sex as $key => $label">
        <li>{input} {label /}</li>
    </ul>
{/form}

Validation

Here supported rules are listed:, _(*10)

CheckboxList

Form::FILLED	At least one box must be checked.
Form::LENGTH	Exact amount of boxes that must be checked.
Form::MIN_LENGTH	Minimum amount of boxes that must be checked.
Form::MAX_LENGTH	Maximum amount of boxes that must be checked.
Form::RANGE	Minimum and maximum amount of boxes that must be checked.
Form::REGEXP	Checks if selected checkbox values match regular expression.