interface MenuLinkInterface

Same name in other branches
  1. 9 core/lib/Drupal/Core/Menu/MenuLinkInterface.php \Drupal\Core\Menu\MenuLinkInterface
  2. 8.9.x core/lib/Drupal/Core/Menu/MenuLinkInterface.php \Drupal\Core\Menu\MenuLinkInterface
  3. 11.x core/lib/Drupal/Core/Menu/MenuLinkInterface.php \Drupal\Core\Menu\MenuLinkInterface

Defines an interface for classes providing a type of menu link.

Hierarchy

Expanded class hierarchy of MenuLinkInterface

All classes that implement MenuLinkInterface

8 files declare their use of MenuLinkInterface
MenuLinkDefaultForm.php in core/lib/Drupal/Core/Menu/Form/MenuLinkDefaultForm.php
MenuLinkEditForm.php in core/modules/menu_ui/src/Form/MenuLinkEditForm.php
MenuLinkFormInterface.php in core/lib/Drupal/Core/Menu/Form/MenuLinkFormInterface.php
MenuLinkResetForm.php in core/modules/menu_ui/src/Form/MenuLinkResetForm.php
MenuUiTest.php in core/modules/menu_ui/tests/src/Functional/MenuUiTest.php

... See full list

File

core/lib/Drupal/Core/Menu/MenuLinkInterface.php, line 13

Namespace

Drupal\Core\Menu
View source
interface MenuLinkInterface extends PluginInspectionInterface, DerivativeInspectionInterface, CacheableDependencyInterface {
    
    /**
     * Returns the weight of the menu link.
     *
     * @return int
     *   The weight of the menu link, 0 by default.
     */
    public function getWeight();
    
    /**
     * Returns the localized title to be shown for this link.
     *
     * @return string
     *   The title of the menu link.
     */
    public function getTitle();
    
    /**
     * Returns the description of the menu link.
     *
     * @return string
     *   The description of the menu link.
     */
    public function getDescription();
    
    /**
     * Returns the menu name of the menu link.
     *
     * @return string
     *   The menu name of the menu link.
     */
    public function getMenuName();
    
    /**
     * Returns the provider (module name) of the menu link.
     *
     * @return string
     *   The provider of the menu link.
     */
    public function getProvider();
    
    /**
     * Returns the plugin ID of the menu link's parent, or an empty string.
     *
     * @return string
     *   The parent plugin ID.
     */
    public function getParent();
    
    /**
     * Returns whether the menu link is enabled (not hidden).
     *
     * @return bool
     *   TRUE for enabled, FALSE otherwise.
     */
    public function isEnabled();
    
    /**
     * Returns whether the child menu links should always been shown.
     *
     * @return bool
     *   TRUE for expanded, FALSE otherwise.
     */
    public function isExpanded();
    
    /**
     * Returns whether this link can be reset.
     *
     * In general, only links that store overrides using the
     * menu_link.static.overrides service should return TRUE for this method.
     *
     * @return bool
     *   TRUE if it can be reset, FALSE otherwise.
     */
    public function isResettable();
    
    /**
     * Returns whether this link can be translated.
     *
     * @return bool
     *   TRUE if the link can be translated, FALSE otherwise.
     */
    public function isTranslatable();
    
    /**
     * Returns whether this link can be deleted.
     *
     * @return bool
     *   TRUE if the link can be deleted, FALSE otherwise.
     */
    public function isDeletable();
    
    /**
     * Returns the route name, if available.
     *
     * @return string
     *   The name of the route this menu link links to.
     */
    public function getRouteName();
    
    /**
     * Returns the route parameters, if available.
     *
     * @return array
     *   An array of parameter names and values.
     */
    public function getRouteParameters();
    
    /**
     * Returns a URL object containing either the external path or route.
     *
     * @param bool $title_attribute
     *   (optional) If TRUE, add the link description as the title attribute if
     *   the description is not empty.
     *
     * @return \Drupal\Core\Url
     *   A URL object containing either the external path or route.
     */
    public function getUrlObject($title_attribute = TRUE);
    
    /**
     * Returns the options for this link.
     *
     * @return array
     *   An associative array of options.
     */
    public function getOptions();
    
    /**
     * Returns any metadata for this link.
     *
     * @return array
     *   The metadata for the menu link.
     */
    public function getMetaData();
    
    /**
     * Updates the definition values for a menu link.
     *
     * Depending on the implementation details of the class, not all definition
     * values may be changed. For example, changes to the title of a static link
     * will be discarded.
     *
     * In general, this method should not be called directly, but will be called
     * automatically from MenuLinkManagerInterface::updateDefinition().
     *
     * @param array $new_definition_values
     *   The new values for the link definition. This will usually be just a
     *   subset of the plugin definition.
     * @param bool $persist
     *   TRUE to have the link persist the changed values to any additional
     *   storage.
     *
     * @return array
     *   The plugin definition incorporating any allowed changes.
     */
    public function updateLink(array $new_definition_values, $persist);
    
