├── .gitignore ├── CHANGELOG ├── LICENSE ├── README.markdown ├── Rakefile ├── jquery.jmapping.js ├── jquery.jmapping.min.js ├── spec ├── jmapping_spec.js ├── screw.css ├── screw.unit │ ├── jquery.fn.js │ ├── jquery.print.js │ ├── screw.behaviors.js │ ├── screw.builder.js │ ├── screw.events.js │ └── screw.matchers.js ├── smoke │ ├── screw.mocking.js │ ├── smoke.core.js │ ├── smoke.mock.js │ └── smoke.stub.js ├── spec_helper.js └── suite.html └── vendor ├── StyledMarker.js ├── jquery-1.4.4.js ├── jquery.metadata.js ├── jsmin.rb └── markermanager.js /.gitignore: -------------------------------------------------------------------------------- 1 | pkg/* 2 | pkg/**/* 3 | -------------------------------------------------------------------------------- /CHANGELOG: -------------------------------------------------------------------------------- 1 | == 2.1.0 / 2011-01-28 2 | * Fixed `force_zoom_level` & `default_zoom_level` 3 | * Add `always_show_markers` option (mokolabs) 4 | 5 | == 2.0.0 / 2010-11-24 6 | * Use version 3 of Google Maps API 7 | * Add `default_point` setting. (gsterndale) 8 | * Add `force_zoom_level` setting. 9 | * Use StyledMarker instead of MapIconMaker as MapIconMaker is incompatible with v3 of the Google Maps API. 10 | 11 | == 1.4.0 / 2010-07-11 12 | 13 | * Uncache metadata on update. 14 | * Allow creating many different types of markers based on categories. 15 | 16 | == 1.3.0 / 2010-07-11 17 | 18 | * Use data-jmapping attribute for metadata by default. 19 | * add `default_zoom_level` option 20 | 21 | == 1.2.1 / 2010-03-12 22 | 23 | * Also call `map.checkResize()` when updating the map. 24 | 25 | == 1.2 / 2010-03-12 26 | 27 | * Add new object and event API. 28 | 29 | == 1.1 / 2009-08-24 30 | 31 | * Allow updating the map. 32 | 33 | == 1.0 / 2009-07-15 34 | 35 | * Initial Release. 36 | -------------------------------------------------------------------------------- /LICENSE: -------------------------------------------------------------------------------- 1 | (The MIT License) 2 | 3 | Copyright (c) 2009-2010 Brian Landau of Viget Labs 4 | 5 | Permission is hereby granted, free of charge, to any person obtaining 6 | a copy of this software and associated documentation files (the 7 | 'Software'), to deal in the Software without restriction, including 8 | without limitation the rights to use, copy, modify, merge, publish, 9 | distribute, sublicense, and/or sell copies of the Software, and to 10 | permit persons to whom the Software is furnished to do so, subject to 11 | the following conditions: 12 | 13 | The above copyright notice and this permission notice shall be 14 | included in all copies or substantial portions of the Software. 15 | 16 | THE SOFTWARE IS PROVIDED 'AS IS', WITHOUT WARRANTY OF ANY KIND, 17 | EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF 18 | MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. 19 | IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY 20 | CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, 21 | TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE 22 | SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. 23 | -------------------------------------------------------------------------------- /README.markdown: -------------------------------------------------------------------------------- 1 | jMapping - Google Maps jQuery Plugin 2 | ===================================== 3 | 4 | This plugin is designed for quick development of a page that implements 5 | a Google Map with a list of the locations that are specified within the HTML. 6 | 7 | 8 | ### Links 9 | 10 | * [Documentation](http://vigetlabs.github.com/jmapping/ "jMapping Documentation") 11 | * [Examples](http://vigetlabs.github.com/jmapping/examples/ "jMapping: Examples") 12 | * [Repository@GitHub](http://github.com/vigetlabs/jmapping) 13 | * [Downloads](http://wiki.github.com/vigetlabs/jmapping/downloads) 14 | 15 | 16 | Graceful degradation and Semantic Expectations 17 | ----------------------------------------------- 18 | 19 | This plugin tries to allow as much graceful degradation as possible by having the HTML be as semantic as possible. 20 | The plugin expect the HTML for the locations to be grouped under a common element. 21 | Additionally, it expects the links and Map Info Window content to be grouped under the location elements. 22 | It also expects the necessary metadata to be on the location element. 23 | This way the HTML semantically reflects that all of those parts and information are associated with the specific location or place. 24 | 25 | 26 | Basic Usage 27 | ------------ 28 | 29 | Download the necessary dependencies and jMapping. 30 | 31 | Make sure you include the necessary scripts in your page: 32 | 33 | 34 | 35 | 36 | 37 | 38 | 39 | 40 | Make sure your HTML has a `div` element for the Google map, and there is a container element with some locations and their data. The data by default is expected to be on the "data-jmapping" attribute of the location (this can be configured): 41 | 42 |
43 | 44 |
45 |
46 | Some Place 47 |
48 |

Some thing for the info box.

49 |
50 |
51 |
52 | Another Place 53 |
54 |

Example Text.

