Blazor-ApexSankey 1.0.0

Blazor-ApexSankey

A Blazor component library for creating interactive Sankey diagrams using ApexSankey. Built for Blazor WebAssembly with full support for two-way data binding, customizable styling, and event handling.

Features

• 🔗 Two-Way Binding - Automatic re-rendering when data changes
• 🎨 Fully Customizable - Control nodes, edges, fonts, colors, and tooltips
• ⚡ Event Handling - Handle node clicks and render callbacks
• 📱 WebAssembly - Built specifically for Blazor WebAssembly
• 🛠️ TypeScript Definitions - Full IntelliSense support
• 📦 Easy Integration - Simple NuGet package installation

Installation

dotnet add package Blazor-ApexSankey

Quick Start

1. Add the script reference

The core library is self-contained (no external dependencies), so the standard Blazor script is all you need in your index.html:

<script src="_framework/blazor.webassembly.js"></script>

2. Add the using statement

In your _Imports.razor:

@using Blazor_ApexSankey.Components
@using Blazor_ApexSankey.Models
@using Blazor_ApexSankey.Events
@using Blazor_ApexSankey.Services

3. Use the component

@page "/my-sankey"

<ApexSankey Data="@sankeyData"
            Options="@options"
            OnNodeClick="@HandleNodeClick" />

@code {
    private SankeyData sankeyData = new()
    {
        Nodes = new List<SankeyNode>
        {
            new() { Id = "A", Title = "Source A" },
            new() { Id = "B", Title = "Source B" },
            new() { Id = "C", Title = "Target C" }
        },
        Edges = new List<SankeyEdge>
        {
            new() { Source = "A", Target = "C", Value = 10 },
            new() { Source = "B", Target = "C", Value = 20 }
        }
    };

    private SankeyOptions options = new()
    {
        Width = "800",
        Height = "600",
        NodeWidth = 20,
        FontFamily = "Arial, sans-serif"
    };

    private void HandleNodeClick(NodeClickEventArgs args)
    {
        Console.WriteLine($"Clicked node: {args.Node.Title}");
    }
}

Configuration Options

Data Models

SankeyNode

public class SankeyNode
{
    public string Id { get; set; }      // required
    public string Title { get; set; }   // required
    public string? Color { get; set; }  // optional
}

SankeyEdge

public class SankeyEdge
{
    public string Source { get; set; }  // required
    public string Target { get; set; }  // required
    public double Value { get; set; }   // required
    public string? Type { get; set; }   // optional
    public string? Color { get; set; }  // optional
}

Custom Ordering

You can specify custom node ordering:

var data = new SankeyData
{
    Nodes = nodes,
    Edges = edges,
    Options = new SankeyDataOptions
    {
        Order = new List<List<List<string>>>
        {
            new() { new() { "A", "B" } },
            new() { new() { "C" } }
        }
    }
};

Events

Licensing

To use with a commercial license:

// set before creating any chart instances
await ApexSankeyInterop.SetLicenseAsync(jsRuntime, "your-license-key");

Browser Support

Blazor-ApexSankey supports all modern browsers that support WebAssembly:

• Chrome 57+
• Firefox 52+
• Safari 11+
• Edge 16+

License

See LICENSE for details.

Links

• GitHub Repository
• ApexSankey Documentation
• NuGet Package