See09/WRTKit/UI/Label.js
author ivanl
Thu, 22 Oct 2009 15:52:58 +0100
changeset 19 f3521a11d878
permissions -rw-r--r--
See 09 widget, version 1.0rc3
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
19
f3521a11d878 See 09 widget, version 1.0rc3
ivanl
parents:
diff changeset
     1
/*
f3521a11d878 See 09 widget, version 1.0rc3
ivanl
parents:
diff changeset
     2
� Copyright 2008 Nokia Corporation. All rights reserved.
f3521a11d878 See 09 widget, version 1.0rc3
ivanl
parents:
diff changeset
     3
f3521a11d878 See 09 widget, version 1.0rc3
ivanl
parents:
diff changeset
     4
IMPORTANT:  The Nokia software ("WRTKit and Example Widget files") is supplied to you by Nokia
f3521a11d878 See 09 widget, version 1.0rc3
ivanl
parents:
diff changeset
     5
Corporation (�Nokia�) in consideration of your agreement to the following terms. Your use, installation
f3521a11d878 See 09 widget, version 1.0rc3
ivanl
parents:
diff changeset
     6
and/or redistribution of the WRTKit and Example Widget files constitutes acceptance of these terms. If
f3521a11d878 See 09 widget, version 1.0rc3
ivanl
parents:
diff changeset
     7
you do not agree with these terms, please do not use, install, or redistribute the WRTKit and Example
f3521a11d878 See 09 widget, version 1.0rc3
ivanl
parents:
diff changeset
     8
Widget files.
f3521a11d878 See 09 widget, version 1.0rc3
ivanl
parents:
diff changeset
     9
f3521a11d878 See 09 widget, version 1.0rc3
ivanl
parents:
diff changeset
    10
In consideration of your agreement to abide by the following terms, and subject to these terms, Nokia
f3521a11d878 See 09 widget, version 1.0rc3
ivanl
parents:
diff changeset
    11
grants you a personal, non-exclusive license, under Nokia�s copyrights in the WRTKit and Example
f3521a11d878 See 09 widget, version 1.0rc3
ivanl
parents:
diff changeset
    12
Widget files, to use, reproduce, and redistribute the WRTKit and Example files, in text form (for HTML,
f3521a11d878 See 09 widget, version 1.0rc3
ivanl
parents:
diff changeset
    13
CSS, or JavaScript files) or binary form (for associated images), for the sole purpose of creating S60
f3521a11d878 See 09 widget, version 1.0rc3
ivanl
parents:
diff changeset
    14
Widgets.
f3521a11d878 See 09 widget, version 1.0rc3
ivanl
parents:
diff changeset
    15
f3521a11d878 See 09 widget, version 1.0rc3
ivanl
parents:
diff changeset
    16
If you redistribute the WRTKit and Example files, you must retain this entire notice in all such
f3521a11d878 See 09 widget, version 1.0rc3
ivanl
parents:
diff changeset
    17
redistributions of the WRTKit and Example files.
f3521a11d878 See 09 widget, version 1.0rc3
ivanl
parents:
diff changeset
    18
f3521a11d878 See 09 widget, version 1.0rc3
ivanl
parents:
diff changeset
    19
You may not use the name, trademarks, service marks or logos of Nokia to endorse or promote products
f3521a11d878 See 09 widget, version 1.0rc3
ivanl
parents:
diff changeset
    20
that include the WRTKit and Example files without the prior written explicit agreement with Nokia.
f3521a11d878 See 09 widget, version 1.0rc3
ivanl
parents:
diff changeset
    21
Except as expressly stated in this notice, no other rights or licenses, express or implied, are granted by
f3521a11d878 See 09 widget, version 1.0rc3
ivanl
parents:
diff changeset
    22
Nokia herein, including but not limited to any patent rights that may be infringed by your products that
f3521a11d878 See 09 widget, version 1.0rc3
ivanl
parents:
diff changeset
    23
incorporate the WRTKit and Example files or by other works in which the WRTKit and Example files
f3521a11d878 See 09 widget, version 1.0rc3
ivanl
parents:
diff changeset
    24
may be incorporated.
f3521a11d878 See 09 widget, version 1.0rc3
ivanl
parents:
diff changeset
    25
f3521a11d878 See 09 widget, version 1.0rc3
ivanl
parents:
diff changeset
    26
The WRTKit and Example files are provided on an "AS IS" basis.  NOKIA MAKES NO
f3521a11d878 See 09 widget, version 1.0rc3
ivanl
parents:
diff changeset
    27
WARRANTIES, EXPRESS OR IMPLIED, INCLUDING WITHOUT LIMITATION THE IMPLIED
f3521a11d878 See 09 widget, version 1.0rc3
ivanl
parents:
diff changeset
    28
WARRANTIES OF NON-INFRINGEMENT, MERCHANTABILITY AND FITNESS FOR A
f3521a11d878 See 09 widget, version 1.0rc3
ivanl
parents:
diff changeset
    29
PARTICULAR PURPOSE, REGARDING THE EXAMPLES OR ITS USE AND OPERATION
f3521a11d878 See 09 widget, version 1.0rc3
ivanl
parents:
diff changeset
    30
ALONE OR IN COMBINATION WITH YOUR PRODUCTS.
f3521a11d878 See 09 widget, version 1.0rc3
ivanl
parents:
diff changeset
    31
f3521a11d878 See 09 widget, version 1.0rc3
ivanl
parents:
diff changeset
    32
IN NO EVENT SHALL NOKIA BE LIABLE FOR ANY SPECIAL, INDIRECT, INCIDENTAL OR
f3521a11d878 See 09 widget, version 1.0rc3
ivanl
parents:
diff changeset
    33
CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
f3521a11d878 See 09 widget, version 1.0rc3
ivanl
parents:
diff changeset
    34
SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
f3521a11d878 See 09 widget, version 1.0rc3
ivanl
parents:
diff changeset
    35
INTERRUPTION) ARISING IN ANY WAY OUT OF THE USE, REPRODUCTION, AND/OR
f3521a11d878 See 09 widget, version 1.0rc3
ivanl
parents:
diff changeset
    36
DISTRIBUTION OF THE EXAMPLES, HOWEVER CAUSED AND WHETHER UNDER THEORY
f3521a11d878 See 09 widget, version 1.0rc3
ivanl
parents:
diff changeset
    37
OF CONTRACT, TORT (INCLUDING NEGLIGENCE), STRICT LIABILITY OR OTHERWISE,
f3521a11d878 See 09 widget, version 1.0rc3
ivanl
parents:
diff changeset
    38
EVEN IF NOKIA HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
f3521a11d878 See 09 widget, version 1.0rc3
ivanl
parents:
diff changeset
    39
f3521a11d878 See 09 widget, version 1.0rc3
ivanl
parents:
diff changeset
    40
*/
f3521a11d878 See 09 widget, version 1.0rc3
ivanl
parents:
diff changeset
    41
