×
Namespaces

Variants
Actions

Dropdown

From Nokia Developer Wiki
Jump to: navigation, search
Article Metadata
Article
Created: User:Kbwiki (09 Nov 2009)
Last edited: hamishwillee (30 Jul 2012)

Contents

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 

 

This page was last modified on 30 July 2012, at 10:36.
56 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.

×