AUISoft
AUIGrid 3.0.10 Documentation
Properties

AUIGrid 에서 정의 가능한 속성 리스트입니다.

NameDescription
adjustSummaryPosition
Type : Boolean   Version: 3.0.6

그룹핑 소계 행(Summary Rows)을 그룹핑의 마지막 필드에 일괄적으로 열(column) 맞춤하여 출력시킬지 여부를 지정합니다.

이 속성은 fillValueGroupingSummary=true 설정이 선행되어야 합니다.

Also See : fillValueGroupingSummary | 관련 데모 보기

기본값(default) : false.
applyRestPercentWidth
Type : Boolean   Version: 2.7.0

칼럼 레이아웃 작성 시 칼럼의 width 를 퍼센티지(%) 로 설정한 경우 퍼센티지 적용 대상이 명시적 칼럼 사이즈를 제외하고 남는 width를 대상으로 할지 여부를 지정합니다.

예를 들어 칼럼을 3개 만든 경우 각각 "100", "50%", "50%" 로 작성했을 때 다음 처럼 반응합니다.

  • applyRestPercentWidth = false 인 경우 : 100 픽셀을 무시하고 전체 그리드 사이즈의 50% 공간을 각각 2번째, 3번째 칼럼 사이즈로 할당합니다.
  • applyRestPercentWidth = true 인 경우 : 전체 그리드 사이즈에서 100 픽셀을 제외한 공간에서 각각 50% 씩 칼럼 사이즈로 할당합니다.

이 속성은 칼럼의 width 속성을 명시적 사이즈와 퍼센티지 사이즈를 혼용해서 사용할 때만 유효합니다.

기본값(default) : false.
autoEditBeginMode
Type : Boolean   Version: 2.7.0

터치가 지원되는 모바일 기기(아이폰, 아이패드, 안드로이드 기기 등)로 접속 시 셀 편집을 탭(tap)하여 수정하게 만들지 여부를 지정합니다.

즉, autoEditBeginMode=true 설정하면 editBeginMode 가 "doubleClick" 이라도 모바일 기기로 접속하면 탭으로 수정 가능합니다.(PC는 기존 더블클릭 유지함)

기본값(default) : false.
autoEditCompleteMode
Type : Boolean   Version: 2.7.0

그리드 셀을 수정 중일 때 그리드 외의 HTML 바탕을 mouseDown 한 경우 수정을 종료 시킬지 여부를 지정합니다.

이 속성이 true 라면 그리드 셀 외의 다른 HTML 엘리먼트를 mouseDown 한 경우 편집 종료 이벤트가 발생합니다.

즉, 그리드 외의 다른 영역을 mouseDown 한 경우 자동 편집 종료가 됩니다.

기본값(default) : true.
autoEditCompleteOnResize
Type : Boolean   Version: 3.0.4

그리드 셀을 수정 중일 때 Global Resize 이벤트가 발생한 경우 수정을 종료 시킬지 여부를 지정합니다.

Global Resize 이벤트는 일반적으로 최상위 계층인 window 창의 크기가 변경된 경우를 말합니다.

기본값(default) : true.
autoGridHeight
Type : Boolean   Version: 3.0.5

삽입한 모든 데이터를 세로 스크롤 없이 출력하고 데이터에 맞게 그리드의 높이를 자동 결정할지를 지정합니다.

데이터를 삽입하기 전(또는 데이터 없는 경우)에는 최초 지정된 높이로 그리드가 출력되며 데이터를 삽입하거나 행을 추가하면 유동적으로 그리드의 높이는 맞게 변경됩니다.

이 속성을 true 로 설정하면 resize 메소드를 통해 사용자가 높이를 지정할 수 없습니다.

wordWrap 을 true 로 설정한 경우 이 속성은 무시됩니다. (단, usePaging=true, wordWrap=true 인 경우 autoGridHeight 은 사용 가능)

그리드의 세로 스크롤이 없이 데이터를 모두 출력하므로 많은 양의 데이터를 초기에 넣지 마십시오. 퍼포먼스에 악영향을 미칩니다.

Also See : wordWrap, usePaging | 관련 데모 보기

기본값(default) : false.
autoScrollSize
Type : Boolean   Version: 2.7.0

터치가 지원되는 모바일 기기(아이폰, 아이패드, 안드로이드 기기 등)에서 스크롤 높이(수직 스크롤인 경우 넓이)를 자동으로 작게 만들지 여부를 지정합니다.

만약 true 로 설정한다면 scrollHeight4Mobile 설정값으로 스크롤 크기가 적용됩니다.

기본값(default) : false.
blankNumericToNullOnEditing
Type : Boolean   Version: 3.0.6

dataType을 "numeric" 으로 설정한 셀을 수정할 때 사용자가 입력한 빈 값("")을 명시적인 null 로 처리할지 여부를 지정합니다.

기본적으로 사용자가 빈 값을 입력하면 "numeric" 필드로 설정했기 때문에 0 으로 수정 완료 처리됩니다.

true 인 경우 빈 값을 null 로 false 인 경우 빈 값을 0 으로 적용 시킵니다.

기본값(default) : false.
blankToNullOnEditing
Type : Boolean   Version: 3.0.6

수정할 때 사용자가 입력한 빈 값("")을 명시적인 null 로 처리할지 여부를 지정합니다.

기본적으로 사용자가 빈 값을 입력하면 "" 로 수정 완료 처리됩니다.

true 인 경우 빈 값을 null 로 false 인 경우 빈 값을 "" 로 적용 시킵니다.

기본값(default) : false.
cellColMergeFunction
Type : Function   Version: 3.0.5.5

가로 병합(cellColMerge)을 설정한 경우 특정 행의 가로 병합 실행 여부를 지정할 수 있는 함수 입니다.

cellColMergeFunction는 함수를 지정해야 하며 함수 형태는 다음과 같습니다.

  • rowIndex : 행 인덱스
  • columnIndex : 칼럼 인덱스
  • item : 해당 행에 출력되고 있는 행 아이템 객체 (Object)

Return : (Boolean) true 를 반환하면 가로 병합 실행, false 를 반환하면 가로 병합 하지 않습니다.

 cellColMergeFunction : function(rowIndex, column, item) {
   if(item.name == "Anna") { // 이름이 "Anna" 행은 가로 병합 하지 않습니다.
        return false; // false 를 반환하면 가로 병합 하지 않음
   }
   return true;
}

주의 : 이 속성의 값으로 지정된 함수는 렌더링 시 빈번히 호출됩니다. 따라서 이곳에서 DOM 검색이나, 복잡한 로직은 삼가하십시오. 성능에 영향을 미칩니다.

관련 데모 보기

기본값(default) : null.
cellMergePolicy
Type : String   Version: 2.12

셀 병합인 경우 (enableCellMerge=true) 널 데이터(null, undefined, "")에 대한 병합 정책을 결정합니다.

유효 값은 "default", "withNull", "valueWithNull" 입니다.

  • default : null 을 셀 병합에서 제외하여 병합을 실행하지 않습니다.
  • withNull : null 도 하나의 값으로 간주하여 다수의 null 을 병합된 하나의 공백으로 출력 시킵니다.
  • valueWithNull : null 이 상단의 값과 함께 병합되어 출력 시킵니다.
기본값(default) : "default".
cellMergeRowSpan
Type : Boolean   Version: 3.0.7

셀 세로 병합을 하는 경우(enableCellMerge=true) 실제 rowspan 처리 하여 보일지 여부를 지정합니다.

이 속성을 false 로 설정하면 실제 rowspan 은 처리하지 않고 상단에만 값을 출력하고 그 아래 대상의 셀은 빈 값으로 보이게 처리합니다.

false 설정하면 실제 rowspan 을 하지 않았기 때문에 병합된 셀 블럭이 아닌 개별 셀을 선택하고 수정 할 수 있습니다.

관련 데모 보기

기본값(default) : true.
contextMenuItems
Type : Array   Version: 3.0.8

컨텍스트 메뉴 아이템을 사용자 정의 할 수 있는 속성입니다.

Object 를 배열 요소로 갖는 배열을 정의하십시오. Object 가 하나의 컨텍스트 메뉴 아이템이 됩니다.

다음은 사용자 정의한 컨텍스트 아이템들 예시입니다.

  var myContextMenus = [ {
       // label 에 $value 를 설정하면 마우스가 있는 곳의 value 값으로 대체됩니다.
       label : "$value (커스텀)",  callback : contextItemHandler 
     }, {
       label : "_$line" // label 에 _$line 을 설정하면 라인을 긋는 아이템으로 인식합니다.
     }, {
       label : "Export To Excel", callback : contextItemHandler
     }, {
       label : "Open Google.com", callback : contextItemHandler
  }];
 
  • label (String) : 컨텍스트 메뉴에 표시될 텍스트 입니다. label 에 $value 를 설정하면 마우스가 있는 곳의 value 값으로 대체되어 출력됩니다.
  • style (String) : 개별 아이템의 스타일을 지정합니다. 유효값은 CSS 의 클래스 선언자명입니다.
  • disable (Boolean) : 컨텍스트 메뉴의 비활성화 여부를 지정합니다.
  • callback (Function) : 컨텍스트 메뉴에서 아이템을 선택했을시 호출 되는 함수입니다.

관련 데모 보기

기본값(default) : Array.
copyDisplayFunction
Type : Function   Version: 2.9.0

그리드의 셀 또는 행을 복사(Ctrl+C) 할 때 원래 데이터 값을 복사할 지 그리드에 의해 포매팅된 값을 복사할 지 여부를 결정할 수 있는 함수입니다.

예를 들어 실 데이터는 1000 이나, 그리드에 의해 "1,000원" 으로 포매팅되어 출력되고 있을 때 Ctrl+C 로 복사할 대상이 1000 또는 "1,000원" 인지를 동적으로 결정하게 됩니다.

copyDisplayFunction 는 copyDisplayValue 속성보다 우선 순위가 높습니다. 따라서 copyDisplayFunction 를 지정하면 copyDisplayValue 는 무시됩니다.

copyDisplayFunction는 함수를 지정해야 하며 함수 형태는 다음과 같습니다.

  copyDisplayFunction : function(rowIndex, columnIndex, value, item, columnItem) {
    // 드랍다운 리스트를 에디터로 작성한 경우는 포매팅된 값을 복사하도록 지시
    if(columnItem.editRenderer && columnItem.editRenderer.type == "DropDownListRenderer") {
         return true
    }
    return false; // 그 외는 일반 원래 값 복사하도록 지시
 }
  • rowIndex : 행 인덱스
  • columnIndex : 칼럼 인덱스
  • value : 해당 셀의 값
  • item : 해당 셀에 출력되고 있는 행 아이템 객체 (Object)
  • columnItem : 해당 셀에 출력되고 있는 칼럼 아이템 객체 즉, 칼럼 레이아웃에서 정의한 객체 (Object)

Return : (Boolean) true 를 반환하면 포매팅된 값을, false 반환하면 원래 값을 복사하게 결정합니다.

