拆分调整大小

SpreadJS 支持拆分调整大小功能,允许在调整列或行的大小时,仅影响相邻的列或行,而保持其他列或行的位置不变。这避免了传统调整方式中将所有后续列或行推移出可视区域的问题,特别适用于需要精确控制布局的报表场景。

用户可以通过设置 ResizeMode 为 split 模式启用此功能,或者在调整大小时按住 Ctrl 键临时启用拆分调整。

概述 本 Demo 展示了如何启用和切换 SpreadJS 的拆分调整大小功能。拆分调整大小允许用户在调整列或行的大小时,仅影响当前列/行和相邻的下一个列/行,而保持其他列/行的位置不变,防止重要数据被移出可视区域。 实现思路 创建 SpreadJS 工作簿实例 为行调整大小模式下拉框添加监听器,根据用户选择动态更新 spread.options.rowResizeMode 为列调整大小模式下拉框添加监听器,根据用户选择动态更新 spread.options.columnResizeMode 支持用户在运行时切换调整大小模式 代码解析 获取和初始化工作簿 创建一个包含 1 个工作表的 SpreadJS 工作簿实例。 监听列调整大小模式切换 当下拉框选项改变时,获取用户选择的值("0" 或 "1"),将其转换为整数并赋值给 spread.options.columnResizeMode。下拉框的选项值对应 ResizeMode 枚举的整数值:0 表示 normal,1 表示 split。 监听行调整大小模式切换 同样地,为行调整大小模式下拉框添加监听器,动态更新 spread.options.rowResizeMode。 运行效果 界面右侧有两个下拉框,分别用于设置列调整大小模式和行调整大小模式 默认为"正常"模式,调整列或行时会推移后续所有列或行 选择"分割"模式后,调整列或行时只会影响相邻的下一个列或行,其他列或行保持位置不变 用户也可以在调整大小时按住 Ctrl 键临时启用拆分调整 API 参考 ResizeMode 枚举 normal = 0:正常调整大小模式,调整列或行时会推移后续所有列或行 split = 1:拆分调整大小模式,调整时仅影响相邻的下一个列或行 columnResizeMode 和 rowResizeMode 属性 columnResizeMode:指定如何调整列的大小 rowResizeMode:指定如何调整行的大小 注意事项 在拆分模式下,用户只能选择单个行或列进行调整 如果选择了多个行或列,拆分调整将不起作用,会回退到正常模式 如果调整视口中最后一行或列,拆分调整也将不起作用
window.onload = function() { var spread = new GC.Spread.Sheets.Workbook(_getElementById('ss'), { sheetCount: 1 }); initSpread(spread); }; function initSpread(spread) { var sheet = spread.getActiveSheet(); sheet.suspendPaint(); var rowResizeMode = _getElementById("rowResizeMode"); rowResizeMode.addEventListener("change", function () { spread.options.rowResizeMode = parseInt(rowResizeMode.options[rowResizeMode.selectedIndex].value, 10); }); var columnResizeMode = _getElementById("columnResizeMode"); _getElementById("columnResizeMode").addEventListener("change", function () { spread.options.columnResizeMode = parseInt(columnResizeMode.options[columnResizeMode.selectedIndex].value, 10); }); sheet.resumePaint(); } 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/data/data.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> <p>例如,将列调整大小模式设置为“分割”。现在更改列 A 的宽度。列 B 将自动调整大小,而其余列的大小将保持不变。</p> <label for="columnResizeMode">列调整大小模式</label> <select id="columnResizeMode"> <option value="0">正常</option> <option value="1">分割</option> </select> </div> <div class="option-row"> <label for="rowResizeMode">行调整大小模式</label> <select id="rowResizeMode"> <option value="0">正常</option> <option value="1">分割</option> </select> </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; } label { margin-bottom: 6px; } input { padding: 4px 6px; } input[type=number] { width: 40px; } hr { border-color: #fff; opacity: .2; margin-top: 20px; } body { position: absolute; top: 0; bottom: 0; left: 0; right: 0; }