1. Description

• You can choose where to show the Toast: at the top, center or bottom of the screen.
• You can choose two durations: short (approx. 2 seconds), or long (approx. 5 seconds), after which the Toast automatically disappears.
• Compatible with Cordova Plugman.
• Officially supported by PhoneGap Build.
• Minimum iOS version is 6.

• "There were validation errors"
• "Account created successfully"
• "The record was deleted"
• "Login successful"
• "The battery is almost dead"
• "You are now logged out"
• "Connection failure, please try again later"

2. Screenshots

3. Installation

Automatically (CLI / Plugman)

$ phonegap local plugin add https://github.com/EddyVerbruggen/Toast-PhoneGap-Plugin.git

$ cordova plugin add https://github.com/EddyVerbruggen/Toast-PhoneGap-Plugin.git
$ cordova prepare

Manually

<!-- for iOS -->
<feature name="Toast">
  <param name="ios-package" value="Toast" />
</feature>

<!-- for Android -->
<feature name="Toast">
  <param name="android-package" value="nl.xservices.plugins.Toast" />
</feature>

<!-- for WP8 -->
<feature name="Toast">
  <param name="wp-package" value="Toast"/>
</feature>

<script type="text/javascript" src="js/Toast.js"></script>

PhoneGap Build

<gap:plugin name="nl.x-services.plugins.toast" />

<gap:plugin name="nl.x-services.plugins.toast" version="1.0" />

4. Usage

• show(message, duration, position)
  • duration: 'short', 'long'
  • position: 'top', 'center', 'bottom'

• showShortTop(message)
• showShortCenter(message)
• showShortBottom(message)
• showLongTop(message)
• showLongCenter(message)
• showLongBottom(message)

<button onclick="window.plugins.toast.showShortTop('Hello there!', function(a){console.log('toast success: ' + a)}, function(b){alert('toast error: ' + b)})">Toast showShortTop</button>
<button onclick="window.plugins.toast.showLongBottom('Hello there!', function(a){console.log('toast success: ' + a)}, function(b){alert('toast error: ' + b)})">Toast showLongBottom</button>
<button onclick="window.plugins.toast.show('Hello there!', 'long', 'center', function(a){console.log('toast success: ' + a)}, function(b){alert('toast error: ' + b)})">Toast show long center</button>