Cordova - Globalization كوردوفا الإعدادات العالمية التحويلات

 Cordova - Globalization كوردوفا الإعدادات العالمية

يتم استخدام هذا المكون الإضافي للحصول على معلومات حول لغة المستخدمين والتاريخ والمنطقة الزمنية والعملة وما إلى ذلك.

الخطوة 1 - تثبيت البرنامج المساعد للعولمة

افتح موجه الأوامر وقم بتثبيت البرنامج المساعد عن طريق كتابة الكود التالي

C:\Users\username\Desktop\CordovaProject>cordova plugin add cordova-plugin-globalization

الخطوة 2 - إضافة الأزرار

سنضيف عدة أزرار إلى index.html حتى نتمكن من استدعاء طرق مختلفة سننشئها لاحقًا.

<button id = "getLanguage">LANGUAGE</button>
<button id = "getLocaleName">LOCALE NAME</button>
<button id = "getDate">DATE</button>
<button id = "getCurrency">CURRENCY</button>

الخطوة 3 - إضافة مستمعين الحدث

ستتم إضافة مستمعي الأحداث داخل وظيفة getDeviceReady في ملف index.js لضمان تحميل تطبيقنا وكوردوفا قبل البدء في استخدامه.

document.getElementById("getLanguage").addEventListener("click", getLanguage);
document.getElementById("getLocaleName").addEventListener("click", getLocaleName);
document.getElementById("getDate").addEventListener("click", getDate);
document.getElementById("getCurrency").addEventListener("click", getCurrency);

الخطوة 4 أ - وظيفة اللغة

تقوم الوظيفة الأولى التي نستخدمها بإرجاع علامة لغة BCP 47 لجهاز العميل. سوف نستخدم طريقة getPreferredLanguage . تحتوي الوظيفة على معلمتين onSuccess و onError . نقوم بإضافة هذه الوظيفة في index.js .

function getLanguage() {
   navigator.globalization.getPreferredLanguage(onSuccess, onError);

   function onSuccess(language) {
      alert('language: ' + language.value + '\n');
   }

   function onError(){
      alert('Error getting language');
   }
}

بمجرد الضغط على زر LANGUAGE ، سيظهر التنبيه على الشاشة.

الخطوة 4 ب - الوظيفة المحلية

تقوم هذه الوظيفة بإرجاع علامة BCP 47 للإعدادات المحلية للعميل. هذه الوظيفة مشابهة للوظيفة التي أنشأناها من قبل. الاختلاف الوحيد هو أننا نستخدم طريقة getLocaleName هذه المرة.

function getLocaleName() {
   navigator.globalization.getLocaleName(onSuccess, onError);

   function onSuccess(locale) {
      alert('locale: ' + locale.value);
   }

   function onError(){
      alert('Error getting locale');
   }
}

عندما نضغط على زر LOCALE ، سيعرض التنبيه علامة اللغة الخاصة بنا.

الخطوة 4 ج - وظيفة التاريخ

تُستخدم هذه الوظيفة لإرجاع التاريخ وفقًا لإعدادات اللغة والمنطقة الزمنية للعميل. معلمة التاريخ هي التاريخ الحالي ومعلمة الخيارات اختيارية.

function getDate() {
   var date = new Date();

   var options = {
      formatLength:'short',
      selector:'date and time'
   }
   navigator.globalization.dateToString(date, onSuccess, onError, options);

   function onSuccess(date) {
      alert('date: ' + date.value);
   }

   function onError(){
      alert('Error getting dateString');
   }
}

يمكننا الآن تشغيل التطبيق والضغط على زر التاريخ لرؤية التاريخ الحالي.

الوظيفة الأخيرة التي سنعرضها هي إرجاع قيم العملات وفقًا لإعدادات جهاز العميل ورمز العملة ISO 4217. يمكنك أن ترى أن المفهوم هو نفسه.

function getCurrency() {
   var currencyCode = 'EUR';
   navigator.globalization.getCurrencyPattern(currencyCode, onSuccess, onError);

   function onSuccess(pattern) {
      alert('pattern: '  + pattern.pattern  + '\n' +
         'code: '     + pattern.code     + '\n' +
         'fraction: ' + pattern.fraction + '\n' +
         'rounding: ' + pattern.rounding + '\n' +
         'decimal: '  + pattern.decimal  + '\n' +
         'grouping: ' + pattern.grouping);
   }

   function onError(){
      alert('Error getting pattern');
   }
}

 سوف يؤدي زر التنبيه التي سوف تظهر للمستخدمين نمط العملة.

يقدم هذا البرنامج المساعد طرقًا أخرى. يمكنك أن ترى كل ذلك في الجدول أدناه.

طريقة	المعلمات	تفاصيل
getPreferredLanguage	onSuccess ، onError	إرجاع لغة العميل الحالية.
getLocaleName	onSuccess ، onError	إرجاع إعدادات اللغة الحالية للعميل.
dateToString	date, onSuccess, onError, options	تاريخ الإرجاع وفقًا للغة العميل والمنطقة الزمنية.
stringToDate	dateString ، onSuccess ، onError ، الخيارات	يوزع تاريخًا وفقًا لإعدادات العميل.
getCurrencyPattern	CurrencyCode ، onSuccess ، onError	إرجاع نمط عملة العميل.
getDatePattern	onSuccess ، onError ، options	إرجاع نمط تاريخ العميل.
getDateNames	onSuccess ، onError ، options	إرجاع مجموعة من أسماء الأشهر أو الأسابيع أو الأيام وفقًا لإعدادات العميل.
isDayLightSavingsTimedate, successCallback, errorCallback	date, successCallback, errorCallback	يُستخدم لتحديد ما إذا كان التوقيت الصيفي نشطًا وفقًا للمنطقة الزمنية للعميل والتقويم.
getFirstDayOfWeek	onSuccess ، onError	إرجاع اليوم الأول من الأسبوع وفقًا لإعدادات العميل.
numberToString	number, onSuccess, onError, options	يُرجع الرقم وفقًا لإعدادات العميل.
stringToNumber	سلسلة onSuccess onError الخيارات	يوزع رقمًا وفقًا لإعدادات العميل.
getNumberPattern	onSuccess ، onError ، options	يُرجع نمط الأرقام وفقًا لإعدادات العميل.