Add pjax:click event

Author: josh

README.md

@@ -195,6 +195,7 @@ All events are fired from the container, not the link was clicked.
 
 * `pjax:start` - Fired when pjaxing begins
 * `pjax:end` - Fired when pjaxing ends.
+  `pjax:click` - Fired when pjaxified link is clicked
 
 This pair events fire anytime a pjax request starts and finishes. This includes pjaxing on `popstate` and when pages are loaded from cache instead of making a request.
 

jquery.pjax.js

@@ -89,9 +89,14 @@ function handleClick(event, container, options) {
     fragment: null
   }
 
-  pjax($.extend({}, defaults, options))
+  var opts = $.extend({}, defaults, options)
+  var event = $.Event('pjax:click')
+  $(link).trigger(event, [opts])
 
-  event.preventDefault()
+  if (!event.isDefaultPrevented()) {
+    pjax(opts)
+    event.preventDefault()
+  }
 }
 
 // Public: pjax on form submit handler

test/unit/fn_pjax.js

@@ -204,4 +204,17 @@ if ($.support.pjax) {
     link.attr('href', "/dinosaurs.html#main")
     link.click()
   })
+
+  asyncTest("triggers pjax:click event from link", function() {
+    var frame = this.frame
+
+    frame.$("#main").pjax("a").on("pjax:click", function(event, options) {
+      ok(event)
+      ok(options.container.is('#main'))
+      ok(options.url.match("/dinosaurs.html"))
+      start()
+    })
+
+    frame.$("a[href='/dinosaurs.html']").click()
+  })
 }