عرض مصدر JavaScript/Document/hasFocus

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

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

==البنية العامة==
<syntaxhighlight lang="javascript">
focused = document.hasFocus();
</syntaxhighlight>

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

==مثال==
<syntaxhighlight lang="html">
<!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>
</syntaxhighlight>

==دعم المتصفّحات==
{| class="wikitable"
!الميزة
!|Chrome
!Firefox
!Internet Explorer
!Opera
!Safari
|-
! الدعم الأساسي
|30
|3
|6
|لا
|نعم
|}

==مصادر ومواصفات==
* مواصفة [https://html.spec.whatwg.org/multipage/interaction.html#dom-document-hasfocus HTML Living Standard]

 [[تصنيف:JavaScript]]
 [[تصنيف:Web API]]
 [[تصنيف:DOM]]
 [[تصنيف:Document]]