f3521a11d878 See 09 widget, version 1.0rc3
ivanl
parents:
diff changeset
    42
///////////////////////////////////////////////////////////////////////////////
f3521a11d878 See 09 widget, version 1.0rc3
ivanl
parents:
diff changeset
    43
// The Label class implements a control that displays textual content.
f3521a11d878 See 09 widget, version 1.0rc3
ivanl
parents:
diff changeset
    44
f3521a11d878 See 09 widget, version 1.0rc3
ivanl
parents:
diff changeset
    45
// Constructor.
f3521a11d878 See 09 widget, version 1.0rc3
ivanl
parents:
diff changeset
    46
function Label(id, caption, text) {
f3521a11d878 See 09 widget, version 1.0rc3
ivanl
parents:
diff changeset
    47
    if (id != UI_NO_INIT_ID) {
f3521a11d878 See 09 widget, version 1.0rc3
ivanl
parents:
diff changeset
    48
        this.init(id, caption, text);
f3521a11d878 See 09 widget, version 1.0rc3
ivanl
parents:
diff changeset
    49
    }
f3521a11d878 See 09 widget, version 1.0rc3
ivanl
parents:
diff changeset
    50
}
f3521a11d878 See 09 widget, version 1.0rc3
ivanl
parents:
diff changeset
    51
