- adaptiveStyle
-
adaptive 모드 진입시 적용할 클래스 (현재는 height만 지원)
- allOption
-
inputType이 selectbox인 경우에 전체를 선택하는 라벨을 표시
- allowChar
-
사용자 입력 가능 문자 설정
- alt
-
inputType이 image, textImage인 경우에 이미지의 alt 속성
- applyFormat
-
표시될 값의 형식의 적용범위 설정
<![CDATA[(옵션 설명)
"all"
"display"]]>
- autocomplete
-
HTML5의 autocomplete 기능으로 유형(type)에 따른 유효성 확인 후 사용자에게 알려줘야 할 문구를 명시
(해당 속성을 사용하는 브라우저에서 동작하며, 브라우저마다 동작이 상이할 수 있음)
- autoFitFilterList
-
[default: false, true] useFilterList와 useFilter 속성 "true"로 설정 후, 헤더 필터 목록에 있는 항목 길이에 맞게 필터의 너비가 조정되도록 설정
- blockSelect
-
해당 컬럼의 선택을 차단할지에 대한 여부
- calendarClass
-
[default: class1, class2, class3, class4] Calender의 스킨 종류
- calendarValueType
-
[default: yearMonthDate, year, yearMonth, yearMonthDateTime, yearMonthDateTimeSec] inputType이 calendar인 경우에 Calendar의 표현 방법 설정
- checkAlways
-
헤더 및 바디 컬럼의 inputType이 checkbox인 경우 헤더 체크 시에 읽기전용이나 비활성화된 행도 함께 체크 (바디에 속성을 설정해야함)
- checkboxLabel
-
inputType이 checkbox인 경우 CheckBox 옆에 라벨을 표시하기 위한 속성
<![CDATA[(관련 속성)
checkboxLabelPosition : 좌우 위치를 결정]]>
- checkboxLabelColumn
-
inputType이 checkbox인 경우 다른 컬럼의 정보를 조합하여 라벨을 생성 (컬럼의 아이디를 구분자로 구분하여 여러 개 지정할 수 있음)
<![CDATA[(사용 예)
// 아래 예제의 경우 col1의 라벨은 (col1의값 + ',' + col3의값 + ',' + col5의값)으로 표현
<w2:colummn id='col1' checkboxLabelColumn='col1,col3,col5'/>]]>
<![CDATA[(관련 속성)
checkboxLabelDelimiter : [default: ","] 라벨의 구분자 설정]]>
- checkboxLabelDelimiter
-
[default: ","] checkboxLabelColumn을 사용할때 라벨 조합 컬럼 아이디의 구분자
<![CDATA[(관련 속성)
checkboxLabelColumn]]>
- checkboxLabelFormatter
-
inputType이 checkbox인 경우 라벨의 표시형태를 만들어주는 함수
지정한 함수가 반환하는 값이 라벨로 사용되며, 함수의 매개변수로 rowIndex, colIndex, label 형태로 전달되어야 함
<![CDATA[(사용 예)
<w2:gridView id="gridView2"><w2:gBody id="gBody1" style=""><w2:row id="row1" style="">
<w2:column id="col1" inputType="checkbox" checkboxLabel="test"
checkboxLabelFormatter="scwin.gridView2_col1_checkboxLabelFormatter"/>
<script type="text/javascript" lazy="false"><![CDATA[
scwin.gridView2_col1_checkboxLabelFormatter = function(row, col, label){
return label + ":[" + row + "," + col + "]";
}
]]]]><![CDATA[>]]>
- checkboxLabelPosition
-
[default: right, left] inputType이 checkbox인 경우 라벨의 표시 위치
- checkcomboboxRangeSeparator
-
inputType이 checkcombobox인 경우 연속적으로 선택된 값을 "x-y" 형태로 간단하게 보여주는 기능 (목록을 펼쳤을 때의 순서를 기준으로 연속성을 판단)
<![CDATA[(예제)
항목이 1부터 100까지 있고 "1,3,4,5,6,12,13,14,25,26,27,88,89,90,91" 이 선택된 경우 rangeSeperator를 "-"로 설정하면 아래와 같이 출력
"1,3-6,12-14,25-27,88-91"]]>
- checkcomboboxUseDrag
-
[default: false, true] inputType이 checkcombobox인 경우 목록이 펼쳐졌을 때 마우스 드래그 동작을 통해 여러 Checkbox를 직사각형 형태로 선택/해제 할 수 있는 기능
(Shift키를 누른 상태로 마우스를 드래그하면 선택해제 모드가 됨)
<![CDATA[(옵션 설명)
"true" : Shift키와 마우스 드래그를 통해 영역 안의 모든 Checkbox를 선택/해제
"false" : (기본 값) 마우스 드래그 동작읉 통한 영역 안의 모든 Checkbox를 선택/해재하는 기능을 사용하지 않음]]>
- checkcomboboxUseEdit
-
[default: false, true] inputType이 checkcombobox인 경우 값을 직접 타이핑하여 편집할 수 있는 기능
<![CDATA[(옵션 설명)
"true" : 마우스로 CheckComboBox를 클릭하면 편집 모드 상태가 되어 값을 직접 타이핑하여 편집하는 기능을 사용할 수 있음
"false" : (기본 값) 값을 직접 편집할 수 없음 (마우스로 목록을 열고 체크하거나 setValue() 함수를 통해서 값을 변경해야 함)]]>
- checkcomboboxValidateOnInput
-
[default: false, true] inputType이 checkcombobox인 경우 useEdit 속성 사용 시 값이 입력될 때마다 유효성을 검증하는 기능 (oninput() 이벤트를 지원하는 IE9이상 브라우저 지원)
<![CDATA[(옵션 설명)
"false" (기본 값) : 적용하지 않음
"true" : 값 편집 시 키보드로 입력할 때마다 값에 대한 유효성 검사를 적용해서 유효하지 않는 값의 입력을 제어]]>
<![CDATA[(관련 속성)
useEdit]]>
- checkcomboboxVisibleColMax
-
inputType이 checkcombobox인 경우 펼쳤을 때 보여줄 컬럼의 최대 개수 (보여줄 컬럼의 개수를 항목의 개수에 따라 자동으로 설정할 때 사용)
<![CDATA[(옵션 설명)
"visibleRowNum=5,visibleColMax=8"
항목의 총 수가 40개보다 적은 경우에는 항목이 5배수 단위로 늘어날 때마다 열이 1개씩 추가
항목의 총 수가 4개이면 4*1, 12개이면 5*3, 24개이면 5*5, 30개이면 5*6 직사각형 형태로 출력
항목의 총 수가 40개보다 큰 경우에는 세로 스크롤이 생긴다. 목록은 5*8 직사각형 형태로 출력]]>
<![CDATA[(관련 속성)
checkcomboboxVisibleColNum : 이 설정이 적용되어 있는 경우 이 설정은 무시됨]]>
- checkcomboboxVisibleColNum
-
inputType이 checkcombobox인 경우 보여줄 컬럼의 개수
<![CDATA[(옵션 설명)
3 : 열의 개수가 3개, 행의 개수가 Math.ceil(데이터 수/3)인 직사각형 형태로 목록이 표현]]>
- checkcomboboxVisibleRowNum
-
inputType이 checkcombobox인 경우 보여줄 행의 개수 ("1"로 설정하는 것은 비권장)
<![CDATA[(옵션 설명)
5 : 전체 데이터가 5*컬럼보다 적은 경우에는 데이터수/컬럼수 만큼 행을 보여주고 데이터가 그보다 더 많은 경우에는 행을 5개만 보여주고 세로 스크롤이 생김]]>
<![CDATA[(관련 속성)
checkcomboboxVisibleColMax
checkcomboboxVisibleColNum]]>
- chooseOption
-
[default: false, true] inputType이 select인 경우 선택 안내 메시지 표시 여부
<![CDATA[(옵션 설명)
"true" 선택 안내 메시지를 표시 (chooseOptionLabel 속성에 설정 된 값을 표시하며 chooseOptionLabel 속성에 설정이 없으면 "-선택-"이라 표시되고 value는 ""(Empty String)으로 설정됨)
"false" (기본 값) 선택 안내 메시지를 표시하지 않음]]>
<![CDATA[(관련 속성)
chooseOptionLabel]]>
- chooseOptionLabel
-
inputType이 select이고 chooseOption이 true인 경우 선택 안내 메시지로 표시할 텍스트를 정의
chooseOption="true"인 경우 유효.
<![CDATA[(관련 속성)
chooseOption]]>
- class
-
컬럼에 적용할 클래스
- closeonmouseleave
-
[default: false, true] 목록 창(subLayer)이 열린 경우, 선택 항목 목록에서 마우스 커서가 빠져나갈 때 목록을 닫을지 여부
<![CDATA[(옵션 설명)
"false" (기본 값) : 목록을 닫지 않음
"true" : 목록을 닫음]]>
- colMerge
-
해당 컬럼에 동일데이터 행 반복 시 하나의 셀로 표현 (합쳐진 셀의 편집은 데이터가 표시되는 최상단 셀만 가능)
- colSpan
-
합쳐서 표현할 컬럼의 수
- copyOption
-
[default: "dataList", "display"] 데이터를 복사할 때 기준 값 설정
(GridView 전체 설정도 가능하지만 우선순위는 컬럼의 설정이 우선 함)
<![CDATA[(옵션 설명)
"dataList" (기본 값) : 데이터 복사 시 DataList에 들어있는 값을 기준으로 복사
"display" : 데이터 복사 시 화면에 출력된 값을 기준으로 복사]]>
<![CDATA[(사용 예)
gridView (1,1) 셀의 inputType이 "select" 이고 DataList값은 "1001", 화면에 출력된 값은 "a1" 일 때
copyOption이 dataList인 경우 해당 셀을 복사 시 클립보드에 "1001"이 복사 됨
copyOption이 display인 경우 해당 셀을 복사 시 클립보드에 "a1"이 복사 됨]]>
- customFormatter
-
데이터의 표현식을 조건에 맞추어 변경하기 위한 사용자 함수
inputType이 "text", "link", "textImage", "textarea", "select", "expression", "spinner"인 경우에만 유효
<![CDATA[(함수 설명)
데이터 표현식 Formatter 함수
매개변수는 data, formattedData, rowIndex, colIndex로 구성]]>
- customModelFormatter
-
데이터컬렉션과 바인딩 시, 데이터 값의 표현식을 데이터가 저장되기 전에 변경시켜주는 사용자 정의 함수
inputType이 "text", "textImage" 인 경우에만 유효
(반드시 customModelUnformatter와 함께 사용해야 함)
<![CDATA[(관련 속성)
customModelUnformatter]]>
- customModelUnformatter
-
데이터컬렉션과 바인딩 시, 데이터 값의 표현식을 데이터를 읽어오기 전에 원복시켜주는 사용자 정의 함수
예를 들어 getCellDisplayData API를 실행하면, 해당 속성에 정의한 사용자 정의 함수를 실행한 결과 값을 반환
customModelFormatter를 실행한 결과값이 customModelUnformatter를 실행했을 때 원복되어 원본 데이터로 나옴
<![CDATA[(관련 속성)
customModelFormatter]]>
- dataType
-
컬럼의 데이터 유형
설정하지 않은 경우 DataList의 dataType을 사용
부분합 및 푸터는 GridView 컬럼에 dataType을 설정
<![CDATA[(주의 사항)
dataType이 "number" 또는 "float"인 경우 정수부+소수부의 합이 12자리를 넘으면 데이터가 반올림되어 표현됨
큰 숫자나 정밀한 소수점을 오차 없이 표현하려면 dataType을 "bigDecimal"로 해야 함]]>
- dateValidCheck
-
dataType이 "date"인 경우에 유효성 확인
- dateValidSet
-
[default: false, true] dataType이 "date"인 경우에 입력된 날짜 값의 유효성을 확인하여, 유효하지 않을 경우 이전 값으로의 복귀 여부
- dateValidSetCustom
-
[default: false, true] dateValidSet 기능 사용 시 유효하지 않는 값이 들어왔을 때 invalidMessageFunc만 호출하는 속성
유효하지 않은 값이 입력되었을 때 invalidMessageFunc만 호출하며, 알림창을 띄우거나 값을 이전으로 되돌리는 처리도 하지 않음
invalidMessageFunc에서 사용자 messagePopup을 띄우고 해당 팝업이 닫혔을 때 값을 이전으로 되돌리는 처리를 직접 하고자 할 때 사용하는 속성
값을 이전으로 되돌리고 포커스를 다시 주고자 하는 경우 messagePopup의 onpageload 이벤트에서 inputCalendar.setValueCancel을 직접 호출함
- defaultValue
-
셀의 초기값
- delimiter
-
inputType이 "select" 혹은 "autoComplete" 이고, "displayMode" 혹은 "filterDisplayMode"가 "delim"을 포함하는 형태일때 "delim" 위치에 사용할 구분자
<![CDATA[(관련 속성)
displayMode
filterDisplayMode]]>
- depthColumn
-
inputType이 "drilldown"인 경우, 깊이 값을 갖는 컬럼의 아이디
- depthType
-
[defualt: "nbsp", "div", "line", "none"] inputType이 "drilldown"인 경우 노드의 연관 관계를 표현하는 방식
<![CDATA[(옵션 설명)
"nbsp" (기본 값) : 공백(default)
"div" : 빈 div 상자
"line" : 이미지로 표현
"none" : 미표현]]>
- directOpen
-
inputType이 "autoComplete"인 경우 화살표 클릭시 아이템 테이블 바로 열리는 기능 (viewType이 "icon"이고 viewTypeIconImage이 "true"일 경우의 동작)
inputType이 "select" 혹은 "autoComplete"인 경우 해당 컬럼에 포커스가 있는 상태에서 Enter 키 입력 시에 바로 열리는 기능
<![CDATA[(관련 속성)
viewType = "icon"
viewTypeIconImage = true]]>
- disabled
-
[default: false, true] 셀 비활성화 여부
<![CDATA[(옵션 설명)
"false" (기본 값) : 활성화 함
"true" : 비활성화 함]]>
- disabledClass
-
disabled가 true인 경우 적용할 클래스 아이디
- displayFormat
-
셀에 표시될 값의 형식
- displayFormatFunc
-
DataList의 dataType 속성이 "date"인 경우 displayFormat을 적용할 사용자 정의 함수
displayFormat이 이미 설정되어 있는 경우에는 이 속성은 무시됨
- displayFormatter
-
셀의 데이터 값의 형식을 지정해주는 사용자 정의 함수
- displayMode
-
[default: "label", "value delim label", "label delim value", "value"] inputType이 "select" 혹은 "autoComplete"인 컬럼의 선택 항목 리스트의 표현 방법을 정의 (값과 항목명을 함께 표현하는 것이 가능)
<![CDATA[(옵션 설명)
"value" : 값만 표현
"label" : 라벨만 표현
"label delim value" : 라벨 <구분자> 값
"value delim label" : 값 <구분자> 라벨]]>
<![CDATA[(관련 속성)
delimiter : "delim" 위치에 사용할 구분자]]>
- displayType
-
[default: "hidden", "all] inputType이 "textarea"인 경우, 셀을 늘려서 텍스트를 모두 표시
셀의 너비가 지정되어 있어야 하고, 가로 스크롤이 없는경우에만 동작
- editModeEvent
-
[default: ondblclick, onclick, onsecondclick] 셀에 편집모드로 진입하기 위해 필요한 마우스 동작 이벤트
<![CDATA[(옵션 설명)
"onclick" : 셀을 클릭할 경우 셀의 편집모드로 진입
"ondblclick" (기본 값): 셀을 더블클릭할 경우 셀의 편집모드로 진입
"onsecondclick": 셀을 클릭한 후 다시 클릭하거나 키를 입력할 경우 편집모드로 진입]]>
- editModeEventIcon
-
[default: onclick, ondblclick] viewType이 "icon"인 컬럼에서 편집 모드로 진입하기 위해 필요한 마우스 동작 이벤트
<![CDATA[(옵션 설정)
"onclick" (기본 값): 아이콘을 클릭할 경우 셀 편집 모드로 진입
"ondblclick": 아이콘을 더블클릭할 경우 셀 편 모드로 진입]]>
<![CDATA[(!주의!)
gridView.column과 GridView 모두 editModeEventIcon 설정을 정의한 경우,
gridView.column의 설정이 우선함]]>
- editType
-
[default: "select", "focus] 셀 편집모드 진입 시 수행할 동작을 지정
<![CDATA[(옵션 설명)
"select" (기본 값) : 포커스가 발생할 때 선택된 텍스트를 선택
"focus" : 텍스트의 맨 끝으로 커서를 이동]]>
- embeddedInput
-
[default: false, true] 셀 내부에 입력 컴포넌트를 내장할 것인지 여부
inputType이 "text", "textImage", "select", "textarea"인 경우 사용 가능
<![CDATA[{옵션 설명)
false (기본 값) : , editMode로 전환시 동적으로 추가
true : InputBox 내장]]>
- escape
-
<>&"등과 같은 HTML Tag 문자를 HTML Escape 문자로 변환하여 화면에 표시
<![CDATA[(옵션 설명)
"true" (기본 값) : Escape 문자로 변환하지 않음
"false" : Escape 문자로 변환하여 화면에 표시]]>
- escapeFormatter
-
customFormatter와 동작은 거의 동일하나 사용 목적이 script 태그와 같은 보안상 이슈가 발생하는 문자열을 직접 제어하기 위함 (Formatter 중 가장 먼저 적용)
inputType이 "text"인 경우에만 유효
<![CDATA[(함수 설명)
문자열을 직접 제어하기 위함 Formatter 함수
매개변수는 data, rowIndex, colIndex로 구성]]>
<![CDATA[(사용 예)
전역 스크립트에 아래를 정의한 후, 해당 속성에 "fn_escapeFormat"를 지정
function fn_escapeFormat (tmpVal, rowIndex, colIndex){
var colId = this.getColumnID(colIndex);
if(colId == "xxx"){
return tmpVal.replace(/<script.*script>/g, "")
}
};]]>
- eventPriority
-
[default: onviewchange, oneditend] inputType이 'select' 일 때 값 편집 후 발생할 이벤트의 순서를 지정 (하위호환 유지를 위해 만든 속성)
- eventPropagation
-
[default: fasle, true] inputType이 "checkbox" 또는 "radio" 일 때 마우스 클릭 이벤트를 전파할 지에 대한 여부
<![CDATA[(옵션 설명)
"true" : CheckBox 클릭 시 상위에 등록한 DOM(GridView, Body 등등)에 클릭 이벤트가 발생
"false" (기본 값) : CheckBox 클릭 시 상위에 등록한 DOM(GridView, Body 등등)에 클릭 이벤트가 발생하지 않음]]>
- excelCellType
-
다운로드한 엑셀파일 상에서 출력할 데이터의 표시 형식(셀 타입)을 지정
advancedDataDownload() 함수를 통해 GridView를 엑셀파일로 다운로드할 경우 options.useDataFormat : "true" 옵션을 사용해야 함
<![CDATA[(옵션 설명)
"number" : "숫자" 출력
"bigDecimal" : "숫자" 출력
"text" : "텍스트" 출력
"date" : "날짜" 출력]]>
- excelExpression
-
advancedExcelDownload() 함수를 통해 엑셀 다운로드시 엑셀 수식을 적용할 수 있는 속성
엑셀수식을 동일하게 사용할 수 있으며, 컬럼명을 설정하게 되면 다운로드시 엑셀좌표값으로 변경하여 적용
<![CDATA[(사용 예)
excelExpression="sum('column1','column2',column3')"
엑셀적용수식 : sum(A1,A2,A3)]]>
- excelFormat
-
advancedExcelDownload() 함수를 통해 엑셀파일을 다운로드할 때 엑셀에서 지원하는 표시될 값의 형식을 설정
excelFormat과 displayFormat이 동시에 설정되어 있는 경우, excelFormat이 적용됨
- excelFormatter
-
advancedExcelDownload() 함수를 통해 엑셀파일을 다운로드할 때 엑셀에서 지원하는 표시될 값의 형식을 설정하기 위한 excelFormat을 지정해주는 사용자 함수
excelFormat과 displayFormat이 동시에 설정되어 있는 경우, excelFormat이 적용됨
- expression
-
inputType이 "expression"인 경우의 계산식
<![CDATA[(사용 가능 함수)
SUM(컬럼아이디) : 컬럼 데이터의 총합을 계산 (footer나 subtotal에서 사용)
AVG(컬럼아이디) : 컬럼 데이터의 평균을 계산 (footer나 subtotal에서 사용)
MIN(컬럼아이디) : 컬럼 데이터의 최소값 계산 (footer나 subtotal에서 사용)
MAX(컬럼아이디) : 컬럼 데이터의 최대값 계산 (footer나 subtotal에서 사용)
COUNT(컬럼아이디, 옵션 ) : 컬럼의 각 그룹의 건 수를 계산 (blank 옵션을 false로 설정하면 빈 값은 세지 않음. footer나 subtotal에서 사용)
targetColValue() : subtotal의 target column의 값을 리턴 (subtotal에서 사용)
targetColLabel() : subtotal의 target column의 라벨을 리턴 (inputType이 "select", "autoComplete", "checkcombobox"인 경우. subtotal에서 사용)
display(컬럼아이디) : 컬럼 데이터의 값(DataList에 저장된 값)을 리턴 (body column에서 사용)
datalist(컬럼아이디) : 컬럼 데이터의 값(GridView와 매핑되지 않은 DataList의 컬럼 값도 가져올 수 있음)을 리턴 (body column에서 사용)
SUMIF(컬럼아이디, 조건, 조건 컬럼 ) : 컬럼 데이터 중 조건에 만족하는 총합을 계산 (footer나 subtotal에서 사용)
SUMIFS(컬럼아이디, [조건1, 조건 컬럼1, 조건2, 조건컬럼2, ...] ) : 컬럼 데이터 중 여러 조건에 만족하는 총합을 계산 (footer나 subtotal에서 사용)
SUMIF, SUMIFS의 조건에서 '>', '<', '>=', '<=', '!=', "==" 연산자를 사용할 수 있음
연산자에 '<'이 포함된 경우 escape 문자 (>)를 사용해야 함
(예제)
<w2:column id="col1_footer" inputType="expression" expression="sum('col1')"/> // col1 컬럼의 합
<w2:column id="col1_footer" inputType="expression" expression="avg('col1')"/> // col1 컬럼의 평균
<w2:column id="col1_footer" inputType="expression" expression="min('col1')"/> // col1 컬럼의 최소값
<w2:column id="col1_footer" inputType="expression" expression="max('col1')"/> // col1 컬럼의 최대값
<w2:column id="col1_footer" inputType="expression" expression="count('col1', { blank : false })"/> // col1 컬럼의 개수 (blank옵션이 false이면 빈 값("")은 세지 않음)
<w2:column id="col1_subtotal" inputType="expression" expression="targetColValue()"/> // 해당 subtotal의 target column의 값
<w2:column id="col1_subtotal" inputType="expression" expression="targetColLabel()"/> // 해당 subtotal의 target column의 라벨
<w2:column id="col_exp" inputType="expression" expression="Number(display('col1'))+Number(datalist('colX'))"/> // col_exp값은 col1값 + colX값의 합으로 표현
<w2:column id="col1" inputType="expression" expression="sumif('col1','>1000')"/> // col1의 값이 1000보다 큰 col1 컬럼의 합
<w2:column id="col1" inputType="expression" expression="sumif('col1','>1','col2')"/> // col2의 값이 1보다 큰 col1 컬럼의 합
<w2:column id="col1" inputType="expression" expression="sumif('col1','>10','col2')"/> // col2의 값이 10보다 작은 col1 컬럼의 합
<w2:column id="col1" inputType="expression" expression="sumifs('col1','>1',"col2",'a','col3')"/> // col2의 값이 1보다 크고 col3의 값이 'a'인 col1 컬럼의 합]]>
- falseValue
-
valueType이 "other"일 때 쓰일 셀이 해제된 경우 가지게 될 값
- filterDisplayMode
-
[default: "value", "label", "label delim value", "value delim label"] 필터의 항목 표현 방법을 정의 (값과 항목명을 함께 표현하는 것이 가능)
<![CDATA[(옵션 설명)
"value" : 값만 표현
"label" : 라벨만 표현
"label delim value" : 라벨 <구분자> 값
"value delim label" : 값 <구분자> 라벨]]>
<![CDATA[(관련 속성)
delimiter : "delim" 위치에 사용할 구분자]]>
- fixColumnWidth
-
[default: false, true] 컬럼의 가로 길이를 고정할 지에 대한 여부
<![CDATA[(옵션 설명)
"true" : autoFit 영향을 받지 않고 마우스를 통한 컬럼 가로 길이를 조정할 수 없음
"false" (기본 값) : 가로 길이 고정하지 않음]]>
- fixPickerStatus
-
pickerType이 "dynamic"인 경우 어떤 항목을 고정할지 정하는 옵션
- hidden
-
컬럼의 숨김 유무
- hiddenClass
-
해당 컬럼이 숨김처리되는 경우 추가할 클래스 이름
- hideCustomFilter
-
[default: false, true] useFilter가 "true"인 경우 필터에서 사용자 정의 필터를 숨김
<![CDATA[(옵션 설명)
"true" : 사용자 정의 필터를 숨김
"false" (기본 값) : 사용자 정의 필터를 표시]]>
- hideThreshold
-
화면 사이즈가 줄어들 때 해당 컬럼을 숨김 처리하기 위한 임계값 (단위: px)
값을 설정하지 않을 경우, 사이즈 변경에 따른 컬럼 숨김 기능이 동작하지 않음
- id
-
컬럼의 아이디
- ignoreChar
-
입력 가능 문자 중 사용 불가능 문자 설정
- imageAlign
-
gridView header와 body의 inputType이 "textImage"인 경우 text와 image의 순서를 변경.
<![CDATA[(옵션 설명)
left : 이미지 - 텍스트 순서
right (기본 값): 텍스트 - 이미지 순서]]>
- imageClickFunction
-
inputType이 "image" 혹은 "textimage"인 경우 셀 클릭 시 실행할 함수
<![CDATA[(함수 설명)
매개변수는 rowIndex, colId, nowValue로 구성]]>
<![CDATA[(사용 예)
imageClickFunction="scwin.gridView_imageClickFunc"
scwin.gridView_imageClickFunc = function(rowIndex, colId, nowValue){
alert('image clicked!');}]]>
- imageHeight
-
inputType이 "image" 혹은 "textimage"인 경우 이미지의 높이 설정
- imageSrc
-
inputType이 "image", "textImage"인 경우 이미지의 경로. "textImage"인 경우는 body, header에 사용 가능.
- imageStyle
-
gridView header의 inputType이 "textImage"인 경우 이미지의 스타일 지정.
- imageWidth
-
inputType이 "image" 혹은 "textimage"인 경우 이미지의 너비
- imeMode
-
inputType이 "text"인 경우 ime-mode(CSS) 값을 설정 (ime-mode가 지원 가능한 일부 브라우저에서만 동작)
- inputType
-
셀의 입력 타입 설정
<![CDATA[(옵션)
"text"
"link"
"checkbox"
"button"
"image"
"radio"
"select"
"calendar"
"expression"
"textarea"
"drilldown"
"textImage"
"checkcombobox"
"autoComplete"
"secret"
"custom"
"spinner"]]>
- invalidMessageFunc
-
유효성 검증 결과가 실패일 경우, 결과 메시지를 동적으로 표시할 사용자 정의 함수 이름
(inputType = "calendar", dateValidCheck = "true", dateValidSetCustom = "true"일 경우만 유효)
<![CDATA[// (사용자 정의 함수 예)
// 유효하지 않은 날짜 형식의 값이 입력될 경우 사용자 팝업인 messagePopup.xml을 띄우고, 이전 값으로 복귀하는 예시
scwin.gridView1_col1_invalidMessageFunc = function() {
var opts = {
"id" : "popup1",
"type" : "wframePopup",
"width" : "440px",
"height" : "90px",
"top" : 100,
"left" : 300,
"popupName" : "date_validation_error",
"modal" : true,
"title" : "date validation error",
"dataObject" : {
"type" : "string",
"data" : this.callerId,
"name" : "callerId"
}
};
if (!$p.getPopup("popup1")) {
$p.openPopup("messagePopup.xml", opts);
}
}]]>
<![CDATA[(관련 속성)
inputType = "calendar"
dateValidCheck = "true"
dateValidSet = "true"
dateValidSetCustom = "true"]]>
- ioFormat
-
inputType이 "date"인 경우 포맷 변환에 사용할 입출력 데이터의 포맷
<![CDATA[(사용 예)
ioFormat="yyyyMMdd"
ioFormat="yyyyMM"]]>
- keepFocusOnCheckHeaderClick
-
[default: false, true] 헤더 및 바디의 inputType이 "checkbox"인 경우, 헤더를 클릭했을 때 바디의 선택된 셀의 포커스를 유지할지 여부
<![CDATA[(옵션 설명)
"true" : 선택된 셀의 포커스를 유지
"false" (기본 값) : 선택된 셀의 포커스를 제거]]>
- localeRef
-
다국어 적용시 화면에 출력하는 텍스트의 키
키에 해당하는 텍스트가 없을 경우 "global_undefined"가 화면에 표시됨
- maskFormat
-
[default: ""] jQuery Mask Plugin과 유사한 기능을 제공하며 # 대신 숫자로 대체함
applyFormat은 기존 기능과 동일한 기능을 제공
dataType이 "text" 혹은 "number"인 경우 지원하며, "number"일 경우 Mask에 0으로 입력하여 기본표시를 할 수 있음 (#은 입력할 때 표시되지 않지만, 0은 입력할 때 표시됨)
<![CDATA[(옵션 설명)
"default" : displayFormat의 값을 왼쪽부터 변경
"reverse" : displayFormat의 값을 오른쪽부터 변경]]>
<![CDATA[(관련 속성)
displayFormat
applyFormat
dataType]]>
- maskFormatModelExcludeChar
-
maskFormat을 사용하고 데이터컬렉션과 바인딩 시, 데이터컬렉션에 저장할 때 제외할 문자(Char)를 지정
- max
-
dataType이 "number"인 경우 최대 값
- maxByteLength
-
inputType이 "text", "textarea", "textImage", "secret"인 경우 최대 Byte 길이
- maxLength
-
inputType이 "text", "input", "textarea", "textImage", "secret"인 경우 최대 길이
- min
-
dataType이 "number"인 경우 최소 값
- minWidth
-
[default: 20] 컬럼의 최소 너비 (단위: px)
- monthNames
-
inputType이 "calendar"인 경우 월에 선택창에 보여질 값을 설정하는 기능으로 1월부터 12월의 표현 값을 구분자(,)로 구분하여 정의
<![CDATA[(사용 예)
monthNames : Jan, Feb, Mar, Apr, May, Jun, Jul, Aug, Sep, Oct, Nov, Dec
monthNames : 1,2,3,4,5,6,7,8,9,10,11,12]]>
- navBtn
-
[default: false, true] inputType이 "checkcombox"인 경우, 선택 목록 하단에 [선택해제] 및 [선택적용] 버튼을 표시
<![CDATA[(옵션 설명)
"true" : [선택해제] 및 [선택적용] 버튼을 표시
"false" (기본 값) : [선택해제] 및 [선택적용] 버튼을 표시하지 않음]]>
- noDisabledOnReadOnly
-
[default: fasle, true] inputType이 "checkbox" 혹은 "radio"인 경우 readOnly 상태를 비활성 상태로 처리하지 않고 별도로 처리하도록 하는 속성 (readOnly가 "true"인 경우)
<![CDATA[(옵션 설명)
"true" : 셀이 비활성 처리되지 않으며, oncellclick 등의 이벤트 또한 발생함
"false" (기본 값) :. 셀이 빌활성 처리되며 어떠한 이벤트도 발생하지 않음]]>
- orderByColumn
-
병합된 헤더에서 정렬 기준이 되는 "body column"의 아이디값 지정
- partialCheckNextClick
-
그리드에서 checkbox 헤더의 부분 체크(indeterminate) 속성 사용 시, 부분 체크된 상태에서 헤더 클릭시 동작 정의
<![CDATA[(옵션 설명)
"uncheck" : 전체 해제
"check" : 전체 선택]]>
- pickerType
-
[default: "selectbox", "dynamic"] inputType이 "calendar"인 경우 달력에서 연도 및 월을 선택하는 방식을 설정
<![CDATA[(옵션 설명)
selectbox (기본 값) : 월/연도 이동 버튼이 있어 이동 방식을 선택할 수 있음
dynamic : 월 이동 버튼만 존재하고, 월 이동만 가능]]>
- placeholder
-
inputType이 "text", "textarea", "textImage", "calendar", "spinner", "secret", "autoComplete"인 경우 편집 모드로 진입 시 노출될 값을 설정 (HTML5의 placeholder와 동일한 기능을 제공)
사용자에게 알려줘야 할 힌트 문구 등을 명시
셀의 값이 비어 있을 때 설정한 값이 표시되며, 값을 입력하는 순간 사라짐 (브라우저 별로 동작 방식이 상이할 수 있음)
- radioLabel
-
inputType이 "radio"인 경우 표시할 라벨의 값을 설정
inputType이 "checkbox"인 경우와 다르게 Body 영역에서만 유효하고 헤더 영역에서는 지원하지 않음
<![CDATA[(관련 속성)
radioLabelPosition : 라벨의 좌우 위치를 설정]]>
- radioLabelColumn
-
inputType이 "radio"인 경우 다른 컬럼의 정보를 조합하여 해당 컬럼의 라벨을 생성
라벨을 생성하기 위해 참조할 아이디는 구분자(radioLabelDelimiter)를 사용하여 여러 개 지정 가능
<![CDATA[(관련 속성)
radioLabelDelimiter ]]>
<![CDATA[(사용 예)
// 아래 예제의 경우 col1의 라벨은 (col1의값 + ',' + col3의값 + ',' + col5의값)으로 표현
<w2:colummn id='col1' radioLabelColumn='col1,col3,col5'/>
]]>
- radioLabelDelimiter
-
[default: ","] radioLabelColumn을 사용할때 라벨 조합 컬럼 아이디의 구분자
<![CDATA[(관련 속성)
radioLabelColumn]]>
- radioLabelFormatter
-
inputType이 "radio"인 경우 Radio 버튼의 라벨로 표시할 값으로의 변환해주는 함수
<![CDATA[(함수 설명)
반환 값을 라벨로 사용
매개변수 rowIndex, colIndex, label로 구성]]>
<![CDATA[(사용 예)
<w2:colummn id='col1' radioLabelFormatter='scwin.gridView1_col1_radioLabelFormatter'/>
scwin.gridView1_col1_radioLabelFormatter = function(row, col, label){ return row + "," + col + "," + label;}
]]>
- radioLabelPosition
-
[default: "right", "left"] Radio에 라벨을 표시할 경우 표시될 좌우 위치를 지정
- readOnly
-
[default: false, true] 컬럼의 읽기전용(ReadOnly) 유무
- readOnlyClass
-
읽기전용(ReadOnly)일때 추가할 클래스 이름
- rowSpan
-
합쳐서 표현할 행의 수
- searchTarget
-
[default: label, value, both] inputType이 "autoComplete"인 경우 검색 기준을 설정
<![CDATA[(옵션 설명)
"label" (기본 값) : 라벨에서 검색
"value" : 값에서 검색
"both" : 라벨과 값 모두에서 검색]]>
- selectedData
-
[default: true, false] inputType이 "select" 또는 "autoComplete"인 경우 값이 바인딩된 DataList의 목록에 없을 경우 기존 값 유지 여부
<![CDATA[(옵션 설명)
"true" (기본 값) : 입력 값을 무시하고 이전 값 유지
"false" : 입력 값으로 대체]]>
- separator
-
[default: 공백(space)] inputType이 "checkcombobox"인 경우 선택된 항목을 구분할 문자
- showDepth
-
inputType이 "drilldown"인 경우 처음 로딩시 보여줄 깊이 값 (깊이 값이 상위인 영역을 포함하여 보여짐)
- skipKeyMoveEditMode
-
[default: false, true] GridView에 설정된 특정 속성 값들을 무시할 지에 대한 여부
<![CDATA[(옵션 설명)
false (기본 값) : 무시하지 않고 설정 값대로 동작함
true : 설정 값과 상관없이 동작하지 않음
무시되는 특정 속성 : keyMoveEditMode, moveKeyEditMode, moveKeyEditModeAll]]>
- sortable
-
[default: false, true] 데이터 정렬 기능의 사용 여부 (GridView의 헤더영역의 클릭 또는 더블-클릭 이벤트를 통해 지원)
- sortLabel
-
[default: false, true] inputType이 "select", "autoComplete", "custom"이고, sortable이 "true"인 경우 라벨을 기준으로 정렬할 지의 여부 (Body 영역에 설정해야 함)
<![CDATA[(옵션 설명)
"true" : 라벨을 기준으로 정렬
"false" (기본 값) : 값을 기준으로 정렬]]>
- textAlign
-
셀의 텍스트 정렬방법을 설정
<![CDATA[(제약 사항)
senseReader가 "true"이고, inputType이 "select"인 경우 text-align이 지원 가능한 브라우저(chrome, edge, firefox)에서 지원 가능)]]>
- textImageRenderType
-
[defualt: "component", "div"] inputType이 "textImage"인 경우 브라우저에 표현될 셀 구조
<![CDATA[(옵션 설명)
"component" (기본 값) : table 태그를 사용
"div" : text 영역은 div tag를 사용하고, 이미지는 button tag 사용.]]>
- trueValue
-
valueType이 "other"인 경우 해당 셀이 선택된 경우 가지게 될 값
- type
-
[default: text] HTML 의 태그와 동일한 기능으로 Input시 나타낼 타입을 명시 (text, drilldown, textImage 만 가능)
- typeGetter
-
inputType이 "custom"인 경우 셀의 타입을 동적으로 설정하기 위한 함수 (drilldown 미지원)
<![CDATA[(함수 설명)
셀에 표현할 inputType에 대한 정보 동적으로 구성
매개변수 : colID, colIndex, rowIndex, realRowIndex가 포함된 JSON 객체로 구성 ]]>
<![CDATA[(사용 예)
<w2:column id="col1" inputType="custom" typeGetter="scwin.gridView1_getType"></w2:column>
scwin.gridView1_getType = function(info) {
var rowIndex = info.rowIndex;
var colIndex = info.colIndex;
var returnInfo;
var inputType = inputTypeDataList.getCellData( rowIndex, colIndex );
switch(inputType) {
case "select":
returnInfo = {
id : "dynamic_select_" + rowIndex + "_" + colIndex,
inputType : "select",
options : {viewType: "icon", textAlign : "left", displayMode : "value"},
itemSet : {
nodeset: "data:dataList1",
label: "label",
value: "value"
}
}
break;
case "text":
returnInfo = {
id : "dynamic_text_" + rowIndex + "_" + colIndex,
inputType : "text",
options : {}
}
break;
}
return returnInfo;
}]]>
- upperColumn
-
colMerge시에 기준으로 할 열의 아이디
- useFilter
-
[default:false, true] 필터의 사용 여부 (필터링을 수행할 각 컬럼별로 설정)
<![CDATA[(옵션 설명)
"true" : 필터 사용
"false" (기본 값): 필터 사용하지 않음]]>
- useKeywordHighlight
-
[default: false, true] inputType이 "autoComplete"인 경우, 검색 결과 항목중 사용자 입력값(키워드)에 별도의 클래스(Class)를 적용하여 다르게 표시할지 여부
<![CDATA[(옵션 설명)
"false" (기본 값) : 적용하지 않음
"true" : 클래스 적용 (검색된 항목중 키워드에 "w2autoComplete_keyword" 클래스를 적용)]]>
- useLocale
-
[default: false, true] 라벨값을 다국어 키를 이용하여 표현하여 다국어의 사용이 가능하도록 설정 (세부 내용은 다국어 설정 가이드 - 클라이언트 편을 참고)
<![CDATA[(옵션 설명)
"false" (기본 값) : 다국어 키를 이용하지 않음
"true" : 다국어 키를 이용하여 다국어 지원]]>
- useMonthYearFormat
-
[default: false, true] 달력에서 보여지는 선택창의 순서를 "연도/월"에서 "월/연도"로 변경
단, 데이터컬렉션과 연동 시 데이터컬렉션에 저장되는 값은 한국식 표현인 "연" > "월" > "일" 순서로 저장됨
- validateOnInput
-
[default: false, true] inputType이 "text", "calendar"인 경우 유효성을 검사할 지의 여부 (oninput 이벤트를 지원하는 IE9이상 브라우저 지원)
<![CDATA[(옵션 설명)
true: 입력 값이 변경되는 시점에 유효성 검사를 수행함
false (기본 값): 입력 값이 변경되는 시점에 유효성 검사를 수행하지 않음]]>
- validator
-
입력이 가능한 컬럼에서 포커스가 빠져나가는 시점에 본 속성에 정의한 함수를 실행
엑셀수식을 동일하게 사용할 수 있으며, 컬럼명을 설정하게 되면 다운로드시 엑셀좌표값으로 변경하여 적용
<![CDATA[(사용 예)
function fn_idValid(tmpVal){ // tmpVal는 셀이 가진 값임
return tempVal + "$$";
} };]]>
- value
-
셀의 값
- valueType
-
[default: "binary", "boolean", "other"] inputType이 "radio" 혹은 "checkbox"인 경우 trueValue 값과 falseValue 값의 종류를 결정
- viewType
-
[default: "default", "icon"] inputType에 헤당하는 아이콘을 표시
<![CDATA[(옵션 설명)
"icon" : 아이콘을 표시
"default" (기본 값 ): 아이콘을 표시하지 않음]]>
- viewTypeIconImage
-
[default: false, true] inputType이 "calendar" 혹은 "autoComplete"이고, viewType이 "icon"인 경우, 아이콘클릭으로 편집모드 진입 여부
<![CDATA[(옵션 설명)
"true" : 편집모드에 진입하지 않고 항목리스트가 표시됨
"false" (기본값) : 편집모드 진입 후 추가 클릭 시 항목리스트가 표시됨]]>
<![CDATA[(관련 속성)
inputType : calendar, autoComplete
viewType : icon]]>
- voidNull
-
inputType이 "link"인 경우 href의 속성값을 "javascript:void(null);"로 설정
- width
-
컬럼의 너비
- yearSuffix
-
inputType이 "calendar"인 경우 연도 선택창에 보여질 값의 숫자(연도) 뒤에 들어갈 문자열
연도만 나타내고 싶은 경우 $blank로 정의함