甘特图布局配置

概述本 Demo 展示了如何配置 GanttSheet 的布局选项，包括链接线模式、任务条高度、任务条日期格式以及是否将任务条对齐到整天。Demo 提供了交互式界面，允许用户实时调整这些布局属性并查看效果。实现思路初始化 Spread 工作簿并创建数据源（使用 dataManager 连接远程数据）创建 GanttSheet 并绑定数据视图设置初始布局属性（链接线模式为 noLinks，任务条高度为 18）初始化侧边面板，提供下拉选择框和复选框用于配置布局点击"设置布局"按钮时，读取用户选择并应用到 GanttSheet 的 layout 对象代码解析初始化 GanttSheet 并设置默认布局这段代码创建了 GanttSheet 并绑定了数据视图。通过 ganttSheet.project.layout 获取布局对象，并设置初始的链接线模式和任务条高度。应用用户配置的布局属性点击"设置布局"按钮时，从界面控件读取用户选择的值，并应用到 layout 对象的各个属性。使用 suspendPaint() 和 resumePaint() 来优化性能，避免多次重绘。运行效果页面加载后显示一个甘特图，初始状态链接线为隐藏模式在右侧面板中，可以通过下拉框选择链接线模式（无链接、到顶部、到末端）可以调整任务条高度（6-24 像素可选）可以选择任务条上日期文本的显示格式（如 yyyy-mm-dd、yy/m/dd 等）可以切换是否将任务条对齐到整天（勾选复选框）点击"设置布局"按钮后，配置立即生效，甘特图会根据新的布局设置重新渲染 API 参考 TaskbarLayout 对象通过 ganttSheet.project.layout 获取，用于配置甘特图的布局外观。主要属性 linkLineMode：链接线模式，类型为 TaskbarLinkMode，可选值： "noLinks" - 不显示链接线 "toTop" - 连接到任务条顶部（默认值） "toEnd" - 连接到任务条末端 barHeight：任务条高度（像素），默认值为 12 barTextDateFormat：任务条上日期文本的格式字符串，默认值为 "yyyy/mm/dd hh:mm" roundBarsToWholeDays：是否将任务条对齐到整天，布尔值，默认值为 true

