Поле FormType

Дата обновления перевода 2025-02-05

Поле FormType

FormType предопределяет несколько опций, которые потом доступны во всех типах, родителями которых является FormType.

????????? ???????????? ?? ????????? ??? ???????? ?? ???????? ????????.
???????? ???????????
????? FormType

Дата обновления перевода 2025-02-21

Tip

Полный список опций, определенных и унаследованных этим типом формы, доступен путем
выполнения этой команды в вашем приложении:

1
2
# замените 'FooType' именем класса вашего типа формы
$ php bin/console debug:form FooType

Опции поля

action

тип: string default: пустая строка

Эта опция указывает, куда отправить данные формы при отправке (обычно URI). Её значение отображается как атрибут action элемента form. Пустое значение считается ссылкой на тот же документ, т.е. форма будет отправлена по тому же URI, что и отображённая форма.

allow_extra_fields

тип: boolean по умолчанию: false

Обычно, если вы отправляете дополнительные поля, которые не сконфигурированы в вашей форме, вы получите ошибку валидации "Эта форма не должна содержать дополнительных полей".

Вы можете отключить эту ошибку валидации, включив в форме опцию allow_extra_fields.

Дата обновления перевода 2025-02-22

by_reference

тип: boolean по умолчанию: true

В большинстве случаев, если у вас есть поле author, то вы ожидаете, что в исходном объекте будет вызван setAuthor(). Однако, в некоторых случаях, setAuthor() может быть не вызван. Установив by_reference, как false, вы гарантируете, что сеттер будет вызван в любом случае.

Чтобы объяснить это детальнее, вот простой пример:

1
2
3
4
5
6
7
8
9
10
11
12
13
use Symfony\Component\Form\Extension\Core\Type\EmailType;
use Symfony\Component\Form\Extension\Core\Type\FormType;
use Symfony\Component\Form\Extension\Core\Type\TextType;
// ...

$builder = $this->createFormBuilder($article);
$builder
    ->add('title', TextType::class)
    ->add(
        $builder->create('author', FormType::class, ['by_reference' => ?])
            ->add('name', TextType::class)
            ->add('email', EmailType::class)
    )

Если by_reference - "true", то следующее происходит за кулисами, когда вы вызываете submit() (или handleRequest()) в форме:

1
2
3
$article->setTitle('...');
$article->getAuthor()->setName('...');
$article->getAuthor()->setEmail('...');

Заметьте, что setAuthor() не вызывается. Автор изменяется ссылкой.

Если вы установили by_reference, как "false", отправка выглядит так:

1
2
3
4
5
$article->setTitle('...');
$author = clone $article->getAuthor();
$author->setName('...');
$author->setEmail('...');
$article->setAuthor($author);

Поэтому, всё, что на самом деле делает by_reference=false - это заставляет фреймворк вызвать сеттер в родительском объекте.

Похожим образом, если вы используете поле CollectionType, где ваша исходная коллекция данных является объектом (как с ArrayCollection в Doctrine), то by_reference должна быть установлена, как false, если вам нужно, чтобы был вызван добавитель или уиичтожитель (например, addAuthor() и removeAuthor()).

compound

тип: boolean по умолчанию: true

Составная форма может быть либо целым элементом <form>, либо группой полей формы (отображенных, например, внутри элементов контейнера <div> или <tr>). Составные формы используют DataMapperInterface для инициализации своих дочерей или обратного написания их отправленных данных.

Простая (не составная) форма отображается як любой из этих HTML-элементов: <input> (TextType, FileType, HiddenType), <textarea> (TextareaType) или <select> (ChoiceType).

Некоторые основные типы вроде типов, связанных с датами, или ChoiceType могут быть простыми или составными, в зависимости от их опций (таких как expanded или widget). Они будут вести себя либо как простые текстовые поля, либо как группа текстовых полей или полей выбора.

Дата обновления перевода 2024-07-26

constraints

тип: array или Constraint по умолчанию: null

