Document.queryCommandEnabled()
< JavaScript | Document
يشير التّابع 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.