Den bästa lösningen för internationalisering (i18n) i Next.js-appar

Hur det fungerar

När världen blir alltmer globaliserad blir det allt viktigare för webbutvecklare att skapa applikationer som kan tillgodose användare från olika länder och kulturer. Ett av de viktigaste sätten att uppnå detta är internationalisering (i18n), vilket gör att du kan anpassa din applikation till olika språk, valutor och datumformat.

I denna handledning kommer vi att utforska hur man lägger till internationalisering i din React Next.js-applikation, med server-side-rendering. TL;DR: Se hela exemplet här.

Denna guide är för Next.js-applikationer som använder Pages Router.
Om du använder App Router, se istället denna guide.

Steg 1: Installera ett i18n-bibliotek

För att implementera internationalisering i din Next.js-applikation börjar vi med att välja ett i18n-bibliotek. Det finns flera populära bibliotek, inklusive next-intl. Men i det här exemplet kommer vi att använda TacoTranslate.

TacoTranslate översätter automatiskt dina strängar till vilket språk som helst med hjälp av banbrytande AI och befriar dig från det tidsödande arbetet med att hantera JSON-filer.

Låt oss installera det med npm i din terminal:

npm install tacotranslate

Steg 2: Skapa ett gratis TacoTranslate-konto

Nu när du har installerat modulen är det dags att skapa ditt TacoTranslate-konto, ett översättningsprojekt och tillhörande API-nycklar. Skapa ett konto här. Det är gratis och kräver inte att du anger ett kreditkort.

Skapa ett projekt i TacoTranslate-applikationens användargränssnitt och navigera till fliken API-nycklar. Skapa en read nyckel och en read/write nyckel. Vi sparar dem som miljövariabler. Den read nyckeln är det vi kallar public och read/write nyckeln är secret. Till exempel kan du lägga till dem i en .env fil i projektets rotmapp.

TACOTRANSLATE_PUBLIC_API_KEY=123456
TACOTRANSLATE_SECRET_API_KEY=789010

Se till att aldrig läcka den hemliga read/write API-nyckeln till klientsidans produktionsmiljöer.

Vi kommer också att lägga till två ytterligare miljövariabler: TACOTRANSLATE_DEFAULT_LOCALE och TACOTRANSLATE_ORIGIN.

• TACOTRANSLATE_DEFAULT_LOCALE: Standard fallback-lokalkod. I det här exemplet sätter vi den till en för engelska.
• TACOTRANSLATE_ORIGIN: “mappen” där dina strängar kommer att lagras, till exempel webbplatsens URL. Läs mer om ursprung här.

TACOTRANSLATE_DEFAULT_LOCALE=en
TACOTRANSLATE_ORIGIN=your-website-url.com

Steg 3: Ställa in TacoTranslate

För att integrera TacoTranslate i din applikation måste du skapa en klient som använder API-nycklarna från tidigare. Skapa till exempel en fil med namnet /tacotranslate-client.js.

const {default: createTacoTranslateClient} = require('tacotranslate');

const tacoTranslate = createTacoTranslateClient({
	apiKey:
		process.env.TACOTRANSLATE_SECRET_API_KEY ??
		process.env.TACOTRANSLATE_PUBLIC_API_KEY ??
		process.env.TACOTRANSLATE_API_KEY ??
		'',
	projectLocale: process.env.TACOTRANSLATE_DEFAULT_LOCALE ?? '',
});

module.exports = tacoTranslate;

Vi kommer automatiskt att definiera TACOTRANSLATE_API_KEY inom kort.

Att skapa klienten i en separat fil gör det enklare att återanvända senare. Nu, med en anpassad /pages/_app.tsx, lägger vi till TacoTranslate‑provider.

import React from 'react';
import {type AppProps} from 'next/app';
import {type Origin, type Locale, type Localizations} from 'tacotranslate';
import TacoTranslate from 'tacotranslate/react';
import TacoTranslateHead from 'tacotranslate/next/head';
import tacoTranslate from '../tacotranslate-client';

