venne/forms

Venne forms component

dev-master / 3.0.x-dev 2015-03-03 07:22 UTC

Requires

• php: >=5.5.0
• nette/di: 2.3@dev
• nette/forms: 2.3@dev

Requires (Dev)

• nette/tester: ~1.3.2
• phing/phing: ~2.10.1
• squizlabs/php_codesniffer: ~1.5.0

Suggests

• kdyby/doctrine-forms

BSD-3-Clause, GPL-2.0, GPL-3.0

• Josef Kříž

• Forms
• nette
• venne

README

Create forms as nested factories:

+- IFormFactory ---+    +- IFormFactory --+    +- IFormFactory -+
|   Base factory   | -> |   Adds inputs   | -> |  Adds mapping  | -> create() : Form
+------------------+    +-----------------+    +----------------+

Benefits:

• Change form configuration around the application on one place.
• Each factory can be used independently.
• It is not necessary to inherit forms.

Installation

The best way to install Venne/Forms is using Composer:

composer require venne/forms:@dev

Usage

Create basic factory

example:

services:
	basicFormFactory:
		class: Nette\Application\UI\Form
		arguments: [NULL, NULL]
		implement: Venne\Forms\IFormFactory
		setup:
			- setRenderer(@system.formRenderer)
			- setTranslator(@translator.translator)
		autowired: no

Create forms as factory

Implement Venne\Forms\IFormFactory:

class FooFormFactory implements Venne\Forms\IFormFactory
{

	private $formFactory;


	public function __construct(IFormFactory $formFactory)
	{
		$this->formFactory = $formFactory;
	}


	public function create()
	{
		$form = $this->formFactory->create();
		$form->addText('foo', 'Foo');
		$form->addSubmit('_submit', 'Save');
		return $form;
	}

}

Register forms

Define nested formFactory in constructor

services:
	fooFormFactory:
		class: FooFormFactory(@basicFormFactory)

Use it in presenter

class ExamplePresenter extends Nette\Application\UI\Presenter
{

	private $fooFormFactory;

	public function __construct(FooFormFactory $fooFormFactory)
	{
		$this->fooFormFactory = $fooFormFactory;
	}

	public function createComponentFooForm()
	{
		$form = $this->fooFormFactory->create();
		$form->onSuccess[] = $this->fooFormSuccess;
		return $form;
	}

	public function fooFormSuccess($form)
	{
		...
	}

}

Connect forms with kdyby\doctrine-forms

use Venne\Bridges\Kdyby\DoctrineForms\FormFactoryFactory;

class ExamplePresenter extends Nette\Application\UI\Presenter
{

	private $fooFormFactory;
	private $formFactoryFactory;

	public function __construct(FooFormFactory $fooFormFactory, FormFactoryFactory $formFactoryFactory)
	{
		$this->fooFormFactory = $fooFormFactory;
		$this->formFactoryFactory = $formFactoryFactory;
	}

	public function createComponentFooForm()
	{
		$entity = ....;

		$form = $this->formFactoryFactory
					->create($this->fooFormFactory)
					->setEntity($entity)
					->create();

		$form->onSuccess[] = $this->fooFormSuccess;
		return $form;
	}

	public function fooFormSuccess($form)
	{
		...
	}

}