Skip to main content

DevExpress v24.2 Update — Your Feedback Matters

Our What's New in v24.2 webpage includes product-specific surveys. Your response to our survey questions will help us measure product satisfaction for features released in this major update and help us refine our plans for our next major release.

Take the survey Not interested

DxTreeViewNode.UrlMatchMode Property

Specifies whether the item becomes selected if its DxTreeViewNode.NavigateUrl property value matches the active web page. If the control does select the item, it expands all parent items.

Namespace: DevExpress.Blazor

Assembly: DevExpress.Blazor.v24.2.dll

NuGet Package: DevExpress.Blazor

#Declaration

C#
[DefaultValue(null)]
[Parameter]
public NavigationUrlMatchMode? UrlMatchMode { get; set; }

#Property Value

Type Default Description
Nullable<NavigationUrlMatchMode> null

A NavigationUrlMatchMode enumeration value.

Available values:

Name Description
None

Automatic selection synchronization is disabled.

CurrentPath

The component selects an item if the item’s NavigateUrl property value matches the current browser URL. The query string appended to the URL is ignored.

Prefix

The component selects an item if the item’s NavigateUrl property value starts with the current browser URL and vice versa.

Exact

The component selects an item if the item’s NavigateUrl property value matches the current browser URL.

#Remarks

Use a node’s UrlMatchMode property to specify whether the TreeView selects this node if its NavigateUrl property matches the current browser URL. If you do not specify the item’s UrlMatchMode property, the Accordion uses its own UrlMatchMode property value.

The following example sets the first item’s UrlMatchMode to Exact to select the Overview page only when it is active:

<DxTreeView AllowSelectNodes="true" UrlMatchMode="NavigationUrlMatchMode.Prefix" CssClass="app-sidebar">
    <Nodes>
        <DxTreeViewNode NavigateUrl="./" Text="Overview" UrlMatchMode="NavigationUrlMatchMode.Exact"></DxTreeViewNode>
        <DxTreeViewNode NavigateUrl="grid" Text="Grid">
    </Nodes>
</DxTreeView>

MatchMode on item level

See Also