f3521a11d878 See 09 widget, version 1.0rc3
ivanl
parents:
diff changeset
    52
// Label inherits from Control.
f3521a11d878 See 09 widget, version 1.0rc3
ivanl
parents:
diff changeset
    53
Label.prototype = new Control(UI_NO_INIT_ID);
f3521a11d878 See 09 widget, version 1.0rc3
ivanl
parents:
diff changeset
    54
f3521a11d878 See 09 widget, version 1.0rc3
ivanl
parents:
diff changeset
    55
// Content element for label text.
f3521a11d878 See 09 widget, version 1.0rc3
ivanl
parents:
diff changeset
    56
Label.prototype.contentElement = null;
f3521a11d878 See 09 widget, version 1.0rc3
ivanl
parents:
diff changeset
    57
f3521a11d878 See 09 widget, version 1.0rc3
ivanl
parents:
diff changeset
    58
// Initializer - called from constructor.
f3521a11d878 See 09 widget, version 1.0rc3
ivanl
parents:
diff changeset
    59
Label.prototype.init = function(id, caption, text) {
f3521a11d878 See 09 widget, version 1.0rc3
ivanl
parents:
diff changeset
    60
    uiLogger.debug("Label.init(" + id + ", " + caption + ", " + text + ")");
f3521a11d878 See 09 widget, version 1.0rc3
ivanl
parents:
diff changeset
    61
    
f3521a11d878 See 09 widget, version 1.0rc3
ivanl
parents:
diff changeset
    62
    // call superclass initializer
f3521a11d878 See 09 widget, version 1.0rc3
ivanl
parents:
diff changeset
    63
    Control.prototype.init.call(this, id, caption);
f3521a11d878 See 09 widget, version 1.0rc3
ivanl
parents:
diff changeset
    64
    
f3521a11d878 See 09 widget, version 1.0rc3
ivanl
parents:
diff changeset
    65
    // create content element
f3521a11d878 See 09 widget, version 1.0rc3
ivanl
parents:
diff changeset
    66
    this.contentElement = document.createElement("div");
f3521a11d878 See 09 widget, version 1.0rc3
ivanl
parents:
diff changeset
    67
    this.controlElement.appendChild(this.contentElement);
f3521a11d878 See 09 widget, version 1.0rc3
ivanl
parents:
diff changeset
    68
    
f3521a11d878 See 09 widget, version 1.0rc3
ivanl
parents:
diff changeset
    69
    // set the text
f3521a11d878 See 09 widget, version 1.0rc3
ivanl
parents:
diff changeset
    70
    this.setText(text);
f3521a11d878 See 09 widget, version 1.0rc3
ivanl
parents:
diff changeset
    71
}
f3521a11d878 See 09 widget, version 1.0rc3
ivanl
parents:
diff changeset
    72
f3521a11d878 See 09 widget, version 1.0rc3
ivanl
parents:
diff changeset
    73
// Returns the enabled state for the control.
f3521a11d878 See 09 widget, version 1.0rc3
ivanl
parents:
diff changeset
    74
Label.prototype.isEnabled = function() {
f3521a11d878 See 09 widget, version 1.0rc3
ivanl
parents:
diff changeset
    75
    return true;
f3521a11d878 See 09 widget, version 1.0rc3
ivanl
parents:
diff changeset
    76
}
f3521a11d878 See 09 widget, version 1.0rc3
ivanl
parents:
diff changeset
    77
