/* Copyright (c) 2011 by MapQuery Contributors (see AUTHORS for * full list of contributors). Published under the MIT license. * See https://github.com/mapquery/mapquery/blob/master/LICENSE for the * full text of the license. */ /** #jquery.mapquery.mqLayerManager.js The file containing the mqLayerManager Widget ### *$('selector')*.`mqLayerManager([options])` _version added 0.1_ ####**Description**: create a widget to manage layers + **options**: - **map**: the mapquery instance - **title**: Title that will be displayed at the top of the layer manager (default: Layer Manager) >Returns: widget >Requires: jquery.mapquery.legend.js The mqLayerManager allows us to control the order, opacity and visibility of layers. We can also remove layers. It also shows the legend of the layer if available and the error messages provided by the legend plugin. It listens to layerchange event for order, transparancy and opacity changes. It listens to addlayer and removelayer events to keep track which layers are on the map. $('#layermanager').mqLayerManager({map:'#map'}); */ (function($) { $.template('mqLayerManager', '
'); $.template('mqLayerManagerElement', ' '); $.widget("mapQuery.mqLayerManager", { options: { // The MapQuery instance map: undefined, // Title that will be displayed at the top of the popup title: "Layer Manager" }, _create: function() { var map; var zoom; var numzoomlevels; var self = this; var element = this.element; //get the mapquery object map = $(this.options.map).data('mapQuery'); this.element.addClass('ui-widget ui-helper-clearfix ' + 'ui-corner-all'); var lmElement = $.tmpl('mqLayerManager').appendTo(element); element.find('.ui-icon-closethick').button(); lmElement.sortable({ axis:'y', handle: '.mq-layermanager-element-header', update: function(event, ui) { var layerNodes = ui.item.siblings().andSelf(); var num = layerNodes.length-1; layerNodes.each(function(i) { var layer = $(this).data('layer'); var pos = num-i; self._position(layer, pos); }); } }); //these layers are already added to the map as such won't trigger //and event, we call the draw function directly $.each(map.layers().reverse(), function(){ self._layerAdded(lmElement, this); }); element.delegate('.mq-layermanager-element-vischeckbox', 'change',function() { var checkbox = $(this); var element = checkbox.parents('.mq-layermanager-element'); var layer = element.data('layer'); var self = element.data('self'); self._visible(layer,checkbox.attr('checked')); }); element.delegate('.ui-icon-closethick', 'click', function() { var control = $(this).parents('.mq-layermanager-element'); self._remove(control.data('layer')); }); //binding events map.bind("mqAddLayer", {widget:self,control:lmElement}, self._onLayerAdd); map.bind("mqRemoveLayer", {widget:self,control:lmElement}, self._onLayerRemove); map.bind("changelayer", {widget:self,map:map,control:lmElement}, self._onLayerChange); map.bind("moveend", {widget:self,map:map,control:lmElement}, self._onMoveEnd); }, _destroy: function() { this.element.removeClass(' ui-widget ui-helper-clearfix ' + 'ui-corner-all') .empty(); }, //functions that actually change things on the map //call these from within the widget to do stuff on the map //their actions will trigger events on the map and in return //will trigger the _layer* functions _add: function(map,layer) { map.layers(layer); }, _remove: function(layer) { layer.remove(); }, _position: function(layer, pos) { layer.position(pos); }, _visible: function(layer, vis) { layer.visible(vis); }, _opacity: function(layer,opac) { layer.opacity(opac); }, //functions that change the widget _layerAdded: function(widget, layer) { var self = this; var error = layer.legend().msg; var url; switch(error){ case '': url =layer.legend().url; if(url==''){error='No legend for this layer';} break; case 'E_ZOOMOUT': error = 'Please zoom out to see this layer'; break; case 'E_ZOOMIN': error = 'Please zoom in to see this layer'; break; case 'E_OUTSIDEBOX': error = 'This layer is outside the current view'; break; } var layerElement = $.tmpl('mqLayerManagerElement',{ id: layer.id, label: layer.label, position: layer.position(), visible: layer.visible(), imgUrl: url, opacity: layer.visible()?layer.opacity():0, errMsg: error }) // save layer layer in the DOM, so we can easily // hide/show/delete the layer with live events .data('layer', layer) .data('self',self) .prependTo(widget); $(".mq-layermanager-element-slider", layerElement).slider({ max: 100, step: 1, value: layer.visible()?layer.opacity()*100:0, slide: function(event, ui) { var layer = layerElement.data('layer'); var self = layerElement.data('self'); self._opacity(layer,ui.value/100); }, //using the slide event to check for the checkbox often gives errors. change: function(event, ui) { var layer = layerElement.data('layer'); var self = layerElement.data('self'); if(ui.value>=0.01) { if(!layer.visible()){layer.visible(true);} } if(ui.value<0.01) { if(layer.visible()){layer.visible(false);} } } }); }, _layerRemoved: function(widget, id) { var control = $("#mq-layermanager-element-"+id); control.fadeOut(function() { $(this).remove(); }); }, _layerPosition: function(widget, layer) { var layerNodes = widget.element.find('.mq-layermanager-element'); var num = layerNodes.length-1; var tmpNodes = []; tmpNodes.length = layerNodes.length; layerNodes.each(function() { var layer = $(this).data('layer'); var pos = num-layer.position(); tmpNodes[pos]= this; }); for (i=0;i