function Attribute::addClass

Same name in other branches
  1. 9 core/lib/Drupal/Core/Template/Attribute.php \Drupal\Core\Template\Attribute::addClass()
  2. 8.9.x core/lib/Drupal/Core/Template/Attribute.php \Drupal\Core\Template\Attribute::addClass()
  3. 10 core/lib/Drupal/Core/Template/Attribute.php \Drupal\Core\Template\Attribute::addClass()

Adds classes or merges them on to array of existing CSS classes.

Parameters

string|array ...$args: CSS classes to add to the class attribute array.

Return value

$this

File

core/lib/Drupal/Core/Template/Attribute.php, line 182

Class

Attribute
Collects, sanitizes, and renders HTML attributes.

Namespace

Drupal\Core\Template

Code

public function addClass(...$args) {
    if ($args) {
        $classes = [];
        foreach ($args as $arg) {
            // Merge the values passed in from the classes array.
            // The argument is cast to an array to support comma separated single
            // values or one or more array arguments.
            $classes[] = (array) $arg;
        }
        $classes = array_merge(...$classes);
        // Merge if there are values, just add them otherwise.
        if (isset($this->storage['class']) && $this->storage['class'] instanceof AttributeArray) {
            // Merge the values passed in from the class value array.
            $classes = array_merge($this->storage['class']
                ->value(), $classes);
            $this->storage['class']
                ->exchangeArray($classes);
        }
        else {
            $this->offsetSet('class', $classes);
        }
    }
    return $this;
}

Buggy or inaccurate documentation? Please file an issue. Need support? Need help programming? Connect with the Drupal community.