إنشاء تجارب ملء الشاشة

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

عرض تطبيقك أو موقعك الإلكتروني بملء الشاشة

هناك عدة طرق يمكن للمستخدم أو المطوّر من خلالها عرض تطبيق ويب بملء الشاشة.

  • اطلب من المتصفّح الانتقال إلى وضع ملء الشاشة استجابةً لإجراء تفاعلي من المستخدم.
  • ثبِّت التطبيق على الشاشة الرئيسية.
  • يمكنك إخفاء شريط العناوين تلقائيًا.

طلب الانتقال إلى وضع ملء الشاشة في المتصفّح استجابةً لإجراء تفاعلي من المستخدم

لا تتساوى جميع الأنظمة الأساسية. لا يتوفّر في متصفّح Safari على نظام التشغيل iOS واجهة برمجة تطبيقات لملء الشاشة، ولكنّها تتوفّر في متصفّح Chrome على نظام التشغيل Android، ومتصفّح Firefox، ومتصفّح IE 11 والإصدارات الأحدث. ستستخدم معظم التطبيقات التي تنشئها مزيجًا من واجهة برمجة تطبيقات JS وأدوات اختيار لغة CSS التي توفّرها مواصفات ملء الشاشة. واجهات برمجة التطبيقات الرئيسية في JS التي يجب الاهتمام بها عند إنشاء تجربة ملء الشاشة هي:

  • element.requestFullscreen() (مسبوقة حاليًا في Chrome وFirefox وIE) تعرض العنصر في وضع ملء الشاشة.
  • document.exitFullscreen() (مسبوقة حاليًا في Chrome وFirefox وIE. يستخدم Firefox مفتاح cancelFullScreen() بدلاً من ذلك) لإلغاء وضع ملء الشاشة.
  • ‫document.fullscreenElement (مسبوقة حاليًا في Chrome وFirefox وIE) تعرض القيمة "صحيح" إذا كان أي من العناصر في وضع ملء الشاشة.

عندما يكون تطبيقك في وضع ملء الشاشة، لن تتوفر لك عناصر التحكّم في واجهة المستخدم الخاصة بالمتصفح. يؤدي هذا إلى تغيير طريقة تفاعل المستخدمين مع تجربتك. لا تحتوي على عناصر التحكم في التنقل القياسية مثل الأمام والخلف؛ ليس لديهم فتحة الهروب وهي زر التحديث. من المهم تلبية احتياجات هذا السيناريو. يمكنك استخدام بعض أدوات اختيار لغة CSS لمساعدتك في تغيير نمط موقعك الإلكتروني وطريقة عرضه عندما يدخل المتصفّح في وضع ملء الشاشة.

<button id="goFS">Go fullscreen</button>
<script>
  var goFS = document.getElementById('goFS');
  goFS.addEventListener(
    'click',
    function () {
      document.body.requestFullscreen();
    },
    false,
  );
</script>

المثال أعلاه مصطنع بعض الشيء؛ لقد أخفيت كل التعقيدات حول استخدام بادئات البائع.

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

function toggleFullScreen() {
  var doc = window.document;
  var docEl = doc.documentElement;

  var requestFullScreen =
    docEl.requestFullscreen ||
    docEl.mozRequestFullScreen ||
    docEl.webkitRequestFullScreen ||
    docEl.msRequestFullscreen;
  var cancelFullScreen =
    doc.exitFullscreen ||
    doc.mozCancelFullScreen ||
    doc.webkitExitFullscreen ||
    doc.msExitFullscreen;

  if (
    !doc.fullscreenElement &&
    !doc.mozFullScreenElement &&
    !doc.webkitFullscreenElement &&
    !doc.msFullscreenElement
  ) {
    requestFullScreen.call(docEl);
  } else {
    cancelFullScreen.call(doc);
  }
}

نحن مطوِّرو تطبيقات الويب نكره التعقيد. من واجهات برمجة التطبيقات المجرّدة العالية المستوى التي يمكنك استخدامها وحدة Screenfull.js من Sindre Sorhus التي توحّد واجهتَي برمجة التطبيقات JS المختلفتَين قليلاً والبادئات الخاصة بالمورّدين في واجهة برمجة تطبيقات واحدة متّسقة.

