Palm webOS

Dashboards

You will usually create a dashboard panel following a banner notification posting as a reminder of the notification. Dashboards can also display ambient information or provide a dynamic window for background applications when you don’t need a full card stage. Although constrained by size and UI convention, dashboard summaries are fully functional stages, within which you can push scenes and employ any part of the Mojo API, though not all of the Mojo styles are available outside of card stages.

Note

The full framework CSS is not automatically loaded when creating pop-up or dashboard stages. Currently, some of the styles that you can use in a card stage or main application window are not available within noncard stages. This will be addressed in time, but for now you may have to copy some style properties and selectors to your application CSS from the framework CSS.

Dashboards are constrained windows that span the full screen width and about 10% of the screen height in portrait mode; on the Palm Prē, that’s 320 pixels wide and 48 pixels high. But just as with card windows, you should lay out your dashboard windows to handle different widths for landscape modes or different screen sizes on future Palm webOS devices.

Back to the News: Adding a Dashboard Stage

You can create a dashboard stage similar to the general stage example shown earlier in this chapter, but you will declare it as a dashboard stage type. We’ll add a dashboard stage to News in updateFeedSuccess() by following ...