Type

engine

Property Summary

Event Summary

Method Summary

appendingPathComponent( starturl , endurl )

url 경로에 다른 경로를 덧붙이는 함수로 /의 유무에 따라 이상동작하는 것을 핸들링.

clearInterval( key , force )

WebSquare

clearPage( )

브라우저를 갱신하여 브라우저를 초기상태로 되돌리는 함수

clearTimeout( key , force )

WebSquare

closePopup( id )

id를 찾아서 popup을 닫아줍니다

createPopup( id , type , popupName , style , useIFrame , modal , srcORurl , srcData , destData , xml )

popup을 속성에 따라 만드는 함수입니다

dbltoHexacode( dbl )

주어진 정수값을 RGB 색상을 표현하기 위한 hexa code 형태로 변환하여 반환니다

first( elem )

주어진 html 객체의 첫 번째 child node를 반환합니다

getBoolean( boolstr )

"ture"면 true를 반환하고 "false"면 false를 반환합니다

getChildNodeAt( obj , idx )

객체 obj의 idx 번째 child node를 반환합니다

getChildren( component , options )

특정 component의 자식 component들을 배열로 반환합니다

getComponentById( id )

주어진 id에 해당하는 웹스퀘어 컴포넌트를 찾아 반환합니다

getData( key )

특정 key로 등록된 data를 가져온다

getDate( str )

Date String에서 '/'를 제거합니다

getDocumentSize( sizeName )

scroll bar 영역의 사이즈는 제외한 document의 width나 height를 구합니다

getFocusedComponentId( )

현재 포커스가 있는 웹스퀘어 객체의 아이디를 반환.

getGlobalFunction( str )

global 영역에서 함수를 찾아와 반환합니다

getIntervalKeyList( )

WebSquare

getNumber( str )

입력된 String에서 콤마(',')를 제거한후 parseInt/parseFloat를 실행한 결과를 반환합니다

getPopup( id )

id를 찾아서 해당 popup component를 반환합니다

getPopupParam( )

popup을 만들때 xml 속성으로 넘긴 xmlDocument의 string를 반환합니다

getPopupWindow( id )

id를 찾아서 해당 popup의 window를 반환합니다

getStringByteSize( str , ignoreChar )

주어진 string의 byte size를 반환합니다

getSubmissionURL( url )

submissionURL 정보를 읽어들여서 필요시 경로처리하는 함수

getTextNodeValue( element )

주어진 html element의 text node 값을 반환합니다

getTime( str )

Time String에서 ':'을 제거합니다

getTimeoutKeyList( )

WebSquare

hexacodetoDbl( hexa )

주어진 hexa code 값을 정수로 변환하여 반환합니다

isInteger( num )

주어진 숫자가 정수인지 판별합니다

isMobile( )

현재 동작중인 기기가 모바일 기기인지 판별

isNull( value )

주어진 값이 null인지 체크합니다

isNumber( value )

주어진 값의 타입이 Number인지 체크합니다

isOdd( num )

주어진 정수가 홀수인지 판별합니다

isPopup( )

현재 Window가 popup이면 true 아니면 false를 반환합니다

isString( value )

주어진 값의 타입이 String인지 체크합니다

js( )

<a href="

last( elem )

주어진 html 객체의 마지막 child node를 반환합니다

multipleExcelDownload( options , infoArr )

그리드의 데이터를 엑셀 파일로 저장합니다

next( elem )

텍스트 노드를 제외한 다음 노드 검색해서 반환합니다

openPopup( url , <Object:Y> , params , target )

popup을 속성에 따라 만드는 함수입니다

parent( elem , num )

주어진 html 객체에서 숫자 num 만큼(없으면 한 단계 위) 상위인 노드를 찾아 반환합니다

parseFloat( str , defaultValue )

parseFloat를 호출합니다

parseInt( str , defaultValue )

parseInt를 호출합니다

prev( elem )

텍스트 노드를 제외한 이전 노드 검색해서 반환합니다

reinitialize( refresh )

브라우저 refresh 없이 페이지를 다시 로딩하거나 또는 브라우저를 refresh합니다

removeData( key )

특정 key로 등록된 data를 제거한다

setData( key , data )

특정 key로 data를 등록한다

setDate( str )

Date String에 '/'를 추가합니다

setDisabled( obj )

컴포넌트 하위로 disabled를 처리한다

setDocumentLang( lang )

html태그의 lang 속성에 언어 코드를 설정 한다

setDomain( domain )

frame 및 popup에서 cross domain을 처리하기 위해 domain을 셋팅한다

setInterval( func , options )

실행할 함수를 함수를 setInterval로 등록하여 함수가 주기적으로 계속 실행되도록 한다

setNumber( str )

입력된 숫자에서 콤마(',')을 추가한 문자열로 변환한 다음 반환 합니다

setTime( str )

Time String에 ':'를 추가합니다

setTimeout( func , options )

실행할 함수를 함수를 setTimer로 등록하여 일정 시간 후에 실행되도록 한다

toHexColor( rgb )

rgb(r, g, b) 형식의 string을 입력받아 #RRGGBB 형식의 color code를 반환합니다

url( w2xPath , options )

화면 이동 시 url전체를 전달하는 대신 w2xPath에 해당하는 경로만 전달하여 페이지를 이동할 수 있게 해주는 함수

appendingPathComponent( starturl , endurl )