기본값(default) : null.
copyDisplayValue
Type : Boolean   Version: 2.7.0

그리드의 셀 또는 행을 복사(Ctrl+C) 할 때 원래 데이터 값을 복사할 지 그리드에 의해 포매팅된 값을 복사할 지 여부를 나타냅니다.

예를 들어 실 데이터는 1000 이나, 그리드에 의해 "1,000원" 으로 포매팅되어 출력되고 있을 때 Ctrl+C 로 복사할 대상이 1000 또는 "1,000원" 인지를 지정합니다.

copyDisplayValue = true 인 경우 "1,000원" 이 복사됩니다.

기본값(default) : false.
copySingleCellOnRowMode
Type : Boolean   Version: 2.10

셀렉션모드(selectionMode) 가 "singleRow" 또는 "multipleRows" 인 경우 복사(Ctrl+C) 할 때 단일 셀을 복사할지 여부를 지정합니다.

기본적으로 "singleRow", "multipleRows" 인 경우, 행 단위로 복사가 이루어집니다.

그러나 행 모드인 경우 선택된 단일 셀을 복사하고자 한다면 이 속성을 true 설정하십시오.

기본값(default) : false.
defaultColumnWidth
Type : Number   Version: 2.7.0

칼럼의 가로 사이즈(width) 기본(default)값을 지정합니다.

기본값은 칼럼 레이아웃에서 width 속성을 지정하지 않은 칼럼에게 적용됩니다.

기본값(default) : 80.
dependentColSpan
Type : Boolean   Version: 3.0.5.8

칼럼 헤더의 가로 병합(colSpan)을 설정한 경우 칼럼 감추기/보이기 메소드로 병합된 칼럼을 감추기/보이기 할 때 가로 병합 대상이 된 칼럼도 같이 감추기/보이기 할지 여부를 지정합니다.

이 속성을 true 설정한 경우 칼럼 감추기/보이기 메소드 사용 시 가로병합에 해당되는 칼럼 모두가 감추기/보이기 됩니다.

Also See : hideColumnByDataField | showColumnByDataField

기본값(default) : true.
displayTreeOpen
Type : Boolean   Version: 2.7.0

계층형 그리드(트리 그리드) 에서 최초로 보여지는 그리드의 브랜치 아이템이 모두 열린 상태로 출력될지 닫힌 상태로 출력될지를 결정합니다.

이 값이 true 라면 모두 열린 상태이고, false 라면 최상위 브랜치만 표시됩니다.

참고 : treeLazyMode 를 사용하는 경우 이 속성은 무시됩니다.

Also See : treeLazyMode 기본값(default) : false.

dragKnobColumnWidth
Type : Number   Version: 3.0.10.0

행 드래그&드랍을 도와주는 엑스트라 칼럼의 넓이를 지정합니다.

기본값(default) : 32.
dragRowsText
Type : String   Version: 3.0.4

행 드래깅 시 마우스 커서 옆에 출력되는 텍스트를 지정합니다.

기본값(default) : "$value 행(들)".
dropAcceptableGridIDs
Type : Array   Version: 3.0.4

다른 그리드에 드랍 가능 여부 일 때 받아줄 수 있는 그리드의 pid 를 배열의 요소로 지정합니다.

즉, 그리드와 그리드 간의 드래그&드랍일 때 선택적으로 허용 여부를 결정 지을 수 있습니다.

이 속성을 null 로 설정하면 모든 그리드 간의 드래그&드랍을 허용합니다. 단, 모든 그리드의 속성 enableDrop=true 설정했을 경우입니다.

만약 이 속성을 dropAcceptableGridIDs=["#grid_wrap2"] 로 설정한다면 #grid_wrap2 에 있는 그리드에만 드랍을 허용합니다.

Also See : dropToOthers, enableDrop | 관련 데모 보기

기본값(default) : null.
dropToOthers
Type : Boolean   Version: 3.0.4

행 드래깅 하였을 때 드랍이 가능한 그리드가 자신을 포함하여 다른 곳에도 있는지 여부를 지정합니다.

그리드와 그리드 간의 드래그&드랍을 위해선 반드시 이 속성을 true 설정해야 합니다.

드래깅 하는 그리드와 드랍 받는 그리드는 동일한 문서 객체 모델(DOM)에 존재해야 합니다. 이종간의 문서 객체 모델(DOM) 에서 드래그&드랍은 불가능합니다.

Also See : enableDrag, enableDrop | 관련 데모 보기

기본값(default) : false.
editable
Type : Boolean   Version: 2.7.0

편집 수정 가능 여부를 지정합니다.

기본값(default) : false.
editableOnFixedCell
Type : Boolean   Version: 2.7.0

편집 가능(editable=true) 상태에서 고정 칼럼, 고정 행을 설정했을 때 해당 셀 편집 가능 여부를 지정합니다.

editableOnFixedCell = true 로 설정한다면, 고정 칼럼, 행으로 지정된 셀을 편집 할 수 있습니다.

기본값(default) : false.
editableOnGroupFields
Type : Boolean   Version: 3.0.7

그룹핑을 설정한 경우 그룹핑 필드에 해당하는 셀의 수정 가능 여부를 지정합니다.

이 속성을 true 로 설정한 경우 cellMergeRowSpan 속성을 true 로 설정하기를 권장합니다.

Also See : cellMergeRowSpan | 관련 데모 보기

기본값(default) : false.
editBeginMode
Type : String   Version: 2.7.0

마우스로 편집, 수정 모드로 들어가는 정책을 지정합니다.

더블클릭과 클릭 중 택할 수 있습니다. 유효값: doubleClick, click

키보드로 편집, 수정 모드 들어가는 방법은 F2입니다.

기본값(default) : "doubleClick".
editingOnKeyDown
Type : Boolean   Version: 2.7.0

기본적으로 편집 가능 상태(editable = true)일 때 수정 모드 진입은 F2, 더블클릭(클릭)입니다. 그러나 엑셀과 같이 바로 해당 셀에서 어떤 키(any keys)를 누르든 수정 가능 상태로 만들지 여부를 나타냅니다.

바로 편집 가능 상태로 진입한 경우 엔터/탭 키 완료는 물론 키보드 방향 키로도 편집 완료가 가능합니다.(엑셀 UI)

기본값(default) : true.
enableCellMerge
Type : Boolean   Version: 2.7.0

칼럼 셀 병합(cell merge) 가능 여부를 지정합니다.

셀 병합은 가로 병합, 세로 병합 중 한가지만 가능합니다. 가로 병합과 세로 병합을 같이 사용하여 혼합된 병합으로 출력은 불가능합니다.

기본값(default) : false.
enableClipboard
Type : Boolean   Version: 2.7.0

그리드 데이터 복사하기(Ctrl+C), 붙여넣기(Ctrl+V) 활성화 여부를 지정합니다.

기본값(default) : true.
enableColumnResize
Type : Boolean   Version: 2.7.0

칼럼 리사이징 가능 여부를 지정합니다.

칼럼 리사시징은 헤더와 헤더의 경계선을 마우스 드래그&드랍을 통해 가능합니다.

만약 헤더의 경계선을 더블 클릭한 경우 모든 행들의 셀 값 중 가장 길이(length)가 큰 텍스트로 사이즈가 결정됩니다.

주의 : 더블 클릭으로 자동 결정되는 크기는 UI의 크기가 아닌 실제 셀 값의 길이(length) 입니다. 따라서 renderer 를 통해 단순 텍스트가 아닌 값을 표현 한 경우 오차가 발생할 수 있습니다.

또한 TempleteRenderer 를 사용하는 경우 더블클릭을 통한 리사이징은 무시합니다.

기본값(default) : true.
enableDrag
Type : Boolean   Version: 3.0.4

행 드래깅 가능 여부를 지정합니다.

만약 현재 그리드가 정렬된 상태이거나 필터링된 상태라면 그 상태에서는 행 드래깅이 불가능합니다.

정렬 및 필터링이 해제된 상태여야 합니다.

관련 데모 보기

기본값(default) : false.
enableDragByCellDrag
Type : Boolean   Version: 3.0.4

행 드래깅 손잡이 뿐만 셀을 바로 드래깅해서 행 이동(복사) 가능 여부를 지정합니다.

속성 enableDrag=true 설정이 선행되어야 합니다.

Also See : enableDrag | 관련 데모 보기

기본값(default) : false.
enableDrop
Type : Boolean   Version: 3.0.4

행 드래깅 하였을 때 드랍 가능 여부를 지정합니다.

만약 이 속성을 false 설정하면 어떤 경우라도 드랍을 허용하지 않습니다.

드랍을 받을 수 있는 최상위 속성입니다.

Also See : enableDrag | 관련 데모 보기

기본값(default) : true.
enableFilter
Type : Boolean   Version: 2.7.0

칼럼 필드 필터링 기능 활성화 여부를 지정합니다.

기본값(default) : true.
enableFocus
Type : Boolean   Version: 2.7.0

그리드에 키보드 포커스 설정을 할지 여부를 지정합니다.

만약, enableFocus 를 false 로 지정하면 키포드 포커싱을 받지 못하기 때문에 키보드로 바로 셀 값 수정 및 화살표 키로 이동 등 키보드 이용을 사용할 수 없습니다.

기본값(default) : true.
enableHScrollByWheel
Type : Boolean   Version: 2.10

그리드에 삽입된 데이터 양이 적어 수직 스크롤이 생성되지 않았을 때 마우스 휠(wheel)이 수평 스크롤에 반응할지 여부를 지정합니다.

만약, enableMouseWheel=false 설정하면 enableHScrollByWheel 는 무시됩니다.

기본값(default) : true.
enableLongTap
Type : Boolean   Version: 3.0.2

터치 기기(touch devices)에서 길게 누르기(Long Tap) 이벤트를 활성화 할지 여부를 지정합니다.

기본값(default) : false.
enableMouseWheel
Type : Boolean   Version: 2.7.0

마우스 휠(wheel) 활성화 여부를 지정합니다.

이 속성을 false 로 설정하면, 마우스 휠로 그리드의 스크롤이 반응하지 않습니다.

기본값(default) : true.
enableMovingColumn
Type : Boolean   Version: 2.7.0

칼럼 헤더를 드래그앤드랍으로 자리를 옮기는 기능 활성화 여부를 지정합니다.

만약 enableMovingColumn = true 라면, 사용자가 칼럼 헤더를 드래깅하여 자리를 바꿀 수 있습니다.

기본값(default) : false.
enableMultipleDrag
Type : Boolean   Version: 3.0.4
p>다수의 행을 한번에 드래깅 가능 여부를 지정합니다.

selectionMode 를 "multipleCells" 또는 "multipleRows" 인 경우 유효합니다. 또한 속성 enableDrag=true 설정이 선행되어야 합니다.

만약 계층형 그리드(TreeGrid)인 경우 계층형 그리드는 기본적으로 다수 행 드래깅을 지원하지 않으므로 이 속성은 false 처리 됩니다.

