vendor/symfony/webpack-encore-bundle/src/Dto/AbstractStimulusDto.php line 35

Open in your IDE?
  1. <?php
  3. declare(strict_types=1);
  5. /*
  6.  * This file is part of the Symfony WebpackEncoreBundle package.
  7.  * (c) Fabien Potencier <fabien@symfony.com>
  8.  * For the full copyright and license information, please view the LICENSE
  9.  * file that was distributed with this source code.
  10.  */
  12. namespace Symfony\WebpackEncoreBundle\Dto;
  14. use Twig\Environment;
  16. /**
  17.  * @internal
  18.  *
  19.  * @deprecated since 1.17.0 - install symfony/stimulus-bundle instead.
  20.  */
  21. abstract class AbstractStimulusDto implements \Stringable
  22. {
  23.     /**
  24.      * @var Environment
  25.      */
  26.     private $env;
  28.     public function __construct(Environment $env)
  29.     {
  30.         $this->env = $env;
  31.     }
  33.     abstract public function toArray(): array;
  35.     protected function getFormattedControllerName(string $controllerName): string
  36.     {
  37.         return $this->escapeAsHtmlAttr($this->normalizeControllerName($controllerName));
  38.     }
  40.     protected function getFormattedValue($value)
  41.     {
  42.         if ($value instanceof \Stringable || (\is_object($value) && \is_callable([$value, '__toString']))) {
  43.             $value = (string) $value;
  44.         } elseif (!\is_scalar($value)) {
  45.             $value = json_encode($value);
  46.         } elseif (\is_bool($value)) {
  47.             $value = $value ? 'true' : 'false';
  48.         }
  50.         return (string) $value;
  51.     }
  53.     protected function escapeAsHtmlAttr($value): string
  54.     {
  55.         return (string) twig_escape_filter($this->env, $value, 'html_attr');
  56.     }
  58.     /**
  59.      * Normalize a Stimulus controller name into its HTML equivalent (no special character and / becomes --).
  60.      *
  61.      * @see https://stimulus.hotwired.dev/reference/controllers
  62.      */
  63.     private function normalizeControllerName(string $controllerName): string
  64.     {
  65.         return preg_replace('/^@/', '', str_replace('_', '-', str_replace('/', '--', $controllerName)));
  66.     }
  67. }