`Document.hasFocus()‎`

The printable version is no longer supported and may have rendering errors. Please update your browser bookmarks and please use the default browser print function instead.

يُعيد التّابع 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	لا	نعم

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

مواصفة HTML Living Standard