Document.hasFocus()‎

من موسوعة حسوب
اذهب إلى: تصفح، ابحث

يُعيد التّابع Document.hasFocus‎()‎ قيمة منطقيّة من النّوع Boolean تدلّ على ما إذا كان المستند أو أي عنصرٍ داخل المستند مُركَّزًا عليه أو لا. يُستعمل هذا التّابع لتحديد ما إذا كان العنصر المفعّل في مستند مُركَّزًا عليه أو لا.

ملاحظة: عند عرض مستندٍ ما، فالعنصر المُركّز عليه هو دائمًا العنصر المفعّل في المستند، لكنّ العنصر المفعّل لا يكون دائمًا مُركَّزًا عليه بالضّرورة. على سبيل المثال، عنصر مُفعّل داخل نافذة منبثقة في الخلفيّة لا يكون مركّزًا عليه.

البنية العامة

focused = document.hasFocus();

القيمة المعادة

القيمة false إن لم يكن العنصر المفعّل في المستند ذا تركيز؛ والقيمة true إن كان العنصر المفعّل في المستند ذا تركيز.

مثال

<!DOCTYPE html>
<html lang="en">
<head>
<meta charset="UTF-8" />
<title>TEST</title>
<style>
#message { font-weight: bold; }
</style>
<script>
setInterval( checkPageFocus, 200 );

function checkPageFocus() {
  var info = document.getElementById("message");

  if ( document.hasFocus() ) {
    info.innerHTML = "المستند مركّز عليه";
  } else {
    info.innerHTML = "المستند غير مركّز عليه";
  }
}

function openWindow() {
  window.open (
    "http://developer.mozilla.org/",
    "mozdev",
    "width=640,height=300,left=150,top=260"
  );
}
</script>
</head>
<body>
  <h1>JavaScript hasFocus example</h1>
  <div id="message">بانتظار حركة المستخدم</div>
  <div><button onclick="openWindow()">افتح نافذة جديدة</button></div>
</body>
</html>

دعم المتصفّحات

الميزة Chrome Firefox Internet Explorer Opera Safari
الدعم الأساسي 30 3 6 لا نعم

مصادر ومواصفات