# General Translation Changelog: gt-next 6.10.0: Supporto sperimentale per i componenti in cache
URL: https://generaltranslation.com/it/blog/gt-next_v6_10_0.mdx
Docs index: https://generaltranslation.com/llms.txt
Description: 
Authors: Ernest McCarter
Published: 2025-12-03

## Panoramica

**gt-next 6.10.0** introduce il supporto sperimentale per i componenti in cache e depreca al contempo le funzioni di richiesta statica legacy di gt-next@6.9.

* **Aggiunto il supporto sperimentale per i componenti in cache** con `experimentalLocaleResolution`
* **Deprecate le funzioni di richiesta statica legacy** di `gt-next@6.9`

***

## Componenti in cache

Per abilitare il supporto per i componenti in cache, aggiungi `experimentalLocaleResolution: true` alla configurazione di gt-next e segui [la guida ai Cache Components di Next.js](https://nextjs.org/docs/app/getting-started/cache-components). Quando usi componenti in cache con contenuti traducibili, devi passare `locale` come parametro per garantire la corretta invalidazione della cache tra impostazioni regionali diverse.

Considera questa struttura dell'applicazione:

```tsx title="page.tsx"
import { Suspense } from "react";
import { getLocale, getLocales } from "gt-next/server";

export const generateStaticParams = () => {
  return getLocales().map(locale => ({ locale }))
}

async function CachedContent({locale: _locale}: {locale: string}) {
  "use cache"
  return (
    <div>
      <T><h1>Cached Content</h1></T>
    </div>
  )
}
export default async function Home() {
  const locale = await getLocale()
  return (
    <div>
      <CachedContent locale={locale} />
    </div>
  );
}
```


### Il requisito del parametro `locale`

I componenti in cache usano i propri parametri come chiavi della cache; qualsiasi componente in cache che contenga contenuti traducibili deve accettare un parametro `locale` per aggiornarsi quando cambia l&#39;impostazione regionale dell&#39;utente. Ad esempio, `CachedContent` deve accettare un parametro `locale` per creare voci di cache separate per ogni impostazione regionale. Senza questo parametro, il componente restituirebbe lo stesso contenuto memorizzato nella cache indipendentemente dall&#39;impostazione regionale dell&#39;utente.

### Note sulla configurazione

Quando `experimentalLocaleResolution` è abilitato:

* Il proxy I18n deve essere abilitato perché la risoluzione dell&#39;impostazione regionale funzioni (vedi [I18n Proxy](/docs/react/nextjs/app-router-middleware))
* Sovrascrive qualsiasi funzione [`getLocale`](/docs/react/nextjs/reference/functions/get-locale) personalizzata (la risoluzione dell&#39;impostazione regionale legge il percorso dell&#39;URL)
* Disabilita le funzioni [`getRegion`](/docs/react/nextjs/reference/functions/get-region) e `getDomain`
* È in conflitto con la configurazione deprecata `experimentalEnableSSG`: può esserne abilitata solo una alla volta
* Puoi personalizzare il nome del parametro dell&#39;impostazione regionale con `experimentalLocaleResolutionParam` (il valore predefinito è `'locale'`)

```js
export default withGTConfig(nextConfig, {
  experimentalLocaleResolution: true,
  // Facoltativamente, personalizza il nome del parametro
  experimentalLocaleResolutionParam: 'lang',
})
```

***

## Deprecazione delle funzioni di richiesta statica legacy

Dopo l&#39;introduzione del supporto per il rendering statico in gt-next@6.9, stiamo deprecando le funzioni di richiesta statica legacy (`getStaticLocale`, `getStaticRegion`, `getStaticDomain`) a favore delle funzioni di richiesta standard ([`getLocale`](/docs/react/nextjs/reference/functions/get-locale), [`getRegion`](/docs/react/nextjs/reference/functions/get-region), `getDomain`).

Questa deprecazione riflette il nostro obiettivo di semplificare l&#39;API mantenendo al tempo stesso tutte le funzionalità. Le funzioni statiche legacy continueranno a funzionare, ma genereranno avvisi di deprecazione. Per uniformità, ti consigliamo di [migrare alle funzioni di richiesta standard](#migration-guide).

***

## Guida alla migrazione

### SSG legacy

Sostituisci le funzioni di richiesta statica deprecate:

```js title="next.config.js"
// Prima (deprecato)
export default withGTConfig(nextConfig, {
  experimentalEnableSSG: true,
})

// Dopo  
export default withGTConfig(nextConfig, {
  // Accessibile per impostazione predefinita
})
```

Rimuovi eventuali funzioni personalizzate `getStaticLocale`, `getStaticRegion` o `getStaticDomain` e usa invece funzioni personalizzate [`getLocale`](/docs/react/nextjs/reference/functions/get-locale), [`getRegion`](/docs/react/nextjs/reference/functions/get-region) o `getDomain`. Devi aggiungere una funzione [`getLocale`](/docs/react/nextjs/reference/functions/get-locale) personalizzata e disabilitare la funzione [`getRegion`](/docs/react/nextjs/reference/functions/get-region). Per ulteriori informazioni, consulta la [guida SSG](/docs/react/nextjs/app-router-static-site-generation).

```ts title="getLocale.ts"
import { locale } from "next/root-params";

export default async function getLocale() {
  return await locale();
}
```

```ts title="getRegion.ts"
export default async function getRegion() {
  return undefined;
}
```

### Per i componenti in cache

Abilita la risoluzione sperimentale dell&#39;impostazione regionale e assicurati che i componenti in cache ricevano i parametri dell&#39;impostazione regionale:

```js
const nextConfig = {
  cacheComponents: true,
}

// Configurazione
export default withGTConfig(nextConfig, {
  experimentalLocaleResolution: true,
})
```

```tsx
// Implementazione del componente
async function MyCachedComponent({locale}: {locale: string}) {
  "use cache"
  // Il tuo contenuto internazionalizzato qui
  return <T>Content for <Var>{locale}</Var></T>
}

// Utilizzo
export default async function Page() {
  const locale = await getLocale()
  return <MyCachedComponent locale={locale} />
}
```

## Sitemap

See the full [sitemap](https://generaltranslation.com/sitemap.md) for all pages.