26

I have not found any easy way to accomplish to simply check a Checkbox by default. That can not be that hard, so what am i missing?

14 Answers 14

50

You can also just set the attr attribute in the form builder buildForm method:

$builder->add('isPublic', CheckboxType::class, array(
    'attr' => array('checked'   => 'checked'),
));
Sign up to request clarification or add additional context in comments.

4 Comments

works for me, I am looking now for the same thing but for a radiobutton
That's interesting. You are telling symfony to add checked="checked" to the attributes of the checkbox, rather than telling symfony that the value of the checkbox is true and that it should therefore be adding checked="checked" itself.
Simple and efficient solution for Symfony 3. Many thanks !
Won't work if you want to use the form for editing an entity, too. A value of "false" will still have a "checked" attribute. Sgoettschkes' solution is better
26

In Symfony >= 2.3 "property_path" became "mapped".

So:

$builder->add('checkboxName', 'checkbox', array('mapped' => false,
    'label' => 'customLabel',
    'data' => true, // Default checked
));

Comments

21

You would simply set the value in your model or entity to true and than pass it to the FormBuilder then it should be checked.

If you have a look at the first example in the documentation:

A new task is created, then setTask is executed and this task is added to the FormBuilder. If you do the same thing with your checkbox

$object->setCheckboxValue(true);

and pass the object you should see the checkbox checked.

If it's not working as expected, please get back with some sample code reproducing the error.

2 Comments

Well, i already do set a value of the form this way, but I was simply too focused on finding an attribute to set the checkbox that I did not even thought in this direction. Thanks for the fast and perfect answer, solved the problem!
+1 - Another way, if true/checked is the default value for any new entity, is simply to set the value in the __construct()-method like: public function __construct() { $this->attribute = true; }.
16

Setting the 'data' option works for me. I'm creating a non entity based form:

$builder->add('isRated','checkbox', array(
    'data' => true
));

2 Comments

In Symfony 2.8, this doesn't work if the model has an explicit false value when creating the form. The checkbox would still be checked.
Yes, thanks Peter. Any idea on what will work in Symfony >=2.8?
10

In TWIG

If you wish to do this in the template directly:

{{ form_widget(form.fieldName, { 'attr': {'checked': 'checked'} }) }}

1 Comment

In this way the checkbox is impossible to uncheck
5

Use the FormBuilder::setData() method :

$builder->add('fieldName', 'checkbox', array('property_path' => false));
$builder->get('fieldName')->setData( true );

"property_path" to false cause this is a non-entity field (Otherwise you should set the default value to true using your entity setter).

Checkbox will be checked by default.

Comments

5

To complete a previous answer, with a multiple field you can do that to check all choices :

   'choice_attr' => function ($val, $key, $index) {
       return ['checked' => true];
   }

https://symfony.com/doc/3.3/reference/forms/types/choice.html#choice-attr

Comments

2

You should make changes to temporary object where entity is stored before displaying it on form. Something like next:

<?php

namespace KPI\AnnouncementsBundle\Form;

use Symfony\Component\Form\AbstractType;
use Symfony\Component\Form\FormBuilderInterface;
use Symfony\Component\OptionsResolver\OptionsResolverInterface;

class AnnouncementType extends AbstractType
{
    public function buildForm(FormBuilderInterface $builder, array $options)
    {  
        // ...        

        if ($options['data']->getDisplayed() === null) {
            $options['data']->setDisplayed(true);
        }

        // ...

        $builder
            ->add('displayed', 'checkbox', array(
                'required' => false
            ));
    }
}

Comments

1

As per documentation: http://symfony.com/doc/current/reference/forms/types/checkbox.html#value

To make a checkbox or radio button checked by default, use the data option.

1 Comment

But be aware that in the cases when you are showing the already existing object (with possibly this value NOT checked), your 'data' = true would still force it to be shown as checked. From the same doc page: "The data option always overrides the value taken from the domain data (object) when rendering. This means the object value is also overriden when the form edits an already persisted object, causing it to lose its persisted value when the form is submitted."
1
UserBundle\Entity\User

let's assume that you have an entity called ( User ) and it has a member named isActive, You can set the checkbox to be checked by default by setting up isActive to true:

$user = new User();

// This will set the checkbox to be checked by default
$user->setIsActive(true);

// Create the user data entry form
$form = $this->createForm(new UserType(), $user);

