invalid_message

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

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

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

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

years

тип: array по умолчанию: 120 лет назад от текущего года

Список годов, доступных в типе поля год. Эта опция имеет значение только когда опция widget установлена, как choice.

days

тип: array по умолчанию: от 1 до 31

Список дней, доступных в типе поля день. Эта опция применима только тогда когда опция widget установлена, как choice:

1

'days' => range(1,31)

placeholder

тип: string | array

Если ваша оцпия виджета установлена, как choice, то это поле будет представлено как набор полей выбора select. Когда значение заполнителя является строкой, оно будет использовано в качестве пустого значения всех полей выбора:

1
2
3

$builder->add('birthdate', BirthdayType::class, array(
    'placeholder' => 'Select a value',
));

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

1
2
3
4
5

$builder->add('birthdate', BirthdayType::class, array(
    'placeholder' => array(
        'year' => 'Year', 'month' => 'Month', 'day' => 'Day',
    )
));

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

format

тип: integer или string по умолчанию: IntlDateFormatter::MEDIUM (или yyyy-MM-dd если widget - single_text)

Опция, переданная классу IntlDateFormatter, используется для преобразования ввода пользователя в правильный формат. Это критично, когда опция widget устанвлена, как single_text и будет определять, как пользователь будет вводить данные. По умолчанию, формат определяется, основываясь на локали текущего пользователя: это означает, что ожидаемый формат будет отличаться для разных пользователей. Вы можете переопределить это, передав формат в качестве строки.

Чтобы узнать больше о валидных форматах, см. Синтаксис формата Date/Time:

1
2
3
4
5
6
7
8

use Symfony\Component\Form\Extension\Core\Type\DateType;
// ...

$builder->add('dateCreated', DateType::class, [
    'widget' => 'single_text',
    // Это на самом деле формат по умолчанию для single_text
    'format' => 'yyyy-MM-dd',
));

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

input

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

Формат данных ввода - т.е. формат, в котором хранятся данные вашего исходного объекта. Валидные значения:

• string (например, 2011-06-05)
• datetime (объект DateTime)
• datetime_immutable (объект DateTimeImmutable)
• array (например, array('year' => 2011, 'month' => 06, 'day' => 05))
• timestamp (например, 1307232000)

Значение, которое возвращается из формы, также будет нормализовано обратно в этот формат.

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

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

input_format

тип: string по умолчанию: Y-m-d

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

Если опция input установлена как string, эта опция указывает формат даты. Это должно быть валидным PHP-форматом даты.

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

model_timezone

тип: string по умолчанию: часовой пояс системы по умолчанию

Часовой появ, в котором хранятся данные вода. Это должен быть один из часовых поясов, поддерживаемых PHP.

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

months

тип: array по умолчанию: от 1 до 12

Список месяцев, доступных типу поля месяц. Эта опция применима только когда опция widget установлена, как choice.

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

view_timezone

тип: string по умолчанию: часовой пояс системы по умолчанию

Часовой пояс для отображения данных пользователю (а следовательно и данных, которые отправляет пользователь). Это должен быть один из часовых поясов, поддерживаемых PHP.

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

widget

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

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

Основной способ, которым должно быть отображено это поле. Может быть одним из следующих:

• choice: отображает три ввода выбора. Порядок вариантов определяется опцией format.
• text: отображает три поля ввода типа text (месяц, день, год).
• single_text: отображает один ввод типа date. Пользовательский ввод валидируется, основываясь на опции format.

Эти опции наследуются из FormType:

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

attr

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

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

1
2
3

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

Дата обновления перевода 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',
));

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

disabled

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

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

Дата обновления перевода 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-05

inherit_data

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

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

Дата обновления перевода 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

mapped

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

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

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

row_attr

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

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

1
2
3

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