Nebulous Plasma Muffin

    leaflet-polylineoffset

    1.1.1 • Public • Published

    Leaflet Polyline Offset

    Works with Leaflet >= 1.0.

    This plugin adds to Leaflet Polylines the ability to be drawn with a relative pixel offset, without modifying their actual LatLngs. The offset value can be either negative or positive, for left- or right-side offset, and remains constant across zoom levels.

    Install with NPM

    npm install leaflet-polylineoffset

    Use cases and demos

    Line offsetting is the process of drawing a line parallel to an existant one, at a fixed distance. It's not a simple (x,y) translation of the whole shape, as it shouldn't overlap. It can be used to visually emphasize different properties of the same linear feature, or achieve complex composite styling.

    This plugin brings this feature to Leaflet, to apply to client-side vectors.

    Demos are clearer than words:

    • Basic demo. The dashed line is the "model", with no offset applied. Red is with a -10px offset, green is with a 5px offset. The three are distinct Polyline objects but uses the same coordinate array.
    • Cycle lanes. Drawing a road with two directions of cycle lanes, a main one and one shared.
    • Bus lines. A more complex demo. Offsets are computed automatically depending on the number of bus lines using the same segment. Other non-offset polylines are used to achieve the white and black outline effect.

    Usage

    The plugin adds offset capabilities directly to the L.Polyline class.

    // Instantiate a normal Polyline with an 'offset' options, in pixels.
    var pl = L.polyline([[48.8508, 2.3455], [48.8497, 2.3504], [48.8494, 2.35654]], {
      offset: 5
    });
     
    // Setting the 'offset' property through the 'setStyle' method won't work.
    // If you want to set the offset afterwards, use 'setOffset'.
    pl.setOffset(-10);
     
    // To cancel the offset, simply set it to 0
    pl.setOffset(0);

    License

    MIT.

    Contributors

    Install

    npm i leaflet-polylineoffset

    DownloadsWeekly Downloads

    503

    Version

    1.1.1

    License

    MIT

    Unpacked Size

    23 kB

    Total Files

    7

    Last publish

    Collaborators

    • bbecquet