Bump version number, namespace events

README.md

@@ -40,8 +40,8 @@ $(document).ready(function() {
 
 The constructor also takes an optional options object and callback function. The function will be called whenever 
 the selected date range has been changed by the user, and is passed the start and end dates (moment date objects)
-and the range label chosen (if any), as parameters. It will not fire if the picker is closed without any change
-to the selected dates.
+and the predefined range label chosen (if any), as parameters. It will not fire if the picker is closed without 
+any change to the selected dates.
 
 ````
 $('input[name="daterange"]').daterangepicker(
@@ -50,7 +50,7 @@ $('input[name="daterange"]').daterangepicker(
     startDate: '2013-01-01',
     endDate: '2013-12-31'
   },
-  function(start, end) {
+  function(start, end, label) {
     alert('A date range was chosen: ' + start.format('YYYY-MM-DD') + ' to ' + end.format('YYYY-MM-DD'));
   }
 );
@@ -106,17 +106,28 @@ Several functions are provided for updating the picker's option and state after
 
 `setEndDate(Date/moment/string)`: Sets the date range picker's currently selected end date to the provided date
 
+Example usage:
+
+````
+//create a new date range picker
+$('#daterange').daterangepicker({ startDate: '2014-03-05', endDate: '2014-03-06' });
+
+//change the selected date range of that picker
+$('#daterange').data('daterangepicker').setStartDate('2014-03-01');
+$('#daterange').data('daterangepicker').setEndDate('2014-03-31');
+````
+
 ## Events
 
 Several events are triggered on the element you attach the picker to, which you can listen for:
 
-`show`: Triggered when the picker is shown
+`show.daterangepicker`: Triggered when the picker is shown
 
-`hide`: Triggered when the picker is hidden
+`hide.daterangepicker`: Triggered when the picker is hidden
 
-`apply`: Triggered when the apply button is clicked
+`apply.daterangepicker`: Triggered when the apply button is clicked
 
-`cancel`: Triggered when the cancel button is clicked
+`cancel.daterangepicker`: Triggered when the cancel button is clicked
 
 Some applications need a "clear" instead of a "cancel" functionality, which can be achieved by changing the button label and watching for the cancel event:
 
@@ -125,7 +136,7 @@ $('#daterange').daterangepicker({
   locale: { cancelLabel: 'Clear' }  
 });
 
-$('#daterange').on('cancel', function(ev, picker) {
+$('#daterange').on('cancel.daterangepicker', function(ev, picker) {
   //do something, like clearing an input
   $('#daterange').val('');
 });

bower.json

@@ -1,6 +1,6 @@
 {
   "name": "bootstrap-daterangepicker",
-  "version": "1.3.2",
+  "version": "1.3.3",
   "main": "daterangepicker.js",
   "ignore": [
     "**/.*",

daterangepicker.js

@@ -1,5 +1,5 @@
 /**
-* @version: 1.3.2
+* @version: 1.3.3
 * @author: Dan Grossman http://www.dangrossman.info/
 * @date: 2014-01-22
 * @copyright: Copyright (c) 2012-2014 Dan Grossman. All rights reserved.
@@ -500,7 +500,7 @@
             }
 
             $(document).on('mousedown', $.proxy(this.hide, this));
-            this.element.trigger('show', this);
+            this.element.trigger('show.daterangepicker', this);
         },
 
         hide: function (e) {
@@ -514,7 +514,7 @@
             this.oldEndDate = this.endDate.clone();
 
             $(document).off('mousedown', this.hide);
-            this.element.trigger('hide', this);
+            this.element.trigger('hide.daterangepicker', this);
         },
 
         enterRange: function (e) {
@@ -567,7 +567,7 @@
 
                 this.container.find('.calendar').hide();
                 this.hide();
-                this.element.trigger('apply', this);
+                this.element.trigger('apply.daterangepicker', this);
             }
         },
 
@@ -662,7 +662,7 @@
         clickApply: function (e) {
             this.updateInputText();
             this.hide();
-            this.element.trigger('apply', this);
+            this.element.trigger('apply.daterangepicker', this);
         },
 
         clickCancel: function (e) {
@@ -672,7 +672,7 @@
             this.updateView();
             this.updateCalendars();
             this.hide();
-            this.element.trigger('cancel', this);
+            this.element.trigger('cancel.daterangepicker', this);
         },
 
         updateMonthYear: function (e) {

examples.html

@@ -113,9 +113,9 @@ <h4>Options Usage</h4>
                <script type="text/javascript">
                $(document).ready(function() {
 
-                  var cb = function(start, end) {
+                  var cb = function(start, end, label) {
                     $('#reportrange span').html(start.format('MMMM D, YYYY') + ' - ' + end.format('MMMM D, YYYY'));
-                    alert("Callback has fired: [" + start.format('MMMM D, YYYY') + " to " + end.format('MMMM D, YYYY') + "]");
+                    alert("Callback has fired: [" + start.format('MMMM D, YYYY') + " to " + end.format('MMMM D, YYYY') + ", label = " + label + "]");
                   }
 
                   var optionSet1 = {
@@ -173,16 +173,16 @@ <h4>Options Usage</h4>
 
                   $('#reportrange').daterangepicker(optionSet1, cb);
 
-                  $('#reportrange').on('show', function() { console.log("show event fired"); });
-                  $('#reportrange').on('hide', function() { console.log("hide event fired"); });
-                  $('#reportrange').on('apply', function(ev, picker) { 
+                  $('#reportrange').on('show.daterangepicker', function() { console.log("show event fired"); });
+                  $('#reportrange').on('hide.daterangepicker', function() { console.log("hide event fired"); });
+                  $('#reportrange').on('apply.daterangepicker', function(ev, picker) { 
                     console.log("apply event fired, start/end dates are " 
                       + picker.startDate.format('MMMM D, YYYY') 
                       + " to " 
                       + picker.endDate.format('MMMM D, YYYY')
                     ); 
                   });
-                  $('#reportrange').on('cancel', function(ev, picker) { console.log("cancel event fired"); });
+                  $('#reportrange').on('cancel.daterangepicker', function(ev, picker) { console.log("cancel event fired"); });
 
                   $('#options1').click(function() {
                     $('#reportrange').data('daterangepicker').setOptions(optionSet1, cb);