    /**
     * Deletes a menu link.
     *
     * In general, this method should not be called directly, but will be called
     * automatically from MenuLinkManagerInterface::removeDefinition().
     *
     * This method will only delete the link from any additional storage, but not
     * from the plugin.manager.menu.link service.
     *
     * @throws \Drupal\Component\Plugin\Exception\PluginException
     *   If the link is not deletable.
     */
    public function deleteLink();
    
    /**
     * Returns the name of a class that can build an editing form for this link.
     *
     * To instantiate the form class, use an instance of the
     * \Drupal\Core\DependencyInjection\ClassResolverInterface, such as from the
     * class_resolver service. Then call the setMenuLinkInstance() method on the
     * form instance with the menu link plugin instance.
     *
     * @todo Add a code example. https://www.drupal.org/node/2302849
     *
     * @return string
     *   A class that implements \Drupal\Core\Menu\Form\MenuLinkFormInterface.
     */
    public function getFormClass();
    
    /**
     * Returns route information for a route to delete the menu link.
     *
     * @return \Drupal\Core\Url|null
     *   A Url object, or NULL if there is no route (e.g. when the link is not
     *   deletable).
     */
    public function getDeleteRoute();
    
    /**
     * Returns route information for a custom edit form for the menu link.
     *
     * Plugins should return a value here if they have a special edit form, or if
     * they need to define additional local tasks, local actions, etc. that are
     * visible from the edit form.
     *
     * @return \Drupal\Core\Url|null
     *   A Url object, or NULL if there is no route because there is no custom
     *   edit route for this instance.
     */
    public function getEditRoute();
    
    /**
     * Returns route information for a route to reset the menu link.
     *
     * @return \Drupal\Core\Url|null
     *   A Url object, or NULL if there is no route (e.g. when the link is not
     *   resettable).
     */
    public function getResetRoute() : Url|null;
    
    /**
     * Returns route information for a route to translate the menu link.
     *
     * @return \Drupal\Core\Url|null
     *   A Url object, or NULL if there is no route (e.g. when the link is not
     *   translatable).
     */
    public function getTranslateRoute();
    
    /**
     * Provides an array of information to build a list of operation links.
     *
     * @return array
     *   An associative array of operation link data for this menu link, keyed by
     *   operation name, containing the following key-value pairs:
     *   - title: The localized title of the operation.
     *   - url: An instance of \Drupal\Core\Url for the operation URL.
     *   - weight: The weight of this operation.
     */
    public function getOperations() : array;

}

Members

Title Sort descending Modifiers Object type Summary Overrides
CacheableDependencyInterface::getCacheContexts public function The cache contexts associated with this object. 34
CacheableDependencyInterface::getCacheMaxAge public function The maximum age for which this object may be cached. 34
CacheableDependencyInterface::getCacheTags public function The cache tags associated with this object. 27
DerivativeInspectionInterface::getBaseId public function Gets the base_plugin_id of the plugin instance. 1
DerivativeInspectionInterface::getDerivativeId public function Gets the derivative_id of the plugin instance. 1
MenuLinkInterface::deleteLink public function Deletes a menu link. 1
MenuLinkInterface::getDeleteRoute public function Returns route information for a route to delete the menu link. 1
MenuLinkInterface::getDescription public function Returns the description of the menu link. 5
MenuLinkInterface::getEditRoute public function Returns route information for a custom edit form for the menu link. 1
MenuLinkInterface::getFormClass public function Returns the name of a class that can build an editing form for this link. 1
MenuLinkInterface::getMenuName public function Returns the menu name of the menu link. 1
MenuLinkInterface::getMetaData public function Returns any metadata for this link. 1
MenuLinkInterface::getOperations public function Provides an array of information to build a list of operation links. 1
MenuLinkInterface::getOptions public function Returns the options for this link. 1
MenuLinkInterface::getParent public function Returns the plugin ID of the menu link's parent, or an empty string. 1
MenuLinkInterface::getProvider public function Returns the provider (module name) of the menu link. 1
MenuLinkInterface::getResetRoute public function Returns route information for a route to reset the menu link. 1
MenuLinkInterface::getRouteName public function Returns the route name, if available. 1
MenuLinkInterface::getRouteParameters public function Returns the route parameters, if available. 1
MenuLinkInterface::getTitle public function Returns the localized title to be shown for this link. 5
MenuLinkInterface::getTranslateRoute public function Returns route information for a route to translate the menu link. 1
MenuLinkInterface::getUrlObject public function Returns a URL object containing either the external path or route. 1
MenuLinkInterface::getWeight public function Returns the weight of the menu link. 1
MenuLinkInterface::isDeletable public function Returns whether this link can be deleted. 1
MenuLinkInterface::isEnabled public function Returns whether the menu link is enabled (not hidden). 1
MenuLinkInterface::isExpanded public function Returns whether the child menu links should always been shown. 1
MenuLinkInterface::isResettable public function Returns whether this link can be reset. 1
MenuLinkInterface::isTranslatable public function Returns whether this link can be translated. 1
MenuLinkInterface::updateLink public function Updates the definition values for a menu link. 5
PluginInspectionInterface::getPluginDefinition public function Gets the definition of the plugin implementation. 6
PluginInspectionInterface::getPluginId public function Gets the plugin_id of the plugin instance. 2

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