--- layout: api title: "v1.6.4 JavaScript Library: L.mapbox.shareControl(id|url, options)" categories: api version: v1.6.4 permalink: /api/v1.6.4/l-mapbox-sharecontrol ---

L.mapbox.shareControl(id|url, options)

Adds a "Share" button to the map, which can be used to share the map to Twitter or Facebook, or generate HTML for a map embed.

Extends: L.Control

Options Value Description
id or url optional string Either a
  • id string examples.map-foo
  • A URL to TileJSON, like {{site.tileApi}}/v3/examples.map-0l53fhk2.json If not supplied, the TileJSON from the map is used.
options object Options for L.Control Also accepts the following options:
  • url: the URL of a page to which the share control will link instead of the URL of the current page or that specified in TileJSON data.

Example:

var map = L.map('map', 'examples.map-i875kd35')
    .setView([37, -77], 5)
    .addControl(L.mapbox.shareControl());

Returns: Returns a L.mapbox.shareControl object.