概要と基本的な使い方

フィルターと同様に、Excelライクなスライサーは、スプレッドシートのデータをフィルタリングする、直感的で視覚的な方法を提供します。スライサーは、現在のフィルターされた状態もまた、視覚的に表示します。

スライサーはテーブルに付随する機能です。このため、スライサーの使用にあたっては初めにテーブルを作成する必要があります。 addメソッドでスライサーを追加できます。次に、例を示します: スライサーはスライサーヘッダとスライサーボディから構成されています。 スライサーヘッダは、スライサーキャプション、マルチセレクト、および フィルターのクリアボタンで構成されています。スライサーキャプションは、キャプションを表示するために使用されます。フィルターのクリアボタンは、スライサーのフィルタリングを解除するために使用され、デフォルトでは無効になっています。このボタンは、スライサーのアイテムがフィルタリングされているときのみ有効になります。 スライサーボディはスライサー項目で構成されています。スライサー項目は以下の4種類があります: データなし項目: 別のスライサーによってフィルタアウトされた項目 データあり項目: 別のスライサーによってフィルタアウトされていない項目 選択項目: スライサーによってフィルタアウトされた項目 未選択項目: スライサーによってフィルタアウトされていない項目 別のスライサーによってフィルタアウトされた項目はデータなし項目、データあり項目と表現されます。スライサーによってフィルタリングされた項目は選択項目、未選択項目と表現されます。
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-resources-ja'; GC.Spread.Common.CultureManager.culture("ja-jp"); import "@mescius/spread-sheets-shapes"; import "@mescius/spread-sheets-slicers"; import './styles.css'; const getSelectedSlicers = (sheet: GC.Spread.Sheets.Worksheet) => { if (!sheet) { return null; } let slicers = sheet.slicers.all(); if (!slicers || _isEmptyObject(slicers)) { return null; } let selectedSlicersList = []; for (let item in slicers) { let slicer = slicers[item]; if (slicer.isSelected()) { selectedSlicersList.push(slicer); } } return selectedSlicersList; } const _isEmptyObject = (obj: object) => { for (let name in obj) { return false; } return true; } @Component({ standalone: true, imports: [SpreadSheetsModule, BrowserModule, FormsModule], selector: 'app-component', templateUrl: 'src/app.component.html' }) export class AppComponent { spread: GC.Spread.Sheets.Workbook; name = ''; captionName = ''; showHeader = true; showNoDataItems = true; showNoDataItemsInLast = false; visuallyNoDataItems = true; disableName = true; disableCaptionName = true; selectedSlicersList: any[] = []; hostStyle = { width: 'calc(100% - 280px)', height: '100%', overflow: 'hidden', float: 'left' }; updateName() { if (!this.name) { return; } this.selectedSlicersList.forEach((slicer) => { slicer.name(this.name); }) } updateCaptionName() { this.selectedSlicersList.forEach((slicer) => { slicer.captionName(this.captionName); }) } updateShowHeader() { this.selectedSlicersList.forEach((slicer) => { slicer.showHeader(this.showHeader); }) } updateShowNoDataItems() { this.selectedSlicersList.forEach((slicer) => { slicer.showNoDataItems(this.showNoDataItems); }) } updateShowNoDataItemsInLast() { this.selectedSlicersList.forEach((slicer) => { slicer.showNoDataItemsInLast(this.showNoDataItemsInLast); }) } updateVisuallyNoDataItems() { this.selectedSlicersList.forEach((slicer) => { slicer.visuallyNoDataItems(this.visuallyNoDataItems); }) } initSpread($event: any) { let spread = this.spread = $event.spread; spread.suspendPaint(); let sheet = spread.getActiveSheet(); let dataColumns = ["Name", "City", "Birthday", "Sex", "Weight", "Height"]; let data = [ ["Bob", "NewYork", "1968/6/8", "man", "80", "180"], ["Betty", "NewYork", "1972/7/3", "woman", "72", "168"], ["Cherry", "Washington", "1986/2/2", "woman", "58", "161"], ["Gary", "NewYork", "1964/3/2", "man", "71", "179"], ["Hunk", "Washington", "1972/8/8", "man", "80", "171"], ["Eva", "Washington", "1993/2/15", "woman", "71", "180"] ]; sheet.tables.addFromDataSource("table1", 1, 1, data); sheet.getRange(-1, 1, -1, 6).width(80); let table = sheet.tables.findByName("table1"); table.setColumnName(0, dataColumns[0]); table.setColumnName(1, dataColumns[1]); table.setColumnName(2, dataColumns[2]); table.setColumnName(3, dataColumns[3]); table.setColumnName(4, dataColumns[4]); table.setColumnName(5, dataColumns[5]); let slicer1 = sheet.slicers.add("slicer1", "table1", "Name"); slicer1.position(new GC.Spread.Sheets.Point(10, 170)); // show data items in original position slicer1.showNoDataItemsInLast(false); let slicer2 = sheet.slicers.add("slicer2", "table1", "City"); slicer2.position(new GC.Spread.Sheets.Point(220, 170)); let slicer3 = sheet.slicers.add("slicer3", "table1", "Height"); slicer3.position(new GC.Spread.Sheets.Point(430, 170)); // do not show filtered out items slicer3.showNoDataItems(false); spread.resumePaint(); this.bindEvent(spread); table.getSlicerData().doFilter("City", {exclusiveRowIndexes: [0]}); } bindEvent(spread: GC.Spread.Sheets.Workbook) { let self = this; spread.bind(GC.Spread.Sheets.Events.SlicerChanged, function(event: any, args: any) { let sheet = args.sheet; let slicer = args.slicer; if (!slicer) { return; } let propertyName = args.propertyName; if (propertyName === "isSelected") { if (slicer.isSelected()) { self.disableCaptionName = false; self.selectedSlicersList = getSelectedSlicers(sheet); if (self.selectedSlicersList && self.selectedSlicersList.length > 1) { self.disableName = true; self.name = ''; self.captionName = ''; self.showHeader = false; self.showNoDataItems = false; self.showNoDataItemsInLast = false; self.visuallyNoDataItems = false; } else if (self.selectedSlicersList.length === 1) { self.disableName = false; self.name = slicer.name(); self.captionName = slicer.captionName(); self.showHeader = slicer.showHeader(); self.showNoDataItems = slicer.showNoDataItems(); self.showNoDataItemsInLast = slicer.showNoDataItemsInLast(); self.visuallyNoDataItems = slicer.visuallyNoDataItems(); } } else { self.disableName = true; self.disableCaptionName = true; } } }); } } 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"> <!-- 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"> <p style="padding:2px 10px; background-color:#F4F8EB">スライサーを選択して、オプションを変更します。</p> <div class="option-row"> <label for="slicer_name" style="display: inline-block;width: 150px">名前:</label> <input type="text" id="slicer_name" [disabled]="disableName" [(ngModel)]="name" (change)="updateName()" /> </div> <div class="option-row"> <label for="slicer_caption_name" style="display: inline-block;width: 150px">キャプション名:</label> <input type="text" id="slicer_caption_name" [disabled]="disableCaptionName" [(ngModel)]="captionName" (change)="updateCaptionName()" /> </div> <div class="option-row"> <input type="checkbox" id="show_header" [disabled]="disableCaptionName" [(ngModel)]="showHeader" (change)="updateShowHeader()"/> <label for="show_header">ShowHeader</label> </div> <div class="option-row"> <input type="checkbox" id="show_nodata_items" [disabled]="disableCaptionName" [(ngModel)]="showNoDataItems" (change)="updateShowNoDataItems()" /> <label for="show_nodata_items">ShowNoDataItems</label> </div> <div class="option-row"> <p class="desc">以下のチェックボックスをチェックすると、スライサーの最後に、フィルタされていない項目が表示されます。</p> <input type="checkbox" id="show_nodata_items_last" [disabled]="disableCaptionName" [(ngModel)]="showNoDataItemsInLast" (change)="updateShowNoDataItemsInLast()" /> <label for="show_nodata_items_last">ShowNoDataItemsInLast</label> <p style="padding:2px 10px; background-color:#F4F8EB">以下のチェックボックスをチェックすると、テーブル内に表示されていない項目を淡色で表示します。</p> <input type="checkbox" id="visually_nodata_items" [disabled]="disableCaptionName" [(ngModel)]="visuallyNoDataItems" (change)="updateVisuallyNoDataItems()" /> <label for="visually_nodata_items">VisuallyNoDataItems</label> </div> </div> </div>
.sample-tutorial { position: relative; height: 100%; overflow: hidden; } .sample-spreadsheets { width: calc(100% - 280px); height: 100%; overflow: auto; float: left; } .options-container { float: right; width: 280px; padding: 12px; height: 100%; box-sizing: border-box; background: #fbfbfb; overflow: auto; } .option-group { margin-bottom: 6px; } label { display: inline-block; min-width: 90px; margin: 6px 0; } input { padding: 4px 6px; box-sizing: border-box; margin-bottom: 6px; } hr { border-color: #fff; opacity: .2; margin: 12px 0; } p { padding: 2px 10px; background-color: #F4F8EB; } body { position: absolute; top: 0; bottom: 0; left: 0; right: 0; }
(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-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);