Поле IntegerType
Дата оновлення перекладу 2025-01-15
Поле IntegerType
Відображає поле введення "числа". По суті, це текстове поле, яке гарно справляється
з обробкою даних у формі цілих чисел. Поле введення number
виглядає як текстове
поле, окрім того, що якщо браузер користувача підтримує HTML5, воно матиме деяку
додаткову функціональність фронтенду.
Це поле має різні опції для обробки значень введення, які не є цілими числами. За замовчуванням, всі значення не цілого числа (наприклад, 6.78) будуть округлені в меншу сторону (наприклад, 6).
?????????????? ?? | ???? input file |
???????????? ???????????? ?? ????????????? | ???? ?????, ??????? ???? ?????. |
???????????? ??? | FormType |
???? | IntegerType |
Дата оновлення перекладу 2025-02-21
Tip
Повний список опцій, визначених та успадкованих цим типом форми, доступний шляхом виконання цієї команди у вашому додатку:
1 2
# замініть 'FooType' імʼям класу вашого типу форми
$ php bin/console debug:form FooType
Опції поля
Дата оновлення перекладу 2025-02-24
grouping
тип: integer
за замовчуванням: false
Це значення використовується внутрішньо, як значення NumberFormatter::GROUPING_USED
при використанні класу NumberFormatter
. Його документації не існує, але
схоже, що якщо ви встановите це як true
, то числа будуть згруповані з
комою або крапкою (залежно від вашої локалі): 12345.123
буде відображатися
як 12,345.123
.
rounding_mode
тип: integer
за замовчуванням: \NumberFormatter::ROUND_DOWN
За замовчуванням, якщо користувач вводить не ціле число, воно буде округлене в меншу сторону. Ви маєте декілька конфігурованих опцій для цього округлення. Кожна опція є константою класу NumberFormatter:
\NumberFormatter::ROUND_DOWN
Округлити в сторону нуля. Округлює1.4
до1
, а-1.4
- до-1
.\NumberFormatter::ROUND_FLOOR
Округлити в сторону відʼємної безкінечності. Округлює1.4
до1
, а-1.4
- до-2
.\NumberFormatter::ROUND_UP
Округллити в сторону від нуля. Округлює1.4
до2
, а-1.4
- до-2
.\NumberFormatter::ROUND_CEILING
Округлити в сторону позитивної безкінечності. Округлює1.4
до2
, а-1.4
- до-1
.\NumberFormatter::ROUND_HALFDOWN
Округлити в сторону "найближчого сусіда". Якщо обидва суіди рівновіддалені, округлити в меншу сторону. Округлює2.5
та1.6
до2
, а1.5
та1.4
- до1
.\NumberFormatter::ROUND_HALFEVEN
Округлити в сторону "найближчого сусіда". Якщо обидва суіди рівновіддалені, округлити в сторону парного числа. Округлює2.5
,1.6
та1.5
до2
, а1.4
- до1
.\NumberFormatter::ROUND_HALFUP
Округлити в сторону "найближчого сусіда". Якщо обидва суіди рівновіддалені, округлити в більшу сторону. Округлює2.5
до3
,1.6
та1.5
- до2
, а1.4
- до1
.
Перевизначені опції
Дата оновлення перекладу 2025-02-22
compound
тип: boolean
за замовчуванням: false
Ця опція вказує, чи містить тип дочірні типи. Ця опція управляється внутрішньо для вбудованих типів, так що нема необхідності конфігурувати її явно.
Дата оновлення перекладу 2025-02-24
invalid_message
тип: string
за замовчуванням: Це значення не є валідним значение не валидно
Це повідомлення помилки валідації, яке використовується, якщо дані, введені у це поле, не мають сенсу (тобто валідація проходить невдало).
Це може трапитися, наприклад, якщо користувач вводить у поле
TimeType асбурдний рядок, який
не може бути конвертований в даний час, або якщо користувач вводить
рядок (наприклад, apple
) у числове поле.
Нормальна (програмний код) валідація (наприклад, встановлення мінімальної довжини для поля), має бути встановлена з використанням повідомлень валідації з вашими правилами валідації (довідник ).
Успадковані опції
Ці опції наслідуються з FormType:
Дата оновлення перекладу 2025-02-21
attr
тип: array
за замовчуванням: []
Якщо ви хочете додати додаткові атрибути до HTML представлення поля, то
ви можете використовувати опцію attr
. Це асоціативний масив із HTML-атрибутами
в якості ключів. Це може бути корисно, коли вам потрібно встановити для деякого
віджета користувацький клас:
1 2 3
$builder->add('body', TextareaType::class, [
'attr' => ['class' => 'tinymce'],
]);
See also
Використовуйте опцію row_attr
, якщо ви хочете додати ці атрибути до
елементу рядку типу форми .
Дата оновлення перекладу 2025-01-15
data
тип: mixed
за замовчуванням: За замовчуванням - поле вихідної структури.
Коли ви створюєте форму, кожне поле спочатку відображає значення
відповідної властивості доменних даних форми (наприклад, якщо ви прив'язуєте об'єкт
до форми). Якщо ви хочете замінити це початкове значення для форми або окремого поля,
ви можете задати його в опції даних:
1 2 3 4 5 6
use Symfony\Component\Form\Extension\Core\Type\HiddenType;
// ...
$builder->add('token', HiddenType::class, [
'data' => 'abcdef',
]);
Warning
Опція data
завжди перевизначає значення, взяте з даних домену
(об'єкта) під час відображення. Це означає, що значення об'єкта також перевизначається,
коли форма редагує вже збережений об'єкт, що призводить до втрати
збереженого значення, коли форма буде відправлена.
Дата обновления перевода 2025-02-24
disabled
тип: boolean
по умолчанию: false
Если вы не хотите, чтобы пользователь изменял значение поля, то вы можете установить опцию отключения, как "true". Любые отправленные данные будут проигнорированы.
Дата оновлення перекладу 2025-02-24
empty_data
тип: mixed
Значення за замовчуванням - ''
(порожній рядок).
Дата оновлення перекладу 2025-01-15
Ця опція визначає, яке значення буде повертати поле, коли надіслане значення значення порожнє (або відсутнє). Вона не встановлює початкове значення, якщо його не було надано при відображенні форми у перегляді.
Це означає, що вона допомагає вам обробляти відправлення форм з порожніми полями.
Наприклад, якщо ви хочете, щоб для поля 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
Дата оновлення перекладу 2022-12-21
Якщо true
, будь-які помилки цього поля будуть передані батьківському полю
або формі. Наприклад, якщо встановлено true
у нормальному полі, будь-які
помилки цього поля будуть прикріплені до головної форми, а не до конкретного
поля.
Дата оновлення перекладу 2024-05-30
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',
],
]);
Дата оновлення перекладу 2024-05-30
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
invalid_message_parameters
тип: array
за замовчуванням: []
При встановленні опції invalid_message
вам може знадобитися включити в рядок деякі
змінні. Це можна зробити, додавши заповнювачі в цю опцію, та включивши змінні в цій
опції:
1 2 3 4
$builder->add('someField', SomeFormType::class, [
// ...
'invalid_message' => 'Ви ввели невалідне значення, воно має містити %num% літер',
'invalid_message_parameters' => ['%num%' => 6],
Дата оновлення перекладу 2022-12-21
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_attr
тип: array
за замовчуванням: []
Встановлює HTML-атрибути для елемента <label>
, який буде використаний
при відображенні ярлика для поля. Це асоціативний масив із HTML-атрибутом в
якості ключа. Цей атрибут може також бути встановлений прямо всередині шаблону:
1 2 3
{{ form_label(form.name, 'Your name', {
'label_attr': {'class': 'CUSTOM_LABEL_CLASS'}
}) }}
Дата оновлення перекладу 2025-02-24
label_html
тип: boolean
за замовчуванням: false
За замовчуванням, зміст опції label
екранується перед відображенням
у шаблоні. Встановіть для цієї опції значення true
, щоб не екранувати
її, що може бути корисно, коли ярлик містить HTML-елементи.
Дата оновлення перекладу 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
.
Дата оновлення перекладу 2023-09-25
required
тип: boolean
за замовчуванням: true
Якщо значення true, буде відображено обов'язковий атрибут HTML5. Відповідний
label
також буде відображено з класом required
.
Це поверхнево і не залежить від валідації. У кращому випадку, якщо ви дозволите Symfony вгадати тип вашого поля, то значення цієї опції буде вгадано з вашої інформації валідації.
Note
Обов'язкова опція також впливає на те, як будуть оброблятися порожні дані для кожного поля. Для більш детальної інформації дивіться опцію empty_data.
Дата оновлення перекладу 2025-02-24
row_attr
тип: array
за замовчуванням: []
Асоціативний масив атрибутів HTML, що додаються до елементу, який використовується для відображення рядка типу форми :
1 2 3
$builder->add('body', TextareaType::class, [
'row_attr' => ['class' => 'text-editor', 'id' => '...'],
]);
See also
Використовуйте опцію attr
, якщо ви хочете додати ці атрибути до
елементу віджета типу форми .