الفرق بين المراجعتين لصفحة: «JavaScript/Document/hasFocus»

المراجعة الحالية بتاريخ 11:14، 31 مارس 2018

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

@@ سطر 1: / سطر 1: @@
 <noinclude>{{DISPLAYTITLE:<code>Document.hasFocus()‎</code>}}</noinclude>
-يُعيد التّابع <code>Document.hasFocus‎()‎</code> قيمة منطقيّة من النّوع <code>Boolean</code> تدلّ على ما إذا كان المستند أو أي عنصرٍ داخل المستند مُركَّزًا عليه أو لا. يُستعمل هذا التّابع لتحديد ما إذا كان العنصر المفعّل في مستند مُركَّزًا عليه أو لا.
+يُعيد التّابع <code>Document.hasFocus‎()‎</code> قيمة منطقيّة من النّوع <code>[[JavaScript/Boolean|Boolean]]</code> تدلّ على ما إذا كان المستند أو أي عنصرٍ داخل المستند مُركَّزًا عليه أو لا. يُستعمل هذا التّابع لتحديد ما إذا كان العنصر المفعّل في مستند مُركَّزًا عليه أو لا.
 '''ملاحظة:''' عند عرض مستندٍ ما، فالعنصر المُركّز عليه هو دائمًا العنصر المفعّل في المستند، لكنّ العنصر المفعّل لا يكون دائمًا مُركَّزًا عليه بالضّرورة. على سبيل المثال، عنصر مُفعّل داخل نافذة منبثقة في الخلفيّة لا يكون مركّزًا عليه.
@@ سطر 13: / سطر 13: @@
 ==مثال==
-<syntaxhighlight lang="javascript">
+<syntaxhighlight lang="html">
 <!DOCTYPE html>
 <html lang="en">