Interface: CosmographSearchConfigInterface<T>

Extends

Omit<SearchConfigInterface<T>, "placeholderRenderer" | "footerComponent" | "searchFn">

Type Parameters

Type Parameter
`T`

Properties

accessor?

optional accessor: string

Data column key to access time values for the CosmographSearch. Make sure it’s included in pointIncludeColumns if you’re not using this column as other point accessor.

Default

undefined

placeholderText?

optional placeholderText: string

The text to display in the search input placeholder.

Default

'Search...'

showAccessorsMenu?

optional showAccessorsMenu: boolean

Whether to show the accessors menu.

Default

true

multifieldSearch?

optional multifieldSearch: boolean

Whether to search across all fields in the table, not just the accessor field. When enabled, accessor field matches will have priority over other field matches.

Default

false

suggestionFields?

optional suggestionFields: Record<string, string>

A map of field names (accessors) to their display labels for the suggestion list. The order of fields in the map determines the display order in the suggestion. If provided, the suggestion renderer will display these fields and their values. The main accessor will be added first if not present in this map. Example: { ‘id’: ‘Point ID’, ‘weight’: ‘Weight’ }

Default

undefined

suggestionFieldsPalette?

optional suggestionFieldsPalette: string[]

An array of CSS-valid colors to use for the suggestion fields. Colors will be applied in order and cycled through if not enough colors are provided.

Default

['#fbb4aebf', '#b3cde3bf', '#ccebc5bf', '#decbe4bf', '#fed9a6bf', '#ffffccbf', '#e5d8bdbf', '#fddaecbf'],

suggestionTruncationLength?

optional suggestionTruncationLength: number

Maximum number of characters to show before and after a search match in suggestions. If the result is longer than this limit, it will be truncated with ”…” to indicate truncation. Set to 0 to disable truncation and show full text.

Default

preserveSelectionOnUnmount?

optional preserveSelectionOnUnmount: boolean

Preserves the selection on unmount.

Default

false

showFooter?

optional showFooter: boolean

Whether to show footer with “Select all results” button and the counter of results below the search suggestion dropdown. When enabled, displays a footer below the suggestion list.

Default

false

onSelectAll()?

optional onSelectAll: (suggestionIndexes) => void

Callback triggered when all suggestions from the results are selected using the “Select all results” button.

Parameters

Parameter	Type	Description
`suggestionIndexes`	`undefined` \| `number`[]	An array of selected suggestion indexes or undefined if no suggestions are selected

Returns

void

disabled?

optional disabled: boolean

Whether the search component is disabled.

Default

false

Inherited from

Omit.disabled

openListUpwards?

optional openListUpwards: boolean

Whether to open the suggestion list above the input field instead of below.

Default

false

Inherited from

Omit.openListUpwards

onInput()?

optional onInput: (value, results, event) => void

Callback invoked when the input value changes. This callback should be used to process the query, retrieve matching items, and return them.

Parameters

Parameter	Type	Description
`value`	`string`	The current value of the input field
`results`	`T`[]	An array of found items of type T matching the current query
`event`	`InputEvent`	The input event object

Returns

void

Inherited from

Omit.onInput

debounceTime?

optional debounceTime: number

The debounce duration (in milliseconds) used to delay the onInput callback. Helps prevent excessive callback invocations during rapid typing.

Default

Inherited from

Omit.debounceTime

suggestionsLimit?

optional suggestionsLimit: number

The maximum number of suggestions to retrieve and include in the results. When the number of suggestions exceeds this limit, the rest will be omitted. This can be tweaked to improve performance when dealing with large data sets.

Default

Inherited from

Omit.suggestionsLimit

maxVisibleItems?

optional maxVisibleItems: number

The maximum items visible in the suggestions dropdown at once. When the number of suggestions exceeds this value, a scrollbar will be added.

Default

Inherited from

Omit.maxVisibleItems

onSelect()?

optional onSelect: (suggestion) => void

Callback triggered when a suggestion from the autosuggest list is selected.

Parameters

Parameter	Type	Description
`suggestion`	`T`	The selected suggestion item of type T

Returns

void

Inherited from

Omit.onSelect

suggestionRenderer()?

optional suggestionRenderer: (suggestion, value?) => string | HTMLElement

Customize how each suggestion is rendered.

Parameters

Parameter	Type	Description
`suggestion`	`T`	The suggestion item of type T to render
`value?`	`string`	-

Returns

string | HTMLElement

A string containing HTML or an HTMLElement representing the rendered suggestion

Inherited from

Omit.suggestionRenderer

selectedSuggestionRenderer()?

optional selectedSuggestionRenderer: (suggestion, value?) => string

Function to convert a suggestion item to a string for display in the input field after selection.

Parameters

Parameter	Type	Description
`suggestion`	`T`	The suggestion item to convert
`value?`	`string`	The current value of the input field

Returns

string

The string representation of the suggestion

Inherited from

Omit.selectedSuggestionRenderer

inputClassName?

optional inputClassName: string

Custom CSS class name to apply to the search input field.

Default

undefined

Inherited from

Omit.inputClassName

suggestionListClassName?

optional suggestionListClassName: string

Custom CSS class name to apply to the autosuggest list container.

Default

undefined

Inherited from

Omit.suggestionListClassName

minSearchLength?

optional minSearchLength: number

The minimum number of characters required to trigger a search.

Default

Inherited from

Omit.minSearchLength

onEnter()?

optional onEnter: (value, results) => void

Callback invoked when the return (Enter) key is pressed. This callback should process the current input value to find the matching items and return them.

Parameters

Parameter	Type	Description
`value`	`string`	The current value of the input field when Enter is pressed
`results`	`T`[]	An array of found items of type T matching the current query

Returns

void

Inherited from

Omit.onEnter

onClear()?

optional onClear: () => void

Callback invoked when the clear button is clicked.

Returns

void

Inherited from

Omit.onClear

highlightMatch?

optional highlightMatch: boolean

Whether to highlight the matching text in the suggestions.

Default

true

Inherited from

Omit.highlightMatch

noResultsText?

optional noResultsText: null | string

Text to display when no search results are found. Set to null to hide the no results message.

Default

'No results found'

Inherited from

Omit.noResultsText

Upgrade from v1 CosmographBars