valicek1/nestraps

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

Bootstrap / Zurb Foundation forms for Nette Framework

Originally forked from foglcz/nestraps, _(*1)

Installation

$ composer require valicek1/nestraps

How to use in nette

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

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

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

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., _(*4)

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

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, _(*6)

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:, _(*7)

  {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:, _(*8)

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

... or:, _(*10)

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

NOTE:

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

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

License

LGPL., _(*14)