复选框单元格

CheckBox 表示一种复选框单元格类型。当你想在你的页面添加用户可以填写的表单,那么复选框单元格将是非常有用,而且将会很简单的让用户去选择。

创建一个复选框单元格,参照以下代码: 复选框单元格类型 CheckBox 支持三种状态。你可以使用 isThreeState 方法来设置复选框是否支持三种状态。例如: 三种状态分别是选中,未选中和不确定状态。每种状态都有对应的文本;你可以使用 textTrue , textFalse和 textIndeterminate 方法来设置或者获取状态对应的文本。例如: 你可以使用 caption 方法来设置或者获取复选框单元格的标题。使用 textAlign 方法来设置或者获取文本相对于复选框的位置。这个设置是一个枚举 CheckBoxTextAlign, 枚举值如下: top: 文本在复选框顶部。 bottom: 文本在复选框底部。 left: 文本在复选框左边。 right: 文本在复选框右边。 你可以使用 boxSize 方法来获取或者设置复选框大小,可以设置数字或者"auto"。 当单元格样式 "wordWrap "被设置为 "true",且单元格宽度不足以容纳文本时,文本将被包裹显示。
window.onload = function() { var spread = new GC.Spread.Sheets.Workbook(document.getElementById("ss")); initSpread(spread); }; function initSpread(spread) { var spreadNS = GC.Spread.Sheets; var sheet = spread.getSheet(0); sheet.bind(spreadNS.Events.SelectionChanged, function() { propertyChange(false); }); sheet.suspendPaint(); sheet.setColumnWidth(1, 120); sheet.setColumnWidth(2, 130); sheet.setRowHeight(1, 35); sheet.setValue(1, 1, "caption"); sheet.getCell(1, 1).hAlign(GC.Spread.Sheets.HorizontalAlign.center).vAlign(GC.Spread.Sheets.VerticalAlign.center).foreColor("green"); var captionCellType = new GC.Spread.Sheets.CellTypes.CheckBox(); captionCellType.caption("Caption"); sheet.setCellType(1, 2, captionCellType); sheet.getCell(1, 2).hAlign(GC.Spread.Sheets.HorizontalAlign.center).vAlign(GC.Spread.Sheets.VerticalAlign.center); sheet.setRowHeight(3, 35); sheet.setValue(3, 1, "threeState"); sheet.getCell(3, 1).hAlign(GC.Spread.Sheets.HorizontalAlign.center).vAlign(GC.Spread.Sheets.VerticalAlign.center).foreColor("red"); var threeStateCellType = new GC.Spread.Sheets.CellTypes.CheckBox(); threeStateCellType.isThreeState(false); threeStateCellType.textTrue("Checked!"); threeStateCellType.textFalse("Check Me!"); sheet.setCellType(3, 2, threeStateCellType); sheet.getCell(3, 2).hAlign(GC.Spread.Sheets.HorizontalAlign.center).vAlign(GC.Spread.Sheets.VerticalAlign.center); sheet.setRowHeight(5, 35); sheet.setValue(5, 1, "textAlign"); sheet.getCell(5, 1).hAlign(GC.Spread.Sheets.HorizontalAlign.center).vAlign(GC.Spread.Sheets.VerticalAlign.center).foreColor("blue"); var textAlignCellType = new GC.Spread.Sheets.CellTypes.CheckBox(); textAlignCellType.isThreeState(false); textAlignCellType.caption("textAlign"); textAlignCellType.textAlign(GC.Spread.Sheets.CellTypes.CheckBoxTextAlign.bottom); sheet.setCellType(5, 2, textAlignCellType); sheet.getCell(5, 2).hAlign(GC.Spread.Sheets.HorizontalAlign.center).vAlign(GC.Spread.Sheets.VerticalAlign.center); sheet.setRowHeight(7, 35); sheet.setValue(7, 1, "text wrap"); sheet.getCell(7, 1).hAlign(GC.Spread.Sheets.HorizontalAlign.center).vAlign(GC.Spread.Sheets.VerticalAlign.center).foreColor("orange"); var textWrapCellType = new GC.Spread.Sheets.CellTypes.CheckBox(); textWrapCellType.caption("This is a long long text"); sheet.setCellType(7, 2, textWrapCellType); sheet.getCell(7, 2).wordWrap(true); sheet.resumePaint(); _getElementById("changeProperty").addEventListener('click',function() { propertyChange(true); }); function propertyChange(isSet) { var sheet = spread.getActiveSheet(); var sels = sheet.getSelections(); if (sels && sels.length > 0) { var sel = getActualRange(sels[0], sheet.getRowCount(), sheet.getColumnCount()); var checkboxCellType = sheet.getCellType(sel.row, sel.col); if (!(checkboxCellType instanceof spreadNS.CellTypes.CheckBox)) { _getElementById("changeProperty").setAttribute("disabled", 'disabled'); return; } if (!isSet) { _getElementById("changeProperty").removeAttribute("disabled"); if(checkboxCellType.caption()) { _getElementById("txtCheckBoxCellTextCaption").parentNode.style.display="block"; _getElementById("txtCheckBoxCellTextCaption").value=checkboxCellType.caption(); _getElementById("txtCheckBoxCellTextTrue").parentNode.style.display="none"; _getElementById("ckbCheckBoxCellIsThreeState").parentNode.style.display="none"; } else { _getElementById("txtCheckBoxCellTextCaption").parentNode.style.display="none"; _getElementById("txtCheckBoxCellTextTrue").parentNode.style.display="block"; _getElementById("ckbCheckBoxCellIsThreeState").parentNode.style.display="block"; _getElementById("txtCheckBoxCellTextTrue").value=checkboxCellType.textTrue(); _getElementById("txtCheckBoxCellTextIndeterminate").value=checkboxCellType.textIndeterminate(); _getElementById("txtCheckBoxCellTextFalse").value=checkboxCellType.textFalse(); _getElementById("ckbCheckBoxCellIsThreeState").checked=checkboxCellType.isThreeState(); _getElementById("checkboxSize").value = checkboxCellType.boxSize(); } _getElementById("selCheckBoxCellAlign").value=checkboxCellType.textAlign(); } else { if(checkboxCellType.caption()) { checkboxCellType.caption(_getElementById("txtCheckBoxCellTextCaption").value); } else { checkboxCellType.textTrue(_getElementById("txtCheckBoxCellTextTrue").value); checkboxCellType.textIndeterminate(_getElementById("txtCheckBoxCellTextIndeterminate").value); checkboxCellType.textFalse(_getElementById("txtCheckBoxCellTextFalse").value); checkboxCellType.isThreeState(_getElementById("ckbCheckBoxCellIsThreeState").checked); var boxSizeValue = _getElementById("checkboxSize").value; var boxSize = Number(boxSizeValue); if (isNaN(boxSize)) { checkboxCellType.boxSize(boxSizeValue); } else { checkboxCellType.boxSize(boxSize); } } checkboxCellType.textAlign(_getElementById("selCheckBoxCellAlign").value - 0); } } sheet.repaint(); } function getActualRange(range, maxRowCount, maxColCount) { var row = range.row < 0 ? 0 : range.row; var col = range.col < 0 ? 0 : range.col; var rowCount = range.rowCount < 0 ? maxRowCount : range.rowCount; var colCount = range.colCount < 0 ? maxColCount : range.colCount; return new spreadNS.Range(row, col, rowCount, colCount); } } function _getElementById(id){ return document.getElementById(id); }
<!doctype html> <html style="height:100%;font-size:14px;"> <head> <meta name="spreadjs culture" content="zh-cn" /> <meta charset="utf-8" /> <meta name="viewport" content="width=device-width, initial-scale=1.0" /> <link rel="stylesheet" type="text/css" href="$DEMOROOT$/zh/purejs/node_modules/@grapecity-software/spread-sheets/styles/gc.spread.sheets.excel2013white.css"> <script src="$DEMOROOT$/zh/purejs/node_modules/@grapecity-software/spread-sheets/dist/gc.spread.sheets.all.min.js" type="text/javascript"></script> <script src="$DEMOROOT$/zh/purejs/node_modules/@grapecity-software/spread-sheets-resources-zh/dist/gc.spread.sheets.resources.zh.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"> <labe>Select the check box cell in Spread and edit its options with these text boxes.</labe> </div> <div class="option-row"> <label>caption:</label> <input type="text" id="txtCheckBoxCellTextCaption" /> </div> <div class="option-row"> <label>textTrue:</label> <input type="text" id="txtCheckBoxCellTextTrue" value="textTrue" /> <label>textIndeterminate(for 3-state option):</label> <input type="text" id="txtCheckBoxCellTextIndeterminate" value="textIndeterminate" /> <label>textFalse:</label> <input type="text" id="txtCheckBoxCellTextFalse" value="textFalse" /> <label>boxSize</label> <input type="text" id="checkboxSize" min="1"> </div> <div class="option-row"> <label>textAlign:</label> <select id="selCheckBoxCellAlign"> <option value="0" selected="selected">top</option> <option value="1">bottom</option> <option value="2">left</option> <option value="3">right</option> </select> </div> <div class="option-row"> <input type="checkbox" id="ckbCheckBoxCellIsThreeState" checked="checked" /> <label for="ckbCheckBoxCellIsThreeState">isThreeState</label> </div> <div class="option-row"> <label></label> <input type="button" id="changeProperty" value="Update" /> </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; } .option-row { padding-bottom: 5px; } label { padding-bottom: 4px; display: block; } input, select { width: 100%; padding: 4px 8px; box-sizing: border-box; } input[type=checkbox] { width: auto; } input[type=checkbox]+label { display: inline-block; width: auto; } body { position: absolute; top: 0; bottom: 0; left: 0; right: 0; }