概要

動的配列数式は、配列の数式を置き換えるために使用されます。セル範囲を自動スピルおよび範囲指定することで、複数の結果を出力として返し、スプレッドシート内の配列数式を簡単ですばやく処理できます。

次の例では、SEQUENCE関数によってセルC3から値が順番に設定されます。ただし、セル範囲内に既存の値がある場合にはセルC9のようにエラーとなり、#SPILL!が表示されます。

次の2つのいずれかの方法で動的配列関数を有効にできます: スピルとは、数式が複数の値を返し、それらの値が隣接セルに設定されること意味します。 動的配列には7つの関数があります: FILTER 関数: 条件に基づいてセル範囲をフィルタできます。 RANDARRAY 関数: ランダムな数値の配列を返します。 SEQUENCE 関数: 連続した数値の一覧を昇順で配列として返します。 SORT 関数: 範囲または配列のデータを並べ替えます。 SORTBY 関数: 範囲または配列の内容を、対応する範囲または配列の値に基づいて並べ替えます。 UNIQUE 関数: セル範囲内の一意な値の一覧を返します。 暗黙的なインターセクション演算子 @: 動的配列数式ではなく、参照式を入力したセルと同じ行または同じ列のセルを参照します。 スピル範囲演算子(#)を使用することで、スピル範囲全体を参照できます: スピルされたセルを別の関数などで扱う場合、スピル範囲演算子(#)を使うことにより、スピル範囲全体を参照することができます。 数式が複数の値を返し、次のいずれかの理由でスプレッドシートに結果を表示できない場合、#SPILLエラーが返されます: 数式のスピル範囲は空白ではありません。 数式は揮発性であり、計算パス間でサイズ変更されるため、配列のサイズを判別できません。 入力しようとしている数式は、ワークシートの範囲を超えて拡張されます。 テーブルの配列式がスピルされました。 入力しようとしている数式により、メモリが不足しています。 数式は、結合されたセルにスピルします。 数式が認識できないか、調整できません。 次のいずれかの結果に該当する場合、#CALC!エラーが返されます: 配列内の配列を計算します。 配列には、数値、文字列、エラー、ブール値、またはリンクされたデータ型のみを含めることができます。 範囲参照はサポートされていません。 空のセットを返します。 計算エンジンは、配列で不特定の計算エラーを検出します。
<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="option-row"> <input style="width: 20px;float: left;" type="checkbox" id="allowDynamicArray" checked="checked" @change="setAllowDynamicArray($event)" /> <label for="allowDynamicArray">動的配列を許可する</label> </div> </div> </div> </template> <script setup> import GC from '@mescius/spread-sheets'; import '@mescius/spread-sheets-resources-ja'; GC.Spread.Common.CultureManager.culture("ja-jp"); import { ref } from 'vue'; const spreadRef = ref(null); function initSpread(spread) { spreadRef.value = spread; spread.options.allowDynamicArray = true; var sheet = spread.getActiveSheet(); spread.suspendPaint(); spread.suspendCalcService(); sheet.setValue(1, 2, "=SEQUENCE(3,3)"); sheet.setFormula(2, 2, 'SEQUENCE(3,3)'); sheet.setValue(7, 2, "=SEQUENCE(3,3)"); sheet.setFormula(8, 2, 'SEQUENCE(3,3)'); sheet.setValue(9, 3, 3); spread.resumeCalcService(); spread.resumePaint(); } function setAllowDynamicArray(e) { var spread = spreadRef.value, sheet = spread.getActiveSheet(); spread.options.allowDynamicArray = e.target.checked; sheet && sheet.recalcAll(true); } </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; } .option-row { font-size: 14px; padding: 5px; margin-top: 10px; } input { margin-bottom: 5px; padding: 2px 4px; width: 100%; box-sizing: border-box; } 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: { '@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', '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", }, meta: { '*.css': { loader: 'systemjs-plugin-css' }, '*.vue': { loader: "../plugin-vue/index.js" } } }); })(this);