v2.0.2

새 기능

Headless 모드

• general.headless를 지정하면 툴바(북 헤더), 헤드라인, 컬럼 바, 푸터, 인스펙터, 탐색기, AI 패널 없이 피벗 테이블 본체만 표시합니다. 행 바 아이콘, 필드 메뉴 버튼, 컨텍스트 메뉴도 제공하지 않습니다.
• 객체로 지정하면 필요한 패널만 사용할 수 있습니다. 객체로 지정할 때는 visible: true를 함께 지정해야 headless 모드가 적용됩니다.
  • field · filter: 오른쪽에 Fields · Filters 탭이 표시되고, 탭을 클릭하면 인스펙터가 해당 모드로 열립니다.
  • detail: 값 셀을 더블클릭하면 상세 데이터 패널이 열립니다.
• 탭바가 없으므로 페이지는 control.showPage()로 전환합니다.

const config = {
  general: {
    headless: { visible: true, field: true, filter: true, detail: true }, // 본체만 표시하려면 headless: true
  },
};
 
control.showPage(1);       // 인덱스로 전환
control.showPage('page2'); // 이름으로 전환

셀 복사

• 셀을 클릭하거나 범위를 선택한 뒤 Ctrl/Cmd+C로 복사할 수 있습니다. 탭으로 구분된 텍스트로 복사되어 엑셀 등에 그대로 붙여넣을 수 있으며, 헤더는 포함되지 않습니다.
• 셀 컨텍스트 메뉴에 '값으로 복사'(집계된 원래 값)와 '형식대로 복사'(화면에 표시되는 값) 항목이 추가되었습니다.
• general.copyMode로 키보드 복사 시 복사할 값의 형태를 지정합니다. 페이지의 tables[].copyMode를 지정하면 그 값이 우선합니다. 설정 대화상자의 '키보드 복사 (Ctrl/Cmd+C)' 항목에서도 바꿀 수 있습니다.
  • 'value'(기본값): 집계된 원래 값. 값 표시 방식(showAs), 표시 형식, formatter가 적용되지 않습니다.
  • 'display': 화면에 표시되는 텍스트. 값 표시 방식, 표시 형식, formatter, 빈 셀 텍스트가 적용됩니다.
• https가 아닌 http 환경에서도 복사할 수 있습니다.

const config = {
  general: { copyMode: 'display' },
};

상세 데이터 패널

• detail.dataMode에 'agg'(집계 데이터)가 추가되었습니다. 피벗의 집계 테이블 전체 행을 표시하며, fields·sourceFields는 적용되지 않습니다.
• 패널 메뉴에서 '집계 데이터' · '큐브 데이터' · '원본 데이터' 중 하나를 선택할 수 있습니다.
• agg·cube 모드에서는 차원 컬럼에 배경색이 표시됩니다.
• detail.columnMode 옵션이 추가되었습니다.
  • 'only'(기본값): fields·sourceFields에 지정한 필드만, 지정한 순서대로 표시합니다.
  • 'all': 지정한 필드만 표시하되, 데이터의 원래 필드 순서대로 표시합니다.

tables: [{
  detail: { dataMode: 'cube', fields: ['판매수량', '연료', '국가'] }, // 판매수량 → 연료 → 국가 순서로 표시
}]

필터 셀렉터 자동 적용

• general.autoFilterApply를 true로 지정하면 헤더에 표시되는 드롭다운·트리 셀렉터에서 적용 버튼 없이 항목을 체크하는 즉시 필터가 적용됩니다.
• 셀렉터마다 autoApply를 지정하면 그 값이 우선합니다.

const config = {
  general: { autoFilterApply: true },
  filterSelectors: [
    { type: 'dropdown', cube: 'sales', slicer: '차종' },                   // 즉시 적용
    { type: 'dropdown', cube: 'sales', slicer: '국가', autoApply: false }, // 적용 버튼 사용
  ],
};

트리 레이아웃 연결선

• 트리 레이아웃 행 바에 부모 필드와 자식 필드를 잇는 연결선이 표시됩니다. 선 색은 CSS 변수 --rpivot-tree-line-color로 바꿀 수 있습니다.

:root {
  --rpivot-tree-line-color: #a8adb6;
}

AI

• OpenAI 로컬 모델 옵션에 apiType과 reasoningEffort가 추가되었습니다. 두 옵션은 provider: 'openai'일 때만 지정할 수 있습니다.
  • apiType: 'chat-completions'(기본값) 또는 'responses'. 추론 모델에서 도구 호출을 사용하려면 'responses'를 지정합니다.
  • reasoningEffort: 추론 수준('none' · 'minimal' · 'low' · 'medium' · 'high' · 'xhigh' · 'max'). 생략하면 모델의 기본값을 사용하며, 지원하는 값은 모델마다 다릅니다.

