واجهة برمجة تطبيقات جافا سكريبت

يمكنك أيضًا استخدام عميل Magic Translate مباشرةً في البرامج النصية لترجمة السلاسل وتغيير اللغة.

الحصول على المثيل

باستخدام علامة البرنامج النصي، يتم إنشاء المثيل بمجرد تحميل الصفحة ويكون متاحًا كـ window.magicTranslate. لاستخدامه بمجرد أن يصبح جاهزًا، استمع إلى حدث magictranslate:ready:

document.addEventListener('magictranslate:ready', (event) => {
  const magicTranslate = event.detail;
});

باستخدام npm، يقوم createMagicTranslate بإرجاع المثيل.

الترجمة في الكود

لترجمة سلسلة، اتصل بـ translate. إنها تعيد الوعد.

const message = await magicTranslate.translate('Your order has been placed');

// with options
const formal = await magicTranslate.translate('How are you?', {
  lang: 'fr',
  formality: 'formal'
});

بدون خيار lang، تتم ترجمة النص إلى اللغة الحالية. باستخدام id، يمكنك تحرير هذا الاستخدام للنص بمفرده.

القيم التي لا يجب ترجمتها تدخل في v، المشار إليها باسم $name. تتم ترجمة النص مرة واحدة كقالب وتخزينه مؤقتًا، مهما كانت القيم:

const message = await magicTranslate.translate('Your order $id has shipped', {
  v: { id: order.id }
});

اللغة الحالية

اقرأ اللغة الحالية باستخدام magicTranslate.language. استخدم setLanguage لتغييرها وترجمة الصفحة مرة أخرى، أو onLanguageChange لتشغيل رد الاتصال كلما تغيرت اللغة:

magicTranslate.setLanguage('fr');

const unsubscribe = magicTranslate.onLanguageChange((language) => {
  document.documentElement.lang = language;
});

التوقف

destroy يتوقف عن ترجمة الصفحة. المحتوى الذي تمت ترجمته بالفعل يظل مترجمًا.

magicTranslate.destroy();