Skip to content

Instantly share code, notes, and snippets.

@chriswhong chriswhong/
Last active May 30, 2019

What would you like to do?
Clickable Markers in MapboxGL

This example shows how to extend mapboxGL's Marker class to add custom functionality on click.


MapboxGL has a very convenient Marker class that can be used to quickly get markers on the map with a few lines of code (versus the more complex method of adding sources and layers). They behave a bit differently from the rest of the map features because they are actually HTML elements overlaid on the map canvas.

The stock markers are great, and they are SVG so you can color them by passing in a color option! However, the only interactivity you can easily set up is a popup. When you google 'clickable markers', the examples you find are all using symbol layers with queryRenderedFeatures.

I wanted to trigger navigation in a single page app using the stock Markers and determined a simple extension of the class would help me accomplish this. You can also see these markers in action at

How it works

Marker already has an internal method _onMapClick which is used by the popup functionality. The extension does two things:

  1. Adds the method onMapClick which takes a function and can be chained with other methods.

  2. Overrides _onMapClick to trigger _handleClick if it exists.

Some CSS is used to set the pointer to a cursor on hover, and to change the fill.

<!doctype html>
<html lang="en">
<meta charset="utf-8">
<link href="" rel="stylesheet" />
html, body, #mapContainer {
height: 100%;
margin: 0;
/* Change the cursor to a pointer on hover so the user knows it's clickable */
.mapboxgl-marker:hover {
cursor: pointer;
/* darken the marker on hover */
.mapboxgl-marker:hover svg > g > g:nth-child(2) {
fill: #7993a5;
#info-box {
position: absolute;
z-index: 10;
left: 7px;
font-family: sans-serif;
background: #dedede;
padding: 12px;
border-radius: 8px;
font-size: 2rem;
border: 1px solid #969696;
bottom: 34px;
<div id="mapContainer"></div>
<div id="info-box">Click a City</div>
<script src=''></script>
mapboxgl.accessToken = 'pk.eyJ1IjoiY3dob25nIiwiYSI6IjAyYzIwYTJjYTVhMzUxZTVkMzdmYTQ2YzBmMTM0ZDAyIn0.owNd_Qa7Sw2neNJbK6zc1A';
const map = new mapboxgl.Map({
container: 'mapContainer',
style: 'mapbox://styles/mapbox/light-v9',
center: [-100.52, 37.67],
zoom: 3.05,
pitch: 36,
hash: true,
// Add zoom and rotation controls to the map.
map.addControl(new mapboxgl.NavigationControl());
// extend mapboxGL Marker so we can pass in an onClick handler
class ClickableMarker extends mapboxgl.Marker {
// new method onClick, sets _handleClick to a function you pass in
onClick(handleClick) {
this._handleClick = handleClick;
return this;
// the existing _onMapClick was there to trigger a popup
// but we are hijacking it to run a function we define
_onMapClick(e) {
const targetElement =;
const element = this._element;
if (this._handleClick && (targetElement === element || element.contains((targetElement)))) {
const cities = [
name: 'New York',
coordinates: [ -73.969145, 40.669116 ],
name: 'Washington, D.C.',
coordinates: [ -77.047119, 38.856820 ],
name: 'Chicago',
coordinates: [ -87.662659, 41.865470 ],
name: 'Seattle',
coordinates: [ -122.266846, 47.591346 ],
name: 'St. Louis',
coordinates: [ -90.304871, 38.634036 ],
name: 'Houston',
coordinates: [ -95.377808, 29.754840 ],
cities.forEach((city) => {
new ClickableMarker()
.onClick(() => { // onClick() is a thing now!
.innerHTML = `You clicked ${}!`;
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
You can’t perform that action at this time.