FormExtension

class FormExtension extends AbstractExtension implements InitRuntimeInterface

FormExtension extends Twig with form capabilities.

Properties

TwigRendererInterface $renderer This property is public so that it can be accessed directly from compiled templates without having to call a getter, which slightly decreases performance.

Methods

__construct(TwigRendererInterface $renderer)
initRuntime(Environment $environment)

{@inheritdoc}

getTokenParsers()

{@inheritdoc}

getFunctions()

{@inheritdoc}

getFilters()

{@inheritdoc}

getTests()

{@inheritdoc}

string renderCsrfToken(string $intention)

Renders a CSRF token.

string humanize(string $text)

Makes a technical name human readable.

bool isSelectedChoice(ChoiceView $choice, string|array $selectedValue)

Returns whether a choice is selected for a given form value.

getName()

{@inheritdoc}

Details

__construct(TwigRendererInterface $renderer)

Parameters

TwigRendererInterface $renderer

initRuntime(Environment $environment)

{@inheritdoc}

Parameters

Environment $environment

getTokenParsers()

{@inheritdoc}

getFunctions()

{@inheritdoc}

getFilters()

{@inheritdoc}

getTests()

{@inheritdoc}

string renderCsrfToken(string $intention)

Renders a CSRF token.

Parameters

string $intention The intention of the protected action

Return Value

string A CSRF token

string humanize(string $text)

Makes a technical name human readable.

Parameters

string $text The text to humanize

Return Value

string The humanized text

bool isSelectedChoice(ChoiceView $choice, string|array $selectedValue)

Returns whether a choice is selected for a given form value.

Unfortunately Twig does not support an efficient way to execute the "is_selected" closure passed to the template by ChoiceType. It is faster to implement the logic here (around 65ms for a specific form).

Directly implementing the logic here is also faster than doing so in ChoiceView (around 30ms).

The worst option tested so far is to implement the logic in ChoiceView and access the ChoiceView method directly in the template. Doing so is around 220ms slower than doing the method call here in the filter. Twig seems to be much more efficient at executing filters than at executing methods of an object.

Parameters

ChoiceView $choice The choice to check
string|array $selectedValue The selected value to compare

Return Value

bool Whether the choice is selected

See also

ChoiceView::isSelected()

getName()

{@inheritdoc}

© 2004–2017 Fabien Potencier
Licensed under the MIT License.
http://api.symfony.com/2.8/Symfony/Bridge/Twig/Extension/FormExtension.html