نصائح حول واجهة برمجة التطبيقات Fullscreen API

عرض المستند بملء الشاشة
ملء الشاشة على عنصر النص
الشكل 1: ملء الشاشة على عنصر النص الأساسي

قد تعتقد أنّه من الطبيعي عرض عنصر body في وضع ملء الشاشة، ولكن إذا كنت تستخدم محرّك عرض يستند إلى WebKit أو Blink، ستلاحظ أنّه يؤدي إلى تقليص عرض body إلى أصغر حجم ممكن يحتوي على كل المحتوى. (Mozilla Gecko مناسب.)

ملء الشاشة على عنصر المستند
الشكل 2: ملء الشاشة على عنصر المستند

لحلّ هذه المشكلة، استخدِم عنصر المستند بدلاً من عنصر النص:

document.documentElement.requestFullscreen();
عرض عنصر فيديو بملء الشاشة

إنّ عرض عنصر فيديو في وضع ملء الشاشة هو نفسه تمامًا مثل عرض أي عنصر آخر في وضع ملء الشاشة. يمكنك استدعاء طريقة requestFullscreen في عنصر الفيديو.

<video id="videoElement"></video>
<button id="goFS">Go Fullscreen</button>
<script>
  var goFS = document.getElementById('goFS');
  goFS.addEventListener(
    'click',
    function () {
      var videoElement = document.getElementById('videoElement');
      videoElement.requestFullscreen();
    },
    false,
  );
</script>

إذا لم يتضمّن عنصر <video> سمة عناصر التحكّم المحدّدة، لن يتمكّن المستخدم من التحكّم في الفيديو بعد عرضه في وضع ملء الشاشة. الطريقة المقترَحة لتنفيذ ذلك هي استخدام حاوية أساسية تلتف حول الفيديو وعناصر التحكّم التي تريد أن يراها المستخدم.

<div id="container">
  <video></video>
  <div>
    <button>Play</button>
    <button>Stop</button>
    <button id="goFS">Go fullscreen</button>
  </div>
</div>
<script>
  var goFS = document.getElementById('goFS');
  goFS.addEventListener(
    'click',
    function () {
      var container = document.getElementById('container');
      container.requestFullscreen();
    },
    false,
  );
</script>

يمنحك ذلك مرونة أكبر لأنّه يمكنك دمج عنصر الحاوية مع أداة الاختيار الزائفة في CSS (على سبيل المثال، لإخفاء الزر "goFS").

<style>
  #goFS:-webkit-full-screen #goFS {
    display: none;
  }
  #goFS:-moz-full-screen #goFS {
    display: none;
  }
  #goFS:-ms-fullscreen #goFS {
    display: none;
  }
  #goFS:fullscreen #goFS {
    display: none;
  }
</style>

باستخدام هذه الأنماط، يمكنك رصد وقت تشغيل وضع ملء الشاشة وتكييف واجهة المستخدم بشكل مناسب، على سبيل المثال:

  • من خلال توفير رابط للعودة إلى صفحة البدء
  • من خلال توفير آلية لإغلاق مربّعات الحوار أو الرجوع إلى الخلف

فتح صفحة بملء الشاشة من الشاشة الرئيسية

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

Across the major mobile platforms it is pretty easy to implement using either meta tags, or manifest files as follows.

iOS

منذ إطلاق iPhone، أصبح بإمكان المستخدمين تثبيت تطبيقات الويب على الشاشة الرئيسية وتشغيلها كتطبيقات ويب بملء الشاشة.

<meta name="apple-mobile-web-app-capable" content="yes" />

إذا تم ضبط المحتوى على "نعم"، يتم تشغيل تطبيق الويب في وضع ملء الشاشة، وإلا فلن يتم تشغيله. الإعداد التلقائي هو استخدام Safari لعرض المحتوى على الويب. يمكنك تحديد ما إذا كانت صفحة الويب معروضة في وضع ملء الشاشة باستخدام السمة window.navigator.standalone للقراءة فقط في JavaScript.

Apple

Chrome لنظام Android

