Функция field_help

Функция field_help используется в Twig-шаблонах для вывода текста подсказки, привязанного к конкретному полю формы. Первым параметром передаётся объект поля формы (обычно результат вызова form.fieldName), а вторым - необязательный массив параметров, например label или translation_domain. Функция возвращает HTML-разметку подсказки, которую можно вывести в шаблоне.

Синтаксис

{{ field_help(field, params) }}

Пример

Давайте создадим форму с полем name и зададим для него подсказку через опцию help:

<?php
	namespace App\Form;
	
	use Symfony\Component\Form\AbstractType;
	use Symfony\Component\Form\Extension\Core\Type\TextType;
	use Symfony\Component\Form\FormBuilderInterface;
	
	class ArticleType extends AbstractType
	{
		public function buildForm(FormBuilderInterface $builder, array $options): void
		{
			$builder->add('name', TextType::class, [
				'help' => 'Enter the article name',
			]);
		}
	}
?>

Теперь выведем подсказку в Twig-шаблоне с помощью функции field_help:

{{ form_start(form) }}
	{{ field_help(form.name) }}
{{ form_end(form) }}

Результат выполнения кода:

<div class="form-help">Enter the article name</div>

Пример

Давайте переопределим текст подсказки прямо в шаблоне через параметр label:

{{ field_help(form.name, {label: 'Please enter the article name'}) }}

Результат выполнения кода:

<div class="form-help">Please enter the article name</div>

Пример

Давайте выведем подсказки для нескольких полей формы в цикле:

{% for field in form %}
	{{ field_help(field) }}
{% endfor %}

Результат выполнения кода:

<div class="form-help">Enter the article name</div>
<div class="form-help">Enter the article text</div>

Смотрите также

функция form_help,
которая выводит подсказку для всей формы
функция field_label,
которая выводит метку поля формы
функция field_errors,
которая выводит ошибки поля формы
функция field_value,
которая выводит значение поля формы