AUISoft에이유아이소프트
AUIPivot 2.8 Documentation

Properties

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

Name Description
aliasMustInPanel
Type : Boolean   Version: 2.6.3

원시 데이터와 관계 없이 피벗 필드 별칭(alias)를 설정한 필드는 피벗 패널 리스트로 출력 시킬지 여부를 지정합니다.

기본값(default) : false
autoGridHeight
Type : Boolean   Version: 1.5

피벗 결과의 행 수에 맞춰 그리드 높이를 자동으로 조절할지 지정합니다.

생성 시 높이보다 커지지 않으며, 결과가 많으면 세로 스크롤을 표시합니다.

기본값(default) : true
autoGridMinHeight
Type : Number   Version: 1.5

autoGridHeight가 true일 때 그리드의 최소 높이를 픽셀 단위로 지정합니다.

기본값(default) : NaN
autoGridParentHeight
Type : Boolean   Version: 1.5

autoGridHeight 을 true 로 설정한 경우, 피벗 그리드의 높이가 유동적으로 변할 때 그리드의 부모 DIV 도 같이 적용 시킬지 여부를 지정합니다.

기본값(default) : true
autoScrollSize
Type : Boolean   Version: 1.0

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

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

기본값(default) : false
columnAutoWidthGap
Type : Number   Version: 1.0

자동 계산된 칼럼 너비에 더할 여백을 픽셀 단위로 지정합니다. 너비를 줄이려면 음수를 사용합니다.

기본값(default) : 4
contextMenuHeaderItems
Type : Array   Version: 2.6

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

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

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


  const myContextMenus = [{
       // label 에 $value 를 설정하면 마우스가 있는 곳의 헤더 텍스트 값으로 대체됩니다.
       label : "$value (커스텀)",  callback : contextItemHeaderHandler 
     }, {
       label : "_$line" // label 에 _$line 을 설정하면 라인을 긋는 아이템으로 인식합니다.
  }];
 
  • label (String) : 컨텍스트 메뉴에 표시될 텍스트 입니다. label 에 $value 를 설정하면 마우스가 있는 곳 헤더 텍스트 값으로 대체되어 출력됩니다.
  • style (String) : 개별 아이템의 스타일을 지정합니다. 유효값은 CSS 의 클래스 선언자명입니다.
  • disable (Boolean) : 컨텍스트 메뉴의 비활성화 여부를 지정합니다.
  • children (Array) : 서브 메뉴의 컨텍스트를 작성합니다.
  • callback (Function) : 컨텍스트 메뉴에서 아이템을 선택했을시 호출 되는 함수입니다. callback 의 파라메터는 event 로 요소는 다음과 같습니다.
    • columnIndex : 열(Column) 인덱스
    • contextIndex : 컨텍스트 메뉴 구성 인덱스
    • contextDepth : 컨텍스트 메뉴 구성의 깊이(depth)
    • contextItem : 컨텍스트 메뉴 아이템 (Object)
    • dataField : 행(Row) 아이템에서 현재 열(Column)이 출력되고 있는 데이터의 KeyField
    • pid : 사용자에 의해 작성된 그리드의 부모 DIV ID (샘플 상의 myGridID 와 일치함)
    • depth : 헤더를 그룹형(계층형)으로 작성한 경우 계층(depth)
    • target : 컨텍스트 메뉴 구성 타겟. 헤더 컨텍스트 메뉴이므로 "header" 값을 갖음
    • value : 컨텍스트 지점의 헤더 텍스트
  • isGroup : 헤더를 그룹형(계층형)으로 작성한 경우 그룹 헤더인 지 여부
기본값(default) : Array
contextMenuItems
Type : Array   Version: 2.6

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

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

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


  const 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) : 컨텍스트 메뉴의 비활성화 여부를 지정합니다.
  • children (Array) : 서브 메뉴의 컨텍스트를 작성합니다.
  • callback (Function) : 컨텍스트 메뉴에서 아이템을 선택했을시 호출 되는 함수입니다. callback 의 파라메터는 event 로 요소는 다음과 같습니다.
    • columnIndex : 열(Column) 인덱스
    • rowIndex : 행(Row) 인덱스
    • contextIndex : 컨텍스트 메뉴 구성 인덱스
    • contextDepth : 컨텍스트 메뉴 구성의 깊이(depth)
    • contextItem : 컨텍스트 메뉴 아이템 (Object)
    • dataField : 행(Row) 아이템에서 현재 열(Column)이 출력되고 있는 데이터의 KeyField
    • item : 해당 행(Row)에 출력되고 있는 행 아이템 객체 (Object)
    • pid : 사용자에 의해 작성된 그리드의 부모 DIV ID (샘플 상의 myGridID 와 일치함)
    • target : 컨텍스트 메뉴 구성 타겟. 바디 컨텍스트 메뉴이므로 "body" 값을 갖음
    • value : 셀에 출력되고 있는 값(value)
