API revisions for 3.0

[maxkfranz]

Improvements to the API that break backwards compatibility (sorted by most-to-least significant amount of changes needed to update your app):

• Functions with the function(i, ele) signature become function(ele, i) etc, e.g. eles.each() Functions with the function(i, ele) signature become function(ele, i) etc, e.g. eles.each() #1531
  • eles.bfs()
  • eles.dfs()
  • eles.each()
  • eles.filter()
  • eles.positions()
  • eles.layoutPositions()
• cy.layout() and eles.layout() return the layout rather than chaining the calling object cy.layout() and eles.layout() return the layout rather than chaining the calling object #1533
• Callbacks like weight should not set this Callbacks like weight should not set this #1535
  • eles.each()
  • eles.filter()
  • eles.positions()
  • eles.layoutPositions()
  • eles.bfs()
  • eles.dfs()
  • eles.dijkstra()
  • eles.aStar()
  • eles.bellmanFord()
  • eles.kruskal()
  • eles.floydWarshall()
  • eles.pageRank()
  • eles.closenessCentrality() & eles.closenessCentralityNormalized()
  • eles.betweennessCentrality() & eles.betweennessCentralityNormalized()
  • eles.degreeCentrality() & eles.degreeCentralityNormalized()
  • concentric layout (already deprecated)
  • cose layout (already deprecated)
• Remove cy prefix on event fields, because we don't merge with the original event (as left open); e.g. cyTarget => target Remove cy prefix on event fields, because we don't merge with the original event (as left open); e.g. cyTarget => target #1537
• Clarify interactivity and visibility Clarify interactivity and visibility #1544
• Remove :touch selector -- not reliable as some desktop browsers now implement touch APIs without hardware support Remove :touch selector -- not reliable as some desktop browsers now implement touch APIs without hardware support #1540
• Replace cy.onRender() and cy.offRender() with a render event Replace cy.onRender() and cy.offRender() with a render event #1541
• grab event should happen on nodes being dragged; use grabon for differentiating which element the cursor or finger holds grab event should happen on nodes being dragged; use grabon for differentiating which element the cursor or finger holds #1545
• Remove jQuery plugin (still allow passing a jQuery element to init, but don't allow $('#cy-div').cytoscape(...) syntax) Remove jQuery plugin (still allow passing a jQuery element to init, but don't allow $('#cy-div').cytoscape(...) syntax) #1539
• Remove the already deprecated cy.load() Remove the already deprecated cy.load() #1534
• Remove deprecated layout() and scratch() mapper support in code Remove deprecated layout() and scratch() mapper support in code #1536
• Remove deprecated cy.initrender() Remove deprecated cy.initrender()  #1538
• Remove inhibitor arrow shape alias Remove inhibitor arrow shape alias #1655
• Remove mandatory weaver dependency on CoSE layout Remove mandatory weaver dependency on CoSE layout #1687
• Remove all shadow style properties Remove all shadow style properties #1758
• Remove data parameters in .on() etc Remove data parameters in .on() etc #1764