url 경로에 다른 경로를 덧붙이는 함수로 /의 유무에 따라 이상동작하는 것을 핸들링.
case 1 : "/hoyoon/" + "/inswave.xml" = "/hoyoon/inswave.xml" (//에서 / 하나 지운다)
case 2 : "/hoyoon" + "/inswave.xml" = "/hoyoon/inswave.xml" (그냥 붙인다)
case 3 : "/hoyoon/" + "inswave.xml" = "/hoyoon/inswave.xml" (그냥 붙인다)
case 4 : "/hoyoon" + "inswave.xml" = "/hoyoon/inswave.xml" (/ 하나 추가한다)
degenerating case : 뒷부분 컴포넌트에 "://" 가 있을 경우(프로토콜이 포함된 절대경로일 경우) 뒷부분만 리턴.

Parameter

name	type	required	description
starturl	String	Y	병합할 url 컴포넌트 앞부분
endurl	String	Y	병합할 url 컴포넌트 뒷부분

Return

type	description
String	병합된 url

clearInterval( key , force )

WebSquare.util.setInterval로 등록한 함수를 직접 clearInterval시킨다.

Parameter

name	type	required	description
key	String	Y	WebSquare.util.setInterval로 등록할 때 options.key로 지정한 키값.
force	Boolean	N	setInterval로 등록된 함수를 한 번 실행할지에 대한 여부. 기본값은 false.

Sample

WebSquare.util.clearInterval("timer1");

clearPage( )

브라우저를 갱신하여 브라우저를 초기상태로 되돌리는 함수. 주로 spa 모드에서 브라우저 초기화가 필요한 경우 onpageunload 이벤트에서 이 함수가 사용된다. Editor 컴포넌트나 Chart컴포넌트 등 spa 모드에서 메모리 릭이 존재하는 컴포넌트 사용 시 해당 페이지의 body에 onpageunload이벤트를 등록하고 이 함수를 호출한다. WebSquare.util.url(WebSquare.baseURI + "blank.xml", {"spa":true, "forceReload":true}); 함수를 호출한 것과 동일하다.

Sample

<body> <script type="javascript" ev:event="onpageunload"><![CDATA[ WebSquare.util.clearPage(); // 브라우저를 갱신하여 초기상태로 되돌린다. 이 경우 웹스퀘어 엔진 및 리소스를 새로 로딩하게 된다. ]]></script> </body>

clearTimeout( key , force )

WebSquare.util.setTimer로 등록한 함수를 직접 clearTimeout시킨다.

Parameter

name	type	required	description
key	String	Y	WebSquare.util.setTimer로 등록할 때 options.key로 지정한 키값.
force	Boolean	N	setTimer로 등록된 함수를 실행할지에 대한 여부. 기본값은 false.

Sample

WebSquare.util.clearTimeout("timer1");

closePopup( id )

id를 찾아서 popup을 닫아줍니다.

Parameter

name	type	required	description
id	String	Y	popup의 id

Sample

WebSquare.util.closePopup("popup1");

createPopup( id , type , popupName , style , useIFrame , modal , srcORurl , srcData , destData , xml )

popup을 속성에 따라 만드는 함수입니다.

Parameter

name	type	required	description
id	String	Y	popup 객체의 ID
type	String	N	popup 객체의 type으로 litewindow, window, browser 중 하나
popupName	String	N	popup 객체의 이름으로 popup 프레임의 표시줄에 나타납니다.
style	String	N	popup 객체의 style
useIFrame	String	N	true, false 두 개의 값을 가질 수 있다. true : IFrame 을 사용하는 WebSquare popup false: window.open 을 사용하는 popup
modal	String	N	true, false 두 개의 값을 가질 수 있다. true : popup 객체의 뒷 배경에 표시되는 component 를 사용할 수 없다. false: popup 객체의 뒷 배경에 표시되는 component 를 사용할 수 있다.
srcORurl	String	Y	popup 객체의 type 이 litewindow, window 인 경우 : 표시될 WebSuqare xml 파일의 이름 popup 객체의 type 이 browser 인 경우 : 표시될 웹 사이트의 주소
srcData	String	N	popup 객체의 type 이 window 일 때 Parent 에서 넘길 xpath
destData	String	N	popup 객체의 type 이 window 일 때 popup 에 설정할 xpath
xml	Array	N	popup 객체에 적용될 xml 문서

Sample

WebSquare.util.createPopup("popup1", "window", "People Profile", "width:600px;height:350px;top:100px;left:100px;", "true", "true", "WebSquare1.xml", peopleNode, "map", peopleNode);

dbltoHexacode( dbl )

주어진 정수값을 RGB 색상을 표현하기 위한 hexa code 형태로 변환하여 반환니다.

Parameter

name	type	required	description
dbl	Number	Y	정수 형태의 RGB 값

Return

type	description
String	hexa code로 변환된 값

Sample

WebSquare.util.dbltoHexacode(16777215);

first( elem )

주어진 html 객체의 첫 번째 child node를 반환합니다.

Parameter

name	type	required	description
elem	Object	Y	하위 노드를 검사할 객체

Return

type	description
Object	elem의 첫 번째 child node

Sample

WebSquare.util.first( xmlDoc);

getBoolean( boolstr )

"ture"면 true를 반환하고 "false"면 false를 반환합니다.

Parameter

name	type	required	description
boolstr	String	Y	boolean string

Return

type	description
Boolean	"ture"면 true, "false"면 false

Sample

WebSquare.util.getBoolean("true");

getChildNodeAt( obj , idx )

객체 obj의 idx 번째 child node를 반환합니다.

Parameter

name	type	required	description
obj	Object	Y	하위 객체를 조사할 객체
idx	Number	Y	하위 객체의 index

Return

type	description
Object	obj의 idx 번째 child node

Sample

WebSquare.util.getChildNodeAt( xmlDoc, 1 );

getChildren( component , options )

특정 component의 자식 component들을 배열로 반환합니다.

Parameter

name	type	required	description
component	Object	N	부모 component. 인자값이 없는 경우 body component가 됩니다.
options	Object	N	options 속성은 아래와 같습니다. <boolean:N> obj.recursive : 자손(descendant)을 포함할 것인지에 대한 옵션으로 기본값은 false. body component인 경우에는 해당 옵션이 무시되어 무조건 false로 적용됩니다. <String:N> obj.excludeId : 제외할 컴포넌트 id. 인자가 여러개일 경우 공백을 구분자로 사용. <String:N> obj.excludePlugin : 제외할 컴포넌트 plugin 이름. 인자가 여러개일 경우 공백을 구분자로 사용.

Return

type	description
Object	component가 담긴 배열

Sample

(ex1) WebSquare.util.getChildren(); 또는 WebSquare.util.getChildren(null, {recursive:true}); => body의 직접적인 자식(immediate children) component를 전부 반환합니다. body의 경우에는 recursive 속성을 무시합니다. (성능 이슈로 body의 경우에는 자식 노드의 재귀적 탐색을 허용하지 않습니다.) (ex2) WebSquare.util.getChildren (group1, {excludePlugin : "trigger output", recursive : true}); => group1의 모든 자식 및 자손 컴포넌트 (descendant) 중에서 trigger와 ouptput을 제외하고 전부 반환합니다. (ex3) WebSquare.util.getChildren(group2, {excludePlugin : "trigger input", excludeId : "treeview1_tooltip windowContainer1_tooltip"); => group1의 직접적인 자식(immediate children) component 중 trigger, output component 및 id가 treeview1_tooltip, widnowContainer1_tooltip인 component를 제외한 배열을 반환한다.

getComponentById( id )

주어진 id에 해당하는 웹스퀘어 컴포넌트를 찾아 반환합니다.

Parameter

name	type	required	description
id	String	Y	웹스퀘어 컴포넌트의 ID

Return

type	description
Object	웹스퀘어 컴포넌트 객체

Sample

var output1 = WebSquare.util.getComponentById("output1");

getData( key )

특정 key로 등록된 data를 가져온다.

Parameter

name	type	required	description
key	String	Y	꺼내오고자 하는 data의 key값

Return

type	description
Object	key에 해당하는 data

Sample

var itemList = WebSquare.util.getData("item1").itemList;

getDate( str )

Date String에서 '/'를 제거합니다.

Parameter

name	type	required	description
str	String	Y	Date String

Return

type	description
String	입력받은 str에서 '/'를 제거한 String

Sample

var data = WebSquare.util.getDate("2012/01/01"); date : 20120101

getDocumentSize( sizeName )

scroll bar 영역의 사이즈는 제외한 document의 width나 height를 구합니다.

Parameter

name	type	required	description
sizeName	String	Y	"width"나 "height"에 해당하는 string

Return

type	description
Number	document의 크기 값

Sample

WebSquare.util.getDocumentSize("width");

getFocusedComponentId( )

현재 포커스가 있는 웹스퀘어 객체의 아이디를 반환.
(버전 정보: 5.0_1.2783B.20170908.145609 버전에서 추가.)

getGlobalFunction( str )

global 영역에서 함수를 찾아와 반환합니다. 함수가 객체 내부에 있을 경우에도 찾아옵니다.

Parameter

name	type	required	description
str	String	Y	함수를 나타내는 string

Return

type	description
Function	반환할 함수

Sample

var func = WebSquare.util.getGlobalFunction("obj.formatter");

getIntervalKeyList( )

WebSquare.util.setIntervalKey로 등록된 키값 전부를 array로 반환한다.

Return

type	description
Object	getIntervalKey로 등록된 키값

Sample

var IntervalKeyList = WebSquare.util.getIntervalKeyList(); for(var i = 0; i < IntervalKeyList.length; i++) { WebSquare.util.clearInterval(IntervalKeyList[i]); } // 등록된 타이머를 전부 제거

getNumber( str )

입력된 String에서 콤마(',')를 제거한후 parseInt/parseFloat를 실행한 결과를 반환합니다.

Parameter

name	type	required	description
str	String	Y	string 형태의 숫자

Return

type	description
Number	입력된 string을 숫자로 변환 한 값

Sample

var data = WebSquare.util.getNumber("2,000"); data : 2000

getPopup( id )

id를 찾아서 해당 popup component를 반환합니다.

Parameter

name	type	required	description
id	String	Y	popup의 id

Return

type	description
Object	해당 popup component

Sample

var popObj = WebSquare.util.getPopup("popup1");

getPopupParam( )

popup을 만들때 xml 속성으로 넘긴 xmlDocument의 string를 반환합니다.

Return

type	description
String	popup을 만들때 xml 속성으로 넘긴 xmlDocument의 string

Sample

var dataStr = WebSquare.util.getPopupParam();

getPopupWindow( id )

id를 찾아서 해당 popup의 window를 반환합니다.

Parameter

name	type	required	description
id	String	Y	popup의 id

Return

type	description
Object	해당 popup의 window

Sample

var popObj = WebSquare.util.getPopup("popup1");

getStringByteSize( str , ignoreChar )

주어진 string의 byte size를 반환합니다.

Parameter

name	type	required	description
str	String	Y	byte size를 알아낼 string
ignoreChar	String	N	byte size 체크시 무시할 문자

Return

type	description
Number	byte size

Sample

var data = WebSquare.util.getStringByteSize("websquare"); data : 9

getSubmissionURL( url )

submissionURL 정보를 읽어들여서 필요시 경로처리하는 함수. appendingPathComponent 사용함.

Parameter

name	type	required	description
url	String	Y	기본 url 주소

Return

type	description
String	submissionURL 처리 된 url

getTextNodeValue( element )

주어진 html element의 text node 값을 반환합니다.

Parameter

name	type	required	description
element	Object	Y	html element

Return

type	description
String	text node string

Sample

WebSquare.util.getTextNodeValue( xmlDoc);

getTime( str )

Time String에서 ':'을 제거합니다.

Parameter

name	type	required	description
str	String	Y	Time String

Return

type	description
String	입력받은 str에서 ':'를 제거한 String

Sample

var data = WebSquare.util.getTime("11:23"); data : 1123

getTimeoutKeyList( )

WebSquare.util.setTimer로 등록된 키값 전부를 array로 반환한다.

Return

type	description
Object	setTimer로 등록된 키값

Sample

var timeoutKeyList = WebSquare.util.getTimeoutKeyList(); for(var i = 0; i < timeoutKeyList.length; i++) { WebSquare.util.clearTimeout(timeoutKeyList[i]); } // 등록된 타이머를 전부 제거

hexacodetoDbl( hexa )

주어진 hexa code 값을 정수로 변환하여 반환합니다.

Parameter

name	type	required	description
hexa	String	Y	hexa code 값

Return

type	description
Number	정수로 변환된 값

Sample

WebSquare.util.hexacodetoDbl("A0D39C");

isInteger( num )

주어진 숫자가 정수인지 판별합니다.

Parameter

name	type	required	description
num	String	Y	Number 또는 Number String

Return

type	description
Boolean	정수라면 true, 정수가 아니면 false

Sample

WebSquare.util.isInteger(10)

isMobile( )

현재 동작중인 기기가 모바일 기기인지 판별. 아이폰, 아이패드, 아이팟터치, 안드로이드, 블랙베리를 판별 가능.

Return

type	description
Boolean	모바일 기기인 경우 true, 아닌 경우 false를 반환.

isNull( value )

주어진 값이 null인지 체크합니다.

Parameter

name	type	required	description
value	Obejct	Y	null 체크를 할 값

Return

type	description
Boolean	null이라면 true, 아니라면 false

isNumber( value )

주어진 값의 타입이 Number인지 체크합니다.

Parameter

name	type	required	description
value	Obejct	Y	type 체크를 할 값

Return

type	description
Boolean	type이 Number라면 true, 아니라면 false

Sample

var data = WebSquare.util.isNumber("12"); data : false

isOdd( num )

주어진 정수가 홀수인지 판별합니다.

Parameter

name	type	required	description
num	String	Y	Number String

Return

type	description
Boolean	홀수라면 true, 짝수라면 false

Sample

WebSquare.util.isOdd(11);

isPopup( )

현재 Window가 popup이면 true 아니면 false를 반환합니다.

Return

type	description
boolean	팝업창인지 여부를 반환합니다.

Sample

var ispopup = WebSquare.util.isPopup();

isString( value )

주어진 값의 타입이 String인지 체크합니다.

Parameter

name	type	required	description
value	Obejct	Y	type 체크를 할 값

Return

type	description
Boolean	type이 String라면 true, 아니라면 false

Sample

var data = WebSquare.util.isString("12"); data : true

js( )

$w.js 와 동일

last( elem )

주어진 html 객체의 마지막 child node를 반환합니다.

Parameter

name	type	required	description
elem	Object	Y	하위 노드를 검사할 객체

Return

type	description
Object	elem의 마지막 child node

Sample

WebSquare.util.last(xmlDoc);

multipleExcelDownload( options , infoArr )

그리드의 데이터를 엑셀 파일로 저장합니다. provider 설정시에만 동작 합니다. sheetName은 중복되지 않게 설정해야 합니다. (JDK 1.5이상에서 사용 가능)

Parameter

name	type	required	description
options	Object	Y	JSON형태로 저장된 그리드의 엑셀 다운로드 옵션 <String:N> options.fileName : [defalut: excel.xls] 다운로드하려는 파일의 이름 <String:N> options.sheetName : [defalut: sheet] excel의 sheet의 이름 <String:N> options.rowsByN : [defalut: 100] 다운로드 가능한 최대 행 개수 (예: 이 값이 "1000"인 경우 1000 건 이상은 다운로드 할 수 없음.) <String:N> options.type : [defalut: 0] type이 0인 경우 실제 데이터 1인 경우 눈에 보이는 데이터를 2이면 들어가 있는 data 그대로(filter무시 expression 타입의 셀은 나오지 않음) <String:N> options.removeColumns : [defalut: 없음] 다운로드시 excel에서 삭제하려는 열의 번호(여러 개일 경우 ,로 구분) <String:N> options.removeHeaderRows : [defalut: 없음] 다운로드시 excel에서 삭제하려는 Header의 row index(여러 개일 경우 ,로 구분) <String:N> options.foldColumns : [defalut: 없음] 다운로드시 excel에서 fold하려는 열의 번호(여러 개일 경우 ,로 구분) <Number:N> options.startRowIndex : [defalut: 0] excel파일에서 그리드의 데이터가 시작되는 행의 번호(헤더 포함) <Number:N> options.startColumnIndex : [defalut: 0] excel파일에서 그리드의 데이터가 시작되는 열의 번호(헤더 포함) <String:N> options.headerColor : [defalut: #33CCCC] excel파일에서 그리드의 header부분의 색 <String:N> options.headerFontName : [defalut: 없음] excel파일에서 그리드의 header부분의 font name <String:N> options.headerFontSize : [defalut: 10] excel파일에서 그리드의 header부분의 font size <String:N> options.headerFontColor : [defalut: 없음] excel파일에서 그리드의 header부분의 font색 <String:N> options.bodyColor : [defalut: #FFFFFF] excel파일에서 그리드의 body부분의 색 <String:N> options.bodyFontName : [defalut: 없음] excel파일에서 그리드의 body부분의 font name <String:N> options.bodyFontSize : [defalut: 10] excel파일에서 그리드의 body부분의 font size <String:N> options.bodyFontColor : [defalut: 없음] excel파일에서 그리드의 body부분의 font색 <String:N> options.subTotalColor : [defalut: #CCFFCC] excel파일에서 그리드의 subtotal부분의 색 <String:N> options.subTotalFontName : [defalut: 없음] excel파일에서 그리드의 subtotal부분의 font name <String:N> options.subTotalFontSize : [defalut: 10] excel파일에서 그리드의 subtotal부분의 font size <String:N> options.subTotalFontColor : [defalut: 없음] excel파일에서 그리드의 subtotal부분의 font색 <String:N> options.footerColor : [defalut: #008000] excel파일에서 그리드의 footer부분의 색 <String:N> options.footerFontName : [defalut: 없음] excel파일에서 그리드의 footer부분의 font name <String:N> options.footerFontSize : [defalut: 10] excel파일에서 그리드의 footer부분의 font size <String:N> options.footerFontColor : [defalut: 없음] excel파일에서 그리드의 footer부분의 font색 <Boolean:N> options.showProcess : [defalut: true] 다운로드 시 프로세스 창을 보여줄지 여부 <String:N> options.dataProvider : [defalut: 없음] 대량데이터 처리 및 사용자 데이터를 가공할 수 있는 Provider Package <String:N> options.providerRequestXml : [defalut: 없음] Provider 내부에서 사용할 XML 문자열 <String:N> options.userDataXml : [defalut: 없음] 사용자가 서버모듈 개발 시 필요한 데이터를 전송 할 수 있는 변수 <Boolean:N> options.bodyWordwrap : [defalut: false] 다운로드시 바디의 줄 바꿈 기능 <String:N> options.useEuroLocale : [defalut: false] 다운로드시 유로화 처리 기능(,와 .이 반대인 경우처리) <String:N> options.useHeader : [defalut: true] 다운로드시 Header를 출력 할지 여부( "true"인경우 출력, "false"인경우 미출력) <String:N> options.useSubTotal : [defalut: false] 다운로드시 SubTotal을 출력 할지 여부( "true"인경우 출력, "false"인경우 미출력), expression을 지정한 경우 avg,sum,min,max,targetColValue,숫자를 지원 함. <String:N> options.useFooter : [defalut: true] 다운로드시 Footer를 출력 할지 여부( "true"인경우 출력, "false"인경우 미출력) <String:N> options.separator : [defalut: ,] 다운로드시 서버로 데이터 전송할때, 데이터를 구분짓는 구분자, default는 comma(,) <Number:N> options.subTotalScale : [defalut: -1] 다운로드시 subTotal 평균계산시 소수점 자리수를 지정 <String:N> options.subTotalRoundingMode : [defalut: 없음] 다운로드시 subTotal 평균계산시 Round를 지정 한다. ("CEILING","FLOOR","HALF_UP") <String:N> options.useStyle : [defalut: false] 다운로드시 css를 제외한, style을 excel에도 적용할 지 여부 (배경색,폰트) <String:N> options.freezePane : [defalut: ""] 틀고정을 위한 좌표값 및 좌표값의 오픈셋 ( ex) freezePane="3,4" X축 3, Y축 4에서 틀고정, freezePane="0,1,0,5" X축 0, Y축 1에서 X축으로 0, Y축으로 5로 틀공정 ) <String:N> options.autoSizeColumn : [defalut: false] 너비자동맞춤 설정 유무 <String:N> options.displayGridlines : [defalut: false] 엑셀 전체 셀의 눈금선 제거 유무 <String:N> options.colMerge : [defalut: false] colMerge된 컬럼을 Merge해서 출력 할 지 여부 <String:N> options.useDataFormat : [defalut: 없음] 그리드 dataType이 text인 경우, 엑셀의 표시형식 '텍스트' 출력 유무( "true"인 경우 표시형식 텍스트, "false"인 경우 표시형식 일반 출력) <Object:N> options.printSet JSON형태로 저장된 Excel Print관련 설정 <String:N> options.printSet.fitToPage : [defalut: false] 엑셀 프린터 출력시 쪽맞춤 사용 유무 <String:N> options.printSet.landScape : [defalut: false] 엑셀 프린터 출력시 가로 방향 출력 유무 <String:N> options.printSet.fitWidth : [defalut: 1] 엑셀 프린터 출력시 용지너비 <String:N> options.printSet.fitHeight : [defalut: 1] 엑셀 프린터 출력시 용지높이 <String:N> options.printSet.scale : [defalut: 100] 엑셀 프린터 출력시 확대/축소 배율, scale을 사용할 경우 fitToPage는 false로 설정 해야 한다. <String:N> options.printSet.pageSize : [defalut: A4] 엑셀 프린터 출력시 인쇄 용지 크기 (예: "A3", "A4", "A5", "B4") 단, fitToPage: true 인 경우에만 유효.
infoArr	Object	N	그리드에 대한 내용을 추가로 다른 셀에 표현하는 경우 사용하는 배열 <Number:N> infoArr.rowIndex : 내용을 표시할 행번호 <Number:N> infoArr.colIndex : 내용을 표시할 열번호 <Number:N> infoArr.rowSpan : 병합할 행의 수 <Number:N> infoArr.colSpan : 병합할 열의 수 <String:N> infoArr.text : 표시할 내용 <String:N> infoArr.textAlign : 표시할 내용의 정렬 방법 (left, center, right) <String:N> infoArr.fontSize : font size 설정 ( ex) "20px" ) <String:N> infoArr.fontName : font name 설정 <String:N> infoArr.color : font color 설정 ( ex) "red" ) <String:N> infoArr.fontWeight : font weight 설정 ( ex) "bold" ) <String:N> infoArr.drawBorder : cell의 border 지정 ( ex) true ) <String:N> infoArr.wordWrap : cell의 줄 바꿈 기능 ( ex) "true" )