نفّذ فريق Chrome مؤخرًا ميزة تطلب من المتصفّح تشغيل الصفحة في وضع ملء الشاشة عندما يضيفها المستخدم إلى الشاشة الرئيسية. وهو مشابه لنموذج Safari على iOS.

<meta name="mobile-web-app-capable" content="yes" />

يمكنك إعداد تطبيق الويب لإضافة رمز اختصار للتطبيق إلى الشاشة الرئيسية للجهاز، وتشغيل التطبيق في "وضع التطبيق" بملء الشاشة باستخدام عنصر القائمة "إضافة إلى الشاشة الرئيسية" في Chrome لنظام التشغيل Android.

Google Chrome

والخيار الأفضل هو استخدام بيان تطبيق الويب.

بيان تطبيق الويب (Chrome وOpera وFirefox وSamsung)

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

  1. إعلام المتصفّح بملف البيان
  2. وصف كيفية الإطلاق

بعد إنشاء ملف البيان واستضافته على موقعك الإلكتروني، ما عليك سوى إضافة علامة رابط من جميع صفحاتك التي تشمل تطبيقك، على النحو التالي:

<link rel="manifest" href="/manifest.json" />

يتيح Chrome استخدام ملفات البيان منذ الإصدار 38 لنظام التشغيل Android (أكتوبر 2014)، ويمنحك إمكانية التحكّم في كيفية ظهور تطبيق الويب عند تثبيته على الشاشة الرئيسية (من خلال السمات short_name وname وicons) وكيفية تشغيله عندما ينقر المستخدم على رمز التشغيل (من خلال start_url وdisplay وorientation).

في ما يلي مثال على ملف بيان. ولا يعرض كل ما يمكن أن يكون في ملف البيان.

{
  "short_name": "Kinlan's Amaze App",
  "name": "Kinlan's Amazing Application ++",
  "icons": [
    {
      "src": "launcher-icon-4x.png",
      "sizes": "192x192",
      "type": "image/png"
    }
  ],
  "start_url": "/index.html",
  "display": "standalone",
  "orientation": "landscape"
}

هذه الميزة تقدّمية بالكامل وتتيح لك إنشاء تجارب أفضل وأكثر تكاملاً لمستخدمي المتصفّحات التي تتيح هذه الميزة.

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

تطبيقات الأدوات المساعدة

ستستفيد معظم تطبيقات الأدوات المساعدة من هذه الميزة على الفور. بالنسبة إلى هذه التطبيقات، من المرجّح أنك تريد تشغيلها بشكل مستقل مثل أي تطبيق آخر على نظام أساسي للأجهزة الجوّالة. لإعلام التطبيق بأنّه يجب تشغيله بشكل مستقل، أضِف ما يلي إلى بيان تطبيق الويب:

    "display": "standalone"
الألعاب

ستستفيد معظم الألعاب من ملف البيان على الفور. تتطلب الغالبية العظمى من الألعاب تشغيلها في وضع ملء الشاشة وفرض اتجاه معيّن.

إذا كنت تطوّر لعبة تمرير عمودي أو لعبة مثل Flappy Birds، فمن المرجّح أنك تريد أن تكون لعبتك دائمًا في الوضع العمودي.

    "display": "fullscreen",
    "orientation": "portrait"

أما إذا كنت تطوّر لعبة ألغاز أو لعبة مثل X-Com، فمن الأفضل أن تستخدم اللعبة دائمًا الاتجاه الأفقي.

    "display": "fullscreen",
    "orientation": "landscape"
المواقع الإخبارية

في معظم الحالات، تكون المواقع الإخبارية عبارة عن تجارب تستند إلى المحتوى فقط. معظم المطوّرين لا يفكّرون عادةً في إضافة ملف بيان إلى موقع إخباري. سيسمح لك ملف البيان بتحديد ما تريد تشغيله (الصفحة الأولى من موقعك الإخباري) وكيفية تشغيله (ملء الشاشة أو كعلامة تبويب متصفّح عادية).

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

    "display": "browser"

إذا أردت أن يبدو موقعك الإخباري مثل معظم التطبيقات التي تركّز على الأخبار، يمكنك إزالة كل عناصر واجهة المستخدم التي تشبه الويب من واجهة المستخدم من خلال ضبط العرض على standalone.

    "display": "standalone"

