Capture tap events on the status bar.
Switch branches/tags
Nothing to show
Clone or download
Pull request Compare This branch is 17 commits behind j-mcnally:master.
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
src/ios
www
.gitignore
LICENSE
README.md
plugin.xml

README.md

cordova-statusTap

Capture tap events on the status bar.

This plugin is aimed at libraries like Sencha for users who want to execute custom code like scrolling their list views on status tap.

Installation

To use this plugin, all you have to do is add this to your project use the PhoneGap CLI:

phonegap local plugin add https://github.com/triceam/cordova-statusTap

The CLI tooling sets up all JS file references, and the plugin will initialize itself.

Then to add a listener for the tap implement after PhoneGap/Cordova's onDeviceReady has been fired:

window.addEventListener("statusTap", function() {
  alert("status tap");
});

If you want to scroll a div based on this event, you can do something like the following (note, this is jQuery syntax):

window.addEventListener("statusTap", function() {
	var target = $("#scroller");
	
	//disable touch scroll
	target.css({
		'-webkit-overflow-scrolling' : 'auto',
		'overflow-y' : 'hidden'
	});
	
	//animate
	target.animate({ scrollTop: 0}, 300, "swing", function(){
		
		//re-enable touch scrolling
		target.css({
			'-webkit-overflow-scrolling' : 'touch',
			'overflow-y' : 'scroll'
		});
	});
});

This disables touch scrolling to kill an inertial scrolling in progress, animates it, then re-enables touch scrolling once the animation is complete.

That's it... very simple.

Details

This implementation is forked from https://github.com/j-mcnally/cordova-statusTap

Changes include:

  1. Updated for PhoneGap/Cordova CLI usage
  2. Added auto-initialization - no need to manually initialize anymore
  3. Updated for ARC compatibility

The main implementation is exactly the same as the original.