기본값(default) : Array
copyDisplayValue
Type : Boolean   Version: 1.0

셀을 복사할 때 숫자의 표시 서식을 포함할지 지정합니다.

  • false: 서식 적용 전 집계값을 복사합니다. 화면의 1,000원은 1000으로 복사됩니다. 원본 거래 한 건의 값이 아닌 피벗 집계 결과입니다.
  • true: 숫자 서식과 valueLabelFunction을 적용한 표시값을 복사합니다.

행 레이블은 두 경우 모두 표시 이름을 복사합니다. selectionMode가 none이면 브라우저의 일반 텍스트 복사를 사용합니다.

Also See : selectionMode | 복사 안내 | 관련 데모 보기

기본값(default) : false
dateTypeField
Type : String   Version: 1.0

연, 반기, 분기, 월 필드를 만들 기준 날짜 필드명을 지정합니다. 날짜는 일 단위의 값이어야 합니다.

DATE를 지정하면 DATE_YEAR, DATE_HALF, DATE_QTR, DATE_MONTH가 생성됩니다.

Also See : setDateTypeField | 날짜 필드 안내

기본값(default) : null
defaultFormatString
Type : String   Version: 2.6

값 차원에 필드를 설정하면 연산되어 요약된 값이 출력됩니다. 이 요약된 숫자의 기본 포맷스트링을 지정합니다.

이 포맷스트링은 숫자 형식에만 유효합니다.

숫자 포맷 스트링은 다음과 같습니다.

"0" 과 "#"의 차이는 "0"은 반드시 자리수를 차지하도록 채웁니다. "#"은 있는 경우 출력 시킴

  • ###0 : 컴마 구분자 없이 정수 표현(소수점은 기본적으로 반올림 처리)
  • #### : 컴마 구분자 없이 정수 표현, 0인 경우 공백 처리(소수점은 기본적으로 반올림 처리)
  • #,##0 : 천단위 마다 컴마 구분자 정수 표현(소수점은 기본적으로 반올림 처리)
  • #,### : 천단위 마다 컴마 구분자 정수 표현, 0인 경우 공백 처리(소수점은 기본적으로 반올림 처리)
  • #,##0.0 : 천단위 마다 컴마 구분자 소수 1자리 의무 표현(소수 2자리에서 기본적으로 반올림 처리)
  • #,##0.# : 천단위 마다 컴마 구분자 소수 있다면 1자리 표현, 0인 경우 공백 처리(소수 2자리에서 기본적으로 반올림 처리)
  • #,##0.00 : 천단위 마다 컴마 구분자 소수 2자리 의무 표현(소수 3자리에서 기본적으로 반올림 처리)
  • #,##0.0# : 천단위 마다 컴마 구분자 소수 1자리 의무, 2자리 있다면 표현(소수 3자리에서 기본적으로 반올림 처리)

비율을 표시할 때 백분율로 표현 하기 위해서는 뒤에 %를 붙여 출력 가능합니다.

예로 백분율을 소수점 2자리까지 표현은 "0.00%" 로 정의 가능합니다.

기본값(default) : "###0.#####"
defaultHeatmapColors
Type : Array   Version: 1.0

히트맵으로 출력을 사용하는 경우(useHeatmap=true) 히트맵 색상의 기본값을 지정합니다.

반드시 Array 로 2개 이상의 색상을 지정하십시오.

기본값(default) : ["#FFFFFF", "#4374D9"]
displayAutoAscending
Type : Boolean   Version: 2.5

행, 열의 항목을 자동으로 오름차순 정렬할지 지정합니다. false이면 원본 데이터의 순서를 따릅니다.

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

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

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

기본값(default) : true
enableCalculatedFieldEditor
Type : Boolean   Version: 2.8.0

필드 패널의 값 영역에 계산 필드 편집 버튼을 표시합니다.

