From 048cc8f656c71c26276a72fe6ca546f6dcb2bf3c Mon Sep 17 00:00:00 2001
From: Kirill Matasov <33geek@gmail.com>
Date: Fri, 28 Aug 2020 01:00:56 +0300
Subject: [PATCH] Update docs

---
 docs/reference/form_types.rst | 49 +++++++++++++++++++++++++----------
 1 file changed, 35 insertions(+), 14 deletions(-)

diff --git a/docs/reference/form_types.rst b/docs/reference/form_types.rst
index 814f4e5a5b..fe356c68cb 100644
--- a/docs/reference/form_types.rst
+++ b/docs/reference/form_types.rst
@@ -267,20 +267,41 @@ The available options are:
 
   From the ``$admin`` parameter it is possible to get the ``Datagrid`` and the ``Request``::
 
-    $formMapper
-        ->add('category', ModelAutocompleteType::class, [
-            'property' => 'title',
-            'callback' => function ($admin, $property, $value) {
-                $datagrid = $admin->getDatagrid();
-                $queryBuilder = $datagrid->getQuery();
-                $queryBuilder
-                    ->andWhere($queryBuilder->getRootAlias() . '.foo=:barValue')
-                    ->setParameter('barValue', $admin->getRequest()->get('bar'))
-                ;
-                $datagrid->setValue($property, null, $value);
-            },
-        ])
-    ;
+      $formMapper
+          ->add('category', ModelAutocompleteType::class, [
+              'property' => 'title',
+              'callback' => static function (AdminInterface $admin, string $property, $value): void {
+                  $datagrid = $admin->getDatagrid();
+                  $queryBuilder = $datagrid->getQuery();
+                  $queryBuilder
+                      ->andWhere($queryBuilder->getRootAlias() . '.foo=:barValue')
+                      ->setParameter('barValue', $admin->getRequest()->get('bar'))
+                  ;
+                  $datagrid->setValue($property, null, $value);
+              },
+          ])
+      ;
+
+  If you want to dynamically change the ``property`` being filtered on to something else,
+  you can use a prefix system, as follows.
+  When the user types **id: 20** the property used for filtering is "id".
+  When they type **username: awesome_user_name**, it will be "username"::
+
+      $formMapper
+          ->add('category', ModelAutocompleteType::class, [
+              'property' => 'title',
+              'callback' => static function (AdminInterface $admin, string $property, string $value): void {
+                  $datagrid = $admin->getDatagrid();
+
+                  $valueParts = explode(':', $value);
+                  if (count($valueParts) === 2 && in_array($valueParts[0], ['id', 'email', 'username'])) {
+                      [$property, $value] = $valueParts;
+                  }
+
+                  $datagrid->setValue($datagrid->getFilter($property)->getFormName(), null, $value);
+              },
+          ])
+      ;
 
 ``to_string_callback``
   defaults to ``null``. Callable function that can be used to change the default toString behavior of entity::