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.

164 lines
8.3 KiB

  1. <!DOCTYPE html>
  2. <html lang="en"><head>
  3. <meta charset="utf-8">
  4. <meta http-equiv="X-UA-Compatible" content="IE=edge">
  5. <meta name="viewport" content="width=device-width, initial-scale=1">
  6. <meta name="description" content="">
  7. <meta name="author" content="">
  8. <link rel="icon" HREF="favicon.ico">
  9. <title>vis.js - A dynamic, browser based visualization library.</title>
  10. <!-- Bootstrap core CSS -->
  11. <link href="../css/bootstrap.css" rel="stylesheet">
  12. <link href="../css/newdocs.css" rel="stylesheet">
  13. <!-- HTML5 shim and Respond.js for IE8 support of HTML5 elements and media queries -->
  14. <!--[if lt IE 9]>
  15. <script src="https://oss.maxcdn.com/html5shiv/3.7.2/html5shiv.min.js"></script>
  16. <script src="https://oss.maxcdn.com/respond/1.4.2/respond.min.js"></script>
  17. <![endif]-->
  18. <link href="../css/prettify.css" type="text/css" rel="stylesheet"/>
  19. <script type="text/javascript" src="../js/googleAnalytics.js"></script>
  20. <script type="text/javascript" src="../js/prettify/prettify.js"></script>
  21. <script src="../js/smooth-scroll.min.js"></script>
  22. <script language="JavaScript">
  23. smoothScroll.init();
  24. </script>
  25. <script type="text/javascript" src="../js/toggleTable.js"></script>
  26. </head>
  27. <body onload="prettyPrint();">
  28. <div class="navbar-wrapper">
  29. <div class="container">
  30. <nav class="navbar navbar-inverse navbar-static-top" role="navigation">
  31. <div class="container">
  32. <div class="navbar-header">
  33. <button type="button" class="navbar-toggle collapsed" data-toggle="collapse" data-target="#navbar"
  34. aria-expanded="false" aria-controls="navbar">
  35. <span class="sr-only">Toggle navigation</span>
  36. <span class="icon-bar"></span>
  37. <span class="icon-bar"></span>
  38. <span class="icon-bar"></span>
  39. </button>
  40. <a class="navbar-brand hidden-sm" href="./index.html">vis.js</a>
  41. </div>
  42. <div id="navbar" class="navbar-collapse collapse">
  43. <ul class="nav navbar-nav">
  44. <li><a href="http://www.visjs.org/index.html#modules">Modules</a></li>
  45. <li class="active"><a href="./docs/index.html" target="_blank">Documentation <img class="icon"
  46. src="../img/external-link-icons/external-link-icon-white.png"></a>
  47. </li>
  48. <li><a href="http://www.visjs.org/blog.html">Blog</a></li>
  49. <li><a href="http://www.visjs.org/index.html#download_install">Download</a></li>
  50. <li><a href="http://www.visjs.org/showcase/index.html">Showcase</a></li>
  51. <li><a href="http://www.visjs.org/index.html#contribute">Contribute</a></li>
  52. <li><a href="http://www.visjs.org/featureRequests.html">Feature requests</a></li>
  53. <li><a href="http://www.visjs.org/index.html#licenses">License</a></li>
  54. </ul>
  55. </div>
  56. </div>
  57. </nav>
  58. </div>
  59. </div>
  60. <a href="https://github.com/almende/vis" class="hidden-xs hidden-sm hidden-md"><img style="position: absolute; top: 0; right: 0; border: 0;" src="https://camo.githubusercontent.com/38ef81f8aca64bb9a64448d0d70f1308ef5341ab/68747470733a2f2f73332e616d617a6f6e6177732e636f6d2f6769746875622f726962626f6e732f666f726b6d655f72696768745f6461726b626c75655f3132313632312e706e67" alt="Fork me on GitHub" data-canonical-src="https://s3.amazonaws.com/github/ribbons/forkme_right_darkblue_121621.png"></a>
  61. <div class="container full">
  62. <h1>Network - view</h1>
  63. <p>Acts as the camera that looks on the canvas. Does the animation, zooming and focusing.</p>
  64. <h3>Options</h3>
  65. <p>The view has no options.</p>
  66. <h3>Methods</h3>
  67. <p>This is a list of all the methods in the public API. Options can be set directly to the module or you can use the setOptions method of the network itself and use the module name as an object name.</p>
  68. <table>
  69. <tr class="header"><td class="methodName">name</td><td>returns</td><td>description</td></tr>
  70. <tr><td>getScale()</td> <td class="mid">Number</td><td>Returns the current scale of the network. 1.0 is comparible to 100%, 0 is zoomed out infinitely.</td></tr>
  71. <tr><td>getPosition()</td> <td class="mid">Number</td><td>Returns the current central focus point of the camera.</td></tr>
  72. <tr><td>fit(<code>[Object options]</code>)</td><td class="mid">none</td><td>Zooms out so all nodes fit on the canvas. You can supply options to customize this:
  73. <pre class="code">
  74. {
  75. nodes:[Array of nodeIds],
  76. animation: { // -------------------> can be a boolean too!
  77. duration: Number
  78. easingFunction: String
  79. }
  80. }
  81. </pre>
  82. The nodes can be used to zoom to fit only specific nodes in the view. <br /><br />
  83. The other options are explained in the <code>moveTo()</code> description below.
  84. All options are optional for the fit method.
  85. </td></tr>
  86. <tr><td>focus(<br>
  87. &nbsp;&nbsp;&nbsp;<code>String nodeId</code>,<br>
  88. &nbsp;&nbsp;&nbsp;<code>[Object options]</code><br>)</td><td class="mid">none</td>
  89. <td>You can focus on a node with this function. What that means is the view will lock onto that node, if it is moving, the view will also move accordingly. If the view is dragged by the user, the focus is broken.
  90. You can supply options to customize the effect:
  91. <pre class="code">
  92. {
  93. scale: Number,
  94. offset: {x:Number, y:Number}
  95. locked: boolean
  96. animation: { // -------------------> can be a boolean too!
  97. duration: Number
  98. easingFunction: String
  99. }
  100. }
  101. </pre>
  102. All options except for locked are explained in the <code>moveTo()</code> description below. Locked denotes whether or not the view remains locked to the node once the zoom-in animation is finished. Default value is true. The options object is optional in the focus method.</td></tr>
  103. <tr><td>moveTo(<code>Object options</code>)</td> <td class="mid">none</td><td>You can animate or move the camera using the moveTo method. Options are:
  104. <pre class="code">
  105. {
  106. position: {x:Number, y:Number},
  107. scale: Number,
  108. offset: {x:Number, y:Number}
  109. animation: { // -------------------> can be a boolean too!
  110. duration: Number
  111. easingFunction: String
  112. }
  113. }
  114. </pre>
  115. The position (in canvas units!) is the position of the central focus point of the camera. <br><br>
  116. The scale is the target zoomlevel. Default value is 1.0. <br><br>
  117. The offset (in DOM units) is how many pixels from the center the view is focussed. Default value is {x:0,y:0}.<br><br>
  118. For animation you can either use a Boolean to use it with the default options or disable it or you can define the duration (in milliseconds) and easing function manually. Available are:
  119. <code>linear, easeInQuad, easeOutQuad, easeInOutQuad, easeInCubic, easeOutCubic, easeInOutCubic, easeInQuart, easeOutQuart, easeInOutQuart, easeInQuint, easeOutQuint, easeInOutQuint</code>. <br><br>
  120. <i>You will have to define at least a scale or a position. Otherwise, there is nothing to move to.</i>
  121. </td></tr>
  122. <tr><td>releaseNode()</td><td class="mid">none</td><td>Programatically release the focussed node.</td></tr>
  123. </table>
  124. <h3>Events</h3>
  125. <p>These events are fired by the renderer and can be used to move and draw custom elements on the same canvas as the rest of the network.</p>
  126. <table>
  127. <tr class="header"><td>name</td><td class="properties">properties</td><td>description</td></tr>
  128. <tr><td>animationFinished</td><td class="mid">none</td><td>Fired when an animation is finished.</td>
  129. </table>
  130. <br />
  131. <br />
  132. <br />
  133. <br />
  134. <br />
  135. <br />
  136. <br />
  137. </div>
  138. <!-- Bootstrap core JavaScript
  139. ================================================== -->
  140. <!-- Placed at the end of the document so the pages load faster -->
  141. <script src="../js/jquery.min.js"></script>
  142. <script src="../js/bootstrap.min.js"></script>
  143. <!-- IE10 viewport hack for Surface/desktop Windows 8 bug -->
  144. <script src="../js/ie10-viewport-bug-workaround.js"></script>