Also See : selectionMode, enableDrag | 관련 데모 보기

기본값(default) : true.
enableMultipleSorting
Type : Boolean   Version: 2.7.0

다중 칼럼 필드 정렬(Sorting) 여부를 지정합니다. (선행 : enableSorting 속성 true 설정)

이 값이 true 라면 multiSortingKey( 기본 : shiftKey )에 따라 다중 칼럼 헤더 클릭 시 멀티 정렬이 실행됩니다.

기본값(default) : true.
enableRestore
Type : Boolean   Version: 2.7.0

편집 가능 그리드(editable=true)에서 수정, 추가, 삭제 행을 원래 상태로 복구 가능하게 할지 여부를 지정합니다.

enableRestore 를 true 로 설정한 경우, 행 상태 칼럼(showStateColumn=true) 의 상태 아이콘을 클릭하면 복구가 됩니다.

즉, 수정을 한 경우 연필 아이콘이 나오는데 이를 클릭하면 수정 전으로 복구되고, 추가된 행인 경우 플러스 아이콘이 나오는데 이를 클릭하면 추가 취소로 복구됩니다.

마찬가지로 삭제 아이콘을 클릭하면 삭제 취소로 복구됩니다.

기본값(default) : true.
enableRightDownFocus
Type : Boolean   Version: 2.7.0

마우스 오른쪽 버턴 클릭 할 때 클릭 한 지점의 셀이 선택되도록 할지 여부를 지정합니다.

즉, 컨텍스트 메뉴를 보기 위해 오른쪽 클릭을 한 경우 클릭 지점이 왼쪽 클릭과 같이 셀 선택을 할지를 나타냅니다.

기본값(default) : false.
enableRowCheckShiftKey
Type : Boolean   Version: 3.0.9.0

엑스트라 체크박스(showRowCheckColumn)에서 쉬프트키(ShiftKey)를 누른 채 클릭해서 다중 체크하게 할지 여부를 지정합니다.

기본값(default) : false.
enableSorting
Type : Boolean   Version: 2.7.0

정렬 가능 여부를 지정합니다.

기본값(default) : true.
enableSummaryMerge
Type : Boolean   Version: 3.0

그룹핑 합계 필드(소계) 셀 가로 병합 실행 여부를 지정합니다.

선행적으로 그리드 속성인 enableCellMerge 을 true 설정 해야 합니다.

기본값(default) : false.
enableUndoRedo
Type : Boolean   Version: 2.7.0

편집 가능 그리드(editable=true)에서 실행 취소(Undo), 다시 실행(Redo) 기능을 사용할지 여부를 지정합니다.

enableUndoRedo 를 true 로 설정하면, Ctrl+Z, Ctrl+Y 단축키가 활성화 됩니다.

기본값(default) : true.
enterKeyColumnBase
Type : Boolean   Version: 2.7.0

엔터키가 다음 행으로 이동하지 않고, 다음 칼럼으로 이동할지 여부를 지정합니다.

기본값(default) : false.
excludeFixedRowsOnSorting
Type : Boolean   Version: 2.7.0

고정 행(fixedRows) 를 지정한 경우, 정렬(sorting)을 할 때 고정 행으로 설정된 행이 정렬에서 제외 될지 여부를 지정합니다.

excludeFixedRowsOnSorting=true 인 경우 고정 행으로 지정된 행은 항상 그대로 유지됩니다.

기본값(default) : true.
exportURL
Type : String   Version: 2.7.0

엑셀(xlsx), CSV, TXT 등으로 내보내기(Export) 할 때 내보내기 된 내용물을 다운로드 형식으로 응답해 줄 서버단 URL 주소를 지정합니다.

해당 서버단 파일은 PHP, JSP 등이 될 수 있습니다. 제공된 샘플의 server_script 폴더에 샘플 JSP, PHP, ASP 가 있습니다.

해당 파일을 WAS 에 업로드 할 해당 주소를 지정해 주십시오.

기본값(default) : null.
fillColumnSizeMode
Type : Boolean   Version: 3.0.2

정의한 칼럼 레이아웃을 가로 스크롤 없이 현재 그리드 영역에 꽉차도록 칼럼들을 비율로 계산하여 출력합니다.

이 속성을 true 로 설정하면 어떤 경우도 가로 스크롤이 생성되지 않습니다. 또한 모든 칼럼들의 넓이(width)는 비율로 계산되어 적용됩니다.

참고 : fillColumnSizeMode 를 true 로 설정하면 fixedColumnCount 속성은 무시됩니다.

Also See : fixedColumnCount | 관련 데모 보기

기본값(default) : false.
fillValueGroupingSummary
Type : Boolean   Version: 3.0.6

그룹핑 소계 행(Summary Rows)의 앞 부분에 값을 채울지 여부를 지정합니다.

이 속성을 true 설정하면 그룹핑 소계 행에서 그룹핑 필드에 해당되는 셀도 세로 병합의 대상이 됩니다.

관련 데모 보기

기본값(default) : false.
filterCancelText
Type : String   Version: 2.7.0

필터 메뉴에 표현 할 "취 소" 텍스트를 대체할 다른 텍스트를 지정합니다.

기본값(default) : "취 소".
filterCheckAllText
Type : String   Version: 2.7.0

필터 메뉴에 표현 할 "전체선택" 텍스트를 대체할 다른 텍스트를 지정합니다.

기본값(default) : "(전체선택)".
filterClearText
Type : String   Version: 2.7.0

필터 메뉴에 표현 할 "필터 초기화" 텍스트를 대체할 다른 텍스트를 지정합니다.

기본값(default) : "필터 초기화".
filterItemMoreMessage
Type : String   Version: 2.7.0

칼럼의 필터링 아이콘 클릭 시 나오는 필터링 메뉴에서 실제 값들이 더 많다는 메세지를 출력할 수 있습니다.

즉, 실제 필터링 가능한 값이 filterMenuItemMaxCount 보다 큰 경우 filterItemMoreMessage 가 하단에 출력됩니다.

기본값(default) : "Too many items...Search words".
filterLayerHeight
Type : Number   Version: 2.7.0

헤더의 필터 아이콘을 클릭했을 때 나오는 필터 기본 메뉴의 높이를 픽셀 단위로 지정합니다.

기본값(default) : 320.
filterLayerWidth
Type : Number   Version: 2.7.0

헤더의 필터 아이콘을 클릭했을 때 나오는 필터 기본 메뉴의 넓이를 픽셀 단위로 지정합니다.

기본값(default) : 260.
filterMenuItemMaxCount
Type : Number   Version: 2.7.0

칼럼의 필터링 아이콘 클릭 시 나오는 필터링 메뉴에서 해당 칼럼의 값들이 많을 경우 모두 체크 박스로 출력되지 않습니다.

filterMenuItemMaxCount 은 필터링 가능한 체크박스의 최대값을 지정합니다.

보이지 않는 값들을 필터링하고자 할 때 자동완성(auto complete) 기능으로 검색하여 체크박스 선택하십시오.

기본값(default) : 50.
filterNoValuePosition
Type : String   Version: 2.7.0

필터 메뉴에 표현 될 "필드 값 없음" 의 위치를 지정합니다.

그리드의 데이터 중 값이 없는 셀이 있는 경우 "필드 값 없음" 으로 필터 메뉴에 출력되는데 이 "필드 값 없음"이 표시 될 위치를 최상단에 위치시키고자 한다면 "top" 로 설정하십시오.

유효값은 "top" 와 "bottom" 입니다.

기본값(default) : "bottom".
filterNoValueText
Type : String   Version: 2.7.0

그리드의 데이터 중 값이 없는 셀이 있는 경우 필터 메뉴에 표현 할 "필드 값 없음" 텍스트를 대체할 다른 텍스트를 지정합니다.

기본값(default) : "(필드 값 없음)".
filterNumberOperatorList
Type : Array   Version: 2.7.0

필터 유형이 numeric 인 경우 필터링 체크박스에 표시할 비교 연산자명을 지정합니다.

기본값(default) : ["같다(=)", "크다(>)", "크거나 같다(>=)", "작다(<)", "작거나 같다(<=)", "같지 않다(!=)"].
filterOkText
Type : String   Version: 2.7.0

필터 메뉴에 표현 할 "확 인" 텍스트를 대체할 다른 텍스트를 지정합니다.

기본값(default) : "확인".
filterSearchCheckAllText
Type : String   Version: 2.7.0

필터 메뉴에 표현 할 "검색 전체선택" 텍스트를 대체할 다른 텍스트를 지정합니다.

기본값(default) : "(검색 전체선택)".
filterSearchPlaceholder
Type : Number   Version: 2.9.4

헤더의 필터 아이콘을 클릭했을 때 나오는 필터 기본 메뉴의 검색 입력 필드(input filed)의 placeholder 텍스트를 지정합니다.

기본값(default) : "검색".
fixedColumnCount
Type : Number   Version: 2.7.0

고정 칼럼의 개수를 지정합니다.

고정 칼럼은 수평 스크롤에 영향을 받지 않고 항상 표시되는 칼럼을 말합니다.(틀 고정)

기본값(default) : 0.
fixedRowCount
Type : Number   Version: 2.7.0

고정 행(row)의 개수를 지정합니다.

고정 행은 수직 스크롤에 영향을 받지 않고 항상 표시되는 행을 말합니다.(틀 고정)

참고 : 페이징 모드(usePaging=true)인 경우 fixedRowCount 속성은 무시됩니다.

기본값(default) : 0.
flat2tree
Type : Boolean   Version: 2.7.0

그리드에 입력되는 데이터가 계층구조의 데이터는 아니지만, id, parent 구조를 갖는 일반 데이터인 경우 트리 그리드로 출력할지 여부를 나타냅니다.

flat2tree 속성은 반드시 treeIdField, treeIdRefField 가 선행적으로 설정되어야 합니다.

기본값(default) : false.
footerHeight
Type : Number   Version: 2.7.0

푸터의 높이를 지정합니다.

기본값(default) : 30.
footerHeights
Type : Array   Version: 3.0.7

푸터의 행 개수를 다수로 설정한 경우 개별 푸터 행 높이를 지정합니다.

예를 들어 3개의 푸터 행이라면(즉, 푸터 행의 개수가 3개) 다음과 같이 배열로 개별 3개를 지정합니다.

var gridPros = {
      footerHeights : [24, 24, 50],
      ....
};

만약 footerHeights 를 지정하지 않은 경우 기본 푸터 높이 속성인 footerHeight 값을 따르게 됩니다.

이 말은 다시 말해 footerHeights 의 배열 인자가 정수가 아닌 경우 headerHeight 이 적용됩니다.

관련 데모 보기

기본값(default) : null.
footerPosition
Type : String   Version: 2.7.0

푸터의 위치를 지정합니다. 기본적으로 푸터는 그리드 하단에 출력합니다.

그러나 푸터를 그리드 상단에 위치시켜 Header Summary 기능으로 활용하고자 한다면 이 값을 "top"으로 지정하십시오.

유효값은 "top", "bottom" 입니다.

