الفرق بين المراجعتين لصفحة: «Cordova/cordova plugin battery status»
< Cordova
أنشأ الصفحة ب'<noinclude>{{DISPLAYTITLE:إضافة حالة البطارية cordova-plugin-battery-status في كوردوفا}}</noinclude> تصنيف: Cordova تصنيف: p...' |
لا ملخص تعديل |
||
| سطر 1: | سطر 1: | ||
<noinclude>{{DISPLAYTITLE:إضافة حالة البطارية cordova-plugin-battery-status في كوردوفا}}</noinclude> | <noinclude>{{DISPLAYTITLE:إضافة حالة البطارية cordova-plugin-battery-status في كوردوفا}}</noinclude> | ||
[[تصنيف: Cordova]] | [[تصنيف: Cordova]] | ||
[[تصنيف: plugin]] | [[تصنيف: plugin]] | ||
[[تصنيف: cordova-plugin-battery-status]] | [[تصنيف: cordova-plugin-battery-status]] | ||
توفر هذه الإضافة | توفر هذه الإضافة تقديمًا (implementation) لإصدارٍ قديمٍ من [http://www.w3.org/TR/2011/WD-battery-status-20110915/ الواجهة البرمجية لأحداث حالة البطارية]. تضيف هذه الإضافة الأحداث الثلاثة التالية إلى الكائن <code>window</code>: | ||
*batterystatus | *<code>batterystatus</code> | ||
*batterycritical | *<code>batterycritical</code> | ||
*batterylow | *<code>batterylow</code> | ||
يمكن للتطبيقات أن تستخدم <code>window.addEventListener</code> لإرفاق منصِتٍ (listener) لأيٍّ من الأحداث المذكورة أعلاه بعد اطلاق الحدث <code>deviceready</code>. | يمكن للتطبيقات أن تستخدم <code>window.addEventListener</code> لإرفاق منصِتٍ (listener) لأيٍّ من الأحداث المذكورة أعلاه بعد اطلاق الحدث <code>deviceready</code>. | ||
== التثبيت == | == التثبيت == | ||
<syntaxhighlight lang=" | <syntaxhighlight lang="console">cordova plugin add cordova-plugin-battery-status</syntaxhighlight> | ||
== | == الكائن Status == | ||
الكائنات التي تعيدها أحداث هذه الإضافة تملك الخصائص التالية: | الكائنات التي تعيدها أحداث هذه الإضافة تملك الخصائص التالية: | ||
* | * <code>level</code>: نسبة شحن البطارية (0-100). (عددٌ) | ||
* | * <code>isPlugged</code>: قيمة منطقية توضح ما إن كان الجهاز موصولاً. (قيمة منطقية) | ||
== الحدث batterystatus == | == الحدث <code>batterystatus</code> == | ||
يُطلق هذا الحدث عندما تتغير نسبة شحن البطارية بنسبة 1٪ على الأقل، أو عند توصيل الجهاز أو فصله. | يُطلق هذا الحدث عندما تتغير نسبة شحن البطارية بنسبة 1٪ على الأقل، أو عند توصيل الجهاز أو فصله. ويُعاد [https://cordova.apache.org/docs/en/latest/reference/cordova-plugin-battery-status/index.html#status-object كائن] يحتوي حالة بطارية. | ||
=== مثال === | === مثال === | ||
<syntaxhighlight lang="javascript">window.addEventListener("batterystatus", onBatteryStatus, false); | <syntaxhighlight lang="javascript">window.addEventListener("batterystatus", onBatteryStatus, false); | ||
مراجعة 10:55، 12 ديسمبر 2018
توفر هذه الإضافة تقديمًا (implementation) لإصدارٍ قديمٍ من الواجهة البرمجية لأحداث حالة البطارية. تضيف هذه الإضافة الأحداث الثلاثة التالية إلى الكائن window:
batterystatusbatterycriticalbatterylow
يمكن للتطبيقات أن تستخدم window.addEventListener لإرفاق منصِتٍ (listener) لأيٍّ من الأحداث المذكورة أعلاه بعد اطلاق الحدث deviceready.
التثبيت
cordova plugin add cordova-plugin-battery-status
الكائن Status
الكائنات التي تعيدها أحداث هذه الإضافة تملك الخصائص التالية:
level: نسبة شحن البطارية (0-100). (عددٌ)isPlugged: قيمة منطقية توضح ما إن كان الجهاز موصولاً. (قيمة منطقية)
الحدث batterystatus
يُطلق هذا الحدث عندما تتغير نسبة شحن البطارية بنسبة 1٪ على الأقل، أو عند توصيل الجهاز أو فصله. ويُعاد كائن يحتوي حالة بطارية.
مثال
window.addEventListener("batterystatus", onBatteryStatus, false);
function onBatteryStatus(status) {
console.log("Level: " + status.level + " isPlugged: " + status.isPlugged);
}
المنصات المدعومة
- iOS
- أندرويد
- الويندوز
- المتصفحات (كروم، فايرفوكس، أوبرا)
ملاحظات خاصة بأندرويد
Warning: طريقة تقديم (implementation) أندرويد لهذا الحدث طماعة (greedy)، والاستخدام المُطوّل سيستنزف بطارية الجهاز.
الحدث batterylow
يُطلق هذا الحدث عندما تصل نسبة شحن البطارية إلى الحد الأدنى. قيمة العتبة تختلف من جهاز لآخر. يعاد [#status-object object] يحتوي على حالة بطارية.
مثال
window.addEventListener("batterylow", onBatteryLow, false);
function onBatteryLow(status) {
alert("Battery Level Low " + status.level + "%");
}
المنصات المدعومة
- iOS
- أندرويد
- ويندوز
- المتصفحات (كروم، فايرفوكس، أوبرا)
الحدث batterycritical
يُطلق هذا الحدث عندما تصل نسبة شحن البطارية إلى حد الشحن الحرج. قيمة العتبة تحتلف من جهاز لآخر. يُعاد [#status-object object] يحتوي حالة البطارية.
مثال
window.addEventListener("batterycritical", onBatteryCritical, false);
function onBatteryCritical(status) {
alert("Battery Level Critical " + status.level + "%\nRecharge Soon!");
}
المنصات المدعومة
- iOS
- أندرويد
- الويندوز
- المتصفحات (كروم، فايرفوكس، أوبرا)