DragulaDropula 1.3.0

DragulaDropula

Library for simple Drag-And-Drop functionality in Blazor.

You can pull request and create issue here 👉 https://github.com/marat0n/DragulaDropula

How to start using

1. Add DradNDropController to Scoped Services.

builder.Service.AddScoped<DragNDropController>();

2. Add DragulaDropula namespace to _Imports.razor.

@using DragulaDropula

3. Done ✅

API

Components

DraggingZone — Component you need to use as an underlay for Draggable components.

Parameters:

Width - width of DraggingZone.

Height - height of DraggingZone.

Draggable — Component you can drag.

Parameters:

ItemToDrop - object you need to drop (Example below).

MustReturnBackOnDrop - boolean parameter means this component will return to start position when it's dropped.

OnDrop - if you need to run some logic when Draggable is dropped then put your method here.

OnDropWithPosition - the same as OnDrop but also set X and Y parameters when component dropped.

ChildContent - default child content.

ContentWhenDragging - child content will be rendered when user drags Draggable component.

Bindings:

X - position on the X-axis.

Y - position on the Y-axis.

DropTarget — Component for creating dropping area.

Parameters:

OnDrop - your method for getting dropped DraggableModel (and ItemToDrop inside) and something else you need.

ValidateItem - method for validating dropped item. If validation is successful then OnAccept will be invoked.

OnAccept - action will be invoked only if ValidateItem method returns true.

OnReject - action will be invoked only if ValidateItem method returns false.

Example

Let's create a test page in blazor and use DragulaDropula here. Page Test.razor:

@page "/Test"

<DraggingZone Width="100vw" Height="100vh">
    <h1>Some test here!</h1>
    
    <Draggable
        OnDrop="@(o => Console.WriteLine("Drop banana!"))"
        ItemToDrop="@("banana")">
        
        <div style="background-color: yellow; width: 100px; height: 100px; color: white;">
            <span style="background-color: darkorange">The banana</span>
        </div>
    </Draggable>
    
    <Draggable
        OnDrop="@(o => Console.WriteLine("Drop apple!"))"
        ItemToDrop="@("apple")">
        
        <div style="background-color: red; width: 100px; height: 100px; color: white;">
            <span>The apple</span>
        </div>
    </Draggable>
    
    <hr />
    
    <DropTarget
        ValidateItem="@(o => o is "banana")"
        OnAccept="@(item => { _result = item; Console.WriteLine(_result); })"
        OnReject="@(o => _result = "absolutely nothing because YOU JUST CAN'T PUT APPLES IN THE BANANA BOX")">
        <div style="background-color: sandybrown; width: 250px; height: 250px; color: black;">
            The banana box
        </div>
    </DropTarget>
    
    <hr />
    
    The result is @(_result).
    
    <hr>
    
    
</DraggingZone>

@code {

    private object _result = "nothing";

}