XUL:Method:appendNotification

From MDC

« XUL Reference home

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

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.

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.