Class HtmlService

HtmlService

บริการสำหรับแสดงผล HTML และเนื้อหาข้อความอื่นๆ จากสคริปต์

สคริปต์ไม่สามารถแสดงเนื้อหาต่อเบราว์เซอร์ได้โดยตรงเนื่องจากข้อควรพิจารณาด้านความปลอดภัย แต่ต้องทำให้ HTML ปลอดภัยเพื่อไม่ให้มีการดำเนินการที่เป็นอันตราย ดูคำอธิบายของ HtmlOutput เพื่อดูข้อจำกัดเกี่ยวกับสิ่งที่ระบบจะแสดงผล

พร็อพเพอร์ตี้

พร็อพเพอร์ตี้ประเภทคำอธิบาย
SandboxModeSandboxModeอาร์เรย์แบบจำกัดที่แสดงถึงโหมดแซนด์บ็อกซ์ที่ใช้กับHtmlServiceสคริปต์ฝั่งไคลเอ็นต์ได้
XFrameOptionsModeXFrameOptionsModeอาร์เรย์แบบจำกัดที่แสดงโหมด X-Frame-Options ที่ใช้กับสคริปต์ HtmlService ฝั่งไคลเอ็นต์ได้

เมธอด

วิธีการประเภทการแสดงผลรายละเอียดแบบย่อ
createHtmlOutput()HtmlOutputสร้างออบเจ็กต์ HtmlOutput ใหม่ที่สามารถแสดงผลจากสคริปต์
createHtmlOutput(blob)HtmlOutputสร้างออบเจ็กต์ HtmlOutput ใหม่จากแหล่งข้อมูล BlobSource
createHtmlOutput(html)HtmlOutputสร้างออบเจ็กต์ HtmlOutput ใหม่ที่สามารถแสดงผลจากสคริปต์
createHtmlOutputFromFile(filename)HtmlOutputสร้างออบเจ็กต์ HtmlOutput ใหม่จากไฟล์ในเครื่องมือแก้ไขโค้ด
createTemplate(blob)HtmlTemplateสร้างออบเจ็กต์ HtmlTemplate ใหม่จากแหล่งข้อมูล BlobSource
createTemplate(html)HtmlTemplateสร้างออบเจ็กต์ HtmlTemplate ใหม่ที่สามารถแสดงผลจากสคริปต์
createTemplateFromFile(filename)HtmlTemplateสร้างออบเจ็กต์ HtmlTemplate ใหม่จากไฟล์ในเครื่องมือแก้ไขโค้ด
getUserAgent()Stringรับสตริง User Agent ของเบราว์เซอร์ปัจจุบัน

เอกสารประกอบโดยละเอียด

createHtmlOutput()

สร้างออบเจ็กต์ HtmlOutput ใหม่ที่สามารถแสดงผลจากสคริปต์

const output = HtmlService.createHtmlOutput();

รีเทิร์น

HtmlOutput — ออบเจ็กต์ HtmlOutput ใหม่


createHtmlOutput(blob)

สร้างออบเจ็กต์ HtmlOutput ใหม่จากแหล่งข้อมูล BlobSource

function createFromBlob(blob) {
  const output = HtmlService.createHtmlOutput(blob);
  return output;
}

พารามิเตอร์

ชื่อประเภทคำอธิบาย
blobBlobSourceออบเจ็กต์ที่จะดึง HTML ออกมา

รีเทิร์น

HtmlOutput — ออบเจ็กต์ HtmlOutput ใหม่

โยน

Error — หากบล็อกไม่มี HTML หรือ HTML ผิดรูปแบบ


createHtmlOutput(html)

สร้างออบเจ็กต์ HtmlOutput ใหม่ที่สามารถแสดงผลจากสคริปต์

const output = HtmlService.createHtmlOutput('<b>Hello world!</b>');

พารามิเตอร์

ชื่อประเภทคำอธิบาย
htmlStringเนื้อหาที่จะแสดง

รีเทิร์น

HtmlOutput — ออบเจ็กต์ HtmlOutput ใหม่

โยน

Error — หาก HTML ผิดรูปแบบ


createHtmlOutputFromFile(filename)

สร้างออบเจ็กต์ HtmlOutput ใหม่จากไฟล์ในเครื่องมือแก้ไขโค้ด

const output = HtmlService.createHtmlOutputFromFile('myPage');

พารามิเตอร์

ชื่อประเภทคำอธิบาย
filenameStringชื่อไฟล์ที่จะใช้

รีเทิร์น

HtmlOutput — ออบเจ็กต์ HtmlOutput ใหม่

โยน

Error — หากไม่พบไฟล์หรือ HTML ในไฟล์มีรูปแบบไม่ถูกต้อง


createTemplate(blob)

สร้างออบเจ็กต์ HtmlTemplate ใหม่จากแหล่งข้อมูล BlobSource

function createFromBlob(blob) {
  const template = HtmlService.createTemplate(blob);
  const output = template.evaluate();
  return output;
}

พารามิเตอร์

ชื่อประเภทคำอธิบาย
blobBlobSourceออบเจ็กต์ที่จะดึง HTML ออกมา

รีเทิร์น

HtmlTemplate — ออบเจ็กต์ HtmlTemplate ใหม่

โยน

Error — หากบล็อกไม่มี HTML


createTemplate(html)

สร้างออบเจ็กต์ HtmlTemplate ใหม่ที่สามารถแสดงผลจากสคริปต์

const template = HtmlService.createTemplate(
    '<b>The time is &lt;?= new Date() ?&gt;</b>',
);

พารามิเตอร์

ชื่อประเภทคำอธิบาย
htmlStringเนื้อหาของเทมเพลต

รีเทิร์น

HtmlTemplate — ออบเจ็กต์ HtmlTemplate ใหม่


createTemplateFromFile(filename)

สร้างออบเจ็กต์ HtmlTemplate ใหม่จากไฟล์ในเครื่องมือแก้ไขโค้ด

const template = HtmlService.createTemplateFromFile('myTemplate');

พารามิเตอร์

ชื่อประเภทคำอธิบาย
filenameStringชื่อไฟล์ที่จะใช้

รีเทิร์น

HtmlTemplate — ออบเจ็กต์ HtmlTemplate ใหม่

โยน

Error — หากไม่พบไฟล์


getUserAgent()

รับสตริง User Agent ของเบราว์เซอร์ปัจจุบัน แสดงผล null สําหรับการเรียกใช้สคริปต์ส่วนใหญ่ หากไม่ได้ใช้ในฟังก์ชัน doGet() หรือ doPost() ของเว็บแอป

รีเทิร์น

String — สตริง User Agent