Функция form_label

Функция form_label используется в Twig-шаблонах для вывода метки (label) конкретного поля формы. Первым параметром передаётся переменная поля, полученная из form_widget или созданного через createView. Вторым необязательным параметром можно переопределить текст метки, а третьим - передать массив атрибутов HTML.

Синтаксис

{{ form_label(field, label, attr) }}

Пример

Давайте создадим форму с полем name и выведем его метку:

<?php
	namespace App\Controller;
	
	use Symfony\Bundle\FrameworkBundle\Controller\AbstractController;
	use Symfony\Component\HttpFoundation\Response;
	use Symfony\Component\Form\Extension\Core\Type\TextType;
	use Symfony\Component\Form\Extension\Core\Type\SubmitType;
	use Symfony\Component\Routing\Attribute\Route;
	
	class ArticleController extends AbstractController
	{
		#[Route('/article', name: 'article_form')]
		public function form(): Response
		{
			$form = $this->createFormBuilder()
				->add('name', TextType::class)
				->add('save', SubmitType::class)
				->getForm();
			
			return $this->render('article/form.html.twig', [
				'form' => $form->createView(),
			]);
		}
	}
?>

Теперь выведем метку поля name в шаблоне:

{{ form_start(form) }}
	{{ form_label(form.name) }}
	{{ form_widget(form.name) }}
	{{ form_widget(form.save) }}
{{ form_end(form) }}

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

<label for="form_name">Name</label>
<input type="text" id="form_name" name="form[name]">
<button type="submit" id="form_save" name="form[save]">Save</button>

Пример

Давайте переопределим текст метки через второй параметр:

{{ form_start(form) }}
	{{ form_label(form.name, 'User name') }}
	{{ form_widget(form.name) }}
{{ form_end(form) }}

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

<label for="form_name">User name</label>
<input type="text" id="form_name" name="form[name]">

Пример

Давайте передадим HTML-атрибут class для метки:

{{ form_start(form) }}
	{{ form_label(form.name, null, {'class': 'form-label'}) }}
	{{ form_widget(form.name) }}
{{ form_end(form) }}

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

<label class="form-label" for="form_name">Name</label>
<input type="text" id="form_name" name="form[name]">

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

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