기본값은 false입니다. true이면 데이터를 불러온 뒤 계산 필드를 추가, 수정, 삭제할 수 있습니다. 실행 중에는 setProp으로 변경한 뒤 refresh를 호출합니다. 필드 패널을 생성해야 버튼이 표시됩니다.

원본 행의 사칙연산과 합계 간 비율을 지원합니다. 패널의 isUpdatePiovtLater가 true이면 업데이트 버튼을 누를 때 반영합니다. 수식과 값 설정은 보고서 저장 정의에 포함하며, 이 표시 속성과 적용 전 초안은 포함하지 않습니다.

입력 범위, 미리보기와 삭제 조건은 계산 필드 편집을 참고하세요.

// 필드 패널에서 계산 필드를 편집할 수 있습니다.
const pivotProps = {
    enableCalculatedFieldEditor: true
};

집계 후 수식 모드에서는 괄호와 사칙연산을 직접 입력하고 현재 필터를 반영한 전체 총합계의 원시값과 서식 적용값을 미리 볼 수 있습니다. 수식 정의는 표시 여부와 별도로 관리됩니다. 자유 수식 안내를 참고하세요.

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

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

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

칼럼 리사이징 가능 여부를 지정합니다. 마우스 또는 터치로 헤더 사이의 경계를 끌고 놓으면 열 너비가 바뀝니다.

기본값(default) : true
enableFieldSubtotalMenu
Type : Boolean   Version: 2.8.0

필드 패널의 행 필드 메뉴에 부분합 설정을 표시합니다.

Boolean이며 기본값은 false입니다. true로 설정하고 필드 패널을 생성하면 사용할 수 있습니다. 실행 중에는 setProp으로 변경한 뒤 refresh를 호출합니다.

table과 tableCellMerge에서 해당 행 필드의 부분합을 표시하거나 숨깁니다. showSummaryRow가 false이거나 마지막 행 필드이면 변경할 수 없습니다. tree는 지원하지 않습니다. 변경하면 setExceptSumRowFields와 동일하게 showTreeIcon이 false가 되며 부분합을 다시 표시해도 아이콘은 자동 복원되지 않습니다.

패널의 isUpdatePiovtLater가 true이면 업데이트 버튼을 누를 때 반영됩니다. 자세한 적용과 저장 규칙은 필드별 부분합 설정을 참고하세요.

// 행 필드 메뉴에서 부분합을 설정할 수 있습니다.
const pivotProps = {
    enableFieldSubtotalMenu: true
};
기본값(default) : false
enableFocus
Type : Boolean   Version: 1.0

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

기본값(default) : true
enableGridFieldDrop
Type : Boolean   Version: 2.8.0

표 상단에서 행, 열, 값, 필터를 드래그하여 배치할 수 있는 편집 영역을 표시합니다.

기본값은 false입니다. true이면 빈 보고서와 tree, table, tableCellMerge에서 표시합니다. 실행 중에는 setProp으로 변경한 뒤 refresh를 호출합니다.

필드 패널에서 필드를 추가하거나 이름표를 옮겨 순서를 바꿀 수 있습니다. 패널의 isUpdatePiovtLater가 true이면 업데이트 버튼을 누를 때 보고서에 반영됩니다. 이동 메뉴와 제한 사항은 표에서 필드 배치를 참고하세요. 이 UI 속성은 보고서 저장 정의에 포함되지 않습니다.

// 표 안에 필드 배치 영역을 표시합니다.
const pivotProps = {
    enableGridFieldDrop: true
};
기본값(default) : false
enableHScrollByOnlyShiftKey
Type : Boolean   Version: 2.6

마우스 휠이 수평 스크롤에 반응 할 때 반드시 Shift Key 를 누를 경우만 해당되는지 여부를 지정합니다.

만약 이 속성을 false 설정하면 세로 스크롤이 없는 그리드인 경우 Shift Key 없이 단순 마우스 휠로 세로 스크롤 대신 가로 스크롤에 반응 합니다.

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

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

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

기본값(default) : true
enableItemReorder
Type : Boolean   Version: 2.8.0

행, 열 항목을 드래그하거나 이동 메뉴로 순서를 바꿀 수 있는 손잡이를 표시합니다.

기본값은 false입니다. true이면 tree, table, tableCellMerge에서 행 레이블과 열 항목에 표시합니다. 실행 중에는 setProp으로 변경한 뒤 refresh를 호출합니다.

