الفرق بين المراجعتين ل"Cordova/cordova plugin battery status"
< Cordova
اذهب إلى التنقل
اذهب إلى البحث
| سطر 15: | سطر 15: | ||
== الكائن Status == | == الكائن Status == | ||
| − | + | الكائن الذي تعيده أحداث هذه الإضافة يملك الخصائص التالية: | |
* <code>level</code>: نسبة شحن البطارية (0-100). (عددٌ) | * <code>level</code>: نسبة شحن البطارية (0-100). (عددٌ) | ||
| − | * <code>isPlugged</code>: قيمة منطقية توضح ما إن كان الجهاز موصولاً. (قيمة منطقية) | + | * <code>isPlugged</code>: قيمة منطقية توضح ما إن كان الجهاز موصولاً أم لا. (قيمة منطقية) |
== الحدث <code>batterystatus</code> == | == الحدث <code>batterystatus</code> == | ||
| سطر 30: | سطر 30: | ||
*iOS | *iOS | ||
*أندرويد | *أندرويد | ||
| − | * | + | *ويندوز |
* المتصفحات (كروم، فايرفوكس، أوبرا) | * المتصفحات (كروم، فايرفوكس، أوبرا) | ||
=== ملاحظات خاصة بأندرويد === | === ملاحظات خاصة بأندرويد === | ||
| − | + | طريقة تقديم (implementation) أندرويد لهذا الحدث طماعة (greedy)، والاستخدام المُطوّل له سيستنزف بطارية الجهاز. | |
| − | == الحدث batterylow == | + | == الحدث <code>batterylow</code> == |
| − | يُطلق هذا الحدث عندما تصل نسبة شحن البطارية إلى | + | يُطلق هذا الحدث عندما تصل نسبة شحن البطارية إلى العتبة الدنيا. قيمة العتبة تختلف من جهاز لآخر. ويعاد [[Cordova/cordova plugin battery status#.D8.A7.D9.84.D9.83.D8.A7.D8.A6.D9.86 Status|كائن]] يحتوي على حالة بطارية. |
=== مثال === | === مثال === | ||
<syntaxhighlight lang="javascript">window.addEventListener("batterylow", onBatteryLow, false); | <syntaxhighlight lang="javascript">window.addEventListener("batterylow", onBatteryLow, false); | ||
| سطر 50: | سطر 50: | ||
* المتصفحات (كروم، فايرفوكس، أوبرا) | * المتصفحات (كروم، فايرفوكس، أوبرا) | ||
| − | == الحدث batterycritical == | + | == الحدث <code>batterycritical</code> == |
| − | يُطلق هذا الحدث عندما تصل نسبة شحن البطارية إلى | + | يُطلق هذا الحدث عندما تصل نسبة شحن البطارية إلى العتبة الحرجة. قيمة العتبة تختلف من جهاز لآخر. ويُعاد [[Cordova/cordova plugin battery status#.D8.A7.D9.84.D9.83.D8.A7.D8.A6.D9.86 Status|كائن]] يحتوي حالة البطارية. |
=== مثال === | === مثال === | ||
<syntaxhighlight lang="javascript">window.addEventListener("batterycritical", onBatteryCritical, false); | <syntaxhighlight lang="javascript">window.addEventListener("batterycritical", onBatteryCritical, false); | ||
| سطر 63: | سطر 63: | ||
*الويندوز | *الويندوز | ||
* المتصفحات (كروم، فايرفوكس، أوبرا) | * المتصفحات (كروم، فايرفوكس، أوبرا) | ||
| + | |||
| + | == أنظر أيضا == | ||
| + | * صفحة الإضافة [[Cordova/cordova plugin device|cordova_plugin_device]] | ||
| + | * [[Cordova/plugins|دليل تطوير الإضافات في كوردوفا]] | ||
| + | |||
==مصادر== | ==مصادر== | ||
*[https://cordova.apache.org/docs/en/latest/reference/cordova-plugin-battery-status/index.html صفحة cordova-plugin-battery-status في توثيق كوردوفا الرسمي.] | *[https://cordova.apache.org/docs/en/latest/reference/cordova-plugin-battery-status/index.html صفحة cordova-plugin-battery-status في توثيق كوردوفا الرسمي.] | ||
مراجعة 11:02، 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
- أندرويد
- ويندوز
- المتصفحات (كروم، فايرفوكس، أوبرا)
ملاحظات خاصة بأندرويد
طريقة تقديم (implementation) أندرويد لهذا الحدث طماعة (greedy)، والاستخدام المُطوّل له سيستنزف بطارية الجهاز.
الحدث batterylow
يُطلق هذا الحدث عندما تصل نسبة شحن البطارية إلى العتبة الدنيا. قيمة العتبة تختلف من جهاز لآخر. ويعاد كائن يحتوي على حالة بطارية.
مثال
window.addEventListener("batterylow", onBatteryLow, false);
function onBatteryLow(status) {
alert("Battery Level Low " + status.level + "%");
}
المنصات المدعومة
- iOS
- أندرويد
- ويندوز
- المتصفحات (كروم، فايرفوكس، أوبرا)
الحدث batterycritical
يُطلق هذا الحدث عندما تصل نسبة شحن البطارية إلى العتبة الحرجة. قيمة العتبة تختلف من جهاز لآخر. ويُعاد كائن يحتوي حالة البطارية.
مثال
window.addEventListener("batterycritical", onBatteryCritical, false);
function onBatteryCritical(status) {
alert("Battery Level Critical " + status.level + "%\nRecharge Soon!");
}
المنصات المدعومة
- iOS
- أندرويد
- الويندوز
- المتصفحات (كروم، فايرفوكس، أوبرا)
أنظر أيضا
- صفحة الإضافة cordova_plugin_device
- دليل تطوير الإضافات في كوردوفا