New feature. Custom controls

hpneo · hpneo · commit 3069dcc0ba50 · 2012-05-26T15:02:25.000-05:00
diff --git a/README.md b/README.md
@@ -8,6 +8,10 @@ Visit the examples in [hpneo.github.com/gmaps](http://hpneo.github.com/gmaps/)
 Changelog
 ---------
 
+0.1.10
+-----------------------
+* New feature: **Custom controls**
+
 0.1.9
 -----------------------
 * New feature: **Static maps**
diff --git a/examples/map_controls.html b/examples/map_controls.html
@@ -0,0 +1,91 @@
+<!DOCTYPE html>
+<html>
+<head>
+  <meta charset="utf-8">
+  <title>GMaps.js &mdash; Map events</title>
+  <script type="text/javascript" src="http://ajax.googleapis.com/ajax/libs/jquery/1.6.4/jquery.min.js"></script>
+  <script type="text/javascript" src="http://maps.google.com/maps/api/js?sensor=true"></script>
+  <script type="text/javascript" src="../gmaps.js"></script>
+  <link rel="stylesheet" href="http://twitter.github.com/bootstrap/1.3.0/bootstrap.min.css" />
+  <link rel="stylesheet" type="text/css" href="examples.css" />
+  <script type="text/javascript">
+    var map;
+    $(document).ready(function(){
+      map = new GMaps({
+        div: '#map',
+        zoom: 16,
+        lat: -12.043333,
+        lng: -77.028333
+      });
+      map.addControl({
+        position: 'top_right',
+        text: 'Geolocate',
+        style: {
+          margin: '5px',
+          padding: '1px 6px',
+          border: 'solid 1px #717B87',
+          background: '#fff'
+        },
+        events: {
+          click: function(){
+            GMaps.geolocate({
+              success: function(position){
+                map.setCenter(position.coords.latitude, position.coords.longitude);
+              },
+              error: function(error){
+                alert('Geolocation failed: ' + error.message);
+              },
+              not_supported: function(){
+                alert("Your browser does not support geolocation");
+              }
+            });
+          }
+        }
+      });
+    });
+  </script>
+</head>
+<body>
+  <h1>GMaps.js &mdash; Map events</h1>
+  <div class="row">
+    <div class="span11">
+      <div id="map"></div>
+    </div>
+    <div class="span6">
+      <p>GMaps.js allows to add custom controls:</p>
+      <pre>map.addControl({
+  position: 'top_right',
+  text: 'Geolocate',
+  style: {
+    margin: '5px',
+    padding: '1px 6px',
+    border: 'solid 1px #717B87',
+    background: '#fff'
+  },
+  events: {
+    click: function(){
+      console.log(this);
+    }
+  }
+});</pre>
+      <p>
+        <span class="label notice">Note</span> You can use the following positions:
+        <ul>
+          <li>top_center</li>
+          <li>top_left</li>
+          <li>top_right</li>
+          <li>left_top</li>
+          <li>right_top</li>
+          <li>left_center</li>
+          <li>right_center</li>
+          <li>left_bottom</li>
+          <li>right_bottom</li>
+          <li>bottom_center</li>
+          <li>bottom_left</li>
+          <li>bottom_right</li>
+        </ul>
+        You can learn more of custom controls <a href="https://developers.google.com/maps/documentation/javascript/controls#ControlPositioning">here</a>.</p>
+    </div>
+  </div>
+</body>
+</html>
diff --git a/gmaps.js b/gmaps.js
@@ -8,6 +8,7 @@ var GMaps = (function($) {
     window.context_menu = {};
 
     this.div = $(options.div)[0];
+    this.controls = [];
     this.overlays = [];
     this.markers = [];
     this.polylines = [];
@@ -241,6 +242,41 @@ var GMaps = (function($) {
       this.map.setZoom(this.map.getZoom() - value);
     };
 
+    this.createControl = function(options) {
+      options.style.cursor = 'pointer';
+      options.style.fontFamily = 'Arial, sans-serif';
+      options.style.fontSize = '13px';
+      options.style.boxShadow = 'rgba(0, 0, 0, 0.398438) 0px 2px 4px';
+
+      var controlDiv = $('<div></div>');
+      controlDiv.css(options.style);
+      controlDiv.text(options.text);
+
+      var control = controlDiv[0];
+
+      for(var e in options.events) {
+        google.maps.event.addDomListener(control, e, function() {
+          options.events[e].apply(this, [this]);
+        });
+      }
+
+      control.index = 1;
+
+      return control;
+    };
+
+    this.addControl = function(options) {
+      var position = google.maps.ControlPosition[options.position.toUpperCase()];
+
+      delete options.position;
+
+      var control = this.createControl(options);
+      this.controls.push(control);
+      this.map.controls[position].push(control);
+
+      return control;
+    };
+
     // Markers
     this.createMarker = function(options) {
       if (options.lat && options.lng) {
