Document.queryCommandEnabled()‎

يشير التّابع 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	؟	؟

انظر أيضًا

• Document.execCommand()‎
• Document.queryCommandSupported()‎

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

• مواصفة Document Object Model (DOM) Level 2 HTML Specification