Version

Documentation » Admin

2. KnpMenu »

« 10. Preview Mode

1. Select2

The admin comes with select2 integration since version 2.2.6. Select2 is a jQuery based replacement for select boxes. It supports searching, remote data sets, and infinite scrolling of results.

The select2 is enabled on all select form elements by default.

1.1. Disable select2

If you don’t want to use select2 in your admin, you can disable it in config.yml.

  • YAML
    # app/config/config.yml
    
    sonata_admin:
        options:
            use_select2:    false # disable select2
    

Note

If you disable select2, autocomplete form types will stop working.

1.2. Disable select2 on some form elements

To disable select2 on some select form element, set data attribute data-sonata-select2 = "false" to this form element.

public function configureFormFields(FormMapper $formMapper)
{
    $formMaper
        ->add('category', 'sonata_type_model', array(
            'attr' => array(
                'data-sonata-select2' => 'false'
            )
        ))
    ;
}

Note

You have to use false as string! "false"!

1.3. AllowClear

Select2 parameter allowClear is handled automatically by admin. But if you want to overload the default functionality, you can set data attribute data-sonata-select2-allow-clear="true" to enable allowClear or data-sonata-select2-allow-clear = "false" to disable the allowClear parameter.

public function configureFormFields(FormMapper $formMapper)
{
    $formMapper
        ->add('category', 'sonata_type_model', array(
            'attr' => array(
                'data-sonata-select2-allow-clear' => 'false'
            )
        ))
    ;
}

Note

You have to use false as string! "false"!

Found a typo? Something is wrong in this documentation? Just fork and edit it!