إخفاء شريط العناوين تلقائيًا

يمكنك "محاكاة وضع ملء الشاشة" من خلال إخفاء شريط العناوين تلقائيًا على النحو التالي:

window.scrollTo(0, 1);

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

على سبيل المثال، غالبًا ما تستعيد المتصفّحات الموضع على الصفحة عندما ينتقل المستخدم إليها مرة أخرى. ويؤدي استخدام window.scrollTo إلى إلغاء هذا الإعداد، ما يزعج المستخدم. لحلّ هذه المشكلة، عليك تخزين آخر موضع في localStorage، والتعامل مع الحالات الاستثنائية (على سبيل المثال، إذا كان المستخدم قد فتح الصفحة في نوافذ متعددة).

إرشادات تجربة المستخدم

عند إنشاء موقع إلكتروني يستفيد من ميزة ملء الشاشة، هناك عدد من التغييرات المحتملة في تجربة المستخدم التي يجب أن تكون على دراية بها لتتمكّن من إنشاء خدمة يحبّها المستخدمون.

لا تعتمد على عناصر التحكّم في التنقّل

لا يتضمّن نظام التشغيل iOS زر رجوع أو إيماءة إعادة تحميل. لذلك يجب عليك التأكد من أن المستخدمين يمكنهم التنقل في جميع أنحاء التطبيق دون أن يتم قفلهم.

يمكنك بسهولة رصد ما إذا كنت تستخدم وضع ملء الشاشة أو وضع التثبيت على جميع المنصات الرئيسية.

iOS

على أجهزة iOS، يمكنك استخدام القيمة المنطقية navigator.standalone لمعرفة ما إذا كان المستخدم قد فتح التطبيق من الشاشة الرئيسية أم لا.

if (navigator.standalone == true) {
  // My app is installed and therefore fullscreen
}

بيان تطبيق الويب (Chrome وOpera وSamsung)

عند تشغيل Chrome كتطبيق مثبّت، لا يتم تشغيله في وضع ملء الشاشة الحقيقي، لذا تعرض السمة document.fullscreenElement القيمة null ولا تعمل أدوات اختيار لغة CSS.

عندما يطلب المستخدم ملء الشاشة من خلال إيماءة على موقعك الإلكتروني، تتوفّر واجهات برمجة التطبيقات العادية لملء الشاشة، بما في ذلك أداة الاختيار الزائفة في CSS التي تتيح لك تكييف واجهة المستخدم للتفاعل مع حالة ملء الشاشة على النحو التالي

selector:-webkit-full-screen {
  display: block; // displays the element only when in fullscreen
}

selector {
  display: none; // hides the element when not in fullscreen mode
}

إذا فتح المستخدمون موقعك الإلكتروني من الشاشة الرئيسية، سيتم ضبط الاستعلام عن الوسائط display-mode على ما تم تحديده في بيان تطبيق الويب. في حالة ملء الشاشة الخالص، سيكون:

@media (display-mode: fullscreen) {
}

إذا شغّل المستخدم التطبيق في وضع مستقل، سيكون الاستعلام عن الوسائط display-mode على النحو التالي standalone:

@media (display-mode: standalone) {
}

Firefox

عندما يطلب المستخدم ملء الشاشة من خلال موقعك الإلكتروني أو يشغّل التطبيق في وضع ملء الشاشة، تتوفّر جميع واجهات برمجة التطبيقات العادية لملء الشاشة، بما في ذلك محدِّد CSS الزائف، الذي يتيح لك تكييف واجهة المستخدم للتفاعل مع حالة ملء الشاشة على النحو التالي:

selector:-moz-full-screen {
  display: block; // hides the element when not in fullscreen mode
}

selector {
  display: none; // hides the element when not in fullscreen mode
}

Internet Explorer

في IE، تفتقر فئة CSS الزائفة إلى واصلة، ولكنها تعمل بشكل مشابه لمتصفح Chrome وFirefox.

selector:-ms-fullscreen {
  display: block;
}