같은 부모의 같은 필드 항목끼리 이동하며 자식과 부분 합계를 함께 옮깁니다. 변경한 순서는 필드 전체에 적용되어 setCustomValueOrders와 보고서 저장 정의에 반영됩니다. 이 표시 속성 자체는 보고서 저장 정의에 포함하지 않습니다.

행 결과 정렬 중에는 이동 메뉴에서 정렬을 먼저 해제하세요. 손잡이 조작, 키보드와 지원 값은 항목 수동 순서를 참고하세요.

// 행, 열 항목의 순서를 직접 바꿀 수 있습니다.
const pivotProps = {
    enableItemReorder: true
};
기본값(default) : false
enableMouseWheel
Type : Boolean   Version: 2.5.18

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

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

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

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

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

기본값(default) : true
enableSorting
Type : Boolean   Version: 1.0

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

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

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

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

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

기본값(default) : null
fieldListAreaRatio
Type : Number   Version: 1.5

피벗 필드 패널의 필드 리스트 영역이 차지하는 비율을 지정합니다.

예를 들어 이 값을 0.3으로 지정하면 필드 리스트 영역의 높이 크기가 전체 피벗 필드 패널의 30% 를 차지합니다.

유효 값은 0.3 ~ 0.7 입니다.

기본값(default) : 0.5
filterLayerHeight
Type : Number   Version: 1.0

필터 기본 메뉴의 높이를 픽셀 단위로 지정합니다.

기본값(default) : 380
filterLayerWidth
Type : Number   Version: 1.0

필터 기본 메뉴의 너비를 픽셀 단위로 지정합니다.

기본값(default) : 240
filterMenuItemMaxCount
Type : Number   Version: 1.0

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

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

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

기본값(default) : 50
filterPanelHeight
Type : Number   Version: 1.0

필터 차원 설정 메뉴 영역의 높이를 픽셀 단위로 지정합니다.

기본값(default) : 240
fixedAlterWidth
Type : Number   Version: 2.5.4

고정 칼럼이 설정된 경우 고정 칼럼외의 영역 보장 크기(width)를 지정합니다.

설정된 fixedAlterWidth 보다 고정 칼럼의 전체 크기(width)가 커진 경우 고정 칼럼들은 크기를 줄여 출력됩니다.

기본값(default) : 200
fixedColumnHGap
Type : Number   Version: 1.0

행 줄번호 또는 fixedColumnCount 설정 시 좌측으로 구분되는 그리드와 메인 그리드 사이의 여백을 지정합니다.

기본값(default) : 0
fixedColumnsMinWidth
Type : Number   Version: 2.8.2

좌우 칼럼 고정을 유지할 피벗의 최소 너비를 픽셀 단위로 지정합니다. 기본값은 600입니다.

피벗 자체의 너비(테두리 포함)가 이 값보다 작으면 고정을 일시 해제하고, 다시 이 값 이상이면 기존 설정대로 복원합니다.

0은 너비에 따른 자동 해제를 사용하지 않습니다. 0 이상의 유한한 숫자만 허용하며 그 외에는 Error를 발생시킵니다.

실행 중에는 setProp으로 변경한 뒤 refresh를 호출하고, 컨테이너 크기를 바꾼 뒤에는 resize를 호출하세요. 적용 범위와 저장 기준은 좁은 화면의 고정 해제를 참고하세요.

// 피벗 너비가 600px 미만이면 좌우 고정을 일시 해제합니다.
const pivotProps = { fixedColumnsMinWidth: 600 };
기본값(default) : 600
fixedRightColumnCount
Type : Number   Version: 2.8.2

오른쪽에 고정할 값 칼럼 수를 지정합니다.

  • null(기본값): 오른쪽 끝의 전체 합계 칼럼을 자동 고정합니다.
  • 0: 고정을 해제합니다.
  • 양의 안전한 정수: 오른쪽 마지막 값 칼럼을 지정한 개수만큼 고정합니다.

행 레이블, 행 번호와 상태 칼럼은 개수에서 제외합니다. 허용값 이외에는 Error를 발생시킵니다.

적용 조건은 useFixedRightColumns를 따릅니다. 실행 중에는 setProp으로 변경한 뒤 refresh를 호출하세요.

자동 고정 범위, 너비 제한과 저장 기준은 오른쪽 값 칼럼 고정을 참고하세요.