f3521a11d878 See 09 widget, version 1.0rc3
ivanl
parents:
diff changeset
    78
// Returns the focusable state for the control.
f3521a11d878 See 09 widget, version 1.0rc3
ivanl
parents:
diff changeset
    79
Label.prototype.isFocusable = function() {
f3521a11d878 See 09 widget, version 1.0rc3
ivanl
parents:
diff changeset
    80
    return false;
f3521a11d878 See 09 widget, version 1.0rc3
ivanl
parents:
diff changeset
    81
}
f3521a11d878 See 09 widget, version 1.0rc3
ivanl
parents:
diff changeset
    82
f3521a11d878 See 09 widget, version 1.0rc3
ivanl
parents:
diff changeset
    83
// Returns the control text.
f3521a11d878 See 09 widget, version 1.0rc3
ivanl
parents:
diff changeset
    84
Label.prototype.getText = function() {
f3521a11d878 See 09 widget, version 1.0rc3
ivanl
parents:
diff changeset
    85
    return this.contentElement.innerHTML;
f3521a11d878 See 09 widget, version 1.0rc3
ivanl
parents:
diff changeset
    86
}
f3521a11d878 See 09 widget, version 1.0rc3
ivanl
parents:
diff changeset
    87
f3521a11d878 See 09 widget, version 1.0rc3
ivanl
parents:
diff changeset
    88
// Sets the text for the control.
f3521a11d878 See 09 widget, version 1.0rc3
ivanl
parents:
diff changeset
    89
Label.prototype.setText = function(text) {
f3521a11d878 See 09 widget, version 1.0rc3
ivanl
parents:
diff changeset
    90
    uiLogger.debug("Label.setText(" + text + ")");
f3521a11d878 See 09 widget, version 1.0rc3
ivanl
parents:
diff changeset
    91
    this.contentElement.innerHTML = (text == null) ? "" : text;
f3521a11d878 See 09 widget, version 1.0rc3
ivanl
parents:
diff changeset
    92
    this.updateStyleFromState();
f3521a11d878 See 09 widget, version 1.0rc3
ivanl
parents:
diff changeset
    93
}
f3521a11d878 See 09 widget, version 1.0rc3
ivanl
parents:
diff changeset
    94
f3521a11d878 See 09 widget, version 1.0rc3
ivanl
parents:
diff changeset
    95
// Updates the style of the control to reflects the state of the control.
f3521a11d878 See 09 widget, version 1.0rc3
ivanl
parents:
diff changeset
    96
Label.prototype.updateStyleFromState = function() {
f3521a11d878 See 09 widget, version 1.0rc3
ivanl
parents:
diff changeset
    97
    uiLogger.debug("Label.updateStyleFromState()");
f3521a11d878 See 09 widget, version 1.0rc3
ivanl
parents:
diff changeset
    98
    
f3521a11d878 See 09 widget, version 1.0rc3
ivanl
parents:
diff changeset
    99
    // set element class names
f3521a11d878 See 09 widget, version 1.0rc3
ivanl
parents:
diff changeset
   100
    this.setClassName(this.rootElement, "Control");
f3521a11d878 See 09 widget, version 1.0rc3
ivanl
parents:
diff changeset
   101
    this.setClassName(this.assemblyElement, "ControlAssembly ControlAssemblyNormal");
f3521a11d878 See 09 widget, version 1.0rc3
ivanl
parents:
diff changeset
   102
    this.setClassName(this.captionElement, "ControlCaption ControlCaptionNormal");
f3521a11d878 See 09 widget, version 1.0rc3
ivanl
parents:
diff changeset
   103
    this.setClassName(this.controlElement, "ControlElement");
f3521a11d878 See 09 widget, version 1.0rc3
ivanl
parents:
diff changeset
   104
    this.setClassName(this.contentElement, "LabelText");
f3521a11d878 See 09 widget, version 1.0rc3
ivanl
parents:
diff changeset
   105
}