Sample

// id가 a,b,c,d,e인 5개 컬럼이 존재하는 그리드 var options = { common: { fileName : "user.xls", showProcess : true, printSet : { landScape : "true", fitToPage : "true", fitWidth : "1", fitHeight : "1", scale : "222" } }, excelInfo: [ { gridId : "grid1", sheetName : "첫번째 sheet", type : "1", removeColumns : "1,3", foldColumns : "2", startRowIndex : 3, startColumnIndex : 0, headerColor : "#DBEEF3", bodyColor : "#92CDDC", dataProvider : "com.provider.Provider1", providerRequestXml : "<info><key value='TEST'/><info>", infoArr : [ { rowIndex : 1, colIndex : 3, rowSpan : 1, colSpan : 2, text : "데이터표시" , textAlign : "center" } ] }, { gridId : "grid2", sheetName : "두번째 sheet", type : "1", removeColumns : "1,3", foldColumns : "2", startRowIndex : 3, startColumnIndex : 0, headerColor : "#DBEEF3", bodyColor : "#92CDDC", dataProvider : "com.provider.Provider1", providerRequestXml : "<info><key value='TEST'/><info>", infoArr : [ { rowIndex : 1, colIndex : 3, rowSpan : 1, colSpan : 2, text : "데이터표시" , textAlign : "center" } ] } ] }; WebSquare.util.multipleExcelDownload( options ); (첫번째 sheet) A || C D E F ┌──────────────┐┌──────────┬──────┬──────┬──── 1 | || | | | | || ┌──────┴──────┐ 2 | || | 데이터표시 | | || └──────┬──────┘ 3 | || | | | 4 | a || e | | | -> 그리드 헤더. 5 | Renaissance || 20111231 | | | -> 그리드 데이터. 6 | ... (생략) (두번째 sheet) A || C D E F ┌──────────────┐┌──────────┬──────┬──────┬──── 1 | || | | | | || ┌──────┴──────┐ 2 | || | 데이터표시 | | || └──────┬──────┘ 3 | || | | | 4 | a || e | | | -> 그리드 헤더. 5 | Renaissance || 20111231 | | | -> 그리드 데이터. 6 | ... (생략)

