daku/nette-form-blueprints

Manual rendering of Nette forms made easy.

v1.0.0 2020-05-07 19:49 UTC

Requires

• php: >=7.1
• latte/latte: ^2.4.1 | ^3.0
• nette/application: ^2.4.1 | ^3.0
• nette/forms: ^2.4 | ^3.0
• nette/utils: ^2.4 | ^3.0

Requires (Dev)

• nette/nette: ^2.4 | ^3.0
• nette/tester: ^2.3.2

MIT

• Daniel Kurečka

• nette
• latte
• bootstrap3
• bootstrap4
• tracy-panel
• forms-generator

README

This tool helps with manual rendering of Nette forms. It can generate Latte markup using various templates.

Installation

composer require daku/nette-form-blueprints

Usage

Integration with Tracy debug panel

Register the extension in config.neon:

extensions:
	formBlueprints: Daku\Nette\FormBlueprints\FormBlueprintsExtension

From now on you will be able to see generated blueprints in debug panel for all forms that were attached to current presenter:

Optional configuration

formBlueprints:
	indentation: '    ' # change indentation to spaces

	# add custom templates
	templates:
		- CustomTemplate

Standalone usage

It is possible to generate a blueprint without integration to Tracy debug panel.

Example:

<?php
require __DIR__ . '/vendor/autoload.php';

// create your form
$form = new Nette\Application\UI\Form;
$form->addText('foo');
$form->addSubmit('submit');

// use the generator
$generator = new Daku\Nette\FormBlueprints\BlueprintsGenerator(new Daku\Nette\FormBlueprints\LatteFormatter(new Latte\Parser));
echo $generator->generate($form, new Daku\Nette\FormBlueprints\Templates\Bootstrap4Template);

Templates

Following templates are available:

• Table (mimics Nette's default form renderer)
• Line Breaks (simple template using line breaks only)
• Bootstrap 3
• Bootstrap 3 Horizontal
• Bootstrap 3 Inline
• Bootstrap 4
• Bootstrap 4 Horizontal
• Bootstrap 4 Inline

Additional templates can be used by implementing Daku\Nette\FormBlueprints\Templates\Template.

Requirements

PHP >= 7.1
Nette >= 2.4