Helpers

useLocaleSelector

Riferimento API per l’hook useLocaleSelector

Panoramica

Questo hook restituisce la lingua/locale corrente, l’elenco delle lingue/locale e l’hook useSetLocale. È pensato per un utilizzo semplice quando crei un tuo componente di selezione della lingua/locale.

Se non vuoi implementarne uno tuo, puoi usare il componente <LocaleSelector>.

Riferimenti

Valori restituiti

Un oggetto che contiene la lingua/locale corrente, l’elenco delle lingue/locali e l’hook useSetLocale.


Esempi

<LocaleSelector>

Questo è un esempio di implementazione del componente <LocaleSelector>.

export default function LocaleSelector({
  locales: _locales,
  ...props
}: {
  locales?: string[];
  [key: string]: any;
}): React.JSX.Element | null {
  // Recupera le proprietà del selettore della lingua/locale
  const { locale, locales, setLocale, getLocaleProperties } = useLocaleSelector(
    _locales ? _locales : undefined
  );

  // Ottieni il nome da visualizzare
  const getDisplayName = (locale: string) => {
    return capitalizeLanguageName(
      getLocaleProperties(locale).nativeNameWithRegionCode
    );
  };

  // Se non sono disponibili lingue/locali, non renderizzare nulla o gestisci il caso in modo appropriato
  if (!locales || locales.length === 0 || !setLocale) {
    return null;
  }

  return (
    <select
      {...props}
      // Usa una stringa vuota come ripiego se currentLocale non è definito
      value={locale || ''}
      onChange={(e) => setLocale(e.target.value)}
    >
      {/* Ripiego opzionale quando non è impostata alcuna lingua/locale */}
      {!locale && <option value='' />}

      {locales.map((locale) => (
        <option key={locale} value={locale} suppressHydrationWarning>
          {getDisplayName(locale)}
        </option>
      ))}
    </select>
  );
}

Note

  • Questo hook è disponibile solo sul client.
  • Scopri di più sulle stringhe di localizzazione qui.

Prossimi passaggi

Come valuti questa guida?

useLocaleSelector