attr

тип: array за замовчуванням: array()

Якщо ви хочете додати додаткові атрибути до HTML-представлення кнопки, ви можете використати опцію attr. Це асоціативний масив із HTML-атрибутом в якості ключа. Це може бути корисно, коли вам потрібно встановити для кнопки користувацький клас:

1
2
3
4
5
6

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

$builder->add('save', ResetType::class, [
    'attr' => ['class' => 'save'],
]);

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

disabled

тип: boolean за замовчуванням: false

Якщо ви не хочете, щоб користувач міг натискати на кнопку, ви можете встановити опцію відключення, як "true". Надіслати форму без цієї кнопки буде неможливо, навіть шляхом обходу браузера і надсилання запиту вручну, наприклад, за допомогою cURL.

Дата оновлення перекладу 2024-05-29

label

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

Дозволяє задати ярлик, який буде відображатися на кнопці. Ярлик також можна встановити безпосередньо всередині шаблону:

1

{{ form_widget(form.save, { 'label': 'Click me' }) }}

1

<?= $view['form']->widget($form['save'], ['label' => 'Click me']) ?>

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

translation_domain

тип: string за замовчуванням: messages

Це домен перекладу, який буде використано для будь-яких ярликів або опцій,
які відображаються для цієї кнопки.

label_translation_parameters

тип: array за замовчуванням: []

Зміст опції label перекладається перед відображенням, тому вона може містити заповнювачі перекладу . Ця опція визначає значення, що використовуються для заміни цих заповнювачів.

Враховуючи це повідомлення перекладу:

1
2

# translations/messages.en.yaml
form.order.reset: 'Reset an order to %company%'

Ви можете вказати значення заповнювача таким чином:

1
2
3
4
5
6
7
8
9

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

$builder->add('send', ResetType::class, [
    'label' => 'form.order.reset',
    '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

row_attr

тип: array за замовчуванням: []

Асоціативний масив атрибутів HTML, що додаються до елементу, який використовується для відображення рядка типу форми :

1
2
3

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