फ़ाइलों को खींचकर छोड़ने का तरीका

एचटीएमएल ड्रैग ऐंड ड्रॉप इंटरफ़ेस की मदद से, वेब ऐप्लिकेशन किसी वेब पेज पर ड्रैग ऐंड ड्रॉप की गई फ़ाइलें स्वीकार कर सकते हैं. खींचने और छोड़ने की प्रोसेस के दौरान, खींची गई फ़ाइल और डायरेक्ट्री आइटम, फ़ाइल एंट्री और डायरेक्ट्री एंट्री से जुड़े होते हैं. फ़ाइलों को ब्राउज़र में खींचकर छोड़ने के दो तरीके हैं: नया तरीका और क्लासिक तरीका.

मॉडर्न तरीका

File System Access API के DataTransferItem.getAsFileSystemHandle() तरीके का इस्तेमाल करना

अगर ड्रैग किया गया आइटम कोई फ़ाइल है, तो DataTransferItem.getAsFileSystemHandle() तरीका FileSystemFileHandle ऑब्जेक्ट के साथ एक प्रॉमिस दिखाता है. अगर ड्रैग किया गया आइटम कोई डायरेक्ट्री है, तो यह FileSystemDirectoryHandle ऑब्जेक्ट के साथ एक प्रॉमिस दिखाता है. इन हैंडल की मदद से, फ़ाइल या डायरेक्ट्री को पढ़ा जा सकता है. साथ ही, फ़ाइल या डायरेक्ट्री में बदलाव भी किया जा सकता है. ध्यान दें कि खींचकर छोड़ने वाले इंटरफ़ेस का DataTransferItem.kind, फ़ाइलों और डायरेक्ट्री, दोनों के लिए "file" होगा. वहीं, फ़ाइल सिस्टम ऐक्सेस एपीआई का FileSystemHandle.kind, फ़ाइलों के लिए "file" और डायरेक्ट्री के लिए "directory" होगा.

Browser Support

  • Chrome: 86.
  • Edge: 86.
  • Firefox: not supported.
  • Safari: not supported.

Source

क्लासिक तरीका

DataTransferItem.getAsFile() वाले क्लासिक तरीके का इस्तेमाल करना

DataTransferItem.getAsFile() तरीका, ड्रैग किए गए डेटा आइटम का File ऑब्जेक्ट दिखाता है. अगर आइटम कोई फ़ाइल नहीं है, तो यह तरीका null दिखाता है. फ़ाइल को पढ़ा जा सकता है, लेकिन उसमें वापस नहीं लिखा जा सकता. इस तरीके का नुकसान यह है कि यह डायरेक्ट्री के साथ काम नहीं करता.

Browser Support

  • Chrome: 11.
  • Edge: 12.
  • Firefox: 50.
  • Safari: 5.1.

Source

परतदार वृद्धि

नीचे दिए गए स्निपेट में, File System Access API के DataTransferItem.getAsFileSystemHandle() तरीके का इस्तेमाल किया गया है. अगर यह तरीका काम नहीं करता है, तो यह स्निपेट नॉन-स्टैंडर्ड DataTransferItem.webkitGetAsEntry() तरीके का इस्तेमाल करता है. अगर यह तरीका भी काम नहीं करता है, तो यह स्निपेट क्लासिक DataTransferItem.getAsFile() तरीके का इस्तेमाल करता है. हर handle का टाइप ज़रूर देखें, क्योंकि यह इनमें से कोई भी हो सकता है:

  • FileSystemFileHandle जब मॉडर्न कोड पाथ चुना जाता है.
  • File जब क्लासिक कोड पाथ चुना जाता है.

सभी टाइप में name प्रॉपर्टी होती है. इसलिए, इसे लॉग करना ठीक है और यह हमेशा काम करेगी.

// Run feature detection.
const supportsFileSystemAccessAPI =
  'getAsFileSystemHandle' in DataTransferItem.prototype;

