Provides functionality for the search system within the application.
You can implement your own result provider by listening to the search hook:
window.addHook('search', function(query) {});
.
The query
object has the following members:
term
: The term for which the user has searched.confirmed
: A boolean indicating if the user has pressed enter after searching. You should not search online or do heavy processing unless the user has confirmed the search term.addResult(result)
: A method to add a result to the query.
The result
object can have the following members (title
is required, as well as one of position
and bounds
):
title
: The label for this result. Will be interpreted as HTML, so make sure to escape properly.description
: Secondary information for this result. Will be interpreted as HTML, so make sure to escape properly.position
: A L.LatLng object describing the position of this result.bounds
: A L.LatLngBounds object describing the bounds of this result.layer
: An ILayer to be added to the map when the user selects this search result. Will be generated if not set. Set tonull
to prevent the result from being added to the map.icon
: A URL to an icon to display in the result list. Should be 12x12 pixels.onSelected(result, event)
: A handler to be called when the result is selected. May returntrue
to prevent the map from being repositioned. You may reposition the map yourself or do other work.onRemove(result)
: A handler to be called when the result is removed from the map (because another result has been selected or the search was cancelled by the user).
Classes
Methods
-
static addSearchResult(query, data, guid)
-
Adds a search result for a portal to the search query results.
Parameters:
Name Type Description query
Object The search query object to which the result will be added.
data
Object The data for the search result. This includes information such as title, team, level, health, etc.
guid
string GUID if the portal.
-
static doSearch(term, confirmed)
-
Initiates a search with the specified term and confirmation status.
Parameters:
Name Type Description term
string The search term.
confirmed
boolean Indicates if the search term is confirmed.
-
static setup()
-
Sets up the search input field and button functionality.