讲师中心 微信公众号
AI工具推荐 视频效率加速

HTML如何切换多国语言_国际化实现指南【教程】

夜芳酱_2116

夜芳酱_2116

发布时间:2025-12-17 12:22:02

|

813人浏览过

|

来源于php中文网

原创

需通过HTML标记、多语言JSON资源文件及JavaScript动态加载实现网页多语言切换:一、按语言建zh.json/en.json/ja.json等键名统一的翻译文件;二、用data-i18n等属性标记待译元素;三、fetch加载对应JSON并替换文本/属性;四、按钮绑定事件切换语言并防重复加载;五、扩展支持title/alt/innerHTML等多场景翻译。

html如何切换多国语言_国际化实现指南【教程】

如果您希望网页支持多种语言,用户可根据自身偏好切换界面语言,则需要通过HTML结合JavaScript和资源文件实现多语言内容的动态替换。以下是实现此功能的具体步骤:

一、准备多语言JSON资源文件

每种语言的内容以独立的JSON文件形式组织,键名保持一致,仅值为对应语言的翻译文本。这种方式便于维护与扩展,且避免硬编码导致的耦合问题。

1、在项目根目录下创建文件夹。

2、在该文件夹中新建zh.json,写入中文键值对,例如:{"welcome": "欢迎使用", "submit": "提交"}。

立即学习“前端免费学习笔记(深入)”;

3、新建en.json,使用相同键名但填写英文翻译,例如:{"welcome": "Welcome to use", "submit": "Submit"}。

4、新建ja.json,填入日文翻译,确保所有键名完全一致。

二、HTML中定义可翻译元素并标记语言键

通过自定义属性(如data-i18n)标注需本地化的HTML元素,使JavaScript能精准识别并替换其内容,同时保留原有结构与语义。

1、在<body>内添加一个按钮用于切换语言:<button id="lang-zh">中文</button><button id="lang-en">English</button>。

2、为待翻译文本添加data-i18n属性,例如:<h1 data-i18n="welcome">欢迎使用</h1>。

3、为表单控件的占位符或按钮文字也添加对应属性:<input type="text" placeholder="" data-i18n-placeholder="search_hint">。

三、使用JavaScript加载并应用对应语言包

通过fetch异步加载选定语言的JSON文件,并遍历DOM中所有带data-i18n属性的节点,将其文本内容或属性值替换为对应翻译。

1、声明全局变量currentLang = 'zh'记录当前激活语言。

Java Maven Common
Java Maven Common

Java Maven 项目审查工作流的通用输入处理。当 Java Maven 项目以 ZIP压缩包或 GitLab 仓库 URL 形式提供且需要...时使用。

下载

2、编写函数loadLanguage(langCode),使用fetch('./i18n/' + langCode + '.json')获取资源。

3、解析响应后调用applyTranslations(translations),遍历document.querySelectorAll('[data-i18n]')节点。

4、对每个节点,读取data-i18n值作为键,在JSON对象中查找对应翻译,并设置textContent或placeholder等属性。

四、监听语言切换按钮并触发更新

为每个语言按钮绑定点击事件,防止重复加载同一语言资源,同时更新currentLang状态,确保后续操作基于最新选择。

1、为id="lang-zh"按钮添加onclick="loadLanguage('zh')"。

2、为id="lang-en"按钮添加onclick="loadLanguage('en')"。

3、在loadLanguage()函数开头加入判断:if (currentLang === langCode) return;。

4、在成功加载后执行currentLang = langCode,完成状态同步。

五、处理HTML属性与嵌套文本的翻译

除纯文本外,部分元素需翻译其属性(如title、alt、aria-label),以及包含子元素的复合结构,需扩展匹配逻辑以覆盖全部场景。

1、在applyTranslations()中增加对data-i18n-title、data-i18n-alt等自定义属性的支持。

2、对含有子节点的元素(如含图标与文字的按钮),使用data-i18n-inner标识需替换内部文本的区域。

