npm package discovery and stats viewer.

Discover Tips

  • General search

    [free text search, go nuts!]

  • Package details

    pkg:[package-name]

  • User packages

    @[username]

Sponsor

Optimize Toolset

I’ve always been into building performant and accessible sites, but lately I’ve been taking it extremely seriously. So much so that I’ve been building a tool to help me optimize and monitor the sites that I build to make sure that I’m making an attempt to offer the best experience to those who visit them. If you’re into performant, accessible and SEO friendly sites, you might like it too! You can check it out at Optimize Toolset.

About

Hi, 👋, I’m Ryan Hefner  and I built this site for me, and you! The goal of this site was to provide an easy way for me to check the stats on my npm packages, both for prioritizing issues and updates, and to give me a little kick in the pants to keep up on stuff.

As I was building it, I realized that I was actually using the tool to build the tool, and figured I might as well put this out there and hopefully others will find it to be a fast and useful way to search and browse npm packages as I have.

If you’re interested in other things I’m working on, follow me on Twitter or check out the open source projects I’ve been publishing on GitHub.

I am also working on a Twitter bot for this site to tweet the most popular, newest, random packages from npm. Please follow that account now and it will start sending out packages soon–ish.

Open Software & Tools

This site wouldn’t be possible without the immense generosity and tireless efforts from the people who make contributions to the world and share their work via open source initiatives. Thank you 🙏

© 2024 – Pkg Stats / Ryan Hefner

@yworks/yfiles-layout-reactflow

v1.0.3

Published

yFiles Layouts for React Flow - A layout library for React Flow providing powerful yFiles layout algorithms and supporting components

Downloads

26

Readme

yFiles Layout Algorithms for React Flow

NPM version

Welcome playground

Welcome to the yFiles Layout Algorithms for React Flow module, a powerful and versatile layout add-on for React Flow based on the yFiles library.

yFiles Layout Algorithms for React Flow is a comprehensive npm module designed to seamlessly integrate the powerful layout capabilities of yFiles for HTML into React Flow.

With yFiles Layout Algorithms for React Flow, developers can utilize the advanced graph layout algorithms and customization options provided by yFiles for HTML within their React Flow projects, enabling precise control over the arrangement and appearance of nodes and edges.

Getting Started

Prerequisites

To use the module, yFiles for HTML is required. You can evaluate yFiles for 60 days free of charge on my.yworks.com. See Licensing for more information on this topic.

You can learn how to work with the yFiles npm module in our Developer’s Guide. A convenient way of getting access to yFiles is to use the yFiles Dev Suite.

Project Setup

  1. Installation

    In addition to yFiles, the module requires React to be installed in your project. If you want to start your project from scratch, we recommend using vite:

    npm create vite@latest my-yfiles-layout-app -- --template react-ts

    Install the ReactFlow:

    npm install reactflow

    Add the yFiles dependency:

    npm install <yFiles package path>/lib-dev/yfiles-26.0.0+dev.tgz
       dependencies: {
         "react": "^18.2.0",
         "react-dom": "^18.2.0",
         "reactflow": "^11.11.0",
         "yfiles": "./lib-dev/yfiles-26.0.0.tgz"
      }

    Install the module via npm by running the following command in your project directory:

    npm install @yworks/yfiles-layout-reactflow
  2. License:

    Be sure to invoke registerLicense function before using the module. When evaluating yFiles, the license JSON file is found in the lib/ folder of the yFiles for HTML evaluation package. For licensed users, the license data is provided separately.

    <summary>License registration</summary>
    
    Import or paste your license data and register the license, e.g. in `App.tsx`:
    
    ```js
    import yFilesLicense from './license.json'
    
    registerLicense(yFilesLicense)
    ```
  3. Usage

    Utilize the useLayout-hook in your React Flow application. First invoke registerLicense somewhere in your application.

    // App.tsx
    import { registerLicense } from '@yworks/yfiles-layout-reactflow'
    import yFilesLicense from './license.json'
       
    function App() {
      registerLicense(yFilesLicense)
      return <Flow></Flow>
    }
        
    export default App

    Then create a custom flow with a layout button.

    // Flow.tsx
    import { useCallback } from 'react'
    import ReactFlow, {
      addEdge,
      Connection,
      EdgeProps,
      NodeProps,
      Panel,
      ReactFlowProvider,
      useEdgesState,
      useNodesState
    } from 'reactflow'
    import 'reactflow/dist/style.css'
    import { MultiHandleNode, PolylineEdge, useLayout } from '@yworks/yfiles-layout-reactflow'
       
    import initialNodes from './nodes.json'
    import initialEdges from './edges.json'
       
    // use the node and edge types that can process the layout result
    // including multiple handles and bends in edges
    const edgeTypes = {
      default: PolylineEdge
    }
    const nodeTypes = {
      default: MultiHandleNode
    }
    
    function LayoutFlow() {
      const [nodes, setNodes, onNodesChange] = useNodesState(initialNodes);
      const [edges, setEdges, onEdgesChange] = useEdgesState(initialEdges);
    
      const onConnect = useCallback(
        (connection:Connection) => setEdges((eds) => addEdge(connection, eds)),
        [setEdges]
      )
       
      // use the layout-hook to configure the layout algorithm
      const { runLayout } = useLayout()
       
      return (
        <ReactFlow
          nodes={nodes}
          edges={edges}
          onNodesChange={onNodesChange}
          onEdgesChange={onEdgesChange}
          onConnect={onConnect}
          nodeTypes={nodeTypes}
          edgeTypes={edgeTypes}
        >
          <Panel position="top-left">
            <button onClick={() => runLayout('HierarchicLayout')}>Run Layout</button>
          </Panel>
        </ReactFlow>
      );
    }
       
    export default function Flow() {
      return (
        <ReactFlowProvider>
          <LayoutFlow />
        </ReactFlowProvider>
      )
    }
    

    Note that in order to effectively visualize the outcome of the layout algorithm, it is essential to use Node and Edge types that are capable of accommodating multiple handles and polyline paths.

Live Playground

Live Playground

Try the yFiles Layout Algorithms for React Flow directly in your browser with our playground.

Licensing

All owners of a valid software license for yFiles for HTML are allowed to use these sources as the basis for their own yFiles for HTML powered applications.

Use of such programs is governed by the rights and conditions as set out in the yFiles for HTML license agreement.

You can evaluate yFiles for 60 days free of charge on my.yworks.com.

For more information, see the LICENSE file.

Learn More

For detailed instructions on how to use and configure the layout module, please refer to the comprehensive documentation provided.

For further information about yFiles for HTML and our company, please visit yWorks.com.

If you are working on a specific use case (e.g., organization chart, supply chain, company ownsership diagram) and require an easy-to-use React component, please take a look at the available React components powered by yFiles!

For support or feedback, please reach out to our support team or open an issue on GitHub. Happy diagramming!