// 오른쪽 값 칼럼 두 개를 고정합니다.
const pivotProps = { fixedRightColumnCount: 2 };
기본값(default) : null
fixedRowFieldCount
Type : Number   Version: 2.8.0

왼쪽에 고정할 행 레이블 칼럼 수를 지정합니다.

피벗 너비가 fixedColumnsMinWidth(기본 600px)보다 작으면 고정을 일시 해제하며 지정값은 보존합니다.

기본값 null은 행 레이블 칼럼 전체를 자동으로 고정합니다. 0은 고정을 해제하며, 0 이상의 안전한 정수는 왼쪽부터 해당 개수만 고정합니다. 행 번호, 상태 칼럼과 값 칼럼은 개수에 포함하지 않습니다.

tree에서는 최대 1개, table과 tableCellMerge에서는 행 필드 수까지 적용합니다. 지정한 개수가 더 크면 현재 가능한 개수만 고정하며 지정값은 보존합니다. useFixedColumns가 false이면 이 값과 관계없이 고정하지 않습니다.

실행 중에는 setProp으로 변경한 뒤 refresh를 호출합니다. 이후 setGridData나 updatePivot으로 집계할 때도 적용합니다. 음수, 소수, 숫자 문자열과 안전한 정수 범위 밖의 값은 Error를 발생시킵니다.

보고서 저장 정의에 포함하지 않으므로 별도로 저장하고 설정하세요. 사용 예와 엑셀 적용은 행 칼럼 틀 고정을 참고하세요.

// 테이블에서 왼쪽 행 레이블 두 칼럼을 고정합니다.
const pivotProps = {
    layoutType: "table",
    fixedRowFieldCount: 2
};
기본값(default) : null
footerHeight
Type : Number   Version: 1.0

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

기본값(default) : 30
footerVGap
Type : Number   Version: 1.0

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

기본값(default) : 1
headerHeight
Type : Number   Version: 1.0

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

기본값(default) : 24
height
Type : Number   Version: 1.0

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

기본값(default) : NaN
isFormatNullValue
Type : Boolean   Version: 2.5

피벗 분석 데이터 값이 없는 값(null value)도 포맷팅을 할지 여부를 지정합니다.

예로 분석 후 값이 없는 경우 빈 공백으로 출력되는데 만약 0으로 출력하고자 한다면 이 속성을 true 설정 후 defaultFormatString(또는 개별 값 차원의 formatString) 을 "#,##0" 으로 설정 하십시오.

기본값(default) : false
isUpdatePiovtLater
Type : Boolean   Version: 2.6.4

피벗 패널을 열 때 “나중에 피벗 업데이트” 체크박스를 선택한 상태로 표시할지 지정합니다.

기본값(default) : false
layoutType
Type : String   Version: 1.0

피벗 그리드의 행 차원에 다수의 필드를 설정한 경우, 그리드의 출력 방식을 지정합니다.

유효값은 다음 3가지가 존재합니다.

  • tree : 요약형 트리 형식의 계층 구조로 출력합니다.
  • table : 행 차원에 설정한 필드 대로 칼럼을 출력 하나, 셀 병합된 형태가 아닌 반복적은 값이 나오도록 출력합니다.
  • tableCellMerge : 행 차원에 설정한 필드 대로 칼럼을 출력 후 반복적인 값은 병합하여 출력하도록 합니다.
기본값(default) : "tree"
minFieldPanelHeight
Type : Number   Version: 1.5

피벗 필드 패널의 최소 높이를 픽셀 단위로 지정합니다.

기본값(default) : 400
minFieldPanelWidth
Type : Number   Version: 1.5

피벗 필드 패널의 최소 너비를 픽셀 단위로 지정합니다.

기본값(default) : 300
movableFieldPanel
Type : Boolean   Version: 1.0

피벗 필드 패널의 제목을 마우스 또는 터치로 끌어 이동할 수 있게 할지 지정합니다.

Also See : resizableFieldPanel | 패널 조작 안내

기본값(default) : true
multiSortingKey
Type : String   Version: 1.0

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

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

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

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

기본값(default) : "shiftKey"
onlyTreeLastDepthSorting
Type : Boolean   Version: 1.0

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

기본값(default) : false
panelHeight
Type : Number   Version: 1.0

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

기본값(default) : NaN
panelWidth
Type : Number   Version: 1.0

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

