toast

by 2 contributors:

This article is in need of a technical review.

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.

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:NativeWindow-toast.png

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);   
  });  
}  
      
function removeMenuItem(window) {  
  window.NativeWindow.menu.remove(menuID);  
}

Methods

show
Show a toast notification.

See also

Document Tags and Contributors

Contributors to this page: wbamberg, justinpotts
Last updated by: wbamberg,
Hide Sidebar