Built-in Style Rules
There are several built-in style rules for each taskbar type (GC.Spread.Sheets.GanttSheet.TaskbarStyleRuleName):
durationOnly
durationOnlyMilestone
finishOnly
finishOnlyMilestone
manualMilestone
manualProgress
manualSummary
manualTask
milestone
progress
projectSummary
startOnly
startOnlyMilestone
summary
task
You can get the style rule and change its style properties like so:
Configurable Style Properties
startShape: GC.Spread.Sheets.GanttSheet.TaskbarEndShape
startType: GC.Spread.Sheets.GanttSheet.TaskbarEndType
startColor: string
endShape: GC.Spread.Sheets.GanttSheet.TaskbarEndShape
endType: GC.Spread.Sheets.GanttSheet.TaskbarEndType
endColor: string
middleShape: GC.Spread.Sheets.GanttSheet.TaskbarMiddleShape
middlePattern: GC.Spread.Sheets.GanttSheet.TaskbarFillPattern
middleColor: string
leftText: string
rightText: string
topText: string
bottomText: string
insideText: string
Text properties like leftText support the data field name and column formula:
Custom Style Rules
You can create a custom style rule based on the base style rule class (GC.Spread.Sheets.GanttSheet.TaskbarStyleRule):
Then add your custom style rule to the taskbar style rule collection (GC.Spread.Sheets.GanttSheet.TaskbarStyleRules):
You can update an existing custom style rule:
/*REPLACE_MARKER*/
/*DO NOT DELETE THESE COMMENTS*/
import { Component, NgModule, enableProdMode } from "@angular/core";
import { BrowserModule } from "@angular/platform-browser";
import { FormsModule } from "@angular/forms";
import { platformBrowserDynamic } from "@angular/platform-browser-dynamic";
import { SpreadSheetsModule } from "@mescius/spread-sheets-angular";
import GC from '@mescius/spread-sheets';
import "@mescius/spread-sheets-tablesheet";
import "@mescius/spread-sheets-ganttsheet";
import './styles.css';
declare var SplitView: any;
@Component({
selector: 'app-component',
templateUrl: 'src/app.component.html'
})
export class AppComponent {
spread: GC.Spread.Sheets.Workbook;
ganttSheet: GC.Spread.Sheets.GanttSheet;
ruleName = "task";
startShape = "";
startType = "";
startColor = "";
middleShape = "rectangleBar";
middlePattern = "diagonalLeft";
middleColor = "#8abbed";
endShape = "";
endType = "";
endColor = "";
leftText = "";
rightText = "";
topText = "";
bottomText = "";
insideText = "";
hostStyle = {
width: '100%',
height: '100%'
};
initSpread($event: any) {
this.spread = $event.spread;
let spread = this.spread;
spread.suspendPaint();
spread.clearSheets();
this.initDataSource(spread);
this.initGanttSheet(spread);
spread.resumePaint();
initSplitView(spread);
}
initDataSource(spread) {
var tableName = "Gantt_Id";
var baseApiUrl = getBaseApiUrl();
var apiUrl = baseApiUrl + "/" + tableName;
var dataManager = spread.dataManager();
var myTable = dataManager.addTable("myTable", {
batch: true,
remote: {
read: {
url: apiUrl
}
},
schema: {
hierarchy: {
type: "Parent",
column: "parentId"
},
columns: {
id: { isPrimaryKey: true },
taskNumber: { dataType: "rowOrder" }
}
}
});
this.myTable = myTable;
}
initGanttSheet(spread) {
var ganttSheet = spread.addSheetTab(0, "GanttSheet", GC.Spread.Sheets.SheetType.ganttSheet);
var view = this.myTable.addView("ganttView", [
{ value: "taskNumber", caption: "NO.", width: 60 },
{ value: "mode", caption: "Mode", width: 65 },
{ 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);
}).then(function() {
let taskRule = ganttSheet.project.taskStyleRules.getRule("task");
let taskStyle = taskRule.style.taskbarStyle;
taskStyle.middleColor = "#abd08f";
taskRule.style.taskbarStyle = taskStyle;
let summaryRule = ganttSheet.project.taskStyleRules.getRule("summary");
let summaryStyle = summaryRule.style.taskbarStyle;
summaryStyle.middleColor = "#00b050";
summaryStyle.startShape = "leftBracket";
summaryStyle.startColor = "#578335";
summaryStyle.endShape = "rightBracket";
summaryStyle.endColor = "#578335";
summaryRule.style.taskbarStyle = summaryStyle;
});
this.ganttSheet = ganttSheet;
}
syncConfigFromStyle() {
var ganttSheet = this.ganttSheet;
var styleRuleName = this.ruleName;
var targetStyle = ganttSheet.project.taskStyleRules.getRule(styleRuleName).style.taskbarStyle;
if (targetStyle) {
this.startShape = targetStyle.startShape;
this.startType = targetStyle.startType;
this.startColor = targetStyle.startColor ? targetStyle.startColor : "";
this.middleShape = targetStyle.middleShape;
this.middlePattern = targetStyle.middlePattern;
this.middleColor = targetStyle.middleColor ? targetStyle.middleColor : "";
this.endShape = targetStyle.endShape;
this.endType = targetStyle.endType;
this.endColor = targetStyle.endColor ? targetStyle.endColor : "";
this.leftText = targetStyle.leftText || "";
this.rightText = targetStyle.rightText || "";
this.topText = targetStyle.topText || "";
this.bottomText = targetStyle.bottomText || "";
this.insideText = targetStyle.insideText || "";
}
}
getStyleFromConfig(targetStyle) {
if (!targetStyle) {
targetStyle = {};
}
targetStyle.startShape = this.startShape;
targetStyle.startType = this.startType;
targetStyle.startColor = this.startColor;
targetStyle.middleShape = this.middleShape;
targetStyle.middlePattern = this.middlePattern;
targetStyle.middleColor = this.middleColor;
targetStyle.endShape = this.endShape;
targetStyle.endType = this.endType;
targetStyle.endColor = this.endColor;
targetStyle.leftText = this.leftText;
targetStyle.rightText = this.rightText;
targetStyle.topText = this.topText;
targetStyle.bottomText = this.bottomText;
targetStyle.insideText = this.insideText;
return targetStyle;
}
setStyle() {
var ganttSheet = this.ganttSheet;
ganttSheet.suspendPaint();
var styleRuleName = this.ruleName;
var targetStyleRule = ganttSheet.project.taskStyleRules.getRule(styleRuleName);
let ruleType = ["task", "milestone", "summary", "projectSummary", "manualTask", "manualMilestone", "durationOnly", "manualSummary", "startOnly", "finishOnly", "durationOnlyMilestone", "startOnlyMilestone", "finishOnlyMilestone", "progress", "manualProgress"];
let style = targetStyleRule.style;
style.taskbarStyle = this.getStyleFromConfig(style.taskbarStyle);
ganttSheet.project.taskStyleRules.setItemAt(ruleType.indexOf(styleRuleName), targetStyleRule);
ganttSheet.resumePaint()
}
}
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();
}
});
}
function getBaseApiUrl() {
return window.location.href.match(/http.+spreadjs\/demos\//)[0] + 'server/api';
}
@NgModule({
imports: [BrowserModule, SpreadSheetsModule, FormsModule],
declarations: [AppComponent],
exports: [AppComponent],
bootstrap: [AppComponent]
})
export class AppModule {}
enableProdMode();
// Bootstrap application with hash style navigation and global services.
platformBrowserDynamic().bootstrapModule(AppModule);
<!doctype html>
<html style="height:100%;font-size:14px;">
<head>
<meta charset="utf-8" />
<meta name="viewport" content="width=device-width, initial-scale=1.0" />
<link rel="stylesheet" type="text/css" href="$DEMOROOT$/en/angular/node_modules/@mescius/spread-sheets/styles/gc.spread.sheets.excel2013white.css">
<link rel="stylesheet" type="text/css" href="$DEMOROOT$/spread/source/splitView/splitView.css">
<!-- Polyfills -->
<script src="$DEMOROOT$/en/angular/node_modules/core-js/client/shim.min.js"></script>
<script src="$DEMOROOT$/en/angular/node_modules/zone.js/fesm2015/zone.min.js"></script>
<!-- SystemJS -->
<script src="$DEMOROOT$/en/angular/node_modules/systemjs/dist/system.js"></script>
<script src="systemjs.config.js"></script>
<!-- plugins -->
<script src="$DEMOROOT$/spread/source/splitView/SplitView.js"></script>
<script>
// workaround to load 'rxjs/operators' from the rxjs bundle
System.import('rxjs').then(function (m) {
System.import('@angular/compiler');
System.set(SystemJS.resolveSync('rxjs/operators'), System.newModule(m.operators));
System.import('$DEMOROOT$/en/lib/angular/license.ts');
System.import('./src/app.component');
});
</script>
</head>
<body>
<app-component></app-component>
</body>
</html>
<div id="split-view" class="sample-tutorial">
<gc-spread-sheets class="sample-spreadsheets split-content" [hostStyle]="hostStyle" (workbookInitialized)="initSpread($event)"></gc-spread-sheets>
<div class="options-container split-panel">
<div class="option-row option-title">
Config the taskbar style rules.
</div>
<div class="option-block">
<div class="option-row selection-box">
<label for="rule-name">Rule Name</label>
<select id="rule-name" [(ngModel)]="ruleName" (change)="syncConfigFromStyle()">
<option value="durationOnly">durationOnly</option>
<option value="durationOnlyMilestone">durationOnlyMilestone</option>
<option value="finishOnly">finishOnly</option>
<option value="finishOnlyMilestone">finishOnlyMilestone</option>
<option value="manualMilestone">manualMilestone</option>
<option value="manualProgress">manualProgress</option>
<option value="manualSummary">manualSummary</option>
<option value="manualTask">manualTask</option>
<option value="milestone">milestone</option>
<option value="progress">progress</option>
<option value="projectSummary">projectSummary</option>
<option value="startOnly">startOnly</option>
<option value="startOnlyMilestone">startOnlyMilestone</option>
<option value="summary">summary</option>
<option value="task" selected>task</option>
</select>
</div>
<div class="option-row">
<input type="button" id="set-style" class="option-button" value="Set Taskbar Styles" (click)="setStyle()" >
</div>
</div>
<div class="option-block">
<div class="option-row option-title">
Config the taskbar style.
</div>
<div class="option-block">
<div class="option-row option-title">
Start
</div>
<div class="option-row selection-box">
<label for="start-shape">Shape</label>
<select id="start-shape" [(ngModel)]="startShape">
<option value=""></option>
<option value="arrowDown">arrowDown</option>
<option value="arrowUp">arrowUp</option>
<option value="caretDownTop">caretDownTop</option>
<option value="caretUpBottom">caretUpBottom</option>
<option value="circle">circle</option>
<option value="circleArrowDown">circleArrowDown</option>
<option value="circleArrowUp">circleArrowUp</option>
<option value="circleDiamond">circleDiamond</option>
<option value="circleTriangleDown">circleTriangleDown</option>
<option value="circleTriangleUp">circleTriangleUp</option>
<option value="diamond">diamond</option>
<option value="houseDown">houseDown</option>
<option value="houseUp">houseUp</option>
<option value="leftBracket">leftBracket</option>
<option value="leftFade">leftFade</option>
<option value="lineShape" selected>lineShape</option>
<option value="rightBracket">rightBracket</option>
<option value="rightFade">rightFade</option>
<option value="square">square</option>
<option value="star">star</option>
<option value="triangleDown">triangleDown</option>
<option value="triangleLeft">triangleLeft</option>
<option value="triangleRight">triangleRight</option>
<option value="triangleUp">triangleUp</option>
</select>
</div>
<div class="option-row selection-box">
<label for="start-type">Type</label>
<select id="start-type" [(ngModel)]="startType">
<option value=""></option>
<option value="solid" selected>solid</option>
<option value="dashed">dashed</option>
<option value="framed">framed</option>
</select>
</div>
<div class="option-row input-box">
<label for="start-color">Color</label>
<input type="text" id="start-color" [(ngModel)]="startColor" />
<div class="option-info valid">* valid value: color string</div>
</div>
</div>
<div class="option-block">
<div class="option-row option-title">
Middle
</div>
<div class="option-row selection-box">
<label for="middle-shape">Shape</label>
<select id="middle-shape" [(ngModel)]="middleShape">
<option value=""></option>
<option value="lineBottom">lineBottom</option>
<option value="lineMiddle">lineMiddle</option>
<option value="lineTop">lineTop</option>
<option value="rectangleBar" selected>rectangleBar</option>
<option value="rectangleBottom">rectangleBottom</option>
<option value="rectangleMiddle">rectangleMiddle</option>
<option value="rectangleTop">rectangleTop</option>
</select>
</div>
<div class="option-row selection-box">
<label for="middle-pattern">Fill Pattern</label>
<select id="middle-pattern" [(ngModel)]="middlePattern">
<option value=""></option>
<option value="darkFill">darkFill</option>
<option value="dashedBorder">dashedBorder</option>
<option value="diagonalCross">diagonalCross</option>
<option value="diagonalLeft" selected>diagonalLeft</option>
<option value="diagonalRight">diagonalRight</option>
<option value="hollow">hollow</option>
<option value="lightFill">lightFill</option>
<option value="lineCross">lineCross</option>
<option value="lineHorizontal">lineHorizontal</option>
<option value="lineVertical">lineVertical</option>
<option value="mediumFill">mediumFill</option>
<option value="solidFill">solidFill</option>
</select>
</div>
<div class="option-row input-box">
<label for="middle-color">Color</label>
<input type="text" id="middle-color" [(ngModel)]="middleColor" />
<div class="option-info valid">* valid value: color string</div>
</div>
</div>
<div class="option-block">
<div class="option-row option-title">
End
</div>
<div class="option-row selection-box">
<label for="end-shape">Shape</label>
<select id="end-shape" [(ngModel)]="endShape">
<option value=""></option>
<option value="arrowDown">arrowDown</option>
<option value="arrowUp">arrowUp</option>
<option value="caretDownTop">caretDownTop</option>
<option value="caretUpBottom">caretUpBottom</option>
<option value="circle">circle</option>
<option value="circleArrowDown">circleArrowDown</option>
<option value="circleArrowUp">circleArrowUp</option>
<option value="circleDiamond">circleDiamond</option>
<option value="circleTriangleDown">circleTriangleDown</option>
<option value="circleTriangleUp">circleTriangleUp</option>
<option value="diamond">diamond</option>
<option value="houseDown">houseDown</option>
<option value="houseUp">houseUp</option>
<option value="leftBracket">leftBracket</option>
<option value="leftFade">leftFade</option>
<option value="lineShape" selected>lineShape</option>
<option value="rightBracket">rightBracket</option>
<option value="rightFade">rightFade</option>
<option value="square">square</option>
<option value="star">star</option>
<option value="triangleDown">triangleDown</option>
<option value="triangleLeft">triangleLeft</option>
<option value="triangleRight">triangleRight</option>
<option value="triangleUp">triangleUp</option>
</select>
</div>
<div class="option-row selection-box">
<label for="end-type">Type</label>
<select id="end-type" [(ngModel)]="endType">
<option value=""></option>
<option value="solid" selected>solid</option>
<option value="dashed">dashed</option>
<option value="framed">framed</option>
</select>
</div>
<div class="option-row input-box">
<label for="end-color">Color</label>
<input type="text" id="end-color" [(ngModel)]="endColor" />
<div class="option-info valid">* valid value: color string</div>
</div>
</div>
</div>
<div class="option-block">
<div class="option-row option-title">
Config the taskbar text.
</div>
<div class="option-row input-box">
<label for="left-text">Left Text</label>
<input type="text" id="left-text" [(ngModel)]="leftText" />
<div class="option-info valid">* valid value: field string or column formula</div>
</div>
<div class="option-row input-box">
<label for="right-text">Right Text</label>
<input type="text" id="right-text" [(ngModel)]="rightText" />
<div class="option-info valid">* valid value: field string or column formula</div>
</div>
<div class="option-row input-box">
<label for="top-text">Top Text</label>
<input type="text" id="top-text" [(ngModel)]="topText" />
<div class="option-info valid">* valid value: field string or column formula</div>
</div>
<div class="option-row input-box">
<label for="bottom-text">Bottom Text</label>
<input type="text" id="bottom-text" [(ngModel)]="bottomText" />
<div class="option-info valid">* valid value: field string or column formula</div>
</div>
<div class="option-row input-box">
<label for="inside-text">Inside Text</label>
<input type="text" id="inside-text" [(ngModel)]="insideText" />
<div class="option-info valid">* valid value: field string or column formula</div>
</div>
</div>
</div>
</div>
.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);
}
(function (global) {
System.config({
transpiler: 'ts',
typescriptOptions: {
tsconfig: true
},
meta: {
'typescript': {
"exports": "ts"
},
'*.css': { loader: 'css' }
},
paths: {
// paths serve as alias
'npm:': 'node_modules/'
},
// map tells the System loader where to look for things
map: {
'core-js': 'npm:core-js/client/shim.min.js',
'zone': 'npm:zone.js/fesm2015/zone.min.js',
'rxjs': 'npm:rxjs/dist/bundles/rxjs.umd.min.js',
'@angular/core': 'npm:@angular/core/fesm2022',
'@angular/common': 'npm:@angular/common/fesm2022/common.mjs',
'@angular/compiler': 'npm:@angular/compiler/fesm2022/compiler.mjs',
'@angular/platform-browser': 'npm:@angular/platform-browser/fesm2022/platform-browser.mjs',
'@angular/platform-browser-dynamic': 'npm:@angular/platform-browser-dynamic/fesm2022/platform-browser-dynamic.mjs',
'@angular/common/http': 'npm:@angular/common/fesm2022/http.mjs',
'@angular/router': 'npm:@angular/router/fesm2022/router.mjs',
'@angular/forms': 'npm:@angular/forms/fesm2022/forms.mjs',
'jszip': 'npm:jszip/dist/jszip.min.js',
'typescript': 'npm:typescript/lib/typescript.js',
'ts': './plugin.js',
'tslib':'npm:tslib/tslib.js',
'css': 'npm:systemjs-plugin-css/css.js',
'plugin-babel': 'npm:systemjs-plugin-babel/plugin-babel.js',
'systemjs-babel-build':'npm:systemjs-plugin-babel/systemjs-babel-browser.js',
'@mescius/spread-sheets': 'npm:@mescius/spread-sheets/index.js',
'@mescius/spread-sheets-tablesheet': 'npm:@mescius/spread-sheets-tablesheet/index.js',
'@mescius/spread-sheets-ganttsheet': 'npm:@mescius/spread-sheets-ganttsheet/index.js',
'@mescius/spread-sheets-angular': 'npm:@mescius/spread-sheets-angular/fesm2020/mescius-spread-sheets-angular.mjs',
'@grapecity/jsob-test-dependency-package/react-components': 'npm:@grapecity/jsob-test-dependency-package/react-components/index.js'
},
// packages tells the System loader how to load when no filename and/or no extension
packages: {
src: {
defaultExtension: 'ts'
},
rxjs: {
defaultExtension: 'js'
},
"node_modules": {
defaultExtension: 'js'
},
"node_modules/@angular": {
defaultExtension: 'mjs'
},
"@mescius/spread-sheets-angular": {
defaultExtension: 'mjs'
},
'@angular/core': {
defaultExtension: 'mjs',
main: 'core.mjs'
}
}
});
})(this);