Geoportal Extension for OpenLayers API Reference

Class: LayerSwitcher


OpenLayers Control to manage map layers : their order, visibility and opacity, and display their informations (title, description, legends, metadata...)

new LayerSwitcher(options)

OpenLayers/Controls/LayerSwitcher.js, line 52
Name Type Description
options Object

control options

Name Type Description
layers Array optional

list of layers to be configured. Each array element is an object, with following properties :

Name Type Description
layer ol.layer.Layer optional

ol.layer.Layer layer to be configured (that has been added to map)

config Object optional

custom configuration object for layer information (title, description, legends, metadata, quicklook url), with following properties :

Name Type Description
title String optional

layer alias, to be displayed in widget layer list. E.g. : "Cartes IGN"

description String optional

layer description, to be displayed on title hover, or in layer information panel.

quicklookUrl String optional

link to a quick look image for this layer.

legends Array optional

array of layer legends. Each array element is an object, with following properties :
- url (String, mandatory) : link to a legend
- minScaleDenominator (Number, optional) : min scale denominator for legend validity.

metadata Array optional

array of layer metadata. Each array element is an object, with property url (String, mandatory) : link to a metadata

options Object optional

ol.control.Control options (see ol.control.Control)

Name Type Default Description
collapsed Boolean true optional

Specify if widget has to be collapsed (true) or not (false) on map loading. Default is true.

map.addControl(new ol.control.LayerSwitcher(
         layer : wms1,
         config : {
             title : "test layer name 1",
             description : "test layer desc 1",
     collapsed : true


  • ol.control.Control



{Boolean} true if widget is collapsed, false otherwise


addLayer(layer, config)

OpenLayers/Controls/LayerSwitcher.js, line 193

Add a new layer to control (when added to map) or add new layer configuration

Name Type Description
layer ol.layer.Layer

layer to add to layer switcher

config Object optional

additional options for layer configuration

Name Type Description
title Object optional

layer title (default is layer identifier)

description Object optional

layer description (default is null)

legends Object optional

layer legends (default is an empty array)

metadata Object optional

layer metadata (default is an empty array)

quicklookUrl Object optional

layer quicklookUrl (default is null)

          title : "Parcelles cadastrales",
          description : "description de la couche",
          quicklookUrl : ""


OpenLayers/Controls/LayerSwitcher.js, line 390

Returns true if widget is collapsed (minimize), false otherwise



OpenLayers/Controls/LayerSwitcher.js, line 1006

Returns Layer Container Id associated with given olLayer

Name Type Description
olLayer ol.layer.Layer

ol layer object

container Id ; null if layer not found.


OpenLayers/Controls/LayerSwitcher.js, line 323

Remove a layer from control

Name Type Description
layer ol.layer.Layer


  • on the future version ...


    OpenLayers/Controls/LayerSwitcher.js, line 366

    Collapse or display control main container

    Name Type Description
    collapsed Boolean

    True to collapse control, False to display it


    OpenLayers/Controls/LayerSwitcher.js, line 109

    Overload setMap function, that enables to catch map events, such as movend events.

    Name Type Description
    map ol.Map


    setRemovable(layer, removable)

    OpenLayers/Controls/LayerSwitcher.js, line 400

    Display or hide removeLayerPicto from layerSwitcher for this layer

    Name Type Description
    layer ol.layer.Layer

    ol.layer to be configured

    removable Boolean

    specify if layer can be remove from layerSwitcher (true) or not (false). Default is true