next( elem )

텍스트 노드를 제외한 다음 노드 검색해서 반환합니다.

Parameter

name	type	required	description
elem	Object	Y	다음 노드를 검색할 객체

Return

type	description
Object	elem의 다음 노드

Sample

WebSquare.util.next(xmlDoc);

openPopup( url , <Object:Y> , params , target )

popup을 속성에 따라 만드는 함수입니다. createPopup과 인자만 다르고 같은 함수입니다.

Parameter

name	type	required	description
url	String	Y	popup창의 url
<Object:Y>	Object	Y	options popup의 options. (width, height 등) <String:N> options.id : [default: ppo1] popup의 id <String:N> options.type : [default: browser] 팝업의 종류. litewindow, winddow 혹은 browser. 이 값을 browser로 지정할 경우, useIFrame 속성과 상관없이 window.open으로 열림. <String:N> options.width : [default: 500px] 팝업의 width 설정값. <String:N> options.height : [default: 500px] 팝업의 height 설정값. <String:N> options.top : [default: 100px] 팝업의 top 설정값. useIframe:true인 경우 브라우져를 기준으로 false인 경우 모니터를 기준으로 계산. <String:N> options.left : [default: 100px] 팝업의 left 설정값. useIframe:true인 경우 브라우져를 기준으로 false인 경우 모니터를 기준으로 계산. <String:N> options.popupName : [default: WebSquarePopup] 팝업 객체의 이름으로 popup 프레임의 표시줄에 표시. <String:N> options.modal : [default: false] modal을 이용해서 뒤 쪽 배경을 동작하지 않도록 만들기 위한 인자. false이면 뒤쪽의 컴포넌트가 사용 가능. <String:N> options.useModalStack : [default: false] 여러 개의 팝업을 생성할 경우, 제일 마지막에 표시되는 팝엄만 활성화. (true: 마지막 팝업만 활성화. false: 모든 팝업을 활성화.) (5.0_1.2701A.20170714.211228 버전에서 추가.) <String:N> options.useIFrame : [default: false] type:window인 경우, 이 값이 true이면 IFrame 을 사용하는 WebSquare popup으로, false이면 window.open 을 사용하는 팝업을 생성. <String:N> options.style : [default: ""] 팝업의 스타일을 지정값. 값이 있으면 left top width height는 적용되지 않음. <String:N> options.srcData : [default: null] 팝업 객체의 type 이 window 일 때 Parent 에서 넘길 xpath. <String:N> options.destData : [default: null] 팝업 객체의 type 이 window 일 때 popup 에 설정할 xpath. <Object:N> options.dataObject popup에 설정할 변수의 데이터 타입과 데이터, 변수명을 입력하는 객체. (예) { type: ["xml","string","json","array"], data: "전달 데이터" , name :"변수명"} <String:N> options.xml : [default: null] 팝업에 넘길 xmlDocument의 string popup창에서 WebSquare.uiplugin.popup.getPopupParam() api를 사용하여 가져올수 있음. <String:N> options.resizable : [default: false] size조절을 유무 (useIfrmae:false인 경우 적용) <String:N> options.status : [default: false] status 출력 유무 (useIfrmae:false인 경우) <String:N> options.menubar : [default: false] menubar 출력 유무 (useIfrmae:false인 경우) <String:N> options.scrollbars : [default: false] scrollbar 출력 유무 (useIfrmae:false인 경우) <String:N> options.title : [default: false] title 출력 유무 (useIfrmae:false인 경우) <String:N> options.useMaximize : [default: true] useIFrame:true 설정시 상단 title 영역을 더블클릭 할 경우 최대화 시킬지 유무 <String:N> options.closeAction : [default: ""] useIFrame:true 설정시 닫기 버튼을 클릭 할 경우 팝업을 닫기전 호출된 사용자 정의 funcion 이름. 사용자정의 함수 에서 return true;시 팝업을 닫는다. <String:N> options.className : [default: ""] userIFrame: true 설정시 팝업의 디자인을 변경하기 위한 class. <String:N> options.fullscreen : [default: false] fullscreen: true 설정시 전체화면으로 팝업을 띄웁니다. (IE전용) <String:N> options.useControl : [default: false] useControl: true 설정시 최소화, 최대화, 닫기 버튼을 사용할 수 있다. type="litewindow" 혹은 type+"window"이고 useIFrame="true"인 경우 유효. (5.0_1.2783B.20170908.145609 버전에서 추가.) <String:N> options.foldOnMinimized : [default: false] foldOnMinimize: true 설정시 최소화 동작이 팝업 접기 동작으로 바뀐다. 아래의 controls 옵션에서 "minimize:true"로 설정할 경우, "foldOnMinimize:true"로 설정해야 함. (5.0_1.2783B.20170908.145609 버전에서 추가.) <Object:N> options.controls : [default: { minimized:true, maximized:true, close:true }] 특정 컨트롤 버튼을 보이거나 숨길 수 있다. (useControl 속성이 true일 때 동작) "minimize:true"를 사용할 경우, "foldOnMinimize:true"를 지정해야 함. "foldOnMinimize:false" 설정을 사용하면 화면이 접히지 않고 사라짐.(5.0_1.2799B.20170918.104858 버전에서 추가.) <Object:N> options.foldSize : [default: { width: 500 }] foldSize: minimize(fold) 동작시의 크기를 지정할 수 있다. (controls 옵션에서 "minimize:true"이고 "foldOnMinimize:true"인 경우 유효.) (5.0_1.2799B.20170918.104858 버전에서 추가.)
params	Object	N	팝업창에 넘길 parameter
target	Object	N	window객체. default로 window

