الفرق بين المراجعتين ل"Cordova/cordova plugin battery status"

من موسوعة حسوب
اذهب إلى التنقل اذهب إلى البحث
(أنشأ الصفحة ب'<noinclude>{{DISPLAYTITLE:إضافة حالة البطارية cordova-plugin-battery-status في كوردوفا}}</noinclude> تصنيف: Cordova تصنيف: p...')
 
ط
 
(4 مراجعات متوسطة بواسطة مستخدمين اثنين آخرين غير معروضة)
سطر 1: سطر 1:
−
<noinclude>{{DISPLAYTITLE:إضافة حالة البطارية cordova-plugin-battery-status في كوردوفا}}</noinclude>
+
<noinclude>{{DISPLAYTITLE:إضافة حالة البطارية في كوردوفا}}</noinclude>
−
[[تصنيف: Cordova]]
+
[[تصنيف: Cordova]]
−
[[تصنيف: plugin]]
+
[[تصنيف: Cordova Plugin]]
−
[[تصنيف: cordova-plugin-battery-status]]
+
توفر هذه الإضافة تنفيذًا (implementation) لإصدارٍ قديمٍ من [http://www.w3.org/TR/2011/WD-battery-status-20110915/ الواجهة البرمجية لأحداث حالة البطارية]. تضيف هذه الإضافة الأحداث الثلاثة التالية إلى الكائن <code>window</code>:
−
توفر هذه الإضافة تنزيلًا (implementation) لإصدار قديم من الواجهة البرمجية لأحداث حالة البطارية [http://www.w3.org/TR/2011/WD-battery-status-20110915/ Battery Status Events API]. تضيف هذه الإضافة الأحداث الثلاثة التالية إلى الكائن <code>window</code>:  
+
*<code>batterystatus</code>
−
*batterystatus  
+
*<code>batterycritical</code>
−
*batterycritical  
+
*<code>batterylow</code>
−
*batterylow  
 
  
−
يمكن للتطبيقات أن تستخدم <code>window.addEventListener</code> لإرفاق منصِتٍ (listener) لأيٍّ من الأحداث المذكورة أعلاه بعد اطلاق الحدث <code>deviceready</code>.  
+
يمكن للتطبيقات أن تستخدم <code>window.addEventListener</code> لإرفاق منصِتٍ (listener) لأيٍّ من الأحداث المذكورة أعلاه بعد اطلاق الحدث <code>[[Cordova/events#deviceready|deviceready]]</code>.  
  
 
== التثبيت ==  
 
== التثبيت ==  
−
<syntaxhighlight lang="javascript">cordova plugin add cordova-plugin-battery-status‎</syntaxhighlight>  
+
<syntaxhighlight lang="shell">cordova plugin add cordova-plugin-battery-status‎</syntaxhighlight>  
  
−
== كائن الحالة (Status object) ==  
+
== الكائن <code>Status</code> ==  
  
−
الكائنات التي تعيدها أحداث هذه الإضافة تملك الخصائص التالية:  
+
الكائن الذي تعيده جميع أحداث هذه الإضافة يملك الخصائص التالية:  
−
* '''level''': نسبة شحن البطارية (0-100). (عدد)
+
* <code>level</code>: عدد بين 0 و 100 يمثِّل نسبة شحن البطارية.  
−
* '''isPlugged''': قيمة منطقية توضح ما إذا كان الجهاز موصولاً. (قيمة منطقية)
+
* <code>isPlugged</code>: قيمة منطقية توضح ما إن كان الجهاز موصولاً بالشاحن أم لا.
  
−
== الحدث batterystatus ==  
+
== الحدث <code>batterystatus</code> ==  
  
−
يُطلق هذا الحدث عندما تتغير نسبة شحن البطارية بنسبة 1٪ على الأقل، أو عند توصيل الجهاز أو فصله. ثم يعيد [#status-object object] يحتوي حالة بطارية.  
+
يُطلق هذا الحدث عندما تتغير نسبة شحن البطارية بنسبة1٪ على الأقل، أو عند توصيل الجهاز أو فصله. ويُعاد [[Cordova/cordova plugin battery status#.D8.A7.D9.84.D9.83.D8.A7.D8.A6.D9.86 Status|كائن]] يحتوي حالة بطارية. إليك المثال التالي: <syntaxhighlight lang="javascript">window.addEventListener("batterystatus", onBatteryStatus, false);
−
=== مثال ===
 
−
<syntaxhighlight lang="javascript">window.addEventListener("batterystatus", onBatteryStatus, false);
 
 
function onBatteryStatus(status) {
 
function onBatteryStatus(status) {
 
     console.log("Level: " + status.level + " isPlugged: " + status.isPlugged);
 
     console.log("Level: " + status.level + " isPlugged: " + status.isPlugged);
 
}‎</syntaxhighlight>  
 
}‎</syntaxhighlight>  
−
== المنصات المدعومة ==  
+
=== المنصات المدعومة ===  
 
*iOS  
 
*iOS  
 
*أندرويد  
 
*أندرويد  
−
*الويندوز
+
*ويندوز
 
* المتصفحات (كروم، فايرفوكس، أوبرا)  
 
* المتصفحات (كروم، فايرفوكس، أوبرا)  
 
=== ملاحظات خاصة بأندرويد ===  
 
=== ملاحظات خاصة بأندرويد ===  
  
−
'''Warning''': طريقة تقديم (implementation) أندرويد لهذا الحدث طماعة (greedy)، والاستخدام المُطوّل سيستنزف بطارية الجهاز.  
+
طريقة تقديم (implementation) أندرويد لهذا الحدث طماعة (greedy)، والاستخدام المُطوّل له سيستنزف بطارية الجهاز.  
  
−
== الحدث batterylow ==  
+
== الحدث <code>batterylow</code> ==  
  
−
يُطلق هذا الحدث عندما تصل نسبة شحن البطارية إلى الحد الأدنى. قيمة العتبة تختلف من جهاز لآخر. يعاد [#status-object object] يحتوي على حالة بطارية.  
+
يُطلق هذا الحدث عندما تصل نسبة شحن البطارية إلى العتبة الدنيا. قيمة العتبة تختلف من جهاز لآخر. ويعاد [[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);
 
 
function onBatteryLow(status) {
 
function onBatteryLow(status) {
 
     alert("Battery Level Low " + status.level + "%");
 
     alert("Battery Level Low " + status.level + "%");
سطر 50: سطر 45:
 
* المتصفحات (كروم، فايرفوكس، أوبرا)  
 
* المتصفحات (كروم، فايرفوكس، أوبرا)  
  
−
== الحدث batterycritical ==  
+
== الحدث <code>batterycritical</code> ==  
  
−
يُطلق هذا الحدث عندما تصل نسبة شحن البطارية إلى حد الشحن الحرج. قيمة العتبة تحتلف من جهاز لآخر. يُعاد [#status-object object] يحتوي حالة البطارية.  
+
يُطلق هذا الحدث عندما تصل نسبة شحن البطارية إلى العتبة الحرجة. قيمة العتبة تختلف من جهاز لآخر. ويُعاد [[Cordova/cordova plugin battery status#.D8.A7.D9.84.D9.83.D8.A7.D8.A6.D9.86 Status|كائن]] يحتوي حالة البطارية. إليك المثال التالي عن الحدث <code>batterycritical</code>: <syntaxhighlight lang="javascript">window.addEventListener("batterycritical", onBatteryCritical, false);
−
=== مثال ===
 
−
<syntaxhighlight lang="javascript">window.addEventListener("batterycritical", onBatteryCritical, false);
 
 
function onBatteryCritical(status) {
 
function onBatteryCritical(status) {
 
     alert("Battery Level Critical " + status.level + "%\nRecharge Soon!");
 
     alert("Battery Level Critical " + status.level + "%\nRecharge Soon!");
 
}‎</syntaxhighlight>  
 
}‎</syntaxhighlight>  
−
== المنصات المدعومة ==  
+
=== المنصات المدعومة ===  
 
*iOS  
 
*iOS  
 
*أندرويد  
 
*أندرويد  
 
*الويندوز  
 
*الويندوز  
 
* المتصفحات (كروم، فايرفوكس، أوبرا)
 
* المتصفحات (كروم، فايرفوكس، أوبرا)
 +
 +
== انظر أيضًا ==
 +
* [[Cordova/cordova plugin device|إضافة حالة الجهاز]]
 +
* [[Cordova/cordova plugin geolocation|إضافة تحديد الموقع الجغرافي]]
 +
* [[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 في توثيق كوردوفا الرسمي.]

المراجعة الحالية بتاريخ 07:50، 25 ديسمبر 2018

توفر هذه الإضافة تنفيذًا (implementation) لإصدارٍ قديمٍ من الواجهة البرمجية لأحداث حالة البطارية. تضيف هذه الإضافة الأحداث الثلاثة التالية إلى الكائن window:

  • batterystatus
  • batterycritical
  • batterylow

يمكن للتطبيقات أن تستخدم 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

يُطلق هذا الحدث عندما تصل نسبة شحن البطارية إلى العتبة الحرجة. قيمة العتبة تختلف من جهاز لآخر. ويُعاد كائن يحتوي حالة البطارية. إليك المثال التالي عن الحدث batterycritical: 

window.addEventListener("batterycritical", onBatteryCritical, false);
function onBatteryCritical(status) {
    alert("Battery Level Critical " + status.level + "%\nRecharge Soon!");
}‎

المنصات المدعومة

  • iOS
  • أندرويد
  • الويندوز
  • المتصفحات (كروم، فايرفوكس، أوبرا)

انظر أيضًا

مصادر

مجلوبة من "https://wiki.hsoub.com/index.php?title=Cordova/cordova_plugin_battery_status&oldid=26716"