[]
        
(Showing Draft Content)

Search and Filtering

C1HamburgerMenu supports search through C1HamburgerMenuSearchPanel and the menu ApplySearch methods.

Search can be applied automatically while users enter text or only when users initiate a search action. The SearchMode property determines when the search is applied, and SearchDelay specifies the delay before an automatic search executes.

  • When SearchMode is set to SearchMode.Always, the search is applied as the user enters text. Use SearchDelay to delay the operation and avoid running a search for every keystroke.

  • When SearchMode is set to SearchMode.SearchClick, the search is applied only after the user initiates a search action. Keep ShowSearchButton set to true when using this mode.

Search highlighting and filtering are independent behaviors. HighlightSearchResultsMode marks matching text using the item highlighted style, while FilterSearchResults hides items that do not match the search text. Applications can enable either behavior separately or combine them.

  • SearchHighlightMode.All highlights every matching occurrence within an item. SearchHighlightMode.OnlyFirst highlights only the first matching occurrence

  • SearchHighlightMode.None disables highlighting.

When SearchThroughVisibleItems is set to true, the search evaluates only items currently visible in the menu hierarchy.

C1HamburgerMenuSearchPanel requires a visible menu. When using a search panel, set ExpandedMode to ExpandedMode.Always.

c1HamburgerMenu1.ExpandedMode = ExpandedMode.Always;