기본값(default) : NaN
pivotPanelId
Type : String   Version: 1.0

피벗 필드 패널을 표시하고자 할 때 피벗 필드가 출력될 DIV 의 id 를 지정합니다.

DIV 태그의 id 를 지정하면 AUIPivot 이 생성될 때 같이 지정된 id 에 피벗 필드 패널이 생성됩니다.

기본값(default) : null
resizableFieldPanel
Type : Boolean   Version: 1.0

피벗 필드 패널의 크기를 마우스 또는 터치로 조절할 수 있게 할지 지정합니다. false이면 크기 조절 손잡이를 숨깁니다.

최소 크기는 minFieldPanelWidth와 minFieldPanelHeight로 지정합니다.

Also See : movableFieldPanel | 패널 조작 안내

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

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

기본값(default) : false
rowHeight
Type : Number   Version: 1.0

행 높이를 픽셀 단위로 지정합니다. 최솟값은 20입니다.

기본값(default) : 24
rowNumColumnWidth
Type : Number   Version: 1.0

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

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

기본값(default) : 40
rowStyleFunction
Type : Function   Version: 1.0

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

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

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

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

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

기본값(default) : null
scrollHeight
Type : Number   Version: 1.0

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

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

autoScrollSize가 true일 때 터치 기기에서 사용할 스크롤바 두께를 지정합니다. 가로 스크롤바는 높이, 세로 스크롤바는 너비이며 단위는 픽셀입니다.

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

스크롤 손잡이의 두께를 픽셀 단위로 지정합니다. 가로 스크롤바는 높이, 세로 스크롤바는 너비이며 기본값은 10입니다.

생성 시 설정합니다. 모바일 기기에서 autoScrollSize가 true이면 scrollHeight4Mobile 설정을 사용합니다.

기본값(default) : 10
selectionMode
Type : String

셀 또는 행의 선택 방식을 지정합니다.

  • singleCell: 셀 하나를 선택합니다.
  • singleRow: 행 하나를 선택합니다.
  • multipleCells: 여러 셀을 선택합니다.
  • multipleRows: 여러 행을 선택합니다.
  • none: 셀, 행 선택을 끕니다. 화면의 글자는 브라우저 기능으로 선택하고 복사할 수 있습니다.

복수 선택은 드래그 또는 Shift+클릭으로 범위를 지정하고, Ctrl+클릭(macOS는 Command+클릭)으로 항목을 추가합니다.

// 행 전체를 여러 개 선택하도록 설정합니다.
const pivotProps = {
    selectionMode: "multipleRows"
};

실행 중에는 setProp으로 지정한 뒤 refresh를 호출합니다. 실제 모드가 바뀌면 기존 선택은 해제됩니다.

Also See : getSelectedIndex | bind | 선택 동작 안내 | 관련 데모 보기

기본값(default) : "multipleCells"
showColumnLabelHeader
Type : Boolean   Version: 1.7

열(column) 의 최상단 헤더로 출력되는 "열 레이블" 헤더 출력 여부를 지정합니다.

기본값(default) : true
showColumnTreeIcon
Type : Boolean   Version: 1.7

열(column) 필드를 복수로 지정한 경우, 열에 트리 아이콘이 출력됩니다. 이 트리 아이콘의 출력 여부를 지정합니다.

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

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

기본값(default) : true
showGrandTotalColumn
Type : Boolean   Version: 1.7

열(column) 의 전체 합계 출력 여부를 지정합니다.

기본값(default) : true
showRowNumColumn
Type : Boolean   Version: 1.0

그리드 왼쪽에 행 번호 칼럼을 표시할지 지정합니다.

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

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

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

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

기본값(default) : true
showSummaryColumn
Type : Boolean   Version: 1.7

열(column) 필드를 복수로 지정한 경우, 개별 열에 부분 합계(소계)가 출력 됩니다. 이 부분 합계 열의 출력 여부를 지정합니다.

기본값(default) : true
showSummaryRow
Type : Boolean   Version: 1.7

layoutType 을 "table" 또는 "tableCellMerge" 로 설정한 경우, 행의 부분 합계(소계) 출력 여부를 지정합니다.

참고 : layoutType = "tree" 인 경우 트리 형태 유지를 위해 부분 합계(소계)가 출력 되므로 showSummaryRow 속성은 무시됩니다.

