name = $name; $menuClass = 'menu__item--' . $name; $this->attributes = [ 'data-icon' => [ 'icon' => null, ], 'data-event-name' => null, 'title' => null, 'id' => null, 'text' => $text, 'href' => $url, 'role' => '', 'data-mw' => 'interface', 'class' => is_array( $className ) ? implode( ' ', $className + [ $menuClass ] ) : ltrim( $className . ' ' . $menuClass ), ]; } /** * Override the icon used in the home menu entry. * * @param string $icon * @return $this */ public function overrideIcon( $icon ) { $this->setIcon( str_replace( 'minerva-', '', $icon ) ); return $this; } /** * Override the text used in the home menu entry. * * @param string $text * @return $this */ public function overrideText( $text ) { $this->attributes['text'] = $text; return $this; } /** * Create a Single Menu entry with text, icon and active click tracking * * @param string $name Entry identifier * @param string $text Entry label * @param string $url The URL entry points to * @param string $className Optional HTML classes * @param string|null $icon defaults to $name if not specified * @param bool $trackable Whether an entry will track clicks or not. Default is false. * @return static */ public static function create( $name, $text, $url, $className = '', $icon = null, $trackable = false ) { $entry = new static( $name, $text, $url, $className ); if ( $trackable ) { $entry->trackClicks( $name ); } if ( $icon === null ) { $icon = $name; } $entry->setIcon( $icon ); return $entry; } /** * @inheritDoc */ public function getName() { return $this->name; } /** * @inheritDoc */ public function getCSSClasses(): array { return $this->isJSOnly ? [ 'jsonly' ] : []; } /** * @inheritDoc */ public function getComponents(): array { $attrs = []; foreach ( [ 'id', 'href', 'data-event-name', 'data-mw', 'role' ] as $key ) { $value = $this->attributes[$key]; if ( $value ) { $attrs[] = [ 'key' => $key, 'value' => $value, ]; } } $btn = [ 'tag-name' => 'a', 'label' => $this->attributes['text'], 'array-attributes' => $attrs, 'classes' => $this->attributes['class'], 'data-icon' => $this->attributes['data-icon'], ]; return [ $btn ]; } /** * @param string $eventName Should clicks be tracked. To override the tracking code * pass the tracking code as string * @return $this */ public function trackClicks( $eventName ) { $this->attributes['data-event-name'] = 'menu.' . $eventName; return $this; } /** * Set the Menu entry icon * @param string|null $iconName * @param string $iconType * @param string $additionalClassNames Additional classes * @param string $iconPrefix either `wikimedia` or `minerva` * @return $this */ public function setIcon( $iconName, $iconType = 'before', $additionalClassNames = '', $iconPrefix = 'minerva' ) { if ( $iconName !== null ) { $this->attributes['data-icon']['icon'] = $iconPrefix . '-' . $iconName; } else { $this->attributes['data-icon'] = null; } if ( $additionalClassNames ) { $this->attributes['class'] .= ' ' . $additionalClassNames; } if ( $iconType !== 'before' ) { $this->attributes['role'] = 'button'; } return $this; } /** * Set the menu entry title * @param Message $message Title message * @return $this */ public function setTitle( Message $message ): self { $this->attributes['title'] = $message->escaped(); return $this; } /** * Set the Menu entry ID html attribute * @param string $nodeID * @return $this */ public function setNodeID( $nodeID ): self { $this->attributes['id'] = $nodeID; return $this; } /** * Mark entry as JS only. */ public function setJSOnly() { $this->isJSOnly = true; } }