シート上の特定領域を選択するには、1つのセルをクリックして、マウスでドラッグします。これで、選択領域が作成されます。
選択領域の境界線の色および背景色を変更するには、次のコードに示すように、selectionBorderColorおよびselectionBackColorオプションを使用します。
ユーザーが選択可能なアイテムを設定するには、selectionPolicyおよびselectionUnitオプションを使用します。SelectionPolicyには、以下のタイプがあります。
single: 1つの項目のみを選択できます。
range: 1つの項目と項目の範囲を選択できますが、複数の範囲は選択できません。
multiRange: 1つの項目と項目の範囲を選択でき、複数の範囲も選択できます。
SelectionUnitには、以下のタイプがあります。
cell: 選択できる最小単位がセルであることを示します。
row: 選択できる最小単位が行であることを示します。
column: 選択できる最小単位が列であることを示します。
これらの2つのメソッドにより、選択モードを制御することができます。
複数の領域を選択するには、［Ctrl］キーを押しながら必要な領域を選択します。また、addSelectionメソッドを使用しても、選択領域を追加できます。すべての選択領域を取得するには、getSelectionsメソッドを使用します。選択領域をクリアするには、clearSelectionメソッドを使用します。次のコードは、これらのメソッドの用法を示します。
ワークブックのallowUserDeselectオプションを使用すると、ユーザーに対し、現在の選択領域をマウスで選択解除できるようにするかどうかを定義できます。
セルをマウスで選択するだけでなく、setSelectionメソッドを使用して複数のセルを選択することも、setActiveCellメソッドを使用して1つのセルを選択することもできます。アクティブセルは、選択領域内の先頭セルです。アクティブセルの行および列インデックスを取得するには、次のコードに示すように、getActiveRowIndexおよびgetActiveColumnIndexメソッドを使用します。
アクティブセルを設定したにもかかわらず、このセルが表示されていない場合は、showCell、showRow、およびshowColumnの各メソッドを使用して、アクティブセルを表示できます。
<template>
<div class="sample-tutorial">
<gc-spread-sheets class="sample-spreadsheets" @workbookInitialized="initSpread">
<gc-worksheet></gc-worksheet>
</gc-spread-sheets>
<div class="options-container">
<div class="options-row">
以下のオプションを設定して、選択処理がどのように変更されるかご確認ください。
</div>
<div class="options-row">
<label for="selectionPolicy">選択ポリシー：</label>
<select name="selectionPolicy" id="selectionPolicy" v-model="selectionPolicy">
<option v-for="item of selectionPolicyOptions" :value="item.value">{{ item.text }}</option>
</select>
</div>
<div class="options-row">
<label for="selectionUnit">選択単位：</label>
<select name="selectionUnit" id="selectionUnit" v-model="selectionUnit">
<option v-for="item of selectionUnitOptions" :value="item.value">{{ item.text }}</option>
</select>
</div>
<div class="options-row">
<input type="checkbox" id="checkAllowDeselect" v-model="allowDeselect">
<label for="checkAllowDeselect" style="display:inline-block">ユーザーに選択解除を許可</label>
</div>
<div class="options-row">
<label for="backColor">選択領域の背景色：</label>
<input type="text" id="backColor" v-model="backColor">
<input type="button" value="設定" @click="setSelectionBackColor()">
</div>
<div class="options-row">
<label for="borderColor">選択領域の枠線の色：</label>
<input type="text" id="borderColor" v-model="borderColor">
<input type="button" value="設定" @click="setSelectionBorderColor()">
</div>
<div class="options-row">
<input type="button" value="TabStopを有効にする" @click="setIsTabStop(true)">
</div>
<div class="options-row">
<input type="button" value="TabStopを無効にする" @click="setIsTabStop(false)">
</div>
<div class="options-row" style="padding-top: 10px">
<label>ユーザーが［Tab］キーを使用して選択領域にフォーカスを設定できるかどうかを指定します。</label>
</div>
</div>
</div>
</template>
<script setup>
import { ref, watch } from "vue";
import "@mescius/spread-sheets-vue";
import GC from '@mescius/spread-sheets';
import '@mescius/spread-sheets-resources-ja';
GC.Spread.Common.CultureManager.culture("ja-jp");
import "./dataset.js";
const spreadRef = ref(null);
const selectionPolicyOptions = ref([
{
value: 0,
text: "Single"
}, {
value: 1,
text: "Range"
}, {
value: 2,
text: "MultiRange"
}
]);
const selectionUnitOptions = ref([{
value: 0,
text: "Cell"
}, {
value: 1,
text: "Row"
}, {
value: 2,
text: "Column"
}]);
const selectionPolicy = ref("2");
const selectionUnit = ref("0");
const allowDeselect = ref(true);
const backColor = ref("rgba(204,255,51, 0.3)");
const borderColor = ref("Accent 3 -40");
watch(selectionPolicy, (value) => {
let spread = spreadRef.value;
let sheet = spread.getActiveSheet();
let policy = parseInt(value, 10);
sheet.selectionPolicy(policy);
});
watch(selectionUnit, (value) => {
let spread = spreadRef.value;
let sheet = spread.getActiveSheet();
let policy = parseInt(value, 10);
sheet.selectionUnit(policy);
});
watch(allowDeselect, (value) => {
let spread = spreadRef.value;
spread.options.allowUserDeselect = value;
});
let initSpread = function (spread) {
spreadRef.value = spread;
spread.fromJSON(data[0]);
}
function setSelectionBackColor() {
let spread = spreadRef.value;
let sheet = spread.getActiveSheet();
sheet.options.selectionBackColor = backColor.value;
}
function setSelectionBorderColor() {
let spread = spreadRef.value;
let sheet = spread.getActiveSheet();
sheet.options.selectionBorderColor = borderColor.value;
}
function setIsTabStop(isTabStop) {
let spread = spreadRef.value;
let sheet = spread.getActiveSheet();
sheet.suspendPaint();
let sels = sheet.getSelections();
for (let index = 0; index < sels.length; index++) {
let selRange = sels[index];
if (selRange.col >= 0 && selRange.row >= 0) {
sheet.getRange(selRange.row, selRange.col, selRange.rowCount, selRange.colCount).tabStop(isTabStop);
} else if (selRange.row >= 0) {
sheet.getRange(selRange.row, -1, selRange.rowCount, -1).tabStop(isTabStop);
} else if (selRange.col >= 0) {
sheet.getRange(-1, selRange.col, -1, selRange.colCount).tabStop(isTabStop);
}
}
sheet.resumePaint();
}
</script>
<style scoped>
#app {
height: 100%;
}
.sample-tutorial {
position: relative;
height: 100%;
overflow: hidden;
}
.sample-spreadsheets {
width: calc(100% - 280px);
height: 100%;
overflow: hidden;
float: left;
}
.options-container {
float: right;
width: 280px;
padding: 12px;
height: 100%;
box-sizing: border-box;
background: #fbfbfb;
overflow: auto;
}
.options-row {
font-size: 14px;
padding: 5px;
margin-top: 10px;
}
input {
display: inline-block;
}
input[type="text"] {
width: 160px;
}
label {
display: inline-block;
margin-bottom: 6px;
width: 200px;
}
select {
width: 120px;
height: 35px;
}
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 src="$DEMOROOT$/spread/source/data/data.js" type="text/javascript"></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-vue': 'npm:@mescius/spread-sheets-vue/index.js'
},
meta: {
'*.css': { loader: 'systemjs-plugin-css' },
'*.vue': { loader: "../plugin-vue/index.js" }
}
});
})(this);
