/* * jQuery.splitter.js - two-pane splitter window plugin * * version 1.6 (2010/01/03) * * Dual licensed under the MIT and GPL licenses: * http://www.opensource.org/licenses/mit-license.php * http://www.gnu.org/licenses/gpl.html */ /** * The splitter() plugin implements a two-pane resizable splitter window. * The selected elements in the jQuery object are converted to a splitter; * each selected element should have two child elements, used for the panes * of the splitter. The plugin adds a third child element for the splitbar. * * For more details see: http://methvin.com/jquery/splitter/ * * * @example $('#MySplitter').splitter(); * @desc Create a vertical splitter with default settings * * @example $('#MySplitter').splitter({type: 'h', accessKey: 'M'}); * @desc Create a horizontal splitter resizable via Alt+Shift+M * * @name splitter * @type jQuery * @param Object options Options for the splitter (not required) * @cat Plugins/Splitter * @return jQuery * @author Dave Methvin (dave.methvin@gmail.com) */ ;(function($) { var splitterCounter = 0; $.fn.splitter = function(args) { args = args || {}; return this.each(function() { // Check if already a splitter if ($(this).is(".splitter")) { return; } // already a splitter var zombie; // left-behind splitbar for outline resizes function setBarState(state) { bar.removeClass(opts.barStateClasses) .addClass(state); } function doSplitMouse(evt) { var pos = A._posSplit + evt[opts.eventPos], range = Math.max(0, Math.min(pos, splitter._DA - bar._DA)), limit = Math.max(A._min, splitter._DA - B._max, Math.min(pos, A._max, splitter._DA - bar._DA - B._min)); if (opts.outline) { // Let docking splitbar be dragged to the dock position, even if min width applies if ((opts.dockPane == A && pos < Math.max(A._min, bar._DA)) || (opts.dockPane == B && pos > Math.min(pos, A._max, splitter._DA - bar._DA - B._min))) { bar.addClass(opts.barDockedClass) .css(opts.origin, range); } else { bar.removeClass(opts.barDockedClass) .css(opts.origin, limit); } bar._DA = bar[0][opts.pxSplit]; } else { resplit(pos); } setBarState(pos == limit ? opts.barActiveClass : opts.barLimitClass); } function endSplitMouse(evt) { setBarState(opts.barNormalClass); bar.addClass(opts.barHoverClass); var pos = A._posSplit + evt[opts.eventPos]; if (opts.outline) { zombie.remove(); zombie = null; resplit(pos); } panes.css("-webkit-user-select", "text") .find("iframe").removeClass(opts.iframeClass); $(document).unbind("mousemove" + opts.eventNamespace + " mouseup" + opts.eventNamespace); } function resplit(pos) { bar._DA = bar[0][opts.pxSplit]; // bar size may change during dock // Constrain new splitbar position to fit pane size and docking limits if ((opts.dockPane == A && pos < Math.max(A._min, bar._DA)) || (opts.dockPane == B && pos > Math.min(pos, A._max, splitter._DA - bar._DA - B._min))) { bar.addClass(opts.barDockedClass); bar._DA = bar[0][opts.pxSplit]; pos = opts.dockPane == A ? 0 : splitter._DA - bar._DA; if (bar._pos == null) { bar._pos = A[0][opts.pxSplit]; } } else { bar.removeClass(opts.barDockedClass); bar._DA = bar[0][opts.pxSplit]; bar._pos = null; pos = Math.max(A._min, splitter._DA - B._max, Math.min(pos, A._max, splitter._DA - bar._DA - B._min)); } // Resize/position the two panes bar.css(opts.origin, pos); A.css(opts.origin, 0) .css(opts.split, pos); B.css(opts.origin, pos + bar._DA) .css(opts.split, splitter._DA - bar._DA - pos); $().add(bar).add(A).add(B) .css(opts.fixed, splitter._DF); // IE fires resize for us; all others pay cash if (!browser_resize_auto_fired()) { panes.trigger("resize"); } } function dimSum(jq, dims) { // Opera returns -1 for missing min/max width, turn into 0 var sum = 0; for (var i = 1; i < arguments.length; i++) { sum += Math.max(parseInt(jq.css(arguments[i]), 10) || 0, 0); } return sum; } // Determine settings based on incoming opts, element classes, and defaults var vh = (args.splitHorizontal ? 'h' : (args.splitVertical ? 'v' : args.type)) || 'v'; var opts = $.extend({ // Defaults here allow easy use with ThemeRoller splitterClass: "", paneClass: "", barClass: "splitter-bar", barNormalClass: "ui-state-default", // splitbar normal barHoverClass: "ui-state-hover", // splitbar mouse hover barActiveClass: "ui-state-highlight", // splitbar being moved barLimitClass: "ui-state-error", // splitbar at limit iframeClass: "splitter-iframe-hide", // hide iframes during split eventNamespace: ".splitter" + (++splitterCounter), pxPerKey: 8, // splitter px moved per keypress tabIndex: 0, // tab order indicator accessKey: '', // accessKey for splitbar dockSpeed: 1 },{ // user can override v: { // Vertical splitters: keyLeft: 39, keyRight: 37, cursor: "e-resize", barStateClass: "splitter-bar-vertical", barDockedClass: "splitter-bar-vertical-docked" }, h: { // Horizontal splitters: keyTop: 40, keyBottom: 38, cursor: "n-resize", barStateClass: "splitter-bar-horizontal", barDockedClass: "splitter-bar-horizontal-docked" } }[vh], args, { // user cannot override v: { // Vertical splitters: type: 'v', eventPos: "pageX", origin: "left", split: "width", pxSplit: "offsetWidth", fixed: "height", pxFixed: "offsetHeight", side1: "Left", side2: "Right", side3: "Top", side4: "Bottom" }, h: { // Horizontal splitters: type: 'h', eventPos: "pageY", origin: "top", split: "height", pxSplit: "offsetHeight", fixed: "width", pxFixed: "offsetWidth", side1: "Top", side2: "Bottom", side3: "Left", side4: "Right" } }[vh]); opts.undockSpeed = opts.undockSpeed || opts.dockSpeed; opts.barStateClasses = [opts.barNormalClass, opts.barHoverClass, opts.barActiveClass, opts.barLimitClass].join(' '); // Create jQuery object closures for splitter and both panes var splitter = $(this) .css("position", "relative") .addClass(opts.splitterClass); var panes = $(">*", splitter[0]) .addClass(opts.paneClass) .css({ position: "absolute", // positioned inside splitter container "-moz-outline-style": "none" // don't show dotted outline }); var A = $(panes[0]), // left/top B = $(panes[1]); // right/bottom opts.dockPane = opts.dock && (/right|bottom/.test(opts.dock)? B:A); // Focuser element, provides keyboard support; title is shown by Opera accessKeys var focuser = $('') .attr({ accessKey: opts.accessKey, tabIndex: opts.tabIndex, title: opts.splitbarClass }) .bind("blur" + opts.eventNamespace, function() { bar.removeClass(opts.barActiveClass); }); if(opts.accessKey !== '') { focuser.bind("keydown" + opts.eventNamespace, function(e) { var key = e.which || e.keyCode; var dir = (key == opts["key" + opts.side1]) ? 1 : ((key == opts["key" + opts.side2]) ? -1 : 0); if (dir) { resplit(A[0][opts.pxSplit] + dir * opts.pxPerKey, false); } }); } // Splitbar element var bar = $('
') .insertAfter(A) .addClass(opts.barClass + ' ' + opts.barStateClass) .append(focuser) .attr("unselectable", "on") .css({ position: "absolute", "user-select": "none", "-webkit-user-select": "none", "-khtml-user-select": "none", "-moz-user-select": "none", "z-index": "1" }) .bind("mousedown" + opts.eventNamespace, function (evt) { if (evt.which != 1) { return; // left button only } bar.removeClass(opts.barHoverClass); if (opts.outline) { zombie = zombie || bar.clone().insertAfter(A); bar.removeClass(opts.barDockedClass); } setBarState(opts.barActiveClass); // Safari selects A/B text on a move; iframes capture mouse events so hide them panes.css("-webkit-user-select", "none") .find("iframe").addClass(opts.iframeClass); A._posSplit = A[0][opts.pxSplit] - evt[opts.eventPos]; $(document) .bind("mousemove" + opts.eventNamespace, doSplitMouse) .bind("mouseup" + opts.eventNamespace, endSplitMouse); }) .bind("mouseover" + opts.eventNamespace, function() { $(this).addClass(opts.barHoverClass); }) .bind("mouseout" + opts.eventNamespace, function() { $(this).removeClass(opts.barHoverClass); }); // Use our cursor unless the style specifies a non-default cursor if (/^(auto|default|)$/.test(bar.css("cursor"))) { bar.css("cursor", opts.cursor); } // Cache several dimensions for speed, rather than re-querying constantly // These are saved on the A/B/bar/splitter jQuery vars, which are themselves cached // DA=dimension adjustable direction, PBF=padding/border fixed, PBA=padding/border adjustable bar._DA = bar[0][opts.pxSplit]; splitter._PBF = dimSum(splitter, "border" + opts.side3 + "Width", "border" + opts.side4 + "Width"); splitter._PBA = dimSum(splitter, "border" + opts.side1 + "Width", "border" + opts.side2 + "Width"); A._pane = opts.side1; B._pane = opts.side2; $.each([A,B], function() { this._splitter_style = this.style; this._min = opts["min" + this._pane] || dimSum(this, "min-" + opts.split); this._max = opts["max" + this._pane] || dimSum(this, "max-" + opts.split) || 9999; this._init = (opts["size" + this._pane] === true) ? parseInt($.css(this[0], opts.split), 10) : opts["size" + this._pane]; }); // Determine initial position var initPos = A._init; if (!isNaN(B._init)) { // recalc initial B size as an offset from the top or left side initPos = splitter[0][opts.pxSplit] - splitter._PBA - B._init - bar._DA; } else if (isNaN(initPos)) {// King Solomon's algorithm initPos = Math.round((splitter[0][opts.pxSplit] - splitter._PBA - bar._DA) / 2); } // Resize event propagation and splitter sizing if (opts.anchorToWindow) { opts.resizeTo = window; } if (opts.resizeTo) { splitter._hadjust = dimSum(splitter, "borderTopWidth", "borderBottomWidth", "marginBottom"); splitter._hmin = Math.max(dimSum(splitter, "minHeight"), 20); $(window).bind("resize" + opts.eventNamespace, function (e) { if (e.target == window) { var top = splitter.offset().top, eh = $(opts.resizeTo).height(); splitter.css("height", Math.max(eh - top - splitter._hadjust, splitter._hmin) + "px"); if (!browser_resize_auto_fired()) { splitter.trigger("resize"); } } }) .trigger("resize" + opts.eventNamespace); } else if (opts.resizeToWidth) { $(window).bind("resize" + opts.eventNamespace, function() { splitter.trigger("resize"); }); } // Docking support if (opts.dock) { splitter .bind("toggleDock" + opts.eventNamespace, function() { splitter.trigger((opts.dockPane[0][opts.pxSplit]) ? "dock" : "undock"); }) .bind("dock" + opts.eventNamespace, function() { var pw = A[0][opts.pxSplit]; if (!pw) { return; } bar._pos = pw; var x = {}; x[opts.origin] = opts.dockPane == A ? 0 : (splitter[0][opts.pxSplit] - splitter._PBA - bar[0][opts.pxSplit]); bar.animate(x, opts.dockSpeed, opts.dockEasing, function() { bar.addClass(opts.barDockedClass); resplit(x[opts.origin]); }); }) .bind("undock" + opts.eventNamespace, function() { var pw = opts.dockPane[0][opts.pxSplit]; if (pw) { return; } var x = {}; x[opts.origin] = bar._pos + "px"; bar.removeClass(opts.barDockedClass) .animate(x, opts.undockSpeed, opts.undockEasing || opts.dockEasing, function() { resplit(bar._pos); bar._pos = null; }); }); if (opts.dockKey) { $('') .attr({ accessKey: opts.dockKey, tabIndex: -1 }) .appendTo(bar); } bar.bind("dblclick", function() { splitter.trigger("toggleDock"); }); } // Resize event handler; triggered immediately to set initial position splitter .bind("destroy" + opts.eventNamespace, function() { $([window, document]).unbind(opts.eventNamespace); bar.unbind().remove(); panes.removeClass(opts.paneClass); splitter .removeClass(opts.splitterClass) .add(panes) .unbind(opts.eventNamespace) .attr("style", function() { return this._splitter_style || ""; //TODO: save style }); splitter = bar = focuser = panes = A = B = opts = args = null; }) .bind("resize" + opts.eventNamespace, function(e, size) { // Custom events bubble in jQuery 1.3; avoid recursion if (e.target != this) { return; } // Determine new width/height of splitter container splitter._DF = splitter[0][opts.pxFixed] - splitter._PBF; splitter._DA = splitter[0][opts.pxSplit] - splitter._PBA; // Bail if splitter isn't visible or content isn't there yet if (splitter._DF <= 0 || splitter._DA <= 0) { return; } // Re-divvy the adjustable dimension; maintain size of the preferred pane resplit(!isNaN(size) ? size : (!(opts.sizeRight || opts.sizeBottom) ? A[0][opts.pxSplit] : splitter._DA - B[0][opts.pxSplit] - bar._DA)); setBarState(opts.barNormalClass); }) .trigger("resize" , [initPos]); }); // See: http://stackoverflow.com/questions/5321284/fix-for-jquery-splitter-in-ie9 function browser_resize_auto_fired() { // Returns true when the browser natively fires the resize // event attached to the panes elements return false; } }; })(jQuery);