Revision as of 15:30, 2 May 2008 by Forum Nokia KB (Talk | contribs)

Archived:Listbox for Symbian Web Runtime

From Nokia Developer Wiki
Jump to: navigation, search


ID CS000941 Creation date May 2, 2008
Platform S60 3rd Edition, FP2 Tested on devices  
Category S60 Web Runtime Subcategory  
APIs   Classes  


This example Javascript code is intended for re-use and incorporation into larger projects.


ListBox is a graphical user interface library, written in JavaScript language and designed for the S60 Web Runtime platform. The library can be used mainly in Web widgets for S60 to display text information on a list view.

ListBox is controlled by the “keypress” event of the five-way navigation key (on S60 devices). Therefore, it requires the browsing mode of a widget to be set to “tabbed” mode (vs. “cursor” mode). ListBox, however, does not enforce this requirement automatically. Widgets which use the library will need to set the browsing mode accordingly. This gives the widgets a chance to mixed-use ListBox and other UI components that may require the “cursor” mode.

List view demo.jpg

Public methods

 Constructor ListBox (Element [div] viewElement,
                      Integer maxVisibleLen,
                      Boolean sort)
 Void activateListBox ()
 Void deactivateListBox ()
 Void releaseResources ()
 Void setMaxVisible (Integer maxVisibleLen)
 Void setDisplayStyle (String unselectedStyle, String selectedStyle)
 String getSelectedItem ()
 Void addItem (String item)
 Void createList (Array newItems)
 Void removeItem ()
 Void filter (String argument)
 Callback function onRightNaviKeyPress()
 Callback function onLeftNaviKeyPress()
 Callback function onCenterNaviKeyPress ()
 Callback function onItemSelected ()

Example application


85 page views in the last 30 days.