refactor: 更改参数名称为 AllowDrag

Author: ArgoZhang

src/BootstrapBlazor/Components/TreeView/TreeView.razor

@@ -68,7 +68,7 @@ else
     RenderFragment RenderRow(TreeViewItem<TItem> item) =>
     @<TreeViewRow @key="item" IsActive="GetActive(item)" Index="GetIndex(item)" Item="item"
                   NodeIcon="@NodeIcon" ExpandNodeIcon="@ExpandNodeIcon" LoadingIcon="@LoadingIcon"
-                  MaxSelectedCount="MaxSelectedCount" Draggable="ItemDraggable" PreviewDrop="_previewDrop"
+                  MaxSelectedCount="MaxSelectedCount" AllowDrag="AllowDrag" PreviewDrop="_previewDrop"
                   ToolbarEditTitle="@ToolbarEditTitle" ToolbarEditLabelText="@ToolbarEditLabelText"
                   IsDisabled="IsDisabled" CanExpandWhenDisabled="CanExpandWhenDisabled"
                   ShowCheckbox="ShowCheckbox" ShowIcon="ShowIcon"

src/BootstrapBlazor/Components/TreeView/TreeView.razor.cs

@@ -269,17 +269,19 @@ public partial class TreeView<TItem> : IModelEqualityComparer<TItem>
     public bool AutoCheckParent { get; set; }
 
     /// <summary>
-    /// Gets or sets whether to enable item dragging. Default is false.
+    /// Gets or sets a value indicating whether drag-and-drop operations are allowed. Default is false
     /// </summary>
     [Parameter]
-    public bool ItemDraggable { get; set; }
+    public bool AllowDrag { get; set; }
 
     /// <summary>
-    /// Gets or sets the callback method to be invoked when an item is dropped.
-    /// Drop action can be cancelled by returning false.
+    /// Gets or sets the asynchronous callback that is invoked when a drag-and-drop operation ends.
     /// </summary>
+    /// <remarks>This callback allows handling of the finalization of a drag-and-drop operation, such as
+    /// updating the data model or providing feedback to the user. If not set, no action is taken when the drag
+    /// operation ends.</remarks>
     [Parameter]
-    public Func<TreeDropEventArgs<TItem>, Task<bool>> OnDrop { get; set; } = _ => Task.FromResult(true);
+    public Func<TreeDropEventArgs<TItem>, Task<bool>>? OnDragItemEndAsync { get; set; }
 
     [Inject]
     [NotNull]

src/BootstrapBlazor/Components/TreeView/TreeViewRow.razor

@@ -9,23 +9,6 @@
     <div class="tree-content-body">
         <DynamicElement TagName="i" class="@CaretClassString" TriggerClick="CanTriggerClickNode" OnClick="ToggleNodeAsync"></DynamicElement>
         <i class="@NodeLoadingClassString"></i>
-
-        @if (Draggable && !_draggingItem)
-        {
-            <div class="tree-drop-zone">
-                <div class="tree-drop-child-inside"
-                     ondragover="event.preventDefault();"
-                     @ondragenter="DragEnterChildInside"
-                     @ondragleave="DragLeaveChildInside"
-                     @ondrop="DropChildInside"></div>
-                <div class="tree-drop-child-below"
-                     ondragover="event.preventDefault();"
-                     @ondragenter="DragEnterChildBelow"
-                     @ondragleave="DragLeaveChildBelow"
-                     @ondrop="DropChildBelow"></div>
-            </div>
-        }
-
         @if (ShowCheckbox)
         {
             <Checkbox Value="@Item" IsDisabled="ItemDisabledState"
@@ -35,7 +18,7 @@
             </Checkbox>
         }
         <DynamicElement class="@NodeClassString" TriggerClick="!ItemDisabledState" OnClick="ClickRow"
-                        draggable="@(Draggable ? "true" : "false")"
+                        draggable="@DraggableString"
                         @ondragstart="DragStart" @ondragend="DragEnd">
             @if (ShowIcon)
             {

src/BootstrapBlazor/Components/TreeView/TreeViewRow.razor.cs

@@ -139,6 +139,12 @@ public partial class TreeViewRow<TItem>
     [Parameter]
     public Func<TItem, string?, Task<bool>>? OnUpdateCallbackAsync { get; set; }
 
+    /// <summary>
+    /// Gets or sets whether the node can be dragged. Default is false.
+    /// </summary>
+    [Parameter]
+    public bool AllowDrag { get; set; }
+
     [Inject]
     [NotNull]
     private IOptionsMonitor<BootstrapBlazorOptions>? Options { get; set; }
@@ -176,11 +182,8 @@ public partial class TreeViewRow<TItem>
         .Build();
 
     private bool IsPreventDefault => ContextMenuZone != null;
-
     private bool _touchStart = false;
-
     private bool _isBusy = false;
-
     private bool _showToolbar = false;
 
     /// <summary>
@@ -293,15 +296,6 @@ private async Task ClickRow()
         }
     }
 
-    #region Draggable
-
-
-    /// <summary>
-    /// Gets or sets whether the node can be dragged. Default is false.
-    /// </summary>
-    [Parameter]
-    public bool Draggable { get; set; }
-
     /// <summary>
     /// Gets or sets whether to preview the drop target when dragging. Default is false.
     /// </summary>
@@ -326,7 +320,8 @@ private async Task ClickRow()
     /// <summary>
     /// Triggered when an item is dropped
     /// </summary>
-    [Parameter][Required]
+    [Parameter]
+    [Required]
     public Func<TreeDropEventArgs<TItem>, Task> OnItemDrop { get; set; } = null!;
 
     private async Task DragStart(DragEventArgs e)
@@ -336,7 +331,8 @@ private async Task DragStart(DragEventArgs e)
         {
             _expandAfterDrop = true;
             await ToggleNodeAsync();
-        }else
+        }
+        else
         {
             _expandAfterDrop = false;
         }
@@ -352,6 +348,8 @@ private void DragEnd(DragEventArgs e)
         OnItemDragEnd?.Invoke();
     }
 
+    private string? DraggableString => AllowDrag ? "true" : null;
+
     private bool _previewChildLast;
     private bool _previewChildFirst;
     private bool _previewBelow;
@@ -424,7 +422,4 @@ private async Task DropChildBelow(DragEventArgs e)
         var dropTask = OnItemDrop.Invoke(args);
         await dropTask;
     }
-
-
-    #endregion
 }