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

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

يشير التّابع Document.queryCommandEnabled‎()‎ إلى ما إذا كان أمر التّحرير المعطى مفعّلًا من طرف المتصفّح أم لا.

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

isEnabled = document.queryCommandEnabled(command);

`command`

الأمر المرغوب التّعرّف على ما إذا كان مدعومًا أو لا.

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

قيمة منطقيّة من النّوع Boolean تكون true إن كان الأمر مُفعّلًا وتكون false إن لم يكن كذلك.

مثال

var flg = document.queryCommandEnabled("SelectAll");

if(flg) {
  document.execCommand("SelectAll", false, null); // الأمر مُفعّل، لذا نفّذه
}

ملاحظات

بالنّسبة للأمران 'cut' و'copy' فإنّ التّابع يعيد القيمة true فقط إن استدعيَ في «خيط» مهيّئ من طرف المستخدم (user-initiated thread).
يعيد الأمر 'paste' القيمة false في حالة لم يكن الأمر متاحًا إضافةً إلى حالة كون السكربت المستدعي ذا صلاحيّات غير كافيّة للقيام بالعمليّة.

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

الميزة	Chrome	Firefox	Internet Explorer	Opera	Safari
الدعم الأساسي	17	9	4	؟	؟

انظر أيضًا

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

مواصفة HTML Editing APIs.

@@ سطر 1: / سطر 1: @@
 <noinclude>{{DISPLAYTITLE:<code>Document.queryCommandEnabled()‎</code>}}</noinclude>
-يشير التّابع <code>Document.queryCommandEnabled‎()‎</code> إلى ما إذا كان أمر التّحرير المعطى مفعّلًا من طرف المتصفّح أو لا.
+يشير التّابع <code>Document.queryCommandEnabled‎()‎</code> إلى ما إذا كان أمر التّحرير المعطى مفعّلًا من طرف المتصفّح أم لا.
 ==البنية العامة==
@@ سطر 7: / سطر 7: @@
 </syntaxhighlight>
-===المعاملات===
+===<code>command</code>===
-====<code>command</code>====
 الأمر المرغوب التّعرّف على ما إذا كان مدعومًا أو لا.
@@ سطر 24: / سطر 23: @@
 ==ملاحظات==
-*  بالنّسبة للأمران <code>'cut'</code> و<code>'copy'</code> فإنّ التّابع يعيد القيمة <code>true</code> فقط إن استدعيَ في سلسلةٍ مهيّئة من طرف المستخدم (user-initiated thread).
+*  بالنّسبة للأمران <code>'cut'</code> و<code>'copy'</code> فإنّ التّابع يعيد القيمة <code>true</code> فقط إن استدعيَ في «خيط» مهيّئ من طرف المستخدم (user-initiated thread).
 * يعيد الأمر <code>'paste'</code> القيمة <code>false</code> في حالة لم يكن الأمر متاحًا إضافةً إلى حالة كون السكربت المستدعي ذا صلاحيّات غير كافيّة للقيام بالعمليّة.
@@ سطر 49: / سطر 48: @@
 ==مصادر ومواصفات==
-* مواصفة [https://www.w3.org/TR/DOM-Level-2-HTML/html.html#ID-72161170 Document Object Model (DOM) Level 2 HTML Specification]
+* مواصفة [https://w3c.github.io/editing/#querycommandenabled() HTML Editing APIs].
   [[تصنيف:JavaScript]]