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 ؟ ؟

انظر أيضًا

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