Функция form_help

Функция form_help выводит текст подсказки, привязанный к полю формы. Обычно подсказка задаётся опцией help при построении поля. Функция принимает форму или конкретное поле и возвращает готовый HTML-блок подсказки.

Синтаксис

{{ form_help(form) }}

Пример

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

<?php
	namespace App\Controller;

	use Symfony\Bundle\FrameworkBundle\Controller\AbstractController;
	use Symfony\Component\Form\Extension\Core\Type\TextType;
	use Symfony\Component\Form\Extension\Core\Type\SubmitType;
	use Symfony\Component\HttpFoundation\Response;
	use Symfony\Component\Routing\Attribute\Route;

	class ArticleController extends AbstractController
	{
		#[Route('/article', name: 'article_form')]
		public function form(): Response
		{
			$form = $this->createFormBuilder()
				->add('title', TextType::class, [
					'help' => 'Enter the article title',
				])
				->add('save', SubmitType::class)
				->getForm();

			return $this->render('article/form.html.twig', [
				'form' => $form,
			]);
		}
	}
?>

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

{{ form_start(form) }}
	{{ form_row(form.title) }}
	<p>{{ form_help(form.title) }}</p>
	{{ form_row(form.save) }}
{{ form_end(form) }}

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

<p>Enter the article title</p>

Пример

Давайте выведем подсказку для всей формы сразу, передав в функцию form_help объект формы:

{{ form_start(form) }}
	{{ form_help(form) }}
	{{ form_row(form.title) }}
	{{ form_row(form.save) }}
{{ form_end(form) }}

Если у формы нет опции help, функция вернёт пустую строку:

""

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

функция form_label,
которая выводит подпись поля формы
функция form_errors,
которая выводит ошибки валидации поля
функция form_row,
которая выводит подпись, поле и ошибки сразу
функция form_widget,
которая выводит сам элемент ввода формы