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

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

Also See : fillValueGroupingSummary | 관련 데모 보기

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

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

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

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

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

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

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

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

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

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

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

터치 디바이스의 경우 소프트 키보드의 유무에 의해 global resize 이벤트가 발생하기 때문에 이 속성은 false 로 처리됩니다.

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

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

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

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

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

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

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

만약 true 로 설정한다면 모바일 기기에서는 scrollHeight4Mobile 설정값으로 스크롤 크기가 적용되고 일반 데스크탑에서는 scrollHeight 설정값으로 스크롤 크기가 자동 적용 됩니다.

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

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

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

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

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

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

가로 병합(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 검색이나, 복잡한 로직은 삼가하십시오. 성능에 영향을 미칩니다.

관련 데모 보기

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

세로 병합에 한해 널 데이터의 병합 정책을 결정 짓습니다. 이와 무관하게 가로 병합은 온전히 값이 같아야 병합됩니다.

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

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

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

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

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

관련 데모 보기

엑스트라 체크박스의 헤더에 표시되는 전체 체크박스를 표시하지 않을 때 출력할 텍스트를 지정합니다.

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

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) : 컨텍스트 메뉴에서 아이템을 선택했을시 호출 되는 함수입니다. callback 의 파라메터는 event 로 요소는 다음과 같습니다.
  • columnIndex : 열(Column) 인덱스
  • rowIndex : 행(Row) 인덱스
  • contextIndex : 컨텍스트 메뉴 구성 인덱스
  • dataField : 행(Row) 아이템에서 현재 열(Column)이 출력되고 있는 데이터의 KeyField
  • item : 해당 행(Row)에 출력되고 있는 행 아이템 객체 (Object)
  • pid : 사용자에 의해 작성된 그리드의 부모 DIV ID (샘플 상의 myGridID 와 일치함)
  • value : 셀에 출력되고 있는 값(value)

관련 데모 보기

