Class: NavBar

cercaliagl.control/NavBar


Javascript ES5

const control = new cercaliagl.control.NavBar();

Class for nav bar control which offers to search addresses, calculate routes and search points. This class can be obtained via map object.

All autocomplete components element gets addresses by country priority depends where map is centered. It is possible to access to some functionalities by published methods listed in this page.

To access to NavBar control element you can do it:

const map = new cercaliagl.Map({ target: 'map', controls: [cercaliagl.control.MapControls.NAVBAR] });
const navbarControl = map.getControlByName(cercaliagl.control.MapControls.NAVBAR);

new NavBar()

control/NavBar.js, line 94

Extends

Methods

clear()

control/NavBar.js, line 1290

Clear all navbar autocomplete inputs.

getCercaliaMap(){module:cercaliagl/Map~Map} inherited

control/Control.js, line 106

Returns cercalia Map object

Returns:
Cercalia map.

getClass(){string} inherited

control/Control.js, line 79

Get class name.

Returns:
Class name.

getElement(){Element} inherited

control/Control.js, line 97

Get control HTML Element

Returns:
HTML Element

getId(){string} inherited

control/Control.js, line 70

Get control id.

Returns:
Id.

getMap(){module:maplibre-gl~Map} inherited

control/Control.js, line 115

Returns mapboxgl Map object

getName(){string|null} inherited

control/Control.js, line 88

Get control name. Null if control has not defined name.

Returns:
Class name.

getNavBarAutocompleteService(){module:cercaliagl/service/Autocomplete~Autocomplete}

control/NavBar.js, line 429

Get autocomplete search address service object. More details: module:cercaliagl/service/Autocomplete~Autocomplete.

Returns:
Autocomplete service.

hide() inherited

control/Control.js, line 137

Hide control.

hideButton(buttonName)

control/NavBar.js, line 341

Show button form UI element. Buttons available to show/hide are for widgets: search address, calculate route, search POIs. You can access this values via constants. Show buttonName parameter description.

Name Type Description
buttonName string

Button to hide on NavBar control. Possible values:

  • cercaliagl.control.NavBar.Buttons.ADDRESS
  • cercaliagl.control.NavBar.Buttons.POIS
  • cercaliagl.control.NavBar.Buttons.ROUTING

reset()

control/NavBar.js, line 1281

Reset menu to initial state.

setAutocompleteAddressCallback(fn)

control/NavBar.js, line 472

Set custom callback function for address search. Set null to disable custom function and use default. This is useful if user wants to override default behaviour. Unique parameter received is GeEntity.

Example usage:

navBarControl.setAutocompleteAddressCallback(function(data) {
  const country = data.country.value;
  const municipality = data.municipality.value;
  const coordX = parseFloat(data.coord.x);
  const coordY = parseFloat(data.coord.y);
  console.log(country, municipality, coordY + ',' + coordX);
});
Name Type Description
fn function | null

Callback function. null to use default API behaviour.

setCoordinatesSearchCallback(fn)

control/NavBar.js, line 481

Set custom callback function for coordinates search, same behaviour as customAutocompleteAdressCallback. Set null to disable custom function and use default.

Name Type Description
fn function | null

Callback function. null to use default API behaviour.

show() inherited

control/Control.js, line 146

Show control.

showButton(buttonName)

control/NavBar.js, line 354

Show button form UI element. Buttons available to show/hide are for widgets: search address, calculate route, search POIs. You can access this values via constants. Show buttonName parameter description.

Name Type Description
buttonName string

Button to show on NavBar control. Possible values:

  • cercaliagl.control.NavBar.Buttons.ADDRESS
  • cercaliagl.control.NavBar.Buttons.POIS
  • cercaliagl.control.NavBar.Buttons.ROUTING