기본값(default) : true
showTooltip
Type : Boolean   Version: 1.0

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

기본값(default) : false
showTreeIcon
Type : Boolean   Version: 1.7

layoutType 을 "table" 또는 "tableCellMerge" 로 설정한 경우, 트리 아이콘 출력 여부를 지정합니다.

참고 : layoutType = "tree" 인 경우 필수로 트리 아이콘이 출력되어야 하므로 showTreeIcon 속성은 무시됩니다.

기본값(default) : true
showValueLabelHeader
Type : Boolean   Version: 1.7

값 필드의 정보를 나타내는 헤더 출력 여부를 지정합니다. 예를 들어 값 필드를 "TOTAL" 필드 "합계" 연산으로 설정했다면,

피벗 그리드의 최상단 좌측에 "합계 : TOTAL" 이라고 나오는 헤더 출력 여부 지정 속성입니다.

기본값(default) : true
slicerHeight
Type : Number   Version: 2.8.0

슬라이서 삽입 창에서 새로 만드는 슬라이서의 초기 높이를 픽셀 단위로 지정합니다.

180 이상의 유한한 숫자를 사용합니다. 화면보다 크면 최소 180px을 유지하는 범위에서 화면 여백을 제외한 크기로 줄입니다.

setProp으로 변경하면 다음에 삽입하는 슬라이서부터 적용됩니다. 이미 열린 슬라이서와 영역을 직접 지정한 수동 슬라이서에는 적용하지 않습니다. 보고서 저장 대상이 아닙니다.

// 슬라이서 삽입 창에서 생성할 기본 크기를 지정합니다.
const pivotProps = { slicerWidth: 320, slicerHeight: 360 };

slicerWidth, createSlicer

기본값(default) : 330
slicerWidth
Type : Number   Version: 2.8.0

슬라이서 삽입 창에서 새로 만드는 슬라이서의 초기 너비를 픽셀 단위로 지정합니다.

200 이상의 유한한 숫자를 사용합니다. 화면보다 크면 최소 200px을 유지하는 범위에서 화면 여백을 제외한 크기로 줄입니다.

setProp으로 변경하면 다음에 삽입하는 슬라이서부터 적용됩니다. 이미 열린 슬라이서와 영역을 직접 지정한 수동 슬라이서에는 적용하지 않습니다. 보고서 저장 대상이 아닙니다.

// 슬라이서 삽입 창에서 생성할 기본 크기를 지정합니다.
const pivotProps = { slicerWidth: 320, slicerHeight: 360 };

slicerHeight, createSlicer

기본값(default) : 300
stateColumnWidth
Type : Number   Version: 1.0

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

기본값(default) : 16
summaryColumnPosition
Type : String   Version: 1.0

요약 칼럼(부분 합계 칼럼, 전체 합계 칼럼 칼럼)의 위치를 지정합니다.

기본적으로 요약 칼럼은 뒤에 출력 시킵니다. 만약 앞에 출력하고자 한다면 이 속성을 "first" 로 지정하십시오.

유효값은 "first", "last" 입니다.

기본값(default) : "last"
tooltipDocked
Type : Boolean   Version: 2.7.0

툴팁을 마우스 위치 대신 셀 아래에 고정하여 표시할지 지정합니다.

showTooltip이 true일 때 사용합니다. 고정한 경우 tooltipOffsetX와 tooltipOffsetY는 적용하지 않습니다.

Also See : showTooltip | 툴팁 위치 안내 | 관련 데모 보기

기본값(default) : false
tooltipFunction
Type : Function   Version: 1.0

그리드 셀에 마우스 오버 시 생기는 툴팁을 사용자 정의 할 수 있는 함수를 설정합니다. (속성 showTooltip = true 설정 선행 필수)

tooltipFunction 은 함수로 설정하고 형식은 다음과 같습니다.

