LineLayerState

The state holder for LineLayer's layer properties.

See also

Constructors

Link copied to clipboard

Construct an default LineLayerState.

Properties

Link copied to clipboard

An expression specifying conditions on source features. Only features that match the filter are displayed. Zoom expressions in filters are only evaluated at integer zoom levels. The ["feature-state", ...] expression is not supported in filter expressions. The ["pitch"] and ["distance-from-center"] expressions are supported only for filter expressions on the symbol layer.

Link copied to clipboard

The interactions associated with this layer.

Link copied to clipboard

Blur applied to the line, in pixels. Default value: 0. Minimum value: 0. The unit of lineBlur is in pixels.

Link copied to clipboard

Defines the transition of lineBlur.

Link copied to clipboard

The color of the line border. If line-border-width is greater than zero and the alpha value of this color is 0 (default), the color for the border will be selected automatically based on the line color. Default value: "rgba(0, 0, 0, 0)".

Link copied to clipboard
Link copied to clipboard

Overrides applying of color theme for lineBorderColor if "none" is set. To follow default theme "default" should be set. Default value: "default".

Link copied to clipboard

The width of the line border. A value of zero means no border. Default value: 0. Minimum value: 0.

Link copied to clipboard
Link copied to clipboard

The display of line endings. Default value: "butt".

Link copied to clipboard

The color with which the line will be drawn. Default value: "#000000".

Link copied to clipboard

Defines the transition of lineColor.

Link copied to clipboard

Overrides applying of color theme for lineColor if "none" is set. To follow default theme "default" should be set. Default value: "default".

Link copied to clipboard

Defines the slope of an elevated line. A value of 0 creates a horizontal line. A value of 1 creates a vertical line. Other values are currently not supported. If undefined, the line follows the terrain slope. This is an experimental property with some known issues: - Vertical lines don't support line caps - line-join: round is not supported with this property

Link copied to clipboard

Specifies the lengths of the alternating dashes and gaps that form the dash pattern. The lengths are later scaled by the line width. To convert a dash length to pixels, multiply the length by the current line width. Note that GeoJSON sources with lineMetrics: true specified won't render dashed lines to the expected scale. Also note that zoom-dependent expressions will be evaluated only at integer zoom levels. Minimum value: 0. The unit of lineDasharray is in line widths.

Link copied to clipboard

Decrease line layer opacity based on occlusion from 3D objects. Value 0 disables occlusion, value 1 means fully occluded. Default value: 1. Value range: 0, 1

Link copied to clipboard

Selects the base of line-elevation. Some modes might require precomputed elevation data in the tileset. Default value: "none".

Link copied to clipboard

Controls the intensity of light emitted on the source features. Default value: 0. Minimum value: 0. The unit of lineEmissiveStrength is in intensity.

Link copied to clipboard
Link copied to clipboard

Draws a line casing outside of a line's actual path. Value indicates the width of the inner gap. Default value: 0. Minimum value: 0. The unit of lineGapWidth is in pixels.

Link copied to clipboard

Defines the transition of lineGapWidth.

Link copied to clipboard

A gradient used to color a line feature at various distances along its length. Defined using a step or interpolate expression which outputs a color for each corresponding line-progress input value. line-progress is a percentage of the line feature's total length as measured on the webmercator projected coordinate plane (a number between 0 and 1). Can only be used with GeoJSON sources that specify "lineMetrics": true.

Link copied to clipboard

Overrides applying of color theme for lineGradient if "none" is set. To follow default theme "default" should be set. Default value: "default".

Link copied to clipboard

The display of lines when joining. Default value: "miter".

Link copied to clipboard

Used to automatically convert miter joins to bevel joins for sharp angles. Default value: 2.

Link copied to clipboard

Opacity multiplier (multiplies line-opacity value) of the line part that is occluded by 3D objects. Value 0 hides occluded part, value 1 means the same opacity as non-occluded part. The property is not supported when line-opacity has data-driven styling. Default value: 0. Value range: 0, 1

Link copied to clipboard
Link copied to clipboard

The line's offset. For linear features, a positive value offsets the line to the right, relative to the direction of the line, and a negative value to the left. For polygon features, a positive value results in an inset, and a negative value results in an outset. Default value: 0. The unit of lineOffset is in pixels.

Link copied to clipboard

Defines the transition of lineOffset.

Link copied to clipboard

The opacity at which the line will be drawn. Default value: 1. Value range: 0, 1

Link copied to clipboard

Defines the transition of lineOpacity.

Link copied to clipboard

Name of image in sprite to use for drawing image lines. For seamless patterns, image width must be a factor of two (2, 4, 8, ..., 512). Note that zoom-dependent expressions will be evaluated only at integer zoom levels.

Link copied to clipboard

Used to automatically convert round joins to miter joins for shallow angles. Default value: 1.05.

Link copied to clipboard

Sorts features in ascending order based on this value. Features with a higher sort key will appear above features with a lower sort key.

Link copied to clipboard

The geometry's offset. Values are x, y where negatives indicate left and up, respectively. Default value: 0,0. The unit of lineTranslate is in pixels.

Link copied to clipboard

Controls the frame of reference for line-translate. Default value: "map".

Link copied to clipboard

Defines the transition of lineTranslate.

Link copied to clipboard

The color to be used for rendering the trimmed line section that is defined by the line-trim-offset property. Default value: "transparent".

Link copied to clipboard
Link copied to clipboard

Overrides applying of color theme for lineTrimColor if "none" is set. To follow default theme "default" should be set. Default value: "default".

Link copied to clipboard

The fade range for the trim-start and trim-end points is defined by the line-trim-offset property. The first element of the array represents the fade range from the trim-start point toward the end of the line, while the second element defines the fade range from the trim-end point toward the beginning of the line. The fade result is achieved by interpolating between line-trim-color and the color specified by the line-color or the line-gradient property. Default value: 0,0. Minimum value: 0,0. Maximum value: 1,1.

Link copied to clipboard

The line part between trim-start, trim-end will be painted using line-trim-color, which is transparent by default to produce a route vanishing effect. The line trim-off offset is based on the whole line range 0.0, 1.0. Default value: 0,0. Minimum value: 0,0. Maximum value: 1,1.

Link copied to clipboard

Stroke thickness. Default value: 1. Minimum value: 0. The unit of lineWidth is in pixels.

Link copied to clipboard

Defines the transition of lineWidth.

Link copied to clipboard

Selects the unit of line-width. The same unit is automatically used for line-blur and line-offset. Note: This is an experimental property and might be removed in a future release. Default value: "pixels".

Link copied to clipboard

Vertical offset from ground, in meters. Defaults to 0. This is an experimental property with some known issues: - Not supported for globe projection at the moment - Elevated line discontinuity is possible on tile borders with terrain enabled - Rendering artifacts can happen near line joins and line caps depending on the line styling - Rendering artifacts relating to line-opacity and line-blur - Elevated line visibility is determined by layer order - Z-fighting issues can happen with intersecting elevated lines - Elevated lines don't cast shadows Default value: 0.

Link copied to clipboard

The maximum zoom level for the layer. At zoom levels equal to or greater than the maxzoom, the layer will be hidden. Value range: 0, 24

Link copied to clipboard

The minimum zoom level for the layer. At zoom levels less than the minzoom, the layer will be hidden. Value range: 0, 24

Link copied to clipboard

Layer to use from a vector tile source. Required for vector tile sources; prohibited for all other source types, including GeoJSON sources.

Link copied to clipboard

Whether this layer is displayed. Default value: "visible".