profile/themes/keepit/exampleSite/content/posts/theme-documentation-mapbox-shortcode/index.zh-cn.md

weight, title, date, lastmod, draft, author, authorLink, description, images, resources, tags, categories, hiddenFromHomePage, toc, mapbox

weight	title	date	lastmod	draft	author	authorLink	description	images	resources	tags	categories	hiddenFromHomePage	toc	mapbox
7	主题文档 - mapbox Shortcode	2020-03-03T13:29:59+08:00	2020-03-03T13:29:59+08:00	false	Dillon	https://dillonzq.com	mapbox shortcode 使用 Mapbox GL JS 库提供互动式地图的功能.		name src featured-image featured-image.jpg	shortcodes	documentation	true	enable false	lightStyle darkStyle mapbox://styles/mapbox/light-zh-v1?optimize=true mapbox://styles/mapbox/dark-zh-v1?optimize=true

{{< version 0.2.0 >}}

mapbox shortcode 使用 Mapbox GL JS 库提供互动式地图的功能.

Mapbox GL JS 是一个 JavaScript 库，它使用 WebGL, 以 vector tiles 和 Mapbox styles 为来源, 将它们渲染成互动式地图.

mapbox shortcode 有以下命名参数来使用 Mapbox GL JS:

• lng [必需] (第一个位置参数)

  地图初始中心点的经度, 以度为单位.

• lat [必需] (第二个位置参数)

  地图初始中心点的纬度, 以度为单位.

• zoom [可选] (第三个位置参数)

  地图的初始缩放级别, 默认值是 10.

• marked [可选] (第四个位置参数)

  是否在地图的初始中心点添加图钉, 默认值是 true.

• light-style [可选] (第五个位置参数)

  浅色主题的地图样式, 默认值是前置参数或者网站配置中设置的值.

• dark-style [可选] (第六个位置参数)

  深色主题的地图样式, 默认值是前置参数或者网站配置中设置的值.

• navigation [可选]

  是否添加 NavigationControl, 默认值是前置参数或者网站配置中设置的值.

• geolocate [可选]

  是否添加 GeolocateControl, 默认值是前置参数或者网站配置中设置的值.

• scale [可选]

  是否添加 ScaleControl, 默认值是前置参数或者网站配置中设置的值.

• fullscreen [可选]

  是否添加 FullscreenControl, 默认值是前置参数或者网站配置中设置的值.

• width [可选]

  地图的宽度, 默认值是 100%.

• height [可选]

  地图的高度, 默认值是 20rem.

一个简单的 mapbox 示例:

{{</* mapbox 121.485 31.233 12 */>}}
或者
{{</* mapbox lng=121.485 lat=31.233 zoom=12 */>}}

呈现的输出效果如下:

{{< mapbox 121.485 31.233 12 >}}

一个带有自定义样式的 mapbox 示例:

{{</* mapbox -122.252 37.453 10 false "mapbox://styles/mapbox/streets-zh-v1?optimize=true" */>}}
或者
{{</* mapbox lng=-122.252 lat=37.453 zoom=10 marked=false light-style="mapbox://styles/mapbox/streets-zh-v1?optimize=true" */>}}

呈现的输出效果如下:

{{< mapbox -122.252 37.453 10 false "mapbox://styles/mapbox/streets-zh-v1?optimize=true" >}}