9.5/_menu_8php_source.html

<?php

namespace ‪TYPO3\CMS\Backend\Template\Components\Menu;


/*

 * 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!

 */


use ‪TYPO3\CMS\Core\Utility\GeneralUtility;


class ‪Menu

{

    protected ‪$identifier = '';


    protected ‪$label = '';


    protected ‪$menuItems = [];


    public function ‪getLabel()

    {

        return ‪$this->label;

    }


    public function ‪setLabel(‪$label)

    {

        $this->label = ‪$label;

        return $this;

    }


    public function ‪setIdentifier(‪$identifier)

    {

        $this->identifier = ‪$identifier;

        return $this;

    }


    public function ‪addMenuItem(‪MenuItem $menuItem)

    {

        if (!$menuItem->‪isValid($menuItem)) {

            throw new \InvalidArgumentException('MenuItem "' . $menuItem->‪getTitle() . '" is not valid', 1442236317);

        }

        // @todo implement sorting of menu items

        // @todo maybe even things like spacers/sections?

        $this->menuItems[] = clone $menuItem;

    }


    public function ‪getMenuItems()

    {

        return ‪$this->menuItems;

    }


    public function ‪getIdentifier()

    {

        return ‪$this->identifier;

    }


    public function ‪getDataIdentifier(): string

    {

        $dataMenuIdentifier = GeneralUtility::camelCaseToLowerCaseUnderscored($this->identifier);

        $dataMenuIdentifier = str_replace('_', '-', $dataMenuIdentifier);

        return $dataMenuIdentifier;

    }


    public function ‪makeMenuItem()

    {

        $menuItem = GeneralUtility::makeInstance(MenuItem::class);

        return $menuItem;

    }


    public function ‪isValid(‪Menu $menu)

    {

        return trim($menu->‪getIdentifier()) !== '';

    }

}