Navigation

Structr.Navigation package is intended to help organize navigation menu (nav bar) or/and breadcrumbs in web-application.
Installation
Navigation package is available on NuGet.
dotnet add package Structr.Navigation
Setup
Create menu or breadcrumb navigation item.
public class MenuItem : NavigationItem<MenuItem>
{
	public string Action { get; set; }
	public string Controller { get; set; }
	public string Area { get; set; }
	public string Icon { get; set; }
}
Navigation services uses different providers to get source navigation data. For example: JSON, XML file, Database, or something else.
You can create custom navigation provider:
public class CustomNavigationProvider<TNavigationItem> : INavigationProvider<TNavigationItem>
    where TNavigationItem : NavigationItem<TNavigationItem>, new()
{
    public IEnumerable<TNavigationItem> CreateNavigation() 
    {
        /* Do some logic here */
    }
}
And then setup navigation services:
services.AddNavigation()
    .AddProvider(new CustomNavigationProvider<MenuItem>());
Or you can use one of default implemented navigation provider from list:
​JSON​
​XML​
JSON provider
Create JSON file with hierarchical navigation:
[
  {
    "Id": "Parent_1",
    "Title": "Parent 1",
    "Icon": "icon-1",
    "Action": "Parent_1_Action",
    "Controller": "Parent_1_Controller",
    "Children": [
      {
        "Id": "Child_1_1",
        "Title": "Child 1 1",
        "Icon": "icon-1-1",
        "Action": "Child_1_1_Action",
        "Controller": "Child_1_1_Controller"
      }
    ]
  },
  {
    "Id": "Parent_2",
    "Title": "Parent 2",
    "Icon": "icon-2",
    "Action": "Parent_2_Action",
    "Controller": "Parent_2_Controller"
  },
  {
    "Id": "Parent_3",
    "Title": "Parent 3",
    "Icon": "icon-3",
    "Action": "Parent_3_Action",
    "Controller": "Parent_3_Controller"
  }
]
Setup JSON navigation provider:
services.AddNavigation()
    .AddJson<MenuItem>("path_to_json_file");
XML provider
Create XML file with hierarchical navigation:
<?xml version="1.0" encoding="utf-8" ?>
<menu>
    <item id="Parent_1" title="Parent 1" Action="Parent_1_Action" Controller="Parent_1_Controller" icon="icon-1">
        <item id="Child_1_1" title="Child 1 1" Action="Child_1_1_Action" Controller="Child_1_1_Controller" icon="icon-1-1"/>
    </item>
    <item id="Parent_2" title="Parent 2" Action="Parent_2_Action" Controller="Parent_2_Controller" icon="icon-2"/>
    <item id="Parent_3" title="Parent 3" Action="Parent_3_Action" Controller="Parent_3_Controller" icon="icon-3"/>
</menu>
Setup XML navigation provider:
services.AddNavigation()
    .AddXml<MenuItem>("path_to_xml_file");
Options
When you setup navigation provider you can configure navigation options represents by NavigationOptions<TNavigationItem>.
NavigationOptions<TNavigationItem> properties:
Property name
Property type
Description
ResourceType
Type
Determines a type of resources file whether uses for localization, null by default.
ItemFilter
Func<TNavigationItem, bool>
Determines a filter function for navigation items, item => true by default.
ItemActivator
Func<TNavigationItem, bool>
Determines an activation function for navigation items, item => false by default.
EnableCaching
bool
Determines whether navigation items should be cached, true by default.
Example configure navigation services:
services.AddNavigation()
    .AddJson<MenuItem>("path_to_json_file", (serviceProvider, options) =>
    {
        options.ResourceType = typeof(MenuResource); // Also navigation item should have configured `ResourceName` property.
        options.ItemFilter =
            item => serviceProvider.GetService<IMenuFilter>().Filter(item);
        options.ItemActivator =
            item => serviceProvider.GetService<IMenuActivator>().Activate(item);
    });
Usage
Navigation services uses to organize menu or breadcrumbs. Both of navigation elements should be inherited from NavigationItem<T> that represents basic navigation item.
NavigationItem<T> properties:
Property name
Property type
Description
Id
string
Navigation item identifier.
Title
string
Navigation item title.
ResourceName
string
The key of navigation item in resource file.
Children
IEnumerable<TNavigationItem>
Child navigation elements.
Ancestors
IEnumerable<TNavigationItem>
Returns all parent navigation items.
Descendants
IEnumerable<TNavigationItem>
Returns all child navigation items.
Parent
TNavigationItem
Returns closest parent navigation item.
IsActive
bool
Status of navigation item. Only one navigation item can be active at the same time.
HasChildren
bool
Returns true if the navigation item has a child, otherwise returns false.
HasActiveChild
bool
Returns true if the navigation item has an active child, otherwise returns false.
HasActiveDescendant
bool
Returns true if the navigation item has an active descendant, otherwise returns false.
HasActiveAncestor
bool
Returns true if the navigation item has an active ancestor, otherwise returns false.

Property name	Property type	Description
ResourceType	`Type`	Determines a type of resources file whether uses for localization, `null` by default.
ItemFilter	`Func<TNavigationItem, bool>`	Determines a filter function for navigation items, `item => true` by default.
ItemActivator	`Func<TNavigationItem, bool>`	Determines an activation function for navigation items, `item => false` by default.
EnableCaching	`bool`	Determines whether navigation items should be cached, `true` by default.

Property name	Property type	Description
Id	`string`	Navigation item identifier.
Title	`string`	Navigation item title.
ResourceName	`string`	The key of navigation item in resource file.
Children	`IEnumerable<TNavigationItem>`	Child navigation elements.
Ancestors	`IEnumerable<TNavigationItem>`	Returns all parent navigation items.
Descendants	`IEnumerable<TNavigationItem>`	Returns all child navigation items.
Parent	`TNavigationItem`	Returns closest parent navigation item.
IsActive	`bool`	Status of navigation item. Only one navigation item can be active at the same time.
HasChildren	`bool`	Returns `true` if the navigation item has a child, otherwise returns `false`.
HasActiveChild	`bool`	Returns `true` if the navigation item has an active child, otherwise returns `false`.
HasActiveDescendant	`bool`	Returns `true` if the navigation item has an active descendant, otherwise returns `false`.
HasActiveAncestor	`bool`	Returns `true` if the navigation item has an active ancestor, otherwise returns `false`.

Razor

Last modified 1yr ago