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.

643 lines
21 KiB

10 years ago
10 years ago
10 years ago
10 years ago
10 years ago
10 years ago
10 years ago
10 years ago
10 years ago
10 years ago
10 years ago
10 years ago
10 years ago
10 years ago
10 years ago
10 years ago
10 years ago
10 years ago
10 years ago
10 years ago
10 years ago
10 years ago
10 years ago
10 years ago
10 years ago
10 years ago
10 years ago
10 years ago
10 years ago
10 years ago
10 years ago
10 years ago
10 years ago
11 years ago
  1. # vis.js history
  2. http://visjs.org
  3. ## 2014-10-28, version 3.6.3
  4. ### Timeline
  5. - Fixed background items not always be cleared when removing them.
  6. - Fixed visible items not always be displayed.
  7. - Performance improvements when doing a lot of changes at once in a DataSet.
  8. ### Network
  9. - Fixed dashed and arrow lines not using inheritColor.
  10. ### DataSet
  11. - Support for queueing of changes, and flushing them at once.
  12. - Implemented `DataSet.setOptions`. Only applicable for the `queue` options.
  13. ## 2014-10-24, version 3.6.2
  14. - Vis.js is now dual licensed under both Apache 2.0 and MIT.
  15. ## 2014-10-22, version 3.6.1
  16. ### Timeline
  17. - Fixed uneven stepsized with hidden dates.
  18. - Fixed multiple bugs with regards to hidden dates.
  19. - Fixed subgroups and added subgroup sorting. Subgroup labels will be in future releases.
  20. ## 2014-10-21, version 3.6.0
  21. ### Network
  22. - Title of nodes and edges can now be an HTML element too.
  23. - Renamed storePosition to storePositions. Added deprication message and old name still works.
  24. - Worked around hammer.js bug with multiple release listeners.
  25. - Improved cleaning up after manipulation toolbar.
  26. - Added getPositions() method to get the position of all nodes or some of them if specific Ids are supplied.
  27. - Added getCenterCoordinates() method to get the x and y position in canvas space of the center of the view.
  28. - Fixed node label becoming undefined.
  29. - Fixed cluster fontsize scaling.
  30. - Fixed cluster sector scaling.
  31. - Added oldHeight and oldWidth to resize event.
  32. ### Timeline
  33. - Implemented field `style` for both items and groups, to set a custom style for
  34. individual items.
  35. - Fixed height of BackgroundItems not being 100% when timeline has a fixed height.
  36. - Fixed width of BackgroundItems not being reduced to 0 when zooming out.
  37. - Fixed onclick events in items not working.
  38. - Added hiddenDates to hide specific times and/or days in the timeline.
  39. ### DataSet
  40. - Event listeners of `update` now receive an extra property `data`,
  41. containing the changed fields of the changed items.
  42. ### Graph2d
  43. - Fixed height of legend when there are many items showing.
  44. ### Graph3d
  45. - Implemented options `xValueLabel`, `yValueLabel` and `zValueLabel` for custom labels along
  46. the x, y, z axis. Thanks @fabriziofortino.
  47. ## 2014-09-16, version 3.5.0
  48. ### Network
  49. - Fixed nodes not always being unfixed when using allowedToMove.
  50. - Added dragStart and dragEnd events.
  51. - Added edge selection on edge labels.
  52. ### Graph2d
  53. - Fixed dataAxis not showing large numbers correctly.
  54. ## 2014-09-12, version 3.4.2
  55. ### Network
  56. - Changed timings for zoomExtent animation.
  57. - Fixed possible cause of freezing graph when animating.
  58. - Added locked to focusOnNode and releaseNode().
  59. - Fixed minor bug in positioning of fontFill of nodes with certain shapes.
  60. - Added startStabilization event.
  61. ## 2014-09-11, version 3.4.1
  62. ### Network
  63. - Fix for introduced bug on zoomExtent navigation button.
  64. - Added animation to zoomExtent navigation button.
  65. - Improved cleaning of Hammer.js bindings.
  66. ### Timeline
  67. - Fixed a bug in IE freezing when margin.item and margin.axis where both 0.
  68. ## 2014-09-10, version 3.4.0
  69. ### Graph2d
  70. - Fixed moment.js url in localization example.
  71. ### Network
  72. - Fixed some positioning issues with the close button of the manipulation menu.
  73. - Added fontFill to Nodes as it is in Edges.
  74. - Implemented support for broken image fallback. Thanks @sfairgrieve.
  75. - Added multiline labels to edges as they are implemented in nodes. Updated
  76. multiline example to show this.
  77. - Added animation and camera controls by the method .moveTo()
  78. - Added new event that fires when the animation is finished.
  79. - Added new example showing the new features of animation.
  80. - Added getScale() method.
  81. ### Timeline
  82. - Implemented support for templates.
  83. - Implemented a new item type: `'background'`. This can be used to mark periods
  84. with a background color and label.
  85. - Implemented support for attaching HTML attributes to items. Thanks @dturkenk.
  86. - Fixed moment.js url in localization example.
  87. - Fixed `className` of groups not being updated when changed.
  88. - Fixed the `id` field of a new item not correctly generated.
  89. - Fixed newly added item ignored when returning an other object instance.
  90. - Fixed option `autoResize` not working on IE in case of changing visibility
  91. of the Timeline container element.
  92. - Fixed an overflow issue with the dots of BoxItems when using groups.
  93. - Fixed a horizontal 1-pixel offset in the items (border width wasn't taken into
  94. account).
  95. - Renamed internal items from `ItemBox`, `ItemRange`, and `ItemPoint` to
  96. respectively `BoxItem`, `RangeItem`, and `PointItem`.
  97. - Fixed an error thrown when calling `destroy()`.
  98. ## 2014-08-29, version 3.3.0
  99. ### Timeline
  100. - Added localization support.
  101. - Implemented option `clickToUse`.
  102. - Implemented function `focus(id)` to center a specific item (or multiple items)
  103. on screen.
  104. - Implemented an option `focus` for `setSelection(ids, options)`, to immediately
  105. focus selected nodes.
  106. - Implemented function `moveTo(time, options)`.
  107. - Implemented animated range change for functions `fit`, `focus`, `setSelection`,
  108. and `setWindow`.
  109. - Implemented functions `setCurrentTime(date)` and `getCurrentTime()`.
  110. - Implemented a new callback function `onMoving(item, callback)`.
  111. - Implemented support for option `align` for range items.
  112. - Fixed the `change` event sometimes being fired twice on IE10.
  113. - Fixed canceling moving an item to another group did not move the item
  114. back to the original group.
  115. - Fixed the `change` event sometimes being fired twice on IE10.
  116. - Fixed canceling moving an item to another group did not move the item
  117. back to the original group.
  118. ### Network
  119. - A fix in reading group properties for a node.
  120. - Fixed physics solving stopping when a support node was not moving.
  121. - Implemented localization support.
  122. - Implemented option `clickToUse`.
  123. - Improved the `stabilized` event, it's now firing after every stabilization
  124. with iteration count as parameter.
  125. - Fixed page scroll event not being blocked when moving around in Network
  126. using arrow keys.
  127. - Fixed an initial rendering before the graph has been stabilized.
  128. - Fixed bug where loading hierarchical data after initialization crashed network.
  129. - Added different layout method to the hierarchical system based on the direction of the edges.
  130. ### Graph2d
  131. - Implemented option `handleOverlap` to support overlap, sideBySide and stack.
  132. - Implemented two examples showing the `handleOverlap` functionality.
  133. - Implemented `customRange` for the Y axis and an example showing how it works.
  134. - Implemented localization support.
  135. - Implemented option `clickToUse`.
  136. - Implemented functions `setCurrentTime(date)` and `getCurrentTime()`.
  137. - Implemented function `moveTo(time, options)`.
  138. - Fixed bugs.
  139. - Added groups.visibility functionality and an example showing how it works.
  140. ## 2014-08-14, version 3.2.0
  141. ### General
  142. - Refactored Timeline and Graph2d to use the same core.
  143. ### Graph2d
  144. - Added `visible` property to the groups.
  145. - Added `getLegend()` method.
  146. - Added `isGroupVisible()` method.
  147. - Fixed empty group bug.
  148. - Added `fit()` and `getItemRange()` methods.
  149. ### Timeline
  150. - Fixed items in groups sometimes being displayed but not positioned correctly.
  151. - Fixed a group "null" being displayed in IE when not using groups.
  152. ### Network
  153. - Fixed mass = 0 for nodes.
  154. - Revamped the options system. You can globally set options (network.setOptions) to update settings of nodes and edges that have not been specifically defined by the individual nodes and edges.
  155. - Disabled inheritColor when color information is set on an edge.
  156. - Tweaked examples.
  157. - Removed the global length property for edges. The edgelength is part of the physics system. Therefore, you have to change the springLength of the physics system to change the edge length. Individual edge lengths can still be defined.
  158. - Removed global edge length definition form examples.
  159. - Removed onclick and onrelease for navigation and switched to Hammer.js (fixing touchscreen interaction with navigation).
  160. - Fixed error on adding an edge without having created the nodes it should be connected to (in the case of dynamic smooth curves).
  161. ## 2014-07-22, version 3.1.0
  162. ### General
  163. - Refactored the code to commonjs modules, which are browserifyable. This allows
  164. to create custom builds.
  165. ### Timeline
  166. - Implemented function `getVisibleItems()`, which returns the items visible
  167. in the current window.
  168. - Added options `margin.item.horizontal` and `margin.item.vertical`, which
  169. allows to specify different margins horizontally/vertically.
  170. - Removed check for number of arguments in callbacks `onAdd`, `onUpdate`,
  171. `onRemove`, and `onMove`.
  172. - Fixed items in groups sometimes being displayed but not positioned correctly.
  173. - Fixed range where the `end` of the first is equal to the `start` of the second
  174. sometimes being stacked instead of put besides each other when `item.margin=0`
  175. due to round-off errors.
  176. ### Network (formerly named Graph)
  177. - Expanded smoothCurves options for improved support for large clusters.
  178. - Added multiple types of smoothCurve drawing for greatly improved performance.
  179. - Option for inherited edge colors from connected nodes.
  180. - Option to disable the drawing of nodes or edges on drag.
  181. - Fixed support nodes not being cleaned up if edges are removed.
  182. - Improved edge selection detection for long smooth curves.
  183. - Fixed dot radius bug.
  184. - Updated max velocity of nodes to three times it's original value.
  185. - Made "stabilized" event fire every time the network stabilizes.
  186. - Fixed drift in dragging nodes while zooming.
  187. - Fixed recursively constructing of hierarchical layouts.
  188. - Added borderWidth option for nodes.
  189. - Implemented new Hierarchical view solver.
  190. - Fixed an issue with selecting nodes when the web page is scrolled down.
  191. - Added Gephi JSON parser
  192. - Added Neighbour Highlight example
  193. - Added Import From Gephi example
  194. - Enabled color parsing for nodes when supplied with rgb(xxx,xxx,xxx) value.
  195. ### DataSet
  196. - Added .get() returnType option to return as JSON object, Array or Google
  197. DataTable.
  198. ## 2014-07-07, version 3.0.0
  199. ### Timeline
  200. - Implemented support for displaying a `title` for both items and groups.
  201. - Fixed auto detected item type being preferred over the global item `type`.
  202. - Throws an error when constructing without new keyword.
  203. - Removed the 'rangeoverflow' item type. Instead, one can use a regular range
  204. and change css styling of the item contents to:
  205. .vis.timeline .item.range .content {
  206. overflow: visible;
  207. }
  208. - Fixed the height of background and foreground panels of groups.
  209. - Fixed ranges in the Timeline sometimes overlapping when dragging the Timeline.
  210. - Fixed `DataView` not working in Timeline.
  211. ### Network (formerly named Graph)
  212. - Renamed `Graph` to `Network` to prevent confusion with the visualizations
  213. `Graph2d` and `Graph3d`.
  214. - Renamed option `dragGraph` to `dragNetwork`.
  215. - Now throws an error when constructing without new keyword.
  216. - Added pull request from Vukk, user can now define the edge width multiplier
  217. when selected.
  218. - Fixed `graph.storePositions()`.
  219. - Extended Selection API with `selectNodes` and `selectEdges`, deprecating
  220. `setSelection`.
  221. - Fixed multiline labels.
  222. - Changed hierarchical physics solver and updated docs.
  223. ### Graph2d
  224. - Added first iteration of the Graph2d.
  225. ### Graph3d
  226. - Now throws an error when constructing without new keyword.
  227. ## 2014-06-19, version 2.0.0
  228. ### Timeline
  229. - Implemented function `destroy` to neatly cleanup a Timeline.
  230. - Implemented support for dragging the timeline contents vertically.
  231. - Implemented options `zoomable` and `moveable`.
  232. - Changed default value of option `showCurrentTime` to true.
  233. - Internal refactoring and simplification of the code.
  234. - Fixed property `className` of groups not being applied to related contents and
  235. background elements, and not being updated once applied.
  236. ### Graph
  237. - Reduced the timestep a little for smoother animations.
  238. - Fixed dataManipulation.initiallyVisible functionality (thanks theGrue).
  239. - Forced typecast of fontSize to Number.
  240. - Added editing of edges using the data manipulation toolkit.
  241. ### DataSet
  242. - Renamed option `convert` to `type`.
  243. ## 2014-06-06, version 1.1.0
  244. ### Timeline
  245. - Select event now triggers repeatedly when selecting an already selected item.
  246. - Renamed `Timeline.repaint()` to `Timeline.redraw()` to be consistent with
  247. the other visualisations of vis.js.
  248. - Fixed `Timeline.clear()` not resetting a configured `options.start` and
  249. `options.end`.
  250. ### Graph
  251. - Fixed error with zero nodes with hierarchical layout.
  252. - Added focusOnNode function.
  253. - Added hover option.
  254. - Added dragNodes option. Renamed movebale to dragGraph option.
  255. - Added hover events (hoverNode, blurNode).
  256. ### Graph3D
  257. - Ported Graph3D from Chap Links Library.
  258. ## 2014-05-28, version 1.0.2
  259. ### Timeline
  260. - Implemented option `minHeight`, similar to option `maxHeight`.
  261. - Implemented a method `clear([what])`, to clear items, groups, and configuration
  262. of a Timeline instance.
  263. - Added function `repaint()` to force a repaint of the Timeline.
  264. - Some tweaks in snapping dragged items to nice dates.
  265. - Made the instance of moment.js packaged with vis.js accessibly via `vis.moment`.
  266. - A newly created item is initialized with `end` property when option `type`
  267. is `"range"` or `"rangeoverflow"`.
  268. - Fixed a bug in replacing the DataSet of groups via `Timeline.setGroups(groups)`.
  269. - Fixed a bug when rendering the Timeline inside a hidden container.
  270. - Fixed axis scale being determined wrongly for a second Timeline in a single page.
  271. ### Graph
  272. - Added zoomable and moveable options.
  273. - Changes setOptions to avoid resetting view.
  274. - Interchanged canvasToDOM and DOMtoCanvas to correspond with the docs.
  275. ## 2014-05-09, version 1.0.1
  276. ### Timeline
  277. - Fixed width of items with type `rangeoverflow`.
  278. - Fixed a bug wrongly rendering invisible items after updating them.
  279. ### Graph
  280. - Added coordinate conversion from DOM to Canvas.
  281. - Fixed bug where the graph stopped animation after settling in playing with physics.
  282. - Fixed bug where hierarchical physics properties were not handled.
  283. - Added events for change of view and zooming.
  284. ## 2014-05-02, version 1.0.0
  285. ### Timeline
  286. - Large refactoring of the Timeline, simplifying the code.
  287. - Great performance improvements.
  288. - Improved layout of box-items inside groups.
  289. - Items can now be dragged from one group to another.
  290. - Implemented option `stack` to enable/disable stacking of items.
  291. - Implemented function `fit`, which sets the Timeline window such that it fits
  292. all items.
  293. - Option `editable` can now be used to enable/disable individual manipulation
  294. actions (`add`, `updateTime`, `updateGroup`, `remove`).
  295. - Function `setWindow` now accepts an object with properties `start` and `end`.
  296. - Fixed option `autoResize` forcing a repaint of the Timeline with every check
  297. rather than when the Timeline is actually resized.
  298. - Fixed `select` event fired repeatedly when clicking an empty place on the
  299. Timeline, deselecting selected items).
  300. - Fixed initial visible window in case items exceed `zoomMax`. Thanks @Remper.
  301. - Fixed an offset in newly created items when using groups.
  302. - Fixed height of a group not reckoning with the height of the group label.
  303. - Option `order` is now deprecated. This was needed for performance improvements.
  304. - More examples added.
  305. - Minor bug fixes.
  306. ### Graph
  307. - Added recalculate hierarchical layout to update node event.
  308. - Added arrowScaleFactor to scale the arrows on the edges.
  309. ### DataSet
  310. - A DataSet can now be constructed with initial data, like
  311. `new DataSet(data, options)`.
  312. ## 2014-04-18, version 0.7.4
  313. ### Graph
  314. - Fixed IE9 bug.
  315. - Style fixes.
  316. - Minor bug fixes.
  317. ## 2014-04-16, version 0.7.3
  318. ### Graph
  319. - Fixed color bug.
  320. - Added pull requests from kannonboy and vierja: tooltip styling, label fill
  321. color.
  322. ## 2014-04-09, version 0.7.2
  323. ### Graph
  324. - Fixed edge select bug.
  325. - Fixed zoom bug on empty initialization.
  326. ## 2014-03-27, version 0.7.1
  327. ### Graph
  328. - Fixed edge color bug.
  329. - Fixed select event bug.
  330. - Clarified docs, stressing importance of css inclusion for correct display of
  331. navigation an manipulation icons.
  332. - Improved and expanded playing with physics (configurePhysics option).
  333. - Added highlights to navigation icons if the corresponding key is pressed.
  334. - Added freezeForStabilization option to improve stabilization with cached
  335. positions.
  336. ## 2014-03-07, version 0.7.0
  337. ### Graph
  338. - Changed navigation CSS. Icons are now always correctly positioned.
  339. - Added stabilizationIterations option to graph.
  340. - Added storePosition() method to save the XY positions of nodes in the DataSet.
  341. - Separated allowedToMove into allowedToMoveX and allowedToMoveY. This is
  342. required for initializing nodes from hierarchical layouts after
  343. storePosition().
  344. - Added color options for the edges.
  345. ## 2014-03-06, version 0.6.1
  346. ### Graph
  347. - Bugfix graphviz examples.
  348. - Bugfix labels position for smooth curves.
  349. - Tweaked graphviz example physics.
  350. - Updated physics documentation to stress importance of configurePhysics.
  351. ### Timeline
  352. - Fixed a bug with options `margin.axis` and `margin.item` being ignored when
  353. setting them to zero.
  354. - Some clarifications in the documentation.
  355. ## 2014-03-05, version 0.6.0
  356. ### Graph
  357. - Added Physics Configuration option. This makes tweaking the physics system to
  358. suit your needs easier.
  359. - Click and doubleClick events.
  360. - Initial zoom bugfix.
  361. - Directions for Hierarchical layout.
  362. - Refactoring and bugfixes.
  363. ## 2014-02-20, version 0.5.1
  364. - Fixed broken bower module.
  365. ## 2014-02-20, version 0.5.0
  366. ### Timeline
  367. - Editable Items: drag items, add new items, update items, and remove items.
  368. - Implemented options `selectable`, `editable`.
  369. - Added events `timechange` and `timechanged` when dragging the custom time bar.
  370. - Multiple items can be selected using ctrl+click or shift+click.
  371. - Implemented functions `setWindow(start, end)` and `getWindow()`.
  372. - Fixed scroll to zoom not working on IE in standards mode.
  373. ### Graph
  374. - Editable nodes and edges: create, update, and remove them.
  375. - Support for smooth, curved edges (on by default).
  376. - Performance improvements.
  377. - Fixed scroll to zoom not working on IE in standards mode.
  378. - Added hierarchical layout option.
  379. - Overhauled physics system, now using Barnes-Hut simulation by default. Great
  380. performance gains.
  381. - Modified clustering system to give better results.
  382. - Adaptive performance system to increase visual performance (60fps target).
  383. ### DataSet
  384. - Renamed functions `subscribe` and `unsubscribe` to `on` and `off` respectively.
  385. ## 2014-01-31, version 0.4.0
  386. ### Timeline
  387. - Implemented functions `on` and `off` to create event listeners for events
  388. `rangechange`, `rangechanged`, and `select`.
  389. - Implemented function `select` to get and set the selected items.
  390. - Items can be selected by clicking them, muti-select by holding them.
  391. - Fixed non working `start` and `end` options.
  392. ### Graph
  393. - Fixed longstanding bug in the force calculation, increasing simulation
  394. stability and fluidity.
  395. - Reworked the calculation of the Graph, increasing performance for larger
  396. datasets (up to 10x!).
  397. - Support for automatic clustering in Graph to handle large (>50000) datasets
  398. without losing performance.
  399. - Added automatic initial zooming to Graph, to more easily view large amounts
  400. of data.
  401. - Added local declustering to Graph, freezing the simulation of nodes outside
  402. of the cluster.
  403. - Added support for key-bindings by including mouseTrap in Graph.
  404. - Added navigation controls.
  405. - Added keyboard navigation.
  406. - Implemented functions `on` and `off` to create event listeners for event
  407. `select`.
  408. ## 2014-01-14, version 0.3.0
  409. - Moved the generated library to folder `./dist`
  410. - Css stylesheet must be loaded explicitly now.
  411. - Implemented options `showCurrentTime` and `showCustomTime`. Thanks @fi0dor.
  412. - Implemented touch support for Timeline.
  413. - Fixed broken Timeline options `min` and `max`.
  414. - Fixed not being able to load vis.js in node.js.
  415. ## 2013-09-20, version 0.2.0
  416. - Implemented full touch support for Graph.
  417. - Fixed initial empty range in the Timeline in case of a single item.
  418. - Fixed field `className` not working for items.
  419. ## 2013-06-20, version 0.1.0
  420. - Added support for DataSet to Graph. Graph now uses an id based set of nodes
  421. and edges instead of a row based array internally. Methods getSelection and
  422. setSelection of Graph now accept a list with ids instead of rows.
  423. - Graph is now robust against edges pointing to non-existing nodes, which
  424. can occur easily while dynamically adding/removing nodes and edges.
  425. - Implemented basic support for groups in the Timeline.
  426. - Added documentation on DataSet and DataView.
  427. - Fixed selection of nodes in a Graph when the containing web page is scrolled.
  428. - Improved date conversion.
  429. - Renamed DataSet option `fieldTypes` to `convert`.
  430. - Renamed function `vis.util.cast` to `vis.util.convert`.
  431. ## 2013-06-07, version 0.0.9
  432. - First working version of the Graph imported from the old library.
  433. - Documentation added for both Timeline and Graph.
  434. ## 2013-05-03, version 0.0.8
  435. - Performance improvements: only visible items are rendered.
  436. - Minor bug fixes and improvements.
  437. ## 2013-04-25, version 0.0.7
  438. - Sanitized the published packages on npm and bower.
  439. ## 2013-04-25, version 0.0.6
  440. - Css is now packaged in the javascript file, and automatically loaded.
  441. - The library uses node style dependency management for modules now, used
  442. with Browserify.
  443. ## 2013-04-16, version 0.0.5
  444. - First working version of the Timeline.
  445. - Website created.