'continue-with'];
/** @var Url */
protected $url;
/** @var Filter\Rule|callable */
protected $filter;
/** @var string */
protected $title;
/** @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;
}
/**
* Set title for the anchor
*
* @param string $title
*
* @return $this
*/
public function setTitle($title)
{
$this->title = $title;
return $this;
}
public function assemble()
{
$filter = $this->filter;
if (is_callable($filter)) {
$filter = $filter(); /** @var Filter\Rule $filter */
}
$baseFilter = $this->url?->getFilter();
if ($baseFilter && ((! $baseFilter instanceof Filter\Chain) || ! $baseFilter->isEmpty())) {
$filter = Filter::all($baseFilter, $filter);
}
if ($this->disableReason || ($filter instanceof Filter\Chain && $filter->isEmpty())) {
$this->addHtml(new HtmlElement(
'span',
Attributes::create([
'class' => ['control-button', 'disabled'],
'title' => $this->disableReason ?? $this->emptyFilterTitle,
]),
new Icon('share')
));
} else {
$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);
}
}
}