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.

400 lines
12 KiB

9 years ago
9 years ago
  1. var util = require('../../../util');
  2. import Label from './shared/Label'
  3. import Box from './nodes/shapes/Box'
  4. import Circle from './nodes/shapes/Circle'
  5. import CircularImage from './nodes/shapes/CircularImage'
  6. import Database from './nodes/shapes/Database'
  7. import Diamond from './nodes/shapes/Diamond'
  8. import Dot from './nodes/shapes/Dot'
  9. import Ellipse from './nodes/shapes/Ellipse'
  10. import Icon from './nodes/shapes/Icon'
  11. import Image from './nodes/shapes/Image'
  12. import Square from './nodes/shapes/Square'
  13. import Star from './nodes/shapes/Star'
  14. import Text from './nodes/shapes/Text'
  15. import Triangle from './nodes/shapes/Triangle'
  16. import TriangleDown from './nodes/shapes/TriangleDown'
  17. import Validator from "../Validator";
  18. import {printStyle} from "../Validator";
  19. /**
  20. * @class Node
  21. * A node. A node can be connected to other nodes via one or multiple edges.
  22. * @param {object} options An object containing options for the node. All
  23. * options are optional, except for the id.
  24. * {number} id Id of the node. Required
  25. * {string} label Text label for the node
  26. * {number} x Horizontal position of the node
  27. * {number} y Vertical position of the node
  28. * {string} shape Node shape, available:
  29. * "database", "circle", "ellipse",
  30. * "box", "image", "text", "dot",
  31. * "star", "triangle", "triangleDown",
  32. * "square", "icon"
  33. * {string} image An image url
  34. * {string} title An title text, can be HTML
  35. * {anytype} group A group name or number
  36. * @param {Network.Images} imagelist A list with images. Only needed
  37. * when the node has an image
  38. * @param {Network.Groups} grouplist A list with groups. Needed for
  39. * retrieving group options
  40. * @param {Object} constants An object with default values for
  41. * example for the color
  42. *
  43. */
  44. class Node {
  45. constructor(options, body, imagelist, grouplist, globalOptions) {
  46. this.options = util.bridgeObject(globalOptions);
  47. this.body = body;
  48. this.edges = []; // all edges connected to this node
  49. // set defaults for the options
  50. this.id = undefined;
  51. this.imagelist = imagelist;
  52. this.grouplist = grouplist;
  53. // state options
  54. this.x = undefined;
  55. this.y = undefined;
  56. this.baseSize = this.options.size;
  57. this.baseFontSize = this.options.font.size;
  58. this.predefinedPosition = false; // used to check if initial fit should just take the range or approximate
  59. this.selected = false;
  60. this.hover = false;
  61. this.labelModule = new Label(this.body, this.options);
  62. this.setOptions(options);
  63. }
  64. /**
  65. * Attach a edge to the node
  66. * @param {Edge} edge
  67. */
  68. attachEdge(edge) {
  69. if (this.edges.indexOf(edge) === -1) {
  70. this.edges.push(edge);
  71. }
  72. }
  73. /**
  74. * Detach a edge from the node
  75. * @param {Edge} edge
  76. */
  77. detachEdge(edge) {
  78. var index = this.edges.indexOf(edge);
  79. if (index != -1) {
  80. this.edges.splice(index, 1);
  81. }
  82. }
  83. /**
  84. * Enable or disable the physics.
  85. * @param status
  86. */
  87. togglePhysics(status) {
  88. this.options.physics = status;
  89. }
  90. /**
  91. * Set or overwrite options for the node
  92. * @param {Object} options an object with options
  93. * @param {Object} constants and object with default, global options
  94. */
  95. setOptions(options) {
  96. if (!options) {
  97. return;
  98. }
  99. // basic options
  100. if (options.id !== undefined) {this.id = options.id;}
  101. if (this.id === undefined) {
  102. throw "Node must have an id";
  103. }
  104. if (options.x !== undefined) {this.x = parseInt(options.x); this.predefinedPosition = true;}
  105. if (options.y !== undefined) {this.y = parseInt(options.y); this.predefinedPosition = true;}
  106. if (options.size !== undefined) {this.baseSize = options.size;}
  107. if (options.value !== undefined) {options.value = parseInt(options.value);}
  108. // this transforms all shorthands into fully defined options
  109. Node.parseOptions(this.options, options, true);
  110. // copy group options
  111. if (typeof options.group === 'number' || (typeof options.group === 'string' && options.group != '')) {
  112. var groupObj = this.grouplist.get(options.group);
  113. util.deepExtend(this.options, groupObj);
  114. // the color object needs to be completely defined. Since groups can partially overwrite the colors, we parse it again, just in case.
  115. this.options.color = util.parseColor(this.options.color);
  116. }
  117. // load the images
  118. if (this.options.image !== undefined && this.options.image != "") {
  119. if (this.imagelist) {
  120. this.imageObj = this.imagelist.load(this.options.image, this.options.brokenImage);
  121. }
  122. else {
  123. throw "No imagelist provided";
  124. }
  125. }
  126. this.updateShape();
  127. this.updateLabelModule();
  128. // reset the size of the node, this can be changed
  129. this._reset();
  130. }
  131. /**
  132. * This process all possible shorthands in the new options and makes sure that the parentOptions are fully defined.
  133. * Static so it can also be used by the handler.
  134. * @param parentOptions
  135. * @param newOptions
  136. */
  137. static parseOptions(parentOptions, newOptions, allowDeletion = false) {
  138. var fields = [
  139. 'color',
  140. 'fixed',
  141. 'font',
  142. 'shadow'
  143. ];
  144. util.selectiveNotDeepExtend(fields, parentOptions, newOptions);
  145. // merge the shadow options into the parent.
  146. util.mergeOptions(parentOptions, newOptions, 'shadow');
  147. // individual shape newOptions
  148. if (newOptions.color !== undefined && newOptions.color !== null) {
  149. let parsedColor = util.parseColor(newOptions.color);
  150. util.fillIfDefined(parentOptions.color, parsedColor);
  151. }
  152. else if (allowDeletion === true) {
  153. parentOptions.color = undefined;
  154. delete parentOptions.color;
  155. }
  156. if (newOptions.fixed !== undefined && newOptions.fixed !== null) {
  157. if (typeof newOptions.fixed === 'boolean') {
  158. parentOptions.fixed.x = newOptions.fixed;
  159. parentOptions.fixed.y = newOptions.fixed;
  160. }
  161. else {
  162. if (newOptions.fixed.x !== undefined && typeof newOptions.fixed.x === 'boolean') {
  163. parentOptions.fixed.x = newOptions.fixed.x;
  164. }
  165. if (newOptions.fixed.y !== undefined && typeof newOptions.fixed.y === 'boolean') {
  166. parentOptions.fixed.y = newOptions.fixed.y;
  167. }
  168. }
  169. }
  170. }
  171. updateLabelModule() {
  172. if (this.options.label === undefined || this.options.label === null) {
  173. this.options.label = '';
  174. }
  175. this.labelModule.setOptions(this.options, true);
  176. if (this.labelModule.baseSize !== undefined) {
  177. this.baseFontSize = this.labelModule.baseSize;
  178. }
  179. }
  180. updateShape() {
  181. // choose draw method depending on the shape
  182. switch (this.options.shape) {
  183. case 'box':
  184. this.shape = new Box(this.options, this.body, this.labelModule);
  185. break;
  186. case 'circle':
  187. this.shape = new Circle(this.options, this.body, this.labelModule);
  188. break;
  189. case 'circularImage':
  190. this.shape = new CircularImage(this.options, this.body, this.labelModule, this.imageObj);
  191. break;
  192. case 'database':
  193. this.shape = new Database(this.options, this.body, this.labelModule);
  194. break;
  195. case 'diamond':
  196. this.shape = new Diamond(this.options, this.body, this.labelModule);
  197. break;
  198. case 'dot':
  199. this.shape = new Dot(this.options, this.body, this.labelModule);
  200. break;
  201. case 'ellipse':
  202. this.shape = new Ellipse(this.options, this.body, this.labelModule);
  203. break;
  204. case 'icon':
  205. this.shape = new Icon(this.options, this.body, this.labelModule);
  206. break;
  207. case 'image':
  208. this.shape = new Image(this.options, this.body, this.labelModule, this.imageObj);
  209. break;
  210. case 'square':
  211. this.shape = new Square(this.options, this.body, this.labelModule);
  212. break;
  213. case 'star':
  214. this.shape = new Star(this.options, this.body, this.labelModule);
  215. break;
  216. case 'text':
  217. this.shape = new Text(this.options, this.body, this.labelModule);
  218. break;
  219. case 'triangle':
  220. this.shape = new Triangle(this.options, this.body, this.labelModule);
  221. break;
  222. case 'triangleDown':
  223. this.shape = new TriangleDown(this.options, this.body, this.labelModule);
  224. break;
  225. default:
  226. this.shape = new Ellipse(this.options, this.body, this.labelModule);
  227. break;
  228. }
  229. this._reset();
  230. }
  231. /**
  232. * select this node
  233. */
  234. select() {
  235. this.selected = true;
  236. this._reset();
  237. }
  238. /**
  239. * unselect this node
  240. */
  241. unselect() {
  242. this.selected = false;
  243. this._reset();
  244. }
  245. /**
  246. * Reset the calculated size of the node, forces it to recalculate its size
  247. * @private
  248. */
  249. _reset() {
  250. this.shape.width = undefined;
  251. this.shape.height = undefined;
  252. }
  253. /**
  254. * get the title of this node.
  255. * @return {string} title The title of the node, or undefined when no title
  256. * has been set.
  257. */
  258. getTitle() {
  259. return this.options.title;
  260. }
  261. /**
  262. * Calculate the distance to the border of the Node
  263. * @param {CanvasRenderingContext2D} ctx
  264. * @param {Number} angle Angle in radians
  265. * @returns {number} distance Distance to the border in pixels
  266. */
  267. distanceToBorder(ctx, angle) {
  268. return this.shape.distanceToBorder(ctx,angle);
  269. }
  270. /**
  271. * Check if this node has a fixed x and y position
  272. * @return {boolean} true if fixed, false if not
  273. */
  274. isFixed() {
  275. return (this.options.fixed.x && this.options.fixed.y);
  276. }
  277. /**
  278. * check if this node is selecte
  279. * @return {boolean} selected True if node is selected, else false
  280. */
  281. isSelected() {
  282. return this.selected;
  283. }
  284. /**
  285. * Retrieve the value of the node. Can be undefined
  286. * @return {Number} value
  287. */
  288. getValue() {
  289. return this.options.value;
  290. }
  291. /**
  292. * Adjust the value range of the node. The node will adjust it's size
  293. * based on its value.
  294. * @param {Number} min
  295. * @param {Number} max
  296. */
  297. setValueRange(min, max, total) {
  298. if (this.options.value !== undefined) {
  299. var scale = this.options.scaling.customScalingFunction(min, max, total, this.options.value);
  300. var sizeDiff = this.options.scaling.max - this.options.scaling.min;
  301. if (this.options.scaling.label.enabled === true) {
  302. var fontDiff = this.options.scaling.label.max - this.options.scaling.label.min;
  303. this.options.font.size = this.options.scaling.label.min + scale * fontDiff;
  304. }
  305. this.options.size = this.options.scaling.min + scale * sizeDiff;
  306. }
  307. else {
  308. this.options.size = this.baseSize;
  309. this.options.font.size = this.baseFontSize;
  310. }
  311. }
  312. /**
  313. * Draw this node in the given canvas
  314. * The 2d context of a HTML canvas can be retrieved by canvas.getContext("2d");
  315. * @param {CanvasRenderingContext2D} ctx
  316. */
  317. draw(ctx) {
  318. this.shape.draw(ctx, this.x, this.y, this.selected, this.hover);
  319. }
  320. /**
  321. * Recalculate the size of this node in the given canvas
  322. * The 2d context of a HTML canvas can be retrieved by canvas.getContext("2d");
  323. * @param {CanvasRenderingContext2D} ctx
  324. */
  325. resize(ctx) {
  326. this.shape.resize(ctx);
  327. }
  328. /**
  329. * Check if this object is overlapping with the provided object
  330. * @param {Object} obj an object with parameters left, top, right, bottom
  331. * @return {boolean} True if location is located on node
  332. */
  333. isOverlappingWith(obj) {
  334. return (
  335. this.shape.left < obj.right &&
  336. this.shape.left + this.shape.width > obj.left &&
  337. this.shape.top < obj.bottom &&
  338. this.shape.top + this.shape.height > obj.top
  339. );
  340. }
  341. }
  342. export default Node;