はじめに
SpreadJSのピボットテーブルは、項目スライサーとタイムラインスライサーの、2種類のスライサーをサポートします。
テーブルスライサーも同じように、ピボットスライサーもスライサーコレクションで管理されます。
SpreadJSでは、追加するスライサーのタイプを区別するために、SlicerTypeを定義しました。
項目スライサーは、任意のフィールド（計算フィールドを除く）に追加できます。
項目スライサーによる変更は、手動フィルターを使用した場合と同じで、ラベルフィルターの "textItems" を意味します。
タイムラインスライサーは、日付型フィールドにのみ追加できます。
タイムラインスライサーによる変更は、ラベル条件フィルターを使用した場合と同じで、ラベルフィルターの "condition" を意味します。
例えば、ピボットテーブルの項目スライサーを追加したい場合。
"pt" という名前のピボットテーブルを作成したと仮定します。
"name" フィールドに項目スライサーを追加したい場合。
また、ピボットテーブル "pt" に "birthday" という日付フィールドがあると仮定し、
ピボットテーブルのタイムラインスライサーを追加するとします。
次の疑問が出てくるかもしれません：
項目スライサーとタイムラインスライサーを、同時に日付フィールドに追加できることは明らかです。
これらのスライサーは同時に動作できるのか？
デフォルトでは、出来ません。
これらはlabelFilterを通して動作します。"textItems" フィルターを使用すると、"condition" フィルターが失われます。
この問題は、ピボットテーブルのallowMultipleFiltersPerFieldオプションで解決できます。
スライサー内の項目をクリックしてドラッグし、フィルタリングしてみてください。
クリックまたはドラッグするときに、ShiftキーとCtrlキー（Windowsの場合）／コマンドキー（Macの場合）を押してみることもできます。
シェイプに基づくスライサー
シェイプに基づくピボットスライサーにより、多くのシェイプAPIを使用してピボットスライサーを制御できます。
例として
ピボットテーブルへの接続
ピボットスライサーはピボットテーブルへの接続を管理して、接続の追加・切断を行います。
ピボットテーブルとの接続が切断すると、スライサーのフィルターアクションはピボットテーブルには影響しません。
また、ピボットテーブルのフィルターアクションもスライサーには影響しません。
例として、この機能を使うと、複数の同じソースのピボットテーブルを管理するためにスライサーを使用できます。
2つのピボットテーブル "pt1" と "pt2" があると仮定すると、どちらも "table1" という名前のテーブルから作成されているので、同じデータソース、同じフィールドを持っています。
これで、slicer_nameを使用して、2つのピボットテーブルのフィルターを制御できます。
import { Component, NgModule, enableProdMode } from '@angular/core';
import { bootstrapApplication, BrowserModule } from '@angular/platform-browser';
import { FormsModule } from '@angular/forms';
import { platformBrowserDynamic } from '@angular/platform-browser-dynamic';
import { SpreadSheetsModule } from '@mescius/spread-sheets-angular';
import GC from '@mescius/spread-sheets';
import "@mescius/spread-sheets-shapes";
import "@mescius/spread-sheets-slicers";
import "@mescius/spread-sheets-pivot-addon";
import '@mescius/spread-sheets-resources-ja';
GC.Spread.Common.CultureManager.culture("ja-jp");
import './styles.css';
@Component({
standalone: true,
imports: [SpreadSheetsModule, BrowserModule, FormsModule],
selector: 'app-component',
templateUrl: 'src/app.component.html'
})
export class AppComponent {
hostStyle = {
width: 'calc(100% - 330px)',
height: '100%',
overflow: 'hidden',
float: 'left'
};
name: string;
captionName: string;
x: number;
y: number;
width: number;
height: number;
connectPT1: boolean;
connectPT2: boolean;
activeSlicer: any;
sheet: GC.Spread.Sheets.Worksheet;
slicerCount = 0;
constructor() {
}
initSpread($event: any) {
let spread = $event.spread;
this.initSheets(spread);
let pivotLayoutSheet = spread.getSheet(0);
this.initPivotTable(pivotLayoutSheet);
this.initSlicer(pivotLayoutSheet);
this.bindEvents();
}
initSheets (spread: GC.Spread.Sheets.Workbook) {
spread.suspendPaint();
spread.setSheetCount(2);
let sheet = spread.getSheet(1);
sheet.name("DataSource");
sheet.setRowCount(650);
sheet.setColumnWidth(5, 120);
sheet.getCell(-1, 5).formatter("YYYY-mm-DD");
sheet.getRange(-1,4,0,1).formatter("$ #,##0");
sheet.setArray(0, 0, pivotSales);
let table = sheet.tables.add('tableSales', 0, 0, 637, 6);
table.style(GC.Spread.Sheets.Tables.TableThemes["none"]);
let sheet0 = spread.getSheet(0);
sheet0.name("PivotLayout");
sheet0.setValue(0, 0, "Pivot Table 1");
sheet0.setValue(0, 10, "Pivot Table 2");
spread.resumePaint();
this.sheet = sheet0;
}
initPivotTable(sheet: GC.Spread.Sheets.Worksheet) {
let groupInfo = { originFieldName: "date", dateGroups: [{ by: GC.Pivot.DateGroupType.quarters }, {by: GC.Pivot.DateGroupType.years}, {by: GC.Pivot.DateGroupType.months}] };
let pt1 = sheet.pivotTables.add("pt1", "tableSales", 1, 0, GC.Spread.Pivot.PivotTableLayoutType.outline, GC.Spread.Pivot.PivotTableThemes.light8);
pt1.suspendLayout();
pt1.options.showRowHeader = true;
pt1.options.showColumnHeader = true;
pt1.options.subtotalsPosition = GC.Spread.Pivot.SubtotalsPosition.top;
pt1.layoutType(GC.Spread.Pivot.PivotTableLayoutType.compact);
pt1.add("region", "region", GC.Spread.Pivot.PivotTableFieldType.rowField);
pt1.add("country", "country", GC.Spread.Pivot.PivotTableFieldType.rowField);
pt1.add("city", "city", GC.Spread.Pivot.PivotTableFieldType.rowField);
pt1.add("amount", "amounts", GC.Spread.Pivot.PivotTableFieldType.valueField, GC.Pivot.SubtotalType.sum);
pt1.resumeLayout();
pt1.autoFitColumn();
let pt2 = sheet.pivotTables.add("pt2", "tableSales", 1, 10, GC.Spread.Pivot.PivotTableLayoutType.outline, GC.Spread.Pivot.PivotTableThemes.medium23);
pt2.suspendLayout();
pt2.options.showRowHeader = true;
pt2.options.showColumnHeader = true;
pt2.options.subtotalsPosition = GC.Spread.Pivot.SubtotalsPosition.top;
pt2.layoutType(GC.Spread.Pivot.PivotTableLayoutType.compact);
pt2.group(groupInfo);
pt2.add("年 (date)", "年 (date)", GC.Spread.Pivot.PivotTableFieldType.rowField);
pt2.add("四半期 (date)", "四半期 (date)", GC.Spread.Pivot.PivotTableFieldType.rowField);
pt2.add("月 (date)", "月 (date)", GC.Spread.Pivot.PivotTableFieldType.rowField);
pt2.add("amount", "Amounts", GC.Spread.Pivot.PivotTableFieldType.valueField, GC.Pivot.SubtotalType.sum);
pt2.resumeLayout();
pt2.autoFitColumn();
}
initSlicer (sheet: GC.Spread.Sheets.Worksheet) {
sheet.suspendPaint();
let yearSlicer = sheet.slicers.add("Years", 'pt2', "date", GC.Spread.Sheets.Slicers.TimelineStyles.light5(), GC.Spread.Sheets.Slicers.SlicerType.pivotTimeline);
let monthSlicer = sheet.slicers.add("Months", 'pt2', "date", GC.Spread.Sheets.Slicers.TimelineStyles.light1(), GC.Spread.Sheets.Slicers.SlicerType.pivotTimeline);
this.setTimelineProp(yearSlicer, 967, 20, 310, 160, 1, "年");
this.setTimelineProp(monthSlicer, 967, 160, 310, 160, 3, "月");
let regionSlicer = sheet.slicers.add("region", 'pt1', "region", GC.Spread.Sheets.Slicers.SlicerStyles.dark1(), GC.Spread.Sheets.Slicers.SlicerType.pivotTable);
let countrySlicer = sheet.slicers.add("country", 'pt1', "country", GC.Spread.Sheets.Slicers.SlicerStyles.dark2(), GC.Spread.Sheets.Slicers.SlicerType.pivotTable);
let citySlicer = sheet.slicers.add("city", 'pt1', "city", GC.Spread.Sheets.Slicers.SlicerStyles.dark3(), GC.Spread.Sheets.Slicers.SlicerType.pivotTable);
this.setSlicerProp(regionSlicer, 285, 20, 140, 200, 1, true, true);
this.setSlicerProp(countrySlicer, 425, 20, 140, 200, 1, true, true);
this.setSlicerProp(citySlicer, 565, 20, 140, 200, 1, true, true);
sheet.resumePaint();
}
setSlicerProp(slicer: GC.Spread.Sheets.Slicers.ISlicer, x: number, y: number, width: number, height: number, columnCount: number, showHeader: boolean, showNoDataItemsInLast: boolean) {
slicer.position({x, y});
slicer.width(width);
slicer.height(height);
if (columnCount) {
slicer.columnCount(columnCount);
}
slicer.showHeader(!!showHeader);
slicer.showNoDataItemsInLast(!!showNoDataItemsInLast);
slicer.allowMove(false);
slicer.allowResize(false);
}
setTimelineProp (timeline, x, y, width, height, level, caption) {
timeline.position({x, y});
timeline.width(width);
timeline.height(height);
timeline.level(level);
timeline.captionName(caption);
timeline.allowMove(false);
timeline.allowResize(false);
}
bindEvents() {
let self = this;
let sheet = this.sheet as any;
sheet.bind(GC.Spread.Sheets.Events.SlicerChanged, function () {
let slicers = sheet.slicers.all();
for (let i = 0; i < slicers.length; i++) {
if (slicers[i].isSelected()) {
self.activeSlicer = slicers[i];
self.updateSlicerInfo();
break;
}
}
});
}
changeProperty(prop: string, v?: any) {
if (!this.activeSlicer) {
return;
}
v = v || this[prop];
if (v !== null && v !== undefined && v !== '') {
this.activeSlicer[prop](v);
}
}
updateSlicerInfo() {
if (!this.activeSlicer) {
return;
}
let slicer = this.activeSlicer;
this.name = slicer.name();
this.captionName = slicer.captionName();
this.x = slicer.x();
this.y = slicer.y();
this.width = slicer.width();
this.height = slicer.height();
this.connectPT1 = slicer.isConnectedPivotTable('pt1');
this.connectPT2 = slicer.isConnectedPivotTable('pt2');
}
changeConnection (id: number) {
let connect = id === 1 ? this.connectPT1 : this.connectPT2;
let ptName = id === 1 ? 'pt1' : 'pt2';
let slicer = this.activeSlicer;
if(slicer) {
if (connect) {
slicer.connectPivotTable(ptName);
} else {
slicer.disconnectPivotTable(ptName);
}
}
}
}
enableProdMode();
bootstrapApplication(AppComponent);
<!doctype html>
<html style="height:100%;font-size:14px;">
<head>
<meta charset="utf-8" />
<meta name="viewport" content="width=device-width, initial-scale=1.0" />
<link rel="stylesheet" type="text/css" href="$DEMOROOT$/ja/angular/node_modules/@mescius/spread-sheets/styles/gc.spread.sheets.excel2013white.css">
<script src="$DEMOROOT$/spread/source/data/pivotSales.js" type="text/javascript"></script>
<!-- Polyfills -->
<script src="$DEMOROOT$/ja/angular/node_modules/core-js/client/shim.min.js"></script>
<script src="$DEMOROOT$/ja/angular/node_modules/zone.js/fesm2015/zone.min.js"></script>
<!-- SystemJS -->
<script src="$DEMOROOT$/ja/angular/node_modules/systemjs/dist/system.js"></script>
<script src="systemjs.config.js"></script>
<script>
// workaround to load 'rxjs/operators' from the rxjs bundle
System.import('rxjs').then(function (m) {
System.import('@angular/compiler');
System.set(SystemJS.resolveSync('rxjs/operators'), System.newModule(m.operators));
System.import('$DEMOROOT$/ja/lib/angular/license.ts');
System.import('./src/app.component');
});
</script>
</head>
<body>
<app-component></app-component>
</body>
</html>
<div class="sample-tutorial">
<gc-spread-sheets [hostStyle]="hostStyle" (workbookInitialized)="initSpread($event)">
</gc-spread-sheets>
<div class="options-container">
<div class="block slicer-infos">
<div>現在選択しているスライサーの情報：</div><br>
<div class="slicer-info">
<label class="info-label">スライサー名：</label>
<input class="info-input" id="name" [(ngModel)]="name" (change)="changeProperty('name')"/>
</div>
<div class="slicer-info">
<label class="info-label">キャプション名：</label>
<input class="info-input" id="captionName" [(ngModel)]="captionName" (change)="changeProperty('captionName')"/>
</div>
<div class="slicer-info">
<label class="info-label">X: </label>
<input type="number" class="info-input" name="x" id="x" min="0" max="1000" step="1" [(ngModel)]="x" (change)="changeProperty('x')"/>
</div>
<div class="slicer-info">
<label class="info-label">Y: </label>
<input type="number" class="info-input" name="y" id="y" min="0" max="1000" step="1" [(ngModel)]="y" (change)="changeProperty('y')"/>
</div>
<div class="slicer-info">
<label class="info-label">幅：</label>
<input type="number" class="info-input" name="width" id="width" min="0" max="1000" step="1" [(ngModel)]="width" (change)="changeProperty('width')"/>
</div>
<div class="slicer-info">
<label class="info-label">高さ：</label>
<input type="number" class="info-input" name="height" id="height" min="0" max="1000" step="1" [(ngModel)]="height" (change)="changeProperty('height')"/>
</div>
</div>
<div class="block">
<div>スライサー接続</div><br/>
<div class="Connection">
<div class="slicer-info">
<input type="checkbox" id="pt1" [(ngModel)]="connectPT1" (change)="changeConnection(1)"/>
<label for="pt1">ピボットテーブル1に接続する</label>
</div>
<div class="slicer-info">
<input type="checkbox" id="pt2" [(ngModel)]="connectPT2" (change)="changeConnection(2)"/>
<label for="pt2">ピボットテーブル2に接続する</label>
</div>
</div>
</div>
</div>
</div>
.sample-tutorial {
position: relative;
height: 100%;
overflow: hidden;
}
.sample-spreadsheets {
width: calc(100% - 330px);
height: 100%;
overflow: hidden;
float: left;
}
.options-container {
float: right;
width: 330px;
padding: 12px;
height: 100%;
box-sizing: border-box;
background: #fbfbfb;
overflow: auto;
}
body {
position: absolute;
top: 0;
bottom: 0;
left: 0;
right: 0;
}
.slicer-info {
margin-top: 5px;
margin-bottom: 5px;
}
.block {
border: 1px solid gray;
padding-left: 5px;
padding-top: 10px;
padding-bottom: 10px;
margin-bottom: 1px;
}
.info-label {
width: 35%;
display: inline-block;
}
.info-input {
width: 58%;
display: inline-block;
}
(function (global) {
System.config({
transpiler: 'ts',
typescriptOptions: {
tsconfig: true
},
meta: {
'typescript': {
"exports": "ts"
},
'*.css': { loader: 'css' }
},
paths: {
// paths serve as alias
'npm:': 'node_modules/'
},
// map tells the System loader where to look for things
map: {
'core-js': 'npm:core-js/client/shim.min.js',
'zone': 'npm:zone.js/fesm2015/zone.min.js',
'rxjs': 'npm:rxjs/dist/bundles/rxjs.umd.min.js',
'@angular/core': 'npm:@angular/core/fesm2022',
'@angular/common': 'npm:@angular/common/fesm2022/common.mjs',
'@angular/compiler': 'npm:@angular/compiler/fesm2022/compiler.mjs',
'@angular/platform-browser': 'npm:@angular/platform-browser/fesm2022/platform-browser.mjs',
'@angular/platform-browser-dynamic': 'npm:@angular/platform-browser-dynamic/fesm2022/platform-browser-dynamic.mjs',
'@angular/common/http': 'npm:@angular/common/fesm2022/http.mjs',
'@angular/router': 'npm:@angular/router/fesm2022/router.mjs',
'@angular/forms': 'npm:@angular/forms/fesm2022/forms.mjs',
'jszip': 'npm:jszip/dist/jszip.min.js',
'typescript': 'npm:typescript/lib/typescript.js',
'ts': './plugin.js',
'css': 'npm:systemjs-plugin-css/css.js',
'plugin-babel': 'npm:systemjs-plugin-babel/plugin-babel.js',
'systemjs-babel-build':'npm:systemjs-plugin-babel/systemjs-babel-browser.js',
'tslib':'npm:tslib/tslib.js',
'@mescius/spread-sheets': 'npm:@mescius/spread-sheets/index.js',
'@mescius/spread-sheets-shapes': 'npm:@mescius/spread-sheets-shapes/index.js',
'@mescius/spread-sheets-slicers': 'npm:@mescius/spread-sheets-slicers/index.js',
'@mescius/spread-sheets-resources-ja': 'npm:@mescius/spread-sheets-resources-ja/index.js',
'@mescius/spread-sheets-pivot-addon': 'npm:@mescius/spread-sheets-pivot-addon/index.js',
'@mescius/spread-sheets-angular': 'npm:@mescius/spread-sheets-angular/fesm2020/mescius-spread-sheets-angular.mjs',
'@grapecity/jsob-test-dependency-package/react-components': 'npm:@grapecity/jsob-test-dependency-package/react-components/index.js'
},
// packages tells the System loader how to load when no filename and/or no extension
packages: {
src: {
defaultExtension: 'ts',
meta: {
"*.component.ts": {
loader: "system.component-loader.js"
}
}
},
rxjs: {
defaultExtension: 'js'
},
"node_modules": {
defaultExtension: 'js'
},
"node_modules/@angular": {
defaultExtension: 'mjs'
},
"@mescius/spread-sheets-angular": {
defaultExtension: 'mjs'
},
'@angular/core': {
defaultExtension: 'mjs',
main: 'core.mjs'
}
}
});
})(this);
