src/js/widgets.js
author veltr
Thu, 19 Apr 2012 19:20:41 +0200
branchnew-model
changeset 872 d777d05a16e4
parent 870 2c025db10a10
child 874 38b65761a7d5
permissions -rw-r--r--
finished AnnotationsList and started New PolemicWidget
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
66
13013b9452af Added a new file to the build, widgets.js, to contain widget classes.
hamidouk
parents:
diff changeset
     1
/* the widget classes and definitions */
13013b9452af Added a new file to the build, widgets.js, to contain widget classes.
hamidouk
parents:
diff changeset
     2
520
fe008e95a716 added jsdoc support, and a script to generate the docs.
hamidouk
parents: 287
diff changeset
     3
/**
868
a525cc2214e7 Started big refactoring
veltr
parents: 866
diff changeset
     4
 * @class IriSP.Widget is an "abstract" class. It's mostly used to define some properties common to every widget.
a525cc2214e7 Started big refactoring
veltr
parents: 866
diff changeset
     5
 *
a525cc2214e7 Started big refactoring
veltr
parents: 866
diff changeset
     6
 *  Note that widget constructors are never called directly by the user. Instead, the widgets are instantiated by functions
a525cc2214e7 Started big refactoring
veltr
parents: 866
diff changeset
     7
 *  defined in init.js
a525cc2214e7 Started big refactoring
veltr
parents: 866
diff changeset
     8
 *
a525cc2214e7 Started big refactoring
veltr
parents: 866
diff changeset
     9
 * @constructor
a525cc2214e7 Started big refactoring
veltr
parents: 866
diff changeset
    10
 * @param player - a reference to the player widget
a525cc2214e7 Started big refactoring
veltr
parents: 866
diff changeset
    11
 * @param config - configuration options for the widget
a525cc2214e7 Started big refactoring
veltr
parents: 866
diff changeset
    12
 */
a525cc2214e7 Started big refactoring
veltr
parents: 866
diff changeset
    13
