source: trunk/js/Msg.js @ 617

/*
* The Strangecode Codebase - a general application development framework for PHP
* For details visit the project site: <http://trac.strangecode.com/codebase/>
* Copyright © 2014 Strangecode, LLC
*
* This program is free software: you can redistribute it and/or modify
* it under the terms of the GNU General Public License as published by
* the Free Software Foundation, either version 3 of the License, or
* (at your option) any later version.
*
* This program is distributed in the hope that it will be useful,
* but WITHOUT ANY WARRANTY; without even the implied warranty of
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
* GNU General Public License for more details.
*
* You should have received a copy of the GNU General Public License
* along with this program.  If not, see <http://www.gnu.org/licenses/>.
*/

// Codebase functions will be under the Strangecode namespace, unless they are added to the jQuery object for chaining.
var Strangecode = Strangecode || {};

/*
* Class for managing user messages. This is the constructor function.
*
* @access   public
* @param    object containing object options:
{
    container: '#sc-msg-formvalidator',
    above_msg: 'Oops!'
}
* @author   Quinn Comendant <quinn@strangecode.com>
* @version  1.0
* @since    18 Mar 2014 23:24:15
*
* Example of use:
---------------------------------------------------------------------
var sc_msg = new Strangecode.Msg({
    container: '#sc-msg-formvalidator',
    above_msg: 'The following errors occurred:'
});
sc_msg.raise('Oops, you fuxt up!', 'sc-msg-error');
sc_msg.clear();
sc_msg.raise('Ok, now you’re cool.', 'sc-msg-success');
---------------------------------------------------------------------
*/
Strangecode.Msg = function (options) {
    // Merge options with defaults
    var options = this.o = $.extend({
        container: '.sc-msg:last',
        above_msg: '',
        gotohash: true
    }, options || {});

    document.addEventListener('DOMContentLoaded', function (e) {
        // Warn if the target doesn't exist.
        if (!$(options.container).length) {
            console.warn('Strangecode.Msg container not found: ' + this.o.container);
        }
    });
};

/*
* Raises a message to the user.
*
* @access   public
* @param    string message  The message to display.
* @param    string class    The class to apply to the message div (when using codebase CSS, it is useful to use one of: sc-msg-success, sc-msg-notice, sc-msg-warning, sc-msg-error)
* @author   Quinn Comendant <quinn@strangecode.com>
* @version  1.0
* @since    18 Mar 2014 23:24:15
*/
Strangecode.Msg.prototype.raise = function (message, msg_class) {
    // If an "above msg" is provided, and one doesn't already exist, add it to the message box.
    if (this.o.above_msg.length && !$(this.o.container).find('.sc-above').length) {
        $(this.o.container).append($('<div class="sc-js-msg sc-above"></div>').text(this.o.above_msg));
    }
    // Use 'sc-msg-error' as default class string.
    var msg_class = (typeof msg_class === 'undefined') ? 'sc-msg-error' : msg_class;
    // Append this raised message to the sc-msg stack, if it doesn't exist already.
    if (!$(this.o.container).find(':contains("' + message + '")').length) {
        $(this.o.container).append($('<div data-alert class="alert-box sc-js-msg ' + msg_class + '"></div>').hide().html(message).append('<a href="#" class="close">×</a>'));
        $('.sc-js-msg').slideDown('fast');
        if ($.fn.foundation) {
            $(document).foundation('reflow');
        }
    }

    if (this.o.gotohash) {
        $(document.body).animate({
            'scrollTop': $(this.o.container).offset().top
        }, 'fast');
    }
};

/*
* Removes all previously raised messages. By default, only messages raised by this JS class
* are cleared (matching class="sc-js-msg"), but you can clear *all* messages by assigning a more general
* class (e.g., "sc-msg-error").
*
* @access   public
* @param    string message  The message to display.
* @param    string class    Remove message divs matching this class (default: sc-js-msg; or use one of: sc-msg-success, sc-msg-notice, sc-msg-warning, sc-msg-error)
* @author   Quinn Comendant <quinn@strangecode.com>
* @version  1.1
* @since    18 Mar 2014 23:24:15
*/
Strangecode.Msg.prototype.clear = function (msg_class) {
    var msg_class = (typeof msg_class === 'undefined') ? 'sc-js-msg' : msg_class;
    $(this.o.container).find('.' + msg_class).remove();
};