Add a way to generate absolute component URLs

Author: 1ed

src/LiveComponent/CHANGELOG.md

@@ -4,6 +4,8 @@
 
 -   Add support for URL binding in `LiveProp`
 -   Allow multiple `LiveListener` attributes on a single method.
+-   Add a new `urlReferenceType` parameter to `AsLiveComponent`, which allows to
+    generate different type URL (e.g. absolute) for the component Ajax calls.
 
 ## 2.13.2
 

src/LiveComponent/doc/index.rst

@@ -3153,6 +3153,26 @@ Then specify this new route on your component:
           use DefaultActionTrait;
       }
 
+.. versionadded:: 2.14
+
+    The ``urlReferenceType`` option  was added in LiveComponents 2.14.
+
+You can also control the type of the generated URL:
+
+.. code-block:: diff
+
+      // src/Components/RandomNumber.php
+    + use Symfony\Component\Routing\Generator\UrlGeneratorInterface;
+      use Symfony\UX\LiveComponent\Attribute\AsLiveComponent;
+      use Symfony\UX\LiveComponent\DefaultActionTrait;
+
+    - #[AsLiveComponent]
+    + #[AsLiveComponent(urlReferenceType: UrlGeneratorInterface::ABSOLUTE_URL)]
+      class RandomNumber
+      {
+          use DefaultActionTrait;
+      }
+
 Add a Hook on LiveProp Update
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 

src/LiveComponent/src/Attribute/AsLiveComponent.php

@@ -11,6 +11,7 @@
 
 namespace Symfony\UX\LiveComponent\Attribute;
 
+use Symfony\Component\Routing\Generator\UrlGeneratorInterface;
 use Symfony\UX\TwigComponent\Attribute\AsTwigComponent;
 
 /**
@@ -33,6 +34,7 @@ final class AsLiveComponent extends AsTwigComponent
      * @param string      $attributesVar     The name of the special "attributes" variable in the template
      * @param bool        $csrf              Whether to enable CSRF protection (default: true)
      * @param string      $route             The route used to render the component & handle actions (default: ux_live_component)
+     * @param int         $urlReferenceType  Which type of URL should be generated for the given route. Use the constants from UrlGeneratorInterface (default: absolute path, e.g. "/dir/file").
      */
     public function __construct(
         string $name = null,
@@ -42,6 +44,7 @@ public function __construct(
         string $attributesVar = 'attributes',
         public bool $csrf = true,
         public string $route = 'ux_live_component',
+        public int $urlReferenceType = UrlGeneratorInterface::ABSOLUTE_PATH,
     ) {
         parent::__construct($name, $template, $exposePublicProps, $attributesVar);
     }
@@ -56,6 +59,7 @@ public function serviceConfig(): array
             'live' => true,
             'csrf' => $this->csrf,
             'route' => $this->route,
+            'url_reference_type' => $this->urlReferenceType,
         ]);
     }
 

src/LiveComponent/src/Twig/LiveComponentRuntime.php

@@ -45,6 +45,6 @@ public function getComponentUrl(string $name, array $props = []): string
 
         $metadata = $this->factory->metadataFor($mounted->getName());
 
-        return $this->urlGenerator->generate($metadata->get('route'), $params);
+        return $this->urlGenerator->generate($metadata->get('route'), $params, $metadata->get('url_reference_type'));
     }
 }

src/LiveComponent/src/Util/LiveControllerAttributesCreator.php

@@ -61,7 +61,7 @@ public function attributesForRendering(MountedComponent $mounted, ComponentMetad
         $attributesCollection = $this->attributeHelper->create();
         $attributesCollection->setLiveController($mounted->getName());
 
-        $url = $this->urlGenerator->generate($metadata->get('route'), ['_live_component' => $mounted->getName()]);
+        $url = $this->urlGenerator->generate($metadata->get('route'), ['_live_component' => $mounted->getName()], $metadata->get('url_reference_type'));
         $attributesCollection->setUrl($url);
 
         $liveListeners = AsLiveComponent::liveListeners($mounted->getComponent());

src/LiveComponent/tests/Fixtures/Component/WithAbsoluteUrl.php

@@ -0,0 +1,16 @@
+<?php
+
+namespace Symfony\UX\LiveComponent\Tests\Fixtures\Component;
+
+use Symfony\Component\Routing\Generator\UrlGeneratorInterface;
+use Symfony\UX\LiveComponent\Attribute\AsLiveComponent;
+use Symfony\UX\LiveComponent\DefaultActionTrait;
+
+/**
+ * @author Gábor Egyed <[email protected]>
+ */
+#[AsLiveComponent('with_absolute_url', urlReferenceType: UrlGeneratorInterface::ABSOLUTE_URL)]
+final class WithAbsoluteUrl
+{
+    use DefaultActionTrait;
+}

src/LiveComponent/tests/Fixtures/templates/component_url.html.twig

@@ -1,2 +1,3 @@
 {{ component_url('component1', {prop1: null, prop2: date}) }}
 {{ component_url('alternate_route') }}
+{{ component_url('with_absolute_url') }}

src/LiveComponent/tests/Fixtures/templates/components/with_absolute_url.html.twig

@@ -0,0 +1,3 @@
+<div{{ attributes }}>
+    From absolute url.
+</div>

src/LiveComponent/tests/Fixtures/templates/render_with_absolute_url.html.twig

@@ -0,0 +1 @@
+{{ component('with_absolute_url') }}

src/LiveComponent/tests/Functional/EventListener/AddLiveAttributesSubscriberTest.php

@@ -154,4 +154,24 @@ public function testQueryStringMappingAttribute()
 
         $this->assertEquals($expected, $queryMapping);
     }
+
+    public function testAbsoluteUrl(): void
+    {
+        $div = $this->browser()
+            ->visit('/render-template/render_with_absolute_url')
+            ->assertSuccessful()
+            ->crawler()
+            ->filter('div')
+        ;
+
+        $props = json_decode($div->attr('data-live-props-value'), true);
+
+        $this->assertSame('live', $div->attr('data-controller'));
+        $this->assertSame('http://localhost/_components/with_absolute_url', $div->attr('data-live-url-value'));
+        $this->assertNotNull($div->attr('data-live-csrf-value'));
+        $this->assertCount(2, $props);
+        $this->assertArrayHasKey('@checksum', $props);
+        $this->assertArrayHasKey('@attributes', $props);
+        $this->assertArrayHasKey('data-live-id', $props['@attributes']);
+    }
 }