/NodifyM.Avalonia

A collection of controls for node based editors designed for MVVM.

Primary LanguageC#MIT LicenseMIT

NodifyM.Avalonia

NuGet NuGet License

A collection of controls for node based editors designed for MVVM.

About

This project is a refactoring of Nodify on the Avalonia platform and is not a 1:1 replica of Nodify, but they have many similarities. image image

Features

  • Designed from the start to work with MVVM
  • Built-in dark and light themes
  • Selecting， zooming， panning
  • Select， move, auto align, auto panning when close to edge and connect nodes

What are the differences compared to Nodify

  • Supports
    • auto align Node
    • display text on Connection
  • Nonsupport
    • Select multiple nodes
  • Will be supported in the future
    • none

Usage

NodifyEditor

  • Press and Hold -> Move the all show items
  • Mouse wheel -> Zoom all show items

Node

  • Press and Hold -> Move the Node
  • Press Move and Hold Shift -> Move the Node(without automatically align)
  • Press the Node -> Select the Node

Connection

  • Press and Hold the Connector and move to another Connector -> Create a new connection
  • Hold Alt and Click Connection -> Remove Connection
  • DoubleClick Connection -> Split the connection in the double-click position

PendingConnection

  • Press and Hold the Connector -> Show connection preview

Connector

  • Hold Alt and Click Connector -> Remove all the Connections on the Connector

Notice

Some known problems

  1. Do not use Mode=OneWayToSource when you have multiple Nodify bound to the same ViewModel, this is a bug from Avalonia

Example

please see the NodifyM.Avalonia.Example

You can git clone the project and run NodifyM.Avalonia.Example

Changelog

1.0.12

  • Fixed the adaptive node layout calculation error
  • Added node centerline alignment

1.0.11

  • Added automatic adaptation to display all Nodes when NodifyEditor is initialized
  • Optimize child node search

1.0.10

  • Fixed Node Header/Input/OutputTemplate allow use IDataTemplate
  • Added Avalonia.Diagnostics Condition

1.0.9

  • Allows not to use the built-in ViewModelBase
  • Fixed ViewTranslateTransform and AlignmentLine exceptions when multiple NodifyEditor

1.0.8

  • Added Light and Dark themes follow the Avalonia toggle
  • Fixed invalid Connection Text Brush modifications
  • Optimize the Dark theme color
  • Added GridLine color definition

1.0.7

  • Added Node auto panning when close to edge

1.0.6

  • Fixed Node IsSelected property
  • Fixed Node BorderBrush Style
  • Added Node Alignment hint

1.0.5

  • Added the ability to temporarily without automatically align Node while holding Shift
  • Added the ability to display text on Connection

1.0.4

  • Add align Node configuration properties
  • Add Node automatic alignment

1.0.3

  • Added the connection SplitConnection and DisconnectConnection commands
  • Add CircuitConnection
  • Fixed default control color to dictionary color
  • Support to override the Connect and Disconnect from NodifyEditorViewModelBase method
  • Fix KnotNode Show
  • Remove some useless attributes