. */ declare(strict_types=1); namespace Fisharebest\Webtrees; use function trigger_error; use const E_USER_DEPRECATED; /** * System for generating menus. */ class Menu { /** @var string The text to be displayed in the mneu */ private $label; /** @var string The target URL or href */ private $link; /** @var string The CSS class used to style this menu item */ private $class; /** @var string[] A list of optional HTML attributes, such as onclick or data-xxx */ private $attrs; /** @var Menu[] An optional list of sub-menus. */ private $submenus; /** * Constructor for the menu class * * @param string $label The label for the menu item * @param string $link The target URL * @param string $class A CSS class * @param string[] $attrs Optional attributes, such as onclick or data-xxx * @param Menu[] $submenus Any submenus */ public function __construct($label, $link = '#', $class = '', array $attrs = [], array $submenus = []) { $this ->setLabel($label) ->setLink($link) ->setClass($class) ->setAttrs($attrs) ->setSubmenus($submenus); } /** * Render this menu using Bootstrap4 markup * * @return string * * @deprecated since 2.0.2. Will be removed in 2.1.0 */ public function bootstrap4(): string { trigger_error( 'Menu::bootstrap4() is deprecated. Use the view(components/menu-item) instead', E_USER_DEPRECATED ); return view('components/menu-item', ['menu' => $this]); } /** * Get the optional attributes. * * @return string[] */ public function getAttrs(): array { return $this->attrs; } /** * Set the optional attributes. * * @param string[] $attrs * * @return $this */ public function setAttrs(array $attrs): self { $this->attrs = $attrs; return $this; } /** * Get the class. * * @return string */ public function getClass(): string { return $this->class; } /** * Set the class. * * @param string $class * * @return $this */ public function setClass($class): self { $this->class = $class; return $this; } /** * Get the label. * * @return string */ public function getLabel(): string { return $this->label; } /** * Set the label. * * @param string $label * * @return $this */ public function setLabel($label): self { $this->label = $label; return $this; } /** * Get the link. * * @return string */ public function getLink(): string { return $this->link; } /** * Set the link. * * @param string $link * * @return $this */ public function setLink($link): self { $this->link = $link; return $this; } /** * Add a submenu to this menu * * @param Menu $menu * * @return $this */ public function addSubmenu($menu): self { $this->submenus[] = $menu; return $this; } /** * Get the sub-menus. * * @return Menu[] */ public function getSubmenus(): array { return $this->submenus; } /** * Set the sub-menus. * * @param Menu[] $submenus * * @return $this */ public function setSubmenus(array $submenus): self { $this->submenus = $submenus; return $this; } }