egroupware/etemplate/js/et2_widget_gantt.js
Nathan Gray 175d6b7201 - Change zoom auto level to better suit projects a day or two long
- Reset start/end dates when changing data
2014-08-18 22:55:54 +00:00

798 lines
22 KiB
JavaScript

/**
* EGroupware eTemplate2 - JS widget for GANTT chart
*
* @license http://opensource.org/licenses/gpl-license.php GPL - GNU General Public License
* @package etemplate
* @subpackage api
* @link http://www.egroupware.org
* @author Nathan Gray
* @copyright Nathan Gray 2014
* @version $Id$
*/
"use strict";
/*egw:uses
jsapi.jsapi;
jquery.jquery;
/phpgwapi/js/dhtmlxtree/codebase/dhtmlxcommon.js; // otherwise gantt breaks
/phpgwapi/js/dhtmlxGantt/codebase/dhtmlxgantt.js;
et2_core_inputWidget;
*/
/**
* Gantt chart
*
* The gantt widget allows children, which are displayed as a header. Any child input
* widgets are bound as live filters on existing data. The filter is done based on
* widget ID, such that the value of the widget must match that attribute in the task
* or the task will not be displayed. There is special handling for
* date widgets with IDs 'start_date' and 'end_date' to filter as an inclusive range
* instead of simple equality.
*
* @see http://docs.dhtmlx.com/gantt/index.html
* @augments et2_valueWidget
*/
var et2_gantt = et2_valueWidget.extend([et2_IResizeable,et2_IInput],
{
// Filters are inside gantt namespace
createNamespace: true,
attributes: {
"autoload": {
"name": "Autoload",
"type": "string",
"default": "",
"description": "JSON URL or menuaction to be called for projects with no, GET parameter selected contains id"
},
"ajax_update": {
"name": "AJAX update method",
"type": "string",
"default": "",
"description": "AJAX menuaction to be called when the user changes a task. The function should take two parameters: the updated element, and all template values."
},
value: {type: 'any'}
},
// Common configuration for Egroupware/eTemplate
gantt_config: {
// Gantt takes a different format of date format, all the placeholders are prefixed with '%'
api_date: '%Y-%n-%d %H:%i:%s',
xml_date: '%Y-%n-%d %H:%i:%s',
// Duration is a unitless field. This is the unit.
duration_unit: 'minute',
show_progress: true,
order_branch: true,
min_column_width: 30,
fit_tasks: true,
autosize: '',
// Date rounding happens either way, but this way it rounds to the displayed grid resolution
// Also avoids a potential infinite loop thanks to how the dates are rounded with false
round_dnd_dates: false,
// Round resolution
time_step: parseInt(this.egw().preference('interval','calendar') || 15),
min_duration: 1 * 60 * 1000, // 1 minute
scale_unit: 'day',
date_scale: '%d',
subscales: [
{unit:"month", step:1, date:"%F, %Y"},
//{unit:"hour", step:1, date:"%G"}
],
columns: [
{name: "text", label: egw.lang('Title'), tree: true, width: '*'}
]
},
init: function(_parent, _attrs) {
// _super.apply is responsible for the actual setting of the params (some magic)
this._super.apply(this, arguments);
// Gantt instance
this.gantt = null;
// DOM Nodes
this.filters = $j(document.createElement("div"))
.addClass('et2_gantt_header');
this.gantt_node = $j('<div style="width:100%;height:100%"></div>');
this.htmlNode = $j(document.createElement("div"))
.css('height', this.options.height)
.addClass('et2_gantt');
this.htmlNode.prepend(this.filters);
this.htmlNode.append(this.gantt_node);
// Create the dynheight component which dynamically scales the inner
// container.
this.dynheight = new et2_dynheight(
this.getParent().getDOMNode(this.getParent()) || this.getInstanceManager().DOMContainer,
this.gantt_node, 300
);
this.setDOMNode(this.htmlNode[0]);
},
destroy: function() {
if(this.gantt !== null)
{
this.gantt.detachAllEvents();
this.gantt.clearAll();
this.gantt = null;
// Destroy dynamic full-height
if(this.dynheight) this.dynheight.free();
this._super.apply(this, arguments);}
this.htmlNode.remove();
this.htmlNode = null;
},
doLoadingFinished: function() {
this._super.apply(this, arguments);
if(this.gantt != null) return false;
var config = jQuery.extend({}, this.gantt_config);
// Set initial values for start and end, if those filters exist
var start_date = this.getWidgetById('start_date');
var end_date = this.getWidgetById('end_date');
if(start_date)
{
config.start_date = start_date.getValue() ? new Date(start_date.getValue() * 1000) : null;
}
if(end_date)
{
config.end_date = end_date.getValue() ? new Date(end_date.getValue() * 1000): null;
}
// Initialize chart
this.gantt = this.gantt_node.dhx_gantt(config);
if(this.options.value)
{
this.set_value(this.options.value);
}
// Update start & end dates with chart values for consistency
if(start_date)
{
start_date.set_value(this.gantt.getState().min_date);
}
if(end_date)
{
end_date.set_value(this.gantt.getState().max_date);
}
// Bind some events to make things nice and et2
this._bindGanttEvents();
// Bind filters
this._bindChildren();
return true;
},
getDOMNode: function(_sender) {
// Return filter container for children
if (_sender != this && this._children.indexOf(_sender) != -1)
{
return this.filters[0];
}
// Normally simply return the main div
return this._super.apply(this, arguments);
},
/**
* Implement the et2_IResizable interface to resize
*/
resize: function()
{
if(this.dynheight)
{
this.dynheight.update(function(w,h) {
if(this.gantt)
{
this.gantt.setSizes();
}
}, this);
}
else
{
this.gantt.setSizes();
}
},
/**
* Sets the data to be displayed in the gantt chart.
*
* Data is a JSON object with 'data' and 'links', both of which are arrays.
* {
* data:[
* {id:1, text:"Project #1", start_date:"01-04-2013", duration:18},
* {id:2, text:"Task #1", start_date:"02-04-2013", duration:8, parent:1},
* {id:3, text:"Task #2", start_date:"11-04-2013", duration:8, parent:1}
* ],
* links:[
* {id:1, source:1, target:2, type:"1"},
* {id:2, source:2, target:3, type:"0"}
* ]
* };
* Any additional data can be included and used, but the above is the minimum
* required data.
*
* @see http://docs.dhtmlx.com/gantt/desktop__loading.html
*/
set_value: function(value) {
if(this.gantt == null) return false;
this.gantt.clearAll();
// Ensure proper format, no extras
var safe_value = {
data: value.data || [],
links: value.links || []
};
this.gantt.config.start_date = null;
this.gantt.config.end_date = null;
this.gantt.parse(safe_value);
// Set some things from the value
// Set zoom
if(!this.options.zoom) this.set_zoom();
// If this is not the first gantt chart the browser renders, sometimes it needs a nudge
try
{
this.gantt.render();
}
catch (e)
{
this.egw().debug('warning', 'Problem rendering gantt', e);
}
},
/**
* getValue has to return the value of the input widget
*/
getValue: function() {
return this.value;
},
/**
* Is dirty returns true if the value of the widget has changed since it
* was loaded.
*/
isDirty: function() {
return this.value != null;
},
/**
* Causes the dirty flag to be reseted.
*/
resetDirty: function() {
this.value = null;
},
/**
* Checks the data to see if it is valid, as far as the client side can tell.
* Return true if it's not possible to tell on the client side, because the server
* will have the chance to validate also.
*
* The messages array is to be populated with everything wrong with the data,
* so don't stop checking after the first problem unless it really makes sense
* to ignore other problems.
*
* @param {String[]} messages List of messages explaining the failure(s).
* messages should be fairly short, and already translated.
*
* @return {boolean} True if the value is valid (enough), false to fail
*/
isValid: function(messages) {return true},
/**
* Set a URL to fetch the data from the server.
* Data must be in the specified format.
* @see http://docs.dhtmlx.com/gantt/desktop__loading.html
*/
set_autoload: function(url) {
if(this.gantt == null) return false;
this.options.autoloading = url;
throw new Exception('Not implemented yet - apparently loading segments is not supported automatically');
},
/**
* Sets the level of detail for the chart, which adjusts the scale(s) across the
* top and the granularity of the drag grid.
*
* Gantt chart needs a render() after changing.
*
* @param {int} level Higher levels show more grid, at larger granularity.
* @return {int} Current level
*/
set_zoom: function(level) {
var subscales = [];
var scale_unit = 'day';
var date_scale = '%d';
var step = 1;
var time_step = this.gantt_config.time_step;
var min_column_width = this.gantt_config.min_column_width;
// No level? Auto calculate.
if(level > 4) level = 4;
if(!level || level < 1) {
// Make sure we have the most up to date info for the calculations
// There may be a more efficient way to trigger this though
try {
this.gantt.render();
}
catch (e)
{}
var difference = (this.gantt.getState().max_date - this.gantt.getState().min_date)/1000; // seconds
// Spans more than a year
if(difference > 31536000 || this.gantt.getState().max_date.getFullYear() != this.gantt.getState().min_date.getFullYear())
{
level = 4;
}
// More than 2 months
else if(difference > 5256000 || this.gantt.getState().max_date.getMonth() != this.gantt.getState().min_date.getMonth())
{
level = 3;
}
// More than 1 day
else if (difference > 86400)
{
level = 2;
}
else
{
level = 1;
}
}
// Adjust Gantt settings for specified level
switch(level)
{
case 4:
// A year or more, scale in weeks
subscales.push({unit: "month", step: 1, date: '%F %Y'});
scale_unit = 'week';
date_scale= '#%W';
break;
case 3:
// Less than a year, several months
subscales.push({unit: "month", step: 1, date: '%F %Y', class: 'et2_clickable'});
break;
case 2:
default:
// About a month
subscales.push({unit: "day", step: 1, date: '%F %d'});
scale_unit = 'hour';
date_scale = this.egw().preference('timeformat') == '24' ? "%G" : "%g";
break;
case 1: // A day or two, scale in Minutes
subscales.push({unit: "day", step: 1, date: '%F %d'});
date_scale = this.egw().preference('timeformat') == '24' ? "%G:%i" : "%g:%i";
step = parseInt(this.egw().preference('interval','calendar') || 15);
time_step = 1;
scale_unit = 'minute';
min_column_width = 50;
break;
}
// Apply settings
this.gantt.config.subscales = subscales;
this.gantt.config.scale_unit = scale_unit;
this.gantt.config.date_scale = date_scale;
this.gantt.config.step = step;
this.gantt.config.time_step = time_step;
this.gantt.config.min_column_width = min_column_width;
this.options.zoom = level;
return level;
},
/**
* Bind all the internal gantt events for nice widget actions
*/
_bindGanttEvents: function() {
var gantt_widget = this;
// After the chart renders, resize to make sure it's all showing
this.gantt.attachEvent("onGanttRender", function() {
// Timeout gets around delayed rendering
window.setTimeout(function() {
gantt_widget.resize();
},100);
});
// Click on scale to zoom - top zooms out, bottom zooms in
this.gantt_node.on('click','.gantt_scale_line', function(e) {
var current_position = e.target.offsetLeft / $j(e.target.parentNode).width();
// Some crazy stuff make sure timing is OK to scroll after re-render
// TODO: Make this more consistently go to where you click
var id = gantt_widget.gantt.attachEvent("onGanttRender", function() {
console.log('Render');
gantt_widget.gantt.detachEvent(id);
gantt_widget.gantt.scrollTo(parseInt($j('.gantt_task_scale',gantt_widget.gantt_node).width() *current_position),0);
window.setTimeout(function() {
console.log("Scroll to");
gantt_widget.gantt.scrollTo(parseInt($j('.gantt_task_scale',gantt_widget.gantt_node).width() *current_position),0);
},100);
});
if(this.parentNode.firstChild == this)
{
// Zoom out
gantt_widget.set_zoom(gantt_widget.options.zoom + 1);
gantt_widget.gantt.render();
}
else if (gantt_widget.options.zoom > 1)
{
// Zoom in
gantt_widget.set_zoom(gantt_widget.options.zoom - 1);
gantt_widget.gantt.render();
}
/*
window.setTimeout(function() {
console.log("Scroll to");
gantt_widget.gantt.scrollTo(parseInt($j('.gantt_task_scale',gantt_widget.gantt_node).width() *current_position),0);
},50);
*/
});
this.gantt.attachEvent("onContextMenu",function(taskId, linkId, e) {
if(taskId)
{
gantt_widget._link_task(taskId);
}
else if (linkId)
{
this._delete_link_handler(linkId,e)
e.stopPropagation();
}
return false;
})
// Double click
this.gantt.attachEvent("onBeforeLightbox", function(id) {
gantt_widget._link_task(id);
// Don't do gantt default actions, actions handle it
return false;
});
// Update server after dragging a task
this.gantt.attachEvent("onAfterTaskDrag", function(id, mode, e) {
var task = jQuery.extend({},this.getTask(id));
// Gantt chart deals with dates as Date objects, format as server likes
var date_parser = this.date.date_to_str(this.config.api_date);
if(task.start_date) task.start_date = date_parser(task.start_date);
if(task.end_date) task.end_date = date_parser(task.end_date);
var value = gantt_widget.getInstanceManager().getValues(gantt_widget.getInstanceManager().widgetContainer);
if(gantt_widget.options.ajax_update)
{
var request = gantt_widget.egw().json(gantt_widget.options.ajax_update,
[task,value]
).sendRequest(true);
}
});
// Update server for links
var link_update = function(id, link) {
if(gantt_widget.options.ajax_update)
{
link.parent = this.getTask(link.source).parent;
var value = gantt_widget.getInstanceManager().getValues(gantt_widget.getInstanceManager().widgetContainer);
var request = gantt_widget.egw().json(gantt_widget.options.ajax_update,
[link,value], function(new_id) {
if(new_id)
{
link.id = new_id;
}
}
).sendRequest(true);
}
};
this.gantt.attachEvent("onAfterLinkAdd", link_update);
this.gantt.attachEvent("onAfterLinkDelete", link_update);
// Bind AJAX for dynamic expansion
// TODO: This could be improved
this.gantt.attachEvent("onTaskOpened", function(id, item) {
var task = this.getTask(id);
// Node children are already there & displayed
var value = gantt_widget.getInstanceManager().getValues(gantt_widget.getInstanceManager().widgetContainer);
var request = gantt_widget.egw().json(gantt_widget.options.autoload,
[id,value,task.parent||false],
function(data) {
this.parse(data);
},
this,true,this
).sendRequest();
});
// Filters
this.gantt.attachEvent("onBeforeTaskDisplay", function(id, task) {
var display = true;
gantt_widget.iterateOver(function(_widget){
switch(_widget.id)
{
// Start and end date are an interval. Also update the chart to
// display those dates. Special handling because date widgets give
// value in timestamp (seconds), gantt wants Date object (ms)
case 'end_date':
if(_widget.getValue())
{
display = display && ((task['start_date'].valueOf() / 1000) < _widget.getValue() + 86400 );
}
return;
case 'start_date':
// End date is not actually a required field, so accept undefined too
if(_widget.getValue())
{
display = display && (typeof task['end_date'] == 'undefined' || !task['end_date'] || ((task['end_date'].valueOf() / 1000) >= _widget.getValue()));
}
return;
}
// Regular equality comparison
if(_widget.getValue() && typeof task[_widget.id] != 'undefined')
{
if (task[_widget.id] != _widget.getValue())
{
display = false;
}
// Special comparison for objects, any intersection is a match
if(!display && typeof task[_widget.id] == 'object' || typeof _widget.getValue() == 'object')
{
var a = typeof task[_widget.id] == 'object' ? task[_widget.id] : _widget.getValue();
var b = a == task[_widget.id] ? _widget.getValue() : task[_widget.id];
if(typeof b == 'object')
{
display = jQuery.map(a,function(x) {
return jQuery.inArray(x,b) >= 0;
});
}
else
{
display = jQuery.inArray(b,a) >= 0;
}
}
}
},gantt_widget, et2_inputWidget);
return display;
});
},
/**
* Bind onchange for any child input widgets
*/
_bindChildren: function() {
var gantt_widget = this;
this.iterateOver(function(_widget){
// Existing change function
var widget_change = _widget.change;
var change = function(_node) {
// Call previously set change function
var result = widget_change.call(_widget,_node);
// Update filters
if(result) {
// Update dirty
_widget._oldValue = _widget.getValue();
// Start date & end date change the display
if(_widget.id == 'start_date' || _widget.id == 'end_date')
{
var start = this.getWidgetById('start_date');
var end = this.getWidgetById('end_date');
gantt_widget.gantt.config.start_date = start && start.getValue() ? new Date(start.getValue() * 1000) : gantt_widget.gantt.getState().min_date;
// End date is inclusive
gantt_widget.gantt.config.end_date = end && end.getValue() ? new Date((end.getValue()+86400) * 1000) : gantt_widget.gantt.getState().max_date;
if(gantt_widget.gantt.config.end_date <= gantt_widget.gantt.config.start_date)
{
gantt_widget.gantt.config.end_date = null;
if(end) end.set_value(null);
}
gantt_widget.set_zoom();
gantt_widget.gantt.render();
}
gantt_widget.gantt.refreshData();
}
// In case this gets bound twice, it's important to return
return true;
};
if(_widget.change != change) _widget.change = change;
}, this, et2_inputWidget);
},
/**
* Link the actions to the DOM nodes / widget bits.
* Overridden to make the gantt chart a container, so it can't be selected.
* Because the chart handles its own AJAX fetching and parsing, for this widget
* we're trying dynamic binding as needed, rather than binding every single task
*
* @param {object} actions {ID: {attributes..}+} map of egw action information
*/
_link_actions: function(actions)
{
this._super.apply(this, arguments);
// Submit with most actions
this._actionManager.setDefaultExecute(jQuery.proxy(function(action, selected) {
var ids = [];
for(var i = 0; i < selected.length; i++)
{
ids.push(selected[i].id);
}
this.value = {
action: action.id,
selected: ids
};
// downloads need a regular submit via POST (no Ajax)
if (action.data.postSubmit)
{
this.getInstanceManager().postSubmit();
}
else
{
this.getInstanceManager().submit();
}
}, this));
// Get the top level element for the tree
var objectManager = egw_getAppObjectManager(true);
var widget_object = objectManager.getObjectById(this.id);
widget_object.flags = EGW_AO_FLAG_IS_CONTAINER;
},
/**
* Bind a single task as needed to the action system. This is instead of binding
* every single task at the start.
*
* @param {string} taskId
*/
_link_task: function(taskId)
{
if(!taskId) return;
var objectManager = egw_getObjectManager(this.id,false);
var obj = null;
if(!(obj = objectManager.getObjectById(taskId)))
{
obj = objectManager.addObject(taskId, this.dhtmlxGanttItemAOI(this.gantt,taskId));
obj.data = this.gantt.getTask(taskId);
obj.updateActionLinks(objectManager.actionLinks)
}
objectManager.setAllSelected(false);
obj.setSelected(true);
objectManager.updateSelectedChildren(obj,true)
},
/**
* ActionObjectInterface for gantt chart
*/
dhtmlxGanttItemAOI: function(gantt, task_id)
{
var aoi = new egwActionObjectInterface();
// Retrieve the actual node from the chart
aoi.node = gantt.getTaskNode(task_id);
aoi.id = task_id;
aoi.doGetDOMNode = function() {
return aoi.node;
}
aoi.doTriggerEvent = function(_event) {
if (_event == EGW_AI_DRAG_OVER)
{
$j(this.node).addClass("draggedOver");
}
if (_event == EGW_AI_DRAG_OUT)
{
$j(this.node).removeClass("draggedOver");
}
}
aoi.doSetState = function(_state) {
if(!gantt || !gantt.isTaskExists(this.id)) return;
if(egwBitIsSet(_state, EGW_AO_STATE_SELECTED))
{
gantt.selectTask(this.id); // false = do not trigger onSelect
}
else
{
gantt.unselectTask(this.id);
}
}
return aoi;
}
});
et2_register_widget(et2_gantt, ["gantt"]);
/**
* Common look, feel & settings for all Gantt charts
*/
// Localize to user's language - breaks if file is not there
//egw.includeJS("/phpgwapi/js/dhtmlxGantt/codebase/locale/locale_" + egw.preference('lang') + ".js");
$j(function() {
// Set icon to match application
gantt.templates.grid_file = function(item) {
if(!item.pe_icon || !egw.image(item.pe_icon)) return "<div class='gantt_tree_icon gantt_file'></div>";
return "<div class='gantt_tree_icon' style='background-image: url(\"" + egw.image(item.pe_icon) + "\");'/></div>";
}
// CSS for scale row, turns on clickable
gantt.templates.scale_row_class = function(scale) {
if(scale.unit != 'minute' && scale.unit != 'month')
{
return scale.class || 'et2_clickable';
}
return scale.class;
}
// Include progress text in the bar
gantt.templates.progress_text = function(start, end, task) {
return "<span>"+Math.round(task.progress*100)+ "% </span>";
};
// Highlight weekends
gantt.templates.scale_cell_class = function(date){
if(date.getDay()==0||date.getDay()==6){
return "weekend";
}
};
gantt.templates.task_cell_class = function(item,date){
if(date.getDay()==0||date.getDay()==6){
return "weekend"
}
};
// Link styling
gantt.templates.link_class = function(link) {
var link_class = '';
var source = gantt.getTask(link.source);
var target = gantt.getTask(link.target);
var valid = true;
var types = gantt.config.links;
switch (link.type)
{
case types.finish_to_start:
valid = (source.end_date <= target.start_date)
break;
case types.start_to_start:
valid = (source.start_date <= target.start_date);
break;
case types.finish_to_finish:
valid = (source.end_date >= target.end_date);
break;
case types.start_to_finish:
valid = (source.start_date >= target.end_date)
break;
}
link_class += valid ? '' : 'invalid_constraint';
return link_class;
}
});