Nextjs 中的路由国际化指南 (i)
来源:dev.to
时间:2024-07-16 08:24:46 282浏览 收藏
积累知识,胜过积蓄金银!毕竟在文章开发的过程中,会遇到各种各样的问题,往往都是一些细节知识点还没有掌握好而导致的,因此基础知识点的积累是很重要的。下面本文《Nextjs 中的路由国际化指南 (i)》,就带大家讲解一下知识点,若是你对本文感兴趣,或者是想搞懂其中某个知识点,就请你继续往下看吧~
国际化(i18n)是设计应用程序的过程,使其能够轻松适应不同的语言和地区,而无需进行工程更改。在本文中,您将学习如何在 next.js 应用程序中设置 i18n 并使用 next-intl 创建语言切换器以在英语和西班牙语之间切换。
安装
首先,您需要安装 next-intl 库,它有助于管理 next.js 中的国际化。在终端中运行以下命令:
npm install next-intl
项目结构
项目结构如下:
├── messages │ ├── en.json │ └── es.json ├── next.config.mjs └── src ├── i18n.ts ├── middleware.ts └── app └── [locale] ├── layout.tsx └── page.tsx
1. 设置翻译消息
在项目的根目录下创建一个 messages 目录。在此目录中,为您想要支持的每种语言添加 json 文件。
消息/en.json
{ "greeting": "hello codú", "farewell": "goodbye codú" }
消息/es.json
{ "greeting": "hola codú", "farewell": "adiós codú" }
这些文件包含您的应用程序将使用的短语的翻译。
2. 配置next.js
在 next.config.mjs 中配置 next.js 以支持国际化。
下一个配置.mjs
import { getrequestconfig } from 'next-intl/server'; // list of supported languages const locales = ['en', 'es']; export default getrequestconfig(async ({ locale }) => { // validate that the incoming `locale` parameter is valid if (!locales.includes(locale)) { return { notfound: true }; } return { messages: (await import(`./messages/${locale}.json`)).default }; });
此文件配置 next.js 以根据请求的语言加载正确的翻译消息。
3. 国际化中间件
创建中间件来处理重定向和设置默认语言。
src/中间件.ts
import createmiddleware from 'next-intl/middleware'; export default createmiddleware({ // list of all supported languages locales: ['en', 'es'], // default language defaultlocale: 'en' }); export const config = { // only match internationalised pathnames matcher: ['/', '/(en|es)/:path*'] };
如果未指定,此中间件会处理重定向到默认语言。
4. 国际化配置
创建配置文件来管理国际化设置。
src/i18n.ts
import { notfound } from 'next/navigation'; import { getrequestconfig } from 'next-intl/server'; const locales = ['en', 'es']; export default getrequestconfig(async ({ locale }) => { if (!locales.includes(locale as any)) notfound(); return { messages: (await import(`../messages/${locale}.json`)).default }; });
此文件验证区域设置并加载相应的消息。
5. 设置布局和页面
配置布局和主页以支持国际化。
src/app/[语言环境]/layout.tsx
import { uselocale } from 'next-intl'; import { reactnode } from 'react'; export default function layout({ children }: { children: reactnode }) { const locale = uselocale(); return ( {children} ); }
src/app/[语言环境]/page.tsx
import { usetranslations } from 'next-intl'; export default function page() { const t = usetranslations(); return (); }{t('greeting')}
{t('farewell')}
这些文件配置布局和主页以使用翻译。
6. 创建语言切换器
最后,创建一个语言切换器以在英语和西班牙语之间切换。
src/app/[语言环境]/switcher.tsx
'use client'; import { useLocale } from 'next-intl'; import { useRouter } from 'next/navigation'; import { ChangeEvent, useTransition } from 'react'; export default function LocalSwitcher() { const [isPending, startTransition] = useTransition(); const router = useRouter(); const localActive = useLocale(); const onSelectChange = (e: ChangeEvent) => { const nextLocale = e.target.value; startTransition(() => { router.replace(`/${nextLocale}`); }); }; return ( ); }
该组件允许用户更改界面语言。
结论
通过这些步骤,您已成功在 next.js 应用程序中设置国际化,并创建了一个语言切换器以在英语和西班牙语之间切换。这将使您的应用程序支持多种语言并提供本地化的用户体验。
文中关于的知识介绍,希望对你的学习有所帮助!若是受益匪浅,那就动动鼠标收藏这篇《Nextjs 中的路由国际化指南 (i)》文章吧,也可关注golang学习网公众号了解相关技术文章。
-
501 收藏
-
501 收藏
-
501 收藏
-
501 收藏
-
501 收藏
-
144 收藏
-
173 收藏
-
378 收藏
-
124 收藏
-
444 收藏
-
364 收藏
-
341 收藏
-
238 收藏
-
181 收藏
-
295 收藏
-
232 收藏
-
337 收藏
-
- 前端进阶之JavaScript设计模式
- 设计模式是开发人员在软件开发过程中面临一般问题时的解决方案,代表了最佳的实践。本课程的主打内容包括JS常见设计模式以及具体应用场景,打造一站式知识长龙服务,适合有JS基础的同学学习。
- 立即学习 542次学习
-
- GO语言核心编程课程
- 本课程采用真实案例,全面具体可落地,从理论到实践,一步一步将GO核心编程技术、编程思想、底层实现融会贯通,使学习者贴近时代脉搏,做IT互联网时代的弄潮儿。
- 立即学习 508次学习
-
- 简单聊聊mysql8与网络通信
- 如有问题加微信:Le-studyg;在课程中,我们将首先介绍MySQL8的新特性,包括性能优化、安全增强、新数据类型等,帮助学生快速熟悉MySQL8的最新功能。接着,我们将深入解析MySQL的网络通信机制,包括协议、连接管理、数据传输等,让
- 立即学习 497次学习
-
- JavaScript正则表达式基础与实战
- 在任何一门编程语言中,正则表达式,都是一项重要的知识,它提供了高效的字符串匹配与捕获机制,可以极大的简化程序设计。
- 立即学习 487次学习
-
- 从零制作响应式网站—Grid布局
- 本系列教程将展示从零制作一个假想的网络科技公司官网,分为导航,轮播,关于我们,成功案例,服务流程,团队介绍,数据部分,公司动态,底部信息等内容区块。网站整体采用CSSGrid布局,支持响应式,有流畅过渡和展现动画。
- 立即学习 484次学习