# all files / src/ Theme.js

64% Statements 16/25
66.67% Branches 4/6
50% Functions 3/6
64% Lines 16/25

    1
    2
    3
    4
    5
    6
    7
    8
    9
    10
    11
    12
    13
    14
    15
    16
    17
    18
    19
    20
    21
    22
    23
    24
    25
    26
    27
    28
    29
    30
    31
    32
    33
    34
    35
    36
    37
    38
    39
    40
    41
    42
    43
    44
    45
    46
    47
    48
    49
    50
    51
    52
    53
    54
    55
    56
    57
    58
    59
    60
    61
    62
    63
    64
    65
    66
    67
    68
    69
    70
    71
    72
    73
    74
    75
    76
    77
    78
    79
    80
    81
    82
    83
    84
    85
    86
    87
    88
    89
    90
    91
    92
    93
    94
    95
    96
    97

    1×
    4×
    4×

    1×

    1×
    455937×

    1×
    455937×

    455937×
    244728×

    455937×
    123552×

    455937×

    1×

    1×

    1×

     /**
     * Theme logic.
     *
     * @abstract
     * @class
     *
     * @constructor
     */
    OO.ui.Theme = function OoUiTheme() {
    	this.elementClassesQueue = [];
    	this.debouncedUpdateQueuedElementClasses = OO.ui.debounce( this.updateQueuedElementClasses );
    };

    /* Setup */

    OO.initClass( OO.ui.Theme );

    /* Methods */

    /**
     * Get a list of classes to be applied to a widget.
     *
     * The 'on' and 'off' lists combined MUST contain keys for all classes the theme adds or removes,
     * otherwise state transitions will not work properly.
     *
     * @param {OO.ui.Element} element Element for which to get classes
     * @return {Object.<string,string[]>} Categorized class names with `on` and `off` lists
     */
    OO.ui.Theme.prototype.getElementClasses = function () {
    	return { on: [], off: [] };
    };

    /**
     * Update CSS classes provided by the theme.
     *
     * For elements with theme logic hooks, this should be called any time there's a state change.
     *
     * @param {OO.ui.Element} element Element for which to update classes
     */
    OO.ui.Theme.prototype.updateElementClasses = function ( element ) {
    	var $elements = $( [] ),
    		classes = this.getElementClasses( element );

    	if ( element.$icon ) {
    		$elements = $elements.add( element.$icon );
    	}
    	if ( element.$indicator ) {
    		$elements = $elements.add( element.$indicator );
    	}

    	$elements
    		.removeClass( classes.off )
    		.addClass( classes.on );
    };

    /**
     * @private
     */
    OO.ui.Theme.prototype.updateQueuedElementClasses = function () {
    	var i;
    	for ( i = 0; i < this.elementClassesQueue.length; i++ ) {
    		this.updateElementClasses( this.elementClassesQueue[ i ] );
    	}
    	// Clear the queue
    	this.elementClassesQueue = [];
    };

    /**
     * Queue #updateElementClasses to be called for this element.
     *
     * @localdoc QUnit tests override this method to directly call #queueUpdateElementClasses,
     *   to make them synchronous.
     *
     * @param {OO.ui.Element} element Element for which to update classes
     */
    OO.ui.Theme.prototype.queueUpdateElementClasses = function ( element ) {
    	// Keep items in the queue unique. Use lastIndexOf to start checking from the end because that's
    	// the most common case (this method is often called repeatedly for the same element).
    	if ( this.elementClassesQueue.lastIndexOf( element ) !== -1 ) {
    		return;
    	}
    	this.elementClassesQueue.push( element );
    	this.debouncedUpdateQueuedElementClasses();
    };

    /**
     * Get the transition duration in milliseconds for dialogs opening/closing
     *
     * The dialog should be fully rendered this many milliseconds after the
     * ready process has executed.
     *
     * @return {number} Transition duration in milliseconds
     */
    OO.ui.Theme.prototype.getDialogTransitionDuration = function () {
    	return 0;
    };