Referencia de Next.js
init(options)
Importar desde @18ways/next/server.
importar { inicializar } de '@18ways/next/server';Opciones comunes:
| Opción | Tipo | Notas |
|---|---|---|
apiKey | cadena | Requerido. |
localizaciónBase | cadena | Idioma de origen para la aplicación. |
localidad | cadena | Anulación de configuración regional fija opcional. |
locales aceptados | cadena[] | Lista de locales explícitos opcionales. |
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. |
obtenedor | typeof fetch | Implementación de recuperación personalizada. |
rutaDeRuta | ConfiguraciónDeRutaWaysPath | 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 el actual lang y dir valores para el elemento del documento.
generateWaysMetadata()
Usa generateWaysMetadata() dentro de generateMetadata() cuando quieras títulos traducidos,
descripciones y URLs canónicas o alternativas conscientes de la localidad.
waysMiddleware()
waysMiddleware() es la API de middleware en tiempo de solicitud devuelta de init(). Resuelve el estado de la localidad, aplica las cookies de localidad y devuelve el final NextResponse. Usa transformRequestHeaders o transformResponse cuando necesites un comportamiento personalizado.
init() return value
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() | Crea metadatos conscientes de la configuración regional 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 de @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 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
ConfiguraciónDeRutaDeWaysPath acepta:
{
incluir?: Array<string | RegExp>;
excluir?: 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 ruta.
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, el init() superficie anterior es la abstracción correcta.