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.

Telerik UI for Blazor Ninja image

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

  1. Use the TelerikMenu tag to add the component to your razor page.

  2. Populate the Data property with the collection of items that you want to appear in the menu. The Menu will automatically recognize property names like Id, ParentId, Text and 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...

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 UrlField in 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., NavLink components) 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...

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...

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.

Next Steps

See Also

In this article