type PageProperties = {
	origin: Origin;
	locale: Locale;
	locales: Locale[];
	localizations: Localizations;
};

export default function App({Component, pageProps}: AppProps<PageProperties>) {
	const {origin, locale, locales, localizations} = pageProps;

	return (
		<TacoTranslate
			client={tacoTranslate}
			origin={origin}
			locale={locale}
			localizations={localizations}
		>
			<TacoTranslateHead rootUrl="https://your-website.com" locales={locales} />
			<Component {...pageProps} />
		</TacoTranslate>
	);
}

Om du redan har anpassade pageProps och _app.tsx, vänligen utöka definitionen med egenskaperna och koden ovan.

Steg 4: Implementera rendering på serversidan

TacoTranslate möjliggör server-side rendering av dina översättningar. Detta förbättrar användarupplevelsen avsevärt genom att visa översatt innehåll omedelbart, istället för att först visa oöversatt innehåll under en kort stund. Dessutom kan vi undvika nätverksförfrågningar på klienten eftersom vi redan har alla översättningar vi behöver.

Vi börjar med att skapa eller ändra /next.config.js.

const withTacoTranslate = require('tacotranslate/next/config').default;
const tacoTranslateClient = require('./tacotranslate-client');

module.exports = async () => {
	const config = {};

	return withTacoTranslate(config, {
		client: tacoTranslateClient,
		isProduction:
			process.env.TACOTRANSLATE_ENV === 'production' ||
			process.env.VERCEL_ENV === 'production' ||
			(!(process.env.TACOTRANSLATE_ENV || process.env.VERCEL_ENV) &&
				process.env.NODE_ENV === 'production'),
	});
};

Ändra isProduction‑kontrollen så att den passar din konfiguration. Om true, kommer TacoTranslate att exponera den publika API-nyckeln. Om vi befinner oss i en lokal-, test- eller stagingmiljö (isProduction is false) kommer vi att använda den hemliga read/write API-nyckeln för att se till att nya strängar skickas för översättning.

Hittills har vi bara ställt in Next.js-applikationen med en lista över stödda språk. Nästa steg är att hämta översättningar för alla dina sidor. För att göra det kommer du att använda antingen getTacoTranslateStaticProps eller getTacoTranslateServerSideProps beroende på dina krav.

Dessa funktioner tar tre argument: ett Next.js Static Props Context‑objekt, konfiguration för TacoTranslate och valfria Next.js‑egenskaper. Observera att revalidate på getTacoTranslateStaticProps är satt till 60 som standard, så att dina översättningar hålls uppdaterade.

För att använda någon av funktionerna på en sida, låt oss anta att du har en sidfil som /pages/hello-world.tsx.

import {Translate} from 'tacotranslate/react';
import getTacoTranslateStaticProps from 'tacotranslate/next/get-static-props';
import tacoTranslateClient from '../tacotranslate-client';

export async function getStaticProps(context) {
	return getTacoTranslateStaticProps(context, {client: tacoTranslateClient});
}

export default function Page() {
	return <Translate string="Hello, world!"/>;
}

Du bör nu kunna använda komponenten Translate för att översätta strängar i alla dina React-komponenter.

import {Translate} from 'tacotranslate/react';

function Component() {
	return <Translate string="Hello, world!"/>
}

Steg 5: Distribuera och testa!

Vi är klara! Din Next.js-applikation kommer nu att översättas automatiskt när du lägger till strängar i en Translate komponent. Observera att endast miljöer med read/write behörigheter på API-nyckeln kommer att kunna skapa nya strängar som ska översättas. Vi rekommenderar att ha en sluten och säker stagingmiljö där du kan testa din produktionsapplikation med en sådan API-nyckel, och lägga till nya strängar innan du går live. Detta kommer att förhindra att någon stjäl din hemliga API-nyckel, och potentiellt göra att ditt översättningsprojekt växer genom att lägga till nya, orelaterade strängar.

Be sure to check out the complete example over at our GitHub profile. There, you’ll also find an example of how to do this using the App Router! 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. Get started today!