New to Telerik UI for Blazor? Download free 30-day trial

PanelBar for Navigation

The PanelBar can be used to navigate between different pages in the application. It can generate the needed links for you through its UrlField when data binding.

To use the PanelBar for navigating between pages:

  • Add the PanelBar to your application.
  • Provide a collection of models that describe the pages you want the user to navigate to.
  • Populate its UrlField with the corresponding data from the model or provide a Url property in the model.

Use the PanelBar to navigate between pages

@* This a basic example of a PanelBar used as Navigation. *@
@* The items that does not have a set Url are not navigation links *@

<div style="width: 30%;">
    <TelerikPanelBar Data="@Items">
        <PanelBarBindings>
            <PanelBarBinding UrlField="@nameof(PanelBarItem.NavigationUrl)"></PanelBarBinding>
        </PanelBarBindings>
    </TelerikPanelBar>
</div>

@code {
    public List<PanelBarItem> Items { get; set; }

    public class PanelBarItem
    {
        public int Id { get; set; }
        public string Text { get; set; }
        public int? ParentId { get; set; }
        public bool HasChildren { get; set; }
        public string NavigationUrl { get; set; }
    }

    private List<PanelBarItem> LoadFlatData()
    {
        List<PanelBarItem> items = new List<PanelBarItem>();

        items.Add(new PanelBarItem()
        {
            Id = 1,
            Text = "Company",
            ParentId = null,
            HasChildren = true
        });

        items.Add(new PanelBarItem()
        {
            Id = 2,
            Text = "About us",
            ParentId = 1,
            HasChildren = false,
            NavigationUrl = "/company/about-us"
        });

        items.Add(new PanelBarItem()
        {
            Id = 3,
            Text = "Our mission",
            ParentId = 1,
            HasChildren = false,
            NavigationUrl = "/company/our-mission"
        });

        items.Add(new PanelBarItem()
        {
            Id = 4,
            Text = "Products",
            ParentId = 1,
            HasChildren = false,
            NavigationUrl = "/company/products"
        });

        return items;
    }

    protected override void OnInitialized()
    {
        Items = LoadFlatData();

        base.OnInitialized();
    }
}

Notes

  • The UrlField has a default value (Url) and that will be used if present in the model even if you do not define it explicitly.
  • The component uses the NavigationManager from the framework to perform the navigation based on the value from the UrlField.

    • If you have a template that adds anchors, or use a click event to navigate the user yourself, this may lead to double navigation and errors, especially if your model has a field called Url. To avoid such problems, either let the Telerik component do the navigation and remove the application-specific code that does it as well, or remove the URL setting (either rename the model field, or point the UrlField to a non-existing field).

See Also

In this article
Not finding the help you need? Improve this article