models: {
  type: 'local',
  name: 'gpt',
  provider: 'openai',
  modelName: '<MODEL_NAME>',
  apiKey: '<YOUR_OPENAI_API_KEY>',
  apiType: 'responses',
  reasoningEffort: 'low',
}

개선

상세 데이터 패널

• 날짜 필드가 cube·source 모드 모두 yyyy-MM-dd 형식으로 표시됩니다. 이전에는 cube 모드에서 숫자(타임스탬프), source 모드에서 Date 문자열로 표시되었습니다.

버그 수정

값 표시 방식

• 값 필드가 2개 이상일 때 showAs의 parentColPercent·parentRowPercent 비율이 다른 값 필드의 소계를 기준으로 계산되어 잘못 표시되던 문제가 수정되었습니다.
• 값 필드가 2개 이상이고 기준 필드가 값 필드와 같은 축에 있을 때, baseItem: '@next'가 다음 항목이 아니라 자기 자신과 비교되던 문제가 수정되었습니다. 다음 항목이 없는 마지막 항목은 빈 칸으로 표시됩니다.

셀 선택

• 행·열 총계를 앞쪽에 고정(fixed: true)했을 때 마지막 데이터 행·열의 셀에서 드래그 선택이 되지 않고 오류가 발생하던 문제가 수정되었습니다.

값 셀

• 열 차원(또는 행 차원)이 하나도 없는 피벗에서 모든 값 셀이 총계 셀로 처리되던 문제가 수정되었습니다. 이제 반대 축을 기준으로 일반 값 셀 또는 소계 셀로 처리되며, 셀 스타일과 셀 오버레이 적용 대상, 셀 정보의 vt 값도 이에 맞게 바뀝니다.
• 값 필드 className에 공백으로 여러 클래스를 지정하거나 formatter가 반환한 className과 함께 지정하면 렌더링 중 오류가 발생하던 문제가 수정되었습니다.
• formatter가 반환하는 아이콘이 없어졌다가 다른 아이콘으로 바뀌면 이전 아이콘이 표시되던 문제가 수정되었습니다.

셀 오버레이

• 강조(highlight) 규칙의 updateOption()을 호출하면 "Not implemented" 예외가 발생하던 문제가 수정되었습니다.

const rule = control.table.fields.getValueField('판매수량').highlight.rules[0];
 
rule.updateOption('value', 1);

시리즈

• 스파크 렌더러(sparkbar · sparkline · sparkwinloss) 속성을 런타임에 변경할 때의 문제가 수정되었습니다.
  • type 없이 렌더러 속성만 지정하면 렌더러가 text로 바뀌던 문제
  • 렌더러 객체의 속성을 직접 변경하면 화면에 반영되지 않던 문제
  • sparkline의 lineColor·areaColor를 undefined로 지정해도 이전 색이 남던 문제. 이제 기본 색으로 돌아갑니다.

book.updateItem(series, { renderer: { barColor: '#ff0000' } }); // 기존 렌더러 유지
book.updateProp(series.renderer, 'barColor', '#ff0000');

상세 데이터 패널

• 상세 데이터 패널이 열린 상태에서 피벗 필드를 모두 제거하면 오류가 발생하던 문제가 수정되었습니다.

필터

• 인스펙터 Filters 탭의 타임라인 셀렉터에서 Years · Quarters · Days 버튼을 클릭해도 단위가 바뀌지 않던 문제가 수정되었습니다.
• 인스펙터 필터 패널에서 필터 셀렉터 제목 앞의 아이콘이 보이지 않던 문제가 수정되었습니다.

내보내기

• 연도처럼 숫자 값을 가진 차원이 행·열 헤더에 있을 때 CSV·PDF 내보내기에서 오류가 발생하던 문제가 수정되었습니다. 헤더 셀은 화면과 같은 레이블로 내보냅니다.

React · Vue

• RealPivotReact에 modules·cubes·tableOptions를 인라인 객체로 넘기면 부모 컴포넌트가 다시 렌더링될 때마다 피벗이 새로 만들어져 필터·필드 배치 등이 초기화되던 문제가 수정되었습니다.
• RealPivotVue에서 cubes 내용을 바꿔도 큐브 개수가 같으면 피벗에 반영되지 않던 문제가 수정되었습니다.