appendNotification( label , value , image , priority , buttons, eventCallback )

Return type: element

Create a new notification and display it. If another notification is already present with a higher priority, the new notification will be added behind it.

• label - label to appear on the notification
• value - value used to identify the notification
• image - URL of image to appear on the notification
• priority - notification priority, see Priority Levels.
• buttons - array of button descriptions to appear on the notification.
• eventCallback Optional Requires Gecko 9.0 - a JavaScript function to call to notify you of interesting things that happen with the notification box. See Notification box events.

Priority Levels :

• PRIORITY_INFO_LOW
• PRIORITY_INFO_MEDIUM
• PRIORITY_INFO_HIGH
• PRIORITY_WARNING_LOW
• PRIORITY_WARNING_MEDIUM
• PRIORITY_WARNING_HIGH
• PRIORITY_CRITICAL_LOW
• PRIORITY_CRITICAL_MEDIUM
• PRIORITY_CRITICAL_HIGH
• PRIORITY_CRITICAL_BLOCK

Buttons :

The buttons argument is an array of button descriptions. Each description is an object with the following properties:

• accessKey - the accesskey to appear on the button
• callback - function to be called when the button is activated. This function is passed two arguments:
  • the <notification> the button is associated with
  • the button description as passed to appendNotification.
• label - the label to appear on the button
• popup - the id of a popup for the button. If null, the button is a button popup.

If you specify the eventCallback parameter, it should be a JavaScript function that gets called when interesting things happen related to the notification box. This function receives as its only parameter a string indicating what event occurred. At this time, there's just one event type: "removed". This indicates that the notification box has been removed from its window.