列头展示模式

SpreadJS 集算表提供三种列头展示模式:普通模式、垂直模式和堆叠模式。当列宽较窄但列标题较长时,可以通过切换展示模式确保标题完整显示,同时保持表格布局的紧凑性和可读性。

这三种模式分别适用于不同的业务场景:普通模式适合常规展示,垂直模式适合需要节省横向空间的场景,堆叠模式适合标题文字较多但列宽受限的情况。

概述 本 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; }