Ir para o conteúdo principal

Nativo Arquivo Drag & Drop

Visão Geral

Alguns tipos de aplicativos que manipulam arquivos talvez queiram oferecer suporte ao recurso de drag & drop (arrastar e soltar) nativo do sistema operacional. Arrastar arquivos para a web é bastante comum e utilizado por muitos sites. Além disso, Electron adicionou suporte para arrastar arquivos e conteúdos de fora do conteúdo web para o mundo do sistema operacional.

To implement this feature in your app, you need to call the webContents.startDrag(item) API in response to the ondragstart event.


An example demonstrating how you can create a file on the fly to be dragged out of the window.


In preload.js use the contextBridge to inject a method window.electron.startDrag(...) that will send an IPC message to the main process.

const { contextBridge, ipcRenderer } = require('electron')
const path = require('node:path')

contextBridge.exposeInMainWorld('electron', {
startDrag: (fileName) => {
ipcRenderer.send('ondragstart', path.join(process.cwd(), fileName))


Add a draggable element to index.html, and reference your renderer script:

<div style="border:2px solid black;border-radius:3px;padding:5px;display:inline-block" draggable="true" id="drag">Drag me</div>
<script src="renderer.js"></script>


In renderer.js set up the renderer process to handle drag events by calling the method you added via the contextBridge above.

document.getElementById('drag').ondragstart = (event) => {


In the Main process (main.js file), expand the received event with a path to the file that is being dragged and an icon:

const { app, BrowserWindow, ipcMain } = require('electron/main')
const path = require('node:path')
const fs = require('node:fs')
const https = require('node:https')

function createWindow () {
const win = new BrowserWindow({
width: 800,
height: 600,
webPreferences: {
preload: path.join(__dirname, 'preload.js')


const iconName = path.join(__dirname, 'iconForDragAndDrop.png')
const icon = fs.createWriteStream(iconName)

// Create a new file to copy - you can also copy existing files.
fs.writeFileSync(path.join(__dirname, ''), '# First file to test drag and drop')
fs.writeFileSync(path.join(__dirname, ''), '# Second file to test drag and drop')

https.get('', (response) => {


ipcMain.on('ondragstart', (event, filePath) => {
file: path.join(__dirname, filePath),
icon: iconName

app.on('window-all-closed', () => {
if (process.platform !== 'darwin') {

app.on('activate', () => {
if (BrowserWindow.getAllWindows().length === 0) {

After launching the Electron application, try dragging and dropping the item from the BrowserWindow onto your desktop. In this guide, the item is a Markdown file located in the root of the project:

Drag and drop