// 툴팁 사용자 정의 함수
// displayName : 값에 해당되는 연산 정보 텍스트(예: 합계 : 가격)
// rowText : 행 텍스트
// colText : 열 텍스트
// valText : 값 텍스트
// Return : 반환하는 그대로를 툴팁으로 출력합니다.(innerHTML 처리)
tooltipFunction :  function(displayName, rowText, colText, valText) {
        let htmlStr = '

AUIPivot 툴팁 사용자 정의

'; htmlStr += '' + displayName + ''; htmlStr += '
행 : ' + rowText.replace(/ - /gi, ", "); if(colText != "") htmlStr += '
열 : ' + colText.replace(/ - /gi, ", "); if(valText != "") htmlStr += '
값 : ' + valText; return htmlStr; // 반환하는 그대로를 툴팁으로 출력합니다.(innerHTML 처리) }
기본값(default) : null
tooltipOffsetX
Type : Number   Version: 2.7.0

마우스와 툴팁 사이의 가로 간격을 픽셀 단위로 지정합니다. 0 이상의 숫자를 사용하며 소수도 가능합니다.

showTooltip이 true이고 tooltipDocked가 false일 때 적용합니다.

Also See : tooltipDocked | 툴팁 위치 안내 | 관련 데모 보기

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

마우스와 툴팁 사이의 세로 간격을 픽셀 단위로 지정합니다. 0 이상의 숫자를 사용하며 소수도 가능합니다.

showTooltip이 true이고 tooltipDocked가 false일 때 적용합니다.

Also See : tooltipDocked | 툴팁 위치 안내 | 관련 데모 보기

기본값(default) : 16
tooltipSensitivity
Type : Number   Version: 1.0

showTooltip이 true일 때 마우스를 올린 후 툴팁이 나타나기까지의 시간을 밀리초(ms)로 지정합니다. 0이면 즉시 표시합니다.

기본값(default) : 700
treeLevelIndent
Type : Number   Version: 1.0

레이아웃 유형이 "tree" 인 경우 자식 행과 부모 행의 왼쪽 간격(indent)를 지정합니다.

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

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

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

기본값(default) : false
useContextHeaderMenu
Type : Boolean   Version: 2.6

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

반드시 contextMenuHeaderItems 속성을 함께 설정하여 헤더 컨텍스트 메뉴를 구성하십시오.

기본값(default) : false
useContextMenu
Type : Boolean   Version: 2.6

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

반드시 contextMenuItems 속성을 함께 설정하여 헤더 컨텍스트 메뉴를 구성하십시오.

기본값(default) : false
useFixedColumns
Type : Boolean   Version: 1.0

행 차원에 필드를 설정하면 해당 행 필드에 의해 만들어진 칼럼을 틀 고정 처리 할지 여부를 지정합니다.

피벗 너비가 fixedColumnsMinWidth(기본 600px)보다 작으면 고정을 일시 해제하며 지정값은 보존합니다.

틀 고정은 행 차원 필드 개수에 따라 동적으로 변합니다.

기본값(default) : true
useFixedRightColumns
Type : Boolean   Version: 2.8.2

오른쪽 값 칼럼의 고정 사용 여부를 지정합니다.

  • true(기본값): fixedRightColumnCount에 따라 고정합니다. 기본은 전체 합계 자동 고정입니다.
  • false: 개수 설정과 관계없이 오른쪽 고정을 해제합니다.

가로 스크롤바가 표시될 때만 적용하며, 피벗 너비가 fixedColumnsMinWidth(기본 600px) 미만이면 일시 해제합니다. 지정 개수는 보존하며 왼쪽 고정에는 영향을 주지 않습니다.

실행 중에는 setProp으로 변경한 뒤 refresh를 호출하세요. 세부 동작은 오른쪽 값 칼럼 고정을 참고하세요.

// 오른쪽 전체 합계를 자동 고정합니다.
const pivotProps = { useFixedRightColumns: true };
기본값(default) : true
useHeaderFilterMenu
Type : Boolean   Version: 2.5

행 차원 칼럼의 헤더에 필터 메뉴를 생성 시킬지 여부를 지정합니다.

기본값(default) : true
useHeatmap
Type : Boolean   Version: 1.0

피벗된 그리드의 셀을 히트맵 형식으로 출력할지 여부를 지정합니다.

기본값(default) : false

useSmoothScroll
Type : Boolean   Version: 2.7

마우스 휠 및 트랙패드 스크롤 이동을 부드럽게 처리할지 여부를 지정합니다.

운영체제의 동작 줄이기 설정을 사용하면 부드러운 이동을 생략합니다.

기본값(default) : true
wheelSensitivity
Type : Number   Version: 1.0

마우스 휠의 세로 스크롤 민감도를 지정합니다.

값이 클수록 더 많이 이동합니다. 1 이상의 숫자를 사용하십시오.

기본값(default) : 2
width
Type : Number   Version: 1.0

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

기본값(default) : NaN