Позволяет вам прикрепить одно или более ограничений валидации к конкретному полю. Чтобы узнать больше, см, Добавление валидации. Эта опция добавляется в расширении формы FormTypeValidatorExtension.

Дата обновления перевода 2025-02-05

data

тип: mixed по умолчанию : По умолчанию является полем основоположной структуры.

Когда вы создаёте форму, каждое поле изначально отображает значение соотствующего свойства данных домена формы (например, если вы привязываете объект к форме). Если вы хотите переопределить эти изначальные значения для формы или индивидуального поля, вы можете установить это в опции данных:

1
2
3
4
5
6
use Symfony\Component\Form\Extension\Core\Type\HiddenType;
// ...

$builder->add('token', HiddenType::class, array(
    'data' => 'abcdef',
));

Warning

Опция data всегда переопределяет значение, взятое из данных домена (объекта) при отображении. Это означает, что значение объекта также переопределяется, когда форма редактирует уже существующий сохранённый объект, что приводит к потере сохранённого значения при отправке формы.

Дата обновления перевода 2025-02-24

data_class

тип: string

Эта опция используется для установки правильного отображателя данных для использования формой, поэтому вы можете использовать её для любого типа поля, который требует объект:

use AppEntityMedia; use AppFormMediaType; // ...

$builder->add('media', MediaType::class, [
'data_class' => Media::class,

]);

Дата обновления перевода 2025-02-24

empty_data

тип: mixed

Фактическое значение по умолчанию этой опции зависит от других опций поля:

  • Если data_class установлена, а required - true, тогда new $data_class();
  • Если data_class установлена, а required - false, тогда null;
  • Если data_class не установлена, а compound - true, тогда [] (пустой массив);
  • Если data_class не установлена, а compound - false, тогда '' (пустая строка).

Дата обновления перевода 2025-02-05

Эта опция определяет, какое значение поле будет возвращать, если представленное значение пустое (или отсутствует). Она не устанавливает начальное значение, если оно не предоставлено при отображении формы в просмотре.

Это означает, что она помогает вам обрабатывать отправку формы с пустыми полями. Например, если вы хотите, чтобы поле name было явно установлено как John Doe, когда значение не выбрано, вы можете сделать это следующим образом:

1
2
3
4
$builder->add('name', null, [
    'required'   => false,
    'empty_data' => 'John Doe',
]);

В результате все еще будет отображаться пустое текстовое поле, но при отправке будет установлено значение John Doe. Используйте опции data или placeholder, чтобы показать это начальное значение в отображаемой форме.

Note

Если форма является составной, вы можете задать empty_data в виде массива, объекта или
замыкания. Эта опция может быть установлена для всего класса формы, см. статью Как сконфигурировать пустые данные для класса формы для получения более подробной информации об этих опциях.

Warning

Преобразователи данных формы все равно будут
применяться к значению empty_data. Это означает, что пустая строка будет будет приведена к значению null. Используйте пользовательский преобразователь данных, если вы явно хотите вернуть пустую строку.

is_empty_callback

тип: callable по умолчаню: null

Это вызываемое берёт данные формы и возвращает, считается ли значение пустым.

Дата обновления перевода 2024-07-26

constraints

тип: array или Constraint по умолчанию: null

Позволяет вам прикрепить одно или более ограничений валидации к конкретному полю. Чтобы узнать больше, см, Добавление валидации. Эта опция добавляется в расширении формы FormTypeValidatorExtension.

Дата обновления перевода 2025-02-05

data

тип: mixed по умолчанию : По умолчанию является полем основоположной структуры.

Когда вы создаёте форму, каждое поле изначально отображает значение соотствующего свойства данных домена формы (например, если вы привязываете объект к форме). Если вы хотите переопределить эти изначальные значения для формы или индивидуального поля, вы можете установить это в опции данных:

1
2
3
4
5
6
use Symfony\Component\Form\Extension\Core\Type\HiddenType;
// ...

