Displays a sliding notification window.
The following arguments will be passed to the alertListener’s observe()
method:
subject - null
topic - “alertfinished” when the alert goes away
“alertclickcallback” when the text is clicked
“alertshow” when the alert is shown
data - the value of the cookie parameter passed to showAlertNotification.
@note Depending on current circumstances (if the user’s in a fullscreen
application, for instance), the alert might not be displayed at all.
In that case, if an alert listener is passed in it will receive the
“alertfinished” notification immediately.
| imageUrl | A URL identifying the image to put in the alert. The OS X implemenation limits the amount of time it will wait for an icon to load to six seconds. After that time the alert will show with no icon. |
| title | The title for the alert. |
| text | The contents of the alert. |
| textClickable | If true, causes the alert text to look like a link and notifies the listener when user attempts to click the alert text. |
| cookie | A blind cookie the alert will pass back to the consumer during the alert listener callbacks. |
| alertListener | Used for callbacks. May be null if the caller doesn't care about callbacks. |
| name | The name of the notification. This is currently only used on Android and OS X. On Android the name is hashed and used as a notification ID. Notifications will replace previous notifications with the same name. |
| dir | Bidi override for the title. Valid values are "auto", "ltr" or "rtl". Only available on supported platforms. |
| lang | Language of title and text of the alert. Only available on supported platforms. @throws NS_ERROR_NOT_AVAILABLE If the notification cannot be displayed. |
Close alerts created by the service.
| name | The name of the notification to close. If no name is provided then only a notification created with no name (if any) will be closed. |