Lorixen.
AR

رفع عدة مستندات بالسحب والإفلات مع شريط تقدم لكل ملف

باختصار: حين يطلب مكتبك من الزبون رفع عدة مستندات، كصور هوية العمل أو عقود أو مخططات، فنموذج بزر «اختر ملفاً» واحد يجعله يكرر العملية ملفاً ملفاً، ولا يعرف إن كان الرفع قد اكتمل. منطقة سحب وإفلات تقبل عدة ملفات دفعة واحدة، مع شريط تقدم لكل ملف، تجعل الأمر أوضح. تشرح MDN كيف تبنيها: ألغِ السلوك الافتراضي لحدثي dragover وdrop حتى لا يفتح المتصفح الملف بدل رفعه، واقرأ الملفات من dataTransfer، وأبقِ زر اختيار الملفات العادي بديلاً لمن لا يستطيع السحب أو لا يريده، وخاصة على الجوال. ثم اعرض تقدم كل ملف عبر حدث progress.

موقف مألوف

مكتب تصميم داخلي في عمّان يطلب من الزبائن الجدد قبل الزيارة الأولى: صور الغرف، ومخطط الشقة إن وُجد، وصوراً لأمثلة أعجبتهم. النموذج القديم فيه ثلاثة حقول ملف منفصلة، كل حقل يقبل ملفاً واحداً. ما كان يحدث:

  • زبون لديه 14 صورة يرفع ثلاثاً ثم يرسل الباقي على واتساب.
  • زبون آخر سحب صورة من سطح المكتب إلى الصفحة، ففتحها المتصفح مكان النموذج، وضاع ما كتبه.
  • زبونة ضغطت «إرسال» قبل اكتمال الرفع، لأن الصفحة لم تعرض أي إشارة إلى أن الملفات ما زالت تُرفع.

المشكلة ليست في الزبائن، بل في أن النموذج لا يتصرف كما يتوقعون.

لماذا يفتح المتصفح الملف بدل رفعه

توضح MDN أن المتصفح قد يتعامل مع الملفات المسحوبة بطريقته الافتراضية، كفتحها أو تنزيلها، حتى إن لم تُسحب إلى هدف صالح. لذلك تنصح بالاستماع لحدث drop على النافذة كلها وإلغائه، مع الحرص على فعل ذلك فقط إن كان المسحوب ملفاً، لا رابطاً أو نصاً، حتى يبقى السلوك العادي لغير الملفات.

وتذكر MDN شرطاً آخر: لكي يُطلق حدث drop على العنصر أصلاً، يجب أن يلغي العنصر حدث dragover أيضاً. وإن كنت تستمع لـ drop على النافذة، فعليك إلغاء dragover على مستوى النافذة كذلك.

بكلمات بسيطة: دون هذين السطرين، إما أن يفتح المتصفح الملف، أو لا يحدث شيء عند الإفلات.

قراءة الملفات المسحوبة

في مثال MDN، تُقرأ العناصر من dataTransfer.items، ويُصفّى منها ما نوعه file، ثم يُستخدم getAsFile للوصول إلى كل ملف. بعدها يقرر تطبيقك ما يفعله به: عرض معاينة، أو رفعه إلى الخادم. وتشير MDN إلى أن المثال يعرض الملفات في الصفحة فقط، وأنك في الواقع ستريد رفعها إلى الخادم أيضاً.

ويستخدم المثال dropEffect لإعطاء الزبون إشارة بصرية: "copy" إن كان الملف صورة، و"none" إن لم يكن من النوع المقبول أو لم يُسحب إلى المكان الصحيح. هذا يعني أن مؤشر الفأرة نفسه يخبر الزبون قبل أن يفلت إن كان الملف مقبولاً.

مثال توضيحي مختصر

const zone = document.getElementById('drop-zone');
const input = document.getElementById('files');

window.addEventListener('dragover', (e) => {
  if ([...e.dataTransfer.items].some(i => i.kind === 'file')) e.preventDefault();
});
window.addEventListener('drop', (e) => {
  if ([...e.dataTransfer.items].some(i => i.kind === 'file')) e.preventDefault();
});
zone.addEventListener('drop', (e) => {
  const files = [...e.dataTransfer.items]
    .filter(i => i.kind === 'file')
    .map(i => i.getAsFile());
  files.forEach(uploadOne);
});
input.addEventListener('change', () => [...input.files].forEach(uploadOne));

لاحظ أن الملفات المختارة بالزر والمسحوبة تذهب إلى الدالة نفسها، فلا يختلف شيء بعدها.

لا تلغِ زر الاختيار

