MacLeod Broad
7 years ago
No known key found for this signature in database
GPG Key ID: F1B295D13C3CC9CF
55 changed files with 1154 additions and 434 deletions
Unified View
Diff Options
-
+1 -0.gitignore
-
+231 -0docs/README.md
-
+6 -81docs/data/dataset.html
-
+19 -1docs/network/index.html
-
+118 -0docs/publish.js
-
+7 -0docs/timeline/index.html
-
+40 -0docs/tmpl/html-head.tmpl
-
+49 -0docs/tmpl/navbar.tmpl
-
+3 -1examples/network/nodeStyles/shapes.html
-
+1 -0examples/network/nodeStyles/shapesWithDashedBorders.html
-
+58 -0examples/timeline/other/loadingScreen.html
-
+2 -11examples/timeline/other/stressPerformance.html
-
+26 -3examples/timeline/styling/weekStyling.html
-
+36 -1gulpfile.js
-
+3 -0jsdoc.json
-
+20 -0lib/network/Network.js
-
+3 -2lib/network/modules/LayoutEngine.js
-
+12 -6lib/network/modules/components/DirectionStrategy.js
-
+2 -2lib/network/modules/components/Edge.js
-
+1 -1lib/network/modules/components/edges/BezierEdgeDynamic.js
-
+1 -1lib/network/modules/components/edges/BezierEdgeStatic.js
-
+1 -1lib/network/modules/components/edges/CubicBezierEdge.js
-
+2 -2lib/network/modules/components/edges/StraightEdge.js
-
+4 -4lib/network/modules/components/edges/util/EdgeBase.js
-
+0 -22lib/network/modules/components/edges/util/EndPoints.js
-
+1 -1lib/network/modules/components/nodes/shapes/Box.js
-
+1 -1lib/network/modules/components/nodes/shapes/Circle.js
-
+1 -1lib/network/modules/components/nodes/shapes/CircularImage.js
-
+1 -1lib/network/modules/components/nodes/shapes/Database.js
-
+1 -1lib/network/modules/components/nodes/shapes/Diamond.js
-
+1 -1lib/network/modules/components/nodes/shapes/Dot.js
-
+1 -1lib/network/modules/components/nodes/shapes/Ellipse.js
-
+2 -2lib/network/modules/components/nodes/shapes/Hexagon.js
-
+2 -2lib/network/modules/components/nodes/shapes/Icon.js
-
+1 -1lib/network/modules/components/nodes/shapes/Image.js
-
+1 -1lib/network/modules/components/nodes/shapes/Square.js
-
+1 -1lib/network/modules/components/nodes/shapes/Star.js
-
+1 -1lib/network/modules/components/nodes/shapes/Text.js
-
+1 -1lib/network/modules/components/nodes/shapes/Triangle.js
-
+1 -1lib/network/modules/components/nodes/shapes/TriangleDown.js
-
+2 -2lib/network/modules/components/nodes/util/CircleImageBase.js
-
+7 -7lib/network/modules/components/nodes/util/NodeBase.js
-
+1 -1lib/network/modules/components/nodes/util/ShapeBase.js
-
+0 -20lib/network/modules/components/shared/ComponentUtil.js
-
+1 -26lib/network/modules/components/shared/Label.js
-
+322 -214lib/network/modules/components/shared/LabelSplitter.js
-
+97 -0lib/network/typedefs.js
-
+5 -2lib/timeline/Core.js
-
+2 -2lib/timeline/TimeStep.js
-
+22 -1lib/timeline/Timeline.js
-
+8 -2lib/timeline/component/css/timeline.css
-
+19 -0lib/timeline/component/css/timeline.js
-
+1 -0lib/timeline/optionsTimeline.js
-
+3 -1package.json
-
+1 -0test/Label.test.js
+ 1
- 0
.gitignore
View File
+ 231
- 0
docs/README.md
View File
| @ -0,0 +1,231 @@ | |||||
| # Command line usage example | |||||
| ``` | |||||
| jsdoc -c jsdoc.json -r -t docs -d gen/docs lib | |||||
| ``` | |||||
| - `-c`: use this config file for `jsdoc` | |||||
| - `-r`: Recurse into subdirectories of the specified source directories | |||||
| - `-t`: Use template in path `docs` | |||||
| - `-d`: Generated html files put in `gen/docs` | |||||
| - Source files to parse are taken from directory `lib` | |||||
| ## Notes | |||||
| The template generation is set up so that: | |||||
| - Files ending in `.tmpl` are skipped | |||||
| - All non-html files are plain copied | |||||
| - html-files *can* contain `<?js ?>` tags, but this is not required | |||||
| ## Intention | |||||
| The `docs` directory is treated as a `jsdoc` template, in which the html-files are the template files. This allows for a gradual adaptation of the html-files to templates; unchanged html-files will pass through `jsdoc` unchanged. | |||||
| The added value of using `jsdoc` for documentation generation, is that the complete documentation information, as collected by `jsdoc` from the source, is available for usage. This way, it's possible to insert technical notes from the source code into the documentation. | |||||
| ---- | |||||
| # Usage of and Notes on Source Code | |||||
| This section contains notes on the usage of `jsdoc` functionality, to aid with the handling of its generated data. | |||||
| ## Parameters of `publish()` | |||||
| ### Parameter `taffyData` | |||||
| A table containing *all* data collected from the source code, related to jsdoc generation. See below for more info and example outputs. | |||||
| ### Parameter `opt` | |||||
| Example of `opt` variable: | |||||
| ```js | |||||
| { | |||||
| "_":["../github/vis/lib/network/"], | |||||
| "configure":"jsdoc.json", | |||||
| "recurse":true, | |||||
| "template":"/home/wim/projects/jsdoc/default", | |||||
| "destination":"./out/", | |||||
| "encoding":"utf8" | |||||
| } | |||||
| ``` | |||||
| ### Parameter `tutorial` | |||||
| This does not appear to be of use for the generation of `vis.js` documentation. | |||||
| Example of `tutorial` variable: | |||||
| ```js | |||||
| { | |||||
| "longname":"", | |||||
| "name":"", | |||||
| "title":"", | |||||
| "content":"", | |||||
| "parent":null, | |||||
| "children":[], | |||||
| "_tutorials":{} | |||||
| } | |||||
| ``` | |||||
| ## Global variable `env` | |||||
| This contains addition info for the current execution of `jsdoc`. Example of `env` variable: | |||||
| ```js | |||||
| { | |||||
| "run":{"start":"2017-09-16T05:06:45.621Z","finish":null}, | |||||
| "args":["-c","jsdoc.json","-r","-t","default","../github/vis/lib/network/"], | |||||
| "conf":{ | |||||
| "plugins":["/usr/lib/node_modules/jsdoc/plugins/markdown.js"], | |||||
| "recurseDepth":10, | |||||
| "source":{"includePattern":".+\\.js(doc|x)?$","excludePattern":""}, | |||||
| "sourceType":"module", | |||||
| "tags":{"allowUnknownTags":true,"dictionaries":["jsdoc","closure"]}, | |||||
| "templates":{"monospaceLinks":false,"cleverLinks":false} | |||||
| }, | |||||
| "dirname":"/usr/lib/node_modules/jsdoc", | |||||
| "pwd":"/home/wim/projects/jsdoc", | |||||
| "opts":{ <<same as parameter 'opt' above>> }, | |||||
| "sourceFiles":[ <<list of full path names of all js-source files used as input>> ], | |||||
| "version":{"number":"3.5.4","revision":"Fri, 04 Aug 2017 22:05:27 GMT"} | |||||
| } | |||||
| ``` | |||||
| ## taffyData | |||||
| This is a parameter to `publish()`. It's a table containing *all* data collected from the source code, related to jsdoc generation. | |||||
| I can't find any way to return a list of fields for the data items in the taffyDB docs, therefore below there are examples of items, for better understanding of usage. | |||||
| Example usage: | |||||
| ```js | |||||
| var data = taffyData; | |||||
| var tmp = data().filter({name:'Label'}).get(); | |||||
| ``` | |||||
| Returns an array with all items with `name === 'Label'`. Example output of one of these items, for a class: | |||||
| *In these examples, block comment endings are redacted to ' * /'* | |||||
| ```js | |||||
| { | |||||
| "comment":"/**\n * A Label to be used for Nodes or Edges.\n * /", | |||||
| "meta":{ | |||||
| "range":[3770,41303], | |||||
| "filename":"Label.js", | |||||
| "lineno":167, | |||||
| "columnno":0, | |||||
| "path":"/home/wim/projects/github/vis/lib/network/modules/components/shared", | |||||
| "code":{ | |||||
| "id":"astnode100065034", | |||||
| "name":"Label", | |||||
| "type":"ClassDeclaration", | |||||
| "paramnames":["body","options","edgelabel"] | |||||
| } | |||||
| }, | |||||
| "classdesc":" | |||||
| A Label to be used for Nodes or Edges. | |||||
| ", | |||||
| "name":"Label", | |||||
| "longname":"Label", | |||||
| "kind":"class", | |||||
| "scope":"global", | |||||
| "params":[ | |||||
| {"type":{"names":["Object"]},"name":"body"}, | |||||
| {"type":{"names":["Object"]},"name":"options"}, | |||||
| {"type":{"names":["boolean"]},"optional":true,"defaultvalue":false,"name":"edgelabel"} | |||||
| ], | |||||
| "___id":"T000002R005289", | |||||
| "___s":true | |||||
| } | |||||
| ``` | |||||
| Example of item for an instance method: | |||||
| ```js | |||||
| var tmp = data().filter({name:'_drawText'}).get(); | |||||
| ``` | |||||
| Full output returned: | |||||
| ```js | |||||
| [{ | |||||
| "comment":"/**\n *\n * @param {CanvasRenderingContext2D} ctx\n * @param {boolean} selected\n * @param {boolean} hover\n * @param {number} x\n * @param {number} y\n * @param {string} [baseline='middle']\n * @private\n * /", | |||||
| "meta":{ | |||||
| "range":[20060,22269], | |||||
| "filename":"Label.js", | |||||
| "lineno":652, | |||||
| "columnno":2, | |||||
| "path":"/home/wim/projects/github/vis/lib/network/modules/components/shared", | |||||
| "code":{ | |||||
| "id":"astnode100066427", | |||||
| "name":"Label#_drawText", | |||||
| "type":"MethodDefinition", | |||||
| "paramnames":["ctx","selected","hover","x","y","baseline"] | |||||
| }, | |||||
| "vars":{"":null} | |||||
| }, | |||||
| "params":[ | |||||
| {"type":{"names":["CanvasRenderingContext2D"]},"name":"ctx"}, | |||||
| {"type":{"names":["boolean"]},"name":"selected"}, | |||||
| {"type":{"names":["boolean"]},"name":"hover"}, | |||||
| {"type":{"names":["number"]},"name":"x"}, | |||||
| {"type":{"names":["number"]},"name":"y"}, | |||||
| {"type":{"names":["string"]},"optional":true,"defaultvalue":"'middle'","name":"baseline"} | |||||
| ], | |||||
| "access":"private", | |||||
| "name":"_drawText", | |||||
| "longname":"Label#_drawText", | |||||
| "kind":"function", | |||||
| "memberof":"Label", | |||||
| "scope":"instance", | |||||
| "___id":"T000002R005388", | |||||
| "___s":true | |||||
| }] | |||||
| ``` | |||||
| ## `jsdoc` template rendering | |||||
| See `function createRenderer(fromDir, data)` in code for usage. | |||||
| There are two calls for rendering templates: | |||||
| - `var html = renderer.render(inFile, docData);` | |||||
| - `var html = renderer.partial(inFile, docData);` | |||||
| The difference is that `render()` will use a default layout template, if present, which will encapsulate all html. This can be set by: | |||||
| ```js | |||||
| renderer.layout = 'path/to/default/layout.tmpl'; | |||||
| ``` | |||||
| Parameter `docData` is a hash which is used to pass parameters into a template. The standard way of using this appear to be: | |||||
| ``` | |||||
| <?js | |||||
| var data = obj; // Whatever docData is | |||||
| var self = this; | |||||
| ?> | |||||
| ``` | |||||
| But it also appear to be possible to use the elements of docData directly: | |||||
| ```js | |||||
| var docData = { | |||||
| myTitle: 'Hello, pussycat!' | |||||
| }; | |||||
| ``` | |||||
| Within the template: | |||||
| ``` | |||||
| <?js= myTitle ?> | |||||
| ``` | |||||
+ 6
- 81
docs/data/dataset.html
View File
+ 19
- 1
docs/network/index.html
View File
+ 118
- 0
docs/publish.js
View File
| @ -0,0 +1,118 @@ | |||||
| /*============================================================================== | |||||
| Demo template, showing how documentation can be generated for `vis.js`. | |||||
| ------------------------------------------------------------------------------ | |||||
| ## Notes on `jsdoc` code | |||||
| // claim some special filenames in advance, so the All-Powerful Overseer of Filename Uniqueness | |||||
| // doesn't try to hand them out later | |||||
| indexUrl = helper.getUniqueFilename('index'); | |||||
| // don't call registerLink() on this one! 'index' is also a valid longname | |||||
| globalUrl = helper.getUniqueFilename('global'); | |||||
| helper.registerLink('global', globalUrl); | |||||
| ============================================================================== */ | |||||
| 'use strict'; | |||||
| //var taffy = require('taffydb').taffy; // not really required here, left for reference | |||||
| // Internal modules of `jsdoc` are available here. | |||||
| // This is not the complete list, there may be more useful stuff in jsdoc | |||||
| // For all modules scan in: '/usr/lib/node_modules/jsdoc/lib/jsdoc/' (or similar on your system) | |||||
| var fs = require('jsdoc/fs'); | |||||
| var path = require('jsdoc/path'); | |||||
| var template = require('jsdoc/template'); | |||||
| /** | |||||
| * Set up the template rendering engine. | |||||
| */ | |||||
| function createRenderer(fromDir, data) { | |||||
| var renderer = new template.Template(fromDir); // Param is the template source directory. | |||||
| // All template files are relative to this directory! | |||||
| /** | |||||
| * Example helper method | |||||
| * | |||||
| * This can be called from within a template as follows: | |||||
| * | |||||
| * ``` | |||||
| * <?js | |||||
| * var self = this; | |||||
| * ?> | |||||
| * ... | |||||
| * <?js= self.helper('hello!') ?> | |||||
| * ``` | |||||
| * | |||||
| * / | |||||
| renderer.helper = function(val) { | |||||
| return 'this is a helper! ' + val; | |||||
| }; | |||||
| */ | |||||
| /** | |||||
| * Retrieves jsdoc info for the passed instance method. | |||||
| */ | |||||
| renderer.getComment = function(methodName) { | |||||
| var tmp = data().filter({longname: methodName}).get()[0]; | |||||
| //console.log(JSON.stringify(tmp)); | |||||
| // Some restructuring, to adapt it to the docs layout | |||||
| // This needs some work to make it handle 0 and > 1 parameters | |||||
| var param = tmp.params[0]; | |||||
| var prototype = tmp.name + '(<code>' + param.type.names.join('|') + ' ' + param.name + '</code>)'; | |||||
| var returns = tmp.returns[0].type.names; | |||||
| return { | |||||
| prototype: prototype, | |||||
| returns: returns, | |||||
| description: tmp.description | |||||
| } | |||||
| }; | |||||
| return renderer; | |||||
| } | |||||
| /** | |||||
| Entry point for the template. | |||||
| This is called from `jsdoc` during execution | |||||
| @param {TAFFY} taffyData See <http://taffydb.com/>. | |||||
| @param {object} opts | |||||
| @param {Tutorial} tutorials | |||||
| */ | |||||
| exports.publish = function(taffyData, opts, tutorials) { | |||||
| //console.log(JSON.stringify(opts, null, 2)); | |||||
| var fromDir = path.resolve(opts.template); | |||||
| var toDir = path.join(opts.destination); | |||||
| var renderer = createRenderer(fromDir, taffyData); | |||||
| var docFiles = fs.ls(fromDir, 3); | |||||
| docFiles.forEach(function(fileName) { | |||||
| // Template filenames need to be relative to template source dir | |||||
| var relName = path.relative(fromDir, fileName); | |||||
| var outFile = path.join(toDir, relName); | |||||
| if (/publish.js$/.test(fileName)) return; // Skip self | |||||
| if (/README.md$/.test(fileName)) return; // Skip own README | |||||
| if (/\.tmpl$/.test(fileName)) return; // Skip .tmpl files; these are used as partials only | |||||
| if (!/\.html$/.test(fileName)) { | |||||
| // Just plain copy over non-html files | |||||
| var tmpDir = fs.toDir(outFile); | |||||
| fs.mkPath(tmpDir); | |||||
| fs.copyFileSync(fileName, tmpDir); | |||||
| return; | |||||
| } | |||||
| // Render html files as templates | |||||
| //console.log(relName); | |||||
| var html = renderer.partial(relName, {}); | |||||
| fs.mkPath(fs.toDir(outFile)); | |||||
| fs.writeFileSync(outFile, html, 'utf8'); | |||||
| }); | |||||
| //console.log(JSON.stringify(env, null, 2)); | |||||
| }; | |||||
+ 7
- 0
docs/timeline/index.html
View File
+ 40
- 0
docs/tmpl/html-head.tmpl
View File
| @ -0,0 +1,40 @@ | |||||
| <?js | |||||
| var title = obj; | |||||
| var self = this; | |||||
| ?> | |||||
| <!DOCTYPE html> | |||||
| <html lang="en"><head> | |||||
| <meta charset="utf-8"> | |||||
| <meta http-equiv="X-UA-Compatible" content="IE=edge"> | |||||
| <meta name="viewport" content="width=device-width, initial-scale=1"> | |||||
| <meta name="description" content=""> | |||||
| <meta name="author" content=""> | |||||
| <link rel="icon" HREF="favicon.ico"> | |||||
| <title><?js= title ?></title> | |||||
| <!-- Bootstrap core CSS --> | |||||
| <link href="../css/bootstrap.css" rel="stylesheet"> | |||||
| <!-- Tipue vendor css --> | |||||
| <link href="../css/tipuesearch.css" rel="stylesheet"> | |||||
| <link href="../css/style.css" rel="stylesheet"> | |||||
| <!-- HTML5 shim and Respond.js for IE8 support of HTML5 elements and media queries --> | |||||
| <!--[if lt IE 9]> | |||||
| <script src="https://oss.maxcdn.com/html5shiv/3.7.2/html5shiv.min.js"></script> | |||||
| <script src="https://oss.maxcdn.com/respond/1.4.2/respond.min.js"></script> | |||||
| <![endif]--> | |||||
| <link href="../css/prettify.css" type="text/css" rel="stylesheet"/> | |||||
| <script type="text/javascript" src="../js/googleAnalytics.js"></script> | |||||
| <script type="text/javascript" src="../js/prettify/prettify.js"></script> | |||||
| <script src="../js/smooth-scroll.min.js"></script> | |||||
| <script language="JavaScript"> | |||||
| smoothScroll.init(); | |||||
| </script> | |||||
| <script type="text/javascript" src="../js/toggleTable.js"></script> | |||||
| <?js /* end tag '</head>' purposely missing here, so that more stuff can be added to header */ ?> | |||||
+ 49
- 0
docs/tmpl/navbar.tmpl
View File
| @ -0,0 +1,49 @@ | |||||
| <?js | |||||
| var title = obj; | |||||
| var self = this; | |||||
| ?> | |||||
| <div class="navbar-wrapper"> | |||||
| <div class="container"> | |||||
| <nav class="navbar navbar-inverse navbar-static-top" role="navigation"> | |||||
| <div class="container"> | |||||
| <div class="navbar-header"> | |||||
| <button type="button" class="navbar-toggle collapsed" data-toggle="collapse" data-target="#navbar" | |||||
| aria-expanded="false" aria-controls="navbar"> | |||||
| <span class="sr-only">Toggle navigation</span> | |||||
| <span class="icon-bar"></span> | |||||
| <span class="icon-bar"></span> | |||||
| <span class="icon-bar"></span> | |||||
| </button> | |||||
| <a class="navbar-brand hidden-sm" href="./index.html">vis.js</a> | |||||
| </div> | |||||
| <div id="navbar" class="navbar-collapse collapse"> | |||||
| <ul class="nav navbar-nav"> | |||||
| <li><a href="http://www.visjs.org/index.html#modules">Modules</a></li> | |||||
| <li><a href="http://www.visjs.org/blog.html">Blog</a></li> | |||||
| <li><a href="http://www.visjs.org/index.html#download_install">Download</a></li> | |||||
| <li><a href="http://www.visjs.org/showcase/index.html">Showcase</a></li> | |||||
| <li><a href="http://www.visjs.org/index.html#contribute">Contribute</a></li> | |||||
| <li><a href="http://www.visjs.org/featureRequests.html">Feature requests</a></li> | |||||
| <li><a href="http://www.visjs.org/index.html#licenses">License</a></li> | |||||
| </ul> | |||||
| <form class="navbar-form navbar-right" role="search"> | |||||
| <input name="q" id="tipue_search_input" autocomplete="off" type="text" class="form-control" placeholder="Enter keywords"> | |||||
| <button type="submit" class="btn btn-default">Go!</button> | |||||
| </form> | |||||
| <div id="search-results-wrapper" class="panel panel-default"> | |||||
| <div class="panel-body"> | |||||
| <div id="tipue_search_content"></div> | |||||
| </div> | |||||
| </div> | |||||
| <div id="keyword-info" class="panel panel-success"> | |||||
| <div class="panel-body"> | |||||
| Found <span id="keyword-count"></span> results. Click <a id="keyword-jumper-button" href="">here</a> to jump to the first keyword occurence! | |||||
| </div> | |||||
| </div> | |||||
| </div> | |||||
| </div> | |||||
| </nav> | |||||
| </div> | |||||
| </div> | |||||
| <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> | |||||
+ 3
- 1
examples/network/nodeStyles/shapes.html
View File
+ 1
- 0
examples/network/nodeStyles/shapesWithDashedBorders.html
View File
+ 58
- 0
examples/timeline/other/loadingScreen.html
View File
| @ -0,0 +1,58 @@ | |||||
| <!DOCTYPE HTML> | |||||
| <html> | |||||
| <head> | |||||
| <title>Timeline | Loading screen example</title> | |||||
| <script src="http://cdnjs.cloudflare.com/ajax/libs/moment.js/2.8.4/moment.min.js"></script> | |||||
| <script src="../../../dist/vis.js"></script> | |||||
| <link href="../../../dist/vis-timeline-graph2d.min.css" rel="stylesheet" type="text/css" /> | |||||
| </head> | |||||
| <body> | |||||
| <h1>Timeline with loading screen</h1> | |||||
| <div id="visualization"></div> | |||||
| </body> | |||||
| <script> | |||||
| var now = moment(); | |||||
| var groupCount = 20; | |||||
| var itemCount = 400; | |||||
| // create a data set with groups | |||||
| var groups = new vis.DataSet(); | |||||
| for (var g = 0; g < groupCount; g++) { | |||||
| groups.add({ | |||||
| id: g, | |||||
| content: "group " + g | |||||
| }); | |||||
| } | |||||
| var types = ['point', 'range', 'box', 'background'] | |||||
| // create a dataset with items | |||||
| var items = new vis.DataSet(); | |||||
| for (var i = 0; i < itemCount; i++) { | |||||
| var start = now.clone().add(Math.random() * 180, 'days'); | |||||
| var end = start.clone().add(Math.random() * 30, 'days'); | |||||
| var group = Math.floor(Math.random() * groupCount); | |||||
| items.add({ | |||||
| id: i, | |||||
| type: types[Math.floor(Math.random() * types.length)], | |||||
| group: group, | |||||
| content: '' + i, | |||||
| start: start, | |||||
| end: end | |||||
| }); | |||||
| } | |||||
| // create visualization | |||||
| var container = document.getElementById('visualization'); | |||||
| var options = { | |||||
| loadingScreenTemplate: function() { | |||||
| return '<h1>Loading...</h1>' | |||||
| } | |||||
| }; | |||||
| var timeline = new vis.Timeline(container, items, groups, options); | |||||
| </script> | |||||
| </html> | |||||
+ 2
- 11
examples/timeline/other/stressPerformance.html
View File
+ 26
- 3
examples/timeline/styling/weekStyling.html
View File
+ 36
- 1
gulpfile.js
View File
+ 3
- 0
jsdoc.json
View File
| @ -0,0 +1,3 @@ | |||||
| { | |||||
| "plugins": ["plugins/markdown"] | |||||
| } | |||||
+ 20
- 0
lib/network/Network.js
View File
+ 3
- 2
lib/network/modules/LayoutEngine.js
View File
+ 12
- 6
lib/network/modules/components/DirectionStrategy.js
View File
+ 2
- 2
lib/network/modules/components/Edge.js
View File
+ 1
- 1
lib/network/modules/components/edges/BezierEdgeDynamic.js
View File
+ 1
- 1
lib/network/modules/components/edges/BezierEdgeStatic.js
View File
+ 1
- 1
lib/network/modules/components/edges/CubicBezierEdge.js
View File
+ 2
- 2
lib/network/modules/components/edges/StraightEdge.js
View File
+ 4
- 4
lib/network/modules/components/edges/util/EdgeBase.js
View File
+ 0
- 22
lib/network/modules/components/edges/util/EndPoints.js
View File
+ 1
- 1
lib/network/modules/components/nodes/shapes/Box.js
View File
+ 1
- 1
lib/network/modules/components/nodes/shapes/Circle.js
View File
+ 1
- 1
lib/network/modules/components/nodes/shapes/CircularImage.js
View File
+ 1
- 1
lib/network/modules/components/nodes/shapes/Database.js
View File
+ 1
- 1
lib/network/modules/components/nodes/shapes/Diamond.js
View File
+ 1
- 1
lib/network/modules/components/nodes/shapes/Dot.js
View File
+ 1
- 1
lib/network/modules/components/nodes/shapes/Ellipse.js
View File
+ 2
- 2
lib/network/modules/components/nodes/shapes/Hexagon.js
View File
+ 2
- 2
lib/network/modules/components/nodes/shapes/Icon.js
View File
+ 1
- 1
lib/network/modules/components/nodes/shapes/Image.js
View File
+ 1
- 1
lib/network/modules/components/nodes/shapes/Square.js
View File
+ 1
- 1
lib/network/modules/components/nodes/shapes/Star.js
View File
+ 1
- 1
lib/network/modules/components/nodes/shapes/Text.js
View File
+ 1
- 1
lib/network/modules/components/nodes/shapes/Triangle.js
View File
+ 1
- 1
lib/network/modules/components/nodes/shapes/TriangleDown.js
View File
+ 2
- 2
lib/network/modules/components/nodes/util/CircleImageBase.js
View File
+ 7
- 7
lib/network/modules/components/nodes/util/NodeBase.js
View File
+ 1
- 1
lib/network/modules/components/nodes/util/ShapeBase.js
View File
+ 0
- 20
lib/network/modules/components/shared/ComponentUtil.js
View File
+ 1
- 26
lib/network/modules/components/shared/Label.js
View File
+ 322
- 214
lib/network/modules/components/shared/LabelSplitter.js
View File
+ 97
- 0
lib/network/typedefs.js
View File
| @ -0,0 +1,97 @@ | |||||
| // NOTE: When a typedef is isolated in a separate comment block, an actual description is generated for it, | |||||
| // using the rest of the commenting in the code block. Usage of typedef in other comments then | |||||
| // link to there. TIL. | |||||
| // | |||||
| // Also noteworthy, all typedef's set up in this manner are collected in a single, global page 'global.html'. | |||||
| // In other words, it doesn't matter *where* the typedef's are defined in the code. | |||||
| // | |||||
| // | |||||
| // TODO: add descriptive commenting to given typedef's | |||||
| /** | |||||
| * @typedef {{type:string, point:Point, angle:number, length:number}} ArrowData | |||||
| * | |||||
| * Object containing instantiation data for a given endpoint. | |||||
| */ | |||||
| /** | |||||
| * @typedef {{x:number, y:number}} Point | |||||
| * | |||||
| * A point in view-coordinates. | |||||
| */ | |||||
| /** | |||||
| * @typedef {{toArrow: boolean, toArrowScale: (allOptions.edges.arrows.to.scaleFactor|{number}|allOptions.edges.arrows.middle.scaleFactor|allOptions.edges.arrows.from.scaleFactor|Array|number), toArrowType: *, middleArrow: boolean, middleArrowScale: (number|allOptions.edges.arrows.middle.scaleFactor|{number}|Array), middleArrowType: (allOptions.edges.arrows.middle.type|{string}|string|*), fromArrow: boolean, fromArrowScale: (allOptions.edges.arrows.to.scaleFactor|{number}|allOptions.edges.arrows.middle.scaleFactor|allOptions.edges.arrows.from.scaleFactor|Array|number), fromArrowType: *, arrowStrikethrough: (*|boolean|allOptions.edges.arrowStrikethrough|{boolean}), color: undefined, inheritsColor: (string|string|string|allOptions.edges.color.inherit|{string, boolean}|Array|*), opacity: *, hidden: *, length: *, shadow: *, shadowColor: *, shadowSize: *, shadowX: *, shadowY: *, dashes: (*|boolean|Array|allOptions.edges.dashes|{boolean, array}), width: *}} ArrowOptions | |||||
| */ | |||||
| /** | |||||
| * @typedef {string|number} Id | |||||
| */ | |||||
| /** | |||||
| * @typedef {Id} NodeId | |||||
| */ | |||||
| /** | |||||
| * @typedef {Id} EdgeId | |||||
| */ | |||||
| /** | |||||
| * @typedef {Id} LabelId | |||||
| */ | |||||
| /** | |||||
| * @typedef {{x: number, y: number}} point | |||||
| */ | |||||
| /** | |||||
| * @typedef {{left: number, top: number, width: number, height: number}} rect | |||||
| */ | |||||
| /** | |||||
| * @typedef {{x: number, y:number, angle: number}} rotationPoint | |||||
| * | |||||
| * point to rotate around and the angle in radians to rotate. angle == 0 means no rotation | |||||
| */ | |||||
| /** | |||||
| * @typedef {{nodeId:NodeId}} nodeClickItem | |||||
| */ | |||||
| /** | |||||
| * @typedef {{nodeId:NodeId, labelId:LabelId}} nodeLabelClickItem | |||||
| */ | |||||
| /** | |||||
| * @typedef {{edgeId:EdgeId}} edgeClickItem | |||||
| */ | |||||
| /** | |||||
| * @typedef {{edgeId:EdgeId, labelId:LabelId}} edgeLabelClickItem | |||||
| */ | |||||
| /** | |||||
| * @typedef {'bold'|'ital'|'boldital'|'mono'|'normal'} MultiFontStyle | |||||
| * | |||||
| * The allowed specifiers of multi-fonts. | |||||
| */ | |||||
| /** | |||||
| * @typedef {{color:string, size:number, face:string, mod:string, vadjust:number}} MultiFontOptions | |||||
| * | |||||
| * The full set of options of a given multi-font. | |||||
| */ | |||||
| /** | |||||
| * @typedef {Array.<object>} Pile | |||||
| * | |||||
| * Sequence of option objects, the order is significant. | |||||
| * The sequence is used to determine the value of a given option. | |||||
| * | |||||
| * Usage principles: | |||||
| * | |||||
| * - All search is done in the sequence of the pile. | |||||
| * - As soon as a value is found, the searching stops. | |||||
| * - prototypes are totally ignored. The idea is to add option objects used as prototypes | |||||
| * to the pile, in the correct order. | |||||
| */ | |||||
+ 5
- 2
lib/timeline/Core.js
View File
+ 2
- 2
lib/timeline/TimeStep.js
View File
+ 22
- 1
lib/timeline/Timeline.js
View File
+ 8
- 2
lib/timeline/component/css/timeline.css
View File
+ 19
- 0
lib/timeline/component/css/timeline.js
View File
| @ -0,0 +1,19 @@ | |||||
| import { StyleSheet } from 'react-native'; | |||||
| export default StyleSheet.create({ | |||||
| 'vis-timeline': { | |||||
| 'position': 'relative', | |||||
| 'border': [{ 'unit': 'px', 'value': 1 }, { 'unit': 'string', 'value': 'solid' }, { 'unit': 'string', 'value': '#bfbfbf' }], | |||||
| 'overflow': 'hidden', | |||||
| 'padding': [{ 'unit': 'px', 'value': 0 }, { 'unit': 'px', 'value': 0 }, { 'unit': 'px', 'value': 0 }, { 'unit': 'px', 'value': 0 }], | |||||
| 'margin': [{ 'unit': 'px', 'value': 0 }, { 'unit': 'px', 'value': 0 }, { 'unit': 'px', 'value': 0 }, { 'unit': 'px', 'value': 0 }], | |||||
| 'boxSizing': 'border-box' | |||||
| }, | |||||
| 'vis-loading-screen': { | |||||
| 'width': [{ 'unit': '%H', 'value': 1 }], | |||||
| 'height': [{ 'unit': '%V', 'value': 1 }], | |||||
| 'position': 'absolute', | |||||
| 'top': [{ 'unit': 'px', 'value': 0 }], | |||||
| 'left': [{ 'unit': 'px', 'value': 0 }] | |||||
| } | |||||
| }); | |||||