/*REPLACE_MARKER*/
/*DO NOT DELETE THESE COMMENTS*/
var myTable;
var ganttSheet;
var roundBarsToWholeDays = true;
window.onload = function() {
var spread = new GC.Spread.Sheets.Workbook(document.getElementById("ss"), { sheetCount: 0 });
initSpread(spread);
initSplitView(spread);
};
function initSpread(spread) {
spread.suspendPaint();
initDataSource(spread);
initGanttSheet(spread);
spread.resumePaint();
}
function initDataSource(spread) {
var tableName = "Gantt_Id";
var baseApiUrl = getBaseApiUrl();
var apiUrl = baseApiUrl + "/" + tableName;
var dataManager = spread.dataManager();
myTable = dataManager.addTable("myTable", {
batch: true,
remote: {
read: {
url: apiUrl
}
},
schema: {
hierarchy: {
type: "Parent",
column: "parentId"
},
columns: {
id: { isPrimaryKey: true },
taskNumber: { dataType: "rowOrder" }
}
}
});
}
function initGanttSheet(spread) {
ganttSheet = spread.addSheetTab(0, "GanttSheet", GC.Spread.Sheets.SheetType.ganttSheet);
var view = myTable.addView("ganttView", [
{ value: "taskNumber", caption: "NO.", width: 60 },
{ value: "name", caption: "Task Name", width: 200 },
{ value: "duration", caption: "Duration", width: 90 },
{ value: "predecessors", caption: "Predecessors", width: 120, visible: false }
]);
view.fetch().then(function() {
ganttSheet.bindGanttView(view);
ganttSheet.suspendPaint();
var summaryStyleRule = ganttSheet.project.taskStyleRules.getRule("summary");
var summaryStyle = summaryStyleRule.style.taskbarStyle;
summaryStyle.leftText = "start";
summaryStyle.rightText = "finish";
summaryStyleRule.style.taskbarStyle = summaryStyle;
var layout = ganttSheet.project.layout;
layout.linkLineMode = "noLinks";
layout.barHeight = 18;
ganttSheet.resumePaint();
});
initSidePanel(ganttSheet);
}
function initSidePanel(ganttSheet) {
var roundBarItem = document.getElementById("round-bar");
var linkTypeItem = document.getElementById("link-type");
var barHeightItem = document.getElementById("bar-height");
var dateFormatItem = document.getElementById("date-format");
var setLayoutItem = document.getElementById("set-layout");
roundBarItem.addEventListener("click", function() {
if (roundBarItem.classList.contains("active")) {
roundBarItem.classList.remove("active");
roundBarsToWholeDays = false;
} else {
roundBarItem.classList.add("active");
roundBarsToWholeDays = true;
}
});
setLayoutItem.addEventListener("click", function() {
var layout = ganttSheet.project.layout;
ganttSheet.suspendPaint();
layout.linkLineMode = linkTypeItem.value;
layout.barHeight = Number(barHeightItem.value);
layout.barTextDateFormat = dateFormatItem.value;
layout.roundBarsToWholeDays = roundBarsToWholeDays;
ganttSheet.resumePaint();
});
}
function getBaseApiUrl() {
return window.location.href.match(/http.+spreadjs\/SpreadJSTutorial\//)[0] + 'server/api';
}
function initSplitView(spread) {
var host = document.getElementById("split-view");
var content = host.getElementsByClassName("split-content")[0];
var panel = host.getElementsByClassName("split-panel")[0];
new SplitView({
host: host,
content: content,
panel: panel,
refreshContent: function() {
spread.refresh();
}
});
}

<!doctype html>
<html style="height:100%;font-size:14px;">
<head>
<meta charset="utf-8" />
<meta name="spreadjs culture" content="zh-cn" />
<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">
<link rel="stylesheet" type="text/css" href="$DEMOROOT$/spread/source/splitView/splitView.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-ganttsheet/dist/gc.spread.sheets.ganttsheet.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/splitView/splitView.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 id="split-view" class="sample-tutorial">
<div id="ss" class="sample-spreadsheets split-content"></div>
<div class="options-container split-panel">
<div class="option-row option-title">
配置甘特图布局
</div>
<div class="option-block">
<div class="option-row selection-box">
<label for="link-type">链接模式</label>
<select id="link-type">
<option value="noLinks">无链接</option>
<option value="toEnd">到结束</option>
<option value="toTop" selected>到顶部</option>
</select>
</div>
</div>
<div class="option-block">
<div class="option-row selection-box">
<label for="bar-height">条形高度</label>
<select id="bar-height">
<option value="6">6</option>
<option value="8">8</option>
<option value="10">10</option>
<option value="12" selected>12</option>
<option value="14">14</option>
<option value="18">18</option>
<option value="24">24</option>
</select>
</div>
<div class="option-row selection-box">
<label for="date-format">日期格式</label>
<select id="date-format">
<option value="yyyy-mm-dd" selected>默认</option>
<option value="yy/m/dd hh:mm">09/1/28 12:33</option>
<option value="yy/m/dd">09/1/28</option>
<option value="yyyy/m/dd">2009/1/28</option>
<option value="yyyy mmmm dd hh:mm">2009 九月 28 12:33</option>
<option value="yyyy mmmm dd">2009 九月 28</option>
<option value="mmm dd hh:mm">9月 28 12:33</option>
<option value="'yy mm dd">'09 09 28</option>
<option value="mmmm dd">九月 28</option>
<option value="mmm dd">9月 28</option>
<option value="ddd yy/m/dd hh:mm">周三 09/1/28 12:33</option>
<option value="ddd yy/m/dd">周三 09/1/28</option>
<option value="ddd yy mm dd">周三 09 9月 28</option>
<option value="ddd hh:mm">周三 12:33</option>
<option value="ddd mm dd">周三 09 28</option>
<option value="ddd m/dd">周三 1/28</option>
<option value="ddd dd">周三 28</option>
<option value="m/dd">1/28</option>
<option value="dd">28</option>
<option value="hh:mm">12:33</option>
</select>
</div>
</div>
<div class="option-block">
<div class="option-row">
<label class="option-checkbox active" id="round-bar">条形对齐到整天</label>
<div class="option-info">* 复选框切换是否将条形对齐到整天。</div>
</div>
</div>
<div class="option-row">
<input type="button" id="set-layout" class="option-button" value="设置布局" />
</div>
</div>
</div>
</html>

.options-container {
float: right;
width: 280px;
padding: 12px;
height: 100%;
box-sizing: border-box;
background: #fbfbfb;
overflow: auto;
box-shadow: inset 0px 0 4px 0 rgba(0,0,0,0.4);
}
.option-block {
background: #fff;
padding: 8px;
margin: 12px 0;
border-radius: 4px;
border: 1px dashed #82bc00;
box-shadow: 0px 0 6px 0 rgba(0,0,0,0.1);
}
.option-block.toggle {
border: 1px dotted #f7a711;
}
.option-row {
font-size: 14px;
box-sizing: border-box;
padding: 4px 0;
}
.option-title {
font-weight: bold;
color: #656565;
}
.option-info {
font-size: 12px;
color: #919191;
margin-top: 6px;
font-weight: normal;
}
.option-info.valid {
color: #82bc00;
}
.option-info.toggle {
color: #f7a711;
}
.option-button {
width: 100%;
padding: 0;
line-height: 20px;
background: #82bc00;
color: #fff;
transition: 0.3s;
cursor: pointer;
outline: none;
border-radius: 4px;
box-sizing: border-box;
box-shadow: 0 1px 4px 0 rgba(0,0,0,0.3);
border: none;
}
.option-button:hover {
background: #82bc00;
color: #fff;
box-shadow: 0 3px 8px 0 rgba(0,0,0,0.4);
}
.option-checkbox {
background: #fff;
border: 1px dashed #f7a711;
color: #f7a711;
padding: 2px 4px;
transition: 0.3s;
box-sizing: border-box;
cursor: pointer;
}
.option-checkbox.active {
color: #fff;
background: #f7a711;
box-shadow: 0 1px 4px 0 rgba(0,0,0,0.3);
border-radius: 4px;
}
.selection-box {
position: relative;
}
.selection-box > select {
text-align: left;
width: 100%;
height: 20px;
padding: 0;
line-height: 20px;
background: transparent;
border: none;
border-bottom: 2px solid #656565;
color: #656565;
transition: 0.3s;
cursor: pointer;
outline: none;
box-sizing: border-box;
}
.selection-box > select > option {
background: white;
}
.selection-box > select:focus {
border-bottom: 2px solid #82bc00;
color: #82bc00;
box-shadow: 0 2px 6px 0 rgba(0,0,0,0.3);
}
.selection-box > label {
position: absolute;
cursor: pointer;
font-size: 12px;
color: #fff;
background: #656565;
padding: 0 4px;
right: 0;
top: 6px;
box-shadow: 0 1px 4px 0 rgba(0,0,0,0.3);
}
.input-box {
position: relative;
}
.input-box > input[type=text] {
width: 100%;
background: transparent;
border: none;
color: #656565;
border-bottom: 2px solid #656565;
outline: none;
box-sizing: border-box;
transition: 0.3s;
}
.input-box > input[type=text]:focus {
color: #82bc00;
border-bottom: 2px solid #82bc00;
}
.input-box > label {
cursor: pointer;
position: absolute;
right: 0;
top: 5px;
font-size: 12px;
color: #fff;
background: #656565;
padding: 0 4px;
box-shadow: 0 1px 4px 0 rgba(0,0,0,0.3);
}

SpreadJS 在线示例