TacoTranslate
/
DocumentacióPreus
 
Article
04 de maig del 2025

La millor solució per a la internacionalització (i18n) en aplicacions React

Vols expandir la teva aplicació React a nous mercats? TacoTranslate fa que sigui molt fàcil localitzar les teves aplicacions React, permetent-te arribar a una audiència global sense complicacions.

Per què triar TacoTranslate per a React?

  • Integració perfecta: Dissenyat específicament per a aplicacions React, TacoTranslate s'integra de manera fluida al teu flux de treball existent.
  • Recollida automàtica de cadenes: No cal gestionar manualment fitxers JSON. TacoTranslate recull automàticament les cadenes del teu codi.
  • Traduccions impulsades per IA: Aprofita la potència de la IA per oferir traduccions contextualment precises que s'ajusten al to de la teva aplicació.
  • Suport d'idiomes instantani: Afegeix suport per a nous idiomes amb un sol clic, fent la teva aplicació accessible a tot el món.

Com funciona

Instal·la el paquet TacoTranslate mitjançant npm:

npm install tacotranslate

Un cop tinguis el mòdul instal·lat, necessitaràs crear un compte de TacoTranslate, un projecte de traducció i les claus API associades. Crea un compte aquí. És gratuït i no requereix que afegeixis una targeta de crèdit.

A la interfície d'usuari de l'aplicació TacoTranslate, crea un projecte i ves a la pestanya de claus d'API. Crea una clau read i una clau read/write. Les guardarem com a variables d'entorn. La clau read és la que anomenem public i la clau read/write és la que anomenem secret. Per exemple, les pots afegir a un fitxer .env a l'arrel del teu projecte.

També hauràs d'afegir dues variables d'entorn més: TACOTRANSLATE_DEFAULT_LOCALE i TACOTRANSLATE_ORIGIN.

  • TACOTRANSLATE_DEFAULT_LOCALE: El codi de localització de reserva per defecte. En aquest exemple, l'establirem a en per a l'anglès.
  • TACOTRANSLATE_ORIGIN: La «carpeta» on s'emmagatzemaran les teves cadenes, com ara l'URL del teu lloc web. Llegeix més sobre els orígens aquí.
.env
TACOTRANSLATE_PUBLIC_API_KEY=123456
TACOTRANSLATE_SECRET_API_KEY=789010
TACOTRANSLATE_DEFAULT_LOCALE=en
TACOTRANSLATE_ORIGIN=your-website-url.com

Assegura't de no filtrar mai la clau secreta d'API read/write als entorns de producció del costat del client.

Configuració de TacoTranslate

Inicialitza TacoTranslate a la teva aplicació React envoltant la teva aplicació amb el proveïdor de context de TacoTranslate:

import React, {useState} from 'react';
import TacoTranslate, {Translate} from 'tacotranslate/react';

const tacoTranslate = createTacoTranslateClient({
	apiKey: 'YOUR_API_KEY',
});

export default function App() {
	const [locale, setLocale] = useState('en');

	return (
		<TacoTranslate client={tacoTranslate} locale={locale}>
			<Translate string="Hello, world!"/>
		</TacoTranslate>
	);
}

Ara pots utilitzar el component Translate en qualsevol lloc de la teva aplicació per mostrar text traduït! Assegura't de consultar la nostra documentació per a més informació i per a guies d'implementació específiques per a la teva configuració.

import {Translate} from 'tacotranslate/react';

export default async function Component() {
	return (
		<Translate string="Hello? This is TacoTranslate speaking." />
	);
}

Beneficis d'utilitzar TacoTranslate

  • Estalvi de temps: Automatitza el tediós procés de localització i la recopilació de cadenes, estalviant-te un temps valuós.
  • Rendible: Redueix la necessitat de traduccions manuals, reduint els costos de localització.
  • Major precisió: Les traduccions impulsades per IA garanteixen resultats coherents amb el context i d'alta qualitat.
  • Solució escalable: Afegeix fàcilment suport per a nous idiomes a mesura que la teva aplicació i la teva base de clients creixen.

Comença avui!

La teva aplicació React es traduirà automàticament quan afegeixis qualsevol cadena a un component Translate. Tingues en compte que només els entorns amb permisos read/write a la clau de l'API podran crear noves cadenes per traduir.

Recomanem tenir un entorn de staging tancat i segur on puguis provar la teva aplicació de producció, afegint noves cadenes abans d'anar a producció. Això impedirà que qualsevol persona qualsevol persona robi la teva clau secreta de l'API i, potencialment, inflarà el teu projecte de traducció afegint cadenes no autoritzades.

Be sure to check out the complete examples over at our GitHub profile. If you encounter any problems, feel free to reach out, and we’ll be more than happy to help.

TacoTranslate lets you automatically localize your React applications quickly to and from over 75 languages. Translate for free!

Un producte de NattskiftetFet a Noruega