Latest revision as of 07:12, 28 September 2012

Archived: This article is archived because it is not considered relevant for third-party developers creating commercial solutions today. If you think this article is still relevant, let us know by adding the template {{ReviewForRemovalFromArchive|user=~~~~|write your reason here}}.

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

Overview

GridBox 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 images, icons, or even text information on a grid view.

GridBox 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). GridBox, however, does not enforce this requirement automatically. Widgets using the library, need to set the browsing mode accordingly. This gives the widgets a chance to mixed-use GridBox and other UI components that may require the “cursor” mode.

Public methods

The following public methods are used in this library. For detailed descriptions of the methods, see the Gridbox_Library_Ref.pdf included in the example application.

  Constructor GridBox (Element [div] viewElement,
                         Integer maxRow,
                         Integer maxCol, 
                         Integer maxHeight, 
                         Integer maxWidth, 
                         Boolean searchEnabled,
                         String mode)
 
  Void activateGridBox ()
 
  Void deactivateGridBox ()
 
  Void releaseResources ()
 
  Element [text input] getSearchElement ()
 
  Void setResourceLocation (String path)
 
  Void setSize (Integer maxRow, Integer maxCol, Integer maxHeight, Integer maxWidth)
 
  Void setDisplayStyle (String unselectedStyle, String selectedStyle)
 
  String getSelectedItem ()
 
  Void addItem (String item)
 
  Void createList (Array newItems)
 
  Void removeItem ()
 
  Void filter (String argument)
 
  Callback function onCenterNaviKeyPress ()
 
  Callback function onItemSelected ()

Example application

File:Gridbox.zip