Sample

var options = { id : "popup1", type : "window", width: "250px", height: "250px", top: "200px", left: "200px", popupName : "Test", modal : true, useIFrame : false, style : "", resizable : true, status : false, menubar : false, scrollbars : false, title : false, xml: empNm, srcData: "", destData: "" }; WebSquare.util.openPopup("/ComponentTest/innerPopup1.xml", options );

parent( elem , num )

주어진 html 객체에서 숫자 num 만큼(없으면 한 단계 위) 상위인 노드를 찾아 반환합니다.

Parameter

name	type	required	description
elem	Object	Y	부모 노드를 검사할 객체
num	Number	N	상위 노드를 탐색할 횟수

Return

type	description
Object	elem의 상위 노드

Sample

WebSquare.util.parent( xmlDoc, 1)

parseFloat( str , defaultValue )

parseFloat를 호출합니다. defaultValue가 주어지고 parseFloat결과가 NaN이면 defaultValue를 반환합니다.

Parameter

name	type	required	description
str	String	Y	Number string
defaultValue	Number	N	parseFloat 결과가 NaN일때 반환할 기본 값

Return

type	description
Number	주어진 문자를 숫자로 변환한 값

Sample

var data = WebSquare.util.parseFloat(num, 0);

parseInt( str , defaultValue )

