- adaptiveStyle
-
GridView의 adaptive 모드 진입시 적용할 클래스.
(현재는 height만 지원)
- allOption
-
inputType이 selectbox인 경우에 전체를 선택하는 라벨을 표시.
- allowChar
-
사용자 입력 가능 문자 설정.
- alt
-
inputType이 image, textImage 인 경우에 이미지의 alt 속성.
- applyFormat
-
편집 모드 및 모든 경우에 포맷을 적용할지 여부.
<![CDATA[(옵션 설명)
"all"
"display"]]>
- autocomplete
-
HTML5의 autocomplete 기능으로 type에 따른 validation 후 사용자에게 알려줘야 할 문구를 명시.
해당 속성을 사용하는 브라우저에서는 동작하며, 브라우저마다의 동작 방식이 상이할 수 있음.
- autoFitFilterList
-
useFilterList와 useFilter 속성 "true"로 설정 후, header 필터 list에 있는 item 길이에 맞게 필터의 width가 조정되도록 설정. [default: false, true]
- blockSelect
-
해당 컬럼의 선택을 막을지에 대한 여부.
- calendarClass
-
Calendr의 스킨 종류. [default:class1, class2, class3, class4, class5]
- calendarValueType
-
inputType이 calendar인 경우에 calendar의 타입.
- checkAlways
-
헤더 및 바디 컬럼의 inputType이 checkbox인 경우 헤더 체크시에 readOnly나 disabled된 row도 함께 체크.
body에 속성을 줘야함.
- checkboxLabel
-
inputType="checkbox"인 경우 label을 표시하기 위한 속성.
해당 속성값을 checkbox 옆에 표시.
checkboxLabelPosition속성으로 좌우 위치를 결정.
- checkboxLabelColumn
-
inputType="checkbox"인 칼럼의 경우 다른 컬럼의 정보를 조합하여 해당 컬럼의 label을 생성. (웹 접근성 지원.)
해당 컬럼의 label을 생성하기 위해 참조할 ID를 구분자(',')를 사용하여 여러 개 지정 가능.
<![CDATA[(사용 예)
// 아래 예제의 경우 col1의 label은 (col1의값 + ',' + col3의값 + ',' + col5의값)으로 표현된다.
<w2:colummn id='col1' checkboxLabelColumn='col1,col3,col5'/>
]]>
- checkboxLabelDelimiter
-
checkboxLabelColumn의 label 구분자 [default: ","]
- checkboxLabelFormatter
-
inputType="checkbox"인 경우 CheckBox 버튼의 label로 표시할 값으로의 변환을 수생하는 함수 이름. (웹 접근성 지원용.)
지정한 함수가 반환하는 값이 label로 사용되며, 함수의 인자로 rowIndex, colIndex, label 3개가 전달되어야 함.
<![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
-
checkbox에 label을 표시할 경우 해당 label을 checkbox 왼쪽에 나타낼지, 오른쪽에 나타낼지를 결정. [default: right]
- 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
-
inputType="checkcombobox"인 칼럼의 경우 목록이 펼쳐졌을 때 마우스 드래그 동작을 통해 여러 checkbox를 직사각형 형태로 선택 / 선택해제 할 수 있는 기능
shift키를 누른 상태로 마우스를 드래그하면 선택해제 모드가 된다.
<![CDATA[(옵션 설명)
"true" : shift키를 누르지 않은 상태에서는 마우스 드래그를 통해 직사각형 영역 안의 모든 checkbox를 선택한다. shift키를 누르고 드래그하면 영역 안의 checkbox 선택을 해제한다.
"false" : (기본 값) 마우스 드래그 동작읉 통한 여러 checkbox를 선택하는 기능을 사용하지 않는다.]]>
- checkcomboboxUseEdit
-
inputType="checkcombobox"인 칼럼의 경우 checkcombobox 값을 직접 타이핑하여 편집할 수 있는 기능
<![CDATA[(옵션 설명)
"true" : 마우스로 checkcombobox를 클릭하면 편집 모드 상태가 되어 값을 직접 타이핑하여 편집하는 기능을 사용할 수 있다.
"false" : (기본 값) 값을 직접 편집할 수 없음 (마우스로 목록을 열고 체크박스를 체크하거나 setValue API 호출을 통해서 값을 변경해야 함.)]]>
- checkcomboboxValidateOnInput
-
[default:false] inputType="checkcombobox"인 칼럼의 경우 useEdit 사용 시 값이 입력될 때마다 유효성을 검증하는 기능 (oninput 이벤트를 지원하는 IE9이상 브라우저 지원)
<![CDATA[ (옵션 설명)
"false" (기본 값) : 적용하지 않음.
"true" : checkcombobox 값 편집 시 키보드로 입력할 때마다 값에 대한 유효성 검사를 적용해서 유효하지 않는 값의 입력을 막는다.
(관련 속성)
useEdit]]>
- checkcomboboxVisibleColMax
-
inputType="checkcombobox"인 칼럼의 경우 목록을 펼쳤을 때 보여줄 열의 최대 개수. 보여줄 열의 개수를 항목의 개수에 따라 자동으로 설정할 때 사용한다.
visibleColNum = Math.min(visibleColMax, Math.ceil(itemCount / visibleRowNum))
visibleColNum 설정이 있을 경우 이 설정은 무시된다.
<![CDATA[(옵션 설명)
"visibleRowNum=5,visibleColMax=8"
항목의 총 수가 40개보다 적은 경우에는 항목이 5배수 단위로 늘어날 때마다 열이 1개씩 추가된다.
항목의 총 수가 4개이면 4*1, 12개이면 5*3, 24개이면 5*5, 30개이면 5*6 직사각형 형태로 출력된다.
항목의 총 수가 40개보다 큰 경우에는 세로 스크롤이 생긴다. 목록은 5*8 직사각형 형태로 출력된다.
(관련 속성)
visibleColNum : 이 설정이 적용되어 있는 경우 visibleColMax 설정은 무시된다.]]>
- checkcomboboxVisibleColNum
-
inputType="checkcombobox"인 칼럼의 경우 목록의 열의 개수. 기본값은 1이다.
<![CDATA[(옵션 설명)
3 : 열의 개수가 3개, 행의 개수가 Math.ceil(데이터 수/3)인 직사각형 형태로 목록이 표현된다.]]>
- checkcomboboxVisibleRowNum
-
inputType="checkcombobox"인 칼럼의 경우 목록에 보여줄 행의 개수. "1"로 설정하는 것은 비권장.
<![CDATA[(옵션 설명)
5 : 전체 데이터가 5*column보다 적은 경우에는 데이터수/column수 만큼 행을 보여주고 데이터가 그보다 더 많은 경우에는 행을 5개만 보여주고 세로 스크롤이 생긴다.]]>
- chooseOption
-
선택 안내 메시지 표시 여부.
chooseOptionLabel 속성이 설정된 경우 해당 값을 표시.
단, chooseOptionLabel 속성이 설정되지 않고 chooseOption="true"인 경우, 선택 항목 목록에 "-선택-"(label)이 표시됨.
이 때 value는 ""(empty string)으로 설정됨.
<![CDATA[ (옵션 설명)
"true" 선택 안내 메시지를 표시. chooseOptionLabel 속성에 설정 된 값을 표시.
"false" (기본 값) 선택 안내 메시지를 표시하지 않음. ]]>
<![CDATA[ (관련 속성)
chooseOptionLabel]]>
- chooseOptionLabel
-
선택 안내 메시지로 표시할 텍스트의 label을 정의.
chooseOption="true"인 경우 유효.
<![CDATA[ (관련 속성)
chooseOption="true"]]>
- class
-
column에 적용할 클래스.
- closeonmouseleave
-
subLayer로 열린 경우, 선택 항목 목록에서 마우스 커서가 빠져나갈 때 목록을 닫을지 여부.
<![CDATA[(옵션 설명)
"false" (기본 값) : 목록을 닫지 않음.
"true" : 목록을 닫음.]]>
- colMerge
-
선택한 열에서 동일데이터 행 반복시 하나의 셀로 표현.
- colSpan
-
span할 열의 수.
- copyOption
-
그리드에서 데이터를 복사할 때 dataList에 들어있는 값을 기준으로 복사할 지 (dataList), 또는 화면에 보이는 기준(display)으로 복사할지를 설정한다.
copyOption은 gridView 전체 설정도 가능하며 우선순위는 column개별 설정이 더 높다.
<![CDATA[(옵션 설명)
"dataList" (기본 값) : 데이터 복사 시 dataList에 들어있는 값을 기준으로 복사한다.
"display" : 데이터 복사 시 화면에 출력된 값을 기준으로 복사한다.
(사용 예)
gridView (1,1) 셀의 inputType이 "select" 이고 dataList값(value)은 "1001", 화면에 출력된 값(label)은 "a1" 일 때
copyOption이 dataList인 경우 해당 cell을 복사 시 clipboard에 "1001"이 복사된다.
copyOption이 display인 경우 해당 cell을 복사 시 clipboard에 "a1"이 복사된다.]]>
- customFormatter
-
data, formattedData, rowIndex, colIndex 인자를 받는 조건부 서식 formatter 함수명.
inputType="text", "link", "textImage", "textarea", "select", "expression", 혹은 "spinner"인 경우에만 유효.
- customModelFormatter
-
dataCollection과 바인딩 시, dataCollection에 값이 저장되기 전에 실행되는 사용자 정의 함수. [default: ""]
사용자 정의 함수가 실행되고, 해당 함수가 반환하는 (포맷된) 값이 dataCollection에 저장됨.
GridView가 inputType="text" 혹은 inputType="textImage" 설정을 사용하는 경우 사용 가능.
반드시 customModelUnformatter와 함께 사용해야 함.
- customModelUnformatter
-
dataCollection과 바인딩 시, dataCollection에서 값을 읽어올 때 값을 반환하기 전에 실행되는 사용자 정의 함수. [default: ""]
예를 들어 getCellDisplayData API를 실행하면, 해당 속성으로 정의한 사용자 정의 함수를 실행한 결과 값을 반환.
customModelFormatter를 실행한 결과값을 customModelUnformatter를 실행했을 때 원본 데이터가 나와야 함.
- dataType
-
column의 데이터 Type.
설정하지 않은 경우 dataColleciton(dataList)의 dataType을 사용.
subTotal 및 footer는 GridView column에 dataType을 설정.
(주의사항) dataType이 "number" 또는 "float"인 경우 정수부+소수부의 합이 12자리를 넘으면 데이터가 반올림되어 표현된다.
큰 숫자나 정밀한 소수점을 오차 없이 표현하려면 dataType="bigDecimal"을 사용해야 한다.
- dateValidCheck
-
dataType="date"인 경우에 유효성 확인.
- dateValidSet
-
[default: false, true] dataType="date"인 경우에 입력된 날짜 값의 유효성을 확인하여, 유효하지 않을 경우 이전 값으로 복귀.
- dateValidSetCustom
-
[default: false, true] dateValidSet 기능 사용 시 유효하지 않는 값이 들어왔을 때 invalidMessageFunc만 호출하는 속성.
유효하지 않은 값이 입력되었을 때 invalidMessageFunc만 호출하며, alert창을 띄우지 않고 값을 이전으로 되돌리는 처리도 하지 않는다.
invalidMessageFunc에서 alert 대신 사용자 messagePopup을 띄우고 해당 popup이 닫혔을 때 값을 이전으로 되돌리는 처리를 직접 하고자 할 때 사용하는 속성
값을 이전으로 되돌리고 포커스를 다시 주고자 하는 경우 messagePopup의 onpageload 이벤트에서 inputCalendar.setValueCancel을 직접 호출한다.
- defaultValue
-
셀의 초기값.
- delimiter
-
value와 label을 함께 표현할 때 사용하는 구분자.
inputType="selectbox" 혹은 inputType="autocomplete" 컬럼에서만 동작.
displayMode 속성의 "delim"에 해당하는 값이 본 속성에 정의된 값.
- depthColumn
-
inputType="drilldown"인 경우, depth를 표시할의 id.
- depthType
-
drilldown 사용 시 노드의 연관 관계를 표현하는 방식.
<![CDATA[(옵션 설명)
"nbsp" (기본 값) : 공백(default)
"div" : 빈 div 상자
"line" : 이미지로 표현
"none" : 미표현]]>
- directOpen
-
GridView의 autoComplete에서 화살표 클릭시 아이템 테이블 바로 열리는 기능. viewType="icon", viewTypeIconImage="true"일 경우.
focus가 있는 상태에서 autoComplete, selectbox에서 enter key입력시에도 바로 열리는 기능.
- disabled
-
셀 비활성 여부.
<![CDATA[(옵션 설명)
"false" (기본 값) : 셀을 비활성화 하지 않음.
"true" : 셀을 비활성화 함.]]>
- disabledClass
-
셀이 disabled 일때 추가할 클래스 이름.
- displayFormat
-
셀에 값을 표시하는 format
- displayFormatFunc
-
dataType="date"인 경우 적용할 사용자 정의 함수.
해당 함수의 반환 값으로 displayFormat을 설정.
displayFormat이 이미 설정되어 있는 경우에는 이 속성은 무시됨.
- displayFormatter
-
셀의 데이터 값을 포맷할 사용자 정의 함수.
함수를 직접 정의해야 함.
- displayMode
-
선택 항목 표현 방법. [default: label, value delim label, label delim value, value]
label과 value를 함께 표현하는 것이 가능.
inputType="selectbox" 혹은 inputType="autocomplete" 컬럼에서만 동작.
delim(구분자)는 delimiter속성에 정의된 값을 사용.
- displayType
-
inputType="textarea"인 경우, 셀을 늘려서 텍스트를 모두 표시.
그리드의 width가 지정되어 있어야 하고, 가로 스크롤이 없는경우에만 동작.
- editModeEvent
-
셀 수정 모드로 진입하기 위해 필요한 마우스 동작 이벤트. [default: ondblclick, onclick, onsecondclick]
<![CDATA[(옵션 설명)
"onclick" : 셀을 클릭할 경우 셀 수정 모드로 진입.
"ondblclick" (기본 값): 셀을 더블-클릭할 경우 셀 수정 모드로 진입.
"onsecondclick": 셀 클릭 후 다시 클릭하거나 키를 입력할 경우 수정 모드로 진입.]]>
- editModeEventIcon
-
viewType="icon"인 컬럼에서 수정 모드로 진입하기 위해 필요한 마우스 동작 이벤트.[default: onclick, ondblclick]
<![CDATA[(옵션 설정)
"onclick" (기본 값): 아이콘을 클릭할 경우 셀 수정 모드로 진입.
"ondblclick": 아이콘을 더블-클릭할 경우 셀 수정 모드로 진입.
(!주의!)
gridView.column과 GridView 모두 editModeEventIcon 설정을 정의한 경우,
gridView.column의 설정이 우선함.]]>
- editType
-
사용자가 컴포넌트 클릭 시 결과 동작 지정.
<![CDATA[ (옵션 설명)
"select" (기본 값) 포커스가 발생할 때 선택된 텍스트를 선택.
"focus" 텍스트의 맨 끝으로 커서를 이동.]]>
- embeddedInput
-
셀 내부에 입력 컴포넌트를 내장할 것인지, 아니면 editMode로 전환시 동적으로 추가.
inputType="text", "select", 혹은 "textarea"인 경우 사용 가능.
- escape
-
<>&"를 HTML Escape 문자로 변환하여 화면에 표시.
<![CDATA[(옵션 설명)
"true" (기본 값) : Escape 문자로 변환하지 않음.
"false" : Escape 문자로 변환하여 화면에 표시.]]>
- escapeFormatter
-
data, rowIndex, colIndex 인자를 받는 escapeFormatter 함수 명.
정의한 format에서 엔진에서 파라메터로 넘겨준 value에 format을 적용 한 뒤 return 값을 통해 적용.
customFormatter와 동작은 거의 동일하나 사용하는 목적이 <script> 태그와 같은 보안상 이슈가 발생하는 문자열을 직접 제어하기 위해 사용.
inputType이 text인 경우만 동작.
가장 먼저 적용되는 formatter.
<![CDATA[(사용 예)
전역 스크립트에 아래를 정의한 후, 본 속성으로 "fn_escapeFormat"를 지정.
function fn_escapeFormat (tmpVal, rowIndex, colIndex){
var colId = this.getColumnID(colIndex);
if(colId == "xxx"){
return tmpVal.replace(/<script.*script>/g, "")
}
};]]>
- eventPriority
-
inputType='select' 일 때 값 편집 후 이벤트 순서를 onviewchange를 먼저 발생할지, oneditend를 먼저 발생할지를 지정하는 속성. [default: onviewchange, oneditend]
하위호환 유지를 위해 만든 속성.
- eventPropagation
-
inputType="checkbox" 또는 "radio" 일 때 click event를 전파할지에 대한 여부. [default: fasle, true]
<![CDATA[(옵션 설명)
"true" : click 이벤트 발생 시 이벤트를 전파한다. checkbox 버튼 클릭 시 상위에 등록한 dom (gridView, body 등등)에 click 이벤트가 발생한다.
"false" : 기본값. click이벤트가 전파되지 않는다. checkbox 버튼 클릭 시 상위 dom에 click이벤트가 발생하지 않는다.]]>
- excelCellType
-
다운로드한 Excel 파일 상에서 출력할 데이터의 표시 형식(셀 타입)을 지정.
advancedDataDownload() 함수를 통해 GridView를 Excel 파일로 다운로드할 경우 options.useDataFormat : "true" 옵션을 사용해야 함.
<![CDATA[(옵션 설명)
"number" : "숫자" 출력.
"bigDecimal" : "숫자" 출력.
"text" : "텍스트" 출력.
"date" : "날짜" 출력.]]>
- excelExpression
-
GridView의 advancedExcelDownload를 통해 엑셀 다운로드시 엑셀 수식을 적용할 수 있는 속성.
엑셀수식을 동일하게 사용할 수 있으며, 컬럼명을 설정하게 되면 다운로드시 엑셀좌표값으로 변경하여 적용.
(관련 API: GridView의 advancedEXcelDownload)
<![CDATA[(사용 예)
excelExpression="sum('column1','column2',column3')"
엑셀적용수식 : sum(A1,A2,A3)]]>
- excelFormat
-
GridView의 advancedExcelDownload를 통해 Excel 파일을 다운로드할 때 Excel에서 지원하는 format을 설정.
excelFormat과 displayFormat이 동시에 설정되어 있는 경우, excelFormat이 적용됨.
(관련 API: GridView의 advancedExcelDownload)
- excelFormatter
-
GridView의 advancedExcelDownload를 통해 Excel 파일을 다운로드할 때 Excel에서 지원하는 format을 사용자 함수에서 받아서 excelFormat을 지정.
excelFormat과 displayFormat이 동시에 설정되어 있는 경우, excelFormat이 적용됨.
(관련 API: GridView의 advancedExcelDownload)
- expression
-
inputType="expression"인 경우의 계산식.
<![CDATA[(사용 가능 함수)
SUM( 컬럼ID ) : 해당 컬럼 데이터의 총합을 리턴. footer나 subtotal에서 사용된다.
AVG( 컬럼ID ) : 해당 컬럼 데이터의 평균을 리턴. footer나 subtotal에서 사용된다.
MIN( 컬럼ID ) : 해당 컬럼 데이터의 최소값 리턴. footer나 subtotal에서 사용된다.
MAX( 컬럼ID ) : 해당 컬럼 데이터의 최대값 리턴. footer나 subtotal에서 사용된다.
COUNT( 컬럼ID, 옵션 ) : 해당 컬럼의 각 그룹의 건 수를 리턴. blank 옵션을 false로 설정하면 빈 값을 세지 않음. footer나 subtotal에서 사용된다.
targetColValue() : 해당 subtotal의 target column의 값을 리턴. subtotal에서 사용된다.
targetColLabel() : 해당 subtotal의 target column의 label을 리턴. (inputType이 select,autoComplete,checkcombobox인 경우) subtotal에서 사용된다.
display( 컬럼ID ) : 해당 컬럼 데이터의 값을 리턴. dataList에 저장된 값을 리턴한다. body column에서 사용된다.
datalist( 컬럼ID ) : 해당 컬럼 데이터의 값을 리턴. gridView와 매핑되지 않은 dataList의 column 값도 가져올 수 있다. body column에서 사용된다.
SUMIF( 컬럼ID, 조건, 조건 컬럼 ) : 해당 컬럼 데이터 중 조건에 만족하는 총합을 리턴. footer나 subtotal에서 사용된다.
SUMIFS( 컬럼ID, [조건1, 조건 컬럼1, 조건2, 조건컬럼2, ...] ) : 해당 컬럼 데이터 중 여러 조건에 만족하는 총합을 리턴. footer나 subtotal에서 사용된다.
SUMIF, SUMIFS의 조건에서 '>', '<', '>=', '<=', '!=', "==" 연산자를 사용할 수 있음.]]>
<![CDATA[(예제)
<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의 label을 리턴한다.
<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="sumifs('col1','>1',"col2",'a','col3')"/> // col2의 값이 1보다 크고 col3의 값이 'a'인 col1 컬럼의 합을 구한다.]]>
- falseValue
-
valueType="other"일 때 쓰일 셀이 해제된 경우 가지게 될 값.
- filterDisplayMode
-
항목의 표현 방법. [default: value]
<![CDATA[(옵션 설명)
"value"
"label"
"label delim value"
"value delim label"]]>
- fixColumnWidth
-
컬럼의 가로 길이를 고정할 지에 대한 여부. [default: fasle, true]
<![CDATA[(옵션 설명)
"true" : autoFit 영향을 받지 않으며, 또한 마우스를 통한 컬럼 가로길이 조정 기능이 동작하지 않음.
"false"]]>
- hidden
-
컬럼의 hidden 유무.
- hiddenClass
-
해당 컬럼이 hidden되는 경우 추가할 클래스 이름.
- hideCustomFilter
-
useFilter="true"인 경우 필터에서 사용자 정의 필터를 숨김.
<![CDATA[(옵션 설명)
"true" : 사용자 정의 필터를 숨김.
"false" : 사용자 정의 필터를 표시.]]>
- hideThreshold
-
화면 사이즈가 줄어들 때 해당 컬럼을 숨김 처리하기 위한 임계값. (단위: px)
값을 설정하지 않을 경우, 사이즈 변경에 따른 컬럼 숨김 기능이 동작하지 않음.
- id
-
컬럼의 id
- ignoreChar
-
설정된 사용자(end user) 입력 가능 문자 중 사용 불가능 문자 설정.
- imageClickFunction
-
inputType="image" 혹은 inputType="textimage"인 경우, 셀 클릭 시 실행할 함수.
해당 함수의 인자로는 rowIndex, colId, nowValue가 전달된다.
<![CDATA[(사용 예)
<w2:column id="col1" inputType="textImage"
imageClickFunction="scwin.gridView_imageClickFunc"/>
<script type="text/javascript" lazy="false"><![CDATA[
scwin.gridView_imageClickFunc = function(rowIndex, colId, nowValue){
alert('image clicked!');
}
]]]]><![CDATA[>]]>
- imageHeight
-
inputType="image" 혹은 inputType="textimage"인 경우, 이미지의 높이.
- imageSrc
-
inputType이 image인 경우에 이미지의 경로.
- imageWidth
-
inputType="image" 혹은 inputType="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"]]>
- ioFormat
-
date 타입일 경우 포맷 변환에 사용할 입출력 데이터의 포맷
<![CDATA[(사용 예)
ioFormat="yyyyMMdd"
ioFormat="yyyyMM"]]>
- localeRef
-
클라이언트 다국어 적용시 화면에 출력하는 텍스트의 key.
key에 해당하는 텍스트가 없을 경우 "global_undefined"가 화면에 표시됨.
- maskFormatModelExcludeChar
-
maskFormat을 사용하고 dataCollection과 바인딩 시, dataCollection에 저장할 때 제외할 char을 지정.
dataCollection에는 maskFormatModelExcludeChar을 제외한 문자열이 저장됨.
- max
-
dataType이 number인 경우에 최대 값
- maxByteLength
-
최대 Byte 길이.
inputType="text", "textarea", "textImage", 혹은 "secret"인 경우.
- maxLength
-
최대 길이.
inputType="text"(혹은, input, textarea, textImage, secret)인 경우에만 유효.
- min
-
dataType이 number인 경우에 최소 값
- minWidth
-
컬럼의 최소 너비. (단위:px) [기본값: 20]
- monthNames
-
1~12월을 나타내는 문자열을 콤마(,)로 구분한 스트링.
- navBtn
-
inputType이 "checkcombox"인 컬럼의 경우, 선택 목록 하단에 [선택해제] 및 [선택적용] 버튼을 표시.
[선택해제] - 항목 선택을 취소.
[선택해제] - 항목 선택을 적용.
<![CDATA[(옵션 설명)
"true" : [선택해제] 및 [선택적용] 버튼을 표시.
"false" (기본 값) : 표시하지 않음.]]>
- noDisabledOnReadOnly
-
inputType="checkbox" 또는 "radio" 일 때 readOnly 상태를 disabled로 처리하지 않고 별도로 처리하도록 하는 속성. [default: fasle, true]
<![CDATA[(옵션 설명)
"true" : inputType="checkbox" 또는 "radio"인 cell이 readOnly=true 상태일 때 disabled 처리되지 않으며, oncellclick 등의 이벤트 또한 발생한다.
"false" : 기본값. inputType="checkbox" 또는 "radio"인 cell이 readOnly=true 상태일 때 disabled 처리되며 어떠한 이벤트도 발생하지 않는다.]]>
- orderByColumn
-
병합된 헤더에서 정렬 기준이 되는 body column의 id값 지정.
- partialCheckNextClick
-
그리드에서 checkbox 헤더의 부분 체크(indeterminate) 속성 사용 시, 부분 체크된 헤더 클릭시 동작 정의.
<![CDATA[(옵션 설명)
"uncheck" : 전체 해제.
"check" : 전체 선택.]]>
- placeholder
-
inputType이 [text, textarea, textImage, calendar, spinner, secret, autoComplete]일 떄 동작. 편집모드 진입 시 placeholder가 노출된다.
HTML5의 placeholder와 동일한 기능을 제공. 사용자에게 알려줘야 할 힌트 문구 등을 명시.
cell 값이 비어 있을 때 placeholder로 설정한 값이 표시되며, 값을 입력하는 순간 사라짐.
브라우저 별로 동작 방식이 상이. (예: IE는 포커싱을 할 경우 문구가 사라지지만, Chrome은 텍스트 입력 시 문구가 사라짐.)
- radioLabel
-
inputType이 radio인 경우 label을 표시하기 위한 속성.
해당 속성값을 radio 옆에 표시.
radioLabelPosition속성으로 좌우 위치를 결정.
inputType="checkbox"와 다르게 radio속성은 body에만 유효하고 header에서는 지원하지 않음.
- radioLabelColumn
-
inputType="radio"인 칼럼의 경우 다른 컬럼의 정보를 조합하여 해당 컬럼의 label을 생성. (웹 접근성 지원.)
해당 컬럼의 label을 생성하기 위해 참조할 ID를 구분자(',')를 사용하여 여러 개 지정 가능.
<![CDATA[(사용 예)
// 아래 예제의 경우 col1의 label은 (col1의값 + ',' + col3의값 + ',' + col5의값)으로 표현된다.
<w2:colummn id='col1' radioLabelColumn='col1,col3,col5'/>
]]>
- radioLabelFormatter
-
inputType="radio"인 경우 Radio 버튼의 label로 표시할 값으로의 변환을 수생하는 함수 이름. (웹 접근성 지원용.)
지정한 함수가 반환하는 값이 label로 사용되며, 함수의 인자로 rowIndex, colIndex, label 3개가 전달되어야 함.
<![CDATA[(사용 예)
<w2:colummn id='col1' radioLabelFormatter='scwin.gridView1_col1_radioLabelFormatter'/>
scwin.gridView1_col1_radioLabelFormatter = function(row, col, label){ return row + "," + col + "," + label;}
]]>
- radioLabelPosition
-
radio에 label을 표시할 경우 해당 label을 radio 왼쪽에 나타낼지, 오른쪽에 나타낼지를 결정. [default: right]
- readOnly
-
컬럼의 readOnly 유무.
- readOnlyClass
-
readOnly 일때 추가할 클래스 이름.
- rowSpan
-
span할 행의 수.
- searchTarget
-
inputType="autoComplete"일 경우, 사용자의 입력 값을 기반으로 선택 항목을 제안하기 위해 검색할 대상을 지정. [default: label, value, both]
<![CDATA[(옵션 설명)
"label" (기본 값) : label 검색
"value" : value 검색
"both" : label과 value 모두 검색.]]>
<![CDATA[(관련 속성)
inputType="autoComplete"]]>
- selectedData
-
inputType = "select" 또는 "autoComplete"인 경우, 선택한 값이 바인딩된 DataList의 목록에 없을 경우 선택한 값 유지 여부. [default: true, false]
<![CDATA[(옵션 설명)
"true" (기본 값) : 선택 값을 무시하고 이전 값 유지.
"false" : 선택 값 유지.]]>
- separator
-
inputType="checkcombobox"일 경우, 선택된 항목을 구분할 문자. [default: 공백(space)]
- showDepth
-
inputType="drilldown"인 경우, 처음 로딩시 보여줄 depth.
- skipKeyMoveEditMode
-
특정 컬럼에 keyMoveEditMode, moveKeyEditMode, moveKeyEditModeAll 속성을 무시할지 여부. [default: false, true]
- sortable
-
데이터 정렬 기능의 사용 여부. [default:false, true]
header 클릭 또는 더블-클릭 이벤트를 통해 지원.
- sortLabel
-
Body 컬럼용 속성. Body 컬럼에 설정해야 함. [default: false, true]
body 컬럼의 inputType이 "select" 또는 "autoComplete" 또는 "custom"이고,
sortable = "true" 인 컬럼의 경우, label 값을 기준으로 정렬.
<![CDATA[(옵션 설명)
"true" : label 값을 기준으로 정렬.
"false" (기본 값) : value 값을 기준으로 정렬.]]>
- textAlign
-
셀의 텍스트 정렬 부분.
<![CDATA[(제약 사항)
senseReader = "true" 설정한 경우 inputType 이 "select" 인경우 해당 속성은 select 태그의 text-align이 지원가능한 브라우저(chrome, edge, firefox)에서 지원가능함.]]>
- trueValue
-
valueType="other"일 때 쓰일 셀이 선택된 경우 가지게 될 값.
- type
-
html <type> 태그와 동일한 기능. [default: text]
- typeGetter
-
inputType custom인 경우 동적 inputType 정보를 반환하는 함수명.
사용자 함수는 colID, colIndex, rowIndex, realRowIndex가 포함된 json object를 인자로 받아 cell에 표현할 inputType에 대한 정보를 반환.
<![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시에 기준으로 할 열의 ID.
- useFilter
-
필터 사용 여부. [default:false, true]
필터링을 수행할 각 컬럼 별로 설정.
<![CDATA[(옵션 설명)
"true" : 필터 사용.
"false" (기본 값): 필터 사용하지 않음.]]>
- useKeywordHighlight
-
inputType="autoComplete"일 경우, 검색 결과 중 사용자 입력값에 별도의 class를 적용하여 다르게 표시할지 여부. [default: false, true]
<![CDATA[ (옵션 설명)
"false" (기본 값) : 적용하지 않음.
"true" : 검색된 키워드에 "w2autoComplete_keyword" class를 적용.]]>
- useLocale
-
다국어 사용.
선택 항목의 label에 표현되는 값을 클라이언트의 다국어 key를 이용하여 표현.
(세부 내용은 다국어 설정 가이드 - 클라이언트 편을 참고.)
<![CDATA[(옵션 설명)
"false" (기본 값)클라이언트의 다국어 key를 이용하지 않음.
"true" 클라이언트의 다국어 key를 이용하여 다국어 지원.]]>
- useMonthYearFormat
-
달력에서 보여지는 연도/월 selectbox의 순서를 월/연도로 변경. [default: false, true]
dataCollection과 연동 시 dataCollection에 저장되는 값은 한국식 표현인 "연" > "월" > "일" 순서로 저장됨.
- userData1
-
사용자 정의 데이터 속성.
getUserData("userData1") API를 통해 설정한 값을 얻어올 수 있음.
<![CDATA[ // 속성 값 얻어오기 예시
getUserData("userData1");]]>
- userData2
-
사용자 정의 데이터 속성.
getUserData("userData2") API를 통해 설정한 값을 얻어올 수 있음.
<![CDATA[ // 속성 값 얻어오기 예시
getUserData("userData2");]]>
- userData3
-
사용자 정의 데이터 속성.
getUserData("userData3") API를 통해 설정한 값을 얻어올 수 있음.
<![CDATA[ // 속성 값 얻어오기 예시
getUserData("userData3");]]>
- validateOnInput
-
[default:false] inputType "text", "calendar"인 칼럼의 경우 input 컴포넌트의 유효성을 검사할지의 여부. (oninput 이벤트를 지원하는 IE9이상 브라우저 지원)
true: oninput 시점에 유효성 검사를 수행함.
false (기본 값): oninput 시점에 유효성 검사를 수행하지 않음.
- validator
-
입력이 가능한 컬럼에서 blur가 발생하는 시점에 본 속성에 정의한 함수를 실행한다.
엑셀수식을 동일하게 사용할 수 있으며, 컬럼명을 설정하게 되면 다운로드시 엑셀좌표값으로 변경하여 적용.
<![CDATA[(사용 예)
function fn_idValid(tmpVal){ // tmpVal는 cell의 value를 담는다.
return tempVal + "$$";
} };]]>
- value
-
셀의 값.
- valueType
-
inputType="radio" 혹은 "checkbox"인 경우 trueValue 값과 falseValue 값의 종류를 결정.
- viewType
-
컬럼의 inputType에 헤당하는 아이콘을 표시.
<![CDATA[(옵션 설명)
"icon" : 아이콘을 표시.
"default" (기본 값 ): 아이콘을 표시하지 않음.]]>
- viewTypeIconImage
-
calendar나 autoComplete의 경우, 아이템 테이블을 열기위한 화살표를 image로 표시할지 여부.
- voidNull
-
inputType이 link인 경우에 href의 속성값을 javascript:void(null);로 설정.
- width
-
컬럼의 width.
- yearSuffix
-
연도 숫자 뒤에 들어갈 문자열.