This sample demonstrates how to integrate Toast messages into a BlackBerry WebWorks application for BlackBerry 10. The API documentation is available here.

The sample code for this application is Open Source under the Apache 2.0 License.

Applies To

• BlackBerry 10 WebWorks SDK

Author(s)

• Chad Tetreault

Dependencies

1. [bbUI.js] (https://github.com/blackberry/bbUI.js) is [licensed] (https://github.com/blackberry/bbUI.js/blob/master/LICENSE) under the Apache 2.0 license.

Icons
Icons used here are from http://subway.pixle.pl/rim are licensed under the CC-BY-3.0 license. This is a subset of the Subway icons available at http://subway.pixle.pl/

To contribute code to this repository you must be signed up as an official contributor.

The following must be added to your CONFIG.XML in order to use the toast API.

<feature id="blackberry.ui.toast" />

Displaying a Toast message is really easy. This sample app shows you two methods. Simple, and Custom.

Simple Toast

Displays a custom message to the user for a few seconds, then disappears.

var message = 'This is a simple Toast';
blackberry.ui.toast.show(message);	

Custom Toast

Displays a custom message, with an optional button (with callbacks).

var message = 'This is my toast!',
    buttonText = 'Click Me',
    toastId,

onButtonSelected = function () {
   	alert('Button was clicked for toast: ' + toastId);
},

onToastDismissed = function () {
   	alert('Toast disappeared: ' + toastId);
};

options = {
   	buttonText : buttonText,
    buttonCallback : onButtonSelected,
    dismissCallback : onToastDismissed
};

toastId = blackberry.ui.toast.show(message, options);		

1. Clone the repo to your local machine
2. Use Using the Ripple Mobile Emulator and the BlackBerry WebWorks SDK for BlackBerry 10, package the contents of your local BB10-WebWorks-Samples/Toast folder into a BlackBerry application.

• BlackBerry HTML5 WebWorks - Downloads, Getting Started guides, samples, code signing keys.
• BlackBerry WebWorks Development Guides
• BlackBerry WebWorks Community Forums
• BlackBerry Open Source WebWorks Contributions Forums

Please see the README of the BB10-WebWorks-Samples repository for instructions on how to add new Samples or make modifications to existing Samples.

If you find a bug in a Sample, or have an enhancement request, simply file an Issue for the Sample.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.