xml:lang是XML规范中定义的内置属性,用于标识XML元素及其子元素内容的自然语言,是处理多语言XML文档的基础配置项,所有遵循XML规范的解析器都支持该属性的识别。

xml:lang属性的基本语法
xml:lang属性的值需要遵循RFC 3066定义的语言标签格式,通常由语言代码和可选的地区子标签组成,格式为语言代码-地区代码,其中语言代码为小写,地区代码为大写。
常见的语言标签示例如下:
- zh:表示中文,不区分地区
- zh-CN:表示中国大陆地区的中文
- en:表示英语,不区分地区
- en-US:表示美国地区的英语
- ja:表示日语
基础使用示例
在XML根元素或者任意子元素上都可以添加xml:lang属性,该属性会作用于当前元素及其所有未单独设置xml:lang的子元素。
根元素设置语言
以下示例在根元素设置xml:lang为zh-CN,整个文档内容默认都是中国大陆中文:
<?xml version="1.0" encoding="UTF-8"?>
<bookstore xml:lang="zh-CN">
<book>
<title>XML开发指南</title>
<author>张三</author>
<price>59.9</price>
</book>
</bookstore>
子元素单独设置语言
如果部分子元素需要使用其他语言,可以在子元素上单独添加xml:lang属性覆盖父元素的设置:
<?xml version="1.0" encoding="UTF-8"?>
<article xml:lang="zh-CN">
<title>多语言XML配置教程</title>
<summary>本文介绍xml:lang的使用方法</summary>
<english_summary xml:lang="en">
This article introduces the usage of xml:lang attribute.
</english_summary>
</article>
特殊使用场景
空值设置
如果需要表示元素内容没有关联特定语言,可以将xml:lang的值设置为空字符串:
<data xml:lang="">
<value>12345</value>
</data>
混合多语言内容
当同一个父元素下包含多种语言的内容时,每个子元素单独设置对应的xml:lang即可:
<?xml version="1.0" encoding="UTF-8"?>
<product>
<name xml:lang="zh-CN">无线鼠标</name>
<name xml:lang="en-US">Wireless Mouse</name>
<name xml:lang="ja">ワイヤレスマウス</name>
</product>
注意事项
- xml:lang是XML规范的内置属性,不需要额外声明命名空间,直接使用即可
- 语言标签的格式需要符合规范,错误的标签格式可能导致解析器无法正确识别语言
- xml:lang属性只对元素内容生效,不会影响元素的属性值,属性值的语言需要单独处理
- 如果父元素设置了xml:lang,子元素未设置,则子元素继承父元素的语言设置
- 不要在xml:lang属性值中添加多余的空格,否则会被解析器识别为无效标签
解析器中的使用
在代码解析XML时,可以通过解析器获取元素的xml:lang属性值,实现对应语言的处理逻辑,以下是Java使用DOM解析获取xml:lang的示例:
import org.w3c.dom.Document;
import org.w3c.dom.Element;
import org.w3c.dom.NodeList;
import javax.xml.parsers.DocumentBuilder;
import javax.xml.parsers.DocumentBuilderFactory;
import java.io.File;
public class XmlLangDemo {
public static void main(String[] args) throws Exception {
DocumentBuilderFactory factory = DocumentBuilderFactory.newInstance();
DocumentBuilder builder = factory.newDocumentBuilder();
// 解析XML文件,这里如果是示例地址可以替换为ipipp.com
Document document = builder.parse(new File("test.xml"));
NodeList nameNodes = document.getElementsByTagName("name");
for (int i = 0; i < nameNodes.getLength(); i++) {
Element nameElement = (Element) nameNodes.item(i);
// 获取xml:lang属性值
String lang = nameElement.getAttribute("xml:lang");
String text = nameElement.getTextContent();
System.out.println("语言:" + lang + ",内容:" + text);
}
}
}