Blazor Menu Overview
The Blazor Menu component displays data (flat or hierarchical) in a traditional menu-like structure. In addition to built-in navigation capabilities, you can browse through the items and their children, define templates for the individual nodes, render text and icons/images, and respond to events.
The Menu component is part of Telerik UI for Blazor, a
professional grade UI library with 100+ native components for building modern and feature-rich applications. To try it out sign up for a free 30-day trial.
Creating Blazor Menu
Use the
TelerikMenutag to add the component to your razor page.Populate the
Dataproperty with the collection of items that you want to appear in the menu. The Menu will automatically recognize property names likeId,ParentId,Textand a few others. Otherwise, use bindings to configure custom property names.
Basic Menu with hierarchical data binding and built-in navigation
@*Use a Menu to navigate between views*@
<TelerikMenu Data="@MenuItems"/>
@code {
public List<MenuItem> MenuItems { get; set; }
public class MenuItem
{
public string Text { get; set; }
public string Url { get; set; }
public List<MenuItem> Items { get; set; }
}
protected override void OnInitialized()
{
MenuItems = new List<MenuItem>()
{
new MenuItem()
{
Text = "Company", // items that don't have a URL will not render links
Items = new List<MenuItem>()
{
new MenuItem()
{
Text = "Overview",
Url = "company/overview"
},
new MenuItem()
{
Text = "Events",
Url = "company/events"
},
new MenuItem()
{
Text = "Careers",
Url = "company/careers"
}
}
},
new MenuItem()
{
Text = "Services",
Items = new List<MenuItem>()
{
new MenuItem()
{
Text = "Consulting",
Url = "consultingservices"
},
new MenuItem()
{
Text = "Education",
Url = "education"
}
}
}
};
base.OnInitialized();
}
}
Data Binding
To show any items, the Blazor Menu requires a data source that you can provide through the Data property. The Menu allows you to display the items both as flat data and hierarchically. Read more about the Blazor Menu data binding...
Navigate Views
A menu is often used to list pages, views, or sections in an application so the user can navigate through them. To do that with a menu, you have two options:
- Use the built-in
UrlFieldin the bound data to populate the URLs in the anchors that the menu will generate if you provide a URL for the given item. This approach is demonstrated in the Creating Blazor Menu example. - Use a Template to generate the desired links (e.g.,
NavLinkcomponents) with your own code to enable fine-tuning.
Read more about the Blazor Menu navigation...
Orientation
The Blazor Menu allows you to control its orientation and display the items horizontally or vertically. Read more about the Blazor Menu orientation...
Templates
You can use the functionality of the built-in templates and customize what is rendered in the items. Read more about the Blazor Menu templates...
Menu Icons
To illustrate the purpose of each menu item, the Blazor Menu allows you to add images, icon classes, or font icons. Read more about the Blazor Menu icons...
Events
The Blazor Menu generates events that you can handle and further customize its behavior. Read more about the Blazor Menu events...
Menu Parameters
The following table lists Context Menu parameters, which are not related to other features on this page. Check the Menu API Reference for a full list of properties, methods and events.
| Attribute | Type and Default Value | Description |
|---|---|---|
Class |
string |
Renders additional CSS class to the main wrapping element of the component. Use it to apply custom styles or override the theme. |
CloseOnClick - bool
|
Determines whether the Menu popups should close when they are clicked. |