<?php
/**
* JsSelectorCall.php
*
* Factory for a Javascript element selector.
*
* @package jaxon-core
* @author Thierry Feuzeu <thierry.feuzeu@gmail.com>
* @copyright 2024 Thierry Feuzeu <thierry.feuzeu@gmail.com>
* @license https://opensource.org/licenses/BSD-3-Clause BSD 3-Clause License
* @link https://github.com/jaxon-php/jaxon-core
*/
namespace Jaxon\Script\Call;
use Jaxon\Script\Action\HtmlReader;
use Jaxon\Script\Action\Selector;
use Jaxon\Script\JsExpr;
use Closure;
class JsSelectorCall extends AbstractJsCall
{
/**
* The constructor.
*
* @param Closure|null $xExprCb
* @param string $sElementId The DOM element id
*/
public function __construct(?Closure $xExprCb, protected string $sElementId)
{
parent::__construct($xExprCb);
}
/**
* Get the call to add to the expression
*
* @return Selector
*/
protected function _exprCall(): Selector
{
// If the value is '', return the js "this" object, otherwise, the selected DOM element.
return new Selector('js', $this->sElementId ?: 'this');
}
/**
* Set an event handler on the selected elements
*
* @param string $sName
* @param JsExpr $xHandler
*
* @return JsExpr
*/
public function addEventListener(string $sName, JsExpr $xHandler): JsExpr
{
return $this->_expr()->event('js', $sName, $xHandler);
}
/**
* Set an "click" event handler on the first selected element
*
* @param JsExpr $xHandler
*
* @return JsExpr
*/
public function click(JsExpr $xHandler): JsExpr
{
return $this->_expr()->event('js', 'click', $xHandler);
}
/**
* @return HtmlReader
*/
public function rd(): HtmlReader
{
return new HtmlReader($this->sElementId);
}
}
|
Download
