vendor/symfony/webpack-encore-bundle/src/Dto/StimulusControllersDto.php line 23

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. /**
  15.  * @deprecated since 1.17.0 - install symfony/stimulus-bundle instead.
  16.  */
  17. final class StimulusControllersDto extends AbstractStimulusDto
  18. {
  19.     private $controllers = [];
  20.     private $values = [];
  21.     private $classes = [];
  23.     public function addController(string $controllerName, array $controllerValues = [], array $controllerClasses = []): void
  24.     {
  25.         $controllerName = $this->getFormattedControllerName($controllerName);
  26.         $this->controllers[] = $controllerName;
  28.         foreach ($controllerValues as $key => $value) {
  29.             if (null === $value) {
  30.                 continue;
  31.             }
  33.             $key = $this->escapeAsHtmlAttr($this->normalizeKeyName($key));
  34.             $value = $this->getFormattedValue($value);
  36.             $this->values['data-'.$controllerName.'-'.$key.'-value'] = $value;
  37.         }
  39.         foreach ($controllerClasses as $key => $class) {
  40.             $key = $this->escapeAsHtmlAttr($this->normalizeKeyName($key));
  42.             $this->classes['data-'.$controllerName.'-'.$key.'-class'] = $class;
  43.         }
  44.     }
  46.     public function __toString(): string
  47.     {
  48.         if (0 === \count($this->controllers)) {
  49.             return '';
  50.         }
  52.         return rtrim(implode(' ', array_filter([
  53.             'data-controller="'.implode(' ', $this->controllers).'"',
  54.             $this->formatDataAttribute($this->values),
  55.             $this->formatDataAttribute($this->classes),
  56.         ])));
  57.     }
  59.     public function toArray(): array
  60.     {
  61.         if (0 === \count($this->controllers)) {
  62.             return [];
  63.         }
  65.         return [
  66.             'data-controller' => implode(' ', $this->controllers),
  67.         ] + $this->values + $this->classes;
  68.     }
  70.     /**
  71.      * Normalize a Stimulus Value API key into its HTML equivalent ("kebab case").
  72.      * Backport features from symfony/string.
  73.      *
  74.      * @see https://stimulus.hotwired.dev/reference/values
  75.      */
  76.     private function normalizeKeyName(string $str): string
  77.     {
  78.         // Adapted from ByteString::camel
  79.         $str = ucfirst(str_replace(' ', '', ucwords(preg_replace('/[^a-zA-Z0-9\x7f-\xff]++/', ' ', $str))));
  81.         // Adapted from ByteString::snake
  82.         return strtolower(preg_replace(['/([A-Z]+)([A-Z][a-z])/', '/([a-z\d])([A-Z])/'], '\1-\2', $str));
  83.     }
  85.     private function formatDataAttribute(array $data): string
  86.     {
  87.         return implode(' ', array_map(function (string $attribute, string $value): string {
  88.             return $attribute.'="'.$this->escapeAsHtmlAttr($value).'"';
  89.         }, array_keys($data), $data));
  90.     }
  91. }