الفرق بين المراجعتين لصفحة: «JavaScript/Document/queryCommandEnabled»
< JavaScript | Document
لا ملخص تعديل |
|||
سطر 1: | سطر 1: | ||
<noinclude>{{DISPLAYTITLE:<code>Document.queryCommandEnabled()</code>}}</noinclude> | <noinclude>{{DISPLAYTITLE:<code>Document.queryCommandEnabled()</code>}}</noinclude> | ||
يشير التّابع <code>Document.queryCommandEnabled()</code> إلى ما إذا كان أمر التّحرير المعطى مفعّلًا من طرف المتصفّح | يشير التّابع <code>Document.queryCommandEnabled()</code> إلى ما إذا كان أمر التّحرير المعطى مفعّلًا من طرف المتصفّح أم لا. | ||
==البنية العامة== | ==البنية العامة== | ||
سطر 7: | سطر 7: | ||
</syntaxhighlight> | </syntaxhighlight> | ||
===<code>command</code>=== | |||
الأمر المرغوب التّعرّف على ما إذا كان مدعومًا أو لا. | الأمر المرغوب التّعرّف على ما إذا كان مدعومًا أو لا. | ||
سطر 24: | سطر 23: | ||
==ملاحظات== | ==ملاحظات== | ||
* بالنّسبة للأمران <code>'cut'</code> و<code>'copy'</code> فإنّ التّابع يعيد القيمة <code>true</code> فقط إن استدعيَ في | * بالنّسبة للأمران <code>'cut'</code> و<code>'copy'</code> فإنّ التّابع يعيد القيمة <code>true</code> فقط إن استدعيَ في «خيط» مهيّئ من طرف المستخدم (user-initiated thread). | ||
* يعيد الأمر <code>'paste'</code> القيمة <code>false</code> في حالة لم يكن الأمر متاحًا إضافةً إلى حالة كون السكربت المستدعي ذا صلاحيّات غير كافيّة للقيام بالعمليّة. | * يعيد الأمر <code>'paste'</code> القيمة <code>false</code> في حالة لم يكن الأمر متاحًا إضافةً إلى حالة كون السكربت المستدعي ذا صلاحيّات غير كافيّة للقيام بالعمليّة. | ||
سطر 49: | سطر 48: | ||
==مصادر ومواصفات== | ==مصادر ومواصفات== | ||
* مواصفة [https://w3c.github.io/editing/#querycommandenabled() HTML Editing APIs] | * مواصفة [https://w3c.github.io/editing/#querycommandenabled() HTML Editing APIs]. | ||
[[تصنيف:JavaScript]] | [[تصنيف:JavaScript]] |
المراجعة الحالية بتاريخ 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.