Actualización

vendor/sonata-project/admin-bundle/Resources/doc/cookbook/recipe_select2.rst

@@ -0,0 +1,73 @@
+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"``!