Please note that as of October 24, 2014, the Nokia Developer Wiki will no longer be accepting user contributions, including new entries, edits and comments, as we begin transitioning to our new home, in the Windows Phone Development Wiki. We plan to move over the majority of the existing entries. Thanks for all your past and future contributions.

Symbian Belle UX changes impact on WRT widget toolbar

From Wiki
Jump to: navigation, search
Article Metadata
Nokia Belle
Created: isalento (23 Sep 2011)
Last edited: hamishwillee (12 Aug 2012)

This article explains what is the Nokia Belle UX change impact on Symbian Web Runtime widget toolbar.

One of the most visible changes in Nokia Belle UX is a new toolbar. In the new toolbar Options and Exit soft keys are reversed and icons are used instead of text labels. See details here: Symbian Design Guidelines

This change has some impact on on how the WRT Menu API works, but the changes do maintain compatibility of existing WRT code.

Reversed soft keys

Platform takes care of reversing soft keys.Please note that WRT menu API function names have not been updated, thus from Belle onwards, API calls to manipulate left soft key impact the right soft key and vice versa.

  • setRightSofkeyLabel is automatically mapped to left soft key on Nokia Belle device (Back button)
  • setLeftSoftkeyLabel is automatically mapped to right soft key on Nokia Belle device (Menu button)

Soft key Labels

Soft key text labels are no longer supported on Nokia Belle. setRightSoftkeyLabel and setLeftSoftkeyLabel can still be used to customize the operation attached to right or left soft key. The icons shown in toolbar cannot be changed in WRT apps.

Custom push button support

Adding custom push buttons to e.g. center of the toolbar is not supported in WRT apps. If you want to have a menu with custom push buttons between back and menu, you must implement your own custom menu using HTML, CSS and JavaScript.

This page was last modified on 12 August 2012, at 23:42.
21 page views in the last 30 days.