ตัวจัดรูปแบบสำหรับเอาต์พุตเอกสาร XML โดยมีรูปแบบที่กำหนดไว้ล่วงหน้า 3 รูปแบบซึ่งปรับแต่งเพิ่มเติมได้
// Log an XML document with specified formatting options. const xml = '<root><a><b>Text!</b><b>More text!</b></a></root>'; const document = XmlService.parse(xml); const output = XmlService.getCompactFormat() .setLineSeparator('\n') .setEncoding('UTF-8') .setIndent(' ') .format(document); Logger.log(output);
เมธอด
| วิธีการ | ประเภทการแสดงผล | รายละเอียดแบบย่อ |
|---|---|---|
format(document) | String | แสดงผล Document ที่ระบุเป็นสตริงที่จัดรูปแบบ |
format(element) | String | แสดงผลโหนด Element ที่ระบุเป็นสตริงที่จัดรูปแบบแล้ว |
set | Format | กำหนดการเข้ารหัสอักขระที่ควรใช้สำหรับตัวจัดรูปแบบ |
set | Format | กำหนดสตริงที่ใช้ในการเยื้องโหนดย่อยที่สัมพันธ์กับโหนดหลัก |
set | Format | ตั้งค่าสตริงที่จะแทรกเมื่อใดก็ตามที่โปรแกรมจัดรูปแบบจะแทรกตัวแบ่งบรรทัดตามปกติ |
set | Format | กำหนดว่าตัวจัดรูปแบบควรละเว้นการประกาศ XML หรือไม่ เช่น <?xml version="1.0"
encoding="UTF-8"?> |
set | Format | กำหนดว่าตัวจัดรูปแบบควรละเว้นการเข้ารหัสในการประกาศ XML หรือไม่ เช่น ฟิลด์การเข้ารหัสใน <?xml version="1.0" encoding="UTF-8"?> |
เอกสารโดยละเอียด
format(document)
format(element)
set
กำหนดการเข้ารหัสอักขระที่ควรใช้สำหรับตัวจัดรูปแบบ อาร์กิวเมนต์ encoding ต้อง
เป็นการเข้ารหัส XML ที่ยอมรับได้ เช่น ISO-8859-1, US-ASCII, UTF-8 หรือ UTF-16
// Log an XML document with encoding that does not support certain special // characters. const xml = '<root><a><b>ಠ‿ಠ</b><b>ಠ‿ಠ</b></a></root>'; const document = XmlService.parse(xml); const output = XmlService.getRawFormat().setEncoding('ISO-8859-1').format(document); Logger.log(output);
พารามิเตอร์
| ชื่อ | ประเภท | คำอธิบาย |
|---|---|---|
encoding | String | การเข้ารหัสที่จะใช้ |
รีเทิร์น
Format — ตัวจัดรูปแบบสำหรับการเชื่อมโยง
set
กำหนดสตริงที่ใช้ในการเยื้องโหนดย่อยที่สัมพันธ์กับโหนดหลัก การตั้งค่าการเยื้องอื่น
ที่ไม่ใช่ null จะทำให้ตัวจัดรูปแบบแทรกการขึ้นบรรทัดใหม่หลังแต่ละโหนด
// Log an XML document with each child node indented four spaces. const xml = '<root><a><b>Text!</b><b>More text!</b></a></root>'; const document = XmlService.parse(xml); const output = XmlService.getCompactFormat().setIndent(' ').format(document); Logger.log(output);
พารามิเตอร์
| ชื่อ | ประเภท | คำอธิบาย |
|---|---|---|
indent | String | การเยื้องที่จะใช้ |
รีเทิร์น
Format — ตัวจัดรูปแบบสำหรับการเชื่อมโยง
set
ตั้งค่าสตริงที่จะแทรกเมื่อใดก็ตามที่โปรแกรมจัดรูปแบบจะแทรกตัวแบ่งบรรทัดตามปกติ ตัวจัดรูปแบบที่กำหนดไว้ล่วงหน้า 3 รายการมีเงื่อนไขที่แตกต่างกันในการแทรกการขึ้นบรรทัดใหม่ ตัวคั่นบรรทัดเริ่มต้นคือ \r\n
// Log an XML document with several spaces and a pipe character in place of line // breaks. const xml = '<root><a><b>Text!</b><b>More text!</b></a></root>'; const document = XmlService.parse(xml); const output = XmlService.getRawFormat().setLineSeparator(' | ').format(document); Logger.log(output);
พารามิเตอร์
| ชื่อ | ประเภท | คำอธิบาย |
|---|---|---|
separator | String | ตัวคั่นที่จะใช้ |
รีเทิร์น
Format — ตัวจัดรูปแบบสำหรับการเชื่อมโยง
set
กำหนดว่าตัวจัดรูปแบบควรละเว้นการประกาศ XML หรือไม่ เช่น <?xml version="1.0"
encoding="UTF-8"?>
พารามิเตอร์
| ชื่อ | ประเภท | คำอธิบาย |
|---|---|---|
omit | Boolean | true เพื่อละเว้นการประกาศ XML false เพื่อรวมการประกาศ XML |
รีเทิร์น
Format — ตัวจัดรูปแบบสำหรับการเชื่อมโยง
set
กำหนดว่าตัวจัดรูปแบบควรละเว้นการเข้ารหัสในการประกาศ XML หรือไม่ เช่น ฟิลด์การเข้ารหัสใน <?xml version="1.0" encoding="UTF-8"?>
พารามิเตอร์
| ชื่อ | ประเภท | คำอธิบาย |
|---|---|---|
omit | Boolean | true เพื่อละเว้นการเข้ารหัสในการประกาศ XML false เพื่อรวมการเข้ารหัส |
รีเทิร์น
Format — ตัวจัดรูปแบบสำหรับการเชื่อมโยง