YUI recommends YUI3.
YUI 2 has been deprecated since 2011. This site acts as an archive for files and documentation.
This documentation is no longer maintained.
/**
* @description <p>Provides a fixed position unit containing a header, body and footer for use with a YAHOO.widget.Layout instance.</p>
* @namespace YAHOO.widget
* @requires yahoo, dom, element, event, layout
* @optional animation, dragdrop, selector
*/
(function() {
var Dom = YAHOO.util.Dom,
Sel = YAHOO.util.Selector,
Event = YAHOO.util.Event,
Lang = YAHOO.lang;
/**
* @constructor
* @class LayoutUnit
* @extends YAHOO.util.Element
* @description <p>Provides a fixed position unit containing a header, body and footer for use with a YAHOO.widget.Layout instance.</p>
* @param {String/HTMLElement} el The element to make a unit.
* @param {Object} attrs Object liternal containing configuration parameters.
*/
var LayoutUnit = function(el, config) {
var oConfig = {
element: el,
attributes: config || {}
};
LayoutUnit.superclass.constructor.call(this, oConfig.element, oConfig.attributes);
};
/**
* @private
* @static
* @property _instances
* @description Internal hash table for all layout unit instances
* @type Object
*/
LayoutUnit._instances = {};
/**
* @static
* @method getLayoutUnitById
* @description Get's a layout unit object by the HTML id of the element associated with the Layout Unit object.
* @return {Object} The Layout Object
*/
LayoutUnit.getLayoutUnitById = function(id) {
if (LayoutUnit._instances[id]) {
return LayoutUnit._instances[id];
}
return false;
};
YAHOO.extend(LayoutUnit, YAHOO.util.Element, {
/**
* @property STR_CLOSE
* @description String used for close button title
* @type {String}
*/
STR_CLOSE: 'Click to close this pane.',
/**
* @property STR_COLLAPSE
* @description String used for collapse button title
* @type {String}
*/
STR_COLLAPSE: 'Click to collapse this pane.',
/**
* @property STR_EXPAND
* @description String used for expand button title
* @type {String}
*/
STR_EXPAND: 'Click to expand this pane.',
/**
* The class name applied to dynamic tabs while loading.
* @property LOADING_CLASSNAME
* @type String
* @default "disabled"
*/
LOADING_CLASSNAME: 'loading',
/**
* @property browser
* @description A modified version of the YAHOO.env.ua object
* @type Object
*/
browser: null,
/**
* @private
* @property _sizes
* @description A collection of the current sizes of the contents of this Layout Unit
* @type Object
*/
_sizes: null,
/**
* @private
* @property _anim
* @description A reference to the Animation instance used by this LayouUnit
* @type YAHOO.util.Anim
*/
_anim: null,
/**
* @private
* @property _resize
* @description A reference to the Resize instance used by this LayoutUnit
* @type YAHOO.util.Resize
*/
_resize: null,
/**
* @private
* @property _clip
* @description A reference to the clip element used when collapsing the unit
* @type HTMLElement
*/
_clip: null,
/**
* @private
* @property _gutter
* @description A simple hash table used to store the gutter to apply to the Unit
* @type Object
*/
_gutter: null,
/**
* @property header
* @description A reference to the HTML element used for the Header
* @type HTMLELement
*/
header: null,
/**
* @property body
* @description A reference to the HTML element used for the body
* @type HTMLElement
*/
body: null,
/**
* @property footer
* @description A reference to the HTML element used for the footer
* @type HTMLElement
*/
footer: null,
/**
* @private
* @property _collapsed
* @description Flag to determine if the unit is collapsed or not.
* @type Boolean
*/
_collapsed: null,
/**
* @private
* @property _collapsing
* @description A flag set while the unit is being collapsed, used so we don't fire events while animating the size
* @type Boolean
*/
_collapsing: null,
/**
* @private
* @property _lastWidth
* @description A holder for the last known width of the unit
* @type Number
*/
_lastWidth: null,
/**
* @private
* @property _lastHeight
* @description A holder for the last known height of the unit
* @type Number
*/
_lastHeight: null,
/**
* @private
* @property _lastTop
* @description A holder for the last known top of the unit
* @type Number
*/
_lastTop: null,
/**
* @private
* @property _lastLeft
* @description A holder for the last known left of the unit
* @type Number
*/
_lastLeft: null,
/**
* @private
* @property _lastScroll
* @description A holder for the last known scroll state of the unit
* @type Boolean
*/
_lastScroll: null,
/**
* @private
* @property _lastCenetrScroll
* @description A holder for the last known scroll state of the center unit
* @type Boolean
*/
_lastCenterScroll: null,
/**
* @private
* @property _lastScrollTop
* @description A holder for the last known scrollTop state of the unit
* @type Number
*/
_lastScrollTop: null,
/**
* @method resize
* @description Resize either the unit or it's clipped state, also updating the box inside
* @param {Boolean} force This will force full calculations even when the unit is collapsed
* @return {<a href="YAHOO.widget.LayoutUnit.html">YAHOO.widget.LayoutUnit</a>} The LayoutUnit instance
*/
resize: function(force) {
YAHOO.log('Resize', 'info', 'LayoutUnit');
var retVal = this.fireEvent('beforeResize');
if (retVal === false) {
return this;
}
if (!this._collapsing || (force === true)) {
var scroll = this.get('scroll');
this.set('scroll', false);
var hd = this._getBoxSize(this.header),
ft = this._getBoxSize(this.footer),
box = [this.get('height'), this.get('width')];
var nh = (box[0] - hd[0] - ft[0]) - (this._gutter.top + this._gutter.bottom),
nw = box[1] - (this._gutter.left + this._gutter.right);
var wrapH = (nh + (hd[0] + ft[0])),
wrapW = nw;
if (this._collapsed && !this._collapsing) {
this._setHeight(this._clip, wrapH);
this._setWidth(this._clip, wrapW);
Dom.setStyle(this._clip, 'top', this.get('top') + this._gutter.top + 'px');
Dom.setStyle(this._clip, 'left', this.get('left') + this._gutter.left + 'px');
} else if (!this._collapsed || (this._collapsed && this._collapsing)) {
wrapH = this._setHeight(this.get('wrap'), wrapH);
wrapW = this._setWidth(this.get('wrap'), wrapW);
this._sizes.wrap.h = wrapH;
this._sizes.wrap.w = wrapW;
Dom.setStyle(this.get('wrap'), 'top', this._gutter.top + 'px');
Dom.setStyle(this.get('wrap'), 'left', this._gutter.left + 'px');
this._sizes.header.w = this._setWidth(this.header, wrapW);
this._sizes.header.h = hd[0];
this._sizes.footer.w = this._setWidth(this.footer, wrapW);
this._sizes.footer.h = ft[0];
Dom.setStyle(this.footer, 'bottom', '0px');
this._sizes.body.h = this._setHeight(this.body, (wrapH - (hd[0] + ft[0])));
this._sizes.body.w =this._setWidth(this.body, wrapW);
Dom.setStyle(this.body, 'top', hd[0] + 'px');
this.set('scroll', scroll);
this.fireEvent('resize');
}
}
return this;
},
/**
* @private
* @method _setWidth
* @description Sets the width of the element based on the border size of the element.
* @param {HTMLElement} el The HTMLElement to have it's width set
* @param {Number} w The width that you want it the element set to
* @return {Number} The new width, fixed for borders and IE QuirksMode
*/
_setWidth: function(el, w) {
if (el) {
var b = this._getBorderSizes(el);
w = (w - (b[1] + b[3]));
w = this._fixQuirks(el, w, 'w');
if (w < 0) {
w = 0;
}
Dom.setStyle(el, 'width', w + 'px');
}
return w;
},
/**
* @private
* @method _setHeight
* @description Sets the height of the element based on the border size of the element.
* @param {HTMLElement} el The HTMLElement to have it's height set
* @param {Number} h The height that you want it the element set to
* @return {Number} The new height, fixed for borders and IE QuirksMode
*/
_setHeight: function(el, h) {
if (el) {
var b = this._getBorderSizes(el);
h = (h - (b[0] + b[2]));
h = this._fixQuirks(el, h, 'h');
if (h < 0) {
h = 0;
}
Dom.setStyle(el, 'height', h + 'px');
}
return h;
},
/**
* @private
* @method _fixQuirks
* @description Fixes the box calculations for IE in QuirksMode
* @param {HTMLElement} el The HTMLElement to set the dimension on
* @param {Number} dim The number of the dimension to fix
* @param {String} side The dimension (h or w) to fix. Defaults to h
* @return {Number} The fixed dimension
*/
_fixQuirks: function(el, dim, side) {
var i1 = 0, i2 = 2;
if (side == 'w') {
i1 = 1;
i2 = 3;
}
if ((this.browser.ie < 8) && !this.browser.standardsMode) {
//Internet Explorer - Quirks Mode
var b = this._getBorderSizes(el),
bp = this._getBorderSizes(el.parentNode);
if ((b[i1] === 0) && (b[i2] === 0)) { //No Borders, check parent
if ((bp[i1] !== 0) && (bp[i2] !== 0)) { //Parent has Borders
dim = (dim - (bp[i1] + bp[i2]));
}
} else {
if ((bp[i1] === 0) && (bp[i2] === 0)) {
dim = (dim + (b[i1] + b[i2]));
}
}
}
return dim;
},
/**
* @private
* @method _getBoxSize
* @description Get's the elements clientHeight and clientWidth plus the size of the borders
* @param {HTMLElement} el The HTMLElement to get the size of
* @return {Array} An array of height and width
*/
_getBoxSize: function(el) {
var size = [0, 0];
if (el) {
if (this.browser.ie && !this.browser.standardsMode) {
el.style.zoom = 1;
}
var b = this._getBorderSizes(el);
size[0] = el.clientHeight + (b[0] + b[2]);
size[1] = el.clientWidth + (b[1] + b[3]);
}
return size;
},
/**
* @private
* @method _getBorderSizes
* @description Get the CSS border size of the element passed.
* @param {HTMLElement} el The element to get the border size of
* @return {Array} An array of the top, right, bottom, left borders.
*/
_getBorderSizes: function(el) {
var s = [];
el = el || this.get('element');
if (this.browser.ie && !this.browser.standardsMode) {
el.style.zoom = 1;
}
s[0] = parseInt(Dom.getStyle(el, 'borderTopWidth'), 10);
s[1] = parseInt(Dom.getStyle(el, 'borderRightWidth'), 10);
s[2] = parseInt(Dom.getStyle(el, 'borderBottomWidth'), 10);
s[3] = parseInt(Dom.getStyle(el, 'borderLeftWidth'), 10);
//IE will return NaN on these if they are set to auto, we'll set them to 0
for (var i = 0; i < s.length; i++) {
if (isNaN(s[i])) {
s[i] = 0;
}
}
return s;
},
/**
* @private
* @method _createClip
* @description Create the clip element used when the Unit is collapsed
*/
_createClip: function() {
if (!this._clip) {
this._clip = document.createElement('div');
this._clip.className = 'yui-layout-clip yui-layout-clip-' + this.get('position');
this._clip.innerHTML = '<div class="collapse"></div>';
var c = this._clip.firstChild;
c.title = this.STR_EXPAND;
Event.on(c, 'click', this.expand, this, true);
this.get('element').parentNode.appendChild(this._clip);
}
},
/**
* @private
* @method _toggleClip
* @description Toggle th current state of the Clip element and set it's height, width and position
*/
_toggleClip: function() {
if (!this._collapsed) {
//show
var hd = this._getBoxSize(this.header),
ft = this._getBoxSize(this.footer),
box = [this.get('height'), this.get('width')];
var nh = (box[0] - hd[0] - ft[0]) - (this._gutter.top + this._gutter.bottom),
nw = box[1] - (this._gutter.left + this._gutter.right),
wrapH = (nh + (hd[0] + ft[0]));
switch (this.get('position')) {
case 'top':
case 'bottom':
this._setWidth(this._clip, nw);
this._setHeight(this._clip, this.get('collapseSize'));
Dom.setStyle(this._clip, 'left', (this._lastLeft + this._gutter.left) + 'px');
if (this.get('position') == 'bottom') {
Dom.setStyle(this._clip, 'top', ((this._lastTop + this._lastHeight) - (this.get('collapseSize') - this._gutter.top)) + 'px');
} else {
Dom.setStyle(this._clip, 'top', this.get('top') + this._gutter.top + 'px');
}
break;
case 'left':
case 'right':
this._setWidth(this._clip, this.get('collapseSize'));
this._setHeight(this._clip, wrapH);
Dom.setStyle(this._clip, 'top', (this.get('top') + this._gutter.top) + 'px');
if (this.get('position') == 'right') {
Dom.setStyle(this._clip, 'left', (((this._lastLeft + this._lastWidth) - this.get('collapseSize')) - this._gutter.left) + 'px');
} else {
Dom.setStyle(this._clip, 'left', (this.get('left') + this._gutter.left) + 'px');
}
break;
}
Dom.setStyle(this._clip, 'display', 'block');
this.setStyle('display', 'none');
} else {
//Hide
Dom.setStyle(this._clip, 'display', 'none');
}
},
/**
* @method getSizes
* @description Get a reference to the internal sizes object for this unit
* @return {Object} An object of the sizes used for calculations
*/
getSizes: function() {
return this._sizes;
},
/**
* @method toggle
* @description Toggles the Unit, replacing it with a clipped version.
* @return {<a href="YAHOO.widget.LayoutUnit.html">YAHOO.widget.LayoutUnit</a>} The LayoutUnit instance
*/
toggle: function() {
if (this._collapsed) {
this.expand();
} else {
this.collapse();
}
return this;
},
/**
* @method expand
* @description Expand the Unit if it is collapsed.
* @return {<a href="YAHOO.widget.LayoutUnit.html">YAHOO.widget.LayoutUnit</a>} The LayoutUnit instance
*/
expand: function() {
if (!this._collapsed) {
return this;
}
var retVal = this.fireEvent('beforeExpand');
if (retVal === false) {
return this;
}
this._collapsing = true;
this.setStyle('zIndex', this._zIndex);
if (this._anim) {
this.setStyle('display', 'none');
var attr = {}, s;
switch (this.get('position')) {
case 'left':
case 'right':
this.set('width', this._lastWidth, true);
this.setStyle('width', this._lastWidth + 'px');
this.get('parent').resize(false);
s = this.get('parent').getSizes()[this.get('position')];
this.set('height', s.h, true);
var left = s.l;
attr = {
left: {
to: left
}
};
if (this.get('position') == 'left') {
attr.left.from = (left - s.w);
this.setStyle('left', (left - s.w) + 'px');
}
break;
case 'top':
case 'bottom':
this.set('height', this._lastHeight, true);
this.setStyle('height', this._lastHeight + 'px');
this.get('parent').resize(false);
s = this.get('parent').getSizes()[this.get('position')];
this.set('width', s.w, true);
var top = s.t;
attr = {
top: {
to: top
}
};
if (this.get('position') == 'top') {
this.setStyle('top', (top - s.h) + 'px');
attr.top.from = (top - s.h);
}
break;
}
this._anim.attributes = attr;
var exStart = function() {
this.setStyle('display', 'block');
this.resize(true);
this._anim.onStart.unsubscribe(exStart, this, true);
};
var expand = function() {
this._collapsing = false;
this.setStyle('zIndex', this._zIndex);
this.set('width', this._lastWidth);
this.set('height', this._lastHeight);
this._collapsed = false;
this.resize();
this.set('scroll', this._lastScroll);
if (this._lastScrollTop > 0) {
this.body.scrollTop = this._lastScrollTop;
}
this._anim.onComplete.unsubscribe(expand, this, true);
this.fireEvent('expand');
};
this._anim.onStart.subscribe(exStart, this, true);
this._anim.onComplete.subscribe(expand, this, true);
this._anim.animate();
this._toggleClip();
} else {
this._collapsing = false;
this._toggleClip();
this._collapsed = false;
this._zIndex = this.getStyle('zIndex');
this.setStyle('zIndex', this.get('parent')._zIndex);
this.setStyle('display', 'block');
this.set('width', this._lastWidth);
this.set('height', this._lastHeight);
this.resize();
this.set('scroll', this._lastScroll);
if (this._lastScrollTop > 0) {
this.body.scrollTop = this._lastScrollTop;
}
this.fireEvent('expand');
}
return this;
},
/**
* @method collapse
* @description Collapse the Unit if it is not collapsed.
* @return {<a href="YAHOO.widget.LayoutUnit.html">YAHOO.widget.LayoutUnit</a>} The LayoutUnit instance
*/
collapse: function() {
if (this._collapsed) {
return this;
}
var retValue = this.fireEvent('beforeCollapse');
if (retValue === false) {
return this;
}
if (!this._clip) {
this._createClip();
}
this._collapsing = true;
var w = this.get('width'),
h = this.get('height'),
attr = {};
this._lastWidth = w;
this._lastHeight = h;
this._lastScroll = this.get('scroll');
this._lastScrollTop = this.body.scrollTop;
this.set('scroll', false, true);
this._lastLeft = parseInt(this.get('element').style.left, 10);
this._lastTop = parseInt(this.get('element').style.top, 10);
if (isNaN(this._lastTop)) {
this._lastTop = 0;
this.set('top', 0);
}
if (isNaN(this._lastLeft)) {
this._lastLeft = 0;
this.set('left', 0);
}
this._zIndex = this.getStyle('zIndex');
this.setStyle('zIndex', this.get('parent')._zIndex + 1);
var pos = this.get('position');
switch (pos) {
case 'top':
case 'bottom':
this.set('height', (this.get('collapseSize') + (this._gutter.top + this._gutter.bottom)));
attr = {
top: {
to: (this.get('top') - h)
}
};
if (pos == 'bottom') {
attr.top.to = (this.get('top') + h);
}
break;
case 'left':
case 'right':
this.set('width', (this.get('collapseSize') + (this._gutter.left + this._gutter.right)));
attr = {
left: {
to: -(this._lastWidth)
}
};
if (pos == 'right') {
attr.left = {
to: (this.get('left') + w)
};
}
break;
}
if (this._anim) {
this._anim.attributes = attr;
var collapse = function() {
this._collapsing = false;
this._toggleClip();
this.setStyle('zIndex', this.get('parent')._zIndex);
this._collapsed = true;
this.get('parent').resize();
this._anim.onComplete.unsubscribe(collapse, this, true);
this.fireEvent('collapse');
};
this._anim.onComplete.subscribe(collapse, this, true);
this._anim.animate();
} else {
this._collapsing = false;
this.setStyle('display', 'none');
this._toggleClip();
this.setStyle('zIndex', this.get('parent')._zIndex);
this.get('parent').resize();
this._collapsed = true;
this.fireEvent('collapse');
}
return this;
},
/**
* @method close
* @description Close the unit, removing it from the parent Layout.
* @return {<a href="YAHOO.widget.Layout.html">YAHOO.widget.Layout</a>} The parent Layout instance
*/
close: function() {
this.setStyle('display', 'none');
this.get('parent').removeUnit(this);
this.fireEvent('close');
if (this._clip) {
this._clip.parentNode.removeChild(this._clip);
this._clip = null;
}
return this.get('parent');
},
/**
* @property loadHandler
* @description Callback method for the YUI Connection Manager used for load the body using AJAX. NOTE: e.responseText is loaded via innerHTML.
* @type Object
*/
loadHandler: {
success: function(o) {
this.body.innerHTML = o.responseText;
this.resize (true);
},
failure: function(o) {
}
},
/**
* @property dataConnection
* @description YUI Connection Manager handler
* @type Object
*/
dataConnection: null,
/**
* @private
* @property _loading
* @description During the loading process this variable will be true
* @type Number
*/
_loading: false,
/**
* @method loadContent
* @description Loading the content of the unit using the connection manager
* @return {object} YUI Connection Manager handler
*/
loadContent: function() {
// load dynamic content unless already loading or loaded and caching
if (YAHOO.util.Connect && this.get('dataSrc') && !this._loading && !this.get('dataLoaded')) {
this._loading = true;
Dom.addClass(this.body, this.LOADING_CLASSNAME);
this.dataConnection = YAHOO.util.Connect.asyncRequest(
this.get('loadMethod'),
this.get('dataSrc'),
{
success: function(o) {
this.loadHandler.success.call(this, o);
this.set('dataLoaded', true);
this.dataConnection = null;
Dom.removeClass(this.body, this.LOADING_CLASSNAME);
this._loading = false;
this.fireEvent('load');
},
failure: function(o) {
this.loadHandler.failure.call(this, o);
this.dataConnection = null;
Dom.removeClass(this.body, this.LOADING_CLASSNAME);
this._loading = false;
this.fireEvent('loadError', { error: o });
},
scope: this,
timeout: this.get('dataTimeout')
}
);
return this.dataConnection;
}
return false;
},
/**
* @private
* @method init
* @description The initalization method inherited from Element.
*/
init: function(p_oElement, p_oAttributes) {
YAHOO.log('init', 'info', 'LayoutUnit');
this._gutter = {
left: 0,
right: 0,
top: 0,
bottom: 0
};
this._sizes = {
wrap: {
h: 0,
w: 0
},
header: {
h: 0,
w: 0
},
body: {
h: 0,
w: 0
},
footer: {
h: 0,
w: 0
}
};
LayoutUnit.superclass.init.call(this, p_oElement, p_oAttributes);
this.browser = this.get('parent').browser;
var id = p_oElement;
if (!Lang.isString(id)) {
id = Dom.generateId(id);
}
LayoutUnit._instances[id] = this;
this.setStyle('position', 'absolute');
this.addClass('yui-layout-unit');
this.addClass('yui-layout-unit-' + this.get('position'));
var header = this.getElementsByClassName('yui-layout-hd', 'div')[0];
if (header) {
this.header = header;
}
var body = this.getElementsByClassName('yui-layout-bd', 'div')[0];
if (body) {
this.body = body;
}
var footer = this.getElementsByClassName('yui-layout-ft', 'div')[0];
if (footer) {
this.footer = footer;
}
this.on('contentChange', this.resize, this, true);
this._lastScrollTop = 0;
this.set('animate', this.get('animate'));
},
/**
* @private
* @method initAttributes
* @description Processes the config
*/
initAttributes: function(attr) {
LayoutUnit.superclass.initAttributes.call(this, attr);
/**
* @private
* @attribute wrap
* @description A reference to the wrap element
* @type HTMLElement
*/
this.setAttributeConfig('wrap', {
value: attr.wrap || null,
method: function(w) {
if (w) {
var id = Dom.generateId(w);
LayoutUnit._instances[id] = this;
}
}
});
/**
* @attribute grids
* @description Set this option to true if you want the LayoutUnit to fix the first layer of YUI CSS Grids (margins)
* @type Boolean
*/
this.setAttributeConfig('grids', {
value: attr.grids || false
});
/**
* @private
* @attribute top
* @description The current top positioning of the Unit
* @type Number
*/
this.setAttributeConfig('top', {
value: attr.top || 0,
validator: Lang.isNumber,
method: function(t) {
if (!this._collapsing) {
this.setStyle('top', t + 'px');
}
}
});
/**
* @private
* @attribute left
* @description The current left position of the Unit
* @type Number
*/
this.setAttributeConfig('left', {
value: attr.left || 0,
validator: Lang.isNumber,
method: function(l) {
if (!this._collapsing) {
this.setStyle('left', l + 'px');
}
}
});
/**
* @attribute minWidth
* @description The minWidth parameter passed to the Resize Utility
* @type Number
*/
this.setAttributeConfig('minWidth', {
value: attr.minWidth || false,
method: function(v) {
if (this._resize) {
this._resize.set('minWidth', v);
}
},
validator: YAHOO.lang.isNumber
});
/**
* @attribute maxWidth
* @description The maxWidth parameter passed to the Resize Utility
* @type Number
*/
this.setAttributeConfig('maxWidth', {
value: attr.maxWidth || false,
method: function(v) {
if (this._resize) {
this._resize.set('maxWidth', v);
}
},
validator: YAHOO.lang.isNumber
});
/**
* @attribute minHeight
* @description The minHeight parameter passed to the Resize Utility
* @type Number
*/
this.setAttributeConfig('minHeight', {
value: attr.minHeight || false,
method: function(v) {
if (this._resize) {
this._resize.set('minHeight', v);
}
},
validator: YAHOO.lang.isNumber
});
/**
* @attribute maxHeight
* @description The maxHeight parameter passed to the Resize Utility
* @type Number
*/
this.setAttributeConfig('maxHeight', {
value: attr.maxHeight || false,
method: function(v) {
if (this._resize) {
this._resize.set('maxHeight', v);
}
},
validator: YAHOO.lang.isNumber
});
/**
* @attribute height
* @description The height of the Unit
* @type Number
*/
this.setAttributeConfig('height', {
value: attr.height,
validator: Lang.isNumber,
method: function(h) {
if (!this._collapsing) {
if (h < 0) {
h = 0;
}
this.setStyle('height', h + 'px');
}
}
});
/**
* @attribute width
* @description The width of the Unit
* @type Number
*/
this.setAttributeConfig('width', {
value: attr.width,
validator: Lang.isNumber,
method: function(w) {
if (!this._collapsing) {
if (w < 0) {
w = 0;
}
this.setStyle('width', w + 'px');
}
}
});
/**
* @attribute zIndex
* @description The CSS zIndex to give to the unit, so you can have overlapping elements such as menus in a unit.
* @type {Number}
*/
this.setAttributeConfig('zIndex', {
value: attr.zIndex || false,
method: function(z) {
this.setStyle('zIndex', z);
}
});
/**
* @attribute position
* @description The position (top, right, bottom, left or center) of the Unit in the Layout
* @type {String}
*/
this.setAttributeConfig('position', {
value: attr.position
});
/**
* @attribute gutter
* @description The gutter that we should apply to the parent Layout around this Unit. Supports standard CSS markup: (2 4 0 5) or (2) or (2 5)
* @type String
*/
this.setAttributeConfig('gutter', {
value: attr.gutter || 0,
validator: YAHOO.lang.isString,
method: function(gutter) {
var p = gutter.split(' ');
if (p.length) {
this._gutter.top = parseInt(p[0], 10);
if (p[1]) {
this._gutter.right = parseInt(p[1], 10);
} else {
this._gutter.right = this._gutter.top;
}
if (p[2]) {
this._gutter.bottom = parseInt(p[2], 10);
} else {
this._gutter.bottom = this._gutter.top;
}
if (p[3]) {
this._gutter.left = parseInt(p[3], 10);
} else if (p[1]) {
this._gutter.left = this._gutter.right;
} else {
this._gutter.left = this._gutter.top;
}
}
}
});
/**
* @attribute parent
* @description The parent Layout that we are assigned to
* @type {Object} YAHOO.widget.Layout
*/
this.setAttributeConfig('parent', {
writeOnce: true,
value: attr.parent || false,
method: function(p) {
if (p) {
p.on('resize', this.resize, this, true);
}
}
});
/**
* @attribute collapseSize
* @description The pixel size of the Clip that we will collapse to
* @type Number
*/
this.setAttributeConfig('collapseSize', {
value: attr.collapseSize || 25,
validator: YAHOO.lang.isNumber
});
/**
* @attribute duration
* @description The duration to give the Animation Utility when animating the opening and closing of Units
*/
this.setAttributeConfig('duration', {
value: attr.duration || 0.5
});
/**
* @attribute easing
* @description The Animation Easing to apply to the Animation instance for this unit.
*/
this.setAttributeConfig('easing', {
value: attr.easing || ((YAHOO.util && YAHOO.util.Easing) ? YAHOO.util.Easing.BounceIn : 'false')
});
/**
* @attribute animate
* @description Use animation to collapse/expand the unit
* @type Boolean
*/
this.setAttributeConfig('animate', {
value: ((attr.animate === false) ? false : true),
validator: function() {
var anim = false;
if (YAHOO.util.Anim) {
anim = true;
}
return anim;
},
method: function(anim) {
if (anim) {
this._anim = new YAHOO.util.Anim(this.get('element'), {}, this.get('duration'), this.get('easing'));
} else {
this._anim = false;
}
}
});
/**
* @attribute header
* @description The html to use as the Header of the Unit (sets via innerHTML)
* @type {HTML}
*/
this.setAttributeConfig('header', {
value: attr.header || false,
method: function(txt) {
if (txt === false) {
//Remove the footer
if (this.header) {
Dom.addClass(this.body, 'yui-layout-bd-nohd');
this.header.parentNode.removeChild(this.header);
this.header = null;
}
} else {
if (!this.header) {
var header = this.getElementsByClassName('yui-layout-hd', 'div')[0];
if (!header) {
header = this._createHeader();
}
this.header = header;
}
var h = this.header.getElementsByTagName('h2')[0];
if (!h) {
h = document.createElement('h2');
this.header.appendChild(h);
}
h.innerHTML = txt;
if (this.body) {
Dom.removeClass(this.body, 'yui-layout-bd-nohd');
}
}
this.fireEvent('contentChange', { target: 'header' });
}
});
/**
* @attribute proxy
* @description Use the proxy config setting for the Resize Utility
* @type Boolean
*/
this.setAttributeConfig('proxy', {
writeOnce: true,
value: ((attr.proxy === false) ? false : true)
});
/**
* @attribute body
* @description The content for the body. If we find an element in the page with an id that matches the passed option we will move that element into the body of this unit. (sets via innerHTML)
* @type {HTML}
*/
this.setAttributeConfig('body', {
value: attr.body || false,
method: function(content) {
if (!this.body) {
var body = this.getElementsByClassName('yui-layout-bd', 'div')[0];
if (body) {
this.body = body;
} else {
body = document.createElement('div');
body.className = 'yui-layout-bd';
this.body = body;
this.get('wrap').appendChild(body);
}
}
if (!this.header) {
Dom.addClass(this.body, 'yui-layout-bd-nohd');
}
Dom.addClass(this.body, 'yui-layout-bd-noft');
var el = null;
if (Lang.isString(content)) {
el = Dom.get(content);
} else if (content && content.tagName) {
el = content;
}
if (el) {
var id = Dom.generateId(el);
LayoutUnit._instances[id] = this;
this.body.appendChild(el);
} else {
this.body.innerHTML = content;
}
this._cleanGrids();
this.fireEvent('contentChange', { target: 'body' });
}
});
/**
* @attribute footer
* @description The content for the footer. If we find an element in the page with an id that matches the passed option we will move that element into the footer of this unit. (sets via innerHTML)
* @type {HTML}
*/
this.setAttributeConfig('footer', {
value: attr.footer || false,
method: function(content) {
if (content === false) {
//Remove the footer
if (this.footer) {
Dom.addClass(this.body, 'yui-layout-bd-noft');
this.footer.parentNode.removeChild(this.footer);
this.footer = null;
}
} else {
if (!this.footer) {
var ft = this.getElementsByClassName('yui-layout-ft', 'div')[0];
if (!ft) {
ft = document.createElement('div');
ft.className = 'yui-layout-ft';
this.footer = ft;
this.get('wrap').appendChild(ft);
} else {
this.footer = ft;
}
}
var el = null;
if (Lang.isString(content)) {
el = Dom.get(content);
} else if (content && content.tagName) {
el = content;
}
if (el) {
this.footer.appendChild(el);
} else {
this.footer.innerHTML = content;
}
Dom.removeClass(this.body, 'yui-layout-bd-noft');
}
this.fireEvent('contentChange', { target: 'footer' });
}
});
/**
* @attribute close
* @description Adds a close icon to the unit
*/
this.setAttributeConfig('close', {
value: attr.close || false,
method: function(close) {
//Position Center doesn't get this
if (this.get('position') == 'center') {
YAHOO.log('Position center unit cannot have close', 'error', 'LayoutUnit');
return false;
}
if (!this.header && close) {
this._createHeader();
}
if (!this.header) {
return;
}
var c = this.header ? Dom.getElementsByClassName('close', 'div', this.header)[0] : null;
if (close) {
//Force some header text if there isn't any
if (!this.get('header')) {
this.set('header', ' ');
}
if (!c) {
c = document.createElement('div');
c.className = 'close';
this.header.appendChild(c);
Event.on(c, 'click', this.close, this, true);
}
c.title = this.STR_CLOSE;
} else if (c && c.parentNode) {
Event.purgeElement(c);
c.parentNode.removeChild(c);
}
this._configs.close.value = close;
this.set('collapse', this.get('collapse')); //Reset so we get the right classnames
}
});
/**
* @attribute collapse
* @description Adds a collapse icon to the unit
*/
this.setAttributeConfig('collapse', {
value: attr.collapse || false,
method: function(collapse) {
//Position Center doesn't get this
if (this.get('position') == 'center') {
YAHOO.log('Position center unit cannot have collapse', 'error', 'LayoutUnit');
return false;
}
if (!this.header && collapse) {
this._createHeader();
}
if (!this.header) {
return;
}
var c = this.header ? Dom.getElementsByClassName('collapse', 'div', this.header)[0] : null;
if (collapse) {
//Force some header text if there isn't any
if (!this.get('header')) {
this.set('header', ' ');
}
if (!c) {
c = document.createElement('div');
this.header.appendChild(c);
Event.on(c, 'click', this.collapse, this, true);
}
c.title = this.STR_COLLAPSE;
c.className = 'collapse' + ((this.get('close')) ? ' collapse-close' : '');
} else if (c && c.parentNode) {
Event.purgeElement(c);
c.parentNode.removeChild(c);
}
}
});
/**
* @attribute scroll
* @description Adds a class to the unit to allow for overflow: auto (yui-layout-scroll), default is overflow: hidden (yui-layout-noscroll). If true scroll bars will be placed on the element when the content exceeds the given area, false will put overflow hidden to hide the content. Passing null will render the content as usual overflow.
* @type Boolean/Null
*/
this.setAttributeConfig('scroll', {
value: (((attr.scroll === true) || (attr.scroll === false) || (attr.scroll === null)) ? attr.scroll : false),
method: function(scroll) {
if ((scroll === false) && !this._collapsed) { //Removing scroll bar
if (this.body) {
if (this.body.scrollTop > 0) {
this._lastScrollTop = this.body.scrollTop;
}
}
}
if (scroll === true) {
this.addClass('yui-layout-scroll');
this.removeClass('yui-layout-noscroll');
if (this._lastScrollTop > 0) {
if (this.body) {
this.body.scrollTop = this._lastScrollTop;
}
}
} else if (scroll === false) {
this.removeClass('yui-layout-scroll');
this.addClass('yui-layout-noscroll');
} else if (scroll === null) {
this.removeClass('yui-layout-scroll');
this.removeClass('yui-layout-noscroll');
}
}
});
/**
* @attribute hover
* @description Config option to pass to the Resize Utility
*/
this.setAttributeConfig('hover', {
writeOnce: true,
value: attr.hover || false,
validator: YAHOO.lang.isBoolean
});
/**
* @attribute useShim
* @description Config option to pass to the Resize Utility
*/
this.setAttributeConfig('useShim', {
value: attr.useShim || false,
validator: YAHOO.lang.isBoolean,
method: function(u) {
if (this._resize) {
this._resize.set('useShim', u);
}
}
});
/**
* @attribute resize
* @description Should a Resize instance be added to this unit
*/
this.setAttributeConfig('resize', {
value: attr.resize || false,
validator: function(r) {
if (YAHOO.util && YAHOO.util.Resize) {
return true;
}
return false;
},
method: function(resize) {
if (resize && !this._resize) {
//Position Center doesn't get this
if (this.get('position') == 'center') {
YAHOO.log('Position center unit cannot have resize', 'error', 'LayoutUnit');
return false;
}
var handle = false; //To catch center
switch (this.get('position')) {
case 'top':
handle = 'b';
break;
case 'bottom':
handle = 't';
break;
case 'right':
handle = 'l';
break;
case 'left':
handle = 'r';
break;
}
this.setStyle('position', 'absolute'); //Make sure Resize get's a position
if (handle) {
this._resize = new YAHOO.util.Resize(this.get('element'), {
proxy: this.get('proxy'),
hover: this.get('hover'),
status: false,
autoRatio: false,
handles: [handle],
minWidth: this.get('minWidth'),
maxWidth: this.get('maxWidth'),
minHeight: this.get('minHeight'),
maxHeight: this.get('maxHeight'),
height: this.get('height'),
width: this.get('width'),
setSize: false,
useShim: this.get('useShim'),
wrap: false
});
this._resize._handles[handle].innerHTML = '<div class="yui-layout-resize-knob"></div>';
if (this.get('proxy')) {
var proxy = this._resize.getProxyEl();
proxy.innerHTML = '<div class="yui-layout-handle-' + handle + '"></div>';
}
this._resize.on('startResize', function(ev) {
this._lastScroll = this.get('scroll');
this.set('scroll', false);
if (this.get('parent')) {
this.get('parent').fireEvent('startResize');
var c = this.get('parent').getUnitByPosition('center');
this._lastCenterScroll = c.get('scroll');
c.addClass(this._resize.CSS_RESIZING);
c.set('scroll', false);
}
this.fireEvent('startResize');
}, this, true);
this._resize.on('resize', function(ev) {
this.set('height', ev.height);
this.set('width', ev.width);
}, this, true);
this._resize.on('endResize', function(ev) {
this.set('scroll', this._lastScroll);
if (this.get('parent')) {
var c = this.get('parent').getUnitByPosition('center');
c.set('scroll', this._lastCenterScroll);
c.removeClass(this._resize.CSS_RESIZING);
}
this.resize();
this.fireEvent('endResize');
}, this, true);
}
} else {
if (this._resize) {
this._resize.destroy();
}
}
}
});
/**
* The unit data source, used for loading content dynamically.
* @attribute dataSrc
* @type String
*/
this.setAttributeConfig('dataSrc', {
value: attr.dataSrc
});
/**
* The method to use for the data request.
* @attribute loadMethod
* @type String
* @default "GET"
*/
this.setAttributeConfig('loadMethod', {
value: attr.loadMethod || 'GET',
validator: YAHOO.lang.isString
});
/**
* Whether or not any data has been loaded from the server.
* @attribute dataLoaded
* @type Boolean
*/
this.setAttributeConfig('dataLoaded', {
value: false,
validator: YAHOO.lang.isBoolean,
writeOnce: true
});
/**
* Number if milliseconds before aborting and calling failure handler.
* @attribute dataTimeout
* @type Number
* @default null
*/
this.setAttributeConfig('dataTimeout', {
value: attr.dataTimeout || null,
validator: YAHOO.lang.isNumber
});
},
/**
* @private
* @method _cleanGrids
* @description This method attempts to clean up the first level of the YUI CSS Grids, YAHOO.util.Selector is required for this operation.
*/
_cleanGrids: function() {
if (this.get('grids')) {
var b = Sel.query('div.yui-b', this.body, true);
if (b) {
Dom.removeClass(b, 'yui-b');
}
Event.onAvailable('yui-main', function() {
Dom.setStyle(Sel.query('#yui-main'), 'margin-left', '0');
Dom.setStyle(Sel.query('#yui-main'), 'margin-right', '0');
});
}
},
/**
* @private
* @method _createHeader
* @description Creates the HTMLElement for the header
* @return {HTMLElement} The new HTMLElement
*/
_createHeader: function() {
var header = document.createElement('div');
header.className = 'yui-layout-hd';
if (this.get('firstChild')) {
this.get('wrap').insertBefore(header, this.get('wrap').firstChild);
} else {
this.get('wrap').appendChild(header);
}
this.header = header;
return header;
},
/**
* @method destroy
* @param {Boolean} force Don't report to the parent, because we are being called from the parent.
* @description Removes this unit from the parent and cleans up after itself.
* @return {<a href="YAHOO.widget.Layout.html">YAHOO.widget.Layout</a>} The parent Layout instance
*/
destroy: function(force) {
if (this._resize) {
this._resize.destroy();
}
var par = this.get('parent');
this.setStyle('display', 'none');
if (this._clip) {
this._clip.parentNode.removeChild(this._clip);
this._clip = null;
}
if (!force) {
par.removeUnit(this);
}
if (par) {
par.removeListener('resize', this.resize, this, true);
}
this.unsubscribeAll();
Event.purgeElement(this.get('element'), true);
this.get('parentNode').removeChild(this.get('element'));
delete YAHOO.widget.LayoutUnit._instances[this.get('id')];
//Brutal Object Destroy
for (var i in this) {
if (Lang.hasOwnProperty(this, i)) {
this[i] = null;
delete this[i];
}
}
return par;
},
/**
* @method toString
* @description Returns a string representing the LayoutUnit.
* @return {String}
*/
toString: function() {
if (this.get) {
return 'LayoutUnit #' + this.get('id') + ' (' + this.get('position') + ')';
}
return 'LayoutUnit';
}
/**
* @event resize
* @description Fired when this.resize is called
* @type YAHOO.util.CustomEvent
*/
/**
* @event startResize
* @description Fired when the Resize Utility fires it's startResize Event.
* @type YAHOO.util.CustomEvent
*/
/**
* @event endResize
* @description Fired when the Resize Utility fires it's endResize Event.
* @type YAHOO.util.CustomEvent
*/
/**
* @event beforeResize
* @description Fired at the beginning of the resize method. If you return false, the resize is cancelled.
* @type YAHOO.util.CustomEvent
*/
/**
* @event contentChange
* @description Fired when the content in the header, body or footer is changed via the API
* @type YAHOO.util.CustomEvent
*/
/**
* @event close
* @description Fired when the unit is closed
* @type YAHOO.util.CustomEvent
*/
/**
* @event beforeCollapse
* @description Fired before the unit is collapsed. If you return false, the collapse is cancelled.
* @type YAHOO.util.CustomEvent
*/
/**
* @event collapse
* @description Fired when the unit is collapsed
* @type YAHOO.util.CustomEvent
*/
/**
* @event expand
* @description Fired when the unit is exanded
* @type YAHOO.util.CustomEvent
*/
/**
* @event beforeExpand
* @description Fired before the unit is exanded. If you return false, the collapse is cancelled.
* @type YAHOO.util.CustomEvent
*/
/**
* @event load
* @description Fired when data is loaded via the dataSrc config.
* @type YAHOO.util.CustomEvent
*/
/**
* @event loadError
* @description Fired when an error occurs loading data via the dataSrc config. Error message is passed as argument to this event.
* @type YAHOO.util.CustomEvent
*/
});
YAHOO.widget.LayoutUnit = LayoutUnit;
})();