/* * Simplespmodal @VERSION - jQuery Plugin * http://simplespmodal.com/ * Copyright (c) 2013 Eric Martin * Licensed under MIT and GPL * Date: */ /** * Simplespmodal is a lightweight jQuery plugin that provides a simple * interface to create a spmodal dialog. * * The goal of Simplespmodal is to provide developers with a cross-browser * overlay and container that will be populated with data provided to * Simplespmodal. * * There are two ways to call Simplespmodal: * 1) As a chained function on a jQuery object, like $('#myDiv').spmodal();. * This call would place the DOM object, #myDiv, inside a spmodal dialog. * Chaining requires a jQuery object. An optional options object can be * passed as a parameter. * * @example $('
my data
').spmodal({options}); * @example $('#myDiv').spmodal({options}); * @example jQueryObject.spmodal({options}); * * 2) As a stand-alone function, like $.spmodal(data). The data parameter * is required and an optional options object can be passed as a second * parameter. This method provides more flexibility in the types of data * that are allowed. The data could be a DOM object, a jQuery object, HTML * or a string. * * @example $.spmodal('
my data
', {options}); * @example $.spmodal('my data', {options}); * @example $.spmodal($('#myDiv'), {options}); * @example $.spmodal(jQueryObject, {options}); * @example $.spmodal(document.getElementById('myDiv'), {options}); * * A Simplespmodal call can contain multiple elements, but only one spmodal * dialog can be created at a time. Which means that all of the matched * elements will be displayed within the spmodal container. * * Simplespmodal internally sets the CSS needed to display the spmodal dialog * properly in all browsers, yet provides the developer with the flexibility * to easily control the look and feel. The styling for Simplespmodal can be * done through external stylesheets, or through Simplespmodal, using the * overlayCss, containerCss, and dataCss options. * * Simplespmodal has been tested in the following browsers: * - IE 6+ * - Firefox 2+ * - Opera 9+ * - Safari 3+ * - Chrome 1+ * * @name Simplespmodal * @type jQuery * @requires jQuery v1.3 * @cat Plugins/Windows and Overlays * @author Eric Martin (http://ericmmartin.com) * @version @VERSION */ ;(function (factory) { if (typeof define === 'function' && define.amd) { // AMD. Register as an anonymous module. define(['jquery'], factory); } else { // Browser globals factory(jQuery); } } (function ($) { var d = [], doc = $(document), ua = navigator.userAgent.toLowerCase(), wndw = $(window), w = []; var browser = { ieQuirks: null, msie: /msie/.test(ua) && !/opera/.test(ua), opera: /opera/.test(ua) }; browser.ie6 = browser.msie && /msie 6./.test(ua) && typeof window['XMLHttpRequest'] !== 'object'; browser.ie7 = browser.msie && /msie 7.0/.test(ua); browser.boxModel = (document.compatMode === "CSS1Compat"); /* * Create and display a spmodal dialog. * * @param {string, object} data A string, jQuery object or DOM object * @param {object} [options] An optional object containing options overrides */ $.spmodal = function (data, options) { return $.spmodal.impl.init(data, options); }; /* * Close the spmodal dialog. */ $.spmodal.close = function () { $.spmodal.impl.close(); }; /* * Set focus on first or last visible input in the spmodal dialog. To focus on the last * element, call $.spmodal.focus('last'). If no input elements are found, focus is placed * on the data wrapper element. */ $.spmodal.focus = function (pos) { $.spmodal.impl.focus(pos); }; /* * Determine and set the dimensions of the spmodal dialog container. * setPosition() is called if the autoPosition option is true. */ $.spmodal.setContainerDimensions = function () { $.spmodal.impl.setContainerDimensions(); }; /* * Re-position the spmodal dialog. */ $.spmodal.setPosition = function () { $.spmodal.impl.setPosition(); }; /* * Update the spmodal dialog. If new dimensions are passed, they will be used to determine * the dimensions of the container. * * setContainerDimensions() is called, which in turn calls setPosition(), if enabled. * Lastly, focus() is called is the focus option is true. */ $.spmodal.update = function (height, width) { $.spmodal.impl.update(height, width); }; /* * Chained function to create a spmodal dialog. * * @param {object} [options] An optional object containing options overrides */ $.fn.spmodal = function (options) { return $.spmodal.impl.init(this, options); }; /* * Simplespmodal default options * * appendTo: (String:'body') The jQuery selector to append the elements to. For .NET, use 'form'. * focus: (Boolean:true) Focus in the first visible, enabled element? * opacity: (Number:50) The opacity value for the overlay div, from 0 - 100 * overlayId: (String:'simplespmodal-overlay') The DOM element id for the overlay div * overlayCss: (Object:{}) The CSS styling for the overlay div * containerId: (String:'simplespmodal-container') The DOM element id for the container div * containerCss: (Object:{}) The CSS styling for the container div * dataId: (String:'simplespmodal-data') The DOM element id for the data div * dataCss: (Object:{}) The CSS styling for the data div * minHeight: (Number:null) The minimum height for the container * minWidth: (Number:null) The minimum width for the container * maxHeight: (Number:null) The maximum height for the container. If not specified, the window height is used. * maxWidth: (Number:null) The maximum width for the container. If not specified, the window width is used. * autoResize: (Boolean:false) Automatically resize the container if it exceeds the browser window dimensions? * autoPosition: (Boolean:true) Automatically position the container upon creation and on window resize? * zIndex: (Number: 1000) Starting z-index value * close: (Boolean:true) If true, closeHTML, escClose and overClose will be used if set. If false, none of them will be used. * closeHTML: (String:'') The HTML for the default close link. Simplespmodal will automatically add the closeClass to this element. * closeClass: (String:'simplespmodal-close') The CSS class used to bind to the close event * escClose: (Boolean:true) Allow Esc keypress to close the dialog? * overlayClose: (Boolean:false) Allow click on overlay to close the dialog? * fixed: (Boolean:true) If true, the container will use a fixed position. If false, it will use a absolute position (the dialog will scroll with the page) * position: (Array:null) Position of container [top, left]. Can be number of pixels or percentage * persist: (Boolean:false) Persist the data across spmodal calls? Only used for existing DOM elements. If true, the data will be maintained across spmodal calls, if false, the data will be reverted to its original state. * spmodal: (Boolean:true) User will be unable to interact with the page below the spmodal or tab away from the dialog. If false, the overlay, iframe, and certain events will be disabled allowing the user to interact with the page below the dialog. * onOpen: (Function:null) The callback function used in place of Simplespmodal's open * onShow: (Function:null) The callback function used after the spmodal dialog has opened * onClose: (Function:null) The callback function used in place of Simplespmodal's close */ $.spmodal.defaults = { appendTo: 'body', focus: true, opacity: 50, overlayId: 'simplespmodal-overlay', overlayCss: {}, containerId: 'simplespmodal-container', containerCss: {}, dataId: 'simplespmodal-data', dataCss: {}, minHeight: null, minWidth: null, maxHeight: null, maxWidth: null, autoResize: false, autoPosition: true, zIndex: 1000, close: true, closeHTML: '', closeClass: 'simplespmodal-close', escClose: true, overlayClose: false, fixed: true, position: null, persist: false, spmodal: true, onOpen: null, onShow: null, onClose: null }; /* * Main spmodal object * o = options */ $.spmodal.impl = { /* * Contains the spmodal dialog elements and is the object passed * back to the callback (onOpen, onShow, onClose) functions */ d: {}, /* * Initialize the spmodal dialog */ init: function (data, options) { var s = this; // don't allow multiple calls if (s.d.data) { return false; } browser.ieQuirks = browser.msie && !browser.boxModel; // merge defaults and user options s.o = $.extend({}, $.spmodal.defaults, options); // keep track of z-index s.zIndex = s.o.zIndex; // set the onClose callback flag s.occb = false; // determine how to handle the data based on its type if (typeof data === 'object') { // convert DOM object to a jQuery object data = data instanceof $ ? data : $(data); s.d.placeholder = false; // if the object came from the DOM, keep track of its parent if (data.parent().parent().size() > 0) { data.before($('') .attr('id', 'simplespmodal-placeholder') .css({display: 'none'})); s.d.placeholder = true; s.display = data.css('display'); // persist changes? if not, make a clone of the element if (!s.o.persist) { s.d.orig = data.clone(true); } } } else if (typeof data === 'string' || typeof data === 'number') { // just insert the data as innerHTML data = $('
').html(data); } else { // unsupported data type! alert('Simplespmodal Error: Unsupported data type: ' + typeof data); return s; } // create the spmodal overlay, container and, if necessary, iframe s.create(data); data = null; // display the spmodal dialog s.open(); // useful for adding events/manipulating data in the spmodal dialog if ($.isFunction(s.o.onShow)) { s.o.onShow.apply(s, [s.d]); } // don't break the chain =) return s; }, /* * Create and add the spmodal overlay and container to the page */ create: function (data) { var s = this; // get the window properties s.getDimensions(); // add an iframe to prevent select options from bleeding through if (s.o.spmodal && browser.ie6) { s.d.iframe = $('') .css($.extend(s.o.iframeCss, { display: 'none', opacity: 0, position: 'fixed', height: w[0], width: w[1], zIndex: s.o.zIndex, top: 0, left: 0 })) .appendTo(s.o.appendTo); } // create the overlay s.d.overlay = $('
') .attr('id', s.o.overlayId) .addClass('simplespmodal-overlay') .css($.extend(s.o.overlayCss, { display: 'none', opacity: s.o.opacity / 100, height: s.o.spmodal ? d[0] : 0, width: s.o.spmodal ? d[1] : 0, position: 'fixed', left: 0, top: 0, zIndex: s.o.zIndex + 1 })) .appendTo(s.o.appendTo); // create the container s.d.container = $('
') .attr('id', s.o.containerId) .addClass('simplespmodal-container') .css($.extend( {position: s.o.fixed ? 'fixed' : 'absolute'}, s.o.containerCss, {display: 'none', zIndex: s.o.zIndex + 2} )) .append(s.o.close && s.o.closeHTML ? $(s.o.closeHTML).addClass(s.o.closeClass) : '') .appendTo(s.o.appendTo); s.d.wrap = $('
') .attr('tabIndex', -1) .addClass('simplespmodal-wrap') .css({height: '100%', outline: 0, width: '100%'}) .appendTo(s.d.container); // add styling and attributes to the data // append to body to get correct dimensions, then move to wrap s.d.data = data .attr('id', data.attr('id') || s.o.dataId) .addClass('simplespmodal-data') .css($.extend(s.o.dataCss, { display: 'none' })) .appendTo('body'); data = null; s.setContainerDimensions(); s.d.data.appendTo(s.d.wrap); // fix issues with IE if (browser.ie6 || browser.ieQuirks) { s.fixIE(); } }, /* * Bind events */ bindEvents: function () { var s = this; // bind the close event to any element with the closeClass class $('.' + s.o.closeClass).bind('click.simplespmodal', function (e) { e.preventDefault(); s.close(); }); // bind the overlay click to the close function, if enabled if (s.o.spmodal && s.o.close && s.o.overlayClose) { s.d.overlay.bind('click.simplespmodal', function (e) { e.preventDefault(); s.close(); }); } // bind keydown events doc.bind('keydown.simplespmodal', function (e) { if (s.o.spmodal && e.keyCode === 9) { // TAB s.watchTab(e); } else if ((s.o.close && s.o.escClose) && e.keyCode === 27) { // ESC e.preventDefault(); s.close(); } }); // update window size wndw.bind('resize.simplespmodal orientationchange.simplespmodal', function () { // redetermine the window width/height s.getDimensions(); // reposition the dialog s.o.autoResize ? s.setContainerDimensions() : s.o.autoPosition && s.setPosition(); if (browser.ie6 || browser.ieQuirks) { s.fixIE(); } else if (s.o.spmodal) { // update the iframe & overlay s.d.iframe && s.d.iframe.css({height: w[0], width: w[1]}); s.d.overlay.css({height: d[0], width: d[1]}); } }); }, /* * Unbind events */ unbindEvents: function () { $('.' + this.o.closeClass).unbind('click.simplespmodal'); doc.unbind('keydown.simplespmodal'); wndw.unbind('.simplespmodal'); this.d.overlay.unbind('click.simplespmodal'); }, /* * Fix issues in IE6 and IE7 in quirks mode */ fixIE: function () { var s = this, p = s.o.position; // simulate fixed position - adapted from BlockUI $.each([s.d.iframe || null, !s.o.spmodal ? null : s.d.overlay, s.d.container.css('position') === 'fixed' ? s.d.container : null], function (i, el) { if (el) { var bch = 'document.body.clientHeight', bcw = 'document.body.clientWidth', bsh = 'document.body.scrollHeight', bsl = 'document.body.scrollLeft', bst = 'document.body.scrollTop', bsw = 'document.body.scrollWidth', ch = 'document.documentElement.clientHeight', cw = 'document.documentElement.clientWidth', sl = 'document.documentElement.scrollLeft', st = 'document.documentElement.scrollTop', s = el[0].style; s.position = 'absolute'; if (i < 2) { s.removeExpression('height'); s.removeExpression('width'); s.setExpression('height','' + bsh + ' > ' + bch + ' ? ' + bsh + ' : ' + bch + ' + "px"'); s.setExpression('width','' + bsw + ' > ' + bcw + ' ? ' + bsw + ' : ' + bcw + ' + "px"'); } else { var te, le; if (p && p.constructor === Array) { var top = p[0] ? typeof p[0] === 'number' ? p[0].toString() : p[0].replace(/px/, '') : el.css('top').replace(/px/, ''); te = top.indexOf('%') === -1 ? top + ' + (t = ' + st + ' ? ' + st + ' : ' + bst + ') + "px"' : parseInt(top.replace(/%/, '')) + ' * ((' + ch + ' || ' + bch + ') / 100) + (t = ' + st + ' ? ' + st + ' : ' + bst + ') + "px"'; if (p[1]) { var left = typeof p[1] === 'number' ? p[1].toString() : p[1].replace(/px/, ''); le = left.indexOf('%') === -1 ? left + ' + (t = ' + sl + ' ? ' + sl + ' : ' + bsl + ') + "px"' : parseInt(left.replace(/%/, '')) + ' * ((' + cw + ' || ' + bcw + ') / 100) + (t = ' + sl + ' ? ' + sl + ' : ' + bsl + ') + "px"'; } } else { te = '(' + ch + ' || ' + bch + ') / 2 - (this.offsetHeight / 2) + (t = ' + st + ' ? ' + st + ' : ' + bst + ') + "px"'; le = '(' + cw + ' || ' + bcw + ') / 2 - (this.offsetWidth / 2) + (t = ' + sl + ' ? ' + sl + ' : ' + bsl + ') + "px"'; } s.removeExpression('top'); s.removeExpression('left'); s.setExpression('top', te); s.setExpression('left', le); } } }); }, /* * Place focus on the first or last visible input */ focus: function (pos) { var s = this, p = pos && $.inArray(pos, ['first', 'last']) !== -1 ? pos : 'first'; // focus on dialog or the first visible/enabled input element var input = $(':input:enabled:visible:' + p, s.d.wrap); setTimeout(function () { input.length > 0 ? input.focus() : s.d.wrap.focus(); }, 10); }, getDimensions: function () { // fix a jQuery bug with determining the window height - use innerHeight if available var s = this, h = typeof window.innerHeight === 'undefined' ? wndw.height() : window.innerHeight; d = [doc.height(), doc.width()]; w = [h, wndw.width()]; }, getVal: function (v, d) { return v ? (typeof v === 'number' ? v : v === 'auto' ? 0 : v.indexOf('%') > 0 ? ((parseInt(v.replace(/%/, '')) / 100) * (d === 'h' ? w[0] : w[1])) : parseInt(v.replace(/px/, ''))) : null; }, /* * Update the container. Set new dimensions, if provided. * Focus, if enabled. Re-bind events. */ update: function (height, width) { var s = this; // prevent update if dialog does not exist if (!s.d.data) { return false; } // reset orig values s.d.origHeight = s.getVal(height, 'h'); s.d.origWidth = s.getVal(width, 'w'); // hide data to prevent screen flicker s.d.data.hide(); height && s.d.container.css('height', height); width && s.d.container.css('width', width); s.setContainerDimensions(); s.d.data.show(); s.o.focus && s.focus(); // rebind events s.unbindEvents(); s.bindEvents(); }, setContainerDimensions: function () { var s = this, badIE = browser.ie6 || browser.ie7; // get the dimensions for the container and data var ch = s.d.origHeight ? s.d.origHeight : browser.opera ? s.d.container.height() : s.getVal(badIE ? s.d.container[0].currentStyle['height'] : s.d.container.css('height'), 'h'), cw = s.d.origWidth ? s.d.origWidth : browser.opera ? s.d.container.width() : s.getVal(badIE ? s.d.container[0].currentStyle['width'] : s.d.container.css('width'), 'w'), dh = s.d.data.outerHeight(true), dw = s.d.data.outerWidth(true); s.d.origHeight = s.d.origHeight || ch; s.d.origWidth = s.d.origWidth || cw; // mxoh = max option height, mxow = max option width var mxoh = s.o.maxHeight ? s.getVal(s.o.maxHeight, 'h') : null, mxow = s.o.maxWidth ? s.getVal(s.o.maxWidth, 'w') : null, mh = mxoh && mxoh < w[0] ? mxoh : w[0], mw = mxow && mxow < w[1] ? mxow : w[1]; // moh = min option height var moh = s.o.minHeight ? s.getVal(s.o.minHeight, 'h') : 'auto'; if (!ch) { if (!dh) {ch = moh;} else { if (dh > mh) {ch = mh;} else if (s.o.minHeight && moh !== 'auto' && dh < moh) {ch = moh;} else {ch = dh;} } } else { ch = s.o.autoResize && ch > mh ? mh : ch < moh ? moh : ch; } // mow = min option width var mow = s.o.minWidth ? s.getVal(s.o.minWidth, 'w') : 'auto'; if (!cw) { if (!dw) {cw = mow;} else { if (dw > mw) {cw = mw;} else if (s.o.minWidth && mow !== 'auto' && dw < mow) {cw = mow;} else {cw = dw;} } } else { cw = s.o.autoResize && cw > mw ? mw : cw < mow ? mow : cw; } s.d.container.css({height: ch, width: cw}); s.d.wrap.css({overflow: (dh > ch || dw > cw) ? 'auto' : 'visible'}); s.o.autoPosition && s.setPosition(); }, setPosition: function () { var s = this, top, left, hc = (w[0]/2) - (s.d.container.outerHeight(true)/2), vc = (w[1]/2) - (s.d.container.outerWidth(true)/2), st = s.d.container.css('position') !== 'fixed' ? wndw.scrollTop() : 0; if (s.o.position && Object.prototype.toString.call(s.o.position) === '[object Array]') { top = st + (s.o.position[0] || hc); left = s.o.position[1] || vc; } else { top = st + hc; left = vc; } s.d.container.css({left: left, top: top}); }, watchTab: function (e) { var s = this; if ($(e.target).parents('.simplespmodal-container').length > 0) { // save the list of inputs s.inputs = $(':input:enabled:visible:first, :input:enabled:visible:last', s.d.data[0]); // if it's the first or last tabbable element, refocus if ((!e.shiftKey && e.target === s.inputs[s.inputs.length -1]) || (e.shiftKey && e.target === s.inputs[0]) || s.inputs.length === 0) { e.preventDefault(); var pos = e.shiftKey ? 'last' : 'first'; s.focus(pos); } } else { // might be necessary when custom onShow callback is used e.preventDefault(); s.focus(); } }, /* * Open the spmodal dialog elements * - Note: If you use the onOpen callback, you must "show" the * overlay and container elements manually * (the iframe will be handled by Simplespmodal) */ open: function () { var s = this; // display the iframe s.d.iframe && s.d.iframe.show(); if ($.isFunction(s.o.onOpen)) { // execute the onOpen callback s.o.onOpen.apply(s, [s.d]); } else { // display the remaining elements s.d.overlay.show(); s.d.container.show(); s.d.data.show(); } s.o.focus && s.focus(); // bind default events s.bindEvents(); }, /* * Close the spmodal dialog * - Note: If you use an onClose callback, you must remove the * overlay, container and iframe elements manually * * @param {boolean} external Indicates whether the call to this * function was internal or external. If it was external, the * onClose callback will be ignored */ close: function () { var s = this; // prevent close when dialog does not exist if (!s.d.data) { return false; } // remove the default events s.unbindEvents(); if ($.isFunction(s.o.onClose) && !s.occb) { // set the onClose callback flag s.occb = true; // execute the onClose callback s.o.onClose.apply(s, [s.d]); } else { // if the data came from the DOM, put it back if (s.d.placeholder) { var ph = $('#simplespmodal-placeholder'); // save changes to the data? if (s.o.persist) { // insert the (possibly) modified data back into the DOM ph.replaceWith(s.d.data.removeClass('simplespmodal-data').css('display', s.display)); } else { // remove the current and insert the original, // unmodified data back into the DOM s.d.data.hide().remove(); ph.replaceWith(s.d.orig); } } else { // otherwise, remove it s.d.data.hide().remove(); } // remove the remaining elements s.d.container.hide().remove(); s.d.overlay.hide(); s.d.iframe && s.d.iframe.hide().remove(); s.d.overlay.remove(); // reset the dialog object s.d = {}; } } }; }));