ContinueWith: Introduce factory methods create() and createDisabled()

- Disable button if `createDisabled()` is called or no filter is applied
- Apply `baseTarget` to the link instead of the class itself

Author: sukhwinder33445

src/Widget/ContinueWith.php

@@ -6,14 +6,11 @@
 use ipl\Html\BaseHtmlElement;
 use ipl\Html\HtmlElement;
 use ipl\Stdlib\Filter;
-use ipl\Web\Common\BaseTarget;
-use ipl\Web\Filter\QueryString;
+use ipl\Stdlib\Filter\Rule;
 use ipl\Web\Url;
 
 class ContinueWith extends BaseHtmlElement
 {
-    use BaseTarget;
-
     protected $tag = 'span';
 
     protected $defaultAttributes = ['class' => 'continue-with'];
@@ -27,10 +24,98 @@ class ContinueWith extends BaseHtmlElement
     /** @var string */
     protected $title;
 
-    public function __construct(Url $url, $filter)
+    /** @var string The title to use when the filter is empty */
+    protected string $emptyFilterTitle;
+
+    /** @var ?string The reason why the widget is disabled */
+    protected ?string $disableReason = null;
+
+    /** @var ?string The `data-base-target` attribute */
+    protected ?string $baseTarget = null;
+
+    /**
+     * @deprecated Use {@see ContinueWith::create()} and {@see ContinueWith::createDisabled()} instead
+     */
+    public function __construct(?Url $url = null, $filter = null)
     {
         $this->url = $url;
         $this->filter = $filter;
+
+        $this->emptyFilterTitle = '';
+    }
+
+    /**
+     * Create a `ContinueWith` widget
+     *
+     * @param Url $url The url to use
+     * @param Rule|callable $filter The filter to apply
+     * @param string $title The title of the widget
+     * @param string $emptyFilterTitle The title to use when the filter is empty
+     *
+     * @return static
+     */
+    public static function create(
+        Url $url,
+        Filter\Rule|callable $filter,
+        string $title,
+        string $emptyFilterTitle
+    ): static {
+        return (new static($url, $filter))
+            ->setTitle($title)
+            ->setEmptyFilterTitle($emptyFilterTitle);
+    }
+
+    /**
+     * Create a disabled `ContinueWith` widget
+     *
+     * @param string $reason The reason why the widget is disabled
+     *
+     * @return static
+     */
+    public static function createDisabled(string $reason): static
+    {
+        $instance = new static();
+        $instance->disableReason = $reason;
+
+        return $instance;
+    }
+
+    /**
+     * Get the `data-base-target` attribute
+     *
+     * @return ?string
+     */
+    public function getBaseTarget(): ?string
+    {
+        return $this->baseTarget;
+    }
+
+    /**
+     * Set the `data-base-target` attribute
+     *
+     * @param string $target
+     *
+     * @return $this
+     */
+    public function setBaseTarget(string $target): static
+    {
+        $this->baseTarget = $target;
+
+        return $this;
+    }
+
+    /**
+     * Set the title to use when the filter is empty
+     *
+     * @param string $emptyFilterTitle
+     *
+     * @return $this
+     */
+    public function setEmptyFilterTitle(string $emptyFilterTitle): static
+    {
+        $this->emptyFilterTitle = $emptyFilterTitle;
+
+        return $this;
     }
 
     /**
@@ -54,24 +139,33 @@ public function assemble()
             $filter = $filter(); /** @var Filter\Rule $filter */
         }
 
-        $baseFilter = $this->url->getFilter();
+        $baseFilter = $this->url?->getFilter();
         if ($baseFilter && ((! $baseFilter instanceof Filter\Chain) || ! $baseFilter->isEmpty())) {
             $filter = Filter::all($baseFilter, $filter);
         }
 
-        if ($filter instanceof Filter\Chain && $filter->isEmpty()) {
+        if ($this->disableReason || ($filter instanceof Filter\Chain && $filter->isEmpty())) {
             $this->addHtml(new HtmlElement(
                 'span',
-                Attributes::create(['class' => ['control-button', 'disabled']]),
+                Attributes::create([
+                    'class' => ['control-button', 'disabled'],
+                    'title' => $this->disableReason ?? $this->emptyFilterTitle,
+                ]),
                 new Icon('share')
             ));
         } else {
-            $this->addHtml(new ActionLink(
+            $link = new ActionLink(
                 null,
                 $this->url->setFilter($filter),
                 'share',
                 ['class' => 'control-button', 'title' => $this->title]
-            ));
+            );
+
+            if ($this->getBaseTarget()) {
+                $link->setBaseTarget($this->getBaseTarget());
+            }
+
+            $this->addHtml($link);
         }
     }
 }