You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
 
 
 
 
 
 

12686 lines
347 KiB

/**
* Jindo2 Framework
* @version 1.5.2
* NHN_Library:Jindo-1.5.2;JavaScript Framework;
*/
/**
* @fileOverview $와 $Class를 정의한 파일
*/
if (typeof window != "undefined" && typeof window.nhn == "undefined") {
window.nhn = {};
}
if (typeof window != "undefined") {
if (typeof window.jindo == "undefined") {
window.jindo = {};
}
} else {
if (!jindo) {
jindo = {};
}
}
/**
* $Jindo 객체를 리턴한다. $Jindo 객체는 프레임웍에 대한 정보와 유틸리티 함수를 제공한다.
* @constructor
* @class $Jindo 객체는 프레임웍에 대한 정보와 유틸리티 함수를 제공한다.
* @description [Lite]
*/
jindo.$Jindo = function() {
var cl=arguments.callee;
var cc=cl._cached;
if (cc) return cc;
if (!(this instanceof cl)) return new cl();
if (!cc) cl._cached = this;
this.version = "1.5.2";
}
/**
* @function
* $ 함수는 다음의 두 가지 역할을 한다.
* <ul><li/>ID를 사용하여 HTML 엘리먼트를 가져온다. 매개변수를 두 개 이상 지정하면 HTML 엘리먼트를 원소로하는 배열을 리턴한다.
* <li>또한 "<tagName>" 과 같은 형식의 문자열을 입력하면 tagName을 가지는 객체를 생성한다.</li></ul>
* @param {String...} sID HTML 엘리먼트의 ID. ID는 하나 이상 지정할 수 있다. (1.4.6부터는 마지막 매개변수에 document을 지정할수 있다.)
* @return {Element|Array} HTML 엘리먼트 혹은 HTML 엘리먼트를 원소로 가지는 배열을 리턴한다. 만약 ID에 해당하는 HTML 엘리먼트가 없으면 null을 리턴한다.
* @description [Lite]
* @example
// ID를 이용하여 객체를 리턴한다.
<div id="div1"></div>
var el = $("div1");
// ID를 이용하여 여러개의 객체를 리턴한다.
<div id="div1"></div>
<div id="div2"></div>
var els = $("div1","div2"); // [$("div1"),$("div2")]와 같은 결과를 리턴한다.
// tagName과 같은 형식의 문자열을 이용하여 객체를 생성한다.
var el = $("<DIV>");
var els = $("<DIV id='div1'><SPAN>hello</SPAN></DIV>");
//IE는 iframe에 추가할 엘리먼트를 생성하려고 할 때는 document를 반드시 지정해야 한다.(1.4.6 부터 지원)
var els = $("<div>" , iframe.contentWindow.document);
//위와 같을 경우 div태그가 iframe.contentWindow.document기준으로 생김.
*/
jindo.$ = function(sID/*, id1, id2*/) {
var ret = [], arg = arguments, nArgLeng = arg.length, lastArgument = arg[nArgLeng-1],doc = document,el = null;
var reg = /^<([a-z]+|h[1-5])>$/i;
var reg2 = /^<([a-z]+|h[1-5])(\s+[^>]+)?>/i;
if (nArgLeng > 1 && typeof lastArgument != "string" && lastArgument.body) {
/*
마지막 인자가 document일때.
*/
arg = Array.prototype.slice.apply(arg,[0,nArgLeng-1]);
doc = lastArgument;
}
for(var i=0; i < nArgLeng; i++) {
el = arg[i];
if (typeof el == "string") {
el = el.replace(/^\s+|\s+$/g, "");
if (el.indexOf("<")>-1) {
if (reg.test(el)) {
el = doc.createElement(RegExp.$1);
}else if (reg2.test(el)) {
var p = { thead:'table', tbody:'table', tr:'tbody', td:'tr', dt:'dl', dd:'dl', li:'ul', legend:'fieldset',option:"select" };
var tag = RegExp.$1.toLowerCase();
var ele = jindo._createEle(p[tag],el,doc);
for (var i=0,leng = ele.length; i < leng ; i++) {
ret.push(ele[i]);
};
el = null;
}
}else {
el = doc.getElementById(el);
}
}
if (el) ret[ret.length] = el;
}
return ret.length>1?ret:(ret[0] || null);
}
jindo._createEle = function(sParentTag,sHTML,oDoc,bWantParent){
var sId = 'R' + new Date().getTime() + parseInt(Math.random() * 100000,10);
var oDummy = oDoc.createElement("div");
switch (sParentTag) {
case 'select':
case 'table':
case 'dl':
case 'ul':
case 'fieldset':
oDummy.innerHTML = '<' + sParentTag + ' class="' + sId + '">' + sHTML + '</' + sParentTag + '>';
break;
case 'thead':
case 'tbody':
case 'col':
oDummy.innerHTML = '<table><' + sParentTag + ' class="' + sId + '">' + sHTML + '</' + sParentTag + '></table>';
break;
case 'tr':
oDummy.innerHTML = '<table><tbody><tr class="' + sId + '">' + sHTML + '</tr></tbody></table>';
break;
default:
oDummy.innerHTML = '<div class="' + sId + '">' + sHTML + '</div>';
break;
}
var oFound;
for (oFound = oDummy.firstChild; oFound; oFound = oFound.firstChild){
if (oFound.className==sId) break;
}
return bWantParent? oFound : oFound.childNodes;
}
/**
* 클래스 객체를 생성한다.
* @extends core
* @class $Class는 Jindo에서 객체 지향 프로그래밍(OOP)를 구현하는 객체이다. $Class.$init 메소드는 클래스를 생성할 때 클래스 인스턴스에 대한 생성자 함수를 정의한다.
* @param {Object} oDef 클래스를 정의하는 객체. 메서드, 프로퍼티와 생성자를 정의한다. $staic 키워드는 인스턴스를 생성하지 않아도 사용할 수 있는 메서드의 집합이다.
* @return {$Class} 클래스 객체
* @description [Lite]
* @example
var CClass = $Class({
prop : null,
$init : function() {
this.prop = $Ajax();
...
},
$static : {
static_method : function(){ return 1;}
}
});
var c1 = new CClass();
var c2 = new CClass();
// c1과 c2는 서로 다른 $Ajax 객체를 각각 가진다.
CClass.static_method(); -> 1
*/
jindo.$Class = function(oDef) {
function typeClass() {
var t = this;
var a = [];
var superFunc = function(m, superClass, func) {
if(m!='constructor' && func.toString().indexOf("$super")>-1 ){
var funcArg = func.toString().replace(/function\s*\(([^\)]*)[\w\W]*/g,"$1").split(",");
// var funcStr = func.toString().replace(/function\s*\(.*\)\s*\{/,"").replace(/this\.\$super/g,"this.$super.$super");
var funcStr = func.toString().replace(/function[^{]*{/,"").replace(/(\w|\.?)(this\.\$super|this)/g,function(m,m2,m3){
if(!m2){
return m3+".$super"
}
return m;
});
funcStr = funcStr.substr(0,funcStr.length-1);
func = superClass[m] = eval("false||function("+funcArg.join(",")+"){"+funcStr+"}");
}
return function() {
var f = this.$this[m];
var t = this.$this;
var r = (t[m] = func).apply(t, arguments);
t[m] = f;
return r;
};
}
while(typeof t._$superClass != "undefined") {
t.$super = new Object;
t.$super.$this = this;
for(var x in t._$superClass.prototype) {
if (t._$superClass.prototype.hasOwnProperty(x)){
if (typeof this[x] == "undefined" && x !="$init") this[x] = t._$superClass.prototype[x];
if (x!='constructor' && x!='_$superClass' && typeof t._$superClass.prototype[x] == "function") {
t.$super[x] = superFunc(x, t._$superClass, t._$superClass.prototype[x]);
} else {
t.$super[x] = t._$superClass.prototype[x];
}
}
}
if (typeof t.$super.$init == "function") a[a.length] = t;
t = t.$super;
}
for(var i=a.length-1; i > -1; i--) a[i].$super.$init.apply(a[i].$super, arguments);
if (typeof this.$init == "function") this.$init.apply(this,arguments);
}
if (typeof oDef.$static != "undefined") {
var i=0, x;
for(x in oDef){
if (oDef.hasOwnProperty(x)) {
x=="$static"||i++;
}
}
for(x in oDef.$static){
if (oDef.$static.hasOwnProperty(x)) {
typeClass[x] = oDef.$static[x];
}
}
if (!i) return oDef.$static;
delete oDef.$static;
}
// if (typeof oDef.$destroy == "undefined") {
// oDef.$destroy = function(){
// if(this.$super&&(arguments.callee==this.$super.$destroy)){this.$super.$destroy();}
// }
// } else {
// oDef.$destroy = eval("false||"+oDef.$destroy.toString().replace(/\}$/,"console.log(this.$super);console.log(arguments.callee!=this.$super.$destroy);if(this.$super&&(arguments.callee==this.$destroy)){this.$super.$destroy();}}"));
// }
//
typeClass.prototype = oDef;
typeClass.prototype.constructor = typeClass;
typeClass.extend = jindo.$Class.extend;
return typeClass;
}
/**
* 클래스를 상속한다.
* 하위 클래스는 this.$super.method 로 상위 클래스의 메서드에 접근할 수 있으나, this.$super.$super.method 와 같이 한 단계 이상의 상위 클래스는 접근할 수 없다.
* @name $Class#extend
* @type $Class
* @function
* @param {$Class} superClass 수퍼 클래스 객체
* @return {$Class} 상속된 클래스
* @description [Lite]
* @example
var ClassExt = $Class(classDefinition);
ClassExt.extend(superClass);
// ClassExt는 SuperClass를 상속받는다.
*/
jindo.$Class.extend = function(superClass) {
// superClass._$has_super = true;
if (typeof superClass == "undefined" || superClass === null || !superClass.extend) {
throw new Error("extend시 슈퍼 클래스는 Class여야 합니다.");
}
this.prototype._$superClass = superClass;
// inherit static methods of parent
for(var x in superClass) {
if (superClass.hasOwnProperty(x)) {
if (x == "prototype") continue;
this[x] = superClass[x];
}
}
return this;
};
/**
부모 클래스의 메서드에 접근할 때 사용한다. 부모 클래스와 자식 클래스가 같은 이름의 메서드를 가지고 있고 $super로 그 메서드를 호출하면, 자식 클래스의 메서드를 사용한다.
@name $Class#$super
@type $Class
@example
var Parent = $Class ({
a: 100,
b: 200,
c: 300,
sum2: function () {
var init = this.sum();
return init;
},
sum: function () {
return this.a + this.b
}
});
var Child = $Class ({
a: 10,
b: 20,
sum2 : function () {
var init = this.sum();
return init;
},
sum: function () {
return this.b;
}
}).extend (Parent);
var oChild = new Child();
var oParent = new Parent();
oChild.sum(); // 20
oChild.sum2(); // 20
oChild.$super.sum(); // 30 -> 부모 클래스의 100(a)과 200(b)대신 자식 클래스의 10(a)과 20(b)을 더한다.
oChild.$super.sum2(); // 20 -> 부모 클래스의 sum2 메서드에서 부모 클래스의 sum()이 아닌 자식 클래스의 sum()을 호출한다.
*/
/**
* @fileOverview CSS 셀렉터를 사용한 엘리먼트 선택 엔진
* @name cssquery.js
* @author Hooriza
*/
/**
* CSS 셀렉터를 사용하여 객체를 탐색한다.
*
* @function CSS 셀렉터를 사용하여 객체를 탐색한다.
* @param {String} CSS셀렉터
* @param {Element} 탐색 대상이 되는 요소, 요소의 하위 노드에서만 탐색한다.
* @return {Array} 조건에 해당하는 요소의 배열을 반환한다.
* @description [Lite]
* @example
// 문서에서 IMG 태그를 찾는다.
var imgs = $$('IMG');
// div 요소 하위에서 IMG 태그를 찾는다.
var imgsInDiv = $$('IMG', $('div'));
// 문서에서 IMG 태그 중 가장 첫 요소를 찾는다.
var firstImg = $$.getSingle('IMG');
*/
jindo.$$ = jindo.cssquery = (function() {
/*
querySelector 설정.
*/
var sVersion = '3.0';
var debugOption = { repeat : 1 };
/*
빠른 처리를 위해 노드마다 유일키 값 셋팅
*/
var UID = 1;
var cost = 0;
var validUID = {};
var bSupportByClassName = document.getElementsByClassName ? true : false;
var safeHTML = false;
var getUID4HTML = function(oEl) {
var nUID = safeHTML ? (oEl._cssquery_UID && oEl._cssquery_UID[0]) : oEl._cssquery_UID;
if (nUID && validUID[nUID] == oEl) return nUID;
nUID = UID++;
oEl._cssquery_UID = safeHTML ? [ nUID ] : nUID;
validUID[nUID] = oEl;
return nUID;
};
var getUID4XML = function(oEl) {
var oAttr = oEl.getAttribute('_cssquery_UID');
var nUID = safeHTML ? (oAttr && oAttr[0]) : oAttr;
if (!nUID) {
nUID = UID++;
oEl.setAttribute('_cssquery_UID', safeHTML ? [ nUID ] : nUID);
}
return nUID;
};
var getUID = getUID4HTML;
var uniqid = function(sPrefix) {
return (sPrefix || '') + new Date().getTime() + parseInt(Math.random() * 100000000,10);
};
function getElementsByClass(searchClass,node,tag) {
var classElements = new Array();
if ( node == null )
node = document;
if ( tag == null )
tag = '*';
var els = node.getElementsByTagName(tag);
var elsLen = els.length;
var pattern = new RegExp("(^|\\s)"+searchClass+"(\\s|$)");
for (i = 0, j = 0; i < elsLen; i++) {
if ( pattern.test(els[i].className) ) {
classElements[j] = els[i];
j++;
}
}
return classElements;
}
var getChilds_dontShrink = function(oEl, sTagName, sClassName) {
if (bSupportByClassName && sClassName) {
if(oEl.getElementsByClassName)
return oEl.getElementsByClassName(sClassName);
if(oEl.querySelectorAll)
return oEl.querySelectorAll(sClassName);
return getElementsByClass(sClassName, oEl, sTagName);
}else if (sTagName == '*') {
return oEl.all || oEl.getElementsByTagName(sTagName);
}
return oEl.getElementsByTagName(sTagName);
};
var clearKeys = function() {
backupKeys._keys = {};
};
var oDocument_dontShrink = document;
var bXMLDocument = false;
/*
따옴표, [] 등 파싱에 문제가 될 수 있는 부분 replace 시켜놓기
*/
var backupKeys = function(sQuery) {
var oKeys = backupKeys._keys;
/*
작은 따옴표 걷어내기
*/
sQuery = sQuery.replace(/'(\\'|[^'])*'/g, function(sAll) {
var uid = uniqid('QUOT');
oKeys[uid] = sAll;
return uid;
});
/*
큰 따옴표 걷어내기
*/
sQuery = sQuery.replace(/"(\\"|[^"])*"/g, function(sAll) {
var uid = uniqid('QUOT');
oKeys[uid] = sAll;
return uid;
});
/*
[ ] 형태 걷어내기
*/
sQuery = sQuery.replace(/\[(.*?)\]/g, function(sAll, sBody) {
if (sBody.indexOf('ATTR') == 0) return sAll;
var uid = '[' + uniqid('ATTR') + ']';
oKeys[uid] = sAll;
return uid;
});
/*
( ) 형태 걷어내기
*/
var bChanged;
do {
bChanged = false;
sQuery = sQuery.replace(/\(((\\\)|[^)|^(])*)\)/g, function(sAll, sBody) {
if (sBody.indexOf('BRCE') == 0) return sAll;
var uid = '_' + uniqid('BRCE');
oKeys[uid] = sAll;
bChanged = true;
return uid;
});
} while(bChanged);
return sQuery;
};
/*
replace 시켜놓은 부분 복구하기
*/
var restoreKeys = function(sQuery, bOnlyAttrBrace) {
var oKeys = backupKeys._keys;
var bChanged;
var rRegex = bOnlyAttrBrace ? /(\[ATTR[0-9]+\])/g : /(QUOT[0-9]+|\[ATTR[0-9]+\])/g;
do {
bChanged = false;
sQuery = sQuery.replace(rRegex, function(sKey) {
if (oKeys[sKey]) {
bChanged = true;
return oKeys[sKey];
}
return sKey;
});
} while(bChanged);
/*
( ) 는 한꺼풀만 벗겨내기
*/
sQuery = sQuery.replace(/_BRCE[0-9]+/g, function(sKey) {
return oKeys[sKey] ? oKeys[sKey] : sKey;
});
return sQuery;
};
/*
replace 시켜놓은 문자열에서 Quot 을 제외하고 리턴
*/
var restoreString = function(sKey) {
var oKeys = backupKeys._keys;
var sOrg = oKeys[sKey];
if (!sOrg) return sKey;
return eval(sOrg);
};
var wrapQuot = function(sStr) {
return '"' + sStr.replace(/"/g, '\\"') + '"';
};
var getStyleKey = function(sKey) {
if (/^@/.test(sKey)) return sKey.substr(1);
return null;
};
var getCSS = function(oEl, sKey) {
if (oEl.currentStyle) {
if (sKey == "float") sKey = "styleFloat";
return oEl.currentStyle[sKey] || oEl.style[sKey];
} else if (window.getComputedStyle) {
return oDocument_dontShrink.defaultView.getComputedStyle(oEl, null).getPropertyValue(sKey.replace(/([A-Z])/g,"-$1").toLowerCase()) || oEl.style[sKey];
}
if (sKey == "float" && /MSIE/.test(window.navigator.userAgent)) sKey = "styleFloat";
return oEl.style[sKey];
};
var oCamels = {
'accesskey' : 'accessKey',
'cellspacing' : 'cellSpacing',
'cellpadding' : 'cellPadding',
'class' : 'className',
'colspan' : 'colSpan',
'for' : 'htmlFor',
'maxlength' : 'maxLength',
'readonly' : 'readOnly',
'rowspan' : 'rowSpan',
'tabindex' : 'tabIndex',
'valign' : 'vAlign'
};
var getDefineCode = function(sKey) {
var sVal;
var sStyleKey;
if (bXMLDocument) {
sVal = 'oEl.getAttribute("' + sKey + '",2)';
} else {
if (sStyleKey = getStyleKey(sKey)) {
sKey = '$$' + sStyleKey;
sVal = 'getCSS(oEl, "' + sStyleKey + '")';
} else {
switch (sKey) {
case 'checked':
sVal = 'oEl.checked + ""';
break;
case 'disabled':
sVal = 'oEl.disabled + ""';
break;
case 'enabled':
sVal = '!oEl.disabled + ""';
break;
case 'readonly':
sVal = 'oEl.readOnly + ""';
break;
case 'selected':
sVal = 'oEl.selected + ""';
break;
default:
if (oCamels[sKey]) {
sVal = 'oEl.' + oCamels[sKey];
} else {
sVal = 'oEl.getAttribute("' + sKey + '",2)';
}
}
}
}
return '_' + sKey + ' = ' + sVal;
};
var getReturnCode = function(oExpr) {
var sStyleKey = getStyleKey(oExpr.key);
var sVar = '_' + (sStyleKey ? '$$' + sStyleKey : oExpr.key);
var sVal = oExpr.val ? wrapQuot(oExpr.val) : '';
switch (oExpr.op) {
case '~=':
return '(' + sVar + ' && (" " + ' + sVar + ' + " ").indexOf(" " + ' + sVal + ' + " ") > -1)';
case '^=':
return '(' + sVar + ' && ' + sVar + '.indexOf(' + sVal + ') == 0)';
case '$=':
return '(' + sVar + ' && ' + sVar + '.substr(' + sVar + '.length - ' + oExpr.val.length + ') == ' + sVal + ')';
case '*=':
return '(' + sVar + ' && ' + sVar + '.indexOf(' + sVal + ') > -1)';
case '!=':
return '(' + sVar + ' != ' + sVal + ')';
case '=':
return '(' + sVar + ' == ' + sVal + ')';
}
return '(' + sVar + ')';
};
var getNodeIndex = function(oEl) {
var nUID = getUID(oEl);
var nIndex = oNodeIndexes[nUID] || 0;
/*
노드 인덱스를 구할 수 없으면
*/
if (nIndex == 0) {
for (var oSib = (oEl.parentNode || oEl._IE5_parentNode).firstChild; oSib; oSib = oSib.nextSibling) {
if (oSib.nodeType != 1){
continue;
}
nIndex++;
setNodeIndex(oSib, nIndex);
}
nIndex = oNodeIndexes[nUID];
}
return nIndex;
};
/*
몇번째 자식인지 설정하는 부분
*/
var oNodeIndexes = {};
var setNodeIndex = function(oEl, nIndex) {
var nUID = getUID(oEl);
oNodeIndexes[nUID] = nIndex;
};
var unsetNodeIndexes = function() {
setTimeout(function() { oNodeIndexes = {}; }, 0);
};
/*
가상 클래스
*/
var oPseudoes_dontShrink = {
'contains' : function(oEl, sOption) {
return (oEl.innerText || oEl.textContent || '').indexOf(sOption) > -1;
},
'last-child' : function(oEl, sOption) {
for (oEl = oEl.nextSibling; oEl; oEl = oEl.nextSibling){
if (oEl.nodeType == 1)
return false;
}
return true;
},
'first-child' : function(oEl, sOption) {
for (oEl = oEl.previousSibling; oEl; oEl = oEl.previousSibling){
if (oEl.nodeType == 1)
return false;
}
return true;
},
'only-child' : function(oEl, sOption) {
var nChild = 0;
for (var oChild = (oEl.parentNode || oEl._IE5_parentNode).firstChild; oChild; oChild = oChild.nextSibling) {
if (oChild.nodeType == 1) nChild++;
if (nChild > 1) return false;
}
return nChild ? true : false;
},
'empty' : function(oEl, _) {
return oEl.firstChild ? false : true;
},
'nth-child' : function(oEl, nMul, nAdd) {
var nIndex = getNodeIndex(oEl);
return nIndex % nMul == nAdd;
},
'nth-last-child' : function(oEl, nMul, nAdd) {
var oLast = (oEl.parentNode || oEl._IE5_parentNode).lastChild;
for (; oLast; oLast = oLast.previousSibling){
if (oLast.nodeType == 1) break;
}
var nTotal = getNodeIndex(oLast);
var nIndex = getNodeIndex(oEl);
var nLastIndex = nTotal - nIndex + 1;
return nLastIndex % nMul == nAdd;
},
'checked' : function(oEl){
return !!oEl.checked;
},
'selected' : function(oEl){
return !!oEl.selected;
},
'enabled' : function(oEl){
return !oEl.disabled;
},
'disabled' : function(oEl){
return !!oEl.disabled;
}
};
/*
단일 part 의 body 에서 expression 뽑아냄
*/
var getExpression = function(sBody) {
var oRet = { defines : '', returns : 'true' };
var sBody = restoreKeys(sBody, true);
var aExprs = [];
var aDefineCode = [], aReturnCode = [];
var sId, sTagName;
/*
유사클래스 조건 얻어내기
*/
var sBody = sBody.replace(/:([\w-]+)(\(([^)]*)\))?/g, function(_1, sType, _2, sOption) {
switch (sType) {
case 'not':
/*
괄호 안에 있는거 재귀파싱하기
*/
var oInner = getExpression(sOption);
var sFuncDefines = oInner.defines;
var sFuncReturns = oInner.returnsID + oInner.returnsTAG + oInner.returns;
aReturnCode.push('!(function() { ' + sFuncDefines + ' return ' + sFuncReturns + ' })()');
break;
case 'nth-child':
case 'nth-last-child':
sOption = restoreString(sOption);
if (sOption == 'even'){
sOption = '2n';
}else if (sOption == 'odd') {
sOption = '2n+1';
}
var nMul, nAdd;
var matchstr = sOption.match(/([0-9]*)n([+-][0-9]+)*/);
if (matchstr) {
nMul = matchstr[1] || 1;
nAdd = matchstr[2] || 0;
} else {
nMul = Infinity;
nAdd = parseInt(sOption,10);
}
aReturnCode.push('oPseudoes_dontShrink[' + wrapQuot(sType) + '](oEl, ' + nMul + ', ' + nAdd + ')');
break;
case 'first-of-type':
case 'last-of-type':
sType = (sType == 'first-of-type' ? 'nth-of-type' : 'nth-last-of-type');
sOption = 1;
case 'nth-of-type':
case 'nth-last-of-type':
sOption = restoreString(sOption);
if (sOption == 'even') {
sOption = '2n';
}else if (sOption == 'odd'){
sOption = '2n+1';
}
var nMul, nAdd;
if (/([0-9]*)n([+-][0-9]+)*/.test(sOption)) {
nMul = parseInt(RegExp.$1,10) || 1;
nAdd = parseInt(RegExp.$2,20) || 0;
} else {
nMul = Infinity;
nAdd = parseInt(sOption,10);
}
oRet.nth = [ nMul, nAdd, sType ];
break;
default:
sOption = sOption ? restoreString(sOption) : '';
aReturnCode.push('oPseudoes_dontShrink[' + wrapQuot(sType) + '](oEl, ' + wrapQuot(sOption) + ')');
break;
}
return '';
});
/*
[key=value] 형태 조건 얻어내기
*/
var sBody = sBody.replace(/\[(@?[\w-]+)(([!^~$*]?=)([^\]]*))?\]/g, function(_1, sKey, _2, sOp, sVal) {
sKey = restoreString(sKey);
sVal = restoreString(sVal);
if (sKey == 'checked' || sKey == 'disabled' || sKey == 'enabled' || sKey == 'readonly' || sKey == 'selected') {
if (!sVal) {
sOp = '=';
sVal = 'true';
}
}
aExprs.push({ key : sKey, op : sOp, val : sVal });
return '';
});
var sClassName = null;
/*
클래스 조건 얻어내기
*/
var sBody = sBody.replace(/\.([\w-]+)/g, function(_, sClass) {
aExprs.push({ key : 'class', op : '~=', val : sClass });
if (!sClassName) sClassName = sClass;
return '';
});
/*
id 조건 얻어내기
*/
var sBody = sBody.replace(/#([\w-]+)/g, function(_, sIdValue) {
if (bXMLDocument) {
aExprs.push({ key : 'id', op : '=', val : sIdValue });
}else{
sId = sIdValue;
}
return '';
});
sTagName = sBody == '*' ? '' : sBody;
/*
match 함수 코드 만들어 내기
*/
var oVars = {};
for (var i = 0, oExpr; oExpr = aExprs[i]; i++) {
var sKey = oExpr.key;
if (!oVars[sKey]) aDefineCode.push(getDefineCode(sKey));
/*
유사클래스 조건 검사가 맨 뒤로 가도록 unshift 사용
*/
aReturnCode.unshift(getReturnCode(oExpr));
oVars[sKey] = true;
}
if (aDefineCode.length) oRet.defines = 'var ' + aDefineCode.join(',') + ';';
if (aReturnCode.length) oRet.returns = aReturnCode.join('&&');
oRet.quotID = sId ? wrapQuot(sId) : '';
oRet.quotTAG = sTagName ? wrapQuot(bXMLDocument ? sTagName : sTagName.toUpperCase()) : '';
if (bSupportByClassName) oRet.quotCLASS = sClassName ? wrapQuot(sClassName) : '';
oRet.returnsID = sId ? 'oEl.id == ' + oRet.quotID + ' && ' : '';
oRet.returnsTAG = sTagName && sTagName != '*' ? 'oEl.tagName == ' + oRet.quotTAG + ' && ' : '';
return oRet;
};
/*
쿼리를 연산자 기준으로 잘라냄
*/
var splitToParts = function(sQuery) {
var aParts = [];
var sRel = ' ';
var sBody = sQuery.replace(/(.*?)\s*(!?[+>~ ]|!)\s*/g, function(_, sBody, sRelative) {
if (sBody) aParts.push({ rel : sRel, body : sBody });
sRel = sRelative.replace(/\s+$/g, '') || ' ';
return '';
});
if (sBody) aParts.push({ rel : sRel, body : sBody });
return aParts;
};
var isNth_dontShrink = function(oEl, sTagName, nMul, nAdd, sDirection) {
var nIndex = 0;
for (var oSib = oEl; oSib; oSib = oSib[sDirection]){
if (oSib.nodeType == 1 && (!sTagName || sTagName == oSib.tagName))
nIndex++;
}
return nIndex % nMul == nAdd;
};
/*
잘라낸 part 를 함수로 컴파일 하기
*/
var compileParts = function(aParts) {
var aPartExprs = [];
/*
잘라낸 부분들 조건 만들기
*/
for (var i = 0, oPart; oPart = aParts[i]; i++)
aPartExprs.push(getExpression(oPart.body));
//////////////////// BEGIN
var sFunc = '';
var sPushCode = 'aRet.push(oEl); if (oOptions.single) { bStop = true; }';
for (var i = aParts.length - 1, oPart; oPart = aParts[i]; i--) {
var oExpr = aPartExprs[i];
var sPush = (debugOption.callback ? 'cost++;' : '') + oExpr.defines;
var sReturn = 'if (bStop) {' + (i == 0 ? 'return aRet;' : 'return;') + '}';
if (oExpr.returns == 'true') {
sPush += (sFunc ? sFunc + '(oEl);' : sPushCode) + sReturn;
}else{
sPush += 'if (' + oExpr.returns + ') {' + (sFunc ? sFunc + '(oEl);' : sPushCode ) + sReturn + '}';
}
var sCheckTag = 'oEl.nodeType != 1';
if (oExpr.quotTAG) sCheckTag = 'oEl.tagName != ' + oExpr.quotTAG;
var sTmpFunc =
'(function(oBase' +
(i == 0 ? ', oOptions) { var bStop = false; var aRet = [];' : ') {');
if (oExpr.nth) {
sPush =
'if (isNth_dontShrink(oEl, ' +
(oExpr.quotTAG ? oExpr.quotTAG : 'false') + ',' +
oExpr.nth[0] + ',' +
oExpr.nth[1] + ',' +
'"' + (oExpr.nth[2] == 'nth-of-type' ? 'previousSibling' : 'nextSibling') + '")) {' + sPush + '}';
}
switch (oPart.rel) {
case ' ':
if (oExpr.quotID) {
sTmpFunc +=
'var oEl = oDocument_dontShrink.getElementById(' + oExpr.quotID + ');' +
'var oCandi = oEl;' +
'for (; oCandi; oCandi = (oCandi.parentNode || oCandi._IE5_parentNode)) {' +
'if (oCandi == oBase) break;' +
'}' +
'if (!oCandi || ' + sCheckTag + ') return aRet;' +
sPush;
} else {
sTmpFunc +=
'var aCandi = getChilds_dontShrink(oBase, ' + (oExpr.quotTAG || '"*"') + ', ' + (oExpr.quotCLASS || 'null') + ');' +
'for (var i = 0, oEl; oEl = aCandi[i]; i++) {' +
(oExpr.quotCLASS ? 'if (' + sCheckTag + ') continue;' : '') +
sPush +
'}';
}
break;
case '>':
if (oExpr.quotID) {
sTmpFunc +=
'var oEl = oDocument_dontShrink.getElementById(' + oExpr.quotID + ');' +
'if ((oEl.parentNode || oEl._IE5_parentNode) != oBase || ' + sCheckTag + ') return aRet;' +
sPush;
} else {
sTmpFunc +=
'for (var oEl = oBase.firstChild; oEl; oEl = oEl.nextSibling) {' +
'if (' + sCheckTag + ') { continue; }' +
sPush +
'}';
}
break;
case '+':
if (oExpr.quotID) {
sTmpFunc +=
'var oEl = oDocument_dontShrink.getElementById(' + oExpr.quotID + ');' +
'var oPrev;' +
'for (oPrev = oEl.previousSibling; oPrev; oPrev = oPrev.previousSibling) { if (oPrev.nodeType == 1) break; }' +
'if (!oPrev || oPrev != oBase || ' + sCheckTag + ') return aRet;' +
sPush;
} else {
sTmpFunc +=
'for (var oEl = oBase.nextSibling; oEl; oEl = oEl.nextSibling) { if (oEl.nodeType == 1) break; }' +
'if (!oEl || ' + sCheckTag + ') { return aRet; }' +
sPush;
}
break;
case '~':
if (oExpr.quotID) {
sTmpFunc +=
'var oEl = oDocument_dontShrink.getElementById(' + oExpr.quotID + ');' +
'var oCandi = oEl;' +
'for (; oCandi; oCandi = oCandi.previousSibling) { if (oCandi == oBase) break; }' +
'if (!oCandi || ' + sCheckTag + ') return aRet;' +
sPush;
} else {
sTmpFunc +=
'for (var oEl = oBase.nextSibling; oEl; oEl = oEl.nextSibling) {' +
'if (' + sCheckTag + ') { continue; }' +
'if (!markElement_dontShrink(oEl, ' + i + ')) { break; }' +
sPush +
'}';
}
break;
case '!' :
if (oExpr.quotID) {
sTmpFunc +=
'var oEl = oDocument_dontShrink.getElementById(' + oExpr.quotID + ');' +
'for (; oBase; oBase = (oBase.parentNode || oBase._IE5_parentNode)) { if (oBase == oEl) break; }' +
'if (!oBase || ' + sCheckTag + ') return aRet;' +
sPush;
} else {
sTmpFunc +=
'for (var oEl = (oBase.parentNode || oBase._IE5_parentNode); oEl; oEl = (oEl.parentNode || oEl._IE5_parentNode)) {'+
'if (' + sCheckTag + ') { continue; }' +
sPush +
'}';
}
break;
case '!>' :
if (oExpr.quotID) {
sTmpFunc +=
'var oEl = oDocument_dontShrink.getElementById(' + oExpr.quotID + ');' +
'var oRel = (oBase.parentNode || oBase._IE5_parentNode);' +
'if (!oRel || oEl != oRel || (' + sCheckTag + ')) return aRet;' +
sPush;
} else {
sTmpFunc +=
'var oEl = (oBase.parentNode || oBase._IE5_parentNode);' +
'if (!oEl || ' + sCheckTag + ') { return aRet; }' +
sPush;
}
break;
case '!+' :
if (oExpr.quotID) {
sTmpFunc +=
'var oEl = oDocument_dontShrink.getElementById(' + oExpr.quotID + ');' +
'var oRel;' +
'for (oRel = oBase.previousSibling; oRel; oRel = oRel.previousSibling) { if (oRel.nodeType == 1) break; }' +
'if (!oRel || oEl != oRel || (' + sCheckTag + ')) return aRet;' +
sPush;
} else {
sTmpFunc +=
'for (oEl = oBase.previousSibling; oEl; oEl = oEl.previousSibling) { if (oEl.nodeType == 1) break; }' +
'if (!oEl || ' + sCheckTag + ') { return aRet; }' +
sPush;
}
break;
case '!~' :
if (oExpr.quotID) {
sTmpFunc +=
'var oEl = oDocument_dontShrink.getElementById(' + oExpr.quotID + ');' +
'var oRel;' +
'for (oRel = oBase.previousSibling; oRel; oRel = oRel.previousSibling) { ' +
'if (oRel.nodeType != 1) { continue; }' +
'if (oRel == oEl) { break; }' +
'}' +
'if (!oRel || (' + sCheckTag + ')) return aRet;' +
sPush;
} else {
sTmpFunc +=
'for (oEl = oBase.previousSibling; oEl; oEl = oEl.previousSibling) {' +
'if (' + sCheckTag + ') { continue; }' +
'if (!markElement_dontShrink(oEl, ' + i + ')) { break; }' +
sPush +
'}';
}
break;
}
sTmpFunc +=
(i == 0 ? 'return aRet;' : '') +
'})';
sFunc = sTmpFunc;
}
eval('var fpCompiled = ' + sFunc + ';');
return fpCompiled;
};
/*
쿼리를 match 함수로 변환
*/
var parseQuery = function(sQuery) {
var sCacheKey = sQuery;
var fpSelf = arguments.callee;
var fpFunction = fpSelf._cache[sCacheKey];
if (!fpFunction) {
sQuery = backupKeys(sQuery);
var aParts = splitToParts(sQuery);
fpFunction = fpSelf._cache[sCacheKey] = compileParts(aParts);
fpFunction.depth = aParts.length;
}
return fpFunction;
};
parseQuery._cache = {};
/*
test 쿼리를 match 함수로 변환
*/
var parseTestQuery = function(sQuery) {
var fpSelf = arguments.callee;
var aSplitQuery = backupKeys(sQuery).split(/\s*,\s*/);
var aResult = [];
var nLen = aSplitQuery.length;
var aFunc = [];
for (var i = 0; i < nLen; i++) {
aFunc.push((function(sQuery) {
var sCacheKey = sQuery;
var fpFunction = fpSelf._cache[sCacheKey];
if (!fpFunction) {
sQuery = backupKeys(sQuery);
var oExpr = getExpression(sQuery);
eval('fpFunction = function(oEl) { ' + oExpr.defines + 'return (' + oExpr.returnsID + oExpr.returnsTAG + oExpr.returns + '); };');
}
return fpFunction;
})(restoreKeys(aSplitQuery[i])));
}
return aFunc;
};
parseTestQuery._cache = {};
var distinct = function(aList) {
var aDistinct = [];
var oDummy = {};
for (var i = 0, oEl; oEl = aList[i]; i++) {
var nUID = getUID(oEl);
if (oDummy[nUID]) continue;
aDistinct.push(oEl);
oDummy[nUID] = true;
}
return aDistinct;
};
var markElement_dontShrink = function(oEl, nDepth) {
var nUID = getUID(oEl);
if (cssquery._marked[nDepth][nUID]) return false;
cssquery._marked[nDepth][nUID] = true;
return true;
};
var oResultCache = null;
var bUseResultCache = false;
var bExtremeMode = false;
var old_cssquery = function(sQuery, oParent, oOptions) {
if (typeof sQuery == 'object') {
var oResult = {};
for (var k in sQuery){
if(sQuery.hasOwnProperty(k))
oResult[k] = arguments.callee(sQuery[k], oParent, oOptions);
}
return oResult;
}
cost = 0;
var executeTime = new Date().getTime();
var aRet;
for (var r = 0, rp = debugOption.repeat; r < rp; r++) {
aRet = (function(sQuery, oParent, oOptions) {
if(oOptions){
if(!oOptions.oneTimeOffCache){
oOptions.oneTimeOffCache = false;
}
}else{
oOptions = {oneTimeOffCache:false};
}
cssquery.safeHTML(oOptions.oneTimeOffCache);
if (!oParent) oParent = document;
/*
ownerDocument 잡아주기
*/
oDocument_dontShrink = oParent.ownerDocument || oParent.document || oParent;
/*
브라우저 버젼이 IE5.5 이하
*/
if (/\bMSIE\s([0-9]+(\.[0-9]+)*);/.test(navigator.userAgent) && parseFloat(RegExp.$1) < 6) {
try { oDocument_dontShrink.location; } catch(e) { oDocument_dontShrink = document; }
oDocument_dontShrink.firstChild = oDocument_dontShrink.getElementsByTagName('html')[0];
oDocument_dontShrink.firstChild._IE5_parentNode = oDocument_dontShrink;
}
/*
XMLDocument 인지 체크
*/
bXMLDocument = (typeof XMLDocument != 'undefined') ? (oDocument_dontShrink.constructor === XMLDocument) : (!oDocument_dontShrink.location);
getUID = bXMLDocument ? getUID4XML : getUID4HTML;
clearKeys();
/*
쿼리를 쉼표로 나누기
*/
var aSplitQuery = backupKeys(sQuery).split(/\s*,\s*/);
var aResult = [];
var nLen = aSplitQuery.length;
for (var i = 0; i < nLen; i++)
aSplitQuery[i] = restoreKeys(aSplitQuery[i]);
/*
쉼표로 나눠진 쿼리 루프
*/
for (var i = 0; i < nLen; i++) {
var sSingleQuery = aSplitQuery[i];
var aSingleQueryResult = null;
var sResultCacheKey = sSingleQuery + (oOptions.single ? '_single' : '');
/*
결과 캐쉬 뒤짐
*/
var aCache = bUseResultCache ? oResultCache[sResultCacheKey] : null;
if (aCache) {
/*
캐싱되어 있는게 있으면 parent 가 같은건지 검사한후 aSingleQueryResult 에 대입
*/
for (var j = 0, oCache; oCache = aCache[j]; j++) {
if (oCache.parent == oParent) {
aSingleQueryResult = oCache.result;
break;
}
}
}
if (!aSingleQueryResult) {
var fpFunction = parseQuery(sSingleQuery);
// alert(fpFunction);
cssquery._marked = [];
for (var j = 0, nDepth = fpFunction.depth; j < nDepth; j++)
cssquery._marked.push({});
// console.log(fpFunction.toSource());
aSingleQueryResult = distinct(fpFunction(oParent, oOptions));
/*
결과 캐쉬를 사용중이면 캐쉬에 저장
*/
if (bUseResultCache&&!oOptions.oneTimeOffCache) {
if (!(oResultCache[sResultCacheKey] instanceof Array)) oResultCache[sResultCacheKey] = [];
oResultCache[sResultCacheKey].push({ parent : oParent, result : aSingleQueryResult });
}
}
aResult = aResult.concat(aSingleQueryResult);
}
unsetNodeIndexes();
return aResult;
})(sQuery, oParent, oOptions);
}
executeTime = new Date().getTime() - executeTime;
if (debugOption.callback) debugOption.callback(sQuery, cost, executeTime);
return aRet;
};
var cssquery;
if (document.querySelectorAll) {
function _isNonStandardQueryButNotException(sQuery){
return /\[\s*(?:checked|selected|disabled)/.test(sQuery)
}
function _commaRevise (sQuery,sChange) {
return sQuery.replace(/\,/gi,sChange);
}
var protoSlice = Array.prototype.slice;
var _toArray = function(aArray){
return protoSlice.apply(aArray);
}
try{
protoSlice.apply(document.documentElement.childNodes);
}catch(e){
_toArray = function(aArray){
var returnArray = [];
var leng = aArray.length;
for ( var i = 0; i < leng; i++ ) {
returnArray.push( aArray[i] );
}
return returnArray;
}
}
/**
*/
cssquery = function(sQuery, oParent, oOptions){
oParent = oParent || document ;
try{
if (_isNonStandardQueryButNotException(sQuery)) {
throw Error("None Standard Query");
}else{
var sReviseQuery = sQuery;
var oReviseParent = oParent;
if (oParent.nodeType != 9) {
if(bExtremeMode){
if(!oParent.id) oParent.id = "p"+ new Date().getTime() + parseInt(Math.random() * 100000000,10);
}else{
throw Error("Parent Element has not ID.or It is not document.or None Extreme Mode.");
}
sReviseQuery = _commaRevise("#"+oParent.id+" "+sQuery,", #"+oParent.id);
oReviseParent = oParent.ownerDocument||oParent.document||document;
}
if (oOptions&&oOptions.single) {
return [oReviseParent.querySelector(sReviseQuery)];
}else{
return _toArray(oReviseParent.querySelectorAll(sReviseQuery));
}
}
}catch(e){
return old_cssquery(sQuery, oParent, oOptions);
}
}
}else{
cssquery = old_cssquery;
}
/**
* 특정 엘리먼트가 해당 CSS 셀렉터에 부합하는 엘리먼트인지 판단한다
* @remark CSS 셀렉터에 연결자는 사용할 수 없음에 유의한다.
* @param {Element} element 검사하고자 하는 엘리먼트
* @param {String} selector CSS 셀렉터
* @return {Boolean} 셀렉터 조건에 부합하면 true, 부합하지 않으면 false
* @example
// oEl 이 div 태그 또는 p 태그, 또는 align=center 인 엘리먼트인지
if (cssquery.test(oEl, 'div, p, [align=center]')) alert('해당 조건 만족');// oEl 이 div 태그 또는 p 태그, 또는 align=center 인 엘리먼트인지
if (cssquery.test(oEl, 'div, p, [align=center]')) alert('해당 조건 만족');
*/
cssquery.test = function(oEl, sQuery) {
clearKeys();
var aFunc = parseTestQuery(sQuery);
for (var i = 0, nLen = aFunc.length; i < nLen; i++){
if (aFunc[i](oEl)) return true;
}
return false;
};
/**
* cssquery 에 결과 캐쉬를 사용할 것인지 지정하거나 확인한다.
* @remark 결과 캐쉬를 사용하면 동일한 셀렉터를 사용했을 경우 새로 탐색을 하지 않고 기존 탐색 결과를 그대로 반환하기 때문에 사용자가 변수 캐쉬에 신경쓰지 않고 편하고 빠르게 쓸 수 있는 장점이 있지만 결과의 신뢰성을 위해 DOM 에 변화가 없다는 것이 확실할때만 사용해야 한다.
* @param {Boolean} flag 사용할 것 인지 여부 (생략시 사용 여부만 반환)
* @return {Boolean} 결과 캐쉬를 사용하는지 여부
*/
cssquery.useCache = function(bFlag) {
if (typeof bFlag != 'undefined') {
bUseResultCache = bFlag;
cssquery.clearCache();
}
return bUseResultCache;
};
/**
* 결과 캐쉬를 사용 중에 DOM 의 변화가 생기는 등의 이유로 캐쉬를 모두 비워주고 싶을때 사용한다.
* @return {Void} 반환값 없음
*/
cssquery.clearCache = function() {
oResultCache = {};
};
/**
* CSS 셀렉터를 사용하여 DOM 에서 원하는 엘리먼트를 하나만 얻어낸다. 반환하는 값은 배열이 아닌 객체 또는 null 이다.
* @remark 결과를 하나만 얻어내면 이후의 모든 탐색 작업을 중단하기 때문에 결과가 하나라는 보장이 있을때 빠른 속도로 결과를 얻어올 수 있다.
* @param {String} selector CSS 셀렉터
* @param {Document | Element} el 탐색을 진행하는 기준이 되는 엘리먼트 또는 문서 (생략시 현재 문서의 document 객체)
* @param {Object} 오브젝트에 onTimeOffCache를 true로 하면 해당 쿼리는 cache를 사용하지 않는다.
* @return {Element} 선택된 엘리먼트
*/
cssquery.getSingle = function(sQuery, oParent, oOptions) {
return cssquery(sQuery, oParent, { single : true ,oneTimeOffCache:oOptions?(!!oOptions.oneTimeOffCache):false})[0] || null;
};
/**
* XPath 문법을 사용하여 엘리먼트를 얻어온다.
* @remark 지원하는 문법이 무척 제한적으로 특수한 경우에서만 사용하는 것을 권장한다.
* @param {String} xpath XPath
* @param {Document | Element} el 탐색을 진행하는 기준이 되는 엘리먼트 또는 문서 (생략시 현재 문서의 document 객체)
* @return {Array} 선택된 엘리먼트 목록의 배열
*/
cssquery.xpath = function(sXPath, oParent) {
var sXPath = sXPath.replace(/\/(\w+)(\[([0-9]+)\])?/g, function(_1, sTag, _2, sTh) {
sTh = sTh || '1';
return '>' + sTag + ':nth-of-type(' + sTh + ')';
});
return old_cssquery(sXPath, oParent);
};
/**
* cssquery 를 사용할 때의 성능을 측정하기 위한 방법을 제공하는 함수이다.
* @param {Function} callback 셀렉터 실행에 소요된 비용과 시간을 받아들이는 함수 (false 인 경우 debug 옵션을 끔)
* @param {Number} repeat 하나의 셀렉터를 반복하여 수행하도록 해서 인위적으로 실행 속도를 늦춤
* @remark callback 함수의 형태는 아래와 같습니다.
* callback : function({String}query, {Number}cost, {Number}executeTime)
* <dl>
* <dt>query</dt>
* <dd>실행에 사용된 셀렉터</dd>
* <dt>cost</dt>
* <dd>탐색에 사용된 비용 (루프 횟수)</dd>
* <dt>executeTime</dt>
* <dd>탐색에 소요된 시간</dd>
* </dl>
* @return {Void} 반환값 없음
* @example
cssquery.debug(function(sQuery, nCost, nExecuteTime) {
if (nCost > 5000)
console.warn('5000 이 넘는 비용이?! 체크해보자 -> ' + sQuery + '/' + nCost);
else if (nExecuteTime > 200)
console.warn('0.2초가 넘게 실행을?! 체크해보자 -> ' + sQuery + '/' + nExecuteTime);
}, 20);
....
cssquery.debug(false);
*/
cssquery.debug = function(fpCallback, nRepeat) {
debugOption.callback = fpCallback;
debugOption.repeat = nRepeat || 1;
};
/**
* IE 에서 innerHTML 을 쓸때 _cssquery_UID 나오지 않도록 하는 함수이다.
* true 로 설정하면 그때부터 탐색하는 노드에 대해서는 innerHTML 에 _cssquery_UID 가 나오지 않도록 하지만 탐색속도는 다소 느려질 수 있다.
* @param {Boolean} flag true 로 셋팅하면 _cssquery_UID 가 나오지 않음
* @return {Boolean} _cssquery_UID 가 나오지 않는 상태이면 true 반환
*/
cssquery.safeHTML = function(bFlag) {
var bIE = /MSIE/.test(window.navigator.userAgent);
if (arguments.length > 0)
safeHTML = bFlag && bIE;
return safeHTML || !bIE;
};
/**
* cssquery 의 버젼정보를 담고 있는 문자열이다.
*/
cssquery.version = sVersion;
/**
* IE에서 validUID,cache를 사용했을때 메모리 닉이 발생하여 삭제하는 모듈 추가.
*/
cssquery.release = function() {
if(/MSIE/.test(window.navigator.userAgent)){
delete validUID;
validUID = {};
if(bUseResultCache){
cssquery.clearCache();
}
}
};
/**
* cache가 삭제가 되는지 확인하기 위해 필요한 함수
* @ignore
*/
cssquery._getCacheInfo = function(){
return {
uidCache : validUID,
eleCache : oResultCache
}
}
/**
* 테스트를 위해 필요한 함수
* @ignore
*/
cssquery._resetUID = function(){
UID = 0
}
/**
* querySelector가 있는 브라우져에서 extreme을 실행시키면 querySelector을 사용할수 있는 커버리지가 높아져 전체적으로 속도가 빨리진다.
* 하지만 ID가 없는 엘리먼트를 기준 엘리먼트로 넣었을 때 기준 엘리먼트에 임의의 아이디가 들어간다.
* @param {Boolean} bExtreme true
*/
cssquery.extreme = function(bExtreme){
if(arguments.length == 0){
bExtreme = true;
}
bExtremeMode = bExtreme;
}
return cssquery;
})();
/**
* @fileOverview $Agent의 생성자 및 메서드를 정의한 파일
*/
/**
* Agent 객체를 반환한다. Agent 객체는 브라우저와 OS에 대한 정보를 가진다.
* @class Agent 객체는 운영체제, 브라우저를 비롯한 사용자 시스템의 정보를 가진다.
* @constructor
* @author Kim, Taegon
*/
jindo.$Agent = function() {
var cl = arguments.callee;
var cc = cl._cached;
if (cc) return cc;
if (!(this instanceof cl)) return new cl;
if (!cc) cl._cached = this;
this._navigator = navigator;
}
/**
* navigator 메서드는 웹 브라우저의 정보 객체를 리턴한다.
* @return {Object} 웹 브라우저 정보를 저장하는 객체. <br>
* object는 브라우저 이름과 버전을 속성으로 가진다. 브라우저 이름은 영어 소문자로 표시하며, 사용자의 브라우저와 일치하는 브라우저 이름은 true를 가진다.
* @since 1.4.3 부터 mobile,msafari,mopera,mie 사용 가능.
* @since 1.4.5 부터 ipad에서 mobile은 false를 반환 한다.
* @example
oAgent = $Agent().navigator(); // 사용자가 파이어폭스 3를 사용한다고 가정한다.
oAgent.camino // false
oAgent.firefox // true
oAgent.konqueror // false
oAgent.mozilla //true
oAgent.netscape // false
oAgent.omniweb //false
oAgent.opera //false
oAgent.webkit /false
oAgent.safari //false
oAgent.ie //false
oAgent.chrome //false
oAgent.icab //false
oAgent.version //3
oAgent.nativeVersion //-1 (1.4.2부터 사용 가능, IE8에서 호환 모드 사용시 nativeVersion은 8로 나옴.)
oAgent.getName() // firefox
*/
jindo.$Agent.prototype.navigator = function() {
var info = new Object;
var ver = -1;
var nativeVersion = -1;
var u = this._navigator.userAgent;
var v = this._navigator.vendor || "";
function f(s,h){ return ((h||"").indexOf(s) > -1) };
info.getName = function(){
var name = "";
for(x in info){
if(typeof info[x] == "boolean" && info[x]&&info.hasOwnProperty(x))
name = x;
}
return name;
}
info.webkit = f("WebKit",u);
info.opera = (typeof window.opera != "undefined") || f("Opera",u);
info.ie = !info.opera && f("MSIE",u);
info.chrome = info.webkit && f("Chrome",u);
info.safari = info.webkit && !info.chrome && f("Apple",v);
info.firefox = f("Firefox",u);
info.mozilla = f("Gecko",u) && !info.safari && !info.chrome && !info.firefox;
info.camino = f("Camino",v);
info.netscape = f("Netscape",u);
info.omniweb = f("OmniWeb",u);
info.icab = f("iCab",v);
info.konqueror = f("KDE",v);
info.mobile = (f("Mobile",u)||f("Android",u)||f("Nokia",u)||f("webOS",u)||f("Opera Mini",u)||f("BlackBerry",u)||(f("Windows",u)&&f("PPC",u))||f("Smartphone",u)||f("IEMobile",u))&&!f("iPad",u);
info.msafari = (!f("IEMobile",u) && f("Mobile",u))||(f("iPad",u)&&f("Safari",u));
info.mopera = f("Opera Mini",u);
info.mie = f("PPC",u)||f("Smartphone",u)||f("IEMobile",u);
try {
if (info.ie) {
ver = u.match(/(?:MSIE) ([0-9.]+)/)[1];
if (u.match(/(?:Trident)\/([0-9.]+)/)){
var nTridentNum = parseInt(RegExp.$1,10);
if(nTridentNum > 3){
nativeVersion = nTridentNum + 4;
}
}
} else if (info.safari||info.msafari) {
ver = parseFloat(u.match(/Safari\/([0-9.]+)/)[1]);
if (ver == 100) {
ver = 1.1;
} else {
if(u.match(/Version\/([0-9.]+)/)){
ver = RegExp.$1;
}else{
ver = [1.0,1.2,-1,1.3,2.0,3.0][Math.floor(ver/100)];
}
}
} else if(info.mopera){
ver = u.match(/(?:Opera\sMini)\/([0-9.]+)/)[1];
} else if (info.firefox||info.opera||info.omniweb) {
ver = u.match(/(?:Firefox|Opera|OmniWeb)\/([0-9.]+)/)[1];
} else if (info.mozilla) {
ver = u.match(/rv:([0-9.]+)/)[1];
} else if (info.icab) {
ver = u.match(/iCab[ \/]([0-9.]+)/)[1];
} else if (info.chrome) {
ver = u.match(/Chrome[ \/]([0-9.]+)/)[1];
}
info.version = parseFloat(ver);
info.nativeVersion = parseFloat(nativeVersion);
if (isNaN(info.version)) info.version = -1;
} catch(e) {
info.version = -1;
}
this.navigator = function() {
return info;
};
return info;
};
/**
* os 메서드는 운영체제에 대한 정보 객체를 리턴한다.
* @return {Object} 운영체제 정보 객체. 운영체제의 영문 이름을 속성으로 가지며, 사용자가 사용하는 운영체제와 동일한 이름의 속성은 true를 가진다.
* @since 1.4.3 부터 iphone,android,nokia,webos,blackberry,mwin 사용 가능.
* @since 1.4.5 부터 ipad 사용가능.
* @example
oOS = $Agent().os(); // 사용자의 운영체제가 Windows XP라고 가정한다.
oOS.linux // false
oOS.mac // false
oOS.vista // false
oOS.win // true
oOS.win2000 // false
oOS.winxp // true
oOS.xpsp2 // false
oOS.win7 // false
oOS.getName() // winxp
*/
jindo.$Agent.prototype.os = function() {
var info = new Object;
var u = this._navigator.userAgent;
var p = this._navigator.platform;
var f = function(s,h){ return (h.indexOf(s) > -1) };
info.getName = function(){
var name = "";
for(x in info){
if(typeof info[x] == "boolean" && info[x]&&info.hasOwnProperty(x))
name = x;
}
return name;
}
info.win = f("Win",p)
info.mac = f("Mac",p);
info.linux = f("Linux",p);
info.win2000 = info.win && (f("NT 5.0",u) || f("2000",u));
info.winxp = info.win && f("NT 5.1",u);
info.xpsp2 = info.winxp && f("SV1",u);
info.vista = info.win && f("NT 6.0",u);
info.win7 = info.win && f("NT 6.1",u);
info.ipad = f("iPad",u);
info.iphone = f("iPhone",u) && !info.ipad;
info.android = f("Android",u);
info.nokia = f("Nokia",u);
info.webos = f("webOS",u);
info.blackberry = f("BlackBerry",u);
info.mwin = f("PPC",u)||f("Smartphone",u)||f("IEMobile",u);
this.os = function() {
return info;
};
return info;
};
/**
* flash 메서드는 플래시에 대한 정보 객체를 리턴한다.
* @return {Object} Flash 정보 객체. <br>
* object.installed는 플래시 플레이어 설치 여부를 boolean 값으로 가지고 object.version은 플래시 플레이어의 버전을 가진다. 플래시 버전을 탐지하지 못하면 flash.version은 -1의 값을 가진다.
* @example
var oFlash = $Agent.flash();
oFlash.installed // 플래시 플레이어를 설치했다면 true
oFlash.version // 플래시 플레이어의 버전.
*/
jindo.$Agent.prototype.flash = function() {
var info = new Object;
var p = this._navigator.plugins;
var m = this._navigator.mimeTypes;
var f = null;
info.installed = false;
info.version = -1;
if (typeof p != "undefined" && p.length) {
f = p["Shockwave Flash"];
if (f) {
info.installed = true;
if (f.description) {
info.version = parseFloat(f.description.match(/[0-9.]+/)[0]);
}
}
if (p["Shockwave Flash 2.0"]) {
info.installed = true;
info.version = 2;
}
} else if (typeof m != "undefined" && m.length) {
f = m["application/x-shockwave-flash"];
info.installed = (f && f.enabledPlugin);
} else {
for(var i=10; i > 1; i--) {
try {
f = new ActiveXObject("ShockwaveFlash.ShockwaveFlash."+i);
info.installed = true;
info.version = i;
break;
} catch(e) {}
}
}
this.flash = function() {
return info;
};
/*
하위호환을 위해 일단 남겨둔다.
*/
this.info = this.flash;
return info;
};
/**
* silverlight 메서드는 실버라이트(Silverlight)에 대한 정보 객체를 리턴한다.
* @returns {Object} Silverlight 정보 객체. <br>
* object.installed은 실버라이트 플레이어 설치 여부를 boolean 값으로 가지고 object.version은 실버라이트 플레이어의 버전을 가진다. 플레이어의 버전을 탐지하지 못하면 object.version의 값은 -1이 된다.
* @example
var oSilver = $Agent.silverlight();
oSilver.installed // Silverlight 플레이어를 설치했다면 true
oSilver.version // Silverlight 플레이어의 버전.
*/
jindo.$Agent.prototype.silverlight = function() {
var info = new Object;
var p = this._navigator.plugins;
var s = null;
info.installed = false;
info.version = -1;
if (typeof p != "undefined" && p.length) {
s = p["Silverlight Plug-In"];
if (s) {
info.installed = true;
info.version = parseInt(s.description.split(".")[0],10);
if (s.description == "1.0.30226.2") info.version = 2;
}
} else {
try {
s = new ActiveXObject("AgControl.AgControl");
info.installed = true;
if(s.isVersionSupported("3.0")){
info.version = 3;
}else if (s.isVersionSupported("2.0")) {
info.version = 2;
} else if (s.isVersionSupported("1.0")) {
info.version = 1;
}
} catch(e) {}
}
this.silverlight = function() {
return info;
};
return info;
};
/**
* @fileOverview $A의 생성자 및 메서드를 정의한 파일
* @name array.js
*/
/**
* $A 객체를 생성하여 반환한다.
* @extends core
* @class $A 클래스는 배열(Array)을 래핑(wrapping)하여 배열을 다루기 위한 여러가지 메서드를 제공한다.<br>
* 여기서 래핑이란 자바스크립트의 함수를 감싸 본래 함수의 기능에 새로운 확장 속성을 추가하는 것을 말한다.
* @param {Array|$A} array 배열. 만약 매개 변수를 생략하면 빈 배열을 가진 새로운 $A 객체를 리턴한다.
* @constructor
* @description [Lite]
* @author Kim, Taegon
*
* @example
var zoo = ["zebra", "giraffe", "bear", "monkey"];
var waZoo = $A(zoo); // ["zebra", "giraffe", "bear", "monkey"]를 래핑한 $A 객체를 생성하여 반환
*/
jindo.$A = function(array) {
var cl = arguments.callee;
if (typeof array == "undefined" || array == null) array = [];
if (array instanceof cl) return array;
if (!(this instanceof cl)) return new cl(array);
this._array = []
if (array.constructor != String) {
this._array = [];
for(var i=0; i < array.length; i++) {
this._array[this._array.length] = array[i];
}
}
};
/**
* toString 메서드는 내부 배열을 문자열로 변환한다. 자바스크립트의 Array.toString 을 사용한다.
* @return {String} 내부 배열을 변환한 문자열.
* @description [Lite]
*
* @example
var zoo = ["zebra", "giraffe", "bear", "monkey"];
$A(zoo).toString();
// 결과 : zebra,giraffe,bear,monkey
*/
jindo.$A.prototype.toString = function() {
return this._array.toString();
};
/**
* 인덱스로 배열의 원소 값을 조회한다.
* @param {Number} nIndex 조회할 배열의 인덱스. 인덱스는 0부터 시작한다.
* @return {Value} 배열에서의 해당 인덱스의 원소 값.
* @description [Lite]
* @since 1.4.2 부터 지원
*
* @example
var zoo = ["zebra", "giraffe", "bear", "monkey"];
var waZoo = $A(zoo);
// 원소 값 조회
waZoo.get(1); // 결과 : giraffe
waZoo.get(3); // 결과 : monkey
*/
jindo.$A.prototype.get = function(nIndex){
return this._array[nIndex];
};
/**
* 내부 배열의 크기를 지정하거나 리턴한다.
* @param {Number} [nLen] 지정할 배열의 크기.<br>
* nLen 이 기존 배열의 크기보다 크면 oValue 매개 변수의 값을 배열의 마지막에 덧붙인다.<br>
* nLen 이 기존 배열의 크기보다 작으면 nLen 번째 이후의 원소는 제거한다.
* @param {Value} [oValue] 새로운 원소를 추가할 때 사용할 초기값
* @return {Number|$A} 매개 변수를 모두 생략하면 현재 내부 배열의 크기를 리턴하고,<br>
* 매개 변수를 지정한 경우에는 내부 배열을 변경한 $A 객체를 리턴한다.
*
* @example
var zoo = ["zebra", "giraffe", "bear", "monkey"];
var birds = ["parrot", "sparrow", "dove"];
// 배열의 크기 조회
$A(zoo).length(); // 결과 : 4
// 배열의 크기 지정 (원소가 삭제되는 경우)
$A(zoo).length(2);
// 결과 : ["zebra", "giraffe"]
// 배열의 크기 지정 (원소가 추가되는 경우)
$A(zoo).length(6, "(Empty)");
// 결과 : ["zebra", "giraffe", "bear", "monkey", "(Empty)", "(Empty)"]
$A(zoo).length(5, birds);
// 결과 : ["zebra", "giraffe", "bear", "monkey", ["parrot", "sparrow", "dove"]]
*/
jindo.$A.prototype.length = function(nLen, oValue) {
if (typeof nLen == "number") {
var l = this._array.length;
this._array.length = nLen;
if (typeof oValue != "undefined") {
for(var i=l; i < nLen; i++) {
this._array[i] = oValue;
}
}
return this;
} else {
return this._array.length;
}
};
/**
* 배열에서 특정 값을 검색한다.
* @param {Value} oValue 검색할 값
* @return {Boolean} 배열에서 매개 변수의 값과 동일한 원소를 찾으면 true를, 찾지 못하면 false를 리턴한다.
* @see $A#indexOf
* @description [Lite]
*
* @example
var arr = $A([1,2,3]);
// 값 검색
arr.has(3); // 결과 : true
arr.has(4); // 결과 : false
*/
jindo.$A.prototype.has = function(oValue) {
return (this.indexOf(oValue) > -1);
};
/**
* 배열에서 특정 값을 검색하고 검색한 원소의 인덱스를 리턴한다.
* @param {Value} oValue 검색할 값
* @return {Number} 찾은 원소의 인덱스. 인덱스는 0 부터 시작한다. 매개 변수와 동일한 원소를 찾지 못하면 -1 을 리턴한다.
* @see $A#has
* @description [Lite]
*
* @example
var zoo = ["zebra", "giraffe", "bear"];
va r waZoo = $A(zoo);
// 값 검색 후 인덱스 리턴
waZoo.indexOf("giraffe"); // 1
waZoo.indexOf("monkey"); // -1
*/
jindo.$A.prototype.indexOf = function(oValue) {
if (typeof this._array.indexOf != 'undefined') {
jindo.$A.prototype.indexOf = function(oValue) {
return this._array.indexOf(oValue);
}
}else{
jindo.$A.prototype.indexOf = function(oValue) {
for(var i=0; i < this._array.length; i++) {
if (this._array[i] == oValue) return i;
}
return -1;
}
}
return this.indexOf(oValue);
};
/**
* 내부의 원본 배열을 리턴한다.
* @return {Array} 배열
* @description [Lite]
*
* @example
var waNum = $A([1, 2, 3]);
waNum.$value(); // 원래의 배열인 [1, 2, 3]이 반환된다
*/
jindo.$A.prototype.$value = function() {
return this._array;
};
/**
* 내부 배열에 하나 이상의 원소를 추가한다.
* @param {oValue1, ..., oValueN} oValueN 추가할 N 개의 값
* @return {Number} 하나 이상의 원소를 추가한 내부 배열의 크기
* @description [Lite]
*
* @example
var arr = $A([1,2,3]);
// 원소 추가
arr.push(4); // 결과 : 4 반환, 내부 배열은 [1,2,3,4]로 변경 됨
arr.push(5,6); // 결과 : 6 반환, 내부 배열은 [1,2,3,4,5,6]로 변경 됨
*/
jindo.$A.prototype.push = function(oValue1/*, ...*/) {
return this._array.push.apply(this._array, Array.prototype.slice.apply(arguments));
};
/**
* 내부 배열의 마지막 원소를 삭제한다.
* @return {Value} 삭제한 원소
* @description [Lite]
*
* @example
var arr = $A([1,2,3,4,5]);
arr.pop(); // 결과 : 5 반환, 내부 배열은 [1,2,3,4]로 변경 됨
*/
jindo.$A.prototype.pop = function() {
return this._array.pop();
};
/**
* 내부 배열의 모든 원소를 앞으로 한 칸씩 이동한다. 내부 배열의 첫 번째 원소는 삭제된다.
* @return {Value} 삭제한 첫 번째 원소.
* @see $A#pop
* @see $A#unshift
* @description [Lite]
* @example
var arr = $A(['Melon','Grape','Apple','Kiwi']);
arr.shift(); // 결과 : 'Melon' 반환, 내부 배열은 ["Grape", "Apple", "Kiwi"]로 변경 됨.
*/
jindo.$A.prototype.shift = function() {
return this._array.shift();
};
/**
* 내부 배열의 맨 앞에 하나 이상의 원소를 삽입한다.
* @param {oValue1, ..., oValueN} oValueN 삽입할 하나 이상의 값
* @return {Number} 원소를 추가한 후의 배열의 크기
* @description [Lite]
* @example
var arr = $A([4,5]);
arr.unshift('c'); // 결과 : 3 반환, 내부 배열은 ["c", 4, 5]로 변경 됨.
arr.unshift('a', 'b'); // 결과 : 5 반환, 내부 배열은 ["a", "b", "c", 4, 5]로 변경 됨.
*/
jindo.$A.prototype.unshift = function(oValue1/*, ...*/) {
this._array.unshift.apply(this._array, Array.prototype.slice.apply(arguments));
return this._array.length;
};
/**
* 내부 배열의 모든 원소를 순회하면서 콜백 함수를 실행한다.
*
* @param {Function} fCallback 순회하면서 실행할 콜백 함수.<br>
* <br>
* 콜백 함수는 fCallback(value, index, array) 의 형식을 가진다. <br>
* value 는 배열이 가진 원소의 값을 가지고,<br>
* index 는 해당 원소의 인덱스를 가지고,<br>
* array 는 배열 그 자체를 가리킨다.
* @param {Object} [oThis] 콜백 함수가 객체의 메서드일 때 콜백 함수 내부에서 사용할 this
* @return {$A} $A 객체
* @import core.$A[Break, Continue]
* @see $A#map
* @see $A#filter
* @description [Lite]
*
* @example
var waZoo = $A(["zebra", "giraffe", "bear", "monkey"]);
waZoo.forEach(function(value, index, array) {
document.writeln((index+1) + ". " + value);
});
// 결과 :
// 1. zebra
// 2. giraffe
// 3. bear
// 4. monkey
* @example
var waArray = $A([1, 2, 3]);
waArray.forEach(function(value, index, array) {
array[index] += 10;
});
document.write(waArray.$value());
// 결과 : 11, 12, 13 (내부 배열에 10씩 더해짐)
*/
jindo.$A.prototype.forEach = function(fCallback, oThis) {
if (typeof this._array.forEach == "function") {
jindo.$A.prototype.forEach = function(fCallback, oThis) {
var arr = this._array;
var errBreak = this.constructor.Break;
var errContinue = this.constructor.Continue;
function f(v,i,a) {
try {
fCallback.call(oThis, v, i, a);
} catch(e) {
if (!(e instanceof errContinue)) throw e;
}
};
try {
this._array.forEach(f);
} catch(e) {
if (!(e instanceof errBreak)) throw e;
}
return this;
}
}else{
jindo.$A.prototype.forEach = function(fCallback, oThis) {
var arr = this._array;
var errBreak = this.constructor.Break;
var errContinue = this.constructor.Continue;
function f(v,i,a) {
try {
fCallback.call(oThis, v, i, a);
} catch(e) {
if (!(e instanceof errContinue)) throw e;
}
};
for(var i=0; i < arr.length; i++) {
try {
f(arr[i], i, arr);
} catch(e) {
if (e instanceof errBreak) break;
throw e;
}
}
return this;
}
}
return this.forEach(fCallback, oThis);
};
/**
* 배열의 일부를 추출한다.
* @param {Number} nStart 잘라낼 부분의 시작 인덱스. 인덱스는 0부터 시작한다.
* @param {Number} nEnd 잘라낼 부분의 바로 뒤 인덱스
* @return {$A} 내부 배열의 일부를 추출한 새로운 $A 객체.<br>
* nStart 값이 0 보다 작거나 혹은 nStart 값이 nEnd 값 보다 크거나 같으면 빈 배열을 가지는 $A 객체를 리턴한다.
* @description [Lite]
*
* @example
var arr = $A([12, 5, 8, 130, 44]);
var newArr = arr.slice(1,3);
// 잘라낸 배열인 [5, 8]를 래핑한 $A 객체를 리턴한다. (원래의 배열은 변화 없음)
* @example
var arr = $A([12, 5, 8, 130, 44]);
var newArr = arr.slice(3,3);
// []를 래핑한 $A 객체를 리턴한다.
*/
jindo.$A.prototype.slice = function(nStart, nEnd) {
var a = this._array.slice.call(this._array, nStart, nEnd);
return jindo.$A(a);
};
/**
* 배열의 일부를 삭제한다.
* @param {Number} nIndex 삭제할 부분의 시작 인덱스. 인덱스는 0부터 시작한다.
* @param {Number} [nHowMany] 삭제할 원소의 개수.<br>
* 이 값과 oValueN 를 생략하면 nIndex 번째 원소부터 배열의 마지막 원소까지 삭제한다.<br>
* 이 값을 0 혹은 지정하지 않고 oValueN 에 값을 지정하면 nIndex 번째 위치에 oValueN 값이 추가된다.
* @param {Value1, ...,ValueN} [oValueN] 삭제한 배열에 추가할 하나 이상의 값. nIndex 값의 인덱스부터 추가된다.
* @returns {$A} 삭제한 원소를 래핑하는 새로운 $A 객체
* @description [Lite]
*
* @example
var arr = $A(["angel", "clown", "mandarin", "surgeon"]);
var removed = arr.splice(2, 0, "drum");
// arr의 내부 배열은 ["angel", "clown", "drum", "mandarin", "surgeon"]로 인덱스 2에 drum이 추가 됨
// removed의 내부 배열은 []로 삭제된 원소가 없음
removed = arr.splice(3, 1);
// arr의 내부 배열은 ["angel", "clown", "drum", "surgeon"]로 mandarin이 삭제 됨
// removed의 내부 배열은 삭제된 원소 ["mandarin"]를 가짐
removed = arr.splice(2, 1, "trumpet", "parrot");
// arr의 내부 배열은 ["angel", "clown", "trumpet", "parrot", "surgeon"]로 drum이 삭제되고 새로운 원소가 추가 됨
// removed의 내부 배열은 삭제된 원소 ["drum"]을 가짐
removed = arr.splice(3);
// arr의 내부 배열은 ["angel", "clown", "trumpet"]로 인덱스 3부터 마지막 원소가 삭제되었음
// removed의 내부 배열은 삭제된 원소 ["parrot", "surgeon"]을 가짐
*/
jindo.$A.prototype.splice = function(nIndex, nHowMany/*, oValue1,...*/) {
var a = this._array.splice.apply(this._array, Array.prototype.slice.apply(arguments));
return jindo.$A(a);
};
/**
* 배열의 원소를 무작위로 섞는다.
* @return {$A} 배열이 섞여진 $A 객체
* @description [Lite]
*
* @example
var dice = $A([1,2,3,4,5,6]);
dice.shuffle();
document.write("You get the number " + dice.get(0));
// 결과 : 1부터 6까지의 숫자 중 랜덤한 숫자
*/
jindo.$A.prototype.shuffle = function() {
this._array.sort(function(a,b){ return Math.random()>Math.random()?1:-1 });
return this;
};
/**
* 배열 원소의 순서를 거꾸로 뒤집는다.
* @return {$A} 원소 순서를 뒤집은 $A 객체
* @description [Lite]
*
* @example
var arr = $A([1, 2, 3, 4, 5]);
arr.reverse(); // 결과 : [5, 4, 3, 2, 1]
*/
jindo.$A.prototype.reverse = function() {
this._array.reverse();
return this;
};
/**
* 배열의 모든 원소를 제거하고, 빈 배열로 만든다.
* @return {$A} 배열의 원소가 제거된 $A 객체
* @description [Lite]
*
* @example
var arr = $A([1, 2, 3]);
arr.empty(); // 결과 : []
*/
jindo.$A.prototype.empty = function() {
return this.length(0);
};
/**
* Break 메서드는 forEach, filter, map 메서드의 순회 루프를 중단한다.
* @remark 내부적으로는 강제로 예외를 발생시키는 구조이므로, try ~ catch 영역에서 이 메소드를 실행하면 정상적으로 동작하지 않을 수 있다.
*
* @description [Lite]
* @see $A#Continue
* @see $A#forEach
* @see $A#filter
* @see $A#map
* @example
$A([1,2,3,4,5]).forEach(function(value,index,array) {
// 값이 4보다 크면 종료
if (value > 4) $A.Break();
...
});
*/
jindo.$A.Break = function() {
if (!(this instanceof arguments.callee)) throw new arguments.callee;
};
/**
* Continue 메서드는 forEach, filter, map 메서드의 순회 루프에서 나머지 명령을 실행하지 않고 다음 루프로 건너뛴다.
* @remark 내부적으로는 강제로 예외를 발생시키는 구조이므로, try ~ catch 영역에서 이 메소드를 실행하면 정상적으로 동작하지 않을 수 있다.
*
* @description [Lite]
* @see $A#Break
* @see $A#forEach
* @see $A#filter
* @see $A#map
* @example
$A([1,2,3,4,5]).forEach(function(value,index,array) {
// 값이 짝수면 처리를 하지 않음
if (value%2 == 0) $A.Continue();
...
});
*/
jindo.$A.Continue = function() {
if (!(this instanceof arguments.callee)) throw new arguments.callee;
};
/**
* @fileOverview $A의 확장 메서드를 정의한 파일
* @name array.extend.js
*/
/**
* 배열의 모든 원소를 순회하면서 콜백 함수를 실행한다.<br>
* 콜백 함수의 실행 결과를 배열의 원소에 설정한다.
*
* @param {Function} fCallback 순회하면서 실행할 콜백 함수.<br>
* <br>
* 콜백 함수는 fCallback(value, index, array) 의 형식을 가진다. <br>
* value 는 배열이 가진 원소의 값을 가지고,<br>
* index 는 해당 원소의 인덱스를 가지고,<br>
* array 는 배열 그 자체를 가리킨다.<br>
* <br>
* 콜백 함수에서 리턴하는 값을 원소의 값으로 설정한다.
*
* @param {Object} [oThis] 콜백 함수가 객체의 메서드일 때 콜백 함수 내부에서 사용할 this
* @return {$A} 콜백 함수의 수행 결과를 반영한 $A 객체
* @see $A#forEach
* @see $A#filter
*
* @example
var waZoo = $A(["zebra", "giraffe", "bear", "monkey"]);
waZoo.map(function(value, index, array) {
return (index+1) + ". " + value;
});
// 결과 : [1. zebra, 2. giraffe, 3. bear, 4. monkey]
* @example
var waArray = $A([1, 2, 3]);
waArray.map(function(value, index, array) {
return value + 10;
});
document.write(waArray.$value());
// 결과 : 11, 12, 13 (내부 배열에 10씩 더해짐)
*/
jindo.$A.prototype.map = function(fCallback, oThis) {
if (typeof this._array.map == "function") {
jindo.$A.prototype.map = function(fCallback, oThis) {
var arr = this._array;
var errBreak = this.constructor.Break;
var errContinue = this.constructor.Continue;
function f(v,i,a) {
try {
return fCallback.call(oThis, v, i, a);
} catch(e) {
if (e instanceof errContinue){
return v;
} else{
throw e;
}
}
};
try {
this._array = this._array.map(f);
} catch(e) {
if(!(e instanceof errBreak)) throw e;
}
return this;
}
}else{
jindo.$A.prototype.map = function(fCallback, oThis) {
var arr = this._array;
var returnArr = [];
var errBreak = this.constructor.Break;
var errContinue = this.constructor.Continue;
function f(v,i,a) {
try {
return fCallback.call(oThis, v, i, a);
} catch(e) {
if (e instanceof errContinue){
return v;
} else{
throw e;
}
}
};
for(var i=0; i < this._array.length; i++) {
try {
returnArr[i] = f(arr[i], i, arr);
} catch(e) {
if (e instanceof errBreak){
return this;
}else{
throw e;
}
}
}
this._array = returnArr;
return this;
}
}
return this.map(fCallback, oThis);
};
/**
* 배열의 모든 원소를 순회하면서 콜백 함수를 실행한다. 실행이 끝나면 filter 메서드는 콜박 함수를 만족하는 원소로 이루어진 새로운 $A 객체를 반환한다.
* @param {Function} fCallback 순회하면서 실행할 콜백 함수.<br>
* <br>
* 콜백 함수는 fCallback(value, index, array)의 형식으로 작성해야 한다. 여기서
* value 는 배열이 가진 원소의 값, index 는 해당 원소의 인덱스, array 는 원본 배열이다.<br>
* <br>
* 콜백 함수는 Boolean 을 리턴해야한다. 만약 리턴 값이 true 인 원소는 새로운 배열의 원소가 된다.
*
* @param {Object} oThis 콜백 함수가 객체의 메서드일 때 콜백 함수 내부에서 사용할 this
* @return {$A} 콜백 함수의 리턴 값이 true 인 원소로 이루어진 새로운 $A 객체
* @see $A#forEach
* @see $A#map
*
* @example
var arr = $A([1,2,3,4,5]);
// 필터링 함수
function filterFunc(value, index, array) {
if (value > 2) {
return true;
} else {
return false;
}
}
var newArr = arr.filter(filterFunc);
document.write(arr.$value()); // 결과 : [1,2,3,4,5]
document.write(newArr.$value()); // 결과 : [3,4,5]
*/
jindo.$A.prototype.filter = function(fCallback, oThis) {
if (typeof this._array.filter != "undefined") {
jindo.$A.prototype.filter = function(fCallback, oThis) {
return jindo.$A(this._array.filter(fCallback, oThis));
}
}else{
jindo.$A.prototype.filter = function(fCallback, oThis) {
var ar = [];
this.forEach(function(v,i,a) {
if (fCallback.call(oThis, v, i, a) === true) {
ar[ar.length] = v;
}
});
return jindo.$A(ar);
}
}
return this.filter(fCallback, oThis);
};
/**
* 배열의 모든 원소를 순회하면서 콜백 함수를 실행한다. 동시에 배열의 모든 원소가 콜백 함수를 만족하는지(콜백 함수가 true를 리턴하는지) 검사한다. <br>
* 만약 모든 원소가 콜백 함수를 만족하면 every 메서드는 true를 리턴한다.
*
* @param {Function} fCallback 순회하면서 실행할 콜백 함수.<br>
* <br>
* 콜백 함수는 fCallback(value, index, array) 의 형식으로 작성해야 한다. 여기서
* value 는 배열이 가진 원소의 값, index 는 해당 원소의 인덱스, array 는 원본 배열이다.<br>
* <br>
* 콜백 함수는 Boolean 을 리턴해야한다.<br>
*
* @param {Object} oThis 콜백 함수가 객체의 메서드일 때 콜백 함수 내부에서 사용할 this
* @return {Boolean} 콜백 함수의 리턴 값이 모두 true 이면 true 를, 그렇지 않으면 false 를 리턴한다.
* @see $A#some
*
* @example
function isBigEnough(value, index, array) {
return (value >= 10);
}
var try1 = $A([12, 5, 8, 130, 44]).every(isBigEnough); // 결과 : false
var try2 = $A([12, 54, 18, 130, 44]).every(isBigEnough); // 결과 : true
*/
jindo.$A.prototype.every = function(fCallback, oThis) {
if (typeof this._array.every != "undefined"){
jindo.$A.prototype.every = function(fCallback, oThis) {
return this._array.every(fCallback, oThis);
}
}else{
jindo.$A.prototype.every = function(fCallback, oThis) {
var result = true;
this.forEach(function(v, i, a) {
if (fCallback.call(oThis, v, i, a) === false) {
result = false;
jindo.$A.Break();
}
});
return result;
}
}
return this.every(fCallback, oThis);
};
/**
* 배열의 모든 원소를 순회하면서 콜백 함수를 실행한다.<br>
* 콜백 함수를 만족하는 원소가 있는지 검사한다.
*
* @param {Function} fCallback 순회하면서 실행할 콜백 함수.<br>
* <br>
* 콜백 함수는 fCallback(value, index, array) 의 형식으로 작성해야 한다. 여기서
* value 는 배열이 가진 원소, index 는 해당 원소의 인덱스, array 는 원본 배열이다.<br>
* <br>
* 콜백 함수는 Boolean 을 리턴해야한다.<br>
*
* @param {Object} oThis 콜백 함수가 객체의 메서드일 때 콜백 함수 내부에서 사용할 this
* @return {Boolean} 콜백 함수의 리턴 값이 true 인 원소가 있으면 true 를, 하나도 없으면 false 를 리턴한다.
* @see $A#every
*
* @example
function twoDigitNumber(value, index, array) {
return (value >= 10 && value < 100);
}
var try1 = $A([12, 5, 8, 130, 44]).some(twoDigitNumber); // 결과 : true
var try2 = $A([1, 5, 8, 130, 4]).some(twoDigitNumber); // 결과 : false
*/
jindo.$A.prototype.some = function(fCallback, oThis) {
if (typeof this._array.some != "undefined"){
jindo.$A.prototype.some = function(fCallback, oThis) {
return this._array.some(fCallback, oThis);
}
}else{
jindo.$A.prototype.some = function(fCallback, oThis) {
var result = false;
this.forEach(function(v, i, a) {
if (fCallback.call(oThis, v, i, a) === true) {
result = true;
jindo.$A.Break();
}
});
return result;
}
}
return this.some(fCallback, oThis);
};
/**
* 배열에서 매개 변수와 같은 값을 제외하여 새로운 $A 객체를 만든다.
*
* @param {Value, ..., ValueN} oValueN 배열에서 제외할 값
* @return {$A} 배열에서 특정 값을 제외한 새로운 $A 객체
*
* @example
var arr = $A([12, 5, 8, 130, 44]);
var newArr1 = arr.refuse(12);
document.write(arr); // 결과 : [12, 5, 8, 130, 44]
document.write(newArr1); // 결과 : [5, 8, 130, 44]
var newArr2 = newArr1.refuse(8, 44, 130);
document.write(newArr1); // 결과 : [5, 8, 130, 44]
document.write(newArr2); // 결과 : [5]
*/
jindo.$A.prototype.refuse = function(oValue1/*, ...*/) {
var a = jindo.$A(Array.prototype.slice.apply(arguments));
return this.filter(function(v,i) { return !a.has(v) });
};
/**
* 배열에서 중복되는 원소를 삭제한다.
*
* @return {$A} 중복되는 원소를 제거한 $A 객체
*
* @example
var arr = $A([10, 3, 76, 5, 4, 3]);
arr.unique(); // 결과 : [10, 3, 76, 5, 4]
*/
jindo.$A.prototype.unique = function() {
var a = this._array, b = [], l = a.length;
var i, j;
/*
중복되는 원소 제거
*/
for(i = 0; i < l; i++) {
for(j = 0; j < b.length; j++) {
if (a[i] == b[j]) break;
}
if (j >= b.length) b[j] = a[i];
}
this._array = b;
return this;
};
/**
* @fileOverview $Ajax의 생성자 및 메서드를 정의한 파일
* @name Ajax.js
*/
/**
* $Ajax는 서버와 브라우저 사이의 비동기 통신, 즉 Ajax 통신을 지원한다. $Ajax는 XHR(XMLHTTPRequest)을 사용한 기본적인 방식과 함께 다른 호스트(Host) 사이의 통신을 위한 여러 방식을 제공한다.
* $Ajax 객체의 기본적인 초기화 방식은 다음과 같다.
* <textarea name="code" class="js:nocontrols">
* var oAjax = new $Ajax('server.php', {
type : 'xhr',
method : 'get', // GET 방식으로 통신
onload : function(res){ // 요청이 완료되면 실행될 콜백 함수
$('list').innerHTML = res.text();
},
timeout : 3, // 3초 이내에 요청이 완료되지 않으면 ontimeout 실행 (생략 시 0)
ontimeout : function(){ // 타임 아웃이 발생하면 실행될 콜백 함수, 생략 시 타임 아웃이 되면 아무 처리도 하지 않음
alert("Timeout!");
},
async : true // 비동기로 호출하는 경우, 생략하면 true
});
oAjax.request();
}
* </textarea>
*
* @extends core
* @class $Ajax 클래스는 다양한 개발 환경에서 Ajax 요청과 응답을 쉽게 구현하기 위한 메서드를 제공한다.<br>
*
* $Ajax를 초기화할 때 사용하는 매개 변수는 다음과 같다.
*
* @param {String} url Ajax 요청을 보낼 서버 측 URL.<br>
* @param {Object} option $Ajax 에서 사용하는 콜백 함수, 통신 방식 등과 같은 다양한 정보를 정의한다.<br>
* <br>
* option 객체의 프로퍼티와 사용법은 아래에서 설명한다.<br>
<table>
<thead style="background-color:#D2E0E6;">
<th>프로퍼티 명</th>
<th>타입</th>
<th>설명</th>
</thead>
<tbody>
<tr>
<td style="font-weight:bold;">type</td>
<td>String</td>
<td>
Ajax 구현 방식. 생략 시 기본 값은 "xhr"
<ul>
<li><strong>xhr</strong>
브라우저에 내장된 XMLHttpRequest 객체를 이용하여 Ajax 요청을 처리한다.<br>
응답으로는 text, xml, json 방식 모두 사용이 가능하며, 요청 실패 시 HTTP 응답코드를 통해 원인 파악이 가능하다.<br>
단, Cross-Domain 에서는 사용할 수 없다.
</li>
<li><strong>iframe</strong>
iframe 을 프록시로 사용하여 Ajax 요청을 처리한다. Cross-Domain 에서 사용한다.<br>
로컬(요청 하는 쪽)과 원격(요청 받는 쪽)에 모두 프록시용 HTML 파일을 만들어<br>
iframe 에서 원격 프록시에 요청하면, 원격 프록시에서 원격 도메인의 페이지에 XHR 로 Ajax 요청을 한다.<br>
응답을 받은 원격 프록시에서 로컬 프록시로 응답을 전달하면 로컬 프록시에서 최종적으로 콜백 함수(onload)를 호출하여 처리된다.<br>
<ul type="disc">
<li>원격 프록시 파일 : ajax_remote_callback.html</li>
<li>로컬 프록시 파일 : ajax_local_callback.html</li>
</ul>
※ IE 에서는 "딱.딱." 하는 페이지 이동음이 들릴 수도 있다 (요청당 2회).
</li>
<li><strong>jsonp</strong>
JSON 과 &lt;script&gt; 태그를 사용하여 사용하여 Ajax 요청을 처리한다. Cross-Domain 에서 사용한다.<br>
&lt;script&gt; 태그를 동적으로 생성하여, 요청할 원격 페이지를 스크립트에 삽입하여 GET 방식으로 요청을 전송한다.<br>
요청 시에 콜백 함수를 매개 변수로 넘기면, 원격 페이지에서 전달받은 콜백 함수명으로 아래와 같이 응답을 보낸다.<br>
<ul type="disc"><li>function_name(...결과 값...)</li></ul>
응답은 콜백 함수(onload)에서 처리된다.<br>
※ GET 방식만 가능하므로, 전송 데이터 길이는 URL 에 허용하는 길이로 제한된다.
</li>
<li><strong>flash</strong>
플래시 객체를 사용하여 Ajax 요청을 처리한다. Cross-Domain 에서 사용한다.<br>
서버의 루트에 crossdomain.xml 이 존재해야 하며 접근 권한을 설정해야 사용할 수 있다.<br>
모든 통신은 플래시 객체를 통하여 주고 받으며 Ajax 호출을 하기 전에 반드시 플래시 객체를 초기화해야 한다.<br>
$Ajax.SWFRequest.write 메서드 사용하여 초기화하며 해당 메서드는 &lt;body&gt; 태그 내에 작성한다.
</li>
<li><strong>get/post/put/delete</strong> : 내부적으로 xhr 로 처리한다.</li>
</ul>
</td>
</tr>
<tr>
<td style="font-weight:bold;">method</td>
<td>String</td>
<td>
HTTP 통신 방법
<ul>
<li><strong>post</strong> : 생략 시 기본 값.</li>
<li><strong>get</strong> : type 이 "jsonp" 이면 "get" 으로 설정된다.</li>
<li><strong>put</strong> : 1.4.2 부터 사용 가능</li>
<li><strong>delete</strong> : 1.4.2 부터 사용 가능</li>
</ul>
</td>
</tr>
<tr>
<td style="font-weight:bold;">timeout</td>
<td>Number</td>
<td>
요청 타임아웃 시간. 생략 시 0 (단위는 초).<br>
타임아웃 시간 내에 요청이 완료되지 않으면 중지시킨다.<br>
비동기 호출인 경우에만 사용 가능하다.
</td>
</tr>
<tr>
<td style="font-weight:bold;">onload</td>
<td>Function</td>
<td>
요청이 완료되면 실행할 콜백 함수. 반드시 지정해야 한다.<br>
매개 변수로 응답 객체인 $Ajax.Response 객체가 전달 된다.
</td>
</tr>
<tr>
<td style="font-weight:bold;">onerror</td>
<td>Function</td>
<td>
요청이 실패하면 실행할 콜백 함수.<br>
생략하면 에러가 발생해도 onload 를 실행한다.
</td>
</tr>
<tr>
<td style="font-weight:bold;">ontimeout</td>
<td>Function</td>
<td>
타임아웃이 되었을 때 실행할 콜백 함수.<br>
생략하면 타임아웃 발생 후에 아무런 처리를 하지 않는다.
</td>
</tr>
<tr>
<td style="font-weight:bold;">proxy</td>
<td>String</td>
<td>
로컬 프록시 파일(ajax_local_callback.html)의 경로.<br>
type 이 "iframe" 일 때 사용하며 반드시 지정해야 한다.
</td>
</tr>
<tr>
<td style="font-weight:bold;">jsonp_charset</td>
<td>String</td>
<td>
요청 시 사용할 &lt;script&gt; 인코딩 방식.<br>
type 이 "jsonp" 일 때 사용한다. 생략하면 "utf-8" 이 기본값이다. (0.4.2 부터 지원)
</td>
</tr>
<tr>
<td style="font-weight:bold;">callbackid</td>
<td>String</td>
<td>
콜백 함수 이름에 사용할 아이디 값.<br>
type 이 "jsonp" 일 때 사용한다. (1.3.0 부터 지원)<br>
생략하면 자동으로 랜덤한 아이디 값을 생성하여 사용한다.
<br>
jsonp 방식에서 Ajax 요청 시, 콜백 함수 이름에 랜덤한 아이디 값을 덧붙여 만든 콜백 함수 이름을 서버로 전달한다.<br>
이 때 랜덤한 값을 아이디로 사용하여 넘기므로 요청 URL이 매번 새롭게 생성되어 캐쉬 서버가 아닌 서버로 직접 데이터를 요청하게 된다.<br>
아이디 값을 지정하면 랜덤한 아이디 값으로 콜백 함수 이름을 생성하지 않으므로<br>
캐쉬 서버를 사용하여 그에 대한 히트율을 높이고자 할 때 아이디를 지정하여 사용할 수 있다.
</td>
</tr>
<tr>
<td style="font-weight:bold;">callbackname</td>
<td>String</td>
<td>
콜백 함수 이름을 가지는 매개변수 이름.<br>
type 이 "jsonp" 일 때 사용한다. 기본 값은 "_callback" 이다. (1.3.8 부터 지원)
</td>
</tr>
<tr>
<td style="font-weight:bold;">sendheader</td>
<td>Boolean</td>
<td>
요청 헤더를 전송할지 여부.<br>
type 이 "flash" 일 때 사용하며, 서버에서 접근 권한을 설정하는 crossdomain.xml 에<br>
allow-header 가 없는 경우에 false 로 설정해야 한다.<br>
플래시 9에서는 allow-header가 false인 경우 get만 ajax가 되면 post는 ajax가 안된다.<br>
플래시 10에서는 allow-header가 false인 경우 get,post 둘다 ajax가 안된다.<br>
그래서 allow-header가 설정되어 있지 않다면 반드시 false로 셋팅해야 한다.<br>
기본 값은 true 이다. (1.3.4부터 지원)
</td>
</tr>
<tr>
<td style="font-weight:bold;">async</td>
<td>Boolean</td>
<td>
비동기 호출 여부.<br>
type 이 "xhr" 일 때만 유효하다. 기본 값은 true 이다. (1.3.7부터 지원)
</td>
</tr>
<tr>
<td style="font-weight:bold;">decode</td>
<td>Boolean</td>
<td>
type 이 "flash" 일 때 사용하며, 요청한 데이터 안에 utf-8 이 아닌 다른 인코딩이 되어 있을때 false 로 지정한다.<br>
기본 값은 true 이다. (1.4.0부터 지원)
</td>
</tr>
<tr>
<td style="font-weight:bold;">postBody</td>
<td>Boolean</td>
<td>
요청 시 서버로 전달할 데이터를 Body 영역에 전달할 지의 여부.<br>
type 이 "xhr" 이고 method 가 "get"이 아니어야 유효하며 REST 환경에서 사용된다.<br>
기본값은 false 이다. (1.4.2부터 지원)
</td>
</tr>
</tbody>
</table>
* @constructor
* @description [Lite]
* @see <a href="http://dev.naver.com/projects/jindo/wiki/cross%20domain%20ajax">Cross Domain Ajax 이해</a>
* @author Kim, Taegon
*
* @example
// 'Get List' 버튼 클릭 시, 서버에서 데이터를 받아와 리스트를 구성하는 예제
// (1) 서버 페이지와 서비스 페이지가 같은 도메인에 있는 경우 - xhr
// [client.html]
<!DOCTYPE html>
<html>
<head>
<title>Ajax Sample</title>
<meta http-equiv="content-type" content="text/html; charset=utf-8"/>
<script type="text/javascript" language="javascript" src="lib/jindo.all.js"></script>
<script type="text/javascript" language="javascript">
function getList() {
var oAjax = new $Ajax('server.php', {
type : 'xhr',
method : 'get', // GET 방식으로 통신
onload : function(res){ // 요청이 완료되면 실행될 콜백 함수
$('list').innerHTML = res.text();
},
timeout : 3, // 3초 이내에 요청이 완료되지 않으면 ontimeout 실행 (생략 시 0)
ontimeout : function(){ // 타임 아웃이 발생하면 실행될 콜백 함수, 생략 시 타임 아웃이 되면 아무 처리도 하지 않음
alert("Timeout!");
},
async : true // 비동기로 호출하는 경우, 생략하면 true
});
oAjax.request();
}
</script>
</head>
<body>
<button onclick="getList(); return false;">Get List</button>
<ul id="list">
</ul>
</body>
</html>
// [server.php]
<?php
echo "<li>첫번째</li><li>두번째</li><li>세번째</li>";
?>
* @example
// 'Get List' 버튼 클릭 시, 서버에서 데이터를 받아와 리스트를 구성하는 예제
// (2) 서버 페이지와 서비스 페이지가 같은 도메인에 있는 경우 - iframe
// [http://local.com/some/client.html]
<!DOCTYPE html>
<html>
<head>
<title>Ajax Sample</title>
<meta http-equiv="content-type" content="text/html; charset=utf-8"/>
<script type="text/javascript" language="javascript" src="lib/jindo.all.js"></script>
<script type="text/javascript" language="javascript">
function getList() {
var oAjax = new $Ajax('http://server.com/some/some.php', {
type : 'iframe',
method : 'get', // GET 방식으로 통신
// POST로 지정하면 원격 프록시 파일에서 some.php 로 요청 시에 POST 방식으로 처리
onload : function(res){ // 요청이 완료되면 실행될 콜백 함수
$('list').innerHTML = res.text();
},
// 로컬 프록시 파일의 경로.
// 반드시 정확한 경로를 지정해야 하며, 로컬 도메인의 경로라면 어디에 두어도 상관 없음
// (※ 원격 프록시 파일은 반드시 원격 도메인 서버의 도메인 루트 상에 두어야 함)
proxy : 'http://local.naver.com/some/ajax_local_callback.html'
});
oAjax.request();
}
</script>
</head>
<body>
<button onclick="getList(); return false;">Get List</button>
<ul id="list">
</ul>
</body>
</html>
// [http://server.com/some/some.php]
<?php
echo "<li>첫번째</li><li>두번째</li><li>세번째</li>";
?>
* @example
// 'Get List' 버튼 클릭 시, 서버에서 데이터를 받아와 리스트를 구성하는 예제
// (3) 서버 페이지와 서비스 페이지가 같은 도메인에 있는 경우 - jsonp
// [http://local.com/some/client.html]
<!DOCTYPE html>
<html>
<head>
<title>Ajax Sample</title>
<meta http-equiv="content-type" content="text/html; charset=utf-8"/>
<script type="text/javascript" language="javascript" src="lib/jindo.all.js"></script>
<script type="text/javascript" language="javascript">
function getList(){
var oAjax = new $Ajax('http://server.com/some/some.php', {
type: 'jsonp',
method: 'get', // type 이 jsonp 이면 get 으로 지정하지 않아도 자동으로 get 으로 처리함 (생략가능)
jsonp_charset: 'utf-8', // 요청 시 사용할 <script> 인코딩 방식 (생략 시 utf-8)
onload: function(res){ // 요청이 완료되면 실행될 콜백 함수
var response = res.json();
var welList = $Element('list').empty();
for (var i = 0, nLen = response.length; i < nLen; i++) {
welList.append($("<li>" + response[i] + "</li>"));
}
},
callbackid: '12345', // 콜백 함수 이름에 사용할 아이디 값 (생략가능)
callbackname: 'ajax_callback_fn' // 서버에서 사용할 콜백 함수이름을 가지는 매개 변수 이름 (생략 시 '_callback')
});
oAjax.request();
}
</script>
</head>
<body>
<button onclick="getList(); return false;">Get List</button>
<ul id="list">
</ul>
</body>
</html>
// [http://server.com/some/some.php]
<?php
$callbackName = $_GET['ajax_callback_fn'];
echo $callbackName."(['첫번째','두번째','세번째'])";
?>
* @example
// 'Get List' 버튼 클릭 시, 서버에서 데이터를 받아와 리스트를 구성하는 예제
// (4) 서버 페이지와 서비스 페이지가 같은 도메인에 있는 경우 - flash
// [http://local.com/some/client.html]
<!DOCTYPE html>
<html>
<head>
<title>Ajax Sample</title>
<meta http-equiv="content-type" content="text/html; charset=utf-8"/>
<script type="text/javascript" language="javascript" src="lib/jindo.all.js"></script>
<script type="text/javascript" language="javascript">
function getList(){
var oAjax = new $Ajax('http://server.com/some/some.php', {
type : 'flash',
method : 'get', // GET 방식으로 통신
sendheader : false, // 요청 헤더를 전송할지 여부. (생략 시 true)
decode : true, // 요청한 데이터 안에 utf-8 이 아닌 다른 인코딩이 되어 있을때 false. (생략 시 true)
onload : function(res){ // 요청이 완료되면 실행될 콜백 함수
$('list').innerHTML = res.text();
},
});
oAjax.request();
}
</script>
</head>
<body>
<script type="text/javascript">
$Ajax.SWFRequest.write("swf/ajax.swf"); // Ajax 호출을 하기 전에 반드시 플래시 객체를 초기화
</script>
<button onclick="getList(); return false;">Get List</button>
<ul id="list">
</ul>
</body>
</html>
// [http://server.com/some/some.php]
<?php
echo "<li>첫번째</li><li>두번째</li><li>세번째</li>";
?>
*/
jindo.$Ajax = function (url, option) {
var cl = arguments.callee;
if (!(this instanceof cl)) return new cl(url, option);
function _getXHR() {
if (window.XMLHttpRequest) {
return new XMLHttpRequest();
} else if (ActiveXObject) {
try {
return new ActiveXObject('MSXML2.XMLHTTP');
}catch(e) {
return new ActiveXObject('Microsoft.XMLHTTP');
}
return null;
}
}
var loc = location.toString();
var domain = '';
try { domain = loc.match(/^https?:\/\/([a-z0-9_\-\.]+)/i)[1]; } catch(e) {}
this._status = 0;
this._url = url;
this._options = new Object;
this._headers = new Object;
this._options = {
type :"xhr",
method :"post",
proxy :"",
timeout:0,
onload :function(req){},
onerror :null,
ontimeout:function(req){},
jsonp_charset : "utf-8",
callbackid : "",
callbackname : "",
sendheader : true,
async : true,
decode :true,
postBody :false
};
this.option(option);
/*
테스트를 위해 우선 적용가능한 설정 객체가 존재하면 적용
*/
if(jindo.$Ajax.CONFIG){
this.option(jindo.$Ajax.CONFIG);
}
var _opt = this._options;
_opt.type = _opt.type.toLowerCase();
_opt.method = _opt.method.toLowerCase();
if (typeof window.__jindo2_callback == "undefined") {
window.__jindo2_callback = new Array();
}
switch (_opt.type) {
case "put":
case "delete":
case "get":
case "post":
_opt.method = _opt.type;
_opt.type = "xhr";
case "xhr":
this._request = _getXHR();
break;
case "flash":
if(!jindo.$Ajax.SWFRequest) throw Error('Require jindo.$Ajax.SWFRequest');
this._request = new jindo.$Ajax.SWFRequest(jindo.$Fn(this.option,this).bind());
break;
case "jsonp":
if(!jindo.$Ajax.JSONPRequest) throw Error('Require jindo.$Ajax.JSONPRequest');
_opt.method = "get";
this._request = new jindo.$Ajax.JSONPRequest(jindo.$Fn(this.option,this).bind());
break;
case "iframe":
if(!jindo.$Ajax.FrameRequest) throw Error('Require jindo.$Ajax.FrameRequest');
this._request = new jindo.$Ajax.FrameRequest(jindo.$Fn(this.option,this).bind());
break;
}
};
/**
* @ignore
*/
jindo.$Ajax.prototype._onload = (function(isIE) {
if(isIE){
return function(){
var bSuccess = this._request.readyState == 4 && this._request.status == 200;
var oResult;
if (this._request.readyState == 4) {
try {
if (this._request.status != 200 && typeof this._options.onerror == 'function'){
if(!this._request.status == 0){
this._options.onerror(jindo.$Ajax.Response(this._request));
}
}else{
if(!this._is_abort){
oResult = this._options.onload(jindo.$Ajax.Response(this._request));
}
}
}finally{
if(typeof this._oncompleted == 'function'){
this._oncompleted(bSuccess, oResult);
}
if (this._options.type == "xhr" ){
this.abort();
try { delete this._request.onload; } catch(e) { this._request.onload =undefined;}
}
delete this._request.onreadystatechange;
}
}
}
}else{
return function(){
var bSuccess = this._request.readyState == 4 && this._request.status == 200;
var oResult;
if (this._request.readyState == 4) {
try {
if (this._request.status != 200 && typeof this._options.onerror == 'function'){
this._options.onerror(jindo.$Ajax.Response(this._request));
}else{
oResult = this._options.onload(jindo.$Ajax.Response(this._request));
}
}finally{
this._status--;
if(typeof this._oncompleted == 'function'){
this._oncompleted(bSuccess, oResult);
}
}
}
}
}
})(/MSIE/.test(window.navigator.userAgent));
/**
* request 메서드는 Ajax 요청을 서버에 전송한다.<br>
* 요청에 사용할 매개 변수는 $Ajax 생성자에서 설정하거나 option 메서드에서 변경할 수 있다.<br>
*
* @remark 요청 타입(type)이 "flash" 이면 이 메소드를 실행하기 전에 body 태그 내부에서 $Ajax.SWFRequest.write() 명령어를 반드시 실행해야 한다.
*
* @param {Object} oData 서버로 전송할 데이터.
* @return {$Ajax} $Ajax 객체
* @description [Lite]
* @example
*
*
var ajax = $Ajax("http://www.remote.com", {
onload : function(res) {
// onload 핸들러
}
});
ajax.request( {key1:"value1", key2:"value2"} ); // 서버에 전송할 데이터를 매개변수로 넘긴다.
*/
jindo.$Ajax.prototype.request = function(oData) {
this._status++;
var t = this;
var req = this._request;
var opt = this._options;
var data, v,a = [], data = "";
var _timer = null;
var url = this._url;
this._is_abort = false;
if( opt.postBody && opt.type.toUpperCase()=="XHR" && opt.method.toUpperCase()!="GET"){
if(typeof oData == 'string'){
data = oData;
}else{
data = jindo.$Json(oData).toString();
}
}else if (typeof oData == "undefined" || !oData) {
data = null;
} else {
for(var k in oData) {
if(oData.hasOwnProperty(k)){
v = oData[k];
if (typeof v == "function") v = v();
if (v instanceof Array || v instanceof jindo.$A) {
jindo.$A(v).forEach(function(value,index,array) {
a[a.length] = k+"="+encodeURIComponent(value);
});
} else {
a[a.length] = k+"="+encodeURIComponent(v);
}
}
}
data = a.join("&");
}
/*
XHR GET 방식 요청인 경우 URL에 파라미터 추가
*/
if(data && opt.type.toUpperCase()=="XHR" && opt.method.toUpperCase()=="GET"){
if(url.indexOf('?')==-1){
url += "?";
} else {
url += "&";
}
url += data;
data = null;
}
req.open(opt.method.toUpperCase(), url, opt.async);
if(opt.type.toUpperCase()=="XHR"&&opt.method.toUpperCase()=="GET"&&/MSIE/.test(window.navigator.userAgent)){
/*
xhr인 경우 IE에서는 GET으로 보낼 때 브라우져에서 자체 cache하여 cache을 안되게 수정.
*/
req.setRequestHeader("If-Modified-Since", "Thu, 1 Jan 1970 00:00:00 GMT");
}
if (opt.sendheader) {
if(!this._headers["Content-Type"]){
req.setRequestHeader("Content-Type", "application/x-www-form-urlencoded; charset=utf-8");
}
req.setRequestHeader("charset", "utf-8");
for (var x in this._headers) {
if(this._headers.hasOwnProperty(x)){
if (typeof this._headers[x] == "function")
continue;
req.setRequestHeader(x, String(this._headers[x]));
}
}
}
var navi = navigator.userAgent;
if(req.addEventListener&&!(navi.indexOf("Opera") > -1)&&!(navi.indexOf("MSIE") > -1)){
/*
* opera 10.60에서 XMLHttpRequest에 addEventListener기 추가되었지만 정상적으로 동작하지 않아 opera는 무조건 dom1방식으로 지원함.
* IE9에서도 opera와 같은 문제가 있음.
*/
if(this._loadFunc){ req.removeEventListener("load", this._loadFunc, false); }
this._loadFunc = function(rq){
clearTimeout(_timer);
_timer = undefined;
t._onload(rq);
}
req.addEventListener("load", this._loadFunc, false);
}else{
if (typeof req.onload != "undefined") {
req.onload = function(rq){
if(req.readyState == 4 && !t._is_abort){
clearTimeout(_timer);
_timer = undefined;
t._onload(rq);
}
};
} else {
/*
* IE6에서는 onreadystatechange가 동기적으로 실행되어 timeout이벤트가 발생안됨.
* 그래서 interval로 체크하여 timeout이벤트가 정상적으로 발생되도록 수정. 비동기 방식일때만
*/
if(window.navigator.userAgent.match(/(?:MSIE) ([0-9.]+)/)[1]==6&&opt.async){
var onreadystatechange = function(rq){
if(req.readyState == 4 && !t._is_abort){
if(_timer){
clearTimeout(_timer);
_timer = undefined;
}
t._onload(rq);
clearInterval(t._interval);
t._interval = undefined;
}
};
this._interval = setInterval(onreadystatechange,300);
}else{
req.onreadystatechange = function(rq){
if(req.readyState == 4){
clearTimeout(_timer);
_timer = undefined;
t._onload(rq);
}
};
}
}
}
if (opt.timeout > 0) {
// if(this._interval)clearInterval(this._interval);
if(this._timer) clearTimeout(this._timer);
_timer = setTimeout(function(){
t._is_abort = true;
if(t._interval){
clearInterval(t._interval);
t._interval = undefined;
}
try{ req.abort(); }catch(e){};
opt.ontimeout(req);
if(typeof t._oncompleted == 'function') t._oncompleted(false);
}, opt.timeout * 1000 );
this._timer = _timer;
}
/*
* test을 하기 위한 url
*/
this._test_url = url;
req.send(data);
return this;
};
/**
* isIdle 메서드는 Ajax 객체가 현재 요청 대기 상태인지 확인한다.
* @return {Boolean} 현재 대기 중이면 true 를, 그렇지 않으면 false를 리턴한다.
* @since 1.3.5 부터 사용 가능
* @description [Lite]
* @example
var ajax = $Ajax("http://www.remote.com",{
onload : function(res){
// onload 핸들러
}
});
if(ajax.isIdle()) ajax.request();
*/
jindo.$Ajax.prototype.isIdle = function(){
return this._status==0;
}
/**
* abort 메서드는 서버로 전송한 Ajax 요청을 취소한다. Ajax 요청의 응답 시간이 길거나 강제로 Ajax 요청을 취소할 경우 사용한다.
* @return {$Ajax} 전송을 취소한 $Ajax 객체
* @description [Lite]
* @example
var ajax = $Ajax("http://www.remote.com", {
timeout : 3,
ontimeout : function() {
stopRequest();
}
onload : function(res) {
// onload 핸들러
}
}).request( {key1:"value1", key2:"value2"} );
function stopRequest() {
ajax.abort();
}
*/
jindo.$Ajax.prototype.abort = function() {
try {
if(this._interval) clearInterval(this._interval);
if(this._timer) clearTimeout(this._timer);
this._interval = undefined;
this._timer = undefined;
this._is_abort = true;
this._request.abort();
}finally{
this._status--;
}
return this;
};
/**
* option 메서드는 Ajax 요청에서 사용한 정보를 가져오거나 혹은 설정한다.<br>
* 설정하려면 이름과 값을, 혹은 이름과 값을 원소로 가지는 하나의 객체를 매개 변수로 사용한다.<br>
* 이름과 값을 원소로 가지는 객체를 사용하면 두 개 이상의 정보를 한 번에 설정할 수 있다.
*
* @param {String | Object} name <br>
* 매개 변수의 타입은 문자열 혹은 객체를 사용한다.<br>
* <br>
* 문자열을 매개 변수로 사용하면 다음과 같이 동작한다..<br>
* 1. value 매개 변수를 생략하면 이름에 해당하는 $Ajax의 속성 값을 리턴한다.<br>
* 2. value 매개 변수를 설정하면 이름에 해당하는 $Ajax의 속성에 value를 값으로 설정한다.<br>
* <br>
* 객체인 경우에는 속성 이름으로 정보를 찾아 속성의 값으로 설정한다. 객체에 두 개 이상의 속성을 지정하면 여러 속성 값을 한 번에 설정할 수 있다.
* @param {String} [value] 새로 설정할 정보의 값. name 매개 변수가 문자열인 경우에만 사용된다.
* @return {String|$Ajax} 정보의 값을 가져올 때는 문자열을, 값을 설정할 때는 $Ajax 객체를 리턴한다.
* @description [Lite]
* @example
var ajax = $Ajax("http://www.remote.com", {
type : "xhr",
method : "get",
onload : function(res) {
// onload 핸들러
}
});
var request_type = ajax.option("type"); // type 인 xhr 을 리턴한다.
ajax.option("method", "post"); // method 를 post 로 설정한다.
ajax.option( { timeout : 0, onload : handler_func } ); // timeout 을 으로, onload 를 handler_func 로 설정한다.
*/
jindo.$Ajax.prototype.option = function(name, value) {
if (typeof name == "undefined") return "";
if (typeof name == "string") {
if (typeof value == "undefined") return this._options[name];
this._options[name] = value;
return this;
}
try {
for(var x in name){
if(name.hasOwnProperty(x))
this._options[x] = name[x]
}
} catch(e) {};
return this;
};
/**
* header 메서드는 Ajax 요청에서 사용할 HTTP 요청 헤더를 가져오거나 설정한다.<br>
* 헤더를 설정하려면 헤더의 이름과 값을 각각 매개 변수로 사용하거나, 헤더의 이름과 값을 원소로 가지는 객체를 매개 변수로 사용한다. 만약 여러 개의 속성을 가진 객체를 사용하면 두 개 이상의 헤더를 한 번에 설정할 수 있다.<br>
* 헤더에서 특정 속성의 값을 가져오려면 속성의 이름을 매개 변수로 사용한다.
*
* @param {String|Object} name <br>
* 매개 변수의 타입은 문자열 혹은 객체를 사용한다.<br>
* <br>
* 문자열을 매개 변수로 사용하면 다음과 같이 동작한다. <br>
* 1. value 매개 변수를 생략하면 HTTP 요청 헤더에서 문자열과 일치하는 속성값을 찾는다.<br>
* 2. value 매개 변수를 설정하면 HTTP 요청 헤더에서 문자열과 일치하는 속성에 value를 값으로 설정한다.<br>
* <br>
* 객체인 경우에는 속성 이름으로 정보를 찾아 속성의 값으로 설정한다. 객체에 두 개 이상의 속성을 지정하면 HTTP 요청 헤더에서 여러 속성 값을 한 번에 설정할 수 있다.
* @param {Value} [value] 설정할 헤더 값. name 매개 변수가 문자열인 경우에만 사용된다.
* @return {String|$Ajax} 정보의 값을 가져올 때는 문자열을, 값을 설정할 때는 $Ajax 객체를 리턴한다.
* @description [Lite]
* @example
var customheader = ajax.header("myHeader"); // HTTP 요청 헤더에서 myHeader 의 값
ajax.header( "myHeader", "someValue" ); // HTTP 요청 헤더의 myHeader 를 someValue 로 설정한다.
ajax.header( { anotherHeader : "someValue2" } ); // HTTP 요청 헤더의 anotherHeader 를 someValue2 로 설정한다.
*/
jindo.$Ajax.prototype.header = function(name, value) {
if (typeof name == "undefined") return "";
if (typeof name == "string") {
if (typeof value == "undefined") return this._headers[name];
this._headers[name] = value;
return this;
}
try {
for (var x in name) {
if (name.hasOwnProperty(x))
this._headers[x] = name[x]
}
} catch(e) {};
return this;
};
/**
* Ajax 응답 객체를 래핑하여 응답을 가져오는데 유용한 메서드를 제공한다.
* @class $Ajax.Response 객체를 생성하여 리턴한다.<br>
* $Ajax 객체에서 request 요청 처리 완료 후, 생성되며 $Ajax 생성 시에 설정한 onload 콜백 함수의 매개 변수로 전달된다.
* @constructor
* @param {Object} req 요청 객체
* @description [Lite]
*/
jindo.$Ajax.Response = function(req) {
if (this === jindo.$Ajax) return new jindo.$Ajax.Response(req);
this._response = req;
};
/**
* 응답을 XML 객체로 리턴한다.
* @return {Object} 응답 XML 객체. XHR의 responseXML 과 유사하다.
* @description [Lite]
*
* @example
// some.xml
<?xml version="1.0" encoding="utf-8"?>
<data>
<li>첫번째</li>
<li>두번째</li>
<li>세번째</li>
</data>
// client.html
var oAjax = new $Ajax('some.xml', {
type : 'xhr',
method : 'get',
onload : function(res){
var elData = cssquery.getSingle('data', res.xml()); // 응답을 XML 객체로 리턴한다
$('list').innerHTML = elData.firstChild.nodeValue;
},
}).request();
*/
jindo.$Ajax.Response.prototype.xml = function() {
return this._response.responseXML;
};
/**
* 응답을 문자열로 리턴한다.
* @return {String} 응답 문자열. XHR의 responseText 와 유사하다.
* @description [Lite]
*
* @example
// some.php
<?php
echo "<li>첫번째</li><li>두번째</li><li>세번째</li>";
?>
// client.html
var oAjax = new $Ajax('some.xml', {
type : 'xhr',
method : 'get',
onload : function(res){
$('list').innerHTML = res.text(); // 응답을 문자열로 리턴한다
},
}).request();
*/
jindo.$Ajax.Response.prototype.text = function() {
return this._response.responseText;
};
/**
* HTTP 응답 코드를 리턴한다.
* @return {Number} 응답 코드. http 응답 코드표를 참고한다.
* @description [Lite]
*
* @example
var oAjax = new $Ajax('some.php', {
type : 'xhr',
method : 'get',
onload : function(res){
if(res.status() == 200){ // HTTP 응답 코드를 확인한다.
$('list').innerHTML = res.text();
}
},
}).request();
*/
jindo.$Ajax.Response.prototype.status = function() {
return this._response.status;
};
/**
* 응답의 readyState 를 리턴한다.
* @return {Number} readyState.
* @description [Lite]
*
* @example
var oAjax = new $Ajax('some.php', {
type : 'xhr',
method : 'get',
onload : function(res){
if(res.readyState() == 4){ // 응답의 readyState 를 확인한다.
$('list').innerHTML = res.text();
}
},
}).request();
*/
jindo.$Ajax.Response.prototype.readyState = function() {
return this._response.readyState;
};
/**
* 응답을 JSON 객체로 리턴한다.
* @return {Object} 응답 JSON 객체. <br>
* 응답 문자열을 자동으로 JSON 객체로 변환하여 리턴한다. 변환 과정에서 오류가 발생하면 빈 객체를 리턴한다.
* @description [Lite]
*
* @example
// some.php
<?php
echo "['첫번째', '두번째', '세번째']";
?>
// client.html
var oAjax = new $Ajax('some.php', {
type : 'xhr',
method : 'get',
onload : function(res){
var welList = $Element('list').empty();
var jsonData = res.json(); // 응답을 JSON 객체로 리턴한다
for(var i = 0, nLen = jsonData.length; i < nLen; i++){
welList.append($("<li>" + jsonData[i] + "</li>"));
}
},
}).request();
*/
jindo.$Ajax.Response.prototype.json = function() {
if (this._response.responseJSON) {
return this._response.responseJSON;
} else if (this._response.responseText) {
try {
return eval("("+this._response.responseText+")");
} catch(e) {
return {};
}
}
return {};
};
/**
* 응답 헤더를 가져온다. 매개 변수를 전달하지 않으면 헤더 전체를 리턴한다.
* @param {String} name 가져올 응답 헤더의 이름
* @return {String|Object} 매개 변수가 있을 때는 해당하는 헤더 값을, 그렇지 않으면 헤더 전체를 리턴한다.
* @description [Lite]
*
* @example
var oAjax = new $Ajax('some.php', {
type : 'xhr',
method : 'get',
onload : function(res){
res.header(); // 응답 헤더 전체를 리턴한다.
res.header("Content-Length") // 응답 헤더에서 "Content-Length" 의 값을 리턴한다.
},
}).request();
*/
jindo.$Ajax.Response.prototype.header = function(name) {
if (typeof name == "string") return this._response.getResponseHeader(name);
return this._response.getAllResponseHeaders();
};
/**
* @fileOverview $Ajax의 확장 메서드를 정의한 파일
* @name Ajax.extend.js
*/
/**
* Ajax 요청 타입 별로 요청 객체를 생성하기 위한 상위 객체로 사용한다.
* @class Ajax 요청 객체의 기본 객체이다.
*/
jindo.$Ajax.RequestBase = jindo.$Class({
_respHeaderString : "",
callbackid:"",
callbackname:"",
responseXML : null,
responseJSON : null,
responseText : "",
status : 404,
readyState : 0,
$init : function(fpOption){},
onload : function(){},
abort : function(){},
open : function(){},
send : function(){},
setRequestHeader : function(sName, sValue) {
this._headers[sName] = sValue;
},
getResponseHeader : function(sName) {
return this._respHeaders[sName] || "";
},
getAllResponseHeaders : function() {
return this._respHeaderString;
},
_getCallbackInfo : function() {
var id = "";
if(this.option("callbackid")!="") {
var idx = 0;
do {
id = "_" + this.option("callbackid") + "_"+idx;
idx++;
} while (window.__jindo2_callback[id]);
}else{
do {
id = "_" + Math.floor(Math.random() * 10000);
} while (window.__jindo2_callback[id]);
}
if(this.option("callbackname") == ""){
this.option("callbackname","_callback");
}
return {callbackname:this.option("callbackname"),id:id,name:"window.__jindo2_callback."+id};
}
});
/**
* $Ajax.JSONPRequest 객체를 생성하여 리턴한다.
* @extends $Ajax.RequestBase
* @class Ajax 요청 타입(type)이 jsonp 인 요청 객체를 생성하며, jindo.$Ajax 생성자에서 요청 객체 생성 시 사용한다.
*/
jindo.$Ajax.JSONPRequest = jindo.$Class({
_headers : {},
_respHeaders : {},
_script : null,
_onerror : null,
$init : function(fpOption){
this.option = fpOption;
},
_callback : function(data) {
if (this._onerror) {
clearTimeout(this._onerror);
this._onerror = null;
}
var self = this;
this.responseJSON = data;
this.onload(this);
setTimeout(function(){ self.abort() }, 10);
},
abort : function() {
if (this._script) {
try {
this._script.parentNode.removeChild(this._script);
}catch(e){
};
}
},
open : function(method, url) {
this.responseJSON = null;
this._url = url;
},
send : function(data) {
var t = this;
var info = this._getCallbackInfo();
var head = document.getElementsByTagName("head")[0];
this._script = jindo.$("<script>");
this._script.type = "text/javascript";
this._script.charset = this.option("jsonp_charset");
if (head) {
head.appendChild(this._script);
} else if (document.body) {
document.body.appendChild(this._script);
}
window.__jindo2_callback[info.id] = function(data){
try {
t.readyState = 4;
t.status = 200;
t._callback(data);
} finally {
delete window.__jindo2_callback[info.id];
}
};
var agent = jindo.$Agent(navigator);
if (agent.navigator().ie || agent.navigator().opera) {
this._script.onreadystatechange = function(){
if (this.readyState == 'loaded'){
if (!t.responseJSON) {
t.readyState = 4;
t.status = 500;
t._onerror = setTimeout(function(){t._callback(null);}, 200);
}
this.onreadystatechange = null;
}
};
} else {
this._script.onload = function(){
if (!t.responseJSON) {
t.readyState = 4;
t.status = 500;
t._onerror = setTimeout(function(){t._callback(null);}, 200);
}
this.onload = null;
this.onerror = null;
};
this._script.onerror = function(){
if (!t.responseJSON) {
t.readyState = 4;
t.status = 404;
t._onerror = setTimeout(function(){t._callback(null);}, 200);
}
this.onerror = null;
this.onload = null;
};
}
var delimiter = "&";
if(this._url.indexOf('?')==-1){
delimiter = "?";
}
if (data) {
data = "&" + data;
}else{
data = "";
}
//test url for spec.
this._test_url = this._url+delimiter+info.callbackname+"="+info.name+data;
this._script.src = this._url+delimiter+info.callbackname+"="+info.name+data;
}
}).extend(jindo.$Ajax.RequestBase);
/**
* $Ajax.SWFRequest 객체를 생성하여 리턴한다.
* @extends $Ajax.RequestBase
* @class Ajax 요청 타입(type)이 flash 인 요청 객체를 생성하며, jindo.$Ajax 생성자에서 요청 객체 생성 시 사용한다.
*/
jindo.$Ajax.SWFRequest = jindo.$Class({
$init : function(fpOption){
this.option = fpOption;
},
_headers : {},
_respHeaders : {},
_getFlashObj : function(){
var navi = jindo.$Agent(window.navigator).navigator();
var obj;
if (navi.ie&&navi.version==9) {
obj = document.getElementById(jindo.$Ajax.SWFRequest._tmpId);
}else{
obj = window.document[jindo.$Ajax.SWFRequest._tmpId];
}
return(this._getFlashObj = function(){
return obj;
})();
},
_callback : function(status, data, headers){
this.readyState = 4;
/*
하위 호환을 위해 status가 boolean 값인 경우도 처리
*/
if( (typeof status).toLowerCase() == 'number'){
this.status = status;
}else{
if(status==true) this.status=200;
}
if (this.status==200) {
if (typeof data == "string") {
try {
this.responseText = this.option("decode")?decodeURIComponent(data):data;
if(!this.responseText || this.responseText=="") {
this.responseText = data;
}
} catch(e) {
/*
데이터 안에 utf-8이 아닌 다른 인코딩일때 디코딩을 안하고 바로 text에 저장.
*/
if(e.name == "URIError"){
this.responseText = data;
if(!this.responseText || this.responseText=="") {
this.responseText = data;
}
}
}
}
/*
콜백코드는 넣었지만, 아직 SWF에서 응답헤더 지원 안함
*/
if(typeof headers == "object"){
this._respHeaders = headers;
}
}
this.onload(this);
},
open : function(method, url) {
var re = /https?:\/\/([a-z0-9_\-\.]+)/i;
this._url = url;
this._method = method;
},
send : function(data) {
this.responseXML = false;
this.responseText = "";
var t = this;
var dat = {};
var info = this._getCallbackInfo();
var swf = this._getFlashObj()
function f(arg) {
switch(typeof arg){
case "string":
return '"'+arg.replace(/\"/g, '\\"')+'"';
break;
case "number":
return arg;
break;
case "object":
var ret = "", arr = [];
if (arg instanceof Array) {
for(var i=0; i < arg.length; i++) {
arr[i] = f(arg[i]);
}
ret = "["+arr.join(",")+"]";
} else {
for(var x in arg) {
if(arg.hasOwnProperty(x)){
arr[arr.length] = f(x)+":"+f(arg[x]);
}
}
ret = "{"+arr.join(",")+"}";
}
return ret;
default:
return '""';
}
}
data = (data || "").split("&");
for(var i=0; i < data.length; i++) {
pos = data[i].indexOf("=");
key = data[i].substring(0,pos);
val = data[i].substring(pos+1);
dat[key] = decodeURIComponent(val);
}
this._current_callback_id = info.id
window.__jindo2_callback[info.id] = function(success, data){
try {
t._callback(success, data);
} finally {
delete window.__jindo2_callback[info.id];
}
};
var oData = {
url : this._url,
type : this._method,
data : dat,
charset : "UTF-8",
callback : info.name,
header_json : this._headers
};
swf.requestViaFlash(f(oData));
},
abort : function(){
if(this._current_callback_id){
window.__jindo2_callback[this._current_callback_id] = function(){
delete window.__jindo2_callback[info.id];
}
}
}
}).extend(jindo.$Ajax.RequestBase);
/**
* Ajax 요청 타입(type)이 flash 일 때, request 메소드가 호출되기 전에 반드시 한 번 실행해야 한다.<br>
* <br>
* 요청 타입이 flash 이면 모든 통신은 플래시 객체를 통하여 주고 받으며 Ajax 호출을 하기 전에 반드시 플래시 객체를 초기화해야한다.<br>
* $Ajax.SWFRequest.write 메서드를 호출하면 통신을 위한 플래시 객체를 문서 내에 추가한다.
*
* @param {String} [swf_path] 통신을 담당할 플래시 파일의 경로. 생략하면 기본 값은 "./ajax.swf" 이다.
*
* @remark 해당 메서드는 <body> 태그 내에 작성되어야 한다.
* @remark 반드시 한 번 실행해야 한다. 두 번 이상 실행해도 문제가 발생한다.
*
* @see $Ajax#request
*/
jindo.$Ajax.SWFRequest.write = function(swf_path) {
if(typeof swf_path == "undefined") swf_path = "./ajax.swf";
jindo.$Ajax.SWFRequest._tmpId = 'tmpSwf'+(new Date()).getMilliseconds()+Math.floor(Math.random()*100000);
var activeCallback = "jindo.$Ajax.SWFRequest.loaded";
jindo.$Ajax._checkFlashLoad();
document.write('<div style="position:absolute;top:-1000px;left:-1000px"><object id="'+jindo.$Ajax.SWFRequest._tmpId+'" width="1" height="1" classid="clsid:d27cdb6e-ae6d-11cf-96b8-444553540000" codebase="http://download.macromedia.com/pub/shockwave/cabs/flash/swflash.cab#version=6,0,0,0"><param name="movie" value="'+swf_path+'"><param name = "FlashVars" value = "activeCallback='+activeCallback+'" /><param name = "allowScriptAccess" value = "always" /><embed name="'+jindo.$Ajax.SWFRequest._tmpId+'" src="'+swf_path+'" type="application/x-shockwave-flash" pluginspage="http://www.macromedia.com/go/getflashplayer" width="1" height="1" allowScriptAccess="always" swLiveConnect="true" FlashVars="activeCallback='+activeCallback+'"></embed></object></div>');
};
/**
* @ignore
*/
jindo.$Ajax._checkFlashLoad = function(){
jindo.$Ajax._checkFlashKey = setTimeout(function(){
// throw new Error("Check your flash file!. Unload flash on a page.");
// [SMARTEDITORSUS-334] Flash 를 지원하지 않는 환경(ex. iOS)에서 경고창을 띄우지 않도록 임시적으로 주석 처리함
// alert("Check your flash file!. Unload flash on a page.");
},5000);
jindo.$Ajax._checkFlashLoad = function(){}
}
/**
* flash가 로딩 되었는지 확인 하는 변수.
*/
jindo.$Ajax.SWFRequest.activeFlash = false;
/**
* flash에서 로딩 후 실행 시키는 함수.
* @ignore
*/
jindo.$Ajax.SWFRequest.loaded = function(){
clearTimeout(jindo.$Ajax._checkFlashKey);
jindo.$Ajax.SWFRequest.activeFlash = true;
}
/**
* $Ajax.FrameRequest 객체를 생성하여 리턴한다.
* @extends $Ajax.RequestBase
* @class Ajax 요청 타입(type)이 iframe 인 요청 객체를 생성하며, jindo.$Ajax 생성자에서 요청 객체 생성 시 사용한다.
*/
jindo.$Ajax.FrameRequest = jindo.$Class({
_headers : {},
_respHeaders : {},
_frame : null,
_domain : "",
$init : function(fpOption){
this.option = fpOption;
},
_callback : function(id, data, header) {
var self = this;
this.readyState = 4;
this.status = 200;
this.responseText = data;
this._respHeaderString = header;
header.replace(/^([\w\-]+)\s*:\s*(.+)$/m, function($0,$1,$2) {
self._respHeaders[$1] = $2;
});
this.onload(this);
setTimeout(function(){ self.abort() }, 10);
},
abort : function() {
if (this._frame) {
try {
this._frame.parentNode.removeChild(this._frame);
} catch(e) {
}
}
},
open : function(method, url) {
var re = /https?:\/\/([a-z0-9_\-\.]+)/i;
var dom = document.location.toString().match(re);
this._method = method;
this._url = url;
this._remote = String(url).match(/(https?:\/\/[a-z0-9_\-\.]+)(:[0-9]+)?/i)[0];
this._frame = null;
this._domain = (dom[1] != document.domain)?document.domain:"";
},
send : function(data) {
this.responseXML = "";
this.responseText = "";
var t = this;
var re = /https?:\/\/([a-z0-9_\-\.]+)/i;
var info = this._getCallbackInfo();
var url;
var _aStr = [];
_aStr.push(this._remote+"/ajax_remote_callback.html?method="+this._method);
var header = new Array;
window.__jindo2_callback[info.id] = function(id, data, header){
try {
t._callback(id, data, header);
} finally {
delete window.__jindo2_callback[info.id];
}
};
for(var x in this._headers) {
if(this._headers.hasOwnProperty(x)){
header[header.length] = "'"+x+"':'"+this._headers[x]+"'";
}
}
header = "{"+header.join(",")+"}";
_aStr.push("&id="+info.id);
_aStr.push("&header="+encodeURIComponent(header));
_aStr.push("&proxy="+encodeURIComponent(this.option("proxy")));
_aStr.push("&domain="+this._domain);
_aStr.push("&url="+encodeURIComponent(this._url.replace(re, "")));
_aStr.push("#"+encodeURIComponent(data));
var fr = this._frame = jindo.$("<iframe>");
fr.style.position = "absolute";
fr.style.visibility = "hidden";
fr.style.width = "1px";
fr.style.height = "1px";
var body = document.body || document.documentElement;
if (body.firstChild){
body.insertBefore(fr, body.firstChild);
}else{
body.appendChild(fr);
}
fr.src = _aStr.join("");
}
}).extend(jindo.$Ajax.RequestBase);
/**
* $Ajax 객체를 순서대로 호출할 수 있는 기능을 제공한다.
* @class $Ajax.Queue는 Ajax 요청을 큐에 담아 큐에 들어온 순서대로 처리한다.
* @param {Object} option $Ajax.Queue 에서 서버에 요청할 때 사용하는 다양한 정보를 정의한다.
<ul>
<li>
async : 비동기/동기 요청 여부를 설정한다. 비동기인 경우 true 이며, 기본 값은 false 이다.
</li>
<li>
useResultAsParam : 이전에 처리된 요청의 결과를 다음 요청에 매개 변수로 넘길지 여부를 설정한다. 요청 결과를 넘기면 true 이며, 기본 값은 false 이다.
</li>
<li>
stopOnFailure : 이전 요청이 실패하는 경우 다음 요청을 멈출지 여부를 설정한다. 멈춘다면 true 이며, 기본 값은 false 이다.
</li>
</ul>
* @constructor
* @since 1.3.7
*
* @example
// $Ajax 요청 큐를 생성한다.
var oAjaxQueue = new $Ajax.Queue({
useResultAsParam : true
});
*/
jindo.$Ajax.Queue = function (option) {
var cl = arguments.callee;
if (!(this instanceof cl)){ return new cl(option);}
this._options = {
async : false,
useResultAsParam : false,
stopOnFailure : false
};
this.option(option);
this._queue = [];
}
/**
* $Ajax.Queue 의 옵션을 가져오거나 설정한다.
* @param {Object} name 옵션의 이름
* @param {Object} [value] 옵션의 값. 옵션을 설정하는 경우에는 값을 지정한다.
* @return {Value | $Ajax.Queue} 값을 가져오는 경우 해당 값을, 설정하는 경우 $Ajax.Queue 객체를 리턴한다.
* @example
var oAjaxQueue = new $Ajax.Queue({
useResultAsParam : true
});
oAjaxQueue.option("useResultAsParam"); // useResultAsParam 옵션 값인 true 를 리턴한다.
oAjaxQueue.option("async", true); // async 옵션을 true 로 설정한다.
*/
jindo.$Ajax.Queue.prototype.option = function(name, value) {
if (typeof name == "undefined"){ return "";}
if (typeof name == "string") {
if (typeof value == "undefined"){ return this._options[name];}
this._options[name] = value;
return this;
}
try {
for(var x in name) {
if(name.hasOwnProperty(x))
this._options[x] = name[x]
}
} catch(e) {
};
return this;
};
/**
* Ajax 요청 큐에 요청을 추가한다.
* @param {$Ajax} 추가할 $Ajax 객체
* @param {Object} 요청 시 전송할 매개 변수 객체
*
* @example
var oAjax1 = new $Ajax('ajax_test.php',{
onload : function(res){
// onload 핸들러
}
});
var oAjax2 = new $Ajax('ajax_test.php',{
onload : function(res){
// onload 핸들러
}
});
var oAjax3 = new $Ajax('ajax_test.php',{
onload : function(res){
// onload 핸들러
}
});
var oAjaxQueue = new $Ajax.Queue({
async : true,
useResultAsParam : true,
stopOnFailure : false
});
// Ajax 요청 큐에 추가한다.
oAjaxQueue.add(oAjax1,{seq:1});
oAjaxQueue.add(oAjax2,{seq:2,foo:99});
oAjaxQueue.add(oAjax3,{seq:3});
oAjaxQueue.request();
*/
jindo.$Ajax.Queue.prototype.add = function (oAjax, oParam) {
this._queue.push({obj:oAjax, param:oParam});
}
/**
* Ajax Queue를 요청한다.
*
* @example
var oAjaxQueue = new $Ajax.Queue({
useResultAsParam : true
});
oAjaxQueue.add(oAjax1,{seq:1});
oAjaxQueue.add(oAjax2,{seq:2,foo:99});
oAjaxQueue.add(oAjax3,{seq:3});
// 서버에 Ajax 요청을 보낸다.
oAjaxQueue.request();
*/
jindo.$Ajax.Queue.prototype.request = function () {
if(this.option('async')){
this._requestAsync();
} else {
this._requestSync(0);
}
}
jindo.$Ajax.Queue.prototype._requestSync = function (nIdx, oParam) {
var t = this;
if (this._queue.length > nIdx+1) {
this._queue[nIdx].obj._oncompleted = function(bSuccess, oResult){
if(!t.option('stopOnFailure') || bSuccess) t._requestSync(nIdx + 1, oResult);
};
}
var _oParam = this._queue[nIdx].param||{};
if(this.option('useResultAsParam') && oParam){
try { for(var x in oParam) if(typeof _oParam[x] == 'undefined' && oParam.hasOwnProperty(x)) _oParam[x] = oParam[x] } catch(e) {};
}
this._queue[nIdx].obj.request(_oParam);
}
jindo.$Ajax.Queue.prototype._requestAsync = function () {
for( var i=0; i<this._queue.length; i++)
this._queue[i].obj.request(this._queue[i].param);
}
/**
* @fileOverview $H의 생성자 및 메서드를 정의한 파일
* @name hash.js
*/
/**
* $H 해시 객체를 리턴한다
* @class $H 클래스는 키와 값을 원소로 가지는 열거형 배열인 해시를 구현하고, 해시를 다루기 위한 여러 가지 위한 메서드를 제공한다.
* @param {Object} hashObject 해시로 만들 객체.
* @return {$H} 해시 객체
* @constructor
* @example
var h = $H({one:"first", two:"second", three:"third"})
* @author Kim, Taegon
*/
jindo.$H = function(hashObject) {
var cl = arguments.callee;
if (typeof hashObject == "undefined") hashObject = new Object;
if (hashObject instanceof cl) return hashObject;
if (!(this instanceof cl)) return new cl(hashObject);
this._table = {};
for(var k in hashObject) {
if(hashObject.hasOwnProperty(k)){
this._table[k] = hashObject[k];
}
}
};
/**
* $value 메서드는 해싱 대상인 객체를 반환한다.
* @return {Object} 해싱 대상 객체
*/
jindo.$H.prototype.$value = function() {
return this._table;
};
/**
* $ 메서드는 키와 값을 설정하거나 키에 해당하는 값을 반환한다.
* @param {String} key 키
* @param {void} [value] 값
* @return {void|$H} 키에 해당하는 값 혹은 $H 객체
* @example
* var hash = $H({one:"first", two:"second"});
*
* // 값을 설정할 때
* hash.$("three", "third");
*
* // hash => {one:"first", two:"second", three:"third"}
*
* // 값을 반환할 때
* var three = hash.$("three");
*
* // three => "third"
*/
jindo.$H.prototype.$ = function(key, value) {
if (typeof value == "undefined") {
return this._table[key];
}
this._table[key] = value;
return this;
};
/**
* length 메서드는 해시 객체의 크기를 반환한다.
* @return {Number} 해시의 크기
*/
jindo.$H.prototype.length = function() {
var i = 0;
for(var k in this._table) {
if(this._table.hasOwnProperty(k)){
if (typeof Object.prototype[k] != "undeifned" && Object.prototype[k] === this._table[k]) continue;
i++;
}
}
return i;
};
/**
* forEach 메서드는 해시 객체의 키와 값을 인수로 지정한 콜백 함수를 실행한다.
* @param {Function} callback 실행할 콜백 함수
* @param {Object} thisObject 콜백 함수의 this
* @example
function printIt(value, key) {
document.write(key+" => "+value+" <br>");
}
$H({one:"first", two:"second", three:"third"}).forEach(printIt);
*/
jindo.$H.prototype.forEach = function(callback, thisObject) {
var t = this._table;
var h = this.constructor;
for(var k in t) {
if (t.hasOwnProperty(k)) {
if (!t.propertyIsEnumerable(k)) continue;
try {
callback.call(thisObject, t[k], k, t);
} catch(e) {
if (e instanceof h.Break) break;
if (e instanceof h.Continue) continue;
throw e;
}
}
}
return this;
};
/**
* filter 메서드는 해시 객체에서 필터 콜백 함수를 만족하는 원소를 수집한다. 수집한 원소는 새로운 $H 객체의 원소가 된다.
* 콜백함수는 Boolean 값을 반환해야 한다.
* @param {Function} callback 필터 콜백 함수
* @param {Object} thisObject 콜백 함수의 this
* @return {$H} 수집한 원소로 새로 만든 해시 객체
* @remark 필터 콜백 함수의 결과가 true인 원소만 수집한다. 콜백 함수는 형식은 예제를 참고한다.
* @example
function callback(value, key, object) {
// value 해시의 값
// key 해시의 고유한 키 혹은 이름
// object JavaScript Core Object 객체
}
*/
jindo.$H.prototype.filter = function(callback, thisObject) {
var h = jindo.$H();
this.forEach(function(v,k,o) {
if(callback.call(thisObject, v, k, o) === true) {
h.add(k,v);
}
});
return h;
};
/**
* map 메서드는 해시 객체의 원소를 인수로 콜백 함수를 실행하고, 함수의 리턴 값을 해당 원소의 값으로 지정한다.
* @param {Function} callback 콜백 함수
* @param {Object} thisObject 콜백 함수의 this
* @return {$H} 값을 변경한 해시 객체
* @remark 콜백 함수는 형식은 예제를 참고한다.
* @example
function callback(value, key, object ) {
// value 해시의 값
// key 해시의 고유한 키 혹은 이름
// object JavaScript Core Object 객체
var r = key+"_"+value;
document.writeln (r + "<br />");
return r;
}
$H({one:"first", two:"second", three:"third"}).map(callback);
*/
jindo.$H.prototype.map = function(callback, thisObject) {
var t = this._table;
this.forEach(function(v,k,o) {
t[k] = callback.call(thisObject, v, k, o);
});
return this;
};
/**
* 해시 테이블에 값을 추가한다.
* @param {String} key 추가한 값을 위한 키
* @param {String} value 해시 테이블에 추가할 값
* @return {$H} 값을 추가한 해시 객체
*/
jindo.$H.prototype.add = function(key, value) {
//if (this.hasKey(key)) return null;
this._table[key] = value;
return this;
};
/**
* remove 메서드는 해시 테이블의 원소를 제거한다.
* @param {String} key 제거할 원소의 키
* @return {void} 제거한 키 값
* @example
var h = $H({one:"first", two:"second", three:"third"});
h.remove ("two");
// h의 해시 테이블은 {one:"first", three:"third"}
*/
jindo.$H.prototype.remove = function(key) {
if (typeof this._table[key] == "undefined") return null;
var val = this._table[key];
delete this._table[key];
return val;
};
/**
* search 메서드는 해시 테이블에서 인수로 지정한 값을 찾는다.
* @param {String} value 검색할 값
* @returns {String | Boolean} 값을 찾았다면 값에 대한 키. 값을 찾지 못했다면 false.
* @example
var h = $H({one:"first", two:"second", three:"third"});
h.search ("second");
// two
h.search ("fist");
// false
*/
jindo.$H.prototype.search = function(value) {
var result = false;
this.forEach(function(v,k,o) {
if (v === value) {
result = k;
jindo.$H.Break();
}
});
return result;
};
/**
* hasKey 메서드는 해시 테이블에 인수로 지정한 키가 있는지 찾는다.
* @param {String} key 해시 테이블에서 검색할 키
* @return {Boolean} 키의 존재 여부
* @example
var h = $H({one:"first", two:"second", three:"third"});
h.hasKey("four"); // false
h.hasKey("one"); // true
*/
jindo.$H.prototype.hasKey = function(key) {
var result = false;
return (typeof this._table[key] != "undefined");
};
/**
* hasValue 메서드는 해시 테이블에 인수로 지정한 값이 있는지 확인한다.
* @param {String} value 해시 테이블에서 검색할 값
* @return {Boolean} 값의 존재 여부
*/
jindo.$H.prototype.hasValue = function(value) {
return (this.search(value) !== false);
};
/**
* sort 메서드는 값을 기준으로 원소를 오름차순 정렬한다.
* @return {$H} 원소를 정렬한 해시 객체.
* @see $H#ksort
* @example
var h = $H({one:"하나", two:"둘", three:"셋"});
h.sort ();
// {two:"둘", three:"셋", one:"하나"}
*/
jindo.$H.prototype.sort = function() {
var o = new Object;
var a = this.values();
var k = false;
a.sort();
for(var i=0; i < a.length; i++) {
k = this.search(a[i]);
o[k] = a[i];
delete this._table[k];
}
this._table = o;
return this;
};
/**
* ksort 메서드는 키를 기준으로 원소를 오름차순 정렬한다.
* @return {$H} 원소를 정렬한 해시 객체
* @see $H#sort
* @example
var h = $H({one:"하나", two:"둘", three:"셋"});
h.sort ();
// h => {one:"하나", three:"셋", two:"둘"}
*/
jindo.$H.prototype.ksort = function() {
var o = new Object;
var a = this.keys();
a.sort();
for(var i=0; i < a.length; i++) {
o[a[i]] = this._table[a[i]];
}
this._table = o;
return this;
};
/**
* keys 메서드는 해시 키의 배열을 반환한다.
* @return {Array} 해시 키의 배열
* @example
var h = $H({one:"first", two:"second", three:"third"});
h.keys ();
// ["one", "two", "three"]
* @see $H#values
*/
jindo.$H.prototype.keys = function() {
var keys = new Array;
for(var k in this._table) {
if(this._table.hasOwnProperty(k))
keys.push(k);
}
return keys;
};
/**
* values 메서드는 해시 값의 배열을 반환한다.
* @return {Array} 해시 값의 배열
* @example
var h = $H({one:"first", two:"second", three:"third"});
h.values();
// ["first", "second", "third"]
* @see $H#keys
*/
jindo.$H.prototype.values = function() {
var values = [];
for(var k in this._table) {
if(this._table.hasOwnProperty(k))
values[values.length] = this._table[k];
}
return values;
};
/**
* toQueryString은 해시 객체를 쿼리 스트링 형태로 만든다.
* @return {String}
* @example
var h = $H({one:"first", two:"second", three:"third"});
h.toQueryString();
// "one=first&two=second&three=third"
*/
jindo.$H.prototype.toQueryString = function() {
var buf = [], val = null, idx = 0;
for(var k in this._table) {
if (this._table.hasOwnProperty(k)) {
if (typeof(val = this._table[k]) == "object" && val.constructor == Array) {
for(i=0; i < val.length; i++) {
buf[buf.length] = encodeURIComponent(k)+"[]="+encodeURIComponent(val[i]+"");
}
} else {
buf[buf.length] = encodeURIComponent(k)+"="+encodeURIComponent(this._table[k]+"");
}
}
}
return buf.join("&");
};
/**
* empty는 해시 객체를 빈 객체로 만든다.
* @return {$H} 비워진 해시 객체
* @example
var hash = $H({a:1, b:2, c:3});
// hash => {a:1, b:2, c:3}
hash.empty();
// hash => {}
*/
jindo.$H.prototype.empty = function() {
var keys = this.keys();
for(var i=0; i < keys.length; i++) {
delete this._table[keys[i]];
}
return this;
};
/**
* Break 메서드는 반복문의 실행을 중단할 때 사용한다.
* @remark forEach, filter, map와 같은 루프를 중단한다. 강제로 exception을 발생시키므로 try ~ catch 영역에서 이 메소드를 실행하면 정상적으로 동작하지 않을 수 있다.
* @example
$H({a:1, b:2, c:3}).forEach(function(v,k,o) {
...
if (k == "b") $H.Break();
...
});
* @see $H.Continue
*/
jindo.$H.Break = function() {
if (!(this instanceof arguments.callee)) throw new arguments.callee;
};
/**
* Continue 메서드는 루프를 실행하다 다음 단계로 넘어갈 때 사용한다.
* @remark forEach, filter, map와 같은 루프 실행 도중에 현재 루프를 중단하고 다음으로 넘어간다. 강제로 exception을 발생시키므로 try ~ catch 영역에서 이 메소드를 실행하면 정상적으로 동작하지 않을 수 있다.
* @example
$H({a:1, b:2, c:3}).forEach(function(v,k,o) {
...
if (v % 2 == 0) $H.Continue();
...
});
* @see $H.Break
*/
jindo.$H.Continue = function() {
if (!(this instanceof arguments.callee)) throw new arguments.callee;
};
/**
* @fileOverview $Json의 생성자 및 메서드를 정의한 파일
* @name json.js
*/
/**
* $Json 객체를 리턴한다.
* @class $Json 객체는 자바스크립트에서 JSON(JavaScript Object Notation)을 다루기 위한 다양한 메서드를 제공한다.
* @param {Object | String} sObject 객체, 혹은 JSON으로 인코딩 가능한 문자열.
* @return {$Json} 인수를 인코딩한 $Json 객체.
* @remark XML 형태의 문자열을 사용하여 $Json 객체를 생성하려면 $Json#fromXML 메서드를 사용한다.
* @example
var oStr = $Json ('{ zoo: "myFirstZoo", tiger: 3, zebra: 2}');
var d = {name : 'nhn', location: 'Bundang-gu'}
var oObj = $Json (d);
* @constructor
* @author Kim, Taegon
*/
jindo.$Json = function (sObject) {
var cl = arguments.callee;
if (typeof sObject == "undefined") sObject = {};
if (sObject instanceof cl) return sObject;
if (!(this instanceof cl)) return new cl(sObject);
if (typeof sObject == "string") {
this._object = jindo.$Json._oldMakeJSON(sObject);
}else{
this._object = sObject;
}
}
/*
native json의 parse의 성능이 보다 좋지 못해 native json은 사용하지 않음.
jindo.$Json._makeJson = function(sObject){
if (window.JSON&&window.JSON.parse) {
jindo.$Json._makeJson = function(sObject){
if (typeof sObject == "string") {
try{
return JSON.parse(sObject);
}catch(e){
return jindo.$Json._oldMakeJSON(sObject);
}
}
return sObject;
}
}else{
jindo.$Json._makeJson = function(sObject){
if (typeof sObject == "string") {
return jindo.$Json._oldMakeJSON(sObject);
}
return sObject;
}
}
return jindo.$Json._makeJson(sObject);
}
*/
jindo.$Json._oldMakeJSON = function(sObject){
try {
if(/^(?:\s*)[\{\[]/.test(sObject)){
sObject = eval("("+sObject+")");
}else{
sObject = sObject;
}
} catch(e) {
sObject = {};
}
return sObject;
}
/**
* fromXML 메서드는 XML 형태의 문자열을 $Json 객체로 인코딩한다.
* @param {String} sXML $Json 객체로 인코딩할 XML 형태의 문자열
* @returns {$Json} $Json 객체
* @remark 속성과 CDATA를 가지는 태그는 CDATA를 '$cdata' 속성과 값으로 인코딩한다.
* @example
var j1 = $Json.fromXML('<data>only string</data>');
// 결과 :
// {"data":"only string"}
var j2 = $Json.fromXML('<data><id>Faqh%$</id><str attr="123">string value</str></data>');
// 결과:
// {"data":{"id":"Faqh%$","str":{"attr":"123","$cdata":"string value"}}}
*/
jindo.$Json.fromXML = function(sXML) {
var o = {};
var re = /\s*<(\/?[\w:\-]+)((?:\s+[\w:\-]+\s*=\s*(?:"(?:\\"|[^"])*"|'(?:\\'|[^'])*'))*)\s*((?:\/>)|(?:><\/\1>|\s*))|\s*<!\[CDATA\[([\w\W]*?)\]\]>\s*|\s*>?([^<]*)/ig;
var re2= /^[0-9]+(?:\.[0-9]+)?$/;
var ec = {"&amp;":"&","&nbsp;":" ","&quot;":"\"","&lt;":"<","&gt;":">"};
var fg = {tags:["/"],stack:[o]};
var es = function(s){
if (typeof s == "undefined") return "";
return s.replace(/&[a-z]+;/g, function(m){ return (typeof ec[m] == "string")?ec[m]:m; })
};
var at = function(s,c){s.replace(/([\w\:\-]+)\s*=\s*(?:"((?:\\"|[^"])*)"|'((?:\\'|[^'])*)')/g, function($0,$1,$2,$3){c[$1] = es(($2?$2.replace(/\\"/g,'"'):undefined)||($3?$3.replace(/\\'/g,"'"):undefined));}) };
var em = function(o){
for(var x in o){
if (o.hasOwnProperty(x)) {
if(Object.prototype[x])
continue;
return false;
}
};
return true
};
/*
$0 : 전체
$1 : 태그명
$2 : 속성문자열
$3 : 닫는태그
$4 : CDATA바디값
$5 : 그냥 바디값
*/
var cb = function($0,$1,$2,$3,$4,$5) {
var cur, cdata = "";
var idx = fg.stack.length - 1;
if (typeof $1 == "string" && $1) {
if ($1.substr(0,1) != "/") {
var has_attr = (typeof $2 == "string" && $2);
var closed = (typeof $3 == "string" && $3);
var newobj = (!has_attr && closed)?"":{};
cur = fg.stack[idx];
if (typeof cur[$1] == "undefined") {
cur[$1] = newobj;
cur = fg.stack[idx+1] = cur[$1];
} else if (cur[$1] instanceof Array) {
var len = cur[$1].length;
cur[$1][len] = newobj;
cur = fg.stack[idx+1] = cur[$1][len];
} else {
cur[$1] = [cur[$1], newobj];
cur = fg.stack[idx+1] = cur[$1][1];
}
if (has_attr) at($2,cur);
fg.tags[idx+1] = $1;
if (closed) {
fg.tags.length--;
fg.stack.length--;
}
} else {
fg.tags.length--;
fg.stack.length--;
}
} else if (typeof $4 == "string" && $4) {
cdata = $4;
} else if (typeof $5 == "string" && $5) {
cdata = es($5);
}
if (cdata.replace(/^\s+/g, "").length > 0) {
var par = fg.stack[idx-1];
var tag = fg.tags[idx];
if (re2.test(cdata)) {
cdata = parseFloat(cdata);
}else if (cdata == "true"){
cdata = true;
}else if(cdata == "false"){
cdata = false;
}
if(typeof par =='undefined') return;
if (par[tag] instanceof Array) {
var o = par[tag];
if (typeof o[o.length-1] == "object" && !em(o[o.length-1])) {
o[o.length-1].$cdata = cdata;
o[o.length-1].toString = function(){ return cdata; }
} else {
o[o.length-1] = cdata;
}
} else {
if (typeof par[tag] == "object" && !em(par[tag])) {
par[tag].$cdata = cdata;
par[tag].toString = function(){ return cdata; }
} else {
par[tag] = cdata;
}
}
}
};
sXML = sXML.replace(/<(\?|\!-)[^>]*>/g, "");
sXML.replace(re, cb);
return jindo.$Json(o);
};
/**
* get 메서드는 path에 해당하는 $Json 객체의 값을 리턴한다.
* @param {String} sPath path 문자열
* @return {Array} 지정된 path에 해당하는 value를 원소로 가지는 배열
* @example
var j = $Json.fromXML('<data><id>Faqh%$</id><str attr="123">string value</str></data>');
var r = j.get ("/data/id");
// 결과 :
// [Faqh%$]
*/
jindo.$Json.prototype.get = function(sPath) {
var o = this._object;
var p = sPath.split("/");
var re = /^([\w:\-]+)\[([0-9]+)\]$/;
var stack = [[o]], cur = stack[0];
var len = p.length, c_len, idx, buf, j, e;
for(var i=0; i < len; i++) {
if (p[i] == "." || p[i] == "") continue;
if (p[i] == "..") {
stack.length--;
} else {
buf = [];
idx = -1;
c_len = cur.length;
if (c_len == 0) return [];
if (re.test(p[i])) idx = +RegExp.$2;
for(j=0; j < c_len; j++) {
e = cur[j][p[i]];
if (typeof e == "undefined") continue;
if (e instanceof Array) {
if (idx > -1) {
if (idx < e.length) buf[buf.length] = e[idx];
} else {
buf = buf.concat(e);
}
} else if (idx == -1) {
buf[buf.length] = e;
}
}
stack[stack.length] = buf;
}
cur = stack[stack.length-1];
}
return cur;
};
/**
* toString 메서드는 $Json 객체를 JSON 문자열로 리턴한다.
* @return {String} JSON 문자열
* @example
var j = $Json({foo:1, bar: 31});
document.write (j.toString());
document.write (j);
// 결과 :
// {"bar":31,"foo":1}{"bar":31,"foo":1}
*/
jindo.$Json.prototype.toString = function() {
if (window.JSON&&window.JSON.stringify) {
jindo.$Json.prototype.toString = function() {
try{
return window.JSON.stringify(this._object);
}catch(e){
return jindo.$Json._oldToString(this._object);
}
}
}else{
jindo.$Json.prototype.toString = function() {
return jindo.$Json._oldToString(this._object);
}
}
return this.toString();
};
jindo.$Json._oldToString = function(oObj){
var func = {
$ : function($) {
if (typeof $ == "object" && $ == null) return 'null';
if (typeof $ == "undefined") return '""';
if (typeof $ == "boolean") return $?"true":"false";
if (typeof $ == "string") return this.s($);
if (typeof $ == "number") return $;
if ($ instanceof Array) return this.a($);
if ($ instanceof Object) return this.o($);
},
s : function(s) {
var e = {'"':'\\"',"\\":"\\\\","\n":"\\n","\r":"\\r","\t":"\\t"};
var c = function(m){ return (typeof e[m] != "undefined")?e[m]:m };
return '"'+s.replace(/[\\"'\n\r\t]/g, c)+'"';
},
a : function(a) {
// a = a.sort();
var s = "[",c = "",n=a.length;
for(var i=0; i < n; i++) {
if (typeof a[i] == "function") continue;
s += c+this.$(a[i]);
if (!c) c = ",";
}
return s+"]";
},
o : function(o) {
o = jindo.$H(o).ksort().$value();
var s = "{",c = "";
for(var x in o) {
if (o.hasOwnProperty(x)) {
if (typeof o[x] == "function") continue;
s += c+this.s(x)+":"+this.$(o[x]);
if (!c) c = ",";
}
}
return s+"}";
}
}
return func.$(oObj);
}
/**
* toXML 메서드는 $Json 객체를 XML 형태의 문자열로 리턴한다.
* @return {String} XML 형태의 문자열
* @example
var json = $Json({foo:1, bar: 31});
json.toXML();
// 결과 :
// <foo>1</foo><bar>31</bar>
*/
jindo.$Json.prototype.toXML = function() {
var f = function($,tag) {
var t = function(s,at) { return "<"+tag+(at||"")+">"+s+"</"+tag+">" };
switch (typeof $) {
case "undefined":
case "null":
return t("");
case "number":
return t($);
case "string":
if ($.indexOf("<") < 0){
return t($.replace(/&/g,"&amp;"));
}else{
return t("<![CDATA["+$+"]]>");
}
case "boolean":
return t(String($));
case "object":
var ret = "";
if ($ instanceof Array) {
var len = $.length;
for(var i=0; i < len; i++) { ret += f($[i],tag); };
} else {
var at = "";
for(var x in $) {
if ($.hasOwnProperty(x)) {
if (x == "$cdata" || typeof $[x] == "function") continue;
ret += f($[x], x);
}
}
if (tag) ret = t(ret, at);
}
return ret;
}
};
return f(this._object, "");
};
/**
* toObject 메서드는 $Json 객체 원래의 JSON 데이터 객체를 리턴한다.
* @return {Object} 원래의 데이터 객체
* @example
var json = $Json({foo:1, bar: 31});
json.toObject();
// 결과 :
// {foo: 1, bar: 31}
*/
jindo.$Json.prototype.toObject = function() {
return this._object;
};
/**
* compare 메서드는 json객체 끼리 값이 같은지 비교를 한다. (1.4.4부터 사용가능.)
* @return {Boolean} 불린값.
* @example
$Json({foo:1, bar: 31}).compare({foo:1, bar: 31});
// 결과 :
// true
$Json({foo:1, bar: 31}).compare({foo:1, bar: 1});
// 결과 :
// false
*/
jindo.$Json.prototype.compare = function(oData){
return jindo.$Json._oldToString(this._object).toString() == jindo.$Json._oldToString(jindo.$Json(oData).$value()).toString();
}
/**
* $value 메서드는 $Json.toObject의 별칭(Alias)이다.
* @return {Object} 원래의 데이터 객체
*/
jindo.$Json.prototype.$value = jindo.$Json.prototype.toObject;
/**
* @fileOverview $Cookie의 생성자 및 메서드를 정의한 파일
* @name cookie.js
*/
/**
* $Cookie 객체를 생성한다.
* @class $Cookie 클래스는 쿠키(Cookie)를 추가, 수정, 혹은 삭제하거나 쿠키의 값을 가져온다.
* @constructor
* @return {$Cookie} 생성된 $Cookie 객체
* @author Kim, Taegon
* @example
var cookie = $Cookie();
*/
jindo.$Cookie = function() {
var cl = arguments.callee;
var cached = cl._cached;
if (cl._cached) return cl._cached;
if (!(this instanceof cl)) return new cl;
if (typeof cl._cached == "undefined") cl._cached = this;
};
/**
* keys 메서드는 쿠키 이름을 원소로 가지는 배열을 리턴한다.
* @return {Array} 쿠키 이름을 원소로 가지는 배열
* @example
var cookie = $Cookie();
cookie.set("session_id1", "value1", 1);
cookie.set("session_id2", "value2", 1);
cookie.set("session_id3", "value3", 1);
document.write (cookie.keys ());
*
* // 결과 :
* // session_id1, session_id2, session_id3
*/
jindo.$Cookie.prototype.keys = function() {
var ca = document.cookie.split(";");
var re = /^\s+|\s+$/g;
var a = new Array;
for(var i=0; i < ca.length; i++) {
a[a.length] = ca[i].substr(0,ca[i].indexOf("=")).replace(re, "");
}
return a;
};
/**
* get 메서드는 쿠키 이름에 해당하는 쿠키 값을 가져온다. 값이 존재하지 않는다면 null을 리턴한다.
* @param {String} sName 쿠키 이름
* @return {String} 쿠키 값
* @example
var cookie = $Cookie();
cookie.set("session_id1", "value1", 1);
document.write (cookie.get ("session_id1"));
*
* // 결과 :
* // value1
*
document.write (cookie.get ("session_id0"));
*
* // 결과 :
* // null
*/
jindo.$Cookie.prototype.get = function(sName) {
var ca = document.cookie.split(/\s*;\s*/);
var re = new RegExp("^(\\s*"+sName+"\\s*=)");
for(var i=0; i < ca.length; i++) {
if (re.test(ca[i])) return unescape(ca[i].substr(RegExp.$1.length));
}
return null;
};
/**
* set 메서드는 쿠키 값을 설정한다.
* @param {String} sName 쿠키 이름
* @param {String} sValue 쿠키 값
* @param {Number} [nDays] 쿠키 유효 시간. 유효 시간은 일단위로 설정한다. 유효시간을 생략했다면 쿠키는 웹 브라우저가 종료되면 없어진다.
* @param {String} [sDomain] 쿠키 도메인
* @param {String} [sPath] 쿠키 경로
* @return {$Cookie} $Cookie 객체
* @example
var cookie = $Cookie();
cookie.set("session_id1", "value1", 1);
cookie.set("session_id2", "value2", 1);
cookie.set("session_id3", "value3", 1);
*/
jindo.$Cookie.prototype.set = function(sName, sValue, nDays, sDomain, sPath) {
var sExpire = "";
if (typeof nDays == "number") {
sExpire = ";expires="+(new Date((new Date()).getTime()+nDays*1000*60*60*24)).toGMTString();
}
if (typeof sDomain == "undefined") sDomain = "";
if (typeof sPath == "undefined") sPath = "/";
document.cookie = sName+"="+escape(sValue)+sExpire+"; path="+sPath+(sDomain?"; domain="+sDomain:"");
return this;
};
/**
* remove 메서드는 쿠키 이름에 설정된 쿠키 값을 제거한다.
* @param {String} sName 쿠키 이름
* @param {String} sDomain 쿠키 도메인
* @param {String} sPath 쿠키 경로
* @return {$Cookie} $Cookie 객체
* @example
var cookie = $Cookie();
cookie.set("session_id1", "value1", 1);
document.write (cookie.get ("session_id1"));
*
* // 결과 :
* // value1
*
cookie.remove("session_id1");
document.write (cookie.get ("session_id1"));
*
* // 결과 :
* // null
*/
jindo.$Cookie.prototype.remove = function(sName, sDomain, sPath) {
if (this.get(sName) != null) this.set(sName, "", -1, sDomain, sPath);
return this;
};
/**
* @fileOverview $Element의 생성자 및 메서드를 정의한 파일
* @name element.js
*/
/**
* $Element 객체를 생성하여 반환한다.
* @class $Element 클래스는 HTML 엘리먼트를 래핑(wrapping)하며, 엘리먼트를 다루기 위한 메서드를 제공한다.<br>
* 래핑이란 자바스크립트의 함수를 한번 더 감싸 본래 함수의 기능은 그대로 유지하면서 확장된 기능을 속성 형태로 제공하는 것을 말한다.
* @constructor
* @description [Lite]
* @author Kim, Taegon
*
* @param {String | HTML Element | $Element} el
* <br>
* $Element 는 문자열, HTML 엘리먼트, 혹은 $Element 를 매개 변수로 지정할 수 있다.<br>
* <br>
* 매개 변수가 문자열이면 두 가지 방식으로 동작한다.<br>
* 만일 "&lt;tagName&gt;" 과 같은 형식의 문자열이면 tagName을 가지는 객체를 생성한다.<br>
* 그 이외의 경우 문자열을 id 로 하는 HTML 엘리먼트를 사용하여 $Element 를 생성한다.<br>
* <br>
* 매개 변수가 HTML 엘리먼트이면 HTML 엘리먼트를 래핑하여 $Element 를 생성한다.<br>
* <br>
* 매개 변수가 $Element 이면 전달된 매개 변수를 그대로 반환하며 undefined 혹은 null 인 경우에는 null 을 반환한다.
* @return {$Element} 생성된 $Element 객체
*
* @example
var element = $Element($("box")); // HTML 엘리먼트를 매개 변수로 지정
var element = $Element("box"); // HTML 엘리먼트의 id를 매개 변수로 지정
var element = $Element("<DIV>"); // 태그를 매개 변수로 지정, DIV 엘리먼트를 생성하여 래핑함
*/
jindo.$Element = function(el) {
var cl = arguments.callee;
if (el && el instanceof cl) return el;
if (el===null || typeof el == "undefined"){
return null;
}else{
el = jindo.$(el);
if (el === null) {
return null;
};
}
if (!(this instanceof cl)) return new cl(el);
this._element = (typeof el == "string") ? jindo.$(el) : el;
var tag = this._element.tagName;
// tagname
this.tag = (typeof tag!='undefined')?tag.toLowerCase():'';
}
/**
* agent의 dependency를 없애기 위해 별로도 설정.
* @ignore
**/
var _j_ag = navigator.userAgent;
var IS_IE = _j_ag.indexOf("MSIE") > -1;
var IS_FF = _j_ag.indexOf("Firefox") > -1;
var IS_OP = _j_ag.indexOf("Opera") > -1;
var IS_SF = _j_ag.indexOf("Apple") > -1;
var IS_CH = _j_ag.indexOf("Chrome") > -1;
/**
* $value 메서드는 원래의 HTML 엘리먼트를 반환한다.
* @return {HTML Element} 래핑된 원래의 엘리먼트
* @description [Lite]
*
* @example
var element = $Element("sample_div");
element.$value(); // 원래의 엘리먼트가 반환된다
*/
jindo.$Element.prototype.$value = function() {
return this._element;
};
/**
* HTML 엘리먼트의 display 속성을 확인하거나 display 속성을 설정하기 위해 사용한다.
*
* @param {Boolean} [bVisible] 화면에 보여줄지의 여부<br>
* 매개 변수를 생략하면 HTML 엘리먼트의 현재 display 속성을 확인하여 true/false로 반환한다.(none 이면 false)<br>
* 매개 변수가 true인 경우에는 display 속성을 설정하고 false인 경우에는 display 속성을 none 으로 변경한다.
* @param {String} [sDisplay] display 속성 값<br>
* bVisible 매개 변수가 true 이면 display 속성을 전달된 매개 변수로 설정한다.
* @return {$Element} display 속성을 변경한 $Element 객체
*
* @description [Lite]
* @since 1.1.2부터 설정 기능을 사용할 수 있다.
* @since 1.4.5부터 bVisible 매개 변수의 값이 true 인 경우 sDisplay 매개 변수의 값으로 display 속성을 설정할 수 있다.
* @see $Element#show
* @see $Element#hide
* @see $Element#toggle
*
* @example
<div id="sample_div" style="display:none">Hello world</div>
// 조회
$Element("sample_div").visible(); // false
* @example
// 화면에 보이도록 설정
$Element("sample_div").visible(true, 'block');
//Before
<div id="sample_div" style="display:none">Hello world</div>
//After
<div id="sample_div" style="display:block">Hello world</div>
*/
jindo.$Element.prototype.visible = function(bVisible, sDisplay) {
if (typeof bVisible != "undefined") {
this[bVisible?"show":"hide"](sDisplay);
return this;
}
return (this.css("display") != "none");
};
/**
* HTML 엘리먼트가 화면에 보이도록 display 속성을 변경한다.
* @param {String} [sDisplay] 변경할 display 속성 값<br>
* 매개 변수를 생략하면 태그별로 미리 지정된 디폴트 속성 값으로 설정한다.<br>
* 미리 지정된 디폴트 속성 값이 없으면 "inline" 으로 설정한다.
* @return {$Element} display 속성을 변경한 $Element 객체
* @description [Lite]
* @see $Element#hide
* @see $Element#toggle
* @see $Element#visible
* @since 1.4.5부터 sDisplay 값으로 display 속성 값 지정이 가능하다.
*
* @example
// 화면에 보이도록 설정
$Element("sample_div").show();
//Before
<div id="sample_div" style="display:none">Hello world</div>
//After
<div id="sample_div" style="display:block">Hello world</div>
*/
jindo.$Element.prototype.show = function(sDisplay) {
var s = this._element.style;
var b = "block";
var c = { p:b,div:b,form:b,h1:b,h2:b,h3:b,h4:b,ol:b,ul:b,fieldset:b,td:"table-cell",th:"table-cell",
li:"list-item",table:"table",thead:"table-header-group",tbody:"table-row-group",tfoot:"table-footer-group",
tr:"table-row",col:"table-column",colgroup:"table-column-group",caption:"table-caption",dl:b,dt:b,dd:b};
try {
if (sDisplay) {
s.display = sDisplay;
}else{
var type = c[this.tag];
s.display = type || "inline";
}
} catch(e) {
/*
IE에서 sDisplay값이 비정상적일때 block로 셋팅한다.
*/
s.display = "block";
}
return this;
};
/**
* HTML 엘리먼트가 화면에 보이지 않도록 display 속성을 none 으로 변경한다.
* @returns {$Element} display 속성을 변경한 $Element 객체
* @description [Lite]
* @see $Element#show
* @see $Element#toggle
* @see $Element#visible
*
* @example
// 화면에 보이지 않도록 설정
$Element("sample_div").hide();
//Before
<div id="sample_div" style="display:block">Hello world</div>
//After
<div id="sample_div" style="display:none">Hello world</div>
*/
jindo.$Element.prototype.hide = function() {
this._element.style.display = "none";
return this;
};
/**
* HTML 엘리먼트의 display 속성을 변경하여 엘리먼트를 화면에 보이거나, 보이지 않게 한다.
* @param {String} [sDisplay] 보이도록 변경할 때 사용되는 display 속성 값
* @returns {$Element} display 속성을 변경한 $Element 객체
* @description [Lite]
* @see $Element#show
* @see $Element#hide
* @see $Element#visible
* @since 1.4.5부터 보이도록 설정할 때 sDisplay 값으로 display 속성 값 지정이 가능하다.
* @example
// 화면에 보이거나, 보이지 않도록 처리
$Element("sample_div1").toggle();
$Element("sample_div2").toggle();
//Before
<div id="sample_div1" style="display:block">Hello</div>
<div id="sample_div2" style="display:none">Good Bye</div>
//After
<div id="sample_div1" style="display:none">Hello</div>
<div id="sample_div2" style="display:block">Good Bye</div>
*/
jindo.$Element.prototype.toggle = function(sDisplay) {
this[this.visible()?"hide":"show"](sDisplay);
return this;
};
/**
* HTML 엘리먼트의 투명도 값을 가져오거나 설정한다.
* @param {Number} [value] 설정할 투명도 값<br>
* 투명도 값은 0 ~ 1 사이의 실수 값으로 지정한다.<br>
* 매개 변수의 값이 0보다 작으면 0을, 1보다 크면 1을 설정한다.
* @return {Number} HTML 엘리먼트의 투명도 값
* @description [Lite]
*
* @example
<div id="sample" style="background-color:#2B81AF; width:20px; height:20px;"></div>
// 조회
$Element("sample").opacity(); // 1
* @example
// 투명도 값 설정
$Element("sample").opacity(0.4);
//Before
<div style="background-color: rgb(43, 129, 175); width: 20px; height: 20px;" id="sample"></div>
//After
<div style="background-color: rgb(43, 129, 175); width: 20px; height: 20px; opacity: 0.4;" id="sample"></div>
*/
jindo.$Element.prototype.opacity = function(value) {
var v,e = this._element,b = (this._getCss(e,"display") != "none");
value = parseFloat(value);
/*
IE에서 layout을 가지고 있지 않으면 opacity가 적용되지 않음.
*/
e.style.zoom = 1;
if (!isNaN(value)) {
value = Math.max(Math.min(value,1),0);
if (typeof e.filters != "undefined") {
value = Math.ceil(value*100);
if (typeof e.filters != 'unknown' && typeof e.filters.alpha != "undefined") {
e.filters.alpha.opacity = value;
} else {
e.style.filter = (e.style.filter + " alpha(opacity=" + value + ")");
}
} else {
e.style.opacity = value;
}
return value;
}
if (typeof e.filters != "undefined") {
v = (typeof e.filters.alpha == "undefined")?(b?100:0):e.filters.alpha.opacity;
v = v / 100;
} else {
v = parseFloat(e.style.opacity);
if (isNaN(v)) v = b?1:0;
}
return v;
};
/**
* HTML 엘리먼트의 CSS 속성 값을 가져오거나 설정한다.
* @remark CSS 속성은 Camel 표기법을 사용한다. 따라서 border-width-bottom은 borderWidthBottom으로 정의한다.
* @remark float 속성은 Javascript의 예약어로 사용하므로 css 메서드에서는 float 대신 cssFloat를 사용한다. (Internet Explorer에서는 styleFloat를, 그 외의 브라우저에서는 cssFloat를 사용한다.)
* @param {String | Object | $H} sName CSS 속성명 혹은 하나 이상의 CSS 속성과 값을 가지는 객체.<br>
* css 메서드는 문자열, Object, 혹은 $H 를 매개 변수로 지정할 수 있다.<br>
* <br>
* 매개 변수가 문자열이면 조회 혹은 수정할 속성 명으로 아래 두 가지 방식으로 동작한다.<br>
* 두 번째 매개 변수인 sValue 매개 변수를 생략하면 CSS 속성의 값을 가져온다.<br>
* 두 번째 매개 변수인 sValue 매개 변수에 값이 있으면 CSS 속성의 값을 sValue 값으로 설정한다.<br>
* <br>
* Object 혹은 $H 객체를 사용하면 두 개 이상의 CSS 속성을 한꺼번에 설정할 수 있다.<br>
* 객체의 프로퍼티 이름으로 CSS 속성을 찾아 프로퍼티 값으로 설정한다.
* @param {String | Number} [sValue] CSS 속성에 설정할 값.<br>
* 단위가 필요한 값은 숫자 혹은 단위를 포함한 문자열을 사용한다.
* @return {String | $Element} 값을 가져올 때는 값을 문자열로 반환하고, 값을 설정할 때는 값을 설정한 현재의 $Element 를 반환한다.
* @description [Lite]
* @example
<style type="text/css">
#btn {
width: 120px;
height: 30px;
background-color: blue;
}
</style>
<span id="btn"></span>
...
// CSS 속성 값 조회
$Element('btn').css('backgroundColor'); // rgb (0, 0, 255)
* @example
// CSS 속성 값 설정
$Element('btn').css('backgroundColor', 'red');
//Before
<span id="btn"></span>
//After
<span id="btn" style="background-color: red;"></span>
* @example
// 여러개의 CSS 속성 값을 설정
$Element('btn').css({
width: "200px", // 200
height: "80px" // 80 으로 설정하여도 결과는 같음
});
//Before
<span id="btn" style="background-color: red;"></span>
//After
<span id="btn" style="background-color: red; width: 200px; height: 80px;"></span>
*/
jindo.$Element.prototype.css = function(sName, sValue) {
var e = this._element;
var type_v = (typeof sValue);
if (sName == 'opacity') return type_v == 'undefined' ? this.opacity() : this.opacity(sValue);
var type_n = (typeof sName);
if (type_n == "string") {
var view;
if (type_v == "string" || type_v == "number") {
var obj = {};
obj[sName] = sValue;
sName = obj;
} else {
var _getCss = this._getCss;
if((IS_FF||IS_OP)&&(sName=="backgroundPositionX"||sName=="backgroundPositionY")){
var bp = _getCss(e, "backgroundPosition").split(/\s+/);
return (sName == "backgroundPositionX") ? bp[0] : bp[1];
}
if (IS_IE && sName == "backgroundPosition") {
return _getCss(e, "backgroundPositionX") + " " + _getCss(e, "backgroundPositionY")
}
if ((IS_FF||IS_SF||IS_CH) && (sName=="padding"||sName=="margin")) {
var top = _getCss(e, sName+"Top");
var right = _getCss(e, sName+"Right");
var bottom = _getCss(e, sName+"Bottom");
var left = _getCss(e, sName+"Left");
if ((top == right) && (bottom == left)) {
return top;
}else if (top == bottom) {
if (right == left) {
return top+" "+right;
}else{
return top+" "+right+" "+bottom+" "+left;
}
}else{
return top+" "+right+" "+bottom+" "+left;
}
}
return _getCss(e, sName);
}
}
var h = jindo.$H;
if (typeof h != "undefined" && sName instanceof h) {
sName = sName._table;
}
if (typeof sName == "object") {
var v, type;
for(var k in sName) {
if(sName.hasOwnProperty(k)){
v = sName[k];
type = (typeof v);
if (type != "string" && type != "number") continue;
if (k == 'opacity') {
type == 'undefined' ? this.opacity() : this.opacity(v);
continue;
}
if (k == "cssFloat" && IS_IE) k = "styleFloat";
if((IS_FF||IS_OP)&&( k =="backgroundPositionX" || k == "backgroundPositionY")){
var bp = this.css("backgroundPosition").split(/\s+/);
v = k == "backgroundPositionX" ? v+" "+bp[1] : bp[0]+" "+v;
this._setCss(e, "backgroundPosition", v);
}else{
this._setCss(e, k, v);
}
}
}
}
return this;
};
/**
* css에서 사용되는 함수
* @ignore
* @param {Element} e
* @param {String} sName
*/
jindo.$Element.prototype._getCss = function(e, sName){
var fpGetCss;
if (e.currentStyle) {
fpGetCss = function(e, sName){
try{
if (sName == "cssFloat") sName = "styleFloat";
var sStyle = e.style[sName];
if(sStyle){
return sStyle;
}else{
var oCurrentStyle = e.currentStyle;
if (oCurrentStyle) {
return oCurrentStyle[sName];
}
}
return sStyle;
}catch(ex){
throw new Error((e.tagName||"document") + "는 css를 사용 할수 없습니다.");
}
}
} else if (window.getComputedStyle) {
fpGetCss = function(e, sName){
try{
if (sName == "cssFloat") sName = "float";
var d = e.ownerDocument || e.document || document;
var sVal = (e.style[sName]||d.defaultView.getComputedStyle(e,null).getPropertyValue(sName.replace(/([A-Z])/g,"-$1").toLowerCase()));
if (sName == "textDecoration") sVal = sVal.replace(",","");
return sVal;
}catch(ex){
throw new Error((e.tagName||"document") + "는 css를 사용 할수 없습니다.");
}
}
} else {
fpGetCss = function(e, sName){
try{
if (sName == "cssFloat" && IS_IE) sName = "styleFloat";
return e.style[sName];
}catch(ex){
throw new Error((e.tagName||"document") + "는 css를 사용 할수 없습니다.");
}
}
}
jindo.$Element.prototype._getCss = fpGetCss;
return fpGetCss(e, sName);
}
/**
* css에서 css를 세팅하기 위한 함수
* @ignore
* @param {Element} e
* @param {String} k
*/
jindo.$Element.prototype._setCss = function(e, k, v){
if (("#top#left#right#bottom#").indexOf(k+"#") > 0 && (typeof v == "number" ||(/\d$/.test(v)))) {
e.style[k] = parseInt(v,10)+"px";
}else{
e.style[k] = v;
}
}
/**
* DOM 엘리먼트의 HTML 속성을 가져오거나 설정한다.
* 하나의 인자만 사용하면 해당 HTML 속성의 속성 값을 가져온다. 해당 속성이 없다면 null을 반환한다.
* 두 개의 인자를 사용하면 첫 번째 인자에 해당하는 HTML 속성의 속성 값을 두 번째 인자의 값으로 설정한다.
* 첫 번째 인자로 Object 혹은 $H 객체를 사용하면 두 개 이상의 HTML 속성을 한꺼번에 정의할 수 있다.
* @param {String|Object|$H} sName HTML 속성 이름 혹은 설정값 객체
* @param {String|Number} [sValue] 설정 값. 설정 값을 null로 지정하면 해당 HTML 속성을 삭제한다.
* @return {String|$Element} 값을 가져올 때는 String 설정 값을, 값을 설정할 때는 값을 설정한 현재의 $Element를 리턴한다.
* @description [Lite]
*
* @example
<a href="http://www.naver.com" id="sample_a" target="_blank">Naver</a>
$Element("sample_a").attr("href"); // http://www.naver.com
* @example
$Element("sample_a").attr("href", "http://www.hangame.com/");
//Before
<a href="http://www.naver.com" id="sample_a" target="_blank">Naver</a>
//After
<a href="http://www.hangame.com" id="sample_a" target="_blank">Naver</a>
* @example
$Element("sample_a").attr({
"href" : "http://www.hangame.com",
"target" : "_self"
})
//Before
<a href="http://www.naver.com" id="sample_a" target="_blank">Naver</a>
//After
<a href="http://www.hangame.com" id="sample_a" target="_self">Naver</a>
*/
jindo.$Element.prototype.attr = function(sName, sValue) {
var e = this._element;
if (typeof sName == "string") {
if (typeof sValue != "undefined") {
var obj = {};
obj[sName] = sValue;
sName = obj;
} else {
if (sName == "class" || sName == "className"){
return e.className;
}else if(sName == "style"){
return e.style.cssText;
}else if(sName == "checked"||sName == "disabled"){
return !!e[sName];
}else if(sName == "value"){
return e.value;
}else if(sName == "href"){
return e.getAttribute(sName,2);
}
return e.getAttribute(sName);
}
}
if (typeof jindo.$H != "undefined" && sName instanceof jindo.$H) {
sName = sName.$value();
}
if (typeof sName == "object") {
for(var k in sName) {
if(sName.hasOwnProperty(k)){
if (typeof(sValue) != "undefined" && sValue === null) {
e.removeAttribute(k);
}else{
if (k == "class"|| k == "className") {
e.className = sName[k];
}else if(k == "style"){
e.style.cssText = sName[k];
}else if(k == "checked"||k == "disabled"){
e[k] = sName[k];
}else if(k == "value"){
e.value = sName[k];
}else{
e.setAttribute(k, sName[k]);
}
}
}
}
}
return this;
};
/**
* HTML 엘리먼트의 너비를 가져오거나 설정한다.
* @remark width 메서드는 HTML 엘리먼트의 실제 너비를 가져온다. 브라우저마다 Box 모델의 크기 계산 방법이 다르므로 CSS의 width 속성 값과 width 메서드의 반환 값은 서로 다를 수 있다.
* @param {Number} [width] 설정할 너비 값. 단위는 px 이며 매개 변수의 값은 숫자로 지정한다.<br>
* 매개 변수를 생략하면 너비 값을 가져온다.
* @return {Number | $Element} 값을 가져오는 경우에는 HTML 엘리먼트의 실제 너비를, 값을 설정하는 경우에는 너비 값이 변경된 현재의 $Element 객체를 반환한다.
* @description [Lite]
* @see $Element#height
*
* @example
<style type="text/css">
div { width:70px; height:50px; padding:5px; margin:5px; background:red; }
</style>
<div id="sample_div"></div>
...
// 조회
$Element("sample_div").width(); // 80
* @example
// 위의 예제 HTML 엘리먼트에 너비 값을 설정
$Element("sample_div").width(200);
//Before
<div id="sample_div"></div>
//After
<div id="sample_div" style="width: 190px"></div>
*/
jindo.$Element.prototype.width = function(width) {
if (typeof width == "number") {
var e = this._element;
e.style.width = width+"px";
var off = e.offsetWidth;
if (off != width && off!==0) {
var w = (width*2 - off);
if (w>0)
e.style.width = w + "px";
}
return this;
}
return this._element.offsetWidth;
};
/**
* HTML 엘리먼트의 높이를 가져오거나 설정한다.
* @remark height 메서드는 HTML 엘리먼트의 실제 높이를 가져온다. 브라우저마다 Box 모델의 크기 계산 방법이 다르므로 CSS의 height 속성 값과 height 메서드의 반환 값은 서로 다를 수 있다.
* @param {Number} [height] 설정할 높이 값. 단위는 px 이며 매개 변수의 값은 숫자로 지정한다.
* @return {Number | $Element} 값을 가져오는 경우에는 HTML 엘리먼트의 실제 높이를, 값을 설정하는 경우에는 높이 값이 변경된 현재의 $Element 객체를 반환한다.
* @description [Lite]
* @see $Element#width
*
* @example
<style type="text/css">
div { width:70px; height:50px; padding:5px; margin:5px; background:red; }
</style>
<div id="sample_div"></div>
...
// 조회
$Element("sample_div").height(); // 60
* @example
// 위의 예제 HTML 엘리먼트에 높이 값을 설정
$Element("sample_div").height(100);
//Before
<div id="sample_div"></div>
//After
<div id="sample_div" style="height: 90px"></div>
*/
jindo.$Element.prototype.height = function(height) {
if (typeof height == "number") {
var e = this._element;
e.style.height = height+"px";
var off = e.offsetHeight;
if (off != height && off!==0) {
var height = (height*2 - off);
if(height>0)
e.style.height = height + "px";
}
return this;
}
return this._element.offsetHeight;
};
/**
* HTML 엘리먼트의 클래스명을 설정하거나 반환한다.
* @param {String} [sClass] 설정할 클래스명<br>
* 매개 변수를 생략하면 HTML 엘리먼트의 현재의 클래스명을 반환한다.<br>
* 매개 변수를 지정하면 클래스명을 설정한다. 여러개의 클래스명을 설정하려면 공백으로 구분한다.
* @return {String | $Element} 클래스명을 조회하는 경우에는 클래스명을 반환한다.<br>
* 클래스가 두 개 이상이면 클래스명을 공백으로 구분하여 공백을 포함한 문자열로 반환한다.<br>
* 클래스명을 설정한 경우에는 변경된 현재의 $Element 객체를 반환한다.
* @description [Lite]
* @see $Element#hasClass
* @see $Element#addClass
* @see $Element#removeClass
* @see $Element#toggleClass
*
* @example
<style type="text/css">
p { margin: 8px; font-size:16px; }
.selected { color:#0077FF; }
.highlight { background:#C6E746; }
</style>
<p>Hello and <span id="sample_span" class="selected">Goodbye</span></p>
...
// 클래스명 조회
$Element("sample_span").className(); // selected
* @example
// 위의 예제 HTML 엘리먼트에 클래스명 설정
welSample.className("highlight");
//Before
<p>Hello and <span id="sample_span" class="selected">Goodbye</span></p>
//After
<p>Hello and <span id="sample_span" class="highlight">Goodbye</span></p>
*/
jindo.$Element.prototype.className = function(sClass) {
var e = this._element;
if (typeof sClass == "undefined") return e.className;
e.className = sClass;
return this;
};
/**
* HTML 엘리먼트에서 특정 클래스를 사용하고 있는지 확인한다.
* @param {String} sClass 확인할 클래스명
* @return {Boolean} 클래스 사용 여부
* @description [Lite]
* @see $Element#className
* @see $Element#addClass
* @see $Element#removeClass
* @see $Element#toggleClass
*
* @example
<style type="text/css">
p { margin: 8px; font-size:16px; }
.selected { color:#0077FF; }
.highlight { background:#C6E746; }
</style>
<p>Hello and <span id="sample_span" class="selected highlight">Goodbye</span></p>
...
// 클래스의 사용여부를 확인
var welSample = $Element("sample_span");
welSample.hasClass("selected"); // true
welSample.hasClass("highlight"); // true
*/
jindo.$Element.prototype.hasClass = function(sClass) {
if(this._element.classList){
jindo.$Element.prototype.hasClass = function(sClass){
return this._element.classList.contains(sClass);
}
} else {
jindo.$Element.prototype.hasClass = function(sClass){
return (" "+this._element.className+" ").indexOf(" "+sClass+" ") > -1;
}
}
return this.hasClass(sClass);
};
/**
* HTML 엘리먼트에 클래스를 추가한다.
* @param {String} sClass 추가할 클래스명. 여러개의 클래스명을 추가하려면 공백으로 구분한다.
* @return {$Element} 클래스가 추가된 현재의 $Element 객체
* @description [Lite]
* @see $Element#className
* @see $Element#hasClass
* @see $Element#removeClass
* @see $Element#toggleClass
*
* @example
// 클래스 추가
$Element("sample_span1").addClass("selected");
$Element("sample_span2").addClass("selected highlight");
//Before
<p>Hello and <span id="sample_span1">Goodbye</span></p>
<p>Hello and <span id="sample_span2">Goodbye</span></p>
//After
<p>Hello and <span id="sample_span1" class="selected">Goodbye</span></p>
<p>Hello and <span id="sample_span2" class="selected highlight">Goodbye</span></p>
*/
jindo.$Element.prototype.addClass = function(sClass) {
if(this._element.classList){
jindo.$Element.prototype.addClass = function(sClass){
var aClass = sClass.split(/\s+/);
var flistApi = this._element.classList;
for(var i = aClass.length ; i-- ;){
flistApi.add(aClass[i]);
}
return this;
}
} else {
jindo.$Element.prototype.addClass = function(sClass){
var e = this._element;
var aClass = sClass.split(/\s+/);
var eachClass;
for (var i = aClass.length - 1; i >= 0 ; i--){
eachClass = aClass[i];
if (!this.hasClass(eachClass)) {
e.className = (e.className+" "+eachClass).replace(/^\s+/, "");
};
};
return this;
}
}
return this.addClass(sClass);
};
/**
* HTML 엘리먼트에서 특정 클래스를 제거한다.
* @param {String} sClass 제거할 클래스명. 여러개의 클래스명을 제거하려면 공백으로 구분한다.
* @return {$Element} 클래스가 제거된 현재의 $Element 객체
* @description [Lite]
* @see $Element#className
* @see $Element#hasClass
* @see $Element#addClass
* @see $Element#toggleClass
*
* @example
// 클래스 제거
$Element("sample_span").removeClass("selected");
//Before
<p>Hello and <span id="sample_span" class="selected highlight">Goodbye</span></p>
//After
<p>Hello and <span id="sample_span" class="highlight">Goodbye</span></p>
* @example
// 여러개의 클래스를 제거
$Element("sample_span").removeClass("selected highlight");
$Element("sample_span").removeClass("highlight selected");
//Before
<p>Hello and <span id="sample_span" class="selected highlight">Goodbye</span></p>
//After
<p>Hello and <span id="sample_span" class="">Goodbye</span></p>
*/
jindo.$Element.prototype.removeClass = function(sClass) {
if(this._element.classList){
jindo.$Element.prototype.removeClass = function(sClass){
var flistApi = this._element.classList;
var aClass = sClass.split(" ");
for(var i = aClass.length ; i-- ;){
flistApi.remove(aClass[i]);
}
return this;
}
} else {
jindo.$Element.prototype.removeClass = function(sClass){
var e = this._element;
var aClass = sClass.split(/\s+/);
var eachClass;
for (var i = aClass.length - 1; i >= 0 ; i--){
eachClass = aClass[i];
if (this.hasClass(eachClass)) {
e.className = (" "+e.className.replace(/\s+$/, "").replace(/^\s+/, "")+" ").replace(" "+eachClass+" ", " ").replace(/\s+$/, "").replace(/^\s+/, "");
};
};
return this;
}
}
return this.removeClass(sClass);
};
/**
* HTML 엘리먼트에 클래스가 이미 적용되어 있으면 제거하고 만약 없으면 추가한다.
* @param {String} sClass 추가 혹은 제거할 클래스명
* @param {String} [sClass2] 추가 혹은 제거할 클래스명<br>
* sClass2 매개 변수를 생략하면 HTML 엘리먼트에서 sClass 매개 변수 값의 클래스를 사용 중인지 확인한다.<br>
* 만약 사용하고 있다면 해당 클래스를 제거하고, 사용하고 있지 않다면 추가한다.<br>
* 두 개의 매개 변수를 모두 사용하면, 두 클래스 중에서 사용하고 있는 것을 제거하고 나머지를 추가한다.
* @return {$Element} 클래스가 추가 혹은 제거된 현재의 $Element 객체
* @import core.$Element[hasClass,addClass,removeClass]
* @description [Lite]
* @see $Element#className
* @see $Element#hasClass
* @see $Element#addClass
* @see $Element#removeClass
*
* @example
// 매개 변수가 하나인 경우
$Element("sample_span1").toggleClass("highlight");
$Element("sample_span2").toggleClass("highlight");
//Before
<p>Hello and <span id="sample_span1" class="selected highlight">Goodbye</span></p>
<p>Hello and <span id="sample_span2" class="selected">Goodbye</span></p>
//After
<p>Hello and <span id="sample_span1" class="selected">Goodbye</span></p>
<p>Hello and <span id="sample_span2" class="selected highlight">Goodbye</span></p>
* @example
// 매개 변수가 두 개인 경우
$Element("sample_span1").toggleClass("selected", "highlight");
$Element("sample_span2").toggleClass("selected", "highlight");
//Before
<p>Hello and <span id="sample_span1" class="highlight">Goodbye</span></p>
<p>Hello and <span id="sample_span2" class="selected">Goodbye</span></p>
//After
<p>Hello and <span id="sample_span1" class="selected">Goodbye</span></p>
<p>Hello and <span id="sample_span2" class="highlight">Goodbye</span></p>
*/
jindo.$Element.prototype.toggleClass = function(sClass, sClass2) {
if(this._element.classList){
jindo.$Element.prototype.toggleClass = function(sClass, sClass2){
if (typeof sClass2 == "undefined") {
this._element.classList.toggle(sClass);
} else {
if(this.hasClass(sClass)){
this.removeClass(sClass);
this.addClass(sClass2);
}else{
this.addClass(sClass);
this.removeClass(sClass2);
}
}
return this;
}
} else {
jindo.$Element.prototype.toggleClass = function(sClass, sClass2){
sClass2 = sClass2 || "";
if (this.hasClass(sClass)) {
this.removeClass(sClass);
if (sClass2) this.addClass(sClass2);
} else {
this.addClass(sClass);
if (sClass2) this.removeClass(sClass2);
}
return this;
}
}
return this.toggleClass(sClass, sClass2);
};
/**
* HTML 엘리먼트의 텍스트 노드 값을 가져오거나 설정한다.
* @param {String} [sText] 설정할 텍스트<br>
* 매개 변수를 생략하면 텍스트 노드를 조회하고, 매개 변수를 지정하면 매개 변수의 값으로 텍스트 노드를 설정한다.
* @returns {String} 값을 조회하는 경우에는 HTML 엘리먼트의 텍스트 노드를 반환하고,<br>
* 값을 설정하는 경우에는 텍스트 노드를 설정한 현재의 $Element 객체를 반환
* @description [Lite]
*
* @example
<ul id="sample_ul">
<li>하나</li>
<li>둘</li>
<li>셋</li>
<li>넷</li>
</ul>
...
// 텍스트 노드 값 조회
$Element("sample_ul").text();
// 결과
// 하나
// 둘
// 셋
// 넷
@example
// 텍스트 노드 값 설정
$Element("sample_ul").text('다섯');
//Before
<ul id="sample_ul">
<li>하나</li>
<li>둘</li>
<li>셋</li>
<li>넷</li>
</ul>
//After
<ul id="sample_ul">다섯</ul>
@example
// 텍스트 노드 값 설정
$Element("sample_p").text("New Content");
//Before
<p id="sample_p">
Old Content
</p>
//After
<p id="sample_p">
New Content
</p>
*/
jindo.$Element.prototype.text = function(sText) {
var ele = this._element;
var tag = this.tag;
var prop = (typeof ele.innerText != "undefined")?"innerText":"textContent";
if (tag == "textarea" || tag == "input") prop = "value";
var type = (typeof sText);
if (type != "undefined"&&(type == "string" || type == "number" || type == "boolean")) {
sText += "";
try {
/*
* Opera 11.01에서 textContext가 Get일때 정상적으로 동작하지 않음. 그래서 get일 때는 innerText을 사용하고 set하는 경우는 textContent을 사용한다.(http://devcafe.nhncorp.com/ajaxui/295768)
*/
if (prop!="value") prop = (typeof ele.textContent != "undefined")?"textContent":"innerText";
ele[prop] = sText;
} catch(e) {
return this.html(sText.replace(/&/g, '&amp;').replace(/</g, '&lt;'));
}
return this;
}
return ele[prop];
};
/**
* HTML 엘리먼트의 내부 HTML(innerHTML) 을 가져오거나 설정한다.
* @param {String} [sHTML] 설정할 HTML 문자열<br>
* 매개 변수를 생략하면 내부 HTML 을 조회하고, 매개 변수를 지정하면 매개 변수의 값으로 내부 HTML을 변경한다.
* @return {String | $Element} 값을 조회하는 경우에는 HTML 엘리먼트의 내부 HTML을 반환하고,<br>
* 값을 설정하는 경우에는 내부 HTML 을 변경한 현재의 $Element 객체를 반환
* @see $Element#outerHTML
* @description [Lite]
*
* @example
<div id="sample_container">
<p><em>Old</em> content</p>
</div>
...
// 내부 HTML 조회
$Element("sample_container").html(); // <p><em>Old</em> content</p>
* @example
// 내부 HTML 설정
$Element("sample_container").html("<p>New <em>content</em></p>");
//Before
<div id="sample_container">
<p><em>Old</em> content</p>
</div>
//After
<div id="sample_container">
<p>New <em>content</em></p>
</div>
*/
jindo.$Element.prototype.html = function(sHTML) {
var isIe = IS_IE;
var isFF = IS_FF;
if (isIe) {
jindo.$Element.prototype.html = function(sHTML){
if (typeof sHTML != "undefined" && arguments.length) {
sHTML += "";
jindo.$$.release();
var oEl = this._element;
while(oEl.firstChild){
oEl.removeChild(oEl.firstChild);
}
/*
IE 나 FireFox 의 일부 상황에서 SELECT 태그나 TABLE, TR, THEAD, TBODY 태그에 innerHTML 을 셋팅해도
문제가 생기지 않도록 보완 - hooriza
*/
var sId = 'R' + new Date().getTime() + parseInt(Math.random() * 100000,10);
var oDoc = oEl.ownerDocument || oEl.document || document;
var oDummy;
var sTag = oEl.tagName.toLowerCase();
switch (sTag) {
case 'select':
case 'table':
oDummy = oDoc.createElement("div");
oDummy.innerHTML = '<' + sTag + ' class="' + sId + '">' + sHTML + '</' + sTag + '>';
break;
case 'tr':
case 'thead':
case 'tbody':
case 'colgroup':
oDummy = oDoc.createElement("div");
oDummy.innerHTML = '<table><' + sTag + ' class="' + sId + '">' + sHTML + '</' + sTag + '></table>';
break;
default:
oEl.innerHTML = sHTML;
break;
}
if (oDummy) {
var oFound;
for (oFound = oDummy.firstChild; oFound; oFound = oFound.firstChild)
if (oFound.className == sId) break;
if (oFound) {
var notYetSelected = true;
for (var oChild; oChild = oEl.firstChild;) oChild.removeNode(true); // innerHTML = '';
for (var oChild = oFound.firstChild; oChild; oChild = oFound.firstChild){
if(sTag=='select'){
/*
* ie에서 select테그일 경우 option중 selected가 되어 있는 option이 있는 경우 중간에
* selected가 되어 있으면 그 다음 부터는 계속 selected가 true로 되어 있어
* 해결하기 위해 cloneNode를 이용하여 option을 카피한 후 selected를 변경함. - mixed
*/
var cloneNode = oChild.cloneNode(true);
if (oChild.selected && notYetSelected) {
notYetSelected = false;
cloneNode.selected = true;
}
oEl.appendChild(cloneNode);
oChild.removeNode(true);
}else{
oEl.appendChild(oChild);
}
}
oDummy.removeNode && oDummy.removeNode(true);
}
oDummy = null;
}
return this;
}
return this._element.innerHTML;
}
}else if(isFF){
jindo.$Element.prototype.html = function(sHTML){
if (typeof sHTML != "undefined" && arguments.length) {
sHTML += "";
var oEl = this._element;
if(!oEl.parentNode){
/*
IE 나 FireFox 의 일부 상황에서 SELECT 태그나 TABLE, TR, THEAD, TBODY 태그에 innerHTML 을 셋팅해도
문제가 생기지 않도록 보완 - hooriza
*/
var sId = 'R' + new Date().getTime() + parseInt(Math.random() * 100000,10);
var oDoc = oEl.ownerDocument || oEl.document || document;
var oDummy;
var sTag = oEl.tagName.toLowerCase();
switch (sTag) {
case 'select':
case 'table':
oDummy = oDoc.createElement("div");
oDummy.innerHTML = '<' + sTag + ' class="' + sId + '">' + sHTML + '</' + sTag + '>';
break;
case 'tr':
case 'thead':
case 'tbody':
case 'colgroup':
oDummy = oDoc.createElement("div");
oDummy.innerHTML = '<table><' + sTag + ' class="' + sId + '">' + sHTML + '</' + sTag + '></table>';
break;
default:
oEl.innerHTML = sHTML;
break;
}
if (oDummy) {
var oFound;
for (oFound = oDummy.firstChild; oFound; oFound = oFound.firstChild)
if (oFound.className == sId) break;
if (oFound) {
for (var oChild; oChild = oEl.firstChild;) oChild.removeNode(true); // innerHTML = '';
for (var oChild = oFound.firstChild; oChild; oChild = oFound.firstChild){
oEl.appendChild(oChild);
}
oDummy.removeNode && oDummy.removeNode(true);
}
oDummy = null;
}
}else{
oEl.innerHTML = sHTML;
}
return this;
}
return this._element.innerHTML;
}
}else{
jindo.$Element.prototype.html = function(sHTML){
if (typeof sHTML != "undefined" && arguments.length) {
sHTML += "";
var oEl = this._element;
oEl.innerHTML = sHTML;
return this;
}
return this._element.innerHTML;
}
}
return this.html(sHTML);
};
/**
* HTML 엘리먼트의 외부 HTML(outerHTML) 을 반환한다.
* @return {String} 외부 HTML
* @see $Element#html
* @description [Lite]
*
* @example
<h2 id="sample0">Today is...</h2>
<div id="sample1">
<p><span id="sample2">Sample</span> content</p>
</div>
...
// 외부 HTML 값을 조회
$Element("sample0").outerHTML(); // <h2 id="sample0">Today is...</h2>
$Element("sample1").outerHTML(); // <div id="sample1"> <p><span id="sample2">Sample</span> content</p> </div>
$Element("sample2").outerHTML(); // <span id="sample2">Sample</span>
*/
jindo.$Element.prototype.outerHTML = function() {
var e = this._element;
if (typeof e.outerHTML != "undefined") return e.outerHTML;
var oDoc = e.ownerDocument || e.document || document;
var div = oDoc.createElement("div");
var par = e.parentNode;
/**
상위노드가 없으면 innerHTML반환
*/
if(!par) return e.innerHTML;
par.insertBefore(div, e);
div.style.display = "none";
div.appendChild(e);
var s = div.innerHTML;
par.insertBefore(e, div);
par.removeChild(div);
return s;
};
/**
* HTML 엘리먼트를 HTML 문자열로 변환하여 반환한다. (outerHTML 메서드와 동일)
* @return {String} 외부 HTML
* @see $Element#outerHTML
*/
jindo.$Element.prototype.toString = jindo.$Element.prototype.outerHTML;
/**
* @fileOverview $Element의 확장 메서드를 정의한 파일
* @name element.extend.js
*/
/**
* appear ,disappear에서 사용되는 함수로 현재 transition을 사용 할수 있는지를 학인한다.
* @ignore
*/
jindo.$Element._getTransition = function(){
var hasTransition = false , sTransitionName = "";
if (typeof document.body.style.trasition != "undefined") {
hasTransition = true;
sTransitionName = "trasition";
}
/*
아직 firefox는 transitionEnd API를 지원 하지 않음.
*/
// else if(typeof document.body.style.MozTransition !== "undefined"){
// hasTransition = true;
// sTransitionName = "MozTransition";
// }
else if(typeof document.body.style.webkitTransition !== "undefined"){
hasTransition = true;
sTransitionName = "webkitTransition";
}else if(typeof document.body.style.OTransition !== "undefined"){
hasTransition = true;
sTransitionName = "OTransition";
}
return (jindo.$Element._getTransition = function(){
return {
"hasTransition" : hasTransition,
"name" : sTransitionName
};
})();
}
/**
* HTML 엘리먼트를 서서히 나타나게 한다. (Fade-in 효과)
*
* @param {Number} duration HTML 엘리먼트가 완전히 나타날 때까지 걸리는 시간. 단위는 초를 사용한다.
* @param {Function} [callback] HTML 엘리먼트가 완전히 나타난 후에 실행할 콜백 함수.
* @return {$Element} 현재의 $Element 객체
*
* @remark IE6 에서 filter 사용 시 해당 엘리먼트가 position 속성을 가지고 있으면 사라지는 문제가 있기 때문에 HTML 엘리먼트에 position 속성이 없어야 한다.
* @remark webkit기반의 브라우저(safari5+, mobile safari, chrome, mobile webkit), opera10.60+ 에서는 CSS3 transition을 사용한다. 그 이외의 브라우저에서는 자바스크립트를 사용한다.
*
* @see $Element#show
* @see $Element#disappear
*
* @example
$Element("sample1").appear(5, function(){
$Element("sample2").appear(3);
});
//Before
<div style="display: none; background-color: rgb(51, 51, 153); width: 100px; height: 50px;" id="sample1">
<div style="display: none; background-color: rgb(165, 10, 81); width: 50px; height: 20px;" id="sample2">
</div>
</div>
//After(1) : sample1 엘리먼트가 나타남
<div style="display: block; background-color: rgb(51, 51, 153); width: 100px; height: 50px; opacity: 1;" id="sample1">
<div style="display: none; background-color: rgb(165, 10, 81); width: 50px; height: 20px;" id="sample2">
</div>
</div>
//After(2) : sample2 엘리먼트가 나타남
<div style="display: block; background-color: rgb(51, 51, 153); width: 100px; height: 50px; opacity: 1;" id="sample1">
<div style="display: block; background-color: rgb(165, 10, 81); width: 50px; height: 20px; opacity: 1;" id="sample2">
</div>
</div>
*/
jindo.$Element.prototype.appear = function(duration, callback) {
var oTransition = jindo.$Element._getTransition();
if (oTransition.hasTransition) {
jindo.$Element.prototype.appear = function(duration, callback) {
duration = duration||0.3;
callback = callback || function(){};
var bindFunc = function(){
callback();
this.show();
this.removeEventListener(oTransition.name+"End", arguments.callee , false );
};
var ele = this._element;
var self = this;
if(!this.visible()){
ele.style.opacity = ele.style.opacity||0;
self.show();
}
ele.addEventListener( oTransition.name+"End", bindFunc , false );
ele.style[oTransition.name + 'Property'] = 'opacity';
ele.style[oTransition.name + 'Duration'] = duration+'s';
ele.style[oTransition.name + 'TimingFunction'] = 'linear';
setTimeout(function(){
ele.style.opacity = '1';
},1);
return this;
}
}else{
jindo.$Element.prototype.appear = function(duration, callback) {
var self = this;
var op = this.opacity();
if(!this.visible()) op = 0;
if (op == 1) return this;
try { clearTimeout(this._fade_timer); } catch(e){};
callback = callback || function(){};
var step = (1-op) / ((duration||0.3)*100);
var func = function(){
op += step;
self.opacity(op);
if (op >= 1) {
callback(self);
} else {
self._fade_timer = setTimeout(func, 10);
}
};
this.show();
func();
return this;
}
}
return this.appear(duration, callback);
};
/**
* HTML 엘리먼트를 서서히 사라지게 한다. (Fade-out 효과)<br>
* HTML 엘리먼트가 완전히 사라지면 엘리먼트의 display 속성은 none 으로 변한다.
*
* @param {Number} duration HTML 엘리먼트 완전히 사라질 때까지 걸리는 시간. 단위는 초를 사용한다.
* @param {Function} [callback] HTML 엘리먼트가 완전히 사라진 후에 실행할 콜백 함수.
* @return {$Element} 현재의 $Element 객체
*
* @remark webkit기반의 브라우저(safari5+, mobile safari, chrome, mobile webkit), opera10.60+ 에서는 CSS3 transition을 사용한다. 그 이외의 브라우저에서는 자바스크립트를 사용한다.
*
* @see $Element#hide
* @see $Element#appear
*
* @example
$Element("sample1").disappear(5, function(){
$Element("sample2").disappear(3);
});
//Before
<div id="sample1" style="background-color: rgb(51, 51, 153); width: 100px; height: 50px;">
</div>
<div id="sample2" style="background-color: rgb(165, 10, 81); width: 100px; height: 50px;">
</div>
//After(1) : sample1 엘리먼트가 사라짐
<div id="sample1" style="background-color: rgb(51, 51, 153); width: 100px; height: 50px; opacity: 1; display: none;">
</div>
<div id="sample2" style="background-color: rgb(165, 10, 81); width: 100px; height: 50px;">
</div>
//After(2) : sample2 엘리먼트가 사라짐
<div id="sample1" style="background-color: rgb(51, 51, 153); width: 100px; height: 50px; opacity: 1; display: none;">
</div>
<div id="sample2" style="background-color: rgb(165, 10, 81); width: 100px; height: 50px; opacity: 1; display: none;">
</div>
*/
jindo.$Element.prototype.disappear = function(duration, callback) {
var oTransition = jindo.$Element._getTransition();
if (oTransition.hasTransition) {
jindo.$Element.prototype.disappear = function(duration, callback) {
duration = duration||0.3
var self = this;
callback = callback || function(){};
var bindFunc = function(){
callback();
this.removeEventListener(oTransition.name+"End", arguments.callee , false );
self.hide();
};
var ele = this._element;
ele.addEventListener( oTransition.name+"End", bindFunc , false );
ele.style[oTransition.name + 'Property'] = 'opacity';
ele.style[oTransition.name + 'Duration'] = duration+'s';
ele.style[oTransition.name + 'TimingFunction'] = 'linear';
/*
opera 버그로 인하여 아래와 같이 처리함.
*/
setTimeout(function(){
ele.style.opacity = '0';
},1);
return this;
}
}else{
jindo.$Element.prototype.disappear = function(duration, callback) {
var self = this;
var op = this.opacity();
if (op == 0) return this;
try { clearTimeout(this._fade_timer); } catch(e){};
callback = callback || function(){};
var step = op / ((duration||0.3)*100);
var func = function(){
op -= step;
self.opacity(op);
if (op <= 0) {
self.hide();
self.opacity(1);
callback(self);
} else {
self._fade_timer = setTimeout(func, 10);
}
};
func();
return this;
}
}
return this.disappear(duration, callback);
};
/**
* HTML 엘리먼트의 위치를 가져오거나 설정한다.<br>
* <br>
* 매개 변수를 생략하면 위치 값을 가져온다.<br>
* 매개 변수를 지정하면 HTML 엘리먼트의 위치를 설정한다.<br>
* 기준점은 브라우저 문서의 왼쪽 상단이다.
*
* @param {Number} [nTop] 문서의 맨 위에서 HTML 엘리먼트 맨 위까지의 거리. 단위는 px
* @param {Number} [nLeft] 문서의 왼쪽 가장자리에서 HTML 엘리먼트 왼쪽 가장자리까지의 거리. 단위는 px
* @return {$Element | Object} 위치를 설정하면 위치 값이 변경된 $Element 객체를 반환하고,<br>
* 위치를 가져오면 HTML 엘리먼트의 top, left 위치 값을 객체로 반환한다.
*
* @remark HTML 엘리먼트가 보이는 상태에서 적용해야 한다. 엘리먼트가 화면에 보이지 않으면 offset 의 사용이 정확하지 않다.
* @remark 일부 브라우저와 일부 상황에서 inline 엘리먼트에 대한 위치가 올바르게 얻어지지 않는 문제가 있으며 이 경우 해당 엘리먼트를 position:relative; 로 바꿔주는 식으로 해결할 수 있다.
* @author Hooriza
*
* @example
<style type="text/css">
div { background-color:#2B81AF; width:20px; height:20px; float:left; left:100px; top:50px; position:absolute;}
</style>
<div id="sample"></div>
...
// 위치 값 조회
$Element("sample").offset(); // { left=100, top=50 }
* @example
// 위치 값 설정
$Element("sample").offset(40, 30);
//Before
<div id="sample"></div>
//After
<div id="sample" style="top: 40px; left: 30px;"></div>
*/
jindo.$Element.prototype.offset = function(nTop, nLeft) {
var oEl = this._element;
var oPhantom = null;
// setter
if (typeof nTop == 'number' && typeof nLeft == 'number') {
if (isNaN(parseInt(this.css('top'),10))) this.css('top', 0);
if (isNaN(parseInt(this.css('left'),10))) this.css('left', 0);
var oPos = this.offset();
var oGap = { top : nTop - oPos.top, left : nLeft - oPos.left };
oEl.style.top = parseInt(this.css('top'),10) + oGap.top + 'px';
oEl.style.left = parseInt(this.css('left'),10) + oGap.left + 'px';
return this;
}
// getter
var bSafari = /Safari/.test(navigator.userAgent);
var bIE = /MSIE/.test(navigator.userAgent);
var nVer = bIE?navigator.userAgent.match(/(?:MSIE) ([0-9.]+)/)[1]:0;
var fpSafari = function(oEl) {
var oPos = { left : 0, top : 0 };
for (var oParent = oEl, oOffsetParent = oParent.offsetParent; oParent = oParent.parentNode; ) {
if (oParent.offsetParent) {
oPos.left -= oParent.scrollLeft;
oPos.top -= oParent.scrollTop;
}
if (oParent == oOffsetParent) {
oPos.left += oEl.offsetLeft + oParent.clientLeft;
oPos.top += oEl.offsetTop + oParent.clientTop ;
if (!oParent.offsetParent) {
oPos.left += oParent.offsetLeft;
oPos.top += oParent.offsetTop;
}
oOffsetParent = oParent.offsetParent;
oEl = oParent;
}
}
return oPos;
};
var fpOthers = function(oEl) {
var oPos = { left : 0, top : 0 };
var oDoc = oEl.ownerDocument || oEl.document || document;
var oHtml = oDoc.documentElement;
var oBody = oDoc.body;
if (oEl.getBoundingClientRect) { // has getBoundingClientRect
if (!oPhantom) {
var bHasFrameBorder = (window == top);
if(!bHasFrameBorder){
try{
bHasFrameBorder = (window.frameElement && window.frameElement.frameBorder == 1);
}catch(e){}
}
if ((bIE && nVer < 8 && window.external) && bHasFrameBorder) {
oPhantom = { left : 2, top : 2 };
oBase = null;
} else {
oPhantom = { left : 0, top : 0 };
}
}
var box = oEl.getBoundingClientRect();
if (oEl !== oHtml && oEl !== oBody) {
oPos.left = box.left - oPhantom.left;
oPos.top = box.top - oPhantom.top;
oPos.left += oHtml.scrollLeft || oBody.scrollLeft;
oPos.top += oHtml.scrollTop || oBody.scrollTop;
}
} else if (oDoc.getBoxObjectFor) { // has getBoxObjectFor
var box = oDoc.getBoxObjectFor(oEl);
var vpBox = oDoc.getBoxObjectFor(oHtml || oBody);
oPos.left = box.screenX - vpBox.screenX;
oPos.top = box.screenY - vpBox.screenY;
} else {
for (var o = oEl; o; o = o.offsetParent) {
oPos.left += o.offsetLeft;
oPos.top += o.offsetTop;
}
for (var o = oEl.parentNode; o; o = o.parentNode) {
if (o.tagName == 'BODY') break;
if (o.tagName == 'TR') oPos.top += 2;
oPos.left -= o.scrollLeft;
oPos.top -= o.scrollTop;
}
}
return oPos;
};
return (bSafari ? fpSafari : fpOthers)(oEl);
};
/**
* 문자열 내의 JavaScript를 실행한다.<br>
* &lt;script&gt; 태그가 포함된 문자열을 매개 변수로 지정하면, &lt;script&gt; 안에 있는 내용을 파싱하여 eval 를 수행한다.
*
* @param {String} sHTML &lt;script&gt; 태그가 포함된 HTML 문자열
* @return {$Element} 현재의 $Element 객체를 반환
*
* @example
// script 태그가 포함된 문자열을 지정
var response = "<script type='text/javascript'>$Element('sample').appendHTML('<li>4</li>')</script>";
$Element("sample").evalScripts(response);
//Before
<ul id="sample">
<li>1</li>
<li>2</li>
<li>3</li>
</ul>
//After
<ul id="sample">
<li>1</li>
<li>2</li>
<li>3</li>
<li>4</li></ul>
*/
jindo.$Element.prototype.evalScripts = function(sHTML) {
var aJS = [];
sHTML = sHTML.replace(new RegExp('<script(\\s[^>]+)*>(.*?)</'+'script>', 'gi'), function(_1, _2, sPart) { aJS.push(sPart); return ''; });
eval(aJS.join('\n'));
return this;
};
/**
* element를 뒤에 붙일때 사용되는 함수.
* @ignore
* @param {Element} 기준 엘리먼트
* @param {Element} 붙일 엘리먼트
* @return {$Element} 두번째 파라메터의 엘리먼트
*/
jindo.$Element._append = function(oParent, oChild){
if (typeof oChild == "string") {
oChild = jindo.$(oChild);
}else if(oChild instanceof jindo.$Element){
oChild = oChild.$value();
}
oParent._element.appendChild(oChild);
return oParent;
}
/**
* element를 앞에 붙일때 사용되는 함수.
* @ignore
* @param {Element} 기준 엘리먼트
* @param {Element} 붙일 엘리먼트
* @return {$Element} 두번째 파라메터의 엘리먼트
*/
jindo.$Element._prepend = function(oParent, oChild){
if (typeof oParent == "string") {
oParent = jindo.$(oParent);
}else if(oParent instanceof jindo.$Element){
oParent = oParent.$value();
}
var nodes = oParent.childNodes;
if (nodes.length > 0) {
oParent.insertBefore(oChild._element, nodes[0]);
} else {
oParent.appendChild(oChild._element);
}
return oChild;
}
/**
* HTML 엘리먼트에 마지막 자식 노드를 추가한다.
*
* @param {$Element | HTML Element | String} oElement 추가할 HTML 엘리먼트. 문자열, HTML 엘리먼트, 혹은 $Element 을 매개 변수로 지정할 수 있다.<br>
* <br>
* 매개 변수가 문자열이면 해당 문자열을 id 로 하는 HTML 엘리먼트를 마지막 자식노드로 추가한다.<br>
* 매개 변수가 HTML 엘리먼트이면 해당 엘리먼트를 마지막 자식노드로 추가한다.<br>
* 매개 변수가 $Element 이면 $Element 객체 내부의 HTML 엘리먼트를 마지막 자식노드로 추가한다.
* @return {$Element} $Element 객체 자신
*
* @see $Element#prepend
* @see $Element#before
* @see $Element#after
* @see $Element#appendTo
* @see $Element#prependTo
*
* @example
// id 가 sample1 인 HTML 엘리먼트에
// id 가 sample2 인 HTML 엘리먼트를 추가
$Element("sample1").append("sample2");
//Before
<div id="sample2">
<div>Hello 2</div>
</div>
<div id="sample1">
<div>Hello 1</div>
</div>
//After
<div id="sample1">
<div>Hello 1</div>
<div id="sample2">
<div>Hello 2</div>
</div>
</div>
* @example
// id 가 sample 인 HTML 엘리먼트에
// 새로운 DIV 엘리먼트를 추가
var elChild = $("<div>Hello New</div>");
$Element("sample").append(elChild);
//Before
<div id="sample">
<div>Hello</div>
</div>
//After
<div id="sample">
<div>Hello </div>
<div>Hello New</div>
</div>
*/
jindo.$Element.prototype.append = function(oElement) {
return jindo.$Element._append(this,oElement);
};
/**
* HTML 엘리먼트에 첫 번째 자식 노드를 추가한다.
*
* @param {$Element | HTMLElement | String} oElement 추가할 HTML 엘리먼트. 문자열, HTML 엘리먼트, 혹은 $Element 을 매개 변수로 지정할 수 있다.<br>
* <br>
* 매개 변수가 문자열이면 해당 문자열을 id 로 하는 HTML 엘리먼트를 첫 번째 자식노드로 추가한다.<br>
* 매개 변수가 HTML 엘리먼트이면 해당 엘리먼트를 첫 번째 자식노드로 추가한다.<br>
* 매개 변수가 $Element 이면 $Element 객체 내부의 HTML 엘리먼트를 첫 번째 자식노드로 추가한다.
* @return {$Element} $Element 객체 자신
*
* @see $Element#append
* @see $Element#before
* @see $Element#after
* @see $Element#appendTo
* @see $Element#prependTo
*
* @example
// id 가 sample1 인 HTML 엘리먼트에서
// id 가 sample2 인 HTML 엘리먼트를 첫 번째 자식노드로 이동
$Element("sample1").prepend("sample2");
//Before
<div id="sample1">
<div>Hello 1</div>
<div id="sample2">
<div>Hello 2</div>
</div>
</div>
//After
<div id="sample1">
<div id="sample2">
<div>Hello 2</div>
</div>
<div>Hello 1</div>
</div>
* @example
// id 가 sample 인 HTML 엘리먼트에
// 새로운 DIV 엘리먼트를 추가
var elChild = $("<div>Hello New</div>");
$Element("sample").prepend(elChild);
//Before
<div id="sample">
<div>Hello</div>
</div>
//After
<div id="sample">
<div>Hello New</div>
<div>Hello</div>
</div>
*/
jindo.$Element.prototype.prepend = function(oElement) {
return jindo.$Element._prepend(this._element, jindo.$Element(oElement));
};
/**
* $Element 객체 내부의 HTML 엘리먼트를 매개 변수로 지정한 엘리먼트로 대체한다.
*
* @param {$Element | HTML Element | String} oElement 대체할 HTML 엘리먼트. 문자열, HTML 엘리먼트, 혹은 $Element 을 매개 변수로 지정할 수 있다.<br>
* <br>
* 매개 변수가 문자열이면 해당 문자열을 id 로 하는 HTML 엘리먼트로 대체한다.<br>
* 매개 변수가 HTML 엘리먼트이면 해당 엘리먼트로 대체한다.<br>
* 매개 변수가 $Element 이면 $Element 객체 내부의 HTML 엘리먼트로 대체한다.
* @return {$Element} HTML 엘리먼트가 대체 된 $Element 객체를 반환
*
* @example
// id 가 sample1 인 HTML 엘리먼트에서
// id 가 sample2 인 HTML 엘리먼트로 대체
$Element('sample1').replace('sample2');
//Before
<div>
<div id="sample1">Sample1</div>
</div>
<div id="sample2">Sample2</div>
//After
<div>
<div id="sample2">Sample2</div>
</div>
* @example
// 새로운 DIV 엘리먼트로 대체
$Element("btn").replace($("<div>Sample</div>"));
//Before
<button id="btn">Sample</button>
//After
<div>Sample</div>
*/
jindo.$Element.prototype.replace = function(oElement) {
jindo.$$.release();
var e = this._element;
var oParentNode = e.parentNode;
var o = jindo.$Element(oElement);
if(oParentNode&&oParentNode.replaceChild){
oParentNode.replaceChild(o.$value(),e);
return o;
}
var o = o.$value();
oParentNode.insertBefore(o, e);
oParentNode.removeChild(e);
return o;
};
/**
* HTML 엘리먼트를 다른 HTML 엘리먼트의 마지막 자식노드로 추가한다.
*
* @param {$Element | HTML Element | String} oElement 부모가 될 HTML 엘리먼트. <br>
* <br>
* 문자열, HTML 엘리먼트, 혹은 $Element 을 매개 변수로 지정할 수 있다.<br>
* <br>
* 매개 변수가 문자열이면 해당 문자열을 id 로 하는 HTML 엘리먼트를 부모로 한다.<br>
* 매개 변수가 HTML 엘리먼트이면 해당 엘리먼트를 부모로 한다.<br>
* 매개 변수가 $Element 이면 $Element 객체 내부의 HTML 엘리먼트를 부모로 한다.
* @return {$Element} 인자로 받은 엘리먼트
*
* @see $Element#append
* @see $Element#prepend
* @see $Element#after
* @see $Element#appendTo
* @see $Element#prependTo
*
* @example
// id 가 sample2 인 HTML 엘리먼트에
// id 가 sample1 인 HTML 엘리먼트를 추가
$Element("sample1").appendTo("sample2");
//Before
<div id="sample1">
<div>Hello 1</div>
</div>
<div id="sample2">
<div>Hello 2</div>
</div>
//After
<div id="sample2">
<div>Hello 2</div>
<div id="sample1">
<div>Hello 1</div>
</div>
</div>
*/
jindo.$Element.prototype.appendTo = function(oElement) {
var ele = jindo.$Element(oElement);
jindo.$Element._append(ele, this._element);
return ele;
};
/**
* HTML 엘리먼트를 다른 HTML 엘리먼트의 첫 번째 자식노드로 추가한다.
*
* @param {$Element | HTML Element | String} oElement 부모가 될 HTML 엘리먼트. 문자열, HTML 엘리먼트, 혹은 $Element 을 매개 변수로 지정할 수 있다.<br>
* <br>
* 매개 변수가 문자열이면 해당 문자열을 id 로 하는 HTML 엘리먼트를 부모로 한다.<br>
* 매개 변수가 HTML 엘리먼트이면 해당 엘리먼트를 부모로 한다.<br>
* 매개 변수가 $Element 이면 $Element 객체 내부의 HTML 엘리먼트를 부모로 한다.
* @return {$Element} 인자로 받은 엘리먼트
*
* @see $Element#append
* @see $Element#prepend
* @see $Element#after
* @see $Element#appendTo
* @see $Element#prependTo
*
* @example
// id 가 sample2 인 HTML 엘리먼트에
// id 가 sample1 인 HTML 엘리먼트를 추가
$Element("sample1").prependTo("sample2");
//Before
<div id="sample1">
<div>Hello 1</div>
</div>
<div id="sample2">
<div>Hello 2</div>
</div>
//After
<div id="sample2">
<div id="sample1">
<div>Hello 1</div>
</div>
<div>Hello 2</div>
</div>
*/
jindo.$Element.prototype.prependTo = function(oElement) {
jindo.$Element._prepend(oElement, this);
return jindo.$Element(oElement);
};
/**
* HTML 엘리먼트 바로 앞에 HTML 엘리먼트를 추가한다.
*
* @param {$Element | HTML Element | String} oElement 추가할 HTML 엘리먼트.<br>
* <br>
* 문자열, HTML 엘리먼트, 혹은 $Element 을 매개 변수로 지정할 수 있다.<br>
* <br>
* 매개 변수가 문자열이면 해당 문자열을 id 로 하는 HTML 엘리먼트를 추가한다.<br>
* 매개 변수가 HTML 엘리먼트이면 해당 엘리먼트를 추가한다.<br>
* 매개 변수가 $Element 이면 $Element 객체 내부의 HTML 엘리먼트를 추가한다.
* @return {$Element} 추가 된 $Element 객체
*
* @see $Element#append
* @see $Element#prepend
* @see $Element#after
* @see $Element#appendTo
* @see $Element#prependTo
*
* @example
// id 가 sample1 인 HTML 엘리먼트 앞에
// id 가 sample2 인 HTML 엘리먼트를 추가 함
$Element("sample1").before("sample2"); // sample2를 래핑한 $Element 를 반환
//Before
<div id="sample1">
<div>Hello 1</div>
<div id="sample2">
<div>Hello 2</div>
</div>
</div>
//After
<div id="sample2">
<div>Hello 2</div>
</div>
<div id="sample1">
<div>Hello 1</div>
</div>
* @example
// 새로운 DIV 엘리먼트를 추가
var elNew = $("<div>Hello New</div>");
$Element("sample").before(elNew); // elNew 엘리먼트를 래핑한 $Element 를 반환
//Before
<div id="sample">
<div>Hello</div>
</div>
//After
<div>Hello New</div>
<div id="sample">
<div>Hello</div>
</div>
*/
jindo.$Element.prototype.before = function(oElement) {
var oRich = jindo.$Element(oElement);
var o = oRich.$value();
this._element.parentNode.insertBefore(o, this._element);
return oRich;
};
/**
* HTML 엘리먼트 바로 뒤에 HTML 엘리먼트를 추가한다.
*
* @param {$Element | HTML Element | String} oElement 추가할 HTML 엘리먼트. 문자열, HTML 엘리먼트, 혹은 $Element 을 매개 변수로 지정할 수 있다.<br>
* <br>
* 매개 변수가 문자열이면 해당 문자열을 id 로 하는 HTML 엘리먼트를 추가한다.<br>
* 매개 변수가 HTML 엘리먼트이면 해당 엘리먼트를 추가한다.<br>
* 매개 변수가 $Element 이면 $Element 객체 내부의 HTML 엘리먼트를 추가한다.
* @return {$Element} 추가 된 $Element 객체
*
* @see $Element#append
* @see $Element#prepend
* @see $Element#before
* @see $Element#appendTo
* @see $Element#prependTo
*
* @example
// id 가 sample1 인 HTML 엘리먼트 뒤에
// id 가 sample2 인 HTML 엘리먼트를 추가 함
$Element("sample1").after("sample2"); // sample2를 래핑한 $Element 를 반환
//Before
<div id="sample1">
<div>Hello 1</div>
<div id="sample2">
<div>Hello 2</div>
</div>
</div>
//After
<div id="sample1">
<div>Hello 1</div>
</div>
<div id="sample2">
<div>Hello 2</div>
</div>
* @example
// 새로운 DIV 엘리먼트를 추가
var elNew = $("<div>Hello New</div>");
$Element("sample").after(elNew); // elNew 엘리먼트를 래핑한 $Element 를 반환
//Before
<div id="sample">
<div>Hello</div>
</div>
//After
<div id="sample">
<div>Hello</div>
</div>
<div>Hello New</div>
*/
jindo.$Element.prototype.after = function(oElement) {
var o = this.before(oElement);
o.before(this);
return o;
};
/**
* HTML 엘리먼트의 상위 엘리먼트 노드를 검색한다.
*
* @param {Function} [pFunc] 상위 엘리먼트 노드의 검색 조건을 지정한 콜백 함수.<br>
* 매개 변수를 생략하면 부모 엘리먼트 노드를 반환하고,<br>
* 매개 변수로 콜백 함수를 지정하면 콜백 함수의 실행 결과가 true 인 상위 엘리먼트 노드의 배열을 반환한다.<br>
* 콜백 함수에 매개 변수로 탐색 중인 상위 엘리먼트 노드의 $Element 객체를 넘긴다.
* @param {Number} [limit] 탐색할 상위 엘리먼트 노드의 뎁스.<br>
* 매개 변수를 생략하면 모든 상위 엘리먼트 노드를 탐색한다.<br>
* pFunc 매개 변수를 null로 설정하고 limit 매개 변수를 설정하면 제한된 뎁스의 상위 엘리먼트 노드를 조건 없이 검색한다.
* @return {$Element | Array} 부모 엘리먼트 노드 혹은 상위 엘리먼트 노드의 배열.<br>
* 매개 변수를 생략하여 부모 엘리먼트 노드를 반환하는 경우, $Element 타입으로 반환한다.<br>
* 그 이외에는 검색된 엘리먼트 노드를 $Element의 배열로 반환한다.
*
* @see $Element#child
* @see $Element#prev
* @see $Element#next
* @see $Element#first
* @see $Element#last
* @see $Element#indexOf
*
* @example
<div class="sample" id="div1">
<div id="div2">
<div class="sample" id="div3">
<div id="target">
Sample
<div id="div4">
Sample
</div>
<div class="sample" id="div5">
Sample
</div>
</div>
<div class="sample" id="div6">
Sample
</div>
</div>
</div>
</div>
<script type="text/javascript">
var welTarget = $Element("target");
var parent = welTarget.parent();
// id가 div3인 DIV를 래핑한 $Element를 반환
parent = welTarget.parent(function(v){
return v.hasClass("sample");
});
// id가 div3인 DIV를 래핑한 $Element와
// id가 div1인 DIV를 래핑한 $Element를 원소로 하는 배열을 반환
parent = welTarget.parent(function(v){
return v.hasClass("sample");
}, 1);
// id가 div3인 DIV를 래핑한 $Element를 원소로 하는 배열을 반환
</script>
*/
jindo.$Element.prototype.parent = function(pFunc, limit) {
var e = this._element;
var a = [], p = null;
if (typeof pFunc == "undefined") return jindo.$Element(e.parentNode);
if (typeof limit == "undefined" || limit == 0) limit = -1;
while (e.parentNode && limit-- != 0) {
p = jindo.$Element(e.parentNode);
if (e.parentNode == document.documentElement) break;
if (!pFunc || (pFunc && pFunc(p))) a[a.length] = p;
e = e.parentNode;
}
return a;
};
/**
* HTML 엘리먼트의 하위 엘리먼트 노드를 검색한다.
*
* @param {Function} [pFunc] 하위 엘리먼트 노드의 검색 조건을 지정한 콜백 함수.<br>
* 매개 변수를 생략하면 자식 엘리먼트 노드의 배열을 반환하고,<br>
* 매개 변수로 콜백 함수를 지정하면 콜백 함수의 실행 결과가 true 인 하위 엘리먼트 노드의 배열을 반환한다.<br>
* 콜백 함수에 매개 변수로 탐색 중인 하위 엘리먼트 노드의 $Element 객체를 넘긴다.
* @param {Number} [limit] 탐색할 하위 엘리먼트 노드의 뎁스.<br>
* 매개 변수를 생략하면 모든 하위 엘리먼트 노드를 탐색한다.<br>
* pFunc 매개 변수를 null로 설정하고 limit 매개 변수를 설정하면 제한된 뎁스의 하위 엘리먼트 노드를 조건 없이 검색한다.
* @return {$Element | Array} 자식 엘리먼트 노드 혹은 조건에 맞는 하위 노드의 $Element의 배열을 반환한다.
*
* @see $Element#parent
* @see $Element#prev
* @see $Element#next
* @see $Element#first
* @see $Element#last
* @see $Element#indexOf
*
* @example
<div class="sample" id="target">
<div id="div1">
<div class="sample" id="div2">
<div id="div3">
Sample
<div id="div4">
Sample
</div>
<div class="sample" id="div5">
Sample
<div class="sample" id="div6">
Sample
</div>
</div>
</div>
</div>
</div>
<div class="sample" id="div7">
Sample
</div>
</div>
<script type="text/javascript">
var welTarget = $Element("target");
var child = welTarget.child();
// id가 div1인 DIV를 래핑한 $Element와
// id가 div7인 DIV를 래핑한 $Element를 원소로 하는 배열을 반환
child = welTarget.child(function(v){
return v.hasClass("sample");
});
// id가 div2인 DIV를 래핑한 $Element와
// id가 div5인 DIV를 래핑한 $Element와
// id가 div6인 DIV를 래핑한 $Element와
// id가 div7인 DIV를 래핑한 $Element를 원소로 하는 배열을 반환
child = welTarget.child(function(v){
return v.hasClass("sample");
}, 1);
// id가 div7인 DIV를 래핑한 $Element를 원소로 하는 배열을 반환
child = welTarget.child(function(v){
return v.hasClass("sample");
}, 2);
// id가 div2인 DIV를 래핑한 $Element와
// id가 div7인 DIV를 래핑한 $Element를 원소로 하는 배열을 반환
</script>
*/
jindo.$Element.prototype.child = function(pFunc, limit) {
var e = this._element;
var a = [], c = null, f = null;
if (typeof pFunc == "undefined") return jindo.$A(e.childNodes).filter(function(v){ return v.nodeType == 1}).map(function(v){ return jindo.$Element(v) }).$value();
if (typeof limit == "undefined" || limit == 0) limit = -1;
(f = function(el, lim){
var ch = null, o = null;
for(var i=0; i < el.childNodes.length; i++) {
ch = el.childNodes[i];
if (ch.nodeType != 1) continue;
o = jindo.$Element(el.childNodes[i]);
if (!pFunc || (pFunc && pFunc(o))) a[a.length] = o;
if (lim != 0) f(el.childNodes[i], lim-1);
}
})(e, limit-1);
return a;
};
/**
* HTML 엘리먼트의 이전에 나오는 형제 엘리먼트 노드를 검색한다.
*
* @param {Function} [pFunc] 이전 형제 엘리먼트 노드의 검색 조건을 지정한 콜백 함수.<br>
* 매개 변수를 생략하면 바로 이전의 형제 엘리먼트 노드를 반환하고,<br>
* 매개 변수로 콜백 함수를 지정하면 콜백 함수의 실행 결과가 true 인 형제 엘리먼트 노드의 배열을 반환한다.<br>
* 콜백 함수에 매개 변수로 탐색 중인 형제 엘리먼트 노드를 넘긴다. ($Element 객체가 아님)
* @return {$Element | Array} 바로 전의 형제 엘리먼트 노드를 가리키는 $Element 혹은 조건에 맞는 형제 노드의 $Element의 배열을 반환한다.
*
* @see $Element#parent
* @see $Element#child
* @see $Element#next
* @see $Element#first
* @see $Element#last
* @see $Element#indexOf
*
* @example
<div class="sample" id="sample_div1">
<div id="sample_div2">
<div class="sample" id="sample_div3">
Sample1
</div>
<div id="sample_div4">
Sample2
</div>
<div class="sample" id="sample_div5">
Sample3
</div>
<div id="sample_div">
Sample4
<div id="sample_div6">
Sample5
</div>
</div>
<div id="sample_div7">
Sample6
</div>
<div class="sample" id="sample_div8">
Sample7
</div>
</div>
</div>
<script type="text/javascript">
var sibling = $Element("sample_div").prev();
// id가 sample_div5인 DIV를 래핑한 $Element를 반환
sibling = $Element("sample_div").prev(function(v){
return $Element(v).hasClass("sample");
});
// id가 sample_div5인 DIV를 래핑한 $Element와
// id가 sample_div3인 DIV를 래핑한 $Element를 원소로 하는 배열을 반환
</script>
*/
jindo.$Element.prototype.prev = function(pFunc) {
var e = this._element;
var a = [];
var b = (typeof pFunc == "undefined");
if (!e) return b?jindo.$Element(null):a;
do {
e = e.previousSibling;
if (!e || e.nodeType != 1) continue;
if (b) return jindo.$Element(e);
if (!pFunc || pFunc(e)) a[a.length] = jindo.$Element(e);
} while(e);
return b?jindo.$Element(e):a;
};
/**
* HTML 엘리먼트의 다음에 나오는 형제 엘리먼트 노드를 검색한다.
*
* @param {Function} [pFunc] 다음 형제 엘리먼트 노드의 검색 조건을 지정한 콜백 함수.<br>
* 매개 변수를 생략하면 바로 다음의 형제 엘리먼트 노드를 반환하고,<br>
* 매개 변수로 콜백 함수를 지정하면 콜백 함수의 실행 결과가 true 인 형제 엘리먼트 노드의 배열을 반환한다.<br>
* 콜백 함수에 매개 변수로 탐색 중인 형제 엘리먼트 노드를 넘긴다. ($Element 객체가 아님)
* @return {$Element | Array} 바로 다음의 형제 엘리먼트 노드를 가리키는 $Element 혹은 조건에 맞는 형제 노드의 $Element의 배열을 반환한다.
*
* @see $Element#parent
* @see $Element#child
* @see $Element#prev
* @see $Element#first
* @see $Element#last
* @see $Element#indexOf
*
* @example
<div class="sample" id="sample_div1">
<div id="sample_div2">
<div class="sample" id="sample_div3">
Sample1
</div>
<div id="sample_div4">
Sample2
</div>
<div class="sample" id="sample_div5">
Sample3
</div>
<div id="sample_div">
Sample4
<div id="sample_div6">
Sample5
</div>
</div>
<div id="sample_div7">
Sample6
</div>
<div class="sample" id="sample_div8">
Sample7
</div>
</div>
</div>
<script type="text/javascript">
var sibling = $Element("sample_div").next();
// id가 sample_div7인 DIV를 래핑한 $Element를 반환
sibling = $Element("sample_div").next(function(v){
return $Element(v).hasClass("sample");
});
// id가 sample_div8인 DIV를 래핑한 $Element를 원소로 하는 배열을 반환
</script>
*/
jindo.$Element.prototype.next = function(pFunc) {
var e = this._element;
var a = [];
var b = (typeof pFunc == "undefined");
if (!e) return b?jindo.$Element(null):a;
do {
e = e.nextSibling;
if (!e || e.nodeType != 1) continue;
if (b) return jindo.$Element(e);
if (!pFunc || pFunc(e)) a[a.length] = jindo.$Element(e);
} while(e);
return b?jindo.$Element(e):a;
};
/**
* HTML 엘리먼트의 첫 번째 자식 엘리먼트 노드를 반환한다.
*
* @return {$Element} 첫 번째 자식 엘리먼트 노드
* @since 1.2.0
*
* @see $Element#parent
* @see $Element#child
* @see $Element#prev
* @see $Element#next
* @see $Element#last
* @see $Element#indexOf
*
* @example
<div id="sample_div1">
<div id="sample_div2">
<div id="sample_div">
Sample1
<div id="sample_div3">
<div id="sample_div4">
Sample2
</div>
Sample3
</div>
<div id="sample_div5">
Sample4
<div id="sample_div6">
Sample5
</div>
</div>
</div>
</div>
</div>
<script type="text/javascript">
var firstChild = $Element("sample_div").first();
// id가 sample_div3인 DIV를 래핑한 $Element를 반환
</script>
*/
jindo.$Element.prototype.first = function() {
var el = this._element.firstElementChild||this._element.firstChild;
if (!el) return null;
while(el && el.nodeType != 1) el = el.nextSibling;
return el?jindo.$Element(el):null;
}
/**
* HTML 엘리먼트의 마지막 자식 엘리먼트 노드를 반환한다.
*
* @return {$Element} 마지막 자식 엘리먼트 노드
* @since 1.2.0
*
* @see $Element#parent
* @see $Element#child
* @see $Element#prev
* @see $Element#next
* @see $Element#first
* @see $Element#indexOf
*
* @example
<div id="sample_div1">
<div id="sample_div2">
<div id="sample_div">
Sample1
<div id="sample_div3">
<div id="sample_div4">
Sample2
</div>
Sample3
</div>
<div id="sample_div5">
Sample4
<div id="sample_div6">
Sample5
</div>
</div>
</div>
</div>
</div>
<script type="text/javascript">
var lastChild = $Element("sample_div").last();
// id가 sample_div5인 DIV를 래핑한 $Element를 반환
</script>
*/
jindo.$Element.prototype.last = function() {
var el = this._element.lastElementChild||this._element.lastChild;
if (!el) return null;
while(el && el.nodeType != 1) el = el.previousSibling;
return el?jindo.$Element(el):null;
}
/**
* HTML 엘리먼트의 부모 엘리먼트 노드를 확인한다.
*
* @param {HTML Element | String | $Element} element 부모 노드인지 확인할 HTML 엘리먼트.<br>
* <br>
* 문자열, HTML 엘리먼트, 혹은 $Element 을 매개 변수로 지정할 수 있다.<br>
* <br>
* 매개 변수가 문자열이면 해당 문자열을 id 로 하는 HTML 엘리먼트를 확인한다.<br>
* 매개 변수가 HTML 엘리먼트이면 해당 엘리먼트를 확인한다.<br>
* 매개 변수가 $Element 이면 $Element 객체 내부의 HTML 엘리먼트를 확인한다.
* @return {Boolean} 매개 변수가 부모 엘리먼트 노드이면 true 를, 그렇지 않으면 false 를 반환한다.
*
* @see $Element#isParentOf
*
* @example
<div id="parent">
<div id="child">
<div id="grandchild"></div>
</div>
</div>
<div id="others"></div>
...
// 부모/자식 확인하기
$Element("child").isChildOf("parent"); // 결과 : true
$Element("others").isChildOf("parent"); // 결과 : false
$Element("grandchild").isChildOf("parent"); // 결과 : true
*/
jindo.$Element.prototype.isChildOf = function(element) {
return jindo.$Element._contain(jindo.$Element(element).$value(),this._element);
};
/**
* HTML 엘리먼트의 자식 엘리먼트 노드를 확인한다.
*
* @param {HTML Element | String | $Element} element 자식 노드인지 확인할 HTML 엘리먼트. 문자열, HTML 엘리먼트, 혹은 $Element 을 매개 변수로 지정할 수 있다가매개 변수가 문자열이면 해당 문자열을 id 로 하는 HTML 엘리먼트를 확인한다.<br>
* 매개 변수가 HTML 엘리먼트이면 해당 엘리먼트를 확인한다.<br>
* 매개 변수가 $Element 이면 $Element 객체 내부의 HTML 엘리먼트를 확인한다.
* @return {Boolean} 매개 변수가 자식 엘리먼트 노드이면 true 를, 그렇지 않으면 false 를 반환한다.
*
* @see $Element#isChildOf
*
* @example
<div id="parent">
<div id="child"></div>
</div>
<div id="others"></div>
...
// 부모/자식 확인하기
$Element("parent").isParentOf("child"); // 결과 : true
$Element("others").isParentOf("child"); // 결과 : false
$Element("parent").isParentOf("grandchild");// 결과 : true
*/
jindo.$Element.prototype.isParentOf = function(element) {
return jindo.$Element._contain(this._element, jindo.$Element(element).$value());
};
/**
* isChildOf , isParentOf의 기본이 되는 API(IE에서는 contains,기타 브라우져에는 compareDocumentPosition을 사용하고 둘다 없는 경우는 기존 레거시 API사용.)
* @param {HTMLElement} eParent 부모노드
* @param {HTMLElement} eChild 자식노드
* @ignore
*/
jindo.$Element._contain = function(eParent,eChild){
if (document.compareDocumentPosition) {
jindo.$Element._contain = function(eParent,eChild){
return !!(eParent.compareDocumentPosition(eChild)&16);
}
}else if(document.body.contains){
jindo.$Element._contain = function(eParent,eChild){
return (eParent !== eChild)&&(eParent.contains ? eParent.contains(eChild) : true);
}
}else{
jindo.$Element._contain = function(eParent,eChild){
var e = eParent;
var el = eChild;
while(e && e.parentNode) {
e = e.parentNode;
if (e == el) return true;
}
return false;
}
}
return jindo.$Element._contain(eParent,eChild);
}
/**
* 현재의 HTML 엘리먼트와 동일한 엘리먼트인지 확인한다.
*
* @remark DOM3의 API중 isSameNode와 같은 함수로 레퍼런스까지 확인 함수이다.
* @remark isEqualNode와는 다른 함수이기 때문에 헷갈리지 않도록 한다.
*
* @param {HTML Element | String | $Element} element 같은 HTML 엘리먼트인지 확인할 HTML 엘리먼트. 문자열, HTML 엘리먼트, 혹은 $Element 을 매개 변수로 지정할 수 있다.<br>
* <br>
* 매개 변수가 문자열이면 해당 문자열을 id 로 하는 HTML 엘리먼트를 확인한다.<br>
* 매개 변수가 HTML 엘리먼트이면 해당 엘리먼트를 확인한다.<br>
* 매개 변수가 $Element 이면 $Element 객체 내부의 HTML 엘리먼트를 확인한다.
* @return {Boolean} 매개 변수가 같은 HTML 엘리먼트이면 true 를, 그렇지 않으면 false 를 반환한다.
*
* @example
<div id="sample1"><span>Sample</span></div>
<div id="sample2"><span>Sample</span></div>
...
// 같은 HTML 엘리먼트인지 확인
var welSpan1 = $Element("sample1").first(); // <span>Sample</span>
var welSpan2 = $Element("sample2").first(); // <span>Sample</span>
welSpan1.isEqual(welSpan2); // 결과 : false
welSpan1.isEqual(welSpan1); // 결과 : true
*/
jindo.$Element.prototype.isEqual = function(element) {
try {
return (this._element === jindo.$Element(element).$value());
} catch(e) {
return false;
}
};
/**
* HTML 엘리먼트에 이벤트를 발생시킨다.
*
* @param {String} sEvent 실행할 이벤트 이름. on 접두사는 생략한다.
* @param {Object} [oProps] 이벤트 실행 시 사용할 이벤트 객체의 속성을 지정한다.
* @return {$Element} 이벤트가 발생한 HTML 엘리먼트
*
* @since WebKit 계열에서는 이벤트 객체의 keyCode 가 read-only 인 관계로 key 이벤트를 발생시킬 경우 keyCode 값이 설정되지 않는다. 1.4.1 부터 keyCode 값을 설정할 수 있다.
*
* @example
$Element("div").fireEvent("click", {left : true, middle : false, right : false}); // click 이벤트 발생
$Element("div").fireEvent("mouseover", {screenX : 50, screenY : 50, clientX : 50, clientY : 50}); // mouseover 이벤트 발생
$Element("div").fireEvent("keydown", {keyCode : 13, alt : true, shift : false ,meta : false, ctrl : true}); // keydown 이벤트 발생
*/
jindo.$Element.prototype.fireEvent = function(sEvent, oProps) {
function IE(sEvent, oProps) {
sEvent = (sEvent+"").toLowerCase();
var oEvent = document.createEventObject();
if(oProps){
for (k in oProps){
if(oProps.hasOwnProperty(k))
oEvent[k] = oProps[k];
}
oEvent.button = (oProps.left?1:0)+(oProps.middle?4:0)+(oProps.right?2:0);
oEvent.relatedTarget = oProps.relatedElement||null;
}
this._element.fireEvent("on"+sEvent, oEvent);
return this;
};
function DOM2(sEvent, oProps) {
var sType = "HTMLEvents";
sEvent = (sEvent+"").toLowerCase();
if (sEvent == "click" || sEvent.indexOf("mouse") == 0) {
sType = "MouseEvent";
if (sEvent == "mousewheel") sEvent = "dommousescroll";
} else if (sEvent.indexOf("key") == 0) {
sType = "KeyboardEvent";
}
var evt;
if (oProps) {
oProps.button = 0 + (oProps.middle?1:0) + (oProps.right?2:0);
oProps.ctrl = oProps.ctrl||false;
oProps.alt = oProps.alt||false;
oProps.shift = oProps.shift||false;
oProps.meta = oProps.meta||false;
switch (sType) {
case 'MouseEvent':
evt = document.createEvent(sType);
evt.initMouseEvent( sEvent, true, true, null, oProps.detail||0, oProps.screenX||0, oProps.screenY||0, oProps.clientX||0, oProps.clientY||0,
oProps.ctrl, oProps.alt, oProps.shift, oProps.meta, oProps.button, oProps.relatedElement||null);
break;
case 'KeyboardEvent':
if (window.KeyEvent) {
evt = document.createEvent('KeyEvents');
evt.initKeyEvent(sEvent, true, true, window, oProps.ctrl, oProps.alt, oProps.shift, oProps.meta, oProps.keyCode, oProps.keyCode);
} else {
try {
evt = document.createEvent("Events");
} catch (e){
evt = document.createEvent("UIEvents");
} finally {
evt.initEvent(sEvent, true, true);
evt.ctrlKey = oProps.ctrl;
evt.altKey = oProps.alt;
evt.shiftKey = oProps.shift;
evt.metaKey = oProps.meta;
evt.keyCode = oProps.keyCode;
evt.which = oProps.keyCode;
}
}
break;
default:
evt = document.createEvent(sType);
evt.initEvent(sEvent, true, true);
}
}else{
evt = document.createEvent(sType);
evt.initEvent(sEvent, true, true);
}
this._element.dispatchEvent(evt);
return this;
};
jindo.$Element.prototype.fireEvent = (typeof this._element.dispatchEvent != "undefined")?DOM2:IE;
return this.fireEvent(sEvent, oProps);
};
/**
* HTML 엘리먼트의 자식 노드를 모두 제거한다.
*
* @return {$Element} 자식 노드를 모두 제거한 현재의 $Element 객체
*
* @see $Element#leave
* @see $Element#remove
*
* @example
// 자식 노드를 모두 제거
$Element("sample").empty();
//Before
<div id="sample"><span>노드</span> <span>모두</span> 삭제하기 </div>
//After
<div id="sample"></div>
*/
jindo.$Element.prototype.empty = function() {
jindo.$$.release();
this.html("");
return this;
};
/**
* HTML 엘리먼트의 특정 자식 노드를 제거한다. 제거되는 자식 엘리먼트 노드의 이벤트 핸들러도 제거한다.
*
* @param {HTML Element | String | $Element} oChild 제거할 자식 엘리먼트 노드.<br>
* <br>
* 문자열, HTML 엘리먼트, 혹은 $Element 을 매개 변수로 지정할 수 있다.<br>
* <br>
* 매개 변수가 문자열이면 해당 문자열을 id 로 하는 HTML 엘리먼트를 제거한다.<br>
* 매개 변수가 HTML 엘리먼트이면 해당 엘리먼트를 제거한다.<br>
* 매개 변수가 $Element 이면 $Element 객체 내부의 HTML 엘리먼트를 제거한다.
* @return {$Element} 자식 노드를 모두 제거한 현재의 $Element 객체
*
* @see $Element#empty
* @see $Element#leave
*
* @example
// 특정 자식 노드를 제거
$Element("sample").remove("child2");
//Before
<div id="sample"><span id="child1">노드</span> <span id="child2">삭제하기</span></div>
//After
<div id="sample"><span id="child1">노드</span> </div>
*/
jindo.$Element.prototype.remove = function(oChild) {
jindo.$$.release();
jindo.$Element(oChild).leave();
return this;
}
/**
* HTML 엘리먼트를 부모 엘리먼트 노드에서 제거한다.<br>
* HTML 엘러먼트에 등록된 이벤트 핸들러도 제거한다.
*
* @return {$Element} 부모 엘리먼트 노드에서 제거 된 현재의 $Element 객체
*
* @see $Element#empty
* @see $Element#remove
*
* @example
// 부모 엘리먼트 노드에서 제거
$Element("sample").leave();
//Before
<div>
<div id="sample"><span>노드</span> <span>모두</span> 삭제하기 </div>
</div>
//After
// <div id="sample"><span>노드</span> <span>모두</span> 삭제하기 </div>를 래핑한 $Element가 반환된다
<div>
</div>
*/
jindo.$Element.prototype.leave = function() {
var e = this._element;
if (e.parentNode) {
jindo.$$.release();
e.parentNode.removeChild(e);
}
jindo.$Fn.freeElement(this._element);
return this;
};
/**
* HTML 엘리먼트를 다른 HTML 엘리먼트로 감싼다.
*
* @param {String | HTML Element | $Element} wrapper 감쌀 HTML 엘리먼트. 문자열, HTML 엘리먼트, 혹은 $Element 을 매개 변수로 지정할 수 있다.<br>
* <br>
* 매개 변수가 문자열이면 해당 문자열을 id 로 하는 HTML 엘리먼트를 사용한다.<br>
* 매개 변수가 HTML 엘리먼트이면 해당 엘리먼트를 사용한다.<br>
* 매개 변수가 $Element 이면 $Element 객체 내부의 HTML 엘리먼트를 사용한다.
* @return {$Element} 새로운 HTML 엘리먼트로 감싼 $Element 개체
*
* @example
$Element("sample1").wrap("sample2");
//Before
<div id="sample1"><span>Sample</span></div>
<div id="sample2"><span>Sample</span></div>
//After
<div id="sample2"><span>Sample</span><div id="sample1"><span>Sample</span></div></div>
* @example
$Element("box").wrap($('<DIV>'));
//Before
<span id="box"></span>
//After
<div><span id="box"></span></div>
*/
jindo.$Element.prototype.wrap = function(wrapper) {
var e = this._element;
wrapper = jindo.$Element(wrapper).$value();
if (e.parentNode) {
e.parentNode.insertBefore(wrapper, e);
}
wrapper.appendChild(e);
return this;
};
/**
* HTML 엘리먼트의 텍스트 노드가 브라우저에서 한 줄로 보이도록 길이를 조절한다.
*
* @remark 이 메서드는 HTML 엘리먼트가 텍스트 노드만을 포함한다고 가정한다. 따라서, 이 외의 상황에서의 동작은 보장하지 않는다.
* @remark 브라우저에서의 HTML 엘리먼트의 너비를 기준으로 텍스트 노드의 길이를 정하므로 HTML 엘리먼트는 반드시 보이는 상태여야 한다.
* @remark 화면에 전체 텍스트 노드가 보였다가 줄어드는 경우가 있다. 이런 경우, HTML 엘리먼트에서 overflow:hidden 속성을 활용한다.
*
* @param {String} [stringTail] 말줄임 표시자. <br>
* 매개 변수에 지정한 문자열을 텍스트 노드 맨 끝에 붙이고 텍스트 노드의 길이를 조절한다.<br>
* 매개 변수를 생락하면 말줄임표('...')를 사용한다.
*
* @example
$Element("sample_span").ellipsis();
//Before
<div style="width:300px; border:1px solid #CCCCCC; padding:10px">
<span id="sample_span">NHN은 검색과 게임을 양축으로 혁신적이고 편리한 온라인 서비스를 꾸준히 선보이며 디지털 라이프를 선도하고 있습니다.</span>
</div>
//After
<div style="width:300px; border:1px solid #CCCCCC; padding:10px">
<span id="sample_span">NHN은 검색과 게임을 양축으로 혁신적...</span>
</div>
*/
jindo.$Element.prototype.ellipsis = function(stringTail) {
stringTail = stringTail || "...";
var txt = this.text();
var len = txt.length;
var padding = parseInt(this.css("paddingTop"),10) + parseInt(this.css("paddingBottom"),10);
var cur_h = this.height() - padding;
var i = 0;
var h = this.text('A').height() - padding;
if (cur_h < h * 1.5) return this.text(txt);
cur_h = h;
while(cur_h < h * 1.5) {
i += Math.max(Math.ceil((len - i)/2), 1);
cur_h = this.text(txt.substring(0,i)+stringTail).height() - padding;
}
while(cur_h > h * 1.5) {
i--;
cur_h = this.text(txt.substring(0,i)+stringTail).height() - padding;
}
};
/**
* HTML 엘리먼트에서 매개 변수가 몇 번째 자식 엘리먼트 노드인지 확인하여 인덱스를 반환한다.
*
* @param {String | HTML Element | $Element} element 확인할 HTML 엘리먼트. 문자열, HTML 엘리먼트, 혹은 $Element 을 매개 변수로 지정할 수 있다.<br>
* <br>
* 매개 변수가 문자열이면 해당 문자열을 id 로 하는 HTML 엘리먼트를 사용한다.<br>
* 매개 변수가 HTML 엘리먼트이면 해당 엘리먼트를 사용한다.<br>
* 매개 변수가 $Element 이면 $Element 객체 내부의 HTML 엘리먼트를 사용한다.
* @return {Number} 검색 결과 인덱스.<br>
* 인덱스는 0 부터 시작하며, 찾지 못한 경우에는 -1 을 반환한다.
*
* @since 1.2.0
*
* @see $Element#parent
* @see $Element#child
* @see $Element#prev
* @see $Element#next
* @see $Element#first
* @see $Element#last
*
* @example
<div id="sample_div1">
<div id="sample_div">
<div id="sample_div2">
Sample1
</div>
<div id="sample_div3">
<div id="sample_div4">
Sample2
</div>
Sample3
</div>
<div id="sample_div5">
Sample4
<div id="sample_div6">
Sample5
</div>
</div>
</div>
</div>
<script type="text/javascript">
var welSample = $Element("sample_div");
welSample.indexOf($Element("sample_div1")); // 결과 : -1
welSample.indexOf($Element("sample_div2")); // 결과 : 0
welSample.indexOf($Element("sample_div3")); // 결과 : 1
welSample.indexOf($Element("sample_div4")); // 결과 : -1
welSample.indexOf($Element("sample_div5")); // 결과 : 2
welSample.indexOf($Element("sample_div6")); // 결과 : -1
</script>
*/
jindo.$Element.prototype.indexOf = function(element) {
try {
var e = jindo.$Element(element).$value();
var n = this._element.childNodes;
var c = 0;
var l = n.length;
for (var i=0; i < l; i++) {
if (n[i].nodeType != 1) continue;
if (n[i] === e) return c;
c++;
}
}catch(e){}
return -1;
};
/**
* HTML 엘리먼트에서 특정 CSS 셀렉터(selector)를 만족하는 하위 엘리먼트 노드를 찾는다.
*
* @param {String} sSelector CSS 셀렉터
* @return {Array} CSS 셀렉터 조건을 만족하는 HTML 엘리먼트의 배열을 반환한다.<br>
* 만족하는 HTML 엘리먼트가 존재하지 않으면 빈 배열을 반환한다.
*
* @see $Element#query
* @see $Element#queryAll
*
* @example
<div id="sample">
<div></div>
<div class="pink"></div>
<div></div>
<div class="pink"></div>
<div></div>
<div class="blue"></div>
<div class="blue"></div>
</div>
<script type="text/javascript">
$Element("sample").queryAll(".pink");
// <div class="pink"></div>와 <div class="pink"></div>를 원소로 하는 배열을 반환
$Element("sample").queryAll(".green");
// [] 빈 배열을 반환
</script>
*/
jindo.$Element.prototype.queryAll = function(sSelector) {
return jindo.$$(sSelector, this._element);
};
/**
* HTML 엘리먼트에서 특정 CSS 셀렉터(selector)를 만족하는 첫 번째 하위 엘리먼트 노드를 반환한다.
*
* @param {String} sSelector CSS 셀렉터
* @return {HTML Element} CSS 셀렉터 조건을 만족하는 첫 번째 HTML 엘리먼트.<br>
* 만족하는 HTML 엘리먼트가 존재하지 않으면 null 을 반환한다.
*
* @see $Element#test
* @see $Element#queryAll
*
* @example
<div id="sample">
<div></div>
<div class="pink"></div>
<div></div>
<div class="pink"></div>
<div></div>
<div class="blue"></div>
<div class="blue"></div>
</div>
<script type="text/javascript">
$Element("sample").query(".pink");
// 첫 번째 <div class="pink"></div> DIV 엘리먼트를 반환
$Element("sample").query(".green");
// null 을 반환
</script>
*/
jindo.$Element.prototype.query = function(sSelector) {
return jindo.$$.getSingle(sSelector, this._element);
};
/**
* HTML 엘리먼트에서 특정 CSS 셀렉터(selector)를 만족하는지 확인한다.
*
* @param {String} sSelector CSS 셀렉터
* @return {Boolean} CSS 셀렉터 조건을 만족하는지 확인하여 true/false 로 반환한다.
*
* @see $Element#query
* @see $Element#queryAll
*
* @example
<div id="sample" class="blue"></div>
<script type="text/javascript">
$Element("sample").test(".blue"); // 결과 : true
$Element("sample").test(".red"); // 결과 : false
</script>
*/
jindo.$Element.prototype.test = function(sSelector) {
return jindo.$$.test(this._element, sSelector);
};
/**
* HTML 엘리먼트를 기준으로 XPath 문법을 사용하여 해당하는 HTML 엘리먼트를 가져온다.
*
* @remark 지원하는 문법이 무척 제한적으로 특수한 경우에서만 사용하는 것을 권장한다.
*
* @param {String} sXPath XPath 문법
* @return {Array} XPath 에 해당하는 HTML 엘리먼트를 원소로 하는 배열을 반환한다.
*
* @example
<div id="sample">
<div>
<div>1</div>
<div>2</div>
<div>3</div>
<div>4</div>
<div>5</div>
<div>6</div>
</div>
</div>
<script type="text/javascript">
$Element("sample").xpathAll("div/div[5]");
// <div>5</div> 엘리먼트를 원소로 하는 배열이 반환 됨
</script>
*/
jindo.$Element.prototype.xpathAll = function(sXPath) {
return jindo.$$.xpath(sXPath, this._element);
};
/**
* insertAdjacentHTML 함수. 직접사용하지 못함.
* @ignore
*/
jindo.$Element.insertAdjacentHTML = function(ins,html,insertType,type,fn){
var _ele = ins._element;
if( _ele.insertAdjacentHTML && !(/^<(option|tr|td|th|col)(?:.*?)>/.test(html.replace(/^(\s| )+|(\s| )+$/g, "").toLowerCase()))){
_ele.insertAdjacentHTML(insertType, html);
}else{
var oDoc = _ele.ownerDocument || _ele.document || document;
var fragment = oDoc.createDocumentFragment();
var defaultElement;
var sTag = html.replace(/^(\s| )+|(\s| )+$/g, "");
var oParentTag = {
"option" : "select",
"tr" : "tbody",
"thead" : "table",
"tbody" : "table",
"col" : "table",
"td" : "tr",
"th" : "tr",
"div" : "div"
}
var aMatch = /^\<(option|tr|thead|tbody|td|th|col)(?:.*?)\>/i.exec(sTag);
var sChild = aMatch === null ? "div" : aMatch[1].toLowerCase();
var sParent = oParentTag[sChild] ;
defaultElement = jindo._createEle(sParent,sTag,oDoc,true);
var scripts = defaultElement.getElementsByTagName("script");
for ( var i = 0, l = scripts.length; i < l; i++ ){
scripts[i].parentNode.removeChild( scripts[i] );
}
while ( defaultElement[ type ]){
fragment.appendChild( defaultElement[ type ] );
}
fn(fragment.cloneNode(true));
}
return ins;
}
/**
* HTML 엘리먼트 내부 HTML 의 가장 뒤에 HTML 을 덧붙인다.
*
* @param {String} sHTML 덧붙일 HTML 문자열
* @return {$Element} 1.4.8부터 내부 HTML 을 변경한 현재의 $Element 객체를 반환한다.
* @since 1.4.6 부터 사용 가능.
* @since 1.4.8 부터 $Element 객체를 반환한다.
* @see $Element#prependHTML
* @see $Element#beforeHTML
* @see $Element#afterHTML
*
* @example
// 내부 HTML 가장 뒤에 덧붙이기
$Element("sample_ul").appendHTML("<li>3</li><li>4</li>");
//Before
<ul id="sample_ul">
<li>1</li>
<li>2</li>
</ul>
//After
<ul id="sample_ul">
<li>1</li>
<li>2</li>
<li>3</li>
<li>4</li>
</ul>
*/
jindo.$Element.prototype.appendHTML = function(sHTML) {
return jindo.$Element.insertAdjacentHTML(this,sHTML,"beforeEnd","firstChild",jindo.$Fn(function(oEle){
this.append(oEle);
},this).bind());
};
/**
* HTML 엘리먼트 내부 HTML 의 가장 앞에 HTML 을 삽입한다.
*
* @param {String} sHTML 삽입할 HTML 문자열
* @return {$Element} 1.4.8부터 내부 HTML 을 변경한 현재의 $Element 객체를 반환한다.
* @since 1.4.6부터 사용 가능.
* @see $Element#appendHTML
* @see $Element#beforeHTML
* @see $Element#afterHTML
*
* @example
// 내부 HTML 가장 앞에 삽입
$Element("sample_ul").prependHTML("<li>3</li><li>4</li>");
//Before
<ul id="sample_ul">
<li>1</li>
<li>2</li>
</ul>
//After
<ul id="sample_ul">
<li>4</li>
<li>3</li>
<li>1</li>
<li>2</li>
</ul>
*/
jindo.$Element.prototype.prependHTML = function(sHTML) {
return jindo.$Element.insertAdjacentHTML(this,sHTML,"afterBegin","lastChild",jindo.$Fn(function(oEle){
this.prepend(oEle);
},this).bind());
};
/**
* HTML 엘리먼트 앞에 HTML 을 삽입한다.
*
* @param {String} sHTML 삽입할 HTML 문자열
* @return {$Element} 1.4.8부터 현재의 $Element 객체를 반환한다.
* @since 1.4.6부터 사용 가능.
* @see $Element#appendHTML
* @see $Element#prependHTML
* @see $Element#afterHTML
*
* @example
var welSample = $Element("sample_ul");
welSample.beforeHTML("<ul><li>3</li><li>4</li></ul>");
welSample.beforeHTML("<ul><li>5</li><li>6</li></ul>");
//Before
<ul id="sample_ul">
<li>1</li>
<li>2</li>
</ul>
//After
<ul>
<li>3</li>
<li>4</li>
</ul>
<ul>
<li>5</li>
<li>6</li>
</ul>
<ul id="sample_ul">
<li>1</li>
<li>2</li>
</ul>
*/
jindo.$Element.prototype.beforeHTML = function(sHTML) {
return jindo.$Element.insertAdjacentHTML(this,sHTML,"beforeBegin","firstChild",jindo.$Fn(function(oEle){
this.before(oEle);
},this).bind());
};
/**
* HTML 엘리먼트 뒤에 HTML 을 덧붙인다.
* @param {String} sHTML 덧붙일 HTML 문자열
* @returns {$Element} 1.4.8부터 현재의 $Element 객체를 반환한다.
* @since 1.4.6부터 사용 가능.
* @see $Element#appendHTML
* @see $Element#prependHTML
* @see $Element#beforeHTML
* @example
var welSample = $Element("sample_ul");
welSample.beforeHTML("<ul><li>3</li><li>4</li></ul>");
welSample.beforeHTML("<ul><li>5</li><li>6</li></ul>");
//Before
<ul id="sample_ul">
<li>1</li>
<li>2</li>
</ul>
//After
<ul id="sample_ul">
<li>1</li>
<li>2</li>
</ul>
<ul>
<li>5</li>
<li>6</li>
</ul>
<ul>
<li>3</li>
<li>4</li>
</ul>
*/
jindo.$Element.prototype.afterHTML = function(sHTML) {
return jindo.$Element.insertAdjacentHTML(this,sHTML,"afterEnd","lastChild",jindo.$Fn(function(oEle){
this._element.parentNode.insertBefore( oEle, this._element.nextSibling );
},this).bind());
};
/**
* 이벤트 델리게이션으로 이벤트를 처리한다.<br>
* 이벤트 델리게이션이란 이벤트 버블링을 이용하여 효율적으로 이벤트를 관리하는 방법이다.<br>
* 자세한 내용은 아래의 URL을 참고한다.<br>
* <br>
*
* <ul>
* <li><a href="http://devcode.nhncorp.com/projects/jindo/wiki/EventDelegate" target="_blank">Event Delegate 란?</a></li>
* <ul>
*
* @param {String} sEvent 이벤트 이름. on 접두사는 생략한다.<br>
* domready, mousewheel, mouseenter, mouseleave 은 지원하지 않는다.<br>
*
* @param {String | Function} vFilter 원하는 HTML 엘리먼트에 대해서만 이벤트를 실행하도록 하기 위한 필터이다.<br>
* <br>
* 필터에는 CSS 셀렉터와 함수의 두 가지 타입이 있다.<br>
* <br>
* 필터를 CSS 셀렉터를 사용하려면 문자열을 매개 변수로 지정한다.<br>
* <br>
* 필터를 함수로 사용하려면 Boolean 을 반환하는 함수를 매개 변수로 지정한다.<br>
* 필터 함수의 첫 번째 매개 변수는 HTML 엘리먼트 자신이고, 두 번째 매개 변수는 이벤트가 발생한 HTML 엘리먼트이다.
*
* @param {Function} fpCallback 필터에서 true 가 반환된 경우 실행되는 콜백 함수이다.<br>
* 매개 변수로 이벤트 객체가 지정된다.
*
* @return {$Element} $Element 객체를 리턴한다.
* @since 1.4.6부터 사용 가능.
* @see $Element#undelegate
*
* @example
<ul id="parent">
<li class="odd">1</li>
<li>2</li>
<li class="odd">3</li>
<li>4</li>
</ul>
// CSS 셀렉터를 필터로 사용하는 경우
$Element("parent").delegate("click",
".odd", // 필터
function(eEvent){ // 콜백 함수
alert("odd 클래스를 가진 li가 클릭 될 때 실행");
});
* @example
<ul id="parent">
<li class="odd">1</li>
<li>2</li>
<li class="odd">3</li>
<li>4</li>
</ul>
// 함수를 필터로 사용하는 경우
$Element("parent").delegate("click",
function(oEle,oClickEle){ // 필터
return oClickEle.innerHTML == "2"
},
function(eEvent){ // 콜백 함수
alert("클릭한 엘리먼트의 innerHTML이 2인 경우에 실행");
});
*/
jindo.$Element.prototype.delegate = function(sEvent , vFilter , fpCallback){
if(!this._element["_delegate_"+sEvent]){
this._element["_delegate_"+sEvent] = {};
var fAroundFunc = jindo.$Fn(function(sEvent,wEvent){
wEvent = wEvent || window.event;
if (typeof wEvent.currentTarget == "undefined") {
wEvent.currentTarget = this._element;
}
var oEle = wEvent.target || wEvent.srcElement;
var aData = this._element["_delegate_"+sEvent];
var data,func,event,resultFilter;
for(var i in aData){
data = aData[i];
resultFilter = data.checker(oEle);
if(resultFilter[0]){
func = data.func;
event = jindo.$Event(wEvent);
event.element = resultFilter[1];
for(var j = 0, l = func.length ; j < l ;j++){
func[j](event);
}
}
}
},this).bind(sEvent);
jindo.$Element._eventBind(this._element,sEvent,fAroundFunc);
var oEle = this._element;
oEle["_delegate_"+sEvent+"_func"] = fAroundFunc;
if (this._element["_delegate_events"]) {
this._element["_delegate_events"].push(sEvent);
}else{
this._element["_delegate_events"] = [sEvent];
}
oEle = null;
}
this._bind(sEvent,vFilter,fpCallback);
return this;
}
/**
* 이벤트를 바인딩 하는 함수.
* @param {Element} oEle 엘리먼트
* @param {Boolean} sEvent 이벤트 타입.
* @param {Function} fAroundFunc 바인딩할 함수
* @ignore.
*/
jindo.$Element._eventBind = function(oEle,sEvent,fAroundFunc){
if(oEle.addEventListener){
jindo.$Element._eventBind = function(oEle,sEvent,fAroundFunc){
oEle.addEventListener(sEvent,fAroundFunc,false);
}
}else{
jindo.$Element._eventBind = function(oEle,sEvent,fAroundFunc){
oEle.attachEvent("on"+sEvent,fAroundFunc);
}
}
jindo.$Element._eventBind(oEle,sEvent,fAroundFunc);
}
/**
* HTML 엘리먼트에 등록된 이벤트 델리게이션을 해제한다.
*
* @param {String} sEvent 이벤드 델리게이션 등록 시 사용한 이벤트 이름. on 접두사는 생략한다.
* @param {String|Function} vFilter 이벤트 델리게이션 등록 시 사용한 필터.
* @param {Function} fpCallback 이벤트 델리게이션 등록 시 사용한 콜백 함수.
* @return {$Element} $Element 객체를 리턴한다.
* @since 1.4.6부터 사용 가능.
* @see $Element#delegate
*
* @example
<ul id="parent">
<li class="odd">1</li>
<li>2</li>
<li class="odd">3</li>
<li>4</li>
</ul>
// 콜백 함수
var fnOddClass = function(eEvent){
alert("odd 클래스를 가진 li가 클릭 될 때 실행");
};
$Element("parent").delegate("click", ".odd", fnOddClass); // 이벤트 델리게이션 사용
$Element("parent").undelegate("click", ".odd", fnOddClass); // 이벤트 해제
*/
jindo.$Element.prototype.undelegate = function(sEvent, vFilter, fpCallback){
this._unbind(sEvent,vFilter,fpCallback);
return this;
}
/**
* 딜리게이션으로 실행되어야 할 함수를 추가 하는 함수.
* @param {String} sEvent 이벤트 타입.
* @param {String|Function} vFilter cssquery,function 이렇게 2가지 타입이 들어옴.
* @param {Function} fpCallback 해당 cChecker에 들어오는 함수가 맞을때 실행되는 함수.
* @returns {$Element} $Element 객체.
* @since 1.4.6부터 사용가능.
* @ignore
*/
jindo.$Element.prototype._bind = function(sEvent,vFilter,fpCallback){
var _aDataOfEvent = this._element["_delegate_"+sEvent];
if(_aDataOfEvent){
var fpCheck;
if(typeof vFilter == "string"){
fpCheck = jindo.$Fn(function(sCssquery,oEle){
var eIncludeEle = oEle;
var isIncludeEle = jindo.$$.test(oEle, sCssquery);
if(!isIncludeEle){
var aPropagationElements = this._getParent(oEle);
for(var i = 0, leng = aPropagationElements.length ; i < leng ; i++){
eIncludeEle = aPropagationElements[i];
if(jindo.$$.test(eIncludeEle, sCssquery)){
isIncludeEle = true;
break;
}
}
}
return [isIncludeEle,eIncludeEle];
},this).bind(vFilter);
}else if(typeof vFilter == "function"){
fpCheck = jindo.$Fn(function(fpFilter,oEle){
var eIncludeEle = oEle;
var isIncludeEle = fpFilter(this._element,oEle);
if(!isIncludeEle){
var aPropagationElements = this._getParent(oEle);
for(var i = 0, leng = aPropagationElements.length ; i < leng ; i++){
eIncludeEle = aPropagationElements[i];
if(fpFilter(this._element,eIncludeEle)){
isIncludeEle = true;
break;
}
}
}
return [isIncludeEle,eIncludeEle];
},this).bind(vFilter);
}
this._element["_delegate_"+sEvent] = jindo.$Element._addBind(_aDataOfEvent,vFilter,fpCallback,fpCheck);
}else{
alert("check your delegate event.");
}
}
/**
* 파라메터로 들어오는 엘리먼트 부터 자신의 엘리먼트 까지의 엘리먼트를 구하는 함수.
* @param {Element} 엘리먼트.
* @returns {Array} 배열 객체.
* @ignore
*/
jindo.$Element.prototype._getParent = function(oEle) {
var e = this._element;
var a = [], p = null;
while (oEle.parentNode && p != e) {
p = oEle.parentNode;
if (p == document.documentElement) break;
a[a.length] = p;
oEle = p;
}
return a;
};
/**
* 엘리먼트에 이벤트를 추가하는 함수.
* @param {Object} aDataOfEvent 이벤트와 함수를 가지고 있는 오브젝트.
* @param {String|Function} vFilter cssquery,check하는 함수.
* @param {Function} fpCallback 실행될 함수.
* @param {Function} fpCheck 체크하는 함수.
* @retruns {Object} aDataOfEvent를 반환.
* @ignore
*/
jindo.$Element._addBind = function(aDataOfEvent,vFilter,fpCallback,fpCheck){
var aEvent = aDataOfEvent[vFilter];
if(aEvent){
var fpFuncs = aEvent.func;
fpFuncs.push(fpCallback);
aEvent.func = fpFuncs;
}else{
aEvent = {
checker : fpCheck,
func : [fpCallback]
};
}
aDataOfEvent[vFilter] = aEvent
return aDataOfEvent;
}
/**
* 딜리게이션에서 해제되어야 할 함수를 삭제하는 함수.
* @param {String} sEvent 이벤트 타입.
* @param {String|Function} vFilter cssquery,function 이렇게 2가지 타입이 들어옴.
* @param {Function} fpCallback 해당 cChecker에 들어오는 함수가 맞을때 실행되는 함수.
* @returns {$Element} $Element 객체.
* @since 1.4.6부터 사용가능.
* @ignore
*/
jindo.$Element.prototype._unbind = function(sEvent, vFilter,fpCallback){
var oEle = this._element;
if (sEvent&&vFilter&&fpCallback) {
var oEventInfo = oEle["_delegate_"+sEvent];
if(oEventInfo&&oEventInfo[vFilter]){
var fpFuncs = oEventInfo[vFilter].func;
fpFuncs = oEventInfo[vFilter].func = jindo.$A(fpFuncs).refuse(fpCallback).$value();
if (!fpFuncs.length) {
jindo.$Element._deleteFilter(oEle,sEvent,vFilter);
}
}
}else if (sEvent&&vFilter) {
jindo.$Element._deleteFilter(oEle,sEvent,vFilter);
}else if (sEvent) {
jindo.$Element._deleteEvent(oEle,sEvent,vFilter);
}else{
var aEvents = oEle['_delegate_events'];
var sEachEvent;
for(var i = 0 , l = aEvents.length ; i < l ; i++){
sEachEvent = aEvents[i];
jindo.$Element._unEventBind(oEle,sEachEvent,oEle["_delegate_"+sEachEvent+"_func"]);
jindo.$Element._delDelegateInfo(oEle,"_delegate_"+sEachEvent);
jindo.$Element._delDelegateInfo(oEle,"_delegate_"+sEachEvent+"_func");
}
jindo.$Element._delDelegateInfo(oEle,"_delegate_events");
}
return this;
}
/**
* 오브젝트에 키값으로 정보삭제하는 함수
* @param {Object} 삭제할 오브젝트.
* @param {String|Function} sType 키값이 들어옴.
* @returns {Object} 삭제된 오브젝트.
* @since 1.4.6부터 사용가능.
* @ignore
*/
jindo.$Element._delDelegateInfo = function(oObj , sType){
try{
oObj[sType] = null;
delete oObj[sType];
}catch(e){}
return oObj
}
/**
* 플터 기준으로 삭제하는 함수.
* @param {Element} 삭제할 엘리먼트.
* @param {String} 이벤트명.
* @param {String|Function} cssquery, 필터하는 함수.
* @since 1.4.6부터 사용가능.
* @ignore
*/
jindo.$Element._deleteFilter = function(oEle,sEvent,vFilter){
var oEventInfo = oEle["_delegate_"+sEvent];
if(oEventInfo&&oEventInfo[vFilter]){
if (jindo.$H(oEventInfo).keys().length == 1) {
jindo.$Element._deleteEvent(oEle,sEvent,vFilter);
}else{
jindo.$Element._delDelegateInfo(oEventInfo,vFilter);
}
}
}
/**
* event 기준으로 삭제하는 함수.
* @param {Element} 삭제할 엘리먼트.
* @param {String} 이벤트명.
* @param {String|Function} cssquery, 필터하는 함수.
* @since 1.4.6부터 사용가능.
* @ignore
*/
jindo.$Element._deleteEvent = function(oEle,sEvent,vFilter){
var aEvents = oEle['_delegate_events'];
jindo.$Element._unEventBind(oEle,sEvent,oEle["_delegate_"+sEvent+"_func"]);
jindo.$Element._delDelegateInfo(oEle,"_delegate_"+sEvent);
jindo.$Element._delDelegateInfo(oEle,"_delegate_"+sEvent+"_func");
aEvents = jindo.$A(aEvents).refuse(sEvent).$value();
if (!aEvents.length) {
jindo.$Element._delDelegateInfo(oEle,"_delegate_events");
}else{
oEle['_delegate_events'] = jindo.$A(aEvents).refuse(sEvent).$value();
}
}
/**
* 이벤트를 해제 하는 함수.
* @param {Element} oEle 엘리먼트
* @param {Boolean} sType 이벤트 타입.
* @param {Function} fAroundFunc 바인딩을 해제할 함수.
* @ignore
*/
jindo.$Element._unEventBind = function(oEle,sType,fAroundFunc){
if(oEle.removeEventListener){
jindo.$Element._unEventBind = function(oEle,sType,fAroundFunc){
oEle.removeEventListener(sType,fAroundFunc,false);
}
}else{
jindo.$Element._unEventBind = function(oEle,sType,fAroundFunc){
oEle.detachEvent("on"+sType,fAroundFunc);
}
}
jindo.$Element._unEventBind(oEle,sType,fAroundFunc);
}
/**
* @fileOverview $Fn의 생성자 및 메서드를 정의한 파일
* @name function.js
*/
/**
* $Fn 객체를 리턴한다.
* @extends core
* @class $Fn 클래스는 자바스크립트 Function 객체의 래퍼(Wrapper) 클래스이다.
* @constructor
* @param {Function | String} func
* <br>
* Function 객체 혹은 함수의 매개변수를 나타내는 문자열
* @param {Object | String} thisObject
* <br>
* 함수가 특정 객체의 메서드일 때, 해당 객체도 같이 전달한다. 혹은 함수의 몸체를 나타내는 문자열.
* @return {$Fn} $Fn 객체
* @see $Fn#toFunction
* @description [Lite]
* @example
func : function() {
// code here
}
var fn = $Fn(func, this);
* @example
var someObject = {
func : function() {
// code here
}
}
var fn = $Fn(someObject.func, someObject);
* @example
var fn = $Fn("a, b", "return a + b;");
var result = fn.$value()(1, 2) // result = 3;
// fn은 함수 리터럴인 function(a, b){ return a + b;}와 동일한 함수를 래핑한다.
* @author Kim, Taegon
*/
jindo.$Fn = function(func, thisObject) {
var cl = arguments.callee;
if (func instanceof cl) return func;
if (!(this instanceof cl)) return new cl(func, thisObject);
this._events = [];
this._tmpElm = null;
this._key = null;
if (typeof func == "function") {
this._func = func;
this._this = thisObject;
} else if (typeof func == "string" && typeof thisObject == "string") {
//this._func = new Function(func, thisObject);
this._func = eval("false||function("+func+"){"+thisObject+"}")
}
}
/**
* userAgent cache
* @ignore
*/
var _ua = navigator.userAgent;
/**
* $value 메서드는 원래의 Function 객체를 리턴한다.
* @return {Function} 함수 객체
* @description [Lite]
* @example
func : function() {
// code here
}
var fn = $Fn(func, this);
fn.$value(); // 원래의 함수가 리턴된다.
*/
jindo.$Fn.prototype.$value = function() {
return this._func;
};
/**
* bind 메서드는 함수가 객체의 메소드로 동작하도록 묶인 Function 객체를 리턴한다.
* @return {Function} thisObject의 메소드로 묶인 Function 객체
* @description [Lite]
* @example
var sName = "OUT";
var oThis = {
sName : "IN"
};
function getName() {
return this.sName;
}
oThis.getName = $Fn(getName, oThis).bind();
alert( getName() ); // OUT
alert( oThis.getName() ); // IN
* @example
// 함수를 미리 선언하고 나중에 사용할 때,
// 함수에서 참조 하는 값들은 해당 함수를 생성 할때의 값이 아니라 함수 실행 시점의 값이 사용 되므로 이때 bind를 이용한다.
for(var i=0; i<2;i++){
aTmp[i] = function(){alert(i);}
}
for(var n=0; n<2;n++){
aTmp[n](); // 숫자 2만 두번 alert된다.
}
for(var i=0; i<2;i++){
aTmp[i] = $Fn(function(nTest){alert(nTest);}, this).bind(i);
}
for(var n=0; n<2;n++){
aTmp[n](); // 숫자 0, 1이 alert된다.
}
* @example
//클래스 생성 시 함수를 매개변수로 할 때, scope를 맞춰주기 위해 bind를 사용한다.
var MyClass = $Class({
fFunc : null,
$init : function(func){
this.fFunc = func;
this.testFunc();
},
testFunc : function(){
this.fFunc();
}
})
var MainClass = $Class({
$init : function(){
var oMyClass1 = new MyClass(this.func1);
var oMyClass2 = new MyClass($Fn(this.func2, this).bind());
},
func1 : function(){
alert(this);// this는 MyClass 를 의미한다.
},
func2 : function(){
alert(this);// this는 MainClass 를 의미한다.
}
})
function init(){
var a = new MainClass();
}
*/
jindo.$Fn.prototype.bind = function() {
var a = jindo.$A(arguments).$value();
var f = this._func;
var t = this._this;
var b = function() {
var args = jindo.$A(arguments).$value();
// fix opera concat bug
if (a.length) args = a.concat(args);
return f.apply(t, args);
};
return b;
};
/**
* bingForEvent는 객체와 메서드를 묶어 하나의 이벤트 핸들러 Function으로 반환한다.
* @param {Element, ...} [elementN] 이벤트 객체와 함께 전달할 값
* @see $Fn#bind
* @see $Event
* @description [Lite]
* @ignore
*/
jindo.$Fn.prototype.bindForEvent = function() {
var a = arguments;
var f = this._func;
var t = this._this;
var m = this._tmpElm || null;
var b = function(e) {
var args = Array.prototype.slice.apply(a);
if (typeof e == "undefined") e = window.event;
if (typeof e.currentTarget == "undefined") {
e.currentTarget = m;
}
var oEvent = jindo.$Event(e);
args.unshift(oEvent);
var returnValue = f.apply(t, args);
if(typeof returnValue != "undefined" && oEvent.type=="beforeunload"){
e.returnValue = returnValue;
}
return returnValue;
};
return b;
};
/**
* attach 메서드는 함수를 특정 엘리먼트의 이벤트 핸들러로 할당한다.<br>
* 함수의 반환 값이 false인 경우, $Fn에 바인딩하여 사용했을 시 IE에서 기본 기능을 막기 때문에 사용하지 않도록 주의한다.
<ul>
<li>이벤트 이름에는 on 접두어를 사용하지 않는다.</li>
<li>마우스 휠 스크롤 이벤트는 mousewheel 로 사용한다.</li>
<li>기본 이벤트 외에 추가로 사용이 가능한 이벤트에는 domready, mouseenter, mouseleave, mousewheel이 있다.</li>
</ul>
* @param {Element | Array} oElement 이벤트 핸들러를 할당할 엘리먼트(엘리먼트가 원소인 배열도 가능)
* @param {String} sEvent 이벤트 종류
* @param {Boolean} bUseCapture capturing을 사용할 때(1.4.2 부터 지원)
* @see $Fn#detach
* @description [Lite]
* @return {$Fn} 생성된 $Fn 객체
* @example
var someObject = {
func : function() {
// code here
}
}
$Fn(someObject.func, someObject).attach($("test"),"click"); // 단일 엘리먼트에 클릭을 할당한 경우
$Fn(someObject.func, someObject).attach($$(".test"),"click"); // 여러 엘리먼트에 클릭을 할당한 경우
//attach에 첫번째 인자로 엘리먼트 배열이 들어오면 해당 모든 엘리먼트에 이벤트가 바인딩 됨.
*/
jindo.$Fn.prototype.attach = function(oElement, sEvent, bUseCapture) {
var fn = null, l, ev = sEvent, el = oElement, ua = _ua;
if (typeof bUseCapture == "undefined") {
bUseCapture = false;
};
this._bUseCapture = bUseCapture;
if ((el instanceof Array) || (jindo.$A && (el instanceof jindo.$A) && (el=el.$value()))) {
for(var i=0; i < el.length; i++) this.attach(el[i], ev, bUseCapture);
return this;
}
if (!el || !ev) return this;
if (typeof el.$value == "function") el = el.$value();
el = jindo.$(el);
ev = ev.toLowerCase();
this._tmpElm = el;
fn = this.bindForEvent();
this._tmpElm = null;
var bIsIE = ua.indexOf("MSIE") > -1;
if (typeof el.addEventListener != "undefined") {
if (ev == "domready") {
ev = "DOMContentLoaded";
}else if (ev == "mousewheel" && ua.indexOf("WebKit") < 0 && !/Opera/.test(ua) && !bIsIE) {
/*
IE9인 경우도 DOMMouseScroll이 동작하지 않음.
*/
ev = "DOMMouseScroll";
}else if (ev == "mouseenter" && !bIsIE){
ev = "mouseover";
fn = jindo.$Fn._fireWhenElementBoundary(el, fn);
}else if (ev == "mouseleave" && !bIsIE){
ev = "mouseout";
fn = jindo.$Fn._fireWhenElementBoundary(el, fn);
}else if(ev == "transitionend"||ev == "transitionstart"){
var sPrefix, sPostfix = ev.replace("transition","");
sPostfix = sPostfix.substr(0,1).toUpperCase() + sPostfix.substr(1);
if(typeof document.body.style.WebkitTransition !== "undefined"){
sPrefix = "webkit";
}else if(typeof document.body.style.OTransition !== "undefined"){
sPrefix = "o";
}else if(typeof document.body.style.MsTransition !== "undefined"){
sPrefix = "ms";
}
ev = (sPrefix?sPrefix+"Transition":"transition")+sPostfix;
this._for_test_attach = ev;
this._for_test_detach = "";
}else if(ev == "animationstart"||ev == "animationend"||ev == "animationiteration"){
var sPrefix, sPostfix = ev.replace("animation","");
sPostfix = sPostfix.substr(0,1).toUpperCase() + sPostfix.substr(1);
if(typeof document.body.style.WebkitAnimationName !== "undefined"){
sPrefix = "webkit";
}else if(typeof document.body.style.OAnimationName !== "undefined"){
sPrefix = "o";
}else if(typeof document.body.style.MsTransitionName !== "undefined"){
sPrefix = "ms";
}
ev = (sPrefix?sPrefix+"Animation":"animation")+sPostfix;
this._for_test_attach = ev;
this._for_test_detach = "";
}
el.addEventListener(ev, fn, bUseCapture);
} else if (typeof el.attachEvent != "undefined") {
if (ev == "domready") {
/*
iframe안에서 domready이벤트가 실행되지 않기 때문에 error를 던짐.
*/
if(window.top != window) throw new Error("Domready Event doesn't work in the iframe.");
jindo.$Fn._domready(el, fn);
return this;
} else {
el.attachEvent("on"+ev, fn);
}
}
if (!this._key) {
this._key = "$"+jindo.$Fn.gc.count++;
jindo.$Fn.gc.pool[this._key] = this;
}
this._events[this._events.length] = {element:el, event:sEvent.toLowerCase(), func:fn};
return this;
};
/**
* detach 메서드는 엘리먼트의 이벤트 핸들러로 할당된 함수를 해제한다.
* @remark 이벤트 이름에는 on 접두어를 사용하지 않는다.
* @remark 마우스 휠 스크롤 이벤트는 mousewheel 로 사용한다.
* @param {Element} oElement 이벤트 핸들러를 해제할 엘리먼트
* @param {String} sEvent 이벤트 종류
* @see $Fn#attach
* @description [Lite]
* @return {$Fn} 생성된 $Fn 객체
* @example
var someObject = {
func : function() {
// code here
}
}
$Fn(someObject.func, someObject).detach($("test"),"click"); // 단일 엘리먼트에 클릭을 할당한 경우
$Fn(someObject.func, someObject).detach($$(".test"),"click"); // 여러 엘리먼트에 클릭을 할당한 경우
*/
jindo.$Fn.prototype.detach = function(oElement, sEvent) {
var fn = null, l, el = oElement, ev = sEvent, ua = _ua;
if ((el instanceof Array) || (jindo.$A && (el instanceof jindo.$A) && (el=el.$value()))) {
for(var i=0; i < el.length; i++) this.detach(el[i], ev);
return this;
}
if (!el || !ev) return this;
if (jindo.$Element && el instanceof jindo.$Element) el = el.$value();
el = jindo.$(el);
ev = ev.toLowerCase();
var e = this._events;
for(var i=0; i < e.length; i++) {
if (e[i].element !== el || e[i].event !== ev) continue;
fn = e[i].func;
this._events = jindo.$A(this._events).refuse(e[i]).$value();
break;
}
if (typeof el.removeEventListener != "undefined") {
if (ev == "domready") {
ev = "DOMContentLoaded";
}else if (ev == "mousewheel" && ua.indexOf("WebKit") < 0) {
ev = "DOMMouseScroll";
}else if (ev == "mouseenter"){
ev = "mouseover";
}else if (ev == "mouseleave"){
ev = "mouseout";
}else if(ev == "transitionend"||ev == "transitionstart"){
var sPrefix, sPostfix = ev.replace("transition","");
sPostfix = sPostfix.substr(0,1).toUpperCase() + sPostfix.substr(1);
if(typeof document.body.style.WebkitTransition !== "undefined"){
sPrefix = "webkit";
}else if(typeof document.body.style.OTransition !== "undefined"){
sPrefix = "o";
}else if(typeof document.body.style.MsTransition !== "undefined"){
sPrefix = "ms";
}
ev = (sPrefix?sPrefix+"Transition":"transition")+sPostfix;
this._for_test_detach = ev;
this._for_test_attach = "";
}else if(ev == "animationstart"||ev == "animationend"||ev == "animationiteration"){
var sPrefix, sPostfix = ev.replace("animation","");
sPostfix = sPostfix.substr(0,1).toUpperCase() + sPostfix.substr(1);
if(typeof document.body.style.WebkitAnimationName !== "undefined"){
sPrefix = "webkit";
}else if(typeof document.body.style.OAnimationName !== "undefined"){
sPrefix = "o";
}else if(typeof document.body.style.MsTransitionName !== "undefined"){
sPrefix = "ms";
}
ev = (sPrefix?sPrefix+"Animation":"animation")+sPostfix;
this._for_test_detach = ev;
this._for_test_attach = "";
}
if (fn) el.removeEventListener(ev, fn, false);
} else if (typeof el.detachEvent != "undefined") {
if (ev == "domready") {
jindo.$Fn._domready.list = jindo.$Fn._domready.list.refuse(fn);
return this;
} else {
el.detachEvent("on"+ev, fn);
}
}
return this;
};
/**
* delay 메서드는 래핑한 함수를 지정한 시간 이후에 호출한다.
* @param {Number} nSec 함수를 호출할 때까지 대기할 시간(초 단위).
* @param {Array} args 함수를 호출할 때 사용할 매개변수. 매개변수가 여러 개일 경우 배열을 사용한다.
* @see $Fn#bind
* @see $Fn#setInterval
* @description [Lite]
* @return {$Fn} 생성된 $Fn 객체
* @example
function func(a, b) {
alert(a + b);
}
$Fn(func).delay(5, [3, 5]);//5초 이후에 3, 5 값을 매개변수로 하는 함수 func를 호출한다.
*/
jindo.$Fn.prototype.delay = function(nSec, args) {
if (typeof args == "undefined") args = [];
this._delayKey = setTimeout(this.bind.apply(this, args), nSec*1000);
return this;
};
/**
* setInterval 메서드는 래핑한 함수를 지정한 시간 간격마다 호출한다.
* @param {Number} nSec 함수를 호출할 간격(초 단위).
* @param {Array} args 함수를 호출할 때 사용할 매개변수. 매개변수가 여러 개일 경우 배열을 사용한다.
* @return {Number} Interval ID, 함수 호출을 해제할 때 사용한다.
* @see $Fn#bind
* @see $Fn#delay
* @description [Lite]
* @example
function func(a, b) {
alert(a + b);
}
$Fn(func).setInterval(5, [3, 5]);//5초 간격으로 3, 5 값을 매개변수로 하는 함수 func를 호출한다.
*/
jindo.$Fn.prototype.setInterval = function(nSec, args) {
if (typeof args == "undefined") args = [];
this._repeatKey = setInterval(this.bind.apply(this, args), nSec*1000);
return this._repeatKey;
};
/**
* repeat 메서드는 setInterval와 같다.
* @param {Number} nSec 함수를 호출간 간격.
* @param {Array} args 함수를 호출할 때 사용할 매개변수. 매개변수가 여러 개일 경우 배열을 사용한다.
* @return {Number} Interval ID, 함수 호출을 해제할 때 사용한다.
* @see $Fn#bind
* @see $Fn#delay
* @description [Lite]
* @example
function func(a, b) {
alert(a + b);
}
$Fn(func).repeat(5, [3, 5]);//5초 간격으로 3, 5 값을 매개변수로 하는 함수 func를 호출한다.
*/
jindo.$Fn.prototype.repeat = jindo.$Fn.prototype.setInterval;
/**
* stopDelay는 delay 메서드로 지정한 함수 호출을 멈출 때 사용한다.
* @return {$Fn} $Fn 객체
* @see $Fn#delay
* @example
function func(a, b) {
alert(a + b);
}
var fpDelay = $Fn(func);
fpDelay.delay(5, [3, 5]);
fpDelay.stopDelay();
*/
jindo.$Fn.prototype.stopDelay = function(){
if(typeof this._delayKey != "undefined"){
window.clearTimeout(this._delayKey);
delete this._delayKey;
}
return this;
}
/**
* stopRepeat는 repeat메서드로 지정한 함수 호출을 멈출 때 사용한다.
* @return {$Fn} $Fn 객체
* @see $Fn#repeat
* @example
function func(a, b) {
alert(a + b);
}
var fpDelay = $Fn(func);
fpDelay.repeat(5, [3, 5]);
fpDelay.stopRepeat();
*/
jindo.$Fn.prototype.stopRepeat = function(){
if(typeof this._repeatKey != "undefined"){
window.clearInterval(this._repeatKey);
delete this._repeatKey;
}
return this;
}
/**
* 메모리에서 이 객체를 사용한 참조를 모두 해제한다(직접 호출 금지).
* @param {Element} 해당 요소의 이벤트 핸들러만 해제.
* @ignore
*/
jindo.$Fn.prototype.free = function(oElement) {
var len = this._events.length;
while(len > 0) {
var el = this._events[--len].element;
var sEvent = this._events[len].event;
var fn = this._events[len].func;
if (oElement && el!==oElement){
continue;
}
this.detach(el, sEvent);
/*
unload시에 엘리먼트에 attach한 함수를 detach하는 로직이 있는데 해당 로직으로 인하여 unload이벤트가 실행되지 않아 실행시키는 로직을 만듬. 그리고 해당 로직은 gc에서 호출할때만 호출.
*/
var isGCCall = !oElement;
if (isGCCall && window === el && sEvent == "unload" && _ua.indexOf("MSIE")<1) {
this._func.call(this._this);
}
delete this._events[len];
}
if(this._events.length==0)
try { delete jindo.$Fn.gc.pool[this._key]; }catch(e){};
};
/**
* IE에서 domready(=DOMContentLoaded) 이벤트를 에뮬레이션한다.
* @ignore
*/
jindo.$Fn._domready = function(doc, func) {
if (typeof jindo.$Fn._domready.list == "undefined") {
var f = null, l = jindo.$Fn._domready.list = jindo.$A([func]);
// use the trick by Diego Perini
// http://javascript.nwbox.com/IEContentLoaded/
var done = false, execFuncs = function(){
if(!done) {
done = true;
var evt = {
type : "domready",
target : doc,
currentTarget : doc
};
while(f = l.shift()) f(evt);
}
};
(function (){
try {
doc.documentElement.doScroll("left");
} catch(e) {
setTimeout(arguments.callee, 50);
return;
}
execFuncs();
})();
// trying to always fire before onload
doc.onreadystatechange = function() {
if (doc.readyState == 'complete') {
doc.onreadystatechange = null;
execFuncs();
}
};
} else {
jindo.$Fn._domready.list.push(func);
}
};
/**
* 비 IE에서 mouseenter/mouseleave 이벤트를 에뮬레이션하기 위한 요소 영역을 벗어나는 경우에만 실행하는 함수 필터
* @ignore
*/
jindo.$Fn._fireWhenElementBoundary = function(doc, func) {
return function(evt){
var oEvent = jindo.$Event(evt);
var relatedElement = jindo.$Element(oEvent.relatedElement);
if(relatedElement && (relatedElement.isEqual(this) || relatedElement.isChildOf(this))) return;
func.call(this,evt);
}
};
/**
* gc 메서드는 엘리먼트에 할당된 모든 이벤트 핸들러를 해제한다.
* @example
var someObject = {
func1 : function() {
// code here
},
func2 : function() {
// code here
}
}
$Fn(someObject.func1, someObject).attach($("test1"),"mouseup");
$Fn(someObject.func2, someObject).attach($("test1"),"mousedown");
$Fn(someObject.func1, someObject).attach($("test2"),"mouseup");
$Fn(someObject.func2, someObject).attach($("test2"),"mousedown");
..
..
$Fn.gc();
*/
jindo.$Fn.gc = function() {
var p = jindo.$Fn.gc.pool;
for(var key in p) {
if(p.hasOwnProperty(key))
try { p[key].free(); }catch(e){ };
}
/*
레퍼런스를 삭제한다.
*/
jindo.$Fn.gc.pool = p = {};
};
/**
* freeElement 메소드는 지정한 엘리먼트에 할당된 이벤트 핸들러를 모두 해제한다.
* @since 1.3.5
* @see $Fn#gc
* @example
var someObject = {
func : function() {
// code here
}
}
$Fn(someObject.func, someObject).attach($("test"),"mouseup");
$Fn(someObject.func, someObject).attach($("test"),"mousedown");
$Fn.freeElement($("test"));
*/
jindo.$Fn.freeElement = function(oElement){
var p = jindo.$Fn.gc.pool;
for(var key in p) {
if(p.hasOwnProperty(key)){
try {
p[key].free(oElement);
}catch(e){ };
}
}
}
jindo.$Fn.gc.count = 0;
jindo.$Fn.gc.pool = {};
function isUnCacheAgent(){
var isIPad = (_ua.indexOf("iPad") > -1);
var isAndroid = (_ua.indexOf("Android") > -1);
var isMSafari = (!(_ua.indexOf("IEMobile") > -1) && (_ua.indexOf("Mobile") > -1) )||(isIPad && (_ua.indexOf("Safari") > -1));
return isMSafari && !isIPad && !isAndroid;
}
if (typeof window != "undefined" && !isUnCacheAgent()) {
jindo.$Fn(jindo.$Fn.gc).attach(window, "unload");
}
/**
* @fileOverview $Event의 생성자 및 메서드를 정의한 파일
* @name event.js
*/
/**
* JavaScript Core 이벤트 객체로부터 $Event 객체를 생성한다.
* @class $Event 클래스는 자바스크립트 Event 객체의 래퍼(Wrapper) 클래스이다. 사용자는 $Event.element 메서드를 사용하여 이벤트가 발생한 객체를 알 수 있다.
* @param {Event} e Event 객체
* @constructor
* @description [Lite]
* @author Kim, Taegon
*/
jindo.$Event = function(e) {
var cl = arguments.callee;
if (e instanceof cl) return e;
if (!(this instanceof cl)) return new cl(e);
if (typeof e == "undefined") e = window.event;
if (e === window.event && document.createEventObject) e = document.createEventObject(e);
this._event = e;
this._globalEvent = window.event;
/**
이벤트의 종류
*/
this.type = e.type.toLowerCase();
if (this.type == "dommousescroll") {
this.type = "mousewheel";
} else if (this.type == "domcontentloaded") {
this.type = "domready";
}
this.canceled = false;
/**
이벤트가 발생한 엘리먼트
*/
this.element = e.target || e.srcElement;
/**
이벤트가 정의된 엘리먼트
*/
this.currentElement = e.currentTarget;
/**
이벤트의 연관 엘리먼트
*/
this.relatedElement = null;
if (typeof e.relatedTarget != "undefined") {
this.relatedElement = e.relatedTarget;
} else if(e.fromElement && e.toElement) {
this.relatedElement = e[(this.type=="mouseout")?"toElement":"fromElement"];
}
}
/**
* mouse 메서드는 마우스 이벤트의 버튼, 휠 정보를 리턴한다.
* @description [Lite]
* @example
function eventHandler(evt) {
var mouse = evt.mouse();
mouse.delta; // Number. 휠이 움직인 정도. 휠을 위로 굴리면 양수, 아래로 굴리면 음수.
mouse.left; // Boolean. 마우스 왼쪽 버튼을 눌렸으면 true, 아니면 false
mouse.middle; // Boolean. 마우스 중간 버튼을 눌렸으면 true, 아니면 false
mouse.right; // Boolean. 마우스 오른쪽 버튼을 눌렸으면 true, 아니면 false
}
* @return {Object} 마우스 정보를 가지는 객체. 리턴한 객체의 속성은 예제를 참조한다.
*/
jindo.$Event.prototype.mouse = function() {
var e = this._event;
var delta = 0;
var left = false,mid = false,right = false;
var left = e.which ? e.button==0 : !!(e.button&1);
var mid = e.which ? e.button==1 : !!(e.button&4);
var right = e.which ? e.button==2 : !!(e.button&2);
var ret = {};
if (e.wheelDelta) {
delta = e.wheelDelta / 120;
} else if (e.detail) {
delta = -e.detail / 3;
}
ret = {
delta : delta,
left : left,
middle : mid,
right : right
};
// replace method
this.mouse = function(){ return ret };
return ret;
};
/**
* key 메서드는 키보드 이벤트 정보를 리턴한다.
* @description [Lite]
* @example
function eventHandler(evt) {
var key = evt.key();
key.keyCode; // Number. 눌린 키보드의 키코드
key.alt; // Boolean. Alt 키를 눌렸으면 true.
key.ctrl; // Boolean. Ctrl 키를 눌렸으면 true.
key.meta; // Boolean. Meta 키를 눌렸으면 true. Meta키는 맥의 커맨드키를 검출할 때 사용합니다.
key.shift; // Boolean. Shift 키를 눌렸으면 true.
key.up; // Boolean. 위쪽 화살표 키를 눌렸으면 true.
key.down; // Boolean. 아래쪽 화살표 키를 눌렸으면 true.
key.left; // Boolean. 왼쪽 화살표 키를 눌렸으면 true.
key.right; // Boolean. 오른쪽 화살표 키를 눌렸으면 true.
key.enter; // Boolean. 리턴키를 눌렀으면 true
key.esc; // Boolean. ESC키를 눌렀으면 true
}
}
* @return {Object} 키보드 이벤트의 눌린 키값. 객체의 속성은 예제를 참조한다.
*/
jindo.$Event.prototype.key = function() {
var e = this._event;
var k = e.keyCode || e.charCode;
var ret = {
keyCode : k,
alt : e.altKey,
ctrl : e.ctrlKey,
meta : e.metaKey,
shift : e.shiftKey,
up : (k == 38),
down : (k == 40),
left : (k == 37),
right : (k == 39),
enter : (k == 13),
esc : (k == 27)
};
this.key = function(){ return ret };
return ret;
};
/**
* pos 메서드는 마우스 커서의 위치 정보를 리턴한다.
* @param {Boolean} bGetOffset 현재 엘리먼트에 대한 마우스 커서의 상대위치인 offsetX, offsetY를 구할 것인지의 여부. true면 값을 구한다(offsetX, offsetY는 1.2.0버전부터 추가). $Element 가 포함되어 있어야 한다.
* @description [Lite]
* @example
function eventHandler(evt) {
var pos = evt.pos();
pos.clientX; // Number. 현재 화면에 대한 X 좌표
pos.clientY; // Number. 현재 화면에 대한 Y 좌표
pos.pageX; // Number. 문서 전체에 대한 X 좌표
pos.pageY; // Number. 문서 전체에 대한 Y 좌표
pos.layerX; // Number. <b>deprecated.</b> 이벤트가 발생한 엘리먼트로부터의 상대적인 X 좌표
pos.layerY; // Number. <b>deprecated.</b> 이벤트가 발생한 엘리먼트로부터의 상대적인 Y 좌표
pos.offsetX; // Number. 이벤트가 발생한 엘리먼트에 대한 마우스 커서의 상대적인 X좌표 (1.2.0 이상)
pos.offsetY; // Number. 이벤트가 발생한 엘리먼트에 대한 마우스 커서의 상대적인 Y좌표 (1.2.0 이상)
}
* @return {Object} 마우스 커서의 위치 정보. 객체의 속성은 예제를 참조한다.
* @remark layerX, layerY는 차후 지원하지 않을(deprecated) 예정입니다.
*/
jindo.$Event.prototype.pos = function(bGetOffset) {
var e = this._event;
var b = (this.element.ownerDocument||document).body;
var de = (this.element.ownerDocument||document).documentElement;
var pos = [b.scrollLeft || de.scrollLeft, b.scrollTop || de.scrollTop];
var ret = {
clientX : e.clientX,
clientY : e.clientY,
pageX : 'pageX' in e ? e.pageX : e.clientX+pos[0]-b.clientLeft,
pageY : 'pageY' in e ? e.pageY : e.clientY+pos[1]-b.clientTop,
layerX : 'offsetX' in e ? e.offsetX : e.layerX - 1,
layerY : 'offsetY' in e ? e.offsetY : e.layerY - 1
};
/*
오프셋을 구하는 메소드의 비용이 크므로, 요청시에만 구하도록 한다.
*/
if (bGetOffset && jindo.$Element) {
var offset = jindo.$Element(this.element).offset();
ret.offsetX = ret.pageX - offset.left;
ret.offsetY = ret.pageY - offset.top;
}
return ret;
};
/**
* stop 메서드는 이벤트의 버블링과 기본 동작을 중지시킨다.
* @remark 버블링은 특정 HTML 엘리먼트에서 이벤트가 발생했을 때 이벤트가 상위 노드로 전파되는 현상이다. 예를 들어, div 객체를 클릭할 때 div와 함께 상위 엘리먼트인 document에도 onclick 이벤트가 발생한다. stop() 메소드는 지정한 객체에서만 이벤트가 발생하도록 버블링을 차단한다.
* @description [Lite]
* @example
// 기본 동작만 중지시키고 싶을 때 (1.1.3버전 이상)
function stopDefaultOnly(evt) {
// Here is some code to execute
// Stop default event only
evt.stop($Event.CANCEL_DEFAULT);
}
* @return {$Event} 이벤트 객체.
* @param {Number} nCancel 이벤트의 버블링과 기본 동작을 선택하여 중지시킨다. 기본값은 $Event.CANCEL_ALL 이다(1.1.3 버전 이상).
*/
jindo.$Event.prototype.stop = function(nCancel) {
nCancel = nCancel || jindo.$Event.CANCEL_ALL;
var e = (window.event && window.event == this._globalEvent)?this._globalEvent:this._event;
var b = !!(nCancel & jindo.$Event.CANCEL_BUBBLE); // stop bubbling
var d = !!(nCancel & jindo.$Event.CANCEL_DEFAULT); // stop default event
this.canceled = true;
if (typeof e.preventDefault != "undefined" && d) e.preventDefault();
if (typeof e.stopPropagation != "undefined" && b) e.stopPropagation();
if(d) e.returnValue = false;
if(b) e.cancelBubble = true;
return this;
};
/**
* stopDefault 메서드는 이벤트의 기본 동작을 중지시킨다.
* @return {$Event} 이벤트 객체.
* @see $Event#stop
* @description [Lite]
*/
jindo.$Event.prototype.stopDefault = function(){
return this.stop(jindo.$Event.CANCEL_DEFAULT);
}
/**
* stopBubble 메서드는 이벤트의 버블링을 중지시킨다.
* @return {$Event} 이벤트 객체.
* @see $Event#stop
* @description [Lite]
*/
jindo.$Event.prototype.stopBubble = function(){
return this.stop(jindo.$Event.CANCEL_BUBBLE);
}
/**
* $value 메서드는 원래의 이벤트 객체를 리턴한다
* @example
function eventHandler(evt){
evt.$value();
}
* @return {Event} Event
*/
jindo.$Event.prototype.$value = function() {
return this._event;
};
/**
* $Event#stop 메서드에서 버블링을 중지시킨다.
* @final
*/
jindo.$Event.CANCEL_BUBBLE = 1;
/**
* $Event#stop 메서드에서 기본 동작을 중지시킨다.
* @final
*/
jindo.$Event.CANCEL_DEFAULT = 2;
/**
* $Event#stop 메서드에서 버블링과 기본 동작 모두 중지시킨다.
* @final
*/
jindo.$Event.CANCEL_ALL = 3;
/**
* @fileOverview $ElementList의 생성자 및 메서드를 정의한 파일
* @name elementlist.js
*/
/**
* $ElementList 객체를 생성 및 리턴한다.
* @class $ElementList 클래스는 id 배열, 혹은 CSS 쿼리 등을 사용하여 DOM 엘리먼트의 배열을 만든다.
* @param {String | Array} els 문서에서 DOM 엘리먼트를 찾기 위한 CSS 선택자 혹은 id, HTMLElement, $Element의 배열
* @constructor
* @borrows $Element#show as this.show
* @borrows $Element#hide as this.hide
* @borrows $Element#toggle as this.toggle
* @borrows $Element#addClass as this.addClass
* @borrows $Element#removeClass as this.removeClass
* @borrows $Element#toggleClass as this.toggleClass
* @borrows $Element#fireEvent as this.fireEvent
* @borrows $Element#leave as this.leave
* @borrows $Element#empty as this.empty
* @borrows $Element#appear as this.appear
* @borrows $Element#disappear as this.disappear
* @borrows $Element#className as this.className
* @borrows $Element#width as this.width
* @borrows $Element#height as this.height
* @borrows $Element#text as this.text
* @borrows $Element#html as this.html
* @borrows $Element#css as this.css
* @borrows $Element#attr as this.attr
* @author Kim, Taegon
*/
jindo.$ElementList = function (els) {
var cl = arguments.callee;
if (els instanceof cl) return els;
if (!(this instanceof cl)) return new cl(els);
if (els instanceof Array) {
els = jindo.$A(els);
} else if(jindo.$A && els instanceof jindo.$A){
els = jindo.$A(els.$value());
} else if (typeof els == "string" && jindo.cssquery) {
els = jindo.$A(jindo.cssquery(els));
} else {
els = jindo.$A();
}
this._elements = els.map(function(v,i,a){ return jindo.$Element(v) });
}
/**
* get 메서드는 $ElementList에서 인덱스에 해당하는 엘리먼트를 가져온다.
* @param {Number} idx 가져올 엘리먼트의 인덱스. 인덱스는 0에서 부터 시작한다.
* @return {$Element} 인덱스에 해당하는 엘리먼트
*/
jindo.$ElementList.prototype.get = function(idx) {
return this._elements.$value()[idx];
};
/**
* getFirst 메서드는 $ElementList의 첫번째 엘리먼트를 가져온다.
* @remark getFirst 메서드의 리턴값은 $ElementList.get(0)의 리턴값과 동일하다.
* @return {$Element} 첫번째 엘리먼트
*/
jindo.$ElementList.prototype.getFirst = function() {
return this.get(0);
};
/**
* length메소드는 $A의 length를 이용한다.(1.4.3 부터 사용 가능.)
* @return Number 배열의 크기
* @param {Number} [nLen] 새로 리턴할 배열의 크기. nLen이 기존의 배열보다 크면 oValue으로 초기화한 원소를 마지막에 덧붙인다. nLen이 기존 배열보다 작으면 nLen번째 이후의 원소는 제거한다.
* @param {Value} [oValue] 새로운 원소를 추가할 때 사용할 초기값
* @see $A#length
*/
jindo.$ElementList.prototype.length = function(nLen, oValue) {
return this._elements.length(nLen, oValue);
}
/**
* getLast 메서드는 $ElementList의 마지막 엘리먼트를 가져온다.
* @return {$Element} 마지막 엘리먼트
*/
jindo.$ElementList.prototype.getLast = function() {
return this.get(Math.max(this._elements.length()-1,0));
};
/**
* $value 메소드는 자신의 배열 엘리먼트을 반환 한다.
* @return {Array} $Element가 들어 있는 배열.
*/
jindo.$ElementList.prototype.$value = function() {
return this._elements.$value();
};
(function(proto){
var setters = ['show','hide','toggle','addClass','removeClass','toggleClass','fireEvent','leave',
'empty','appear','disappear','className','width','height','text','html','css','attr'];
jindo.$A(setters).forEach(function(name){
proto[name] = function() {
var args = jindo.$A(arguments).$value();
this._elements.forEach(function(el){
el[name].apply(el, args);
});
return this;
}
});
jindo.$A(['appear','disappear']).forEach(function(name){
proto[name] = function(duration, callback) {
var len = this._elements.length;
var self = this;
this._elements.forEach(function(el,idx){
if(idx == len-1) {
el[name](duration, function(){callback(self)});
} else {
el[name](duration);
}
});
return this;
}
});
})(jindo.$ElementList.prototype);
/**
* @fileOverview $Json의 생성자 및 메서드를 정의한 파일
* @name json.js
*/
/**
* $S 객체를 생성한다.
* @class $S 클래스는 문자열을 처리하기 위한 래퍼(Wrapper) 클래스이다.
* @constructor
* @param {String} str
* <br>
* 문자열을 매개변수로 지정한다.
* @author Kim, Taegon
*/
jindo.$S = function(str) {
var cl = arguments.callee;
if (typeof str == "undefined") str = "";
if (str instanceof cl) return str;
if (!(this instanceof cl)) return new cl(str);
this._str = str+"";
}
/**
* $value 메서드는 원래의 문자열을 리턴한다.
* @return {String} 래핑된 원래의 문자열
* @see $S#toString
* @example
var str = $S("Hello world!!");
str.$value();
*
* // 결과 :
* // Hello world!!
*/
jindo.$S.prototype.$value = function() {
return this._str;
};
/**
* toString 메서드는 원래의 문자열을 리턴한다.
* @return {String} 래핑된 원래의 문자열
* @remark $value와 같은 의미
* @example
var str = $S("Hello world!!");
str.toString();
*
* // 결과 :
* // Hello world!!
*/
jindo.$S.prototype.toString = jindo.$S.prototype.$value;
/**
* trim 메서드는 문자열의 양 끝 공백을 제거한다.(1.4.1 부터 전각공백도 제거)
* @return {$S} 문자열의 양 끝을 제거한 새로운 $S 객체
* @example
var str = " I have many spaces. ";
document.write ( $S(str).trim() );
*
* // 결과 :
* // I have many spaces.
*/
jindo.$S.prototype.trim = function() {
if ("".trim) {
jindo.$S.prototype.trim = function() {
return jindo.$S(this._str.trim());
}
}else{
jindo.$S.prototype.trim = function() {
return jindo.$S(this._str.replace(/^(\s| )+/g, "").replace(/(\s| )+$/g, ""));
}
}
return jindo.$S(this.trim());
};
/**
* escapeHTML 메서드는 HTML 특수 문자를 HTML 엔티티(Entities)형식으로 이스케이프(escape)한다.
* @return {$S} HTML 특수 문자를 엔티티 형식으로 변환한 새로운 $S 객체
* @see $S#unescapeHTML
* @remark ", &, <, > ,' 를 각각 &quot;, &amp;, &lt;, &gt; &#39;로 변경한다.
* @example
var str = ">_<;;";
document.write( $S(str).escapeHTML() );
*
* // 결과 :
* // &amp;gt;_&amp;lt;;;
*/
jindo.$S.prototype.escapeHTML = function() {
var entities = {'"':'quot','&':'amp','<':'lt','>':'gt','\'':'#39'};
var s = this._str.replace(/[<>&"']/g, function(m0){
return entities[m0]?'&'+entities[m0]+';':m0;
});
return jindo.$S(s);
};
/**
* stripTags 메서드는 문자열에서 XML 혹은 HTML 태그를 제거한다.
* @return {$S} XML 혹은 HTML 태그를 제거한 새로운 $S 객체
* @example
var str = "Meeting <b>people</b> is easy.";
document.write( $S(str).stripTags() );
*
* // 결과 :
* // Meeting people is easy.
*/
jindo.$S.prototype.stripTags = function() {
return jindo.$S(this._str.replace(/<\/?(?:h[1-5]|[a-z]+(?:\:[a-z]+)?)[^>]*>/ig, ''));
};
/**
* times 메서드는 문자열을 매개변수로 지정한 숫자만큼 반복한다.
* @param {Number} nTimes 반복할 횟수
* @return {$S} 문자열을 지정한 숫자만큼 반복한 새로운 $S 객체
* @example
document.write ( $S("Abc").times(3) );
*
* // 결과 : AbcAbcAbc
*/
jindo.$S.prototype.times = function(nTimes) {
var buf = [];
for(var i=0; i < nTimes; i++) {
buf[buf.length] = this._str;
}
return jindo.$S(buf.join(''));
};
/**
* unescapeHTML 메서드는 이스케이프(escape)된 HTML을 원래의 HTML로 리턴한다.
* @return {$S} 이스케이프된 HTML을 원래의 HTML로 변환한 새로운 $S 객체
* @remark &quot;, &amp;, &lt;, &gt; &#39;를 각각 ", &, <, >, ' 으로 변경한다.
* @see $S#escapeHTML
* @example
* var str = "&lt;a href=&quot;http://naver.com&quot;&gt;Naver&lt;/a&gt;";
* document.write( $S(str).unescapeHTML() );
*
* // 결과 :
* // <a href="http://naver.com">Naver</a>
*/
jindo.$S.prototype.unescapeHTML = function() {
var entities = {'quot':'"','amp':'&','lt':'<','gt':'>','#39':'\''};
var s = this._str.replace(/&([a-z]+|#[0-9]+);/g, function(m0,m1){
return entities[m1]?entities[m1]:m0;
});
return jindo.$S(s);
};
/**
* escape 메서드는 문자열에 포함된 한글을 ASCII 문자열로 인코딩한다.
* @remark \r, \n, \t, ', ", non-ASCII 문자를 이스케이프 처리한다.
* @return {$S} 문자열을 이스케이프 처리한 새로운 $S 객체
* @see $S#escapeHTML
* @example
* var str = '가"\'나\\';
* document.write( $S(str).escape() );
*
* // 결과 :
* \uAC00\"\'\uB098\\
*/
jindo.$S.prototype.escape = function() {
var s = this._str.replace(/([\u0080-\uFFFF]+)|[\n\r\t"'\\]/g, function(m0,m1,_){
if(m1) return escape(m1).replace(/%/g,'\\');
return (_={"\n":"\\n","\r":"\\r","\t":"\\t"})[m0]?_[m0]:"\\"+m0;
});
return jindo.$S(s);
};
/**
* bytes 메서드는 문자열의 실제 바이트(byte) 수를 리턴하고, 제한하려는 바이트(byte) 수를 지정하면 문자열을 해당 크기에 맞게 잘라낸다.(1.4.3 부터 charset사용 가능)
* @return 문자열의 바이트 수. 단, 첫번째 매개변수를 설정하면 자기 객체($S)를 리턴한다.
* @param {Number|Object} nBytes 맞출 문자열의 바이트(byte) 수 | charset을 지정할 때 사용
* @remark 문서의 charset을 해석해서 인코딩 방식에 따라 한글을 비롯한 유니코드 문자열의 바이트 수를 계산한다.
* @example
// 문서가 euc-kr 환경임을 가정합니다.
*
var str = "한글과 English가 섞인 문장...";
document.write( $S(str).bytes() );
*
* // 결과 :
* // 37
*
document.write( $S(str).bytes(20) );
*
* // 결과 :
* // 한글과 English가
*
document.write( $S(str).bytes({charset:'euc-kr',size:20}) );
*
* // 결과 :
* // 한글과 English가 섞
*
document.write( $S(str).bytes({charset:'euc-kr'}) );
*
* // 결과 :
* // 29
*/
jindo.$S.prototype.bytes = function(vConfig) {
var code = 0, bytes = 0, i = 0, len = this._str.length;
var charset = ((document.charset || document.characterSet || document.defaultCharset)+"");
var cut,nBytes;
if (typeof vConfig == "undefined") {
cut = false;
}else if(vConfig.constructor == Number){
cut = true;
nBytes = vConfig;
}else if(vConfig.constructor == Object){
charset = vConfig.charset||charset;
nBytes = vConfig.size||false;
cut = !!nBytes;
}else{
cut = false;
}
if (charset.toLowerCase() == "utf-8") {
/*
유니코드 문자열의 바이트 수는 위키피디아를 참고했다(http://ko.wikipedia.org/wiki/UTF-8).
*/
for(i=0; i < len; i++) {
code = this._str.charCodeAt(i);
if (code < 128) {
bytes += 1;
}else if (code < 2048){
bytes += 2;
}else if (code < 65536){
bytes += 3;
}else{
bytes += 4;
}
if (cut && bytes > nBytes) {
this._str = this._str.substr(0,i);
break;
}
}
} else {
for(i=0; i < len; i++) {
bytes += (this._str.charCodeAt(i) > 128)?2:1;
if (cut && bytes > nBytes) {
this._str = this._str.substr(0,i);
break;
}
}
}
return cut?this:bytes;
};
/**
* parseString 메서드는 URL 쿼리 스트링을 객체로 파싱한다.
* @return {Object} 문자열을 파싱한 객체
* @example
* var str = "aa=first&bb=second";
* var obj = $S(str).parseString();
*
* // 결과 :
* // obj => { aa : "first", bb : "second" }
*/
jindo.$S.prototype.parseString = function() {
if(this._str=="") return {};
var str = this._str.split(/&/g), pos, key, val, buf = {},isescape = false;
for(var i=0; i < str.length; i++) {
key = str[i].substring(0, pos=str[i].indexOf("=")), isescape = false;
try{
val = decodeURIComponent(str[i].substring(pos+1));
}catch(e){
isescape = true;
val = decodeURIComponent(unescape(str[i].substring(pos+1)));
}
if (key.substr(key.length-2,2) == "[]") {
key = key.substring(0, key.length-2);
if (typeof buf[key] == "undefined") buf[key] = [];
buf[key][buf[key].length] = isescape? escape(val) : val;;
} else {
buf[key] = isescape? escape(val) : val;
}
}
return buf;
};
/**
* escapeRegex 메서드는 정규식에 사용할 수 있도록 문자열을 이스케이프(escape) 한다.
* @since 1.2.0
* @return {String} 이스케이프된 문자열
* @example
var str = "Slash / is very important. Backslash \ is more important. +_+";
document.write( $S(str).escapeRegex() );
*
* // 결과 : \/ is very important\. Backslash \\ is more important\. \+_\+
*/
jindo.$S.prototype.escapeRegex = function() {
var s = this._str;
var r = /([\?\.\*\+\-\/\(\)\{\}\[\]\:\!\^\$\\\|])/g;
return jindo.$S(s.replace(r, "\\$1"));
};
/**
* format 메서드는 문자열을 형식 문자열에 대입하여 새로운 문자열을 만든다. 형식 문자열은 %로 시작하며, 형식 문자열의 종류는 <a href="http://www.php.net/manual/en/function.sprintf.php">PHP</a>와 동일하다.
* @param {String} formatString 형식 문자열
* @return {String} 문자열을 형식 문자열에 대입하여 만든 새로운 문자열.
* @example
var str = $S("%4d년 %02d월 %02d일").format(2008, 2, 13);
*
* // 결과 :
* // str = "2008년 02월 13일"
var str = $S("패딩 %5s 빈공백").format("값");
*
* // 결과 :
* // str => "패딩 값 빈공백"
var str = $S("%b").format(10);
*
* // 결과 :
* // str => "1010"
var str = $S("%x").format(10);
*
* // 결과 :
* // str => "a"
var str = $S("%X").format(10);
*
* // 결과 :
* // str => "A"
* @see $S#times
*/
jindo.$S.prototype.format = function() {
var args = arguments;
var idx = 0;
var s = this._str.replace(/%([ 0])?(-)?([1-9][0-9]*)?([bcdsoxX])/g, function(m0,m1,m2,m3,m4){
var a = args[idx++];
var ret = "", pad = "";
m3 = m3?+m3:0;
if (m4 == "s") {
ret = a+"";
} else if (" bcdoxX".indexOf(m4) > 0) {
if (typeof a != "number") return "";
ret = (m4 == "c")?String.fromCharCode(a):a.toString(({b:2,d:10,o:8,x:16,X:16})[m4]);
if (" X".indexOf(m4) > 0) ret = ret.toUpperCase();
}
if (ret.length < m3) pad = jindo.$S(m1||" ").times(m3 - ret.length).toString();
(m2 == '-')?(ret+=pad):(ret=pad+ret);
return ret;
});
return jindo.$S(s);
};
/**
* @fileOverview $Document 생성자 및 메서드를 정의한 파일
* @name document.js
*/
/**
* $Document 객체를 생성하고 리턴한다.
* @class $Document 클래스는 문서와 관련된 여러가지 기능의 메서드를 제공한다
* @param {Document} doc 기능에 사용된 document 객체. 기본값은 현재 문서의 document.
* @constructor
* @author Hooriza
*/
jindo.$Document = function (el) {
var cl = arguments.callee;
if (el instanceof cl) return el;
if (!(this instanceof cl)) return new cl(el);
this._doc = el || document;
this._docKey = this.renderingMode() == 'Standards' ? 'documentElement' : 'body';
};
/**
* $value 메서드는 원래의 document 객체를 리턴한다.
* @return {HTMLDocument} document 객체
*/
jindo.$Document.prototype.$value = function() {
return this._doc;
};
/**
* scrollSize 메서드는 문서의 실제 가로, 세로 크기를 구한다
* @return {Object} 가로크기는 width, 세로크기는 height 라는 키값으로 리턴된다.
* @example
var size = $Document().scrollSize();
alert('가로 : ' + size.width + ' / 세로 : ' + size.height);
*/
jindo.$Document.prototype.scrollSize = function() {
/*
webkit 계열에서는 Standard 모드라도 body를 사용해야 정상적인 scroll Size를 얻어온다.
*/
var isWebkit = navigator.userAgent.indexOf("WebKit")>-1;
var oDoc = this._doc[isWebkit?'body':this._docKey];
return {
width : Math.max(oDoc.scrollWidth, oDoc.clientWidth),
height : Math.max(oDoc.scrollHeight, oDoc.clientHeight)
};
};
/**
* scrollPosition 메서드는 문서의 스크롤바 위치를 구한다
* @return {Object} 가로 위치는 left, 세로위치는 top 라는 키값으로 리턴된다.
* @example
var size = $Document().scrollPosition();
alert('가로 : ' + size.left + ' / 세로 : ' + size.top);
* @since 1.3.5
*/
jindo.$Document.prototype.scrollPosition = function() {
/*
webkit 계열에서는 Standard 모드라도 body를 사용해야 정상적인 scroll Size를 얻어온다.
*/
var isWebkit = navigator.userAgent.indexOf("WebKit")>-1;
var oDoc = this._doc[isWebkit?'body':this._docKey];
return {
left : oDoc.scrollLeft||window.pageXOffset||window.scrollX||0,
top : oDoc.scrollTop||window.pageYOffset||window.scrollY||0
};
};
/**
* clientSize 메서드는 스크롤바로 인해 가려진 부분을 제외한 문서 중 보이는 부분의 가로, 세로 크기를 구한다
* @return {Object} 가로크기는 width, 세로크기는 height 라는 키값으로 리턴된다
* @example
var size = $Document(document).clientSize();
alert('가로 : ' + size.width + ' / 세로 : ' + size.height);
*/
jindo.$Document.prototype.clientSize = function() {
var agent = navigator.userAgent;
var oDoc = this._doc[this._docKey];
var isSafari = agent.indexOf("WebKit")>-1 && agent.indexOf("Chrome")==-1;
/*
사파리의 경우 윈도우 리사이즈시에 clientWidth,clientHeight값이 정상적으로 나오지 않아서 window.innerWidth,innerHeight로 대체
*/
return (isSafari)?{
width : window.innerWidth,
height : window.innerHeight
}:{
width : oDoc.clientWidth,
height : oDoc.clientHeight
};
};
/**
* renderingMode 메서드는 문서의 렌더링 방식을 얻는다
* @return {String} 렌더링 모드
* <dl>
* <dt>Standards</dt>
* <dd>표준 렌더링 모드</dd>
* <dt>Almost</dt>
* <dd>유사 표준 렌더링 모드 (IE 외의 브라우저에서 DTD 을 올바르게 지정하지 않았을때 리턴)</dd>
* <dt>Quirks</dt>
* <dd>비표준 렌더링 모드</dd>
* </dl>
* @example
var mode = $Document().renderingMode();
alert('렌더링 방식 : ' + mode);
*/
jindo.$Document.prototype.renderingMode = function() {
var agent = navigator.userAgent;
var isIe = (typeof window.opera=="undefined" && agent.indexOf("MSIE")>-1);
var isSafari = (agent.indexOf("WebKit")>-1 && agent.indexOf("Chrome")<0 && navigator.vendor.indexOf("Apple")>-1);
var sRet;
if ('compatMode' in this._doc){
sRet = this._doc.compatMode == 'CSS1Compat' ? 'Standards' : (isIe ? 'Quirks' : 'Almost');
}else{
sRet = isSafari ? 'Standards' : 'Quirks';
}
return sRet;
};
/**
* 문서에서 주어진 selector를 만족시키는 요소의 배열을 반환한다. 만족하는 요소가 존재하지 않으면 빈 배열을 반환한다.
* @param {String} sSelector
* @return {Array} 조건을 만족하는 요소의 배열
*/
jindo.$Document.prototype.queryAll = function(sSelector) {
return jindo.$$(sSelector, this._doc);
};
/**
* 문서에서 주어진 selector를 만족시키는 요소중 첫 번째 요소를 반환한다. 만족하는 요소가 존재하지 않으면 null을 반환한다.
* @param {String} sSelector
* @return {Element} 조건을 만족하는 요소중 첫번째 요소
*/
jindo.$Document.prototype.query = function(sSelector) {
return jindo.$$.getSingle(sSelector, this._doc);
};
/**
* 문서에서 XPath 문법에 해당하는 모든 엘리먼트를 배열로 리턴한다.
* @remark 지원하는 문법에 제약 사항이 많으므로 특수한 경우에만 사용한다.
* @param {String} sXPath 엘리먼트의 위치를 지정한 XPath 값
* @return {Array} path에 해당하는 요소의 배열
* @example
var oDocument = $Document();
alert (oDocument.xpathAll("body/div/div").length);
*/
jindo.$Document.prototype.xpathAll = function(sXPath) {
return jindo.$$.xpath(sXPath, this._doc);
};
/**
* @fileOverview $Form 생성자 및 메서드를 정의한 파일
* @name form.js
*/
/**
* $Form 객체를 생성 및 리턴한다.
* @class $Form 클래스는 form 엘리먼트와 자식 엘리먼트를 제어하는 클래스이다.
* @param {Element | String} el 폼(form) 엘리먼트, 혹은 폼 엘리먼트의 id. 만약 동일한 id를 두 개 이상의 엘리먼트에서 사용하면 먼저 나오는 엘리먼트를 리턴한다.
* @constructor
* @author Hooriza
*/
jindo.$Form = function (el) {
var cl = arguments.callee;
if (el instanceof cl) return el;
if (!(this instanceof cl)) return new cl(el);
el = jindo.$(el);
if (!el.tagName || el.tagName.toUpperCase() != 'FORM') throw new Error('The element should be a FORM element');
this._form = el;
}
/**
* $value 메서드는 랩핑된 원래 폼 엘리먼트를 리턴한다
* @return {HTMLElement} 폼 엘리먼트
* @example
var el = $('<form>');
var form = $Form(el);
alert(form.$value() === el); // true
*/
jindo.$Form.prototype.$value = function() {
return this._form;
};
/**
* serialize 메서드는 특정 또는 전체 엘리멘트 입력요소를 문자열 형태로 리턴한다.
* @param {Mixed} Mixed 인수를 지정하지 않거나 인수를 하나 이상 설정할 수 있다.
* <ol>
* <li>매개 변수를 지정하지 않으면 폼 엘리먼트와 자식 엘리먼트의 모든 값을 쿼리 형태의 문자열로 리턴한다.</li>
* <li>매개 변수로 문자열을 설정하면 문자열과 일치하는 name 속성을 가지는 엘리먼트를 탐색하고 값을 리턴한다.</li>
* <li>매배 변수로 두 개 이상의 문자열을 설정하면, 문자열과 일치하는 name 속성을 가지는 엘리먼트를 모두 탐색하고 값을 쿼리 스트링 형태로 리턴한다. </li>
* </ol>
* @return {String} 쿼리 문자열 형태로 변환한 엘리먼트와 그 값.
* @example
<form id="TEST">
<input name="ONE" value="1" type="text" />
<input name="TWO" value="2" checked="checked" type="checkbox" />
<input name="THREE" value="3_1" type="radio" />
<input name="THREE" value="3_2" checked="checked" type="radio" />
<input name="THREE" value="3_3" type="radio" />
<select name="FOUR">
<option value="4_1">..</option>
<option value="4_2">..</option>
<option value="4_3" selected="selected">..</option>
</select>
</form>
<script type="text/javascript">
var form = $Form('TEST');
var allstr = form.serialize();
alert(allstr == 'ONE=1&TWO=2&THREE=3_2&FOUR=4_3'); // true
var str = form.serialize('ONE', 'THREE');
alert(str == 'ONE=1&THREE=3_2'); // true
</script>
*/
jindo.$Form.prototype.serialize = function() {
var self = this;
var oRet = {};
var nLen = arguments.length;
var fpInsert = function(sKey) {
var sVal = self.value(sKey);
if (typeof sVal != 'undefined') oRet[sKey] = sVal;
};
if (nLen == 0) {
jindo.$A(this.element()).forEach(function(o) { if (o.name) fpInsert(o.name); });
}else{
for (var i = 0; i < nLen; i++) {
fpInsert(arguments[i]);
}
}
return jindo.$H(oRet).toQueryString();
};
/**
* element 메서드는 특정 또는 전체 입력요소를 리턴한다.
* @param {String} sKey 얻고자 하는 입력요소 엘리먼트의 name 문자열, 생략시에는 모든 입력요소들을 배열로 리턴한다.
* @return {HTMLElement | Array} 입력 요소 엘리먼트
*/
jindo.$Form.prototype.element = function(sKey) {
if (arguments.length > 0)
return this._form[sKey];
return this._form.elements;
};
/**
* enable 메서드는 입력 요소의 활성화 여부를 얻거나 설정한다.
* @param {Mixed} mixed enable 메서드는 매개 변수의 개수나 종류에 따라 다르게 동작한다. 자세한 사용법은 다음과 같다.
* <ol>
* <li> 매개 변수로 문자열을 사용하면 문자열과 일치하는 name 속성을 가진 엘리먼트를 탐색한다. 엘리먼트를 발견했다면 엘리먼트의 활성화 여부를 리턴한다.</li>
* <li> 매개 변수로 문자열과 불린(Boolean)을 사용하면 문자열과 일치하는 name 속성을 가진 엘리먼트를 탐색한 후, 활성화 여부를 설정한다. </li>
* <li> 매개 변수로 객체를 사용할 수 있다. 객체는 속성 값과 name이 일치하는 엘리먼트를 탐색해서 값에 따라 활성화 여부를 설정한다. </li>
* </ol>
* @return {Boolean|$Form} 엘리먼트의 활성화 여부를 가져오거나 엘리먼트의 활성화 여부를 설정한 $Form 객체.
* @example
<form id="TEST">
<input name="ONE" disabled="disabled" type="text" />
<input name="TWO" type="checkbox" />
</form>
<script type="text/javascript">
var form = $Form('TEST');
var one_enabled = form.enable('ONE');
alert(one_enabled === false); // true
form.enable('TWO', false);
form.enable({
'ONE' : true,
'TWO' : false
});
</script>
*/
jindo.$Form.prototype.enable = function() {
var sKey = arguments[0];
if (typeof sKey == 'object') {
var self = this;
jindo.$H(sKey).forEach(function(bFlag, sKey) { self.enable(sKey, bFlag); });
return this;
}
var aEls = this.element(sKey);
if (!aEls) return this;
aEls = aEls.nodeType == 1 ? [ aEls ] : aEls;
if (arguments.length < 2) {
var bEnabled = true;
jindo.$A(aEls).forEach(function(o) { if (o.disabled) {
bEnabled = false;
jindo.$A.Break();
}});
return bEnabled;
} else { // setter
var sFlag = arguments[1];
jindo.$A(aEls).forEach(function(o) { o.disabled = !sFlag; });
return this;
}
};
/**
* value 메서드는 폼 엘리먼트의 값을 얻거나 설정한다.
* @param {Mixed} Mixed 정확안 인수 정보는 다음과 같다.
* <ol>
* <li>매개 변수로 문자열을 설정하면 name 속성이 일치하는 앨리먼트를 탐색하고 값을 리턴한다</li>
* <li>매개 변수로 두 개의 문자열과 불린 값을 name 속성이 일치하는 앨리먼트를 탐색하고 값을 설정한다. </br> checkbox, radio, selectbox는 엘리먼트를 선택/선택 해제 한다.</li>
* <li>두 개 이상의 엘리먼트 값을 동시에 지정하고 싶으면 '엘리먼트 이름 : 엘리먼트 값'을 원소로 가지는 객체를 매개 변수로 설정한다.</li>
* </ol>
* @return {String|$Form} 인수로 엘리먼트만 지정했다면 지정한 엘리먼트의 값을, 인수로 폼 엘리먼와 엘리먼트의 값을 지정했다면 $Form 객체를 리턴한다.
* @example
<form id="TEST">
<input name="ONE" value="1" type="text" />
<input name="TWO" value="2" type="checkbox" />
</form>
<script type="text/javascript">
var form = $Form('TEST');
var one_value = form.value('ONE');
alert(one_value === '1'); // true
var two_value = form.value('TWO');
alert(two_value === undefined); // true
form.value('TWO', 2);
alert(two_value === '2'); // true
form.value({
'ONE' : '1111',
'TWO' : '2'
});
// form.value('ONE') -> 1111
// form.value('ONE') -> 2
</script>
*/
jindo.$Form.prototype.value = function(sKey) {
if (typeof sKey == 'object') {
var self = this;
jindo.$H(sKey).forEach(function(bFlag, sKey) { self.value(sKey, bFlag); });
return this;
}
var aEls = this.element(sKey);
if (!aEls) throw new Error('엘리먼트는 존재하지 않습니다.');
aEls = aEls.nodeType == 1 ? [ aEls ] : aEls;
if (arguments.length > 1) { // setter
var sVal = arguments[1];
jindo.$A(aEls).forEach(function(o) {
switch (o.type) {
case 'radio':
o.checked = (o.value == sVal);
break;
case 'checkbox':
if(sVal.constructor == Array){
o.checked = jindo.$A(sVal).has(o.value);
}else{
o.checked = (o.value == sVal);
}
break;
case 'select-one':
var nIndex = -1;
for (var i = 0, len = o.options.length; i < len; i++){
if (o.options[i].value == sVal) nIndex = i;
}
o.selectedIndex = nIndex;
break;
case 'select-multiple':
var nIndex = -1;
if(sVal.constructor == Array){
var waVal = jindo.$A(sVal);
for (var i = 0, len = o.options.length; i < len; i++){
o.options[i].selected = waVal.has(o.options[i].value);
}
}else{
for (var i = 0, len = o.options.length; i < len; i++){
if (o.options[i].value == sVal) nIndex = i;
}
o.selectedIndex = nIndex;
}
break;
default:
o.value = sVal;
break;
}
});
return this;
}
// getter
var aRet = [];
jindo.$A(aEls).forEach(function(o) {
switch (o.type) {
case 'radio':
case 'checkbox':
if (o.checked) aRet.push(o.value);
break;
case 'select-one':
if (o.selectedIndex != -1) aRet.push(o.options[o.selectedIndex].value);
break;
case 'select-multiple':
if (o.selectedIndex != -1){
for (var i = 0, len = o.options.length; i < len; i++){
if (o.options[i].selected) aRet.push(o.options[i].value);
}
}
break;
default:
aRet.push(o.value);
break;
}
});
return aRet.length > 1 ? aRet : aRet[0];
};
/**
* submit 메서드는 폼의 데이터를 웹으로 제출(submit) 한다.
* @param {String} sTargetName 제출할 폼이 있는 윈도우의 이름. sTargetName을 생략하면 기본 타겟
* @param {String} fValidation 제출할 폼의 밸리데이션 함수. form 요소를 인자로 받는다.
* @return {$Form} 데이터를 제출한 $Form 객체.
* @example
var form = $Form(el);
form.submit();
form.submit('foo');
*/
jindo.$Form.prototype.submit = function(sTargetName, fValidation) {
var sOrgTarget = null;
if (typeof sTargetName == 'string') {
sOrgTarget = this._form.target;
this._form.target = sTargetName;
}
if(typeof sTargetName == 'function') fValidation = sTargetName;
if(typeof fValidation != 'undefined'){
if(!fValidation(this._form)) return this;
}
this._form.submit();
if (sOrgTarget !== null)
this._form.target = sOrgTarget;
return this;
};
/**
* reset 메서드는 폼을 초기화(reset)한다.
* @param {String} fValidation 제출할 폼의 밸리데이션 함수. form 요소를 인자로 받는다.
* @return {$Form} 초기화한 $Form 객체.
* @example
var form = $Form(el);
form.reset();
*/
jindo.$Form.prototype.reset = function(fValidation) {
if(typeof fValidation != 'undefined'){
if(!fValidation(this._form)) return this;
}
this._form.reset();
return this;
};
/**
* @fileOverview $Template의 생성자 및 메서드를 정의한 파일
* @name template.js
*/
/**
* $Template 객체를 생성한다.
* @class $Template 클래스는 템플릿을 해석하여 템플릿 문자열에 동적으로 문자를 삽입한다.
* @constructor
* @author Kim, Taegon
*
* @param {String | HTML Element | $Template} str
* <br>
* $Template 은 문자열, HTML 엘리먼트, 혹은 $Template 을 인자로 지정할 수 있다.<br>
* <br>
* 인자가 문자열이면 두 가지 방식으로 동작한다.<br>
* 만일 문자열이 HTML 엘리먼트의 id 라면 HTML 엘리먼트의 innerHTML 을 템플릿으로 사용한다.<br>
* 만약 일반 문자열이라면 문자열 자체를 템플릿으로 사용한다.<br>
* <br>
* 인자가 HTML 엘리먼트이면 TEXTAREA 와 SCRIPT 만이 사용 가능하다.<br>
* HTML 엘리먼트 value 값의 문자열을 템 플릿으로 사용하며, value 값이 없는 경우 HTML 엘리먼트의 innerHTML을 템플릿으로 사용한다.<br>
* <br>
* 인자가 $Template 이면 전달된 인자를 그대로 반환하며 인자를 생략하면 "" 를 템플릿으로 사용한다.
* @return {$Template} 생성된 $Template 객체
*
* @remark 인자가 SCRIPT인 경우의 type은 반드시 "text/template"으로 지정해야 한다.
*
* @example
// 인자가 일반 문자열인 경우
var tpl = $Template("{=service} : {=url}");
*
* @example
<textarea id="tpl1">
{=service} : {=url}
&lt;/textarea&gt;
// 같은 TEXTAREA 엘리먼트를 템플릿으로 사용한다
var template1 = $Template("tpl1"); // 인자가 HTML 엘리먼트의 id 아이디
var template2 = $Template($("tpl1")); // 인자가 TEXTAREA 엘리먼트인 경우
</script>
*
* @example
<script type="text/template" id="tpl2">
{=service} : {=url}
</script>
// 같은 SCRIPT 엘리먼트를 템플릿으로 사용한다
var template1 = $Template("tpl2"); // 인자가 HTML 엘리먼트의 id 아이디
var template2 = $Template($("tpl2")); // 인자가 SCRIPT 엘리먼트인 경우
*/
jindo.$Template = function(str) {
var obj = null, tag = "";
var cl = arguments.callee;
if (str instanceof cl) return str;
if (!(this instanceof cl)) return new cl(str);
if(typeof str == "undefined") {
str = "";
}else if( (obj=document.getElementById(str)||str) && obj.tagName && (tag=obj.tagName.toUpperCase()) && (tag == "TEXTAREA" || (tag == "SCRIPT" && obj.getAttribute("type") == "text/template")) ) {
str = (obj.value||obj.innerHTML).replace(/^\s+|\s+$/g,"");
}
this._str = str+"";
}
jindo.$Template.splitter = /(?!\\)[\{\}]/g;
jindo.$Template.pattern = /^(?:if (.+)|elseif (.+)|for (?:(.+)\:)?(.+) in (.+)|(else)|\/(if|for)|=(.+)|js (.+)|set (.+))$/;
/**
* 템플릿을 해석하고 데이터를 적용하여 새로운 문자열을 생성한다.<br>
* <br>
* 템플릿을 해석할 때에<br>
* 템플릿 내에 패턴이 있으면 패턴에 따라 템플릿을 해석하는 방법이 다르다.(각 패턴의 해석은 예제를 참고한다)<br>
* 템플릿 내에 패턴이 없으면 단순 문자열 치환으로 처리한다.
* @param {Object} data 템플릿에 들어갈 데이터를 가지는 객체<br>
* 템플릿에 데이터를 적용할 부분은 객체의 프로퍼티(property) 이름으로 찾는다.
* @return {String} 템플릿을 해석하고 데이터를 적용한 새로운 문자열
*
* @example
// 단순 문자열 치환
// {=value} 부분의 값을 치환한다.
var tpl = $Template("Value1 : {=val1}, Value2 : {=val2}")
var data = { val1: "first value", val2: "second value" };
document.write( tpl.process(data) );
// 결과
// Value1 : first value, Value2 : second value
* @example
// if/elseif/else : 조건문
// 템플릿을 해석할 때 조건문을 판단하여 처리한다.
var tpl= $Template("{if num >= 7}7보다 크거나 같다.{elseif num <= 5}5보다 작거나 같다.{else}아마 6?{/if}");
var data = { num: 5 };
document.write( tpl.process(data) );
// 결과
// 5보다 작거나 같다.
* @example
// set : 임시 변수 사용
// set val=1 로 설정하는 경우 {=val} 부분에 1을 대입한다.
var tpl = $Template("{set val3=val1}Value1 : {=val1}, Value2 : {=val2}, Value3 : {=val3}")
var data = { val1: "first value", val2: "second value" };
document.write( tpl.process(data) );
// 결과
// Value1 : first value, Value2 : second value, Value3 : first value
* @example
// js : JavaScript 사용
// 템플릿을 해석할 때 해당 JavaScript를 실행한다.
var tpl = $Template("Value1 : {js $S(=val1).bytes()}, Value2 : {=val2}")
var data = { val1: "first value", val2: "second value" };
document.write( tpl.process(data) );
// 결과
// Value1 : 11, Value2 : second value
* @example
// for in : 반복문(인덱스를 사용하지 않는 경우)
var tpl = $Template("<h1>포탈 사이트</h1>\n<ul>{for site in portals}\n<li><a href='{=site.url}'>{=site.name}</a></li>{/for}\n</ul>");
var data = { portals: [
{ name: "네이버", url : "http://www.naver.com" },
{ name: "다음", url : "http://www.daum.net" },
{ name: "야후", url : "http://www.yahoo.co.kr" }
]};
document.write( tpl.process(data) );
// 결과
//<h1>포탈 사이트</h1>
//<ul>
//<li><a href='http://www.naver.com'>네이버</a></li>
//<li><a href='http://www.daum.net'>다음</a></li>
//<li><a href='http://www.yahoo.co.kr'>야후</a></li>
//</ul>
* @example
// for: 반복문(인덱스를 사용하는 경우)
var tpl = $Template("{for num:word in numbers}{=word}({=num}){/for}");
var data = { numbers: ["zero", "one", "two", "three"] };
document.write( tpl.process(data) );
// 결과
// zero(0) one(1) two(2) three(3)
*/
jindo.$Template.prototype.process = function(data) {
var key = "\x01";
var leftBrace = "\x02";
var rightBrace = "\x03";
var tpl = (" "+this._str+" ").replace(/\\{/g,leftBrace).replace(/\\}/g,rightBrace).replace(/(?!\\)\}\{/g, "}"+key+"{").split(jindo.$Template.splitter), i = tpl.length;
var map = {'"':'\\"','\\':'\\\\','\n':'\\n','\r':'\\r','\t':'\\t','\f':'\\f'};
var reg = [/(["'](?:(?:\\.)+|[^\\["']+)*["']|[a-zA-Z_][\w\.]*)/g, /[\n\r\t\f"\\]/g, /^\s+/, /\s+$/, /#/g];
var cb = [function(m){ return (m.substring(0,1)=='"' || m.substring(0,1)=='\''||m=='null')?m:"d."+m; }, function(m){return map[m]||m}, "", ""];
var stm = [];
var lev = 0;
// remove " "
tpl[0] = tpl[0].substr(1);
tpl[i-1] = tpl[i-1].substr(0, tpl[i-1].length-1);
// no pattern
if(i<2) return tpl[0];
tpl = jindo.$A(tpl).reverse().$value();
var delete_info;
while(i--) {
if(i%2) {
tpl[i] = tpl[i].replace(jindo.$Template.pattern, function(){
var m = arguments;
// set
if (m[10]) {
return m[10].replace(/(\w+)(?:\s*)=(?:\s*)(?:([a-zA-Z0-9_]+)|(.+))$/g, function(){
var mm = arguments;
var str = "d."+mm[1]+"=";
if(mm[2]){
str+="d."+mm[2];
}else {
str += mm[3].replace( /(=(?:[a-zA-Z_][\w\.]*)+)/g,
function(m){ return (m.substring(0,1)=='=')?"d."+m.replace('=','') : m; }
);
}
return str;
}) + ";";
}
// js
if(m[9]) {
return 's[i++]=' + m[9].replace( /(=(?:[a-zA-Z_][\w\.]*)+)/g,
function(m){ return (m.substring(0,1)=='=')?"d."+m.replace('=','') : m; }
)+';';
}
// variables
if(m[8]) return 's[i++]= d.'+m[8]+';';
// if
if(m[1]) {
return 'if('+m[1].replace(reg[0],cb[0]).replace(/d\.(typeof) /,'$1 ').replace(/ d\.(instanceof) d\./,' $1 ')+'){';
}
// else if
if(m[2]) return '}else if('+m[2].replace(reg[0],cb[0]).replace(/d\.(typeof) /,'$1 ').replace(/ d\.(instanceof) d\./,' $1 ')+'){';
// for loop
if(m[5]) {
delete_info = m[4];
var _aStr = [];
_aStr.push('var t#=d.'+m[5]+'||{},p#=isArray(t#),i#=0;');
_aStr.push('for(var x# in t#){');
_aStr.push('if(!t#.hasOwnProperty(x#)){continue;}');
_aStr.push(' if( (p# && isNaN(i#=parseInt(x#,10))) || (!p# && !t#.propertyIsEnumerable(x#)) ) continue;');
_aStr.push(' d.'+m[4]+'=t#[x#];');
_aStr.push(m[3]?'d.'+m[3]+'=p#?i#:x#;':'');
return _aStr.join("").replace(reg[4], lev++ );
}
// else
if(m[6]) return '}else{';
// end if, end for
if(m[7]) {
if(m[7]=="for"){
return "delete d."+delete_info+"; };";
}else{
return '};';
}
}
return m[0];
});
}else if(tpl[i] == key) {
tpl[i] = "";
}else if(tpl[i]){
tpl[i] = 's[i++]="'+tpl[i].replace(reg[1],cb[1])+'";';
}
}
tpl = jindo.$A(tpl).reverse().$value().join('').replace(new RegExp(leftBrace,'g'),"{").replace(new RegExp(rightBrace,'g'),"}");
var _aStr = [];
_aStr.push('var s=[],i=0;');
_aStr.push('function isArray(o){ return Object.prototype.toString.call(o) == "[object Array]" };');
_aStr.push(tpl);
_aStr.push('return s.join("");');
tpl = eval("false||function(d){"+_aStr.join("")+"}");
tpl = tpl(data);
//(new Function("d",_aStr.join("")))(data);
return tpl;
};
/**
* @fileOverview $Date의 생성자 및 메서드를 정의한 파일
* @name date.js
*/
/**
* $Date 객체를 생성하고 리턴한다.
* ISO문자를 넣은 경우 jindo.$Date.utc을 기반하여 계산된다.
* @extends core
* @class $Date 클래스는 날짜를 처리하기 위한 Date 타입의 레퍼(Wrapper) 클래스이다.
* @constructor
* @author Kim, Taegon
* @example
$Date();
$Date(milliseconds);
$Date(dateString);
//1.4.6 이후 부터 달까지만 넣어도 $Date사용 가능하여 빈 값은 1로 셋팅.
$Date(year, month, [date, [hours, [minitues, [seconds, [milliseconds]]]]]);
$Date(2010,6);//이러고 하면 $Date(2010,6,1,1,1,1,1); 와 같음.
*/
jindo.$Date = function(src) {
var a=arguments,t="";
var cl=arguments.callee;
if (src && src instanceof cl) return src;
if (!(this instanceof cl)) return new cl(a[0],a[1],a[2],a[3],a[4],a[5],a[6]);
if ((t=typeof src) == "string") {
/*
iso string일때
*/
if (/(\d\d\d\d)(?:-?(\d\d)(?:-?(\d\d)))/.test(src)) {
try{
this._date = new Date(src);
if (!this._date.toISOString) {
this._date = jindo.$Date.makeISO(src);
}else if(this._date.toISOString() == "Invalid Date"){
this._date = jindo.$Date.makeISO(src);
}
}catch(e){
this._date = jindo.$Date.makeISO(src);
}
}else{
this._date = cl.parse(src);
}
} else if (t == "number") {
if (typeof a[1] == "undefined") {
/*
하나의 숫지인 경우는 밀리 세켄드로 계산함.
*/
this._date = new Date(src);
}else{
for(var i = 0 ; i < 7 ; i++){
if(typeof a[i] != "number"){
a[i] = 1;
}
}
this._date = new Date(a[0],a[1],a[2],a[3],a[4],a[5],a[6]);
}
} else if (t == "object" && src.constructor == Date) {
(this._date = new Date).setTime(src.getTime());
this._date.setMilliseconds(src.getMilliseconds());
} else {
this._date = new Date;
}
this._names = {};
for(var i in jindo.$Date.names){
if(jindo.$Date.names.hasOwnProperty(i))
this._names[i] = jindo.$Date.names[i];
}
}
jindo.$Date.makeISO = function(src){
var match = src.match(/(\d\d\d\d)(?:-?(\d\d)(?:-?(\d\d)(?:[T ](\d\d)(?::?(\d\d)(?::?(\d\d)(?:\.(\d+))?)?)?(Z|(?:([-+])(\d\d)(?::?(\d\d))?)?)?)?)?)?/);
var hour = parseInt(match[4]||0,10);
var min = parseInt(match[5]||0,10);
if (match[8] == "Z") {
hour += jindo.$Date.utc;
}else if(match[9] == "+" || match[9] == "-"){
hour += (jindo.$Date.utc - parseInt(match[9]+match[10],10));
min += parseInt(match[9] + match[11],10);
}
return new Date(match[1]||0,parseInt(match[2]||0,10)-1,match[3]||0,hour ,min ,match[6]||0,match[7]||0);
}
/**
* names 속성은 $Date에서 사용할 달, 요일, 오전/오후의 이름을 문자열로 저장한다. s_ 를 접두어로 가지는 이름들은 약어(abbreviation)이다.
*/
jindo.$Date.names = {
month : ["January","Febrary","March","April","May","June","July","August","September","October","Novermber","December"],
s_month : ["Jan","Feb","Mar","Apr","May","Jun","Jul","Aug","Sep","Oct","Nov","Dec"],
day : ["Sunday","Monday","Tuesday","Wednesday","Thursday","Friday","Saturday"],
s_day : ["Sun","Mon","Tue","Wed","Thu","Fri","Sat"],
ampm : ["AM", "PM"]
};
/**
* UTC는 <a href="http://ko.wikipedia.org/wiki/UTC">협정 세계시간</a>으로 한국을 기준으로 기본 값이 +9시간이다.
* @example
jindo.$Date.utc = -10; 을 하면 하와이를 기준으로 계산된다.
*/
jindo.$Date.utc = 9;
/**
* now 메서드는 현재 시간을 밀리초 단위의 정수로 리턴한다.
* @return {Number} 밀리초 단위의 정수인 현재 시간
*/
jindo.$Date.now = function() {
return Date.now();
};
/**
* names속성을 셋팅 혹은 가져 온다.(1.4.1 추가)
* @param {Object} oNames
*/
jindo.$Date.prototype.name = function(oNames){
if(arguments.length){
for(var i in oNames){
if(oNames.hasOwnProperty(i))
this._names[i] = oNames[i];
}
}else{
return this._names;
}
}
/**
* parse 메서드는 인수로 지정한 문자열을 파싱하여 문자열의 형식에 맞는 Date 객체를 생성한다.
* @param {String} strDate 날짜, 혹은 시간 형식을 지정한 파싱 대상 문자열
* @return {Object} Date 객체.
*/
jindo.$Date.parse = function(strDate) {
return new Date(Date.parse(strDate));
};
/**
* $value 메서드는 $Date가 감싸고 있던 원본 Date 객체를 반환한다.
* @returns {Object} Date 객체
*/
jindo.$Date.prototype.$value = function(){
return this._date;
};
/**
* format 메서드는 $Date 객체가 저장하고 있는 시간을 인수로 지정한 형식 문자열에 맞추어 변환한다. 형식 문자열은 PHP의 date 함수와 동일하게 사용한다.
<table>
<caption>날짜</caption>
<thead>
<tr>
<th scope="col">문자</th>
<th scope="col">설명</th>
<th scope="col">기타</th>
</tr>
</thead>
<tbody>
<tr>
<td>d</td>
<td>두자리 날짜</td>
<td>01 ~ 31</td>
</tr>
<tr>
<td>j</td>
<td>0 없는 날짜</td>
<td>1 ~ 31</td>
</tr>
<tr>
<td>l (소문자L)</td>
<td>주의 전체 날짜</td>
<td>$Date.names.day에 지정되는 날짜</td>
</tr>
<tr>
<td>D</td>
<td>요약된 날짜</td>
<td>$Date.names.s_day에 지정된 날짜</td>
</tr>
<tr>
<td>w</td>
<td>그 주의 몇번째 일</td>
<td>0(일) ~ 6(토)</td>
</tr>
<tr>
<td>N</td>
<td>ISO-8601 주의 몇번째 일</td>
<td>1(월) ~ 7(일)</td>
</tr>
<tr>
<td>S</td>
<td>2글자, 서수형식의 표현(1st, 2nd)</td>
<td>st, nd, rd, th</td>
</tr>
<tr>
<td>z</td>
<td>해당 년도의 몇번째 일(0부터)</td>
<td>0 ~ 365</td>
</tr>
</tbody>
</table>
<table>
<caption>월</caption>
<thead>
<tr>
<th scope="col">문자</th>
<th scope="col">설명</th>
<th scope="col">기타</th>
</tr>
</thead>
<tbody>
<tr>
<td>m</td>
<td>두자리 고정으로 월</td>
<td>01 ~ 12</td>
</tr>
<tr>
<td>n</td>
<td>앞에 0제외 월</td>
<td>1 ~ 12</td>
</tr>
</tbody>
</table>
<table>
<caption>년</caption>
<thead>
<tr>
<th scope="col">문자</th>
<th scope="col">설명</th>
<th scope="col">기타</th>
</tr>
</thead>
<tbody>
<tr>
<td>L</td>
<td>윤년 여부</td>
<td>true, false</td>
</tr>
<tr>
<td>o</td>
<td>4자리 연도</td>
<td>2010</td>
</tr>
<tr>
<td>Y</td>
<td>o와 같음.</td>
<td>2010</td>
</tr>
<tr>
<td>y</td>
<td>2자리 연도</td>
<td>10</td>
</tr>
</tbody>
</table>
<table>
<caption>시</caption>
<thead>
<tr>
<th scope="col">문자</th>
<th scope="col">설명</th>
<th scope="col">기타</th>
</tr>
</thead>
<tbody>
<tr>
<td>a</td>
<td>소문자 오전, 오후</td>
<td>am,pm</td>
</tr>
<tr>
<td>A</td>
<td>대문자 오전,오후</td>
<td>AM,PM</td>
</tr>
<tr>
<td>g</td>
<td>(12시간 주기)0없는 두자리 시간.</td>
<td>1~12</td>
</tr>
<tr>
<td>G</td>
<td>(24시간 주기)0없는 두자리 시간.</td>
<td>0~24</td>
</tr>
<tr>
<td>h</td>
<td>(12시간 주기)0있는 두자리 시간.</td>
<td>01~12</td>
</tr>
<tr>
<td>H</td>
<td>(24시간 주기)0있는 두자리 시간.</td>
<td>00~24</td>
</tr>
<tr>
<td>i</td>
<td>0포함 2자리 분.</td>
<td>00~59</td>
</tr>
<tr>
<td>s</td>
<td>0포함 2자리 초</td>
<td>00~59</td>
</tr>
<tr>
<td>u</td>
<td>microseconds</td>
<td>654321</td>
</tr>
</tbody>
</table>
<table>
<caption>기타</caption>
<thead>
<tr>
<th scope="col">문자</th>
<th scope="col">설명</th>
<th scope="col">기타</th>
</tr>
</thead>
<tbody>
<tr>
<td>U</td>
<td>Unix Time(1970 00:00:00 GMT) </td>
<td></td>
</tr>
</tbody>
</table>
* @param {Date} strFormat 형식 문자열
* @returns {String} 시간을 형식 문자열에 맞추어 변환한 문자열.
* @example
var oDate = $Date("Jun 17 2009 12:02:54");
oDate.format("Y.m.d(D) A H:i") => "2009.06.17(Wed) PM 12:02"
*/
jindo.$Date.prototype.format = function(strFormat){
var o = {};
var d = this._date;
var name = this.name();
var self = this;
return (strFormat||"").replace(/[a-z]/ig, function callback(m){
if (typeof o[m] != "undefined") return o[m];
switch(m) {
case"d":
case"j":
o.j = d.getDate();
o.d = (o.j>9?"":"0")+o.j;
return o[m];
case"l":
case"D":
case"w":
case"N":
o.w = d.getDay();
o.N = o.w?o.w:7;
o.D = name.s_day[o.w];
o.l = name.day[o.w];
return o[m];
case"S":
return (!!(o.S=["st","nd","rd"][d.getDate()]))?o.S:(o.S="th");
case"z":
o.z = Math.floor((d.getTime() - (new Date(d.getFullYear(),0,1)).getTime())/(3600*24*1000));
return o.z;
case"m":
case"n":
o.n = d.getMonth()+1;
o.m = (o.n>9?"":"0")+o.n;
return o[m];
case"L":
o.L = self.isLeapYear();
return o.L;
case"o":
case"Y":
case"y":
o.o = o.Y = d.getFullYear();
o.y = (o.o+"").substr(2);
return o[m];
case"a":
case"A":
case"g":
case"G":
case"h":
case"H":
o.G = d.getHours();
o.g = (o.g=o.G%12)?o.g:12;
o.A = o.G<12?name.ampm[0]:name.ampm[1];
o.a = o.A.toLowerCase();
o.H = (o.G>9?"":"0")+o.G;
o.h = (o.g>9?"":"0")+o.g;
return o[m];
case"i":
o.i = (((o.i=d.getMinutes())>9)?"":"0")+o.i;
return o.i;
case"s":
o.s = (((o.s=d.getSeconds())>9)?"":"0")+o.s;
return o.s;
case"u":
o.u = d.getMilliseconds();
return o.u;
case"U":
o.U = self.time();
return o.U;
default:
return m;
}
});
};
/**
* time 메서드는 GMT 1970/01/01 00:00:00을 기준으로 경과한 시간을 설정하거나 가져온다.
* @param {Number} nTime 밀리 초 단위의 시간 값.
* @return {$Date | Number} 인수를 지정했다면 GMT 1970/01/01 00:00:00 에서 부터 인수만큼 지난 시간을 설정한 $DAte 객체. 인수를 지정하지 않았다면 GMT 1970/01/01 00:00:00에서 부터 $Date 객체에 지정된 시각까지 경과한 시간(밀리 초).
*/
jindo.$Date.prototype.time = function(nTime) {
if (typeof nTime == "number") {
this._date.setTime(nTime);
return this;
}
return this._date.getTime();
};
/**
* year 메서드는 년도를 설정하거나 가져온다.
* @param {Number} nYear 설정할 년도값
* @return {$Date | Number} 인수를 지정하였다면 새로 년도 값을 설정한 $Date 객체. 인수를 지정하지 않았다면 $Date 객체가 지정하고 있는 시각의 년도를 리턴한다.
*/
jindo.$Date.prototype.year = function(nYear) {
if (typeof nYear == "number") {
this._date.setFullYear(nYear);
return this;
}
return this._date.getFullYear();
};
/**
* month 메서드는 달을 설정하거나 가져온다.
* @param {Number} nMon 설정할 달의 값
* @return {$Date | Number} 인수를 지정하였다면 새로 달을 설정한 $Date 객체. 인수를 지정하지 않았다면 $Date 객체가 지정하고 있는 시각의 달을 리턴한다.
* @remark 리턴 값의 범위는 0(1월)에서 11(12월)이다.
*/
jindo.$Date.prototype.month = function(nMon) {
if (typeof nMon == "number") {
this._date.setMonth(nMon);
return this;
}
return this._date.getMonth();
};
/**
* date 메서드는 날짜를 설정하거나 가져온다.
* @param {nDate} nDate 설정할 날짜 값
* @return {$Date | Number} 인수를 지정하였다면 새로 날짜를 설정한 $Date 객체. 인수를 지정하지 않았다면 $Date 객체가 지정하고 있는 시각의 날짜를 리턴한다.
*/
jindo.$Date.prototype.date = function(nDate) {
if (typeof nDate == "number") {
this._date.setDate(nDate);
return this;
}
return this._date.getDate();
};
/**
* day 메서드는 요일을 가져온다.
* @return {Number} 요일 값. 0(일요일)에서 6(토요일)을 리턴한다.
*/
jindo.$Date.prototype.day = function() {
return this._date.getDay();
};
/**
* hours 메서드는 시(時)를 설정하거나 가져온다.
* @param {Number} nHour 설정할 시 값
* @return {$Date | Number} 인수를 지정하였다면 새로 시 값을 설정한 $Date 객체. 인수를 지정하지 않았다면 $Date 객체가 지정하고 있는 시각의 시 값.
*/
jindo.$Date.prototype.hours = function(nHour) {
if (typeof nHour == "number") {
this._date.setHours(nHour);
return this;
}
return this._date.getHours();
};
/**
* minutes 메서드는 분을 설정하거나 가져온다.
* @param {Number} nMin 설정할 분 값
* @return {Number} 인수를 지정하였다면 새로 분 값을 설정한 $Date 객체. 인수를 지정하지 않았다면 $Date 객체가 지정하고 있는 시각의 분 값.
*/
jindo.$Date.prototype.minutes = function(nMin) {
if (typeof nMin == "number") {
this._date.setMinutes(nMin);
return this;
}
return this._date.getMinutes();
};
/**
* seconds 메서드는 초을 설정하거나 가져온다.
* @param {Number} nSec 설정할 초 값
* @return {Number} 인수를 지정하였다면 새로 초 값을 설정한 $Date 객체. 인수를 지정하지 않았다면 $Date 객체가 지정하고 있는 시각의 초 값.
*/
jindo.$Date.prototype.seconds = function(nSec) {
if (typeof nSec == "number") {
this._date.setSeconds(nSec);
return this;
}
return this._date.getSeconds();
};
/**
* isLeapYear 메서드는 시각의 윤년 여부를 확인한다.
* @returns {Boolean} $Date가 가리키고 있는 시각이 윤년이면 True, 그렇지 않다면 False
*/
jindo.$Date.prototype.isLeapYear = function() {
var y = this._date.getFullYear();
return !(y%4)&&!!(y%100)||!(y%400);
};
/**
* @fileOverView $Window의 생성자 및 메서드를 정의한 파일
* @name window.js
*/
/**
* $Window 객체를 생성하고 생성한 객체를 리턴한다.
* @class $Window 객체는 브라우저가 제공하는 window 객체를 래핑하고, 이를 다루기 위한 여러가지 메서드를 제공한다.
* @param {HTMLWidnow} el
* <br>
* $Window로 래핑할 window 엘리먼트.
* @author gony
*/
jindo.$Window = function(el) {
var cl = arguments.callee;
if (el instanceof cl) return el;
if (!(this instanceof cl)) return new cl(el);
this._win = el || window;
}
/**
* $value 메서드는 원래의 window 객체를 리턴한다.
* @return {HTMLWindow} window 엘리먼트
* @example
$Window().$value(); // 원래의 window 객체를 리턴한다.
*/
jindo.$Window.prototype.$value = function() {
return this._win;
};
/**
* resizeTo 메서드는 창의 크기를 지정한 크기로 변경한다.<br>
* 이 크기는 프레임을 포함한 창 전체의 크기를 나타내므로 실제로 표현하는 컨텐트 사이즈는 브라우저 종류와 설정에 따라 달라질 수 있다.<br>
* 브라우저에 따라 보안 문제 때문에, 창 크기가 화면의 가시 영역을 벗어나서 커지지 못하도록 막는 경우도 있다. 이 경우에는 지정한 크기보다 작게 창이 커진다.<br>
* @param {Number} nWidth 창의 너비
* @param {Number} nHeight 창의 높이
* @return {$Window} $Window 객체
* @see $Window#resizeBy
* @example
* // 현재 창의 너비를 400, 높이를 300으로 변경한다.
* $Window.resizeTo(400, 300);
*/
jindo.$Window.prototype.resizeTo = function(nWidth, nHeight) {
this._win.resizeTo(nWidth, nHeight);
return this;
};
/**
* resizeBy 메서드는 창의 크기를 지정한 크기만큼 변경한다.
* @param {Number} nWidth 늘어날 창의 너비
* @param {Number} nHeight 늘어날 창의 높이
* @see $Window#resizeTo
* @example
* // 현재 창의 너비를 100, 높이를 50 만큼 늘린다.
* $Window().resize(100, 50);
*/
jindo.$Window.prototype.resizeBy = function(nWidth, nHeight) {
this._win.resizeBy(nWidth, nHeight);
return this;
};
/**
* moveTo 메서드는 창을 지정한 위치로 이동시킨다. 좌표는 프레임을 포함한 창의 좌측 상단을 기준으로 한다.
* @param {Number} nLeft 이동할 x좌표 (pixel 단위)
* @param {Number} nTop 이동할 y좌표 (pixel 단위)
* @see $Window#moveBy
* @example
* // 현재 창을 (15, 10) 으로 이동시킨다.
* $Window().moveTo(15, 10);
*/
jindo.$Window.prototype.moveTo = function(nLeft, nTop) {
this._win.moveTo(nLeft, nTop);
return this;
};
/**
* moveBy 메서드는 창을 지정한 위치만큼 이동시킨다.
* @param {Number} nLeft x좌표로 이동할 만큼의 양 (pixel 단위)
* @param {Number} nTop y좌표로 이동할 만큼의 양 (pixel 단위)
* @see $Window#moveTo
* @example
* // 현재 창을 좌측으로 15px만큼, 아래로 10px만큼 이동시킨다.
* $Window().moveBy(15, 10);
*/
jindo.$Window.prototype.moveBy = function(nLeft, nTop) {
this._win.moveBy(nLeft, nTop);
return this;
};
/**
* sizeToContent 메서드는 내부 문서의 컨텐츠 크기에 맞추어 창의 크기를 변경하며, 몇 가지 제약 사항을 가진다. <br>
* 제약사항에 걸리는 경우 매개변수로 창의 사이즈를 지정할 수 있다.
<ul>
<li>메서드의 내부 문서가 완전히 로딩된 다음에 실행되어야 한다. </li>
<li>창이 내부 문서보다 큰 경우에는 내부 문서를 구할 수 없으므로, 반드시 창 크기를 내부 문서보다 작게 만든다.</li>
<li>반드시 body에 사이즈가 있어야 한다.</li>
<li>html의 DOCTYPE이 Quirks일때 맥에서는 opera(10), 윈도우에서는 IE6+, opera(10), safari(4)에서 정상적으로 동작하지 않는다.</li>
<li>가능 하면 부모창에서 실행 시켜야 한다. 자식창이 모니터 화면을 벗어나 가려져 있을 경우, IE는 가려진 영역은 컨텐츠가 없는 것으로 판단하여 가려진 영역 만큼 줄인다.</li>
</ul>
* @param {Number} nWidth 창의 너비
* @param {Number} nHeight 창의 높이
* @example
* // 새 창을 띄우고 자동으로 창 크기를 컨텐트에 맞게 변경하는 함수
* function winopen(url) {
* try {
* win = window.open(url, "", "toolbar=0,location=0,status=0,menubar=0,scrollbars=0,resizable=0,width=250,height=300");
* win.moveTo(200, 100);
* win.focus();
* } catch(e){}
*
* setTimeout(function() {
* $Window(win).sizeToContent();
* }, 1000);
* }
*
* winopen('/samples/popup.html');
*/
jindo.$Window.prototype.sizeToContent = function(nWidth, nHeight) {
if (typeof this._win.sizeToContent == "function") {
this._win.sizeToContent();
} else {
if(arguments.length != 2){
// use trick by Peter-Paul Koch
// http://www.quirksmode.org/
var innerX,innerY;
var self = this._win;
var doc = this._win.document;
if (self.innerHeight) {
// all except Explorer
innerX = self.innerWidth;
innerY = self.innerHeight;
} else if (doc.documentElement && doc.documentElement.clientHeight) {
// Explorer 6 Strict Mode
innerX = doc.documentElement.clientWidth;
innerY = doc.documentElement.clientHeight;
} else if (doc.body) {
// other Explorers
innerX = doc.body.clientWidth;
innerY = doc.body.clientHeight;
}
var pageX,pageY;
var test1 = doc.body.scrollHeight;
var test2 = doc.body.offsetHeight;
if (test1 > test2) {
// all but Explorer Mac
pageX = doc.body.scrollWidth;
pageY = doc.body.scrollHeight;
} else {
// Explorer Mac;
//would also work in Explorer 6 Strict, Mozilla and Safari
pageX = doc.body.offsetWidth;
pageY = doc.body.offsetHeight;
}
nWidth = pageX - innerX;
nHeight = pageY - innerY;
}
this.resizeBy(nWidth, nHeight);
}
return this;
};
/**
* @fileOverview 다른 프레임웍 없이 jindo만 사용할 경우 편의성을 위해 jindo 객체를 window에 붙임
*/
// copy jindo objects to window
if (typeof window != "undefined") {
for (prop in jindo) {
if (jindo.hasOwnProperty(prop)) {
window[prop] = jindo[prop];
}
}
}