التوثيق

Angular

كيفية استخدام Magic Translate في تطبيقات Angular. يتطلب العميل Angular Angular 20 أو أحدث ويعمل مع zone.js وبدونه.

التثبيت

قم بتثبيت عميل Angular لـ Magic Translate في تطبيقك.

# using npm
npm i @magic-translate/angular
# using yarn
yarn add @magic-translate/angular

ثم أضف provideMagicTranslate إلى تكوين التطبيق الخاص بك.

// app.config.ts
import { ApplicationConfig } from '@angular/core';
import { provideMagicTranslate, Language } from '@magic-translate/angular';
export const appConfig: ApplicationConfig = {
providers: [
provideMagicTranslate({
apiKey: '<your-api-key>',
language: Language.DE // any supported language
})
]
};

إذا لم يكن لديك مفتاح API حتى الآن، فقم بالتسجيل في Magic Translate للحصول على واحد.

يمكنك الآن استخدام المكون <t> في أي مكون يستورده.

import { Component } from '@angular/core';
import { T } from '@magic-translate/angular';
@Component({
selector: 'app-welcome',
imports: [T],
template: `<h1><t>Please translate me!</t></h1>`
})
export class Welcome {}

هذا كل شيء. يمكن الآن ترجمة تطبيقك إلى أكثر من 70 لغة.

التكوين

provideMagicTranslate يقبل هذه الخيارات:

خياروصف
apiKeyمطلوب. مفتاح واجهة برمجة التطبيقات Magic Translate الخاص بك.
languageمطلوب. اللغة التي تتم ترجمة المحتوى الخاص بك إليها، على سبيل المثال 'de'.
sourceLanguageاللغة التي تمت كتابة القوالب بها. يتم اكتشافه تلقائيًا، لذا قم بتعيينه فقط إذا أعطى الاكتشاف نتائج خاطئة.
formality'formal' أو 'informal'. غير مدعوم لجميع اللغات. يمكنك تجاوزها لكل ترجمة.
debugيقوم بتسجيل الطلبات إلى وحدة التحكم.

تغيير اللغات

أدخل خدمة MagicTranslate لقراءة اللغة الحالية أو تغييرها. يتم تحديث كل مكون <t> و t pipe تلقائيًا.

import { Component, inject } from '@angular/core';
import { MagicTranslate } from '@magic-translate/angular';
@Component({
selector: 'app-language-switcher',
template: `
<div>Current language is: {{ magicTranslate.language() }}</div>
<button (click)="magicTranslate.setLanguage('de')">German</button>
`
})
export class LanguageSwitcher {
protected readonly magicTranslate = inject(MagicTranslate);
}

language هي إشارة، لذا يمكنك استخدامها أيضًا في computed و effect.

العرض من جانب الخادم

يترجم المكون <t> و t pipe في المتصفح. من خلال العرض من جانب الخادم، يعرض الخادم المحتوى الأصلي، وتتم ترجمته بعد الترطيب. لإرسال HTML مترجم بالكامل بدلاً من ذلك، قم بترجمة الصفحة أثناء عرضها، كما هو موضح في العرض المسبق.

مشروع مثال

يمكنك العثور على مثال لمشروع على GitHub ومشاهدته مباشرة.