toast

The NativeWindow object is only available to privileged code running on Firefox for Android, and is intended for use by Firefox for Android add-ons.

NativeWindow.toast will be deprecated in Firefox 45.

New code should use Snackbars.jsm to display notifications. To maintain backward compatibility NativeWindow.toast will still work, by delegating calls to Snackbars.jsm.

Summary

Returns a reference to the NativeWindow.toast object, which can be used to display toast notifications on Firefox for Android.

A toast notification is a message that appears on the screen for a set interval and then fades away. It does not accept user input.

You can display a toast using NativeWindow.toast.show(), supplying:

  • the message to display
  • a duration parameter that controls how long the toast should be displayed. This takes one of two values: short or long.

Example

In the example below, an add-on adds a menu item that displays a toast:

function showToast(window) {  
  window.NativeWindow.toast.show("Showing you a toast", "short");  
}  
      
var menuID;  
      
function addMenuItem(window) {  
  menuID = window.NativeWindow.menu.add("Show Toast", null, function(){  
    showToast(window);   
  });  
}

Methods

show
Show a toast notification.

See also

Document Tags and Contributors

 Contributors to this page: wbamberg, dkocho4, alex_johnson, justinpotts
 Last updated by: wbamberg,