Searching

xplr supports searching paths using different algorithm. The search mechanism generally appears between filters and sorters in the Sort & filter panel.

Example:

fzy:foo↓

This line means that the nodes visible on the table are being filtered using the fuzzy matching algorithm on the input foo. The arrow means that ranking based ordering is being applied, i.e. sorters are being ignored.

Node Searcher Applicable

Node Searcher contains the following fields:

pattern

The patterns used to search.

Type: string

recoverable_focus

Where to focus when search is cancelled.

Type: nullable string

algorithm

Search algorithm to use. Defaults to the value set in xplr.config.general.search.algorithm.

It can be one of the following:

  • Fuzzy
  • Regex

unordered

Whether to skip ordering the search result by algorithm based ranking. Defaults to the value set in xplr.config.general.search.unordered.

Type: boolean

Example:

local searcher = {
  pattern = "pattern to search",
  recoverable_focus = "/path/to/focus/on/cancel",
  algorithm = "Fuzzy",
  unordered = false,
}

xplr.util.explore({ searcher = searcher })

See xplr.util.explore.