概要

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

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

<p>次の2つのいずれかの方法で動的配列関数を有効にできます:</p> <pre><code class="hljs js language-js"> <span class="hljs-comment">// 方法1:</span> <span class="hljs-keyword">var</span> workbook = <span class="hljs-keyword">new</span> GC.Spread.Sheets.Workbook(<span class="hljs-built_in">document</span>.getElementById(<span class="hljs-string">"ss"</span>), { <span class="hljs-attr">sheetCount</span>: <span class="hljs-number">3</span>, <span class="hljs-attr">allowDynamicArray</span>: <span class="hljs-literal">true</span>}); <span class="hljs-comment">// 方法2:</span> <span class="hljs-keyword">var</span> workbook = <span class="hljs-keyword">new</span> GC.Spread.Sheets.Workbook(<span class="hljs-built_in">document</span>.getElementById(<span class="hljs-string">"ss"</span>)); workbook.options.allowDynamicArray = <span class="hljs-literal">true</span>; </code></pre> <p>スピルとは、数式が複数の値を返し、それらの値が隣接セルに設定されること意味します。</p> <p>動的配列には7つの関数があります: </p> <ul> <li>FILTER 関数: 条件に基づいてセル範囲をフィルタできます。</li> <li>RANDARRAY 関数: ランダムな数値の配列を返します。</li> <li>SEQUENCE 関数: 連続した数値の一覧を昇順で配列として返します。</li> <li>SORT 関数: 範囲または配列のデータを並べ替えます。</li> <li>SORTBY 関数: 範囲または配列の内容を、対応する範囲または配列の値に基づいて並べ替えます。</li> <li>UNIQUE 関数: セル範囲内の一意な値の一覧を返します。</li> <li>暗黙的なインターセクション演算子 @: 動的配列数式ではなく、参照式を入力したセルと同じ行または同じ列のセルを参照します。</li> </ul> <p>スピル範囲演算子(#)を使用することで、スピル範囲全体を参照できます:</p> <ul> <li>スピルされたセルを別の関数などで扱う場合、スピル範囲演算子(#)を使うことにより、スピル範囲全体を参照することができます。</li> </ul> <p>数式が複数の値を返し、次のいずれかの理由でスプレッドシートに結果を表示できない場合、#SPILLエラーが返されます:</p> <ul> <li>数式のスピル範囲は空白ではありません。</li> <li>数式は揮発性であり、計算パス間でサイズ変更されるため、配列のサイズを判別できません。</li> <li>入力しようとしている数式は、ワークシートの範囲を超えて拡張されます。</li> <li>テーブルの配列式がスピルされました。</li> <li>入力しようとしている数式により、メモリが不足しています。</li> <li>数式は、結合されたセルにスピルします。</li> <li>数式が認識できないか、調整できません。</li> </ul> <p>次のいずれかの結果に該当する場合、#CALC!エラーが返されます:</p> <ul> <li>配列内の配列を計算します。</li> <li>配列には、数値、文字列、エラー、ブール値、またはリンクされたデータ型のみを含めることができます。 範囲参照はサポートされていません。</li> <li>空のセットを返します。</li> <li>計算エンジンは、配列で不特定の計算エラーを検出します。</li> </ul>
window.onload = function () { var spread = new GC.Spread.Sheets.Workbook(_getElementById("ss")); initSpread(spread); }; function initSpread(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); bindEvent(spread, sheet); spread.resumeCalcService(); spread.resumePaint(); } function bindEvent (spread, sheet) { _getElementById("allowDynamicArray").addEventListener('change', function () { spread.options.allowDynamicArray = this.checked; sheet && sheet.recalcAll(true); }); } function _getElementById(id) { return document.getElementById(id); }
<!doctype html> <html style="height:100%;font-size:14px;"> <head> <meta name="spreadjs culture" content="ja-jp" /> <meta charset="utf-8" /> <meta name="viewport" content="width=device-width, initial-scale=1.0" /> <link rel="stylesheet" type="text/css" href="$DEMOROOT$/ja/purejs/node_modules/@grapecity/spread-sheets/styles/gc.spread.sheets.excel2013white.css"> <script src="$DEMOROOT$/ja/purejs/node_modules/@grapecity/spread-sheets/dist/gc.spread.sheets.all.min.js" type="text/javascript"></script> <script src="$DEMOROOT$/ja/purejs/node_modules/@grapecity/spread-sheets-resources-ja/dist/gc.spread.sheets.resources.ja.min.js" type="text/javascript"></script> <script src="$DEMOROOT$/spread/source/js/license.js" type="text/javascript"></script> <script src="app.js" type="text/javascript"></script> <link rel="stylesheet" type="text/css" href="styles.css"> </head> <body> <div class="sample-tutorial"> <div id="ss" class="sample-spreadsheets"></div> <div class="options-container"> <div class="option-row"> <input style="width: 20px;float: left;" type="checkbox" id="allowDynamicArray" checked="checked"/> <label for="allowDynamicArray">動的配列を許可</label> </div> </div> </div></body> </html>
.sample { position: relative; height: 100%; overflow: auto; } .sample::after { display: block; content: ""; clear: both; } .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; } .option-group { margin-bottom: 6px; } label { display: block; margin-bottom: 6px; } input { margin-bottom: 5px; padding: 2px 4px; width: 100%; box-sizing: border-box; } input[type=button] { margin-bottom: 6px; } hr { border-color: #fff; opacity: .2; margin: 5px 0; } body { position: absolute; top: 0; bottom: 0; left: 0; right: 0; }