WANTED: Help to make the widget Android and Mobile Web compatible

The PullToRefresh widget is an Alloy implementation of the TableView Refresh with headerPullView found in the docs for Titanium by Appcelerator.

• Initialize the widget through one simple call.
• Change (localize) any of the messages displayed.
• Localized date and time of last update.
• Manually trigger the widget, e.g. for first load.

• Android and Mobile Web compatibility and testing.
• Localization of messages by the widget itself.
• Find out how to override the view/style from outside the widget.

• Download the repository of the widget as a ZIP file.
• Move the file to your project's root folder.
• Unzip the file and you'll find the widget under app/widgets/nl.fokkezb.pullToRefresh.
• Add the widget as a dependency to your app/config.json file like so:

	"dependencies": {
		"nl.fokkezb.pullToRefresh":"1.1"
	}

• Attach the widget to any Ti.UI.TableView. Please note the change of load to loader as from 1.1.

var ptrCtrl = Alloy.createWidget('nl.fokkezb.pullToRefresh', null, {
	table: $.myTable,
	loader: myLoaderCallback
});

or

var ptrCtrl = Alloy.createWidget('nl.fokkezb.pullToRefresh');
ptrCtrl.init({
	table: $.myTable,
	loader: myLoaderCallback
});

• As from 1.1 your myLoaderCallback gets passed a callback that should be called upon completion. If you pass FALSE when calling the callback, the Last Updated date will NOT be updated.

function myLoaderCallback(widgetCallback) {
	// DO YOUR LOADING
	widgetCallback(true);
}

The only required parameters are the table and loader parameters. You can change the displayed texts using the following additional ones:

As from 1.1 you can also manually show and hide the view, update it's Last Updated date or trigger the complete cycle of the widget. Use this for example upon first load of the table or as long the table is empty.

• 1.1
  • Exposed new API functions to show/hide the view, set the date and trigger the widget manually.
  • Renamed 'load' parameter to 'loader' in line with upcomming widgets.
• 1.0
  • Initial version