1# XML转换
2
3
4将XML文本转换为JavaScript对象可以更轻松地处理和操作数据，并且更适合在JavaScript应用程序中使用。
5
6
7语言基础类库提供ConvertXML类将XML文本转换为JavaScript对象，输入为待转换的XML字符串及转换选项，输出为转换后的JavaScript对象。具体转换选项可见[API参考@ohos.convertxml](../reference/apis-arkts/js-apis-convertxml.md)。
8
9
10## 注意事项
11
12XML解析及转换需要确保传入的XML数据符合标准格式。
13
14
15## 开发步骤
16
17此处以XML转为JavaScript对象后获取其标签值为例，说明转换效果。
18
191. 引入模块。
20
21   ```ts
22   import { convertxml } from '@kit.ArkTS';
23   ```
24
252. 输入待转换的XML，设置转换选项，支持的转换选项及含义具体可见[ConvertOptions](../reference/apis-arkts/js-apis-convertxml.md#convertoptions)。
26
27   > **说明：**
28   >
29   > 传入的XML文本中，若包含“&”字符，请使用实体引用“\&”替换。
30
31   ```ts
32   let xml: string =
33    '<?xml version="1.0" encoding="utf-8"?>' +
34    '<note importance="high" logged="true">' +
35    '    <title>Happy</title>' +
36    '    <todo>Work</todo>' +
37    '    <todo>Play</todo>' +
38    '</note>';
39   let options: convertxml.ConvertOptions = {
40     // trim: false 转换后是否删除文本前后的空格，否
41     // declarationKey: "_declaration" 转换后文件声明使用_declaration来标识
42     // instructionKey: "_instruction" 转换后指令使用_instruction标识
43     // attributesKey: "_attributes" 转换后属性使用_attributes标识
44     // textKey: "_text" 转换后标签值使用_text标识
45     // cdataKey: "_cdata" 转换后未解析数据使用_cdata标识
46     // docTypeKey: "_doctype" 转换后文档类型使用_doctype标识
47     // commentKey: "_comment" 转换后注释使用_comment标识
48     // parentKey: "_parent" 转换后父类使用_parent标识
49     // typeKey: "_type" 转换后元素类型使用_type标识
50     // nameKey: "_name" 转换后标签名称使用_name标识
51     // elementsKey: "_elements" 转换后元素使用_elements标识
52     trim: false,
53     declarationKey: "_declaration",
54     instructionKey: "_instruction",
55     attributesKey: "_attributes",
56     textKey: "_text",
57     cdataKey: "_cdata",
58     doctypeKey: "_doctype",
59     commentKey: "_comment",
60     parentKey: "_parent",
61     typeKey: "_type",
62     nameKey: "_name",
63     elementsKey: "_elements"
64   }
65   ```
66
673. 调用转换函数，打印结果。
68
69   ```ts
70   let conv: convertxml.ConvertXML = new convertxml.ConvertXML();
71   let result: object = conv.convertToJSObject(xml, options);
72   let strRes: string = JSON.stringify(result); // 将js对象转换为json字符串，用于显式输出
73   console.info(strRes);
74   ```
75
76   输出结果如下所示：
77
78   ```json
79   strRes:
80   {"_declaration":{"_attributes":{"version":"1.0","encoding":"utf-8"}},"_elements":[{"_type":"element","_name":"note",
81    "_attributes":{"importance":"high","logged":"true"},"_elements":[{"_type":"element","_name":"title",
82    "_elements":[{"_type":"text","_text":"Happy"}]},{"_type":"element","_name":"todo",
83    "_elements":[{"_type":"text","_text":"Work"}]},{"_type":"element","_name":"todo",
84    "_elements":[{"_type":"text","_text":"Play"}]}]}]}
85   ```
86