IriSP.Widget = function(player, config) {
287
5c7495102bd7 added a spacer div to simplify some graphic animations.
hamidouk
parents: 170
diff changeset
    14
868
a525cc2214e7 Started big refactoring
veltr
parents: 866
diff changeset
    15
    if( typeof player === "undefined") {
a525cc2214e7 Started big refactoring
veltr
parents: 866
diff changeset
    16
        /* Probably an abstract call of the class when
a525cc2214e7 Started big refactoring
veltr
parents: 866
diff changeset
    17
         * individual widgets set their prototype */
a525cc2214e7 Started big refactoring
veltr
parents: 866
diff changeset
    18
        return;
a525cc2214e7 Started big refactoring
veltr
parents: 866
diff changeset
    19
    }
a525cc2214e7 Started big refactoring
veltr
parents: 866
diff changeset
    20
    
a525cc2214e7 Started big refactoring
veltr
parents: 866
diff changeset
    21
    /* Setting all the configuration options */
a525cc2214e7 Started big refactoring
veltr
parents: 866
diff changeset
    22
    var _type = config.type,
870
2c025db10a10 Migrated playerWidget and started annotationsListWidget
veltr
parents: 868
diff changeset
    23
        _config = IriSP._.defaults({}, config, player.config.gui.default_options, IriSP.widgetsDefaults[_type]),
868
a525cc2214e7 Started big refactoring
veltr
parents: 866
diff changeset
    24
        _this = this;
a525cc2214e7 Started big refactoring
veltr
parents: 866
diff changeset
    25
    
a525cc2214e7 Started big refactoring
veltr
parents: 866
diff changeset
    26
    /* Creating containers if needed */
a525cc2214e7 Started big refactoring
veltr
parents: 866
diff changeset
    27
    if (typeof _config.container === "undefined") {
870
2c025db10a10 Migrated playerWidget and started annotationsListWidget
veltr
parents: 868
diff changeset
    28
        var _divs = player.layoutDivs(_type);
868
a525cc2214e7 Started big refactoring
veltr
parents: 866
diff changeset
    29
        _config.container = _divs[0];
a525cc2214e7 Started big refactoring
veltr
parents: 866
diff changeset
    30
        _config.spacer = _divs[1];
a525cc2214e7 Started big refactoring
veltr
parents: 866
diff changeset
    31
    }
a525cc2214e7 Started big refactoring
veltr
parents: 866
diff changeset
    32
    
a525cc2214e7 Started big refactoring
veltr
parents: 866
diff changeset
    33
    IriSP._(_config).forEach(function(_value, _key) {
a525cc2214e7 Started big refactoring
veltr
parents: 866
diff changeset
    34
       _this[_key] = _value;
a525cc2214e7 Started big refactoring
veltr
parents: 866
diff changeset
    35
    });
a525cc2214e7 Started big refactoring
veltr
parents: 866
diff changeset
    36
    
872
d777d05a16e4 finished AnnotationsList and started New PolemicWidget
veltr
parents: 870
diff changeset
    37
    if (typeof this.width === "undefined") {
d777d05a16e4 finished AnnotationsList and started New PolemicWidget
veltr
parents: 870
diff changeset
    38
        this.width = player.config.gui.width;
d777d05a16e4 finished AnnotationsList and started New PolemicWidget
veltr
parents: 870
diff changeset
    39
    }
d777d05a16e4 finished AnnotationsList and started New PolemicWidget
veltr
parents: 870
diff changeset
    40
    
868
a525cc2214e7 Started big refactoring
veltr
parents: 866
diff changeset
    41
    /* Setting this.player at the end in case it's been overriden
a525cc2214e7 Started big refactoring
veltr
parents: 866
diff changeset
    42
     * by a configuration option of the same name :-(
a525cc2214e7 Started big refactoring
veltr
parents: 866
diff changeset
    43
     */
a525cc2214e7 Started big refactoring
veltr
parents: 866
diff changeset
    44
    this.player = player;
a525cc2214e7 Started big refactoring
veltr
parents: 866
diff changeset
    45
    
a525cc2214e7 Started big refactoring
veltr
parents: 866
diff changeset
    46
    /* Getting metadata */
870
2c025db10a10 Migrated playerWidget and started annotationsListWidget
veltr
parents: 868
diff changeset
    47
    this.source = player.loadMetadata(this.metadata);
868
a525cc2214e7 Started big refactoring
veltr
parents: 866
diff changeset
    48
    
a525cc2214e7 Started big refactoring
veltr
parents: 866
diff changeset
    49
    /* Call draw when loaded */
a525cc2214e7 Started big refactoring
veltr
parents: 866
diff changeset
    50
    this.source.onLoad(function() {
a525cc2214e7 Started big refactoring
veltr
parents: 866
diff changeset
    51
        _this.draw();
870
2c025db10a10 Migrated playerWidget and started annotationsListWidget
veltr
parents: 868
diff changeset
    52
    });
868
a525cc2214e7 Started big refactoring
veltr
parents: 866
diff changeset
    53
   
a525cc2214e7 Started big refactoring
veltr
parents: 866
diff changeset
    54
    /* Adding classes and html attributes */
870
2c025db10a10 Migrated playerWidget and started annotationsListWidget
veltr
parents: 868
diff changeset
    55
    console.log(this.container);
2c025db10a10 Migrated playerWidget and started annotationsListWidget
veltr
parents: 868
diff changeset
    56
    this.$ = IriSP.jQuery('#' + this.container);
2c025db10a10 Migrated playerWidget and started annotationsListWidget
veltr
parents: 868
diff changeset
    57
    this.$.addClass("Ldt-TraceMe").addClass("Ldt-Widget").attr("widget-type", _type);
868
a525cc2214e7 Started big refactoring
veltr
parents: 866
diff changeset
    58
    
a525cc2214e7 Started big refactoring
veltr
parents: 866
diff changeset
    59
    /* Does the widget require other widgets ? */
a525cc2214e7 Started big refactoring
veltr
parents: 866
diff changeset
    60
    if (typeof this.requires !== "undefined") {
a525cc2214e7 Started big refactoring
veltr
parents: 866
diff changeset
    61
        for (var _i = 0; _i < this.requires.length; _i++) {
a525cc2214e7 Started big refactoring
veltr
parents: 866
diff changeset
    62
            var _subconfig = this.requires[_i],
a525cc2214e7 Started big refactoring
veltr
parents: 866
diff changeset
    63
                _div = IriSP.jQuery('<div>');
870
2c025db10a10 Migrated playerWidget and started annotationsListWidget
veltr
parents: 868
diff changeset
    64
            _subconfig.container = IriSP._.uniqueId(this.container + '_' + _subconfig.type + '_');
868
a525cc2214e7 Started big refactoring
veltr
parents: 866
diff changeset
    65
            _div.id = _subconfig.container;
870
2c025db10a10 Migrated playerWidget and started annotationsListWidget
veltr
parents: 868
diff changeset
    66
            this.$.append(_div);
2c025db10a10 Migrated playerWidget and started annotationsListWidget
veltr
parents: 868
diff changeset
    67
            this[_subconfig.type] = new IriSP.Widgets(player, _subconfig);
868
a525cc2214e7 Started big refactoring
veltr
parents: 866
diff changeset
    68
        }
a525cc2214e7 Started big refactoring
veltr
parents: 866
diff changeset
    69
    }
a525cc2214e7 Started big refactoring
veltr
parents: 866
diff changeset
    70
    
66
13013b9452af Added a new file to the build, widgets.js, to contain widget classes.
hamidouk
parents:
diff changeset
    71
};
74
d7a7d7216371 lots of changes to the player widget...
hamidouk
parents: 66
diff changeset
    72
