MonthPicker

MonthPicker is a type of drop-down cell style in SpreadJS. Using JavaScript code, the developer can define a starting year, ending year, and height of the Month Picker. When set as a style on a cell in the workbook, the user can click on the drop-down arrow to select a month that will be displayed in that cell. An example of this drop-down is shown in the spreadsheet below.

<p>Drop-downs provide developers the ability to add a drop-down menu with specific properties to cells in a workbook. These drop-down menus don't require any extra code other than simply specifying which one to use for the drop-down menu. </p> <p>SpreadJS now has 8 different kinds of drop-downs, and this demo shows how to use the MonthPicker.</p> <p>You can use MonthPicker drop-down like the following code :</p> <pre><code class="hljs js language-js"> <span class="hljs-comment">// The way of click the dropdown icon to open MonthPicker. </span> <span class="hljs-keyword">var</span> monthPickerStyle = <span class="hljs-keyword">new</span> GC.Spread.Sheets.Style(); monthPickerStyle.cellButtons = [ { <span class="hljs-attr">imageType</span>: GC.Spread.Sheets.ButtonImageType.dropdown, <span class="hljs-attr">command</span>: <span class="hljs-string">"openMonthPicker"</span>, <span class="hljs-attr">useButtonStyle</span>: <span class="hljs-literal">true</span>, } ]; monthPickerStyle.dropDowns = [ { <span class="hljs-attr">type</span>: GC.Spread.Sheets.DropDownType.monthPicker, <span class="hljs-attr">option</span>: { <span class="hljs-attr">startYear</span>: <span class="hljs-number">2009</span>, <span class="hljs-attr">stopYear</span>: <span class="hljs-number">2019</span>, <span class="hljs-attr">height</span>: <span class="hljs-number">300</span>, } } ]; sheet.setText(<span class="hljs-number">1</span>, <span class="hljs-number">5</span>, <span class="hljs-string">"Month Picker"</span>); sheet.setStyle(<span class="hljs-number">2</span>, <span class="hljs-number">5</span>, monthPickerStyle); <span class="hljs-comment">// The way just open MonthPicker with command rather then clicking the dropdown button.</span> spread.commandManager().execute({<span class="hljs-attr">cmd</span>:<span class="hljs-string">"openMonthPicker"</span>,<span class="hljs-attr">row</span>:<span class="hljs-number">2</span>,<span class="hljs-attr">col</span>:<span class="hljs-number">11</span>,<span class="hljs-attr">sheetName</span>:<span class="hljs-string">"Sheet1"</span>}); </code></pre> <p>There are several item in options that can customize the MonthPicker.</p> <ul> <li><strong>startYear: number</strong> : Specific the month picker's start year, default value is ten year ago.</li> <li><strong>stopYear: number</strong> : Specific the month picker's start year, default value is this year.</li> <li><strong>height: number</strong> : Specific the dom's height of month picker, default value is 300.</li> </ul>
var spreadNS = GC.Spread.Sheets; window.onload = function () { var spread = new GC.Spread.Sheets.Workbook(document.getElementById("ss")); initSpread(spread); }; function initSpread(spread) { var sheet = spread.getSheet(0); sheet.suspendPaint(); // -------------------- Month Picker --------------------- var monthPickerStyle = new GC.Spread.Sheets.Style(); monthPickerStyle.cellButtons = [ { imageType: GC.Spread.Sheets.ButtonImageType.dropdown, command: "openMonthPicker", useButtonStyle: true, } ]; monthPickerStyle.dropDowns = [ { type: GC.Spread.Sheets.DropDownType.monthPicker, option: { startYear: 2009, stopYear: 2019, height: 300, } } ]; sheet.setText(1, 5, "Month Picker"); sheet.setStyle(2, 5, monthPickerStyle); // -------------------- Month Picker --------------------- var monthPickerStyle = new GC.Spread.Sheets.Style(); monthPickerStyle.cellButtons = [ { imageType: GC.Spread.Sheets.ButtonImageType.dropdown, command: "openMonthPicker", useButtonStyle: true, } ]; monthPickerStyle.dropDowns = [ { type: GC.Spread.Sheets.DropDownType.monthPicker, option: { startYear: 1970, stopYear: 2030, height: 400, } } ]; sheet.setText(1, 11, "Month Picker"); sheet.setStyle(2, 11, monthPickerStyle); sheet.resumePaint(); spread.commandManager().execute({cmd:"openMonthPicker",row:2,col:5,sheetName:"Sheet1"}); }
<!doctype html> <html style="height:100%;font-size:14px;"> <head> <meta charset="utf-8" /> <meta name="viewport" content="width=device-width, initial-scale=1.0" /> <link rel="stylesheet" type="text/css" href="$DEMOROOT$/en/purejs/node_modules/@grapecity/spread-sheets/styles/gc.spread.sheets.excel2013white.css"> <script src="$DEMOROOT$/en/purejs/node_modules/@grapecity/spread-sheets/dist/gc.spread.sheets.all.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" style="width:100%; height: 100%"></div> </div> </body> </html>
.sample-tutorial { position: relative; height: 100%; overflow: hidden; } body { position: absolute; top: 0; bottom: 0; left: 0; right: 0; }