vis.js is a dynamic, browser-based visualization library
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.

12171 lines
366 KiB

11 years ago
11 years ago
11 years ago
11 years ago
11 years ago
11 years ago
11 years ago
11 years ago
11 years ago
11 years ago
11 years ago
11 years ago
11 years ago
11 years ago
11 years ago
11 years ago
11 years ago
11 years ago
11 years ago
11 years ago
11 years ago
11 years ago
11 years ago
11 years ago
11 years ago
11 years ago
11 years ago
11 years ago
11 years ago
11 years ago
11 years ago
11 years ago
11 years ago
11 years ago
11 years ago
11 years ago
11 years ago
11 years ago
11 years ago
11 years ago
11 years ago
11 years ago
11 years ago
11 years ago
11 years ago
11 years ago
11 years ago
11 years ago
11 years ago
11 years ago
11 years ago
11 years ago
11 years ago
11 years ago
11 years ago
11 years ago
11 years ago
11 years ago
11 years ago
11 years ago
11 years ago
11 years ago
11 years ago
11 years ago
11 years ago
11 years ago
11 years ago
11 years ago
11 years ago
11 years ago
11 years ago
11 years ago
11 years ago
11 years ago
11 years ago
11 years ago
11 years ago
11 years ago
11 years ago
11 years ago
11 years ago
11 years ago
11 years ago
11 years ago
11 years ago
11 years ago
11 years ago
11 years ago
11 years ago
11 years ago
11 years ago
11 years ago
11 years ago
11 years ago
11 years ago
11 years ago
11 years ago
11 years ago
11 years ago
11 years ago
11 years ago
11 years ago
11 years ago
11 years ago
11 years ago
11 years ago
11 years ago
11 years ago
11 years ago
11 years ago
11 years ago
11 years ago
11 years ago
11 years ago
11 years ago
11 years ago
11 years ago
11 years ago
11 years ago
11 years ago
11 years ago
11 years ago
11 years ago
11 years ago
11 years ago
11 years ago
11 years ago
11 years ago
11 years ago
11 years ago
11 years ago
11 years ago
11 years ago
11 years ago
11 years ago
11 years ago
11 years ago
11 years ago
11 years ago
11 years ago
11 years ago
11 years ago
11 years ago
11 years ago
11 years ago
11 years ago
11 years ago
11 years ago
11 years ago
11 years ago
11 years ago
11 years ago
11 years ago
11 years ago
11 years ago
11 years ago
11 years ago
11 years ago
11 years ago
11 years ago
11 years ago
11 years ago
11 years ago
11 years ago
11 years ago
11 years ago
11 years ago
11 years ago
11 years ago
11 years ago
11 years ago
11 years ago
11 years ago
11 years ago
11 years ago
11 years ago
11 years ago
11 years ago
11 years ago
11 years ago
11 years ago
11 years ago
11 years ago
11 years ago
11 years ago
11 years ago
11 years ago
11 years ago
11 years ago
11 years ago
11 years ago
11 years ago
11 years ago
11 years ago
11 years ago
11 years ago
11 years ago
11 years ago
11 years ago
11 years ago
11 years ago
11 years ago
11 years ago
11 years ago
11 years ago
11 years ago
11 years ago
11 years ago
11 years ago
11 years ago
11 years ago
11 years ago
11 years ago
11 years ago
11 years ago
11 years ago
11 years ago
11 years ago
11 years ago
11 years ago
11 years ago
11 years ago
11 years ago
11 years ago
11 years ago
11 years ago
11 years ago
11 years ago
11 years ago
11 years ago
11 years ago
11 years ago
11 years ago
11 years ago
11 years ago
11 years ago
11 years ago
11 years ago
11 years ago
11 years ago
11 years ago
11 years ago
11 years ago
11 years ago
11 years ago
11 years ago
11 years ago
11 years ago
11 years ago
11 years ago
11 years ago
11 years ago
11 years ago
11 years ago
11 years ago
11 years ago
11 years ago
11 years ago
11 years ago
11 years ago
11 years ago
11 years ago
11 years ago
11 years ago
11 years ago
11 years ago
11 years ago
11 years ago
11 years ago
11 years ago
11 years ago
11 years ago
11 years ago
11 years ago
11 years ago
11 years ago
11 years ago
11 years ago
11 years ago
11 years ago
11 years ago
11 years ago
11 years ago
11 years ago
11 years ago
11 years ago
11 years ago
11 years ago
11 years ago
11 years ago
11 years ago
11 years ago
11 years ago
11 years ago
11 years ago
11 years ago
11 years ago
11 years ago
11 years ago
11 years ago
11 years ago
11 years ago
11 years ago
11 years ago
11 years ago
11 years ago
11 years ago
11 years ago
11 years ago
11 years ago
11 years ago
11 years ago
11 years ago
11 years ago
11 years ago
11 years ago
11 years ago
11 years ago
11 years ago
11 years ago
  1. /**
  2. * vis.js
  3. * https://github.com/almende/vis
  4. *
  5. * A dynamic, browser-based visualization library.
  6. *
  7. * @version 0.0.8
  8. * @date 2013-06-03
  9. *
  10. * @license
  11. * Copyright (C) 2011-2013 Almende B.V, http://almende.com
  12. *
  13. * Licensed under the Apache License, Version 2.0 (the "License"); you may not
  14. * use this file except in compliance with the License. You may obtain a copy
  15. * of the License at
  16. *
  17. * http://www.apache.org/licenses/LICENSE-2.0
  18. *
  19. * Unless required by applicable law or agreed to in writing, software
  20. * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
  21. * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the
  22. * License for the specific language governing permissions and limitations under
  23. * the License.
  24. */
  25. (function(e){if("function"==typeof bootstrap)bootstrap("vis",e);else if("object"==typeof exports)module.exports=e();else if("function"==typeof define&&define.amd)define(e);else if("undefined"!=typeof ses){if(!ses.ok())return;ses.makeVis=e}else"undefined"!=typeof window?window.vis=e():global.vis=e()})(function(){var define,ses,bootstrap,module,exports;
  26. return (function(e,t,n){function i(n,s){if(!t[n]){if(!e[n]){var o=typeof require=="function"&&require;if(!s&&o)return o(n,!0);if(r)return r(n,!0);throw new Error("Cannot find module '"+n+"'")}var u=t[n]={exports:{}};e[n][0].call(u.exports,function(t){var r=e[n][1][t];return i(r?r:t)},u,u.exports)}return t[n].exports}var r=typeof require=="function"&&require;for(var s=0;s<n.length;s++)i(n[s]);return i})({1:[function(require,module,exports){
  27. (function(){/**
  28. * vis.js module imports
  29. */
  30. var moment = require('moment');
  31. /**
  32. * utility functions
  33. */
  34. var util = {};
  35. /**
  36. * Test whether given object is a number
  37. * @param {*} object
  38. * @return {Boolean} isNumber
  39. */
  40. util.isNumber = function isNumber(object) {
  41. return (object instanceof Number || typeof object == 'number');
  42. };
  43. /**
  44. * Test whether given object is a string
  45. * @param {*} object
  46. * @return {Boolean} isString
  47. */
  48. util.isString = function isString(object) {
  49. return (object instanceof String || typeof object == 'string');
  50. };
  51. /**
  52. * Test whether given object is a Date, or a String containing a Date
  53. * @param {Date | String} object
  54. * @return {Boolean} isDate
  55. */
  56. util.isDate = function isDate(object) {
  57. if (object instanceof Date) {
  58. return true;
  59. }
  60. else if (util.isString(object)) {
  61. // test whether this string contains a date
  62. var match = ASPDateRegex.exec(object);
  63. if (match) {
  64. return true;
  65. }
  66. else if (!isNaN(Date.parse(object))) {
  67. return true;
  68. }
  69. }
  70. return false;
  71. };
  72. /**
  73. * Test whether given object is an instance of google.visualization.DataTable
  74. * @param {*} object
  75. * @return {Boolean} isDataTable
  76. */
  77. util.isDataTable = function isDataTable(object) {
  78. return (typeof (google) !== 'undefined') &&
  79. (google.visualization) &&
  80. (google.visualization.DataTable) &&
  81. (object instanceof google.visualization.DataTable);
  82. };
  83. /**
  84. * Create a semi UUID
  85. * source: http://stackoverflow.com/a/105074/1262753
  86. * @return {String} uuid
  87. */
  88. util.randomUUID = function randomUUID () {
  89. var S4 = function () {
  90. return Math.floor(
  91. Math.random() * 0x10000 /* 65536 */
  92. ).toString(16);
  93. };
  94. return (
  95. S4() + S4() + '-' +
  96. S4() + '-' +
  97. S4() + '-' +
  98. S4() + '-' +
  99. S4() + S4() + S4()
  100. );
  101. };
  102. /**
  103. * Extend object a with the properties of object b or a series of objects
  104. * Only properties with defined values are copied
  105. * @param {Object} a
  106. * @param {... Object} b
  107. * @return {Object} a
  108. */
  109. util.extend = function (a, b) {
  110. for (var i = 1, len = arguments.length; i < len; i++) {
  111. var other = arguments[i];
  112. for (var prop in other) {
  113. if (other.hasOwnProperty(prop) && other[prop] !== undefined) {
  114. a[prop] = other[prop];
  115. }
  116. }
  117. }
  118. return a;
  119. };
  120. /**
  121. * Cast an object to another type
  122. * @param {Boolean | Number | String | Date | Moment | Null | undefined} object
  123. * @param {String | undefined} type Name of the type. Available types:
  124. * 'Boolean', 'Number', 'String',
  125. * 'Date', 'Moment', ISODate', 'ASPDate'.
  126. * @return {*} object
  127. * @throws Error
  128. */
  129. util.cast = function cast(object, type) {
  130. var match;
  131. if (object === undefined) {
  132. return undefined;
  133. }
  134. if (object === null) {
  135. return null;
  136. }
  137. if (!type) {
  138. return object;
  139. }
  140. if (!(typeof type === 'string') && !(type instanceof String)) {
  141. throw new Error('Type must be a string');
  142. }
  143. //noinspection FallthroughInSwitchStatementJS
  144. switch (type) {
  145. case 'boolean':
  146. case 'Boolean':
  147. return Boolean(object);
  148. case 'number':
  149. case 'Number':
  150. return Number(object);
  151. case 'string':
  152. case 'String':
  153. return String(object);
  154. case 'Date':
  155. if (util.isNumber(object)) {
  156. return new Date(object);
  157. }
  158. if (object instanceof Date) {
  159. return new Date(object.valueOf());
  160. }
  161. else if (moment.isMoment(object)) {
  162. return new Date(object.valueOf());
  163. }
  164. if (util.isString(object)) {
  165. // parse ASP.Net Date pattern,
  166. // for example '/Date(1198908717056)/' or '/Date(1198908717056-0700)/'
  167. // code from http://momentjs.com/
  168. match = ASPDateRegex.exec(object);
  169. if (match) {
  170. return new Date(Number(match[1])); // parse number
  171. }
  172. else {
  173. return moment(object).toDate(); // parse string
  174. }
  175. }
  176. else {
  177. throw new Error(
  178. 'Cannot cast object of type ' + util.getType(object) +
  179. ' to type Date');
  180. }
  181. case 'Moment':
  182. if (util.isNumber(object)) {
  183. return moment(object);
  184. }
  185. if (object instanceof Date) {
  186. return moment(object.valueOf());
  187. }
  188. else if (moment.isMoment(object)) {
  189. return moment.clone();
  190. }
  191. if (util.isString(object)) {
  192. // parse ASP.Net Date pattern,
  193. // for example '/Date(1198908717056)/' or '/Date(1198908717056-0700)/'
  194. // code from http://momentjs.com/
  195. match = ASPDateRegex.exec(object);
  196. if (match) {
  197. return moment(Number(match[1])); // parse number
  198. }
  199. else {
  200. return moment(object); // parse string
  201. }
  202. }
  203. else {
  204. throw new Error(
  205. 'Cannot cast object of type ' + util.getType(object) +
  206. ' to type Date');
  207. }
  208. case 'ISODate':
  209. if (object instanceof Date) {
  210. return object.toISOString();
  211. }
  212. else if (moment.isMoment(object)) {
  213. return object.toDate().toISOString();
  214. }
  215. else if (util.isNumber(object) || util.isString(object)) {
  216. return moment(object).toDate().toISOString();
  217. }
  218. else {
  219. throw new Error(
  220. 'Cannot cast object of type ' + util.getType(object) +
  221. ' to type ISODate');
  222. }
  223. case 'ASPDate':
  224. if (object instanceof Date) {
  225. return '/Date(' + object.valueOf() + ')/';
  226. }
  227. else if (util.isNumber(object) || util.isString(object)) {
  228. return '/Date(' + moment(object).valueOf() + ')/';
  229. }
  230. else {
  231. throw new Error(
  232. 'Cannot cast object of type ' + util.getType(object) +
  233. ' to type ASPDate');
  234. }
  235. default:
  236. throw new Error('Cannot cast object of type ' + util.getType(object) +
  237. ' to type "' + type + '"');
  238. }
  239. };
  240. var ASPDateRegex = /^\/?Date\((\-?\d+)/i;
  241. /**
  242. * Get the type of an object, for example util.getType([]) returns 'Array'
  243. * @param {*} object
  244. * @return {String} type
  245. */
  246. util.getType = function getType(object) {
  247. var type = typeof object;
  248. if (type == 'object') {
  249. if (object == null) {
  250. return 'null';
  251. }
  252. if (object instanceof Boolean) {
  253. return 'Boolean';
  254. }
  255. if (object instanceof Number) {
  256. return 'Number';
  257. }
  258. if (object instanceof String) {
  259. return 'String';
  260. }
  261. if (object instanceof Array) {
  262. return 'Array';
  263. }
  264. if (object instanceof Date) {
  265. return 'Date';
  266. }
  267. return 'Object';
  268. }
  269. else if (type == 'number') {
  270. return 'Number';
  271. }
  272. else if (type == 'boolean') {
  273. return 'Boolean';
  274. }
  275. else if (type == 'string') {
  276. return 'String';
  277. }
  278. return type;
  279. };
  280. /**
  281. * Retrieve the absolute left value of a DOM element
  282. * @param {Element} elem A dom element, for example a div
  283. * @return {number} left The absolute left position of this element
  284. * in the browser page.
  285. */
  286. util.getAbsoluteLeft = function getAbsoluteLeft (elem) {
  287. var doc = document.documentElement;
  288. var body = document.body;
  289. var left = elem.offsetLeft;
  290. var e = elem.offsetParent;
  291. while (e != null && e != body && e != doc) {
  292. left += e.offsetLeft;
  293. left -= e.scrollLeft;
  294. e = e.offsetParent;
  295. }
  296. return left;
  297. };
  298. /**
  299. * Retrieve the absolute top value of a DOM element
  300. * @param {Element} elem A dom element, for example a div
  301. * @return {number} top The absolute top position of this element
  302. * in the browser page.
  303. */
  304. util.getAbsoluteTop = function getAbsoluteTop (elem) {
  305. var doc = document.documentElement;
  306. var body = document.body;
  307. var top = elem.offsetTop;
  308. var e = elem.offsetParent;
  309. while (e != null && e != body && e != doc) {
  310. top += e.offsetTop;
  311. top -= e.scrollTop;
  312. e = e.offsetParent;
  313. }
  314. return top;
  315. };
  316. /**
  317. * Get the absolute, vertical mouse position from an event.
  318. * @param {Event} event
  319. * @return {Number} pageY
  320. */
  321. util.getPageY = function getPageY (event) {
  322. if ('pageY' in event) {
  323. return event.pageY;
  324. }
  325. else {
  326. var clientY;
  327. if (('targetTouches' in event) && event.targetTouches.length) {
  328. clientY = event.targetTouches[0].clientY;
  329. }
  330. else {
  331. clientY = event.clientY;
  332. }
  333. var doc = document.documentElement;
  334. var body = document.body;
  335. return clientY +
  336. ( doc && doc.scrollTop || body && body.scrollTop || 0 ) -
  337. ( doc && doc.clientTop || body && body.clientTop || 0 );
  338. }
  339. };
  340. /**
  341. * Get the absolute, horizontal mouse position from an event.
  342. * @param {Event} event
  343. * @return {Number} pageX
  344. */
  345. util.getPageX = function getPageX (event) {
  346. if ('pageY' in event) {
  347. return event.pageX;
  348. }
  349. else {
  350. var clientX;
  351. if (('targetTouches' in event) && event.targetTouches.length) {
  352. clientX = event.targetTouches[0].clientX;
  353. }
  354. else {
  355. clientX = event.clientX;
  356. }
  357. var doc = document.documentElement;
  358. var body = document.body;
  359. return clientX +
  360. ( doc && doc.scrollLeft || body && body.scrollLeft || 0 ) -
  361. ( doc && doc.clientLeft || body && body.clientLeft || 0 );
  362. }
  363. };
  364. /**
  365. * add a className to the given elements style
  366. * @param {Element} elem
  367. * @param {String} className
  368. */
  369. util.addClassName = function addClassName(elem, className) {
  370. var classes = elem.className.split(' ');
  371. if (classes.indexOf(className) == -1) {
  372. classes.push(className); // add the class to the array
  373. elem.className = classes.join(' ');
  374. }
  375. };
  376. /**
  377. * add a className to the given elements style
  378. * @param {Element} elem
  379. * @param {String} className
  380. */
  381. util.removeClassName = function removeClassname(elem, className) {
  382. var classes = elem.className.split(' ');
  383. var index = classes.indexOf(className);
  384. if (index != -1) {
  385. classes.splice(index, 1); // remove the class from the array
  386. elem.className = classes.join(' ');
  387. }
  388. };
  389. /**
  390. * For each method for both arrays and objects.
  391. * In case of an array, the built-in Array.forEach() is applied.
  392. * In case of an Object, the method loops over all properties of the object.
  393. * @param {Object | Array} object An Object or Array
  394. * @param {function} callback Callback method, called for each item in
  395. * the object or array with three parameters:
  396. * callback(value, index, object)
  397. */
  398. util.forEach = function forEach (object, callback) {
  399. var i,
  400. len;
  401. if (object instanceof Array) {
  402. // array
  403. for (i = 0, len = object.length; i < len; i++) {
  404. callback(object[i], i, object);
  405. }
  406. }
  407. else {
  408. // object
  409. for (i in object) {
  410. if (object.hasOwnProperty(i)) {
  411. callback(object[i], i, object);
  412. }
  413. }
  414. }
  415. };
  416. /**
  417. * Update a property in an object
  418. * @param {Object} object
  419. * @param {String} key
  420. * @param {*} value
  421. * @return {Boolean} changed
  422. */
  423. util.updateProperty = function updateProp (object, key, value) {
  424. if (object[key] !== value) {
  425. object[key] = value;
  426. return true;
  427. }
  428. else {
  429. return false;
  430. }
  431. };
  432. /**
  433. * Add and event listener. Works for all browsers
  434. * @param {Element} element An html element
  435. * @param {string} action The action, for example "click",
  436. * without the prefix "on"
  437. * @param {function} listener The callback function to be executed
  438. * @param {boolean} [useCapture]
  439. */
  440. util.addEventListener = function addEventListener(element, action, listener, useCapture) {
  441. if (element.addEventListener) {
  442. if (useCapture === undefined)
  443. useCapture = false;
  444. if (action === "mousewheel" && navigator.userAgent.indexOf("Firefox") >= 0) {
  445. action = "DOMMouseScroll"; // For Firefox
  446. }
  447. element.addEventListener(action, listener, useCapture);
  448. } else {
  449. element.attachEvent("on" + action, listener); // IE browsers
  450. }
  451. };
  452. /**
  453. * Remove an event listener from an element
  454. * @param {Element} element An html dom element
  455. * @param {string} action The name of the event, for example "mousedown"
  456. * @param {function} listener The listener function
  457. * @param {boolean} [useCapture]
  458. */
  459. util.removeEventListener = function removeEventListener(element, action, listener, useCapture) {
  460. if (element.removeEventListener) {
  461. // non-IE browsers
  462. if (useCapture === undefined)
  463. useCapture = false;
  464. if (action === "mousewheel" && navigator.userAgent.indexOf("Firefox") >= 0) {
  465. action = "DOMMouseScroll"; // For Firefox
  466. }
  467. element.removeEventListener(action, listener, useCapture);
  468. } else {
  469. // IE browsers
  470. element.detachEvent("on" + action, listener);
  471. }
  472. };
  473. /**
  474. * Get HTML element which is the target of the event
  475. * @param {Event} event
  476. * @return {Element} target element
  477. */
  478. util.getTarget = function getTarget(event) {
  479. // code from http://www.quirksmode.org/js/events_properties.html
  480. if (!event) {
  481. event = window.event;
  482. }
  483. var target;
  484. if (event.target) {
  485. target = event.target;
  486. }
  487. else if (event.srcElement) {
  488. target = event.srcElement;
  489. }
  490. if (target.nodeType != undefined && target.nodeType == 3) {
  491. // defeat Safari bug
  492. target = target.parentNode;
  493. }
  494. return target;
  495. };
  496. /**
  497. * Stop event propagation
  498. */
  499. util.stopPropagation = function stopPropagation(event) {
  500. if (!event)
  501. event = window.event;
  502. if (event.stopPropagation) {
  503. event.stopPropagation(); // non-IE browsers
  504. }
  505. else {
  506. event.cancelBubble = true; // IE browsers
  507. }
  508. };
  509. /**
  510. * Cancels the event if it is cancelable, without stopping further propagation of the event.
  511. */
  512. util.preventDefault = function preventDefault (event) {
  513. if (!event)
  514. event = window.event;
  515. if (event.preventDefault) {
  516. event.preventDefault(); // non-IE browsers
  517. }
  518. else {
  519. event.returnValue = false; // IE browsers
  520. }
  521. };
  522. util.option = {};
  523. /**
  524. * Cast a value as boolean
  525. * @param {Boolean | function | undefined} value
  526. * @param {Boolean} [defaultValue]
  527. * @returns {Boolean} bool
  528. */
  529. util.option.asBoolean = function (value, defaultValue) {
  530. if (typeof value == 'function') {
  531. value = value();
  532. }
  533. if (value != null) {
  534. return (value != false);
  535. }
  536. return defaultValue || null;
  537. };
  538. /**
  539. * Cast a value as number
  540. * @param {Boolean | function | undefined} value
  541. * @param {Number} [defaultValue]
  542. * @returns {Number} number
  543. */
  544. util.option.asNumber = function (value, defaultValue) {
  545. if (typeof value == 'function') {
  546. value = value();
  547. }
  548. if (value != null) {
  549. return Number(value) || defaultValue || null;
  550. }
  551. return defaultValue || null;
  552. };
  553. /**
  554. * Cast a value as string
  555. * @param {String | function | undefined} value
  556. * @param {String} [defaultValue]
  557. * @returns {String} str
  558. */
  559. util.option.asString = function (value, defaultValue) {
  560. if (typeof value == 'function') {
  561. value = value();
  562. }
  563. if (value != null) {
  564. return String(value);
  565. }
  566. return defaultValue || null;
  567. };
  568. /**
  569. * Cast a size or location in pixels or a percentage
  570. * @param {String | Number | function | undefined} value
  571. * @param {String} [defaultValue]
  572. * @returns {String} size
  573. */
  574. util.option.asSize = function (value, defaultValue) {
  575. if (typeof value == 'function') {
  576. value = value();
  577. }
  578. if (util.isString(value)) {
  579. return value;
  580. }
  581. else if (util.isNumber(value)) {
  582. return value + 'px';
  583. }
  584. else {
  585. return defaultValue || null;
  586. }
  587. };
  588. /**
  589. * Cast a value as DOM element
  590. * @param {HTMLElement | function | undefined} value
  591. * @param {HTMLElement} [defaultValue]
  592. * @returns {HTMLElement | null} dom
  593. */
  594. util.option.asElement = function (value, defaultValue) {
  595. if (typeof value == 'function') {
  596. value = value();
  597. }
  598. return value || defaultValue || null;
  599. };
  600. /**
  601. * load css from text
  602. * @param {String} css Text containing css
  603. */
  604. util.loadCss = function (css) {
  605. if (typeof document === 'undefined') {
  606. return;
  607. }
  608. // get the script location, and built the css file name from the js file name
  609. // http://stackoverflow.com/a/2161748/1262753
  610. // var scripts = document.getElementsByTagName('script');
  611. // var jsFile = scripts[scripts.length-1].src.split('?')[0];
  612. // var cssFile = jsFile.substring(0, jsFile.length - 2) + 'css';
  613. // inject css
  614. // http://stackoverflow.com/questions/524696/how-to-create-a-style-tag-with-javascript
  615. var style = document.createElement('style');
  616. style.type = 'text/css';
  617. if (style.styleSheet){
  618. style.styleSheet.cssText = css;
  619. } else {
  620. style.appendChild(document.createTextNode(css));
  621. }
  622. document.getElementsByTagName('head')[0].appendChild(style);
  623. };
  624. // Internet Explorer 8 and older does not support Array.indexOf, so we define
  625. // it here in that case.
  626. // http://soledadpenades.com/2007/05/17/arrayindexof-in-internet-explorer/
  627. if(!Array.prototype.indexOf) {
  628. Array.prototype.indexOf = function(obj){
  629. for(var i = 0; i < this.length; i++){
  630. if(this[i] == obj){
  631. return i;
  632. }
  633. }
  634. return -1;
  635. };
  636. try {
  637. console.log("Warning: Ancient browser detected. Please update your browser");
  638. }
  639. catch (err) {
  640. }
  641. }
  642. // Internet Explorer 8 and older does not support Array.forEach, so we define
  643. // it here in that case.
  644. // https://developer.mozilla.org/en-US/docs/JavaScript/Reference/Global_Objects/Array/forEach
  645. if (!Array.prototype.forEach) {
  646. Array.prototype.forEach = function(fn, scope) {
  647. for(var i = 0, len = this.length; i < len; ++i) {
  648. fn.call(scope || this, this[i], i, this);
  649. }
  650. }
  651. }
  652. // Internet Explorer 8 and older does not support Array.map, so we define it
  653. // here in that case.
  654. // https://developer.mozilla.org/en-US/docs/JavaScript/Reference/Global_Objects/Array/map
  655. // Production steps of ECMA-262, Edition 5, 15.4.4.19
  656. // Reference: http://es5.github.com/#x15.4.4.19
  657. if (!Array.prototype.map) {
  658. Array.prototype.map = function(callback, thisArg) {
  659. var T, A, k;
  660. if (this == null) {
  661. throw new TypeError(" this is null or not defined");
  662. }
  663. // 1. Let O be the result of calling ToObject passing the |this| value as the argument.
  664. var O = Object(this);
  665. // 2. Let lenValue be the result of calling the Get internal method of O with the argument "length".
  666. // 3. Let len be ToUint32(lenValue).
  667. var len = O.length >>> 0;
  668. // 4. If IsCallable(callback) is false, throw a TypeError exception.
  669. // See: http://es5.github.com/#x9.11
  670. if (typeof callback !== "function") {
  671. throw new TypeError(callback + " is not a function");
  672. }
  673. // 5. If thisArg was supplied, let T be thisArg; else let T be undefined.
  674. if (thisArg) {
  675. T = thisArg;
  676. }
  677. // 6. Let A be a new array created as if by the expression new Array(len) where Array is
  678. // the standard built-in constructor with that name and len is the value of len.
  679. A = new Array(len);
  680. // 7. Let k be 0
  681. k = 0;
  682. // 8. Repeat, while k < len
  683. while(k < len) {
  684. var kValue, mappedValue;
  685. // a. Let Pk be ToString(k).
  686. // This is implicit for LHS operands of the in operator
  687. // b. Let kPresent be the result of calling the HasProperty internal method of O with argument Pk.
  688. // This step can be combined with c
  689. // c. If kPresent is true, then
  690. if (k in O) {
  691. // i. Let kValue be the result of calling the Get internal method of O with argument Pk.
  692. kValue = O[ k ];
  693. // ii. Let mappedValue be the result of calling the Call internal method of callback
  694. // with T as the this value and argument list containing kValue, k, and O.
  695. mappedValue = callback.call(T, kValue, k, O);
  696. // iii. Call the DefineOwnProperty internal method of A with arguments
  697. // Pk, Property Descriptor {Value: mappedValue, : true, Enumerable: true, Configurable: true},
  698. // and false.
  699. // In browsers that support Object.defineProperty, use the following:
  700. // Object.defineProperty(A, Pk, { value: mappedValue, writable: true, enumerable: true, configurable: true });
  701. // For best browser support, use the following:
  702. A[ k ] = mappedValue;
  703. }
  704. // d. Increase k by 1.
  705. k++;
  706. }
  707. // 9. return A
  708. return A;
  709. };
  710. }
  711. // Internet Explorer 8 and older does not support Array.filter, so we define it
  712. // here in that case.
  713. // https://developer.mozilla.org/en-US/docs/JavaScript/Reference/Global_Objects/Array/filter
  714. if (!Array.prototype.filter) {
  715. Array.prototype.filter = function(fun /*, thisp */) {
  716. "use strict";
  717. if (this == null) {
  718. throw new TypeError();
  719. }
  720. var t = Object(this);
  721. var len = t.length >>> 0;
  722. if (typeof fun != "function") {
  723. throw new TypeError();
  724. }
  725. var res = [];
  726. var thisp = arguments[1];
  727. for (var i = 0; i < len; i++) {
  728. if (i in t) {
  729. var val = t[i]; // in case fun mutates this
  730. if (fun.call(thisp, val, i, t))
  731. res.push(val);
  732. }
  733. }
  734. return res;
  735. };
  736. }
  737. // Internet Explorer 8 and older does not support Object.keys, so we define it
  738. // here in that case.
  739. // https://developer.mozilla.org/en-US/docs/JavaScript/Reference/Global_Objects/Object/keys
  740. if (!Object.keys) {
  741. Object.keys = (function () {
  742. var hasOwnProperty = Object.prototype.hasOwnProperty,
  743. hasDontEnumBug = !({toString: null}).propertyIsEnumerable('toString'),
  744. dontEnums = [
  745. 'toString',
  746. 'toLocaleString',
  747. 'valueOf',
  748. 'hasOwnProperty',
  749. 'isPrototypeOf',
  750. 'propertyIsEnumerable',
  751. 'constructor'
  752. ],
  753. dontEnumsLength = dontEnums.length;
  754. return function (obj) {
  755. if (typeof obj !== 'object' && typeof obj !== 'function' || obj === null) {
  756. throw new TypeError('Object.keys called on non-object');
  757. }
  758. var result = [];
  759. for (var prop in obj) {
  760. if (hasOwnProperty.call(obj, prop)) result.push(prop);
  761. }
  762. if (hasDontEnumBug) {
  763. for (var i=0; i < dontEnumsLength; i++) {
  764. if (hasOwnProperty.call(obj, dontEnums[i])) result.push(dontEnums[i]);
  765. }
  766. }
  767. return result;
  768. }
  769. })()
  770. }
  771. // Internet Explorer 8 and older does not support Array.isArray,
  772. // so we define it here in that case.
  773. // https://developer.mozilla.org/en-US/docs/JavaScript/Reference/Global_Objects/Array/isArray
  774. if(!Array.isArray) {
  775. Array.isArray = function (vArg) {
  776. return Object.prototype.toString.call(vArg) === "[object Array]";
  777. };
  778. }
  779. // Internet Explorer 8 and older does not support Function.bind,
  780. // so we define it here in that case.
  781. // https://developer.mozilla.org/en-US/docs/JavaScript/Reference/Global_Objects/Function/bind
  782. if (!Function.prototype.bind) {
  783. Function.prototype.bind = function (oThis) {
  784. if (typeof this !== "function") {
  785. // closest thing possible to the ECMAScript 5 internal IsCallable function
  786. throw new TypeError("Function.prototype.bind - what is trying to be bound is not callable");
  787. }
  788. var aArgs = Array.prototype.slice.call(arguments, 1),
  789. fToBind = this,
  790. fNOP = function () {},
  791. fBound = function () {
  792. return fToBind.apply(this instanceof fNOP && oThis
  793. ? this
  794. : oThis,
  795. aArgs.concat(Array.prototype.slice.call(arguments)));
  796. };
  797. fNOP.prototype = this.prototype;
  798. fBound.prototype = new fNOP();
  799. return fBound;
  800. };
  801. }
  802. // https://developer.mozilla.org/en-US/docs/JavaScript/Reference/Global_Objects/Object/create
  803. if (!Object.create) {
  804. Object.create = function (o) {
  805. if (arguments.length > 1) {
  806. throw new Error('Object.create implementation only accepts the first parameter.');
  807. }
  808. function F() {}
  809. F.prototype = o;
  810. return new F();
  811. };
  812. }
  813. /**
  814. * Event listener (singleton)
  815. */
  816. // TODO: replace usage of the event listener for the EventBus
  817. var events = {
  818. 'listeners': [],
  819. /**
  820. * Find a single listener by its object
  821. * @param {Object} object
  822. * @return {Number} index -1 when not found
  823. */
  824. 'indexOf': function (object) {
  825. var listeners = this.listeners;
  826. for (var i = 0, iMax = this.listeners.length; i < iMax; i++) {
  827. var listener = listeners[i];
  828. if (listener && listener.object == object) {
  829. return i;
  830. }
  831. }
  832. return -1;
  833. },
  834. /**
  835. * Add an event listener
  836. * @param {Object} object
  837. * @param {String} event The name of an event, for example 'select'
  838. * @param {function} callback The callback method, called when the
  839. * event takes place
  840. */
  841. 'addListener': function (object, event, callback) {
  842. var index = this.indexOf(object);
  843. var listener = this.listeners[index];
  844. if (!listener) {
  845. listener = {
  846. 'object': object,
  847. 'events': {}
  848. };
  849. this.listeners.push(listener);
  850. }
  851. var callbacks = listener.events[event];
  852. if (!callbacks) {
  853. callbacks = [];
  854. listener.events[event] = callbacks;
  855. }
  856. // add the callback if it does not yet exist
  857. if (callbacks.indexOf(callback) == -1) {
  858. callbacks.push(callback);
  859. }
  860. },
  861. /**
  862. * Remove an event listener
  863. * @param {Object} object
  864. * @param {String} event The name of an event, for example 'select'
  865. * @param {function} callback The registered callback method
  866. */
  867. 'removeListener': function (object, event, callback) {
  868. var index = this.indexOf(object);
  869. var listener = this.listeners[index];
  870. if (listener) {
  871. var callbacks = listener.events[event];
  872. if (callbacks) {
  873. index = callbacks.indexOf(callback);
  874. if (index != -1) {
  875. callbacks.splice(index, 1);
  876. }
  877. // remove the array when empty
  878. if (callbacks.length == 0) {
  879. delete listener.events[event];
  880. }
  881. }
  882. // count the number of registered events. remove listener when empty
  883. var count = 0;
  884. var events = listener.events;
  885. for (var e in events) {
  886. if (events.hasOwnProperty(e)) {
  887. count++;
  888. }
  889. }
  890. if (count == 0) {
  891. delete this.listeners[index];
  892. }
  893. }
  894. },
  895. /**
  896. * Remove all registered event listeners
  897. */
  898. 'removeAllListeners': function () {
  899. this.listeners = [];
  900. },
  901. /**
  902. * Trigger an event. All registered event handlers will be called
  903. * @param {Object} object
  904. * @param {String} event
  905. * @param {Object} properties (optional)
  906. */
  907. 'trigger': function (object, event, properties) {
  908. var index = this.indexOf(object);
  909. var listener = this.listeners[index];
  910. if (listener) {
  911. var callbacks = listener.events[event];
  912. if (callbacks) {
  913. for (var i = 0, iMax = callbacks.length; i < iMax; i++) {
  914. callbacks[i](properties);
  915. }
  916. }
  917. }
  918. }
  919. };
  920. /**
  921. * An event bus can be used to emit events, and to subscribe to events
  922. * @constructor EventBus
  923. */
  924. function EventBus() {
  925. this.subscriptions = [];
  926. }
  927. /**
  928. * Subscribe to an event
  929. * @param {String | RegExp} event The event can be a regular expression, or
  930. * a string with wildcards, like 'server.*'.
  931. * @param {function} callback. Callback are called with three parameters:
  932. * {String} event, {*} [data], {*} [source]
  933. * @param {*} [target]
  934. * @returns {String} id A subscription id
  935. */
  936. EventBus.prototype.on = function (event, callback, target) {
  937. var regexp = (event instanceof RegExp) ?
  938. event :
  939. new RegExp(event.replace('*', '\\w+'));
  940. var subscription = {
  941. id: util.randomUUID(),
  942. event: event,
  943. regexp: regexp,
  944. callback: (typeof callback === 'function') ? callback : null,
  945. target: target
  946. };
  947. this.subscriptions.push(subscription);
  948. return subscription.id;
  949. };
  950. /**
  951. * Unsubscribe from an event
  952. * @param {String | Object} filter Filter for subscriptions to be removed
  953. * Filter can be a string containing a
  954. * subscription id, or an object containing
  955. * one or more of the fields id, event,
  956. * callback, and target.
  957. */
  958. EventBus.prototype.off = function (filter) {
  959. var i = 0;
  960. while (i < this.subscriptions.length) {
  961. var subscription = this.subscriptions[i];
  962. var match = true;
  963. if (filter instanceof Object) {
  964. // filter is an object. All fields must match
  965. for (var prop in filter) {
  966. if (filter.hasOwnProperty(prop)) {
  967. if (filter[prop] !== subscription[prop]) {
  968. match = false;
  969. }
  970. }
  971. }
  972. }
  973. else {
  974. // filter is a string, filter on id
  975. match = (subscription.id == filter);
  976. }
  977. if (match) {
  978. this.subscriptions.splice(i, 1);
  979. }
  980. else {
  981. i++;
  982. }
  983. }
  984. };
  985. /**
  986. * Emit an event
  987. * @param {String} event
  988. * @param {*} [data]
  989. * @param {*} [source]
  990. */
  991. EventBus.prototype.emit = function (event, data, source) {
  992. for (var i =0; i < this.subscriptions.length; i++) {
  993. var subscription = this.subscriptions[i];
  994. if (subscription.regexp.test(event)) {
  995. if (subscription.callback) {
  996. subscription.callback(event, data, source);
  997. }
  998. }
  999. }
  1000. };
  1001. /**
  1002. * DataSet
  1003. *
  1004. * Usage:
  1005. * var dataSet = new DataSet({
  1006. * fieldId: '_id',
  1007. * fieldTypes: {
  1008. * // ...
  1009. * }
  1010. * });
  1011. *
  1012. * dataSet.add(item);
  1013. * dataSet.add(data);
  1014. * dataSet.update(item);
  1015. * dataSet.update(data);
  1016. * dataSet.remove(id);
  1017. * dataSet.remove(ids);
  1018. * var data = dataSet.get();
  1019. * var data = dataSet.get(id);
  1020. * var data = dataSet.get(ids);
  1021. * var data = dataSet.get(ids, options, data);
  1022. * dataSet.clear();
  1023. *
  1024. * A data set can:
  1025. * - add/remove/update data
  1026. * - gives triggers upon changes in the data
  1027. * - can import/export data in various data formats
  1028. *
  1029. * @param {Object} [options] Available options:
  1030. * {String} fieldId Field name of the id in the
  1031. * items, 'id' by default.
  1032. * {Object.<String, String} fieldTypes
  1033. * A map with field names as key,
  1034. * and the field type as value.
  1035. * @constructor DataSet
  1036. */
  1037. function DataSet (options) {
  1038. this.id = util.randomUUID();
  1039. this.options = options || {};
  1040. this.data = {}; // map with data indexed by id
  1041. this.fieldId = this.options.fieldId || 'id'; // name of the field containing id
  1042. this.fieldTypes = {}; // field types by field name
  1043. if (this.options.fieldTypes) {
  1044. for (var field in this.options.fieldTypes) {
  1045. if (this.options.fieldTypes.hasOwnProperty(field)) {
  1046. var value = this.options.fieldTypes[field];
  1047. if (value == 'Date' || value == 'ISODate' || value == 'ASPDate') {
  1048. this.fieldTypes[field] = 'Date';
  1049. }
  1050. else {
  1051. this.fieldTypes[field] = value;
  1052. }
  1053. }
  1054. }
  1055. }
  1056. // event subscribers
  1057. this.subscribers = {};
  1058. this.internalIds = {}; // internally generated id's
  1059. }
  1060. /**
  1061. * Subscribe to an event, add an event listener
  1062. * @param {String} event Event name. Available events: 'put', 'update',
  1063. * 'remove'
  1064. * @param {function} callback Callback method. Called with three parameters:
  1065. * {String} event
  1066. * {Object | null} params
  1067. * {String} senderId
  1068. * @param {String} [id] Optional id for the sender, used to filter
  1069. * events triggered by the sender itself.
  1070. */
  1071. DataSet.prototype.subscribe = function (event, callback, id) {
  1072. var subscribers = this.subscribers[event];
  1073. if (!subscribers) {
  1074. subscribers = [];
  1075. this.subscribers[event] = subscribers;
  1076. }
  1077. subscribers.push({
  1078. id: id ? String(id) : null,
  1079. callback: callback
  1080. });
  1081. };
  1082. /**
  1083. * Unsubscribe from an event, remove an event listener
  1084. * @param {String} event
  1085. * @param {function} callback
  1086. */
  1087. DataSet.prototype.unsubscribe = function (event, callback) {
  1088. var subscribers = this.subscribers[event];
  1089. if (subscribers) {
  1090. this.subscribers[event] = subscribers.filter(function (listener) {
  1091. return (listener.callback != callback);
  1092. });
  1093. }
  1094. };
  1095. /**
  1096. * Trigger an event
  1097. * @param {String} event
  1098. * @param {Object | null} params
  1099. * @param {String} [senderId] Optional id of the sender.
  1100. * @private
  1101. */
  1102. DataSet.prototype._trigger = function (event, params, senderId) {
  1103. if (event == '*') {
  1104. throw new Error('Cannot trigger event *');
  1105. }
  1106. var subscribers = [];
  1107. if (event in this.subscribers) {
  1108. subscribers = subscribers.concat(this.subscribers[event]);
  1109. }
  1110. if ('*' in this.subscribers) {
  1111. subscribers = subscribers.concat(this.subscribers['*']);
  1112. }
  1113. for (var i = 0; i < subscribers.length; i++) {
  1114. var subscriber = subscribers[i];
  1115. if (subscriber.callback) {
  1116. subscriber.callback(event, params, senderId || null);
  1117. }
  1118. }
  1119. };
  1120. /**
  1121. * Add data.
  1122. * Adding an item will fail when there already is an item with the same id.
  1123. * @param {Object | Array | DataTable} data
  1124. * @param {String} [senderId] Optional sender id
  1125. */
  1126. DataSet.prototype.add = function (data, senderId) {
  1127. var addedItems = [],
  1128. id,
  1129. me = this;
  1130. if (data instanceof Array) {
  1131. // Array
  1132. for (var i = 0, len = data.length; i < len; i++) {
  1133. id = me._addItem(data[i]);
  1134. addedItems.push(id);
  1135. }
  1136. }
  1137. else if (util.isDataTable(data)) {
  1138. // Google DataTable
  1139. var columns = this._getColumnNames(data);
  1140. for (var row = 0, rows = data.getNumberOfRows(); row < rows; row++) {
  1141. var item = {};
  1142. for (var col = 0, cols = columns.length; col < cols; col++) {
  1143. var field = columns[col];
  1144. item[field] = data.getValue(row, col);
  1145. }
  1146. id = me._addItem(item);
  1147. addedItems.push(id);
  1148. }
  1149. }
  1150. else if (data instanceof Object) {
  1151. // Single item
  1152. id = me._addItem(data);
  1153. addedItems.push(id);
  1154. }
  1155. else {
  1156. throw new Error('Unknown dataType');
  1157. }
  1158. if (addedItems.length) {
  1159. this._trigger('add', {items: addedItems}, senderId);
  1160. }
  1161. };
  1162. /**
  1163. * Update existing items. When an item does not exist, it will be created
  1164. * @param {Object | Array | DataTable} data
  1165. * @param {String} [senderId] Optional sender id
  1166. */
  1167. DataSet.prototype.update = function (data, senderId) {
  1168. var addedItems = [],
  1169. updatedItems = [],
  1170. me = this,
  1171. fieldId = me.fieldId;
  1172. var addOrUpdate = function (item) {
  1173. var id = item[fieldId];
  1174. if (me.data[id]) {
  1175. // update item
  1176. id = me._updateItem(item);
  1177. updatedItems.push(id);
  1178. }
  1179. else {
  1180. // add new item
  1181. id = me._addItem(item);
  1182. addedItems.push(id);
  1183. }
  1184. };
  1185. if (data instanceof Array) {
  1186. // Array
  1187. for (var i = 0, len = data.length; i < len; i++) {
  1188. addOrUpdate(data[i]);
  1189. }
  1190. }
  1191. else if (util.isDataTable(data)) {
  1192. // Google DataTable
  1193. var columns = this._getColumnNames(data);
  1194. for (var row = 0, rows = data.getNumberOfRows(); row < rows; row++) {
  1195. var item = {};
  1196. for (var col = 0, cols = columns.length; col < cols; col++) {
  1197. var field = columns[col];
  1198. item[field] = data.getValue(row, col);
  1199. }
  1200. addOrUpdate(item);
  1201. }
  1202. }
  1203. else if (data instanceof Object) {
  1204. // Single item
  1205. addOrUpdate(data);
  1206. }
  1207. else {
  1208. throw new Error('Unknown dataType');
  1209. }
  1210. if (addedItems.length) {
  1211. this._trigger('add', {items: addedItems}, senderId);
  1212. }
  1213. if (updatedItems.length) {
  1214. this._trigger('update', {items: updatedItems}, senderId);
  1215. }
  1216. };
  1217. /**
  1218. * Get a data item or multiple items.
  1219. *
  1220. * Usage:
  1221. *
  1222. * get()
  1223. * get(options: Object)
  1224. * get(options: Object, data: Array | DataTable)
  1225. *
  1226. * get(id: Number | String)
  1227. * get(id: Number | String, options: Object)
  1228. * get(id: Number | String, options: Object, data: Array | DataTable)
  1229. *
  1230. * get(ids: Number[] | String[])
  1231. * get(ids: Number[] | String[], options: Object)
  1232. * get(ids: Number[] | String[], options: Object, data: Array | DataTable)
  1233. *
  1234. * Where:
  1235. *
  1236. * {Number | String} id The id of an item
  1237. * {Number[] | String{}} ids An array with ids of items
  1238. * {Object} options An Object with options. Available options:
  1239. * {String} [type] Type of data to be returned. Can
  1240. * be 'DataTable' or 'Array' (default)
  1241. * {Object.<String, String>} [fieldTypes]
  1242. * {String[]} [fields] field names to be returned
  1243. * {function} [filter] filter items
  1244. * {String | function} [order] Order the items by
  1245. * a field name or custom sort function.
  1246. * {Array | DataTable} [data] If provided, items will be appended to this
  1247. * array or table. Required in case of Google
  1248. * DataTable.
  1249. *
  1250. * @throws Error
  1251. */
  1252. DataSet.prototype.get = function (args) {
  1253. var me = this;
  1254. // parse the arguments
  1255. var id, ids, options, data;
  1256. var firstType = util.getType(arguments[0]);
  1257. if (firstType == 'String' || firstType == 'Number') {
  1258. // get(id [, options] [, data])
  1259. id = arguments[0];
  1260. options = arguments[1];
  1261. data = arguments[2];
  1262. }
  1263. else if (firstType == 'Array') {
  1264. // get(ids [, options] [, data])
  1265. ids = arguments[0];
  1266. options = arguments[1];
  1267. data = arguments[2];
  1268. }
  1269. else {
  1270. // get([, options] [, data])
  1271. options = arguments[0];
  1272. data = arguments[1];
  1273. }
  1274. // determine the return type
  1275. var type;
  1276. if (options && options.type) {
  1277. type = (options.type == 'DataTable') ? 'DataTable' : 'Array';
  1278. if (data && (type != util.getType(data))) {
  1279. throw new Error('Type of parameter "data" (' + util.getType(data) + ') ' +
  1280. 'does not correspond with specified options.type (' + options.type + ')');
  1281. }
  1282. if (type == 'DataTable' && !util.isDataTable(data)) {
  1283. throw new Error('Parameter "data" must be a DataTable ' +
  1284. 'when options.type is "DataTable"');
  1285. }
  1286. }
  1287. else if (data) {
  1288. type = (util.getType(data) == 'DataTable') ? 'DataTable' : 'Array';
  1289. }
  1290. else {
  1291. type = 'Array';
  1292. }
  1293. // build options
  1294. var fieldTypes = options && options.fieldTypes || this.options.fieldTypes;
  1295. var filter = options && options.filter;
  1296. var items = [], item, itemId, i, len;
  1297. // cast items
  1298. if (id != undefined) {
  1299. // return a single item
  1300. item = me._getItem(id, fieldTypes);
  1301. if (filter && !filter(item)) {
  1302. item = null;
  1303. }
  1304. }
  1305. else if (ids != undefined) {
  1306. // return a subset of items
  1307. for (i = 0, len = ids.length; i < len; i++) {
  1308. item = me._getItem(ids[i], fieldTypes);
  1309. if (!filter || filter(item)) {
  1310. items.push(item);
  1311. }
  1312. }
  1313. }
  1314. else {
  1315. // return all items
  1316. for (itemId in this.data) {
  1317. if (this.data.hasOwnProperty(itemId)) {
  1318. item = me._getItem(itemId, fieldTypes);
  1319. if (!filter || filter(item)) {
  1320. items.push(item);
  1321. }
  1322. }
  1323. }
  1324. }
  1325. // order the results
  1326. if (options && options.order && id == undefined) {
  1327. this._sort(items, options.order);
  1328. }
  1329. // filter fields of the items
  1330. if (options && options.fields) {
  1331. var fields = options.fields;
  1332. if (id != undefined) {
  1333. item = this._filterFields(item, fields);
  1334. }
  1335. else {
  1336. for (i = 0, len = items.length; i < len; i++) {
  1337. items[i] = this._filterFields(items[i], fields);
  1338. }
  1339. }
  1340. }
  1341. // return the results
  1342. if (type == 'DataTable') {
  1343. var columns = this._getColumnNames(data);
  1344. if (id != undefined) {
  1345. // append a single item to the data table
  1346. me._appendRow(data, columns, item);
  1347. }
  1348. else {
  1349. // copy the items to the provided data table
  1350. for (i = 0, len = items.length; i < len; i++) {
  1351. me._appendRow(data, columns, items[i]);
  1352. }
  1353. }
  1354. return data;
  1355. }
  1356. else {
  1357. // return an array
  1358. if (id != undefined) {
  1359. // a single item
  1360. return item;
  1361. }
  1362. else {
  1363. // multiple items
  1364. if (data) {
  1365. // copy the items to the provided array
  1366. for (i = 0, len = items.length; i < len; i++) {
  1367. data.push(items[i]);
  1368. }
  1369. return data;
  1370. }
  1371. else {
  1372. // just return our array
  1373. return items;
  1374. }
  1375. }
  1376. }
  1377. };
  1378. /**
  1379. * Get ids of all items or from a filtered set of items.
  1380. * @param {Object} [options] An Object with options. Available options:
  1381. * {function} [filter] filter items
  1382. * {String | function} [order] Order the items by
  1383. * a field name or custom sort function.
  1384. * @return {Array} ids
  1385. */
  1386. DataSet.prototype.getIds = function (options) {
  1387. var data = this.data,
  1388. filter = options && options.filter,
  1389. order = options && options.order,
  1390. fieldTypes = options && options.fieldTypes || this.options.fieldTypes,
  1391. i,
  1392. len,
  1393. id,
  1394. item,
  1395. items,
  1396. ids = [];
  1397. if (filter) {
  1398. // get filtered items
  1399. if (order) {
  1400. // create ordered list
  1401. items = [];
  1402. for (id in data) {
  1403. if (data.hasOwnProperty(id)) {
  1404. item = this._getItem(id, fieldTypes);
  1405. if (filter(item)) {
  1406. items.push(item);
  1407. }
  1408. }
  1409. }
  1410. this._sort(items, order);
  1411. for (i = 0, len = items.length; i < len; i++) {
  1412. ids[i] = items[i][this.fieldId];
  1413. }
  1414. }
  1415. else {
  1416. // create unordered list
  1417. for (id in data) {
  1418. if (data.hasOwnProperty(id)) {
  1419. item = this._getItem(id, fieldTypes);
  1420. if (filter(item)) {
  1421. ids.push(item[this.fieldId]);
  1422. }
  1423. }
  1424. }
  1425. }
  1426. }
  1427. else {
  1428. // get all items
  1429. if (order) {
  1430. // create an ordered list
  1431. items = [];
  1432. for (id in data) {
  1433. if (data.hasOwnProperty(id)) {
  1434. items.push(data[id]);
  1435. }
  1436. }
  1437. this._sort(items, order);
  1438. for (i = 0, len = items.length; i < len; i++) {
  1439. ids[i] = items[i][this.fieldId];
  1440. }
  1441. }
  1442. else {
  1443. // create unordered list
  1444. for (id in data) {
  1445. if (data.hasOwnProperty(id)) {
  1446. item = data[id];
  1447. ids.push(item[this.fieldId]);
  1448. }
  1449. }
  1450. }
  1451. }
  1452. return ids;
  1453. };
  1454. /**
  1455. * Execute a callback function for every item in the dataset.
  1456. * The order of the items is not determined.
  1457. * @param {function} callback
  1458. * @param {Object} [options] Available options:
  1459. * {Object.<String, String>} [fieldTypes]
  1460. * {String[]} [fields] filter fields
  1461. * {function} [filter] filter items
  1462. * {String | function} [order] Order the items by
  1463. * a field name or custom sort function.
  1464. */
  1465. DataSet.prototype.forEach = function (callback, options) {
  1466. var filter = options && options.filter,
  1467. fieldTypes = options && options.fieldTypes || this.options.fieldTypes,
  1468. data = this.data,
  1469. item,
  1470. id;
  1471. if (options && options.order) {
  1472. // execute forEach on ordered list
  1473. var items = this.get(options);
  1474. for (var i = 0, len = items.length; i < len; i++) {
  1475. item = items[i];
  1476. id = item[this.fieldId];
  1477. callback(item, id);
  1478. }
  1479. }
  1480. else {
  1481. // unordered
  1482. for (id in data) {
  1483. if (data.hasOwnProperty(id)) {
  1484. item = this._getItem(id, fieldTypes);
  1485. if (!filter || filter(item)) {
  1486. callback(item, id);
  1487. }
  1488. }
  1489. }
  1490. }
  1491. };
  1492. /**
  1493. * Map every item in the dataset.
  1494. * @param {function} callback
  1495. * @param {Object} [options] Available options:
  1496. * {Object.<String, String>} [fieldTypes]
  1497. * {String[]} [fields] filter fields
  1498. * {function} [filter] filter items
  1499. * {String | function} [order] Order the items by
  1500. * a field name or custom sort function.
  1501. * @return {Object[]} mappedItems
  1502. */
  1503. DataSet.prototype.map = function (callback, options) {
  1504. var filter = options && options.filter,
  1505. fieldTypes = options && options.fieldTypes || this.options.fieldTypes,
  1506. mappedItems = [],
  1507. data = this.data,
  1508. item;
  1509. // cast and filter items
  1510. for (var id in data) {
  1511. if (data.hasOwnProperty(id)) {
  1512. item = this._getItem(id, fieldTypes);
  1513. if (!filter || filter(item)) {
  1514. mappedItems.push(callback(item, id));
  1515. }
  1516. }
  1517. }
  1518. // order items
  1519. if (options && options.order) {
  1520. this._sort(mappedItems, options.order);
  1521. }
  1522. return mappedItems;
  1523. };
  1524. /**
  1525. * Filter the fields of an item
  1526. * @param {Object} item
  1527. * @param {String[]} fields Field names
  1528. * @return {Object} filteredItem
  1529. * @private
  1530. */
  1531. DataSet.prototype._filterFields = function (item, fields) {
  1532. var filteredItem = {};
  1533. for (var field in item) {
  1534. if (item.hasOwnProperty(field) && (fields.indexOf(field) != -1)) {
  1535. filteredItem[field] = item[field];
  1536. }
  1537. }
  1538. return filteredItem;
  1539. };
  1540. /**
  1541. * Sort the provided array with items
  1542. * @param {Object[]} items
  1543. * @param {String | function} order A field name or custom sort function.
  1544. * @private
  1545. */
  1546. DataSet.prototype._sort = function (items, order) {
  1547. if (util.isString(order)) {
  1548. // order by provided field name
  1549. var name = order; // field name
  1550. items.sort(function (a, b) {
  1551. var av = a[name];
  1552. var bv = b[name];
  1553. return (av > bv) ? 1 : ((av < bv) ? -1 : 0);
  1554. });
  1555. }
  1556. else if (typeof order === 'function') {
  1557. // order by sort function
  1558. items.sort(order);
  1559. }
  1560. // TODO: extend order by an Object {field:String, direction:String}
  1561. // where direction can be 'asc' or 'desc'
  1562. else {
  1563. throw new TypeError('Order must be a function or a string');
  1564. }
  1565. };
  1566. /**
  1567. * Remove an object by pointer or by id
  1568. * @param {String | Number | Object | Array} id Object or id, or an array with
  1569. * objects or ids to be removed
  1570. * @param {String} [senderId] Optional sender id
  1571. */
  1572. DataSet.prototype.remove = function (id, senderId) {
  1573. var removedItems = [],
  1574. i, len;
  1575. if (util.isNumber(id) || util.isString(id)) {
  1576. delete this.data[id];
  1577. delete this.internalIds[id];
  1578. removedItems.push(id);
  1579. }
  1580. else if (id instanceof Array) {
  1581. for (i = 0, len = id.length; i < len; i++) {
  1582. this.remove(id[i]);
  1583. }
  1584. removedItems = items.concat(id);
  1585. }
  1586. else if (id instanceof Object) {
  1587. // search for the object
  1588. for (i in this.data) {
  1589. if (this.data.hasOwnProperty(i)) {
  1590. if (this.data[i] == id) {
  1591. delete this.data[i];
  1592. delete this.internalIds[i];
  1593. removedItems.push(i);
  1594. }
  1595. }
  1596. }
  1597. }
  1598. if (removedItems.length) {
  1599. this._trigger('remove', {items: removedItems}, senderId);
  1600. }
  1601. };
  1602. /**
  1603. * Clear the data
  1604. * @param {String} [senderId] Optional sender id
  1605. */
  1606. DataSet.prototype.clear = function (senderId) {
  1607. var ids = Object.keys(this.data);
  1608. this.data = {};
  1609. this.internalIds = {};
  1610. this._trigger('remove', {items: ids}, senderId);
  1611. };
  1612. /**
  1613. * Find the item with maximum value of a specified field
  1614. * @param {String} field
  1615. * @return {Object | null} item Item containing max value, or null if no items
  1616. */
  1617. DataSet.prototype.max = function (field) {
  1618. var data = this.data,
  1619. max = null,
  1620. maxField = null;
  1621. for (var id in data) {
  1622. if (data.hasOwnProperty(id)) {
  1623. var item = data[id];
  1624. var itemField = item[field];
  1625. if (itemField != null && (!max || itemField > maxField)) {
  1626. max = item;
  1627. maxField = itemField;
  1628. }
  1629. }
  1630. }
  1631. return max;
  1632. };
  1633. /**
  1634. * Find the item with minimum value of a specified field
  1635. * @param {String} field
  1636. * @return {Object | null} item Item containing max value, or null if no items
  1637. */
  1638. DataSet.prototype.min = function (field) {
  1639. var data = this.data,
  1640. min = null,
  1641. minField = null;
  1642. for (var id in data) {
  1643. if (data.hasOwnProperty(id)) {
  1644. var item = data[id];
  1645. var itemField = item[field];
  1646. if (itemField != null && (!min || itemField < minField)) {
  1647. min = item;
  1648. minField = itemField;
  1649. }
  1650. }
  1651. }
  1652. return min;
  1653. };
  1654. /**
  1655. * Find all distinct values of a specified field
  1656. * @param {String} field
  1657. * @return {Array} values Array containing all distinct values. If the data
  1658. * items do not contain the specified field, an array
  1659. * containing a single value undefined is returned.
  1660. * The returned array is unordered.
  1661. */
  1662. DataSet.prototype.distinct = function (field) {
  1663. var data = this.data,
  1664. values = [],
  1665. fieldType = this.options.fieldTypes[field],
  1666. count = 0;
  1667. for (var prop in data) {
  1668. if (data.hasOwnProperty(prop)) {
  1669. var item = data[prop];
  1670. var value = util.cast(item[field], fieldType);
  1671. var exists = false;
  1672. for (var i = 0; i < count; i++) {
  1673. if (values[i] == value) {
  1674. exists = true;
  1675. break;
  1676. }
  1677. }
  1678. if (!exists) {
  1679. values[count] = value;
  1680. count++;
  1681. }
  1682. }
  1683. }
  1684. return values;
  1685. };
  1686. /**
  1687. * Add a single item. Will fail when an item with the same id already exists.
  1688. * @param {Object} item
  1689. * @return {String} id
  1690. * @private
  1691. */
  1692. DataSet.prototype._addItem = function (item) {
  1693. var id = item[this.fieldId];
  1694. if (id != undefined) {
  1695. // check whether this id is already taken
  1696. if (this.data[id]) {
  1697. // item already exists
  1698. throw new Error('Cannot add item: item with id ' + id + ' already exists');
  1699. }
  1700. }
  1701. else {
  1702. // generate an id
  1703. id = util.randomUUID();
  1704. item[this.fieldId] = id;
  1705. this.internalIds[id] = item;
  1706. }
  1707. var d = {};
  1708. for (var field in item) {
  1709. if (item.hasOwnProperty(field)) {
  1710. var type = this.fieldTypes[field]; // type may be undefined
  1711. d[field] = util.cast(item[field], type);
  1712. }
  1713. }
  1714. this.data[id] = d;
  1715. return id;
  1716. };
  1717. /**
  1718. * Get an item. Fields can be casted to a specific type
  1719. * @param {String} id
  1720. * @param {Object.<String, String>} [fieldTypes] Cast field types
  1721. * @return {Object | null} item
  1722. * @private
  1723. */
  1724. DataSet.prototype._getItem = function (id, fieldTypes) {
  1725. var field, value;
  1726. // get the item from the dataset
  1727. var raw = this.data[id];
  1728. if (!raw) {
  1729. return null;
  1730. }
  1731. // cast the items field types
  1732. var casted = {},
  1733. fieldId = this.fieldId,
  1734. internalIds = this.internalIds;
  1735. if (fieldTypes) {
  1736. for (field in raw) {
  1737. if (raw.hasOwnProperty(field)) {
  1738. value = raw[field];
  1739. // output all fields, except internal ids
  1740. if ((field != fieldId) || !(value in internalIds)) {
  1741. casted[field] = util.cast(value, fieldTypes[field]);
  1742. }
  1743. }
  1744. }
  1745. }
  1746. else {
  1747. // no field types specified, no casting needed
  1748. for (field in raw) {
  1749. if (raw.hasOwnProperty(field)) {
  1750. value = raw[field];
  1751. // output all fields, except internal ids
  1752. if ((field != fieldId) || !(value in internalIds)) {
  1753. casted[field] = value;
  1754. }
  1755. }
  1756. }
  1757. }
  1758. return casted;
  1759. };
  1760. /**
  1761. * Update a single item: merge with existing item.
  1762. * Will fail when the item has no id, or when there does not exist an item
  1763. * with the same id.
  1764. * @param {Object} item
  1765. * @return {String} id
  1766. * @private
  1767. */
  1768. DataSet.prototype._updateItem = function (item) {
  1769. var id = item[this.fieldId];
  1770. if (id == undefined) {
  1771. throw new Error('Cannot update item: item has no id (item: ' + JSON.stringify(item) + ')');
  1772. }
  1773. var d = this.data[id];
  1774. if (!d) {
  1775. // item doesn't exist
  1776. throw new Error('Cannot update item: no item with id ' + id + ' found');
  1777. }
  1778. // merge with current item
  1779. for (var field in item) {
  1780. if (item.hasOwnProperty(field)) {
  1781. var type = this.fieldTypes[field]; // type may be undefined
  1782. d[field] = util.cast(item[field], type);
  1783. }
  1784. }
  1785. return id;
  1786. };
  1787. /**
  1788. * Get an array with the column names of a Google DataTable
  1789. * @param {DataTable} dataTable
  1790. * @return {String[]} columnNames
  1791. * @private
  1792. */
  1793. DataSet.prototype._getColumnNames = function (dataTable) {
  1794. var columns = [];
  1795. for (var col = 0, cols = dataTable.getNumberOfColumns(); col < cols; col++) {
  1796. columns[col] = dataTable.getColumnId(col) || dataTable.getColumnLabel(col);
  1797. }
  1798. return columns;
  1799. };
  1800. /**
  1801. * Append an item as a row to the dataTable
  1802. * @param dataTable
  1803. * @param columns
  1804. * @param item
  1805. * @private
  1806. */
  1807. DataSet.prototype._appendRow = function (dataTable, columns, item) {
  1808. var row = dataTable.addRow();
  1809. for (var col = 0, cols = columns.length; col < cols; col++) {
  1810. var field = columns[col];
  1811. dataTable.setValue(row, col, item[field]);
  1812. }
  1813. };
  1814. /**
  1815. * DataView
  1816. *
  1817. * a dataview offers a filtered view on a dataset or an other dataview.
  1818. *
  1819. * @param {DataSet | DataView} data
  1820. * @param {Object} [options] Available options: see method get
  1821. *
  1822. * @constructor DataView
  1823. */
  1824. function DataView (data, options) {
  1825. this.id = util.randomUUID();
  1826. this.data = null;
  1827. this.ids = {}; // ids of the items currently in memory (just contains a boolean true)
  1828. this.options = options || {};
  1829. this.fieldId = 'id'; // name of the field containing id
  1830. this.subscribers = {}; // event subscribers
  1831. var me = this;
  1832. this.listener = function () {
  1833. me._onEvent.apply(me, arguments);
  1834. };
  1835. this.setData(data);
  1836. }
  1837. /**
  1838. * Set a data source for the view
  1839. * @param {DataSet | DataView} data
  1840. */
  1841. DataView.prototype.setData = function (data) {
  1842. var ids, dataItems, i, len;
  1843. if (this.data) {
  1844. // unsubscribe from current dataset
  1845. if (this.data.unsubscribe) {
  1846. this.data.unsubscribe('*', this.listener);
  1847. }
  1848. // trigger a remove of all items in memory
  1849. ids = [];
  1850. for (var id in this.ids) {
  1851. if (this.ids.hasOwnProperty(id)) {
  1852. ids.push(id);
  1853. }
  1854. }
  1855. this.ids = {};
  1856. this._trigger('remove', {items: ids});
  1857. }
  1858. this.data = data;
  1859. if (this.data) {
  1860. // update fieldId
  1861. this.fieldId = this.options.fieldId ||
  1862. (this.data && this.data.options && this.data.options.fieldId) ||
  1863. 'id';
  1864. // trigger an add of all added items
  1865. ids = this.data.getIds({filter: this.options && this.options.filter});
  1866. for (i = 0, len = ids.length; i < len; i++) {
  1867. id = ids[i];
  1868. this.ids[id] = true;
  1869. }
  1870. this._trigger('add', {items: ids});
  1871. // subscribe to new dataset
  1872. if (this.data.subscribe) {
  1873. this.data.subscribe('*', this.listener);
  1874. }
  1875. }
  1876. };
  1877. /**
  1878. * Get data from the data view
  1879. *
  1880. * Usage:
  1881. *
  1882. * get()
  1883. * get(options: Object)
  1884. * get(options: Object, data: Array | DataTable)
  1885. *
  1886. * get(id: Number)
  1887. * get(id: Number, options: Object)
  1888. * get(id: Number, options: Object, data: Array | DataTable)
  1889. *
  1890. * get(ids: Number[])
  1891. * get(ids: Number[], options: Object)
  1892. * get(ids: Number[], options: Object, data: Array | DataTable)
  1893. *
  1894. * Where:
  1895. *
  1896. * {Number | String} id The id of an item
  1897. * {Number[] | String{}} ids An array with ids of items
  1898. * {Object} options An Object with options. Available options:
  1899. * {String} [type] Type of data to be returned. Can
  1900. * be 'DataTable' or 'Array' (default)
  1901. * {Object.<String, String>} [fieldTypes]
  1902. * {String[]} [fields] field names to be returned
  1903. * {function} [filter] filter items
  1904. * {String | function} [order] Order the items by
  1905. * a field name or custom sort function.
  1906. * {Array | DataTable} [data] If provided, items will be appended to this
  1907. * array or table. Required in case of Google
  1908. * DataTable.
  1909. * @param args
  1910. */
  1911. DataView.prototype.get = function (args) {
  1912. var me = this;
  1913. // parse the arguments
  1914. var ids, options, data;
  1915. var firstType = util.getType(arguments[0]);
  1916. if (firstType == 'String' || firstType == 'Number' || firstType == 'Array') {
  1917. // get(id(s) [, options] [, data])
  1918. ids = arguments[0]; // can be a single id or an array with ids
  1919. options = arguments[1];
  1920. data = arguments[2];
  1921. }
  1922. else {
  1923. // get([, options] [, data])
  1924. options = arguments[0];
  1925. data = arguments[1];
  1926. }
  1927. // extend the options with the default options and provided options
  1928. var viewOptions = util.extend({}, this.options, options);
  1929. // create a combined filter method when needed
  1930. if (this.options.filter && options && options.filter) {
  1931. viewOptions.filter = function (item) {
  1932. return me.options.filter(item) && options.filter(item);
  1933. }
  1934. }
  1935. // build up the call to the linked data set
  1936. var getArguments = [];
  1937. if (ids != undefined) {
  1938. getArguments.push(ids);
  1939. }
  1940. getArguments.push(viewOptions);
  1941. getArguments.push(data);
  1942. return this.data && this.data.get.apply(this.data, getArguments);
  1943. };
  1944. /**
  1945. * Get ids of all items or from a filtered set of items.
  1946. * @param {Object} [options] An Object with options. Available options:
  1947. * {function} [filter] filter items
  1948. * {String | function} [order] Order the items by
  1949. * a field name or custom sort function.
  1950. * @return {Array} ids
  1951. */
  1952. DataView.prototype.getIds = function (options) {
  1953. var ids;
  1954. if (this.data) {
  1955. var defaultFilter = this.options.filter;
  1956. var filter;
  1957. if (options && options.filter) {
  1958. if (defaultFilter) {
  1959. filter = function (item) {
  1960. return defaultFilter(item) && options.filter(item);
  1961. }
  1962. }
  1963. else {
  1964. filter = options.filter;
  1965. }
  1966. }
  1967. else {
  1968. filter = defaultFilter;
  1969. }
  1970. ids = this.data.getIds({
  1971. filter: filter,
  1972. order: options && options.order
  1973. });
  1974. }
  1975. else {
  1976. ids = [];
  1977. }
  1978. return ids;
  1979. };
  1980. /**
  1981. * Event listener. Will propagate all events from the connected data set to
  1982. * the subscribers of the DataView, but will filter the items and only trigger
  1983. * when there are changes in the filtered data set.
  1984. * @param {String} event
  1985. * @param {Object | null} params
  1986. * @param {String} senderId
  1987. * @private
  1988. */
  1989. DataView.prototype._onEvent = function (event, params, senderId) {
  1990. var i, len, id, item,
  1991. ids = params && params.items,
  1992. data = this.data,
  1993. added = [],
  1994. updated = [],
  1995. removed = [];
  1996. if (ids && data) {
  1997. switch (event) {
  1998. case 'add':
  1999. // filter the ids of the added items
  2000. for (i = 0, len = ids.length; i < len; i++) {
  2001. id = ids[i];
  2002. item = this.get(id);
  2003. if (item) {
  2004. this.ids[id] = true;
  2005. added.push(id);
  2006. }
  2007. }
  2008. break;
  2009. case 'update':
  2010. // determine the event from the views viewpoint: an updated
  2011. // item can be added, updated, or removed from this view.
  2012. for (i = 0, len = ids.length; i < len; i++) {
  2013. id = ids[i];
  2014. item = this.get(id);
  2015. if (item) {
  2016. if (this.ids[id]) {
  2017. updated.push(id);
  2018. }
  2019. else {
  2020. this.ids[id] = true;
  2021. added.push(id);
  2022. }
  2023. }
  2024. else {
  2025. if (this.ids[id]) {
  2026. delete this.ids[id];
  2027. removed.push(id);
  2028. }
  2029. else {
  2030. // nothing interesting for me :-(
  2031. }
  2032. }
  2033. }
  2034. break;
  2035. case 'remove':
  2036. // filter the ids of the removed items
  2037. for (i = 0, len = ids.length; i < len; i++) {
  2038. id = ids[i];
  2039. if (this.ids[id]) {
  2040. delete this.ids[id];
  2041. removed.push(id);
  2042. }
  2043. }
  2044. break;
  2045. }
  2046. if (added.length) {
  2047. this._trigger('add', {items: added}, senderId);
  2048. }
  2049. if (updated.length) {
  2050. this._trigger('update', {items: updated}, senderId);
  2051. }
  2052. if (removed.length) {
  2053. this._trigger('remove', {items: removed}, senderId);
  2054. }
  2055. }
  2056. };
  2057. // copy subscription functionality from DataSet
  2058. DataView.prototype.subscribe = DataSet.prototype.subscribe;
  2059. DataView.prototype.unsubscribe = DataSet.prototype.unsubscribe;
  2060. DataView.prototype._trigger = DataSet.prototype._trigger;
  2061. /**
  2062. * @constructor TimeStep
  2063. * The class TimeStep is an iterator for dates. You provide a start date and an
  2064. * end date. The class itself determines the best scale (step size) based on the
  2065. * provided start Date, end Date, and minimumStep.
  2066. *
  2067. * If minimumStep is provided, the step size is chosen as close as possible
  2068. * to the minimumStep but larger than minimumStep. If minimumStep is not
  2069. * provided, the scale is set to 1 DAY.
  2070. * The minimumStep should correspond with the onscreen size of about 6 characters
  2071. *
  2072. * Alternatively, you can set a scale by hand.
  2073. * After creation, you can initialize the class by executing first(). Then you
  2074. * can iterate from the start date to the end date via next(). You can check if
  2075. * the end date is reached with the function hasNext(). After each step, you can
  2076. * retrieve the current date via getCurrent().
  2077. * The TimeStep has scales ranging from milliseconds, seconds, minutes, hours,
  2078. * days, to years.
  2079. *
  2080. * Version: 1.2
  2081. *
  2082. * @param {Date} [start] The start date, for example new Date(2010, 9, 21)
  2083. * or new Date(2010, 9, 21, 23, 45, 00)
  2084. * @param {Date} [end] The end date
  2085. * @param {Number} [minimumStep] Optional. Minimum step size in milliseconds
  2086. */
  2087. TimeStep = function(start, end, minimumStep) {
  2088. // variables
  2089. this.current = new Date();
  2090. this._start = new Date();
  2091. this._end = new Date();
  2092. this.autoScale = true;
  2093. this.scale = TimeStep.SCALE.DAY;
  2094. this.step = 1;
  2095. // initialize the range
  2096. this.setRange(start, end, minimumStep);
  2097. };
  2098. /// enum scale
  2099. TimeStep.SCALE = {
  2100. MILLISECOND: 1,
  2101. SECOND: 2,
  2102. MINUTE: 3,
  2103. HOUR: 4,
  2104. DAY: 5,
  2105. WEEKDAY: 6,
  2106. MONTH: 7,
  2107. YEAR: 8
  2108. };
  2109. /**
  2110. * Set a new range
  2111. * If minimumStep is provided, the step size is chosen as close as possible
  2112. * to the minimumStep but larger than minimumStep. If minimumStep is not
  2113. * provided, the scale is set to 1 DAY.
  2114. * The minimumStep should correspond with the onscreen size of about 6 characters
  2115. * @param {Date} [start] The start date and time.
  2116. * @param {Date} [end] The end date and time.
  2117. * @param {int} [minimumStep] Optional. Minimum step size in milliseconds
  2118. */
  2119. TimeStep.prototype.setRange = function(start, end, minimumStep) {
  2120. if (!(start instanceof Date) || !(end instanceof Date)) {
  2121. //throw "No legal start or end date in method setRange";
  2122. return;
  2123. }
  2124. this._start = (start != undefined) ? new Date(start.valueOf()) : new Date();
  2125. this._end = (end != undefined) ? new Date(end.valueOf()) : new Date();
  2126. if (this.autoScale) {
  2127. this.setMinimumStep(minimumStep);
  2128. }
  2129. };
  2130. /**
  2131. * Set the range iterator to the start date.
  2132. */
  2133. TimeStep.prototype.first = function() {
  2134. this.current = new Date(this._start.valueOf());
  2135. this.roundToMinor();
  2136. };
  2137. /**
  2138. * Round the current date to the first minor date value
  2139. * This must be executed once when the current date is set to start Date
  2140. */
  2141. TimeStep.prototype.roundToMinor = function() {
  2142. // round to floor
  2143. // IMPORTANT: we have no breaks in this switch! (this is no bug)
  2144. //noinspection FallthroughInSwitchStatementJS
  2145. switch (this.scale) {
  2146. case TimeStep.SCALE.YEAR:
  2147. this.current.setFullYear(this.step * Math.floor(this.current.getFullYear() / this.step));
  2148. this.current.setMonth(0);
  2149. case TimeStep.SCALE.MONTH: this.current.setDate(1);
  2150. case TimeStep.SCALE.DAY: // intentional fall through
  2151. case TimeStep.SCALE.WEEKDAY: this.current.setHours(0);
  2152. case TimeStep.SCALE.HOUR: this.current.setMinutes(0);
  2153. case TimeStep.SCALE.MINUTE: this.current.setSeconds(0);
  2154. case TimeStep.SCALE.SECOND: this.current.setMilliseconds(0);
  2155. //case TimeStep.SCALE.MILLISECOND: // nothing to do for milliseconds
  2156. }
  2157. if (this.step != 1) {
  2158. // round down to the first minor value that is a multiple of the current step size
  2159. switch (this.scale) {
  2160. case TimeStep.SCALE.MILLISECOND: this.current.setMilliseconds(this.current.getMilliseconds() - this.current.getMilliseconds() % this.step); break;
  2161. case TimeStep.SCALE.SECOND: this.current.setSeconds(this.current.getSeconds() - this.current.getSeconds() % this.step); break;
  2162. case TimeStep.SCALE.MINUTE: this.current.setMinutes(this.current.getMinutes() - this.current.getMinutes() % this.step); break;
  2163. case TimeStep.SCALE.HOUR: this.current.setHours(this.current.getHours() - this.current.getHours() % this.step); break;
  2164. case TimeStep.SCALE.WEEKDAY: // intentional fall through
  2165. case TimeStep.SCALE.DAY: this.current.setDate((this.current.getDate()-1) - (this.current.getDate()-1) % this.step + 1); break;
  2166. case TimeStep.SCALE.MONTH: this.current.setMonth(this.current.getMonth() - this.current.getMonth() % this.step); break;
  2167. case TimeStep.SCALE.YEAR: this.current.setFullYear(this.current.getFullYear() - this.current.getFullYear() % this.step); break;
  2168. default: break;
  2169. }
  2170. }
  2171. };
  2172. /**
  2173. * Check if the there is a next step
  2174. * @return {boolean} true if the current date has not passed the end date
  2175. */
  2176. TimeStep.prototype.hasNext = function () {
  2177. return (this.current.valueOf() <= this._end.valueOf());
  2178. };
  2179. /**
  2180. * Do the next step
  2181. */
  2182. TimeStep.prototype.next = function() {
  2183. var prev = this.current.valueOf();
  2184. // Two cases, needed to prevent issues with switching daylight savings
  2185. // (end of March and end of October)
  2186. if (this.current.getMonth() < 6) {
  2187. switch (this.scale) {
  2188. case TimeStep.SCALE.MILLISECOND:
  2189. this.current = new Date(this.current.valueOf() + this.step); break;
  2190. case TimeStep.SCALE.SECOND: this.current = new Date(this.current.valueOf() + this.step * 1000); break;
  2191. case TimeStep.SCALE.MINUTE: this.current = new Date(this.current.valueOf() + this.step * 1000 * 60); break;
  2192. case TimeStep.SCALE.HOUR:
  2193. this.current = new Date(this.current.valueOf() + this.step * 1000 * 60 * 60);
  2194. // in case of skipping an hour for daylight savings, adjust the hour again (else you get: 0h 5h 9h ... instead of 0h 4h 8h ...)
  2195. var h = this.current.getHours();
  2196. this.current.setHours(h - (h % this.step));
  2197. break;
  2198. case TimeStep.SCALE.WEEKDAY: // intentional fall through
  2199. case TimeStep.SCALE.DAY: this.current.setDate(this.current.getDate() + this.step); break;
  2200. case TimeStep.SCALE.MONTH: this.current.setMonth(this.current.getMonth() + this.step); break;
  2201. case TimeStep.SCALE.YEAR: this.current.setFullYear(this.current.getFullYear() + this.step); break;
  2202. default: break;
  2203. }
  2204. }
  2205. else {
  2206. switch (this.scale) {
  2207. case TimeStep.SCALE.MILLISECOND: this.current = new Date(this.current.valueOf() + this.step); break;
  2208. case TimeStep.SCALE.SECOND: this.current.setSeconds(this.current.getSeconds() + this.step); break;
  2209. case TimeStep.SCALE.MINUTE: this.current.setMinutes(this.current.getMinutes() + this.step); break;
  2210. case TimeStep.SCALE.HOUR: this.current.setHours(this.current.getHours() + this.step); break;
  2211. case TimeStep.SCALE.WEEKDAY: // intentional fall through
  2212. case TimeStep.SCALE.DAY: this.current.setDate(this.current.getDate() + this.step); break;
  2213. case TimeStep.SCALE.MONTH: this.current.setMonth(this.current.getMonth() + this.step); break;
  2214. case TimeStep.SCALE.YEAR: this.current.setFullYear(this.current.getFullYear() + this.step); break;
  2215. default: break;
  2216. }
  2217. }
  2218. if (this.step != 1) {
  2219. // round down to the correct major value
  2220. switch (this.scale) {
  2221. case TimeStep.SCALE.MILLISECOND: if(this.current.getMilliseconds() < this.step) this.current.setMilliseconds(0); break;
  2222. case TimeStep.SCALE.SECOND: if(this.current.getSeconds() < this.step) this.current.setSeconds(0); break;
  2223. case TimeStep.SCALE.MINUTE: if(this.current.getMinutes() < this.step) this.current.setMinutes(0); break;
  2224. case TimeStep.SCALE.HOUR: if(this.current.getHours() < this.step) this.current.setHours(0); break;
  2225. case TimeStep.SCALE.WEEKDAY: // intentional fall through
  2226. case TimeStep.SCALE.DAY: if(this.current.getDate() < this.step+1) this.current.setDate(1); break;
  2227. case TimeStep.SCALE.MONTH: if(this.current.getMonth() < this.step) this.current.setMonth(0); break;
  2228. case TimeStep.SCALE.YEAR: break; // nothing to do for year
  2229. default: break;
  2230. }
  2231. }
  2232. // safety mechanism: if current time is still unchanged, move to the end
  2233. if (this.current.valueOf() == prev) {
  2234. this.current = new Date(this._end.valueOf());
  2235. }
  2236. };
  2237. /**
  2238. * Get the current datetime
  2239. * @return {Date} current The current date
  2240. */
  2241. TimeStep.prototype.getCurrent = function() {
  2242. return this.current;
  2243. };
  2244. /**
  2245. * Set a custom scale. Autoscaling will be disabled.
  2246. * For example setScale(SCALE.MINUTES, 5) will result
  2247. * in minor steps of 5 minutes, and major steps of an hour.
  2248. *
  2249. * @param {TimeStep.SCALE} newScale
  2250. * A scale. Choose from SCALE.MILLISECOND,
  2251. * SCALE.SECOND, SCALE.MINUTE, SCALE.HOUR,
  2252. * SCALE.WEEKDAY, SCALE.DAY, SCALE.MONTH,
  2253. * SCALE.YEAR.
  2254. * @param {Number} newStep A step size, by default 1. Choose for
  2255. * example 1, 2, 5, or 10.
  2256. */
  2257. TimeStep.prototype.setScale = function(newScale, newStep) {
  2258. this.scale = newScale;
  2259. if (newStep > 0) {
  2260. this.step = newStep;
  2261. }
  2262. this.autoScale = false;
  2263. };
  2264. /**
  2265. * Enable or disable autoscaling
  2266. * @param {boolean} enable If true, autoascaling is set true
  2267. */
  2268. TimeStep.prototype.setAutoScale = function (enable) {
  2269. this.autoScale = enable;
  2270. };
  2271. /**
  2272. * Automatically determine the scale that bests fits the provided minimum step
  2273. * @param {Number} [minimumStep] The minimum step size in milliseconds
  2274. */
  2275. TimeStep.prototype.setMinimumStep = function(minimumStep) {
  2276. if (minimumStep == undefined) {
  2277. return;
  2278. }
  2279. var stepYear = (1000 * 60 * 60 * 24 * 30 * 12);
  2280. var stepMonth = (1000 * 60 * 60 * 24 * 30);
  2281. var stepDay = (1000 * 60 * 60 * 24);
  2282. var stepHour = (1000 * 60 * 60);
  2283. var stepMinute = (1000 * 60);
  2284. var stepSecond = (1000);
  2285. var stepMillisecond= (1);
  2286. // find the smallest step that is larger than the provided minimumStep
  2287. if (stepYear*1000 > minimumStep) {this.scale = TimeStep.SCALE.YEAR; this.step = 1000;}
  2288. if (stepYear*500 > minimumStep) {this.scale = TimeStep.SCALE.YEAR; this.step = 500;}
  2289. if (stepYear*100 > minimumStep) {this.scale = TimeStep.SCALE.YEAR; this.step = 100;}
  2290. if (stepYear*50 > minimumStep) {this.scale = TimeStep.SCALE.YEAR; this.step = 50;}
  2291. if (stepYear*10 > minimumStep) {this.scale = TimeStep.SCALE.YEAR; this.step = 10;}
  2292. if (stepYear*5 > minimumStep) {this.scale = TimeStep.SCALE.YEAR; this.step = 5;}
  2293. if (stepYear > minimumStep) {this.scale = TimeStep.SCALE.YEAR; this.step = 1;}
  2294. if (stepMonth*3 > minimumStep) {this.scale = TimeStep.SCALE.MONTH; this.step = 3;}
  2295. if (stepMonth > minimumStep) {this.scale = TimeStep.SCALE.MONTH; this.step = 1;}
  2296. if (stepDay*5 > minimumStep) {this.scale = TimeStep.SCALE.DAY; this.step = 5;}
  2297. if (stepDay*2 > minimumStep) {this.scale = TimeStep.SCALE.DAY; this.step = 2;}
  2298. if (stepDay > minimumStep) {this.scale = TimeStep.SCALE.DAY; this.step = 1;}
  2299. if (stepDay/2 > minimumStep) {this.scale = TimeStep.SCALE.WEEKDAY; this.step = 1;}
  2300. if (stepHour*4 > minimumStep) {this.scale = TimeStep.SCALE.HOUR; this.step = 4;}
  2301. if (stepHour > minimumStep) {this.scale = TimeStep.SCALE.HOUR; this.step = 1;}
  2302. if (stepMinute*15 > minimumStep) {this.scale = TimeStep.SCALE.MINUTE; this.step = 15;}
  2303. if (stepMinute*10 > minimumStep) {this.scale = TimeStep.SCALE.MINUTE; this.step = 10;}
  2304. if (stepMinute*5 > minimumStep) {this.scale = TimeStep.SCALE.MINUTE; this.step = 5;}
  2305. if (stepMinute > minimumStep) {this.scale = TimeStep.SCALE.MINUTE; this.step = 1;}
  2306. if (stepSecond*15 > minimumStep) {this.scale = TimeStep.SCALE.SECOND; this.step = 15;}
  2307. if (stepSecond*10 > minimumStep) {this.scale = TimeStep.SCALE.SECOND; this.step = 10;}
  2308. if (stepSecond*5 > minimumStep) {this.scale = TimeStep.SCALE.SECOND; this.step = 5;}
  2309. if (stepSecond > minimumStep) {this.scale = TimeStep.SCALE.SECOND; this.step = 1;}
  2310. if (stepMillisecond*200 > minimumStep) {this.scale = TimeStep.SCALE.MILLISECOND; this.step = 200;}
  2311. if (stepMillisecond*100 > minimumStep) {this.scale = TimeStep.SCALE.MILLISECOND; this.step = 100;}
  2312. if (stepMillisecond*50 > minimumStep) {this.scale = TimeStep.SCALE.MILLISECOND; this.step = 50;}
  2313. if (stepMillisecond*10 > minimumStep) {this.scale = TimeStep.SCALE.MILLISECOND; this.step = 10;}
  2314. if (stepMillisecond*5 > minimumStep) {this.scale = TimeStep.SCALE.MILLISECOND; this.step = 5;}
  2315. if (stepMillisecond > minimumStep) {this.scale = TimeStep.SCALE.MILLISECOND; this.step = 1;}
  2316. };
  2317. /**
  2318. * Snap a date to a rounded value. The snap intervals are dependent on the
  2319. * current scale and step.
  2320. * @param {Date} date the date to be snapped
  2321. */
  2322. TimeStep.prototype.snap = function(date) {
  2323. if (this.scale == TimeStep.SCALE.YEAR) {
  2324. var year = date.getFullYear() + Math.round(date.getMonth() / 12);
  2325. date.setFullYear(Math.round(year / this.step) * this.step);
  2326. date.setMonth(0);
  2327. date.setDate(0);
  2328. date.setHours(0);
  2329. date.setMinutes(0);
  2330. date.setSeconds(0);
  2331. date.setMilliseconds(0);
  2332. }
  2333. else if (this.scale == TimeStep.SCALE.MONTH) {
  2334. if (date.getDate() > 15) {
  2335. date.setDate(1);
  2336. date.setMonth(date.getMonth() + 1);
  2337. // important: first set Date to 1, after that change the month.
  2338. }
  2339. else {
  2340. date.setDate(1);
  2341. }
  2342. date.setHours(0);
  2343. date.setMinutes(0);
  2344. date.setSeconds(0);
  2345. date.setMilliseconds(0);
  2346. }
  2347. else if (this.scale == TimeStep.SCALE.DAY ||
  2348. this.scale == TimeStep.SCALE.WEEKDAY) {
  2349. //noinspection FallthroughInSwitchStatementJS
  2350. switch (this.step) {
  2351. case 5:
  2352. case 2:
  2353. date.setHours(Math.round(date.getHours() / 24) * 24); break;
  2354. default:
  2355. date.setHours(Math.round(date.getHours() / 12) * 12); break;
  2356. }
  2357. date.setMinutes(0);
  2358. date.setSeconds(0);
  2359. date.setMilliseconds(0);
  2360. }
  2361. else if (this.scale == TimeStep.SCALE.HOUR) {
  2362. switch (this.step) {
  2363. case 4:
  2364. date.setMinutes(Math.round(date.getMinutes() / 60) * 60); break;
  2365. default:
  2366. date.setMinutes(Math.round(date.getMinutes() / 30) * 30); break;
  2367. }
  2368. date.setSeconds(0);
  2369. date.setMilliseconds(0);
  2370. } else if (this.scale == TimeStep.SCALE.MINUTE) {
  2371. //noinspection FallthroughInSwitchStatementJS
  2372. switch (this.step) {
  2373. case 15:
  2374. case 10:
  2375. date.setMinutes(Math.round(date.getMinutes() / 5) * 5);
  2376. date.setSeconds(0);
  2377. break;
  2378. case 5:
  2379. date.setSeconds(Math.round(date.getSeconds() / 60) * 60); break;
  2380. default:
  2381. date.setSeconds(Math.round(date.getSeconds() / 30) * 30); break;
  2382. }
  2383. date.setMilliseconds(0);
  2384. }
  2385. else if (this.scale == TimeStep.SCALE.SECOND) {
  2386. //noinspection FallthroughInSwitchStatementJS
  2387. switch (this.step) {
  2388. case 15:
  2389. case 10:
  2390. date.setSeconds(Math.round(date.getSeconds() / 5) * 5);
  2391. date.setMilliseconds(0);
  2392. break;
  2393. case 5:
  2394. date.setMilliseconds(Math.round(date.getMilliseconds() / 1000) * 1000); break;
  2395. default:
  2396. date.setMilliseconds(Math.round(date.getMilliseconds() / 500) * 500); break;
  2397. }
  2398. }
  2399. else if (this.scale == TimeStep.SCALE.MILLISECOND) {
  2400. var step = this.step > 5 ? this.step / 2 : 1;
  2401. date.setMilliseconds(Math.round(date.getMilliseconds() / step) * step);
  2402. }
  2403. };
  2404. /**
  2405. * Check if the current value is a major value (for example when the step
  2406. * is DAY, a major value is each first day of the MONTH)
  2407. * @return {boolean} true if current date is major, else false.
  2408. */
  2409. TimeStep.prototype.isMajor = function() {
  2410. switch (this.scale) {
  2411. case TimeStep.SCALE.MILLISECOND:
  2412. return (this.current.getMilliseconds() == 0);
  2413. case TimeStep.SCALE.SECOND:
  2414. return (this.current.getSeconds() == 0);
  2415. case TimeStep.SCALE.MINUTE:
  2416. return (this.current.getHours() == 0) && (this.current.getMinutes() == 0);
  2417. // Note: this is no bug. Major label is equal for both minute and hour scale
  2418. case TimeStep.SCALE.HOUR:
  2419. return (this.current.getHours() == 0);
  2420. case TimeStep.SCALE.WEEKDAY: // intentional fall through
  2421. case TimeStep.SCALE.DAY:
  2422. return (this.current.getDate() == 1);
  2423. case TimeStep.SCALE.MONTH:
  2424. return (this.current.getMonth() == 0);
  2425. case TimeStep.SCALE.YEAR:
  2426. return false;
  2427. default:
  2428. return false;
  2429. }
  2430. };
  2431. /**
  2432. * Returns formatted text for the minor axislabel, depending on the current
  2433. * date and the scale. For example when scale is MINUTE, the current time is
  2434. * formatted as "hh:mm".
  2435. * @param {Date} [date] custom date. if not provided, current date is taken
  2436. */
  2437. TimeStep.prototype.getLabelMinor = function(date) {
  2438. if (date == undefined) {
  2439. date = this.current;
  2440. }
  2441. switch (this.scale) {
  2442. case TimeStep.SCALE.MILLISECOND: return moment(date).format('SSS');
  2443. case TimeStep.SCALE.SECOND: return moment(date).format('s');
  2444. case TimeStep.SCALE.MINUTE: return moment(date).format('HH:mm');
  2445. case TimeStep.SCALE.HOUR: return moment(date).format('HH:mm');
  2446. case TimeStep.SCALE.WEEKDAY: return moment(date).format('ddd D');
  2447. case TimeStep.SCALE.DAY: return moment(date).format('D');
  2448. case TimeStep.SCALE.MONTH: return moment(date).format('MMM');
  2449. case TimeStep.SCALE.YEAR: return moment(date).format('YYYY');
  2450. default: return '';
  2451. }
  2452. };
  2453. /**
  2454. * Returns formatted text for the major axis label, depending on the current
  2455. * date and the scale. For example when scale is MINUTE, the major scale is
  2456. * hours, and the hour will be formatted as "hh".
  2457. * @param {Date} [date] custom date. if not provided, current date is taken
  2458. */
  2459. TimeStep.prototype.getLabelMajor = function(date) {
  2460. if (date == undefined) {
  2461. date = this.current;
  2462. }
  2463. //noinspection FallthroughInSwitchStatementJS
  2464. switch (this.scale) {
  2465. case TimeStep.SCALE.MILLISECOND:return moment(date).format('HH:mm:ss');
  2466. case TimeStep.SCALE.SECOND: return moment(date).format('D MMMM HH:mm');
  2467. case TimeStep.SCALE.MINUTE:
  2468. case TimeStep.SCALE.HOUR: return moment(date).format('ddd D MMMM');
  2469. case TimeStep.SCALE.WEEKDAY:
  2470. case TimeStep.SCALE.DAY: return moment(date).format('MMMM YYYY');
  2471. case TimeStep.SCALE.MONTH: return moment(date).format('YYYY');
  2472. case TimeStep.SCALE.YEAR: return '';
  2473. default: return '';
  2474. }
  2475. };
  2476. /**
  2477. * @constructor Stack
  2478. * Stacks items on top of each other.
  2479. * @param {ItemSet} parent
  2480. * @param {Object} [options]
  2481. */
  2482. function Stack (parent, options) {
  2483. this.parent = parent;
  2484. this.options = options || {};
  2485. this.defaultOptions = {
  2486. order: function (a, b) {
  2487. //return (b.width - a.width) || (a.left - b.left); // TODO: cleanup
  2488. // Order: ranges over non-ranges, ranged ordered by width, and
  2489. // lastly ordered by start.
  2490. if (a instanceof ItemRange) {
  2491. if (b instanceof ItemRange) {
  2492. var aInt = (a.data.end - a.data.start);
  2493. var bInt = (b.data.end - b.data.start);
  2494. return (aInt - bInt) || (a.data.start - b.data.start);
  2495. }
  2496. else {
  2497. return -1;
  2498. }
  2499. }
  2500. else {
  2501. if (b instanceof ItemRange) {
  2502. return 1;
  2503. }
  2504. else {
  2505. return (a.data.start - b.data.start);
  2506. }
  2507. }
  2508. },
  2509. margin: {
  2510. item: 10
  2511. }
  2512. };
  2513. this.ordered = []; // ordered items
  2514. }
  2515. /**
  2516. * Set options for the stack
  2517. * @param {Object} options Available options:
  2518. * {ItemSet} parent
  2519. * {Number} margin
  2520. * {function} order Stacking order
  2521. */
  2522. Stack.prototype.setOptions = function setOptions (options) {
  2523. util.extend(this.options, options);
  2524. // TODO: register on data changes at the connected parent itemset, and update the changed part only and immediately
  2525. };
  2526. /**
  2527. * Stack the items such that they don't overlap. The items will have a minimal
  2528. * distance equal to options.margin.item.
  2529. */
  2530. Stack.prototype.update = function update() {
  2531. this._order();
  2532. this._stack();
  2533. };
  2534. /**
  2535. * Order the items. The items are ordered by width first, and by left position
  2536. * second.
  2537. * If a custom order function has been provided via the options, then this will
  2538. * be used.
  2539. * @private
  2540. */
  2541. Stack.prototype._order = function _order () {
  2542. var items = this.parent.items;
  2543. if (!items) {
  2544. throw new Error('Cannot stack items: parent does not contain items');
  2545. }
  2546. // TODO: store the sorted items, to have less work later on
  2547. var ordered = [];
  2548. var index = 0;
  2549. // items is a map (no array)
  2550. util.forEach(items, function (item) {
  2551. if (item.visible) {
  2552. ordered[index] = item;
  2553. index++;
  2554. }
  2555. });
  2556. //if a customer stack order function exists, use it.
  2557. var order = this.options.order || this.defaultOptions.order;
  2558. if (!(typeof order === 'function')) {
  2559. throw new Error('Option order must be a function');
  2560. }
  2561. ordered.sort(order);
  2562. this.ordered = ordered;
  2563. };
  2564. /**
  2565. * Adjust vertical positions of the events such that they don't overlap each
  2566. * other.
  2567. * @private
  2568. */
  2569. Stack.prototype._stack = function _stack () {
  2570. var i,
  2571. iMax,
  2572. ordered = this.ordered,
  2573. options = this.options,
  2574. orientation = options.orientation || this.defaultOptions.orientation,
  2575. axisOnTop = (orientation == 'top'),
  2576. margin;
  2577. if (options.margin && options.margin.item !== undefined) {
  2578. margin = options.margin.item;
  2579. }
  2580. else {
  2581. margin = this.defaultOptions.margin.item
  2582. }
  2583. // calculate new, non-overlapping positions
  2584. for (i = 0, iMax = ordered.length; i < iMax; i++) {
  2585. var item = ordered[i];
  2586. var collidingItem = null;
  2587. do {
  2588. // TODO: optimize checking for overlap. when there is a gap without items,
  2589. // you only need to check for items from the next item on, not from zero
  2590. collidingItem = this.checkOverlap(ordered, i, 0, i - 1, margin);
  2591. if (collidingItem != null) {
  2592. // There is a collision. Reposition the event above the colliding element
  2593. if (axisOnTop) {
  2594. item.top = collidingItem.top + collidingItem.height + margin;
  2595. }
  2596. else {
  2597. item.top = collidingItem.top - item.height - margin;
  2598. }
  2599. }
  2600. } while (collidingItem);
  2601. }
  2602. };
  2603. /**
  2604. * Check if the destiny position of given item overlaps with any
  2605. * of the other items from index itemStart to itemEnd.
  2606. * @param {Array} items Array with items
  2607. * @param {int} itemIndex Number of the item to be checked for overlap
  2608. * @param {int} itemStart First item to be checked.
  2609. * @param {int} itemEnd Last item to be checked.
  2610. * @return {Object | null} colliding item, or undefined when no collisions
  2611. * @param {Number} margin A minimum required margin.
  2612. * If margin is provided, the two items will be
  2613. * marked colliding when they overlap or
  2614. * when the margin between the two is smaller than
  2615. * the requested margin.
  2616. */
  2617. Stack.prototype.checkOverlap = function checkOverlap (items, itemIndex,
  2618. itemStart, itemEnd, margin) {
  2619. var collision = this.collision;
  2620. // we loop from end to start, as we suppose that the chance of a
  2621. // collision is larger for items at the end, so check these first.
  2622. var a = items[itemIndex];
  2623. for (var i = itemEnd; i >= itemStart; i--) {
  2624. var b = items[i];
  2625. if (collision(a, b, margin)) {
  2626. if (i != itemIndex) {
  2627. return b;
  2628. }
  2629. }
  2630. }
  2631. return null;
  2632. };
  2633. /**
  2634. * Test if the two provided items collide
  2635. * The items must have parameters left, width, top, and height.
  2636. * @param {Component} a The first item
  2637. * @param {Component} b The second item
  2638. * @param {Number} margin A minimum required margin.
  2639. * If margin is provided, the two items will be
  2640. * marked colliding when they overlap or
  2641. * when the margin between the two is smaller than
  2642. * the requested margin.
  2643. * @return {boolean} true if a and b collide, else false
  2644. */
  2645. Stack.prototype.collision = function collision (a, b, margin) {
  2646. return ((a.left - margin) < (b.left + b.width) &&
  2647. (a.left + a.width + margin) > b.left &&
  2648. (a.top - margin) < (b.top + b.height) &&
  2649. (a.top + a.height + margin) > b.top);
  2650. };
  2651. /**
  2652. * @constructor Range
  2653. * A Range controls a numeric range with a start and end value.
  2654. * The Range adjusts the range based on mouse events or programmatic changes,
  2655. * and triggers events when the range is changing or has been changed.
  2656. * @param {Object} [options] See description at Range.setOptions
  2657. * @extends Controller
  2658. */
  2659. function Range(options) {
  2660. this.id = util.randomUUID();
  2661. this.start = 0; // Number
  2662. this.end = 0; // Number
  2663. this.options = {
  2664. min: null,
  2665. max: null,
  2666. zoomMin: null,
  2667. zoomMax: null
  2668. };
  2669. this.listeners = [];
  2670. this.setOptions(options);
  2671. }
  2672. /**
  2673. * Set options for the range controller
  2674. * @param {Object} options Available options:
  2675. * {Number} start Set start value of the range
  2676. * {Number} end Set end value of the range
  2677. * {Number} min Minimum value for start
  2678. * {Number} max Maximum value for end
  2679. * {Number} zoomMin Set a minimum value for
  2680. * (end - start).
  2681. * {Number} zoomMax Set a maximum value for
  2682. * (end - start).
  2683. */
  2684. Range.prototype.setOptions = function (options) {
  2685. util.extend(this.options, options);
  2686. if (options.start != null || options.end != null) {
  2687. this.setRange(options.start, options.end);
  2688. }
  2689. };
  2690. /**
  2691. * Add listeners for mouse and touch events to the component
  2692. * @param {Component} component
  2693. * @param {String} event Available events: 'move', 'zoom'
  2694. * @param {String} direction Available directions: 'horizontal', 'vertical'
  2695. */
  2696. Range.prototype.subscribe = function (component, event, direction) {
  2697. var me = this;
  2698. var listener;
  2699. if (direction != 'horizontal' && direction != 'vertical') {
  2700. throw new TypeError('Unknown direction "' + direction + '". ' +
  2701. 'Choose "horizontal" or "vertical".');
  2702. }
  2703. //noinspection FallthroughInSwitchStatementJS
  2704. if (event == 'move') {
  2705. listener = {
  2706. component: component,
  2707. event: event,
  2708. direction: direction,
  2709. callback: function (event) {
  2710. me._onMouseDown(event, listener);
  2711. },
  2712. params: {}
  2713. };
  2714. component.on('mousedown', listener.callback);
  2715. me.listeners.push(listener);
  2716. }
  2717. else if (event == 'zoom') {
  2718. listener = {
  2719. component: component,
  2720. event: event,
  2721. direction: direction,
  2722. callback: function (event) {
  2723. me._onMouseWheel(event, listener);
  2724. },
  2725. params: {}
  2726. };
  2727. component.on('mousewheel', listener.callback);
  2728. me.listeners.push(listener);
  2729. }
  2730. else {
  2731. throw new TypeError('Unknown event "' + event + '". ' +
  2732. 'Choose "move" or "zoom".');
  2733. }
  2734. };
  2735. /**
  2736. * Event handler
  2737. * @param {String} event name of the event, for example 'click', 'mousemove'
  2738. * @param {function} callback callback handler, invoked with the raw HTML Event
  2739. * as parameter.
  2740. */
  2741. Range.prototype.on = function (event, callback) {
  2742. events.addListener(this, event, callback);
  2743. };
  2744. /**
  2745. * Trigger an event
  2746. * @param {String} event name of the event, available events: 'rangechange',
  2747. * 'rangechanged'
  2748. * @private
  2749. */
  2750. Range.prototype._trigger = function (event) {
  2751. events.trigger(this, event, {
  2752. start: this.start,
  2753. end: this.end
  2754. });
  2755. };
  2756. /**
  2757. * Set a new start and end range
  2758. * @param {Number} start
  2759. * @param {Number} end
  2760. */
  2761. Range.prototype.setRange = function(start, end) {
  2762. var changed = this._applyRange(start, end);
  2763. if (changed) {
  2764. this._trigger('rangechange');
  2765. this._trigger('rangechanged');
  2766. }
  2767. };
  2768. /**
  2769. * Set a new start and end range. This method is the same as setRange, but
  2770. * does not trigger a range change and range changed event, and it returns
  2771. * true when the range is changed
  2772. * @param {Number} start
  2773. * @param {Number} end
  2774. * @return {Boolean} changed
  2775. * @private
  2776. */
  2777. Range.prototype._applyRange = function(start, end) {
  2778. var newStart = (start != null) ? util.cast(start, 'Number') : this.start;
  2779. var newEnd = (end != null) ? util.cast(end, 'Number') : this.end;
  2780. var diff;
  2781. // check for valid number
  2782. if (isNaN(newStart)) {
  2783. throw new Error('Invalid start "' + start + '"');
  2784. }
  2785. if (isNaN(newEnd)) {
  2786. throw new Error('Invalid end "' + end + '"');
  2787. }
  2788. // prevent start < end
  2789. if (newEnd < newStart) {
  2790. newEnd = newStart;
  2791. }
  2792. // prevent start < min
  2793. if (this.options.min != null) {
  2794. var min = this.options.min.valueOf();
  2795. if (newStart < min) {
  2796. diff = (min - newStart);
  2797. newStart += diff;
  2798. newEnd += diff;
  2799. }
  2800. }
  2801. // prevent end > max
  2802. if (this.options.max != null) {
  2803. var max = this.options.max.valueOf();
  2804. if (newEnd > max) {
  2805. diff = (newEnd - max);
  2806. newStart -= diff;
  2807. newEnd -= diff;
  2808. }
  2809. }
  2810. // prevent (end-start) > zoomMin
  2811. if (this.options.zoomMin != null) {
  2812. var zoomMin = this.options.zoomMin.valueOf();
  2813. if (zoomMin < 0) {
  2814. zoomMin = 0;
  2815. }
  2816. if ((newEnd - newStart) < zoomMin) {
  2817. if ((this.end - this.start) > zoomMin) {
  2818. // zoom to the minimum
  2819. diff = (zoomMin - (newEnd - newStart));
  2820. newStart -= diff / 2;
  2821. newEnd += diff / 2;
  2822. }
  2823. else {
  2824. // ingore this action, we are already zoomed to the minimum
  2825. newStart = this.start;
  2826. newEnd = this.end;
  2827. }
  2828. }
  2829. }
  2830. // prevent (end-start) > zoomMin
  2831. if (this.options.zoomMax != null) {
  2832. var zoomMax = this.options.zoomMax.valueOf();
  2833. if (zoomMax < 0) {
  2834. zoomMax = 0;
  2835. }
  2836. if ((newEnd - newStart) > zoomMax) {
  2837. if ((this.end - this.start) < zoomMax) {
  2838. // zoom to the maximum
  2839. diff = ((newEnd - newStart) - zoomMax);
  2840. newStart += diff / 2;
  2841. newEnd -= diff / 2;
  2842. }
  2843. else {
  2844. // ingore this action, we are already zoomed to the maximum
  2845. newStart = this.start;
  2846. newEnd = this.end;
  2847. }
  2848. }
  2849. }
  2850. var changed = (this.start != newStart || this.end != newEnd);
  2851. this.start = newStart;
  2852. this.end = newEnd;
  2853. return changed;
  2854. };
  2855. /**
  2856. * Retrieve the current range.
  2857. * @return {Object} An object with start and end properties
  2858. */
  2859. Range.prototype.getRange = function() {
  2860. return {
  2861. start: this.start,
  2862. end: this.end
  2863. };
  2864. };
  2865. /**
  2866. * Calculate the conversion offset and factor for current range, based on
  2867. * the provided width
  2868. * @param {Number} width
  2869. * @returns {{offset: number, factor: number}} conversion
  2870. */
  2871. Range.prototype.conversion = function (width) {
  2872. var start = this.start;
  2873. var end = this.end;
  2874. return Range.conversion(this.start, this.end, width);
  2875. };
  2876. /**
  2877. * Static method to calculate the conversion offset and factor for a range,
  2878. * based on the provided start, end, and width
  2879. * @param {Number} start
  2880. * @param {Number} end
  2881. * @param {Number} width
  2882. * @returns {{offset: number, factor: number}} conversion
  2883. */
  2884. Range.conversion = function (start, end, width) {
  2885. if (width != 0 && (end - start != 0)) {
  2886. return {
  2887. offset: start,
  2888. factor: width / (end - start)
  2889. }
  2890. }
  2891. else {
  2892. return {
  2893. offset: 0,
  2894. factor: 1
  2895. };
  2896. }
  2897. };
  2898. /**
  2899. * Start moving horizontally or vertically
  2900. * @param {Event} event
  2901. * @param {Object} listener Listener containing the component and params
  2902. * @private
  2903. */
  2904. Range.prototype._onMouseDown = function(event, listener) {
  2905. event = event || window.event;
  2906. var params = listener.params;
  2907. // only react on left mouse button down
  2908. var leftButtonDown = event.which ? (event.which == 1) : (event.button == 1);
  2909. if (!leftButtonDown) {
  2910. return;
  2911. }
  2912. // get mouse position
  2913. params.mouseX = util.getPageX(event);
  2914. params.mouseY = util.getPageY(event);
  2915. params.previousLeft = 0;
  2916. params.previousOffset = 0;
  2917. params.moved = false;
  2918. params.start = this.start;
  2919. params.end = this.end;
  2920. var frame = listener.component.frame;
  2921. if (frame) {
  2922. frame.style.cursor = 'move';
  2923. }
  2924. // add event listeners to handle moving the contents
  2925. // we store the function onmousemove and onmouseup in the timeaxis,
  2926. // so we can remove the eventlisteners lateron in the function onmouseup
  2927. var me = this;
  2928. if (!params.onMouseMove) {
  2929. params.onMouseMove = function (event) {
  2930. me._onMouseMove(event, listener);
  2931. };
  2932. util.addEventListener(document, "mousemove", params.onMouseMove);
  2933. }
  2934. if (!params.onMouseUp) {
  2935. params.onMouseUp = function (event) {
  2936. me._onMouseUp(event, listener);
  2937. };
  2938. util.addEventListener(document, "mouseup", params.onMouseUp);
  2939. }
  2940. util.preventDefault(event);
  2941. };
  2942. /**
  2943. * Perform moving operating.
  2944. * This function activated from within the funcion TimeAxis._onMouseDown().
  2945. * @param {Event} event
  2946. * @param {Object} listener
  2947. * @private
  2948. */
  2949. Range.prototype._onMouseMove = function (event, listener) {
  2950. event = event || window.event;
  2951. var params = listener.params;
  2952. // calculate change in mouse position
  2953. var mouseX = util.getPageX(event);
  2954. var mouseY = util.getPageY(event);
  2955. if (params.mouseX == undefined) {
  2956. params.mouseX = mouseX;
  2957. }
  2958. if (params.mouseY == undefined) {
  2959. params.mouseY = mouseY;
  2960. }
  2961. var diffX = mouseX - params.mouseX;
  2962. var diffY = mouseY - params.mouseY;
  2963. var diff = (listener.direction == 'horizontal') ? diffX : diffY;
  2964. // if mouse movement is big enough, register it as a "moved" event
  2965. if (Math.abs(diff) >= 1) {
  2966. params.moved = true;
  2967. }
  2968. var interval = (params.end - params.start);
  2969. var width = (listener.direction == 'horizontal') ?
  2970. listener.component.width : listener.component.height;
  2971. var diffRange = -diff / width * interval;
  2972. this._applyRange(params.start + diffRange, params.end + diffRange);
  2973. // fire a rangechange event
  2974. this._trigger('rangechange');
  2975. util.preventDefault(event);
  2976. };
  2977. /**
  2978. * Stop moving operating.
  2979. * This function activated from within the function Range._onMouseDown().
  2980. * @param {event} event
  2981. * @param {Object} listener
  2982. * @private
  2983. */
  2984. Range.prototype._onMouseUp = function (event, listener) {
  2985. event = event || window.event;
  2986. var params = listener.params;
  2987. if (listener.component.frame) {
  2988. listener.component.frame.style.cursor = 'auto';
  2989. }
  2990. // remove event listeners here, important for Safari
  2991. if (params.onMouseMove) {
  2992. util.removeEventListener(document, "mousemove", params.onMouseMove);
  2993. params.onMouseMove = null;
  2994. }
  2995. if (params.onMouseUp) {
  2996. util.removeEventListener(document, "mouseup", params.onMouseUp);
  2997. params.onMouseUp = null;
  2998. }
  2999. //util.preventDefault(event);
  3000. if (params.moved) {
  3001. // fire a rangechanged event
  3002. this._trigger('rangechanged');
  3003. }
  3004. };
  3005. /**
  3006. * Event handler for mouse wheel event, used to zoom
  3007. * Code from http://adomas.org/javascript-mouse-wheel/
  3008. * @param {Event} event
  3009. * @param {Object} listener
  3010. * @private
  3011. */
  3012. Range.prototype._onMouseWheel = function(event, listener) {
  3013. event = event || window.event;
  3014. // retrieve delta
  3015. var delta = 0;
  3016. if (event.wheelDelta) { /* IE/Opera. */
  3017. delta = event.wheelDelta / 120;
  3018. } else if (event.detail) { /* Mozilla case. */
  3019. // In Mozilla, sign of delta is different than in IE.
  3020. // Also, delta is multiple of 3.
  3021. delta = -event.detail / 3;
  3022. }
  3023. // If delta is nonzero, handle it.
  3024. // Basically, delta is now positive if wheel was scrolled up,
  3025. // and negative, if wheel was scrolled down.
  3026. if (delta) {
  3027. var me = this;
  3028. var zoom = function () {
  3029. // perform the zoom action. Delta is normally 1 or -1
  3030. var zoomFactor = delta / 5.0;
  3031. var zoomAround = null;
  3032. var frame = listener.component.frame;
  3033. if (frame) {
  3034. var size, conversion;
  3035. if (listener.direction == 'horizontal') {
  3036. size = listener.component.width;
  3037. conversion = me.conversion(size);
  3038. var frameLeft = util.getAbsoluteLeft(frame);
  3039. var mouseX = util.getPageX(event);
  3040. zoomAround = (mouseX - frameLeft) / conversion.factor + conversion.offset;
  3041. }
  3042. else {
  3043. size = listener.component.height;
  3044. conversion = me.conversion(size);
  3045. var frameTop = util.getAbsoluteTop(frame);
  3046. var mouseY = util.getPageY(event);
  3047. zoomAround = ((frameTop + size - mouseY) - frameTop) / conversion.factor + conversion.offset;
  3048. }
  3049. }
  3050. me.zoom(zoomFactor, zoomAround);
  3051. };
  3052. zoom();
  3053. }
  3054. // Prevent default actions caused by mouse wheel.
  3055. // That might be ugly, but we handle scrolls somehow
  3056. // anyway, so don't bother here...
  3057. util.preventDefault(event);
  3058. };
  3059. /**
  3060. * Zoom the range the given zoomfactor in or out. Start and end date will
  3061. * be adjusted, and the timeline will be redrawn. You can optionally give a
  3062. * date around which to zoom.
  3063. * For example, try zoomfactor = 0.1 or -0.1
  3064. * @param {Number} zoomFactor Zooming amount. Positive value will zoom in,
  3065. * negative value will zoom out
  3066. * @param {Number} zoomAround Value around which will be zoomed. Optional
  3067. */
  3068. Range.prototype.zoom = function(zoomFactor, zoomAround) {
  3069. // if zoomAroundDate is not provided, take it half between start Date and end Date
  3070. if (zoomAround == null) {
  3071. zoomAround = (this.start + this.end) / 2;
  3072. }
  3073. // prevent zoom factor larger than 1 or smaller than -1 (larger than 1 will
  3074. // result in a start>=end )
  3075. if (zoomFactor >= 1) {
  3076. zoomFactor = 0.9;
  3077. }
  3078. if (zoomFactor <= -1) {
  3079. zoomFactor = -0.9;
  3080. }
  3081. // adjust a negative factor such that zooming in with 0.1 equals zooming
  3082. // out with a factor -0.1
  3083. if (zoomFactor < 0) {
  3084. zoomFactor = zoomFactor / (1 + zoomFactor);
  3085. }
  3086. // zoom start and end relative to the zoomAround value
  3087. var startDiff = (this.start - zoomAround);
  3088. var endDiff = (this.end - zoomAround);
  3089. // calculate new start and end
  3090. var newStart = this.start - startDiff * zoomFactor;
  3091. var newEnd = this.end - endDiff * zoomFactor;
  3092. this.setRange(newStart, newEnd);
  3093. };
  3094. /**
  3095. * Move the range with a given factor to the left or right. Start and end
  3096. * value will be adjusted. For example, try moveFactor = 0.1 or -0.1
  3097. * @param {Number} moveFactor Moving amount. Positive value will move right,
  3098. * negative value will move left
  3099. */
  3100. Range.prototype.move = function(moveFactor) {
  3101. // zoom start Date and end Date relative to the zoomAroundDate
  3102. var diff = (this.end - this.start);
  3103. // apply new values
  3104. var newStart = this.start + diff * moveFactor;
  3105. var newEnd = this.end + diff * moveFactor;
  3106. // TODO: reckon with min and max range
  3107. this.start = newStart;
  3108. this.end = newEnd;
  3109. };
  3110. /**
  3111. * @constructor Controller
  3112. *
  3113. * A Controller controls the reflows and repaints of all visual components
  3114. */
  3115. function Controller () {
  3116. this.id = util.randomUUID();
  3117. this.components = {};
  3118. this.repaintTimer = undefined;
  3119. this.reflowTimer = undefined;
  3120. }
  3121. /**
  3122. * Add a component to the controller
  3123. * @param {Component} component
  3124. */
  3125. Controller.prototype.add = function add(component) {
  3126. // validate the component
  3127. if (component.id == undefined) {
  3128. throw new Error('Component has no field id');
  3129. }
  3130. if (!(component instanceof Component) && !(component instanceof Controller)) {
  3131. throw new TypeError('Component must be an instance of ' +
  3132. 'prototype Component or Controller');
  3133. }
  3134. // add the component
  3135. component.controller = this;
  3136. this.components[component.id] = component;
  3137. };
  3138. /**
  3139. * Remove a component from the controller
  3140. * @param {Component | String} component
  3141. */
  3142. Controller.prototype.remove = function remove(component) {
  3143. var id;
  3144. for (id in this.components) {
  3145. if (this.components.hasOwnProperty(id)) {
  3146. if (id == component || this.components[id] == component) {
  3147. break;
  3148. }
  3149. }
  3150. }
  3151. if (id) {
  3152. delete this.components[id];
  3153. }
  3154. };
  3155. /**
  3156. * Request a reflow. The controller will schedule a reflow
  3157. * @param {Boolean} [force] If true, an immediate reflow is forced. Default
  3158. * is false.
  3159. */
  3160. Controller.prototype.requestReflow = function requestReflow(force) {
  3161. if (force) {
  3162. this.reflow();
  3163. }
  3164. else {
  3165. if (!this.reflowTimer) {
  3166. var me = this;
  3167. this.reflowTimer = setTimeout(function () {
  3168. me.reflowTimer = undefined;
  3169. me.reflow();
  3170. }, 0);
  3171. }
  3172. }
  3173. };
  3174. /**
  3175. * Request a repaint. The controller will schedule a repaint
  3176. * @param {Boolean} [force] If true, an immediate repaint is forced. Default
  3177. * is false.
  3178. */
  3179. Controller.prototype.requestRepaint = function requestRepaint(force) {
  3180. if (force) {
  3181. this.repaint();
  3182. }
  3183. else {
  3184. if (!this.repaintTimer) {
  3185. var me = this;
  3186. this.repaintTimer = setTimeout(function () {
  3187. me.repaintTimer = undefined;
  3188. me.repaint();
  3189. }, 0);
  3190. }
  3191. }
  3192. };
  3193. /**
  3194. * Repaint all components
  3195. */
  3196. Controller.prototype.repaint = function repaint() {
  3197. var changed = false;
  3198. // cancel any running repaint request
  3199. if (this.repaintTimer) {
  3200. clearTimeout(this.repaintTimer);
  3201. this.repaintTimer = undefined;
  3202. }
  3203. var done = {};
  3204. function repaint(component, id) {
  3205. if (!(id in done)) {
  3206. // first repaint the components on which this component is dependent
  3207. if (component.depends) {
  3208. component.depends.forEach(function (dep) {
  3209. repaint(dep, dep.id);
  3210. });
  3211. }
  3212. if (component.parent) {
  3213. repaint(component.parent, component.parent.id);
  3214. }
  3215. // repaint the component itself and mark as done
  3216. changed = component.repaint() || changed;
  3217. done[id] = true;
  3218. }
  3219. }
  3220. util.forEach(this.components, repaint);
  3221. // immediately reflow when needed
  3222. if (changed) {
  3223. this.reflow();
  3224. }
  3225. // TODO: limit the number of nested reflows/repaints, prevent loop
  3226. };
  3227. /**
  3228. * Reflow all components
  3229. */
  3230. Controller.prototype.reflow = function reflow() {
  3231. var resized = false;
  3232. // cancel any running repaint request
  3233. if (this.reflowTimer) {
  3234. clearTimeout(this.reflowTimer);
  3235. this.reflowTimer = undefined;
  3236. }
  3237. var done = {};
  3238. function reflow(component, id) {
  3239. if (!(id in done)) {
  3240. // first reflow the components on which this component is dependent
  3241. if (component.depends) {
  3242. component.depends.forEach(function (dep) {
  3243. reflow(dep, dep.id);
  3244. });
  3245. }
  3246. if (component.parent) {
  3247. reflow(component.parent, component.parent.id);
  3248. }
  3249. // reflow the component itself and mark as done
  3250. resized = component.reflow() || resized;
  3251. done[id] = true;
  3252. }
  3253. }
  3254. util.forEach(this.components, reflow);
  3255. // immediately repaint when needed
  3256. if (resized) {
  3257. this.repaint();
  3258. }
  3259. // TODO: limit the number of nested reflows/repaints, prevent loop
  3260. };
  3261. /**
  3262. * Prototype for visual components
  3263. */
  3264. function Component () {
  3265. this.id = null;
  3266. this.parent = null;
  3267. this.depends = null;
  3268. this.controller = null;
  3269. this.options = null;
  3270. this.frame = null; // main DOM element
  3271. this.top = 0;
  3272. this.left = 0;
  3273. this.width = 0;
  3274. this.height = 0;
  3275. }
  3276. /**
  3277. * Set parameters for the frame. Parameters will be merged in current parameter
  3278. * set.
  3279. * @param {Object} options Available parameters:
  3280. * {String | function} [className]
  3281. * {EventBus} [eventBus]
  3282. * {String | Number | function} [left]
  3283. * {String | Number | function} [top]
  3284. * {String | Number | function} [width]
  3285. * {String | Number | function} [height]
  3286. */
  3287. Component.prototype.setOptions = function setOptions(options) {
  3288. if (options) {
  3289. util.extend(this.options, options);
  3290. if (this.controller) {
  3291. this.requestRepaint();
  3292. this.requestReflow();
  3293. }
  3294. }
  3295. };
  3296. /**
  3297. * Get an option value by name
  3298. * The function will first check this.options object, and else will check
  3299. * this.defaultOptions.
  3300. * @param {String} name
  3301. * @return {*} value
  3302. */
  3303. Component.prototype.getOption = function getOption(name) {
  3304. var value;
  3305. if (this.options) {
  3306. value = this.options[name];
  3307. }
  3308. if (value === undefined && this.defaultOptions) {
  3309. value = this.defaultOptions[name];
  3310. }
  3311. return value;
  3312. };
  3313. /**
  3314. * Get the container element of the component, which can be used by a child to
  3315. * add its own widgets. Not all components do have a container for childs, in
  3316. * that case null is returned.
  3317. * @returns {HTMLElement | null} container
  3318. */
  3319. Component.prototype.getContainer = function getContainer() {
  3320. // should be implemented by the component
  3321. return null;
  3322. };
  3323. /**
  3324. * Get the frame element of the component, the outer HTML DOM element.
  3325. * @returns {HTMLElement | null} frame
  3326. */
  3327. Component.prototype.getFrame = function getFrame() {
  3328. return this.frame;
  3329. };
  3330. /**
  3331. * Repaint the component
  3332. * @return {Boolean} changed
  3333. */
  3334. Component.prototype.repaint = function repaint() {
  3335. // should be implemented by the component
  3336. return false;
  3337. };
  3338. /**
  3339. * Reflow the component
  3340. * @return {Boolean} resized
  3341. */
  3342. Component.prototype.reflow = function reflow() {
  3343. // should be implemented by the component
  3344. return false;
  3345. };
  3346. /**
  3347. * Hide the component from the DOM
  3348. * @return {Boolean} changed
  3349. */
  3350. Component.prototype.hide = function hide() {
  3351. if (this.frame && this.frame.parentNode) {
  3352. this.frame.parentNode.removeChild(this.frame);
  3353. return true;
  3354. }
  3355. else {
  3356. return false;
  3357. }
  3358. };
  3359. /**
  3360. * Show the component in the DOM (when not already visible).
  3361. * A repaint will be executed when the component is not visible
  3362. * @return {Boolean} changed
  3363. */
  3364. Component.prototype.show = function show() {
  3365. if (!this.frame || !this.frame.parentNode) {
  3366. return this.repaint();
  3367. }
  3368. else {
  3369. return false;
  3370. }
  3371. };
  3372. /**
  3373. * Request a repaint. The controller will schedule a repaint
  3374. */
  3375. Component.prototype.requestRepaint = function requestRepaint() {
  3376. if (this.controller) {
  3377. this.controller.requestRepaint();
  3378. }
  3379. else {
  3380. throw new Error('Cannot request a repaint: no controller configured');
  3381. // TODO: just do a repaint when no parent is configured?
  3382. }
  3383. };
  3384. /**
  3385. * Request a reflow. The controller will schedule a reflow
  3386. */
  3387. Component.prototype.requestReflow = function requestReflow() {
  3388. if (this.controller) {
  3389. this.controller.requestReflow();
  3390. }
  3391. else {
  3392. throw new Error('Cannot request a reflow: no controller configured');
  3393. // TODO: just do a reflow when no parent is configured?
  3394. }
  3395. };
  3396. /**
  3397. * A panel can contain components
  3398. * @param {Component} [parent]
  3399. * @param {Component[]} [depends] Components on which this components depends
  3400. * (except for the parent)
  3401. * @param {Object} [options] Available parameters:
  3402. * {String | Number | function} [left]
  3403. * {String | Number | function} [top]
  3404. * {String | Number | function} [width]
  3405. * {String | Number | function} [height]
  3406. * {String | function} [className]
  3407. * @constructor Panel
  3408. * @extends Component
  3409. */
  3410. function Panel(parent, depends, options) {
  3411. this.id = util.randomUUID();
  3412. this.parent = parent;
  3413. this.depends = depends;
  3414. this.options = options || {};
  3415. }
  3416. Panel.prototype = new Component();
  3417. /**
  3418. * Set options. Will extend the current options.
  3419. * @param {Object} [options] Available parameters:
  3420. * {String | function} [className]
  3421. * {String | Number | function} [left]
  3422. * {String | Number | function} [top]
  3423. * {String | Number | function} [width]
  3424. * {String | Number | function} [height]
  3425. */
  3426. Panel.prototype.setOptions = Component.prototype.setOptions;
  3427. /**
  3428. * Get the container element of the panel, which can be used by a child to
  3429. * add its own widgets.
  3430. * @returns {HTMLElement} container
  3431. */
  3432. Panel.prototype.getContainer = function () {
  3433. return this.frame;
  3434. };
  3435. /**
  3436. * Repaint the component
  3437. * @return {Boolean} changed
  3438. */
  3439. Panel.prototype.repaint = function () {
  3440. var changed = 0,
  3441. update = util.updateProperty,
  3442. asSize = util.option.asSize,
  3443. options = this.options,
  3444. frame = this.frame;
  3445. if (!frame) {
  3446. frame = document.createElement('div');
  3447. frame.className = 'panel';
  3448. var className = options.className;
  3449. if (className) {
  3450. if (typeof className == 'function') {
  3451. util.addClassName(frame, String(className()));
  3452. }
  3453. else {
  3454. util.addClassName(frame, String(className));
  3455. }
  3456. }
  3457. this.frame = frame;
  3458. changed += 1;
  3459. }
  3460. if (!frame.parentNode) {
  3461. if (!this.parent) {
  3462. throw new Error('Cannot repaint panel: no parent attached');
  3463. }
  3464. var parentContainer = this.parent.getContainer();
  3465. if (!parentContainer) {
  3466. throw new Error('Cannot repaint panel: parent has no container element');
  3467. }
  3468. parentContainer.appendChild(frame);
  3469. changed += 1;
  3470. }
  3471. changed += update(frame.style, 'top', asSize(options.top, '0px'));
  3472. changed += update(frame.style, 'left', asSize(options.left, '0px'));
  3473. changed += update(frame.style, 'width', asSize(options.width, '100%'));
  3474. changed += update(frame.style, 'height', asSize(options.height, '100%'));
  3475. return (changed > 0);
  3476. };
  3477. /**
  3478. * Reflow the component
  3479. * @return {Boolean} resized
  3480. */
  3481. Panel.prototype.reflow = function () {
  3482. var changed = 0,
  3483. update = util.updateProperty,
  3484. frame = this.frame;
  3485. if (frame) {
  3486. changed += update(this, 'top', frame.offsetTop);
  3487. changed += update(this, 'left', frame.offsetLeft);
  3488. changed += update(this, 'width', frame.offsetWidth);
  3489. changed += update(this, 'height', frame.offsetHeight);
  3490. }
  3491. else {
  3492. changed += 1;
  3493. }
  3494. return (changed > 0);
  3495. };
  3496. /**
  3497. * A root panel can hold components. The root panel must be initialized with
  3498. * a DOM element as container.
  3499. * @param {HTMLElement} container
  3500. * @param {Object} [options] Available parameters: see RootPanel.setOptions.
  3501. * @constructor RootPanel
  3502. * @extends Panel
  3503. */
  3504. function RootPanel(container, options) {
  3505. this.id = util.randomUUID();
  3506. this.container = container;
  3507. this.options = options || {};
  3508. this.defaultOptions = {
  3509. autoResize: true
  3510. };
  3511. this.listeners = {}; // event listeners
  3512. }
  3513. RootPanel.prototype = new Panel();
  3514. /**
  3515. * Set options. Will extend the current options.
  3516. * @param {Object} [options] Available parameters:
  3517. * {String | function} [className]
  3518. * {String | Number | function} [left]
  3519. * {String | Number | function} [top]
  3520. * {String | Number | function} [width]
  3521. * {String | Number | function} [height]
  3522. * {Boolean | function} [autoResize]
  3523. */
  3524. RootPanel.prototype.setOptions = Component.prototype.setOptions;
  3525. /**
  3526. * Repaint the component
  3527. * @return {Boolean} changed
  3528. */
  3529. RootPanel.prototype.repaint = function () {
  3530. var changed = 0,
  3531. update = util.updateProperty,
  3532. asSize = util.option.asSize,
  3533. options = this.options,
  3534. frame = this.frame;
  3535. if (!frame) {
  3536. frame = document.createElement('div');
  3537. frame.className = 'graph panel';
  3538. var className = options.className;
  3539. if (className) {
  3540. util.addClassName(frame, util.option.asString(className));
  3541. }
  3542. this.frame = frame;
  3543. changed += 1;
  3544. }
  3545. if (!frame.parentNode) {
  3546. if (!this.container) {
  3547. throw new Error('Cannot repaint root panel: no container attached');
  3548. }
  3549. this.container.appendChild(frame);
  3550. changed += 1;
  3551. }
  3552. changed += update(frame.style, 'top', asSize(options.top, '0px'));
  3553. changed += update(frame.style, 'left', asSize(options.left, '0px'));
  3554. changed += update(frame.style, 'width', asSize(options.width, '100%'));
  3555. changed += update(frame.style, 'height', asSize(options.height, '100%'));
  3556. this._updateEventEmitters();
  3557. this._updateWatch();
  3558. return (changed > 0);
  3559. };
  3560. /**
  3561. * Reflow the component
  3562. * @return {Boolean} resized
  3563. */
  3564. RootPanel.prototype.reflow = function () {
  3565. var changed = 0,
  3566. update = util.updateProperty,
  3567. frame = this.frame;
  3568. if (frame) {
  3569. changed += update(this, 'top', frame.offsetTop);
  3570. changed += update(this, 'left', frame.offsetLeft);
  3571. changed += update(this, 'width', frame.offsetWidth);
  3572. changed += update(this, 'height', frame.offsetHeight);
  3573. }
  3574. else {
  3575. changed += 1;
  3576. }
  3577. return (changed > 0);
  3578. };
  3579. /**
  3580. * Update watching for resize, depending on the current option
  3581. * @private
  3582. */
  3583. RootPanel.prototype._updateWatch = function () {
  3584. var autoResize = this.getOption('autoResize');
  3585. if (autoResize) {
  3586. this._watch();
  3587. }
  3588. else {
  3589. this._unwatch();
  3590. }
  3591. };
  3592. /**
  3593. * Watch for changes in the size of the frame. On resize, the Panel will
  3594. * automatically redraw itself.
  3595. * @private
  3596. */
  3597. RootPanel.prototype._watch = function () {
  3598. var me = this;
  3599. this._unwatch();
  3600. var checkSize = function () {
  3601. var autoResize = me.getOption('autoResize');
  3602. if (!autoResize) {
  3603. // stop watching when the option autoResize is changed to false
  3604. me._unwatch();
  3605. return;
  3606. }
  3607. if (me.frame) {
  3608. // check whether the frame is resized
  3609. if ((me.frame.clientWidth != me.width) ||
  3610. (me.frame.clientHeight != me.height)) {
  3611. me.requestReflow();
  3612. }
  3613. }
  3614. };
  3615. // TODO: automatically cleanup the event listener when the frame is deleted
  3616. util.addEventListener(window, 'resize', checkSize);
  3617. this.watchTimer = setInterval(checkSize, 1000);
  3618. };
  3619. /**
  3620. * Stop watching for a resize of the frame.
  3621. * @private
  3622. */
  3623. RootPanel.prototype._unwatch = function () {
  3624. if (this.watchTimer) {
  3625. clearInterval(this.watchTimer);
  3626. this.watchTimer = undefined;
  3627. }
  3628. // TODO: remove event listener on window.resize
  3629. };
  3630. /**
  3631. * Event handler
  3632. * @param {String} event name of the event, for example 'click', 'mousemove'
  3633. * @param {function} callback callback handler, invoked with the raw HTML Event
  3634. * as parameter.
  3635. */
  3636. RootPanel.prototype.on = function (event, callback) {
  3637. // register the listener at this component
  3638. var arr = this.listeners[event];
  3639. if (!arr) {
  3640. arr = [];
  3641. this.listeners[event] = arr;
  3642. }
  3643. arr.push(callback);
  3644. this._updateEventEmitters();
  3645. };
  3646. /**
  3647. * Update the event listeners for all event emitters
  3648. * @private
  3649. */
  3650. RootPanel.prototype._updateEventEmitters = function () {
  3651. if (this.listeners) {
  3652. var me = this;
  3653. util.forEach(this.listeners, function (listeners, event) {
  3654. if (!me.emitters) {
  3655. me.emitters = {};
  3656. }
  3657. if (!(event in me.emitters)) {
  3658. // create event
  3659. var frame = me.frame;
  3660. if (frame) {
  3661. //console.log('Created a listener for event ' + event + ' on component ' + me.id); // TODO: cleanup logging
  3662. var callback = function(event) {
  3663. listeners.forEach(function (listener) {
  3664. // TODO: filter on event target!
  3665. listener(event);
  3666. });
  3667. };
  3668. me.emitters[event] = callback;
  3669. util.addEventListener(frame, event, callback);
  3670. }
  3671. }
  3672. });
  3673. // TODO: be able to delete event listeners
  3674. // TODO: be able to move event listeners to a parent when available
  3675. }
  3676. };
  3677. /**
  3678. * A horizontal time axis
  3679. * @param {Component} parent
  3680. * @param {Component[]} [depends] Components on which this components depends
  3681. * (except for the parent)
  3682. * @param {Object} [options] See TimeAxis.setOptions for the available
  3683. * options.
  3684. * @constructor TimeAxis
  3685. * @extends Component
  3686. */
  3687. function TimeAxis (parent, depends, options) {
  3688. this.id = util.randomUUID();
  3689. this.parent = parent;
  3690. this.depends = depends;
  3691. this.dom = {
  3692. majorLines: [],
  3693. majorTexts: [],
  3694. minorLines: [],
  3695. minorTexts: [],
  3696. redundant: {
  3697. majorLines: [],
  3698. majorTexts: [],
  3699. minorLines: [],
  3700. minorTexts: []
  3701. }
  3702. };
  3703. this.props = {
  3704. range: {
  3705. start: 0,
  3706. end: 0,
  3707. minimumStep: 0
  3708. },
  3709. lineTop: 0
  3710. };
  3711. this.options = options || {};
  3712. this.defaultOptions = {
  3713. orientation: 'bottom', // supported: 'top', 'bottom'
  3714. // TODO: implement timeaxis orientations 'left' and 'right'
  3715. showMinorLabels: true,
  3716. showMajorLabels: true
  3717. };
  3718. this.conversion = null;
  3719. this.range = null;
  3720. }
  3721. TimeAxis.prototype = new Component();
  3722. // TODO: comment options
  3723. TimeAxis.prototype.setOptions = Component.prototype.setOptions;
  3724. /**
  3725. * Set a range (start and end)
  3726. * @param {Range | Object} range A Range or an object containing start and end.
  3727. */
  3728. TimeAxis.prototype.setRange = function (range) {
  3729. if (!(range instanceof Range) && (!range || !range.start || !range.end)) {
  3730. throw new TypeError('Range must be an instance of Range, ' +
  3731. 'or an object containing start and end.');
  3732. }
  3733. this.range = range;
  3734. };
  3735. /**
  3736. * Convert a position on screen (pixels) to a datetime
  3737. * @param {int} x Position on the screen in pixels
  3738. * @return {Date} time The datetime the corresponds with given position x
  3739. */
  3740. TimeAxis.prototype.toTime = function(x) {
  3741. var conversion = this.conversion;
  3742. return new Date(x / conversion.factor + conversion.offset);
  3743. };
  3744. /**
  3745. * Convert a datetime (Date object) into a position on the screen
  3746. * @param {Date} time A date
  3747. * @return {int} x The position on the screen in pixels which corresponds
  3748. * with the given date.
  3749. * @private
  3750. */
  3751. TimeAxis.prototype.toScreen = function(time) {
  3752. var conversion = this.conversion;
  3753. return (time.valueOf() - conversion.offset) * conversion.factor;
  3754. };
  3755. /**
  3756. * Repaint the component
  3757. * @return {Boolean} changed
  3758. */
  3759. TimeAxis.prototype.repaint = function () {
  3760. var changed = 0,
  3761. update = util.updateProperty,
  3762. asSize = util.option.asSize,
  3763. options = this.options,
  3764. orientation = this.getOption('orientation'),
  3765. props = this.props,
  3766. step = this.step;
  3767. var frame = this.frame;
  3768. if (!frame) {
  3769. frame = document.createElement('div');
  3770. this.frame = frame;
  3771. changed += 1;
  3772. }
  3773. frame.className = 'axis ' + orientation;
  3774. // TODO: custom className?
  3775. if (!frame.parentNode) {
  3776. if (!this.parent) {
  3777. throw new Error('Cannot repaint time axis: no parent attached');
  3778. }
  3779. var parentContainer = this.parent.getContainer();
  3780. if (!parentContainer) {
  3781. throw new Error('Cannot repaint time axis: parent has no container element');
  3782. }
  3783. parentContainer.appendChild(frame);
  3784. changed += 1;
  3785. }
  3786. var parent = frame.parentNode;
  3787. if (parent) {
  3788. var beforeChild = frame.nextSibling;
  3789. parent.removeChild(frame); // take frame offline while updating (is almost twice as fast)
  3790. var defaultTop = (orientation == 'bottom' && this.props.parentHeight && this.height) ?
  3791. (this.props.parentHeight - this.height) + 'px' :
  3792. '0px';
  3793. changed += update(frame.style, 'top', asSize(options.top, defaultTop));
  3794. changed += update(frame.style, 'left', asSize(options.left, '0px'));
  3795. changed += update(frame.style, 'width', asSize(options.width, '100%'));
  3796. changed += update(frame.style, 'height', asSize(options.height, this.height + 'px'));
  3797. // get characters width and height
  3798. this._repaintMeasureChars();
  3799. if (this.step) {
  3800. this._repaintStart();
  3801. step.first();
  3802. var xFirstMajorLabel = undefined;
  3803. var max = 0;
  3804. while (step.hasNext() && max < 1000) {
  3805. max++;
  3806. var cur = step.getCurrent(),
  3807. x = this.toScreen(cur),
  3808. isMajor = step.isMajor();
  3809. // TODO: lines must have a width, such that we can create css backgrounds
  3810. if (this.getOption('showMinorLabels')) {
  3811. this._repaintMinorText(x, step.getLabelMinor());
  3812. }
  3813. if (isMajor && this.getOption('showMajorLabels')) {
  3814. if (x > 0) {
  3815. if (xFirstMajorLabel == undefined) {
  3816. xFirstMajorLabel = x;
  3817. }
  3818. this._repaintMajorText(x, step.getLabelMajor());
  3819. }
  3820. this._repaintMajorLine(x);
  3821. }
  3822. else {
  3823. this._repaintMinorLine(x);
  3824. }
  3825. step.next();
  3826. }
  3827. // create a major label on the left when needed
  3828. if (this.getOption('showMajorLabels')) {
  3829. var leftTime = this.toTime(0),
  3830. leftText = step.getLabelMajor(leftTime),
  3831. widthText = leftText.length * (props.majorCharWidth || 10) + 10; // upper bound estimation
  3832. if (xFirstMajorLabel == undefined || widthText < xFirstMajorLabel) {
  3833. this._repaintMajorText(0, leftText);
  3834. }
  3835. }
  3836. this._repaintEnd();
  3837. }
  3838. this._repaintLine();
  3839. // put frame online again
  3840. if (beforeChild) {
  3841. parent.insertBefore(frame, beforeChild);
  3842. }
  3843. else {
  3844. parent.appendChild(frame)
  3845. }
  3846. }
  3847. return (changed > 0);
  3848. };
  3849. /**
  3850. * Start a repaint. Move all DOM elements to a redundant list, where they
  3851. * can be picked for re-use, or can be cleaned up in the end
  3852. * @private
  3853. */
  3854. TimeAxis.prototype._repaintStart = function () {
  3855. var dom = this.dom,
  3856. redundant = dom.redundant;
  3857. redundant.majorLines = dom.majorLines;
  3858. redundant.majorTexts = dom.majorTexts;
  3859. redundant.minorLines = dom.minorLines;
  3860. redundant.minorTexts = dom.minorTexts;
  3861. dom.majorLines = [];
  3862. dom.majorTexts = [];
  3863. dom.minorLines = [];
  3864. dom.minorTexts = [];
  3865. };
  3866. /**
  3867. * End a repaint. Cleanup leftover DOM elements in the redundant list
  3868. * @private
  3869. */
  3870. TimeAxis.prototype._repaintEnd = function () {
  3871. util.forEach(this.dom.redundant, function (arr) {
  3872. while (arr.length) {
  3873. var elem = arr.pop();
  3874. if (elem && elem.parentNode) {
  3875. elem.parentNode.removeChild(elem);
  3876. }
  3877. }
  3878. });
  3879. };
  3880. /**
  3881. * Create a minor label for the axis at position x
  3882. * @param {Number} x
  3883. * @param {String} text
  3884. * @private
  3885. */
  3886. TimeAxis.prototype._repaintMinorText = function (x, text) {
  3887. // reuse redundant label
  3888. var label = this.dom.redundant.minorTexts.shift();
  3889. if (!label) {
  3890. // create new label
  3891. var content = document.createTextNode('');
  3892. label = document.createElement('div');
  3893. label.appendChild(content);
  3894. label.className = 'text minor';
  3895. this.frame.appendChild(label);
  3896. }
  3897. this.dom.minorTexts.push(label);
  3898. label.childNodes[0].nodeValue = text;
  3899. label.style.left = x + 'px';
  3900. label.style.top = this.props.minorLabelTop + 'px';
  3901. //label.title = title; // TODO: this is a heavy operation
  3902. };
  3903. /**
  3904. * Create a Major label for the axis at position x
  3905. * @param {Number} x
  3906. * @param {String} text
  3907. * @private
  3908. */
  3909. TimeAxis.prototype._repaintMajorText = function (x, text) {
  3910. // reuse redundant label
  3911. var label = this.dom.redundant.majorTexts.shift();
  3912. if (!label) {
  3913. // create label
  3914. var content = document.createTextNode(text);
  3915. label = document.createElement('div');
  3916. label.className = 'text major';
  3917. label.appendChild(content);
  3918. this.frame.appendChild(label);
  3919. }
  3920. this.dom.majorTexts.push(label);
  3921. label.childNodes[0].nodeValue = text;
  3922. label.style.top = this.props.majorLabelTop + 'px';
  3923. label.style.left = x + 'px';
  3924. //label.title = title; // TODO: this is a heavy operation
  3925. };
  3926. /**
  3927. * Create a minor line for the axis at position x
  3928. * @param {Number} x
  3929. * @private
  3930. */
  3931. TimeAxis.prototype._repaintMinorLine = function (x) {
  3932. // reuse redundant line
  3933. var line = this.dom.redundant.minorLines.shift();
  3934. if (!line) {
  3935. // create vertical line
  3936. line = document.createElement('div');
  3937. line.className = 'grid vertical minor';
  3938. this.frame.appendChild(line);
  3939. }
  3940. this.dom.minorLines.push(line);
  3941. var props = this.props;
  3942. line.style.top = props.minorLineTop + 'px';
  3943. line.style.height = props.minorLineHeight + 'px';
  3944. line.style.left = (x - props.minorLineWidth / 2) + 'px';
  3945. };
  3946. /**
  3947. * Create a Major line for the axis at position x
  3948. * @param {Number} x
  3949. * @private
  3950. */
  3951. TimeAxis.prototype._repaintMajorLine = function (x) {
  3952. // reuse redundant line
  3953. var line = this.dom.redundant.majorLines.shift();
  3954. if (!line) {
  3955. // create vertical line
  3956. line = document.createElement('DIV');
  3957. line.className = 'grid vertical major';
  3958. this.frame.appendChild(line);
  3959. }
  3960. this.dom.majorLines.push(line);
  3961. var props = this.props;
  3962. line.style.top = props.majorLineTop + 'px';
  3963. line.style.left = (x - props.majorLineWidth / 2) + 'px';
  3964. line.style.height = props.majorLineHeight + 'px';
  3965. };
  3966. /**
  3967. * Repaint the horizontal line for the axis
  3968. * @private
  3969. */
  3970. TimeAxis.prototype._repaintLine = function() {
  3971. var line = this.dom.line,
  3972. frame = this.frame,
  3973. options = this.options;
  3974. // line before all axis elements
  3975. if (this.getOption('showMinorLabels') || this.getOption('showMajorLabels')) {
  3976. if (line) {
  3977. // put this line at the end of all childs
  3978. frame.removeChild(line);
  3979. frame.appendChild(line);
  3980. }
  3981. else {
  3982. // create the axis line
  3983. line = document.createElement('div');
  3984. line.className = 'grid horizontal major';
  3985. frame.appendChild(line);
  3986. this.dom.line = line;
  3987. }
  3988. line.style.top = this.props.lineTop + 'px';
  3989. }
  3990. else {
  3991. if (line && axis.parentElement) {
  3992. frame.removeChild(axis.line);
  3993. delete this.dom.line;
  3994. }
  3995. }
  3996. };
  3997. /**
  3998. * Create characters used to determine the size of text on the axis
  3999. * @private
  4000. */
  4001. TimeAxis.prototype._repaintMeasureChars = function () {
  4002. // calculate the width and height of a single character
  4003. // this is used to calculate the step size, and also the positioning of the
  4004. // axis
  4005. var dom = this.dom,
  4006. text;
  4007. if (!dom.measureCharMinor) {
  4008. text = document.createTextNode('0');
  4009. var measureCharMinor = document.createElement('DIV');
  4010. measureCharMinor.className = 'text minor measure';
  4011. measureCharMinor.appendChild(text);
  4012. this.frame.appendChild(measureCharMinor);
  4013. dom.measureCharMinor = measureCharMinor;
  4014. }
  4015. if (!dom.measureCharMajor) {
  4016. text = document.createTextNode('0');
  4017. var measureCharMajor = document.createElement('DIV');
  4018. measureCharMajor.className = 'text major measure';
  4019. measureCharMajor.appendChild(text);
  4020. this.frame.appendChild(measureCharMajor);
  4021. dom.measureCharMajor = measureCharMajor;
  4022. }
  4023. };
  4024. /**
  4025. * Reflow the component
  4026. * @return {Boolean} resized
  4027. */
  4028. TimeAxis.prototype.reflow = function () {
  4029. var changed = 0,
  4030. update = util.updateProperty,
  4031. frame = this.frame,
  4032. range = this.range;
  4033. if (!range) {
  4034. throw new Error('Cannot repaint time axis: no range configured');
  4035. }
  4036. if (frame) {
  4037. changed += update(this, 'top', frame.offsetTop);
  4038. changed += update(this, 'left', frame.offsetLeft);
  4039. // calculate size of a character
  4040. var props = this.props,
  4041. showMinorLabels = this.getOption('showMinorLabels'),
  4042. showMajorLabels = this.getOption('showMajorLabels'),
  4043. measureCharMinor = this.dom.measureCharMinor,
  4044. measureCharMajor = this.dom.measureCharMajor;
  4045. if (measureCharMinor) {
  4046. props.minorCharHeight = measureCharMinor.clientHeight;
  4047. props.minorCharWidth = measureCharMinor.clientWidth;
  4048. }
  4049. if (measureCharMajor) {
  4050. props.majorCharHeight = measureCharMajor.clientHeight;
  4051. props.majorCharWidth = measureCharMajor.clientWidth;
  4052. }
  4053. var parentHeight = frame.parentNode ? frame.parentNode.offsetHeight : 0;
  4054. if (parentHeight != props.parentHeight) {
  4055. props.parentHeight = parentHeight;
  4056. changed += 1;
  4057. }
  4058. switch (this.getOption('orientation')) {
  4059. case 'bottom':
  4060. props.minorLabelHeight = showMinorLabels ? props.minorCharHeight : 0;
  4061. props.majorLabelHeight = showMajorLabels ? props.majorCharHeight : 0;
  4062. props.minorLabelTop = 0;
  4063. props.majorLabelTop = props.minorLabelTop + props.minorLabelHeight;
  4064. props.minorLineTop = -this.top;
  4065. props.minorLineHeight = Math.max(this.top + props.majorLabelHeight, 0);
  4066. props.minorLineWidth = 1; // TODO: really calculate width
  4067. props.majorLineTop = -this.top;
  4068. props.majorLineHeight = Math.max(this.top + props.minorLabelHeight + props.majorLabelHeight, 0);
  4069. props.majorLineWidth = 1; // TODO: really calculate width
  4070. props.lineTop = 0;
  4071. break;
  4072. case 'top':
  4073. props.minorLabelHeight = showMinorLabels ? props.minorCharHeight : 0;
  4074. props.majorLabelHeight = showMajorLabels ? props.majorCharHeight : 0;
  4075. props.majorLabelTop = 0;
  4076. props.minorLabelTop = props.majorLabelTop + props.majorLabelHeight;
  4077. props.minorLineTop = props.minorLabelTop;
  4078. props.minorLineHeight = Math.max(parentHeight - props.majorLabelHeight - this.top);
  4079. props.minorLineWidth = 1; // TODO: really calculate width
  4080. props.majorLineTop = 0;
  4081. props.majorLineHeight = Math.max(parentHeight - this.top);
  4082. props.majorLineWidth = 1; // TODO: really calculate width
  4083. props.lineTop = props.majorLabelHeight + props.minorLabelHeight;
  4084. break;
  4085. default:
  4086. throw new Error('Unkown orientation "' + this.getOption('orientation') + '"');
  4087. }
  4088. var height = props.minorLabelHeight + props.majorLabelHeight;
  4089. changed += update(this, 'width', frame.offsetWidth);
  4090. changed += update(this, 'height', height);
  4091. // calculate range and step
  4092. this._updateConversion();
  4093. var start = util.cast(range.start, 'Date'),
  4094. end = util.cast(range.end, 'Date'),
  4095. minimumStep = this.toTime((props.minorCharWidth || 10) * 5) - this.toTime(0);
  4096. this.step = new TimeStep(start, end, minimumStep);
  4097. changed += update(props.range, 'start', start.valueOf());
  4098. changed += update(props.range, 'end', end.valueOf());
  4099. changed += update(props.range, 'minimumStep', minimumStep.valueOf());
  4100. }
  4101. return (changed > 0);
  4102. };
  4103. /**
  4104. * Calculate the factor and offset to convert a position on screen to the
  4105. * corresponding date and vice versa.
  4106. * After the method _updateConversion is executed once, the methods toTime
  4107. * and toScreen can be used.
  4108. * @private
  4109. */
  4110. TimeAxis.prototype._updateConversion = function() {
  4111. var range = this.range;
  4112. if (!range) {
  4113. throw new Error('No range configured');
  4114. }
  4115. if (range.conversion) {
  4116. this.conversion = range.conversion(this.width);
  4117. }
  4118. else {
  4119. this.conversion = Range.conversion(range.start, range.end, this.width);
  4120. }
  4121. };
  4122. /**
  4123. * An ItemSet holds a set of items and ranges which can be displayed in a
  4124. * range. The width is determined by the parent of the ItemSet, and the height
  4125. * is determined by the size of the items.
  4126. * @param {Component} parent
  4127. * @param {Component[]} [depends] Components on which this components depends
  4128. * (except for the parent)
  4129. * @param {Object} [options] See ItemSet.setOptions for the available
  4130. * options.
  4131. * @constructor ItemSet
  4132. * @extends Panel
  4133. */
  4134. // TODO: improve performance by replacing all Array.forEach with a for loop
  4135. function ItemSet(parent, depends, options) {
  4136. this.id = util.randomUUID();
  4137. this.parent = parent;
  4138. this.depends = depends;
  4139. // one options object is shared by this itemset and all its items
  4140. this.options = options || {};
  4141. this.defaultOptions = {
  4142. style: 'box',
  4143. align: 'center',
  4144. orientation: 'bottom',
  4145. margin: {
  4146. axis: 20,
  4147. item: 10
  4148. },
  4149. padding: 5
  4150. };
  4151. this.dom = {};
  4152. var me = this;
  4153. this.itemsData = null; // DataSet
  4154. this.range = null; // Range or Object {start: number, end: number}
  4155. this.listeners = {
  4156. 'add': function (event, params, senderId) {
  4157. if (senderId != me.id) {
  4158. me._onAdd(params.items);
  4159. }
  4160. },
  4161. 'update': function (event, params, senderId) {
  4162. if (senderId != me.id) {
  4163. me._onUpdate(params.items);
  4164. }
  4165. },
  4166. 'remove': function (event, params, senderId) {
  4167. if (senderId != me.id) {
  4168. me._onRemove(params.items);
  4169. }
  4170. }
  4171. };
  4172. this.items = {}; // object with an Item for every data item
  4173. this.queue = {}; // queue with id/actions: 'add', 'update', 'delete'
  4174. this.stack = new Stack(this, Object.create(this.options));
  4175. this.conversion = null;
  4176. // TODO: ItemSet should also attach event listeners for rangechange and rangechanged, like timeaxis
  4177. }
  4178. ItemSet.prototype = new Panel();
  4179. // available item types will be registered here
  4180. ItemSet.types = {
  4181. box: ItemBox,
  4182. range: ItemRange,
  4183. point: ItemPoint
  4184. };
  4185. /**
  4186. * Set options for the ItemSet. Existing options will be extended/overwritten.
  4187. * @param {Object} [options] The following options are available:
  4188. * {String | function} [className]
  4189. * class name for the itemset
  4190. * {String} [style]
  4191. * Default style for the items. Choose from 'box'
  4192. * (default), 'point', or 'range'. The default
  4193. * Style can be overwritten by individual items.
  4194. * {String} align
  4195. * Alignment for the items, only applicable for
  4196. * ItemBox. Choose 'center' (default), 'left', or
  4197. * 'right'.
  4198. * {String} orientation
  4199. * Orientation of the item set. Choose 'top' or
  4200. * 'bottom' (default).
  4201. * {Number} margin.axis
  4202. * Margin between the axis and the items in pixels.
  4203. * Default is 20.
  4204. * {Number} margin.item
  4205. * Margin between items in pixels. Default is 10.
  4206. * {Number} padding
  4207. * Padding of the contents of an item in pixels.
  4208. * Must correspond with the items css. Default is 5.
  4209. */
  4210. ItemSet.prototype.setOptions = Component.prototype.setOptions;
  4211. /**
  4212. * Set range (start and end).
  4213. * @param {Range | Object} range A Range or an object containing start and end.
  4214. */
  4215. ItemSet.prototype.setRange = function setRange(range) {
  4216. if (!(range instanceof Range) && (!range || !range.start || !range.end)) {
  4217. throw new TypeError('Range must be an instance of Range, ' +
  4218. 'or an object containing start and end.');
  4219. }
  4220. this.range = range;
  4221. };
  4222. /**
  4223. * Repaint the component
  4224. * @return {Boolean} changed
  4225. */
  4226. ItemSet.prototype.repaint = function repaint() {
  4227. var changed = 0,
  4228. update = util.updateProperty,
  4229. asSize = util.option.asSize,
  4230. options = this.options,
  4231. orientation = this.getOption('orientation'),
  4232. defaultOptions = this.defaultOptions,
  4233. frame = this.frame;
  4234. if (!frame) {
  4235. frame = document.createElement('div');
  4236. frame.className = 'itemset';
  4237. var className = options.className;
  4238. if (className) {
  4239. util.addClassName(frame, util.option.asString(className));
  4240. }
  4241. // create background panel
  4242. var background = document.createElement('div');
  4243. background.className = 'background';
  4244. frame.appendChild(background);
  4245. this.dom.background = background;
  4246. // create foreground panel
  4247. var foreground = document.createElement('div');
  4248. foreground.className = 'foreground';
  4249. frame.appendChild(foreground);
  4250. this.dom.foreground = foreground;
  4251. // create axis panel
  4252. var axis = document.createElement('div');
  4253. axis.className = 'itemset-axis';
  4254. //frame.appendChild(axis);
  4255. this.dom.axis = axis;
  4256. this.frame = frame;
  4257. changed += 1;
  4258. }
  4259. if (!this.parent) {
  4260. throw new Error('Cannot repaint itemset: no parent attached');
  4261. }
  4262. var parentContainer = this.parent.getContainer();
  4263. if (!parentContainer) {
  4264. throw new Error('Cannot repaint itemset: parent has no container element');
  4265. }
  4266. if (!frame.parentNode) {
  4267. parentContainer.appendChild(frame);
  4268. changed += 1;
  4269. }
  4270. if (!this.dom.axis.parentNode) {
  4271. parentContainer.appendChild(this.dom.axis);
  4272. changed += 1;
  4273. }
  4274. // reposition frame
  4275. changed += update(frame.style, 'left', asSize(options.left, '0px'));
  4276. changed += update(frame.style, 'top', asSize(options.top, '0px'));
  4277. changed += update(frame.style, 'width', asSize(options.width, '100%'));
  4278. changed += update(frame.style, 'height', asSize(options.height, this.height + 'px'));
  4279. // reposition axis
  4280. changed += update(this.dom.axis.style, 'left', asSize(options.left, '0px'));
  4281. changed += update(this.dom.axis.style, 'width', asSize(options.width, '100%'));
  4282. if (orientation == 'bottom') {
  4283. changed += update(this.dom.axis.style, 'top', (this.height + this.top) + 'px');
  4284. }
  4285. else { // orientation == 'top'
  4286. changed += update(this.dom.axis.style, 'top', this.top + 'px');
  4287. }
  4288. this._updateConversion();
  4289. var me = this,
  4290. queue = this.queue,
  4291. itemsData = this.itemsData,
  4292. items = this.items,
  4293. dataOptions = {
  4294. fields: [(itemsData && itemsData.fieldId || 'id'), 'start', 'end', 'content', 'type']
  4295. };
  4296. // TODO: copy options from the itemset itself?
  4297. // show/hide added/changed/removed items
  4298. Object.keys(queue).forEach(function (id) {
  4299. //var entry = queue[id];
  4300. var action = queue[id];
  4301. var item = items[id];
  4302. //var item = entry.item;
  4303. //noinspection FallthroughInSwitchStatementJS
  4304. switch (action) {
  4305. case 'add':
  4306. case 'update':
  4307. var itemData = itemsData && itemsData.get(id, dataOptions);
  4308. if (itemData) {
  4309. var type = itemData.type ||
  4310. (itemData.start && itemData.end && 'range') ||
  4311. 'box';
  4312. var constructor = ItemSet.types[type];
  4313. // TODO: how to handle items with invalid data? hide them and give a warning? or throw an error?
  4314. if (item) {
  4315. // update item
  4316. if (!constructor || !(item instanceof constructor)) {
  4317. // item type has changed, hide and delete the item
  4318. changed += item.hide();
  4319. item = null;
  4320. }
  4321. else {
  4322. item.data = itemData; // TODO: create a method item.setData ?
  4323. changed++;
  4324. }
  4325. }
  4326. if (!item) {
  4327. // create item
  4328. if (constructor) {
  4329. item = new constructor(me, itemData, options, defaultOptions);
  4330. changed++;
  4331. }
  4332. else {
  4333. throw new TypeError('Unknown item type "' + type + '"');
  4334. }
  4335. }
  4336. // force a repaint (not only a reposition)
  4337. item.repaint();
  4338. items[id] = item;
  4339. }
  4340. // update queue
  4341. delete queue[id];
  4342. break;
  4343. case 'remove':
  4344. if (item) {
  4345. // remove DOM of the item
  4346. changed += item.hide();
  4347. }
  4348. // update lists
  4349. delete items[id];
  4350. delete queue[id];
  4351. break;
  4352. default:
  4353. console.log('Error: unknown action "' + action + '"');
  4354. }
  4355. });
  4356. // reposition all items. Show items only when in the visible area
  4357. util.forEach(this.items, function (item) {
  4358. if (item.visible) {
  4359. changed += item.show();
  4360. item.reposition();
  4361. }
  4362. else {
  4363. changed += item.hide();
  4364. }
  4365. });
  4366. return (changed > 0);
  4367. };
  4368. /**
  4369. * Get the foreground container element
  4370. * @return {HTMLElement} foreground
  4371. */
  4372. ItemSet.prototype.getForeground = function getForeground() {
  4373. return this.dom.foreground;
  4374. };
  4375. /**
  4376. * Get the background container element
  4377. * @return {HTMLElement} background
  4378. */
  4379. ItemSet.prototype.getBackground = function getBackground() {
  4380. return this.dom.background;
  4381. };
  4382. /**
  4383. * Get the axis container element
  4384. * @return {HTMLElement} axis
  4385. */
  4386. ItemSet.prototype.getAxis = function getAxis() {
  4387. return this.dom.axis;
  4388. };
  4389. /**
  4390. * Reflow the component
  4391. * @return {Boolean} resized
  4392. */
  4393. ItemSet.prototype.reflow = function reflow () {
  4394. var changed = 0,
  4395. options = this.options,
  4396. marginAxis = options.margin && options.margin.axis || this.defaultOptions.margin.axis,
  4397. marginItem = options.margin && options.margin.item || this.defaultOptions.margin.item,
  4398. update = util.updateProperty,
  4399. asNumber = util.option.asNumber,
  4400. asSize = util.option.asSize,
  4401. frame = this.frame;
  4402. if (frame) {
  4403. this._updateConversion();
  4404. util.forEach(this.items, function (item) {
  4405. changed += item.reflow();
  4406. });
  4407. // TODO: stack.update should be triggered via an event, in stack itself
  4408. // TODO: only update the stack when there are changed items
  4409. this.stack.update();
  4410. var maxHeight = asNumber(options.maxHeight);
  4411. var fixedHeight = (asSize(options.height) != null);
  4412. var height;
  4413. if (fixedHeight) {
  4414. height = frame.offsetHeight;
  4415. }
  4416. else {
  4417. // height is not specified, determine the height from the height and positioned items
  4418. var visibleItems = this.stack.ordered; // TODO: not so nice way to get the filtered items
  4419. if (visibleItems.length) {
  4420. var min = visibleItems[0].top;
  4421. var max = visibleItems[0].top + visibleItems[0].height;
  4422. util.forEach(visibleItems, function (item) {
  4423. min = Math.min(min, item.top);
  4424. max = Math.max(max, (item.top + item.height));
  4425. });
  4426. height = (max - min) + marginAxis + marginItem;
  4427. }
  4428. else {
  4429. height = marginAxis + marginItem;
  4430. }
  4431. }
  4432. if (maxHeight != null) {
  4433. height = Math.min(height, maxHeight);
  4434. }
  4435. changed += update(this, 'height', height);
  4436. // calculate height from items
  4437. changed += update(this, 'top', frame.offsetTop);
  4438. changed += update(this, 'left', frame.offsetLeft);
  4439. changed += update(this, 'width', frame.offsetWidth);
  4440. }
  4441. else {
  4442. changed += 1;
  4443. }
  4444. return (changed > 0);
  4445. };
  4446. /**
  4447. * Hide this component from the DOM
  4448. * @return {Boolean} changed
  4449. */
  4450. ItemSet.prototype.hide = function hide() {
  4451. var changed = false;
  4452. // remove the DOM
  4453. if (this.frame && this.frame.parentNode) {
  4454. this.frame.parentNode.removeChild(this.frame);
  4455. changed = true;
  4456. }
  4457. if (this.dom.axis && this.dom.axis.parentNode) {
  4458. this.dom.axis.parentNode.removeChild(this.dom.axis);
  4459. changed = true;
  4460. }
  4461. return changed;
  4462. };
  4463. /**
  4464. * Set items
  4465. * @param {vis.DataSet | null} items
  4466. */
  4467. ItemSet.prototype.setItems = function setItems(items) {
  4468. var me = this,
  4469. ids;
  4470. // unsubscribe from current dataset
  4471. var current = this.itemsData;
  4472. if (current) {
  4473. util.forEach(this.listeners, function (callback, event) {
  4474. current.unsubscribe(event, callback);
  4475. });
  4476. // remove all drawn items
  4477. ids = current.getIds();
  4478. this._onRemove(ids);
  4479. }
  4480. // replace the dataset
  4481. if (!items) {
  4482. this.itemsData = null;
  4483. }
  4484. else if (items instanceof DataSet || items instanceof DataView) {
  4485. this.itemsData = items;
  4486. }
  4487. else {
  4488. throw new TypeError('Data must be an instance of DataSet');
  4489. }
  4490. if (this.itemsData) {
  4491. // subscribe to new dataset
  4492. var id = this.id;
  4493. util.forEach(this.listeners, function (callback, event) {
  4494. me.itemsData.subscribe(event, callback, id);
  4495. });
  4496. // draw all new items
  4497. ids = this.itemsData.getIds();
  4498. this._onAdd(ids);
  4499. }
  4500. };
  4501. /**
  4502. * Get the current items items
  4503. * @returns {vis.DataSet | null}
  4504. */
  4505. ItemSet.prototype.getItems = function getItems() {
  4506. return this.itemsData;
  4507. };
  4508. /**
  4509. * Handle updated items
  4510. * @param {Number[]} ids
  4511. * @private
  4512. */
  4513. ItemSet.prototype._onUpdate = function _onUpdate(ids) {
  4514. this._toQueue('update', ids);
  4515. };
  4516. /**
  4517. * Handle changed items
  4518. * @param {Number[]} ids
  4519. * @private
  4520. */
  4521. ItemSet.prototype._onAdd = function _onAdd(ids) {
  4522. this._toQueue('add', ids);
  4523. };
  4524. /**
  4525. * Handle removed items
  4526. * @param {Number[]} ids
  4527. * @private
  4528. */
  4529. ItemSet.prototype._onRemove = function _onRemove(ids) {
  4530. this._toQueue('remove', ids);
  4531. };
  4532. /**
  4533. * Put items in the queue to be added/updated/remove
  4534. * @param {String} action can be 'add', 'update', 'remove'
  4535. * @param {Number[]} ids
  4536. */
  4537. ItemSet.prototype._toQueue = function _toQueue(action, ids) {
  4538. var queue = this.queue;
  4539. ids.forEach(function (id) {
  4540. queue[id] = action;
  4541. });
  4542. if (this.controller) {
  4543. //this.requestReflow();
  4544. this.requestRepaint();
  4545. }
  4546. };
  4547. /**
  4548. * Calculate the factor and offset to convert a position on screen to the
  4549. * corresponding date and vice versa.
  4550. * After the method _updateConversion is executed once, the methods toTime
  4551. * and toScreen can be used.
  4552. * @private
  4553. */
  4554. ItemSet.prototype._updateConversion = function _updateConversion() {
  4555. var range = this.range;
  4556. if (!range) {
  4557. throw new Error('No range configured');
  4558. }
  4559. if (range.conversion) {
  4560. this.conversion = range.conversion(this.width);
  4561. }
  4562. else {
  4563. this.conversion = Range.conversion(range.start, range.end, this.width);
  4564. }
  4565. };
  4566. /**
  4567. * Convert a position on screen (pixels) to a datetime
  4568. * Before this method can be used, the method _updateConversion must be
  4569. * executed once.
  4570. * @param {int} x Position on the screen in pixels
  4571. * @return {Date} time The datetime the corresponds with given position x
  4572. */
  4573. ItemSet.prototype.toTime = function toTime(x) {
  4574. var conversion = this.conversion;
  4575. return new Date(x / conversion.factor + conversion.offset);
  4576. };
  4577. /**
  4578. * Convert a datetime (Date object) into a position on the screen
  4579. * Before this method can be used, the method _updateConversion must be
  4580. * executed once.
  4581. * @param {Date} time A date
  4582. * @return {int} x The position on the screen in pixels which corresponds
  4583. * with the given date.
  4584. */
  4585. ItemSet.prototype.toScreen = function toScreen(time) {
  4586. var conversion = this.conversion;
  4587. return (time.valueOf() - conversion.offset) * conversion.factor;
  4588. };
  4589. /**
  4590. * @constructor Item
  4591. * @param {ItemSet} parent
  4592. * @param {Object} data Object containing (optional) parameters type,
  4593. * start, end, content, group, className.
  4594. * @param {Object} [options] Options to set initial property values
  4595. * @param {Object} [defaultOptions] default options
  4596. * // TODO: describe available options
  4597. */
  4598. function Item (parent, data, options, defaultOptions) {
  4599. this.parent = parent;
  4600. this.data = data;
  4601. this.dom = null;
  4602. this.options = options || {};
  4603. this.defaultOptions = defaultOptions || {};
  4604. this.selected = false;
  4605. this.visible = false;
  4606. this.top = 0;
  4607. this.left = 0;
  4608. this.width = 0;
  4609. this.height = 0;
  4610. }
  4611. /**
  4612. * Select current item
  4613. */
  4614. Item.prototype.select = function select() {
  4615. this.selected = true;
  4616. };
  4617. /**
  4618. * Unselect current item
  4619. */
  4620. Item.prototype.unselect = function unselect() {
  4621. this.selected = false;
  4622. };
  4623. /**
  4624. * Show the Item in the DOM (when not already visible)
  4625. * @return {Boolean} changed
  4626. */
  4627. Item.prototype.show = function show() {
  4628. return false;
  4629. };
  4630. /**
  4631. * Hide the Item from the DOM (when visible)
  4632. * @return {Boolean} changed
  4633. */
  4634. Item.prototype.hide = function hide() {
  4635. return false;
  4636. };
  4637. /**
  4638. * Repaint the item
  4639. * @return {Boolean} changed
  4640. */
  4641. Item.prototype.repaint = function repaint() {
  4642. // should be implemented by the item
  4643. return false;
  4644. };
  4645. /**
  4646. * Reflow the item
  4647. * @return {Boolean} resized
  4648. */
  4649. Item.prototype.reflow = function reflow() {
  4650. // should be implemented by the item
  4651. return false;
  4652. };
  4653. /**
  4654. * @constructor ItemBox
  4655. * @extends Item
  4656. * @param {ItemSet} parent
  4657. * @param {Object} data Object containing parameters start
  4658. * content, className.
  4659. * @param {Object} [options] Options to set initial property values
  4660. * @param {Object} [defaultOptions] default options
  4661. * // TODO: describe available options
  4662. */
  4663. function ItemBox (parent, data, options, defaultOptions) {
  4664. this.props = {
  4665. dot: {
  4666. left: 0,
  4667. top: 0,
  4668. width: 0,
  4669. height: 0
  4670. },
  4671. line: {
  4672. top: 0,
  4673. left: 0,
  4674. width: 0,
  4675. height: 0
  4676. }
  4677. };
  4678. Item.call(this, parent, data, options, defaultOptions);
  4679. }
  4680. ItemBox.prototype = new Item (null, null);
  4681. /**
  4682. * Select the item
  4683. * @override
  4684. */
  4685. ItemBox.prototype.select = function select() {
  4686. this.selected = true;
  4687. // TODO: select and unselect
  4688. };
  4689. /**
  4690. * Unselect the item
  4691. * @override
  4692. */
  4693. ItemBox.prototype.unselect = function unselect() {
  4694. this.selected = false;
  4695. // TODO: select and unselect
  4696. };
  4697. /**
  4698. * Repaint the item
  4699. * @return {Boolean} changed
  4700. */
  4701. ItemBox.prototype.repaint = function repaint() {
  4702. // TODO: make an efficient repaint
  4703. var changed = false;
  4704. var dom = this.dom;
  4705. if (!dom) {
  4706. this._create();
  4707. dom = this.dom;
  4708. changed = true;
  4709. }
  4710. if (dom) {
  4711. if (!this.parent) {
  4712. throw new Error('Cannot repaint item: no parent attached');
  4713. }
  4714. var foreground = this.parent.getForeground();
  4715. if (!foreground) {
  4716. throw new Error('Cannot repaint time axis: ' +
  4717. 'parent has no foreground container element');
  4718. }
  4719. var background = this.parent.getBackground();
  4720. if (!background) {
  4721. throw new Error('Cannot repaint time axis: ' +
  4722. 'parent has no background container element');
  4723. }
  4724. var axis = this.parent.getAxis();
  4725. if (!background) {
  4726. throw new Error('Cannot repaint time axis: ' +
  4727. 'parent has no axis container element');
  4728. }
  4729. if (!dom.box.parentNode) {
  4730. foreground.appendChild(dom.box);
  4731. changed = true;
  4732. }
  4733. if (!dom.line.parentNode) {
  4734. background.appendChild(dom.line);
  4735. changed = true;
  4736. }
  4737. if (!dom.dot.parentNode) {
  4738. axis.appendChild(dom.dot);
  4739. changed = true;
  4740. }
  4741. // update contents
  4742. if (this.data.content != this.content) {
  4743. this.content = this.data.content;
  4744. if (this.content instanceof Element) {
  4745. dom.content.innerHTML = '';
  4746. dom.content.appendChild(this.content);
  4747. }
  4748. else if (this.data.content != undefined) {
  4749. dom.content.innerHTML = this.content;
  4750. }
  4751. else {
  4752. throw new Error('Property "content" missing in item ' + this.data.id);
  4753. }
  4754. changed = true;
  4755. }
  4756. // update class
  4757. var className = (this.data.className? ' ' + this.data.className : '') +
  4758. (this.selected ? ' selected' : '');
  4759. if (this.className != className) {
  4760. this.className = className;
  4761. dom.box.className = 'item box' + className;
  4762. dom.line.className = 'item line' + className;
  4763. dom.dot.className = 'item dot' + className;
  4764. changed = true;
  4765. }
  4766. }
  4767. return changed;
  4768. };
  4769. /**
  4770. * Show the item in the DOM (when not already visible). The items DOM will
  4771. * be created when needed.
  4772. * @return {Boolean} changed
  4773. */
  4774. ItemBox.prototype.show = function show() {
  4775. if (!this.dom || !this.dom.box.parentNode) {
  4776. return this.repaint();
  4777. }
  4778. else {
  4779. return false;
  4780. }
  4781. };
  4782. /**
  4783. * Hide the item from the DOM (when visible)
  4784. * @return {Boolean} changed
  4785. */
  4786. ItemBox.prototype.hide = function hide() {
  4787. var changed = false,
  4788. dom = this.dom;
  4789. if (dom) {
  4790. if (dom.box.parentNode) {
  4791. dom.box.parentNode.removeChild(dom.box);
  4792. changed = true;
  4793. }
  4794. if (dom.line.parentNode) {
  4795. dom.line.parentNode.removeChild(dom.line);
  4796. }
  4797. if (dom.dot.parentNode) {
  4798. dom.dot.parentNode.removeChild(dom.dot);
  4799. }
  4800. }
  4801. return changed;
  4802. };
  4803. /**
  4804. * Reflow the item: calculate its actual size and position from the DOM
  4805. * @return {boolean} resized returns true if the axis is resized
  4806. * @override
  4807. */
  4808. ItemBox.prototype.reflow = function reflow() {
  4809. var changed = 0,
  4810. update,
  4811. dom,
  4812. props,
  4813. options,
  4814. margin,
  4815. start,
  4816. align,
  4817. orientation,
  4818. top,
  4819. left,
  4820. data,
  4821. range;
  4822. if (this.data.start == undefined) {
  4823. throw new Error('Property "start" missing in item ' + this.data.id);
  4824. }
  4825. data = this.data;
  4826. range = this.parent && this.parent.range;
  4827. if (data && range) {
  4828. // TODO: account for the width of the item. Take some margin
  4829. this.visible = (data.start > range.start) && (data.start < range.end);
  4830. }
  4831. else {
  4832. this.visible = false;
  4833. }
  4834. if (this.visible) {
  4835. dom = this.dom;
  4836. if (dom) {
  4837. update = util.updateProperty;
  4838. props = this.props;
  4839. options = this.options;
  4840. start = this.parent.toScreen(this.data.start);
  4841. align = options.align || this.defaultOptions.align;
  4842. margin = options.margin && options.margin.axis || this.defaultOptions.margin.axis;
  4843. orientation = options.orientation || this.defaultOptions.orientation;
  4844. changed += update(props.dot, 'height', dom.dot.offsetHeight);
  4845. changed += update(props.dot, 'width', dom.dot.offsetWidth);
  4846. changed += update(props.line, 'width', dom.line.offsetWidth);
  4847. changed += update(props.line, 'height', dom.line.offsetHeight);
  4848. changed += update(props.line, 'top', dom.line.offsetTop);
  4849. changed += update(this, 'width', dom.box.offsetWidth);
  4850. changed += update(this, 'height', dom.box.offsetHeight);
  4851. if (align == 'right') {
  4852. left = start - this.width;
  4853. }
  4854. else if (align == 'left') {
  4855. left = start;
  4856. }
  4857. else {
  4858. // default or 'center'
  4859. left = start - this.width / 2;
  4860. }
  4861. changed += update(this, 'left', left);
  4862. changed += update(props.line, 'left', start - props.line.width / 2);
  4863. changed += update(props.dot, 'left', start - props.dot.width / 2);
  4864. changed += update(props.dot, 'top', -props.dot.height / 2);
  4865. if (orientation == 'top') {
  4866. top = margin;
  4867. changed += update(this, 'top', top);
  4868. }
  4869. else {
  4870. // default or 'bottom'
  4871. var parentHeight = this.parent.height;
  4872. top = parentHeight - this.height - margin;
  4873. changed += update(this, 'top', top);
  4874. }
  4875. }
  4876. else {
  4877. changed += 1;
  4878. }
  4879. }
  4880. return (changed > 0);
  4881. };
  4882. /**
  4883. * Create an items DOM
  4884. * @private
  4885. */
  4886. ItemBox.prototype._create = function _create() {
  4887. var dom = this.dom;
  4888. if (!dom) {
  4889. this.dom = dom = {};
  4890. // create the box
  4891. dom.box = document.createElement('DIV');
  4892. // className is updated in repaint()
  4893. // contents box (inside the background box). used for making margins
  4894. dom.content = document.createElement('DIV');
  4895. dom.content.className = 'content';
  4896. dom.box.appendChild(dom.content);
  4897. // line to axis
  4898. dom.line = document.createElement('DIV');
  4899. dom.line.className = 'line';
  4900. // dot on axis
  4901. dom.dot = document.createElement('DIV');
  4902. dom.dot.className = 'dot';
  4903. }
  4904. };
  4905. /**
  4906. * Reposition the item, recalculate its left, top, and width, using the current
  4907. * range and size of the items itemset
  4908. * @override
  4909. */
  4910. ItemBox.prototype.reposition = function reposition() {
  4911. var dom = this.dom,
  4912. props = this.props,
  4913. orientation = this.options.orientation || this.defaultOptions.orientation;
  4914. if (dom) {
  4915. var box = dom.box,
  4916. line = dom.line,
  4917. dot = dom.dot;
  4918. box.style.left = this.left + 'px';
  4919. box.style.top = this.top + 'px';
  4920. line.style.left = props.line.left + 'px';
  4921. if (orientation == 'top') {
  4922. line.style.top = 0 + 'px';
  4923. line.style.height = this.top + 'px';
  4924. }
  4925. else {
  4926. // orientation 'bottom'
  4927. line.style.top = (this.top + this.height) + 'px';
  4928. line.style.height = Math.max(this.parent.height - this.top - this.height +
  4929. this.props.dot.height / 2, 0) + 'px';
  4930. }
  4931. dot.style.left = props.dot.left + 'px';
  4932. dot.style.top = props.dot.top + 'px';
  4933. }
  4934. };
  4935. /**
  4936. * @constructor ItemPoint
  4937. * @extends Item
  4938. * @param {ItemSet} parent
  4939. * @param {Object} data Object containing parameters start
  4940. * content, className.
  4941. * @param {Object} [options] Options to set initial property values
  4942. * @param {Object} [defaultOptions] default options
  4943. * // TODO: describe available options
  4944. */
  4945. function ItemPoint (parent, data, options, defaultOptions) {
  4946. this.props = {
  4947. dot: {
  4948. top: 0,
  4949. width: 0,
  4950. height: 0
  4951. },
  4952. content: {
  4953. height: 0,
  4954. marginLeft: 0
  4955. }
  4956. };
  4957. Item.call(this, parent, data, options, defaultOptions);
  4958. }
  4959. ItemPoint.prototype = new Item (null, null);
  4960. /**
  4961. * Select the item
  4962. * @override
  4963. */
  4964. ItemPoint.prototype.select = function select() {
  4965. this.selected = true;
  4966. // TODO: select and unselect
  4967. };
  4968. /**
  4969. * Unselect the item
  4970. * @override
  4971. */
  4972. ItemPoint.prototype.unselect = function unselect() {
  4973. this.selected = false;
  4974. // TODO: select and unselect
  4975. };
  4976. /**
  4977. * Repaint the item
  4978. * @return {Boolean} changed
  4979. */
  4980. ItemPoint.prototype.repaint = function repaint() {
  4981. // TODO: make an efficient repaint
  4982. var changed = false;
  4983. var dom = this.dom;
  4984. if (!dom) {
  4985. this._create();
  4986. dom = this.dom;
  4987. changed = true;
  4988. }
  4989. if (dom) {
  4990. if (!this.parent) {
  4991. throw new Error('Cannot repaint item: no parent attached');
  4992. }
  4993. var foreground = this.parent.getForeground();
  4994. if (!foreground) {
  4995. throw new Error('Cannot repaint time axis: ' +
  4996. 'parent has no foreground container element');
  4997. }
  4998. if (!dom.point.parentNode) {
  4999. foreground.appendChild(dom.point);
  5000. foreground.appendChild(dom.point);
  5001. changed = true;
  5002. }
  5003. // update contents
  5004. if (this.data.content != this.content) {
  5005. this.content = this.data.content;
  5006. if (this.content instanceof Element) {
  5007. dom.content.innerHTML = '';
  5008. dom.content.appendChild(this.content);
  5009. }
  5010. else if (this.data.content != undefined) {
  5011. dom.content.innerHTML = this.content;
  5012. }
  5013. else {
  5014. throw new Error('Property "content" missing in item ' + this.data.id);
  5015. }
  5016. changed = true;
  5017. }
  5018. // update class
  5019. var className = (this.data.className? ' ' + this.data.className : '') +
  5020. (this.selected ? ' selected' : '');
  5021. if (this.className != className) {
  5022. this.className = className;
  5023. dom.point.className = 'item point' + className;
  5024. changed = true;
  5025. }
  5026. }
  5027. return changed;
  5028. };
  5029. /**
  5030. * Show the item in the DOM (when not already visible). The items DOM will
  5031. * be created when needed.
  5032. * @return {Boolean} changed
  5033. */
  5034. ItemPoint.prototype.show = function show() {
  5035. if (!this.dom || !this.dom.point.parentNode) {
  5036. return this.repaint();
  5037. }
  5038. else {
  5039. return false;
  5040. }
  5041. };
  5042. /**
  5043. * Hide the item from the DOM (when visible)
  5044. * @return {Boolean} changed
  5045. */
  5046. ItemPoint.prototype.hide = function hide() {
  5047. var changed = false,
  5048. dom = this.dom;
  5049. if (dom) {
  5050. if (dom.point.parentNode) {
  5051. dom.point.parentNode.removeChild(dom.point);
  5052. changed = true;
  5053. }
  5054. }
  5055. return changed;
  5056. };
  5057. /**
  5058. * Reflow the item: calculate its actual size from the DOM
  5059. * @return {boolean} resized returns true if the axis is resized
  5060. * @override
  5061. */
  5062. ItemPoint.prototype.reflow = function reflow() {
  5063. var changed = 0,
  5064. update,
  5065. dom,
  5066. props,
  5067. options,
  5068. margin,
  5069. orientation,
  5070. start,
  5071. top,
  5072. data,
  5073. range;
  5074. if (this.data.start == undefined) {
  5075. throw new Error('Property "start" missing in item ' + this.data.id);
  5076. }
  5077. data = this.data;
  5078. range = this.parent && this.parent.range;
  5079. if (data && range) {
  5080. // TODO: account for the width of the item. Take some margin
  5081. this.visible = (data.start > range.start) && (data.start < range.end);
  5082. }
  5083. else {
  5084. this.visible = false;
  5085. }
  5086. if (this.visible) {
  5087. dom = this.dom;
  5088. if (dom) {
  5089. update = util.updateProperty;
  5090. props = this.props;
  5091. options = this.options;
  5092. orientation = options.orientation || this.defaultOptions.orientation;
  5093. margin = options.margin && options.margin.axis || this.defaultOptions.margin.axis;
  5094. start = this.parent.toScreen(this.data.start);
  5095. changed += update(this, 'width', dom.point.offsetWidth);
  5096. changed += update(this, 'height', dom.point.offsetHeight);
  5097. changed += update(props.dot, 'width', dom.dot.offsetWidth);
  5098. changed += update(props.dot, 'height', dom.dot.offsetHeight);
  5099. changed += update(props.content, 'height', dom.content.offsetHeight);
  5100. if (orientation == 'top') {
  5101. top = margin;
  5102. }
  5103. else {
  5104. // default or 'bottom'
  5105. var parentHeight = this.parent.height;
  5106. top = Math.max(parentHeight - this.height - margin, 0);
  5107. }
  5108. changed += update(this, 'top', top);
  5109. changed += update(this, 'left', start - props.dot.width / 2);
  5110. changed += update(props.content, 'marginLeft', 1.5 * props.dot.width);
  5111. //changed += update(props.content, 'marginRight', 0.5 * props.dot.width); // TODO
  5112. changed += update(props.dot, 'top', (this.height - props.dot.height) / 2);
  5113. }
  5114. else {
  5115. changed += 1;
  5116. }
  5117. }
  5118. return (changed > 0);
  5119. };
  5120. /**
  5121. * Create an items DOM
  5122. * @private
  5123. */
  5124. ItemPoint.prototype._create = function _create() {
  5125. var dom = this.dom;
  5126. if (!dom) {
  5127. this.dom = dom = {};
  5128. // background box
  5129. dom.point = document.createElement('div');
  5130. // className is updated in repaint()
  5131. // contents box, right from the dot
  5132. dom.content = document.createElement('div');
  5133. dom.content.className = 'content';
  5134. dom.point.appendChild(dom.content);
  5135. // dot at start
  5136. dom.dot = document.createElement('div');
  5137. dom.dot.className = 'dot';
  5138. dom.point.appendChild(dom.dot);
  5139. }
  5140. };
  5141. /**
  5142. * Reposition the item, recalculate its left, top, and width, using the current
  5143. * range and size of the items itemset
  5144. * @override
  5145. */
  5146. ItemPoint.prototype.reposition = function reposition() {
  5147. var dom = this.dom,
  5148. props = this.props;
  5149. if (dom) {
  5150. dom.point.style.top = this.top + 'px';
  5151. dom.point.style.left = this.left + 'px';
  5152. dom.content.style.marginLeft = props.content.marginLeft + 'px';
  5153. //dom.content.style.marginRight = props.content.marginRight + 'px'; // TODO
  5154. dom.dot.style.top = props.dot.top + 'px';
  5155. }
  5156. };
  5157. /**
  5158. * @constructor ItemRange
  5159. * @extends Item
  5160. * @param {ItemSet} parent
  5161. * @param {Object} data Object containing parameters start, end
  5162. * content, className.
  5163. * @param {Object} [options] Options to set initial property values
  5164. * @param {Object} [defaultOptions] default options
  5165. * // TODO: describe available options
  5166. */
  5167. function ItemRange (parent, data, options, defaultOptions) {
  5168. this.props = {
  5169. content: {
  5170. left: 0,
  5171. width: 0
  5172. }
  5173. };
  5174. Item.call(this, parent, data, options, defaultOptions);
  5175. }
  5176. ItemRange.prototype = new Item (null, null);
  5177. /**
  5178. * Select the item
  5179. * @override
  5180. */
  5181. ItemRange.prototype.select = function select() {
  5182. this.selected = true;
  5183. // TODO: select and unselect
  5184. };
  5185. /**
  5186. * Unselect the item
  5187. * @override
  5188. */
  5189. ItemRange.prototype.unselect = function unselect() {
  5190. this.selected = false;
  5191. // TODO: select and unselect
  5192. };
  5193. /**
  5194. * Repaint the item
  5195. * @return {Boolean} changed
  5196. */
  5197. ItemRange.prototype.repaint = function repaint() {
  5198. // TODO: make an efficient repaint
  5199. var changed = false;
  5200. var dom = this.dom;
  5201. if (!dom) {
  5202. this._create();
  5203. dom = this.dom;
  5204. changed = true;
  5205. }
  5206. if (dom) {
  5207. if (!this.parent) {
  5208. throw new Error('Cannot repaint item: no parent attached');
  5209. }
  5210. var foreground = this.parent.getForeground();
  5211. if (!foreground) {
  5212. throw new Error('Cannot repaint time axis: ' +
  5213. 'parent has no foreground container element');
  5214. }
  5215. if (!dom.box.parentNode) {
  5216. foreground.appendChild(dom.box);
  5217. changed = true;
  5218. }
  5219. // update content
  5220. if (this.data.content != this.content) {
  5221. this.content = this.data.content;
  5222. if (this.content instanceof Element) {
  5223. dom.content.innerHTML = '';
  5224. dom.content.appendChild(this.content);
  5225. }
  5226. else if (this.data.content != undefined) {
  5227. dom.content.innerHTML = this.content;
  5228. }
  5229. else {
  5230. throw new Error('Property "content" missing in item ' + this.data.id);
  5231. }
  5232. changed = true;
  5233. }
  5234. // update class
  5235. var className = this.data.className ? ('' + this.data.className) : '';
  5236. if (this.className != className) {
  5237. this.className = className;
  5238. dom.box.className = 'item range' + className;
  5239. changed = true;
  5240. }
  5241. }
  5242. return changed;
  5243. };
  5244. /**
  5245. * Show the item in the DOM (when not already visible). The items DOM will
  5246. * be created when needed.
  5247. * @return {Boolean} changed
  5248. */
  5249. ItemRange.prototype.show = function show() {
  5250. if (!this.dom || !this.dom.box.parentNode) {
  5251. return this.repaint();
  5252. }
  5253. else {
  5254. return false;
  5255. }
  5256. };
  5257. /**
  5258. * Hide the item from the DOM (when visible)
  5259. * @return {Boolean} changed
  5260. */
  5261. ItemRange.prototype.hide = function hide() {
  5262. var changed = false,
  5263. dom = this.dom;
  5264. if (dom) {
  5265. if (dom.box.parentNode) {
  5266. dom.box.parentNode.removeChild(dom.box);
  5267. changed = true;
  5268. }
  5269. }
  5270. return changed;
  5271. };
  5272. /**
  5273. * Reflow the item: calculate its actual size from the DOM
  5274. * @return {boolean} resized returns true if the axis is resized
  5275. * @override
  5276. */
  5277. ItemRange.prototype.reflow = function reflow() {
  5278. var changed = 0,
  5279. dom,
  5280. props,
  5281. options,
  5282. margin,
  5283. padding,
  5284. parent,
  5285. start,
  5286. end,
  5287. data,
  5288. range,
  5289. update,
  5290. box,
  5291. parentWidth,
  5292. contentLeft,
  5293. orientation,
  5294. top;
  5295. if (this.data.start == undefined) {
  5296. throw new Error('Property "start" missing in item ' + this.data.id);
  5297. }
  5298. if (this.data.end == undefined) {
  5299. throw new Error('Property "end" missing in item ' + this.data.id);
  5300. }
  5301. data = this.data;
  5302. range = this.parent && this.parent.range;
  5303. if (data && range) {
  5304. // TODO: account for the width of the item. Take some margin
  5305. this.visible = (data.start < range.end) && (data.end > range.start);
  5306. }
  5307. else {
  5308. this.visible = false;
  5309. }
  5310. if (this.visible) {
  5311. dom = this.dom;
  5312. if (dom) {
  5313. props = this.props;
  5314. options = this.options;
  5315. parent = this.parent;
  5316. start = parent.toScreen(this.data.start);
  5317. end = parent.toScreen(this.data.end);
  5318. update = util.updateProperty;
  5319. box = dom.box;
  5320. parentWidth = parent.width;
  5321. orientation = options.orientation || this.defaultOptions.orientation;
  5322. margin = options.margin && options.margin.axis || this.defaultOptions.margin.axis;
  5323. padding = options.padding || this.defaultOptions.padding;
  5324. changed += update(props.content, 'width', dom.content.offsetWidth);
  5325. changed += update(this, 'height', box.offsetHeight);
  5326. // limit the width of the this, as browsers cannot draw very wide divs
  5327. if (start < -parentWidth) {
  5328. start = -parentWidth;
  5329. }
  5330. if (end > 2 * parentWidth) {
  5331. end = 2 * parentWidth;
  5332. }
  5333. // when range exceeds left of the window, position the contents at the left of the visible area
  5334. if (start < 0) {
  5335. contentLeft = Math.min(-start,
  5336. (end - start - props.content.width - 2 * padding));
  5337. // TODO: remove the need for options.padding. it's terrible.
  5338. }
  5339. else {
  5340. contentLeft = 0;
  5341. }
  5342. changed += update(props.content, 'left', contentLeft);
  5343. if (orientation == 'top') {
  5344. top = margin;
  5345. changed += update(this, 'top', top);
  5346. }
  5347. else {
  5348. // default or 'bottom'
  5349. top = parent.height - this.height - margin;
  5350. changed += update(this, 'top', top);
  5351. }
  5352. changed += update(this, 'left', start);
  5353. changed += update(this, 'width', Math.max(end - start, 1)); // TODO: reckon with border width;
  5354. }
  5355. else {
  5356. changed += 1;
  5357. }
  5358. }
  5359. return (changed > 0);
  5360. };
  5361. /**
  5362. * Create an items DOM
  5363. * @private
  5364. */
  5365. ItemRange.prototype._create = function _create() {
  5366. var dom = this.dom;
  5367. if (!dom) {
  5368. this.dom = dom = {};
  5369. // background box
  5370. dom.box = document.createElement('div');
  5371. // className is updated in repaint()
  5372. // contents box
  5373. dom.content = document.createElement('div');
  5374. dom.content.className = 'content';
  5375. dom.box.appendChild(dom.content);
  5376. }
  5377. };
  5378. /**
  5379. * Reposition the item, recalculate its left, top, and width, using the current
  5380. * range and size of the items itemset
  5381. * @override
  5382. */
  5383. ItemRange.prototype.reposition = function reposition() {
  5384. var dom = this.dom,
  5385. props = this.props;
  5386. if (dom) {
  5387. dom.box.style.top = this.top + 'px';
  5388. dom.box.style.left = this.left + 'px';
  5389. dom.box.style.width = this.width + 'px';
  5390. dom.content.style.left = props.content.left + 'px';
  5391. }
  5392. };
  5393. /**
  5394. * @constructor Group
  5395. * @param {GroupSet} parent
  5396. * @param {Number | String} groupId
  5397. * @param {Object} [options] Options to set initial property values
  5398. * // TODO: describe available options
  5399. * @extends Component
  5400. */
  5401. function Group (parent, groupId, options) {
  5402. this.id = util.randomUUID();
  5403. this.parent = parent;
  5404. this.groupId = groupId;
  5405. this.itemsData = null; // DataSet
  5406. this.itemset = null; // ItemSet
  5407. this.options = options || {};
  5408. this.options.top = 0;
  5409. this.top = 0;
  5410. this.left = 0;
  5411. this.width = 0;
  5412. this.height = 0;
  5413. }
  5414. Group.prototype = new Component();
  5415. // TODO: comment
  5416. Group.prototype.setOptions = Component.prototype.setOptions;
  5417. /**
  5418. * Get the container element of the panel, which can be used by a child to
  5419. * add its own widgets.
  5420. * @returns {HTMLElement} container
  5421. */
  5422. Group.prototype.getContainer = function () {
  5423. return this.parent.getContainer();
  5424. };
  5425. /**
  5426. * Set item set for the group. The group will create a view on the itemset,
  5427. * filtered by the groups id.
  5428. * @param {DataSet | DataView} items
  5429. */
  5430. Group.prototype.setItems = function setItems(items) {
  5431. if (this.itemset) {
  5432. // remove current item set
  5433. this.itemset.hide();
  5434. this.itemset.setItems();
  5435. this.parent.controller.remove(this.itemset);
  5436. this.itemset = null;
  5437. }
  5438. if (items) {
  5439. var groupId = this.groupId;
  5440. var itemsetOptions = Object.create(this.options);
  5441. this.itemset = new ItemSet(this, null, itemsetOptions);
  5442. this.itemset.setRange(this.parent.range);
  5443. this.view = new DataView(items, {
  5444. filter: function (item) {
  5445. return item.group == groupId;
  5446. }
  5447. });
  5448. this.itemset.setItems(this.view);
  5449. this.parent.controller.add(this.itemset);
  5450. }
  5451. };
  5452. /**
  5453. * Repaint the item
  5454. * @return {Boolean} changed
  5455. */
  5456. Group.prototype.repaint = function repaint() {
  5457. return false;
  5458. };
  5459. /**
  5460. * Reflow the item
  5461. * @return {Boolean} resized
  5462. */
  5463. Group.prototype.reflow = function reflow() {
  5464. var changed = 0,
  5465. update = util.updateProperty;
  5466. changed += update(this, 'top', this.itemset ? this.itemset.top : 0);
  5467. changed += update(this, 'height', this.itemset ? this.itemset.height : 0);
  5468. return (changed > 0);
  5469. };
  5470. /**
  5471. * An GroupSet holds a set of groups
  5472. * @param {Component} parent
  5473. * @param {Component[]} [depends] Components on which this components depends
  5474. * (except for the parent)
  5475. * @param {Object} [options] See GroupSet.setOptions for the available
  5476. * options.
  5477. * @constructor GroupSet
  5478. * @extends Panel
  5479. */
  5480. function GroupSet(parent, depends, options) {
  5481. this.id = util.randomUUID();
  5482. this.parent = parent;
  5483. this.depends = depends;
  5484. this.options = options || {};
  5485. this.range = null; // Range or Object {start: number, end: number}
  5486. this.itemsData = null; // DataSet with items
  5487. this.groupsData = null; // DataSet with groups
  5488. this.groups = {}; // map with groups
  5489. // changes in groups are queued key/value map containing id/action
  5490. this.queue = {};
  5491. var me = this;
  5492. this.listeners = {
  5493. 'add': function (event, params) {
  5494. me._onAdd(params.items);
  5495. },
  5496. 'update': function (event, params) {
  5497. me._onUpdate(params.items);
  5498. },
  5499. 'remove': function (event, params) {
  5500. me._onRemove(params.items);
  5501. }
  5502. };
  5503. }
  5504. GroupSet.prototype = new Panel();
  5505. /**
  5506. * Set options for the GroupSet. Existing options will be extended/overwritten.
  5507. * @param {Object} [options] The following options are available:
  5508. * {String | function} groupsOrder
  5509. * TODO: describe options
  5510. */
  5511. GroupSet.prototype.setOptions = Component.prototype.setOptions;
  5512. GroupSet.prototype.setRange = function (range) {
  5513. // TODO: implement setRange
  5514. };
  5515. /**
  5516. * Set items
  5517. * @param {vis.DataSet | null} items
  5518. */
  5519. GroupSet.prototype.setItems = function setItems(items) {
  5520. this.itemsData = items;
  5521. for (var id in this.groups) {
  5522. if (this.groups.hasOwnProperty(id)) {
  5523. var group = this.groups[id];
  5524. group.setItems(items);
  5525. }
  5526. }
  5527. };
  5528. /**
  5529. * Get items
  5530. * @return {vis.DataSet | null} items
  5531. */
  5532. GroupSet.prototype.getItems = function getItems() {
  5533. return this.itemsData;
  5534. };
  5535. /**
  5536. * Set range (start and end).
  5537. * @param {Range | Object} range A Range or an object containing start and end.
  5538. */
  5539. GroupSet.prototype.setRange = function setRange(range) {
  5540. this.range = range;
  5541. };
  5542. /**
  5543. * Set groups
  5544. * @param {vis.DataSet} groups
  5545. */
  5546. GroupSet.prototype.setGroups = function setGroups(groups) {
  5547. var me = this,
  5548. ids;
  5549. // unsubscribe from current dataset
  5550. if (this.groupsData) {
  5551. util.forEach(this.listeners, function (callback, event) {
  5552. me.groupsData.unsubscribe(event, callback);
  5553. });
  5554. // remove all drawn groups
  5555. ids = this.groupsData.getIds();
  5556. this._onRemove(ids);
  5557. }
  5558. // replace the dataset
  5559. if (!groups) {
  5560. this.groupsData = null;
  5561. }
  5562. else if (groups instanceof DataSet) {
  5563. this.groupsData = groups;
  5564. }
  5565. else {
  5566. this.groupsData = new DataSet({
  5567. fieldTypes: {
  5568. start: 'Date',
  5569. end: 'Date'
  5570. }
  5571. });
  5572. this.groupsData.add(groups);
  5573. }
  5574. if (this.groupsData) {
  5575. // subscribe to new dataset
  5576. var id = this.id;
  5577. util.forEach(this.listeners, function (callback, event) {
  5578. me.groupsData.subscribe(event, callback, id);
  5579. });
  5580. // draw all new groups
  5581. ids = this.groupsData.getIds();
  5582. this._onAdd(ids);
  5583. }
  5584. };
  5585. /**
  5586. * Get groups
  5587. * @return {vis.DataSet | null} groups
  5588. */
  5589. GroupSet.prototype.getGroups = function getGroups() {
  5590. return this.groupsData;
  5591. };
  5592. /**
  5593. * Repaint the component
  5594. * @return {Boolean} changed
  5595. */
  5596. GroupSet.prototype.repaint = function repaint() {
  5597. var changed = 0,
  5598. update = util.updateProperty,
  5599. asSize = util.option.asSize,
  5600. options = this.options,
  5601. frame = this.frame;
  5602. if (!frame) {
  5603. frame = document.createElement('div');
  5604. frame.className = 'groupset';
  5605. var className = options.className;
  5606. if (className) {
  5607. util.addClassName(frame, util.option.asString(className));
  5608. }
  5609. this.frame = frame;
  5610. changed += 1;
  5611. }
  5612. if (!this.parent) {
  5613. throw new Error('Cannot repaint groupset: no parent attached');
  5614. }
  5615. var parentContainer = this.parent.getContainer();
  5616. if (!parentContainer) {
  5617. throw new Error('Cannot repaint groupset: parent has no container element');
  5618. }
  5619. if (!frame.parentNode) {
  5620. parentContainer.appendChild(frame);
  5621. changed += 1;
  5622. }
  5623. // reposition frame
  5624. changed += update(frame.style, 'height', asSize(options.height, this.height + 'px'));
  5625. changed += update(frame.style, 'top', asSize(options.top, '0px'));
  5626. changed += update(frame.style, 'left', asSize(options.left, '0px'));
  5627. changed += update(frame.style, 'width', asSize(options.width, '100%'));
  5628. var me = this,
  5629. queue = this.queue,
  5630. groups = this.groups,
  5631. groupsData = this.groupsData;
  5632. // show/hide added/changed/removed items
  5633. var ids = Object.keys(queue);
  5634. if (ids.length) {
  5635. ids.forEach(function (id) {
  5636. var action = queue[id];
  5637. var group = groups[id];
  5638. //noinspection FallthroughInSwitchStatementJS
  5639. switch (action) {
  5640. case 'add':
  5641. case 'update':
  5642. if (!group) {
  5643. var groupOptions = Object.create(me.options);
  5644. group = new Group(me, id, groupOptions);
  5645. group.setItems(me.itemsData); // attach items data
  5646. groups[id] = group;
  5647. me.controller.add(group);
  5648. }
  5649. // TODO: update group data
  5650. group.data = groupsData.get(id);
  5651. delete queue[id];
  5652. break;
  5653. case 'remove':
  5654. if (group) {
  5655. group.setItems(); // detach items data
  5656. delete groups[id];
  5657. me.controller.remove(group);
  5658. }
  5659. // update lists
  5660. delete queue[id];
  5661. break;
  5662. default:
  5663. console.log('Error: unknown action "' + action + '"');
  5664. }
  5665. });
  5666. // the groupset depends on each of the groups
  5667. //this.depends = this.groups; // TODO: gives a circular reference through the parent
  5668. // TODO: apply dependencies of the groupset
  5669. // update the top positions of the groups in the correct order
  5670. var orderedGroups = this.groupsData.getIds({
  5671. order: this.options.groupsOrder
  5672. });
  5673. for (var i = 0; i < orderedGroups.length; i++) {
  5674. (function (group, prevGroup) {
  5675. var top = 0;
  5676. if (prevGroup) {
  5677. top = function () {
  5678. // TODO: top must reckon with options.maxHeight
  5679. return prevGroup.top + prevGroup.height;
  5680. }
  5681. }
  5682. group.setOptions({
  5683. top: top
  5684. });
  5685. })(groups[orderedGroups[i]], groups[orderedGroups[i - 1]]);
  5686. }
  5687. changed++;
  5688. }
  5689. return (changed > 0);
  5690. };
  5691. /**
  5692. * Get container element
  5693. * @return {HTMLElement} container
  5694. */
  5695. GroupSet.prototype.getContainer = function getContainer() {
  5696. // TODO: replace later on with container element for holding itemsets
  5697. return this.frame;
  5698. };
  5699. /**
  5700. * Reflow the component
  5701. * @return {Boolean} resized
  5702. */
  5703. GroupSet.prototype.reflow = function reflow() {
  5704. var changed = 0,
  5705. options = this.options,
  5706. update = util.updateProperty,
  5707. asNumber = util.option.asNumber,
  5708. asSize = util.option.asSize,
  5709. frame = this.frame;
  5710. if (frame) {
  5711. var maxHeight = asNumber(options.maxHeight);
  5712. var fixedHeight = (asSize(options.height) != null);
  5713. var height;
  5714. if (fixedHeight) {
  5715. height = frame.offsetHeight;
  5716. }
  5717. else {
  5718. // height is not specified, calculate the sum of the height of all groups
  5719. height = 0;
  5720. for (var id in this.groups) {
  5721. if (this.groups.hasOwnProperty(id)) {
  5722. var group = this.groups[id];
  5723. height += group.height;
  5724. }
  5725. }
  5726. }
  5727. if (maxHeight != null) {
  5728. height = Math.min(height, maxHeight);
  5729. }
  5730. changed += update(this, 'height', height);
  5731. changed += update(this, 'top', frame.offsetTop);
  5732. changed += update(this, 'left', frame.offsetLeft);
  5733. changed += update(this, 'width', frame.offsetWidth);
  5734. }
  5735. return (changed > 0);
  5736. };
  5737. /**
  5738. * Hide the component from the DOM
  5739. * @return {Boolean} changed
  5740. */
  5741. GroupSet.prototype.hide = function hide() {
  5742. if (this.frame && this.frame.parentNode) {
  5743. this.frame.parentNode.removeChild(this.frame);
  5744. return true;
  5745. }
  5746. else {
  5747. return false;
  5748. }
  5749. };
  5750. /**
  5751. * Show the component in the DOM (when not already visible).
  5752. * A repaint will be executed when the component is not visible
  5753. * @return {Boolean} changed
  5754. */
  5755. GroupSet.prototype.show = function show() {
  5756. if (!this.frame || !this.frame.parentNode) {
  5757. return this.repaint();
  5758. }
  5759. else {
  5760. return false;
  5761. }
  5762. };
  5763. /**
  5764. * Handle updated groups
  5765. * @param {Number[]} ids
  5766. * @private
  5767. */
  5768. GroupSet.prototype._onUpdate = function _onUpdate(ids) {
  5769. this._toQueue(ids, 'update');
  5770. };
  5771. /**
  5772. * Handle changed groups
  5773. * @param {Number[]} ids
  5774. * @private
  5775. */
  5776. GroupSet.prototype._onAdd = function _onAdd(ids) {
  5777. this._toQueue(ids, 'add');
  5778. };
  5779. /**
  5780. * Handle removed groups
  5781. * @param {Number[]} ids
  5782. * @private
  5783. */
  5784. GroupSet.prototype._onRemove = function _onRemove(ids) {
  5785. this._toQueue(ids, 'remove');
  5786. };
  5787. /**
  5788. * Put groups in the queue to be added/updated/remove
  5789. * @param {Number[]} ids
  5790. * @param {String} action can be 'add', 'update', 'remove'
  5791. */
  5792. GroupSet.prototype._toQueue = function _toQueue(ids, action) {
  5793. var queue = this.queue;
  5794. ids.forEach(function (id) {
  5795. queue[id] = action;
  5796. });
  5797. if (this.controller) {
  5798. //this.requestReflow();
  5799. this.requestRepaint();
  5800. }
  5801. };
  5802. /**
  5803. * Create a timeline visualization
  5804. * @param {HTMLElement} container
  5805. * @param {vis.DataSet | Array | DataTable} [items]
  5806. * @param {Object} [options] See Timeline.setOptions for the available options.
  5807. * @constructor
  5808. */
  5809. function Timeline (container, items, options) {
  5810. var me = this;
  5811. this.options = util.extend({
  5812. orientation: 'bottom',
  5813. min: null,
  5814. max: null,
  5815. zoomMin: 10, // milliseconds
  5816. zoomMax: 1000 * 60 * 60 * 24 * 365 * 10000, // milliseconds
  5817. moveable: true,
  5818. zoomable: true,
  5819. showMinorLabels: true,
  5820. showMajorLabels: true,
  5821. autoResize: false
  5822. }, options);
  5823. // controller
  5824. this.controller = new Controller();
  5825. // root panel
  5826. if (!container) {
  5827. throw new Error('No container element provided');
  5828. }
  5829. var mainOptions = Object.create(this.options);
  5830. mainOptions.height = function () {
  5831. if (me.options.height) {
  5832. // fixed height
  5833. return me.options.height;
  5834. }
  5835. else {
  5836. // auto height
  5837. return me.timeaxis.height + me.content.height;
  5838. }
  5839. };
  5840. this.root = new RootPanel(container, mainOptions);
  5841. this.controller.add(this.root);
  5842. // range
  5843. var now = moment().hours(0).minutes(0).seconds(0).milliseconds(0);
  5844. this.range = new Range({
  5845. start: now.clone().add('days', -3).valueOf(),
  5846. end: now.clone().add('days', 4).valueOf()
  5847. });
  5848. // TODO: reckon with options moveable and zoomable
  5849. this.range.subscribe(this.root, 'move', 'horizontal');
  5850. this.range.subscribe(this.root, 'zoom', 'horizontal');
  5851. this.range.on('rangechange', function () {
  5852. var force = true;
  5853. me.controller.requestReflow(force);
  5854. });
  5855. this.range.on('rangechanged', function () {
  5856. var force = true;
  5857. me.controller.requestReflow(force);
  5858. });
  5859. // TODO: put the listeners in setOptions, be able to dynamically change with options moveable and zoomable
  5860. // time axis
  5861. var timeaxisOptions = Object.create(mainOptions);
  5862. timeaxisOptions.range = this.range;
  5863. this.timeaxis = new TimeAxis(this.root, [], timeaxisOptions);
  5864. this.timeaxis.setRange(this.range);
  5865. this.controller.add(this.timeaxis);
  5866. // create itemset or groupset
  5867. this.setGroups(null);
  5868. this.itemsData = null; // DataSet
  5869. this.groupsData = null; // DataSet
  5870. // set data
  5871. if (items) {
  5872. this.setItems(items);
  5873. }
  5874. }
  5875. /**
  5876. * Set options
  5877. * @param {Object} options TODO: describe the available options
  5878. */
  5879. Timeline.prototype.setOptions = function (options) {
  5880. if (options) {
  5881. util.extend(this.options, options);
  5882. }
  5883. this.controller.reflow();
  5884. this.controller.repaint();
  5885. };
  5886. /**
  5887. * Set items
  5888. * @param {vis.DataSet | Array | DataTable | null} items
  5889. */
  5890. Timeline.prototype.setItems = function(items) {
  5891. var initialLoad = (this.itemsData == null);
  5892. // convert to type DataSet when needed
  5893. var newItemSet;
  5894. if (!items) {
  5895. newItemSet = null;
  5896. }
  5897. else if (items instanceof DataSet) {
  5898. newItemSet = items;
  5899. }
  5900. if (!(items instanceof DataSet)) {
  5901. newItemSet = new DataSet({
  5902. fieldTypes: {
  5903. start: 'Date',
  5904. end: 'Date'
  5905. }
  5906. });
  5907. newItemSet.add(items);
  5908. }
  5909. // set items
  5910. this.itemsData = newItemSet;
  5911. this.content.setItems(newItemSet);
  5912. if (initialLoad && (this.options.start == undefined || this.options.end == undefined)) {
  5913. // apply the data range as range
  5914. var dataRange = this.getItemRange();
  5915. // add 5% on both sides
  5916. var min = dataRange.min;
  5917. var max = dataRange.max;
  5918. if (min != null && max != null) {
  5919. var interval = (max.valueOf() - min.valueOf());
  5920. min = new Date(min.valueOf() - interval * 0.05);
  5921. max = new Date(max.valueOf() + interval * 0.05);
  5922. }
  5923. // override specified start and/or end date
  5924. if (this.options.start != undefined) {
  5925. min = new Date(this.options.start.valueOf());
  5926. }
  5927. if (this.options.end != undefined) {
  5928. max = new Date(this.options.end.valueOf());
  5929. }
  5930. // apply range if there is a min or max available
  5931. if (min != null || max != null) {
  5932. this.range.setRange(min, max);
  5933. }
  5934. }
  5935. };
  5936. /**
  5937. * Set groups
  5938. * @param {vis.DataSet | Array | DataTable} groups
  5939. */
  5940. Timeline.prototype.setGroups = function(groups) {
  5941. var me = this;
  5942. this.groupsData = groups;
  5943. // switch content type between ItemSet or GroupSet when needed
  5944. var type = this.groupsData ? GroupSet : ItemSet;
  5945. if (!(this.content instanceof type)) {
  5946. // remove old content set
  5947. if (this.content) {
  5948. this.content.hide();
  5949. if (this.content.setItems) {
  5950. this.content.setItems(); // disconnect from items
  5951. }
  5952. if (this.content.setGroups) {
  5953. this.content.setGroups(); // disconnect from groups
  5954. }
  5955. this.controller.remove(this.content);
  5956. }
  5957. // create new content set
  5958. var options = Object.create(this.options);
  5959. util.extend(options, {
  5960. top: function () {
  5961. if (me.options.orientation == 'top') {
  5962. return me.timeaxis.height;
  5963. }
  5964. else {
  5965. return me.root.height - me.timeaxis.height - me.content.height;
  5966. }
  5967. },
  5968. height: function () {
  5969. if (me.options.height) {
  5970. return me.root.height - me.timeaxis.height;
  5971. }
  5972. else {
  5973. return null;
  5974. }
  5975. },
  5976. maxHeight: function () {
  5977. if (me.options.maxHeight) {
  5978. if (!util.isNumber(me.options.maxHeight)) {
  5979. throw new TypeError('Number expected for property maxHeight');
  5980. }
  5981. return me.options.maxHeight - me.timeaxis.height;
  5982. }
  5983. else {
  5984. return null;
  5985. }
  5986. }
  5987. });
  5988. this.content = new type(this.root, [this.timeaxis], options);
  5989. if (this.content.setRange) {
  5990. this.content.setRange(this.range);
  5991. }
  5992. if (this.content.setItems) {
  5993. this.content.setItems(this.itemsData);
  5994. }
  5995. if (this.content.setGroups) {
  5996. this.content.setGroups(this.groupsData);
  5997. }
  5998. this.controller.add(this.content);
  5999. }
  6000. };
  6001. /**
  6002. * Get the data range of the item set.
  6003. * @returns {{min: Date, max: Date}} range A range with a start and end Date.
  6004. * When no minimum is found, min==null
  6005. * When no maximum is found, max==null
  6006. */
  6007. Timeline.prototype.getItemRange = function getItemRange() {
  6008. // calculate min from start filed
  6009. var itemsData = this.itemsData,
  6010. min = null,
  6011. max = null;
  6012. if (itemsData) {
  6013. // calculate the minimum value of the field 'start'
  6014. var minItem = itemsData.min('start');
  6015. min = minItem ? minItem.start.valueOf() : null;
  6016. // calculate maximum value of fields 'start' and 'end'
  6017. var maxStartItem = itemsData.max('start');
  6018. if (maxStartItem) {
  6019. max = maxStartItem.start.valueOf();
  6020. }
  6021. var maxEndItem = itemsData.max('end');
  6022. if (maxEndItem) {
  6023. if (max == null) {
  6024. max = maxEndItem.end.valueOf();
  6025. }
  6026. else {
  6027. max = Math.max(max, maxEndItem.end.valueOf());
  6028. }
  6029. }
  6030. }
  6031. return {
  6032. min: (min != null) ? new Date(min) : null,
  6033. max: (max != null) ? new Date(max) : null
  6034. };
  6035. };
  6036. /**
  6037. * Parse a text source containing data in DOT language into a JSON object.
  6038. * The object contains two lists: one with nodes and one with edges.
  6039. * @param {String} data Text containing a graph in DOT-notation
  6040. * @return {Object} json An object containing two parameters:
  6041. * {Object[]} nodes
  6042. * {Object[]} edges
  6043. */
  6044. util.parseDOT = function (data) {
  6045. /**
  6046. * Test whether given character is a whitespace character
  6047. * @param {String} c
  6048. * @return {Boolean} isWhitespace
  6049. */
  6050. function isWhitespace(c) {
  6051. return c == ' ' || c == '\t' || c == '\n' || c == '\r';
  6052. }
  6053. /**
  6054. * Test whether given character is a delimeter
  6055. * @param {String} c
  6056. * @return {Boolean} isDelimeter
  6057. */
  6058. function isDelimeter(c) {
  6059. return '[]{}();,=->'.indexOf(c) != -1;
  6060. }
  6061. var i = -1; // current index in the data
  6062. var c = ''; // current character in the data
  6063. /**
  6064. * Read the next character from the data
  6065. */
  6066. function next() {
  6067. i++;
  6068. c = data[i];
  6069. }
  6070. /**
  6071. * Preview the next character in the data
  6072. * @returns {String} nextChar
  6073. */
  6074. function previewNext () {
  6075. return data[i + 1];
  6076. }
  6077. /**
  6078. * Preview the next character in the data
  6079. * @returns {String} nextChar
  6080. */
  6081. function previewPrevious () {
  6082. return data[i + 1];
  6083. }
  6084. /**
  6085. * Get a text description of the the current index in the data
  6086. * @return {String} desc
  6087. */
  6088. function pos() {
  6089. return '(char ' + i + ')';
  6090. }
  6091. /**
  6092. * Skip whitespace and comments
  6093. */
  6094. function parseWhitespace() {
  6095. // skip whitespace
  6096. while (c && isWhitespace(c)) {
  6097. next();
  6098. }
  6099. // test for comment
  6100. var cNext = data[i + 1];
  6101. var cPrev = data[i - 1];
  6102. var c2 = c + cNext;
  6103. if (c2 == '/*') {
  6104. // block comment. skip until the block is closed
  6105. while (c && !(c == '*' && data[i + 1] == '/')) {
  6106. next();
  6107. }
  6108. next();
  6109. next();
  6110. parseWhitespace();
  6111. }
  6112. else if (c2 == '//' || (c == '#' && cPrev == '\n')) {
  6113. // line comment. skip until the next return
  6114. while (c && c != '\n') {
  6115. next();
  6116. }
  6117. next();
  6118. parseWhitespace();
  6119. }
  6120. }
  6121. /**
  6122. * Parse a string
  6123. * The string may be enclosed by double quotes
  6124. * @return {String | undefined} value
  6125. */
  6126. function parseString() {
  6127. parseWhitespace();
  6128. var name = '';
  6129. if (c == '"') {
  6130. next();
  6131. while (c && c != '"') {
  6132. name += c;
  6133. next();
  6134. }
  6135. next(); // skip the closing quote
  6136. }
  6137. else {
  6138. while (c && !isWhitespace(c) && !isDelimeter(c)) {
  6139. name += c;
  6140. next();
  6141. }
  6142. // cast string to number or boolean
  6143. var number = Number(name);
  6144. if (!isNaN(number)) {
  6145. name = number;
  6146. }
  6147. else if (name == 'true') {
  6148. name = true;
  6149. }
  6150. else if (name == 'false') {
  6151. name = false;
  6152. }
  6153. else if (name == 'null') {
  6154. name = null;
  6155. }
  6156. }
  6157. return name;
  6158. }
  6159. /**
  6160. * Parse a value, can be a string, number, or boolean.
  6161. * The value may be enclosed by double quotes
  6162. * @return {String | Number | Boolean | undefined} value
  6163. */
  6164. function parseValue() {
  6165. parseWhitespace();
  6166. if (c == '"') {
  6167. return parseString();
  6168. }
  6169. else {
  6170. var value = parseString();
  6171. if (value != undefined) {
  6172. // cast string to number or boolean
  6173. var number = Number(value);
  6174. if (!isNaN(number)) {
  6175. value = number;
  6176. }
  6177. else if (value == 'true') {
  6178. value = true;
  6179. }
  6180. else if (value == 'false') {
  6181. value = false;
  6182. }
  6183. else if (value == 'null') {
  6184. value = null;
  6185. }
  6186. }
  6187. return value;
  6188. }
  6189. }
  6190. /**
  6191. * Parse a set with attributes,
  6192. * for example [label="1.000", style=solid]
  6193. * @return {Object | undefined} attr
  6194. */
  6195. function parseAttributes() {
  6196. parseWhitespace();
  6197. if (c == '[') {
  6198. next();
  6199. var attr = {};
  6200. while (c && c != ']') {
  6201. parseWhitespace();
  6202. var name = parseString();
  6203. if (!name) {
  6204. throw new SyntaxError('Attribute name expected ' + pos());
  6205. }
  6206. parseWhitespace();
  6207. if (c != '=') {
  6208. throw new SyntaxError('Equal sign = expected ' + pos());
  6209. }
  6210. next();
  6211. var value = parseValue();
  6212. if (!value) {
  6213. throw new SyntaxError('Attribute value expected ' + pos());
  6214. }
  6215. attr[name] = value;
  6216. parseWhitespace();
  6217. if (c ==',') {
  6218. next();
  6219. }
  6220. }
  6221. next();
  6222. return attr;
  6223. }
  6224. else {
  6225. return undefined;
  6226. }
  6227. }
  6228. /**
  6229. * Parse a directed or undirected arrow '->' or '--'
  6230. * @return {String | undefined} arrow
  6231. */
  6232. function parseArrow() {
  6233. parseWhitespace();
  6234. if (c == '-') {
  6235. next();
  6236. if (c == '>' || c == '-') {
  6237. var arrow = '-' + c;
  6238. next();
  6239. return arrow;
  6240. }
  6241. else {
  6242. throw new SyntaxError('Arrow "->" or "--" expected ' + pos());
  6243. }
  6244. }
  6245. return undefined;
  6246. }
  6247. /**
  6248. * Parse a line separator ';'
  6249. * @return {String | undefined} separator
  6250. */
  6251. function parseSeparator() {
  6252. parseWhitespace();
  6253. if (c == ';') {
  6254. next();
  6255. return ';';
  6256. }
  6257. return undefined;
  6258. }
  6259. /**
  6260. * Merge all properties of object b into object b
  6261. * @param {Object} a
  6262. * @param {Object} b
  6263. */
  6264. function merge (a, b) {
  6265. if (a && b) {
  6266. for (var name in b) {
  6267. if (b.hasOwnProperty(name)) {
  6268. a[name] = b[name];
  6269. }
  6270. }
  6271. }
  6272. }
  6273. var nodeMap = {};
  6274. var edgeList = [];
  6275. /**
  6276. * Register a node with attributes
  6277. * @param {String} id
  6278. * @param {Object} [attr]
  6279. */
  6280. function addNode(id, attr) {
  6281. var node = {
  6282. id: String(id),
  6283. attr: attr || {}
  6284. };
  6285. if (!nodeMap[id]) {
  6286. nodeMap[id] = node;
  6287. }
  6288. else {
  6289. merge(nodeMap[id].attr, node.attr);
  6290. }
  6291. }
  6292. /**
  6293. * Register an edge
  6294. * @param {String} from
  6295. * @param {String} to
  6296. * @param {String} type A string "->" or "--"
  6297. * @param {Object} [attr]
  6298. */
  6299. function addEdge(from, to, type, attr) {
  6300. edgeList.push({
  6301. from: String(from),
  6302. to: String(to),
  6303. type: type,
  6304. attr: attr || {}
  6305. });
  6306. }
  6307. // find the opening curly bracket
  6308. next();
  6309. while (c && c != '{') {
  6310. next();
  6311. }
  6312. if (c != '{') {
  6313. throw new SyntaxError('Invalid data. Curly bracket { expected ' + pos())
  6314. }
  6315. next();
  6316. // parse all data until a closing curly bracket is encountered
  6317. while (c && c != '}') {
  6318. // parse node id and optional node attributes
  6319. var id = parseString();
  6320. if (id == undefined) {
  6321. throw new SyntaxError('String with id expected ' + pos());
  6322. }
  6323. var attr = parseAttributes();
  6324. addNode(id, attr);
  6325. // TODO: parse global attributes "graph", "node", "edge"
  6326. // parse arrow
  6327. var type = parseArrow();
  6328. while (type) {
  6329. // parse node id
  6330. var prevId = id;
  6331. id = parseString();
  6332. if (id == undefined) {
  6333. throw new SyntaxError('String with id expected ' + pos());
  6334. }
  6335. addNode(id);
  6336. // parse edge attributes and register edge
  6337. attr = parseAttributes();
  6338. addEdge(prevId, id, type, attr);
  6339. // parse next arrow (optional)
  6340. type = parseArrow();
  6341. }
  6342. // parse separator (optional)
  6343. parseSeparator();
  6344. parseWhitespace();
  6345. }
  6346. if (c != '}') {
  6347. throw new SyntaxError('Invalid data. Curly bracket } expected');
  6348. }
  6349. // crop data between the curly brackets
  6350. var start = data.indexOf('{');
  6351. var end = data.indexOf('}', start);
  6352. var text = (start != -1 && end != -1) ? data.substring(start + 1, end) : undefined;
  6353. if (!text) {
  6354. throw new Error('Invalid data. no curly brackets containing data found');
  6355. }
  6356. // return the results
  6357. var nodeList = [];
  6358. for (id in nodeMap) {
  6359. if (nodeMap.hasOwnProperty(id)) {
  6360. nodeList.push(nodeMap[id]);
  6361. }
  6362. }
  6363. return {
  6364. nodes: nodeList,
  6365. edges: edgeList
  6366. }
  6367. };
  6368. /**
  6369. * Convert a string containing a graph in DOT language into a map containing
  6370. * with nodes and edges in the format of graph.
  6371. * @param {String} data Text containing a graph in DOT-notation
  6372. * @return {Object} graphData
  6373. */
  6374. util.DOTToGraph = function (data) {
  6375. // parse the DOT file
  6376. var dotData = util.parseDOT(data);
  6377. var graphData = {
  6378. nodes: [],
  6379. edges: [],
  6380. options: {
  6381. nodes: {},
  6382. edges: {}
  6383. }
  6384. };
  6385. /**
  6386. * Merge the properties of object b into object a, and adjust properties
  6387. * not supported by Graph (for example replace "shape" with "style"
  6388. * @param {Object} a
  6389. * @param {Object} b
  6390. * @param {Array} [ignore] Optional array with property names to be ignored
  6391. */
  6392. function merge (a, b, ignore) {
  6393. for (var prop in b) {
  6394. if (b.hasOwnProperty(prop) && (!ignore || ignore.indexOf(prop) == -1)) {
  6395. a[prop] = b[prop];
  6396. }
  6397. }
  6398. // Convert aliases to configuration settings supported by Graph
  6399. if (a.label) {
  6400. a.text = a.label;
  6401. delete a.label;
  6402. }
  6403. if (a.shape) {
  6404. a.style = a.shape;
  6405. delete a.shape;
  6406. }
  6407. }
  6408. dotData.nodes.forEach(function (node) {
  6409. if (node.id.toLowerCase() == 'graph') {
  6410. merge(graphData.options, node.attr);
  6411. }
  6412. else if (node.id.toLowerCase() == 'node') {
  6413. merge(graphData.options.nodes, node.attr);
  6414. }
  6415. else if (node.id.toLowerCase() == 'edge') {
  6416. merge(graphData.options.edges, node.attr);
  6417. }
  6418. else {
  6419. var graphNode = {};
  6420. graphNode.id = node.id;
  6421. graphNode.text = node.id;
  6422. merge(graphNode, node.attr);
  6423. graphData.nodes.push(graphNode);
  6424. }
  6425. });
  6426. dotData.edges.forEach(function (edge) {
  6427. var graphEdge = {};
  6428. graphEdge.from = edge.from;
  6429. graphEdge.to = edge.to;
  6430. graphEdge.text = edge.id;
  6431. graphEdge.style = (edge.type == '->') ? 'arrow-end' : 'line';
  6432. merge(graphEdge, edge.attr);
  6433. graphData.edges.push(graphEdge);
  6434. });
  6435. return graphData;
  6436. };
  6437. /**
  6438. * Canvas shapes used by the Graph
  6439. */
  6440. if (typeof CanvasRenderingContext2D !== 'undefined') {
  6441. /**
  6442. * Draw a circle shape
  6443. */
  6444. CanvasRenderingContext2D.prototype.circle = function(x, y, r) {
  6445. this.beginPath();
  6446. this.arc(x, y, r, 0, 2*Math.PI, false);
  6447. };
  6448. /**
  6449. * Draw a square shape
  6450. * @param {Number} x horizontal center
  6451. * @param {Number} y vertical center
  6452. * @param {Number} r size, width and height of the square
  6453. */
  6454. CanvasRenderingContext2D.prototype.square = function(x, y, r) {
  6455. this.beginPath();
  6456. this.rect(x - r, y - r, r * 2, r * 2);
  6457. };
  6458. /**
  6459. * Draw a triangle shape
  6460. * @param {Number} x horizontal center
  6461. * @param {Number} y vertical center
  6462. * @param {Number} r radius, half the length of the sides of the triangle
  6463. */
  6464. CanvasRenderingContext2D.prototype.triangle = function(x, y, r) {
  6465. // http://en.wikipedia.org/wiki/Equilateral_triangle
  6466. this.beginPath();
  6467. var s = r * 2;
  6468. var s2 = s / 2;
  6469. var ir = Math.sqrt(3) / 6 * s; // radius of inner circle
  6470. var h = Math.sqrt(s * s - s2 * s2); // height
  6471. this.moveTo(x, y - (h - ir));
  6472. this.lineTo(x + s2, y + ir);
  6473. this.lineTo(x - s2, y + ir);
  6474. this.lineTo(x, y - (h - ir));
  6475. this.closePath();
  6476. };
  6477. /**
  6478. * Draw a triangle shape in downward orientation
  6479. * @param {Number} x horizontal center
  6480. * @param {Number} y vertical center
  6481. * @param {Number} r radius
  6482. */
  6483. CanvasRenderingContext2D.prototype.triangleDown = function(x, y, r) {
  6484. // http://en.wikipedia.org/wiki/Equilateral_triangle
  6485. this.beginPath();
  6486. var s = r * 2;
  6487. var s2 = s / 2;
  6488. var ir = Math.sqrt(3) / 6 * s; // radius of inner circle
  6489. var h = Math.sqrt(s * s - s2 * s2); // height
  6490. this.moveTo(x, y + (h - ir));
  6491. this.lineTo(x + s2, y - ir);
  6492. this.lineTo(x - s2, y - ir);
  6493. this.lineTo(x, y + (h - ir));
  6494. this.closePath();
  6495. };
  6496. /**
  6497. * Draw a star shape, a star with 5 points
  6498. * @param {Number} x horizontal center
  6499. * @param {Number} y vertical center
  6500. * @param {Number} r radius, half the length of the sides of the triangle
  6501. */
  6502. CanvasRenderingContext2D.prototype.star = function(x, y, r) {
  6503. // http://www.html5canvastutorials.com/labs/html5-canvas-star-spinner/
  6504. this.beginPath();
  6505. for (var n = 0; n < 10; n++) {
  6506. var radius = (n % 2 === 0) ? r * 1.3 : r * 0.5;
  6507. this.lineTo(
  6508. x + radius * Math.sin(n * 2 * Math.PI / 10),
  6509. y - radius * Math.cos(n * 2 * Math.PI / 10)
  6510. );
  6511. }
  6512. this.closePath();
  6513. };
  6514. /**
  6515. * http://stackoverflow.com/questions/1255512/how-to-draw-a-rounded-rectangle-on-html-canvas
  6516. */
  6517. CanvasRenderingContext2D.prototype.roundRect = function(x, y, w, h, r) {
  6518. var r2d = Math.PI/180;
  6519. if( w - ( 2 * r ) < 0 ) { r = ( w / 2 ); } //ensure that the radius isn't too large for x
  6520. if( h - ( 2 * r ) < 0 ) { r = ( h / 2 ); } //ensure that the radius isn't too large for y
  6521. this.beginPath();
  6522. this.moveTo(x+r,y);
  6523. this.lineTo(x+w-r,y);
  6524. this.arc(x+w-r,y+r,r,r2d*270,r2d*360,false);
  6525. this.lineTo(x+w,y+h-r);
  6526. this.arc(x+w-r,y+h-r,r,0,r2d*90,false);
  6527. this.lineTo(x+r,y+h);
  6528. this.arc(x+r,y+h-r,r,r2d*90,r2d*180,false);
  6529. this.lineTo(x,y+r);
  6530. this.arc(x+r,y+r,r,r2d*180,r2d*270,false);
  6531. };
  6532. /**
  6533. * http://stackoverflow.com/questions/2172798/how-to-draw-an-oval-in-html5-canvas
  6534. */
  6535. CanvasRenderingContext2D.prototype.ellipse = function(x, y, w, h) {
  6536. var kappa = .5522848,
  6537. ox = (w / 2) * kappa, // control point offset horizontal
  6538. oy = (h / 2) * kappa, // control point offset vertical
  6539. xe = x + w, // x-end
  6540. ye = y + h, // y-end
  6541. xm = x + w / 2, // x-middle
  6542. ym = y + h / 2; // y-middle
  6543. this.beginPath();
  6544. this.moveTo(x, ym);
  6545. this.bezierCurveTo(x, ym - oy, xm - ox, y, xm, y);
  6546. this.bezierCurveTo(xm + ox, y, xe, ym - oy, xe, ym);
  6547. this.bezierCurveTo(xe, ym + oy, xm + ox, ye, xm, ye);
  6548. this.bezierCurveTo(xm - ox, ye, x, ym + oy, x, ym);
  6549. };
  6550. /**
  6551. * http://stackoverflow.com/questions/2172798/how-to-draw-an-oval-in-html5-canvas
  6552. */
  6553. CanvasRenderingContext2D.prototype.database = function(x, y, w, h) {
  6554. var f = 1/3;
  6555. var wEllipse = w;
  6556. var hEllipse = h * f;
  6557. var kappa = .5522848,
  6558. ox = (wEllipse / 2) * kappa, // control point offset horizontal
  6559. oy = (hEllipse / 2) * kappa, // control point offset vertical
  6560. xe = x + wEllipse, // x-end
  6561. ye = y + hEllipse, // y-end
  6562. xm = x + wEllipse / 2, // x-middle
  6563. ym = y + hEllipse / 2, // y-middle
  6564. ymb = y + (h - hEllipse/2), // y-midlle, bottom ellipse
  6565. yeb = y + h; // y-end, bottom ellipse
  6566. this.beginPath();
  6567. this.moveTo(xe, ym);
  6568. this.bezierCurveTo(xe, ym + oy, xm + ox, ye, xm, ye);
  6569. this.bezierCurveTo(xm - ox, ye, x, ym + oy, x, ym);
  6570. this.bezierCurveTo(x, ym - oy, xm - ox, y, xm, y);
  6571. this.bezierCurveTo(xm + ox, y, xe, ym - oy, xe, ym);
  6572. this.lineTo(xe, ymb);
  6573. this.bezierCurveTo(xe, ymb + oy, xm + ox, yeb, xm, yeb);
  6574. this.bezierCurveTo(xm - ox, yeb, x, ymb + oy, x, ymb);
  6575. this.lineTo(x, ym);
  6576. };
  6577. /**
  6578. * Draw an arrow point (no line)
  6579. */
  6580. CanvasRenderingContext2D.prototype.arrow = function(x, y, angle, length) {
  6581. // tail
  6582. var xt = x - length * Math.cos(angle);
  6583. var yt = y - length * Math.sin(angle);
  6584. // inner tail
  6585. // TODO: allow to customize different shapes
  6586. var xi = x - length * 0.9 * Math.cos(angle);
  6587. var yi = y - length * 0.9 * Math.sin(angle);
  6588. // left
  6589. var xl = xt + length / 3 * Math.cos(angle + 0.5 * Math.PI);
  6590. var yl = yt + length / 3 * Math.sin(angle + 0.5 * Math.PI);
  6591. // right
  6592. var xr = xt + length / 3 * Math.cos(angle - 0.5 * Math.PI);
  6593. var yr = yt + length / 3 * Math.sin(angle - 0.5 * Math.PI);
  6594. this.beginPath();
  6595. this.moveTo(x, y);
  6596. this.lineTo(xl, yl);
  6597. this.lineTo(xi, yi);
  6598. this.lineTo(xr, yr);
  6599. this.closePath();
  6600. };
  6601. /**
  6602. * Sets up the dashedLine functionality for drawing
  6603. * Original code came from http://stackoverflow.com/questions/4576724/dotted-stroke-in-canvas
  6604. * @author David Jordan
  6605. * @date 2012-08-08
  6606. */
  6607. CanvasRenderingContext2D.prototype.dashedLine = function(x,y,x2,y2,dashArray){
  6608. if (!dashArray) dashArray=[10,5];
  6609. if (dashLength==0) dashLength = 0.001; // Hack for Safari
  6610. var dashCount = dashArray.length;
  6611. this.moveTo(x, y);
  6612. var dx = (x2-x), dy = (y2-y);
  6613. var slope = dy/dx;
  6614. var distRemaining = Math.sqrt( dx*dx + dy*dy );
  6615. var dashIndex=0, draw=true;
  6616. while (distRemaining>=0.1){
  6617. var dashLength = dashArray[dashIndex++%dashCount];
  6618. if (dashLength > distRemaining) dashLength = distRemaining;
  6619. var xStep = Math.sqrt( dashLength*dashLength / (1 + slope*slope) );
  6620. if (dx<0) xStep = -xStep;
  6621. x += xStep;
  6622. y += slope*xStep;
  6623. this[draw ? 'lineTo' : 'moveTo'](x,y);
  6624. distRemaining -= dashLength;
  6625. draw = !draw;
  6626. }
  6627. };
  6628. // TODO: add diamond shape
  6629. }
  6630. /**
  6631. * @class Node
  6632. * A node. A node can be connected to other nodes via one or multiple edges.
  6633. * @param {object} properties An object containing properties for the node. All
  6634. * properties are optional, except for the id.
  6635. * {number} id Id of the node. Required
  6636. * {string} text Title for the node
  6637. * {number} x Horizontal position of the node
  6638. * {number} y Vertical position of the node
  6639. * {string} style Drawing style, available:
  6640. * "database", "circle", "rect",
  6641. * "image", "text", "dot", "star",
  6642. * "triangle", "triangleDown",
  6643. * "square"
  6644. * {string} image An image url
  6645. * {string} title An title text, can be HTML
  6646. * {anytype} group A group name or number
  6647. * @param {Graph.Images} imagelist A list with images. Only needed
  6648. * when the node has an image
  6649. * @param {Graph.Groups} grouplist A list with groups. Needed for
  6650. * retrieving group properties
  6651. * @param {Object} constants An object with default values for
  6652. * example for the color
  6653. */
  6654. function Node(properties, imagelist, grouplist, constants) {
  6655. this.selected = false;
  6656. this.edges = []; // all edges connected to this node
  6657. this.group = constants.nodes.group;
  6658. this.fontSize = constants.nodes.fontSize;
  6659. this.fontFace = constants.nodes.fontFace;
  6660. this.fontColor = constants.nodes.fontColor;
  6661. this.borderColor = constants.nodes.borderColor;
  6662. this.backgroundColor = constants.nodes.backgroundColor;
  6663. this.highlightColor = constants.nodes.highlightColor;
  6664. // set defaults for the properties
  6665. this.id = undefined;
  6666. this.style = constants.nodes.style;
  6667. this.image = constants.nodes.image;
  6668. this.x = 0;
  6669. this.y = 0;
  6670. this.xFixed = false;
  6671. this.yFixed = false;
  6672. this.radius = constants.nodes.radius;
  6673. this.radiusFixed = false;
  6674. this.radiusMin = constants.nodes.radiusMin;
  6675. this.radiusMax = constants.nodes.radiusMax;
  6676. this.imagelist = imagelist;
  6677. this.grouplist = grouplist;
  6678. this.setProperties(properties, constants);
  6679. // mass, force, velocity
  6680. this.mass = 50; // kg (mass is adjusted for the number of connected edges)
  6681. this.fx = 0.0; // external force x
  6682. this.fy = 0.0; // external force y
  6683. this.vx = 0.0; // velocity x
  6684. this.vy = 0.0; // velocity y
  6685. this.minForce = constants.minForce;
  6686. this.damping = 0.9; // damping factor
  6687. };
  6688. /**
  6689. * Attach a edge to the node
  6690. * @param {Edge} edge
  6691. */
  6692. Node.prototype.attachEdge = function(edge) {
  6693. this.edges.push(edge);
  6694. this._updateMass();
  6695. };
  6696. /**
  6697. * Detach a edge from the node
  6698. * @param {Edge} edge
  6699. */
  6700. Node.prototype.detachEdge = function(edge) {
  6701. var index = this.edges.indexOf(edge);
  6702. if (index != -1) {
  6703. this.edges.splice(index, 1);
  6704. }
  6705. this._updateMass();
  6706. };
  6707. /**
  6708. * Update the nodes mass, which is determined by the number of edges connecting
  6709. * to it (more edges -> heavier node).
  6710. * @private
  6711. */
  6712. Node.prototype._updateMass = function() {
  6713. this.mass = 50 + 20 * this.edges.length; // kg
  6714. };
  6715. /**
  6716. * Set or overwrite properties for the node
  6717. * @param {Object} properties an object with properties
  6718. * @param {Object} constants and object with default, global properties
  6719. */
  6720. Node.prototype.setProperties = function(properties, constants) {
  6721. if (!properties) {
  6722. return;
  6723. }
  6724. // basic properties
  6725. if (properties.id != undefined) {this.id = properties.id;}
  6726. if (properties.text != undefined) {this.text = properties.text;}
  6727. if (properties.title != undefined) {this.title = properties.title;}
  6728. if (properties.group != undefined) {this.group = properties.group;}
  6729. if (properties.x != undefined) {this.x = properties.x;}
  6730. if (properties.y != undefined) {this.y = properties.y;}
  6731. if (properties.value != undefined) {this.value = properties.value;}
  6732. if (this.id === undefined) {
  6733. throw "Node must have an id";
  6734. }
  6735. // copy group properties
  6736. if (this.group) {
  6737. var groupObj = this.grouplist.get(this.group);
  6738. for (var prop in groupObj) {
  6739. if (groupObj.hasOwnProperty(prop)) {
  6740. this[prop] = groupObj[prop];
  6741. }
  6742. }
  6743. }
  6744. // individual style properties
  6745. if (properties.style != undefined) {this.style = properties.style;}
  6746. if (properties.image != undefined) {this.image = properties.image;}
  6747. if (properties.radius != undefined) {this.radius = properties.radius;}
  6748. if (properties.borderColor != undefined) {this.borderColor = properties.borderColor;}
  6749. if (properties.backgroundColor != undefined){this.backgroundColor = properties.backgroundColor;}
  6750. if (properties.highlightColor != undefined) {this.highlightColor = properties.highlightColor;}
  6751. if (properties.fontColor != undefined) {this.fontColor = properties.fontColor;}
  6752. if (properties.fontSize != undefined) {this.fontSize = properties.fontSize;}
  6753. if (properties.fontFace != undefined) {this.fontFace = properties.fontFace;}
  6754. if (this.image != undefined) {
  6755. if (this.imagelist) {
  6756. this.imageObj = this.imagelist.load(this.image);
  6757. }
  6758. else {
  6759. throw "No imagelist provided";
  6760. }
  6761. }
  6762. this.xFixed = this.xFixed || (properties.x != undefined);
  6763. this.yFixed = this.yFixed || (properties.y != undefined);
  6764. this.radiusFixed = this.radiusFixed || (properties.radius != undefined);
  6765. if (this.style == 'image') {
  6766. this.radiusMin = constants.nodes.widthMin;
  6767. this.radiusMax = constants.nodes.widthMax;
  6768. }
  6769. // choose draw method depending on the style
  6770. var style = this.style;
  6771. switch (style) {
  6772. case 'database': this.draw = this._drawDatabase; this.resize = this._resizeDatabase; break;
  6773. case 'rect': this.draw = this._drawRect; this.resize = this._resizeRect; break;
  6774. case 'circle': this.draw = this._drawCircle; this.resize = this._resizeCircle; break;
  6775. // TODO: add ellipse shape
  6776. // TODO: add diamond shape
  6777. case 'image': this.draw = this._drawImage; this.resize = this._resizeImage; break;
  6778. case 'text': this.draw = this._drawText; this.resize = this._resizeText; break;
  6779. case 'dot': this.draw = this._drawDot; this.resize = this._resizeShape; break;
  6780. case 'square': this.draw = this._drawSquare; this.resize = this._resizeShape; break;
  6781. case 'triangle': this.draw = this._drawTriangle; this.resize = this._resizeShape; break;
  6782. case 'triangleDown': this.draw = this._drawTriangleDown; this.resize = this._resizeShape; break;
  6783. case 'star': this.draw = this._drawStar; this.resize = this._resizeShape; break;
  6784. default: this.draw = this._drawRect; this.resize = this._resizeRect; break;
  6785. }
  6786. // reset the size of the node, this can be changed
  6787. this._reset();
  6788. };
  6789. /**
  6790. * select this node
  6791. */
  6792. Node.prototype.select = function() {
  6793. this.selected = true;
  6794. this._reset();
  6795. };
  6796. /**
  6797. * unselect this node
  6798. */
  6799. Node.prototype.unselect = function() {
  6800. this.selected = false;
  6801. this._reset();
  6802. };
  6803. /**
  6804. * Reset the calculated size of the node, forces it to recalculate its size
  6805. */
  6806. Node.prototype._reset = function() {
  6807. this.width = undefined;
  6808. this.height = undefined;
  6809. };
  6810. /**
  6811. * get the title of this node.
  6812. * @return {string} title The title of the node, or undefined when no title
  6813. * has been set.
  6814. */
  6815. Node.prototype.getTitle = function() {
  6816. return this.title;
  6817. };
  6818. /**
  6819. * Calculate the distance to the border of the Node
  6820. * @param {CanvasRenderingContext2D} ctx
  6821. * @param {Number} angle Angle in radians
  6822. * @returns {number} distance Distance to the border in pixels
  6823. */
  6824. Node.prototype.distanceToBorder = function (ctx, angle) {
  6825. var borderWidth = 1;
  6826. if (!this.width) {
  6827. this.resize(ctx);
  6828. }
  6829. //noinspection FallthroughInSwitchStatementJS
  6830. switch (this.style) {
  6831. case 'circle':
  6832. case 'dot':
  6833. return this.radius + borderWidth;
  6834. // TODO: implement distanceToBorder for database
  6835. // TODO: implement distanceToBorder for triangle
  6836. // TODO: implement distanceToBorder for triangleDown
  6837. case 'rect':
  6838. case 'image':
  6839. case 'text':
  6840. default:
  6841. if (this.width) {
  6842. return Math.min(
  6843. Math.abs(this.width / 2 / Math.cos(angle)),
  6844. Math.abs(this.height / 2 / Math.sin(angle))) + borderWidth;
  6845. // TODO: reckon with border radius too in case of rect
  6846. }
  6847. else {
  6848. return 0;
  6849. }
  6850. }
  6851. // TODO: implement calculation of distance to border for all shapes
  6852. };
  6853. /**
  6854. * Set forces acting on the node
  6855. * @param {number} fx Force in horizontal direction
  6856. * @param {number} fy Force in vertical direction
  6857. */
  6858. Node.prototype._setForce = function(fx, fy) {
  6859. this.fx = fx;
  6860. this.fy = fy;
  6861. };
  6862. /**
  6863. * Add forces acting on the node
  6864. * @param {number} fx Force in horizontal direction
  6865. * @param {number} fy Force in vertical direction
  6866. */
  6867. Node.prototype._addForce = function(fx, fy) {
  6868. this.fx += fx;
  6869. this.fy += fy;
  6870. };
  6871. /**
  6872. * Perform one discrete step for the node
  6873. * @param {number} interval Time interval in seconds
  6874. */
  6875. Node.prototype.discreteStep = function(interval) {
  6876. if (!this.xFixed) {
  6877. var dx = -this.damping * this.vx; // damping force
  6878. var ax = (this.fx + dx) / this.mass; // acceleration
  6879. this.vx += ax / interval; // velocity
  6880. this.x += this.vx / interval; // position
  6881. }
  6882. if (!this.yFixed) {
  6883. var dy = -this.damping * this.vy; // damping force
  6884. var ay = (this.fy + dy) / this.mass; // acceleration
  6885. this.vy += ay / interval; // velocity
  6886. this.y += this.vy / interval; // position
  6887. }
  6888. };
  6889. /**
  6890. * Check if this node has a fixed x and y position
  6891. * @return {boolean} true if fixed, false if not
  6892. */
  6893. Node.prototype.isFixed = function() {
  6894. return (this.xFixed && this.yFixed);
  6895. };
  6896. /**
  6897. * Check if this node is moving
  6898. * @param {number} vmin the minimum velocity considered as "moving"
  6899. * @return {boolean} true if moving, false if it has no velocity
  6900. */
  6901. // TODO: replace this method with calculating the kinetic energy
  6902. Node.prototype.isMoving = function(vmin) {
  6903. return (Math.abs(this.vx) > vmin || Math.abs(this.vy) > vmin ||
  6904. (!this.xFixed && Math.abs(this.fx) > this.minForce) ||
  6905. (!this.yFixed && Math.abs(this.fy) > this.minForce));
  6906. };
  6907. /**
  6908. * check if this node is selecte
  6909. * @return {boolean} selected True if node is selected, else false
  6910. */
  6911. Node.prototype.isSelected = function() {
  6912. return this.selected;
  6913. };
  6914. /**
  6915. * Retrieve the value of the node. Can be undefined
  6916. * @return {Number} value
  6917. */
  6918. Node.prototype.getValue = function() {
  6919. return this.value;
  6920. };
  6921. /**
  6922. * Calculate the distance from the nodes location to the given location (x,y)
  6923. * @param {Number} x
  6924. * @param {Number} y
  6925. * @return {Number} value
  6926. */
  6927. Node.prototype.getDistance = function(x, y) {
  6928. var dx = this.x - x,
  6929. dy = this.y - y;
  6930. return Math.sqrt(dx * dx + dy * dy);
  6931. };
  6932. /**
  6933. * Adjust the value range of the node. The node will adjust it's radius
  6934. * based on its value.
  6935. * @param {Number} min
  6936. * @param {Number} max
  6937. */
  6938. Node.prototype.setValueRange = function(min, max) {
  6939. if (!this.radiusFixed && this.value !== undefined) {
  6940. var scale = (this.radiusMax - this.radiusMin) / (max - min);
  6941. this.radius = (this.value - min) * scale + this.radiusMin;
  6942. }
  6943. };
  6944. /**
  6945. * Draw this node in the given canvas
  6946. * The 2d context of a HTML canvas can be retrieved by canvas.getContext("2d");
  6947. * @param {CanvasRenderingContext2D} ctx
  6948. */
  6949. Node.prototype.draw = function(ctx) {
  6950. throw "Draw method not initialized for node";
  6951. };
  6952. /**
  6953. * Recalculate the size of this node in the given canvas
  6954. * The 2d context of a HTML canvas can be retrieved by canvas.getContext("2d");
  6955. * @param {CanvasRenderingContext2D} ctx
  6956. */
  6957. Node.prototype.resize = function(ctx) {
  6958. throw "Resize method not initialized for node";
  6959. };
  6960. /**
  6961. * Check if this object is overlapping with the provided object
  6962. * @param {Object} obj an object with parameters left, top, right, bottom
  6963. * @return {boolean} True if location is located on node
  6964. */
  6965. Node.prototype.isOverlappingWith = function(obj) {
  6966. return (this.left < obj.right &&
  6967. this.left + this.width > obj.left &&
  6968. this.top < obj.bottom &&
  6969. this.top + this.height > obj.top);
  6970. };
  6971. Node.prototype._resizeImage = function (ctx) {
  6972. // TODO: pre calculate the image size
  6973. if (!this.width) { // undefined or 0
  6974. var width, height;
  6975. if (this.value) {
  6976. var scale = this.imageObj.height / this.imageObj.width;
  6977. width = this.radius || this.imageObj.width;
  6978. height = this.radius * scale || this.imageObj.height;
  6979. }
  6980. else {
  6981. width = this.imageObj.width;
  6982. height = this.imageObj.height;
  6983. }
  6984. this.width = width;
  6985. this.height = height;
  6986. }
  6987. };
  6988. Node.prototype._drawImage = function (ctx) {
  6989. this._resizeImage(ctx);
  6990. this.left = this.x - this.width / 2;
  6991. this.top = this.y - this.height / 2;
  6992. var yText;
  6993. if (this.imageObj) {
  6994. ctx.drawImage(this.imageObj, this.left, this.top, this.width, this.height);
  6995. yText = this.y + this.height / 2;
  6996. }
  6997. else {
  6998. // image still loading... just draw the text for now
  6999. yText = this.y;
  7000. }
  7001. this._text(ctx, this.text, this.x, yText, undefined, "top");
  7002. };
  7003. Node.prototype._resizeRect = function (ctx) {
  7004. if (!this.width) {
  7005. var margin = 5;
  7006. var textSize = this.getTextSize(ctx);
  7007. this.width = textSize.width + 2 * margin;
  7008. this.height = textSize.height + 2 * margin;
  7009. }
  7010. };
  7011. Node.prototype._drawRect = function (ctx) {
  7012. this._resizeRect(ctx);
  7013. this.left = this.x - this.width / 2;
  7014. this.top = this.y - this.height / 2;
  7015. ctx.strokeStyle = this.borderColor;
  7016. ctx.fillStyle = this.selected ? this.highlightColor : this.backgroundColor;
  7017. ctx.lineWidth = this.selected ? 2.0 : 1.0;
  7018. ctx.roundRect(this.left, this.top, this.width, this.height, this.radius);
  7019. ctx.fill();
  7020. ctx.stroke();
  7021. this._text(ctx, this.text, this.x, this.y);
  7022. };
  7023. Node.prototype._resizeDatabase = function (ctx) {
  7024. if (!this.width) {
  7025. var margin = 5;
  7026. var textSize = this.getTextSize(ctx);
  7027. var size = textSize.width + 2 * margin;
  7028. this.width = size;
  7029. this.height = size;
  7030. }
  7031. };
  7032. Node.prototype._drawDatabase = function (ctx) {
  7033. this._resizeDatabase(ctx);
  7034. this.left = this.x - this.width / 2;
  7035. this.top = this.y - this.height / 2;
  7036. ctx.strokeStyle = this.borderColor;
  7037. ctx.fillStyle = this.selected ? this.highlightColor : this.backgroundColor;
  7038. ctx.lineWidth = this.selected ? 2.0 : 1.0;
  7039. ctx.database(this.x - this.width/2, this.y - this.height*0.5, this.width, this.height);
  7040. ctx.fill();
  7041. ctx.stroke();
  7042. this._text(ctx, this.text, this.x, this.y);
  7043. };
  7044. Node.prototype._resizeCircle = function (ctx) {
  7045. if (!this.width) {
  7046. var margin = 5;
  7047. var textSize = this.getTextSize(ctx);
  7048. var diameter = Math.max(textSize.width, textSize.height) + 2 * margin;
  7049. this.radius = diameter / 2;
  7050. this.width = diameter;
  7051. this.height = diameter;
  7052. }
  7053. };
  7054. Node.prototype._drawCircle = function (ctx) {
  7055. this._resizeCircle(ctx);
  7056. this.left = this.x - this.width / 2;
  7057. this.top = this.y - this.height / 2;
  7058. ctx.strokeStyle = this.borderColor;
  7059. ctx.fillStyle = this.selected ? this.highlightColor : this.backgroundColor;
  7060. ctx.lineWidth = this.selected ? 2.0 : 1.0;
  7061. ctx.circle(this.x, this.y, this.radius);
  7062. ctx.fill();
  7063. ctx.stroke();
  7064. this._text(ctx, this.text, this.x, this.y);
  7065. };
  7066. Node.prototype._drawDot = function (ctx) {
  7067. this._drawShape(ctx, 'circle');
  7068. };
  7069. Node.prototype._drawTriangle = function (ctx) {
  7070. this._drawShape(ctx, 'triangle');
  7071. };
  7072. Node.prototype._drawTriangleDown = function (ctx) {
  7073. this._drawShape(ctx, 'triangleDown');
  7074. };
  7075. Node.prototype._drawSquare = function (ctx) {
  7076. this._drawShape(ctx, 'square');
  7077. };
  7078. Node.prototype._drawStar = function (ctx) {
  7079. this._drawShape(ctx, 'star');
  7080. };
  7081. Node.prototype._resizeShape = function (ctx) {
  7082. if (!this.width) {
  7083. var size = 2 * this.radius;
  7084. this.width = size;
  7085. this.height = size;
  7086. }
  7087. };
  7088. Node.prototype._drawShape = function (ctx, shape) {
  7089. this._resizeShape(ctx);
  7090. this.left = this.x - this.width / 2;
  7091. this.top = this.y - this.height / 2;
  7092. ctx.strokeStyle = this.borderColor;
  7093. ctx.fillStyle = this.selected ? this.highlightColor : this.backgroundColor;
  7094. ctx.lineWidth = this.selected ? 2.0 : 1.0;
  7095. ctx[shape](this.x, this.y, this.radius);
  7096. ctx.fill();
  7097. ctx.stroke();
  7098. if (this.text) {
  7099. this._text(ctx, this.text, this.x, this.y + this.height / 2, undefined, 'top');
  7100. }
  7101. };
  7102. Node.prototype._resizeText = function (ctx) {
  7103. if (!this.width) {
  7104. var margin = 5;
  7105. var textSize = this.getTextSize(ctx);
  7106. this.width = textSize.width + 2 * margin;
  7107. this.height = textSize.height + 2 * margin;
  7108. }
  7109. };
  7110. Node.prototype._drawText = function (ctx) {
  7111. this._resizeText(ctx);
  7112. this.left = this.x - this.width / 2;
  7113. this.top = this.y - this.height / 2;
  7114. this._text(ctx, this.text, this.x, this.y);
  7115. };
  7116. Node.prototype._text = function (ctx, text, x, y, align, baseline) {
  7117. if (text) {
  7118. ctx.font = (this.selected ? "bold " : "") + this.fontSize + "px " + this.fontFace;
  7119. ctx.fillStyle = this.fontColor || "black";
  7120. ctx.textAlign = align || "center";
  7121. ctx.textBaseline = baseline || "middle";
  7122. var lines = text.split('\n'),
  7123. lineCount = lines.length,
  7124. fontSize = (this.fontSize + 4),
  7125. yLine = y + (1 - lineCount) / 2 * fontSize;
  7126. for (var i = 0; i < lineCount; i++) {
  7127. ctx.fillText(lines[i], x, yLine);
  7128. yLine += fontSize;
  7129. }
  7130. }
  7131. };
  7132. Node.prototype.getTextSize = function(ctx) {
  7133. if (this.text != undefined) {
  7134. ctx.font = (this.selected ? "bold " : "") + this.fontSize + "px " + this.fontFace;
  7135. var lines = this.text.split('\n'),
  7136. height = (this.fontSize + 4) * lines.length,
  7137. width = 0;
  7138. for (var i = 0, iMax = lines.length; i < iMax; i++) {
  7139. width = Math.max(width, ctx.measureText(lines[i]).width);
  7140. }
  7141. return {"width": width, "height": height};
  7142. }
  7143. else {
  7144. return {"width": 0, "height": 0};
  7145. }
  7146. };
  7147. /**
  7148. * @class Edge
  7149. *
  7150. * A edge connects two nodes
  7151. * @param {Object} properties Object with properties. Must contain
  7152. * At least properties from and to.
  7153. * Available properties: from (number),
  7154. * to (number), color (string),
  7155. * width (number), style (string),
  7156. * length (number), title (string)
  7157. * @param {Graph} graph A graph object, used to find and edge to
  7158. * nodes.
  7159. * @param {Object} constants An object with default values for
  7160. * example for the color
  7161. */
  7162. function Edge (properties, graph, constants) {
  7163. if (!graph) {
  7164. throw "No graph provided";
  7165. }
  7166. this.graph = graph;
  7167. // initialize constants
  7168. this.widthMin = constants.edges.widthMin;
  7169. this.widthMax = constants.edges.widthMax;
  7170. // initialize variables
  7171. this.id = undefined;
  7172. this.style = constants.edges.style;
  7173. this.title = undefined;
  7174. this.width = constants.edges.width;
  7175. this.value = undefined;
  7176. this.length = constants.edges.length;
  7177. // Added to support dashed lines
  7178. // David Jordan
  7179. // 2012-08-08
  7180. this.dashlength = constants.edges.dashlength;
  7181. this.dashgap = constants.edges.dashgap;
  7182. this.altdashlength = constants.edges.altdashlength;
  7183. this.stiffness = undefined; // depends on the length of the edge
  7184. this.color = constants.edges.color;
  7185. this.widthFixed = false;
  7186. this.lengthFixed = false;
  7187. this.setProperties(properties, constants);
  7188. };
  7189. /**
  7190. * Set or overwrite properties for the edge
  7191. * @param {Object} properties an object with properties
  7192. * @param {Object} constants and object with default, global properties
  7193. */
  7194. Edge.prototype.setProperties = function(properties, constants) {
  7195. if (!properties) {
  7196. return;
  7197. }
  7198. if (properties.from != undefined) {this.from = this.graph._getNode(properties.from);}
  7199. if (properties.to != undefined) {this.to = this.graph._getNode(properties.to);}
  7200. if (properties.id != undefined) {this.id = properties.id;}
  7201. if (properties.style != undefined) {this.style = properties.style;}
  7202. if (properties.text != undefined) {this.text = properties.text;}
  7203. if (this.text) {
  7204. this.fontSize = constants.edges.fontSize;
  7205. this.fontFace = constants.edges.fontFace;
  7206. this.fontColor = constants.edges.fontColor;
  7207. if (properties.fontColor != undefined) {this.fontColor = properties.fontColor;}
  7208. if (properties.fontSize != undefined) {this.fontSize = properties.fontSize;}
  7209. if (properties.fontFace != undefined) {this.fontFace = properties.fontFace;}
  7210. }
  7211. if (properties.title != undefined) {this.title = properties.title;}
  7212. if (properties.width != undefined) {this.width = properties.width;}
  7213. if (properties.value != undefined) {this.value = properties.value;}
  7214. if (properties.length != undefined) {this.length = properties.length;}
  7215. // Added to support dashed lines
  7216. // David Jordan
  7217. // 2012-08-08
  7218. if (properties.dashlength != undefined) {this.dashlength = properties.dashlength;}
  7219. if (properties.dashgap != undefined) {this.dashgap = properties.dashgap;}
  7220. if (properties.altdashlength != undefined) {this.altdashlength = properties.altdashlength;}
  7221. if (properties.color != undefined) {this.color = properties.color;}
  7222. if (!this.from) {
  7223. throw "Node with id " + properties.from + " not found";
  7224. }
  7225. if (!this.to) {
  7226. throw "Node with id " + properties.to + " not found";
  7227. }
  7228. this.widthFixed = this.widthFixed || (properties.width != undefined);
  7229. this.lengthFixed = this.lengthFixed || (properties.length != undefined);
  7230. this.stiffness = 1 / this.length;
  7231. // initialize animation
  7232. if (this.style === 'arrow') {
  7233. this.arrows = [0.5];
  7234. }
  7235. // set draw method based on style
  7236. switch (this.style) {
  7237. case 'line': this.draw = this._drawLine; break;
  7238. case 'arrow': this.draw = this._drawArrow; break;
  7239. case 'arrow-end': this.draw = this._drawArrowEnd; break;
  7240. case 'dash-line': this.draw = this._drawDashLine; break;
  7241. default: this.draw = this._drawLine; break;
  7242. }
  7243. };
  7244. /**
  7245. * get the title of this edge.
  7246. * @return {string} title The title of the edge, or undefined when no title
  7247. * has been set.
  7248. */
  7249. Edge.prototype.getTitle = function() {
  7250. return this.title;
  7251. };
  7252. /**
  7253. * Retrieve the value of the edge. Can be undefined
  7254. * @return {Number} value
  7255. */
  7256. Edge.prototype.getValue = function() {
  7257. return this.value;
  7258. };
  7259. /**
  7260. * Adjust the value range of the edge. The edge will adjust it's width
  7261. * based on its value.
  7262. * @param {Number} min
  7263. * @param {Number} max
  7264. */
  7265. Edge.prototype.setValueRange = function(min, max) {
  7266. if (!this.widthFixed && this.value !== undefined) {
  7267. var factor = (this.widthMax - this.widthMin) / (max - min);
  7268. this.width = (this.value - min) * factor + this.widthMin;
  7269. }
  7270. };
  7271. /**
  7272. * Redraw a edge
  7273. * Draw this edge in the given canvas
  7274. * The 2d context of a HTML canvas can be retrieved by canvas.getContext("2d");
  7275. * @param {CanvasRenderingContext2D} ctx
  7276. */
  7277. Edge.prototype.draw = function(ctx) {
  7278. throw "Method draw not initialized in edge";
  7279. };
  7280. /**
  7281. * Check if this object is overlapping with the provided object
  7282. * @param {Object} obj an object with parameters left, top
  7283. * @return {boolean} True if location is located on the edge
  7284. */
  7285. Edge.prototype.isOverlappingWith = function(obj) {
  7286. var distMax = 10;
  7287. var xFrom = this.from.x;
  7288. var yFrom = this.from.y;
  7289. var xTo = this.to.x;
  7290. var yTo = this.to.y;
  7291. var xObj = obj.left;
  7292. var yObj = obj.top;
  7293. var dist = Edge._dist(xFrom, yFrom, xTo, yTo, xObj, yObj);
  7294. return (dist < distMax);
  7295. };
  7296. /**
  7297. * Redraw a edge as a line
  7298. * Draw this edge in the given canvas
  7299. * The 2d context of a HTML canvas can be retrieved by canvas.getContext("2d");
  7300. * @param {CanvasRenderingContext2D} ctx
  7301. */
  7302. Edge.prototype._drawLine = function(ctx) {
  7303. // set style
  7304. ctx.strokeStyle = this.color;
  7305. ctx.lineWidth = this._getLineWidth();
  7306. var point;
  7307. if (this.from != this.to) {
  7308. // draw line
  7309. this._line(ctx);
  7310. // draw text
  7311. if (this.text) {
  7312. point = this._pointOnLine(0.5);
  7313. this._text(ctx, this.text, point.x, point.y);
  7314. }
  7315. }
  7316. else {
  7317. var radius = this.length / 2 / Math.PI;
  7318. var x, y;
  7319. var node = this.from;
  7320. if (!node.width) {
  7321. node.resize(ctx);
  7322. }
  7323. if (node.width > node.height) {
  7324. x = node.x + node.width / 2;
  7325. y = node.y - radius;
  7326. }
  7327. else {
  7328. x = node.x + radius;
  7329. y = node.y - node.height / 2;
  7330. }
  7331. this._circle(ctx, x, y, radius);
  7332. point = this._pointOnCircle(x, y, radius, 0.5);
  7333. this._text(ctx, this.text, point.x, point.y);
  7334. }
  7335. };
  7336. /**
  7337. * Get the line width of the edge. Depends on width and whether one of the
  7338. * connected nodes is selected.
  7339. * @return {Number} width
  7340. * @private
  7341. */
  7342. Edge.prototype._getLineWidth = function() {
  7343. if (this.from.selected || this.to.selected) {
  7344. return Math.min(this.width * 2, this.widthMax);
  7345. }
  7346. else {
  7347. return this.width;
  7348. }
  7349. };
  7350. /**
  7351. * Draw a line between two nodes
  7352. * @param {CanvasRenderingContext2D} ctx
  7353. * @private
  7354. */
  7355. Edge.prototype._line = function (ctx) {
  7356. // draw a straight line
  7357. ctx.beginPath();
  7358. ctx.moveTo(this.from.x, this.from.y);
  7359. ctx.lineTo(this.to.x, this.to.y);
  7360. ctx.stroke();
  7361. };
  7362. /**
  7363. * Draw a line from a node to itself, a circle
  7364. * @param {CanvasRenderingContext2D} ctx
  7365. * @param {Number} x
  7366. * @param {Number} y
  7367. * @param {Number} radius
  7368. * @private
  7369. */
  7370. Edge.prototype._circle = function (ctx, x, y, radius) {
  7371. // draw a circle
  7372. ctx.beginPath();
  7373. ctx.arc(x, y, radius, 0, 2 * Math.PI, false);
  7374. ctx.stroke();
  7375. };
  7376. /**
  7377. * Draw text with white background and with the middle at (x, y)
  7378. * @param {CanvasRenderingContext2D} ctx
  7379. * @param {String} text
  7380. * @param {Number} x
  7381. * @param {Number} y
  7382. */
  7383. Edge.prototype._text = function (ctx, text, x, y) {
  7384. if (text) {
  7385. // TODO: cache the calculated size
  7386. ctx.font = ((this.from.selected || this.to.selected) ? "bold " : "") +
  7387. this.fontSize + "px " + this.fontFace;
  7388. ctx.fillStyle = 'white';
  7389. var width = ctx.measureText(this.text).width;
  7390. var height = this.fontSize;
  7391. var left = x - width / 2;
  7392. var top = y - height / 2;
  7393. ctx.fillRect(left, top, width, height);
  7394. // draw text
  7395. ctx.fillStyle = this.fontColor || "black";
  7396. ctx.textAlign = "left";
  7397. ctx.textBaseline = "top";
  7398. ctx.fillText(this.text, left, top);
  7399. }
  7400. };
  7401. /**
  7402. * Redraw a edge as a dashed line
  7403. * Draw this edge in the given canvas
  7404. * @author David Jordan
  7405. * @date 2012-08-08
  7406. * The 2d context of a HTML canvas can be retrieved by canvas.getContext("2d");
  7407. * @param {CanvasRenderingContext2D} ctx
  7408. */
  7409. Edge.prototype._drawDashLine = function(ctx) {
  7410. // set style
  7411. ctx.strokeStyle = this.color;
  7412. ctx.lineWidth = this._getLineWidth();
  7413. // draw dashed line
  7414. ctx.beginPath();
  7415. ctx.lineCap = 'round';
  7416. if (this.altdashlength != undefined) //If an alt dash value has been set add to the array this value
  7417. {
  7418. ctx.dashedLine(this.from.x,this.from.y,this.to.x,this.to.y,[this.dashlength,this.dashgap,this.altdashlength,this.dashgap]);
  7419. }
  7420. else if (this.dashlength != undefined && this.dashgap != undefined) //If a dash and gap value has been set add to the array this value
  7421. {
  7422. ctx.dashedLine(this.from.x,this.from.y,this.to.x,this.to.y,[this.dashlength,this.dashgap]);
  7423. }
  7424. else //If all else fails draw a line
  7425. {
  7426. ctx.moveTo(this.from.x, this.from.y);
  7427. ctx.lineTo(this.to.x, this.to.y);
  7428. }
  7429. ctx.stroke();
  7430. // draw text
  7431. if (this.text) {
  7432. var point = this._pointOnLine(0.5);
  7433. this._text(ctx, this.text, point.x, point.y);
  7434. }
  7435. };
  7436. /**
  7437. * Get a point on a line
  7438. * @param {Number} percentage. Value between 0 (line start) and 1 (line end)
  7439. * @return {Object} point
  7440. * @private
  7441. */
  7442. Edge.prototype._pointOnLine = function (percentage) {
  7443. return {
  7444. x: (1 - percentage) * this.from.x + percentage * this.to.x,
  7445. y: (1 - percentage) * this.from.y + percentage * this.to.y
  7446. }
  7447. };
  7448. /**
  7449. * Get a point on a circle
  7450. * @param {Number} x
  7451. * @param {Number} y
  7452. * @param {Number} radius
  7453. * @param {Number} percentage. Value between 0 (line start) and 1 (line end)
  7454. * @return {Object} point
  7455. * @private
  7456. */
  7457. Edge.prototype._pointOnCircle = function (x, y, radius, percentage) {
  7458. var angle = (percentage - 3/8) * 2 * Math.PI;
  7459. return {
  7460. x: x + radius * Math.cos(angle),
  7461. y: y - radius * Math.sin(angle)
  7462. }
  7463. };
  7464. /**
  7465. * Redraw a edge as a line with an arrow
  7466. * Draw this edge in the given canvas
  7467. * The 2d context of a HTML canvas can be retrieved by canvas.getContext("2d");
  7468. * @param {CanvasRenderingContext2D} ctx
  7469. */
  7470. Edge.prototype._drawArrow = function(ctx) {
  7471. var point;
  7472. // set style
  7473. ctx.strokeStyle = this.color;
  7474. ctx.fillStyle = this.color;
  7475. ctx.lineWidth = this._getLineWidth();
  7476. if (this.from != this.to) {
  7477. // draw line
  7478. this._line(ctx);
  7479. // draw all arrows
  7480. var angle = Math.atan2((this.to.y - this.from.y), (this.to.x - this.from.x));
  7481. var length = 10 + 5 * this.width; // TODO: make customizable?
  7482. for (var a in this.arrows) {
  7483. if (this.arrows.hasOwnProperty(a)) {
  7484. point = this._pointOnLine(this.arrows[a]);
  7485. ctx.arrow(point.x, point.y, angle, length);
  7486. ctx.fill();
  7487. ctx.stroke();
  7488. }
  7489. }
  7490. // draw text
  7491. if (this.text) {
  7492. point = this._pointOnLine(0.5);
  7493. this._text(ctx, this.text, point.x, point.y);
  7494. }
  7495. }
  7496. else {
  7497. // draw circle
  7498. var radius = this.length / 2 / Math.PI;
  7499. var x, y;
  7500. var node = this.from;
  7501. if (!node.width) {
  7502. node.resize(ctx);
  7503. }
  7504. if (node.width > node.height) {
  7505. x = node.x + node.width / 2;
  7506. y = node.y - radius;
  7507. }
  7508. else {
  7509. x = node.x + radius;
  7510. y = node.y - node.height / 2;
  7511. }
  7512. this._circle(ctx, x, y, radius);
  7513. // draw all arrows
  7514. var angle = 0.2 * Math.PI;
  7515. var length = 10 + 5 * this.width; // TODO: make customizable?
  7516. for (var a in this.arrows) {
  7517. if (this.arrows.hasOwnProperty(a)) {
  7518. point = this._pointOnCircle(x, y, radius, this.arrows[a]);
  7519. ctx.arrow(point.x, point.y, angle, length);
  7520. ctx.fill();
  7521. ctx.stroke();
  7522. }
  7523. }
  7524. // draw text
  7525. if (this.text) {
  7526. point = this._pointOnCircle(x, y, radius, 0.5);
  7527. this._text(ctx, this.text, point.x, point.y);
  7528. }
  7529. }
  7530. };
  7531. /**
  7532. * Redraw a edge as a line with an arrow
  7533. * Draw this edge in the given canvas
  7534. * The 2d context of a HTML canvas can be retrieved by canvas.getContext("2d");
  7535. * @param {CanvasRenderingContext2D} ctx
  7536. */
  7537. Edge.prototype._drawArrowEnd = function(ctx) {
  7538. // set style
  7539. ctx.strokeStyle = this.color;
  7540. ctx.fillStyle = this.color;
  7541. ctx.lineWidth = this._getLineWidth();
  7542. // draw line
  7543. var angle, length;
  7544. if (this.from != this.to) {
  7545. // calculate length and angle of the line
  7546. angle = Math.atan2((this.to.y - this.from.y), (this.to.x - this.from.x));
  7547. var dx = (this.to.x - this.from.x);
  7548. var dy = (this.to.y - this.from.y);
  7549. var lEdge = Math.sqrt(dx * dx + dy * dy);
  7550. var lFrom = this.to.distanceToBorder(ctx, angle + Math.PI);
  7551. var pFrom = (lEdge - lFrom) / lEdge;
  7552. var xFrom = (pFrom) * this.from.x + (1 - pFrom) * this.to.x;
  7553. var yFrom = (pFrom) * this.from.y + (1 - pFrom) * this.to.y;
  7554. var lTo = this.to.distanceToBorder(ctx, angle);
  7555. var pTo = (lEdge - lTo) / lEdge;
  7556. var xTo = (1 - pTo) * this.from.x + pTo * this.to.x;
  7557. var yTo = (1 - pTo) * this.from.y + pTo * this.to.y;
  7558. ctx.beginPath();
  7559. ctx.moveTo(xFrom, yFrom);
  7560. ctx.lineTo(xTo, yTo);
  7561. ctx.stroke();
  7562. // draw arrow at the end of the line
  7563. length = 10 + 5 * this.width; // TODO: make customizable?
  7564. ctx.arrow(xTo, yTo, angle, length);
  7565. ctx.fill();
  7566. ctx.stroke();
  7567. // draw text
  7568. if (this.text) {
  7569. var point = this._pointOnLine(0.5);
  7570. this._text(ctx, this.text, point.x, point.y);
  7571. }
  7572. }
  7573. else {
  7574. // draw circle
  7575. var radius = this.length / 2 / Math.PI;
  7576. var x, y, arrow;
  7577. var node = this.from;
  7578. if (!node.width) {
  7579. node.resize(ctx);
  7580. }
  7581. if (node.width > node.height) {
  7582. x = node.x + node.width / 2;
  7583. y = node.y - radius;
  7584. arrow = {
  7585. x: x,
  7586. y: node.y,
  7587. angle: 0.9 * Math.PI
  7588. };
  7589. }
  7590. else {
  7591. x = node.x + radius;
  7592. y = node.y - node.height / 2;
  7593. arrow = {
  7594. x: node.x,
  7595. y: y,
  7596. angle: 0.6 * Math.PI
  7597. };
  7598. }
  7599. ctx.beginPath();
  7600. // TODO: do not draw a circle, but an arc
  7601. // TODO: similarly, for a line without arrows, draw to the border of the nodes instead of the center
  7602. ctx.arc(x, y, radius, 0, 2 * Math.PI, false);
  7603. ctx.stroke();
  7604. // draw all arrows
  7605. length = 10 + 5 * this.width; // TODO: make customizable?
  7606. ctx.arrow(arrow.x, arrow.y, arrow.angle, length);
  7607. ctx.fill();
  7608. ctx.stroke();
  7609. // draw text
  7610. if (this.text) {
  7611. point = this._pointOnCircle(x, y, radius, 0.5);
  7612. this._text(ctx, this.text, point.x, point.y);
  7613. }
  7614. }
  7615. };
  7616. /**
  7617. * Calculate the distance between a point (x3,y3) and a line segment from
  7618. * (x1,y1) to (x2,y2).
  7619. * http://stackoverflow.com/questions/849211/shortest-distancae-between-a-point-and-a-line-segment
  7620. * @param {number} x1
  7621. * @param {number} y1
  7622. * @param {number} x2
  7623. * @param {number} y2
  7624. * @param {number} x3
  7625. * @param {number} y3
  7626. */
  7627. Edge._dist = function (x1,y1, x2,y2, x3,y3) { // x3,y3 is the point
  7628. var px = x2-x1,
  7629. py = y2-y1,
  7630. something = px*px + py*py,
  7631. u = ((x3 - x1) * px + (y3 - y1) * py) / something;
  7632. if (u > 1) {
  7633. u = 1;
  7634. }
  7635. else if (u < 0) {
  7636. u = 0;
  7637. }
  7638. var x = x1 + u * px,
  7639. y = y1 + u * py,
  7640. dx = x - x3,
  7641. dy = y - y3;
  7642. //# Note: If the actual distance does not matter,
  7643. //# if you only want to compare what this function
  7644. //# returns to other results of this function, you
  7645. //# can just return the squared distance instead
  7646. //# (i.e. remove the sqrt) to gain a little performance
  7647. return Math.sqrt(dx*dx + dy*dy);
  7648. };
  7649. /**
  7650. * Popup is a class to create a popup window with some text
  7651. * @param {Element} container The container object.
  7652. * @param {Number} [x]
  7653. * @param {Number} [y]
  7654. * @param {String} [text]
  7655. */
  7656. function Popup(container, x, y, text) {
  7657. if (container) {
  7658. this.container = container;
  7659. }
  7660. else {
  7661. this.container = document.body;
  7662. }
  7663. this.x = 0;
  7664. this.y = 0;
  7665. this.padding = 5;
  7666. if (x !== undefined && y !== undefined ) {
  7667. this.setPosition(x, y);
  7668. }
  7669. if (text !== undefined) {
  7670. this.setText(text);
  7671. }
  7672. // create the frame
  7673. this.frame = document.createElement("div");
  7674. var style = this.frame.style;
  7675. style.position = "absolute";
  7676. style.visibility = "hidden";
  7677. style.border = "1px solid #666";
  7678. style.color = "black";
  7679. style.padding = this.padding + "px";
  7680. style.backgroundColor = "#FFFFC6";
  7681. style.borderRadius = "3px";
  7682. style.MozBorderRadius = "3px";
  7683. style.WebkitBorderRadius = "3px";
  7684. style.boxShadow = "3px 3px 10px rgba(128, 128, 128, 0.5)";
  7685. style.whiteSpace = "nowrap";
  7686. this.container.appendChild(this.frame);
  7687. };
  7688. /**
  7689. * @param {number} x Horizontal position of the popup window
  7690. * @param {number} y Vertical position of the popup window
  7691. */
  7692. Popup.prototype.setPosition = function(x, y) {
  7693. this.x = parseInt(x);
  7694. this.y = parseInt(y);
  7695. };
  7696. /**
  7697. * Set the text for the popup window. This can be HTML code
  7698. * @param {string} text
  7699. */
  7700. Popup.prototype.setText = function(text) {
  7701. this.frame.innerHTML = text;
  7702. };
  7703. /**
  7704. * Show the popup window
  7705. * @param {boolean} show Optional. Show or hide the window
  7706. */
  7707. Popup.prototype.show = function (show) {
  7708. if (show === undefined) {
  7709. show = true;
  7710. }
  7711. if (show) {
  7712. var height = this.frame.clientHeight;
  7713. var width = this.frame.clientWidth;
  7714. var maxHeight = this.frame.parentNode.clientHeight;
  7715. var maxWidth = this.frame.parentNode.clientWidth;
  7716. var top = (this.y - height);
  7717. if (top + height + this.padding > maxHeight) {
  7718. top = maxHeight - height - this.padding;
  7719. }
  7720. if (top < this.padding) {
  7721. top = this.padding;
  7722. }
  7723. var left = this.x;
  7724. if (left + width + this.padding > maxWidth) {
  7725. left = maxWidth - width - this.padding;
  7726. }
  7727. if (left < this.padding) {
  7728. left = this.padding;
  7729. }
  7730. this.frame.style.left = left + "px";
  7731. this.frame.style.top = top + "px";
  7732. this.frame.style.visibility = "visible";
  7733. }
  7734. else {
  7735. this.hide();
  7736. }
  7737. };
  7738. /**
  7739. * Hide the popup window
  7740. */
  7741. Popup.prototype.hide = function () {
  7742. this.frame.style.visibility = "hidden";
  7743. };
  7744. /**
  7745. * @class Groups
  7746. * This class can store groups and properties specific for groups.
  7747. */
  7748. Groups = function () {
  7749. this.clear();
  7750. this.defaultIndex = 0;
  7751. };
  7752. /**
  7753. * default constants for group colors
  7754. */
  7755. Groups.DEFAULT = [
  7756. {"borderColor": "#2B7CE9", "backgroundColor": "#97C2FC", "highlightColor": "#D2E5FF"}, // blue
  7757. {"borderColor": "#FFA500", "backgroundColor": "#FFFF00", "highlightColor": "#FFFFA3"}, // yellow
  7758. {"borderColor": "#FA0A10", "backgroundColor": "#FB7E81", "highlightColor": "#FFAFB1"}, // red
  7759. {"borderColor": "#41A906", "backgroundColor": "#7BE141", "highlightColor": "#A1EC76"}, // green
  7760. {"borderColor": "#E129F0", "backgroundColor": "#EB7DF4", "highlightColor": "#F0B3F5"}, // magenta
  7761. {"borderColor": "#7C29F0", "backgroundColor": "#AD85E4", "highlightColor": "#D3BDF0"}, // purple
  7762. {"borderColor": "#C37F00", "backgroundColor": "#FFA807", "highlightColor": "#FFCA66"}, // orange
  7763. {"borderColor": "#4220FB", "backgroundColor": "#6E6EFD", "highlightColor": "#9B9BFD"}, // darkblue
  7764. {"borderColor": "#FD5A77", "backgroundColor": "#FFC0CB", "highlightColor": "#FFD1D9"}, // pink
  7765. {"borderColor": "#4AD63A", "backgroundColor": "#C2FABC", "highlightColor": "#E6FFE3"} // mint
  7766. ];
  7767. /**
  7768. * Clear all groups
  7769. */
  7770. Groups.prototype.clear = function () {
  7771. this.groups = {};
  7772. this.groups.length = function()
  7773. {
  7774. var i = 0;
  7775. for ( var p in this ) {
  7776. if (this.hasOwnProperty(p)) {
  7777. i++;
  7778. }
  7779. }
  7780. return i;
  7781. }
  7782. };
  7783. /**
  7784. * get group properties of a groupname. If groupname is not found, a new group
  7785. * is added.
  7786. * @param {*} groupname Can be a number, string, Date, etc.
  7787. * @return {Object} group The created group, containing all group properties
  7788. */
  7789. Groups.prototype.get = function (groupname) {
  7790. var group = this.groups[groupname];
  7791. if (group == undefined) {
  7792. // create new group
  7793. var index = this.defaultIndex % Groups.DEFAULT.length;
  7794. this.defaultIndex++;
  7795. group = {};
  7796. group.borderColor = Groups.DEFAULT[index].borderColor;
  7797. group.backgroundColor = Groups.DEFAULT[index].backgroundColor;
  7798. group.highlightColor = Groups.DEFAULT[index].highlightColor;
  7799. this.groups[groupname] = group;
  7800. }
  7801. return group;
  7802. };
  7803. /**
  7804. * Add a custom group style
  7805. * @param {String} groupname
  7806. * @param {Object} style An object containing borderColor,
  7807. * backgroundColor, etc.
  7808. * @return {Object} group The created group object
  7809. */
  7810. Groups.prototype.add = function (groupname, style) {
  7811. this.groups[groupname] = style;
  7812. return style;
  7813. };
  7814. /**
  7815. * @class Images
  7816. * This class loads images and keeps them stored.
  7817. */
  7818. Images = function () {
  7819. this.images = {};
  7820. this.callback = undefined;
  7821. };
  7822. /**
  7823. * Set an onload callback function. This will be called each time an image
  7824. * is loaded
  7825. * @param {function} callback
  7826. */
  7827. Images.prototype.setOnloadCallback = function(callback) {
  7828. this.callback = callback;
  7829. };
  7830. /**
  7831. *
  7832. * @param {string} url Url of the image
  7833. * @return {Image} img The image object
  7834. */
  7835. Images.prototype.load = function(url) {
  7836. var img = this.images[url];
  7837. if (img == undefined) {
  7838. // create the image
  7839. var images = this;
  7840. img = new Image();
  7841. this.images[url] = img;
  7842. img.onload = function() {
  7843. if (images.callback) {
  7844. images.callback(this);
  7845. }
  7846. };
  7847. img.src = url;
  7848. }
  7849. return img;
  7850. };
  7851. /**
  7852. * @constructor Graph
  7853. * Create a graph visualization, displaying nodes and edges.
  7854. *
  7855. * @param {Element} container The DOM element in which the Graph will
  7856. * be created. Normally a div element.
  7857. * @param {Object} data An object containing parameters
  7858. * {Array} nodes
  7859. * {Array} edges
  7860. * @param {Object} options Options
  7861. */
  7862. function Graph (container, data, options) {
  7863. // create variables and set default values
  7864. this.containerElement = container;
  7865. this.width = "100%";
  7866. this.height = "100%";
  7867. this.refreshRate = 50; // milliseconds
  7868. this.stabilize = true; // stabilize before displaying the graph
  7869. this.selectable = true;
  7870. // set constant values
  7871. this.constants = {
  7872. "nodes": {
  7873. "radiusMin": 5,
  7874. "radiusMax": 20,
  7875. "radius": 5,
  7876. "distance": 100, // px
  7877. "style": "rect",
  7878. "image": undefined,
  7879. "widthMin": 16, // px
  7880. "widthMax": 64, // px
  7881. "fontColor": "black",
  7882. "fontSize": 14, // px
  7883. //"fontFace": "verdana",
  7884. "fontFace": "arial",
  7885. "borderColor": "#2B7CE9",
  7886. "backgroundColor": "#97C2FC",
  7887. "highlightColor": "#D2E5FF",
  7888. "group": undefined
  7889. },
  7890. "edges": {
  7891. "widthMin": 1,
  7892. "widthMax": 15,
  7893. "width": 1,
  7894. "style": "line",
  7895. "color": "#343434",
  7896. "fontColor": "#343434",
  7897. "fontSize": 14, // px
  7898. "fontFace": "arial",
  7899. //"distance": 100, //px
  7900. "length": 100, // px
  7901. "dashlength": 10,
  7902. "dashgap": 5
  7903. },
  7904. "minForce": 0.05,
  7905. "minVelocity": 0.02, // px/s
  7906. "maxIterations": 1000 // maximum number of iteration to stabilize
  7907. };
  7908. var graph = this;
  7909. this.nodes = []; // array with Node objects
  7910. this.edges = []; // array with Edge objects
  7911. this.groups = new Groups(); // object with groups
  7912. this.images = new Images(); // object with images
  7913. this.images.setOnloadCallback(function () {
  7914. graph._redraw();
  7915. });
  7916. // properties of the data
  7917. this.moving = false; // True if any of the nodes have an undefined position
  7918. this.selection = [];
  7919. this.timer = undefined;
  7920. // create a frame and canvas
  7921. this._create();
  7922. // apply options
  7923. this.setOptions(options);
  7924. // draw data
  7925. this.setData(data);
  7926. }
  7927. /**
  7928. * Set nodes and edges, and optionally options as well.
  7929. *
  7930. * @param {Object} data Object containing parameters:
  7931. * {Array} nodes Array with nodes
  7932. * {Array} edges Array with edges
  7933. * {Options} [options] Object with options
  7934. */
  7935. Graph.prototype.setData = function(data) {
  7936. // set options
  7937. this.setOptions(data && data.options);
  7938. // set all data
  7939. this._setNodes(data && data.nodes);
  7940. this._setEdges(data && data.edges);
  7941. // find a stable position or start animating to a stable position
  7942. if (this.stabilize) {
  7943. this._doStabilize();
  7944. }
  7945. this.start();
  7946. };
  7947. /**
  7948. * Set options
  7949. * @param {Object} options
  7950. */
  7951. Graph.prototype.setOptions = function (options) {
  7952. if (options) {
  7953. // retrieve parameter values
  7954. if (options.width != undefined) {this.width = options.width;}
  7955. if (options.height != undefined) {this.height = options.height;}
  7956. if (options.stabilize != undefined) {this.stabilize = options.stabilize;}
  7957. if (options.selectable != undefined) {this.selectable = options.selectable;}
  7958. // TODO: work out these options and document them
  7959. if (options.edges) {
  7960. for (var prop in options.edges) {
  7961. if (options.edges.hasOwnProperty(prop)) {
  7962. this.constants.edges[prop] = options.edges[prop];
  7963. }
  7964. }
  7965. if (options.edges.length != undefined &&
  7966. options.nodes && options.nodes.distance == undefined) {
  7967. this.constants.edges.length = options.edges.length;
  7968. this.constants.nodes.distance = options.edges.length * 1.25;
  7969. }
  7970. if (!options.edges.fontColor) {
  7971. this.constants.edges.fontColor = options.edges.color;
  7972. }
  7973. // Added to support dashed lines
  7974. // David Jordan
  7975. // 2012-08-08
  7976. if (options.edges.dashlength != undefined) {
  7977. this.constants.edges.dashlength = options.edges.dashlength;
  7978. }
  7979. if (options.edges.dashgap != undefined) {
  7980. this.constants.edges.dashgap = options.edges.dashgap;
  7981. }
  7982. if (options.edges.altdashlength != undefined) {
  7983. this.constants.edges.altdashlength = options.edges.altdashlength;
  7984. }
  7985. }
  7986. if (options.nodes) {
  7987. for (prop in options.nodes) {
  7988. if (options.nodes.hasOwnProperty(prop)) {
  7989. this.constants.nodes[prop] = options.nodes[prop];
  7990. }
  7991. }
  7992. /*
  7993. if (options.nodes.widthMin) this.constants.nodes.radiusMin = options.nodes.widthMin;
  7994. if (options.nodes.widthMax) this.constants.nodes.radiusMax = options.nodes.widthMax;
  7995. */
  7996. }
  7997. if (options.groups) {
  7998. for (var groupname in options.groups) {
  7999. if (options.groups.hasOwnProperty(groupname)) {
  8000. var group = options.groups[groupname];
  8001. this.groups.add(groupname, group);
  8002. }
  8003. }
  8004. }
  8005. this._setBackgroundColor(options.backgroundColor);
  8006. }
  8007. this._setSize(this.width, this.height);
  8008. this._setTranslation(0, 0);
  8009. this._setScale(1.0);
  8010. };
  8011. /**
  8012. * fire an event
  8013. * @param {String} event The name of an event, for example "select"
  8014. * @param {Object} params Optional object with event parameters
  8015. */
  8016. Graph.prototype.trigger = function (event, params) {
  8017. // trigger the edges event bus
  8018. events.trigger(this, event, params);
  8019. // trigger the google event bus
  8020. if (typeof google !== 'undefined' && google.visualization && google.visualization.events) {
  8021. google.visualization.events.trigger(this, event, params);
  8022. }
  8023. };
  8024. /**
  8025. * Create the main frame for the Graph.
  8026. * This function is executed once when a Graph object is created. The frame
  8027. * contains a canvas, and this canvas contains all objects like the axis and
  8028. * nodes.
  8029. */
  8030. Graph.prototype._create = function () {
  8031. // remove all elements from the container element.
  8032. while (this.containerElement.hasChildNodes()) {
  8033. this.containerElement.removeChild(this.containerElement.firstChild);
  8034. }
  8035. this.frame = document.createElement("div");
  8036. this.frame.className = "graph-frame";
  8037. this.frame.style.position = "relative";
  8038. this.frame.style.overflow = "hidden";
  8039. // create the graph canvas (HTML canvas element)
  8040. this.frame.canvas = document.createElement( "canvas" );
  8041. this.frame.canvas.style.position = "relative";
  8042. this.frame.appendChild(this.frame.canvas);
  8043. if (!this.frame.canvas.getContext) {
  8044. var noCanvas = document.createElement( "DIV" );
  8045. noCanvas.style.color = "red";
  8046. noCanvas.style.fontWeight = "bold" ;
  8047. noCanvas.style.padding = "10px";
  8048. noCanvas.innerHTML = "Error: your browser does not support HTML canvas";
  8049. this.frame.canvas.appendChild(noCanvas);
  8050. }
  8051. // create event listeners
  8052. var me = this;
  8053. var onmousedown = function (event) {me._onMouseDown(event);};
  8054. var onmousemove = function (event) {me._onMouseMoveTitle(event);};
  8055. var onmousewheel = function (event) {me._onMouseWheel(event);};
  8056. var ontouchstart = function (event) {me._onTouchStart(event);};
  8057. vis.util.addEventListener(this.frame.canvas, "mousedown", onmousedown);
  8058. vis.util.addEventListener(this.frame.canvas, "mousemove", onmousemove);
  8059. vis.util.addEventListener(this.frame.canvas, "mousewheel", onmousewheel);
  8060. vis.util.addEventListener(this.frame.canvas, "touchstart", ontouchstart);
  8061. // add the frame to the container element
  8062. this.containerElement.appendChild(this.frame);
  8063. };
  8064. /**
  8065. * Set the background and border styling for the graph
  8066. * @param {String | Object} backgroundColor
  8067. */
  8068. Graph.prototype._setBackgroundColor = function(backgroundColor) {
  8069. var fill = "white";
  8070. var stroke = "lightgray";
  8071. var strokeWidth = 1;
  8072. if (typeof(backgroundColor) == "string") {
  8073. fill = backgroundColor;
  8074. stroke = "none";
  8075. strokeWidth = 0;
  8076. }
  8077. else if (typeof(backgroundColor) == "object") {
  8078. if (backgroundColor.fill != undefined) fill = backgroundColor.fill;
  8079. if (backgroundColor.stroke != undefined) stroke = backgroundColor.stroke;
  8080. if (backgroundColor.strokeWidth != undefined) strokeWidth = backgroundColor.strokeWidth;
  8081. }
  8082. else if (backgroundColor == undefined) {
  8083. // use use defaults
  8084. }
  8085. else {
  8086. throw "Unsupported type of backgroundColor";
  8087. }
  8088. this.frame.style.boxSizing = 'border-box';
  8089. this.frame.style.backgroundColor = fill;
  8090. this.frame.style.borderColor = stroke;
  8091. this.frame.style.borderWidth = strokeWidth + "px";
  8092. this.frame.style.borderStyle = "solid";
  8093. };
  8094. /**
  8095. * handle on mouse down event
  8096. */
  8097. Graph.prototype._onMouseDown = function (event) {
  8098. event = event || window.event;
  8099. if (!this.selectable) {
  8100. return;
  8101. }
  8102. // check if mouse is still down (may be up when focus is lost for example
  8103. // in an iframe)
  8104. if (this.leftButtonDown) {
  8105. this._onMouseUp(event);
  8106. }
  8107. // only react on left mouse button down
  8108. this.leftButtonDown = event.which ? (event.which == 1) : (event.button == 1);
  8109. if (!this.leftButtonDown && !this.touchDown) {
  8110. return;
  8111. }
  8112. // add event listeners to handle moving the contents
  8113. // we store the function onmousemove and onmouseup in the timeline, so we can
  8114. // remove the eventlisteners lateron in the function mouseUp()
  8115. var me = this;
  8116. if (!this.onmousemove) {
  8117. this.onmousemove = function (event) {me._onMouseMove(event);};
  8118. vis.util.addEventListener(document, "mousemove", me.onmousemove);
  8119. }
  8120. if (!this.onmouseup) {
  8121. this.onmouseup = function (event) {me._onMouseUp(event);};
  8122. vis.util.addEventListener(document, "mouseup", me.onmouseup);
  8123. }
  8124. vis.util.preventDefault(event);
  8125. // store the start x and y position of the mouse
  8126. this.startMouseX = event.clientX || event.targetTouches[0].clientX;
  8127. this.startMouseY = event.clientY || event.targetTouches[0].clientY;
  8128. this.startFrameLeft = vis.util.getAbsoluteLeft(this.frame.canvas);
  8129. this.startFrameTop = vis.util.getAbsoluteTop(this.frame.canvas);
  8130. this.startTranslation = this._getTranslation();
  8131. this.ctrlKeyDown = event.ctrlKey;
  8132. this.shiftKeyDown = event.shiftKey;
  8133. var obj = {
  8134. "left" : this._xToCanvas(this.startMouseX - this.startFrameLeft),
  8135. "top" : this._yToCanvas(this.startMouseY - this.startFrameTop),
  8136. "right" : this._xToCanvas(this.startMouseX - this.startFrameLeft),
  8137. "bottom" : this._yToCanvas(this.startMouseY - this.startFrameTop)
  8138. };
  8139. var overlappingNodes = this._getNodesOverlappingWith(obj);
  8140. // if there are overlapping nodes, select the last one, this is the
  8141. // one which is drawn on top of the others
  8142. this.startClickedObj = (overlappingNodes.length > 0) ?
  8143. overlappingNodes[overlappingNodes.length - 1] : undefined;
  8144. if (this.startClickedObj) {
  8145. // move clicked node with the mouse
  8146. // make the clicked node temporarily fixed, and store their original state
  8147. var node = this.nodes[this.startClickedObj.row];
  8148. this.startClickedObj.xFixed = node.xFixed;
  8149. this.startClickedObj.yFixed = node.yFixed;
  8150. node.xFixed = true;
  8151. node.yFixed = true;
  8152. if (!this.ctrlKeyDown || !node.isSelected()) {
  8153. // select this node
  8154. this._selectNodes([this.startClickedObj], this.ctrlKeyDown);
  8155. }
  8156. else {
  8157. // unselect this node
  8158. this._unselectNodes([this.startClickedObj]);
  8159. }
  8160. if (!this.moving) {
  8161. this._redraw();
  8162. }
  8163. }
  8164. else if (this.shiftKeyDown) {
  8165. // start selection of multiple nodes
  8166. }
  8167. else {
  8168. // start moving the graph
  8169. this.moved = false;
  8170. }
  8171. };
  8172. /**
  8173. * handle on mouse move event
  8174. */
  8175. Graph.prototype._onMouseMove = function (event) {
  8176. event = event || window.event;
  8177. if (!this.selectable) {
  8178. return;
  8179. }
  8180. var mouseX = event.clientX || (event.targetTouches && event.targetTouches[0].clientX) || 0;
  8181. var mouseY = event.clientY || (event.targetTouches && event.targetTouches[0].clientY) || 0;
  8182. this.mouseX = mouseX;
  8183. this.mouseY = mouseY;
  8184. if (this.startClickedObj) {
  8185. var node = this.nodes[this.startClickedObj.row];
  8186. if (!this.startClickedObj.xFixed)
  8187. node.x = this._xToCanvas(mouseX - this.startFrameLeft);
  8188. if (!this.startClickedObj.yFixed)
  8189. node.y = this._yToCanvas(mouseY - this.startFrameTop);
  8190. // start animation if not yet running
  8191. if (!this.moving) {
  8192. this.moving = true;
  8193. this.start();
  8194. }
  8195. }
  8196. else if (this.shiftKeyDown) {
  8197. // draw a rect from start mouse location to current mouse location
  8198. if (this.frame.selRect == undefined) {
  8199. this.frame.selRect = document.createElement("DIV");
  8200. this.frame.appendChild(this.frame.selRect);
  8201. this.frame.selRect.style.position = "absolute";
  8202. this.frame.selRect.style.border = "1px dashed red";
  8203. }
  8204. var left = Math.min(this.startMouseX, mouseX) - this.startFrameLeft;
  8205. var top = Math.min(this.startMouseY, mouseY) - this.startFrameTop;
  8206. var right = Math.max(this.startMouseX, mouseX) - this.startFrameLeft;
  8207. var bottom = Math.max(this.startMouseY, mouseY) - this.startFrameTop;
  8208. this.frame.selRect.style.left = left + "px";
  8209. this.frame.selRect.style.top = top + "px";
  8210. this.frame.selRect.style.width = (right - left) + "px";
  8211. this.frame.selRect.style.height = (bottom - top) + "px";
  8212. }
  8213. else {
  8214. // move the graph
  8215. var diffX = mouseX - this.startMouseX;
  8216. var diffY = mouseY - this.startMouseY;
  8217. this._setTranslation(
  8218. this.startTranslation.x + diffX,
  8219. this.startTranslation.y + diffY);
  8220. this._redraw();
  8221. this.moved = true;
  8222. }
  8223. vis.util.preventDefault(event);
  8224. };
  8225. /**
  8226. * handle on mouse up event
  8227. */
  8228. Graph.prototype._onMouseUp = function (event) {
  8229. event = event || window.event;
  8230. if (!this.selectable) {
  8231. return;
  8232. }
  8233. // remove event listeners here, important for Safari
  8234. if (this.onmousemove) {
  8235. vis.util.removeEventListener(document, "mousemove", this.onmousemove);
  8236. this.onmousemove = undefined;
  8237. }
  8238. if (this.onmouseup) {
  8239. vis.util.removeEventListener(document, "mouseup", this.onmouseup);
  8240. this.onmouseup = undefined;
  8241. }
  8242. vis.util.preventDefault(event);
  8243. // check selected nodes
  8244. var endMouseX = event.clientX || this.mouseX || 0;
  8245. var endMouseY = event.clientY || this.mouseY || 0;
  8246. var ctrlKey = event ? event.ctrlKey : window.event.ctrlKey;
  8247. if (this.startClickedObj) {
  8248. // restore the original fixed state
  8249. var node = this.nodes[this.startClickedObj.row];
  8250. node.xFixed = this.startClickedObj.xFixed;
  8251. node.yFixed = this.startClickedObj.yFixed;
  8252. }
  8253. else if (this.shiftKeyDown) {
  8254. // select nodes inside selection area
  8255. var obj = {
  8256. "left": this._xToCanvas(Math.min(this.startMouseX, endMouseX) - this.startFrameLeft),
  8257. "top": this._yToCanvas(Math.min(this.startMouseY, endMouseY) - this.startFrameTop),
  8258. "right": this._xToCanvas(Math.max(this.startMouseX, endMouseX) - this.startFrameLeft),
  8259. "bottom": this._yToCanvas(Math.max(this.startMouseY, endMouseY) - this.startFrameTop)
  8260. };
  8261. var overlappingNodes = this._getNodesOverlappingWith(obj);
  8262. this._selectNodes(overlappingNodes, ctrlKey);
  8263. this.redraw();
  8264. // remove the selection rectangle
  8265. if (this.frame.selRect) {
  8266. this.frame.removeChild(this.frame.selRect);
  8267. this.frame.selRect = undefined;
  8268. }
  8269. }
  8270. else {
  8271. if (!this.ctrlKeyDown && !this.moved) {
  8272. // remove selection
  8273. this._unselectNodes();
  8274. this._redraw();
  8275. }
  8276. }
  8277. this.leftButtonDown = false;
  8278. this.ctrlKeyDown = false;
  8279. };
  8280. /**
  8281. * Event handler for mouse wheel event, used to zoom the timeline
  8282. * Code from http://adomas.org/javascript-mouse-wheel/
  8283. * @param {event} event The event
  8284. */
  8285. Graph.prototype._onMouseWheel = function(event) {
  8286. event = event || window.event;
  8287. var mouseX = event.clientX;
  8288. var mouseY = event.clientY;
  8289. // retrieve delta
  8290. var delta = 0;
  8291. if (event.wheelDelta) { /* IE/Opera. */
  8292. delta = event.wheelDelta/120;
  8293. } else if (event.detail) { /* Mozilla case. */
  8294. // In Mozilla, sign of delta is different than in IE.
  8295. // Also, delta is multiple of 3.
  8296. delta = -event.detail/3;
  8297. }
  8298. // If delta is nonzero, handle it.
  8299. // Basically, delta is now positive if wheel was scrolled up,
  8300. // and negative, if wheel was scrolled down.
  8301. if (delta) {
  8302. // determine zoom factor, and adjust the zoom factor such that zooming in
  8303. // and zooming out correspond wich each other
  8304. var zoom = delta / 10;
  8305. if (delta < 0) {
  8306. zoom = zoom / (1 - zoom);
  8307. }
  8308. var scaleOld = this._getScale();
  8309. var scaleNew = scaleOld * (1 + zoom);
  8310. if (scaleNew < 0.01) {
  8311. scaleNew = 0.01;
  8312. }
  8313. if (scaleNew > 10) {
  8314. scaleNew = 10;
  8315. }
  8316. var frameLeft = vis.util.getAbsoluteLeft(this.frame.canvas);
  8317. var frameTop = vis.util.getAbsoluteTop(this.frame.canvas);
  8318. var x = mouseX - frameLeft;
  8319. var y = mouseY - frameTop;
  8320. var translation = this._getTranslation();
  8321. var scaleFrac = scaleNew / scaleOld;
  8322. var tx = (1 - scaleFrac) * x + translation.x * scaleFrac;
  8323. var ty = (1 - scaleFrac) * y + translation.y * scaleFrac;
  8324. this._setScale(scaleNew);
  8325. this._setTranslation(tx, ty);
  8326. this._redraw();
  8327. }
  8328. // Prevent default actions caused by mouse wheel.
  8329. // That might be ugly, but we handle scrolls somehow
  8330. // anyway, so don't bother here...
  8331. vis.util.preventDefault(event);
  8332. };
  8333. /**
  8334. * Mouse move handler for checking whether the title moves over a node with a title.
  8335. */
  8336. Graph.prototype._onMouseMoveTitle = function (event) {
  8337. event = event || window.event;
  8338. var startMouseX = event.clientX;
  8339. var startMouseY = event.clientY;
  8340. this.startFrameLeft = this.startFrameLeft || vis.util.getAbsoluteLeft(this.frame.canvas);
  8341. this.startFrameTop = this.startFrameTop || vis.util.getAbsoluteTop(this.frame.canvas);
  8342. var x = startMouseX - this.startFrameLeft;
  8343. var y = startMouseY - this.startFrameTop;
  8344. // check if the previously selected node is still selected
  8345. if (this.popupNode) {
  8346. this._checkHidePopup(x, y);
  8347. }
  8348. // start a timeout that will check if the mouse is positioned above
  8349. // an element
  8350. var me = this;
  8351. var checkShow = function() {
  8352. me._checkShowPopup(x, y);
  8353. };
  8354. if (this.popupTimer) {
  8355. clearInterval(this.popupTimer); // stop any running timer
  8356. }
  8357. if (!this.leftButtonDown) {
  8358. this.popupTimer = setTimeout(checkShow, 300);
  8359. }
  8360. };
  8361. /**
  8362. * Check if there is an element on the given position in the graph
  8363. * (a node or edge). If so, and if this element has a title,
  8364. * show a popup window with its title.
  8365. *
  8366. * @param {number} x
  8367. * @param {number} y
  8368. */
  8369. Graph.prototype._checkShowPopup = function (x, y) {
  8370. var obj = {
  8371. "left" : this._xToCanvas(x),
  8372. "top" : this._yToCanvas(y),
  8373. "right" : this._xToCanvas(x),
  8374. "bottom" : this._yToCanvas(y)
  8375. };
  8376. var i, len;
  8377. var lastPopupNode = this.popupNode;
  8378. if (this.popupNode == undefined) {
  8379. // search the nodes for overlap, select the top one in case of multiple nodes
  8380. var nodes = this.nodes;
  8381. for (i = nodes.length - 1; i >= 0; i--) {
  8382. var node = nodes[i];
  8383. if (node.getTitle() != undefined && node.isOverlappingWith(obj)) {
  8384. this.popupNode = node;
  8385. break;
  8386. }
  8387. }
  8388. }
  8389. if (this.popupNode == undefined) {
  8390. // search the edges for overlap
  8391. var allEdges = this.edges;
  8392. for (i = 0, len = allEdges.length; i < len; i++) {
  8393. var edge = allEdges[i];
  8394. if (edge.getTitle() != undefined && edge.isOverlappingWith(obj)) {
  8395. this.popupNode = edge;
  8396. break;
  8397. }
  8398. }
  8399. }
  8400. if (this.popupNode) {
  8401. // show popup message window
  8402. if (this.popupNode != lastPopupNode) {
  8403. var me = this;
  8404. if (!me.popup) {
  8405. me.popup = new Popup(me.frame);
  8406. }
  8407. // adjust a small offset such that the mouse cursor is located in the
  8408. // bottom left location of the popup, and you can easily move over the
  8409. // popup area
  8410. me.popup.setPosition(x - 3, y - 3);
  8411. me.popup.setText(me.popupNode.getTitle());
  8412. me.popup.show();
  8413. }
  8414. }
  8415. else {
  8416. if (this.popup) {
  8417. this.popup.hide();
  8418. }
  8419. }
  8420. };
  8421. /**
  8422. * Check if the popup must be hided, which is the case when the mouse is no
  8423. * longer hovering on the object
  8424. * @param {number} x
  8425. * @param {number} y
  8426. */
  8427. Graph.prototype._checkHidePopup = function (x, y) {
  8428. var obj = {
  8429. "left" : x,
  8430. "top" : y,
  8431. "right" : x,
  8432. "bottom" : y
  8433. };
  8434. if (!this.popupNode || !this.popupNode.isOverlappingWith(obj) ) {
  8435. this.popupNode = undefined;
  8436. if (this.popup) {
  8437. this.popup.hide();
  8438. }
  8439. }
  8440. };
  8441. /**
  8442. * Event handler for touchstart event on mobile devices
  8443. */
  8444. Graph.prototype._onTouchStart = function(event) {
  8445. vis.util.preventDefault(event);
  8446. if (this.touchDown) {
  8447. // if already moving, return
  8448. return;
  8449. }
  8450. this.touchDown = true;
  8451. var me = this;
  8452. if (!this.ontouchmove) {
  8453. this.ontouchmove = function (event) {me._onTouchMove(event);};
  8454. vis.util.addEventListener(document, "touchmove", this.ontouchmove);
  8455. }
  8456. if (!this.ontouchend) {
  8457. this.ontouchend = function (event) {me._onTouchEnd(event);};
  8458. vis.util.addEventListener(document, "touchend", this.ontouchend);
  8459. }
  8460. this._onMouseDown(event);
  8461. };
  8462. /**
  8463. * Event handler for touchmove event on mobile devices
  8464. */
  8465. Graph.prototype._onTouchMove = function(event) {
  8466. vis.util.preventDefault(event);
  8467. this._onMouseMove(event);
  8468. };
  8469. /**
  8470. * Event handler for touchend event on mobile devices
  8471. */
  8472. Graph.prototype._onTouchEnd = function(event) {
  8473. vis.util.preventDefault(event);
  8474. this.touchDown = false;
  8475. if (this.ontouchmove) {
  8476. vis.util.removeEventListener(document, "touchmove", this.ontouchmove);
  8477. this.ontouchmove = undefined;
  8478. }
  8479. if (this.ontouchend) {
  8480. vis.util.removeEventListener(document, "touchend", this.ontouchend);
  8481. this.ontouchend = undefined;
  8482. }
  8483. this._onMouseUp(event);
  8484. };
  8485. /**
  8486. * Unselect selected nodes. If no selection array is provided, all nodes
  8487. * are unselected
  8488. * @param {Object[]} selection Array with selection objects, each selection
  8489. * object has a parameter row. Optional
  8490. * @param {Boolean} triggerSelect If true (default), the select event
  8491. * is triggered when nodes are unselected
  8492. * @return {Boolean} changed True if the selection is changed
  8493. */
  8494. Graph.prototype._unselectNodes = function(selection, triggerSelect) {
  8495. var changed = false;
  8496. var i, iMax, row;
  8497. if (selection) {
  8498. // remove provided selections
  8499. for (i = 0, iMax = selection.length; i < iMax; i++) {
  8500. row = selection[i].row;
  8501. this.nodes[row].unselect();
  8502. var j = 0;
  8503. while (j < this.selection.length) {
  8504. if (this.selection[j].row == row) {
  8505. this.selection.splice(j, 1);
  8506. changed = true;
  8507. }
  8508. else {
  8509. j++;
  8510. }
  8511. }
  8512. }
  8513. }
  8514. else if (this.selection && this.selection.length) {
  8515. // remove all selections
  8516. for (i = 0, iMax = this.selection.length; i < iMax; i++) {
  8517. row = this.selection[i].row;
  8518. this.nodes[row].unselect();
  8519. changed = true;
  8520. }
  8521. this.selection = [];
  8522. }
  8523. if (changed && (triggerSelect == true || triggerSelect == undefined)) {
  8524. // fire the select event
  8525. this.trigger('select');
  8526. }
  8527. return changed;
  8528. };
  8529. /**
  8530. * select all nodes on given location x, y
  8531. * @param {Array} selection an array with selection objects. Each selection
  8532. * object has a parameter row
  8533. * @param {boolean} append If true, the new selection will be appended to the
  8534. * current selection (except for duplicate entries)
  8535. * @return {Boolean} changed True if the selection is changed
  8536. */
  8537. Graph.prototype._selectNodes = function(selection, append) {
  8538. var changed = false;
  8539. var i, iMax;
  8540. // TODO: the selectNodes method is a little messy, rework this
  8541. // check if the current selection equals the desired selection
  8542. var selectionAlreadyDone = true;
  8543. if (selection.length != this.selection.length) {
  8544. selectionAlreadyDone = false;
  8545. }
  8546. else {
  8547. for (i = 0, iMax = Math.min(selection.length, this.selection.length); i < iMax; i++) {
  8548. if (selection[i].row != this.selection[i].row) {
  8549. selectionAlreadyDone = false;
  8550. break;
  8551. }
  8552. }
  8553. }
  8554. if (selectionAlreadyDone) {
  8555. return changed;
  8556. }
  8557. if (append == undefined || append == false) {
  8558. // first deselect any selected node
  8559. var triggerSelect = false;
  8560. changed = this._unselectNodes(undefined, triggerSelect);
  8561. }
  8562. for (i = 0, iMax = selection.length; i < iMax; i++) {
  8563. // add each of the new selections, but only when they are not duplicate
  8564. var row = selection[i].row;
  8565. var isDuplicate = false;
  8566. for (var j = 0, jMax = this.selection.length; j < jMax; j++) {
  8567. if (this.selection[j].row == row) {
  8568. isDuplicate = true;
  8569. break;
  8570. }
  8571. }
  8572. if (!isDuplicate) {
  8573. this.nodes[row].select();
  8574. this.selection.push(selection[i]);
  8575. changed = true;
  8576. }
  8577. }
  8578. if (changed) {
  8579. // fire the select event
  8580. this.trigger('select');
  8581. }
  8582. return changed;
  8583. };
  8584. /**
  8585. * retrieve all nodes overlapping with given object
  8586. * @param {Object} obj An object with parameters left, top, right, bottom
  8587. * @return {Object[]} An array with selection objects containing
  8588. * the parameter row.
  8589. */
  8590. Graph.prototype._getNodesOverlappingWith = function (obj) {
  8591. var overlappingNodes = [];
  8592. for (var i = 0; i < this.nodes.length; i++) {
  8593. if (this.nodes[i].isOverlappingWith(obj)) {
  8594. var sel = {"row": i};
  8595. overlappingNodes.push(sel);
  8596. }
  8597. }
  8598. return overlappingNodes;
  8599. };
  8600. /**
  8601. * retrieve the currently selected nodes
  8602. * @return {Object[]} an array with zero or more objects. Each object
  8603. * contains the parameter row
  8604. */
  8605. Graph.prototype.getSelection = function() {
  8606. var selection = [];
  8607. for (var i = 0; i < this.selection.length; i++) {
  8608. var row = this.selection[i].row;
  8609. selection.push({"row": row});
  8610. }
  8611. return selection;
  8612. };
  8613. /**
  8614. * select zero or more nodes
  8615. * @param {object[]} selection an array with zero or more objects. Each object
  8616. * contains the parameter row
  8617. */
  8618. Graph.prototype.setSelection = function(selection) {
  8619. var i, iMax, row;
  8620. if (selection.length == undefined)
  8621. throw "Selection must be an array with objects";
  8622. // first unselect any selected node
  8623. for (i = 0, iMax = this.selection.length; i < iMax; i++) {
  8624. row = this.selection[i].row;
  8625. this.nodes[row].unselect();
  8626. }
  8627. this.selection = [];
  8628. for (i = 0, iMax = selection.length; i < iMax; i++) {
  8629. row = selection[i].row;
  8630. if (row == undefined)
  8631. throw "Parameter row missing in selection object";
  8632. if (row > this.nodes.length-1)
  8633. throw "Parameter row out of range";
  8634. var sel = {"row": row};
  8635. this.selection.push(sel);
  8636. this.nodes[row].select();
  8637. }
  8638. this.redraw();
  8639. };
  8640. /**
  8641. * Temporary method to test calculating a hub value for the nodes
  8642. * @param {number} level Maximum number edges between two nodes in order
  8643. * to call them connected. Optional, 1 by default
  8644. * @return {Number[]} connectioncount array with the connection count
  8645. * for each node
  8646. */
  8647. Graph.prototype._getConnectionCount = function(level) {
  8648. var conn = this.edges;
  8649. if (level == undefined) {
  8650. level = 1;
  8651. }
  8652. // get the nodes connected to given nodes
  8653. function getConnectedNodes(nodes) {
  8654. var connectedNodes = [];
  8655. for (var j = 0, jMax = nodes.length; j < jMax; j++) {
  8656. var node = nodes[j];
  8657. // find all nodes connected to this node
  8658. for (var i = 0, iMax = conn.length; i < iMax; i++) {
  8659. var other = null;
  8660. // check if connected
  8661. if (conn[i].from == node)
  8662. other = conn[i].to;
  8663. else if (conn[i].to == node)
  8664. other = conn[i].from;
  8665. // check if the other node is not already in the list with nodes
  8666. var k, kMax;
  8667. if (other) {
  8668. for (k = 0, kMax = nodes.length; k < kMax; k++) {
  8669. if (nodes[k] == other) {
  8670. other = null;
  8671. break;
  8672. }
  8673. }
  8674. }
  8675. if (other) {
  8676. for (k = 0, kMax = connectedNodes.length; k < kMax; k++) {
  8677. if (connectedNodes[k] == other) {
  8678. other = null;
  8679. break;
  8680. }
  8681. }
  8682. }
  8683. if (other)
  8684. connectedNodes.push(other);
  8685. }
  8686. }
  8687. return connectedNodes;
  8688. }
  8689. var connections = [];
  8690. var level0 = [];
  8691. var nodes = this.nodes;
  8692. var i, iMax;
  8693. for (i = 0, iMax = nodes.length; i < iMax; i++) {
  8694. var c = [nodes[i]];
  8695. for (var l = 0; l < level; l++) {
  8696. c = c.concat(getConnectedNodes(c));
  8697. }
  8698. connections.push(c);
  8699. }
  8700. var hubs = [];
  8701. for (i = 0, len = connections.length; i < len; i++) {
  8702. hubs.push(connections[i].length);
  8703. }
  8704. return hubs;
  8705. };
  8706. /**
  8707. * Set a new size for the graph
  8708. * @param {string} width Width in pixels or percentage (for example "800px"
  8709. * or "50%")
  8710. * @param {string} height Height in pixels or percentage (for example "400px"
  8711. * or "30%")
  8712. */
  8713. Graph.prototype._setSize = function(width, height) {
  8714. this.frame.style.width = width;
  8715. this.frame.style.height = height;
  8716. this.frame.canvas.style.width = "100%";
  8717. this.frame.canvas.style.height = "100%";
  8718. this.frame.canvas.width = this.frame.canvas.clientWidth;
  8719. this.frame.canvas.height = this.frame.canvas.clientHeight;
  8720. };
  8721. /**
  8722. * Set a data set with nodes for the graph
  8723. * @param {Array} nodes The data containing the nodes.
  8724. * @private
  8725. */
  8726. Graph.prototype._setNodes = function(nodes) {
  8727. this.selection = [];
  8728. this.nodes = [];
  8729. this.moving = false;
  8730. if (!nodes) {
  8731. return;
  8732. }
  8733. var hasValues = false;
  8734. var rowCount = nodes.length;
  8735. for (var i = 0; i < rowCount; i++) {
  8736. var properties = nodes[i];
  8737. if (properties.value != undefined) {
  8738. hasValues = true;
  8739. }
  8740. if (properties.id == undefined) {
  8741. throw "Column 'id' missing in table with nodes (row " + i + ")";
  8742. }
  8743. this._createNode(properties);
  8744. }
  8745. // calculate scaling function when value is provided
  8746. if (hasValues) {
  8747. this._updateValueRange(this.nodes);
  8748. }
  8749. // give the nodes some first (random) position
  8750. this._reposition(); // TODO: bad solution
  8751. };
  8752. /**
  8753. * Create a node with the given properties
  8754. * If the new node has an id identical to an existing node, the existing
  8755. * node will be overwritten.
  8756. * The properties can contain a property "action", which can have values
  8757. * "create", "update", or "delete"
  8758. * @param {Object} properties An object with properties
  8759. */
  8760. Graph.prototype._createNode = function(properties) {
  8761. var action = properties.action ? properties.action : "update";
  8762. var id, index, newNode, oldNode;
  8763. if (action === "create") {
  8764. // create the node
  8765. newNode = new Node(properties, this.images, this.groups, this.constants);
  8766. id = properties.id;
  8767. index = (id !== undefined) ? this._findNode(id) : undefined;
  8768. if (index !== undefined) {
  8769. // replace node
  8770. oldNode = this.nodes[index];
  8771. this.nodes[index] = newNode;
  8772. // remove selection of old node
  8773. if (oldNode.selected) {
  8774. this._unselectNodes([{'row': index}], false);
  8775. }
  8776. /* TODO: implement this? -> will give performance issues, searching all edges and nodes...
  8777. // update edges linking to this node
  8778. var edgesTable = this.edges;
  8779. for (var i = 0, iMax = edgesTable.length; i < iMax; i++) {
  8780. var edge = edgesTable[i];
  8781. if (edge.from == oldNode) {
  8782. edge.from = newNode;
  8783. }
  8784. if (edge.to == oldNode) {
  8785. edge.to = newNode;
  8786. }
  8787. }
  8788. */
  8789. }
  8790. else {
  8791. // add new node
  8792. this.nodes.push(newNode);
  8793. }
  8794. if (!newNode.isFixed()) {
  8795. // note: no not use node.isMoving() here, as that gives the current
  8796. // velocity of the node, which is zero after creation of the node.
  8797. this.moving = true;
  8798. }
  8799. }
  8800. else if (action === "update") {
  8801. // update existing node, or create it when not yet existing
  8802. id = properties.id;
  8803. if (id === undefined) {
  8804. throw "Cannot update a node without id";
  8805. }
  8806. index = this._findNode(id);
  8807. if (index !== undefined) {
  8808. // update node
  8809. this.nodes[index].setProperties(properties, this.constants);
  8810. }
  8811. else {
  8812. // create node
  8813. newNode = new Node(properties, this.images, this.groups, this.constants);
  8814. this.nodes.push(newNode);
  8815. if (!newNode.isFixed()) {
  8816. // note: no not use node.isMoving() here, as that gives the current
  8817. // velocity of the node, which is zero after creation of the node.
  8818. this.moving = true;
  8819. }
  8820. }
  8821. }
  8822. else if (action === "delete") {
  8823. // delete existing node
  8824. id = properties.id;
  8825. if (id === undefined) {
  8826. throw "Cannot delete node without its id";
  8827. }
  8828. index = this._findNode(id);
  8829. if (index !== undefined) {
  8830. oldNode = this.nodes[index];
  8831. // remove selection of old node
  8832. if (oldNode.selected) {
  8833. this._unselectNodes([{'row': index}], false);
  8834. }
  8835. this.nodes.splice(index, 1);
  8836. }
  8837. else {
  8838. throw "Node with id " + id + " not found";
  8839. }
  8840. }
  8841. else {
  8842. throw "Unknown action " + action + ". Choose 'create', 'update', or 'delete'.";
  8843. }
  8844. };
  8845. /**
  8846. * Find a node by its id
  8847. * @param {Number} id Id of the node
  8848. * @return {Number} index Index of the node in the array this.nodes, or
  8849. * undefined when not found. *
  8850. */
  8851. Graph.prototype._findNode = function (id) {
  8852. var nodes = this.nodes;
  8853. for (var n = 0, len = nodes.length; n < len; n++) {
  8854. if (nodes[n].id === id) {
  8855. return n;
  8856. }
  8857. }
  8858. return undefined;
  8859. };
  8860. /**
  8861. * Find a node by its rowNumber
  8862. * @param {Number} row Row number of the node
  8863. * @return {Node} node     The node with the given row number, or
  8864. *                            undefined when not found.
  8865. */
  8866. Graph.prototype._findNodeByRow = function (row) {
  8867. return this.nodes[row];
  8868. };
  8869. /**
  8870. * Load edges by reading the data table
  8871. * @param {Array} edges The data containing the edges.
  8872. * @private
  8873. */
  8874. Graph.prototype._setEdges = function(edges) {
  8875. this.edges = [];
  8876. if (!edges) {
  8877. return;
  8878. }
  8879. var hasValues = false;
  8880. var rowCount = edges.length;
  8881. for (var i = 0; i < rowCount; i++) {
  8882. var properties = edges[i];
  8883. if (properties.from === undefined) {
  8884. throw "Column 'from' missing in table with edges (row " + i + ")";
  8885. }
  8886. if (properties.to === undefined) {
  8887. throw "Column 'to' missing in table with edges (row " + i + ")";
  8888. }
  8889. if (properties.value != undefined) {
  8890. hasValues = true;
  8891. }
  8892. this._createEdge(properties);
  8893. }
  8894. // calculate scaling function when value is provided
  8895. if (hasValues) {
  8896. this._updateValueRange(this.edges);
  8897. }
  8898. };
  8899. /**
  8900. * Create a edge with the given properties
  8901. * If the new edge has an id identical to an existing edge, the existing
  8902. * edge will be overwritten or updated.
  8903. * The properties can contain a property "action", which can have values
  8904. * "create", "update", or "delete"
  8905. * @param {Object} properties An object with properties
  8906. */
  8907. Graph.prototype._createEdge = function(properties) {
  8908. var action = properties.action ? properties.action : "create";
  8909. var id, index, edge, oldEdge, newEdge;
  8910. if (action === "create") {
  8911. // create the edge, or replace it if already existing
  8912. id = properties.id;
  8913. index = (id !== undefined) ? this._findEdge(id) : undefined;
  8914. edge = new Edge(properties, this, this.constants);
  8915. if (index !== undefined) {
  8916. // replace existing edge
  8917. oldEdge = this.edges[index];
  8918. oldEdge.from.detachEdge(oldEdge);
  8919. oldEdge.to.detachEdge(oldEdge);
  8920. this.edges[index] = edge;
  8921. }
  8922. else {
  8923. // add new edge
  8924. this.edges.push(edge);
  8925. }
  8926. edge.from.attachEdge(edge);
  8927. edge.to.attachEdge(edge);
  8928. }
  8929. else if (action === "update") {
  8930. // update existing edge, or create the edge if not existing
  8931. id = properties.id;
  8932. if (id === undefined) {
  8933. throw "Cannot update a edge without id";
  8934. }
  8935. index = this._findEdge(id);
  8936. if (index !== undefined) {
  8937. // update edge
  8938. edge = this.edges[index];
  8939. edge.from.detachEdge(edge);
  8940. edge.to.detachEdge(edge);
  8941. edge.setProperties(properties, this.constants);
  8942. edge.from.attachEdge(edge);
  8943. edge.to.attachEdge(edge);
  8944. }
  8945. else {
  8946. // add new edge
  8947. edge = new Edge(properties, this, this.constants);
  8948. edge.from.attachEdge(edge);
  8949. edge.to.attachEdge(edge);
  8950. this.edges.push(edge);
  8951. }
  8952. }
  8953. else if (action === "delete") {
  8954. // delete existing edge
  8955. id = properties.id;
  8956. if (id === undefined) {
  8957. throw "Cannot delete edge without its id";
  8958. }
  8959. index = this._findEdge(id);
  8960. if (index !== undefined) {
  8961. oldEdge = this.edges[id];
  8962. edge.from.detachEdge(oldEdge);
  8963. edge.to.detachEdge(oldEdge);
  8964. this.edges.splice(index, 1);
  8965. }
  8966. else {
  8967. throw "Edge with id " + id + " not found";
  8968. }
  8969. }
  8970. else {
  8971. throw "Unknown action " + action + ". Choose 'create', 'update', or 'delete'.";
  8972. }
  8973. };
  8974. /**
  8975. * Update the references to oldNode in all edges.
  8976. * @param {Node} oldNode
  8977. * @param {Node} newNode
  8978. */
  8979. // TODO: start utilizing this method _updateNodeReferences
  8980. Graph.prototype._updateNodeReferences = function(oldNode, newNode) {
  8981. var edges = this.edges;
  8982. for (var i = 0, iMax = edges.length; i < iMax; i++) {
  8983. var edge = edges[i];
  8984. if (edge.from === oldNode) {
  8985. edge.from = newNode;
  8986. }
  8987. if (edge.to === oldNode) {
  8988. edge.to = newNode;
  8989. }
  8990. }
  8991. };
  8992. /**
  8993. * Find a edge by its id
  8994. * @param {Number} id Id of the edge
  8995. * @return {Number} index Index of the edge in the array this.edges, or
  8996. * undefined when not found. *
  8997. */
  8998. Graph.prototype._findEdge = function (id) {
  8999. var edges = this.edges;
  9000. for (var n = 0, len = edges.length; n < len; n++) {
  9001. if (edges[n].id === id) {
  9002. return n;
  9003. }
  9004. }
  9005. return undefined;
  9006. };
  9007. /**
  9008. * Find a edge by its row
  9009. * @param {Number} row Row of the edge
  9010. * @return {Edge} the found edge, or undefined when not found
  9011. */
  9012. Graph.prototype._findEdgeByRow = function (row) {
  9013. return this.edges[row];
  9014. };
  9015. /**
  9016. * Update the values of all object in the given array according to the current
  9017. * value range of the objects in the array.
  9018. * @param {Array} array. An array with objects like Edges or Nodes
  9019. * The objects must have a method getValue() and
  9020. * setValueRange(min, max).
  9021. */
  9022. Graph.prototype._updateValueRange = function(array) {
  9023. var count = array.length;
  9024. var i;
  9025. // determine the range of the node values
  9026. var valueMin = undefined;
  9027. var valueMax = undefined;
  9028. for (i = 0; i < count; i++) {
  9029. var value = array[i].getValue();
  9030. if (value !== undefined) {
  9031. valueMin = (valueMin === undefined) ? value : Math.min(value, valueMin);
  9032. valueMax = (valueMax === undefined) ? value : Math.max(value, valueMax);
  9033. }
  9034. }
  9035. // adjust the range of all nodes
  9036. if (valueMin !== undefined && valueMax !== undefined) {
  9037. for (i = 0; i < count; i++) {
  9038. array[i].setValueRange(valueMin, valueMax);
  9039. }
  9040. }
  9041. };
  9042. /**
  9043. * Redraw the graph with the current data
  9044. * chart will be resized too.
  9045. */
  9046. Graph.prototype.redraw = function() {
  9047. this._setSize(this.width, this.height);
  9048. this._redraw();
  9049. };
  9050. /**
  9051. * Redraw the graph with the current data
  9052. */
  9053. Graph.prototype._redraw = function() {
  9054. var ctx = this.frame.canvas.getContext("2d");
  9055. // clear the canvas
  9056. var w = this.frame.canvas.width;
  9057. var h = this.frame.canvas.height;
  9058. ctx.clearRect(0, 0, w, h);
  9059. // set scaling and translation
  9060. ctx.save();
  9061. ctx.translate(this.translation.x, this.translation.y);
  9062. ctx.scale(this.scale, this.scale);
  9063. this._drawEdges(ctx);
  9064. this._drawNodes(ctx);
  9065. // restore original scaling and translation
  9066. ctx.restore();
  9067. };
  9068. /**
  9069. * Set the translation of the graph
  9070. * @param {Number} offsetX Horizontal offset
  9071. * @param {Number} offsetY Vertical offset
  9072. */
  9073. Graph.prototype._setTranslation = function(offsetX, offsetY) {
  9074. if (this.translation === undefined) {
  9075. this.translation = {
  9076. "x": 0,
  9077. "y": 0
  9078. };
  9079. }
  9080. if (offsetX !== undefined) {
  9081. this.translation.x = offsetX;
  9082. }
  9083. if (offsetY !== undefined) {
  9084. this.translation.y = offsetY;
  9085. }
  9086. };
  9087. /**
  9088. * Get the translation of the graph
  9089. * @return {Object} translation An object with parameters x and y, both a number
  9090. */
  9091. Graph.prototype._getTranslation = function() {
  9092. return {
  9093. "x": this.translation.x,
  9094. "y": this.translation.y
  9095. };
  9096. };
  9097. /**
  9098. * Scale the graph
  9099. * @param {Number} scale Scaling factor 1.0 is unscaled
  9100. */
  9101. Graph.prototype._setScale = function(scale) {
  9102. this.scale = scale;
  9103. };
  9104. /**
  9105. * Get the current scale of the graph
  9106. * @return {Number} scale Scaling factor 1.0 is unscaled
  9107. */
  9108. Graph.prototype._getScale = function() {
  9109. return this.scale;
  9110. };
  9111. Graph.prototype._xToCanvas = function(x) {
  9112. return (x - this.translation.x) / this.scale;
  9113. };
  9114. Graph.prototype._canvasToX = function(x) {
  9115. return x * this.scale + this.translation.x;
  9116. };
  9117. Graph.prototype._yToCanvas = function(y) {
  9118. return (y - this.translation.y) / this.scale;
  9119. };
  9120. Graph.prototype._canvasToY = function(y) {
  9121. return y * this.scale + this.translation.y ;
  9122. };
  9123. /**
  9124. * Get a node by its id
  9125. * @param {number} id
  9126. * @return {Node} node, or null if not found
  9127. */
  9128. Graph.prototype._getNode = function(id) {
  9129. for (var i = 0; i < this.nodes.length; i++) {
  9130. if (this.nodes[i].id == id)
  9131. return this.nodes[i];
  9132. }
  9133. return null;
  9134. };
  9135. /**
  9136. * Redraw all nodes
  9137. * The 2d context of a HTML canvas can be retrieved by canvas.getContext("2d");
  9138. * @param {CanvasRenderingContext2D} ctx
  9139. */
  9140. Graph.prototype._drawNodes = function(ctx) {
  9141. // first draw the unselected nodes
  9142. var nodes = this.nodes;
  9143. var selected = [];
  9144. for (var i = 0, iMax = nodes.length; i < iMax; i++) {
  9145. if (nodes[i].isSelected()) {
  9146. selected.push(i);
  9147. }
  9148. else {
  9149. nodes[i].draw(ctx);
  9150. }
  9151. }
  9152. // draw the selected nodes on top
  9153. for (var s = 0, sMax = selected.length; s < sMax; s++) {
  9154. nodes[selected[s]].draw(ctx);
  9155. }
  9156. };
  9157. /**
  9158. * Redraw all edges
  9159. * The 2d context of a HTML canvas can be retrieved by canvas.getContext("2d");
  9160. * @param {CanvasRenderingContext2D} ctx
  9161. */
  9162. Graph.prototype._drawEdges = function(ctx) {
  9163. var edges = this.edges;
  9164. for (var i = 0, iMax = edges.length; i < iMax; i++) {
  9165. edges[i].draw(ctx);
  9166. }
  9167. };
  9168. /**
  9169. * Recalculate the best positions for all nodes
  9170. */
  9171. Graph.prototype._reposition = function() {
  9172. // TODO: implement function reposition
  9173. /*
  9174. var w = this.frame.canvas.clientWidth;
  9175. var h = this.frame.canvas.clientHeight;
  9176. for (var i = 0; i < this.nodes.length; i++) {
  9177. if (!this.nodes[i].xFixed) this.nodes[i].x = w * Math.random();
  9178. if (!this.nodes[i].yFixed) this.nodes[i].y = h * Math.random();
  9179. }
  9180. //*/
  9181. //*
  9182. // TODO
  9183. var radius = this.constants.edges.length * 2;
  9184. var cx = this.frame.canvas.clientWidth / 2;
  9185. var cy = this.frame.canvas.clientHeight / 2;
  9186. for (var i = 0; i < this.nodes.length; i++) {
  9187. var angle = 2*Math.PI * (i / this.nodes.length);
  9188. if (!this.nodes[i].xFixed) this.nodes[i].x = cx + radius * Math.cos(angle);
  9189. if (!this.nodes[i].yFixed) this.nodes[i].y = cy + radius * Math.sin(angle);
  9190. }
  9191. //*/
  9192. /*
  9193. // TODO
  9194. var radius = this.constants.edges.length * 2;
  9195. var w = this.frame.canvas.clientWidth,
  9196. h = this.frame.canvas.clientHeight;
  9197. var cx = this.frame.canvas.clientWidth / 2;
  9198. var cy = this.frame.canvas.clientHeight / 2;
  9199. var s = Math.sqrt(this.nodes.length);
  9200. for (var i = 0; i < this.nodes.length; i++) {
  9201. //var angle = 2*Math.PI * (i / this.nodes.length);
  9202. if (!this.nodes[i].xFixed) this.nodes[i].x = w/s * (i % s);
  9203. if (!this.nodes[i].yFixed) this.nodes[i].y = h/s * (i / s);
  9204. }
  9205. //*/
  9206. /*
  9207. var cx = this.frame.canvas.clientWidth / 2;
  9208. var cy = this.frame.canvas.clientHeight / 2;
  9209. for (var i = 0; i < this.nodes.length; i++) {
  9210. this.nodes[i].x = cx;
  9211. this.nodes[i].y = cy;
  9212. }
  9213. //*/
  9214. };
  9215. /**
  9216. * Find a stable position for all nodes
  9217. */
  9218. Graph.prototype._doStabilize = function() {
  9219. var start = new Date();
  9220. // find stable position
  9221. var count = 0;
  9222. var vmin = this.constants.minVelocity;
  9223. var stable = false;
  9224. while (!stable && count < this.constants.maxIterations) {
  9225. this._calculateForces();
  9226. this._discreteStepNodes();
  9227. stable = !this._isMoving(vmin);
  9228. count++;
  9229. }
  9230. var end = new Date();
  9231. // console.log("Stabilized in " + (end-start) + " ms, " + count + " iterations" ); // TODO: cleanup
  9232. };
  9233. /**
  9234. * Calculate the external forces acting on the nodes
  9235. * Forces are caused by: edges, repulsing forces between nodes, gravity
  9236. */
  9237. Graph.prototype._calculateForces = function(nodeId) {
  9238. // create a local edge to the nodes and edges, that is faster
  9239. var nodes = this.nodes,
  9240. edges = this.edges;
  9241. // gravity, add a small constant force to pull the nodes towards the center of
  9242. // the graph
  9243. // Also, the forces are reset to zero in this loop by using _setForce instead
  9244. // of _addForce
  9245. var gravity = 0.01,
  9246. gx = this.frame.canvas.clientWidth / 2,
  9247. gy = this.frame.canvas.clientHeight / 2;
  9248. for (var n = 0; n < nodes.length; n++) {
  9249. var dx = gx - nodes[n].x,
  9250. dy = gy - nodes[n].y,
  9251. angle = Math.atan2(dy, dx),
  9252. fx = Math.cos(angle) * gravity,
  9253. fy = Math.sin(angle) * gravity;
  9254. this.nodes[n]._setForce(fx, fy);
  9255. }
  9256. // repulsing forces between nodes
  9257. var minimumDistance = this.constants.nodes.distance,
  9258. steepness = 10; // higher value gives steeper slope of the force around the given minimumDistance
  9259. for (var n = 0; n < nodes.length; n++) {
  9260. for (var n2 = n + 1; n2 < this.nodes.length; n2++) {
  9261. //var dmin = (nodes[n].width + nodes[n].height + nodes[n2].width + nodes[n2].height) / 1 || minimumDistance, // TODO: dmin
  9262. //var dmin = (nodes[n].width + nodes[n2].width)/2 || minimumDistance, // TODO: dmin
  9263. //dmin = 40 + ((nodes[n].width/2 + nodes[n2].width/2) || 0),
  9264. // calculate normally distributed force
  9265. var dx = nodes[n2].x - nodes[n].x,
  9266. dy = nodes[n2].y - nodes[n].y,
  9267. distance = Math.sqrt(dx * dx + dy * dy),
  9268. angle = Math.atan2(dy, dx),
  9269. // TODO: correct factor for repulsing force
  9270. //var repulsingforce = 2 * Math.exp(-5 * (distance * distance) / (dmin * dmin) ); // TODO: customize the repulsing force
  9271. //repulsingforce = Math.exp(-1 * (distance * distance) / (dmin * dmin) ), // TODO: customize the repulsing force
  9272. repulsingforce = 1 / (1 + Math.exp((distance / minimumDistance - 1) * steepness)), // TODO: customize the repulsing force
  9273. fx = Math.cos(angle) * repulsingforce,
  9274. fy = Math.sin(angle) * repulsingforce;
  9275. this.nodes[n]._addForce(-fx, -fy);
  9276. this.nodes[n2]._addForce(fx, fy);
  9277. }
  9278. /* TODO: re-implement repulsion of edges
  9279. for (var l = 0; l < edges.length; l++) {
  9280. var lx = edges[l].from.x+(edges[l].to.x - edges[l].from.x)/2,
  9281. ly = edges[l].from.y+(edges[l].to.y - edges[l].from.y)/2,
  9282. // calculate normally distributed force
  9283. dx = nodes[n].x - lx,
  9284. dy = nodes[n].y - ly,
  9285. distance = Math.sqrt(dx * dx + dy * dy),
  9286. angle = Math.atan2(dy, dx),
  9287. // TODO: correct factor for repulsing force
  9288. //var repulsingforce = 2 * Math.exp(-5 * (distance * distance) / (dmin * dmin) ); // TODO: customize the repulsing force
  9289. //repulsingforce = Math.exp(-1 * (distance * distance) / (dmin * dmin) ), // TODO: customize the repulsing force
  9290. repulsingforce = 1 / (1 + Math.exp((distance / (minimumDistance / 2) - 1) * steepness)), // TODO: customize the repulsing force
  9291. fx = Math.cos(angle) * repulsingforce,
  9292. fy = Math.sin(angle) * repulsingforce;
  9293. nodes[n]._addForce(fx, fy);
  9294. edges[l].from._addForce(-fx/2,-fy/2);
  9295. edges[l].to._addForce(-fx/2,-fy/2);
  9296. }
  9297. */
  9298. }
  9299. // forces caused by the edges, modelled as springs
  9300. for (var l = 0, lMax = edges.length; l < lMax; l++) {
  9301. var edge = edges[l],
  9302. dx = (edge.to.x - edge.from.x),
  9303. dy = (edge.to.y - edge.from.y),
  9304. //edgeLength = (edge.from.width + edge.from.height + edge.to.width + edge.to.height)/2 || edge.length, // TODO: dmin
  9305. //edgeLength = (edge.from.width + edge.to.width)/2 || edge.length, // TODO: dmin
  9306. //edgeLength = 20 + ((edge.from.width + edge.to.width) || 0) / 2,
  9307. edgeLength = edge.length,
  9308. length = Math.sqrt(dx * dx + dy * dy),
  9309. angle = Math.atan2(dy, dx),
  9310. springforce = edge.stiffness * (edgeLength - length),
  9311. fx = Math.cos(angle) * springforce,
  9312. fy = Math.sin(angle) * springforce;
  9313. edge.from._addForce(-fx, -fy);
  9314. edge.to._addForce(fx, fy);
  9315. }
  9316. /* TODO: re-implement repulsion of edges
  9317. // repulsing forces between edges
  9318. var minimumDistance = this.constants.edges.distance,
  9319. steepness = 10; // higher value gives steeper slope of the force around the given minimumDistance
  9320. for (var l = 0; l < edges.length; l++) {
  9321. //Keep distance from other edge centers
  9322. for (var l2 = l + 1; l2 < this.edges.length; l2++) {
  9323. //var dmin = (nodes[n].width + nodes[n].height + nodes[n2].width + nodes[n2].height) / 1 || minimumDistance, // TODO: dmin
  9324. //var dmin = (nodes[n].width + nodes[n2].width)/2 || minimumDistance, // TODO: dmin
  9325. //dmin = 40 + ((nodes[n].width/2 + nodes[n2].width/2) || 0),
  9326. var lx = edges[l].from.x+(edges[l].to.x - edges[l].from.x)/2,
  9327. ly = edges[l].from.y+(edges[l].to.y - edges[l].from.y)/2,
  9328. l2x = edges[l2].from.x+(edges[l2].to.x - edges[l2].from.x)/2,
  9329. l2y = edges[l2].from.y+(edges[l2].to.y - edges[l2].from.y)/2,
  9330. // calculate normally distributed force
  9331. dx = l2x - lx,
  9332. dy = l2y - ly,
  9333. distance = Math.sqrt(dx * dx + dy * dy),
  9334. angle = Math.atan2(dy, dx),
  9335. // TODO: correct factor for repulsing force
  9336. //var repulsingforce = 2 * Math.exp(-5 * (distance * distance) / (dmin * dmin) ); // TODO: customize the repulsing force
  9337. //repulsingforce = Math.exp(-1 * (distance * distance) / (dmin * dmin) ), // TODO: customize the repulsing force
  9338. repulsingforce = 1 / (1 + Math.exp((distance / minimumDistance - 1) * steepness)), // TODO: customize the repulsing force
  9339. fx = Math.cos(angle) * repulsingforce,
  9340. fy = Math.sin(angle) * repulsingforce;
  9341. edges[l].from._addForce(-fx, -fy);
  9342. edges[l].to._addForce(-fx, -fy);
  9343. edges[l2].from._addForce(fx, fy);
  9344. edges[l2].to._addForce(fx, fy);
  9345. }
  9346. }
  9347. */
  9348. };
  9349. /**
  9350. * Check if any of the nodes is still moving
  9351. * @param {number} vmin the minimum velocity considered as "moving"
  9352. * @return {boolean} true if moving, false if non of the nodes is moving
  9353. */
  9354. Graph.prototype._isMoving = function(vmin) {
  9355. // TODO: ismoving does not work well: should check the kinetic energy, not its velocity
  9356. var nodes = this.nodes;
  9357. for (var n = 0, nMax = nodes.length; n < nMax; n++) {
  9358. if (nodes[n].isMoving(vmin)) {
  9359. return true;
  9360. }
  9361. }
  9362. return false;
  9363. };
  9364. /**
  9365. * Perform one discrete step for all nodes
  9366. */
  9367. Graph.prototype._discreteStepNodes = function() {
  9368. var interval = this.refreshRate / 1000.0; // in seconds
  9369. var nodes = this.nodes;
  9370. for (var n = 0, nMax = nodes.length; n < nMax; n++) {
  9371. nodes[n].discreteStep(interval);
  9372. }
  9373. };
  9374. /**
  9375. * Start animating nodes and edges
  9376. */
  9377. Graph.prototype.start = function() {
  9378. if (this.moving) {
  9379. this._calculateForces();
  9380. this._discreteStepNodes();
  9381. var vmin = this.constants.minVelocity;
  9382. this.moving = this._isMoving(vmin);
  9383. }
  9384. if (this.moving) {
  9385. // start animation. only start timer if it is not already running
  9386. if (!this.timer) {
  9387. var graph = this;
  9388. this.timer = window.setTimeout(function () {
  9389. graph.timer = undefined;
  9390. graph.start();
  9391. graph._redraw();
  9392. }, this.refreshRate);
  9393. }
  9394. }
  9395. else {
  9396. this._redraw();
  9397. }
  9398. };
  9399. /**
  9400. * Stop animating nodes and edges.
  9401. */
  9402. Graph.prototype.stop = function () {
  9403. if (this.timer) {
  9404. window.clearInterval(this.timer);
  9405. this.timer = undefined;
  9406. }
  9407. };
  9408. /**
  9409. * vis.js module exports
  9410. */
  9411. var vis = {
  9412. util: util,
  9413. events: events,
  9414. Controller: Controller,
  9415. DataSet: DataSet,
  9416. DataView: DataView,
  9417. Range: Range,
  9418. Stack: Stack,
  9419. TimeStep: TimeStep,
  9420. EventBus: EventBus,
  9421. components: {
  9422. items: {
  9423. Item: Item,
  9424. ItemBox: ItemBox,
  9425. ItemPoint: ItemPoint,
  9426. ItemRange: ItemRange
  9427. },
  9428. Component: Component,
  9429. Panel: Panel,
  9430. RootPanel: RootPanel,
  9431. ItemSet: ItemSet,
  9432. TimeAxis: TimeAxis
  9433. },
  9434. graph: {
  9435. Node: Node,
  9436. Edge: Edge,
  9437. Popup: Popup,
  9438. Groups: Groups,
  9439. Images: Images
  9440. },
  9441. Timeline: Timeline,
  9442. Graph: Graph
  9443. };
  9444. /**
  9445. * CommonJS module exports
  9446. */
  9447. if (typeof exports !== 'undefined') {
  9448. exports = vis;
  9449. }
  9450. if (typeof module !== 'undefined' && typeof module.exports !== 'undefined') {
  9451. module.exports = vis;
  9452. }
  9453. /**
  9454. * AMD module exports
  9455. */
  9456. if (typeof(define) === 'function') {
  9457. define(function () {
  9458. return vis;
  9459. });
  9460. }
  9461. /**
  9462. * Window exports
  9463. */
  9464. if (typeof window !== 'undefined') {
  9465. // attach the module to the window, load as a regular javascript file
  9466. window['vis'] = vis;
  9467. }
  9468. // inject css
  9469. util.loadCss("/* vis.js stylesheet */\n\n.graph {\n position: relative;\n border: 1px solid #bfbfbf;\n}\n\n.graph .panel {\n position: absolute;\n}\n\n.graph .groupset {\n position: absolute;\n padding: 0;\n margin: 0;\n}\n\n\n.graph .itemset {\n position: absolute;\n padding: 0;\n margin: 0;\n overflow: hidden;\n}\n\n.graph .background {\n}\n\n.graph .foreground {\n}\n\n.graph .itemset-axis {\n position: absolute;\n}\n\n.graph .groupset .itemset-axis {\n border-top: 1px solid #bfbfbf;\n}\n\n/* TODO: with orientation=='bottom', this will more or less overlap with timeline axis\n.graph .groupset .itemset-axis:last-child {\n border-top: none;\n}\n*/\n\n\n.graph .item {\n position: absolute;\n color: #1A1A1A;\n border-color: #97B0F8;\n background-color: #D5DDF6;\n display: inline-block;\n}\n\n.graph .item.selected {\n border-color: #FFC200;\n background-color: #FFF785;\n z-index: 999;\n}\n\n.graph .item.cluster {\n /* TODO: use another color or pattern? */\n background: #97B0F8 url('img/cluster_bg.png');\n color: white;\n}\n.graph .item.cluster.point {\n border-color: #D5DDF6;\n}\n\n.graph .item.box {\n text-align: center;\n border-style: solid;\n border-width: 1px;\n border-radius: 5px;\n -moz-border-radius: 5px; /* For Firefox 3.6 and older */\n}\n\n.graph .item.point {\n background: none;\n}\n\n.graph .dot {\n border: 5px solid #97B0F8;\n position: absolute;\n border-radius: 5px;\n -moz-border-radius: 5px; /* For Firefox 3.6 and older */\n}\n\n.graph .item.range {\n overflow: hidden;\n border-style: solid;\n border-width: 1px;\n border-radius: 2px;\n -moz-border-radius: 2px; /* For Firefox 3.6 and older */\n}\n\n.graph .item.range .drag-left {\n cursor: w-resize;\n z-index: 1000;\n}\n\n.graph .item.range .drag-right {\n cursor: e-resize;\n z-index: 1000;\n}\n\n.graph .item.range .content {\n position: relative;\n display: inline-block;\n}\n\n.graph .item.line {\n position: absolute;\n width: 0;\n border-left-width: 1px;\n border-left-style: solid;\n}\n\n.graph .item .content {\n margin: 5px;\n white-space: nowrap;\n overflow: hidden;\n}\n\n/* TODO: better css name, 'graph' is way to generic */\n\n.graph {\n overflow: hidden;\n}\n\n.graph .axis {\n position: relative;\n}\n\n.graph .axis .text {\n position: absolute;\n color: #4d4d4d;\n padding: 3px;\n white-space: nowrap;\n}\n\n.graph .axis .text.measure {\n position: absolute;\n padding-left: 0;\n padding-right: 0;\n margin-left: 0;\n margin-right: 0;\n visibility: hidden;\n}\n\n.graph .axis .grid.vertical {\n position: absolute;\n width: 0;\n border-right: 1px solid;\n}\n\n.graph .axis .grid.horizontal {\n position: absolute;\n left: 0;\n width: 100%;\n height: 0;\n border-bottom: 1px solid;\n}\n\n.graph .axis .grid.minor {\n border-color: #e5e5e5;\n}\n\n.graph .axis .grid.major {\n border-color: #bfbfbf;\n}\n\n");
  9470. })()
  9471. },{"moment":2}],2:[function(require,module,exports){
  9472. (function(){// moment.js
  9473. // version : 2.0.0
  9474. // author : Tim Wood
  9475. // license : MIT
  9476. // momentjs.com
  9477. (function (undefined) {
  9478. /************************************
  9479. Constants
  9480. ************************************/
  9481. var moment,
  9482. VERSION = "2.0.0",
  9483. round = Math.round, i,
  9484. // internal storage for language config files
  9485. languages = {},
  9486. // check for nodeJS
  9487. hasModule = (typeof module !== 'undefined' && module.exports),
  9488. // ASP.NET json date format regex
  9489. aspNetJsonRegex = /^\/?Date\((\-?\d+)/i,
  9490. // format tokens
  9491. formattingTokens = /(\[[^\[]*\])|(\\)?(Mo|MM?M?M?|Do|DDDo|DD?D?D?|ddd?d?|do?|w[o|w]?|W[o|W]?|YYYYY|YYYY|YY|a|A|hh?|HH?|mm?|ss?|SS?S?|X|zz?|ZZ?|.)/g,
  9492. localFormattingTokens = /(\[[^\[]*\])|(\\)?(LT|LL?L?L?|l{1,4})/g,
  9493. // parsing tokens
  9494. parseMultipleFormatChunker = /([0-9a-zA-Z\u00A0-\uD7FF\uF900-\uFDCF\uFDF0-\uFFEF]+)/gi,
  9495. // parsing token regexes
  9496. parseTokenOneOrTwoDigits = /\d\d?/, // 0 - 99
  9497. parseTokenOneToThreeDigits = /\d{1,3}/, // 0 - 999
  9498. parseTokenThreeDigits = /\d{3}/, // 000 - 999
  9499. parseTokenFourDigits = /\d{1,4}/, // 0 - 9999
  9500. parseTokenSixDigits = /[+\-]?\d{1,6}/, // -999,999 - 999,999
  9501. parseTokenWord = /[0-9]*[a-z\u00A0-\u05FF\u0700-\uD7FF\uF900-\uFDCF\uFDF0-\uFFEF]+|[\u0600-\u06FF]+\s*?[\u0600-\u06FF]+/i, // any word (or two) characters or numbers including two word month in arabic.
  9502. parseTokenTimezone = /Z|[\+\-]\d\d:?\d\d/i, // +00:00 -00:00 +0000 -0000 or Z
  9503. parseTokenT = /T/i, // T (ISO seperator)
  9504. parseTokenTimestampMs = /[\+\-]?\d+(\.\d{1,3})?/, // 123456789 123456789.123
  9505. // preliminary iso regex
  9506. // 0000-00-00 + T + 00 or 00:00 or 00:00:00 or 00:00:00.000 + +00:00 or +0000
  9507. isoRegex = /^\s*\d{4}-\d\d-\d\d((T| )(\d\d(:\d\d(:\d\d(\.\d\d?\d?)?)?)?)?([\+\-]\d\d:?\d\d)?)?/,
  9508. isoFormat = 'YYYY-MM-DDTHH:mm:ssZ',
  9509. // iso time formats and regexes
  9510. isoTimes = [
  9511. ['HH:mm:ss.S', /(T| )\d\d:\d\d:\d\d\.\d{1,3}/],
  9512. ['HH:mm:ss', /(T| )\d\d:\d\d:\d\d/],
  9513. ['HH:mm', /(T| )\d\d:\d\d/],
  9514. ['HH', /(T| )\d\d/]
  9515. ],
  9516. // timezone chunker "+10:00" > ["10", "00"] or "-1530" > ["-15", "30"]
  9517. parseTimezoneChunker = /([\+\-]|\d\d)/gi,
  9518. // getter and setter names
  9519. proxyGettersAndSetters = 'Month|Date|Hours|Minutes|Seconds|Milliseconds'.split('|'),
  9520. unitMillisecondFactors = {
  9521. 'Milliseconds' : 1,
  9522. 'Seconds' : 1e3,
  9523. 'Minutes' : 6e4,
  9524. 'Hours' : 36e5,
  9525. 'Days' : 864e5,
  9526. 'Months' : 2592e6,
  9527. 'Years' : 31536e6
  9528. },
  9529. // format function strings
  9530. formatFunctions = {},
  9531. // tokens to ordinalize and pad
  9532. ordinalizeTokens = 'DDD w W M D d'.split(' '),
  9533. paddedTokens = 'M D H h m s w W'.split(' '),
  9534. formatTokenFunctions = {
  9535. M : function () {
  9536. return this.month() + 1;
  9537. },
  9538. MMM : function (format) {
  9539. return this.lang().monthsShort(this, format);
  9540. },
  9541. MMMM : function (format) {
  9542. return this.lang().months(this, format);
  9543. },
  9544. D : function () {
  9545. return this.date();
  9546. },
  9547. DDD : function () {
  9548. return this.dayOfYear();
  9549. },
  9550. d : function () {
  9551. return this.day();
  9552. },
  9553. dd : function (format) {
  9554. return this.lang().weekdaysMin(this, format);
  9555. },
  9556. ddd : function (format) {
  9557. return this.lang().weekdaysShort(this, format);
  9558. },
  9559. dddd : function (format) {
  9560. return this.lang().weekdays(this, format);
  9561. },
  9562. w : function () {
  9563. return this.week();
  9564. },
  9565. W : function () {
  9566. return this.isoWeek();
  9567. },
  9568. YY : function () {
  9569. return leftZeroFill(this.year() % 100, 2);
  9570. },
  9571. YYYY : function () {
  9572. return leftZeroFill(this.year(), 4);
  9573. },
  9574. YYYYY : function () {
  9575. return leftZeroFill(this.year(), 5);
  9576. },
  9577. a : function () {
  9578. return this.lang().meridiem(this.hours(), this.minutes(), true);
  9579. },
  9580. A : function () {
  9581. return this.lang().meridiem(this.hours(), this.minutes(), false);
  9582. },
  9583. H : function () {
  9584. return this.hours();
  9585. },
  9586. h : function () {
  9587. return this.hours() % 12 || 12;
  9588. },
  9589. m : function () {
  9590. return this.minutes();
  9591. },
  9592. s : function () {
  9593. return this.seconds();
  9594. },
  9595. S : function () {
  9596. return ~~(this.milliseconds() / 100);
  9597. },
  9598. SS : function () {
  9599. return leftZeroFill(~~(this.milliseconds() / 10), 2);
  9600. },
  9601. SSS : function () {
  9602. return leftZeroFill(this.milliseconds(), 3);
  9603. },
  9604. Z : function () {
  9605. var a = -this.zone(),
  9606. b = "+";
  9607. if (a < 0) {
  9608. a = -a;
  9609. b = "-";
  9610. }
  9611. return b + leftZeroFill(~~(a / 60), 2) + ":" + leftZeroFill(~~a % 60, 2);
  9612. },
  9613. ZZ : function () {
  9614. var a = -this.zone(),
  9615. b = "+";
  9616. if (a < 0) {
  9617. a = -a;
  9618. b = "-";
  9619. }
  9620. return b + leftZeroFill(~~(10 * a / 6), 4);
  9621. },
  9622. X : function () {
  9623. return this.unix();
  9624. }
  9625. };
  9626. function padToken(func, count) {
  9627. return function (a) {
  9628. return leftZeroFill(func.call(this, a), count);
  9629. };
  9630. }
  9631. function ordinalizeToken(func) {
  9632. return function (a) {
  9633. return this.lang().ordinal(func.call(this, a));
  9634. };
  9635. }
  9636. while (ordinalizeTokens.length) {
  9637. i = ordinalizeTokens.pop();
  9638. formatTokenFunctions[i + 'o'] = ordinalizeToken(formatTokenFunctions[i]);
  9639. }
  9640. while (paddedTokens.length) {
  9641. i = paddedTokens.pop();
  9642. formatTokenFunctions[i + i] = padToken(formatTokenFunctions[i], 2);
  9643. }
  9644. formatTokenFunctions.DDDD = padToken(formatTokenFunctions.DDD, 3);
  9645. /************************************
  9646. Constructors
  9647. ************************************/
  9648. function Language() {
  9649. }
  9650. // Moment prototype object
  9651. function Moment(config) {
  9652. extend(this, config);
  9653. }
  9654. // Duration Constructor
  9655. function Duration(duration) {
  9656. var data = this._data = {},
  9657. years = duration.years || duration.year || duration.y || 0,
  9658. months = duration.months || duration.month || duration.M || 0,
  9659. weeks = duration.weeks || duration.week || duration.w || 0,
  9660. days = duration.days || duration.day || duration.d || 0,
  9661. hours = duration.hours || duration.hour || duration.h || 0,
  9662. minutes = duration.minutes || duration.minute || duration.m || 0,
  9663. seconds = duration.seconds || duration.second || duration.s || 0,
  9664. milliseconds = duration.milliseconds || duration.millisecond || duration.ms || 0;
  9665. // representation for dateAddRemove
  9666. this._milliseconds = milliseconds +
  9667. seconds * 1e3 + // 1000
  9668. minutes * 6e4 + // 1000 * 60
  9669. hours * 36e5; // 1000 * 60 * 60
  9670. // Because of dateAddRemove treats 24 hours as different from a
  9671. // day when working around DST, we need to store them separately
  9672. this._days = days +
  9673. weeks * 7;
  9674. // It is impossible translate months into days without knowing
  9675. // which months you are are talking about, so we have to store
  9676. // it separately.
  9677. this._months = months +
  9678. years * 12;
  9679. // The following code bubbles up values, see the tests for
  9680. // examples of what that means.
  9681. data.milliseconds = milliseconds % 1000;
  9682. seconds += absRound(milliseconds / 1000);
  9683. data.seconds = seconds % 60;
  9684. minutes += absRound(seconds / 60);
  9685. data.minutes = minutes % 60;
  9686. hours += absRound(minutes / 60);
  9687. data.hours = hours % 24;
  9688. days += absRound(hours / 24);
  9689. days += weeks * 7;
  9690. data.days = days % 30;
  9691. months += absRound(days / 30);
  9692. data.months = months % 12;
  9693. years += absRound(months / 12);
  9694. data.years = years;
  9695. }
  9696. /************************************
  9697. Helpers
  9698. ************************************/
  9699. function extend(a, b) {
  9700. for (var i in b) {
  9701. if (b.hasOwnProperty(i)) {
  9702. a[i] = b[i];
  9703. }
  9704. }
  9705. return a;
  9706. }
  9707. function absRound(number) {
  9708. if (number < 0) {
  9709. return Math.ceil(number);
  9710. } else {
  9711. return Math.floor(number);
  9712. }
  9713. }
  9714. // left zero fill a number
  9715. // see http://jsperf.com/left-zero-filling for performance comparison
  9716. function leftZeroFill(number, targetLength) {
  9717. var output = number + '';
  9718. while (output.length < targetLength) {
  9719. output = '0' + output;
  9720. }
  9721. return output;
  9722. }
  9723. // helper function for _.addTime and _.subtractTime
  9724. function addOrSubtractDurationFromMoment(mom, duration, isAdding) {
  9725. var ms = duration._milliseconds,
  9726. d = duration._days,
  9727. M = duration._months,
  9728. currentDate;
  9729. if (ms) {
  9730. mom._d.setTime(+mom + ms * isAdding);
  9731. }
  9732. if (d) {
  9733. mom.date(mom.date() + d * isAdding);
  9734. }
  9735. if (M) {
  9736. currentDate = mom.date();
  9737. mom.date(1)
  9738. .month(mom.month() + M * isAdding)
  9739. .date(Math.min(currentDate, mom.daysInMonth()));
  9740. }
  9741. }
  9742. // check if is an array
  9743. function isArray(input) {
  9744. return Object.prototype.toString.call(input) === '[object Array]';
  9745. }
  9746. // compare two arrays, return the number of differences
  9747. function compareArrays(array1, array2) {
  9748. var len = Math.min(array1.length, array2.length),
  9749. lengthDiff = Math.abs(array1.length - array2.length),
  9750. diffs = 0,
  9751. i;
  9752. for (i = 0; i < len; i++) {
  9753. if (~~array1[i] !== ~~array2[i]) {
  9754. diffs++;
  9755. }
  9756. }
  9757. return diffs + lengthDiff;
  9758. }
  9759. /************************************
  9760. Languages
  9761. ************************************/
  9762. Language.prototype = {
  9763. set : function (config) {
  9764. var prop, i;
  9765. for (i in config) {
  9766. prop = config[i];
  9767. if (typeof prop === 'function') {
  9768. this[i] = prop;
  9769. } else {
  9770. this['_' + i] = prop;
  9771. }
  9772. }
  9773. },
  9774. _months : "January_February_March_April_May_June_July_August_September_October_November_December".split("_"),
  9775. months : function (m) {
  9776. return this._months[m.month()];
  9777. },
  9778. _monthsShort : "Jan_Feb_Mar_Apr_May_Jun_Jul_Aug_Sep_Oct_Nov_Dec".split("_"),
  9779. monthsShort : function (m) {
  9780. return this._monthsShort[m.month()];
  9781. },
  9782. monthsParse : function (monthName) {
  9783. var i, mom, regex, output;
  9784. if (!this._monthsParse) {
  9785. this._monthsParse = [];
  9786. }
  9787. for (i = 0; i < 12; i++) {
  9788. // make the regex if we don't have it already
  9789. if (!this._monthsParse[i]) {
  9790. mom = moment([2000, i]);
  9791. regex = '^' + this.months(mom, '') + '|^' + this.monthsShort(mom, '');
  9792. this._monthsParse[i] = new RegExp(regex.replace('.', ''), 'i');
  9793. }
  9794. // test the regex
  9795. if (this._monthsParse[i].test(monthName)) {
  9796. return i;
  9797. }
  9798. }
  9799. },
  9800. _weekdays : "Sunday_Monday_Tuesday_Wednesday_Thursday_Friday_Saturday".split("_"),
  9801. weekdays : function (m) {
  9802. return this._weekdays[m.day()];
  9803. },
  9804. _weekdaysShort : "Sun_Mon_Tue_Wed_Thu_Fri_Sat".split("_"),
  9805. weekdaysShort : function (m) {
  9806. return this._weekdaysShort[m.day()];
  9807. },
  9808. _weekdaysMin : "Su_Mo_Tu_We_Th_Fr_Sa".split("_"),
  9809. weekdaysMin : function (m) {
  9810. return this._weekdaysMin[m.day()];
  9811. },
  9812. _longDateFormat : {
  9813. LT : "h:mm A",
  9814. L : "MM/DD/YYYY",
  9815. LL : "MMMM D YYYY",
  9816. LLL : "MMMM D YYYY LT",
  9817. LLLL : "dddd, MMMM D YYYY LT"
  9818. },
  9819. longDateFormat : function (key) {
  9820. var output = this._longDateFormat[key];
  9821. if (!output && this._longDateFormat[key.toUpperCase()]) {
  9822. output = this._longDateFormat[key.toUpperCase()].replace(/MMMM|MM|DD|dddd/g, function (val) {
  9823. return val.slice(1);
  9824. });
  9825. this._longDateFormat[key] = output;
  9826. }
  9827. return output;
  9828. },
  9829. meridiem : function (hours, minutes, isLower) {
  9830. if (hours > 11) {
  9831. return isLower ? 'pm' : 'PM';
  9832. } else {
  9833. return isLower ? 'am' : 'AM';
  9834. }
  9835. },
  9836. _calendar : {
  9837. sameDay : '[Today at] LT',
  9838. nextDay : '[Tomorrow at] LT',
  9839. nextWeek : 'dddd [at] LT',
  9840. lastDay : '[Yesterday at] LT',
  9841. lastWeek : '[last] dddd [at] LT',
  9842. sameElse : 'L'
  9843. },
  9844. calendar : function (key, mom) {
  9845. var output = this._calendar[key];
  9846. return typeof output === 'function' ? output.apply(mom) : output;
  9847. },
  9848. _relativeTime : {
  9849. future : "in %s",
  9850. past : "%s ago",
  9851. s : "a few seconds",
  9852. m : "a minute",
  9853. mm : "%d minutes",
  9854. h : "an hour",
  9855. hh : "%d hours",
  9856. d : "a day",
  9857. dd : "%d days",
  9858. M : "a month",
  9859. MM : "%d months",
  9860. y : "a year",
  9861. yy : "%d years"
  9862. },
  9863. relativeTime : function (number, withoutSuffix, string, isFuture) {
  9864. var output = this._relativeTime[string];
  9865. return (typeof output === 'function') ?
  9866. output(number, withoutSuffix, string, isFuture) :
  9867. output.replace(/%d/i, number);
  9868. },
  9869. pastFuture : function (diff, output) {
  9870. var format = this._relativeTime[diff > 0 ? 'future' : 'past'];
  9871. return typeof format === 'function' ? format(output) : format.replace(/%s/i, output);
  9872. },
  9873. ordinal : function (number) {
  9874. return this._ordinal.replace("%d", number);
  9875. },
  9876. _ordinal : "%d",
  9877. preparse : function (string) {
  9878. return string;
  9879. },
  9880. postformat : function (string) {
  9881. return string;
  9882. },
  9883. week : function (mom) {
  9884. return weekOfYear(mom, this._week.dow, this._week.doy);
  9885. },
  9886. _week : {
  9887. dow : 0, // Sunday is the first day of the week.
  9888. doy : 6 // The week that contains Jan 1st is the first week of the year.
  9889. }
  9890. };
  9891. // Loads a language definition into the `languages` cache. The function
  9892. // takes a key and optionally values. If not in the browser and no values
  9893. // are provided, it will load the language file module. As a convenience,
  9894. // this function also returns the language values.
  9895. function loadLang(key, values) {
  9896. values.abbr = key;
  9897. if (!languages[key]) {
  9898. languages[key] = new Language();
  9899. }
  9900. languages[key].set(values);
  9901. return languages[key];
  9902. }
  9903. // Determines which language definition to use and returns it.
  9904. //
  9905. // With no parameters, it will return the global language. If you
  9906. // pass in a language key, such as 'en', it will return the
  9907. // definition for 'en', so long as 'en' has already been loaded using
  9908. // moment.lang.
  9909. function getLangDefinition(key) {
  9910. if (!key) {
  9911. return moment.fn._lang;
  9912. }
  9913. if (!languages[key] && hasModule) {
  9914. require('./lang/' + key);
  9915. }
  9916. return languages[key];
  9917. }
  9918. /************************************
  9919. Formatting
  9920. ************************************/
  9921. function removeFormattingTokens(input) {
  9922. if (input.match(/\[.*\]/)) {
  9923. return input.replace(/^\[|\]$/g, "");
  9924. }
  9925. return input.replace(/\\/g, "");
  9926. }
  9927. function makeFormatFunction(format) {
  9928. var array = format.match(formattingTokens), i, length;
  9929. for (i = 0, length = array.length; i < length; i++) {
  9930. if (formatTokenFunctions[array[i]]) {
  9931. array[i] = formatTokenFunctions[array[i]];
  9932. } else {
  9933. array[i] = removeFormattingTokens(array[i]);
  9934. }
  9935. }
  9936. return function (mom) {
  9937. var output = "";
  9938. for (i = 0; i < length; i++) {
  9939. output += typeof array[i].call === 'function' ? array[i].call(mom, format) : array[i];
  9940. }
  9941. return output;
  9942. };
  9943. }
  9944. // format date using native date object
  9945. function formatMoment(m, format) {
  9946. var i = 5;
  9947. function replaceLongDateFormatTokens(input) {
  9948. return m.lang().longDateFormat(input) || input;
  9949. }
  9950. while (i-- && localFormattingTokens.test(format)) {
  9951. format = format.replace(localFormattingTokens, replaceLongDateFormatTokens);
  9952. }
  9953. if (!formatFunctions[format]) {
  9954. formatFunctions[format] = makeFormatFunction(format);
  9955. }
  9956. return formatFunctions[format](m);
  9957. }
  9958. /************************************
  9959. Parsing
  9960. ************************************/
  9961. // get the regex to find the next token
  9962. function getParseRegexForToken(token) {
  9963. switch (token) {
  9964. case 'DDDD':
  9965. return parseTokenThreeDigits;
  9966. case 'YYYY':
  9967. return parseTokenFourDigits;
  9968. case 'YYYYY':
  9969. return parseTokenSixDigits;
  9970. case 'S':
  9971. case 'SS':
  9972. case 'SSS':
  9973. case 'DDD':
  9974. return parseTokenOneToThreeDigits;
  9975. case 'MMM':
  9976. case 'MMMM':
  9977. case 'dd':
  9978. case 'ddd':
  9979. case 'dddd':
  9980. case 'a':
  9981. case 'A':
  9982. return parseTokenWord;
  9983. case 'X':
  9984. return parseTokenTimestampMs;
  9985. case 'Z':
  9986. case 'ZZ':
  9987. return parseTokenTimezone;
  9988. case 'T':
  9989. return parseTokenT;
  9990. case 'MM':
  9991. case 'DD':
  9992. case 'YY':
  9993. case 'HH':
  9994. case 'hh':
  9995. case 'mm':
  9996. case 'ss':
  9997. case 'M':
  9998. case 'D':
  9999. case 'd':
  10000. case 'H':
  10001. case 'h':
  10002. case 'm':
  10003. case 's':
  10004. return parseTokenOneOrTwoDigits;
  10005. default :
  10006. return new RegExp(token.replace('\\', ''));
  10007. }
  10008. }
  10009. // function to convert string input to date
  10010. function addTimeToArrayFromToken(token, input, config) {
  10011. var a, b,
  10012. datePartArray = config._a;
  10013. switch (token) {
  10014. // MONTH
  10015. case 'M' : // fall through to MM
  10016. case 'MM' :
  10017. datePartArray[1] = (input == null) ? 0 : ~~input - 1;
  10018. break;
  10019. case 'MMM' : // fall through to MMMM
  10020. case 'MMMM' :
  10021. a = getLangDefinition(config._l).monthsParse(input);
  10022. // if we didn't find a month name, mark the date as invalid.
  10023. if (a != null) {
  10024. datePartArray[1] = a;
  10025. } else {
  10026. config._isValid = false;
  10027. }
  10028. break;
  10029. // DAY OF MONTH
  10030. case 'D' : // fall through to DDDD
  10031. case 'DD' : // fall through to DDDD
  10032. case 'DDD' : // fall through to DDDD
  10033. case 'DDDD' :
  10034. if (input != null) {
  10035. datePartArray[2] = ~~input;
  10036. }
  10037. break;
  10038. // YEAR
  10039. case 'YY' :
  10040. datePartArray[0] = ~~input + (~~input > 68 ? 1900 : 2000);
  10041. break;
  10042. case 'YYYY' :
  10043. case 'YYYYY' :
  10044. datePartArray[0] = ~~input;
  10045. break;
  10046. // AM / PM
  10047. case 'a' : // fall through to A
  10048. case 'A' :
  10049. config._isPm = ((input + '').toLowerCase() === 'pm');
  10050. break;
  10051. // 24 HOUR
  10052. case 'H' : // fall through to hh
  10053. case 'HH' : // fall through to hh
  10054. case 'h' : // fall through to hh
  10055. case 'hh' :
  10056. datePartArray[3] = ~~input;
  10057. break;
  10058. // MINUTE
  10059. case 'm' : // fall through to mm
  10060. case 'mm' :
  10061. datePartArray[4] = ~~input;
  10062. break;
  10063. // SECOND
  10064. case 's' : // fall through to ss
  10065. case 'ss' :
  10066. datePartArray[5] = ~~input;
  10067. break;
  10068. // MILLISECOND
  10069. case 'S' :
  10070. case 'SS' :
  10071. case 'SSS' :
  10072. datePartArray[6] = ~~ (('0.' + input) * 1000);
  10073. break;
  10074. // UNIX TIMESTAMP WITH MS
  10075. case 'X':
  10076. config._d = new Date(parseFloat(input) * 1000);
  10077. break;
  10078. // TIMEZONE
  10079. case 'Z' : // fall through to ZZ
  10080. case 'ZZ' :
  10081. config._useUTC = true;
  10082. a = (input + '').match(parseTimezoneChunker);
  10083. if (a && a[1]) {
  10084. config._tzh = ~~a[1];
  10085. }
  10086. if (a && a[2]) {
  10087. config._tzm = ~~a[2];
  10088. }
  10089. // reverse offsets
  10090. if (a && a[0] === '+') {
  10091. config._tzh = -config._tzh;
  10092. config._tzm = -config._tzm;
  10093. }
  10094. break;
  10095. }
  10096. // if the input is null, the date is not valid
  10097. if (input == null) {
  10098. config._isValid = false;
  10099. }
  10100. }
  10101. // convert an array to a date.
  10102. // the array should mirror the parameters below
  10103. // note: all values past the year are optional and will default to the lowest possible value.
  10104. // [year, month, day , hour, minute, second, millisecond]
  10105. function dateFromArray(config) {
  10106. var i, date, input = [];
  10107. if (config._d) {
  10108. return;
  10109. }
  10110. for (i = 0; i < 7; i++) {
  10111. config._a[i] = input[i] = (config._a[i] == null) ? (i === 2 ? 1 : 0) : config._a[i];
  10112. }
  10113. // add the offsets to the time to be parsed so that we can have a clean array for checking isValid
  10114. input[3] += config._tzh || 0;
  10115. input[4] += config._tzm || 0;
  10116. date = new Date(0);
  10117. if (config._useUTC) {
  10118. date.setUTCFullYear(input[0], input[1], input[2]);
  10119. date.setUTCHours(input[3], input[4], input[5], input[6]);
  10120. } else {
  10121. date.setFullYear(input[0], input[1], input[2]);
  10122. date.setHours(input[3], input[4], input[5], input[6]);
  10123. }
  10124. config._d = date;
  10125. }
  10126. // date from string and format string
  10127. function makeDateFromStringAndFormat(config) {
  10128. // This array is used to make a Date, either with `new Date` or `Date.UTC`
  10129. var tokens = config._f.match(formattingTokens),
  10130. string = config._i,
  10131. i, parsedInput;
  10132. config._a = [];
  10133. for (i = 0; i < tokens.length; i++) {
  10134. parsedInput = (getParseRegexForToken(tokens[i]).exec(string) || [])[0];
  10135. if (parsedInput) {
  10136. string = string.slice(string.indexOf(parsedInput) + parsedInput.length);
  10137. }
  10138. // don't parse if its not a known token
  10139. if (formatTokenFunctions[tokens[i]]) {
  10140. addTimeToArrayFromToken(tokens[i], parsedInput, config);
  10141. }
  10142. }
  10143. // handle am pm
  10144. if (config._isPm && config._a[3] < 12) {
  10145. config._a[3] += 12;
  10146. }
  10147. // if is 12 am, change hours to 0
  10148. if (config._isPm === false && config._a[3] === 12) {
  10149. config._a[3] = 0;
  10150. }
  10151. // return
  10152. dateFromArray(config);
  10153. }
  10154. // date from string and array of format strings
  10155. function makeDateFromStringAndArray(config) {
  10156. var tempConfig,
  10157. tempMoment,
  10158. bestMoment,
  10159. scoreToBeat = 99,
  10160. i,
  10161. currentDate,
  10162. currentScore;
  10163. while (config._f.length) {
  10164. tempConfig = extend({}, config);
  10165. tempConfig._f = config._f.pop();
  10166. makeDateFromStringAndFormat(tempConfig);
  10167. tempMoment = new Moment(tempConfig);
  10168. if (tempMoment.isValid()) {
  10169. bestMoment = tempMoment;
  10170. break;
  10171. }
  10172. currentScore = compareArrays(tempConfig._a, tempMoment.toArray());
  10173. if (currentScore < scoreToBeat) {
  10174. scoreToBeat = currentScore;
  10175. bestMoment = tempMoment;
  10176. }
  10177. }
  10178. extend(config, bestMoment);
  10179. }
  10180. // date from iso format
  10181. function makeDateFromString(config) {
  10182. var i,
  10183. string = config._i;
  10184. if (isoRegex.exec(string)) {
  10185. config._f = 'YYYY-MM-DDT';
  10186. for (i = 0; i < 4; i++) {
  10187. if (isoTimes[i][1].exec(string)) {
  10188. config._f += isoTimes[i][0];
  10189. break;
  10190. }
  10191. }
  10192. if (parseTokenTimezone.exec(string)) {
  10193. config._f += " Z";
  10194. }
  10195. makeDateFromStringAndFormat(config);
  10196. } else {
  10197. config._d = new Date(string);
  10198. }
  10199. }
  10200. function makeDateFromInput(config) {
  10201. var input = config._i,
  10202. matched = aspNetJsonRegex.exec(input);
  10203. if (input === undefined) {
  10204. config._d = new Date();
  10205. } else if (matched) {
  10206. config._d = new Date(+matched[1]);
  10207. } else if (typeof input === 'string') {
  10208. makeDateFromString(config);
  10209. } else if (isArray(input)) {
  10210. config._a = input.slice(0);
  10211. dateFromArray(config);
  10212. } else {
  10213. config._d = input instanceof Date ? new Date(+input) : new Date(input);
  10214. }
  10215. }
  10216. /************************************
  10217. Relative Time
  10218. ************************************/
  10219. // helper function for moment.fn.from, moment.fn.fromNow, and moment.duration.fn.humanize
  10220. function substituteTimeAgo(string, number, withoutSuffix, isFuture, lang) {
  10221. return lang.relativeTime(number || 1, !!withoutSuffix, string, isFuture);
  10222. }
  10223. function relativeTime(milliseconds, withoutSuffix, lang) {
  10224. var seconds = round(Math.abs(milliseconds) / 1000),
  10225. minutes = round(seconds / 60),
  10226. hours = round(minutes / 60),
  10227. days = round(hours / 24),
  10228. years = round(days / 365),
  10229. args = seconds < 45 && ['s', seconds] ||
  10230. minutes === 1 && ['m'] ||
  10231. minutes < 45 && ['mm', minutes] ||
  10232. hours === 1 && ['h'] ||
  10233. hours < 22 && ['hh', hours] ||
  10234. days === 1 && ['d'] ||
  10235. days <= 25 && ['dd', days] ||
  10236. days <= 45 && ['M'] ||
  10237. days < 345 && ['MM', round(days / 30)] ||
  10238. years === 1 && ['y'] || ['yy', years];
  10239. args[2] = withoutSuffix;
  10240. args[3] = milliseconds > 0;
  10241. args[4] = lang;
  10242. return substituteTimeAgo.apply({}, args);
  10243. }
  10244. /************************************
  10245. Week of Year
  10246. ************************************/
  10247. // firstDayOfWeek 0 = sun, 6 = sat
  10248. // the day of the week that starts the week
  10249. // (usually sunday or monday)
  10250. // firstDayOfWeekOfYear 0 = sun, 6 = sat
  10251. // the first week is the week that contains the first
  10252. // of this day of the week
  10253. // (eg. ISO weeks use thursday (4))
  10254. function weekOfYear(mom, firstDayOfWeek, firstDayOfWeekOfYear) {
  10255. var end = firstDayOfWeekOfYear - firstDayOfWeek,
  10256. daysToDayOfWeek = firstDayOfWeekOfYear - mom.day();
  10257. if (daysToDayOfWeek > end) {
  10258. daysToDayOfWeek -= 7;
  10259. }
  10260. if (daysToDayOfWeek < end - 7) {
  10261. daysToDayOfWeek += 7;
  10262. }
  10263. return Math.ceil(moment(mom).add('d', daysToDayOfWeek).dayOfYear() / 7);
  10264. }
  10265. /************************************
  10266. Top Level Functions
  10267. ************************************/
  10268. function makeMoment(config) {
  10269. var input = config._i,
  10270. format = config._f;
  10271. if (input === null || input === '') {
  10272. return null;
  10273. }
  10274. if (typeof input === 'string') {
  10275. config._i = input = getLangDefinition().preparse(input);
  10276. }
  10277. if (moment.isMoment(input)) {
  10278. config = extend({}, input);
  10279. config._d = new Date(+input._d);
  10280. } else if (format) {
  10281. if (isArray(format)) {
  10282. makeDateFromStringAndArray(config);
  10283. } else {
  10284. makeDateFromStringAndFormat(config);
  10285. }
  10286. } else {
  10287. makeDateFromInput(config);
  10288. }
  10289. return new Moment(config);
  10290. }
  10291. moment = function (input, format, lang) {
  10292. return makeMoment({
  10293. _i : input,
  10294. _f : format,
  10295. _l : lang,
  10296. _isUTC : false
  10297. });
  10298. };
  10299. // creating with utc
  10300. moment.utc = function (input, format, lang) {
  10301. return makeMoment({
  10302. _useUTC : true,
  10303. _isUTC : true,
  10304. _l : lang,
  10305. _i : input,
  10306. _f : format
  10307. });
  10308. };
  10309. // creating with unix timestamp (in seconds)
  10310. moment.unix = function (input) {
  10311. return moment(input * 1000);
  10312. };
  10313. // duration
  10314. moment.duration = function (input, key) {
  10315. var isDuration = moment.isDuration(input),
  10316. isNumber = (typeof input === 'number'),
  10317. duration = (isDuration ? input._data : (isNumber ? {} : input)),
  10318. ret;
  10319. if (isNumber) {
  10320. if (key) {
  10321. duration[key] = input;
  10322. } else {
  10323. duration.milliseconds = input;
  10324. }
  10325. }
  10326. ret = new Duration(duration);
  10327. if (isDuration && input.hasOwnProperty('_lang')) {
  10328. ret._lang = input._lang;
  10329. }
  10330. return ret;
  10331. };
  10332. // version number
  10333. moment.version = VERSION;
  10334. // default format
  10335. moment.defaultFormat = isoFormat;
  10336. // This function will load languages and then set the global language. If
  10337. // no arguments are passed in, it will simply return the current global
  10338. // language key.
  10339. moment.lang = function (key, values) {
  10340. var i;
  10341. if (!key) {
  10342. return moment.fn._lang._abbr;
  10343. }
  10344. if (values) {
  10345. loadLang(key, values);
  10346. } else if (!languages[key]) {
  10347. getLangDefinition(key);
  10348. }
  10349. moment.duration.fn._lang = moment.fn._lang = getLangDefinition(key);
  10350. };
  10351. // returns language data
  10352. moment.langData = function (key) {
  10353. if (key && key._lang && key._lang._abbr) {
  10354. key = key._lang._abbr;
  10355. }
  10356. return getLangDefinition(key);
  10357. };
  10358. // compare moment object
  10359. moment.isMoment = function (obj) {
  10360. return obj instanceof Moment;
  10361. };
  10362. // for typechecking Duration objects
  10363. moment.isDuration = function (obj) {
  10364. return obj instanceof Duration;
  10365. };
  10366. /************************************
  10367. Moment Prototype
  10368. ************************************/
  10369. moment.fn = Moment.prototype = {
  10370. clone : function () {
  10371. return moment(this);
  10372. },
  10373. valueOf : function () {
  10374. return +this._d;
  10375. },
  10376. unix : function () {
  10377. return Math.floor(+this._d / 1000);
  10378. },
  10379. toString : function () {
  10380. return this.format("ddd MMM DD YYYY HH:mm:ss [GMT]ZZ");
  10381. },
  10382. toDate : function () {
  10383. return this._d;
  10384. },
  10385. toJSON : function () {
  10386. return moment.utc(this).format('YYYY-MM-DD[T]HH:mm:ss.SSS[Z]');
  10387. },
  10388. toArray : function () {
  10389. var m = this;
  10390. return [
  10391. m.year(),
  10392. m.month(),
  10393. m.date(),
  10394. m.hours(),
  10395. m.minutes(),
  10396. m.seconds(),
  10397. m.milliseconds()
  10398. ];
  10399. },
  10400. isValid : function () {
  10401. if (this._isValid == null) {
  10402. if (this._a) {
  10403. this._isValid = !compareArrays(this._a, (this._isUTC ? moment.utc(this._a) : moment(this._a)).toArray());
  10404. } else {
  10405. this._isValid = !isNaN(this._d.getTime());
  10406. }
  10407. }
  10408. return !!this._isValid;
  10409. },
  10410. utc : function () {
  10411. this._isUTC = true;
  10412. return this;
  10413. },
  10414. local : function () {
  10415. this._isUTC = false;
  10416. return this;
  10417. },
  10418. format : function (inputString) {
  10419. var output = formatMoment(this, inputString || moment.defaultFormat);
  10420. return this.lang().postformat(output);
  10421. },
  10422. add : function (input, val) {
  10423. var dur;
  10424. // switch args to support add('s', 1) and add(1, 's')
  10425. if (typeof input === 'string') {
  10426. dur = moment.duration(+val, input);
  10427. } else {
  10428. dur = moment.duration(input, val);
  10429. }
  10430. addOrSubtractDurationFromMoment(this, dur, 1);
  10431. return this;
  10432. },
  10433. subtract : function (input, val) {
  10434. var dur;
  10435. // switch args to support subtract('s', 1) and subtract(1, 's')
  10436. if (typeof input === 'string') {
  10437. dur = moment.duration(+val, input);
  10438. } else {
  10439. dur = moment.duration(input, val);
  10440. }
  10441. addOrSubtractDurationFromMoment(this, dur, -1);
  10442. return this;
  10443. },
  10444. diff : function (input, units, asFloat) {
  10445. var that = this._isUTC ? moment(input).utc() : moment(input).local(),
  10446. zoneDiff = (this.zone() - that.zone()) * 6e4,
  10447. diff, output;
  10448. if (units) {
  10449. // standardize on singular form
  10450. units = units.replace(/s$/, '');
  10451. }
  10452. if (units === 'year' || units === 'month') {
  10453. diff = (this.daysInMonth() + that.daysInMonth()) * 432e5; // 24 * 60 * 60 * 1000 / 2
  10454. output = ((this.year() - that.year()) * 12) + (this.month() - that.month());
  10455. output += ((this - moment(this).startOf('month')) - (that - moment(that).startOf('month'))) / diff;
  10456. if (units === 'year') {
  10457. output = output / 12;
  10458. }
  10459. } else {
  10460. diff = (this - that) - zoneDiff;
  10461. output = units === 'second' ? diff / 1e3 : // 1000
  10462. units === 'minute' ? diff / 6e4 : // 1000 * 60
  10463. units === 'hour' ? diff / 36e5 : // 1000 * 60 * 60
  10464. units === 'day' ? diff / 864e5 : // 1000 * 60 * 60 * 24
  10465. units === 'week' ? diff / 6048e5 : // 1000 * 60 * 60 * 24 * 7
  10466. diff;
  10467. }
  10468. return asFloat ? output : absRound(output);
  10469. },
  10470. from : function (time, withoutSuffix) {
  10471. return moment.duration(this.diff(time)).lang(this.lang()._abbr).humanize(!withoutSuffix);
  10472. },
  10473. fromNow : function (withoutSuffix) {
  10474. return this.from(moment(), withoutSuffix);
  10475. },
  10476. calendar : function () {
  10477. var diff = this.diff(moment().startOf('day'), 'days', true),
  10478. format = diff < -6 ? 'sameElse' :
  10479. diff < -1 ? 'lastWeek' :
  10480. diff < 0 ? 'lastDay' :
  10481. diff < 1 ? 'sameDay' :
  10482. diff < 2 ? 'nextDay' :
  10483. diff < 7 ? 'nextWeek' : 'sameElse';
  10484. return this.format(this.lang().calendar(format, this));
  10485. },
  10486. isLeapYear : function () {
  10487. var year = this.year();
  10488. return (year % 4 === 0 && year % 100 !== 0) || year % 400 === 0;
  10489. },
  10490. isDST : function () {
  10491. return (this.zone() < moment([this.year()]).zone() ||
  10492. this.zone() < moment([this.year(), 5]).zone());
  10493. },
  10494. day : function (input) {
  10495. var day = this._isUTC ? this._d.getUTCDay() : this._d.getDay();
  10496. return input == null ? day :
  10497. this.add({ d : input - day });
  10498. },
  10499. startOf: function (units) {
  10500. units = units.replace(/s$/, '');
  10501. // the following switch intentionally omits break keywords
  10502. // to utilize falling through the cases.
  10503. switch (units) {
  10504. case 'year':
  10505. this.month(0);
  10506. /* falls through */
  10507. case 'month':
  10508. this.date(1);
  10509. /* falls through */
  10510. case 'week':
  10511. case 'day':
  10512. this.hours(0);
  10513. /* falls through */
  10514. case 'hour':
  10515. this.minutes(0);
  10516. /* falls through */
  10517. case 'minute':
  10518. this.seconds(0);
  10519. /* falls through */
  10520. case 'second':
  10521. this.milliseconds(0);
  10522. /* falls through */
  10523. }
  10524. // weeks are a special case
  10525. if (units === 'week') {
  10526. this.day(0);
  10527. }
  10528. return this;
  10529. },
  10530. endOf: function (units) {
  10531. return this.startOf(units).add(units.replace(/s?$/, 's'), 1).subtract('ms', 1);
  10532. },
  10533. isAfter: function (input, units) {
  10534. units = typeof units !== 'undefined' ? units : 'millisecond';
  10535. return +this.clone().startOf(units) > +moment(input).startOf(units);
  10536. },
  10537. isBefore: function (input, units) {
  10538. units = typeof units !== 'undefined' ? units : 'millisecond';
  10539. return +this.clone().startOf(units) < +moment(input).startOf(units);
  10540. },
  10541. isSame: function (input, units) {
  10542. units = typeof units !== 'undefined' ? units : 'millisecond';
  10543. return +this.clone().startOf(units) === +moment(input).startOf(units);
  10544. },
  10545. zone : function () {
  10546. return this._isUTC ? 0 : this._d.getTimezoneOffset();
  10547. },
  10548. daysInMonth : function () {
  10549. return moment.utc([this.year(), this.month() + 1, 0]).date();
  10550. },
  10551. dayOfYear : function (input) {
  10552. var dayOfYear = round((moment(this).startOf('day') - moment(this).startOf('year')) / 864e5) + 1;
  10553. return input == null ? dayOfYear : this.add("d", (input - dayOfYear));
  10554. },
  10555. isoWeek : function (input) {
  10556. var week = weekOfYear(this, 1, 4);
  10557. return input == null ? week : this.add("d", (input - week) * 7);
  10558. },
  10559. week : function (input) {
  10560. var week = this.lang().week(this);
  10561. return input == null ? week : this.add("d", (input - week) * 7);
  10562. },
  10563. // If passed a language key, it will set the language for this
  10564. // instance. Otherwise, it will return the language configuration
  10565. // variables for this instance.
  10566. lang : function (key) {
  10567. if (key === undefined) {
  10568. return this._lang;
  10569. } else {
  10570. this._lang = getLangDefinition(key);
  10571. return this;
  10572. }
  10573. }
  10574. };
  10575. // helper for adding shortcuts
  10576. function makeGetterAndSetter(name, key) {
  10577. moment.fn[name] = moment.fn[name + 's'] = function (input) {
  10578. var utc = this._isUTC ? 'UTC' : '';
  10579. if (input != null) {
  10580. this._d['set' + utc + key](input);
  10581. return this;
  10582. } else {
  10583. return this._d['get' + utc + key]();
  10584. }
  10585. };
  10586. }
  10587. // loop through and add shortcuts (Month, Date, Hours, Minutes, Seconds, Milliseconds)
  10588. for (i = 0; i < proxyGettersAndSetters.length; i ++) {
  10589. makeGetterAndSetter(proxyGettersAndSetters[i].toLowerCase().replace(/s$/, ''), proxyGettersAndSetters[i]);
  10590. }
  10591. // add shortcut for year (uses different syntax than the getter/setter 'year' == 'FullYear')
  10592. makeGetterAndSetter('year', 'FullYear');
  10593. // add plural methods
  10594. moment.fn.days = moment.fn.day;
  10595. moment.fn.weeks = moment.fn.week;
  10596. moment.fn.isoWeeks = moment.fn.isoWeek;
  10597. /************************************
  10598. Duration Prototype
  10599. ************************************/
  10600. moment.duration.fn = Duration.prototype = {
  10601. weeks : function () {
  10602. return absRound(this.days() / 7);
  10603. },
  10604. valueOf : function () {
  10605. return this._milliseconds +
  10606. this._days * 864e5 +
  10607. this._months * 2592e6;
  10608. },
  10609. humanize : function (withSuffix) {
  10610. var difference = +this,
  10611. output = relativeTime(difference, !withSuffix, this.lang());
  10612. if (withSuffix) {
  10613. output = this.lang().pastFuture(difference, output);
  10614. }
  10615. return this.lang().postformat(output);
  10616. },
  10617. lang : moment.fn.lang
  10618. };
  10619. function makeDurationGetter(name) {
  10620. moment.duration.fn[name] = function () {
  10621. return this._data[name];
  10622. };
  10623. }
  10624. function makeDurationAsGetter(name, factor) {
  10625. moment.duration.fn['as' + name] = function () {
  10626. return +this / factor;
  10627. };
  10628. }
  10629. for (i in unitMillisecondFactors) {
  10630. if (unitMillisecondFactors.hasOwnProperty(i)) {
  10631. makeDurationAsGetter(i, unitMillisecondFactors[i]);
  10632. makeDurationGetter(i.toLowerCase());
  10633. }
  10634. }
  10635. makeDurationAsGetter('Weeks', 6048e5);
  10636. /************************************
  10637. Default Lang
  10638. ************************************/
  10639. // Set default language, other languages will inherit from English.
  10640. moment.lang('en', {
  10641. ordinal : function (number) {
  10642. var b = number % 10,
  10643. output = (~~ (number % 100 / 10) === 1) ? 'th' :
  10644. (b === 1) ? 'st' :
  10645. (b === 2) ? 'nd' :
  10646. (b === 3) ? 'rd' : 'th';
  10647. return number + output;
  10648. }
  10649. });
  10650. /************************************
  10651. Exposing Moment
  10652. ************************************/
  10653. // CommonJS module is defined
  10654. if (hasModule) {
  10655. module.exports = moment;
  10656. }
  10657. /*global ender:false */
  10658. if (typeof ender === 'undefined') {
  10659. // here, `this` means `window` in the browser, or `global` on the server
  10660. // add `moment` as a global object via a string identifier,
  10661. // for Closure Compiler "advanced" mode
  10662. this['moment'] = moment;
  10663. }
  10664. /*global define:false */
  10665. if (typeof define === "function" && define.amd) {
  10666. define("moment", [], function () {
  10667. return moment;
  10668. });
  10669. }
  10670. }).call(this);
  10671. })()
  10672. },{}]},{},[1])(1)
  10673. });
  10674. ;