기본값(default) : "bottom".
footerRowCount
Type : Number   Version: 3.0.7

푸터를 설정한 경우 푸터 행의 개수를 지정합니다.

관련 데모 보기

기본값(default) : 1.
footerVGap
Type : Number   Version: 2.7.0

푸터와 메인 그리드 사이의 간격, 공백을 지정합니다.

기본값(default) : 4.
forceTreeView
Type : Boolean   Version: 3.0.10.0

그리드에 삽입하는 데이터와 무관하게 계층형 그리드(트리 그리드)로 출력시킬지 여부를 지정합니다.

계층형 그리드(트리 그리드)는 삽입하는 데이터가 계층형인 경우 트리 그리드로 출력을 시키는게 기본입니다.

그러나 forceTreeView = true 설정하면 데이터와 무관하게 계층형(트리 그리드)로 출력 시킵니다.

기본값(default) : false.
groupingFields
Type : Array   Version: 2.7.0

그룹핑을 할 칼럼의 데이터 필드를 지정합니다.

그룹핑은 동일한 값을 갖는 데이터를 묶어서 계층형으로 자료를 출력합니다.

예를 들어 이 값을 ["country", "product"] 로 설정한 경우 country 의 동일한 값을 묶은 후 다시 country 의 그룹 내에서 product 의 동일한 값으로 묶어서 출력하게 됩니다.

그룹핑을 설정한 후 각 그룹별 소계(Summary Rows) 출력이 가능합니다.

Also See : groupingSummary | 관련 데모 보기

참고 : 설정한 그룹핑의 개수만큼 해당 계층이 형성됩니다. 계층이 많아지면 그룹핑 시 많은 시간이 필요합니다. 계층이 많은 경우 퍼포먼스에 악영향을 끼칩니다.

기본값(default) : null.
groupingMessage
Type : String   Version: 2.7.0

그리드 상단에 그룹핑 가능한 패널에 표시되는 메세지를 지정합니다.

기본값(default) : "Drag a column header and drop here to group by that".
groupingPanelHeight
Type : Number   Version: 2.7.0

그리드 상단에 그룹핑 가능한 패널의 높이를 지정합니다.

기본값(default) : 40.
groupingSummary
Type : Object   Version: 3.0.6

그룹핑 시 소계 행(Summary Rows)을 생성하고자 할 때 이 속성을 설정하십시오. 소계 행 출력을 위해서는 groupingFields 설정이 선행되어야 합니다.

groupingSummary 속성은 Object 로 정의 하며 Object 의 키는 다음 요소를 가질 수 있습니다.

  • dataFields (Array) : 소계 연산의 대상이 되는 필드로 칼럼의 dataType 이 "numeric" 인 경우에만 유효합니다.(dataFields 는 소계 출력을 위해 필수 정의해야 합니다.)
  • excepts (Array) : 그룹핑 시 소계에서 제외할 필드들을 정의합니다.

    groupingFields 에서 설정한 필드의 depth 대로 소계 행이 모두 출력되는 것이 기본입니다. 원하지 않는 depth 의 소계를 제외하고자 할 때 여기서 정의합니다.

    관련 데모 보기

  • labelTexts (Array) : 그룹핑 시 해당 항목 아래에 출력되는 소계 텍스트들을 정의합니다.

    depth 별로 소계를 출력 할 때 "Value 합계" 에 대한 텍스트를 대체할 텍스트를 설정합니다.

    관련 데모 보기

  • rows (Array) : 소계 행의 구체적인 설정을 정의합니다.

    기본적으로 소계는 각 그룹 depth 별 합계를 출력하게 됩니다. 합계 외의 연산 및 사용자 정의 연산, 동일한 depth 에서 다수의 소계 행 정의 등의 구체적 설정을 여기서 정의합니다.

    rows 에서 정의한 배열 요소의 개수만큼 동일한 depth 에서 소계 행이 출력되며 개별 소계행을 여기서 제어 합니다.

    rows 는 Array 를 정의하며 Object 를 배열 요소로 갖습니다. 다음은 Object 의 요소에 대한 설명입니다.

    • operation (String) : 소계로 출력할 구체적 연산을 정의합니다. 유효 값은 "SUM", "MIN", "MAX", "AVG", "COUNT" 입니다. 관련 데모 보기
    • text (String or Object) : 소계 행의 그룹핑 항목 아래에 출력될 텍스트를 설정합니다. Object 를 정의한 경우 해당 소계 행에 임의의 텍스트 설정이 가능합니다. 관련 데모 보기
    • constraintField (String) : 조건에 부합하는 값만 소계 연산 적용 시키고자 할 때 조건에 해당되는 필드명를 설정합니다. 관련 데모 보기
    • constraint (String) : constraintField 에서 정의한 필드의 실제 값을 지정합니다. 관련 데모 보기

      constraint 는 확장하여 Function 을 지정하여 원하는 결과를 도출해 낼 수 있습니다. 고급 사용자를 위한 기능이므로 구체적인 내용은 데모를 참고합시오.

    • exceptFunction (Function) : 조건에 부합하는 경우에만 소계 행을 출력할지 여부를 결정하는 함수입니다. 예로 소계의 대상이 되는 건수가 1개인 경우 소계행 출력하지 않도록 지시 할 수 있습니다.

      이 함수에서 false 를 반환하면 소계행을 출력하지 않습니다. 관련 데모 보기

    • expFunction (Function) : 정해진 연산이 아닌 사용자가 원하는 연산이 가능한 수식 함수입니다.

      이 함수에서 반환하는 값을 소계로 출력합니다. 관련 데모 보기

다음은 groupingSummary 설정 예제입니다.

  // 차례로 country, product, name 순으로 그룹핑을 합니다.
  // 즉, 각 나라별, 각 제품을 구매한 사용자로 그룹핑
  groupingFields : ["country", "product", "name"],

  // 그룹핑 후 합계필드를 출력하도록 설정합니다.
  groupingSummary  : {
        // 소계 필드는 price 1개에 대하여 실시 합니다.
        dataFields : [ "price" ],

        // groupingFields 에서 설정한 필드의 depth 대로 썸머리 행이 출력되는 것이 기본입니다.
        // 그러나 원하는 않는 썸머리는 제외 시키십시오.
        // 즉, 썸머리로 출력되는 대상 제외 시키는 필드 설정
        excepts : [ "name"],

        // 그룹핑 썸머리 행의 구체적 설정
        // 2개의 Object 에 각각, 합계, 개수를 표현
       rows: [{
          operation: "SUM", text : "$value 합계"
       }, {
          operation: "COUNT", text : "$value 개수"
       }]
 }

Also See : groupingFields

참고 : 설정한 그룹핑(groupingFields)의 개수만큼 해당 계층이 형성되며 소계(groupingSummary)는 모든 계층에 대한 소계를 구하게 되어합니다. 계층이 많은 경우 퍼포먼스에 악영향을 끼칩니다.

기본값(default) : null.
groupingSummaryPosition
Type : String   Version: 3.0.6

그룹핑 소계 행(Summary Rows)의 출력 위치를 지정합니다.

소계 행의 출력 위치는 기본적으로 하단에 출력됩니다. 상단에 출력하고자 한다면 "top" 을 설정하십시오.

유효값은 "top", "bottom" 입니다.

관련 데모 보기

기본값(default) : "bottom".
headerHeight
Type : Number   Version: 2.7.0

헤더의 높이를 지정합니다.

기본값(default) : 24.
headerHeights
Type : Array   Version: 2.11.0

헤더를 그룹형(계층형)으로 작성한 경우, 계층(depth) 별로 개별 헤더 높이를 지정합니다.

예를 들어 헤더 계층이 3계층이라면(즉, 헤더 행의 개수가 3개) 다음과 같이 배열로 개별 3개를 지정합니다.

var gridPros = {
      headerHeights : [24, 24, 50],
      ....
};

만약 그룹형 헤더일 때 headerHeights 를 지정하지 않은 경우 기본 헤더 높이 속성인 headerHeight 값을 따르게 됩니다.

이 말은 다시 말해 headerHeights 의 배열 인자가 정수가 아닌 경우 headerHeight 이 적용됩니다.

기본값(default) : null.
height
Type : Number   Version: 2.7.0

그리드의 세로 사이즈를 픽셀 단위로 지정합니다. 이 세로 사이즈를 지정하지 않으면 부모 DIV 의 height 만큼 할당됩니다.(즉, 부모 height의 100%)

기본값(default) : NaN.
hScrollPosition
Type : Number   Version: 2.7.0

수평 스크롤의 위치를 나타냅니다.

이 값은 픽셀입니다.

기본값(default) : 0.
ignoreColumnMinWidth
Type : Boolean   Version: 2.7.0

칼럼을 사용자가 드래깅으로 리사이징(resizing) 할 때 칼럼의 minWidth 속성이 설정되었다면 해당 minWidth 를 무시할 지 여부를 지정합니다.

기본적으로 칼럼의 가로 사이즈는 minWidth 값보다 작아지지 않습니다. 그러나 ignoreColumnMinWidth=true 설정을 하면 minWith 는 무시됩니다.

기본값(default) : false.
independentAllCheckBox
Type : Boolean   Version: 2.8.0

엑스트라 체크 박스(showRowCheckColumn=true) 를 설정한 경우 헤더에 위치한 전체 선택/해제 체크박스가 독립적인 행위를 할지 여부를 지정합니다.

독립적인 행위란, 기본적으로 전체 선택/해제를 할 경우 개별 행들의 체크 박스가 선택/해제가 이루어집니다.

그러나 independentAllCheckBox=true 설정 시 전체 선택/해제 이벤트만 발생 할 뿐 개별 행들의 체크 박스를 선택/해제 하지 않습니다.

전체 선택/해제를 원하는 방식으로 사용자 정의하고자 한다면 independentAllCheckBox 를 true 설정하여 rowAllCheckClick 이벤트를 바인딩하여 제어하십시오.

기본값(default) : false.
isColumnOriented
Type : Boolean   Version: 2.7.0

isColumnOriented = true 설정이라면 Home, End 키가 칼럼의 시작과 끝으로 각각 이동 합니다.

키보드의 Home, End 키가 칼럼이 아닌 행의 시작과 끝으로 이동하고자 한다면 이 속성을 false 설정하십시오.

기본값(default) : true.
isFitColumnSizeHeaderText
Type : Boolean   Version: 2.7.0

칼럼과 칼럼 사이의 구분자를 더블 클릭 할 때 해당 칼럼의 셀 내용에 맞게 사이즈가 최적화 됩니다.

이 때 헤더 텍스트도 고려할지 여부를 지정합니다.

만약, 이 속성을 false 처리하면 헤더 텍스트는 무시하고 실제 셀 텍스트에 맞게 칼럼의 사이즈가 조정됩니다.

기본값(default) : true.
isGenNewRowsOnPaste
Type : Boolean   Version: 2.7.0

