73 lines
1.9 KiB
ReStructuredText
73 lines
1.9 KiB
ReStructuredText
Select2
|
|
=======
|
|
|
|
The admin comes with `select2 <http://ivaynberg.github.io/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.
|
|
|
|
Disable select2
|
|
---------------
|
|
|
|
If you don't want to use select2 in your admin, you can disable it in ``config.yml``.
|
|
|
|
.. configuration-block::
|
|
|
|
.. code-block:: yaml
|
|
|
|
# app/config/config.yml
|
|
|
|
sonata_admin:
|
|
options:
|
|
use_select2: false # disable select2
|
|
|
|
.. note::
|
|
|
|
If you disable select2, autocomplete form types will stop working.
|
|
|
|
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.
|
|
|
|
.. code-block:: php
|
|
|
|
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"``!
|
|
|
|
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.
|
|
|
|
.. code-block:: php
|
|
|
|
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"``! |