概要と基本的な使い方

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

スライサーはテーブルに付随する機能です。このため、スライサーの使用にあたっては初めにテーブルを作成する必要があります。 addメソッドでスライサーを追加できます。次に、例を示します: スライサーはスライサーヘッダとスライサーボディから構成されています。 スライサーヘッダは、スライサーキャプション、マルチセレクト、および フィルターのクリアボタンで構成されています。スライサーキャプションは、キャプションを表示するために使用されます。フィルターのクリアボタンは、スライサーのフィルタリングを解除するために使用され、デフォルトでは無効になっています。このボタンは、スライサーのアイテムがフィルタリングされているときのみ有効になります。 スライサーボディはスライサー項目で構成されています。スライサー項目は以下の4種類があります: データなし項目: 別のスライサーによってフィルタアウトされた項目 データあり項目: 別のスライサーによってフィルタアウトされていない項目 選択項目: スライサーによってフィルタアウトされた項目 未選択項目: スライサーによってフィルタアウトされていない項目 別のスライサーによってフィルタアウトされた項目はデータなし項目、データあり項目と表現されます。スライサーによってフィルタリングされた項目は選択項目、未選択項目と表現されます。
<template> <div class="sample-tutorial"> <gc-spread-sheets class="sample-spreadsheets" @workbookInitialized="initSpread"> </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" v-model="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" v-model="captionName" @change="updateCaptionName" /> </div> <div class="option-row"> <input type="checkbox" id="show_header" :disabled="disableCaptionName" v-model="showHeader" @change="updateShowHeader" /> <label for="show_header">ShowHeader</label> </div> <div class="option-row"> <input type="checkbox" id="show_nodata_items" :disabled="disableCaptionName" checked v-model="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" v-model="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" v-model="visuallyNoDataItems" @change="updateVisuallyNoDataItems" /> <label for="visually_nodata_items">VisuallyNoDataItems</label> </div> </div> </div> </template> <script setup> import '@mescius/spread-sheets-vue'; import '@mescius/spread-sheets-slicers'; import { ref } from "vue"; import GC from '@mescius/spread-sheets'; import '@mescius/spread-sheets-resources-ja'; GC.Spread.Common.CultureManager.culture("ja-jp"); const spreadRef = ref(null); const name = ref(''); const captionName = ref(''); const showHeader = ref(true); const showNoDataItems = ref(true); const showNoDataItemsInLast = ref(false); const visuallyNoDataItems = ref(true); const disableName = ref(true); const disableCaptionName = ref(true); const selectedSlicersList = ref([]); const GCsheets = GC.Spread.Sheets; const getSelectedSlicers = (sheet) => { 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) => { for (let name in obj) { return false; } return true; } const updateName = () => { if (!name.value) { return; } selectedSlicersList.value.forEach((slicer) => { slicer.name(name.value); }) } const updateCaptionName = () => { selectedSlicersList.value.forEach((slicer) => { slicer.captionName(captionName.value); }) } const updateShowHeader = () => { selectedSlicersList.value.forEach((slicer) => { slicer.showHeader(showHeader.value); }) } const updateShowNoDataItems = () => { selectedSlicersList.value.forEach((slicer) => { slicer.showNoDataItems(showNoDataItems.value); }) } const updateShowNoDataItemsInLast = () => { selectedSlicersList.value.forEach((slicer) => { slicer.showNoDataItemsInLast(showNoDataItemsInLast.value); }) } const updateVisuallyNoDataItems = () => { selectedSlicersList.value.forEach((slicer) => { slicer.visuallyNoDataItems(visuallyNoDataItems.value); }) } const initSpread = (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(); bindEvent(spread); table.getSlicerData().doFilter("City", { exclusiveRowIndexes: [0] }); } const bindEvent = (spread) => { spread.bind(GC.Spread.Sheets.Events.SlicerChanged, function (event, args) { let sheet = args.sheet; let slicer = args.slicer; if (!slicer) { return; } let propertyName = args.propertyName; if (propertyName === "isSelected") { if (slicer.isSelected()) { disableCaptionName.value = false; selectedSlicersList.value = getSelectedSlicers(sheet); if (selectedSlicersList.value && selectedSlicersList.value.length > 1) { disableName.value = true; name.value = ''; captionName.value = ''; showHeader.value = false; showNoDataItems.value = false; showNoDataItemsInLast.value = false; visuallyNoDataItems.value = false; } else if (selectedSlicersList.value.length === 1) { disableName.value = false; name.value = slicer.name(); captionName.value = slicer.captionName(); showHeader.value = slicer.showHeader(); showNoDataItems.value = slicer.showNoDataItems(); showNoDataItemsInLast.value = slicer.showNoDataItemsInLast(); visuallyNoDataItems.value = slicer.visuallyNoDataItems(); } } else { disableName.value = true; disableCaptionName.value = true; } } }); } </script> <style scoped> #app { height: 100%; } .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; } </style>
<!DOCTYPE html> <html lang="en" style="height:100%;font-size:14px;"> <head> <meta charset="utf-8" /> <meta http-equiv="X-UA-Compatible" content="IE=edge" /> <title>SpreadJS VUE</title> <meta name="viewport" content="width=device-width, initial-scale=1.0" /> <link rel="stylesheet" type="text/css" href="$DEMOROOT$/ja/vue3/node_modules/@mescius/spread-sheets/styles/gc.spread.sheets.excel2013white.css"> <script src="$DEMOROOT$/ja/vue3/node_modules/systemjs/dist/system.src.js"></script> <script src="./systemjs.config.js"></script> <script src="./compiler.js" type="module"></script> <script> var System = SystemJS; System.import("./src/app.js"); System.import('$DEMOROOT$/ja/lib/vue3/license.js'); </script> </head> <body> <div id="app"></div> </body> </html>
(function (global) { SystemJS.config({ transpiler: 'plugin-babel', babelOptions: { es2015: true }, paths: { // paths serve as alias 'npm:': 'node_modules/' }, packageConfigPaths: [ './node_modules/*/package.json', "./node_modules/@mescius/*/package.json", "./node_modules/@babel/*/package.json", "./node_modules/@vue/*/package.json" ], map: { 'vue': "npm:vue/dist/vue.esm-browser.js", 'tiny-emitter': 'npm:tiny-emitter/index.js', 'plugin-babel': 'npm:systemjs-plugin-babel/plugin-babel.js', "systemjs-babel-build": "npm:systemjs-plugin-babel/systemjs-babel-browser.js", '@mescius/spread-sheets': 'npm:@mescius/spread-sheets/index.js', '@mescius/spread-sheets-resources-ja': 'npm:@mescius/spread-sheets-resources-ja/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-vue': 'npm:@mescius/spread-sheets-vue/index.js', '@grapecity/jsob-test-dependency-package/react-components': 'npm:@grapecity/jsob-test-dependency-package/react-components/index.js', }, meta: { '*.css': { loader: 'systemjs-plugin-css' }, '*.vue': { loader: "../plugin-vue/index.js" } } }); })(this);