SplitButton.php

Go to the documentation of this file.

<?php
namespace TYPO3\CMS\Backend\Template\Components\Buttons;

/*
 * This file is part of the TYPO3 CMS project.
 *
 * It is free software; you can redistribute it and/or modify it under
 * the terms of the GNU General Public License, either version 2
 * of the License, or any later version.
 *
 * For the full copyright and license information, please read the
 * LICENSE.txt file that was distributed with this source code.
 *
 * The TYPO3 project - inspiring people to share!
 */

class SplitButton extends AbstractButton implements ButtonInterface
{
    protected $containsPrimaryAction = false;

    protected $items = [];

    public function addItem(AbstractButton $item, $primaryAction = false)
    {
        if (!$item->isValid($item)) {
            throw new \InvalidArgumentException(
                'Only valid items may be assigned to a split Button. "' .
                $item->getType() .
                '" did not pass validation',
                1441706330
            );
        }
        if ($primaryAction && $this->containsPrimaryAction) {
            throw new \InvalidArgumentException('A splitButton may only contain one primary action', 1441706340);
        }
        if ($primaryAction) {
            $this->containsPrimaryAction = true;
            $this->items['primary'] = clone $item;
        } else {
            $this->items['options'][] = clone $item;
        }
        return $this;
    }

    public function getButton()
    {
        if (!isset($this->items['primary']) && isset($this->items['options'])) {
            $primaryAction = array_shift($this->items['options']);
            $this->items['primary'] = $primaryAction;
        }
        return $this->items;
    }

    public function isValid()
    {
        $subject = $this->getButton();
        if (isset($subject['primary'])
            && ($subject['primary'] instanceof AbstractButton)
            && isset($subject['options'])
        ) {
            return true;
        }
        return false;
    }

    public function render()
    {
        $items = $this->getButton();
        $attributes = [
            'type' => 'submit',
            'class' => 'btn btn-sm btn-default ' . htmlspecialchars($items['primary']->getClasses()),
            'name' => $items['primary']->getName(),
            'value' => $items['primary']->getValue()
        ];
        if (!empty($items['primary']->getOnClick())) {
            $attributes['onclick'] = $items['primary']->getOnClick();
        }
        if (!empty($items['primary']->getForm())) {
            $attributes['form'] = $items['primary']->getForm();
        }
        $attributesString = '';
        foreach ($attributes as $key => $value) {
            $attributesString .= ' ' . htmlspecialchars($key) . '="' . htmlspecialchars($value) . '"';
        }
        $content = '
        <div class="btn-group t3js-splitbutton">
            <button' . $attributesString . '>
                ' . $items['primary']->getIcon()->render() . '
                ' . htmlspecialchars($items['primary']->getTitle()) . '
            </button>
            <button type="button" class="btn btn-sm btn-default dropdown-toggle" data-toggle="dropdown" aria-expanded="false">
                <span class="caret"></span>
                <span class="sr-only">Toggle Dropdown</span>
            </button>
            <ul class="dropdown-menu">';

        foreach ($items['options'] as $option) {
            $optionAttributes = [
                'href' => '#',
                'data-name' => $option->getName(),
                'data-value' => $option->getValue(),
                'data-form' => $option->getForm()
            ];
            if (!empty($option->getClasses())) {
                $optionAttributes['class'] = htmlspecialchars($option->getClasses());
            }
            if (!empty($option->getOnClick())) {
                $optionAttributes['onclick'] = $option->getOnClick();
            }
            $optionAttributesString = '';
            foreach ($optionAttributes as $key => $value) {
                $optionAttributesString .= ' ' . htmlspecialchars($key) . '="' . htmlspecialchars($value) . '"';
            }
            $content .= '
                <li>
                    <a' . $optionAttributesString . '>' . $option->getIcon()->render() . ' '
                    . htmlspecialchars($option->getTitle()) . '</a>
                </li>
            ';
        }
        $content .= '
            </ul>
        </div>
        ';
        return $content;
    }

    public function __toString()
    {
        return $this->render();
    }
}