概述
本 Demo 展示了集算表的列头展示模式功能,通过为不同的列设置不同的 headerFit 模式,实现在有限列宽下完整显示列标题。Demo 中演示了三种模式:normal(普通模式)、vertical(垂直模式)和 stack(堆叠模式),并结合 headerStyle 属性展示了如何自定义列头样式。
实现思路
创建 SpreadJS workbook 和 dataManager,添加产品数据表
创建集算表并设置基本选项
使用 addView 方法定义视图,为每个列配置不同的 headerFit 模式
为部分列设置 headerStyle 属性,自定义列头的背景色、边框等样式
通过 fetch 方法加载数据并应用到集算表
代码解析
设置不同的列头展示模式
这段代码通过 addView 方法定义了表格视图,并为不同的列设置了不同的 headerFit 模式。ID 列和 Discontinued 列使用垂直模式(vertical),标题文字从上到下显示;Quantity Per Unit、Unit Price、Units In Stock 和 Units On Order 列使用堆叠模式(stack),标题文字会在列宽不足时自动换行堆叠;其他列使用默认的普通模式(normal),标题水平显示。
结合样式设置列头外观
headerStyle 属性允许自定义列头的样式,包括背景色、字体颜色和边框等。这段代码为 Unit Price 列设置了橙色背景、白色文字和蓝色边框,使该列在视觉上更加突出。
运行效果
ID 列和 Discontinued 列的标题以垂直方向显示,适合较窄的列宽
Quantity Per Unit、Unit Price 等列的标题在有限宽度内自动堆叠显示,确保完整展示标题文字
Unit Price 和 Units On Order 列的列头具有橙色背景和自定义边框样式
所有列标题都能在相应的列宽下完整显示,不会出现截断
API 参考
headerFit 属性
normal:默认值,列标题文本方向为水平,从左到右
vertical:列标题文本方向为垂直,从上到下
stack:当列的宽度不足以容纳列标题文本时,列标题会相互堆叠
headerStyle 属性
用于自定义列标题的样式,支持设置背景颜色、字体、边框等样式选项。
/*REPLACE_MARKER*/
/*DO NOT DELETE THESE COMMENTS*/
window.onload = function() {
var spread = new GC.Spread.Sheets.Workbook(document.getElementById("ss"), { sheetCount: 0 });
initSpread(spread);
};
function initSpread(spread) {
spread.suspendPaint();
spread.options.autoFitType = GC.Spread.Sheets.AutoFitType.cellWithHeader;
//init a data manager
var baseApiUrl = getBaseApiUrl();
var dataManager = spread.dataManager();
//add product table
var productTable = dataManager.addTable("productTable", {
remote: {
read: {
url: baseApiUrl + "/Product"
}
}
});
//init a table sheet
var sheet = spread.addSheetTab(0, "TableSheet1", GC.Spread.Sheets.SheetType.tableSheet);
sheet.options.allowAddNew = false; //hide new row
//bind a view to the table sheet
var myView = productTable.addView("myView", [
{ value: "Id", caption: "ID", width: 46, headerFit: "vertical" },
{ value: "ProductName", caption: "Name", width: 220 },
{ value: "QuantityPerUnit", caption: "Quantity Per Unit", width: 140, headerFit: "stack" },
{ value: "UnitPrice", caption: "Unit Price", width: 45, headerFit: "stack", headerStyle: {
backColor : "#F7A711",
foreColor:"white",
borderLeft: {
color: "#367fc9",
style: "thin"
},
borderTop: {
color: "#367fc9",
style: "thick"
},
borderRight: {
color: "#367fc9",
style: "thin"
},
borderBottom: {
color: "#367fc9",
style: "thin"
}
}},
{ value: "UnitsInStock", caption: "Units In Stock", width: 40, headerFit: "stack" },
{ value: "UnitsOnOrder", caption: "Units On Order", width: 40, headerFit: "stack", headerStyle: {
backColor : "#F7A711"}},
{ value: "ReorderLevel", caption: "Reorder Level", width: 140, headerStyle: {
borderLeft: {
color: "black",
style: "thin"
},
borderTop: {
color: "black",
style: "thin"
},
borderRight: {
color: "black",
style: "thin"
},
borderBottom: {
color: "black",
style: "thin"
},
} },
{ value: "Discontinued", headerFit: "vertical", width: 70}
]);
myView.fetch().then(function() {
sheet.setDataView(myView);
});
spread.resumePaint();
}
function getBaseApiUrl() {
return window.location.href.match(/http.+spreadjs\/SpreadJSTutorial\//)[0] + 'server/api';
}
<!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">
<!-- Promise Polyfill for IE, https://www.npmjs.com/package/promise-polyfill -->
<script src="https://cdn.jsdelivr.net/npm/promise-polyfill@8/dist/polyfill.min.js"></script>
<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-tablesheet/dist/gc.spread.sheets.tablesheet.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 id="optionContainer" class="optionContainer">
</div>
</div>
</html>
.sample-tutorial {
position: relative;
height: 100%;
overflow: hidden;
}
body {
position: absolute;
top: 0;
bottom: 0;
left: 0;
right: 0;
}
.sample-spreadsheets {
width: 100%;
height: 100%;
overflow: hidden;
float: left;
}