다수의 행을 클립 보드 붙여넣기(Ctrl+V) 할 때 그리드의 마지막 하단 행보다 클립보드 양이 많은 경우, 새 행을 만들고 붙여넣기 할지 여부를 지정합니다.

기본값은 클립보드의 양이 많은 경우 자동으로 그리드에 새 행을 추가하고 모든 클립보드 데이터를 붙여 넣습니다.

그러나 isGenNewRowsOnPaste=false 처리 시 그리드 출력 행보다 많은 클립보드 데이터는 무시하게 됩니다. 즉, 새 행을 만들지 않습니다.

기본값(default) : true.
keepColumnOrderOnGrouping
Type : Boolean   Version: 3.0.6

그룹핑을 할 때 그룹핑 필드들이 첫 칼럼로 옮겨지며 기본적으로 출력됩니다.

이때 칼럼 레이아웃에서 정의한 칼럼 순서 그대로를 유지할지 여부를 지정합니다.

이 속성을 true 설정하면 그룹핑 할 때 칼럼 순서의 변화 없이 기존 칼럼 순서 그대로 유지하며 그룹핑이 됩니다.

참고 : 이 속성을 false 처리하면 fillValueGroupingSummary, adjustSummaryPosition, enableSummaryMerge 속성들은 비활성화(false 설정) 됩니다.

관련 데모 보기

기본값(default) : false.
keepEditing
Type : Boolean   Version: 2.7.0

편집 가능 상태(editable = true)일 때 F2 또는 클릭(더블클릭)으로 수정 모드로 들어간 경우, 탭키나 엔터키로 수정을 완료 한다면 다음 셀을 수정 가능 상태로 만들지 여부를 나타냅니다.

만약 keepEditing = true 로 설정한 경우, 다음 셀이 바로 수정 가능한 상태로 입력 창이 열리게 됩니다.

기본값(default) : false.
keepOrderingOnGrouping
Type : Boolean   Version: 2.7.0

그룹핑을 할 때 원래 데이터의 순서대로 출력시킬지 여부를 지정합니다.

기본적으로 그룹핑을 하면 String은 순서대로 출력을 시킵니다. 그러나 String 이나 Number 체제로 변환해도 무방한 값에는 순서대로 출력을 시키지 않습니다.

예를 들어 연도로 그룹핑을 한다고 할 때, 연도 데이터 값이 "2013", "2014", "2015" 라면 그룹핑 시 순서대로 나오지 않습니다.

Number 체제의 작은 값이 위에 나옵니다. 이런 경우 원래 데이터의 순서대로 나오게 하는 속성이 keepOrderingOnGrouping=true 입니다.

주의 : 이 속성은 일반적으로 불필요 합니다. 데이터의 값이 Number 인 경우(또는 Number 로 캐스팅해도 같은 경우) true 설정하십시오.

데이터의 개수가 많은 경우 그리드 그룹핑 성능에 영향을 미치므로 무조건적인 true는 피하십시오.

기본값(default) : false.
lastRowScrollOnClick
Type : Boolean   Version: 2.12.4

수직 스크롤이 있는 그리드에서 현재 화면의 최하단 행(반절 가려진 행)을 마우스로 클릭 시 온전하게 해당 행이 보이도록 스크롤을 자동으로 내릴지 여부를 지정합니다.

기본값(default) : true.
longTapDelay
Type : Number   Version: 3.0.2

터치 기기(touch devices)에서 길게 누르기(Long Tap)를 할 때 이 속성 값의 시간(ms단위)만큼 누르고 있을 경우 발생합니다.

선행 조건으로 enableLongTap 를 true 로 설정해야 하며 단위는 ms입니다.(최소값:500)

기본값(default) : 700.
minColumnWidth
Type : Number   Version: 2.7.0

칼럼의 최소 사이즈를 지정합니다.

여기서 지정한 칼럼 사이즈보다 칼럼은 작아지지 않습니다.

기본값(default) : 12.
multiSortingKey
Type : String   Version: 2.7.0

다중 칼럼 정렬을 실행 할 때 클릭과 더블어 함께 할 키(key)를 지정합니다.

예를 들어 이 값을 "shiftKey" 로 설정한 경우 쉬프트키와 함께 칼럼 헤더 클릭 시 다중 정렬이 실행됩니다.

유효값은 "shiftKey", "ctrlKey", "always" 입니다.

"always" 값은 단순 클릭만으로 항상 다중 정렬이 실행됩니다.

관련 데모 보기

기본값(default) : "shiftKey".
noDataMessage
Type : String   Version: 2.7.0

showAutoNoDataMessage 가 true 인 경우 출력시킬 메세지를 지정합니다.

기본값(default) : "No Data to display".
notBeginEventNewRowsOnPaste
Type : Boolean   Version: 3.0.6

다수의 행을 클립 보드 붙여넣기(Ctrl+V) 할 때 그리드의 마지막 하단 행보다 클립보드 양이 많은 경우, 새 행을 만들고 붙여넣기가 실행됩니다.

이때 만들어진 새 행의 모든 셀 값에 대하여 cellEditBegin 이벤트를 송출 시킬지 여부를 지정합니다.

true 를 설정한다면 cellEditBegin 이벤트를 송출하지 않습니다.

false 를 설정한다면 cellEditBegin 이벤트가 송출됩니다.

Also See : uneditableNewRowsOnPaste

기본값(default) : false.
nullsLastOnSorting
Type : Boolean   Version: 3.0.5.8

정렬(sorting) 할 때 빈값(undefined, null, "")에 해당되는 값은 오름차순, 내림차순과 관계 없이 항상 아래에 위치시킬지 여부를 지정합니다.

만약 nullsLastOnSorting=fasle 설정한다면 빈값에 해당되는 값은 오름차순 시 상단에, 내림차순 시 하단에 위치합니다.

관련 데모 보기

기본값(default) : true.
onlyEnterKeyEditEnd
Type : Boolean   Version: 2.7.0

이 속성을 true 설정하면 셀을 수정하고 완료를 하기 위해 엔터(Enter) 키를 입력할 때 수정 완료 행위만 하고 다음 행으로 선택자를 내리지 않습니다.

기본값(default) : false.
onlyTreeLastDepthSorting
Type : Boolean   Version: 2.7.0

트리 그리드(계층형 데이터 그리드)에서 정렬을 할 때 최하단의 Depth 에 해당되는 행(rows)만 정렬을 실행할지 여부를 지정합니다.

기본값(default) : false.
pageRowCount
Type : Number   Version: 2.7.0

페이징을 사용하는 경우 한 페이지에 출력되는 행의 수를 지정합니다.

지정할 수 있는 최대값은 500입니다.

이 값을 높이 설정하면 개수만큼 모든 행의 DOM 을 작성하기 때문에 퍼포먼스에 악영향을 미칩니다.

기본값(default) : 20.
pageRowSelectValues
Type : Array   Version: 3.0.5

페이징의 행의 개수를 변경할 수 있는 select 의 option들을 지정합니다.

반드시 정수형의 배열을 설정해야 합니다.

Also See : showPageRowSelect | 관련 데모 보기

기본값(default) : [10, 20, 30, 40, 50].
pagingBottomGap
Type : Number   Version: 3.0.10.0

페이징 모드(usePaging=true)인 경우 세로 스크롤 최하단의 여백을 추가로 지정합니다.

예로 속성의 값을 10으로 설정하면 10 픽셀만큼 추가로 세로 스크롤을 통해 더 내릴 수 있습니다.

기본값(default) : 1.
pagingInfoLabelFunction
Type : Function   Version: 2.7.0

페이징을 사용하는 경우 페이징 오른쪽에 출력되는 현재페이지와 전체페이지 출력 텍스트를 사용자 정의할 수 있는 라벨펑션을 지정합니다.

라벨펑션은 함수를 지정해야 하며 함수 형태는 다음과 같습니다.

  • currentPage : 현재 페이지
  • totalPageCount : 총 페이지수
  • currentTopNumber : 현재 페이지에서 최상단의 행 번호
  • currentBottomNumber : 현재 페이지에서 최하단의 행 번호
  • dataLen : 총 데이터 수
 
pagingInfoLabelFunction : function(currentPage, totalPageCount, currentTopNumber, currentBottomNumber, dataLen) {
   // 로직 처리
   return "현재 : " + currentPage + " / 전체 : " + totalPageCount + "( " + currentTopNumber + "~" + currentBottomNumber + " )";
} 

함수의 반환값이 곧 출력값이 됩니다.

기본값(default) : null.
pagingMode
Type : String   Version: 2.7.0

페이징을 사용하는 경우 페이징의 방식을 지정합니다. 유효값은 "default", "simple" 입니다.

"simple" 로 설정한 경우 이전, 다음 버턴과 현재페이지/전체페이지 만 출력됩니다.

기본값(default) : "default".
pagingPanelHeight
Type : Number   Version: 2.7.0

페이징을 사용하는 경우 페이징이 출력되는 하단의 페이징 영역이 높이를 지정합니다.

기본값(default) : 34.
preventDelKeyMap
Type : Object   Version: 3.0.7.6

수정 가능한 그리드에서 Del 키, Ctrl + X 키로 값을 삭제 불가능한 렌더러(renderer), 에디트렌더러(editRenderer) 의 유형(type) 을 정의합니다.

여기서 정의한 renderer, editRenderer는 Del 키, Ctrl + X 키로 값을 삭제 할 수 없습니다.

다음은 기본값으로 정의된 모습니다.

 preventDelKeyMap = {
     DropDownListRenderer : true,
     LinkRenderer : true,
     CalendarRenderer : true,
     JQCalendarRenderer : true,
     BTCalendarRenderer : true,
     CheckBoxEditRenderer : true
 };

즉, editRenerer(또는 renderer) 의 type 이 "DropDownListRenderer", "LinkRenderer", "CalendarRenderer", "JQCalendarRenderer", "BTCalendarRenderer", "CheckBoxEditRenderer" 는 Del 키, Ctrl + X 키로 삭제 할 수 없습니다.

기본값(default) : Object.
processValidData
Type : Boolean   Version: 2.7.0

그리드 데이터를 유효한 데이터로 재작성 할지 여부를 나타냅니다.

예를 들어 dataType 이 "numeric" 으로 선언된 칼럼에 대입되는 데이터들은 숫자여야 합니다. 그러나 JSON, XML 작성 시 완전한 숫자 형식으로 데이터를 작성하기 힘들 때가 있습니다.

JSON 으로 데이터를 작성한 형태가 다음 2가지가 존재한다고 가정해 보면:

1. [{ "id" : "id1", "price" : "1000"}, { "id" : "id2", "price" : "2000"} ..... ]

2. [{ "id" : "id1", "price" : 1000}, { "id" : "id2", "price" : 2000} ..... ]

1번은 price 의 값이 숫자이지만 따옴표로 묶여 문자처리가 되어 있습니다. 이를 그대로 데이터에 삽입하면 문자로 인식됩니다.

따라서 정렬이나 비교 연산 시 문자 비교를 하게 됩니다. 이를 방지하고자 온전한 숫자로 캐스팅할 필요가 있습니다.

