Referencia de Next.js
init(options)
Importar de @18ways/next/server.
import { init } from '@18ways/next/server';Opciones comunes:
| Opción | Tipo | Notas |
|---|---|---|
apiKey | cadena | Requerido. |
baseLocale | cadena | Idioma de origen para la aplicación. |
localización | cadena | Anulación de configuración regional fija opcional. |
localesAceptados | cadena[] | Lista de locales explícitos opcional. |
persistLocaleCookie | boolean | ((solicitud) => boolean) | Política de cookies de localización predeterminada para cambios de localización en middleware y cliente. |
cacheTtl | número | TTL de caché para solicitudes de adaptador. |
fetcher | typeof fetch | Implementación de búsqueda personalizada. |
pathRouting | WaysPathRoutingConfig | Incluir o excluir rutas con prefijo de localización. |
WaysRoot
Usa WaysRoot en el diseño de tu enrutador de aplicaciones para que el adaptador pueda sembrar el estado de ejecución para la solicitud actual.
htmlAttrs()
htmlAttrs() resuelve los valores actuales de lang y dir para el elemento del documento.
generateWaysMetadata()
Usa generateWaysMetadata() dentro de generateMetadata() cuando desees títulos traducidos,
descripciones y URLs canónicas o alternas que consideren la localidad.
waysMiddleware()
waysMiddleware() es la API de middleware en tiempo de solicitud devuelta por init(). Resuelve el estado de la localidad, aplica las cookies de localidad y devuelve el NextResponse final. Usa transformRequestHeaders o transformResponse cuando necesites un comportamiento personalizado.
valor de retorno de init()
init() devuelve estos campos:
| Campo | Qué hace |
|---|---|
WaysRoot | Contenedor raíz para los diseños del enrutador de la aplicación. |
htmlAttrs() | Resuelve lang y dir para la solicitud actual. |
generateWaysMetadata() | Construye metadatos conscientes de la localidad y puede traducir cadenas de metadatos. |
waysMiddleware() | Resuelve el comportamiento del middleware consciente de la configuración regional y devuelve una respuesta. |
Ayudantes del cliente
Importar desde @18ways/next/client.
useLocale()
Lee y cambia la configuración regional actual. Este es el gancho que emparejas con LanguageSwitcher o tu propio
selector de interfaz de usuario personalizado.
useUnlocalizedPathname()
Lee la ruta actual sin el prefijo de localización.
useLocalizedHref()
Convierte un href interno en el href consciente de la configuración regional actual.
localizePathname()
Ayudante puro para construir una ruta localizada fuera de React.
stripLocalePrefix()
Ayudante puro para eliminar un prefijo de localización de una ruta.
Path routing config
WaysPathRoutingConfig acepta:
{
include?: Array<string | RegExp>;
exclude?: Array<string | RegExp>;
}Úsalo cuando las URL públicas deban llevar prefijos de localización. Déjalo fuera cuando desees una selección de localización basada en cookies o en encabezados sin reescritura de rutas.
Lower-level exports
También hay exportaciones de RSC y middleware en @18ways/next/rsc y @18ways/next/server, pero para la mayoría de las aplicaciones, la superficie init() mencionada arriba es la abstracción correcta.