تقول MDN إن المثال يوفر اختيار الملفات عبر عنصر input بديلاً لمن لا يستطيع أو لا يريد استخدام السحب والإفلات. وهذا مهم في الأردن تحديداً، لأن نسبة كبيرة من الزبائن قد تفتح النموذج من الجوال، وهناك لا يوجد سطح مكتب يُسحب منه. على الجوال، الزر هو الطريقة الأساسية، ومنطقة الإفلات مجرد إطار جميل حوله.

اجعل منطقة الإفلات نفسها قابلة للضغط لفتح نافذة الاختيار. MDN تبني المنطقة من عنصر label مرتبط بحقل الملف، فيكون الضغط عليها كالضغط على الزر. وأضف الخاصية multiple إلى الحقل حتى يختار الزبون عدة صور مرة واحدة من معرض الجوال.

شريط تقدم لكل ملف

رفع الصور من الجوال على شبكة متوسطة قد يستغرق وقتاً، والزبون يحتاج إلى أن يرى ما يحدث. يعرض توثيق MDN لحدث progress على xhr.upload مثالاً يحدّث شريط تقدم بقيمة event.loaded، ويحسب النسبة بقسمتها على event.total.

اعرض لكل ملف سطراً فيه اسمه وحجمه وشريط تقدمه، ثم علامة واضحة عند الاكتمال أو رسالة عند الفشل مع زر «أعد المحاولة» لذلك الملف وحده. ولا تفعّل زر الإرسال النهائي إلا بعد اكتمال كل الملفات، أو اعرض بجانبه «ما زال يُرفع 3 ملفات».

رفع متوازٍ أم واحداً بعد الآخر؟

إن اختار الزبون 14 صورة دفعة واحدة، فبدء رفعها كلها في اللحظة نفسها قد يبطئ كل واحدة منها على اتصال جوال ضعيف، فيرى الزبون 14 شريطاً لا يتحرك أي منها تقريباً. الأوضح غالباً أن يُرفع ملفان أو ثلاثة في الوقت نفسه، ويبدأ التالي حين ينتهي أحدها. هكذا يرى الزبون ملفات تكتمل واحداً تلو الآخر، ويطمئن أن الأمور تسير.

حدود واضحة قبل الرفع

  • الأنواع المقبولة: اكتب بوضوح ما تقبله، كصور JPG وPNG وملفات PDF، وارفض غيرها قبل الرفع برسالة عربية مفهومة.
  • الحجم: إن كان للخادم حد أقصى لحجم الملف، فاعرضه في النموذج وافحصه في المتصفح قبل البدء، حتى لا ينتظر الزبون دقيقة ثم يُرفض.
  • العدد: إن كان هناك حد لعدد الملفات، فاذكره.
  • الخادم يفحص أيضاً: الفحص في المتصفح لراحة الزبون فقط. الخادم يجب أن يتحقق من النوع والحجم بنفسه، لأن أي شخص يستطيع تجاوز ما في الصفحة.

مثال توضيحي لنص المنطقة

مثال توضيحي لما يُكتب داخل منطقة الإفلات:

«اسحب صور الغرف والمخطط إلى هنا، أو اضغط لاختيارها من جهازك. صور JPG أو PNG أو ملف PDF، حتى 20 ملفاً.»

جملة واحدة تجيب عن ثلاثة أسئلة قبل أن يطرحها الزبون: كيف، وماذا، وكم.

بعد الرفع

أرسل للزبون رسالة تأكيد تذكر عدد الملفات المستلمة، لا مجرد «تم الإرسال». وفي لوحة المكتب، اجعل ملفات كل زبون في مجلد واحد باسمه وتاريخ الطلب، حتى يجدها المصمم قبل الزيارة دون بحث في المحادثات.

أسئلة شائعة

لماذا يفتح المتصفح الصورة حين أسحبها إلى الصفحة؟

لأن هذا سلوكه الافتراضي. MDN توضح أنه يجب إلغاء حدثي drop وdragover على النافذة للملفات حتى لا يحدث ذلك.

هل يعمل السحب والإفلات على الجوال؟

الزبون على الجوال سيستخدم زر الاختيار غالباً. لهذا تبقي MDN حقل input بديلاً، واجعله يقبل عدة ملفات.

كيف أعرف أن الرفع اكتمل؟

اعرض التقدم عبر حدث progress على xhr.upload لكل ملف، ولا تسمح بالإرسال النهائي قبل اكتمال الجميع.

هل يكفي فحص نوع الملف في المتصفح؟

لا. هو لراحة الزبون. الخادم يجب أن يتحقق من النوع والحجم بنفسه.

إذا كان زبائنك يرسلون مستنداتهم على واتساب لأن نموذج الرفع في موقعك مرهق، راسلنا لنعيد تصميمه.

المصادر

WhatsAppاحجز مكالمة