// This is the drag and drop zone.
const elem = document.querySelector('main');

  // Prevent navigation.
elem.addEventListener('dragover', (e) => {
  e.preventDefault();
});

// Visually highlight the drop zone.
elem.addEventListener('dragenter', (e) => {
  elem.style.outline = 'solid red 1px';
});

// Visually unhighlight the drop zone.
elem.addEventListener('dragleave', (e) => {
  elem.style.outline = '';
});

// This is where the drop is handled.
elem.addEventListener('drop', async (e) => {
  // Prevent navigation.
  e.preventDefault();
  // Unhighlight the drop zone.
  elem.style.outline = '';
  // Prepare an array of promises…
  const fileHandlesPromises = [...e.dataTransfer.items]
    // …by including only files (where file misleadingly means actual file _or_
    // directory)…
    .filter((item) => item.kind === 'file')
    // …and, depending on previous feature detection…
    .map((item) =>
      supportsFileSystemAccessAPI
        // …either get a modern `FileSystemHandle`…
        ? item.getAsFileSystemHandle()
        // …or a classic `File`.
        : item.getAsFile(),
    );
  // Loop over the array of promises.
  for await (const handle of fileHandlesPromises) {
    // This is where we can actually exclusively act on the files.
    if (handle.kind === 'file' || handle.isFile) {
      console.log(`File: ${handle.name}`);
    }
  }
});

इस बारे में और पढ़ें

डेमो

एचटीएमएल

<!DOCTYPE html>
<html lang="en">
  <head>
    <meta charset="utf-8" />
    <meta name="viewport" content="width=device-width, initial-scale=1" />
    <title>How to drag and drop files</title>
  </head>
  <body>
    <main>
      <h1>How to drag and drop files</h1>
      <p>Drag and drop one or multiple files onto the page.</p>
      <pre></pre>
    </main>
  </body>
</html>

सीएसएस


        :root {
  color-scheme: dark light;
  box-sizing: border-box;
}

*,
*:before,
*:after {
  box-sizing: inherit;
}

body {
  margin: 0;
  padding: 1rem;
  font-family: system-ui, sans-serif;
  line-height: 1.5;
  min-height: 100vh;
  display: flex;
  flex-direction: column;
}

img,
video {
  height: auto;
  max-width: 100%;
}

main {
  flex-grow: 1;
}

footer {
  margin-top: 1rem;
  border-top: solid CanvasText 1px;
  font-size: 0.8rem;
}
        

JS


        const supportsFileSystemAccessAPI =
  "getAsFileSystemHandle" in DataTransferItem.prototype;
const supportsWebkitGetAsEntry =
  "webkitGetAsEntry" in DataTransferItem.prototype;

const elem = document.querySelector("main");
const debug = document.querySelector("pre");

elem.addEventListener("dragover", (e) => {
  // Prevent navigation.
  e.preventDefault();
});

elem.addEventListener("dragenter", (e) => {
  elem.style.outline = "solid red 1px";
});

elem.addEventListener("dragleave", (e) => {
  elem.style.outline = "";
});

elem.addEventListener("drop", async (e) => {
  e.preventDefault();
  elem.style.outline = "";
  const fileHandlesPromises = [...e.dataTransfer.items]
    .filter((item) => item.kind === "file")
    .map((item) =>
      supportsFileSystemAccessAPI
        ? item.getAsFileSystemHandle()
        : supportsWebkitGetAsEntry
        ? item.webkitGetAsEntry()
        : item.getAsFile()
    );

  for await (const handle of fileHandlesPromises) {
    if (handle.kind === "directory" || handle.isDirectory) {
      console.log(`Directory: ${handle.name}`);
      debug.textContent += `Directory: ${handle.name}\n`;
    } else {
      console.log(`File: ${handle.name}`);
      debug.textContent += `File: ${handle.name}\n`;
    }
  }
});