그리드의 셀 또는 행을 복사(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 반환하면 원래(실제) 값을 복사하게 결정합니다.

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

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

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

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

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

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

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

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

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

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

Also See : hideColumnByDataField | showColumnByDataField

기본 내장 태그인 dialog(HTMLDialogElement) 를 Modal로 이용하여 그 안에 그리드를 출력하는 경우 dialogId 를 설정합니다.

그리드 속성 dialogId 를 설정하면 기존 body 의 자식으로 붙던 레이어들이 dialog를 기준으로 표시됩니다.

dialog 에 그리드를 출력한 경우 반드시 dialogId 를 설정해야 드랍다운리스트, 달력, 필터 등의 레이어들이 dialog 상단에 표시됩니다.

selectionChange 이벤트가 마우스를 누른 채 이동하는 경우도 발생할지 여부를 지정합니다.

즉, 마우스를 누르고 드래깅하여 다중 셀을 선택하고 있는 경과를 그대로 selectionChange 이벤트로 송출할지 여부를 지정합니다.

기본값은 마우스를 누르고 이동한 후 최종적으로 뗀 경우(mouseUp 한 경우)에만 발생합니다.

그룹핑 할 때 소계 행(SummaryRows)을 따로 만들지 않고 그룹핑 트리 브랜치에 소계를 같이 출력할지 여부를 지정합니다.

관련 데모 보기

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

그룹핑 상태에서 셀 수정, 행 추가, 삭제를 하고자 하는 경우 editableOnGroupFields 속성을 true 설정해야 합니다.

그룹핑을 했을 때 수정이 필요한 경우 cellMergeRowSpan 속성도 true을 권장합니다.

Also See : cellMergeRowSpan | 관련 데모 보기

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

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

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

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

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

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

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

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

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

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

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

헤더에 HTML 을 표현한 경우 무시됩니다.

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

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

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

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

관련 데모 보기

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

이 속성을 설정하면 selectionMode 가 "multipleCells" 또는 "multipleRows" 인 경우 다중 셀(행) 선택을 하지 않고 바로 드래깅 행위를 하게 됩니다.

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

Also See : enableDrag | 관련 데모 보기

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

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

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

Also See : enableDrag | 관련 데모 보기

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

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

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

Shift + 마우스 휠(wheel)이 수평 스크롤에 반응할지 여부를 지정합니다.

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

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

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

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

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

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

단, 고정 칼럼(fixedColumnCount)으로 설정된 칼럼은 드래깅으로 변경 불가능합니다.

다수의 행을 한번에 드래깅 가능 여부를 지정합니다.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

참고 : keepColumnOrderOnGrouping 를 true 설정한 경우 이 속성은 무시됩니다.

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

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

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

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

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

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

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

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

엑스트라 렌더러의 출력 순서를 결정합니다.

엑스트라 렌더러는 드래깅 손잡이(showDragKnobColumn), 행 번호(showRowNumColumn), 행 상태(showStateColumn), 행 체크박스(showRowCheckColumn) 4가지가 존재합니다.

엑스트라 렌더러 활성화 속성 이름을 배열에 지정하면 해당 순서에 맞게 출력 시킵니다.

예로 작성하면 다음과 같습니다.

 // 엑스트라 체크박스 칼럼을 맨 앞으로, 나머지 칼럼은 기본 순서 유지 (나머지 칼럼 유지는 배열에 지정하지 않으면 유지 시킴)
 extraColumnOrders = ["showDragKnobColumn"];
 
 // 엑스트라 체크박스, 행 번호, 상태, 드래깅 손잡이 순으로 순서 지정하기
 extraColumnOrders = ["showRowCheckColumn", "showRowNumColumn", "showStateColumn", "showDragKnobColumn"];

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

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

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

Also See : fixedColumnCount | 관련 데모 보기

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

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

관련 데모 보기

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

일반 데이터의 순서(order)는 중요합니다. 부모 행은 반드시 자식 행보다 앞에 있어야 합니다.

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

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

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

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

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

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

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

관련 데모 보기

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

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

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

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

관련 데모 보기

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

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

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

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

관련 데모 보기

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

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

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

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

Also See : groupingSummary | 관련 데모 보기

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

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

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

그룹핑 시 소계 행(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)는 모든 계층에 대한 소계를 구하게 되어합니다. 계층이 많은 경우 퍼포먼스에 악영향을 끼칩니다.

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

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

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

관련 데모 보기

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

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

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

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

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

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

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

마우스 오버 시 표시될 모드를 지정합니다. 유효 속성값은 다음과 같습니다.

"singleCell", "singleRow", "none"

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

이 값은 픽셀입니다.

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

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

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

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

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

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

인라인 필터에서 필터 값 입력 시 반응 딜레이를 설정합니다.

예로 500 설정 시 사용자가 입력 종료 500ms 시간이 지난 이후 필터링을 실행합니다.

0을 설정하면 매 입력마다 필터링을 실행합니다.

많은 수의 데이터나 사용자의 매 입력의 불필요한 필터링을 원치 않으면 300~500 설정을 권합니다.

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

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

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

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

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

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

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

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

엑스트라 체크박스의 헤더 전체 체크박스 설정/해제가 현재 데이터 기반으로 될지 여부를 지정합니다.

예로 필터링되어 현재 3개의 행만 보일 때 전체 체크를 하면 현재 보이는 3개의 행만 선택됩니다.

페이징 모드(usePaging = true)에서 현재 페이지의 행들 대상으로 전체 체크 설정/해제 하고자 한다면 이 속성을 설정하십시오.

현재 데이터에 변화가 생긴 경우 전체 체크는 풀립니다

참고 : 계층형 그리드(트리 그리드)에서 해당 속성 설정은 무시됩니다.

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

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

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

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

관련 데모 보기

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

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

터치 기반의 모바일 디바이스에서는 무시됩니다.

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

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

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

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

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

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

수평 스크롤이 있는 그리드에서 현재 화면의 칼럼이 반절 가려진 경우 마우스로 셀을 클릭할 때 온전하게 보이도록 스크롤을 자동으로 이동할지 여부를 지정합니다.

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

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

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

셀 병합(merge)을 할 때 포매팅한 결과 값을 기준으로 병합 할지 여부를 지정합니다.

포매팅한 결과 값의 의미는 실제 데이터가 아닌 labelFunction, formatString 등으로 가공된 최종 뷰(view)적인 표현 값을 의미합니다.

만약 false 설정한다면 실 데이터 모델의 값 기준(dataField 값 기준)으로 병합 여부를 결정 짓습니다.

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

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

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

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

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

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

관련 데모 보기

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

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

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

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

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

Also See : uneditableNewRowsOnPaste

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

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

관련 데모 보기

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

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

그룹핑을 할 때 데이터의 순서를 그룹핑 필드의 값 오름차순으로 출력 시킬지 여부를 지정합니다.

이 속성을 true 설정하면 그룹핑 필드 설정된 칼럼의 데이터 순서는 오름차순으로 출력됩니다.

실제 그리드 정렬(sorting)과는 무관한 단순 출력 방식 지정 입니다.

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

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

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

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

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

Also See : showPageRowSelect | 관련 데모 보기

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

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

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

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

• currentPage : 현재 페이지
• totalPageCount : 총 페이지수
• currentTopNumber : 현재 페이지에서 최상단의 행 번호
• currentBottomNumber : 현재 페이지에서 최하단의 행 번호
• dataLen : 총 데이터 수

 
pagingInfoLabelFunction : function(currentPage, totalPageCount, currentTopNumber, currentBottomNumber, dataLen) {
   // 로직 처리
   return "현재 : " + currentPage + " / 전체 : " + totalPageCount + "( " + currentTopNumber + "~" + currentBottomNumber + " )";
} 

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

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

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

"button" 로 설정한 경우 페이징 패널 없이 그리드 하단에 오버레이되어 이전, 다음 버턴만 출력됩니다.

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

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

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

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

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

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

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

예를 들어 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 로 설정하는게 유리합니다.

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

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

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

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

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

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

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

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

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

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

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

관련 데모 보기

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

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

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

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

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

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

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

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

엑스트라 행 체크박스에 있는 행 체크박스를 비활성화(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 검색이나, 복잡한 로직은 삼가하십시오. 성능에 영향을 미칩니다.

관련 데모 보기

엑스트라 체크박스를 세로 병합하여 출력 시킬 때 그 기준이 되는 칼럼의 dataField를 지정합니다.

예로 이 속성을 "name" 으로 설정하면 그리드의 "name" 칼럼과 동일하게 엑스트라 체크박스를 세로 병합시켜 출력 시킵니다.

따라서 엑스트라 체크박스를 세로 병합하기 위해서는 미리 그 기준이 되는 칼럼을 병합 시켜야 합니다.

관련 데모 보기

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

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

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

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

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

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

Return : (Boolean) true 를 반환하면 체크박스가 정상 표시되며 false 를 반환하면 체크박스가 숨기기 상태(hidden)가 됩니다.

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

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

관련 데모 보기

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

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

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

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

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

예로 rowIdField 를 "id" 로 설정한 경우 모든 데이터의 개별 행에 id 필드가 존재해야 하며 그 값들은 모두 고유값이여야 합니다.

이 필드를 지정하면 그리드가 빨리 생성됩니다. 10만 행(rows) 데이터 이상에서는 빠른 렌더링을 위해 설정을 추천합니다.

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

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

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

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

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

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

Also See : rowIdField

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

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

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

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

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

페이징 모드인 경우는 현재 페이지의 최상단 행의 인덱스와 같습니다.

[deprecated Ver 3.0.13]

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

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

• rowIndex : 행 인덱스
• item : 해당 인덱스의 행 아이템

 rowStyleFunction : function(rowIndex, item) {
   var myCss = "my-Css";
   // 로직 처리
   return myCss;
}

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

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

엑셀 내보내기 시에는 해당 스타일의 글자 색상(color), 배경색(background-color), 이탤릭체(font-style: italic), 볼드체(font-weight: bold), 언더라인(text-decoration: underline)만 적용됩니다.

관련 데모 보기

그리드 상위 태그의 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.

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

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

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

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

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

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

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

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

• "singleCell" : 선택 단위가 셀(cell) 단위로 지정되며 단일 셀을 선택할 수 있습니다.
• "singleRow" : 선택 단위가 행(row) 단위로 지정되며 단일 행을 선택할 수 있습니다.
• "multipleCells" : 선택 단위가 셀(cell) 단위로 지정되며 다수의 셀을 선택할 수 있습니다.
• "multipleRows : 선택 단위가 행(row) 단위로 지정되며 다수의 행을 선택할 수 있습니다.
• "none" : 그리드에서 제공하는 선택 기능을 해제 시킵니다. "none"을 설정하면 일반 HTML 에서 기본 제공하는 사용자 텍스트 선택을 하게 만듭니다.

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

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

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

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

그룹핑 시 브랜치(branch)에 해당되는 행 출력 여부를 지정합니다.

그룹핑을 지정하면 계층 구조(트리 구조)로 데이터가 변하게 됩니다. 이 때 그룹핑의 브랜치에 해당되는 행이 동적으로 생성됩니다.

이 속성을 false 로 지정하면 그룹핑 시 브랜치 행이 표시되지 않습니다.

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

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

드래깅으로 행을 이동할 때 보여지는 툴팁의 표시 여부를 지정합니다.

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

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

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

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

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

그리드 헤더 하단에 필터값을 바로 입력할 수 있는 입력 행을 출력 시킬지 여부를 지정합니다.

인라인 필터 행에 값을 입력하면 매 입력마다 필터링이 됩니다.(선행 속성 enableFilter = true 설정)

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

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

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

Also See : pageRowSelectValues | 관련 데모 보기

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

그리드 홀수 행, 짝수 행에 각각의 지정된 배경색 스타일이 적용될지 여부를 지정합니다.

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

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

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

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

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

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

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

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

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

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

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

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

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

Also See : selectionChange

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

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

다수 값을 붙여 넣기 할 때 수정 불가능한 칼럼은 값 자체를 무시할지 여부를 지정합니다.

예로 A, B, C 칼럼이 존재하고 B칼럼이 수정 불가 일 때 1, 2, 3 으로 대표되는 값을 A열에서 붙여 넣기 하면

true 인 경우에는 A열에 1, B열 수정 불가, C열은 3으로 붙여 넣기 됩니다. 즉, 해당 열이 수정 불가라 그 자리에 들어가야 할 값 자체를 무시합니다.

false 인 경우에는 A열에 1, B열 수정 불가, C열은 그 다음 값인 2로 붙여 넣기 합니다.

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

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

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

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

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

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

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

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

Also See : dropToOthers

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

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

뷰(View)적 정렬을 위해서는 데이터와 뷰의 관계가 1:1 관계여야 합니다. 즉, key : value 의 관계가 1:1 관계여야 합니다.

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

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

정렬의 오름차순, 내림차순 순서를 지정합니다.

헤더 클릭하여 정렬을 할 때 기본 순서는 오름차순, 내림차순, 원복의 순서 입니다.

이 순서를 변경하거나 항목에서 제외 시킬 수 있습니다.

예로 작성하면 다음과 같습니다.

 // 정렬 순서 : 첫 정렬을 내림차순부터, 오름차순, 원복의 순서 설정.
 sortingSequence = [0, -1, 1];
 
 // 정렬 순서 : 오름차순, 내림차순만 가능. 즉, 원복 사용하지 않음.
 sortingSequence = [1, -1];
 
 // 정렬 순서 : 내림차순만 사용. 내림 차순 이후 원복의 순서 설정. 즉, 오름차순은 사용하지 않음. 
 sortingSequence = [0, -1]; 

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

enableSummaryMerge 를 true 로 설정한 경우 즉, 그룹핑 소계 셀 병합 정책을 결정합니다.

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

• "default" : 그룹핑 필드 자신의 이전에서만 가로 병합 실행
• "all" : 그룹핑 필드 지정 개수 만큼 병합 실행

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

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

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

예를 들어 tooltipSensitivity=1000 을 지정한 경우 1 초 후 툴팁이 표시됩니다. 마우스 오버 시 바로 툴팁 표시를 원하면 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;
    }    
   

관련 데모 보기

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

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

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

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

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

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

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

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

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

이 속성은 수정 가능한 그리드(editable = true)인 경우 사용이 불가능합니다. 오로지 조회용 그리드 속성입니다.

수정 가능한 그리드에서의 하위 행 추가는 addTreeRow 메소드를 사용하십시오.

관련 데모 보기

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

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

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

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

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

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

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

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

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

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

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

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

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

Also See : notBeginEventNewRowsOnPaste

updateRow 메소드로 어떤 필드든 변경 시킬 수 있는지 여부를 지정합니다.

만약 true 설정하면 그리드 칼럼 레이아웃에서 정의한 칼럼이 아닌 경우임에도 임의의 필드를 수정할 수 있게 합니다.

임의의 필드를 수정하면 그 행은 수정된 행 상태로 변경됩니다. 따라서 getEditedRowItems 메소드를 통해 얻을 수 있습니다.

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

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

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

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

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

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

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

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

페이징 모드(usePaging=true)에서 하단에 출력되는 페이징 패널(페이징 이동 버턴이 출력되는 하단 영역)을 출력할지 여부를 지정합니다.

이 속성을 false 설정하면 페이징 모드 하단에 페이징 패널을 출력시키지 않습니다.

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

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

마우스 휠을 움직일 때 그리드의 스크롤이 최하단 또는 최상단으로 간 경우 그리드 밖의 스크롤에 영향을 줄지 여부를 결정합니다.

이 속성을 true 로 설정하면, 최하단 또는 최상단으로 간 경우 그리드 밖의 스크롤이 휠에 반응합니다.

페이징 모드가 아닌 일반 그리드에서 마우스 휠(wheel)에 의한 수직 스크롤의 반응도를 결정합니다.

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

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

칼럼의 최적의 사이즈를 구할 때 적용되는 추가 픽셀을 지정합니다.

예로 칼럼과 칼럼의 경계를 더블 클릭하여 크기(width)를 내용물에 맞출 때 추가로 적용 시킬 픽셀 사이즈를 적용 시킵니다.

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

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

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

wordWrap 되는 개별 행의 높이가 그리드의 영역의 2/3 보다 커질 수 없습니다. 만약 커지게 된다면 페이징 모드(usePaging = true)와 함께 사용하십시오.

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

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

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

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

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