Migration Guide: Layout

This chapter outlines the steps required to migrate layout-related code and applications from yFiles for HTML 2.6 to yFiles for HTML 3.0.

The new version introduces a comprehensive revision of the API to make yFiles easier to use, more intuitive, and more consistent. This includes many incompatible API and behavior changes. The most important changes are mentioned in this chapter. For a more comprehensive list of the changes, refer to the release notes.

The layout-related changes include major renamings, changed default values, and removed API. In addition, there have been major changes to basic layout concepts including, among others, the graph model, the handling of ports, the maximum duration/abort handling, the scope of affected elements, and the handling of grouped graph structures.

This chapter also contains layout-algorithm-centric sections that summarize the main changes to individual algorithms, such as the Hierarchic Layout, Organic Layout, Tree Layout, Orthogonal Layout, Edge Router, and Generic Labeling.