[LiveComponent] add LiveProp name to modifier function

Author: jannes-io

src/LiveComponent/doc/index.rst

@@ -2617,7 +2617,9 @@ definition::
 
 Then the ``query`` value will appear in the URL like ``https://my.domain/search?q=my+query+string``.
 
-If you need to change the parameter name on a specific page, you can leverage the :ref:`modifier <modifier>` option::
+If you need to change the parameter name on a specific page, you can leverage the :ref:`modifier <modifier>` option
+which takes a reference to a public function in your component that takes the ``LiveProp`` and the ``name``
+of the property and must return a modified ``LiveProp`` object::
 
     // ...
     use Symfony\UX\LiveComponent\Metadata\UrlMapping;
@@ -2629,27 +2631,28 @@ If you need to change the parameter name on a specific page, you can leverage th
         public string $query = '';
 
         #[LiveProp]
-        public ?string $alias = null;
+        public string $urlPrefix = '';
 
-        public function modifyQueryProp(LiveProp $liveProp): LiveProp
+        public function modifyQueryProp(LiveProp $liveProp, string $propName): LiveProp
         {
-            if ($this->alias) {
-                $liveProp = $liveProp->withUrl(new UrlMapping(as: $this->alias));
-            }
-            return $liveProp;
+            return $this->urlPrefix
+                ? $liveProp->withUrl(new UrlMapping($this->urlPrefix . ucfirst($propName)))
+                : $liveProp;
         }
     }
 
 .. code-block:: html+twig
 
-    <twig:SearchModule alias="q" />
+    <twig:SearchModule urlPrefix="example" />
+
+Now the ``query`` value will appear in the URL like: ``https://my.domain/search?exampleQuery``
 
 This way you can also use the component multiple times in the same page and avoid collisions in parameter names:
 
 .. code-block:: html+twig
 
-    <twig:SearchModule alias="q1" />
-    <twig:SearchModule alias="q2" />
+    <twig:SearchModule urlPrefix="example1" />
+    <twig:SearchModule urlPrefix="example2" />
 
 Validating the Query Parameter Values
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

src/LiveComponent/src/Metadata/LivePropMetadata.php

@@ -135,7 +135,7 @@ public function withModifier(object $component): self
             throw new \LogicException(\sprintf('Method "%s::%s()" given in LiveProp "modifier" does not exist.', $component::class, $modifier));
         }
 
-        $modifiedLiveProp = $component->{$modifier}($this->liveProp);
+        $modifiedLiveProp = $component->{$modifier}($this->liveProp, $this->getName());
         if (!$modifiedLiveProp instanceof LiveProp) {
             throw new \LogicException(\sprintf('Method "%s::%s()" should return an instance of "%s" (given: "%s").', $component::class, $modifier, LiveProp::class, get_debug_type($modifiedLiveProp)));
         }