parseInt를 호출합니다. defaultValue가 주어지고 parseInt결과가 NaN이면 defaultValue를 반환합니다.

Parameter

name	type	required	description
str	String	Y	Number string
defaultValue	Number	N	parseInt 결과가 NaN일때 반환할 기본 값

Return

type	description
Number	주어진 문자를 숫자로 변환한 값

Sample

var data = WebSquare.util.parseInt(num, 0);

prev( elem )

텍스트 노드를 제외한 이전 노드 검색해서 반환합니다.

Parameter

name	type	required	description
elem	Object	Y	이전 노드를 검색할 객체

Return

type	description
Object	elem의 이전 노드

Sample

WebSquare.util.prev( xmlDoc);

reinitialize( refresh )

브라우저 refresh 없이 페이지를 다시 로딩하거나 또는 브라우저를 refresh합니다.

Parameter

name	type	required	description
refresh	Boolean	N	브라우저를 refresh할 것인지에 대한 여부. ( default값은 false )

Sample

WebSquare.util.reinitialize(); 브라우저를 refresh하지 않고 해당 페이지를 다시 로딩한다.
WebSquare.util.reinitialize(true); 브라우저를 refresh한다.

removeData( key )

특정 key로 등록된 data를 제거한다. data의 하위 object를 제거하여 빈 껍데기 상태로 만든다.