$builder->add('token', HiddenType::class, array(
    'data' => 'abcdef',
));

Warning

Опция data всегда переопределяет значение, взятое из данных домена (объекта) при отображении. Это означает, что значение объекта также переопределяется, когда форма редактирует уже существующий сохранённый объект, что приводит к потере сохранённого значения при отправке формы.

Дата обновления перевода 2025-02-24

data_class

тип: string

Эта опция используется для установки правильного отображателя данных для использования формой, поэтому вы можете использовать её для любого типа поля, который требует объект:

use AppEntityMedia; use AppFormMediaType; // ...

$builder->add('media', MediaType::class, [
'data_class' => Media::class,

]);

Дата обновления перевода 2025-02-24

empty_data

тип: mixed

Настоящее значение этой опции по умолчанию зависит от других опций поля:

  • Если data_class установлена, а required - true, то - new $data_class();
  • Если data_class установлена, а required - false, то - null;
  • Если data_class не установлена, а compound - true, то - array() (пустой массив);
  • Если data_class не установлена, а compound - false, то - '' (пустая строка).

Дата обновления перевода 2025-02-05

Эта опция определяет, какое значение поле будет возвращать, если представленное значение пустое (или отсутствует). Она не устанавливает начальное значение, если оно не предоставлено при отображении формы в просмотре.

Это означает, что она помогает вам обрабатывать отправку формы с пустыми полями. Например, если вы хотите, чтобы поле name было явно установлено как John Doe, когда значение не выбрано, вы можете сделать это следующим образом:

1
2
3
4
$builder->add('name', null, [
    'required'   => false,
    'empty_data' => 'John Doe',
]);

В результате все еще будет отображаться пустое текстовое поле, но при отправке будет установлено значение John Doe. Используйте опции data или placeholder, чтобы показать это начальное значение в отображаемой форме.

Note

Если форма является составной, вы можете задать empty_data в виде массива, объекта или
замыкания. Эта опция может быть установлена для всего класса формы, см. статью Как сконфигурировать пустые данные для класса формы для получения более подробной информации об этих опциях.

Warning

Преобразователи данных формы все равно будут
применяться к значению empty_data. Это означает, что пустая строка будет будет приведена к значению null. Используйте пользовательский преобразователь данных, если вы явно хотите вернуть пустую строку.

Дата обновления перевода 2025-02-24

error_bubbling

тип: boolean по умолчанию: false, кроме случаев, когда форма compound

Если true, то любые ошибки в этом поле будут переданы родительскому полю или форме. Например, если установлена, как true в нормальном поле, то любые ошибки для этого поля будут присоединены к главной форме, а не к конкретному полю.

Дата обновления перевода 2024-07-26

error_mapping

тип: array по умолчанию: []

Эта опция позволяет вам изменять цель ошибки валидации.

Представьте, что у вас есть пользовательский метод под именем matchingCityAndZipCode(), который валидирует, совпадает ли город и почтовый индекс. К сожалению, поля "matchingCityAndZipCode" в вашей форме нет, поэтому всё, что Symfony может сделать - это отобразить ошибку наверху формы.

С настроенным отображением ошибок вы можете сделать лучше: привяжите ошибку к полю города, чтобы она отображалась над ним:

1
2
3
4
5
6
7
8
public function configureOptions(OptionsResolver $resolver): void
{
    $resolver->setDefaults([
        'error_mapping' => [
            'matchingCityAndZipCode' => 'city',
        ],
    ]);
}

Вот правила для лево- и правостороннего отображения:

  • Левая сторона содержит пути свойств;
  • Если нарушение генерируется в свойстве или методе класса, то его путь - это просто propertyName;
  • Если нарушение сгенерировано в записи объекта array или ArrayAccess,
    то путь свойства будет [indexName]; * Вы можете создать вложенные пути свойств, соединив их, разделяя свойства точками. Например: addresses[work].matchingCityAndZipCode;
  • Правая сторона содержит просто имена полей в форме.

