概述
本 Demo 展示了如何使用动态大小(星型调整)设置列宽,使表格列能够自动适应视图区域的大小变化。Demo 中结合使用了动态大小和固定大小两种方式设置列宽,其中 "Film" 和 "Lead Studio" 列使用动态大小,其他列使用固定宽度。
实现思路
初始化 SpreadJS 工作簿并获取活动工作表
使用 setDataSource 方法加载外部数据源
使用 setColumnWidth 方法设置各列宽度,其中部分列使用动态大小(如 "2*"、"*"),其他列使用固定像素值
使用 suspendPaint 和 resumePaint 优化渲染性能
代码解析
设置动态列宽
这段代码展示了如何为列设置不同的宽度模式:
第 0 列使用 "2*",表示动态大小,权重为 2
第 1 列使用数字 70,表示固定宽度 70 像素
第 2 列使用 "*",表示动态大小,权重为 1
动态大小的列会根据权重分配视图区域的剩余空间。在这个 Demo 中,第 0 列和第 2 列都是动态大小,权重比例为 2:1,意味着第 0 列的宽度是第 2 列的两倍。
完整列宽设置
这段代码展示了混合使用动态大小和固定大小的方式。视图区域的宽度会先分配给固定宽度的列,剩余空间再按权重分配给动态大小的列。
运行效果
表格加载后,"Film" 和 "Lead Studio" 列会自动调整大小以填充视图区域的剩余空间
拖动浏览器窗口改变大小时,这两列会自动调整宽度,其他列保持固定宽度不变
手动调整某一列的宽度后,动态大小的列会重新计算并调整
隐藏或显示某列时,动态大小的列会自动重新分配空间
API 参考
setColumnWidth 方法
设置指定列的宽度或动态大小。
col:列索引
value:宽度值,可以是数字(像素值)或字符串(动态大小,如 "*"、"2*")
sheetArea:可选,表单区域
window.onload = function() {
var spread = new GC.Spread.Sheets.Workbook(document.getElementById('ss'), { sheetCount: 1 });
spread.suspendPaint();
initSpread(spread);
spread.resumePaint();
};
function initSpread(spread) {
var sd = dataSource;
var sheet = spread.getActiveSheet();
if (sd.length > 0) {
sheet.setDataSource(sd);
}
sheet.setColumnWidth(0, "2*");
sheet.setColumnWidth(1, 70);
sheet.setColumnWidth(2, "*");
sheet.setColumnWidth(3, 110);
sheet.setColumnWidth(4, 80);
sheet.setColumnWidth(6, 110);
}
<!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>列 "Film" 和 "Lead Studio" 已设置为动态大小。 <br />更改浏览器大小、调整列宽或隐藏列,以查看动态大小的工作方式。</p>
</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;
}
body {
position: absolute;
top: 0;
bottom: 0;
left: 0;
right: 0;
}