foglcz/nestraps

Nestraps - Twitter bootstrap renderer for Nette Framework (without assets)

Bootstrap / Zurb Foundation forms for Nette Framework

Installation

$ composer require foglcz/nestraps

How to use in nette

Update your config.neon:, _(*1)

    factories:
        form:
            parameters: [type]
            class: \Nette\Application\UI\Form
            setup:
                - setRenderer(\foglcz\Nestraps(%type%, @cacheStorage))

And then in your presenter:, _(*2)

public function createComponentYourFormName($name) {
    $form = $this->getContext()->createForm(\foglcz\Nestraps::BOOTSTRAP);
    $form = $this->getContext()->createForm(\foglcz\Nestraps::FOUNDATION);
    // ...
}

What is it

Nestraps is a replacement for conventional renderer in Nette Framework. Basically, all it does is that it takes given .latte file & sends the form there., _(*3)

The .latte file can be written in any way - how you want it., _(*4)

Twitter Bootstrap style

Detailed documentation is pending; for now proceed to HomepagePresenter in showcase: https://github.com/foglcz/nestraps/blob/master/showcase/nette-2.0/app/presenters/HomepagePresenter.php, _(*5)

OVERLOADING:

Don't really worry about manually editing this file -- altough it's possible, much cleaner approach is to create your own template with following markup:, _(*6)

  {layout 'path/to/bootstrap.latte'}
  {define #TextInput}<insert text input markup here>{/define}

If you want to overload some field but not overload the input globally, use following:, _(*7)

$field->setOption('latte', 'path/to/your/overloaded.latte');, _(*8)

... or:, _(*9)

$field->setOption('blockname', 'nameOfYourDefineBlockWithoutHash');, _(*10)

NOTE:

In the template, the hidden fields are rendered as last. The easiest way to extend any field is:, _(*11)

$form->addHidden(...)->setOption('latte', 'path/to/your/field.latte'), _(*12)

License

LGPL., _(*13)