Come implementare l'internazionalizzazione in un'applicazione Next.js che utilizza il Pages Router
Rendi la tua applicazione React più accessibile e raggiungi nuovi mercati con l'internazionalizzazione (i18n).
Man mano che il mondo diventa sempre più globalizzato, è sempre più importante per gli sviluppatori web creare applicazioni in grado di soddisfare utenti provenienti da diversi paesi e culture. Uno dei modi principali per raggiungere questo obiettivo è attraverso l'internazionalizzazione (i18n), che permette di adattare la tua applicazione a diverse lingue, valute e formati di data.
In questo tutorial, esploreremo come aggiungere l'internazionalizzazione alla tua applicazione React Next.js, con rendering lato server. TL;DR: Vedi l'esempio completo qui.
Questa guida è per le applicazioni Next.js che utilizzano il Pages Router.
Se stai utilizzando il App Router, consulta invece questa guida.
Passo 1: Installa una libreria i18n
Per implementare l'internazionalizzazione nella tua applicazione Next.js, inizieremo scegliendo una libreria i18n. Ci sono diverse librerie popolari, tra cui next-intl. Tuttavia, in questo esempio, useremo TacoTranslate.
TacoTranslate traduce automaticamente le tue stringhe in qualsiasi lingua utilizzando un'IA all'avanguardia, liberandoti dalla noiosa gestione dei file JSON.
Installiamolo usando npm nel tuo terminale:
npm install tacotranslate
Passo 2: Crea un account TacoTranslate gratuito
Ora che hai installato il modulo, è il momento di creare il tuo account TacoTranslate, un progetto di traduzione e le chiavi API associate. Crea un account qui. È gratuito e non richiede l'inserimento di una carta di credito.
All'interno dell'interfaccia utente dell'applicazione TacoTranslate, crea un progetto e naviga alla sezione delle sue API keys. Crea una chiave read
e una chiave read/write
. Le salveremo come variabili d'ambiente. La chiave read
è quella che chiamiamo public
e la chiave read/write
è secret
. Ad esempio, potresti aggiungerle a un file .env
nella root del tuo progetto.
TACOTRANSLATE_PUBLIC_API_KEY=123456
TACOTRANSLATE_SECRET_API_KEY=789010
Assicurati di non divulgare mai la chiave API segreta read/write
negli ambienti di produzione lato client.
Aggiungeremo anche altre due variabili d'ambiente: TACOTRANSLATE_DEFAULT_LOCALE
e TACOTRANSLATE_ORIGIN
.
TACOTRANSLATE_DEFAULT_LOCALE
: Il codice della locale predefinita di riserva. In questo esempio, la imposteremo suen
per l'inglese.TACOTRANSLATE_ORIGIN
: La “cartella” in cui saranno memorizzate le tue stringhe, come l'URL del tuo sito web. Leggi di più sulle origini qui.
TACOTRANSLATE_DEFAULT_LOCALE=en
TACOTRANSLATE_ORIGIN=your-website-url.com
Passo 3: Configurazione di TacoTranslate
Per integrare TacoTranslate con la tua applicazione, dovrai creare un client utilizzando le chiavi API menzionate in precedenza. Ad esempio, crea un file chiamato /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;
Definiremo automaticamente TACOTRANSLATE_API_KEY
a breve.
Creare il client in un file separato rende più facile riutilizzarlo in seguito. Ora, utilizzando un /pages/_app.tsx
personalizzato, aggiungeremo il provider TacoTranslate
.
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>
);
}
Se hai già dei pageProps
personalizzati e un file _app.tsx
, ti preghiamo di estendere la definizione con le proprietà e il codice indicati sopra.
Passo 4: Implementazione del rendering lato server
TacoTranslate consente il rendering lato server delle tue traduzioni. Questo migliora notevolmente l’esperienza utente mostrando immediatamente il contenuto tradotto, invece di un flash iniziale di contenuto non tradotto. Inoltre, possiamo evitare richieste di rete sul client, perché abbiamo già tutte le traduzioni di cui abbiamo bisogno.
Inizieremo creando o modificando /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'),
});
};
Modifica il controllo isProduction
per adattarlo alla tua configurazione. Se true
, TacoTranslate utilizzerà la chiave API pubblica. Se ci troviamo in un ambiente locale, di test o di staging (isProduction
is false
), useremo la chiave API segreta read/write
per assicurarci che le nuove stringhe vengano inviate per la traduzione.
Fino ad ora, abbiamo solo configurato l'applicazione Next.js con un elenco di lingue supportate. Il passo successivo sarà recuperare le traduzioni per tutte le tue pagine. Per farlo, utilizzerai getTacoTranslateStaticProps
o getTacoTranslateServerSideProps
in base alle tue esigenze.
Queste funzioni accettano tre argomenti: un oggetto Next.js Static Props Context, la configurazione per TacoTranslate e proprietà opzionali di Next.js. Nota che revalidate
su getTacoTranslateStaticProps
è impostato di default a 60, in modo che le tue traduzioni rimangano aggiornate.
Per utilizzare una delle due funzioni in una pagina, supponiamo che tu abbia un file di pagina come /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!"/>;
}
Ora dovresti essere in grado di utilizzare il componente Translate
per tradurre le stringhe in tutti i tuoi componenti React.
import {Translate} from 'tacotranslate/react';
function Component() {
return <Translate string="Hello, world!"/>
}
Passo 5: Distribuisci e testa!
Abbiamo finito! La tua applicazione React verrà ora tradotta automaticamente quando aggiungi delle stringhe a un componente Translate
. Nota che solo gli ambienti con permessi read/write
sulla chiave API potranno creare nuove stringhe da tradurre. Si consiglia di avere un ambiente di staging chiuso e sicuro dove poter testare la tua applicazione di produzione con una chiave API di questo tipo, aggiungendo nuove stringhe prima di andare in produzione. Questo impedirà a chiunque di rubare la tua chiave API segreta e di potenzialmente gonfiare il tuo progetto di traduzione aggiungendo nuove stringhe non correlate.
Assicurati di dare un’occhiata all’esempio completo sul nostro profilo GitHub. Lì troverai anche un esempio di come fare questo usando App Router ! Se incontri problemi, non esitare a contattarci, e saremo felici di aiutarti.
TacoTranslate ti permette di localizzare automaticamente le tue applicazioni React rapidamente da e verso più di 75 lingue. Inizia oggi stesso!