55 |
56 |
57 |
58 | 59 | Then just call the `jMapping` function on the map element: 60 | 61 | $(document).ready(function(){ 62 | $('#map').jMapping(); 63 | }); 64 | 65 | 66 | If you need to change the markers on the map, usually for some type of pagination, this can be done by simply updating the content of the "side-bar" container to contain new location data and then calling the update function: 67 | 68 | $('#map-side-bar').load('ajax/path/file.html', nil, function(){ 69 | $('#map').jMapping('update'); 70 | }); 71 | 72 | *OR* 73 | 74 | $('#map-side-bar').load('ajax/path/file.html', nil, function(){ 75 | $('#map').data('jMapping').update(); 76 | }); 77 | 78 | 79 | Options 80 | -------- 81 | 82 | These are options that can be passed to the `jMapping` function to change specific settings. 83 | 84 | 85 | * `side_bar_selector`: 86 | * *Default*: `"#map-side-bar:first"` 87 | * This defines the selector where location items will be searched for within. 88 | * `location_selector`: 89 | * *Default*: `".map-location"` 90 | * This defines the selector for location items. This is the element that the metadata 91 | needs to be associated with. The plugin will look for items matching this selector *inside* of the side bar element. 92 | * `link_selector`: 93 | * *Default*: `a.map-link` 94 | * This selector defines the link that will be used to "activate" a marker on the map. 95 | If info window elements are provided the HTML inside of them will be loaded into 96 | the pop up window when these links are clicked. You should set this value to `false` 97 | if you do not wish to use this functionality. 98 | These links will be searched for inside of the location elements specified in the `location_selector`. 99 | * `info_window_selector`: 100 | * *Default*: `".info-box"` 101 | * This selector defines where the content for the Google Maps info window for each location marker is. 102 | This element will be searched for inside of the location elements specified in the `location_selector`. 103 | If no element is found no Info Window will be attached to the marker. 104 | * `default_point`: 105 | * *Default*: `{lat: 0.0, lng: 0.0}` 106 | * This point determines the Google Maps location if there are no location elements inside the specified `location_selector`. 107 | * `metadata_options`: 108 | * *Default*: `{type: "attr", name: "data"}` 109 | * This is the set of options passed to the jQuery metadata function. It defines how the necessary 110 | metadata for each location will be searched for. 111 | See the [metadata plugins docs](http://docs.jquery.com/Plugins/Metadata/metadata#toptions) for more info. 112 | * `info_window_max_width`: 113 | * *Default*: `425` 114 | * This specifies what the max width of the Google Maps Info Windows can be when a marker is activated. 115 | Otherwise it will expand to fit the width of the content. 116 | * `map_config`: 117 | * *Default*: *N/A* 118 | * This can be set to a [MapOptions object](http://code.google.com/apis/maps/documentation/javascript/reference.html#MapOptions). Which is just a normal object `{}` with specific properties that become the settings for the map. 119 | * `category_icon_options`: 120 | * *Default*: *N/A* 121 | * By default the plugin will use the default Google Maps marker icon. But you can use this option 122 | to specify what options to pass to the StyledMarker based on category data associated with the location. 123 | It accepts 2 types of values: an object or a function. 124 | If the setting is to an object it will take the category data on the location and look for a key on the object 125 | that matches and return that value. If there is no value for the supplied category, it will return 126 | the value specified in the "default" key. 127 | If the setting is set to a function it will call the function and pass the value for the 128 | category data to the function, returning the result. This can be used for more complicated logic and for 129 | using something other then just string data in the category, such as an object with multiple data 130 | attributes it's self. 131 | The object values for the associated category key or the function should return one of three data types: 132 | 1. A string, this will be used as the image source for the marker icon. 133 | 2. A [google.maps.MarkerImage](http://code.google.com/apis/maps/documentation/javascript/reference.html#MarkerImage), this will be used as the icon for the Marker object. 134 | 3. An object that has [valid options for a StyledIcon object](http://google-maps-utility-library-v3.googlecode.com/svn/trunk/styledmarker/docs/reference.html#StyledIconOptions). 135 | * `default_zoom_level`: 136 | * *Default*: *N/A* 137 | * Use this option to set the default zoom level for your map. Normally, zoom level is set dynamically based on the position of locations being mapped. But, in some cases, like viewing a single mapped location, you may wish to set a default zoom level. Zoom level values should be between 1 and 20. Neighborhood level is approximately 15. 138 | * `force_zoom_level`: 139 | * *Default*: *N/A* 140 | * This will force the map to **always** be rendered at this zoom level. 141 | * `always_show_markers`: 142 | * *Default*: `false` 143 | * Set this option to `true` if you wish to display markers on all zoom levels. (Normally, the markers may only be visible on certain zoom levels, depending on the normal bounds and zoom level of the marker data.) 144 | 145 | Object API 146 | ----------- 147 | 148 | The jMapping API object is available from the "jMapping" data value on 149 | the selector passed to the original $().jMapping function. 150 | 151 | For example: 152 | 153 | $('#map').jMapping(); 154 | $('#map').data('jMapping'); // returns the jMapping API object 155 | 156 | The API of that object: 157 | 158 | * `gmarkers`: 159 | * The google.maps.Marker objects that have been placed on the map. 160 | Stored in an object where the keys are the id's are those provided in the metadata 161 | * `settings`: 162 | * The settings for this jMapping instance. 163 | * `mapped`: 164 | * Did the plugin create the map and markers as expected or not. 165 | * `map`: 166 | * the google.maps.Map Google Map API object. 167 | * `markerManager`: 168 | * The Google Maps MarkerManager object for manipulating groups of markers, has control over all markers on the map. 169 | * `gmarkersArray`: 170 | * Returns an array of all the markers currently on the map. 171 | * `getBounds`: 172 | * The Google Maps google.maps.LatLngBounds bounds object for all the markers on the map. 173 | * `getPlaces`: 174 | * Returns the set of jQuery objects for the place DOM Elements. 175 | * `getPlacesData`: 176 | * Returns an array of all the metadata for each place returned by `getPlaces` 177 | * `update`: 178 | * Used to update the map if the HTML DOM for the locations has changed. 179 | 180 | 181 | Event API 182 | ---------- 183 | 184 | There a number of events that fire as jMapping is used. 185 | 186 | * `beforeMapping.jMapping` 187 | * This fires immediately before the main functionality of the plugin begins and is passed the settings object. 188 | If it returns false the mapping will be canceled. 189 | * `afterMapping.jMapping` 190 | * This fires immediately after the plugins mapping has finished, passes in the jMapping API object. 191 | * `beforeUpdate.jMapping` 192 | * This fires right before the map is updated via the "update" method. The jMapping API object is passed to the callback. 193 | If the callback returns false the update will be canceled. 194 | * `afterUpdate.jMapping` 195 | * This fires immediately after the map is updated. 196 | * `markerCreated.jMapping` 197 | * This fires right after a map marker is created, the marker object is passed to the callback. 198 | 199 | 200 | Dependencies 201 | ------------- 202 | 203 | * [jQuery 1.4.4](http://docs.jquery.com/Downloading_jQuery) 204 | * [jQuery Metadata plugin 2.1](http://plugins.jquery.com/project/metadata) 205 | * [MarkerManager v3 1.0](http://google-maps-utility-library-v3.googlecode.com/svn/tags/markermanager/1.0) 206 | * [StyledMarker 0.5](http://google-maps-utility-library-v3.googlecode.com/svn/trunk/styledmarker) 207 | 208 | 209 | License 210 | -------- 211 | 212 | Copyright (c) 2009-2011 Brian Landau (Viget Labs) 213 | MIT License: [http://www.opensource.org/licenses/mit-license.php](http://www.opensource.org/licenses/mit-license.php) 214 | -------------------------------------------------------------------------------- /Rakefile: -------------------------------------------------------------------------------- 1 | require 'rake' 2 | require 'rake/clean' 3 | require 'rake/packagetask' 4 | require File.join(File.dirname(__FILE__), 'vendor/jsmin.rb') 5 | 6 | Object.send(:remove_const, :CLEAN) if defined?(CLEAN) 7 | CLEAN = FileList.new 8 | CLOBBER.add('jquery.jmapping.min.js') 9 | 10 | file 'jquery.jmapping.min.js' => ['jquery.jmapping.js'] do 11 | original_js = File.read('jquery.jmapping.js') 12 | print " - Minifing JS ... " 13 | minified_js = JSMin.minify(original_js) 14 | open('jquery.jmapping.min.js', 'w') do |file| 15 | file << minified_js 16 | end 17 | print "Done!\n" 18 | end 19 | 20 | task :minify => ['jquery.jmapping.min.js'] 21 | 22 | Rake::PackageTask.new("jquery.jmapping", (ENV['VERSION'] || :noversion)) do |p| 23 | p.need_tar_gz = true 24 | p.need_zip = true 25 | p.package_files.add 'jquery.*.js', 'README.markdown', 'CHANGELOG', 'vendor/jquery.metadata.js', 26 | 'vendor/StyledMarker.js', 'vendor/markermanager.js' 27 | end 28 | 29 | if PLATFORM['darwin'] 30 | task :test do 31 | sh 'open -a Firefox spec/suite.html' do |ok, status| 32 | unless ok 33 | sh 'open spec/suite.html' 34 | end 35 | end 36 | end 37 | end 38 | -------------------------------------------------------------------------------- /jquery.jmapping.js: -------------------------------------------------------------------------------- 1 | /* 2 | * jMapping v2.1.0 - jQuery plugin for creating Google Maps 3 | * 4 | * Copyright (c) 2009-2010 Brian Landau (Viget Labs) 5 | * MIT License: http://www.opensource.org/licenses/mit-license.php 6 | * 7 | */ 8 | 9 | (function($){ 10 | $.jMapping = function(map_elm, options){ 11 | var settings, gmarkers, mapped, map, markerManager, places, bounds, jMapper, info_windows; 12 | map_elm = (typeof map_elm == "string") ? $(map_elm).get(0) : map_elm; 13 | 14 | if (!($(map_elm).data('jMapping'))){ // TODO: Should we use a different test here? 15 | settings = $.extend(true, {}, $.jMapping.defaults); 16 | $.extend(true, settings, options); 17 | gmarkers = {}; 18 | info_windows = []; 19 | 20 | var init = function(doUpdate){ 21 | var info_window_selector, min_zoom, zoom_level; 22 | 23 | info_window_selector = [ 24 | settings.side_bar_selector, 25 | settings.location_selector, 26 | settings.info_window_selector 27 | ].join(' '); 28 | $(info_window_selector).hide(); 29 | 30 | places = getPlaces(); 31 | bounds = getBounds(doUpdate); 32 | 33 | if (doUpdate){ 34 | gmarkers = {}; 35 | info_windows = []; 36 | markerManager.clearMarkers(); 37 | google.maps.event.trigger(map, 'resize'); 38 | map.fitBounds(bounds); 39 | if (settings.force_zoom_level){ 40 | map.setZoom(settings.force_zoom_level); 41 | } 42 | } else { 43 | map = createMap(); 44 | markerManager = new MarkerManager(map); 45 | } 46 | 47 | places.each(function(){ 48 | var marker = createMarker(this); 49 | if (!(settings.link_selector === false)){ 50 | setupLink(this); 51 | } 52 | $(document).trigger('markerCreated.jMapping', [marker]); 53 | }); 54 | 55 | if (doUpdate){ 56 | updateMarkerManager(); 57 | } else { 58 | google.maps.event.addListener(markerManager, 'loaded', function(){ 59 | updateMarkerManager(); 60 | if (settings.default_zoom_level){ 61 | map.setZoom(settings.default_zoom_level); 62 | } 63 | }); 64 | } 65 | 66 | if (!(settings.link_selector === false) && !doUpdate){ 67 | attachMapsEventToLinks(); 68 | } 69 | }; 70 | 71 | var createMap = function(){ 72 | if (settings.map_config){ 73 | map = new google.maps.Map(map_elm, settings.map_config); 74 | } else { 75 | map = new google.maps.Map(map_elm, { 76 | navigationControlOptions: { 77 | style: google.maps.NavigationControlStyle.SMALL 78 | }, 79 | mapTypeControl: false, 80 | mapTypeId: google.maps.MapTypeId.ROADMAP, 81 | zoom: 9 82 | }); 83 | } 84 | map.fitBounds(bounds); 85 | if (settings.force_zoom_level){ 86 | map.setZoom(settings.force_zoom_level); 87 | } 88 | return map; 89 | }; 90 | 91 | var getPlaces = function(){ 92 | return $(settings.side_bar_selector+' '+settings.location_selector); 93 | }; 94 | 95 | var getPlacesData = function(doUpdate){ 96 | return places.map(function(){ 97 | if (doUpdate){ 98 | $(this).data('metadata', false); 99 | } 100 | return $(this).metadata(settings.metadata_options); 101 | }); 102 | }; 103 | 104 | var getBounds = function(doUpdate){ 105 | var places_data = getPlacesData(doUpdate), 106 | newBounds, initialPoint; 107 | 108 | if (places_data.length){ 109 | initialPoint = $.jMapping.makeGLatLng(places_data[0].point); 110 | }else{ 111 | initialPoint = $.jMapping.makeGLatLng(settings.default_point); 112 | } 113 | newBounds = new google.maps.LatLngBounds(initialPoint, initialPoint); 114 | 115 | for (var i=1, len = places_data.length; i 0){ 172 | info_window = new google.maps.InfoWindow({ 173 | content: $info_window_elm.html(), 174 | maxWidth: settings.info_window_max_width 175 | }); 176 | info_windows.push(info_window); 177 | google.maps.event.addListener(marker, 'click', function() { 178 | $.each(info_windows, function(index, iwindow){ 179 | if (info_window != iwindow){ 180 | iwindow.close(); 181 | } 182 | }); 183 | info_window.open(map, marker); 184 | }); 185 | } 186 | 187 | gmarkers[parseInt(place_data.id, 10)] = marker; 188 | return marker; 189 | }; 190 | 191 | var updateMarkerManager = function(){ 192 | if (settings.always_show_markers === true) { 193 | min_zoom = 0; 194 | } else { 195 | zoom_level = map.getZoom(); 196 | min_zoom = (zoom_level < 7) ? 0 : (zoom_level - 7); 197 | } 198 | markerManager.addMarkers(gmarkersArray(), min_zoom); 199 | markerManager.refresh(); 200 | if (settings.force_zoom_level){ 201 | map.setZoom(settings.force_zoom_level); 202 | } 203 | }; 204 | 205 | var attachMapsEventToLinks = function(){ 206 | var location_link_selector = [ 207 | settings.side_bar_selector, 208 | settings.location_selector, 209 | settings.link_selector 210 | ].join(' '); 211 | 212 | $(location_link_selector).live('click', function(e){ 213 | e.preventDefault(); 214 | var marker_index = parseInt($(this).attr('href').split('#')[1], 10); 215 | google.maps.event.trigger(gmarkers[marker_index], "click"); 216 | }); 217 | }; 218 | 219 | var gmarkersArray = function(){ 220 | var marker_arr = []; 221 | $.each(gmarkers, function(key, value){ 222 | marker_arr.push(value); 223 | }); 224 | return marker_arr; 225 | }; 226 | 227 | if ($(document).trigger('beforeMapping.jMapping', [settings]) != false){ 228 | init(); 229 | mapped = true; 230 | } else { 231 | mapped = false; 232 | } 233 | jMapper = { 234 | gmarkers: gmarkers, 235 | settings: settings, 236 | mapped: mapped, 237 | map: map, 238 | markerManager: markerManager, 239 | gmarkersArray: gmarkersArray, 240 | getBounds: getBounds, 241 | getPlacesData: getPlacesData, 242 | getPlaces: getPlaces, 243 | update: function(){ 244 | if ($(document).trigger('beforeUpdate.jMapping', [this]) != false){ 245 | 246 | init(true); 247 | this.map = map; 248 | this.gmarkers = gmarkers; 249 | this.markerManager = markerManager; 250 | $(document).trigger('afterUpdate.jMapping', [this]); 251 | } 252 | } 253 | }; 254 | $(document).trigger('afterMapping.jMapping', [jMapper]); 255 | return jMapper; 256 | } else { 257 | return $(map_elm).data('jMapping'); 258 | } 259 | }; 260 | 261 | $.extend($.jMapping, { 262 | defaults: { 263 | side_bar_selector: '#map-side-bar:first', 264 | location_selector: '.map-location', 265 | link_selector: 'a.map-link', 266 | info_window_selector: '.info-box', 267 | info_window_max_width: 425, 268 | default_point: {lat: 0.0, lng: 0.0}, 269 | metadata_options: {type: 'attr', name: 'data-jmapping'} 270 | }, 271 | makeGLatLng: function(place_point){ 272 | return new google.maps.LatLng(place_point.lat, place_point.lng); 273 | } 274 | }); 275 | 276 | $.fn.jMapping = function(options){ 277 | if ((options == 'update') && $(this[0]).data('jMapping')){ 278 | $(this[0]).data('jMapping').update(); 279 | } else { 280 | if (options == 'update') options = {}; 281 | $(this[0]).data('jMapping', $.jMapping(this[0], options)); 282 | } 283 | return this; 284 | }; 285 | })(jQuery); 286 | -------------------------------------------------------------------------------- /jquery.jmapping.min.js: -------------------------------------------------------------------------------- 1 | 2 | (function($){$.jMapping=function(map_elm,options){var settings,gmarkers,mapped,map,markerManager,places,bounds,jMapper,info_windows;map_elm=(typeof map_elm=="string")?$(map_elm).get(0):map_elm;if(!($(map_elm).data('jMapping'))){settings=$.extend(true,{},$.jMapping.defaults);$.extend(true,settings,options);gmarkers={};info_windows=[];var init=function(doUpdate){var info_window_selector,min_zoom,zoom_level;info_window_selector=[settings.side_bar_selector,settings.location_selector,settings.info_window_selector].join(' ');$(info_window_selector).hide();places=getPlaces();bounds=getBounds(doUpdate);if(doUpdate){gmarkers={};info_windows=[];markerManager.clearMarkers();google.maps.event.trigger(map,'resize');map.fitBounds(bounds);if(settings.force_zoom_level){map.setZoom(settings.force_zoom_level);}}else{map=createMap();markerManager=new MarkerManager(map);} 3 | places.each(function(){var marker=createMarker(this);if(!(settings.link_selector===false)){setupLink(this);} 4 | $(document).trigger('markerCreated.jMapping',[marker]);});if(doUpdate){updateMarkerManager();}else{google.maps.event.addListener(markerManager,'loaded',function(){updateMarkerManager();if(settings.default_zoom_level){map.setZoom(settings.default_zoom_level);}});} 5 | if(!(settings.link_selector===false)&&!doUpdate){attachMapsEventToLinks();}};var createMap=function(){if(settings.map_config){map=new google.maps.Map(map_elm,settings.map_config);}else{map=new google.maps.Map(map_elm,{navigationControlOptions:{style:google.maps.NavigationControlStyle.SMALL},mapTypeControl:false,mapTypeId:google.maps.MapTypeId.ROADMAP,zoom:9});} 6 | map.fitBounds(bounds);if(settings.force_zoom_level){map.setZoom(settings.force_zoom_level);} 7 | return map;};var getPlaces=function(){return $(settings.side_bar_selector+' '+settings.location_selector);};var getPlacesData=function(doUpdate){return places.map(function(){if(doUpdate){$(this).data('metadata',false);} 8 | return $(this).metadata(settings.metadata_options);});};var getBounds=function(doUpdate){var places_data=getPlacesData(doUpdate),newBounds,initialPoint;if(places_data.length){initialPoint=$.jMapping.makeGLatLng(places_data[0].point);}else{initialPoint=$.jMapping.makeGLatLng(settings.default_point);} 9 | newBounds=new google.maps.LatLngBounds(initialPoint,initialPoint);for(var i=1,len=places_data.length;i0){info_window=new google.maps.InfoWindow({content:$info_window_elm.html(),maxWidth:settings.info_window_max_width});info_windows.push(info_window);google.maps.event.addListener(marker,'click',function(){$.each(info_windows,function(index,iwindow){if(info_window!=iwindow){iwindow.close();}});info_window.open(map,marker);});} 12 | gmarkers[parseInt(place_data.id,10)]=marker;return marker;};var updateMarkerManager=function(){if(settings.always_show_markers===true){min_zoom=0;}else{zoom_level=map.getZoom();min_zoom=(zoom_level<7)?0:(zoom_level-7);} 13 | markerManager.addMarkers(gmarkersArray(),min_zoom);markerManager.refresh();if(settings.force_zoom_level){map.setZoom(settings.force_zoom_level);}};var attachMapsEventToLinks=function(){var location_link_selector=[settings.side_bar_selector,settings.location_selector,settings.link_selector].join(' ');$(location_link_selector).live('click',function(e){e.preventDefault();var marker_index=parseInt($(this).attr('href').split('#')[1],10);google.maps.event.trigger(gmarkers[marker_index],"click");});};var gmarkersArray=function(){var marker_arr=[];$.each(gmarkers,function(key,value){marker_arr.push(value);});return marker_arr;};if($(document).trigger('beforeMapping.jMapping',[settings])!=false){init();mapped=true;}else{mapped=false;} 14 | jMapper={gmarkers:gmarkers,settings:settings,mapped:mapped,map:map,markerManager:markerManager,gmarkersArray:gmarkersArray,getBounds:getBounds,getPlacesData:getPlacesData,getPlaces:getPlaces,update:function(){if($(document).trigger('beforeUpdate.jMapping',[this])!=false){init(true);this.map=map;this.gmarkers=gmarkers;this.markerManager=markerManager;$(document).trigger('afterUpdate.jMapping',[this]);}}};$(document).trigger('afterMapping.jMapping',[jMapper]);return jMapper;}else{return $(map_elm).data('jMapping');}};$.extend($.jMapping,{defaults:{side_bar_selector:'#map-side-bar:first',location_selector:'.map-location',link_selector:'a.map-link',info_window_selector:'.info-box',info_window_max_width:425,default_point:{lat:0.0,lng:0.0},metadata_options:{type:'attr',name:'data-jmapping'}},makeGLatLng:function(place_point){return new google.maps.LatLng(place_point.lat,place_point.lng);}});$.fn.jMapping=function(options){if((options=='update')&&$(this[0]).data('jMapping')){$(this[0]).data('jMapping').update();}else{if(options=='update')options={};$(this[0]).data('jMapping',$.jMapping(this[0],options));} 15 | return this;};})(jQuery); -------------------------------------------------------------------------------- /spec/jmapping_spec.js: -------------------------------------------------------------------------------- 1 | Screw.Unit(function(){ 2 | 3 | describe("makeGLatLng", function(){ 4 | before(function(){ 5 | google.maps.LatLng = mock_function(function(lat, lng){}, 'GLatLng'); 6 | google.maps.LatLng.should_be_invoked().exactly('once').with_arguments(70, 50); 7 | }); 8 | 9 | it("should be invoked", function(){ 10 | expect($.jMapping.makeGLatLng({lat: 70, lng: 50})).to(be_true); 11 | }); 12 | }); 13 | 14 | describe("jMapping", function(){ 15 | before(function(){ 16 | // mock out Marker 17 | google.maps.InfoWindow = Smoke.MockFunction(function(options){}, 'InfoWindow'); 18 | 19 | $('#map-side-bar .map-location .info-box').each(function(){ 20 | google.maps.InfoWindow.should_be_invoked().exactly('once').with_arguments({ 21 | content: $(this).html(), 22 | maxWidth: 425 23 | }); 24 | }); 25 | 26 | mockGMaps(); 27 | mockMarkerManager(); 28 | }); 29 | after(function(){ 30 | $('#map').data('jMapping', null); 31 | $('#map-side-bar .map-location a.map-link').attr('href', '#'); 32 | $('#map-side-bar:first .map-location a.map-link').die('click'); 33 | }); 34 | 35 | it("should have 2 GMarkers", function(){ 36 | $('#map').jMapping(); 37 | var jmapper = $('#map').data('jMapping'); 38 | expect(jmapper.gmarkers[5]).to(be_true); 39 | expect(jmapper.gmarkers[8]).to(be_true); 40 | }); 41 | 42 | it("should hide the info html elements", function(){ 43 | $('#map').jMapping(); 44 | expect($('#map-side-bar .map-location .info-box')).to(match_selector, ':hidden'); 45 | }); 46 | 47 | it("should set the links to the correct URL", function(){ 48 | $('#map').jMapping(); 49 | expect($('#map-side-bar .map-location a.map-link#location5').attr('href')).to(equal, '#5'); 50 | expect($('#map-side-bar .map-location a.map-link#location8').attr('href')).to(equal, '#8'); 51 | }); 52 | 53 | it("should only create the jMapping object once", function(){ 54 | $('#map').jMapping(); 55 | $('#map').jMapping(); 56 | expect($('#map').data('jMapping')).to(be_true); 57 | }); 58 | 59 | it('should fire a "beforeMapping.jMapping" event', function(){ 60 | var callback = mock_function(function(){}, 'beforeMapping.jMapping'); 61 | callback.should_be_invoked().exactly('once'); 62 | $(document).bind('beforeMapping.jMapping', callback); 63 | $('#map').jMapping(); 64 | }); 65 | 66 | it('should fire a "afterMapping.jMapping" event', function(){ 67 | var callback = mock_function(function(){}, 'afterMapping.jMapping'); 68 | callback.should_be_invoked().exactly('once'); 69 | $(document).bind('afterMapping.jMapping', callback); 70 | $('#map').jMapping(); 71 | }); 72 | 73 | it('should fire a "markerCreated.jMapping" event', function(){ 74 | var callback = mock_function(function(){}, 'markerCreated.jMapping'); 75 | callback.should_be_invoked().exactly('twice'); 76 | $(document).bind('markerCreated.jMapping', callback); 77 | $('#map').jMapping(); 78 | }); 79 | 80 | describe("object created", function(){ 81 | var jMapper; 82 | before(function(){ 83 | $('#map').jMapping(); 84 | jMapper = $('#map').data('jMapping'); 85 | }); 86 | 87 | it("should have a settings object", function(){ 88 | expect(typeof jMapper.settings).to(equal, 'object'); 89 | }); 90 | 91 | it("should have a mapped boolean", function(){ 92 | expect(typeof jMapper.mapped).to(equal, 'boolean'); 93 | expect(jMapper.mapped).to(be_true); 94 | }); 95 | 96 | it("should have a map GMap2 object", function(){ 97 | expect(typeof jMapper.map).to(equal, 'object'); 98 | expect(jMapper.map instanceof google.maps.Map).to(be_true); 99 | }); 100 | 101 | it("should have a markerManager MarkerManager object", function(){ 102 | expect(typeof jMapper.markerManager).to(equal, 'object'); 103 | expect(jMapper.markerManager instanceof MarkerManager).to(be_true); 104 | }); 105 | 106 | it("should have a gmarkersArray method that returns an array of markers", function(){ 107 | expect($.isFunction(jMapper.gmarkersArray)).to(be_true); 108 | expect(jMapper.gmarkersArray()[0] instanceof google.maps.Marker).to(be_true); 109 | }); 110 | 111 | it("should have a getBounds method", function(){ 112 | expect($.isFunction(jMapper.getBounds)).to(be_true); 113 | }); 114 | 115 | it("should have a getPlacesData method", function(){ 116 | expect($.isFunction(jMapper.getPlacesData)).to(be_true); 117 | }); 118 | 119 | it("should have a getPlaces method that returns a jQuery object", function(){ 120 | expect($.isFunction(jMapper.getPlaces)).to(be_true); 121 | expect(jMapper.getPlaces() instanceof jQuery).to(be_true); 122 | }); 123 | 124 | it("should have an update method", function(){ 125 | expect($.isFunction(jMapper.update)).to(be_true); 126 | }); 127 | }); 128 | 129 | describe("setting link_selector to false", function(){ 130 | before(function(){ 131 | $('#map').jMapping({link_selector: false}); 132 | }); 133 | after(function(){ 134 | delete google.maps.event._expectations; 135 | google.maps.event = {}; 136 | }); 137 | 138 | it("should not change the links url", function(){ 139 | expect($('#map-side-bar .map-location a.map-link#location5').attr('href')).to_not(equal, '#5'); 140 | expect($('#map-side-bar .map-location a.map-link#location8').attr('href')).to_not(equal, '#8'); 141 | }); 142 | 143 | it("should not trigger the GEvent function", function(){ 144 | google.maps.event.should_receive('trigger').exactly(0, 'times') 145 | .with_arguments($('#map').data('jMapping').gmarkers[5], 'click'); 146 | 147 | $('#map-side-bar .map-location a.map-link#location5').trigger('click'); 148 | }); 149 | }); 150 | 151 | describe("click events for links", function(){ 152 | before(function(){ 153 | $('#map').jMapping(); 154 | }); 155 | after(function(){ 156 | delete google.maps.event._expectations; 157 | google.maps.event = {}; 158 | }); 159 | 160 | it("should trigger the GEvent function", function(){ 161 | google.maps.event.should_receive('trigger').exactly('once') 162 | .with_arguments($('#map').data('jMapping').gmarkers[5], 'click'); 163 | 164 | $('#map-side-bar .map-location a.map-link#location5').trigger('click'); 165 | }); 166 | }); 167 | }); 168 | 169 | describe('jMapping with update', function(){ 170 | var update_html = '
'+ 171 | ' Some New Place'+ 172 | '

Test Text.

'+ 173 | '
'+ 174 | '
'+ 175 | ' Another Cool New Place'+ 176 | '

New Text.

'+ 177 | '
'; 178 | var old_html; 179 | before(function(){ 180 | // mock out Marker 181 | google.maps.InfoWindow = Smoke.MockFunction(function(options){}, 'InfoWindow'); 182 | $('#map-side-bar .map-location .info-box').each(function(){ 183 | google.maps.InfoWindow.should_be_invoked().exactly('once').with_arguments({ 184 | content: $(this).html(), 185 | maxWidth: 425 186 | }); 187 | }); 188 | google.maps.InfoWindow.should_be_invoked().exactly('once').with_arguments({ 189 | content: '

Test Text.

', 190 | maxWidth: 425 191 | }); 192 | google.maps.InfoWindow.should_be_invoked().exactly('once').with_arguments({ 193 | content: '

New Text.

', 194 | maxWidth: 425 195 | }); 196 | 197 | mockGMapsUpdate(); 198 | mockMarkerManager(true); 199 | 200 | old_html = $('#map-side-bar').html(); 201 | }); 202 | after(function(){ 203 | $('#map').data('jMapping', null); 204 | $('#map-side-bar .map-location a.map-link').attr('href', '#'); 205 | $('#map-side-bar:first .map-location a.map-link').die('click'); 206 | $('#map-side-bar').html(old_html); 207 | }); 208 | 209 | it("should have 2 GMarkers", function(){ 210 | $('#map').jMapping(); 211 | $('#map-side-bar').html(update_html); 212 | var jmapper = $('#map').data('jMapping'); 213 | jmapper.update(); 214 | expect(jmapper.gmarkers[22]).to(be_true); 215 | expect(jmapper.gmarkers[28]).to(be_true); 216 | }); 217 | 218 | it("should hide the info html elements", function(){ 219 | $('#map').jMapping(); 220 | $('#map-side-bar').html(update_html); 221 | $('#map').data('jMapping').update(); 222 | expect($('#map-side-bar .map-location .info-box')).to(match_selector, ':hidden'); 223 | }); 224 | 225 | it("should set the links to the correct URL", function(){ 226 | $('#map').jMapping(); 227 | $('#map-side-bar').html(update_html); 228 | $('#map').data('jMapping').update(); 229 | expect($('#map-side-bar .map-location a.map-link#location22').attr('href')).to(equal, '#22'); 230 | expect($('#map-side-bar .map-location a.map-link#location28').attr('href')).to(equal, '#28'); 231 | }); 232 | 233 | it('should fire the "beforeUpdate.jMapping" event', function(){ 234 | var callback = mock_function(function(){}, 'beforeUpdate.jMapping'); 235 | callback.should_be_invoked().exactly('once'); 236 | $(document).bind('beforeUpdate.jMapping', callback); 237 | 238 | $('#map').jMapping(); 239 | $('#map-side-bar').html(update_html); 240 | $('#map').data('jMapping').update(); 241 | }); 242 | 243 | it('should fire the "afterUpdate.jMapping" event', function(){ 244 | var callback = mock_function(function(){}, 'afterUpdate.jMapping'); 245 | callback.should_be_invoked().exactly('once'); 246 | $(document).bind('afterUpdate.jMapping', callback); 247 | 248 | $('#map').jMapping(); 249 | $('#map-side-bar').html(update_html); 250 | $('#map').data('jMapping').update(); 251 | }); 252 | 253 | describe("click events for links", function(){ 254 | before(function(){ 255 | $('#map').jMapping(); 256 | $('#map-side-bar').html(update_html); 257 | $('#map').data('jMapping').update(); 258 | }); 259 | after(function(){ 260 | delete google.maps.event._expectations; 261 | google.maps.event = {}; 262 | }); 263 | 264 | it("should trigger the GEvent function", function(){ 265 | delete google.maps.event._expectations; 266 | google.maps.event = mock(); 267 | google.maps.event.should_receive('trigger').exactly('once').with_arguments($('#map').data('jMapping').gmarkers[22], 'click'); 268 | 269 | $('#map-side-bar .map-location a.map-link#location22').trigger('click'); 270 | }); 271 | }); 272 | }); 273 | 274 | describe("jMapping with no location items", function(){ 275 | before(function(){ 276 | // mock out GLatLng 277 | google.maps.LatLng = Smoke.MockFunction(function(lat, lng){}, 'LatLng'); 278 | google.maps.LatLng.should_be_invoked().at_least('once'); 279 | 280 | // mock out GMap2 281 | var gmap_mock = Smoke.Mock(); 282 | gmap_mock.should_receive('fitBounds').exactly('once'); 283 | $.extend(google.maps.Map.prototype, gmap_mock); 284 | 285 | // mock out Bounds 286 | google.maps.LatLngBounds = Smoke.MockFunction(function(point1, point2){}, 'LatLngBounds'); 287 | google.maps.LatLngBounds.should_be_invoked().exactly('once'); 288 | 289 | google.maps.event = Smoke.Mock(); 290 | google.maps.event.should_receive('addListener').at_least('once'); 291 | 292 | mockMarkerManager(); 293 | }); 294 | after(function(){ 295 | $('#map').data('jMapping', null); 296 | }); 297 | it("should function correctly", function(){ 298 | $('#map').jMapping({ 299 | side_bar_selector: 'ul#empty-map-side-bar' 300 | }); 301 | expect($('#map').data('jMapping')).to(be_true); 302 | }); 303 | }); 304 | 305 | describe("jMapping with options", function(){ 306 | before(function(){ 307 | // mock out Marker 308 | google.maps.InfoWindow = Smoke.MockFunction(function(options){}, 'InfoWindow'); 309 | $('ul#map-item-list li.location .info-html').each(function(){ 310 | google.maps.InfoWindow.should_be_invoked().exactly('once').with_arguments({ 311 | content: $(this).html(), 312 | maxWidth: 380 313 | }); 314 | }); 315 | 316 | mockGMaps(); 317 | mockMarkerManager(); 318 | 319 | $('#map').jMapping({ 320 | side_bar_selector: 'ul#map-item-list', 321 | location_selector: 'li.location', 322 | link_selector: 'a.map-item', 323 | info_window_selector: '.info-html', 324 | info_window_max_width: 380 325 | }); 326 | }); 327 | after(function(){ 328 | $('#map').data('jMapping', null); 329 | $('ul#map-item-list li.location a.map-item').attr('href', '#'); 330 | $('ul#map-item-list li.location a.map-item').die('click'); 331 | }); 332 | 333 | it("should have 2 GMarkers", function(){ 334 | var jmapper = $('#map').data('jMapping'); 335 | 336 | expect(jmapper.gmarkers[27]).to(be_true); 337 | expect(jmapper.gmarkers[23]).to(be_true); 338 | }); 339 | 340 | it("should hide the info html elements", function(){ 341 | expect($('ul#map-item-list li.location .info-html')).to(match_selector, ':hidden'); 342 | }); 343 | 344 | it("should set the links to the correct URL", function(){ 345 | expect($('ul#map-item-list li.location a.map-item#location27').attr('href')).to(equal, '#27'); 346 | expect($('ul#map-item-list li.location a.map-item#location23').attr('href')).to(equal, '#23'); 347 | }); 348 | 349 | describe("click events for links", function(){ 350 | it("should trigger the GEvent function", function(){ 351 | google.maps.event.should_receive('trigger').exactly('once') 352 | .with_arguments($('#map').data('jMapping').gmarkers[27], 'click'); 353 | 354 | $('ul#map-item-list li.location a.map-item#location27').trigger('click'); 355 | }); 356 | }); 357 | }); 358 | 359 | describe("jMapping with an alternate metadata storage", function(){ 360 | before(function(){ 361 | // mock out Marker 362 | google.maps.InfoWindow = Smoke.MockFunction(function(options){}, 'InfoWindow'); 363 | $('ul#map-list li.location .info-box').each(function(){ 364 | google.maps.InfoWindow.should_be_invoked().exactly('once').with_arguments({ 365 | content: $(this).html(), 366 | maxWidth: 425 367 | }); 368 | }); 369 | 370 | mockGMaps(); 371 | mockMarkerManager(); 372 | }); 373 | after(function(){ 374 | $('#map').data('jMapping', null); 375 | $('#map-side-bar .map-location a.map-link').attr('href', '#'); 376 | $('#map-side-bar .map-location a.map-link').die('click'); 377 | }); 378 | 379 | it("should function correctly", function(){ 380 | $('#map').jMapping({ 381 | side_bar_selector: 'ul#map-list', 382 | location_selector: 'li.location', 383 | metadata_options: {type: 'html5'} 384 | }); 385 | expect($('#map').data('jMapping')).to(be_true); 386 | }); 387 | }); 388 | 389 | describe("jMapping with no categories and 'category_icon_options'", function(){ 390 | before(function(){ 391 | // mock out Marker 392 | google.maps.InfoWindow = Smoke.MockFunction(function(options){}, 'InfoWindow'); 393 | $('ul#map-list li.location .info-box').each(function(){ 394 | google.maps.InfoWindow.should_be_invoked().exactly('once').with_arguments({ 395 | content: $(this).html(), 396 | maxWidth: 425 397 | }); 398 | }); 399 | 400 | mockGMaps(true); 401 | mockMarkerManager(); 402 | }); 403 | after(function(){ 404 | $('#map').data('jMapping', null); 405 | $('#map-side-bar .map-location a.map-link').attr('href', '#'); 406 | $('#map-side-bar:first .map-location a.map-link').die('click'); 407 | }); 408 | 409 | it("should function correctly", function(){ 410 | $('#map').jMapping({ 411 | side_bar_selector: 'ul#map-list', 412 | location_selector: 'li.location', 413 | category_icon_options: {'fun': {color: '#33FFFF'}, 'default': {color: '#CC0000'}}, 414 | metadata_options: {type: 'html5'} 415 | }); 416 | expect($('#map').data('jMapping')).to(be_true); 417 | }); 418 | }); 419 | 420 | describe("setting a function to category_icon_options", function(){ 421 | var category_function; 422 | before(function(){ 423 | // mock out Marker 424 | google.maps.InfoWindow = Smoke.MockFunction(function(options){}, 'InfoWindow'); 425 | $('#map-side-bar .map-location .info-box').each(function(){ 426 | google.maps.InfoWindow.should_be_invoked().exactly('once').with_arguments({ 427 | content: $(this).html(), 428 | maxWidth: 425 429 | }); 430 | }); 431 | 432 | mockGMaps(true); 433 | mockMarkerManager(); 434 | 435 | category_function = mock_function(function(category){ 436 | if (category.charAt(0).match(/[a-m]/i)){ 437 | return {color: '#CC0000'}; 438 | } else if (category.charAt(0).match(/[n-z]/i)){ 439 | return {color: '#33FFFF'}; 440 | } else { 441 | return {color: '#00FFCC'}; 442 | } 443 | }, 'category_icon_options_function'); 444 | category_function.should_be_invoked().exactly('twice'); 445 | }); 446 | after(function(){ 447 | $('#map').data('jMapping', null); 448 | $('#map-side-bar .map-location a.map-link').attr('href', '#'); 449 | $('#map-side-bar:first .map-location a.map-link').die('click'); 450 | }); 451 | 452 | it("should function correctly", function(){ 453 | $('#map').jMapping({ 454 | category_icon_options: category_function 455 | }); 456 | expect($('#map').data('jMapping')).to(be_true); 457 | }); 458 | }); 459 | 460 | describe("setting a function to category_icon_options that returns a string", function(){ 461 | var category_function; 462 | before(function(){ 463 | google.maps.InfoWindow = Smoke.MockFunction(function(options){}, 'InfoWindow'); 464 | $('#map-side-bar .map-location .info-box').each(function(){ 465 | google.maps.InfoWindow.should_be_invoked().exactly('once').with_arguments({ 466 | content: $(this).html(), 467 | maxWidth: 425 468 | }); 469 | }); 470 | 471 | mockGMaps(); 472 | mockMarkerManager(); 473 | 474 | category_function = mock_function(function(category){ 475 | return '/images/map_icons/icon1.jpg'; 476 | }, 'category_icon_options_function'); 477 | category_function.should_be_invoked().exactly('twice'); 478 | }); 479 | after(function(){ 480 | $('#map').data('jMapping', null); 481 | $('#map-side-bar .map-location a.map-link').attr('href', '#'); 482 | $('#map-side-bar:first .map-location a.map-link').die('click'); 483 | }); 484 | 485 | it("should function correctly", function(){ 486 | $('#map').jMapping({ 487 | category_icon_options: category_function 488 | }); 489 | expect($('#map').data('jMapping')).to(be_true); 490 | }); 491 | }); 492 | 493 | describe("setting a function to category_icon_options that returns a MarkerImage", function(){ 494 | var category_function; 495 | before(function(){ 496 | google.maps.InfoWindow = Smoke.MockFunction(function(options){}, 'InfoWindow'); 497 | $('#map-side-bar .map-location .info-box').each(function(){ 498 | google.maps.InfoWindow.should_be_invoked().exactly('once').with_arguments({ 499 | content: $(this).html(), 500 | maxWidth: 425 501 | }); 502 | }); 503 | 504 | mockGMaps(); 505 | mockMarkerManager(); 506 | 507 | category_function = mock_function(function(category){ 508 | return new google.maps.MarkerImage('/images/map_icons/icon1.jpg'); 509 | }, 'category_icon_options_function'); 510 | category_function.should_be_invoked().exactly('twice'); 511 | }); 512 | after(function(){ 513 | $('#map').data('jMapping', null); 514 | $('#map-side-bar .map-location a.map-link').attr('href', '#'); 515 | $('#map-side-bar:first .map-location a.map-link').die('click'); 516 | }); 517 | 518 | it("should function correctly", function(){ 519 | $('#map').jMapping({ 520 | category_icon_options: category_function 521 | }); 522 | expect($('#map').data('jMapping')).to(be_true); 523 | }); 524 | }); 525 | 526 | }); 527 | -------------------------------------------------------------------------------- /spec/screw.css: -------------------------------------------------------------------------------- 1 | * { 2 | margin: 0; 3 | padding: 0; 4 | font-weight: normal; 5 | list-style: none; 6 | font-size: 1em; 7 | } 8 | 9 | body { 10 | background: #fff; 11 | color: #333; 12 | font-family: "Helvetica Neue", Helvetica, Arial, "Sans-Serif"; 13 | font-size: 78.5%; 14 | padding-top: 3em; 15 | } 16 | 17 | h3.status { 18 | position: fixed; 19 | width: 100%; 20 | top: 0; 21 | left: 0; 22 | margin: 0 0 1em 0; 23 | padding: .75em; 24 | font-size: 1.1em; 25 | color: #fff; 26 | background-color: #3875d7; 27 | font-weight: normal; 28 | -webkit-box-shadow: 0px 1px 5px #666; 29 | -moz-box-shadow: 0px 2px 3px #999; 30 | } 31 | 32 | ul { 33 | margin: .5em 0; 34 | padding: 0 1em; 35 | } 36 | 37 | h1 { 38 | margin: 0 1em; 39 | padding: .25em 0; 40 | border-bottom: 1px dotted #ccc; 41 | font-weight: bold; 42 | } 43 | 44 | h2 { 45 | padding: .2em .5em; 46 | color: #ccc; 47 | } 48 | 49 | .enqueued h2 { 50 | color: #999; 51 | } 52 | 53 | .passed h2 { 54 | color: #333; 55 | background: #abffa5; 56 | border-top: 2px solid #ccffcc; 57 | border-bottom: 2px solid #66ff66; 58 | } 59 | 60 | .failed h2 { 61 | color: #333; 62 | background: #ffaaaa; 63 | border-top: 2px solid #ffcccc; 64 | border-bottom: 2px solid #ff9977; 65 | } 66 | 67 | .error { 68 | background-color: #f9f9f9; 69 | margin-bottom: .5em; 70 | padding: 1em; 71 | border-left: 1px solid #ddd; 72 | border-right: 1px solid #ddd; 73 | border-bottom: 1px solid #ddd; 74 | } 75 | -------------------------------------------------------------------------------- /spec/screw.unit/jquery.fn.js: -------------------------------------------------------------------------------- 1 | (function($) { 2 | $.fn.fn = function() { 3 | var self = this; 4 | var extension = arguments[0], name = arguments[0]; 5 | if (typeof name == "string") { 6 | return apply(self, name, $.makeArray(arguments).slice(1, arguments.length)); 7 | } else { 8 | $.each(extension, function(key, value) { 9 | define(self, key, value); 10 | }); 11 | return self; 12 | } 13 | }; 14 | function define(self, name, fn) { 15 | self.data(namespacedName(name), fn); 16 | }; 17 | function apply(self, name, args) { 18 | var result; 19 | self.each(function(i, item) { 20 | var fn = $(item).data(namespacedName(name)); 21 | if (fn) result = fn.apply(item, args) 22 | else throw(name + " is not defined"); 23 | }); 24 | 25 | return result; 26 | }; 27 | function namespacedName(name) { 28 | return 'fn.' + name; 29 | } 30 | })(jQuery); -------------------------------------------------------------------------------- /spec/screw.unit/jquery.print.js: -------------------------------------------------------------------------------- 1 | (function($) { 2 | 3 | function print_array(obj, opts) { 4 | var result = []; 5 | for (var i = 0; i < Math.min(opts.max_array, obj.length); i++) 6 | result.push($.print(obj[i], $.extend({}, opts, { max_array: 3, max_string: 40 }))); 7 | 8 | if (obj.length > opts.max_array) 9 | result.push((obj.length - opts.max_array) + ' more...'); 10 | if (result.length == 0) return "[]"; 11 | return "[ " + result.join(", ") + " ]"; 12 | } 13 | 14 | function print_element(obj) { 15 | if (obj.nodeType == 1) { 16 | var result = []; 17 | var properties = [ 'className', 'id' ]; 18 | var extra = { 19 | 'input': ['type', 'name', 'value'], 20 | 'a': ['href', 'target'], 21 | 'form': ['method', 'action'], 22 | 'script': ['src'], 23 | 'link': ['href'], 24 | 'img': ['src'] 25 | }; 26 | 27 | $.each(properties.concat(extra[obj.tagName.toLowerCase()] || []), function(){ 28 | if (obj[this]) 29 | result.push(' ' + this.replace('className', 'class') + "=" + $.print(obj[this])); 30 | }); 31 | return "<" + obj.tagName.toLowerCase() 32 | + result.join('') + ">"; 33 | } 34 | } 35 | 36 | function print_object(obj, opts) { 37 | var seen = opts.seen || [ obj ]; 38 | 39 | var result = [], key, value; 40 | for (var k in obj) { 41 | if (obj.hasOwnProperty(k) && $.inArray(obj[k], seen) < 0) { 42 | seen.push(obj[k]); 43 | value = $.print(obj[k], $.extend({}, opts, { max_array: 6, max_string: 40, seen: seen })); 44 | } else 45 | value = "..."; 46 | result.push(k + ": " + value); 47 | } 48 | if (result.length == 0) return "{}"; 49 | return "{ " + result.join(", ") + " }"; 50 | } 51 | 52 | function print_string(value, opts) { 53 | var character_substitutions = { 54 | '\b': '\\b', 55 | '\t': '\\t', 56 | '\n': '\\n', 57 | '\f': '\\f', 58 | '\r': '\\r', 59 | '"' : '\\"', 60 | '\\': '\\\\' 61 | }; 62 | var r = /["\\\x00-\x1f\x7f-\x9f]/g; 63 | 64 | var str = r.test(value) 65 | ? '"' + value.replace(r, function (a) { 66 | var c = character_substitutions[a]; 67 | if (c) return c; 68 | c = a.charCodeAt(); 69 | return '\\u00' + Math.floor(c / 16).toString(16) + (c % 16).toString(16); 70 | }) + '"' 71 | : '"' + value + '"'; 72 | if (str.length > opts.max_string) 73 | return str.slice(0, opts.max_string + 1) + '..."'; 74 | else 75 | return str; 76 | } 77 | 78 | $.print = function(obj, options) { 79 | var opts = $.extend({}, { max_array: 10, max_string: 100 }, options); 80 | 81 | if (typeof obj == 'undefined') 82 | return "undefined"; 83 | else if (typeof obj == 'boolean') 84 | return obj.toString(); 85 | else if (typeof obj == 'number') 86 | return obj.toString(); 87 | else if (!obj) 88 | return "null"; 89 | else if (typeof obj == 'string') 90 | return print_string(obj, opts); 91 | else if (obj instanceof RegExp) 92 | return obj.toString(); 93 | else if (obj instanceof Array || obj.callee || obj.item) 94 | return print_array(obj, opts); 95 | else if (typeof obj == 'function' || obj instanceof Function) 96 | return obj.toString().match(/^([^)]*\))/)[1]; 97 | else if (obj.nodeType) 98 | return print_element(obj); 99 | else if (obj instanceof jQuery) 100 | return "$(" + $.print(obj.get()) + ")"; 101 | else if (obj instanceof Error) 102 | return print_object(obj, $.extend({}, options, { max_string: 200 })); 103 | else if (obj instanceof Object) 104 | return print_object(obj, opts); 105 | else 106 | return obj.toString().replace(/\n\s*/g, ''); 107 | }; 108 | 109 | })(jQuery); -------------------------------------------------------------------------------- /spec/screw.unit/screw.behaviors.js: -------------------------------------------------------------------------------- 1 | (function($) { 2 | $(Screw).bind('loaded', function() { 3 | $('.status').fn({ 4 | display: function() { 5 | $(this).html( 6 | $('.passed').length + $('.failed').length + ' test(s), ' + $('.failed').length + ' failure(s)
' + 7 | ((new Date() - Screw.suite_start_time)/1000.0).toString() + " seconds elapsed" 8 | ); 9 | } 10 | }); 11 | 12 | $('.describe').fn({ 13 | parent: function() { 14 | return $(this).parent('.describes').parent('.describe'); 15 | }, 16 | 17 | run_befores: function() { 18 | $(this).fn('parent').fn('run_befores'); 19 | $(this).children('.befores').children('.before').fn('run'); 20 | }, 21 | 22 | run_afters: function() { 23 | $(this).fn('parent').fn('run_afters'); 24 | $(this).children('.afters').children('.after').fn('run'); 25 | }, 26 | 27 | enqueue: function() { 28 | $(this).children('.its').children('.it').fn('enqueue'); 29 | $(this).children('.describes').children('.describe').fn('enqueue'); 30 | }, 31 | 32 | selector: function() { 33 | return $(this).fn('parent').fn('selector') 34 | + ' > .describes > .describe:eq(' + $(this).parent('.describes').children('.describe').index(this) + ')'; 35 | } 36 | }); 37 | 38 | $('body > .describe').fn({ 39 | selector: function() { return 'body > .describe'; } 40 | }); 41 | 42 | $('.it').fn({ 43 | parent: function() { 44 | return $(this).parent('.its').parent('.describe'); 45 | }, 46 | 47 | run: function() { 48 | var self = this; 49 | $(this).data('screwunit.run_segment', function () { 50 | $(self).fn('parent').fn('run_befores'); 51 | $(self).data('screwunit.run')(); 52 | }); 53 | $(this).fn('run_segment'); 54 | }, 55 | 56 | run_segment: function() { 57 | var failure = null; 58 | try { 59 | $(this).data('screwunit.run_segment')(); 60 | $(this).trigger('finished.screwunit'); 61 | } catch(e) { 62 | if (e instanceof Screw.Wait) { 63 | var self = this; 64 | $(this).data('timeout', setTimeout(function () { 65 | $(self).data('screwunit.run_segment', e.func); 66 | $(self).fn("run_segment"); 67 | }, e.delay)); 68 | return; 69 | } else { 70 | failure = [e]; 71 | } 72 | } 73 | 74 | try { 75 | if (failure) { 76 | $(this).trigger('failed', failure); 77 | } else { 78 | $(this).trigger('passed'); 79 | } 80 | } finally { 81 | $(this).fn('parent').fn('run_afters'); 82 | $(this).removeData('timeout'); 83 | } 84 | }, 85 | 86 | enqueue: function() { 87 | var self = $(this).trigger('enqueued'); 88 | $(Screw) 89 | .queue(function() { 90 | self.fn('run'); 91 | if (self.data('timeout')) { 92 | // If the test contains pending async elements, wait for 93 | // them to complete. 94 | var watcher = setInterval(function () { 95 | if (!self.data('timeout')) { 96 | clearInterval(watcher); 97 | $(Screw).dequeue(); 98 | } 99 | }, 100); 100 | } else { 101 | // Otherwise, immediately start the next test. 102 | setTimeout(function() { $(Screw).dequeue(); }, 0); 103 | } 104 | }); 105 | }, 106 | 107 | selector: function() { 108 | return $(this).fn('parent').fn('selector') 109 | + ' > .its > .it:eq(' + $(this).parent('.its').children('.it').index(this) + ')'; 110 | } 111 | }); 112 | 113 | $('body .before').fn({ 114 | run: function() { $(this).data('screwunit.run')(); } 115 | }); 116 | 117 | $('body .after').fn({ 118 | run: function() { 119 | $(this).data('screwunit.run')(); } 120 | }); 121 | 122 | $(Screw).trigger('before'); 123 | var to_run = unescape(location.search.slice(1)) || 'body > .describe > .describes > .describe'; 124 | $(to_run) 125 | .focus() 126 | .eq(0).trigger('scroll').end() 127 | .fn('enqueue'); 128 | $(Screw).queue(function() { $(Screw).trigger('after'); }); 129 | }); 130 | })(jQuery); 131 | -------------------------------------------------------------------------------- /spec/screw.unit/screw.builder.js: -------------------------------------------------------------------------------- 1 | var Screw = (function($) { 2 | var screw = { 3 | Unit: function(fn) { 4 | var wrappedFn; 5 | if(fn.length == 0) { 6 | var contents = fn.toString().match(/^[^\{]*{((.*\n*)*)}/m)[1]; 7 | wrappedFn = new Function("matchers", "specifications", 8 | "with (specifications) { with (matchers) { " + contents + " } }" 9 | ); 10 | } else { 11 | wrappedFn = function(matchers, specifications) { 12 | var screwContext = {}; 13 | for(var method in matchers) { 14 | screwContext[method] = matchers[method]; 15 | } 16 | for(var method in specifications) { 17 | screwContext[method] = specifications[method]; 18 | } 19 | fn(screwContext); 20 | }; 21 | } 22 | 23 | $(Screw).queue(function() { 24 | Screw.Specifications.context.push($('body > .describe')); 25 | wrappedFn.call(this, Screw.Matchers, Screw.Specifications); 26 | Screw.Specifications.context.pop(); 27 | $(this).dequeue(); 28 | }); 29 | }, 30 | 31 | Wait: function (fn, ms) { 32 | this.func = fn; 33 | this.delay = ms; 34 | 35 | this.toString = function () { 36 | return "Screw.Wait for " + this.delay + "ms and then execute " + this.func; 37 | }; 38 | }, 39 | 40 | Specifications: { 41 | context: [], 42 | 43 | describe: function(name, fn) { 44 | var describe = $('
  • ') 45 | .append($('

    ').text(name)) 46 | .append('
      ') 47 | .append('') 48 | .append('') 49 | .append('
        '); 50 | 51 | this.context.push(describe); 52 | fn.call(); 53 | this.context.pop(); 54 | 55 | this.context[this.context.length-1] 56 | .children('.describes') 57 | .append(describe); 58 | }, 59 | 60 | it: function(name, fn) { 61 | var it = $('
      1. ') 62 | .append($('

        ').text(name)) 63 | .data('screwunit.run', fn); 64 | 65 | this.context[this.context.length-1] 66 | .children('.its') 67 | .append(it); 68 | }, 69 | 70 | before: function(fn) { 71 | var before = $('
      2. ') 72 | .data('screwunit.run', fn); 73 | 74 | this.context[this.context.length-1] 75 | .children('.befores') 76 | .append(before); 77 | }, 78 | 79 | after: function(fn) { 80 | var after = $('
      3. ') 81 | .data('screwunit.run', fn); 82 | 83 | this.context[this.context.length-1] 84 | .children('.afters') 85 | .append(after); 86 | }, 87 | 88 | wait: function(fn, ms) { 89 | throw new Screw.Wait(fn, ms); 90 | } 91 | } 92 | }; 93 | 94 | $(screw).queue(function() { $(screw).trigger('loading'); }); 95 | $(window).load(function(){ 96 | $('
        ') 97 | .append('

        ') 98 | .append('
          ') 99 | .append('') 100 | .append('
            ') 101 | .appendTo('body'); 102 | 103 | $(screw).dequeue(); 104 | $(screw).trigger('loaded'); 105 | }); 106 | 107 | return screw; 108 | })(jQuery); -------------------------------------------------------------------------------- /spec/screw.unit/screw.events.js: -------------------------------------------------------------------------------- 1 | (function($) { 2 | $(Screw) 3 | .bind('loaded', function() { 4 | $('.describe, .it') 5 | .click(function() { 6 | document.location = location.href.split('?')[0] + '?' + $(this).fn('selector'); 7 | return false; 8 | }) 9 | .focus(function() { 10 | return $(this).addClass('focused'); 11 | }) 12 | .bind('scroll', function() { 13 | document.body.scrollTop = $(this).offset().top; 14 | }); 15 | 16 | $('.it') 17 | .bind('enqueued', function() { 18 | $(this).addClass('enqueued'); 19 | }) 20 | .bind('running', function() { 21 | $(this).addClass('running'); 22 | }) 23 | .bind('passed', function() { 24 | $(this).addClass('passed'); 25 | }) 26 | .bind('failed', function(e, reason) { 27 | $(this) 28 | .addClass('failed') 29 | .append($('

            ').text(reason.message || reason.toString())); 30 | 31 | var file = reason.fileName || reason.sourceURL; 32 | var line = reason.lineNumber || reason.line; 33 | if (file || line) { 34 | $(this).append($('

            ').text('line ' + line + ', ' + file)); 35 | } 36 | }); 37 | }) 38 | .bind('before', function() { 39 | Screw.suite_start_time = new Date(); 40 | $('.status').text('Running...'); 41 | }) 42 | .bind('after', function() { 43 | $('body .status').fn('display'); 44 | }); 45 | })(jQuery); 46 | -------------------------------------------------------------------------------- /spec/screw.unit/screw.matchers.js: -------------------------------------------------------------------------------- 1 | Screw.Matchers = (function($) { 2 | return matchers = { 3 | expect: function(actual) { 4 | var funcname = function(f) { 5 | var s = f.toString().match(/function (\w*)/)[1]; 6 | if ((s == null) || (s.length == 0)) return "anonymous"; 7 | return s; 8 | }; 9 | 10 | var stacktrace = function() { 11 | var s = ""; 12 | for(var a = arguments.caller; a != null; a = a.caller) { 13 | s += funcname(a.callee) + "\n"; 14 | if (a.caller == a) break; 15 | } 16 | return s; 17 | }; 18 | 19 | return { 20 | to: function(matcher, expected, not) { 21 | var matched = matcher.match(expected, actual); 22 | if (not ? matched : !matched) { 23 | throw(matcher.failure_message(expected, actual, not)); 24 | } 25 | }, 26 | 27 | to_not: function(matcher, expected) { 28 | this.to(matcher, expected, true); 29 | } 30 | }; 31 | }, 32 | 33 | equal: { 34 | match: function(expected, actual) { 35 | if(expected == actual) return true; 36 | if(actual == undefined) return false; 37 | 38 | if (expected instanceof Array) { 39 | for (var i = 0; i < actual.length; i++) 40 | if (!Screw.Matchers.equal.match(expected[i], actual[i])) return false; 41 | return actual.length == expected.length; 42 | } else if (expected instanceof Object) { 43 | for (var key in expected) 44 | if (!this.match(expected[key], actual[key])) return false; 45 | for (var key in actual) 46 | if (!this.match(actual[key], expected[key])) return false; 47 | return true; 48 | } 49 | return false; 50 | }, 51 | 52 | failure_message: function(expected, actual, not) { 53 | return 'expected ' + $.print(actual) + (not ? ' to not equal ' : ' to equal ') + $.print(expected); 54 | } 55 | }, 56 | 57 | be_gt: { 58 | match: function(expected, actual) { 59 | return actual > expected; 60 | }, 61 | 62 | failure_message: function(expected, actual, not) { 63 | return 'expected ' + $.print(actual) + (not ? ' to not ' : ' to ') + 'be greater than ' + $.print(expected); 64 | } 65 | }, 66 | 67 | be_gte: { 68 | match: function(expected, actual) { 69 | return actual >= expected; 70 | }, 71 | 72 | failure_message: function(expected, actual, not) { 73 | return 'expected ' + $.print(actual) + (not ? ' to not ' : ' to ') + 'be greater than or equal to ' + $.print(expected); 74 | } 75 | }, 76 | 77 | be_lt: { 78 | match: function(expected, actual) { 79 | return actual < expected; 80 | }, 81 | 82 | failure_message: function(expected, actual, not) { 83 | return 'expected ' + $.print(actual) + (not ? ' to not ' : ' to ') + 'be less than ' + $.print(expected); 84 | } 85 | }, 86 | 87 | be_lte: { 88 | match: function(expected, actual) { 89 | return actual <= expected; 90 | }, 91 | 92 | failure_message: function(expected, actual, not) { 93 | return 'expected ' + $.print(actual) + (not ? ' to not ' : ' to ') + 'be less than or equal to ' + $.print(expected); 94 | } 95 | }, 96 | 97 | match: { 98 | match: function(expected, actual) { 99 | if (expected.constructor == RegExp) 100 | return expected.exec(actual.toString()); 101 | else 102 | return actual.indexOf(expected) > -1; 103 | }, 104 | 105 | failure_message: function(expected, actual, not) { 106 | return 'expected ' + $.print(actual) + (not ? ' to not match ' : ' to match ') + $.print(expected); 107 | } 108 | }, 109 | 110 | include: { 111 | match: function(expected, actual) { 112 | return $.inArray(expected, actual) >= 0; 113 | }, 114 | 115 | failure_message: function(expected, actual, not) { 116 | return 'expected ' + $.print(actual) + (not ? ' to not include ' : ' to include ') + $.print(expected); 117 | } 118 | }, 119 | 120 | be_empty: { 121 | match: function(expected, actual) { 122 | if (actual.length == undefined) throw(actual.toString() + " does not respond to length"); 123 | 124 | return actual.length == 0; 125 | }, 126 | 127 | failure_message: function(expected, actual, not) { 128 | return 'expected ' + $.print(actual) + (not ? ' to not be empty' : ' to be empty'); 129 | } 130 | }, 131 | 132 | be_blank: { 133 | match: function(expected, actual) { 134 | if (actual == undefined) return true; 135 | if (typeof(actual) == "string") actual = actual.replace(/^\s*(.*?)\s*$/, "$1"); 136 | return Screw.Matchers.be_empty.match(expected, actual); 137 | }, 138 | 139 | failure_message: function(expected, actual, not) { 140 | return 'expected ' + $.print(actual) + (not ? ' to not be blank' : ' to be blank'); 141 | } 142 | }, 143 | 144 | have_length: { 145 | match: function(expected, actual) { 146 | if (actual.length == undefined) throw(actual.toString() + " does not respond to length"); 147 | 148 | return actual.length == expected; 149 | }, 150 | 151 | failure_message: function(expected, actual, not) { 152 | return 'expected ' + $.print(actual) + (not ? ' to not' : ' to') + ' have length ' + expected; 153 | } 154 | }, 155 | 156 | be_null: { 157 | match: function(expected, actual) { 158 | return actual == null; 159 | }, 160 | 161 | failure_message: function(expected, actual, not) { 162 | return 'expected ' + $.print(actual) + (not ? ' to not be null' : ' to be null'); 163 | } 164 | }, 165 | 166 | be_undefined: { 167 | match: function(expected, actual) { 168 | return actual == undefined; 169 | }, 170 | 171 | failure_message: function(expected, actual, not) { 172 | return 'expected ' + $.print(actual) + (not ? ' to not be undefined' : ' to be undefined'); 173 | } 174 | }, 175 | 176 | be_true: { 177 | match: function(expected, actual) { 178 | return actual; 179 | }, 180 | 181 | failure_message: function(expected, actual, not) { 182 | return 'expected ' + $.print(actual) + (not ? ' to not be true' : ' to be true'); 183 | } 184 | }, 185 | 186 | be_false: { 187 | match: function(expected, actual) { 188 | return !actual; 189 | }, 190 | 191 | failure_message: function(expected, actual, not) { 192 | return 'expected ' + $.print(actual) + (not ? ' to not be false' : ' to be false'); 193 | } 194 | }, 195 | 196 | match_html: { 197 | munge: function(mungee) { 198 | if (mungee instanceof jQuery) { 199 | mungee = mungee.html(); 200 | } else if (typeof(mungee) == "string") { 201 | var span = document.createElement("span"); 202 | span.innerHTML = mungee; 203 | mungee = span.innerHTML; 204 | } 205 | 206 | var regEx = /\sjQuery\d+=['"]\d+['"]/g; 207 | mungee = mungee.replace(regEx, ""); 208 | 209 | return mungee; 210 | }, 211 | 212 | match: function(expected, actual) { 213 | var trimmedExpected = this.munge(expected); 214 | var trimmedActual = this.munge(actual); 215 | return trimmedActual.indexOf(trimmedExpected) > -1; 216 | }, 217 | 218 | failure_message: function(expected, actual, not) { 219 | var trimmedExpected = this.munge(expected); 220 | var trimmedActual = this.munge(actual); 221 | return 'expected ' + $.print(trimmedActual, { max_string: 300 }) + 222 | (not ? ' to not contain ' : ' to contain ') + $.print(trimmedExpected, { max_string: 300 }); 223 | } 224 | }, 225 | 226 | match_selector: { 227 | match: function(expected, actual) { 228 | if (!(actual instanceof jQuery)) { 229 | throw expected.toString() + " must be an instance of jQuery to match against a selector"; 230 | } 231 | 232 | return actual.is(expected); 233 | }, 234 | 235 | failure_message: function(expected, actual, not) { 236 | return 'expected ' + $.print(actual) + (not ? ' to not match selector ' : ' to match selector ') + expected; 237 | } 238 | }, 239 | 240 | contain_selector: { 241 | match: function(expected, actual) { 242 | if (!(actual instanceof jQuery)) { 243 | throw expected.toString() + " must be an instance of jQuery to match against a selector"; 244 | } 245 | 246 | return actual.find(expected).length > 0; 247 | }, 248 | 249 | failure_message: function(expected, actual, not) { 250 | return 'expected ' + $.print(actual) + (not ? ' to not contain selector ' : ' to contain selector ') + expected; 251 | } 252 | } 253 | }; 254 | })(jQuery); 255 | -------------------------------------------------------------------------------- /spec/smoke/screw.mocking.js: -------------------------------------------------------------------------------- 1 | // This is a lightweight bridge between Smoke and Screw.Unit. 2 | // It shadows mocking and stubbing onto the matchers to make them available within tests. 3 | 4 | Screw.Matchers.mock = function(m) { 5 | return Smoke.Mock(m); 6 | }; 7 | 8 | Screw.Matchers.mock_function = function(func,name) { 9 | return Smoke.MockFunction(func,name); 10 | }; 11 | 12 | Screw.Matchers.stub = function(obj, attr) { 13 | return new Smoke.Stub(obj,attr); 14 | }; 15 | 16 | (function($) { 17 | $(Screw).bind("before", function(){ 18 | function checkAndResetSmoke() { 19 | Smoke.checkExpectations(); 20 | Smoke.reset(); 21 | } 22 | 23 | $('.it').bind('finished.screwunit', function(){ checkAndResetSmoke(); }); 24 | }); 25 | })(jQuery); 26 | -------------------------------------------------------------------------------- /spec/smoke/smoke.core.js: -------------------------------------------------------------------------------- 1 | Smoke = { 2 | print: function(v) { 3 | // use the jquery print plugin if it is available or fall back to toString(); 4 | return (jQuery && jQuery.print) ? jQuery.print(v) : v.toString(); 5 | }, 6 | 7 | printArguments: function(args) { 8 | var a = []; 9 | if (args === undefined) args = ''; 10 | if ((args && args.callee) || (args instanceof Array)) { 11 | for(var i = 0; i < args.length; i++) { 12 | a.push(Smoke.print(args[i])); 13 | } 14 | } else { 15 | // Workaround for jQuery.print returning "null" when called with an empty string. 16 | if (!args && (typeof args == 'string')) { 17 | a.push(''); 18 | } else { 19 | a.push(Smoke.print(args)); 20 | } 21 | } 22 | return '(' + a.join(', ') + ')'; 23 | }, 24 | 25 | argumentsToArray: function(args) { 26 | return Array.prototype.slice.call(args); 27 | }, 28 | 29 | compare: function(a, b) { 30 | if (a === b) return true; 31 | if (a instanceof Array) { 32 | if (b.length != a.length) return false; 33 | for (var i = 0; i < b.length; i++) 34 | if (!this.compare(a[i], b[i])) return false; 35 | } else if (a instanceof Object) { 36 | for (var key in a) 37 | if (!this.compare(a[key], b[key])) return false; 38 | for (var key in b) 39 | if (!this.compare(b[key], a[key])) return false; 40 | } else { 41 | return false; 42 | } 43 | return true; 44 | }, 45 | 46 | compareArguments: function(a, b) { 47 | return this.compare(Smoke.argumentsToArray(a), Smoke.argumentsToArray(b)); 48 | } 49 | }; -------------------------------------------------------------------------------- /spec/smoke/smoke.mock.js: -------------------------------------------------------------------------------- 1 | // Overide these functions for custom pass/fail behaviours 2 | Smoke.passed = function(mock){ 3 | Smoke.passCount++; 4 | }; 5 | 6 | Smoke.failed = function(mock, message){ 7 | Smoke.failCount++; 8 | throw(message); 9 | }; 10 | 11 | // Some helpers 12 | Smoke.reset = function(){ 13 | Smoke.mocks = []; 14 | Smoke.passCount = 0; 15 | Smoke.failCount = 0; 16 | }; 17 | Smoke.reset(); 18 | 19 | Smoke.checkExpectations = function(){ 20 | for(var i=0; i=this.callCount) Smoke.passed(this);//console.log('Mock passed!') 136 | else Smoke.failed(this, 'expected '+this.methodSignature()+' to be called at most '+this.maxCount+" times but it actually got called "+this.callCount+' times'); 137 | }, 138 | argumentMismatchError: function(args) { 139 | Smoke.failed(this, 'expected ' + this._attr + ' with ' + Smoke.printArguments(this.callerArgs) + ' but received it with ' + Smoke.printArguments(args)); 140 | }, 141 | methodSignature: function(){ 142 | return this._attr + Smoke.printArguments(this.callerArgs); 143 | }, 144 | parseCount: function(c){ 145 | switch(c){ 146 | case 'once': 147 | return 1; 148 | case 'twice': 149 | return 2; 150 | default: 151 | return c; 152 | } 153 | } 154 | }; -------------------------------------------------------------------------------- /spec/smoke/smoke.stub.js: -------------------------------------------------------------------------------- 1 | Smoke.Stub = function(obj,attr) { 2 | this.obj = obj; 3 | this.attribute = attr; 4 | this.and_return(this.defaultReturn); 5 | }; 6 | 7 | Smoke.Stub.prototype = { 8 | defaultReturn: null, 9 | property: function(p){ 10 | this.property = p; 11 | this.and_set_to(this.defaultReturn); 12 | return this; 13 | }, 14 | method: function(f){ 15 | this.func = f; 16 | this.and_return(this.defaultReturn); 17 | return this; 18 | }, 19 | and_return: function(v){ 20 | this.obj[this.attribute] = function() { 21 | return v; 22 | }; 23 | return this.obj; 24 | }, 25 | and_set_to: function(v){ 26 | this.obj[this.attribute] = v; 27 | return this.obj; 28 | } 29 | }; -------------------------------------------------------------------------------- /spec/spec_helper.js: -------------------------------------------------------------------------------- 1 | var google = { 2 | maps: { 3 | Map: function(){}, 4 | event: {}, 5 | NavigationControlStyle: { 6 | SMALL: 'SMALL', DEFAULT: 'DEFAULT' 7 | }, 8 | MapTypeId: { 9 | ROADMAP: 'ROADMAP', HYBRID: 'HYBRID' 10 | }, 11 | LatLngBounds: function(){}, 12 | LatLng: function(){}, 13 | Marker: function(){}, 14 | InfoWindow: function(){}, 15 | MarkerImage: function(){} 16 | } 17 | }, 18 | StyledIconTypes = { 19 | MARKER: 'MARKER' 20 | }, 21 | StyledIcon = function(){}, 22 | StyledMarker = function(){}; 23 | 24 | Screw.Specifications.mockGMaps = function(custom_markers){ 25 | // mock out GLatLng 26 | google.maps.LatLng = Smoke.MockFunction(function(lat, lng){}, 'LatLng'); 27 | google.maps.LatLng.should_be_invoked().at_least('once'); 28 | 29 | // mock out GMap2 30 | var gmap_mock = Smoke.Mock(); 31 | gmap_mock.should_receive('fitBounds').exactly('once'); 32 | $.extend(google.maps.Map.prototype, gmap_mock); 33 | 34 | // mock out Bounds 35 | var bounds_mock = Smoke.Mock(); 36 | bounds_mock.should_receive('extend').exactly('once'); 37 | google.maps.LatLngBounds = Smoke.MockFunction(function(point1, point2){}, 'LatLngBounds'); 38 | google.maps.LatLngBounds.should_be_invoked().exactly('once'); 39 | $.extend(google.maps.LatLngBounds.prototype, bounds_mock); 40 | 41 | // mock out Marker 42 | if (custom_markers){ 43 | StyledIcon = Smoke.MockFunction(function(options){}, 'StyledIcon'); 44 | StyledIcon.should_be_invoked().exactly('twice'); 45 | StyledMarker = Smoke.MockFunction(function(options){}, 'StyledMarker'); 46 | StyledMarker.should_be_invoked().exactly('twice'); 47 | } else { 48 | google.maps.Marker = Smoke.MockFunction(function(options){}, 'Marker'); 49 | google.maps.Marker.should_be_invoked().exactly('twice'); 50 | } 51 | 52 | google.maps.event = Smoke.Mock(); 53 | google.maps.event.should_receive('addListener').at_least('once'); 54 | }; 55 | Screw.Specifications.mockGMapsUpdate = function(){ 56 | // mock out GLatLng 57 | google.maps.LatLng = Smoke.MockFunction(function(lat, lng){}, 'LatLng'); 58 | google.maps.LatLng.should_be_invoked().at_least('once'); 59 | 60 | // mock out GMap2 61 | var gmap_mock = Smoke.Mock(); 62 | gmap_mock.should_receive('fitBounds').exactly('twice'); 63 | gmap_mock.should_receive('getZoom').exactly('once').and_return(10); 64 | $.extend(google.maps.Map.prototype, gmap_mock); 65 | 66 | // mock out Bounds 67 | var bounds_mock = Smoke.Mock(); 68 | bounds_mock.should_receive('extend').exactly('twice'); 69 | google.maps.LatLngBounds = Smoke.MockFunction(function(point1, point2){}, 'LatLngBounds'); 70 | google.maps.LatLngBounds.should_be_invoked().exactly('twice'); 71 | $.extend(google.maps.LatLngBounds.prototype, bounds_mock); 72 | 73 | // mock out Marker 74 | google.maps.Marker = Smoke.MockFunction(function(options){}, 'Marker'); 75 | google.maps.Marker.should_be_invoked().exactly(4, 'times'); 76 | 77 | google.maps.event = Smoke.Mock(); 78 | google.maps.event.should_receive('trigger').exactly('once').with_arguments(google.maps.Map.prototype, 'resize'); 79 | google.maps.event.should_receive('addListener').at_least('once'); 80 | }; 81 | 82 | Screw.Specifications.mockMarkerManager = function(update){ 83 | var markermanager_mock = Smoke.Mock(); 84 | if (update){ 85 | markermanager_mock.should_receive('clearMarkers').exactly('once'); 86 | markermanager_mock.should_receive('addMarkers').exactly('once'); 87 | markermanager_mock.should_receive('refresh').exactly('once'); 88 | } 89 | 90 | MarkerManager = Smoke.MockFunction(function(map, options){}, 'MarkerManager'); 91 | MarkerManager.should_be_invoked().exactly('once'); 92 | $.extend(MarkerManager.prototype, markermanager_mock); 93 | }; 94 | -------------------------------------------------------------------------------- /spec/suite.html: -------------------------------------------------------------------------------- 1 | 2 | 3 | 4 | jMapping Test Results 5 | 6 | 7 | 8 | 9 | 10 | 11 | 12 | 13 | 14 | 15 | 16 | 17 | 18 | 19 | 20 | 21 | 22 | 23 | 24 | 25 | 26 | 27 | 28 | 29 |
            30 |
            31 |
            32 |
            33 | Some Place 34 |
            35 |

            Some Thing for the info box.

            36 |
            37 |
            38 |
            39 | Another Place 40 |
            41 |

            Example Text.

            42 |
            43 |
            44 |
            45 |
              46 |
            • 47 | Some Place 48 |
              49 |

              Some Thing for the info box.

              50 |
              51 |
              • 52 |
            • 53 | Another Place 54 |
              55 |

              Example Text.

              56 |
              57 |
              • 58 |
            59 | 60 |
              61 |
            • 62 | Some Place 63 |
              64 |

              Some Thing for the info box.

              65 |
              66 |
              • 67 |
            • 68 | Another Place 69 |
              70 |

              Example Text.

              71 |
              72 |
              • 73 |
            74 | 75 |
              76 |
            77 |
            78 | 79 | 80 | -------------------------------------------------------------------------------- /vendor/StyledMarker.js: -------------------------------------------------------------------------------- 1 | /** 2 | * @name StyledMarkerMaker 3 | * @version 0.5 4 | * @author Gabriel Schneider 5 | * @copyright (c) 2010 Gabriel Schneider 6 | * @fileoverview This gives you static functions for creating dynamically 7 | * styled markers using Charts API outputs as well as an ability to 8 | * extend with custom types. 9 | */ 10 | 11 | /** 12 | * Licensed under the Apache License, Version 2.0 (the 'License'); 13 | * you may not use this file except in compliance with the License. 14 | * You may obtain a copy of the License at 15 | * 16 | * http://www.apache.org/licenses/LICENSE-2.0 17 | * 18 | * Unless required by applicable law or agreed to in writing, software 19 | * distributed under the License is distributed on an 'AS IS' BASIS, 20 | * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. 21 | * See the License for the specific language governing permissions and 22 | * limitations under the License. 23 | */ 24 | 25 | var StyledIconTypes = {}; 26 | var StyledMarker, StyledIcon; 27 | 28 | (function() { 29 | var bu_ = 'http://chart.apis.google.com/chart?chst='; 30 | var gm_ = google.maps; 31 | var gp_ = gm_.Point; 32 | var ge_ = gm_.event; 33 | var gmi_ = gm_.MarkerImage; 34 | 35 | 36 | /** 37 | * This class is an extended version of google.maps.Marker. It allows 38 | * styles to be applied that change it's appearance. 39 | * @extends google.maps.Marker 40 | * @param {StyledMarkerOptions} StyledMarkerOptions The options for the Marker 41 | */ 42 | StyledMarker = function(styledMarkerOptions) { 43 | var me=this; 44 | var ci = me.styleIcon = styledMarkerOptions.styleIcon; 45 | me.bindTo('icon',ci); 46 | me.bindTo('shadow',ci); 47 | me.bindTo('shape',ci); 48 | me.setOptions(styledMarkerOptions); 49 | }; 50 | StyledMarker.prototype = new gm_.Marker(); 51 | 52 | /** 53 | * This class stores style information that can be applied to StyledMarkers. 54 | * @extends google.maps.MVCObject 55 | * @param {StyledIconType} styledIconType The type of style this icon is. 56 | * @param {StyledIconOptions} styledIconOptions The options for this StyledIcon. 57 | * @param {StyledIcon} styleClass A class to apply extended style information. 58 | */ 59 | StyledIcon = function(styledIconType,styledIconOptions,styleClass) { 60 | var k; 61 | var me=this; 62 | var i_ = 'icon'; 63 | var sw_ = 'shadow'; 64 | var s_ = 'shape'; 65 | var a_ = []; 66 | 67 | function gs_() { 68 | var image_ = document.createElement('img'); 69 | var simage_ = document.createElement('img'); 70 | ge_.addDomListenerOnce(simage_, 'load', function() { 71 | var w = simage_.width, h = simage_.height; 72 | me.set(sw_,new gmi_(styledIconType.getShadowURL(me),null,null,styledIconType.getShadowAnchor(me,w,h))); 73 | simage = null; 74 | }); 75 | ge_.addDomListenerOnce(image_, 'load', function() { 76 | var w = image_.width, h = image_.height; 77 | me.set(i_,new gmi_(styledIconType.getURL(me),null,null,styledIconType.getAnchor(me,w,h))); 78 | me.set(s_,styledIconType.getShape(me,w,h)); 79 | image_ = null; 80 | }); 81 | image_.src = styledIconType.getURL(me); 82 | simage_.src = styledIconType.getShadowURL(me); 83 | } 84 | 85 | /** 86 | * set: 87 | * This function sets a given style property to the given value. 88 | * @param {String} name The name of the property to set. 89 | * @param {Object} value The value to set the property to. 90 | * get: 91 | * This function gets a given style property. 92 | * @param {String} name The name of the property to get. 93 | * @return {Object} 94 | */ 95 | me.as_ = function(v) { 96 | a_.push(v); 97 | for(k in styledIconOptions) { 98 | v.set(k, styledIconOptions[k]); 99 | } 100 | } 101 | 102 | if (styledIconType !== StyledIconTypes.CLASS) { 103 | for (k in styledIconType.defaults) { 104 | me.set(k, styledIconType.defaults[k]); 105 | } 106 | me.setValues(styledIconOptions); 107 | me.set(i_,styledIconType.getURL(me)); 108 | me.set(sw_,styledIconType.getShadowURL(me)); 109 | if (styleClass) styleClass.as_(me); 110 | gs_(); 111 | me.changed = function(k) { 112 | if (k!==i_&&k!==s_&&k!==sw_) { 113 | gs_(); 114 | } 115 | }; 116 | } else { 117 | me.setValues(styledIconOptions); 118 | me.changed = function(v) { 119 | styledIconOptions[v] = me.get(v); 120 | for (k = 0; k < a_.length; k++) { 121 | a_[k].set(v,me.get(v)); 122 | } 123 | }; 124 | if (styleClass) styleClass.as_(me); 125 | } 126 | }; 127 | StyledIcon.prototype = new gm_.MVCObject(); 128 | 129 | /** 130 | * StyledIconType 131 | * This class holds functions for building the information needed to style markers. 132 | * getURL: 133 | * This function builds and returns a URL to use for the Marker icon property. 134 | * @param {StyledIcon} icon The StyledIcon that holds style information 135 | * @return {String} 136 | * getShadowURL: 137 | * This function builds and returns a URL to use for the Marker shadow property. 138 | * @param {StyledIcon} icon The StyledIcon that holds style information 139 | * @return {String{ 140 | * getAnchor: 141 | * This function builds and returns a Point to indicate where the marker is placed. 142 | * @param {StyledIcon} icon The StyledIcon that holds style information 143 | * @param {Number} width The width of the icon image. 144 | * @param {Number} height The height of the icon image. 145 | * @return {google.maps.Point} 146 | * getShadowAnchor: 147 | * This function builds and returns a Point to indicate where the shadow is placed. 148 | * @param {StyledIcon} icon The StyledIcon that holds style information 149 | * @param {Number} width The width of the shadow image. 150 | * @param {Number} height The height of the shadow image. 151 | * @return {google.maps.Point} 152 | * getShape: 153 | * This function builds and returns a MarkerShape to indicate where the Marker is clickable. 154 | * @param {StyledIcon} icon The StyledIcon that holds style information 155 | * @param {Number} width The width of the icon image. 156 | * @param {Number} height The height of the icon image. 157 | * @return {google.maps.MarkerShape} 158 | */ 159 | 160 | StyledIconTypes.CLASS = {}; 161 | 162 | StyledIconTypes.MARKER = { 163 | defaults: { 164 | text:'', 165 | color:'00ff00', 166 | fore:'000000', 167 | starcolor:null 168 | }, 169 | getURL: function(props){ 170 | var _url; 171 | var starcolor_=props.get('starcolor'); 172 | var text_=props.get('text'); 173 | var color_=props.get('color').replace(/#/,''); 174 | var fore_=props.get('fore').replace(/#/,''); 175 | if (starcolor_) { 176 | _url = bu_ + 'd_map_xpin_letter&chld=pin_star|'; 177 | } else { 178 | _url = bu_ + 'd_map_pin_letter&chld='; 179 | } 180 | if (text_) { 181 | text_ = text_.substr(0,2); 182 | } 183 | _url+=text_+'|'; 184 | _url+=color_+'|'; 185 | _url+=fore_; 186 | if (starcolor_) { 187 | _url+='|'+starcolor_.replace(/#/,''); 188 | } 189 | return _url; 190 | }, 191 | getShadowURL: function(props){ 192 | if (props.get('starcolor')) { 193 | return bu_ + 'd_map_xpin_shadow&chld=pin_star'; 194 | } else { 195 | return bu_ + 'd_map_pin_shadow'; 196 | } 197 | }, 198 | getAnchor: function(props,width,height){ 199 | return new gp_(width / 2,height); 200 | }, 201 | getShadowAnchor: function(props,width,height){ 202 | return new gp_(width / 4,height); 203 | }, 204 | getShape: function(props,width,height){ 205 | var _iconmap = {}; 206 | _iconmap.coord = [ 207 | width / 2, height, 208 | (7 / 16) * width, (5 / 8) * height, 209 | (5 / 16) * width, (7 / 16) * height, 210 | (7 / 32) * width, (5 / 16) * height, 211 | (5 / 16) * width, (1 / 8) * height, 212 | (1 / 2) * width, 0, 213 | (11 / 16) * width, (1 / 8) * height, 214 | (25 / 32) * width, (5 / 16) * height, 215 | (11 / 16) * width, (7 / 16) * height, 216 | (9 / 16) * width, (5 / 8) * height 217 | ]; 218 | for (var i = 0; i < _iconmap.coord.length; i++) { 219 | _iconmap.coord[i] = Math.round(_iconmap.coord[i]); 220 | } 221 | _iconmap.type = 'poly'; 222 | return _iconmap; 223 | } 224 | }; 225 | StyledIconTypes.BUBBLE = { 226 | defaults: { 227 | text:'', 228 | color:'00ff00', 229 | fore:'000000' 230 | }, 231 | getURL: function(props){ 232 | var _url = bu_ + 'd_bubble_text_small&chld=bb|'; 233 | _url+=props.get('text')+'|'; 234 | _url+=props.get('color').replace(/#/,'')+'|'; 235 | _url+=props.get('fore').replace(/#/,''); 236 | return _url; 237 | }, 238 | getShadowURL: function(props){ 239 | return bu_ + 'd_bubble_text_small_shadow&chld=bb|' + props.get('text'); 240 | }, 241 | getAnchor: function(props,width,height){ 242 | return new google.maps.Point(0,42); 243 | }, 244 | getShadowAnchor: function(props,width,height){ 245 | return new google.maps.Point(0,44); 246 | }, 247 | getShape: function(props,width,height){ 248 | var _iconmap = {}; 249 | _iconmap.coord = [ 250 | 0,44, 251 | 13,26, 252 | 13,6, 253 | 17,1, 254 | width - 4,1, 255 | width,6, 256 | width,21, 257 | width - 4,26, 258 | 21,26 259 | ]; 260 | _iconmap.type = 'poly'; 261 | return _iconmap; 262 | } 263 | }; 264 | })(); -------------------------------------------------------------------------------- /vendor/jquery.metadata.js: -------------------------------------------------------------------------------- 1 | /* 2 | * Metadata - jQuery plugin for parsing metadata from elements 3 | * 4 | * Copyright (c) 2006 John Resig, Yehuda Katz, J�örn Zaefferer, Paul McLanahan 5 | * 6 | * Dual licensed under the MIT and GPL licenses: 7 | * http://www.opensource.org/licenses/mit-license.php 8 | * http://www.gnu.org/licenses/gpl.html 9 | * 10 | * Revision: $Id: jquery.metadata.js 3640 2007-10-11 18:34:38Z pmclanahan $ 11 | * 12 | */ 13 | 14 | /** 15 | * Sets the type of metadata to use. Metadata is encoded in JSON, and each property 16 | * in the JSON will become a property of the element itself. 17 | * 18 | * There are four supported types of metadata storage: 19 | * 20 | * attr: Inside an attribute. The name parameter indicates *which* attribute. 21 | * 22 | * class: Inside the class attribute, wrapped in curly braces: { } 23 | * 24 | * elem: Inside a child element (e.g. a script tag). The 25 | * name parameter indicates *which* element. 26 | * html5: Values are stored in data-* attributes. 27 | * 28 | * The metadata for an element is loaded the first time the element is accessed via jQuery. 29 | * 30 | * As a result, you can define the metadata type, use $(expr) to load the metadata into the elements 31 | * matched by expr, then redefine the metadata type and run another $(expr) for other elements. 32 | * 33 | * @name $.metadata.setType 34 | * 35 | * @example

            This is a p

            36 | * @before $.metadata.setType("class") 37 | * @after $("#one").metadata().item_id == 1; $("#one").metadata().item_label == "Label" 38 | * @desc Reads metadata from the class attribute 39 | * 40 | * @example

            This is a p

            41 | * @before $.metadata.setType("attr", "data") 42 | * @after $("#one").metadata().item_id == 1; $("#one").metadata().item_label == "Label" 43 | * @desc Reads metadata from a "data" attribute 44 | * 45 | * @example

            This is a p

            46 | * @before $.metadata.setType("elem", "script") 47 | * @after $("#one").metadata().item_id == 1; $("#one").metadata().item_label == "Label" 48 | * @desc Reads metadata from a nested script element 49 | * 50 | * @example

            This is a p

            51 | * @before $.metadata.setType("html5") 52 | * @after $("#one").metadata().item_id == 1; $("#one").metadata().item_label == "Label" 53 | * @desc Reads metadata from a series of data-* attributes 54 | * 55 | * @param String type The encoding type 56 | * @param String name The name of the attribute to be used to get metadata (optional) 57 | * @cat Plugins/Metadata 58 | * @descr Sets the type of encoding to be used when loading metadata for the first time 59 | * @type undefined 60 | * @see metadata() 61 | */ 62 | 63 | (function($) { 64 | 65 | $.extend({ 66 | metadata : { 67 | defaults : { 68 | type: 'class', 69 | name: 'metadata', 70 | cre: /({.*})/, 71 | single: 'metadata' 72 | }, 73 | setType: function( type, name ){ 74 | this.defaults.type = type; 75 | this.defaults.name = name; 76 | }, 77 | get: function( elem, opts ){ 78 | var settings = $.extend({},this.defaults,opts); 79 | // check for empty string in single property 80 | if ( !settings.single.length ) settings.single = 'metadata'; 81 | 82 | var data = $.data(elem, settings.single); 83 | // returned cached data if it already exists 84 | if ( data ) return data; 85 | 86 | data = "{}"; 87 | 88 | var getData = function(data) { 89 | if(typeof data != "string") return data; 90 | 91 | if( data.indexOf('{') < 0 ) { 92 | data = eval("(" + data + ")"); 93 | } 94 | } 95 | 96 | var getObject = function(data) { 97 | if(typeof data != "string") return data; 98 | 99 | data = eval("(" + data + ")"); 100 | return data; 101 | } 102 | 103 | if ( settings.type == "html5" ) { 104 | var object = {}; 105 | $( elem.attributes ).each(function() { 106 | var name = this.nodeName; 107 | if(name.match(/^data-/)) name = name.replace(/^data-/, ''); 108 | else return true; 109 | object[name] = getObject(this.nodeValue); 110 | }); 111 | } else { 112 | if ( settings.type == "class" ) { 113 | var m = settings.cre.exec( elem.className ); 114 | if ( m ) 115 | data = m[1]; 116 | } else if ( settings.type == "elem" ) { 117 | if( !elem.getElementsByTagName ) return; 118 | var e = elem.getElementsByTagName(settings.name); 119 | if ( e.length ) 120 | data = $.trim(e[0].innerHTML); 121 | } else if ( elem.getAttribute != undefined ) { 122 | var attr = elem.getAttribute( settings.name ); 123 | if ( attr ) 124 | data = attr; 125 | } 126 | object = getObject(data.indexOf("{") < 0 ? "{" + data + "}" : data); 127 | } 128 | 129 | $.data( elem, settings.single, object ); 130 | return object; 131 | } 132 | } 133 | }); 134 | 135 | /** 136 | * Returns the metadata object for the first member of the jQuery object. 137 | * 138 | * @name metadata 139 | * @descr Returns element's metadata object 140 | * @param Object opts An object contianing settings to override the defaults 141 | * @type jQuery 142 | * @cat Plugins/Metadata 143 | */ 144 | $.fn.metadata = function( opts ){ 145 | return $.metadata.get( this[0], opts ); 146 | }; 147 | 148 | })(jQuery); -------------------------------------------------------------------------------- /vendor/jsmin.rb: -------------------------------------------------------------------------------- 1 | #-- 2 | # jsmin.rb - Ruby implementation of Douglas Crockford's JSMin. 3 | # 4 | # This is a port of jsmin.c, and is distributed under the same terms, which are 5 | # as follows: 6 | # 7 | # Copyright (c) 2002 Douglas Crockford (www.crockford.com) 8 | # 9 | # Permission is hereby granted, free of charge, to any person obtaining a copy 10 | # of this software and associated documentation files (the "Software"), to deal 11 | # in the Software without restriction, including without limitation the rights 12 | # to use, copy, modify, merge, publish, distribute, sublicense, and/or sell 13 | # copies of the Software, and to permit persons to whom the Software is 14 | # furnished to do so, subject to the following conditions: 15 | # 16 | # The above copyright notice and this permission notice shall be included in all 17 | # copies or substantial portions of the Software. 18 | # 19 | # The Software shall be used for Good, not Evil. 20 | # 21 | # THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR 22 | # IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, 23 | # FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE 24 | # AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER 25 | # LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, 26 | # OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE 27 | # SOFTWARE. 28 | #++ 29 | 30 | require 'strscan' 31 | 32 | # = JSMin 33 | # 34 | # Ruby implementation of Douglas Crockford's JavaScript minifier, JSMin. 35 | # 36 | # *Author*:: Ryan Grove (mailto:ryan@wonko.com) 37 | # *Version*:: 1.0.1 (2008-11-10) 38 | # *Copyright*:: Copyright (c) 2008 Ryan Grove. All rights reserved. 39 | # *Website*:: http://github.com/rgrove/jsmin 40 | # 41 | # == Example 42 | # 43 | # require 'rubygems' 44 | # require 'jsmin' 45 | # 46 | # File.open('example.js', 'r') {|file| puts JSMin.minify(file) } 47 | # 48 | class JSMin 49 | CHR_APOS = "'".freeze 50 | CHR_ASTERISK = '*'.freeze 51 | CHR_BACKSLASH = '\\'.freeze 52 | CHR_CR = "\r".freeze 53 | CHR_FRONTSLASH = '/'.freeze 54 | CHR_LF = "\n".freeze 55 | CHR_QUOTE = '"'.freeze 56 | CHR_SPACE = ' '.freeze 57 | 58 | if RUBY_VERSION >= '1.9' 59 | ORD_LF = "\n".freeze 60 | ORD_SPACE = ' '.freeze 61 | ORD_TILDE = '~'.freeze 62 | else 63 | ORD_LF = "\n"[0].freeze 64 | ORD_SPACE = ' '[0].freeze 65 | ORD_TILDE = '~'[0].freeze 66 | end 67 | 68 | class << self 69 | 70 | # Reads JavaScript from _input_ (which can be a String or an IO object) and 71 | # returns a String containing minified JS. 72 | def minify(input) 73 | @js = StringScanner.new(input.is_a?(IO) ? input.read : input.to_s) 74 | 75 | @a = "\n" 76 | @b = nil 77 | @lookahead = nil 78 | @output = '' 79 | 80 | action_get 81 | 82 | while !@a.nil? do 83 | case @a 84 | when CHR_SPACE 85 | if alphanum?(@b) 86 | action_output 87 | else 88 | action_copy 89 | end 90 | 91 | when CHR_LF 92 | if @b == CHR_SPACE 93 | action_get 94 | elsif @b =~ /[{\[\(+-]/ 95 | action_output 96 | else 97 | if alphanum?(@b) 98 | action_output 99 | else 100 | action_copy 101 | end 102 | end 103 | 104 | else 105 | if @b == CHR_SPACE 106 | if alphanum?(@a) 107 | action_output 108 | else 109 | action_get 110 | end 111 | elsif @b == CHR_LF 112 | if @a =~ /[}\]\)\\"+-]/ 113 | action_output 114 | else 115 | if alphanum?(@a) 116 | action_output 117 | else 118 | action_get 119 | end 120 | end 121 | else 122 | action_output 123 | end 124 | end 125 | end 126 | 127 | @output 128 | end 129 | 130 | private 131 | 132 | # Corresponds to action(1) in jsmin.c. 133 | def action_output 134 | @output << @a 135 | action_copy 136 | end 137 | 138 | # Corresponds to action(2) in jsmin.c. 139 | def action_copy 140 | @a = @b 141 | 142 | if @a == CHR_APOS || @a == CHR_QUOTE 143 | loop do 144 | @output << @a 145 | @a = get 146 | 147 | break if @a == @b 148 | 149 | if @a[0] <= ORD_LF 150 | raise "JSMin parse error: unterminated string literal: #{@a}" 151 | end 152 | 153 | if @a == CHR_BACKSLASH 154 | @output << @a 155 | @a = get 156 | 157 | if @a[0] <= ORD_LF 158 | raise "JSMin parse error: unterminated string literal: #{@a}" 159 | end 160 | end 161 | end 162 | end 163 | 164 | action_get 165 | end 166 | 167 | # Corresponds to action(3) in jsmin.c. 168 | def action_get 169 | @b = nextchar 170 | 171 | if @b == CHR_FRONTSLASH && (@a == CHR_LF || @a =~ /[\(,=:\[!&|?{};]/) 172 | @output << @a 173 | @output << @b 174 | 175 | loop do 176 | @a = get 177 | 178 | if @a == CHR_FRONTSLASH 179 | break 180 | elsif @a == CHR_BACKSLASH 181 | @output << @a 182 | @a = get 183 | elsif @a[0] <= ORD_LF 184 | raise "JSMin parse error: unterminated regular expression " + 185 | "literal: #{@a}" 186 | end 187 | 188 | @output << @a 189 | end 190 | 191 | @b = nextchar 192 | end 193 | end 194 | 195 | # Returns true if +c+ is a letter, digit, underscore, dollar sign, 196 | # backslash, or non-ASCII character. 197 | def alphanum?(c) 198 | c.is_a?(String) && !c.empty? && (c[0] > ORD_TILDE || c =~ /[0-9a-z_$\\]/i) 199 | end 200 | 201 | # Returns the next character from the input. If the character is a control 202 | # character, it will be translated to a space or linefeed. 203 | def get 204 | c = @lookahead.nil? ? @js.getch : @lookahead 205 | @lookahead = nil 206 | 207 | return c if c.nil? || c == CHR_LF || c[0] >= ORD_SPACE 208 | return "\n" if c == CHR_CR 209 | return ' ' 210 | end 211 | 212 | # Gets the next character, excluding comments. 213 | def nextchar 214 | c = get 215 | return c unless c == CHR_FRONTSLASH 216 | 217 | case peek 218 | when CHR_FRONTSLASH 219 | loop do 220 | c = get 221 | return c if c[0] <= ORD_LF 222 | end 223 | 224 | when CHR_ASTERISK 225 | get 226 | loop do 227 | case get 228 | when CHR_ASTERISK 229 | if peek == CHR_FRONTSLASH 230 | get 231 | return ' ' 232 | end 233 | 234 | when nil 235 | raise 'JSMin parse error: unterminated comment' 236 | end 237 | end 238 | 239 | else 240 | return c 241 | end 242 | end 243 | 244 | # Gets the next character without getting it. 245 | def peek 246 | @lookahead = get 247 | end 248 | end 249 | end 250 | -------------------------------------------------------------------------------- /vendor/markermanager.js: -------------------------------------------------------------------------------- 1 | /** 2 | * @name MarkerManager v3 3 | * @version 1.0 4 | * @copyright (c) 2007 Google Inc. 5 | * @author Doug Ricket, Bjorn Brala (port to v3), others, 6 | * 7 | * @fileoverview Marker manager is an interface between the map and the user, 8 | * designed to manage adding and removing many points when the viewport changes. 9 | *

            10 | * How it Works:
            11 | * The MarkerManager places its markers onto a grid, similar to the map tiles. 12 | * When the user moves the viewport, it computes which grid cells have 13 | * entered or left the viewport, and shows or hides all the markers in those 14 | * cells. 15 | * (If the users scrolls the viewport beyond the markers that are loaded, 16 | * no markers will be visible until the EVENT_moveend 17 | * triggers an update.) 18 | * In practical consequences, this allows 10,000 markers to be distributed over 19 | * a large area, and as long as only 100-200 are visible in any given viewport, 20 | * the user will see good performance corresponding to the 100 visible markers, 21 | * rather than poor performance corresponding to the total 10,000 markers. 22 | * Note that some code is optimized for speed over space, 23 | * with the goal of accommodating thousands of markers. 24 | */ 25 | 26 | /* 27 | * Licensed under the Apache License, Version 2.0 (the "License"); 28 | * you may not use this file except in compliance with the License. 29 | * You may obtain a copy of the License at 30 | * 31 | * http://www.apache.org/licenses/LICENSE-2.0 32 | * 33 | * Unless required by applicable law or agreed to in writing, software 34 | * distributed under the License is distributed on an "AS IS" BASIS, 35 | * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. 36 | * See the License for the specific language governing permissions and 37 | * limitations under the License. 38 | */ 39 | 40 | /** 41 | * @name MarkerManagerOptions 42 | * @class This class represents optional arguments to the {@link MarkerManager} 43 | * constructor. 44 | * @property {Number} maxZoom Sets the maximum zoom level monitored by a 45 | * marker manager. If not given, the manager assumes the maximum map zoom 46 | * level. This value is also used when markers are added to the manager 47 | * without the optional {@link maxZoom} parameter. 48 | * @property {Number} borderPadding Specifies, in pixels, the extra padding 49 | * outside the map's current viewport monitored by a manager. Markers that 50 | * fall within this padding are added to the map, even if they are not fully 51 | * visible. 52 | * @property {Boolean} trackMarkers=false Indicates whether or not a marker 53 | * manager should track markers' movements. If you wish to move managed 54 | * markers using the {@link setPoint}/{@link setLatLng} methods, 55 | * this option should be set to {@link true}. 56 | */ 57 | 58 | /** 59 | * Creates a new MarkerManager that will show/hide markers on a map. 60 | * 61 | * Events: 62 | * @event changed (Parameters: shown bounds, shown markers) Notify listeners when the state of what is displayed changes. 63 | * @event loaded MarkerManager has succesfully been initialized. 64 | * 65 | * @constructor 66 | * @param {Map} map The map to manage. 67 | * @param {Object} opt_opts A container for optional arguments: 68 | * {Number} maxZoom The maximum zoom level for which to create tiles. 69 | * {Number} borderPadding The width in pixels beyond the map border, 70 | * where markers should be display. 71 | * {Boolean} trackMarkers Whether or not this manager should track marker 72 | * movements. 73 | */ 74 | function MarkerManager(map, opt_opts) { 75 | var me = this; 76 | me.map_ = map; 77 | me.mapZoom_ = map.getZoom(); 78 | 79 | me.projectionHelper_ = new ProjectionHelperOverlay(map); 80 | google.maps.event.addListener(me.projectionHelper_, 'ready', function () { 81 | me.projection_ = this.getProjection(); 82 | me.initialize(map, opt_opts); 83 | }); 84 | } 85 | 86 | 87 | MarkerManager.prototype.initialize = function (map, opt_opts) { 88 | var me = this; 89 | 90 | opt_opts = opt_opts || {}; 91 | me.tileSize_ = MarkerManager.DEFAULT_TILE_SIZE_; 92 | 93 | var mapTypes = map.mapTypes; 94 | 95 | // Find max zoom level 96 | var mapMaxZoom = 1; 97 | for (var sType in mapTypes ) { 98 | if (typeof map.mapTypes.get(sType) === 'object' && typeof map.mapTypes.get(sType).maxZoom === 'number') { 99 | var mapTypeMaxZoom = map.mapTypes.get(sType).maxZoom; 100 | if (mapTypeMaxZoom > mapMaxZoom) { 101 | mapMaxZoom = mapTypeMaxZoom; 102 | } 103 | } 104 | } 105 | 106 | me.maxZoom_ = opt_opts.maxZoom || 19; 107 | 108 | me.trackMarkers_ = opt_opts.trackMarkers; 109 | me.show_ = opt_opts.show || true; 110 | 111 | var padding; 112 | if (typeof opt_opts.borderPadding === 'number') { 113 | padding = opt_opts.borderPadding; 114 | } else { 115 | padding = MarkerManager.DEFAULT_BORDER_PADDING_; 116 | } 117 | // The padding in pixels beyond the viewport, where we will pre-load markers. 118 | me.swPadding_ = new google.maps.Size(-padding, padding); 119 | me.nePadding_ = new google.maps.Size(padding, -padding); 120 | me.borderPadding_ = padding; 121 | 122 | me.gridWidth_ = {}; 123 | 124 | me.grid_ = {}; 125 | me.grid_[me.maxZoom_] = {}; 126 | me.numMarkers_ = {}; 127 | me.numMarkers_[me.maxZoom_] = 0; 128 | 129 | 130 | google.maps.event.addListener(map, 'dragend', function () { 131 | me.onMapMoveEnd_(); 132 | }); 133 | google.maps.event.addListener(map, 'zoom_changed', function () { 134 | me.onMapMoveEnd_(); 135 | }); 136 | 137 | 138 | 139 | /** 140 | * This closure provide easy access to the map. 141 | * They are used as callbacks, not as methods. 142 | * @param GMarker marker Marker to be removed from the map 143 | * @private 144 | */ 145 | me.removeOverlay_ = function (marker) { 146 | marker.setMap(null); 147 | me.shownMarkers_--; 148 | }; 149 | 150 | /** 151 | * This closure provide easy access to the map. 152 | * They are used as callbacks, not as methods. 153 | * @param GMarker marker Marker to be added to the map 154 | * @private 155 | */ 156 | me.addOverlay_ = function (marker) { 157 | if (me.show_) { 158 | marker.setMap(me.map_); 159 | me.shownMarkers_++; 160 | } 161 | }; 162 | 163 | me.resetManager_(); 164 | me.shownMarkers_ = 0; 165 | 166 | me.shownBounds_ = me.getMapGridBounds_(); 167 | 168 | google.maps.event.trigger(me, 'loaded'); 169 | 170 | }; 171 | 172 | /** 173 | * Default tile size used for deviding the map into a grid. 174 | */ 175 | MarkerManager.DEFAULT_TILE_SIZE_ = 1024; 176 | 177 | /* 178 | * How much extra space to show around the map border so 179 | * dragging doesn't result in an empty place. 180 | */ 181 | MarkerManager.DEFAULT_BORDER_PADDING_ = 100; 182 | 183 | /** 184 | * Default tilesize of single tile world. 185 | */ 186 | MarkerManager.MERCATOR_ZOOM_LEVEL_ZERO_RANGE = 256; 187 | 188 | 189 | /** 190 | * Initializes MarkerManager arrays for all zoom levels 191 | * Called by constructor and by clearAllMarkers 192 | */ 193 | MarkerManager.prototype.resetManager_ = function () { 194 | var mapWidth = MarkerManager.MERCATOR_ZOOM_LEVEL_ZERO_RANGE; 195 | for (var zoom = 0; zoom <= this.maxZoom_; ++zoom) { 196 | this.grid_[zoom] = {}; 197 | this.numMarkers_[zoom] = 0; 198 | this.gridWidth_[zoom] = Math.ceil(mapWidth / this.tileSize_); 199 | mapWidth <<= 1; 200 | } 201 | 202 | }; 203 | 204 | /** 205 | * Removes all markers in the manager, and 206 | * removes any visible markers from the map. 207 | */ 208 | MarkerManager.prototype.clearMarkers = function () { 209 | this.processAll_(this.shownBounds_, this.removeOverlay_); 210 | this.resetManager_(); 211 | }; 212 | 213 | 214 | /** 215 | * Gets the tile coordinate for a given latlng point. 216 | * 217 | * @param {LatLng} latlng The geographical point. 218 | * @param {Number} zoom The zoom level. 219 | * @param {google.maps.Size} padding The padding used to shift the pixel coordinate. 220 | * Used for expanding a bounds to include an extra padding 221 | * of pixels surrounding the bounds. 222 | * @return {GPoint} The point in tile coordinates. 223 | * 224 | */ 225 | MarkerManager.prototype.getTilePoint_ = function (latlng, zoom, padding) { 226 | 227 | var pixelPoint = this.projectionHelper_.LatLngToPixel(latlng, zoom); 228 | 229 | var point = new google.maps.Point( 230 | Math.floor((pixelPoint.x + padding.width) / this.tileSize_), 231 | Math.floor((pixelPoint.y + padding.height) / this.tileSize_) 232 | ); 233 | 234 | return point; 235 | }; 236 | 237 | 238 | /** 239 | * Finds the appropriate place to add the marker to the grid. 240 | * Optimized for speed; does not actually add the marker to the map. 241 | * Designed for batch-processing thousands of markers. 242 | * 243 | * @param {Marker} marker The marker to add. 244 | * @param {Number} minZoom The minimum zoom for displaying the marker. 245 | * @param {Number} maxZoom The maximum zoom for displaying the marker. 246 | */ 247 | MarkerManager.prototype.addMarkerBatch_ = function (marker, minZoom, maxZoom) { 248 | var me = this; 249 | 250 | var mPoint = marker.getPosition(); 251 | marker.MarkerManager_minZoom = minZoom; 252 | 253 | 254 | // Tracking markers is expensive, so we do this only if the 255 | // user explicitly requested it when creating marker manager. 256 | if (this.trackMarkers_) { 257 | google.maps.event.addListener(marker, 'changed', function (a, b, c) { 258 | me.onMarkerMoved_(a, b, c); 259 | }); 260 | } 261 | 262 | var gridPoint = this.getTilePoint_(mPoint, maxZoom, new google.maps.Size(0, 0, 0, 0)); 263 | 264 | for (var zoom = maxZoom; zoom >= minZoom; zoom--) { 265 | var cell = this.getGridCellCreate_(gridPoint.x, gridPoint.y, zoom); 266 | cell.push(marker); 267 | 268 | gridPoint.x = gridPoint.x >> 1; 269 | gridPoint.y = gridPoint.y >> 1; 270 | } 271 | }; 272 | 273 | 274 | /** 275 | * Returns whether or not the given point is visible in the shown bounds. This 276 | * is a helper method that takes care of the corner case, when shownBounds have 277 | * negative minX value. 278 | * 279 | * @param {Point} point a point on a grid. 280 | * @return {Boolean} Whether or not the given point is visible in the currently 281 | * shown bounds. 282 | */ 283 | MarkerManager.prototype.isGridPointVisible_ = function (point) { 284 | var vertical = this.shownBounds_.minY <= point.y && 285 | point.y <= this.shownBounds_.maxY; 286 | var minX = this.shownBounds_.minX; 287 | var horizontal = minX <= point.x && point.x <= this.shownBounds_.maxX; 288 | if (!horizontal && minX < 0) { 289 | // Shifts the negative part of the rectangle. As point.x is always less 290 | // than grid width, only test shifted minX .. 0 part of the shown bounds. 291 | var width = this.gridWidth_[this.shownBounds_.z]; 292 | horizontal = minX + width <= point.x && point.x <= width - 1; 293 | } 294 | return vertical && horizontal; 295 | }; 296 | 297 | 298 | /** 299 | * Reacts to a notification from a marker that it has moved to a new location. 300 | * It scans the grid all all zoom levels and moves the marker from the old grid 301 | * location to a new grid location. 302 | * 303 | * @param {Marker} marker The marker that moved. 304 | * @param {LatLng} oldPoint The old position of the marker. 305 | * @param {LatLng} newPoint The new position of the marker. 306 | */ 307 | MarkerManager.prototype.onMarkerMoved_ = function (marker, oldPoint, newPoint) { 308 | // NOTE: We do not know the minimum or maximum zoom the marker was 309 | // added at, so we start at the absolute maximum. Whenever we successfully 310 | // remove a marker at a given zoom, we add it at the new grid coordinates. 311 | var zoom = this.maxZoom_; 312 | var changed = false; 313 | var oldGrid = this.getTilePoint_(oldPoint, zoom, new google.maps.Size(0, 0, 0, 0)); 314 | var newGrid = this.getTilePoint_(newPoint, zoom, new google.maps.Size(0, 0, 0, 0)); 315 | while (zoom >= 0 && (oldGrid.x !== newGrid.x || oldGrid.y !== newGrid.y)) { 316 | var cell = this.getGridCellNoCreate_(oldGrid.x, oldGrid.y, zoom); 317 | if (cell) { 318 | if (this.removeFromArray_(cell, marker)) { 319 | this.getGridCellCreate_(newGrid.x, newGrid.y, zoom).push(marker); 320 | } 321 | } 322 | // For the current zoom we also need to update the map. Markers that no 323 | // longer are visible are removed from the map. Markers that moved into 324 | // the shown bounds are added to the map. This also lets us keep the count 325 | // of visible markers up to date. 326 | if (zoom === this.mapZoom_) { 327 | if (this.isGridPointVisible_(oldGrid)) { 328 | if (!this.isGridPointVisible_(newGrid)) { 329 | this.removeOverlay_(marker); 330 | changed = true; 331 | } 332 | } else { 333 | if (this.isGridPointVisible_(newGrid)) { 334 | this.addOverlay_(marker); 335 | changed = true; 336 | } 337 | } 338 | } 339 | oldGrid.x = oldGrid.x >> 1; 340 | oldGrid.y = oldGrid.y >> 1; 341 | newGrid.x = newGrid.x >> 1; 342 | newGrid.y = newGrid.y >> 1; 343 | --zoom; 344 | } 345 | if (changed) { 346 | this.notifyListeners_(); 347 | } 348 | }; 349 | 350 | 351 | /** 352 | * Removes marker from the manager and from the map 353 | * (if it's currently visible). 354 | * @param {GMarker} marker The marker to delete. 355 | */ 356 | MarkerManager.prototype.removeMarker = function (marker) { 357 | var zoom = this.maxZoom_; 358 | var changed = false; 359 | var point = marker.getPosition(); 360 | var grid = this.getTilePoint_(point, zoom, new google.maps.Size(0, 0, 0, 0)); 361 | while (zoom >= 0) { 362 | var cell = this.getGridCellNoCreate_(grid.x, grid.y, zoom); 363 | 364 | if (cell) { 365 | this.removeFromArray_(cell, marker); 366 | } 367 | // For the current zoom we also need to update the map. Markers that no 368 | // longer are visible are removed from the map. This also lets us keep the count 369 | // of visible markers up to date. 370 | if (zoom === this.mapZoom_) { 371 | if (this.isGridPointVisible_(grid)) { 372 | this.removeOverlay_(marker); 373 | changed = true; 374 | } 375 | } 376 | grid.x = grid.x >> 1; 377 | grid.y = grid.y >> 1; 378 | --zoom; 379 | } 380 | if (changed) { 381 | this.notifyListeners_(); 382 | } 383 | this.numMarkers_[marker.MarkerManager_minZoom]--; 384 | }; 385 | 386 | 387 | /** 388 | * Add many markers at once. 389 | * Does not actually update the map, just the internal grid. 390 | * 391 | * @param {Array of Marker} markers The markers to add. 392 | * @param {Number} minZoom The minimum zoom level to display the markers. 393 | * @param {Number} opt_maxZoom The maximum zoom level to display the markers. 394 | */ 395 | MarkerManager.prototype.addMarkers = function (markers, minZoom, opt_maxZoom) { 396 | var maxZoom = this.getOptMaxZoom_(opt_maxZoom); 397 | for (var i = markers.length - 1; i >= 0; i--) { 398 | this.addMarkerBatch_(markers[i], minZoom, maxZoom); 399 | } 400 | 401 | this.numMarkers_[minZoom] += markers.length; 402 | }; 403 | 404 | 405 | /** 406 | * Returns the value of the optional maximum zoom. This method is defined so 407 | * that we have just one place where optional maximum zoom is calculated. 408 | * 409 | * @param {Number} opt_maxZoom The optinal maximum zoom. 410 | * @return The maximum zoom. 411 | */ 412 | MarkerManager.prototype.getOptMaxZoom_ = function (opt_maxZoom) { 413 | return opt_maxZoom || this.maxZoom_; 414 | }; 415 | 416 | 417 | /** 418 | * Calculates the total number of markers potentially visible at a given 419 | * zoom level. 420 | * 421 | * @param {Number} zoom The zoom level to check. 422 | */ 423 | MarkerManager.prototype.getMarkerCount = function (zoom) { 424 | var total = 0; 425 | for (var z = 0; z <= zoom; z++) { 426 | total += this.numMarkers_[z]; 427 | } 428 | return total; 429 | }; 430 | 431 | /** 432 | * Returns a marker given latitude, longitude and zoom. If the marker does not 433 | * exist, the method will return a new marker. If a new marker is created, 434 | * it will NOT be added to the manager. 435 | * 436 | * @param {Number} lat - the latitude of a marker. 437 | * @param {Number} lng - the longitude of a marker. 438 | * @param {Number} zoom - the zoom level 439 | * @return {GMarker} marker - the marker found at lat and lng 440 | */ 441 | MarkerManager.prototype.getMarker = function (lat, lng, zoom) { 442 | var mPoint = new google.maps.LatLng(lat, lng); 443 | var gridPoint = this.getTilePoint_(mPoint, zoom, new google.maps.Size(0, 0, 0, 0)); 444 | 445 | var marker = new google.maps.Marker({position: mPoint}); 446 | 447 | var cellArray = this.getGridCellNoCreate_(gridPoint.x, gridPoint.y, zoom); 448 | if (cellArray !== undefined) { 449 | for (var i = 0; i < cellArray.length; i++) 450 | { 451 | if (lat === cellArray[i].getLatLng().lat() && lng === cellArray[i].getLatLng().lng()) { 452 | marker = cellArray[i]; 453 | } 454 | } 455 | } 456 | return marker; 457 | }; 458 | 459 | /** 460 | * Add a single marker to the map. 461 | * 462 | * @param {Marker} marker The marker to add. 463 | * @param {Number} minZoom The minimum zoom level to display the marker. 464 | * @param {Number} opt_maxZoom The maximum zoom level to display the marker. 465 | */ 466 | MarkerManager.prototype.addMarker = function (marker, minZoom, opt_maxZoom) { 467 | var maxZoom = this.getOptMaxZoom_(opt_maxZoom); 468 | this.addMarkerBatch_(marker, minZoom, maxZoom); 469 | var gridPoint = this.getTilePoint_(marker.getPosition(), this.mapZoom_, new google.maps.Size(0, 0, 0, 0)); 470 | if (this.isGridPointVisible_(gridPoint) && 471 | minZoom <= this.shownBounds_.z && 472 | this.shownBounds_.z <= maxZoom) { 473 | this.addOverlay_(marker); 474 | this.notifyListeners_(); 475 | } 476 | this.numMarkers_[minZoom]++; 477 | }; 478 | 479 | 480 | /** 481 | * Helper class to create a bounds of INT ranges. 482 | * @param bounds Array.> Bounds object. 483 | * @constructor 484 | */ 485 | function GridBounds(bounds) { 486 | // [sw, ne] 487 | 488 | this.minX = Math.min(bounds[0].x, bounds[1].x); 489 | this.maxX = Math.max(bounds[0].x, bounds[1].x); 490 | this.minY = Math.min(bounds[0].y, bounds[1].y); 491 | this.maxY = Math.max(bounds[0].y, bounds[1].y); 492 | 493 | } 494 | 495 | /** 496 | * Returns true if this bounds equal the given bounds. 497 | * @param {GridBounds} gridBounds GridBounds The bounds to test. 498 | * @return {Boolean} This Bounds equals the given GridBounds. 499 | */ 500 | GridBounds.prototype.equals = function (gridBounds) { 501 | if (this.maxX === gridBounds.maxX && this.maxY === gridBounds.maxY && this.minX === gridBounds.minX && this.minY === gridBounds.minY) { 502 | return true; 503 | } else { 504 | return false; 505 | } 506 | }; 507 | 508 | /** 509 | * Returns true if this bounds (inclusively) contains the given point. 510 | * @param {Point} point The point to test. 511 | * @return {Boolean} This Bounds contains the given Point. 512 | */ 513 | GridBounds.prototype.containsPoint = function (point) { 514 | var outer = this; 515 | return (outer.minX <= point.x && outer.maxX >= point.x && outer.minY <= point.y && outer.maxY >= point.y); 516 | }; 517 | 518 | /** 519 | * Get a cell in the grid, creating it first if necessary. 520 | * 521 | * Optimization candidate 522 | * 523 | * @param {Number} x The x coordinate of the cell. 524 | * @param {Number} y The y coordinate of the cell. 525 | * @param {Number} z The z coordinate of the cell. 526 | * @return {Array} The cell in the array. 527 | */ 528 | MarkerManager.prototype.getGridCellCreate_ = function (x, y, z) { 529 | var grid = this.grid_[z]; 530 | if (x < 0) { 531 | x += this.gridWidth_[z]; 532 | } 533 | var gridCol = grid[x]; 534 | if (!gridCol) { 535 | gridCol = grid[x] = []; 536 | return (gridCol[y] = []); 537 | } 538 | var gridCell = gridCol[y]; 539 | if (!gridCell) { 540 | return (gridCol[y] = []); 541 | } 542 | return gridCell; 543 | }; 544 | 545 | 546 | /** 547 | * Get a cell in the grid, returning undefined if it does not exist. 548 | * 549 | * NOTE: Optimized for speed -- otherwise could combine with getGridCellCreate_. 550 | * 551 | * @param {Number} x The x coordinate of the cell. 552 | * @param {Number} y The y coordinate of the cell. 553 | * @param {Number} z The z coordinate of the cell. 554 | * @return {Array} The cell in the array. 555 | */ 556 | MarkerManager.prototype.getGridCellNoCreate_ = function (x, y, z) { 557 | var grid = this.grid_[z]; 558 | 559 | if (x < 0) { 560 | x += this.gridWidth_[z]; 561 | } 562 | var gridCol = grid[x]; 563 | return gridCol ? gridCol[y] : undefined; 564 | }; 565 | 566 | 567 | /** 568 | * Turns at geographical bounds into a grid-space bounds. 569 | * 570 | * @param {LatLngBounds} bounds The geographical bounds. 571 | * @param {Number} zoom The zoom level of the bounds. 572 | * @param {google.maps.Size} swPadding The padding in pixels to extend beyond the 573 | * given bounds. 574 | * @param {google.maps.Size} nePadding The padding in pixels to extend beyond the 575 | * given bounds. 576 | * @return {GridBounds} The bounds in grid space. 577 | */ 578 | MarkerManager.prototype.getGridBounds_ = function (bounds, zoom, swPadding, nePadding) { 579 | zoom = Math.min(zoom, this.maxZoom_); 580 | 581 | var bl = bounds.getSouthWest(); 582 | var tr = bounds.getNorthEast(); 583 | var sw = this.getTilePoint_(bl, zoom, swPadding); 584 | 585 | var ne = this.getTilePoint_(tr, zoom, nePadding); 586 | var gw = this.gridWidth_[zoom]; 587 | 588 | // Crossing the prime meridian requires correction of bounds. 589 | if (tr.lng() < bl.lng() || ne.x < sw.x) { 590 | sw.x -= gw; 591 | } 592 | if (ne.x - sw.x + 1 >= gw) { 593 | // Computed grid bounds are larger than the world; truncate. 594 | sw.x = 0; 595 | ne.x = gw - 1; 596 | } 597 | 598 | var gridBounds = new GridBounds([sw, ne]); 599 | gridBounds.z = zoom; 600 | 601 | return gridBounds; 602 | }; 603 | 604 | 605 | /** 606 | * Gets the grid-space bounds for the current map viewport. 607 | * 608 | * @return {Bounds} The bounds in grid space. 609 | */ 610 | MarkerManager.prototype.getMapGridBounds_ = function () { 611 | return this.getGridBounds_(this.map_.getBounds(), this.mapZoom_, this.swPadding_, this.nePadding_); 612 | }; 613 | 614 | 615 | /** 616 | * Event listener for map:movend. 617 | * NOTE: Use a timeout so that the user is not blocked 618 | * from moving the map. 619 | * 620 | * Removed this because a a lack of a scopy override/callback function on events. 621 | */ 622 | MarkerManager.prototype.onMapMoveEnd_ = function () { 623 | this.objectSetTimeout_(this, this.updateMarkers_, 0); 624 | }; 625 | 626 | 627 | /** 628 | * Call a function or evaluate an expression after a specified number of 629 | * milliseconds. 630 | * 631 | * Equivalent to the standard window.setTimeout function, but the given 632 | * function executes as a method of this instance. So the function passed to 633 | * objectSetTimeout can contain references to this. 634 | * objectSetTimeout(this, function () { alert(this.x) }, 1000); 635 | * 636 | * @param {Object} object The target object. 637 | * @param {Function} command The command to run. 638 | * @param {Number} milliseconds The delay. 639 | * @return {Boolean} Success. 640 | */ 641 | MarkerManager.prototype.objectSetTimeout_ = function (object, command, milliseconds) { 642 | return window.setTimeout(function () { 643 | command.call(object); 644 | }, milliseconds); 645 | }; 646 | 647 | 648 | /** 649 | * Is this layer visible? 650 | * 651 | * Returns visibility setting 652 | * 653 | * @return {Boolean} Visible 654 | */ 655 | MarkerManager.prototype.visible = function () { 656 | return this.show_ ? true : false; 657 | }; 658 | 659 | 660 | /** 661 | * Returns true if the manager is hidden. 662 | * Otherwise returns false. 663 | * @return {Boolean} Hidden 664 | */ 665 | MarkerManager.prototype.isHidden = function () { 666 | return !this.show_; 667 | }; 668 | 669 | 670 | /** 671 | * Shows the manager if it's currently hidden. 672 | */ 673 | MarkerManager.prototype.show = function () { 674 | this.show_ = true; 675 | this.refresh(); 676 | }; 677 | 678 | 679 | /** 680 | * Hides the manager if it's currently visible 681 | */ 682 | MarkerManager.prototype.hide = function () { 683 | this.show_ = false; 684 | this.refresh(); 685 | }; 686 | 687 | 688 | /** 689 | * Toggles the visibility of the manager. 690 | */ 691 | MarkerManager.prototype.toggle = function () { 692 | this.show_ = !this.show_; 693 | this.refresh(); 694 | }; 695 | 696 | 697 | /** 698 | * Refresh forces the marker-manager into a good state. 699 | *
              700 | *
            1. If never before initialized, shows all the markers.
              2. 701 | *
            2. If previously initialized, removes and re-adds all markers.
              3. 702 | *
            703 | */ 704 | MarkerManager.prototype.refresh = function () { 705 | if (this.shownMarkers_ > 0) { 706 | this.processAll_(this.shownBounds_, this.removeOverlay_); 707 | } 708 | // An extra check on this.show_ to increase performance (no need to processAll_) 709 | if (this.show_) { 710 | this.processAll_(this.shownBounds_, this.addOverlay_); 711 | } 712 | this.notifyListeners_(); 713 | }; 714 | 715 | 716 | /** 717 | * After the viewport may have changed, add or remove markers as needed. 718 | */ 719 | MarkerManager.prototype.updateMarkers_ = function () { 720 | this.mapZoom_ = this.map_.getZoom(); 721 | var newBounds = this.getMapGridBounds_(); 722 | 723 | // If the move does not include new grid sections, 724 | // we have no work to do: 725 | if (newBounds.equals(this.shownBounds_) && newBounds.z === this.shownBounds_.z) { 726 | return; 727 | } 728 | 729 | if (newBounds.z !== this.shownBounds_.z) { 730 | this.processAll_(this.shownBounds_, this.removeOverlay_); 731 | if (this.show_) { // performance 732 | this.processAll_(newBounds, this.addOverlay_); 733 | } 734 | } else { 735 | // Remove markers: 736 | this.rectangleDiff_(this.shownBounds_, newBounds, this.removeCellMarkers_); 737 | 738 | // Add markers: 739 | if (this.show_) { // performance 740 | this.rectangleDiff_(newBounds, this.shownBounds_, this.addCellMarkers_); 741 | } 742 | } 743 | this.shownBounds_ = newBounds; 744 | 745 | this.notifyListeners_(); 746 | }; 747 | 748 | 749 | /** 750 | * Notify listeners when the state of what is displayed changes. 751 | */ 752 | MarkerManager.prototype.notifyListeners_ = function () { 753 | google.maps.event.trigger(this, 'changed', this.shownBounds_, this.shownMarkers_); 754 | }; 755 | 756 | 757 | /** 758 | * Process all markers in the bounds provided, using a callback. 759 | * 760 | * @param {Bounds} bounds The bounds in grid space. 761 | * @param {Function} callback The function to call for each marker. 762 | */ 763 | MarkerManager.prototype.processAll_ = function (bounds, callback) { 764 | for (var x = bounds.minX; x <= bounds.maxX; x++) { 765 | for (var y = bounds.minY; y <= bounds.maxY; y++) { 766 | this.processCellMarkers_(x, y, bounds.z, callback); 767 | } 768 | } 769 | }; 770 | 771 | 772 | /** 773 | * Process all markers in the grid cell, using a callback. 774 | * 775 | * @param {Number} x The x coordinate of the cell. 776 | * @param {Number} y The y coordinate of the cell. 777 | * @param {Number} z The z coordinate of the cell. 778 | * @param {Function} callback The function to call for each marker. 779 | */ 780 | MarkerManager.prototype.processCellMarkers_ = function (x, y, z, callback) { 781 | var cell = this.getGridCellNoCreate_(x, y, z); 782 | if (cell) { 783 | for (var i = cell.length - 1; i >= 0; i--) { 784 | callback(cell[i]); 785 | } 786 | } 787 | }; 788 | 789 | 790 | /** 791 | * Remove all markers in a grid cell. 792 | * 793 | * @param {Number} x The x coordinate of the cell. 794 | * @param {Number} y The y coordinate of the cell. 795 | * @param {Number} z The z coordinate of the cell. 796 | */ 797 | MarkerManager.prototype.removeCellMarkers_ = function (x, y, z) { 798 | this.processCellMarkers_(x, y, z, this.removeOverlay_); 799 | }; 800 | 801 | 802 | /** 803 | * Add all markers in a grid cell. 804 | * 805 | * @param {Number} x The x coordinate of the cell. 806 | * @param {Number} y The y coordinate of the cell. 807 | * @param {Number} z The z coordinate of the cell. 808 | */ 809 | MarkerManager.prototype.addCellMarkers_ = function (x, y, z) { 810 | this.processCellMarkers_(x, y, z, this.addOverlay_); 811 | }; 812 | 813 | 814 | /** 815 | * Use the rectangleDiffCoords_ function to process all grid cells 816 | * that are in bounds1 but not bounds2, using a callback, and using 817 | * the current MarkerManager object as the instance. 818 | * 819 | * Pass the z parameter to the callback in addition to x and y. 820 | * 821 | * @param {Bounds} bounds1 The bounds of all points we may process. 822 | * @param {Bounds} bounds2 The bounds of points to exclude. 823 | * @param {Function} callback The callback function to call 824 | * for each grid coordinate (x, y, z). 825 | */ 826 | MarkerManager.prototype.rectangleDiff_ = function (bounds1, bounds2, callback) { 827 | var me = this; 828 | me.rectangleDiffCoords_(bounds1, bounds2, function (x, y) { 829 | callback.apply(me, [x, y, bounds1.z]); 830 | }); 831 | }; 832 | 833 | 834 | /** 835 | * Calls the function for all points in bounds1, not in bounds2 836 | * 837 | * @param {Bounds} bounds1 The bounds of all points we may process. 838 | * @param {Bounds} bounds2 The bounds of points to exclude. 839 | * @param {Function} callback The callback function to call 840 | * for each grid coordinate. 841 | */ 842 | MarkerManager.prototype.rectangleDiffCoords_ = function (bounds1, bounds2, callback) { 843 | var minX1 = bounds1.minX; 844 | var minY1 = bounds1.minY; 845 | var maxX1 = bounds1.maxX; 846 | var maxY1 = bounds1.maxY; 847 | var minX2 = bounds2.minX; 848 | var minY2 = bounds2.minY; 849 | var maxX2 = bounds2.maxX; 850 | var maxY2 = bounds2.maxY; 851 | 852 | var x, y; 853 | for (x = minX1; x <= maxX1; x++) { // All x in R1 854 | // All above: 855 | for (y = minY1; y <= maxY1 && y < minY2; y++) { // y in R1 above R2 856 | callback(x, y); 857 | } 858 | // All below: 859 | for (y = Math.max(maxY2 + 1, minY1); // y in R1 below R2 860 | y <= maxY1; y++) { 861 | callback(x, y); 862 | } 863 | } 864 | 865 | for (y = Math.max(minY1, minY2); 866 | y <= Math.min(maxY1, maxY2); y++) { // All y in R2 and in R1 867 | // Strictly left: 868 | for (x = Math.min(maxX1 + 1, minX2) - 1; 869 | x >= minX1; x--) { // x in R1 left of R2 870 | callback(x, y); 871 | } 872 | // Strictly right: 873 | for (x = Math.max(minX1, maxX2 + 1); // x in R1 right of R2 874 | x <= maxX1; x++) { 875 | callback(x, y); 876 | } 877 | } 878 | }; 879 | 880 | 881 | /** 882 | * Removes value from array. O(N). 883 | * 884 | * @param {Array} array The array to modify. 885 | * @param {any} value The value to remove. 886 | * @param {Boolean} opt_notype Flag to disable type checking in equality. 887 | * @return {Number} The number of instances of value that were removed. 888 | */ 889 | MarkerManager.prototype.removeFromArray_ = function (array, value, opt_notype) { 890 | var shift = 0; 891 | for (var i = 0; i < array.length; ++i) { 892 | if (array[i] === value || (opt_notype && array[i] === value)) { 893 | array.splice(i--, 1); 894 | shift++; 895 | } 896 | } 897 | return shift; 898 | }; 899 | 900 | 901 | 902 | 903 | 904 | 905 | 906 | /** 907 | * Projection overlay helper. Helps in calculating 908 | * that markers get into the right grid. 909 | * @constructor 910 | * @param {Map} map The map to manage. 911 | **/ 912 | function ProjectionHelperOverlay(map) { 913 | 914 | this.setMap(map); 915 | 916 | var TILEFACTOR = 8; 917 | var TILESIDE = 1 << TILEFACTOR; 918 | var RADIUS = 7; 919 | 920 | this._map = map; 921 | this._zoom = -1; 922 | this._X0 = 923 | this._Y0 = 924 | this._X1 = 925 | this._Y1 = -1; 926 | 927 | 928 | } 929 | ProjectionHelperOverlay.prototype = new google.maps.OverlayView(); 930 | 931 | /** 932 | * Helper function to convert Lng to X 933 | * @private 934 | * @param {float} lng 935 | **/ 936 | ProjectionHelperOverlay.prototype.LngToX_ = function (lng) { 937 | return (1 + lng / 180); 938 | }; 939 | 940 | /** 941 | * Helper function to convert Lat to Y 942 | * @private 943 | * @param {float} lat 944 | **/ 945 | ProjectionHelperOverlay.prototype.LatToY_ = function (lat) { 946 | var sinofphi = Math.sin(lat * Math.PI / 180); 947 | return (1 - 0.5 / Math.PI * Math.log((1 + sinofphi) / (1 - sinofphi))); 948 | }; 949 | 950 | /** 951 | * Old school LatLngToPixel 952 | * @param {LatLng} latlng google.maps.LatLng object 953 | * @param {Number} zoom Zoom level 954 | * @return {position} {x: pixelPositionX, y: pixelPositionY} 955 | **/ 956 | ProjectionHelperOverlay.prototype.LatLngToPixel = function (latlng, zoom) { 957 | var map = this._map; 958 | var div = this.getProjection().fromLatLngToDivPixel(latlng); 959 | var abs = {x: ~~(0.5 + this.LngToX_(latlng.lng()) * (2 << (zoom + 6))), y: ~~(0.5 + this.LatToY_(latlng.lat()) * (2 << (zoom + 6)))}; 960 | return abs; 961 | }; 962 | 963 | 964 | /** 965 | * Draw function only triggers a ready event for 966 | * MarkerManager to know projection can proceed to 967 | * initialize. 968 | */ 969 | ProjectionHelperOverlay.prototype.draw = function () { 970 | if (!this.ready) { 971 | this.ready = true; 972 | google.maps.event.trigger(this, 'ready'); 973 | } 974 | }; --------------------------------------------------------------------------------