Parameter

name	type	required	description
key	String	Y	삭제하고자 하는 data의 key값

Return

type	description
Object	key에 해당하는 data

Sample

var itemList = WebSquare.util.getData("item1").itemList;

setData( key , data )

특정 key로 data를 등록한다. 입력 받은 data는 웹스퀘어가 관리하는 변수 목록에 전역변수로 등록된다. SPA로 페이지 이동 시 key와 data가 전부 자동으로 정리된다..

Parameter

name	type	required	description
key	String	Y	등록된 data를 제어하기 위한 key값
data	Object	Y	등록할 data

Sample

window["common"] = {}; common.itemList = []; common.func = function(){}; WebSquare.util.setData("item1", common);

setDate( str )

Date String에 '/'를 추가합니다.

Parameter

name	type	required	description
str	String	Y	Date String

Return

type	description
String	입력받은 str에서 '/'를 추가한 String

Sample

var data = WebSquare.util.setDate ("20120101"); data : 2012/01/01

setDisabled( obj )

컴포넌트 하위로 disabled를 처리한다.

Parameter

name	type	required	description
obj	Object	Y	disabled parameter <String:N> obj.componentId : 컴포넌트 Id, 비어있으면 body <boolean:Y> obj.disabled : disabled flag <Array<String>:N> obj.excludeIdList : 제외할 컴포넌트 Id 리스트 (미입력시 전체 적용) <Array<String>:N> obj.includeIdList : 허용할 컴포넌트 Id 리스트 (미입력시 전체 적용)

Return

type	description
Object	object <String> object.doneComponents 완료한 컴포넌트 ID 리스트 <String> object.skipComponents 이미 disabled 처리되어 있어 Skip한 컴포넌트 ID 리스트

Sample

WebSquare.util.setDisabled({"componentId":"", "disabled":true}); //전체 disabled WebSquare.util.setDisabled({"componentId":"", "disabled":false}); //전체 enabled WebSquare.util.setDisabled({"componentId":"", "disabled":true, "excludeIdList": ["output10"]}); //output10을 제외한 전체 disabled WebSquare.util.setDisabled({"componentId":"", "disabled":true, "includeIdList": ["output1","output2"]}); //output1,output2만 disabled

setDocumentLang( lang )

html태그의 lang 속성에 언어 코드를 설정 한다.

Parameter

name	type	required	description
lang	String	Y	html태그의 lang속성에 설정할 언어 코드. ex) xml:lang="ko"

Sample

WebSquare.util.setDocumentLang("ko");

setDomain( domain )

frame 및 popup에서 cross domain을 처리하기 위해 domain을 셋팅한다.

Parameter

name	type	required	description
domain	String	Y	공통 domain

setInterval( func , options )

실행할 함수를 함수를 setInterval로 등록하여 함수가 주기적으로 계속 실행되도록 한다.SPA모드에서 페이지 이동 시 이 함수로 등록한 타이머를 자동으로 제거한다.

Parameter