По умолчанию, ошибки любого свойства, которое не отображенно, соберутся в родительской форме. Вы можете использовать точку (.) в левой части, чтобы привязать ошибки всех неотображённых свойств к конкретному полю. Например, чтобы привязать эти ошибки к полю city, используйте:

1
2
3
4
5
$resolver->setDefaults([
    'error_mapping' => [
        '.' => 'city',
    ],
]);

Дата обновления перевода 2025-02-24

extra_fields_message

тип: string по умолчанию: Эта форма не должна содержать лишних полей.

Это сообщение ошибки валидации, которое используется, если отправленные данные формы содержат одно или больше полей, которые не являются частью определения формы. Заполнитель {{ extra_fields }} может быть использован, чтобы отобразить список отправленных имён лишних полей, разделённх запятыми.

Это сообщение может быть множественным, см. форматирование сообщений во множественном числе
для получения подробной информации.

Дата обновления перевода 2025-02-24

form_attr

тип: boolean или string по умолчанию: false

Если true и используется в элементе формы, добавляет атрибут "form" к представлению поля HTML
с идентификатором HTML-формы. Таким образом, элемент формы может быть отображен вне HTML-формы, но при этом будет работать должным образом:

1
2
3
$builder->add('body', TextareaType::class, [
    'form_attr' => true,
]);

Это может быть полезно, когда вам нужно решить проблемы с вложенными формами.
Вы также можете установить значение true для корневой формы, чтобы автоматически установить атрибут "form" для всех ее дочерних форм.

Note

Если корневая форма не имеет идентификатора, form_attr должен быть строковым идентификатором, который
будет использоваться в качестве идентификатора формы.

getter

тип: callable по умолчанию: null

Если предоставлено, это вызываемое будет вызвано для чтения значения из основоположного объеккта, который будет использован для наполнения поля формы.

Больше деталей доступно в разделе в Как и когда использовать отображатели данных.

Дата обновления перевода 2024-07-26

help

тип: string или TranslatableInterface по умолчанию: null

Позволяет вам определять сообщение помощи для поля формы, которое по умолчанию отображается под полем:

1
2
3
4
5
6
7
8
9
10
11
12
13
use Symfony\Component\Translation\TranslatableMessage;

$builder
    ->add('zipCode', null, [
        'help' => 'The ZIP/Postal code for your credit card\'s billing address.',
    ])

    // ...

    ->add('status', null, [
        'help' => new TranslatableMessage('order.status', ['%order_id%' => $order->getId()], 'store'),
    ])
;

Дата обновления перевода 2025-02-24

help_attr

тип: array по умолчанию: []

Устанавливает HTML-атрибуты для элемента, используемого для отображения сообщения помощи в поле формы. Его значение представляет собой ассоциативный массив с именами HTML-атрибутов в качестве ключей. Эти атрибуты также могут быть заданы в шаблоне:

1
2
3
{{ form_help(form.name, 'Your name', {
    'help_attr': {'class': 'CUSTOM_LABEL_CLASS'}
}) }}

Дата обновления перевода 2025-02-24

help_html

тип: boolean по умолчанию: false

По умолчанию содержание опции help экранируется перед отображением в шаблоне.
Установите для этой опции значение true, чтобы не экранировать их, что полезно,
когда справка содержит элементы HTML.

Дата обновления перевода 2025-02-24

help_translation_parameters

тип: array по умолчанию: []

Содержание опции help переводится перед показом, поэтому она может содержать заполнители перевода. Эта опция определяет значения, которые будут использоваться для замены этих заполнителей.

Если предоставлено такое сообщение перевода:

1
2
# translations/messages.en.yaml
form.order.id.help: 'This will be the reference in communications with %company%'

То вы можете указать значения заполнителей следующим образом:

1
2
3
4
5
6
$builder->add('id', null, [
    'help' => 'form.order.id.help',
    'help_translation_parameters' => [
        '%company%' => 'ACME Inc.',
    ],
]);

