SharePoint 2010 Status Bar and Notification elementsExcuse the really bad screen capture to the right...The Status Bar and Notifications are two UI elements in SharePoint 2010 which allow us to give the user information in context without distracting them. The Status Bar and Notifications are both exposed as client-side JavaScript APIs.

Status Bar

The Status Bar lives below the Ribbon and displays persistent information such as page status or website alerts. It already existed in MOSS 2007 as a UI element but it's functionality was not exposed as an API. It will display an HTML message, which can include links and/or images, on one of four pre-set background colours depending on the importance of the status defined.

There is a Server API to set statuses at page render time as well as a JavaScript API to dynamically add/remove messages. The JavaScript API is in the SP.UI.Status namespace and is as follows:

SP.UI.Status.addStatus(strTitle, strHtml, atBeginning)
SP.UI.Status.updateStatus(sid, strHtml)
SP.UI.Status.setStatusPriColor(sid, strColor)


Notifications are brand new to SharePoint 2010 and they are used for transient or semi-transient messages such as action confirmations. Notifications appear on the right side of the page below the ribbon and default to a five second display period. Like the Status Bar, the message format is HTML with the ability to include links and/or images.

There is a JavaScript API to add/remove messages. You also have the option to make a Notification "sticky" which means it will continue to display until you manually remove it through the API.

Notifications are in the SP.UI.Notify namespace:

SP.UI.Notify.addNotification(strTitle, bSticky, tooltip, onclickHandler)