name	type	required	description
func	Function	Y	실행할 함수
options	Object	N	options인자로는 아래와 같은 인자가 사용된다. <String:N> options.key : timer를 구별하기 위한 키값. 이 값이 지정되지 않은 경우 키값을 func.toString().slice(0,30)을 키값으로 사용한다. <Number:N> options.delay : setInterval의 2번째 인자값. func함수가 delay시간 이후에 실행되도록 한다. 기본값은 1이다. <Object:N> options.caller : func내에서 this값을 caller로 변경한다. <Object:N> options.args : func에 전달할 인자값. array형태로 인자를 전달한다. <function:N> options.before_call : func 함수가 실행되기 직전에 실행할 함수. func함수와 마찬가지로 data를 인자로 받는다. <function:N> options.callback : func함수가 실행된 후에 실행할 함수. func함수의 return값을 인자로 받는다

Sample

WebSquare.util.setInterval("function(){alert(this.id);}", {caller:grid1, delay:2000, key:"interval1"});

setNumber( str )

입력된 숫자에서 콤마(',')을 추가한 문자열로 변환한 다음 반환 합니다.

Parameter

name	type	required	description
str	String	Y	Number string

Return

type	description
String	입력된 string에 자릿점을 추가한 문자열

Sample

var data = WebSquare.util.setNumber ( 1234652 ); data : 1,234,652

setTime( str )

Time String에 ':'를 추가합니다.

Parameter

name	type	required	description
str	String	Y	Time String

Return

type	description
String	입력받은 str에서 ':'를 추가한 String

Sample

var data = WebSquare.util.setTime ("1123"); data : 11:23

setTimeout( func , options )

실행할 함수를 함수를 setTimer로 등록하여 일정 시간 후에 실행되도록 한다. SPA모드에서 페이지 이동 시 이 함수로 등록한 타이머를 자동으로 제거한다.

Parameter

name	type	required	description
func	Function	Y	실행할 함수
options	Object	N	options인자로는 아래와 같은 인자가 사용된다. <String:N> options.key : timer를 구별하기 위한 키값. 이 값이 지정되지 않은 경우 키값을 func.toString().slice(0,30)을 키값으로 사용한다. <Number:N> options.delay : setTimer의 2번째 인자값. func함수가 delay시간 이후에 실행되도록 한다. 기본값은 1이다. <Object:N> options.caller : func내에서 this값을 caller로 변경한다. <Object:N> options.args : func에 전달할 인자값. array형태로 인자를 전달한다. <function:N> options.before_call : func 함수가 실행되기 직전에 실행할 함수. func함수와 마찬가지로 data를 인자로 받는다. <function:N> options.callback : func함수가 실행된 후에 실행할 함수. func함수의 return값을 인자로 받는다

Sample

WebSquare.util.setTimeout("function(){alert(this.id);}", {caller:grid1, delay:200, key:timer1});

toHexColor( rgb )

rgb(r, g, b) 형식의 string을 입력받아 #RRGGBB 형식의 color code를 반환합니다.

Parameter

name	type	required	description
rgb	String	Y	rgb(r, g, b) 형식의 string

Return

type	description
String	#RRGGBB 형식의 color code

Sample

WebSquare.util.toHexColor("rgb(17,59,158)");

url( w2xPath , options )

화면 이동 시 url전체를 전달하는 대신 w2xPath에 해당하는 경로만 전달하여 페이지를 이동할 수 있게 해주는 함수. options에 추가 인자를 통해 spa로 페이지를 이동할 수 있다.

Parameter

name	type	required	description
w2xPath	String	Y	xml 파일의 경로
options	Object	N	options로 올 수 있는 값은 아래와 같습니다. <Boolean:N> options.spa : 페이지 이동 시 spa = true인 경우 w2xPath를 해시(#)로 전달하며, spa = false인 경우에는 w2xPath를 서치(?)로 전달합니다. spa 옵션값을 명시하지 않은 경우, config.xml의 spa값을 사용합니다. config.xml에 spa 값이 설정되어 있지 않은 경우에는 false입니다. <Boolean:N> options.forceReload : 페이지 이동 후 브라우저를 강제로 갱신할 것인지에 대한 여부. spa = true인 경우에만 의미가 있는 옵션입니다. spa로 페이지를 계속 이동하다보면 전역 자원이 쌓여서 메모리 릭이 발생할 수 있는데, 이런 경우 forceReload=true 로 설정하면 페이지 이동과 동시에 브라우저가 갱신되어 메모리 릭이 사라지고 전역 자원을 초기화 시킬 수 있습니다. <Boolean:N> options.replaceHistory : 브라우저의 히스토리를 덮어 쓸 것인지에 대한 여부. true인 경우 내부적으로 location.replace 함수를 호출하며 false인 경우에는 location.assign함수를 호출합니다. <Object:N> options.param : 페이지 이동 시 추가로 전달할 인자들을 json형태로 나타냅니다. 객체의 값은 반드시 string 형식이어야 합니다. <Boolean:N> options.shortURL : url을 w2xPath에 해당하는 경로만 전달할 것인지 http://... 와 같이 전체 경로를 전달할 것인지에 대한 옵션. 옵션 값을 지정하지 않은 경우 엔진 내부에서 자동으로 판단합니다. <String:N> options.urlHashText : spa = true인 경우, 페이지 이동 후 주소창에 표시되는 url에서 hash부분을 다르게 표시하고자 할 때 사용하는 옵션입니다. 단, ?&# 세 종류의 문자는 절대 포함되어선 안 됩니다.

Sample

var param1 = { "name" = "123", "ID"= "asdf" }; var param2 = { "addr" = "abcd", "PW"= "dddx" }; WebSquare.util.url("/folder1/bar.xml", {"spa" : true, "replaceHistory" : true, "param" : param1}); // bar.xml을 SPA로 페이지 이동하면서 name,ID 파라메터 전달 WebSquare.util.url("/folder1/bar.xml", {"spa" : true, "forceReload" : true, "param" : param2}); // bar.xml을 SPA로 이동하면서 브라우저를 재로딩하고, addr,PW 파라메터 전달 WebSquare.util.url("/folder1/bar.xml", {"spa" : true, "urlHashText" : "pId=bar"}); // SPA 페이지 이동 후 브라우저 상단 url이 http://xxx/websquare.html#pId=bar 으로 보이게 됩니다.