Опция help_translation_parameters дочерних полей объединяется с с аналогичной опцией их родителей, поэтому дочерние поля могут повторно использовать
и/или переопределять любые родительские заполнители.

Дата обновления перевода 2025-02-05

inherit_data

тип: boolean по умолчанию: false

Эта опция определяет, будет ли форма наследовать данные из родительской формы. Это может быть полезной, если у вас есть набор полей, которые повторяется в нескольких формах. См. Как уменьшить дублирование кода с помощью "inherit_data".

Warning

Когда поле имеет установленную опцию inherit_data, оно использует данные родительской формы так, как они есть. Это означает, что Преобразователи Данных не будут применяться к этому полю.

Дата обновления перевода 2025-02-24

invalid_message

тип: string по умолчанию: Это значение не валидно

Это сообщение ошибки валидации, которое используется, если данные, введенные в это поле, не имеют смысла (т.е. валидация проходит неудачно).

Это может случиться, к примеру, если пользователь вводит в поле TimeType асбурдную строку, которая не может быть конвертирована в настоящее время, или если пользователь вводит строку (например, apple) в числовое поле.

Нормальная (программный код) валидация (например, установка минимальной длины для поля), должна быть установлена с использованием сообщений валидации с вашими правилами валидации (справочник ).

Дата обновления перевода 2025-02-24

invalid_message_parameters

тип: array по умолчанию: []

При установке опции invalid_message вам может понадобиться включить в строку некоторые переменные. Это можно сделать, добавив заполнители в эту опцию,и включив переменные в этой опции:

