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.

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