Dokumentasi

Komponen <T>

Bungkus konten Anda di komponen <T> untuk menerjemahkannya.

<T>This content will be translated</T>

Props

PropMengetikDeskripsi
formality'informal' | 'formal'Menetapkan formalitas terjemahan.
idstringMemungkinkan Anda mengedit penggunaan teks ini sendiri.
langLanguageMengganti bahasa yang ditetapkan pada MagicTranslateProvider.

Variabel

Bungkus nilai yang berubah, seperti nama atau hitungan, di v():

import { T, v } from '@magic-translate/react';
<T>
Hello {v(user.name)}, you have {v(count)} unread messages
</T>

Magic Translate menerjemahkan teks di sekitar nilai satu kali, sebagai Hello {0}, you have {1} unread messages, dan mengembalikan nilai ke aplikasi Anda. Terjemahan di-cache dan berfungsi untuk setiap nama dan setiap hitungan, dan nilai-nilai itu sendiri tidak pernah dikirim ke Magic Translate.

Nilai-nilai diberi nomor sesuai urutan kemunculannya. Terjemahan dapat memindahkannya ke mana pun bahasa membutuhkannya, misalnya {1} ungelesene Nachrichten fĂźr {0}.

v() juga dapat menyimpan komponen React, seperti tautan:

<T>
Read our {v(<Link href="/terms">terms</Link>)} before you continue.
</T>

Teks tautan tidak diterjemahkan saat itu. Untuk menerjemahkannya juga, masukkan ke dalam <T> sendiri: v(<Link href="/terms"><T>terms</T></Link>).

Tanpa v(), nilai diterjemahkan bersama dengan teks di sekitarnya. Itu berhasil, tetapi setiap nilai yang berbeda adalah terjemahan terpisah yang diperhitungkan dalam penggunaan Anda.

Keterbatasan

  1. Anda tidak dapat menempatkan komponen React di dalam komponen <T>, kecuali di dalam v(). Elemen HTML biasa baik-baik saja (lihat contoh di bawah).
  2. Konten di dalam komponen <T> tidak boleh melebihi 10 KB, yaitu sekitar 5.000 karakter.
{/* this is OK, since <a> is a plain HTML element */}
<T>
<a href="mailto:info@i42.ch">Please send us an email</a>
</T>
{/* this does NOT work, since <MyButton> is a React component */}
<T>
<MyButton>Click me</MyButton>
</T>