Поле 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'];
},
]);
}
See also
Вы можете прочитать больше об этом в Как выбирать группы валидации, основанные на отправленных данных.
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
Поля отображаются в том же порядке, в котором они включены в форму. Эта опция изменяет приоритет отображения полей, позволяя отображать поля раньше или позже их первоначального порядка.
- Эта опция влияет только на порядок просмотра. Чем выше этот приоритет, тем
- раньше будет отображаться поле. Приоритет также может быть отрицательным, а поля
с одинаковым приоритетом сохранят свой первоначальный порядок.