×
Namespaces

Variants
Actions
Revision as of 06:36, 5 July 2012 by hamishwillee (Talk | contribs)

Dropdown

From Nokia Developer Wiki
Jump to: navigation, search


Inheritance

Nokia.DropDown
|- Nokia.Widget
|- Nokia.Class (basic class)

1 - Description

The Drop Down component behaves similarly to the Options Menu component.

2 - Visual Design

Dropdown01.png

3 - Component Dependencies

3.1 CSS

<!-- Themeroller CSS -->
<link rel="stylesheet" href="themes/themeroller/<theme>/Themeroller.css" type="text/css" media="screen">
<!-- Specific Theme/Resolution CSS -->
<link rel="stylesheet" href="/themes/nokia/ext-theme/<theme>/<resolution>/custom.css" type="text/css" media="screen">

3.2 Javascript

<!-- jQuery file -->
<script src="/lib/jquery/jQuery.js" type="text/javascript" charset="utf-8"></script>
<!-- Guarana file -->
<script src="/lib/Guarana.js" type="text/javascript" charset="utf-8"></script>

4 - Functional Specifications/Requirements

4.1 - Options

  • element: 'selector'
    • jQuery selector or the DOM reference to become the container of the component.
  • items[]: string
    • Defines the list of component items.
  • maximize: boolean
    • Defines whether the component is created as maximised.

4.2 - Events - Callbacks

  • create: function()
    • Scope: [this.element]

4.3 - Methods

  • showOptions: function()
    • Shows the component options.
    • return [void]
  • hideOptions: function()
    • Hides the component options.
    • return [void]
  • select: function(i, event)
    • Selects specific item i in the component.
    • return [void]
  • getSelected: function()
    • Returns the selected item in the component.
    • return [Object]


4.4 - Default options

  • maximize: false


5 - Component Demo

5.1 HTML

<div id="dropdown"></div>

5.2 Javascript

window.dropdown = new Nokia.DropDown({
     element: '#dropdown',
     items: [
          {
               label: "First option",
               value: 'some value',
               select: function(item, event) {
                    alert('Drop Down Clicked on: ' + item.label);
               }
          },
          {
               label: "Second option",
               value: 'some value',
               select: function(item, event) {
                    alert('Drop Down Clicked on: ' + item.label);
               }
          },
          {
               label: "Third option",
               value: 'some value',
               select: function(item, event) {
                    alert('Drop Down Clicked on: ' + item.label);
               }
          },
     ]
});

6 - Nokia WRT Browser Compatibility:

 

▴   S60 3.1 S60 3.2 S60 5.0
DropDown NO YES  YES 

 

62 page views in the last 30 days.

Was this page helpful?

Your feedback about this content is important. Let us know what you think.

 

Thank you!

We appreciate your feedback.

×