만약 1번처럼 데이터를 작성했다면 processValidData 를 true 로 설정하십시오. 그러면 그리드가 자체 캐스팅을 합니다.

데이터 수가 10만, 20만 등 대용량일 경우 processValidData 를 true 로 설정했다면 퍼포먼스가 낮아질 수 있으니 JSON 데이터 작성 시 2번 형태로 작성하십시오.(1번 형태는 anti-pattern임)

XML 데이터를 사용할 경우는 반드시 processValidData 를 true 로 설정해야 비교 연산 시 숫자 연산을 하게 됩니다.

만약 정렬 기능과 같이 비교 연산을 사용하지 않는 경우 processValidData 를 false 로 설정하는게 유리합니다.

기본값(default) : false.
remoterPlaceholder
Type : String   Version: 2.7.0

리모트 리스트 렌더러를 사용할 때 사용자가 입력 전 출력시킬 placeholder 텍스트를 지정합니다.

placeholder 는 브라우저에 의존적입니다. 따라서 무시될 수 있습니다.(브라우저 영향)

기본값(default) : "검색어를 입력하세요.".
resetHScroll
Type : Boolean   Version: 2.7.0

데이터 변경 시 수평 스크롤의 위치를 초기화 할지 여부를 나타냅니다. 이 속성을 false 로 설정하면 데이터 변경 시 수평 스크롤의 위치가 변하지 않습니다.

기본값(default) : true.
resetVScroll
Type : Boolean   Version: 2.7.0

데이터 변경 시 수직 스크롤의 위치를 초기화 할지 여부를 나타냅니다. 이 속성을 false 로 설정하면 데이터 변경 시 수직 스크롤의 위치가 변하지 않습니다.

기본값(default) : true.
reverseRowNum
Type : Boolean   Version: 2.7.0

행번호 칼럼에서 행 번호를 반대로 출력할지 여부를 나타냅니다.

reverseRowNum 을 true 로 설정하면 행번호 칼럼의 넘버링이 큰수에서 작은수로 출력됩니다.

기본값(default) : false.
rowCheckableFunction
Type : Function   Version: 2.7.0

엑스트라 행 체크박스에 있는 행 체크박스를 사용자가 변경하고자 할 때 변경을 허락할지 여부를 지정할 수 있는 함수 입니다.

rowCheckableFunction는 함수를 지정해야 하며 함수 형태는 다음과 같습니다.

  • rowIndex : 행 인덱스
  • isChecked : 현재 체크 유무 (사용자 반응 이전 체크값 여부임)
  • item : 해당 행에 출력되고 있는 행 아이템 객체 (Object)

Return : (Boolean) true 를 반환하면 사용자가 자유롭게 체크 변경이 가능하며, false 반환 시 불가 상태(초기 유지)로 만듭니다.

 rowCheckableFunction : function(rowIndex, isChecked, item) {
   if(item.name == "Anna") { // 이름이 "Anna" 인 경우 행 체크 유지 설정(즉, 사용자가 체크 변경 불가)
        return false;
   }
   return true;
}

관련 데모 보기

기본값(default) : null.
rowCheckableWithDisabled
Type : Boolean   Version: 2.8.0

엑스트라 체크박스 체커블 함수(rowCheckableFunction)을 정의한 경우, checkable 이 아닌 체크박스를 disabled 처리도 함께 시킬지 여부를 지정합니다.

rowCheckableFunction 으로 정의된 함수를 그리드가 렌더링 시 빈번히 호출됩니다.

따라서 rowCheckableFunction 으로 정의된 함수의 로직이 복잡하다면, 이 속성 rowCheckableWithDisabled = false 처리 후 rowCheckDisabledFunction 을 따로 정의하십시오.

기본값(default) : false.
rowCheckColumnWidth
Type : Number   Version: 2.7.0

엑스트라 행 체크박스 칼럼의 가로 사이즈(width)를 지정합니다.

showRowCheckColumn=true 설정인 경우만 유효합니다.

기본값(default) : 25.
rowCheckDependingTree
Type : Boolean   Version: 2.7.0

트리 그리드에서 엑스트라 행 체크 박스를 사용하는 경우, 부모를 체크 할 때 그 자손들도 체크하게 할지 여부를 지정합니다.

즉, 부모를 체크하면 하위 자손들도 체크되고, 체크 해제 하면 그 하위 자손들도 체크 해제 됩니다.

이 속성은 트리 그리드에서만 유효합니다.

기본값(default) : false.
rowCheckDisabledFunction
Type : Function   Version: 2.7.0

엑스트라 행 체크박스에 있는 행 체크박스를 비활성화(disabled) 처리하고자 할 때 비활성화 여부를 지정할 수 있는 함수 입니다.

rowCheckDisabledFunction는 함수를 지정해야 하며 함수 형태는 다음과 같습니다.

  • rowIndex : 행 인덱스
  • isChecked : 현재 체크 유무
  • item : 해당 행에 출력되고 있는 행 아이템 객체 (Object)

Return : (Boolean) false 를 반환하면 비활성화(disabled) 상태로 만듭니다.

 rowCheckDisabledFunction : function(rowIndex, isChecked, item) {
   if(item.name == "Anna") { // 이름이 "Anna" 인 경우 엑스트라 행 체크박스 비활성화 처리함.
        return false;
   }
   return true; // 일반 활성화 된 체크박스로 표현
}

주의 : 이 속성의 값으로 지정된 함수는 렌더링 시 빈번히 호출됩니다. 따라서 이곳에서 DOM 검색이나, 복잡한 로직은 삼가하십시오. 성능에 영향을 미칩니다.

관련 데모 보기

기본값(default) : null.
rowCheckToRadio
Type : Boolean   Version: 2.7.0

엑스트라 행 체크박스 대신 라디오버턴 그룹으로 변환시켜 출력할지 여부를 지정합니다.

showRowCheckColumn=true 설정인 경우만 유효합니다.

기본값(default) : false.
rowCheckVisibleFunction
Type : Function   Version: 3.0.5.8

엑스트라 행 체크박스에 있는 행 체크박스를 숨기기(hidden) 처리하고자 할 때 보이기/숨기기 여부를 지정할 수 있는 함수 입니다.

rowCheckVisibleFunction 을 사용하기 위해서는 선행적으로 속성 independentAllCheckBox = true 를 설정해야 합니다.

rowCheckVisibleFunction는 함수를 지정해야 하며 함수 형태는 다음과 같습니다.

  • rowIndex : 행 인덱스
  • isChecked : 현재 체크 유무 (사용자 반응 이전 체크값 여부임)
  • item : 해당 행에 출력되고 있는 행 아이템 객체 (Object)

Return : (Boolean) true 를 반환하면 사용자가 자유롭게 체크 변경이 가능하며, false 반환 시 불가 상태(초기 유지)로 만듭니다.

 rowCheckVisibleFunction : function(rowIndex, isChecked, item) {
   if(item.name == "Anna") { // 이름이 "Anna" 인 경우 엑스트라 행 체크박스 숨기기 처리
        return false; // false 를 반환하면 체크박스가 숨기기 상태(hidden) 됩니다.
   }
   return true; 
}

주의 : 이 속성의 값으로 지정된 함수는 렌더링 시 빈번히 호출됩니다. 따라서 이곳에서 DOM 검색이나, 복잡한 로직은 삼가하십시오. 성능에 영향을 미칩니다.

관련 데모 보기

기본값(default) : null.
rowHeight
Type : Number   Version: 3.0

행의 높이를 지정합니다. 행의 높이는 20보다 작아질 수 없습니다. (즉, 행 높이 최소값은 20)

기본값(default) : 26.
rowIdField
Type : String   Version: 2.7.0

개별 행 아이템의 고유 값을 갖는 Key 필드에 해당되는 필드를 지정합니다.

DB 의 Record 에 비유하면 Primary Key 입니다.

그리드의 개별 행 아이템에 접근하고 제어하기 위해서는 반드시 지정할 필요가 있습니다.

이 필드에 속하는 데이터 value 는 고유값이여야 합니다. 즉, 중복된 값이 없어야 합니다.

이 필드를 지정하면 그리드가 빨리 생성됩니다. 10만 로우 이상에선 반드시 설정하십시오.

편집 모드(editable=true)에서 rowIdField 로 지정된 필드는 수정이 불가능해집니다.

기본값(default) : "_$uid".
rowIdTrustMode
Type : Boolean   Version: 3.0.5.1

rowIdField 에 대한 신뢰 모드로 사용할지 여부를 지정합니다.

새 행 추가 시 rowIdField 에 대한 값을 그리드가 결정합니다. rowIdField 에 대한 값은 중복 되지 않는 고유의 값이여야 하기 때문입니다.

rowIdTrustMode 를 true 로 설정하면 rowIdField 설정 값이 중복되지 않는 값으로 신뢰하여 그리드가 해당 값을 만들지 않습니다.

예로 rowIdField 를 id 로 설정한 경우 행 추가되는 Object 의 id 필드는 기존 데이터의 id 필드와 중복되지 않는 온전한 값으로 존재한다고 믿습니다.

참고 : rowIdField 를 설정하지 않은 경우 이 속성은 무시됩니다.

Also See : rowIdField

기본값(default) : false.
rowNumColumnWidth
Type : Number   Version: 2.7.0

행 줄번호(로우 넘버링) 칼럼의 가로 사이즈(width)를 지정합니다.

showRowNumColumn=true 설정인 경우만 유효합니다.

기본값(default) : 40.
rowNumHeaderText
Type : String   Version: 2.7.0

행번호 칼럼 설정한 경우(showRowNumColumn=true) 행번호 칼럼의 헤더에 출력할 텍스트를 지정합니다.

기본값(default) : "No.".
rowPosition
Type : Number   Version: 2.7.0

현재 행(row) 의 위치를 나타냅니다.

rowPosition 이 곧 현재 화면에 보이는 그리드의 최상단 행의 인덱스와 같습니다.

기본값(default) : 0.
rowSelectionWithMerge
Type : Boolean   Version: 2.8.0

selctionMode 을 행 선택자("singleRow" 또는 "multpleRows") 로 설정하고, enableCellMerge 를 true 로 설정했을 때 행 선택자가 병합된 셀까지 선택되도록 할지를 지정합니다.

예를 들어 1~5행의 첫번째 칼럼이 병합된 경우, rowSelectionWithMerge=true 설정을 하면 1~5번의 어떤 행을 선택하든 병합된 첫번째 칼럼은 선택되어집니다.

기본값(default) : true.
rowStyleFunction
Type : Function   Version: 2.7.0

행(row) 단위로 동적 스타일을 적용할 수 있는 스타일 함수를 지정합니다.

rowStyleFunction는 함수를 지정해야 하며 함수 형태는 다음과 같습니다.

  • rowIndex : 행 인덱스
  • item : 해당 인덱스의 행 아이템
 rowStyleFunction : function(rowIndex, item) {
   var myCss = "my-Css";
   // 로직 처리
   return myCss;
}