870
2c025db10a10 Migrated playerWidget and started annotationsListWidget
veltr
parents: 868
diff changeset
    73
IriSP.Widget.prototype.functionWrapper = function(_name) {
2c025db10a10 Migrated playerWidget and started annotationsListWidget
veltr
parents: 868
diff changeset
    74
    var _this = this,
2c025db10a10 Migrated playerWidget and started annotationsListWidget
veltr
parents: 868
diff changeset
    75
        _function = this[_name];
2c025db10a10 Migrated playerWidget and started annotationsListWidget
veltr
parents: 868
diff changeset
    76
    if (typeof _function !== "undefined") {
2c025db10a10 Migrated playerWidget and started annotationsListWidget
veltr
parents: 868
diff changeset
    77
        return function() {
2c025db10a10 Migrated playerWidget and started annotationsListWidget
veltr
parents: 868
diff changeset
    78
            return _function.apply(_this, Array.prototype.slice.call(arguments, 0));
2c025db10a10 Migrated playerWidget and started annotationsListWidget
veltr
parents: 868
diff changeset
    79
        }
2c025db10a10 Migrated playerWidget and started annotationsListWidget
veltr
parents: 868
diff changeset
    80
    } else {
2c025db10a10 Migrated playerWidget and started annotationsListWidget
veltr
parents: 868
diff changeset
    81
        console.log("Error, Unknown function IriSP." + this.type + "." + _name)
2c025db10a10 Migrated playerWidget and started annotationsListWidget
veltr
parents: 868
diff changeset
    82
    }
2c025db10a10 Migrated playerWidget and started annotationsListWidget
veltr
parents: 868
diff changeset
    83
}
2c025db10a10 Migrated playerWidget and started annotationsListWidget
veltr
parents: 868
diff changeset
    84
2c025db10a10 Migrated playerWidget and started annotationsListWidget
veltr
parents: 868
diff changeset
    85
IriSP.Widget.prototype.bindPopcorn = function(_popcornEvent, _functionName) {
2c025db10a10 Migrated playerWidget and started annotationsListWidget
veltr
parents: 868
diff changeset
    86
    this.player.popcorn.listen(_popcornEvent, this.functionWrapper(_functionName))
2c025db10a10 Migrated playerWidget and started annotationsListWidget
veltr
parents: 868
diff changeset
    87
}
2c025db10a10 Migrated playerWidget and started annotationsListWidget
veltr
parents: 868
diff changeset
    88
520
fe008e95a716 added jsdoc support, and a script to generate the docs.
hamidouk
parents: 287
diff changeset
    89
/**
868
a525cc2214e7 Started big refactoring
veltr
parents: 866
diff changeset
    90
 * This method responsible of drawing a widget on screen.
a525cc2214e7 Started big refactoring
veltr
parents: 866
diff changeset
    91
 */
a525cc2214e7 Started big refactoring
veltr
parents: 866
diff changeset
    92
IriSP.Widget.prototype.draw = function() {
a525cc2214e7 Started big refactoring
veltr
parents: 866
diff changeset
    93
    /* implemented by "sub-classes" */
a525cc2214e7 Started big refactoring
veltr
parents: 866
diff changeset
    94
};
a525cc2214e7 Started big refactoring
veltr
parents: 866
diff changeset
    95
/**
a525cc2214e7 Started big refactoring
veltr
parents: 866
diff changeset
    96
 * Optional method if you want your widget to support redraws.
a525cc2214e7 Started big refactoring
veltr
parents: 866
diff changeset
    97
 */
74
d7a7d7216371 lots of changes to the player widget...
hamidouk
parents: 66
diff changeset
    98
IriSP.Widget.prototype.redraw = function() {
868
a525cc2214e7 Started big refactoring
veltr
parents: 866
diff changeset
    99
    /* implemented by "sub-classes" */
74
d7a7d7216371 lots of changes to the player widget...
hamidouk
parents: 66
diff changeset
   100
};