Comments

1

I had the same problem as you and here is the only solution I found:

$builder->addEventListener(FormEvents::PRE_SET_DATA, function (FormEvent $event) {
    $entity= $event->getData();
    $form = $event->getForm();
    $form->add('active', CheckboxType::class, [
        'data' => is_null($entity) ? true : $entity->isActive(),
    ]);
});

Comments

0

This works as well, but aware of persistent "checked" state

$builder->add('isPublic', 'checkbox', array(
    'empty_data' => 'on',
));

2 Comments

This solutions works for new AND edit ; from symfony2.3 to 4+ ; and is brilliantly simple! many thanks @stanislav ; The only modification I have (symfony 2.8) is to use CheckboxType::class instead of 'checkbox'
symfony 4: this option determines what value the field will return when the submitted value is empty (or missing). It does not set an initial value if none is provided when the form is rendered in a view.
0

This is how you can define the default values for multiple and expanded checkbox fields. Tested in Symfony4, but it has to work with Symfony 2.8 and above.

if you want to active the 1st and the 2nd checkboxes by default

class MyFormType1 extends AbstractType
{
    CONST FIELD_CHOICES = [
        'Option 1' => 'option_1',
        'Option 2' => 'option_2',
        'Option 3' => 'option_3',
        'Option 4' => 'option_4',
        'Option 5' => 'option_5',
    ];

    public function buildForm(FormBuilderInterface $builder, array $options)
    {

        $this->addSettingsField('my_checkbox_field', ChoiceType::class, [
            'label'    => 'My multiple checkbox field',
            'choices'  => self::FIELD_CHOICES,
            'expanded' => true,
            'multiple' => true,
            'data'     => empty($builder->getData()) ? ['option_1', 'option_2'] : $builder->getData(),
        ]);

    }
}

if you want to active every checkbox by default

class MyFormType2 extends AbstractType
{
    CONST FIELD_CHOICES = [
        'Option 1' => 'option_1',
        'Option 2' => 'option_2',
        'Option 3' => 'option_3',
        'Option 4' => 'option_4',
        'Option 5' => 'option_5',
    ];

    public function buildForm(FormBuilderInterface $builder, array $options)
    {

        $this->addSettingsField('my_checkbox_field', ChoiceType::class, [
            'label'    => 'My multiple checkbox field',
            'choices'  => self::FIELD_CHOICES,
            'expanded' => true,
            'multiple' => true,
            'data'     => empty($builder->getData()) ? array_values(self::FIELD_CHOICES) : $builder->getData(),
        ]);

    }
}

Comments

0

The only watertight solution for me in Symfony 4, 2022 is:

OPTION 1:

First, set it default to "true" on the entity parameter itself:

class MyEntity {
    /**
     * @ORM\Column(name="my_param", type="boolean", nullable=true)
     */
    private $myParameter = true;

    ...
}

Secondly, in the form, first see if you can get it from the entity itself. If Not, set the default

public function buildForm(FormBuilderInterface $builder, array $options)
{
    /** @var MyEntity $entity */
    $entity = $builder->getData();

    $builder->add('myParameter', CheckboxType::class, [
        'required' => false,
        'data' => $entity ? $entity->getMyParameter() : true,
    ]);
}

This way the real value (coming from the database) has precedence over the default value.
Also good to know is: Submitted data has precedence over the 'data' => true but initially loaded data before submit gets overridden by 'data' => true

OPTION 2:

An alternative way of setting it default true on the MyEntity Class you can choose to set it as default only just before creating the form. But then you always need the object to create the form with. So you then may not create a form without a given object

if (empty($entity)) {
    // Warning: Only if it's a new object, set the default
    $entity = new MyEntity();
    $entity->setMyParameter(true);
}

// For this option you must always give the form an entity
$form = $this->createForm(MyType::class, $entity);
$form->handleRequest($request);

So for this option you don't need to do anything special in the FormType

$builder->add('myParameter', CheckboxType::class, [
    'required' => false,
]);

1 Comment

This is answer is assuming the form is directly mapped to an entity class, but that is not stated in the question.

Your Answer

By clicking “Post Your Answer”, you agree to our terms of service and acknowledge you have read our privacy policy.

Start asking to get answers

Find the answer to your question by asking.

Ask question

Explore related questions

See similar questions with these tags.