함수의 반환값은 CSS 에서 이미 선언되어 있는 CSS 클래스여야 합니다.

다중의 CSS 클래스는 지원하지 않습니다. 예를 들어 "right-style bold-style font12-style" 과 같은 구조는 지원하지 않습니다.

엑셀 내보내기 시에는 해당 스타일의 글자색, 배경색, 볼드체, 이탤릭체만 적용됩니다.

관련 데모 보기

기본값(default) : null.
scaleFactor
Type : Number   Version: 3.0.7.7

그리드 상위 태그의 CSS transform 에 scale을 한 경우 그리드에 동일한 scale 값을 지정하여 일관된 좌표 공간이 되도록 설정합니다.

이는 그리드 상위 태그의 CSS transform 에 scale 과 matrix를 설정한 경우만 유효합니다.

예로 80%의 scale 을 설정했다면 상위 태그의 CSS transform 은 다음과 같고 그리드 속성 scaleFactor 는 동일한 값인 0.8 을 설정해야 합니다.

    1. transform: scale(0.8);
    2. transform: matrix(0.8, 0, 0, 0.8, 0, 0);

기본값(default) : 1.

scrollHeight
Type : Number   Version: 2.7.0

스크롤의 높이(수직 스크롤인 경우 넓이)를 지정합니다.

기본값(default) : 14.
scrollHeight4Mobile
Type : Number   Version: 2.7.0