3、若某段文本中混有HTML标签(如加粗关键词),则采用data-i18n-html属性,并使用innerHTML赋值而非textContent。

4、在JSON中对应键值使用合法HTML字符串,例如:"notice": "请确认您的邮箱地址正确无误"。

热门AI工具

更多
AionClaw
AionClaw Hot

AionClaw是一款面向办公、创作和编程任务的AI桌面智能体。

豆包大模型

豆包大模型是一款由字节跳动推出的企业级大语言模型服务平台。

DeepSeek

DeepSeek是一款面向对话、写作、编程和推理场景的AI大模型工具。

超级简历WonderCV

一款AI办公效率工具,主要用于免费求职简历模版下载制作,应届生职场人必备简历制作神器,适合需要提升相关任务效率的用户。

Atoms
Atoms Hot

Atoms是一款AI智能体工具,第一支自动构建真实业务的 AI 团队。

WorkBuddy

一款AI办公效率工具,主要用于腾讯云推出的AI原生桌面智能体工作台,适合需要提升相关任务效率的用户。

PixPix
PixPix Hot

PixPix是一款面向电商视觉生产的AI商品图生成工具。

SkildArt
SkildArt Hot

SkildArt是一款AI文本写作工具,一站式 AI 视觉创作平台。

蛙蛙写作

一款AI论文写作工具,主要用于超级AI智能写作助手,适合需要提升相关任务效率的用户。

相关专题

更多
json数据格式
json数据格式

JSON是一种轻量级的数据交换格式。本专题为大家带来json数据格式相关文章,帮助大家解决问题。

2155

2023.08.07

json是什么
json是什么

JSON是一种轻量级的数据交换格式,具有简洁、易读、跨平台和语言的特点,JSON数据是通过键值对的方式进行组织,其中键是字符串,值可以是字符串、数值、布尔值、数组、对象或者null,在Web开发、数据交换和配置文件等方面得到广泛应用。本专题为大家提供json相关的文章、下载、课程内容,供大家免费下载体验。

3342

2023.08.23

jquery怎么操作json
jquery怎么操作json

操作的方法有:1、“$.parseJSON(jsonString)”2、“$.getJSON(url, data, success)”;3、“$.each(obj, callback)”;4、“$.ajax()”。更多jquery怎么操作json的详细内容,可以访问本专题下面的文章。

1116

2023.10.13

go语言处理json数据方法
go语言处理json数据方法

本专题整合了go语言中处理json数据方法,阅读专题下面的文章了解更多详细内容。

3839

2025.09.10

全局变量怎么定义
全局变量怎么定义

本专题整合了全局变量相关内容,阅读专题下面的文章了解更多详细内容。

4645

2025.09.18

python 全局变量
python 全局变量

本专题整合了python中全局变量定义相关教程,阅读专题下面的文章了解更多详细内容。

1930

2025.09.18

c++ 全局变量
c++ 全局变量

本专题整合了c++全局变量的使用、定义、作用域等等内容,阅读专题下面的文章了解更多详细内容。

199

2026.03.17

js 字符串转数组
js 字符串转数组

js字符串转数组的方法:1、使用“split()”方法;2、使用“Array.from()”方法;3、使用for循环遍历;4、使用“Array.split()”方法。本专题为大家提供js字符串转数组的相关的文章、下载、课程内容,供大家免费下载体验。

1778

2023.08.03

Gradle插件开发入门教程
Gradle插件开发入门教程

本专题介绍Gradle插件开发的基本流程,涵盖插件类编写、自定义任务注册、扩展参数设计和插件应用方法,帮助你理解插件如何组织构建逻辑,减少多个项目之间的重复配置。

0

2026.10.22

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
WebStorm 官方调试文档
WebStorm 官方调试文档

共0课时 | 0人学习

React 教程
React 教程

共58课时 | 12.3万人学习

TypeScript 教程
TypeScript 教程

共19课时 | 6.7万人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn