devtools: true in Map options.map.areTilesLoaded.fill-extrusion-flood-light-ground-radius property.fill-extrusion-cutoff-fade-range property.config expression chaining through nested styles and other issues related to config scope.map.flyTo with padding option was setting and overriding map's padding.url or tiles is missing from source, i.e. in MapTiler source.config and format expressions not working together.map.areTilesLoaded.fill-extrusion-flood-light-ground-radius property.map.flyTo with padding option was setting and overriding map's padding.url or tiles is missing from source, i.e. in MapTiler source.config expression chaining through nested styles.fill-extrusions not being displayed in alternative projections.raster-elevation property for elevating raster layers to a constant height (e.g. clouds over globe).raster-emissive-strength and fill-extrusion-emissive-strength properties for controlling 3D lighting on buildings and raster layers.Map getConfigProperty method for getting current style config values.config support in terrain options.null.minValue, maxValue, stepValue, values, type) when evaluating config options.center: [0, 0] and zoom: 0 map options were ignored in favor of style settings.slot not taking precedence over the before parameter for layer order."camera-projection": "orthographic" not working in styles with imports.box-sizing: border-box. (h/t @simondriesen) #12982aria-label attribute in attribution control that fails accessibility conformance. (h/t @maggiewachs) #12981load event not firing for the sources whose tiles are 404s.url or tiles for tiled sources during validation.v3.1.0-beta.1null.minValue, maxValue, stepValue, values, type) when evaluating config options.load event not firing for the sources whose tiles are 404s.url or tiles for tiled sources during validation.raster-elevation property for elevating raster layers to a constant height (e.g. clouds over globe).raster-emissive-strength and fill-extrusion-emissive-strength properties for controlling 3D lighting on buildings and raster layers.Map getConfigProperty method for getting current style config values.config support in terrain options.center: [0, 0] and zoom: 0 map options were ignored in favor of style settings.slot not taking precedence over the before parameter for layer order."camera-projection": "orthographic" not working in styles with imports.box-sizing: border-box. (h/t @simondriesen) #12982aria-label attribute in attribution control that fails accessibility conformance. (h/t @maggiewachs) #12981Mapbox GL JS v3 enables the Mapbox Standard Style, a new realistic 3D lighting system, building shadows and many other visual enhancements, and an ergonomic API for using a new kind of rich, evolving, configurable map styles and seamless integration with custom data. You can get more information about the new features in the Mapbox GL JS v3 migration guide.
optimizeForTerrain map option (layer rendering on globe and terrain is always optimized now).*-emissive-strength properties for styling layers with the new lighting API.measureLight expression lights configuration property: Create dynamic styles based on lighting conditions.hsl and hsla color expressions: These expressions allow you to define colors using hue, saturation, and lightness format.fill-extrusion-cutoff-fade-range and model-cutoff-fade-range style properties.slots, pre-specified locations in the style, where your layer can be added (e.g., on top of existing land layers but below all labels).config expression: Retrieves the configuration value for the given option.style option is provided to the Map constructor, the Mapbox Standard Style is now enabled as a default.style.import.load event to track the loading of imported style fragments.raster-color paint properties.raster-value expression: Returns the raster value of a pixel computed via raster-color-mix.vertical-range style property.icon-image-cross-fade property, which controls the transitioning between the two variants of an icon image.random expression: Generate random values using this expression. Use this expression to generate random values, which can be particularly helpful for introducing randomness into your map data.distance expression: Returns the shortest distance in meters between the evaluated feature and the input geometry.symbol-z-elevate style property.renderstart event, which, combined with the render event, can be used to measure rendering frame duration.padding is used.tabindex when the map is not interactive; remove role="list" from the attribution control; add role="img" to markers (h/t @kumiko-haraguchi and @aviroopjana).queryRenderedFeatures results on maps with globe and terrain.map hasImage and updateImage after the map was removed.line-border.v3.0.0-rc.2setStyle.queryRenderedFeatures when the model layer is present in the style.Mapbox GL JS v3 enables the Mapbox Standard Style, a new realistic 3D lighting system, building shadows and many other visual enhancements, and an ergonomic API for using a new kind of rich, evolving, configurable map styles and seamless integration with custom data. You can get more information about the new features in the Mapbox GL JS v3 migration guide. Changes since v3.0.0-rc.1:
setConfigProperty not taking effect for certain properties.symbol-z-elevate elevating symbols over invisible fill extrusions (with zero opacity).lights objects.Mapbox GL JS v3 enables the Mapbox Standard Style, a new realistic 3D lighting system, building shadows and many other visual enhancements, and an ergonomic API for using a new kind of rich, evolving, configurable map styles and seamless integration with custom data. You can get more information about the new features in the Mapbox GL JS v3 migration guide. Changes since v3.0.0-beta.5:
slot in custom layers.line-border.raster-color sometimes causing memory issues.fill-extrusion-color causing rendering issues in 3D lighting mode.Mapbox GL JS v3 enables the Mapbox Standard Style, a new realistic 3D lighting system, building shadows and many other visual enhancements, and an ergonomic API for using a new kind of rich, evolving, configurable map styles and seamless integration with custom data. You can get more information about the new features in the Mapbox GL JS v3 migration guide. Changes since v3.0.0-beta.4:
renderstart event, which combined with render event can be used to measure rendering frame duration.setData to animate 3D models.hillshade-illumination-direction to align with light direction if hillshade-illumination-anchor is not set to viewport.fragment: false not to be loaded as basemap imports.map hasImage and updateImage after the map was removed.Mapbox GL JS v3 enables the Mapbox Standard Style, a new realistic 3D lighting system, building shadows and many other visual enhancements, and an ergonomic API for using a new kind of rich, evolving, configurable map styles and seamless integration with custom data. You can get more information about the new features in the Mapbox GL JS v3 migration guide. Changes since v3.0.0-beta.3:
hillshade-emissive-strength property for styling the hillshade layer with the new lighting API.raster-color lookup texture sampling.queryRenderedFeatures results on maps with globe and terrain.Mapbox GL JS v3 enables the Mapbox Standard Style, a new realistic 3D lighting system, building shadows and many other visual enhancements, and an ergonomic API for using a new kind of rich, evolving, configurable map styles and seamless integration with custom data. You can get more information about the new features in the Mapbox GL JS v3 migration guide. Changes since v3.0.0-beta.2:
fill-extrusion-cutoff-fade-range and model-cutoff-fade-range style properties.vertical-range style property.symbol-z-elevate style property.map setLights or setConfigProperty.map transformRequest option not being applied to model URLs.GL_INVALID_OPERATION: Vertex buffer is not big enough for the draw call warnings in certain map views.visibility not being re-evaluated when using setConfigProperty.setStyle on a map with style imports.tabindex when the map is not interactive; remove role="list" from the attribution control; add role="img" to markers (h/t @kumiko-haraguchi and @aviroopjana).transition options from imports.Mapbox GL JS v3 enables the Mapbox Standard Style, a new realistic 3D lighting system, building shadows and many other visual enhancements, and an ergonomic API for using a new kind of rich, evolving, configurable map styles and seamless integration with custom data. You can get more information about the new features in the Mapbox GL JS v3 migration guide.
Changes since v3.0.0-beta.1:
style.import.load event to track loading of imported style fragments and ensure style.load is only called once per style.glyphs endpoint specified (falling back to a default Mapbox endpoint).optimizeForTerrain map option (layer rendering on terrain is always optimized now).setStyle when using the Standard style failed.map.removeSource didn't work properly with the Standard style.map.setLayoutProperty not working on a custom layer.padding is used.Mapbox GL JS v3 enables the Mapbox Standard Style, a new realistic 3D lighting system, building shadows, nested, configurable styles, and many other visual enhancements, and an ergonomic API for using a new kind of rich, evolving, configurable map styles and seamless integration with custom data. You can get more information about the new features in the Mapbox GL JS v3 migration guide.
fill-extrusion and other layers to support 3D lighting styling.icon-image-cross-fade property, which controls the transitioning between the two variants of an icon image.raster-color paint properties.hsl and hsla color expressions: These expressions allow you to define colors using hue, saturation, and lightness format.random expression: Generate random values using this expression. Use this expression to generate random values, which can be particularly helpful for introducing randomness into your map data.measureLight expression lights configuration property: Create dynamic styles based on lighting conditions.config expression: Retrieves the configuration value for the given option.raster-value expression: Returns the raster value of a pixel computed via raster-color-mix.distance expression: Returns the shortest distance in meters between the evaluated feature and the input geometry.slots, pre-specified locations in the style, where your layer can be added (e.g., on top of existing land layers but below all labels).style option is provided to the Map constructor, the Mapbox Standard Style is now enabled as a default.respectPrefersReducedMotion map option (#12694)isPointOnSurface map method to determine if the given point is located on a visible map surface. (#12695)referrerPolicy option for the transformRequest function when using fetch (#12590) (h/t robertcepa)prefers-reduced-motion is enabled (#12631)