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.

1291 lines
45 KiB

9 years ago
9 years ago
9 years ago
9 years ago
9 years ago
9 years ago
9 years ago
9 years ago
9 years ago
9 years ago
9 years ago
9 years ago
9 years ago
9 years ago
9 years ago
9 years ago
9 years ago
9 years ago
9 years ago
9 years ago
9 years ago
9 years ago
9 years ago
9 years ago
9 years ago
9 years ago
9 years ago
9 years ago
9 years ago
9 years ago
9 years ago
9 years ago
9 years ago
10 years ago
10 years ago
10 years ago
10 years ago
9 years ago
9 years ago
9 years ago
9 years ago
9 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
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
11 years ago
11 years ago
11 years ago
11 years ago
11 years ago
11 years ago
11 years ago
11 years ago
10 years ago
11 years ago
  1. # vis.js history
  2. http://visjs.org
  3. ## not yet released, version 4.9.1-SNAPSHOT
  4. ## 2015-01-01, version 4.9.0
  5. ### Network
  6. - Fixed bug where an edge that was not connected would crash the layout algorithms.
  7. - Fixed bug where a box shape could not be drawn outside of the viewable area.
  8. - Fixed bug where dragging a node that is not a control node during edit edge mode would throw an error.
  9. - Made auto scaling on container size change pick the lowest between delta height and delta width.
  10. - Added images with borders option (useBorderWithImage)
  11. - Updated the manipulation css to fix offset if there is no separator.
  12. ### Timeline
  13. - Fixed #1326: wrongly positioned dot of PointItems.
  14. - Fixed #1249: option `hiddenDates` not accepting a single hidden date.
  15. - Fixed a bug when pinching and using hidden dates. Thanks @lauzierj.
  16. ## 2015-09-14, version 4.8.2
  17. ### Network
  18. - Fixed Phantom Edges during clustering.
  19. - Fixed scaling not doing anything to edges.
  20. - Fixed setting font to null so the network won't crash anymore.
  21. - Fixed stabilized event not firing if layout algorithm does very well.
  22. - Fixed arrows with some shapes when they are selected. #1292
  23. - Fixed deletion of options by settings them to null.
  24. ## 2015-09-07, version 4.8.1
  25. ### Network
  26. - Added German (de) locale. Thanks @Tooa.
  27. - Fixed critical camera zoom bug #1273.
  28. - Fixed unselectAll method. #1256
  29. - Fixed bug that broke the network if drawn in a hidden div #1254
  30. ### Timeline
  31. - Fixed #1215: inconsistent types of properties `start` and `end` in callback
  32. functions `onMove`, `onMoving`, `onAdd`.
  33. ## 2015-08-28, version 4.8.0
  34. ### Timeline
  35. - Implemented reordering groups by dragging them vertically. Thanks @hansmaulwurf23.
  36. ### Network
  37. - Added Spanish (es) locale. Thanks @gomezgoiri.
  38. - Added support for labels in edges and titles for both nodes and edges during gephi import.
  39. - Added KamadaKawai layout engine for improved initial layout.
  40. - Added Adaptive timestep to the physics solvers for increased performance during stabilization.
  41. - Added improvedLayout as experimental option for greatly improved stabilization times.
  42. - Added adaptiveTimestep as experimental option for greatly improved stabilization times.
  43. - Added support for Gephi directed edges, edge labels and titles.
  44. - Improved the positioning and CSS of the configurator and the color picker.
  45. - Greatly improved performance in clustering.
  46. - Made the network keep its 'view' during a change of the size of the container.
  47. - Fixed #1152, updating images now works.
  48. - Fixed cleaning up of nodes.
  49. - Fixed dynamic updating of label properties.
  50. - Fixed bugs in clustering algorithm.
  51. - Fixed find node return types.
  52. - Fixed bug where stabilization iterations were counted double. If it looks like the stabilization is slower, its because it is doing twice the amount of steps it did before.
  53. - Fixed getPositions return values.
  54. ## Graph2d
  55. - Implemented configuration option `excludeFromLegend`. Thanks @Bernd0.
  56. ## 2015-07-27, version 4.7.0
  57. ### Timeline
  58. - Fixed #192: Items keep their group offset while dragging items located in
  59. multiple groups. Thanks @Fice.
  60. - Fixed #1118: since v4.6.0, grid of time axis was wrongly positioned on some
  61. scales.
  62. ### Network
  63. - Added moveNode method.
  64. - Added cubic Bezier curves.
  65. ## 2015-07-22, version 4.6.0
  66. ### Timeline
  67. - Implemented #24: support for custom timezones, see configuration option `moment`.
  68. ### Graph2d
  69. - Implemented #24: support for custom timezones, see configuration option `moment`.
  70. ### Network
  71. - Fixed #1111, check if edges exist was not correct on update.
  72. - Fixed #1112, network now works in firefox on unix again.
  73. - Added #931, borderRadius in shapeProperties for the box shape.
  74. - Added #936, useImageSize for images and circularImages
  75. ## 2015-07-20, version 4.5.1
  76. ### Network
  77. - Fixed another clustering bug, phantom edges should be gone now.
  78. - Fixed disabling hierarchical layout.
  79. - Fixed delete button when using multiple selected items in manipulation system.
  80. ## 2015-07-17, version 4.5.0
  81. ### General
  82. - Docs have been greatly improved thanks to @felixhayashi! Thanks a lot!
  83. ### Network
  84. - Added shapeProperties, thanks @zukomgwili!
  85. - Added configChange event.
  86. - Properly fixed the _lockedRedraw method.
  87. - Fixed node resizing on dragging.
  88. - Fixed missing edges during clustering.
  89. - Fixed missing refresh of node data when changing hierarchical layout on the fly.
  90. - Fixed hover and blur events for edges.
  91. ### Graph3d
  92. - Fixed not changing `backgroundColor` when not provided in options. Thanks @ozydingo.
  93. ### Timeline
  94. - Implemented support for group templates (#996). Thanks @hansmaulwurf23.
  95. - Implemented option `zoomKey` for both Timeline and Graph2d (see #1082).
  96. Thanks @hansmaulwurf23.
  97. - Fixed #1076: Fixed possible overlap of minor labels text on the TimeAxis.
  98. - Fixed #1001: First element of group style being cut.
  99. - Fixed #1071: HTML contents of a group not cleared when the contents is updated.
  100. - Fixed #1033: Moved item data not updated in DataSet when using an asynchronous
  101. `onMove` handler.
  102. - Fixed #239: Do not zoom/move the window when the mouse is on the left panel
  103. with group labels.
  104. ## 2015-07-03, version 4.4.0
  105. ### General
  106. - Documentation now has breadcrums. Thanks @felixhayashi!
  107. ### Graph3d
  108. - Fixed #970: Implemented options `dataColor`, `axisColor`, and `gridColor`.
  109. ### Network
  110. - Fixed Hammerjs direction issue.
  111. - Fixed recursion error when node is fixed but has no position.
  112. - Fixed accidental redrawing during stabilization.
  113. - Fixed delete callbacks with null argument not showing toolbar afterwards.
  114. - Added zoom events from keyboard and navigation buttons.
  115. - No longer start stabilization with an empty node set.
  116. - Fixed #974 connecting static smooth and straight edges.
  117. - Improved handling of empty image field.
  118. - Fixed #987 proper cleaning of support nodes.
  119. - Fixed static smooth edges not fully working from every angle.
  120. - Fixed updating bounding box of nodes without drawing.
  121. - Fixed #1036, bug in lockedRedraw. Thanks @vges!
  122. - Added getDataset to all manipulation functions. Thanks @ericvandever!
  123. - Fixed #1039, icon now returns correct distance to border
  124. - Added blurEdge and hoverEdge events.
  125. - Added labelHighlightBold option to edges and nodes.
  126. - Added getOptionsFromConfigurator method.
  127. - Fixed extra edges in clustering.
  128. - Fixed cleaning up of clustering edges on declustering.
  129. - Made fit() method only look at visible nodes to get the range.
  130. ### Graph2d
  131. - Made graph2d more robust against string values in the y position.
  132. - Fixed bug where 0 axis was always in the automatically fitted range.
  133. - Added drawPoints.onRender. Thanks @mschallar!
  134. ### Timeline
  135. - Fixed cleaning up of items in subgroups, thanks @ChenMachluf!
  136. - Improved error notification with groups, thanks @skinkie!
  137. ## 2015-06-16, version 4.3.0
  138. ### General
  139. - Fixed #950: option `locales` broken in `Timeline`, `Graph2d`, and `Network`.
  140. - Fixed #964: `Timeline`, `Graph2d`, and `Network` not working on IE9.
  141. ### Graph2d
  142. - Fixed #942, #966: bug when data is empty.
  143. ### Timeline
  144. - Implemented `editable` option for individual items. Thanks @danbertolini.
  145. ### Network
  146. - Fixed dragStart event to give the correct node information.
  147. ## 2015-06-05, version 4.2.0
  148. ### General
  149. - Fixed #893, #911: the `clickToUse` option of Network, Graph2d, and Network
  150. was blocking click events in the web page.
  151. ### Timeline
  152. - Added axis orientation option `'none'`.
  153. - Added a property `event` to the properties emitted with the `select` event (see #923).
  154. - Improved function `fit()` to take into account the actual width of items.
  155. - Fixed #897: Timeline option `{snap: null}` did give a validation error.
  156. - Fixed #925: Event `timechanged` did not fire when mouse has been moved outside
  157. the timeline.
  158. ### Graph2D
  159. - Fixed #892, addressed any case in validator.
  160. - Fixed #898, lines are not taken into account for stacking.
  161. ### Network
  162. - Improved robustness against people molesting the Function.prototype.bind()
  163. - Fixed few functions including storePositions().
  164. - Added beginnings of unit testing for network.
  165. - Fixed #904, correctly parsing global font options now.
  166. - Fixed dataView support for storePositions.
  167. - Second click on node is no longer unselect.
  168. - Added releaseFunction to openCluster.
  169. - Fixed bug where the network could flicker when the pixelRatio is not integer.
  170. - Added enabled property to physics.
  171. - Fixed #927, dragStart event didn't contain node that was being dragged
  172. ## 2015-05-28, version 4.1.0
  173. ### Network
  174. - Fixed #866, manipulation can now be set to false without crashing.
  175. - Fixed #860, edit node mode now works as it should.
  176. - Fixed #859, images now resize again when they are loaded.
  177. - Fixed dynamic edges not correctly handling non-existent nodes.
  178. - Accepted pull from @killerDJO for fixing selected and hover colors for edges.
  179. - Fixed bug with right mouse button, scroll center and popup positions using the wrong coordinates.
  180. - Fixed click to use.
  181. - Fixed getConnectedEdges method.
  182. - Fixed clustering bug.
  183. - Added getNodesInCluster method.
  184. - Renamed editNodeMode to editNode, editNodeMode now give a deprecation log message.
  185. - Added multiselect to the docs.
  186. - Removed deprecated dynamic entree, allow any smooth curve style for hierarchical layout.
  187. - Fixed bug with the moveTo and getViewPosition methods.
  188. - Fixed #861, brokenImage only working for one node if nodes have the same image.
  189. - Fixed hoverNode and blurNode events and added them to the docs.
  190. - Fixed #884, selectNode event.
  191. - Fixed dynamic setting hidden and physics.
  192. - Fixed edit node mode's fallback.
  193. ### Graph2d & Timeline
  194. - Fixed #858, #872, fixed usage of deprecated `unsubscribe` from DataSet.
  195. - Fixed #869: Add className with id to custom time bars
  196. - Fixed #877: Added support for metaKey to select multiple items.
  197. ## 2015-05-22, version 4.0.0
  198. ### General
  199. - Changed the build scripts to include a transpilation of ES6 to ES5
  200. (using http://babel.org), so we can use ES6 features in the vis.js code.
  201. When creating a custom bundle using browserify, one now needs to add a
  202. transform step using `babelify`, this is described in README.md.
  203. ### Timeline
  204. - Integrated an option configurator and validator.
  205. - Implemented option `multiselect`, which is false by default.
  206. - Added method `setData({groups: groups, items: items})`.
  207. - Fixed range items not being displayed smaller than 10 pixels (twice the
  208. padding). In order to have overflowing text, one should now apply css style
  209. `.vis.timeline .item.range { overflow: visible; }` instead of
  210. `.vis.timeline .item.range .content { overflow: visible; }`.
  211. See example 18_range_overflow.html.
  212. - Fixed invalid css names for time axis grid, renamed hours class names from
  213. `4-8h` to `h4-h8`.
  214. - Deprecated option `showCustomTime`. Use method `addCustomTime()` instead.
  215. - Deprecated event `finishedRedraw` as it's redundant.
  216. - Renamed option `animate` to `animation`, and changed it to be either a boolean
  217. or an object `{duration: number, easingFunction: string}`.
  218. - Fixed #831: items losing selection when their type changed.
  219. ### Graph2d
  220. - New option structure.
  221. - Cleaned up docs.
  222. - Fixed #628: stacking order.
  223. - Fixed #624: sorting order.
  224. - Fixed #616: stacking with negative bars.
  225. - Fixed #728: alignment issues.
  226. - Fixed #716: Height of graph `2px` too large when configuring a fixed height.
  227. ### Network
  228. The network has been completely rewritten. The new modular setup using ES6 classes makes
  229. it future proof for maintainability, extendability and clarity. A summary of new features:
  230. - New examples, categorized by topic.
  231. - New docs.
  232. - New option structure, adhering to the modular setup on the backend.
  233. - New events for user interaction.
  234. - New render events for drawing custom elements on the canvas.
  235. - New physics events for making a loading bar during stabilization.
  236. - A lot of new methods that make extending easier.
  237. - Manipulation system now works without the UI neccesarily.
  238. - Nodes and edges can cast shadows.
  239. - Configurator system to dynamically change almost all options.
  240. - Validator has been created for the network's options, warning you about typo's and suggesting alternatives.
  241. - Diamond shape for nodes.
  242. - Unified the label code so edges and nodes have the same label settings.
  243. - InheritColors for edges can be set to both, making a gradient fade between two node colors.
  244. - Redesigned the clustering system giving full control over it.
  245. - Random seed can be saved so the network will be the same every time you start it.
  246. - New physics solver based on ForceAtlas2 as implemented in gephi.]
  247. - New avoidOverlap option for physics.
  248. - Many, many bugfixes.
  249. ### DataSet
  250. - Dropped support for Google visualization DataTable.
  251. - Dropped support for appending data returned by `DataSet.get()` to an existing
  252. Array or DataTable.
  253. ## 2015-04-07, version 3.12.0
  254. ### Network
  255. - Fixed support for DataSet with custom id fields (option `fieldId`).
  256. ### Timeline
  257. - Orientation can now be configured separately for axis and items.
  258. - The event handlers `onMove` and `onMoving` are now invoked with all item
  259. properties as argument, and can be used to update all properties (like
  260. content, className, etc) and add new properties as well.
  261. - Fixed #654: removed unnecessary minimum height for groups, takes the
  262. height of the group label as minimum height now.
  263. - Fixed #708: detecting wrong group when page is scrolled.
  264. - Fixed #733: background items being selected on shift+click.
  265. ## 2015-03-05, version 3.11.0
  266. ### Network
  267. - (added gradient coloring for lines, but set for release in 4.0 due to required refactoring of options)
  268. - Fixed bug where a network that has frozen physics would resume redrawing after setData, setOptions etc.
  269. - Added option to bypass default groups. If more groups are specified in the nodes than there are in the groups, loop over supplied groups instead of default.
  270. - Added two new static smooth curves modes: curveCW and curve CCW.
  271. - Added request redraw for certain internal processes to reduce number of draw calls (performance improvements!).
  272. - Added pull request for usage of Icons. Thanks @Dude9177!
  273. - Allow hierarchical view to be set in setOptions.
  274. - Fixed manipulation bar for mobile.
  275. - Fixed #670: Bug when updating data in a DataSet, when Network is connected to the DataSet via a DataView.
  276. - Fixed #688: Added a css class to be able to distinguish buttons "Edit node"
  277. and "Edit edge".
  278. ### Timeline
  279. - Implemented orientation option `'both'`, displaying a time axis both on top
  280. and bottom (#665).
  281. - Implemented creating new range items by dragging in an empty space with the
  282. ctrl key down.
  283. - Implemented configuration option `order: function` to define a custom ordering
  284. for the items (see #538, #234).
  285. - Implemented events `click`, `doubleClick`, and `contextMenu`.
  286. - Implemented method `getEventProperties(event)`.
  287. - Fixed not property initializing with a DataView for groups.
  288. - Merged add custom timebar functionality, thanks @aytech!
  289. - Fixed #664: end of item not restored when canceling a move event.
  290. - Fixed #609: reduce the left/right dragarea when an item range is very small,
  291. so you can still move it as a whole.
  292. - Fixed #676: misalignment of background items when using subgroups and the
  293. group label's height is larger than the contents.
  294. ### Graph2d
  295. - Implemented events `click`, `doubleClick`, and `contextMenu`.
  296. - Implemented method `getEventProperties(event)`.
  297. ### DataSet/DataView
  298. - Implemented support for mapping field names. Thanks @spatialillusions.
  299. - Fixed #670: DataView not passing a data property on update events (see #670)
  300. ## 2015-02-11, version 3.10.0
  301. ### Network
  302. - Added option bindToWindow (default true) to choose whether the keyboard binds are global or to the network div.
  303. - Improved images handling so broken images are shown on all references of images that are broken.
  304. - Added getConnectedNodes method.
  305. - Added fontSizeMin, fontSizeMax, fontSizeMaxVisible, scaleFontWithValue, fontDrawThreshold to Nodes.
  306. - Added fade in of labels (on nodes) near the fontDrawThreshold.
  307. - Added nodes option to zoomExtent to zoom in on specific set of nodes.
  308. - Added stabilizationIterationsDone event which fires at the end of the internal stabilization run. Does not imply that the network is stabilized.
  309. - Added freezeSimulation method.
  310. - Added clusterByZoom option.
  311. - Added class name 'network-tooltip' to the tooltip, allowing custom styling.
  312. - Fixed bug when redrawing was not right on zoomed-out browsers.
  313. - Added opacity option to edges. Opacity is only used for the unselected state.
  314. - Fixed bug where selections from removed data elements persisted.
  315. ### Timeline
  316. - `Timeline.redraw()` now also recalculates the size of items.
  317. - Implemented option `snap: function` to customize snapping to nice dates
  318. when dragging items.
  319. - Implemented option `timeAxis: {scale: string, step: number}` to set a
  320. fixed scale.
  321. - Fixed width of range items not always being maintained when moving due to
  322. snapping to nice dates.
  323. - Fixed not being able to drag items to an other group on mobile devices.
  324. - Fixed `setWindow` not working when applying an interval larger than the
  325. configured `zoomMax`.
  326. ### DataSet/DataView
  327. - Added property `length` holding the total number of items to the `DataSet`
  328. and `DataView`.
  329. - Added a method `refresh()` to the `DataView`, to update filter results.
  330. - Fixed a bug in the `DataSet` returning an empty object instead of `null` when
  331. no item was found when using both a filter and specifying fields.
  332. ## 2015-01-16, version 3.9.1
  333. ### General
  334. - Fixed wrong distribution file deployed on the website and the downloadable
  335. zip file.
  336. ### Network
  337. - Fixed bug where opening a cluster with smoothCurves off caused one child to go crazy.
  338. - Fixed bug where zoomExtent does not work as expected.
  339. - Fixed nodes color data being overridden when having a group and a dataset update query.
  340. - Decoupled animation from physics simulation.
  341. - Fixed scroll being blocked if zoomable is false.
  342. ## 2015-01-16, version 3.9.0
  343. ### Network
  344. - Reverted change in image class, fixed bug #552
  345. - Improved (not neccesarily fixed) the fontFill offset between different browsers. #365
  346. - Fixed dashed lines on firefox on Unix systems
  347. - Altered the Manipulation Mixin to be succesfully destroyed from memory when calling destroy();
  348. - Improved drawing of arrowheads on smooth curves. #349
  349. - Caught case where click originated on external DOM element and drag progressed to vis.
  350. - Added label stroke support to Nodes, Edges & Groups as per-object or global settings. Thank you @klmdb!
  351. - Reverted patch that made nodes return to 'default' setting if no group was assigned to fix issue #561. The correct way to 'remove' a group from a node is to assign it a different one.
  352. - Made the node/edge selected by the popup system the same as selected by the click-to-select system. Thank you @pavlos256!
  353. - Improved edit edge control nodes positions, altered style a little.
  354. - Fixed issue #564 by resetting state to initial when no callback is performed in the return function.
  355. - Added condition to Repulsion similar to BarnesHut to ensure nodes do not overlap.
  356. - Added labelAlignment option to edges. Thanks @T-rav!
  357. - Close active sessions in dataManipulation when calling setData().
  358. - Fixed alignment issue with edgelabels
  359. ### Timeline
  360. - Added byUser flag to options of the rangechange and rangechanged event.
  361. ## 2015-01-09, version 3.8.0
  362. ### General
  363. - Updated to moment.js v2.9.0
  364. ### Network
  365. - Fixed flipping of hierarchical network on update when using RL and DU.
  366. - Added zoomExtentOnStabilize option to network.
  367. - Improved destroy function, added them to the examples.
  368. - Nodes now have bounding boxes that are used for zoomExtent.
  369. - Made physics more stable (albeit a little slower).
  370. - Added a check so only one 'activator' overlay is created on clickToUse.
  371. - Made global color options for edges overrule the inheritColors.
  372. - Improved cleaning up of the physics configuration on destroy and in options.
  373. - Made nodes who lost their group revert back to default color.
  374. - Changed group behaviour, groups now extend the options, not replace. This allows partial defines of color.
  375. - Fixed bug where box shaped nodes did not use hover color.
  376. - Fixed Locales docs.
  377. - When hovering over a node that does not have a title, the title of one of the connected edges that HAS a title is no longer shown.
  378. - Fixed error in repulsion physics model.
  379. - Improved physics handling for smoother network simulation.
  380. - Fixed infinite loop when an image can not be found and no brokenImage is provided.
  381. - Added getBoundingBox method.
  382. - Community fix for SVG images in IE11, thanks @dponch!
  383. - Fixed repeating stabilized event when the network is already stabilized.
  384. - Added circularImages, thanks for the contribution @brendon1982!
  385. - Stopped infinite loop when brokenImage is also not available.
  386. - Changed util color functions so they don't need eval. Thanks @naskooskov!
  387. ### Graph2d
  388. - Fixed round-off errors of zero on the y-axis.
  389. - added show major/minor lines options to dataAxis.
  390. - Fixed adapting to width and height changes.
  391. - Added a check so only one 'activator' overlay is created on clickToUse.
  392. - DataAxis width option now draws correctly.
  393. ### Timeline
  394. - Implemented support for styling of the vertical grid.
  395. - Support for custom date formatting of the labels on the time axis.
  396. - added show major/minor lines options to timeline.
  397. - Added a check so only one 'activator' overlay is created on clickToUse.
  398. ### Graph3d
  399. - Fixed mouse coordinates for tooltips.
  400. ## 2014-12-09, version 3.7.2
  401. ### Timeline
  402. - Fixed zooming issue on mobile devices.
  403. ### Graph2D
  404. - Fixed infinite loop when clearing DataSet
  405. ### Network
  406. - Sidestepped double touch event from hammer (ugly.. but functional) causing
  407. strange behaviour in manipulation mode
  408. - Better cleanup after reconnecting edges in manipulation mode
  409. - Fixed recursion error with smooth edges that are connected to non-existent nodes
  410. - Added destroy method.
  411. ## 2014-11-28, version 3.7.1
  412. ### Timeline
  413. - Implemented selection of a range of items using Shift+Click.
  414. - Fixed content in range items may overflow range after zoom.
  415. - Fixed onAdd/onUpdate callbacks when using a DataView (thanks @motzel).
  416. - Fixed configuring either `start` or `end`.
  417. - Fixed Timeline and Graph2d getting stuck in an infinite loop in some
  418. circumstances.
  419. - Fixed background items being selectable and editable when a height is set.
  420. ### Graph2D
  421. - Added `alignZeros` option to dataAxis with default value true.
  422. - Fixed bug with points drawn on bargraphs
  423. - Fixed docs
  424. - Fixed height increase on scrolling if only `graphHeight` is defined.
  425. ### Network
  426. - dragEnd event now does not give the selected nodes if only the viewport has been dragged #453
  427. - merged high DPI fix by @crubier, thanks!
  428. ## 2014-11-14, version 3.7.0
  429. ### Graph2D
  430. - Added points style for scatterplots and pointclouds.
  431. - Modularized the Graph2D draw styles.
  432. - Added a finishedRedraw event.
  433. ### Network
  434. - Added pointer properties to the click and the doubleClick events containing the XY coordinates in DOM and canvas space.
  435. - Removed IDs from navigation so multiple networks can be shown on the same page. (#438)
  436. ### Timeline
  437. - Added a finishedRedraw event.
  438. - Fixed the disappearing item bug.
  439. - Fixed keycharm issue.
  440. ## 2014-11-07, version 3.6.4
  441. ### General
  442. - Removed mousetrap due to Apache license, created keycharm and implemented it with vis.
  443. ### Timeline
  444. - Fixed height of background items when having a fixed or max height defined.
  445. - Fixed only one item being dragged when multiple items are selected.
  446. - Optimised a serious slowdown on performance since hidden dates.
  447. ### Network
  448. - Fixed onRelease with navigation option.
  449. - Fixed arrow heads not being colored.
  450. ### Graph2D
  451. - Fixed cleaning up of groups.
  452. - Throw error message when items are added before groups.
  453. - Made graphHeight automatic if height is defined AND if graphHeight is smaller than the center panel when height is defined as well.
  454. - Added new verticalDrag event for internal use, allowing the vertical scrolling of the grid lines on drag.
  455. - Fixed moving legend when postioned on the bottom and vertical dragging.
  456. - Optimised a serious slowdown on performance since hidden dates.
  457. - Accepted a large pull request from @cdjackson adding the following features (thank you!):
  458. - Titles on the DataAxis to explain what units you are using.
  459. - A style field for groups and datapoints so you can dynamically change styles.
  460. - A precision option to manually set the amount of decimals.
  461. - Two new examples showing the new features.
  462. ## 2014-10-28, version 3.6.3
  463. ### Timeline
  464. - Fixed background items not always be cleared when removing them.
  465. - Fixed visible items not always be displayed.
  466. - Performance improvements when doing a lot of changes at once in a DataSet.
  467. ### Network
  468. - Fixed dashed and arrow lines not using inheritColor.
  469. ### DataSet
  470. - Support for queueing of changes, and flushing them at once.
  471. - Implemented `DataSet.setOptions`. Only applicable for the `queue` options.
  472. ## 2014-10-24, version 3.6.2
  473. - Vis.js is now dual licensed under both Apache 2.0 and MIT.
  474. ## 2014-10-22, version 3.6.1
  475. ### Timeline
  476. - Fixed uneven stepsized with hidden dates.
  477. - Fixed multiple bugs with regards to hidden dates.
  478. - Fixed subgroups and added subgroup sorting. Subgroup labels will be in future releases.
  479. ## 2014-10-21, version 3.6.0
  480. ### Network
  481. - Title of nodes and edges can now be an HTML element too.
  482. - Renamed storePosition to storePositions. Added deprication message and old name still works.
  483. - Worked around hammer.js bug with multiple release listeners.
  484. - Improved cleaning up after manipulation toolbar.
  485. - Added getPositions() method to get the position of all nodes or some of them if specific Ids are supplied.
  486. - Added getCenterCoordinates() method to get the x and y position in canvas space of the center of the view.
  487. - Fixed node label becoming undefined.
  488. - Fixed cluster fontsize scaling.
  489. - Fixed cluster sector scaling.
  490. - Added oldHeight and oldWidth to resize event.
  491. ### Timeline
  492. - Implemented field `style` for both items and groups, to set a custom style for
  493. individual items.
  494. - Fixed height of BackgroundItems not being 100% when timeline has a fixed height.
  495. - Fixed width of BackgroundItems not being reduced to 0 when zooming out.
  496. - Fixed onclick events in items not working.
  497. - Added hiddenDates to hide specific times and/or days in the timeline.
  498. ### DataSet
  499. - Event listeners of `update` now receive an extra property `data`,
  500. containing the changed fields of the changed items.
  501. ### Graph2d
  502. - Fixed height of legend when there are many items showing.
  503. ### Graph3d
  504. - Implemented options `xValueLabel`, `yValueLabel` and `zValueLabel` for custom labels along
  505. the x, y, z axis. Thanks @fabriziofortino.
  506. ## 2014-09-16, version 3.5.0
  507. ### Network
  508. - Fixed nodes not always being unfixed when using allowedToMove.
  509. - Added dragStart and dragEnd events.
  510. - Added edge selection on edge labels.
  511. ### Graph2d
  512. - Fixed dataAxis not showing large numbers correctly.
  513. ## 2014-09-12, version 3.4.2
  514. ### Network
  515. - Changed timings for zoomExtent animation.
  516. - Fixed possible cause of freezing graph when animating.
  517. - Added locked to focusOnNode and releaseNode().
  518. - Fixed minor bug in positioning of fontFill of nodes with certain shapes.
  519. - Added startStabilization event.
  520. ## 2014-09-11, version 3.4.1
  521. ### Network
  522. - Fix for introduced bug on zoomExtent navigation button.
  523. - Added animation to zoomExtent navigation button.
  524. - Improved cleaning of Hammer.js bindings.
  525. ### Timeline
  526. - Fixed a bug in IE freezing when margin.item and margin.axis where both 0.
  527. ## 2014-09-10, version 3.4.0
  528. ### Graph2d
  529. - Fixed moment.js url in localization example.
  530. ### Network
  531. - Fixed some positioning issues with the close button of the manipulation menu.
  532. - Added fontFill to Nodes as it is in Edges.
  533. - Implemented support for broken image fallback. Thanks @sfairgrieve.
  534. - Added multiline labels to edges as they are implemented in nodes. Updated
  535. multiline example to show this.
  536. - Added animation and camera controls by the method .moveTo()
  537. - Added new event that fires when the animation is finished.
  538. - Added new example showing the new features of animation.
  539. - Added getScale() method.
  540. ### Timeline
  541. - Implemented support for templates.
  542. - Implemented a new item type: `'background'`. This can be used to mark periods
  543. with a background color and label.
  544. - Implemented support for attaching HTML attributes to items. Thanks @dturkenk.
  545. - Fixed moment.js url in localization example.
  546. - Fixed `className` of groups not being updated when changed.
  547. - Fixed the `id` field of a new item not correctly generated.
  548. - Fixed newly added item ignored when returning an other object instance.
  549. - Fixed option `autoResize` not working on IE in case of changing visibility
  550. of the Timeline container element.
  551. - Fixed an overflow issue with the dots of BoxItems when using groups.
  552. - Fixed a horizontal 1-pixel offset in the items (border width wasn't taken into
  553. account).
  554. - Renamed internal items from `ItemBox`, `ItemRange`, and `ItemPoint` to
  555. respectively `BoxItem`, `RangeItem`, and `PointItem`.
  556. - Fixed an error thrown when calling `destroy()`.
  557. ## 2014-08-29, version 3.3.0
  558. ### Timeline
  559. - Added localization support.
  560. - Implemented option `clickToUse`.
  561. - Implemented function `focus(id)` to center a specific item (or multiple items)
  562. on screen.
  563. - Implemented an option `focus` for `setSelection(ids, options)`, to immediately
  564. focus selected nodes.
  565. - Implemented function `moveTo(time, options)`.
  566. - Implemented animated range change for functions `fit`, `focus`, `setSelection`,
  567. and `setWindow`.
  568. - Implemented functions `setCurrentTime(date)` and `getCurrentTime()`.
  569. - Implemented a new callback function `onMoving(item, callback)`.
  570. - Implemented support for option `align` for range items.
  571. - Fixed the `change` event sometimes being fired twice on IE10.
  572. - Fixed canceling moving an item to another group did not move the item
  573. back to the original group.
  574. - Fixed the `change` event sometimes being fired twice on IE10.
  575. - Fixed canceling moving an item to another group did not move the item
  576. back to the original group.
  577. ### Network
  578. - A fix in reading group properties for a node.
  579. - Fixed physics solving stopping when a support node was not moving.
  580. - Implemented localization support.
  581. - Implemented option `clickToUse`.
  582. - Improved the `stabilized` event, it's now firing after every stabilization
  583. with iteration count as parameter.
  584. - Fixed page scroll event not being blocked when moving around in Network
  585. using arrow keys.
  586. - Fixed an initial rendering before the graph has been stabilized.
  587. - Fixed bug where loading hierarchical data after initialization crashed network.
  588. - Added different layout method to the hierarchical system based on the direction of the edges.
  589. ### Graph2d
  590. - Implemented option `handleOverlap` to support overlap, sideBySide and stack.
  591. - Implemented two examples showing the `handleOverlap` functionality.
  592. - Implemented `customRange` for the Y axis and an example showing how it works.
  593. - Implemented localization support.
  594. - Implemented option `clickToUse`.
  595. - Implemented functions `setCurrentTime(date)` and `getCurrentTime()`.
  596. - Implemented function `moveTo(time, options)`.
  597. - Fixed bugs.
  598. - Added groups.visibility functionality and an example showing how it works.
  599. ## 2014-08-14, version 3.2.0
  600. ### General
  601. - Refactored Timeline and Graph2d to use the same core.
  602. ### Graph2d
  603. - Added `visible` property to the groups.
  604. - Added `getLegend()` method.
  605. - Added `isGroupVisible()` method.
  606. - Fixed empty group bug.
  607. - Added `fit()` and `getItemRange()` methods.
  608. ### Timeline
  609. - Fixed items in groups sometimes being displayed but not positioned correctly.
  610. - Fixed a group "null" being displayed in IE when not using groups.
  611. ### Network
  612. - Fixed mass = 0 for nodes.
  613. - 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.
  614. - Disabled inheritColor when color information is set on an edge.
  615. - Tweaked examples.
  616. - 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.
  617. - Removed global edge length definition form examples.
  618. - Removed onclick and onrelease for navigation and switched to Hammer.js (fixing touchscreen interaction with navigation).
  619. - Fixed error on adding an edge without having created the nodes it should be connected to (in the case of dynamic smooth curves).
  620. ## 2014-07-22, version 3.1.0
  621. ### General
  622. - Refactored the code to commonjs modules, which are browserifyable. This allows
  623. to create custom builds.
  624. ### Timeline
  625. - Implemented function `getVisibleItems()`, which returns the items visible
  626. in the current window.
  627. - Added options `margin.item.horizontal` and `margin.item.vertical`, which
  628. allows to specify different margins horizontally/vertically.
  629. - Removed check for number of arguments in callbacks `onAdd`, `onUpdate`,
  630. `onRemove`, and `onMove`.
  631. - Fixed items in groups sometimes being displayed but not positioned correctly.
  632. - Fixed range where the `end` of the first is equal to the `start` of the second
  633. sometimes being stacked instead of put besides each other when `item.margin=0`
  634. due to round-off errors.
  635. ### Network (formerly named Graph)
  636. - Expanded smoothCurves options for improved support for large clusters.
  637. - Added multiple types of smoothCurve drawing for greatly improved performance.
  638. - Option for inherited edge colors from connected nodes.
  639. - Option to disable the drawing of nodes or edges on drag.
  640. - Fixed support nodes not being cleaned up if edges are removed.
  641. - Improved edge selection detection for long smooth curves.
  642. - Fixed dot radius bug.
  643. - Updated max velocity of nodes to three times it's original value.
  644. - Made "stabilized" event fire every time the network stabilizes.
  645. - Fixed drift in dragging nodes while zooming.
  646. - Fixed recursively constructing of hierarchical layouts.
  647. - Added borderWidth option for nodes.
  648. - Implemented new Hierarchical view solver.
  649. - Fixed an issue with selecting nodes when the web page is scrolled down.
  650. - Added Gephi JSON parser
  651. - Added Neighbour Highlight example
  652. - Added Import From Gephi example
  653. - Enabled color parsing for nodes when supplied with rgb(xxx,xxx,xxx) value.
  654. ### DataSet
  655. - Added .get() returnType option to return as JSON object, Array or Google
  656. DataTable.
  657. ## 2014-07-07, version 3.0.0
  658. ### Timeline
  659. - Implemented support for displaying a `title` for both items and groups.
  660. - Fixed auto detected item type being preferred over the global item `type`.
  661. - Throws an error when constructing without new keyword.
  662. - Removed the 'rangeoverflow' item type. Instead, one can use a regular range
  663. and change css styling of the item contents to:
  664. .vis.timeline .item.range .content {
  665. overflow: visible;
  666. }
  667. - Fixed the height of background and foreground panels of groups.
  668. - Fixed ranges in the Timeline sometimes overlapping when dragging the Timeline.
  669. - Fixed `DataView` not working in Timeline.
  670. ### Network (formerly named Graph)
  671. - Renamed `Graph` to `Network` to prevent confusion with the visualizations
  672. `Graph2d` and `Graph3d`.
  673. - Renamed option `dragGraph` to `dragNetwork`.
  674. - Now throws an error when constructing without new keyword.
  675. - Added pull request from Vukk, user can now define the edge width multiplier
  676. when selected.
  677. - Fixed `graph.storePositions()`.
  678. - Extended Selection API with `selectNodes` and `selectEdges`, deprecating
  679. `setSelection`.
  680. - Fixed multiline labels.
  681. - Changed hierarchical physics solver and updated docs.
  682. ### Graph2d
  683. - Added first iteration of the Graph2d.
  684. ### Graph3d
  685. - Now throws an error when constructing without new keyword.
  686. ## 2014-06-19, version 2.0.0
  687. ### Timeline
  688. - Implemented function `destroy` to neatly cleanup a Timeline.
  689. - Implemented support for dragging the timeline contents vertically.
  690. - Implemented options `zoomable` and `moveable`.
  691. - Changed default value of option `showCurrentTime` to true.
  692. - Internal refactoring and simplification of the code.
  693. - Fixed property `className` of groups not being applied to related contents and
  694. background elements, and not being updated once applied.
  695. ### Graph
  696. - Reduced the timestep a little for smoother animations.
  697. - Fixed dataManipulation.initiallyVisible functionality (thanks theGrue).
  698. - Forced typecast of fontSize to Number.
  699. - Added editing of edges using the data manipulation toolkit.
  700. ### DataSet
  701. - Renamed option `convert` to `type`.
  702. ## 2014-06-06, version 1.1.0
  703. ### Timeline
  704. - Select event now triggers repeatedly when selecting an already selected item.
  705. - Renamed `Timeline.repaint()` to `Timeline.redraw()` to be consistent with
  706. the other visualisations of vis.js.
  707. - Fixed `Timeline.clear()` not resetting a configured `options.start` and
  708. `options.end`.
  709. ### Graph
  710. - Fixed error with zero nodes with hierarchical layout.
  711. - Added focusOnNode function.
  712. - Added hover option.
  713. - Added dragNodes option. Renamed movebale to dragGraph option.
  714. - Added hover events (hoverNode, blurNode).
  715. ### Graph3D
  716. - Ported Graph3D from Chap Links Library.
  717. ## 2014-05-28, version 1.0.2
  718. ### Timeline
  719. - Implemented option `minHeight`, similar to option `maxHeight`.
  720. - Implemented a method `clear([what])`, to clear items, groups, and configuration
  721. of a Timeline instance.
  722. - Added function `repaint()` to force a repaint of the Timeline.
  723. - Some tweaks in snapping dragged items to nice dates.
  724. - Made the instance of moment.js packaged with vis.js accessibly via `vis.moment`.
  725. - A newly created item is initialized with `end` property when option `type`
  726. is `"range"` or `"rangeoverflow"`.
  727. - Fixed a bug in replacing the DataSet of groups via `Timeline.setGroups(groups)`.
  728. - Fixed a bug when rendering the Timeline inside a hidden container.
  729. - Fixed axis scale being determined wrongly for a second Timeline in a single page.
  730. ### Graph
  731. - Added zoomable and moveable options.
  732. - Changes setOptions to avoid resetting view.
  733. - Interchanged canvasToDOM and DOMtoCanvas to correspond with the docs.
  734. ## 2014-05-09, version 1.0.1
  735. ### Timeline
  736. - Fixed width of items with type `rangeoverflow`.
  737. - Fixed a bug wrongly rendering invisible items after updating them.
  738. ### Graph
  739. - Added coordinate conversion from DOM to Canvas.
  740. - Fixed bug where the graph stopped animation after settling in playing with physics.
  741. - Fixed bug where hierarchical physics properties were not handled.
  742. - Added events for change of view and zooming.
  743. ## 2014-05-02, version 1.0.0
  744. ### Timeline
  745. - Large refactoring of the Timeline, simplifying the code.
  746. - Great performance improvements.
  747. - Improved layout of box-items inside groups.
  748. - Items can now be dragged from one group to another.
  749. - Implemented option `stack` to enable/disable stacking of items.
  750. - Implemented function `fit`, which sets the Timeline window such that it fits
  751. all items.
  752. - Option `editable` can now be used to enable/disable individual manipulation
  753. actions (`add`, `updateTime`, `updateGroup`, `remove`).
  754. - Function `setWindow` now accepts an object with properties `start` and `end`.
  755. - Fixed option `autoResize` forcing a repaint of the Timeline with every check
  756. rather than when the Timeline is actually resized.
  757. - Fixed `select` event fired repeatedly when clicking an empty place on the
  758. Timeline, deselecting selected items).
  759. - Fixed initial visible window in case items exceed `zoomMax`. Thanks @Remper.
  760. - Fixed an offset in newly created items when using groups.
  761. - Fixed height of a group not reckoning with the height of the group label.
  762. - Option `order` is now deprecated. This was needed for performance improvements.
  763. - More examples added.
  764. - Minor bug fixes.
  765. ### Graph
  766. - Added recalculate hierarchical layout to update node event.
  767. - Added arrowScaleFactor to scale the arrows on the edges.
  768. ### DataSet
  769. - A DataSet can now be constructed with initial data, like
  770. `new DataSet(data, options)`.
  771. ## 2014-04-18, version 0.7.4
  772. ### Graph
  773. - Fixed IE9 bug.
  774. - Style fixes.
  775. - Minor bug fixes.
  776. ## 2014-04-16, version 0.7.3
  777. ### Graph
  778. - Fixed color bug.
  779. - Added pull requests from kannonboy and vierja: tooltip styling, label fill
  780. color.
  781. ## 2014-04-09, version 0.7.2
  782. ### Graph
  783. - Fixed edge select bug.
  784. - Fixed zoom bug on empty initialization.
  785. ## 2014-03-27, version 0.7.1
  786. ### Graph
  787. - Fixed edge color bug.
  788. - Fixed select event bug.
  789. - Clarified docs, stressing importance of css inclusion for correct display of
  790. navigation an manipulation icons.
  791. - Improved and expanded playing with physics (configurePhysics option).
  792. - Added highlights to navigation icons if the corresponding key is pressed.
  793. - Added freezeForStabilization option to improve stabilization with cached
  794. positions.
  795. ## 2014-03-07, version 0.7.0
  796. ### Graph
  797. - Changed navigation CSS. Icons are now always correctly positioned.
  798. - Added stabilizationIterations option to graph.
  799. - Added storePosition() method to save the XY positions of nodes in the DataSet.
  800. - Separated allowedToMove into allowedToMoveX and allowedToMoveY. This is
  801. required for initializing nodes from hierarchical layouts after
  802. storePosition().
  803. - Added color options for the edges.
  804. ## 2014-03-06, version 0.6.1
  805. ### Graph
  806. - Bugfix graphviz examples.
  807. - Bugfix labels position for smooth curves.
  808. - Tweaked graphviz example physics.
  809. - Updated physics documentation to stress importance of configurePhysics.
  810. ### Timeline
  811. - Fixed a bug with options `margin.axis` and `margin.item` being ignored when
  812. setting them to zero.
  813. - Some clarifications in the documentation.
  814. ## 2014-03-05, version 0.6.0
  815. ### Graph
  816. - Added Physics Configuration option. This makes tweaking the physics system to
  817. suit your needs easier.
  818. - Click and doubleClick events.
  819. - Initial zoom bugfix.
  820. - Directions for Hierarchical layout.
  821. - Refactoring and bugfixes.
  822. ## 2014-02-20, version 0.5.1
  823. - Fixed broken bower module.
  824. ## 2014-02-20, version 0.5.0
  825. ### Timeline
  826. - Editable Items: drag items, add new items, update items, and remove items.
  827. - Implemented options `selectable`, `editable`.
  828. - Added events `timechange` and `timechanged` when dragging the custom time bar.
  829. - Multiple items can be selected using ctrl+click or shift+click.
  830. - Implemented functions `setWindow(start, end)` and `getWindow()`.
  831. - Fixed scroll to zoom not working on IE in standards mode.
  832. ### Graph
  833. - Editable nodes and edges: create, update, and remove them.
  834. - Support for smooth, curved edges (on by default).
  835. - Performance improvements.
  836. - Fixed scroll to zoom not working on IE in standards mode.
  837. - Added hierarchical layout option.
  838. - Overhauled physics system, now using Barnes-Hut simulation by default. Great
  839. performance gains.
  840. - Modified clustering system to give better results.
  841. - Adaptive performance system to increase visual performance (60fps target).
  842. ### DataSet
  843. - Renamed functions `subscribe` and `unsubscribe` to `on` and `off` respectively.
  844. ## 2014-01-31, version 0.4.0
  845. ### Timeline
  846. - Implemented functions `on` and `off` to create event listeners for events
  847. `rangechange`, `rangechanged`, and `select`.
  848. - Implemented function `select` to get and set the selected items.
  849. - Items can be selected by clicking them, muti-select by holding them.
  850. - Fixed non working `start` and `end` options.
  851. ### Graph
  852. - Fixed longstanding bug in the force calculation, increasing simulation
  853. stability and fluidity.
  854. - Reworked the calculation of the Graph, increasing performance for larger
  855. datasets (up to 10x!).
  856. - Support for automatic clustering in Graph to handle large (>50000) datasets
  857. without losing performance.
  858. - Added automatic initial zooming to Graph, to more easily view large amounts
  859. of data.
  860. - Added local declustering to Graph, freezing the simulation of nodes outside
  861. of the cluster.
  862. - Added support for key-bindings by including mouseTrap in Graph.
  863. - Added navigation controls.
  864. - Added keyboard navigation.
  865. - Implemented functions `on` and `off` to create event listeners for event
  866. `select`.
  867. ## 2014-01-14, version 0.3.0
  868. - Moved the generated library to folder `./dist`
  869. - Css stylesheet must be loaded explicitly now.
  870. - Implemented options `showCurrentTime` and `showCustomTime`. Thanks @fi0dor.
  871. - Implemented touch support for Timeline.
  872. - Fixed broken Timeline options `min` and `max`.
  873. - Fixed not being able to load vis.js in node.js.
  874. ## 2013-09-20, version 0.2.0
  875. - Implemented full touch support for Graph.
  876. - Fixed initial empty range in the Timeline in case of a single item.
  877. - Fixed field `className` not working for items.
  878. ## 2013-06-20, version 0.1.0
  879. - Added support for DataSet to Graph. Graph now uses an id based set of nodes
  880. and edges instead of a row based array internally. Methods getSelection and
  881. setSelection of Graph now accept a list with ids instead of rows.
  882. - Graph is now robust against edges pointing to non-existing nodes, which
  883. can occur easily while dynamically adding/removing nodes and edges.
  884. - Implemented basic support for groups in the Timeline.
  885. - Added documentation on DataSet and DataView.
  886. - Fixed selection of nodes in a Graph when the containing web page is scrolled.
  887. - Improved date conversion.
  888. - Renamed DataSet option `fieldTypes` to `convert`.
  889. - Renamed function `vis.util.cast` to `vis.util.convert`.
  890. ## 2013-06-07, version 0.0.9
  891. - First working version of the Graph imported from the old library.
  892. - Documentation added for both Timeline and Graph.
  893. ## 2013-05-03, version 0.0.8
  894. - Performance improvements: only visible items are rendered.
  895. - Minor bug fixes and improvements.
  896. ## 2013-04-25, version 0.0.7
  897. - Sanitized the published packages on npm and bower.
  898. ## 2013-04-25, version 0.0.6
  899. - Css is now packaged in the javascript file, and automatically loaded.
  900. - The library uses node style dependency management for modules now, used
  901. with Browserify.
  902. ## 2013-04-16, version 0.0.5
  903. - First working version of the Timeline.
  904. - Website created.