selector {
  display: none; // hides the element when not in fullscreen mode
}

المواصفات

تتطابق طريقة الكتابة في المواصفات مع البنية التي يستخدمها IE.

selector:fullscreen {
  display: block;
}

selector {
  display: none; // hides the element when not in fullscreen mode
}

إبقاء المستخدم في تجربة ملء الشاشة

يمكن أن تكون واجهة برمجة التطبيقات بملء الشاشة صعبة بعض الشيء في بعض الأحيان. لا يريد مورّدو المتصفّحات حصر المستخدمين في صفحة بملء الشاشة، لذا طوّروا آليات للخروج من وضع ملء الشاشة في أقرب وقت ممكن. هذا يعني أنّه لا يمكنك إنشاء موقع إلكتروني بملء الشاشة يمتد على صفحات متعددة للأسباب التالية:

  • يؤدي تغيير عنوان URL آليًا باستخدام window.location = "http://example.com" إلى الخروج من وضع ملء الشاشة.
  • إذا نقر المستخدم على رابط خارجي داخل صفحتك، سيتم الخروج من وضع ملء الشاشة.
  • سيؤدي تغيير عنوان URL من خلال واجهة برمجة التطبيقات navigator.pushState أيضًا إلى الخروج من تجربة ملء الشاشة.

يتوفّر لك خياران إذا أردت إبقاء المستخدم في تجربة ملء الشاشة:

  1. استخدِم آليات تطبيقات الويب القابلة للتثبيت للانتقال إلى وضع ملء الشاشة.
  2. إدارة واجهة المستخدم وحالة التطبيق باستخدام الجزء #.

باستخدام البنية # لتعديل عنوان URL ‏ (window.location = "#somestate") والاستماع إلى الحدث window.onhashchange، يمكنك استخدام حزمة السجلّ الخاصة بالمتصفّح لإدارة التغييرات في حالة التطبيق، أو السماح للمستخدم باستخدام أزرار الرجوع في جهازه، أو تقديم تجربة بسيطة لزر الرجوع الآلي باستخدام واجهة برمجة التطبيقات History API على النحو التالي:

window.history.go(-1);

السماح للمستخدم باختيار وقت الانتقال إلى وضع ملء الشاشة

لا يوجد شيء أكثر إزعاجًا للمستخدم من قيام موقع ويب بشيء غير متوقع. عندما ينتقل المستخدم إلى موقعك الإلكتروني، لا تحاول خداعه للانتقال إلى وضع ملء الشاشة.

لا تعترض حدث اللمس الأول واستدعِ requestFullscreen().

  1. هذا مزعج.
  2. قد تقرّر المتصفّحات أن تطلب من المستخدم في وقت ما في المستقبل السماح للتطبيق باستخدام وضع ملء الشاشة.

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

لا ترسل رسائل غير مرغوب فيها إلى المستخدم لتثبيت تطبيقك على الشاشة الرئيسية

إذا كنت تخطط لتقديم تجربة ملء الشاشة من خلال آليات التطبيق المثبّت، يُرجى مراعاة المستخدم.

  • Be discreet. استخدِم بانرًا أو تذييلاً لإعلامهم بأنّه يمكنهم تثبيت التطبيق.
  • إذا أغلق المستخدم الطلب، لا تعرضه مرة أخرى.
  • في الزيارة الأولى للمستخدم، من غير المرجّح أن يرغب في تثبيت التطبيق ما لم يكن راضيًا عن خدمتك. ننصحك بطلب تثبيت التطبيق بعد تفاعل إيجابي على موقعك الإلكتروني.
  • إذا كان المستخدم يزور موقعك بانتظام ولا يثبّت التطبيق، فمن غير المرجح أن يثبّت تطبيقك في المستقبل. لا تواصل إرسال رسائل غير مرغوب فيها إليهم.

الخاتمة

على الرغم من عدم توفّر واجهة برمجة تطبيقات موحّدة بالكامل، يمكنك بسهولة إنشاء تجارب تستفيد من شاشة المستخدم بالكامل، بغض النظر عن العميل، وذلك من خلال اتّباع بعض الإرشادات الواردة في هذه المقالة.

الملاحظات