ITADN
mapbox/mapbox-gl-js

版本发布 8

v3.19.1
? · 2026-03-04

### Bug fixes 🐞 - Removed the unused `@types/mapbox__point-geometry` package that was causing some Typescript builds to fail

v3.19.0-beta.2预发布
? · 2026-02-11

### Features and improvements ✨ - Promote elevated lines properties to stable: `line-z-offset` and `line-elevation-reference`. - Add experimental `text-size-scale-range` and `icon-size-scale-range` style properties. - Add experimental `Map#setScaleFactor`/`Map#getScaleFactor` methods for controlling symbol layer scaling. - Apply global scale factor to images within `text-field`. ### Bug fixes 🐞 - Fix `RasterArrayTileSource#reload()` not working correctly. - Add request cancellation support to the `ModelSource`. - Fix flickering of aliased thin lines. - Fix elevated line bevel join artifacts at sharp corners.

v3.18.0-beta.1预发布
? · 2025-12-18

### Features and improvements ✨ * Add support for `text-rotate`, `text-size`, and `text-offset` properties in appearances. * Add `shadow-draw-before-layer` property to directional light, allowing control over shadow draw order in the layer stack. * Add `model-allow-density-reduction` property to model layers. (h/t @JoshuaJMoore) ### Bug fixes 🐞 * Fix an error when querying multipolygons in `dynamic: true` mode. * Fix `AttributionControl` links sanitization. * Fix appearances with no `icon-size` using the default value instead of the layout-defined one. * Fix updates to model source via `ModelSource.setModels` while models are still loading. * Fix polygon clipping precision errors causing rendering artifacts in elevated structures. * Preserve featuresets in `map.getStyle()` output. * Expose TypeScript types from `@mapbox/mapbox-gl-style-spec` for direct imports.

v3.17.0
? · 2025-12-03

### Features and improvements ✨ - Add experimental [ESM support](https://github.com/mapbox/mapbox-gl-js/issues/13414#issuecomment-3502216725). - Make `line-emissive-strength` data-driven. - Remove experimental flag from the `extra_bounds` property of raster and vector sources. - Remove experimental flag from `model` layer. - Remove experimental flag from `building` layer. - Improve vector icons rasterization performance. - Improve shadow rendering performance. - Improve `building` layer performance. - Improve shader initialization performance. ### Bug fixes 🐞 - Fix polygon rendering for dynamic GeoJSON sources. - Fix `raster-array` layers not working on iOS < 18.4. - Fix a performance issue for symbol layers with zero fade duration and static camera. - Fix occasional WebGL texture warnings when rendering terrain. - Fix features not being localized in dynamic filters when a worldview is set. - Fix an issue with clipping models on Standard. - Fix an issue with models flashing on `setData`. - Fix an issue with incorrect scoping of models added during runtime. - Fix line patterns not elevating properly on HD roads. - Sanitize attributions in `AttributionControl`. - Correctly support filtered features in appearances. - Fix an issue occuring when expressions are used in appearances. - Fix appearance optimization that resulted in wrong appearances being rendered. - Fix appearance icons not changing when feature state changed multiple times. - Improve TypeScript types.

v3.16.0
? · 2025-10-23

### Features and improvements ✨ - Introduce experimental Appearances API for managing layer styling based on feature state. - Add `Map` `setLayerProperty` that combines `setLayoutProperty` & `setPaintProperty` into one method for convenience. - Add support for node/material overrides & other improvements to `model` source and layer. - Various improvements & fixes for upcoming 3D features (indoor, procedural buildings & elevated roads). - Add response headers to the `sourcedata` event data. - Improve TypeScript types for style specification. ### Bug fixes 🐞 - Fix raster particle layer not rendering correctly on styles with emissive light. - Fix icons of different sizes rendering incorrectly in appearances. - Fix worldview filtering with dynamic expressions. - Improve accuracy of `queryRenderedFeatures` for model layers. - Fix a bug with heatmap sometimes disappearing after switching projection. - Fix rendering of model layer with vector source on globe projection. - Fix flickering of fill-extrusion buildings when using clip layers. - Fix inaccuracies in 3D model query intersection. - Fix the passing of `GeolocationPosition` to `geolocate` event listeners. - Fix the placement of line-aligned text with a non-default `scaleFactor`.

v3.15.0
? · 2025-09-10

## 3.15.0 ### Features and improvements ✨ - Add `queryRasterValue` method for querying values in `raster-array` layers. - Add `icon-image-use-theme` property. - Add support for Mapbox vector tiles with precalculated line metrics (for line gradients). - Improve HD Roads loading performance. - Optimize applying LUT when updating images at runtime. - Improve TypeScript types in Style Spec validation methods. - Slightly improve `hsla` expression performance. - Optimize applying LUT for patterns. - Round `queryRasterValue` results to 12 decimal digits to fix precision issues. - Improvements on typing and testing. ### Bug fixes 🐞 - Fix an issue with refreshing expired raster array tiles. - Fix an error on GeoJSON with `"Infinity"` and similar ids. - Fix `GL_INVALID_VALUE` console warning on Mapbox Satellite Standard and a few other styles. - Fix model layer positioning during globe to mercator transition. - Fix an issue with incorrect transparency for some icons with LUT applied. - Fix an issue where updating `*-occlusion-opacity` properties didn't have any effect. - Fix an issue with MRT layers throwing an error when reloading. - Fix occlusion layer ordering. - Fix an issue where using too many data-driven properties on the symbol layer could break the map. - Fix gradients and interpolations with fully-transparent colors. - Fix model layer density reduction. - Fix performance regression on styles that use feature-state expressions.

v3.14.0
? · 2025-07-30

### Breaking changes ⚠️ - Imported styles will use the `glyphs` URL template from the root style instead of their own. ### Features and improvements ✨ - Add a `split` expression to divide a string into an array of substrings based on a specified delimiter. - Improve memory usage for GeoJSON sources. ### Bug fixes 🐞 - Fix an issue with querying rendered features during the globe-to-Mercator transition. - Fix resources cleanup when removing a map with a terrain or/and vector icons. - Fix an issue where a single primary image was not rendered correctly with `icon-image-cross-fade`. - Fix an edge case involving the mixing of vertical and horizontal writing modes. - Fix rendering of multiple `raster` layers from a single `raster-array` source. - Fix restoration of maps with background patterns, heatmap, image, video, or raster sources after WebGL context loss. - Fix memory spike when calling `setData` on large datasets.

v3.14.0-beta.2预发布
? · 2025-07-23

### Bug fixes 🐞 - Fix rendering of multiple `raster` layers from a single `raster-array` source. - Fix restoration of maps with background patterns, heatmap, image, video, or raster sources after WebGL context loss.