1
2
3
4
$builder->add('someField', SomeFormType::class, [
    // ...
    'invalid_message' => 'Вы ввели невалидное значение, оно должно содержать %num% букв',
    'invalid_message_parameters' => ['%num%' => 6],

Дата обновления перевода 2025-02-24

label_attr

тип: array по умолчанию: []

Устанавливает HTML-атрибуты для элемента <label>, который будет использован при отображении ярлыка для поля. Это ассоциативный массив с HTML-атрибутом в качестве ключа. Этот атрибут может также быть установлен прямо внутри шаблона:

1
2
3
{{ form_label(form.name, 'Your name', {
    'label_attr': {'class': 'CUSTOM_LABEL_CLASS'}
}) }}

Дата обновления перевода 2025-02-24

label_format

тип: string по умолчанию: null

Конфигурирует строку, используемую в качестве ярылка поля, в случае, если опция label не была установлена. Это полезно при использовании сообщений переводов ключевых слов.

Если вы используете сообщения переводов ключевых слов в качестве ярлыков, то у вас часто будет несколько сообщений с ключевым словом для одного и того же ярлыка (например, profile_address_street, invoice_address_street). Это потому, что ярлык строится для каждого "пути" к полю. Чтобы избежать повтора сообщений ключевых слов, вы можете сконфигурировать формат ярлыка в качестве статичного значения, например:

1
2
3
4
5
6
7
8
// ...
$profileFormBuilder->add('address', AddressType::class, [
    'label_format' => 'form.address.%name%',
]);

$invoiceFormBuilder->add('invoice', AddressType::class, [
    'label_format' => 'form.address.%name%',
]);

Эта опция наследуется дочерними типами. С использованием вышенаписанного кода, ярлык поля street обеих форм будет использовать сообщение с ключевым словом form.address.street.

В формате ярлыка доступны две переменные:

%id%
Уникальный идентификатор для поля, состоящий из полного пути к полю и имени поля (например, profile_address_street);
%name%
Имя поля (например, street).

Значение по умолчанию (null) приводит к "человеческой" версии имени поля.

Note

Опция label_format оценивается в теме формы. Убедитесь в том, что вы обновили ваши щаблоны, в случае, если вы настраивали темизацию форм.

Дата обновления перевода 2025-02-24

mapped

тип: boolean по умолчанию: true

Если вы хотите, чтобы поле было проигнорировано про чтении или записи в него объекта, вы можете установить опцию mapped, как false.

Дата обновления перевода 2025-02-24

method

тип: string по умолчанию: POST

Эта опция указывает HTTP-метод, использованный для отправки данных формы. Его значение отображается, как атрибут method элемента form и используется для того, чтобы решить, обрабатывать ли отправку формы в методе handleRequest() после её отправки. Возможные значения:

  • POST
  • GET
  • PUT
  • DELETE
  • PATCH

Note

Когда метод - PUT, PATCH, или DELETE, Symfony автоматически отобразит скрытое поле _method в вашей форме. Это используется для "подделывания" HTTP-методов, так как они не поддерживаются в стандартных браузерах. Это может быть полезно при использовании требований маршрутизации метода.

Note

Метод PATCH позволяет отправку частичных данных. Другими словами, если в данных отправленной формы отсутствуют определённые поля, то они будут проигнорированы, и будут использованы (если нужно) значения по умолчанию. Со всеми другими HTTP-методами, если в данных отправленной формы отсутствуют некоторые поля, то эти поля устаналиваются, как null.

Дата обновления перевода 2025-02-24

post_max_size_message

тип: string по умолчанию: Загруженный файл был слишком большой. Пожалуйста, попробуйте загрузить файл поменьше.

Это сообщение ошибки валидации, которое используется, если данные формы POST превышают директиву post_max_size php.ini. Заполнитель {{ max }} может быть использован, чтобы отобразить разрешённый размер.

Note

Валидация post_max_size происходит только в корневой форме.

Дата обновления перевода 2025-02-24

property_path

тип: PropertyPathInterface|string|null по умолчанию: null

Поля отображают значение свойства объекта домена формы по умолчанию. Когда форма отправлена, отправленное значение записывается обратно в объект.

Если вы хотите переопределить свойство, из которого считывает и в которое записывает поле, то вы можете установить опцию property_path. Её значение по умолчанию - (null) - будет использовать имя поля в качестве свойства.

Дата обновления перевода 2023-09-25

required

тип: boolean по умолчанию: true

Если "true", то будет отображён обязательный атрибут HTML5. Соответствующий label также отобразится с классом required.

Эта опция внешняя и не зависит от валидации. В лучшем случае, если вы позволите Symfony отгадать ваш тип поля, тогда значение этой опции будет угадано из вашей информации о валидации.

Note

Обязательная опция также влияет на то, как будут обработаны пустые данные для каждого поля. Чтобы узнать больше, см. опцию empty_data.

setter

тип: callable по умолчанию: null

Если предоставлено, это вызываемое будет вызвано, чтобы отобразить значение формы обратно в основоположный объект.

Больше деталей доступно в разделе в Как и когда использовать отображатели данных.

Дата обновления перевода 2025-02-22

trim

тип: boolean по умолчанию: true

Если "true", то свободное пространство значения отправленной строки будет отделено с помощью функции trim, если данные привязаны. Это гарантирует, что если значение отправлено с лишними свободными пространствами, они будут удалены до того, как значение будет опять объединено с объектом, лежащим в основе.

Дата обновления перевода 2024-07-26

validation_groups

тип: array, string, callable, GroupSequence или null по умолчанию: null

Эта опция валидна только для корневой формы и используется, чтобы указать, какие группы будут использоваться валидатором.

Для null валидатор будет использовать группу Default.

Если вы укажете группы в виде массива или строки, они будут использованы валидатором как они есть:

1
2
3
4
5
6
public function configureOptions(OptionsResolver $resolver): void
{
    $resolver->setDefaults([
        'validation_groups' => 'Registration',
    ]);
}

Это эквивалентно передаче группы как массива:

1
'validation_groups' => ['Registration'],

Данные формы будут валидированы со всеми заданными группами.

Если группы валидации зависят от данных формы, можно передать вызываемое к опции. Тогда Symfony передаст форме при её вызове:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
use Symfony\Component\Form\FormInterface;
use Symfony\Component\OptionsResolver\OptionsResolver;

// ...
public function configureOptions(OptionsResolver $resolver): void
{
    $resolver->setDefaults([
        'validation_groups' => function (FormInterface $form): array {
            $entity = $form->getData();

            return $entity->isUser() ? ['User'] : ['Company'];
        },
    ]);
}

Note

Если ваша форма содержит несколько кнопок отправки, вы можете изменить группу валидации в зависимости от того, какая кнопка используется для отправки формы.

Если вам нужна продвинутая логика для определения групп валидации, посмотрите на Как динамически конфигурировать группы валидации форм.

В некоторых случаях вы захотите валидировать группы шаг за шагом. Для этого вы можете передать GroupSequence этой опции. Это позволит вам выполнять валидацию с несколькими группами, подобно тому, как вы передаёте несколько групп в массиве, но с той разницей, что группа будет валидирована, только если предыдущие группы прошли валидацию без ошибок. Вот пример:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
use Symfony\Component\Form\AbstractType;
use Symfony\Component\Validator\Constraints\GroupSequence;
// ...

class MyType extends AbstractType
{
    // ...
    public function configureOptions(OptionsResolver $resolver): void
    {
        $resolver->setDefaults([
            'validation_groups' => new GroupSequence(['First', 'Second']),
        ]);
    }
}

See also

Прочитайте статью Как применять группы валидации последовательно, чтобы узнать больше об этом.

Наследуемые опции

Следующие опции определены в классе BaseType. Класс BaseType - это родительский класс и для типа form, и для ButtonType, но это не часть дерева типа формы (т.е. не может быть использован в качетсве типа формы сам по себе).

Дата обновления перевода 2025-02-21

attr

тип: array по умолчанию: []

Если вы хотите добавить дополнительные атрибуты к HTML представлению поля, то вы можете использовать опцию attr. Это ассоциативный массив с HTML-атрибутами в качестве ключей. Этоможет быть полезно, когда вам нужно установить для некоторого виджета пользовательский класс:

1
2
3
$builder->add('body', TextareaType::class, [
    'attr' => ['class' => 'tinymce'],
]);

See also

Используйте опцию row_attr, если вы хотите добавить эти атрибуты к к элементу строки типа формы

Дата обновления перевода 2025-02-21

auto_initialize

тип: boolean по умолчанию: true

Внутренняя опция: устаналивает то, должна ли форма быть инициализирована автоматически. Из всех полей эта опция должна быть true лля корневых форм. Вам не нужно менять эту опцию и скорее всего не придётся о ней беспокоиться.

Дата обновления перевода 2025-02-21

block_name

тип: string по умолчанию: имя формы (см. Как узнать, какой блок настраивать )

Позволяет вам переопределить имя блока, используемого для отображения типа формы. Полезна, например, если у вас есть несколько экземпляров одной и той же формы, и вам нужно персонализировать отображения форм индивидуально.

Если вы, например, установите эту опцию как my_custom_name и поле будет иметь тип text, Symfony будет использовать следующие имена (и в этом порядке), чтобы найти блок, используемый для отображения виджета поля: _my_custom_name_widget, text_widget и form_widget.

Дата обновления перевода 2025-02-22

block_prefix

тип: string или null по умолчанию: null (см. Как знать, какой блок настраивать )

Позволяет добавить пользовательский префикс блока и переопределить имя блока. используемого для отображения типа формы. Полезно, например, если у вас есть несколько экземпляров одной и той же формы, и вам нужно персонализировать отображение каждого из них, без необходимости создавать новый тип формы.

Дата обновления перевода 2025-02-24

disabled

тип: boolean по умолчанию: false

Если вы не хотите, чтобы пользователь изменял значение поля, то вы можете установить опцию отключения, как "true". Любые отправленные данные будут проигнорированы.

Дата обновления перевода 2023-01-12

label

тип: string или TranslatableMessage по умолчанию: Ярлык "угадывается" из имени поля

Устанавливает ярлык, который будет использован при отображении поля. Установка, как "false" подавит ярлык:

1
2
3
4
5
6
7
8
use Symfony\Component\Translation\TranslatableMessage;

$builder
    ->add('zipCode', null, [
        'label' => 'The ZIP/Postal code',
        // по желанию, вы можете использовать объекты TranslatableMessage как содержание ярлыка
        'label' => new TranslatableMessage('address.zipCode', ['%country%' => $country], 'address'),
    ])

Ярлык также может быть установлен внутри шаблона:

1
{{ form_label(form.name, 'Your name') }}

Дата обновления перевода 2025-02-24

label_html

тип: boolean по умолчанию: false

По умолчанию, содержание опции label экранируется перед отображением в шаблоне. Установите для этой опции значение true, чтобы не экранировать ее, что может быть полезно, когда ярлык содержит HTML-элементы.

Дата обновления перевода 2025-02-24

row_attr

тип: array по умолчанию: []

Ассоциативный массив атрибутов HTML, добавляемых к элементу, который используется для отображения строки типа формы :

1
2
3
$builder->add('body', TextareaType::class, [
    'row_attr' => ['class' => 'text-editor', 'id' => '...'],
]);

See also

Используйте опцию attr, если вы хотите добавить эти атрибуты к к элементу виджета типа формы .

Дата обновления перевода 2025-02-22

translation_domain

тип: string, null или false по умолчанию: null

Это домен перевода, который будет использован для любого ярлыка или опции, отображённых для этого поля. Используйте null, чтобы повторно использовать домен перевода в родительскойформе (или домен переводчика по умолчанию для корневой формы). Испльзуйте false, чтобы отключить переводы.

Дата обновления перевода 2025-02-24

label_translation_parameters

тип: array по умолчанию: []

Содержание опции label переводится перед отображением, поэтому она может содержать заместители перевода. Эта опция определяет значения, используемые для замены этих заполнителей.

Учитывая это сообщение перевода:

1
2
# translations/messages.en.yaml
form.order.id: 'Identifier of the order to %company%'

Вы можете указать значения заполнителей следующим образом:

1
2
3
4
5
6
$builder->add('id', null, [
    'label' => 'form.order.id',
    'label_translation_parameters' => [
        '%company%' => 'ACME Inc.',
    ],
]);

Опция label_translation_parameters дочерних полей объединяется с аналогичной опцией их родителей, поэтому дочерние поля могут повторно использовать и/или переопределять любые родительские заполнители.

attr_translation_parameters

type: array default: []

The content of the title and placeholder values defined in the attr option is translated before displaying it, so it can contain translation placeholders. This option defines the values used to replace those placeholders.

Given this translation message:

1
2
3
# translations/messages.en.yaml
form.order.id.placeholder: 'Enter unique identifier of the order to %company%'
form.order.id.title: 'This will be the reference in communications with %company%'

You can specify the placeholder values as follows:

1
2
3
4
5
6
7
8
9
$builder->add('id', null, [
    'attr' => [
        'placeholder' => 'form.order.id.placeholder',
        'title' => 'form.order.id.title',
    ],
    'attr_translation_parameters' => [
        '%company%' => 'ACME Inc.',
    ],
]);

The attr_translation_parameters option of children fields is merged with the same option of their parents, so children can reuse and/or override any of the parent placeholders.

Дата обновления перевода 2025-02-24

priority

тип: integer по умолчанию: 0

Поля отображаются в том же порядке, в котором они включены в форму. Эта опция изменяет приоритет отображения полей, позволяя отображать поля раньше или позже их первоначального порядка.

Эта опция влияет только на порядок просмотра. Чем выше этот приоритет, тем
раньше будет отображаться поле. Приоритет также может быть отрицательным, а поля

с одинаковым приоритетом сохранят свой первоначальный порядок.