Merge branch 'development' into 984330-AI-Prompt

Author: rajendranr-5483

blazor-toc.html

@@ -2981,6 +2981,7 @@
 			<li> <a href="/blazor/file-upload/chunk-upload">Chunk Upload</a></li>
 			<li> <a href="/blazor/file-upload/localization">Localization</a></li>
 			<li> <a href="/blazor/file-upload/file-source">File Source</a></li>
+			<li> <a href="/blazor/file-upload/drag-and-drop">Drag and Drop</a></li>
 			<li> <a href="/blazor/file-upload/template">Template</a></li>
 			<li> <a href="/blazor/file-upload/validation">Validation</a></li>
 			<li> <a href="/blazor/file-upload/form-integration">Form Integration</a></li>

blazor/file-upload/drag-and-drop.md

@@ -0,0 +1,177 @@
+---
+layout: post
+title: Drag and Drop in Blazor File Upload Component | Syncfusion
+description: Learn about drag-and-drop file selection, configuring an external drop area, and related behaviors in the Syncfusion Blazor File Upload component.
+platform: Blazor
+control: File Upload
+documentation: ug
+---
+
+# Drag and drop in Blazor File Upload Component
+
+The File Upload component supports drag-and-drop file selection. Users can drag files from the file explorer and drop them into the drop area. By default, the File Upload component acts as the drop area. The drop area is highlighted when files are dragged over it to indicate that dropping is supported.
+
+## Custom DropArea
+
+The File Upload component allows configuring an external target element as the drop area by using the [DropArea](https://help.syncfusion.com/cr/blazor/Syncfusion.Blazor.Inputs.UploaderModel.html#Syncfusion_Blazor_Inputs_UploaderModel_DropArea) property. The element can be specified as an HTML element reference or by using the element’s ID.
+
+```cshtml
+@using Syncfusion.Blazor.Inputs
+
+<div ID="DropArea">
+    Drop files here to upload
+</div>
+
+<SfUploader ID="UploadFiles" AutoUpload="false" DropArea="#DropArea">
+</SfUploader>
+
+<style>
+#DropArea {
+    padding: 50px 25px;
+    margin: 30px auto;
+    border: 1px solid #c3c3c3;
+    text-align: center;
+    width: 100%;
+    display: inline-flex;
+}
+
+.e-file-select,
+.e-file-drop {
+    display: none;
+}
+
+body .e-upload-drag-hover {
+    outline: 2px dashed brown;
+}
+
+#uploadfile {
+    width: 60%;
+    display: inline-flex;
+    margin-left: 5%;
+}
+</style>
+```
+
+{% previewsample "https://blazorplayground.syncfusion.com/embed/BZLoiZrPzKWARfzw?appbar=false&editor=false&result=true&errorlist=false&theme=bootstrap5" %}
+![Customizing Drop Area in Blazor FileUpload](./images/blazor-fileupload-drop-area-customization.gif)
+
+## DropEffect
+
+The File Upload exposes a DropEffect property that controls the cursor feedback and allowed drop operation during drag-and-drop. Set this property to Default, Copy, Move, Link, or None. Default uses the browser’s behavior. Dropped files are added to the selected files list and processed according to component settings (for example, AutoUpload, SaveUrl/RemoveUrl, AllowedExtensions, MinFileSize, and MaxFileSize).
+
+### Copy
+
+Shows a copy cursor during drag-and-drop. Dropped files are added to the File Upload’s selection without modifying the originals. File Upload proceeds based on the component configuration.
+
+```cshtml
+
+@using Syncfusion.Blazor.Inputs
+
+<SfUploader ID="UploadFiles" AutoUpload="false" DropEffect="DropEffect.Copy">
+    <UploaderEvents FileSelected="onFileSelect"></UploaderEvents>
+</SfUploader>
+
+@code{
+    private void onFileSelect(SelectedEventArgs args)
+    {
+        // here you can get dropped file data
+    }
+}
+
+```
+
+{% previewsample "https://blazorplayground.syncfusion.com/embed/LZroMDBPfgwxYYBv?appbar=false&editor=false&result=true&errorlist=false&theme=bootstrap5" %}
+![Copy drop effect in Blazor FileUpload](./images/blazor-fileupload-drag-and-drop-copy.gif)
+
+### Move
+
+Shows a move cursor during drag-and-drop. Source files are not moved from their original location; the File Upload only adds them to the selection and uploads according to configuration.
+
+```cshtml
+
+@using Syncfusion.Blazor.Inputs
+
+<SfUploader ID="UploadFiles" AutoUpload="false" DropEffect="DropEffect.Move">
+    <UploaderEvents FileSelected="onFileSelect"></UploaderEvents>
+</SfUploader>
+
+@code{
+    private void onFileSelect(SelectedEventArgs args)
+    {
+        // here you can get dropped file data
+    }
+}
+
+```
+
+{% previewsample "https://blazorplayground.syncfusion.com/embed/hjBICXBPfzZPgIvh?appbar=false&editor=false&result=true&errorlist=false&theme=bootstrap5" %}
+![Move drop effect in Blazor FileUpload](./images/blazor-fileupload-drop-area-move.gif)
+
+### Link
+
+Shows a link cursor during drag-and-drop. This changes the cursor feedback only; upload behavior remains unchanged.
+
+```cshtml
+
+@using Syncfusion.Blazor.Inputs
+
+<SfUploader ID="UploadFiles" AutoUpload="false" DropEffect="DropEffect.Link">
+    <UploaderEvents FileSelected="onFileSelect"></UploaderEvents>
+</SfUploader>
+
+@code{
+    private void onFileSelect(SelectedEventArgs args)
+    {
+        // here you can get dropped file data
+    }
+}
+
+```
+
+{% previewsample "https://blazorplayground.syncfusion.com/embed/rjBIsDLFJfLAjrAD?appbar=false&editor=false&result=true&errorlist=false&theme=bootstrap5" %}
+![Link drop effect in Blazor FileUpload](./images/blazor-fileupload-drop-area-link.gif)
+
+### None
+
+Prevents dropping files on the File Upload or the configured drop area. Use this when disabling drops is required regardless of validation rules.
+
+```cshtml
+
+@using Syncfusion.Blazor.Inputs
+
+<SfUploader ID="UploadFiles" AutoUpload="false" DropEffect="DropEffect.None">
+    <UploaderEvents FileSelected="onFileSelect"></UploaderEvents>
+</SfUploader>
+
+@code{
+    private void onFileSelect(SelectedEventArgs args)
+    {
+        // here you can get dropped file data
+    }
+}
+
+```
+
+{% previewsample "https://blazorplayground.syncfusion.com/embed/LjrosDhbppKYbVqC?appbar=false&editor=false&result=true&errorlist=false&theme=bootstrap5" %}
+![None drop effect in Blazor FileUpload](./images/blazor-fileupload-drop-area-none.gif)
+
+## Clipboard Paste
+
+The File Upload component supports file selection through clipboard paste operations. Click on the File Upload element and press Ctrl+V to paste files from the clipboard. The pasted files are added to the selected files list.
+
+```cshtml
+@using Syncfusion.Blazor.Inputs
+
+<SfUploader ID="UploadFiles" AutoUpload="false">
+    <UploaderEvents FileSelected="onFileSelect"></UploaderEvents>
+</SfUploader>
+
+@code{
+    private void onFileSelect(SelectedEventArgs args)
+    {
+        // Access pasted file data here
+    }
+}
+```
+{% previewsample "https://blazorplayground.syncfusion.com/embed/BtBysXhPpSVDXqxx?appbar=false&editor=false&result=true&errorlist=false&theme=bootstrap5" %}
+![Clipboard paste file handling in Blazor File Upload component](./images/blazor-fileupload-clipboard-paste.gif)