概要と基本的な使い方

シートにデータを手動で入力する代わりに、オートフィル機能を使用すると、一定のパターンに従ったデータ、または他のセルデータに基づくデータをセルに自動入力できます。この機能は、ユーザー向けのテンプレートを設計する場合に、反復されるデータや決まったパターンが存在する場合に便利です。

いくつかのデータ系列を素速く自動入力するには、セルを選択し、フィルハンドルをドラッグします。フィルハンドルの使用方法は、まず、他のセルへの入力基準として使用するセルを選択します。次に、入力する一連のセルに対し、フィルハンドルを横方向または縦方向にドラッグします。 オートフィルを抑制するには、複数のセルを選択後、[Ctrl]キーを押しながらフィルハンドルをドラッグします。セル範囲をドラッグすると、オートフィルオプションを示すボタンが表示されます。このボタンをクリックすると、選択範囲に対するオートフィルの種類を変更できます。たとえば、[書式のみコピー]を選択すると、セル書式だけをフィルできます。オートフィルオプションは、次のとおりです。 copyCells: 値、書式、数式などのすべてのデータオブジェクトをコピーします。 fillSeries: 連続データをコピーします。 fillFormattingOnly: 書式のみをコピーします。 fillWithoutFormatting: 値のみをコピーし、書式はコピーしません。 また、セル範囲の開始位置まで逆方向にドラッグフィルすると、それまで自動入力された値を消去できます。 フィルハンドルのドラッグ中、デフォルトでは、自動入力される最後の値を示すチップが表示されます。このチップを非表示にすることもできます。次に、例を示します。 customList: ドラッグフィルの動作を強化して、カスタムリストをサポートします。ドラッグフィル時にはカスタムリストに一致する値が自動入力されます。 SpreadJSの組み込みのカスタムリストでは月、曜日を提供します。以下はカスタムリストを設定する例です。
window.onload = function () { var customList = [ ['Light', 'Sun', 'Moon', 'Star', 'Sky', 'Rain', 'Cloud'], ['Dog', 'Cat', 'Lion', 'Fish', 'Snake'] ]; var spread = new GC.Spread.Sheets.Workbook(document.getElementById("ss"), {sheetCount: 3}); spread.options.customList = customList; spread.suspendPaint(); initSheet0(spread); initsheet1(spread); initsheet2(spread); spread.resumePaint(); document.getElementById("chkShowDragFillTip").addEventListener('click',function() { spread.options.showDragFillTip = this.checked; }); document.getElementById("chkShowDragFillSmartTag").addEventListener('click',function () { spread.options.showDragFillSmartTag = this.checked; }); document.getElementById("dragFillType").addEventListener('change',function () { var type = parseInt(this.value, 10); if (!isNaN(type)) { spread.options.defaultDragFillType = type; } }); }; function initSheet0(spread) { var sheet = spread.getSheet(0); sheet.name("Base Fill"); sheet.setValue(1, 1, "以下のデータがあるセルを選択し、セルの右下の枠にカーソルを合わせ、カーソルが「+」に変わったら、そのまま下にドラッグすると、"); sheet.setValue(2, 1, "セルのデータが自動入力されます。また、<Ctrl>キーを押しながらドラッグすると自動的に値が増え、ダブルクリックすると自動でフィルされます。"); var simpleData = [ [1.0, 1], [1.1, 2] ]; var dateData = [ [new Date(2018, 3, 1), new Date(2017, 11, 1), new Date(2018, 2, 31), new Date(2017, 11, 31)], [new Date(2018, 4, 1), new Date(2018, 0, 1), new Date(2018, 3, 30), new Date(2018, 0, 31)] ]; sheet.setArray(4, 1, simpleData); sheet.setArray(4, 4, dateData); for (var i = 6; i < 15; i++) { sheet.setValue(i, 0, "Fill Data"); } for (var i = 4; i < 8; i++) { sheet.setColumnWidth(i, 80); } var dateCell = sheet.getRange(4, 4, 2, 4).formatter('m/d/yyyy'); }; function initsheet1 (spread) { var sheet = spread.getSheet(1); sheet.name("String Fill"); sheet.setValue(0, 0, 'N: 数字, S: 文字. 文字列をドラッグフィルする場合、末尾から先頭に向かった数字を検索します。SNのパターンがNSよりも優先されます。Sが同じ場合、Nに対してフィル処理を実行します。'); var title = sheet.getCell(0, 0); title.font("15px 'Franklin Gothic Medium'"); sheet.setValue(1, 0, '文字列は数字のみです。上下にドラッグしてください。'); sheet.setValue(6, 0, '123'); sheet.setValue(7, 0, '125'); sheet.setValue(6, 2, '-3'); sheet.setValue(7, 2, '-2'); sheet.setValue(6, 4, '003'); sheet.setValue(7, 4, '007'); sheet.setValue(1, 8, '文字列は末尾に数字を含みます。上下にドラッグしてください。'); sheet.setValue(6, 8, 'a2'); sheet.setValue(6, 10, 'a1'); sheet.setValue(7, 10, 'a5'); sheet.setValue(6, 12, 'a001'); sheet.setValue(7, 12, 'a002'); sheet.setValue(6, 14, '1a2a3a4a5'); sheet.setValue(7, 14, '1a2a3a4a6'); sheet.setColumnWidth(14, 100); sheet.setValue(24, 0, '文字列は先頭に数字を含みます。上下にドラッグしてください。'); sheet.setValue(30, 0, '5a'); sheet.setValue(31, 0, '2a'); sheet.setValue(30, 2, '003b'); sheet.setValue(31, 2, '005b'); sheet.setValue(30, 4, '1a1a1a'); sheet.setValue(31, 4, '2a1a1a'); sheet.setValue(24, 8, '文字列はコピーされます。上下にドラッグしてください。'); sheet.setValue(30, 8, 'a1a1'); sheet.setValue(31, 8, 'a2a2'); sheet.setValue(30, 10, '1a1'); sheet.setValue(31, 10, '2a2'); sheet.setValue(30, 12, 'a1'); sheet.setValue(31, 12, 'b2'); } function initsheet2 (spread) { var sheet = spread.getSheet(2); sheet.name("Custom Fill"); sheet.setValue(0, 0, 'ドラッグフィルのカスタムリストです。上下にドラッグしてください。'); sheet.setValue(6, 0, 'Mar'); sheet.setValue(7, 0, 'Apr'); sheet.setValue(6, 2, 'June'); sheet.setValue(7, 2, 'July'); sheet.setValue(6, 4, 'Mon'); sheet.setValue(7, 4, 'Tue'); sheet.setValue(6, 6, 'Friday'); sheet.setValue(7, 6, 'Saturday'); sheet.setValue(20, 0, 'カスタムリストは、現在2つの配列をカスタマイズしており、以下のように表示されます。ドラッグフィルをするために、リストに1つ以上の連続したものを入力します。'); var customList = sheet.parent.options.customList; for (var i = 0; i < customList.length; i++) { var itemList = customList[i]; sheet.setValue(21 + i, 0, 'List ' + i + ": "); itemList.forEach(function(item, index) { sheet.setValue(21 + i, index + 1, item); }); } }
<!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/@mescius/spread-sheets/styles/gc.spread.sheets.excel2013white.css"> <script src="$DEMOROOT$/ja/purejs/node_modules/@mescius/spread-sheets/dist/gc.spread.sheets.all.min.js" type="text/javascript"></script> <script src="$DEMOROOT$/ja/purejs/node_modules/@mescius/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"> <p> 以下のオプションを変更し、フィル操作がどのように変化するかを確認してください。 </p> <label for="dragFillType">デフォルトのドラッグフィルの種類:</label> <select id="dragFillType" title="デフォルトのドラッグフィルの種類を一つ選択してください。"> <option value="5" selected="selected">Auto</option> <option value="0">Copy Cells</option> <option value="1">Fill Series</option> <option value="2">Fill Formatting Only</option> <option value="3">Fill Without Formatting</option> </select> </div> <div class="option-row"> <input type="checkbox" id="chkShowDragFillTip" checked /> <label for="chkShowDragFillTip">ドラッグフィルチップを表示</label> </div> <div class="option-row"> <input id="chkShowDragFillSmartTag" type="checkbox" checked="checked"> <label for="chkShowDragFillSmartTag">ドラッグフィルのスマートタグを表示</label> </div> </div> </div> </body> </html>
.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; } select { padding: 4px 8px; width: 100%; box-sizing: border-box; margin-top: 4px; } body { position: absolute; top: 0; bottom: 0; left: 0; right: 0; }