interface MenuLinkInterface
Same name in other branches
- 9 core/lib/Drupal/Core/Menu/MenuLinkInterface.php \Drupal\Core\Menu\MenuLinkInterface
- 8.9.x core/lib/Drupal/Core/Menu/MenuLinkInterface.php \Drupal\Core\Menu\MenuLinkInterface
- 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
- interface \Drupal\Component\Plugin\DerivativeInspectionInterface; interface \Drupal\Component\Plugin\PluginInspectionInterface; interface \Drupal\Core\Cache\CacheableDependencyInterface
- interface \Drupal\Core\Menu\MenuLinkInterface extends \Drupal\Component\Plugin\PluginInspectionInterface \Drupal\Component\Plugin\DerivativeInspectionInterface \Drupal\Core\Cache\CacheableDependencyInterface
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
File
-
core/
lib/ Drupal/ Core/ Menu/ MenuLinkInterface.php, line 13
Namespace
Drupal\Core\MenuView 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.