MDN may have intermittent access issues April 18 13:00 - April 19 01:00 UTC. See whistlepig.mozilla.org for all notifications.

mozilla
Your Search Results

    show

    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

    NativeWindow.toast.show() displays a toast notification 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.

    Syntax

    NativeWindow.toast.show(message, duration);

    message
    The message displayed by the toast.
    duration

    How long the toast should appear before fading away. This can take one of two values, short or long.

    options
    A set of options for the toast. See the "Supported options" section below

    Supported options

    button

    Attribute Description
    label The label for the button. This text won't be formatted like a link. Keep it a short single word to make it feel clickable.
    icon An icon for the button. This can be a base64 encded url, a chrome/resource url, or a drawable url.
    callback A callback that is called when you tap the icon. The function isn't passed any arguments.

    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", {
        button: {
          label: "Undo",
          icon: "drawable://alert_app",
          callback: function() {
            Services.prompts.alert("You clicked the button");
          }
        }
      });
    }
    
    function addMenuItem(window) {
      menuID = window.NativeWindow.menu.add("Show Toast", null, function() {
        showToast(window);   
      });
    }
    
    function removeMenuItem(window) {
      window.NativeWindow.menu.remove(menuID);
    }
    

    See Also

    Document Tags and Contributors

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