@yworks/react-yfiles-company-ownership v1.1.0

yFiles React Company Ownership Component

Welcome to the yFiles React Company Ownership component, a powerful and versatile React component based on the yFiles library. This component enables seamless integration for displaying company ownership charts in your React applications.

Getting Started

Prerequisites

To use the Company Ownership component, 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 Company Ownership component 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-company-ownership-app -- --template react-ts

   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",
        "yfiles": "./lib-dev/yfiles-26.0.0.tgz"
     }

   Now, the component itself can be installed:

   npm install @yworks/react-yfiles-company-ownership

2. License

   Be sure to invoke the registerLicense function before using the Company Ownership React component. 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.

   Import or paste your license data and register the license, e.g. in App.tsx:

   import yFilesLicense from './license.json'
   
   registerLicense(yFilesLicense)

3. Stylesheet

   Make sure to import the CSS stylesheet as well:

   import '@yworks/react-yfiles-company-ownership/dist/index.css'

4. Usage

   You are now all set to utilize the Company Ownership component with your data! See a basic example App.tsx below:

   import {
     CompanyOwnership,
     CompanyOwnershipData,
     Entity,
     Ownership,
     registerLicense
   } from '@yworks/react-yfiles-company-ownership'
   
   import '@yworks/react-yfiles-company-ownership/dist/index.css'
   
   import yFilesLicense from './license.json'
   
   registerLicense(yFilesLicense)
   
   const data: CompanyOwnershipData<Entity, Ownership> = {
     companies: [
       {
         id: 1,
         name: 'Monster Inc',
         type: 'Corporation'
       },
       {
         id: 2,
         name: 'Connect Partner',
         type: 'RCTB'
       },
       {
         id: 3,
         name: 'Large Scale Trust',
         type: 'Trust'
       }
     ],
     connections: [
       {
         type: 'Ownership',
         ownership: 0.4,
         sourceId: 1,
         targetId: 2
       },
       {
         type: 'Ownership',
         ownership: 0.2,
         sourceId: 1,
         targetId: 3
       }
     ]
   }
   
   function App() {
     return <CompanyOwnership data={data}></CompanyOwnership>
   }
   
   export default App

   Note: By default, the CompanyOwnership component adjusts its size to match the size of its parent element. Therefore, it is necessary to set the dimensions of the containing element or apply styling directly to the CompanyOwnership component. This can be achieved by defining a CSS class or applying inline styles.

Documentation

Find the full documentation, API and many code examples in our documentation.

Live Playground

Try the yFiles React Company Ownership component directly in your browser with our playground.

Features

The component provides versatile features out of the box that can be further tailored to specific use cases.

Find all features in the documentation and try them directly in the browser with our integrated code 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

Explore the possibilities of visualizing large ownership hierarchies with the yFiles Company Ownership Component. For further information about yFiles for HTML and our company, please visit yWorks.com.

If you are exploring a different use case and require another 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!