De beste oplossing voor internationalisatie (i18n) in React-apps

Hoe het werkt

Installeer het TacoTranslate-pakket via npm:

npm install tacotranslate

Wanneer je de module hebt geïnstalleerd, moet je een TacoTranslate-account, een vertaalproject en bijbehorende API-sleutels aanmaken. Maak hier een account aan. Het is gratis en je hoeft geen creditcard toe te voegen.

Maak binnen de TacoTranslate-applicatie-UI een project aan en ga naar het tabblad API-sleutels. Maak één read sleutel en één read/write sleutel aan. We slaan ze op als omgevingsvariabelen. De read sleutel noemen we public en de read/write sleutel is secret. Je kunt ze bijvoorbeeld toevoegen aan een .env bestand in de root van je project.

Je moet ook nog twee extra omgevingsvariabelen toevoegen: TACOTRANSLATE_DEFAULT_LOCALE en TACOTRANSLATE_ORIGIN.

• TACOTRANSLATE_DEFAULT_LOCALE: De standaard fallback-localecode. In dit voorbeeld zetten we deze op en voor Engels.
• TACOTRANSLATE_ORIGIN: De “map” waarin je strings worden opgeslagen, zoals de URL van je website. Lees hier meer over origins.

TACOTRANSLATE_PUBLIC_API_KEY=123456
TACOTRANSLATE_SECRET_API_KEY=789010
TACOTRANSLATE_DEFAULT_LOCALE=en
TACOTRANSLATE_ORIGIN=your-website-url.com

Zorg ervoor dat je de geheime read/write API-sleutel nooit blootstelt aan client-side productieomgevingen.

TacoTranslate instellen

Initialiseer TacoTranslate in uw React-applicatie door uw applicatie te omhullen met de TacoTranslate-contextprovider:

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>
	);
}

Je kunt nu de Translate component overal in je applicatie gebruiken om vertaalde tekst weer te geven! Bekijk zeker onze documentatie voor meer informatie en implementatiegidsen die specifiek zijn voor jouw setup.

import {Translate} from 'tacotranslate/react';

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

Voordelen van het gebruik van TacoTranslate

• Tijdbesparend: Automatiseert het saaie proces van lokalisatie en het verzamelen van tekststrings, waardoor u waardevolle tijd bespaart.
• Kosteneffectief: Vermindert de behoefte aan handmatige vertalingen en verlaagt uw lokalisatiekosten.
• Verbeterde nauwkeurigheid: Door AI aangedreven vertalingen zorgen voor contextueel nauwkeurige en hoogwaardige resultaten.
• Schaalbare oplossing: Voeg gemakkelijk ondersteuning voor nieuwe talen toe naarmate uw applicatie en klantenbestand groeien.

Begin vandaag nog!

Je React-applicatie wordt automatisch vertaald wanneer je strings toevoegt aan een Translate component. Houd er rekening mee dat alleen omgevingen met read/write machtigingen op de API-sleutel nieuwe strings kunnen aanmaken om te worden vertaald.

We raden aan een afgesloten en beveiligde stagingomgeving te hebben waarin je je productieapplicatie kunt testen en nieuwe strings kunt toevoegen voordat je live gaat. Dit voorkomt dat iemand je geheime API-sleutel steelt en mogelijk je vertaalproject opblaast door ongewenste strings toe te voegen.

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!