autoScrollSize=true 설정한 경우, 터치가 지원되는 모바일 화면(아이에서의 스크롤 높이(수직 스크롤인 경우 넓이)를 지정합니다.

기본값(default) : 4.
scrollThumbHeight
Type : Number   Version: 2.7.0

스크롤 썸(thumb)의 높이(수직 스크롤인 경우 넓이)를 지정합니다.

기본값(default) : 12.
searchByFormatValue
Type : Boolean   Version: 3.0.9.0

그리드 검색 기능을 실행 할 때 포매팅된 값을 대상으로 검색을 실행할지 여부를 지정합니다.

기본은 그리드의 포매팅된 값이 아닌 원본 데이터 값을 검색합니다.

예로 그리드에 드랍다운리스트의 key-value 모드로 001 을 "영업본부" 로 출력하고 있는 경우 검색을 할 때 검색의 대상이 되는 값은 원본 데이터는 001 입니다.

그러나 searchByFormatValue 을 설정한다면 사용자가 "영업본부" 로 검색하면 001에 대한 셀을 찾아 갑니다.

기본값(default) : false.
selectionMode
Type : String   Version: 2.7.0

셀 선택모드를 지정합니다. 유효 속성값은 다음과 같습니다.

singleCell, singleRow, multipleCells, multipleRows, none

기본값(default) : "singleCell".
separatedSelectionOnMerge
Type : Boolean   Version: 3.0.9.0

세로 병합된 셀을 선택했을 때 병합된 셀의 첫번째 셀 선택이 아닌 직접적으로 선택된 셀을 구분해서 선택할지 여부를 지정합니다.

예로 3개의 셀이 세로 병합된 경우 가운데 셀을 클릭하면 병합되었기 때문에 첫번째 셀이 선택됩니다. 이 속성을 false 처리하면 가운데 셀만 선택시킵니다.

기본값(default) : false.
separatedSelectionOnMerge
Type : Boolean   Version: 3.0.6

다수의 셀이 하나로 병합된 상태에서 해당 셀을 클릭할 때 병합과 관계없이 고유의 셀 자체로 구별되어 선택되어질지 여부를 지정합니다.

기본값(default) : false.
showAutoNoDataMessage
Type : Boolean   Version: 2.7.0

그리드가 표현할 데이터가 존재 하지 않을 때 자동으로 메세지를 출력할지 여부를 지정합니다.

출력 메세지는 noDataMessage 속성의 값이 출력되니 메세지를 변경하고자 할 때는 noDataMessage 를 변경하십시오.

기본값(default) : true.
showBranchOnGrouping
Type : Boolean   Version: 2.7.0

그룹핑 시 브랜치에 해당되는 행 출력 여부를 지정합니다. 이 속성은 그룹핑과 셀병합를 함께 적용할 때만 유효합니다.

그룹핑을 지정하면 계층 구조로 데이터가 변하게 됩니다.(TreeGrid 형태) 이 때 그룹핑의 브랜치에 해당되는 행이 동적으로 생성되면서 마치 빈행이 보이는 것처럼 느껴질 때가 있습니다.

이 속성을 false 로 지정하면 그룹핑 시 브랜치 행이 표시되지 않습니다.(enableCellMerge = true 인 경우만 유효)

기본값(default) : true.
showDragKnobColumn
Type : Boolean   Version: 3.0.10.0

행 드래그&드랍을 도와주는 엑스트라 칼럼을 최좌측에 생성합니다.

생성된 엑스트라 칼럼의 셀을 드래깅하여 행을 이동 시킬 수 있습니다.

기본값(default) : false.
showEditedCellMarker
Type : Boolean   Version: 2.7.0

수정 가능한 상태(editable = true) 인 경우 셀을 수정하면 해당 셀에 수정된 표시(마크)를 출력할 지 여부를 나타냅니다.

기본값(default) : true.
showFooter
Type : Boolean   Version: 2.7.0

푸터 출력 여부를 지정합니다.

기본값(default) : false.
showFullFixedRule
Type : Boolean   Version: 2.8.0

고정 칼럼 세로 선이 그리드 행 개수와 상관없이 그리드 높이에 맞게 출력 시킬 지 여부를 지정합니다.

만약 showFullFixedRule 속성을 true 로 지정하면, 고정 칼럼 세로 선은 항상 그리드 최하단까지 출력됩니다.

기본값(default) : false.
showHeader
Type : Boolean   Version: 2.7.0

헤더 출력 여부를 지정합니다.

기본값(default) : true.
showPageButtonCount
Type : Number   Version: 2.7.0

페이징을 사용하는 경우 출력되는 페이지의 버턴 개수를 지정합니다.

지정할 수 있는 최대값은 20입니다.

기본값(default) : 10.
showPageRowSelect
Type : Boolean   Version: 3.0.5

페이징을 사용할 때 1 페이지에 출력할 행의 개수를 변경할 수 있는 select UI 를 하단에 출력할지 여부를 지정합니다.

Also See : pageRowSelectValues | 관련 데모 보기

기본값(default) : false.
showRowAllCheckBox
Type : Boolean   Version: 2.7.0

엑스트라 행 체크박스(showRowCheckColumn=true)를 설정한 경우, 헤더 부분에 전체 선택 체크박스를 표시할지 여부를 지정합니다.

기본값(default) : true.
showRowCheckColumn
Type : Boolean   Version: 2.7.0

엑스트라 행 체크박스 출력 여부를 지정합니다.

이 속성 값이 true 이면 최좌측에 체크박스 칼럼이 생성됩니다.

기본값(default) : false.
showRowNumColumn
Type : Boolean   Version: 2.7.0

행 줄번호(로우 넘버링) 칼럼의 출력 여부를 지정합니다.

이 속성 값이 true 이면 최좌측에 행번호 칼럼이 생성됩니다.

기본값(default) : true.
showSelectionBorder
Type : Boolean   Version: 2.7.0

셀 선택 시 선택된 셀에 테두리(border) 를 표시할지 여부를 나타냅니다.

기본값(default) : true.
showStateColumn
Type : Boolean   Version: 2.7.0

그리드 좌측에 행의 상태를 나타내는 칼럼 출력 여부를 결정합니다.

editable 을 true 로 설정한 경우 삭제, 수정, 추가 행에 대한 정보가 이 칼럼에 아이콘을 출력됩니다.

만약 editable 을 false 로 설정한 경우 showStateColumn = true 를 설정하면 선택행에 대한 정보가 아이콘으로 출력됩니다.

기본값(default) : false.
showTooltip
Type : Boolean   Version: 2.7.0

그리드 툴팁 표시 여부를 지정합니다.

기본값(default) : false.
simplifySelectionEvent
Type : Boolean   Version: 3.0.4

selectionChange 이벤트 발생 시 간소화된 정보만 받을지 여부를 지정합니다.

간소화한 경우 selectionChange 이벤트의 파라메터 요소인 event.selectedItems 를 포함시키지 않습니다.

selectionChange 이벤트가 발생될 때 선택한 셀이 수천~수만을 넘어 가면 퍼포먼스에 악영향을 미칩니다.

선택한 셀을 모두 보고자 하는 경우가 아니라면 true 설정을 권장합니다.

Also See : selectionChange

기본값(default) : false.
skipReadonlyColumns
Type : Boolean   Version: 2.7.0

개별 칼럼에 editable=false 를 설정한 경우 키보드 방향키(또는 Tab, Home, End)가 해당 칼럼(읽기 전용 칼럼)을 건너 뛰어 셀렉션을 표현할지 여부를 지정합니다.

주의 : cellEditBegin 이벤트로 동적 편집 불가 설정은 한 셀에 대해서는 적용되지 않습니다.

기본값(default) : false.
softRemovePolicy
Type : String   Version: 3.0

softRemoveRowMode=true 설정한 경우 삭제된 행 아이템은 삭제 표시가 남습니다.

그러나 서버에서 가져온 원래 데이터(그리드에 최초에 삽입한 데이터)가 아닌 사용자가 추가한 행을 삭제할 때, 사용자가 추가한 행은 softRemoveRowMode 를 적용하지 않을 수 있습니다.

즉, 사용자가 추가한 행은 삭제 표시가 아닌 바로 제거하도록 할려면 softRemovePolicy="exceptNew" 를 설정하십시오.

softRemovePolicy 의 유효값은 "all", "exceptNew" 입니다.

기본값(default) : "exceptNew".
softRemoveRowMode
Type : Boolean   Version: 2.7.0

수정 가능한 상태(editable = true) 인 경우 행을 삭제하면 그리드에서 바로 제거하지 않고, 삭제된 표시를 하고 남겨 둘 지 여부를 나타냅니다.

삭제된 표시는 기본적으로 가운데 줄이 그어지는 형태입니다.

softRemoveRowMode=true 인 경우, 삭제된 행은 복구(삭제 취소) 할 수 있습니다.(restoreSoftRows 메소드 참고)

속성 dropToOthers 을 true 로 설정한 경우 softRemoveRowMode 는 강제적으로 false 입니다.

Also See : dropToOthers

기본값(default) : true.
sortableByFormatValue
Type : Boolean   Version: 3.0.7.1

정렬을 할 때 데이터 기반이 아닌 그리드에 출력된 값을 기반으로 정렬을 실행할지 여부를 지정합니다. (선행 : enableSorting 속성 true 설정)

예로 드랍다운리스트의 key-value 모드를 사용하는 경우 실제 데이터는 key 값이, 보여지는 값은 value 입니다.

여기서 정렬을 할 때 기본은 데이터 기반으로 정렬이 됩니다. 그러나 이 속성을 true 설정하면 보여지는 값인 value 기반으로 정렬을 실행합니다.

데이터 기반의 정렬보다 퍼포먼스에 영향을 미치므로 무조건적인 true 설정은 피하십시오.

기본값(default) : false.
stateColumnWidth
Type : Number   Version: 2.7.0

행 상태 칼럼(showStateColumn = true)을 설정한 경우 해당 칼럼의 가로 사이즈를 지정합니다.

기본값(default) : 16.
summaryMergePolicy
Type : String   Version: 3.0

enableSummaryMerge 를 true 로 설정한 경우, 셀 병합 정책을 결정합니다.

유효값은 다음과 같습니다.

  • "default" : 그룹핑 필드 자신의 이전에서만 가로 병합 실행
  • "all" : 그룹핑 필드 지정 개수 만큼 병합 실행
  • 기본값(default) : "default".
summaryText
Type : String   Version: 2.7.0

groupingSummary 속성을 설정하였을 때 합계 필드에 출력되는 텍스트를 지정합니다.

기본값(default) : "합계".
tooltipSensitivity
Type : Number   Version: 2.7.0

툴팁 표시를 설정한 경우(showTooltip:true 설정) 툴팁이 표시되는 시간을 ms 로 지정합니다.

즉, 특정 셀에 마우스 오버를 한 경우 tooltipSensitivity 값 이후에 툴팁이 출력됩니다.

예를 들어 tooltipSensitivity=1000 을 지정한 경우 1 초 후 툴팁이 표시됩니다. 마우스 오버 시 바로 툴팁 표시를 원하면 0 을 설정하십시오.

기본값(default) : 700.
treeColumnIndex
Type : Number   Version: 2.7.0

계층형 그리드(트리 그리드) 에서 트리 아이콘을 출력시킬 칼럼 인덱스를 지정합니다.

기본값(default) : 0.
treeIconFunction
Type : Function   Version: 2.7.0

트리 그리드에서 트리를 출력하는 칼럼에 표시되는 아이콘을 동적으로 변경 할 수 있는 함수입니다.

파라메터 설명

  • rowIndex (Number) : 행인덱스
  • isBranch (Boolean) : Branch 인지 leaf 인지 여부
  • isOpen (Boolean) : Branch 인 경우 열기/닫기 상태 여부
  • depth (Number) : 트리의 depth, 최상위 루트가 1에 해당되며 차례로 1씩 증가함
  • item (Object) : 행 아이템

Return : (String) 아이콘으로 출력하고자 하는 아이콘의 주소값(이미지 소스)

   function signature : 
   function(rowIndex, isBranch, isOpen, depth, item) {
      var imgSrc = null;
      if(item.charge == "Lawrence") {
          imgSrc = "./assets/man1.png";
      } else {
          imgSrc = "./assets/man2.png";
      }
      return imgSrc;
    }    
   

관련 데모 보기

기본값(default) : null.
treeIdField
Type : String   Version: 2.7.0

그리드에 입력되는 데이터가 계층구조의 데이터는 아니지만, 트리 그리드로 출력하고자 할 때 행이 id, parent 필드를 갖어야 합니다.

이 때 id에 해당되는 데이터의 필드명을 treeIdField 값으로 지정하십시오.

이 속성은 flat2tree, treeIdRefField 속성과 관련이 있습니다.

기본값(default) : null.
treeIdRefField
Type : String   Version: 2.7.0

그리드에 입력되는 데이터가 계층구조의 데이터는 아니지만, 트리 그리드로 출력하고자 할 때 행이 id, parent 필드를 갖어야 합니다.

이 때 내 부모행에 해당되는 참고필드를 treeIdRefField 값으로 지정하십시오.

이 속성은 flat2tree, treeIdField 속성과 관련이 있습니다.

기본값(default) : null.
treeLazyMode
Type : Boolean   Version: 2.12

그리드에 일반 데이터(즉, 트리 계층형 데이터가 아닌 일반 배열 데이터)를 삽입 한 경우, 하위 데이터가 없는 트리 그리드로 출력합니다.

이 그리드는 온전한 트리 그리드의 모습을 갖추고 있으나 하위 데이터가 없기 때문에 해당 행의 트리의 열기/닫기 아이콘을 눌렀을 때 그 행에 맞는 하위 데이터를 요청하는 형태의 트리 그리드로 출력합니다.

따라서 트리 그리드의 하위 행을 동적으로 열기/닫기 아이콘을 눌렀을 때 서버 요청하여 적용하고자 하는 경우 treeLazyMode 를 true 설정하십시오.

관련 데모 보기

기본값(default) : false.
treeLevelIndent
Type : Number   Version: 2.7.0

계층형 그리드(트리 그리드) 에서 자식 행과 부모 행의 왼쪽 간격(indent)를 지정합니다.

기본값(default) : 18.
treeOpenRecursivly
Type : Boolean   Version: 2.7.0

계층형 그리드(트리 그리드) 에서 열기/닫기 실행 시 재귀적으로(recursivly) 열/닫을 실행할지 결정합니다.

재귀란 바로 아래 자식 뿐 아니라 자손까지 영향을 미칠지를 나타냅니다.

기본값(default) : false.
triggerSelectionChangeOnCell
Type : Boolean   Version: 2.7.0

selectionMode 를 "singleRow" 또는 "multipleRows" 로 지정 한 경우 같은 행에서 다른 칼럼으로 선택자가 변경된 경우 기본적으로 selectionChange 이벤트가 발생하지 않습니다.

즉, 1번 행의 0번째 칼럼을 선택 한 후 1번 행의 1번째 칼럼으로 선택을 바꿨다면 "singleRow" 또는 "multipleRows" 에선 selectionChange 이벤트가 발생하지 않습니다.

그러나 triggerSelectionChangeOnCell 속성을 true 로 설정하면 "singleRow" 또는 "multipleRows" 에서도 selectionChange 이벤트가 발생하게 됩니다.

행 선택자를 지정 한 후, 같은 행에서 다른 칼럼으로 이동할 때 selectionChange 이벤트를 발생하고자 한다면 이 속성을 true 설정 하십시오.

기본값(default) : false.
undoRedoStackSize
Type : Number   Version: 2.7.0

실행 취소(Undo), 다시 실행(Redo) 기능을 사용할 때 Undo, Redo 가능한 커맨드 스택의 총량(Stack length)을 지정합니다.

예를 들어 이 속성의 값을 30 으로 설정하면, 30개의 커맨드만 관리 됩니다.

0인 경우 길이의 제한은 없습니다. 그러나, 내부적으로 필요에 의해 스택 사이즈 초기화가 이루어집니다.

기본값(default) : 0.
uneditableNewRowsOnPaste
Type : Boolean   Version: 3.0.7

붙여넣기로 새행이 생길 때 칼럼의 editable=false 설정한 칼럼의 값을 새행이 생기는 경우에도 고칠 수 없을지 여부를 지정합니다.

false 인 경우에는 붙여넣기로 새행이 생길 때 클립보드 데이터가 적용됩니다.

true 인 경우에는 붙여넣기로 새행이 생길 때 클립보드 데이터 적용되지 않습니다.

Also See : notBeginEventNewRowsOnPaste

기본값(default) : false.
updownArrowEditEnd
Type : Number   Version: 2.7.0

편집 가능 그리드에서 "F2 또는 (더블)클릭" 으로 편집 상태로 들어간 경우 위, 아래 화살표 키가 편집 완료 역할 할지 여부를 지정합니다.

기본적으로 "F2 또는 (더블)클릭" 으로 편집 상태 들어간 경우는 해당 입력기(inputer) 안에서 키보드가 이동합니다.

이 속성은 editRenderer 의 기본 유형(default type)인 InputEditRenderer 에만 유효합니다.

기본값(default) : true.
useContextMenu
Type : Boolean   Version: 2.7.0

컨텍스트 메뉴 사용 여부를 지정합니다.

컨텍스트 메뉴를 사용한다면 기본적으로 필터 메뉴가 생성됩니다. 기본 컨텍스트 메뉴를 사용하고자 한다면 enableFilter = true 설정도 함께 해주십시오.

기본값(default) : false.
useGroupingPanel
Type : Boolean   Version: 2.7.0

그리드 상단에 그룹핑 가능한 패널 사용 여부를 지정합니다.

이 속성이 true 이면 칼럼 헤더를 드래그하여 그룹핑 패널에 드랍하면 그룹핑을 사용자가 할 수 있습니다.

기본값(default) : false.
usePaging
Type : Boolean   Version: 2.7.0

페이징을 사용 여부를 지정합니다.

기본값(default) : false.
useSummaryExpData
Type : Boolean   Version: 2.7.0

그룹핑 합계필드(groupingSummary)를 사용할 때 합계 필드에 사용되는 데이터가 칼럼의 expFunction 에 의해 생성된 데이터를 사용할지 여부를 나타냅니다.

즉, 의존적 칼럼 관계로 생성된 데이터를 그룹핑 합계 필드에 활용하고자 하는 경우 이 속성을 true 설정하십시오.

기본값(default) : false.
wheelSensitivity
Type : Number   Version: 2.7.0

마우스 휠(wheel)에 의한 수직 스크롤의 반응도를 결정합니다.

예를 들어 이 속성의 값을 2로 주면 마우스 휠로 반응하는 행의 개수가 2로 변경됩니다.

기본값(default) : 3.
width
Type : Number   Version: 2.7.0

그리드의 가로 사이즈를 픽셀 단위로 지정합니다. 이 가로 사이즈를 지정하지 않으면 부모 DIV 의 width 만큼 할당됩니다.(즉, 부모 width의 100%)

기본값(default) : NaN.
wordWrap
Type : Boolean   Version: 2.7.0

이 속성값이 true 인 경우 자동 word-wrap 이 발생하며 각 행의 높이가 설정한 텍스트에 맞게 가변적으로 렌더링됩니다.

wordWrap 의 사용은 그리드 퍼포먼스에 가장 큰 영향을 미치는 속성 중 하나입니다.

칼럼 레이아웃에서 설정한 열의 개수와 보여지는 행의 개수(실제 데이터 개수가 아닌 화면에 보이는 행의 개수)에 비례하여 퍼포먼스는 낮아집니다.

따라서 wordWrap 사용은 꼭 필요한 상황에 최소한으로 사용하십시오

기본값(default) : false.
wrapSelectionMove
Type : Boolean   Version: 2.7.0

마지막 칼럼에서 오른쪽 화살표 키 또는 Tab 키를 누른 경우 다음 행의 시작 칼럼으로 이동할지 여부를 나타냅니다.

반대로 시작 칼럼에서 왼쪽 화살표 키 또는 Shift+Tab 키를 누른 경우 이전 행의 마지막 칼럼으로 이동 여부입니다.

기본값(default) : false.
zeroBazeAtRowNum
Type : Boolean   Version: 2.7.0

행 줄번호(로우 넘버링)의 시작을 0에서 시작할 지, 1에서 시작할지 여부를 지정합니다.

true 인 경우 0에서부터 시작합니다.

기본값(default) : false.