Class HtmlService

HtmlService

Dịch vụ trả về HTML và nội dung văn bản khác từ một tập lệnh.

Do các cân nhắc về bảo mật, tập lệnh không thể trực tiếp trả về nội dung cho trình duyệt. Thay vào đó, các trình duyệt phải dọn dẹp HTML để không thể thực hiện các hành động độc hại. Hãy xem phần mô tả về HtmlOutput để biết những giới hạn liên quan đến nội dung có thể được trả về.

Thuộc tính

Thuộc tínhLoạiMô tả
SandboxModeSandboxModeMột enum đại diện cho các chế độ hộp cát có thể dùng cho tập lệnh HtmlService bên máy khách.
XFrameOptionsModeXFrameOptionsModeMột enum đại diện cho các chế độ X-Frame-Options có thể được dùng cho tập lệnh HtmlService phía máy khách.

Phương thức

Phương thứcLoại dữ liệu trả vềMô tả ngắn
createHtmlOutput()HtmlOutputTạo một đối tượng HtmlOutput mới có thể được trả về từ tập lệnh.
createHtmlOutput(blob)HtmlOutputTạo một đối tượng HtmlOutput mới từ tài nguyên BlobSource.
createHtmlOutput(html)HtmlOutputTạo một đối tượng HtmlOutput mới có thể được trả về từ tập lệnh.
createHtmlOutputFromFile(filename)HtmlOutputTạo một đối tượng HtmlOutput mới từ một tệp trong trình soạn thảo mã.
createTemplate(blob)HtmlTemplateTạo một đối tượng HtmlTemplate mới từ tài nguyên BlobSource.
createTemplate(html)HtmlTemplateTạo một đối tượng HtmlTemplate mới có thể được trả về từ tập lệnh.
createTemplateFromFile(filename)HtmlTemplateTạo một đối tượng HtmlTemplate mới từ một tệp trong trình soạn thảo mã.
getUserAgent()StringLấy chuỗi tác nhân người dùng cho trình duyệt hiện tại.

Tài liệu chi tiết

createHtmlOutput()

Tạo một đối tượng HtmlOutput mới có thể được trả về từ tập lệnh. 

const output = HtmlService.createHtmlOutput();

Cầu thủ trả bóng

HtmlOutput – đối tượng HtmlOutput mới

createHtmlOutput(blob)

Tạo một đối tượng HtmlOutput mới từ tài nguyên BlobSource. 

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

Tham số

TênLoạiMô tả
blobBlobSourceđối tượng để lấy HTML

Cầu thủ trả bóng

HtmlOutput – đối tượng HtmlOutput mới

Gửi

Error – nếu blob không chứa HTML hoặc HTML có định dạng không chính xác

createHtmlOutput(html)

Tạo một đối tượng HtmlOutput mới có thể được trả về từ tập lệnh. 

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

Tham số

TênLoạiMô tả
htmlStringnội dung cần phân phát

Cầu thủ trả bóng

HtmlOutput – đối tượng HtmlOutput mới

Gửi

Error – nếu html có định dạng không đúng

createHtmlOutputFromFile(filename)

Tạo một đối tượng HtmlOutput mới từ một tệp trong trình soạn thảo mã. 

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

Tham số

TênLoạiMô tả
filenameStringtên của tệp cần sử dụng

Cầu thủ trả bóng

HtmlOutput – đối tượng HtmlOutput mới

Gửi

Error – nếu không tìm thấy tệp hoặc HTML trong tệp có định dạng không chính xác

createTemplate(blob)

Tạo một đối tượng HtmlTemplate mới từ tài nguyên BlobSource. 

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

Tham số

TênLoạiMô tả
blobBlobSourceĐối tượng để lấy HTML.

Cầu thủ trả bóng

HtmlTemplate – đối tượng HtmlTemplate mới

Gửi

Error – nếu blob không chứa HTML

createTemplate(html)

Tạo một đối tượng HtmlTemplate mới có thể được trả về từ tập lệnh. 

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

Tham số

TênLoạiMô tả
htmlStringnội dung của mẫu

Cầu thủ trả bóng

HtmlTemplate – đối tượng HtmlTemplate mới

createTemplateFromFile(filename)

Tạo một đối tượng HtmlTemplate mới từ một tệp trong trình soạn thảo mã. 

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

Tham số

TênLoạiMô tả
filenameStringtên của tệp cần sử dụng

Cầu thủ trả bóng

HtmlTemplate – đối tượng HtmlTemplate mới

Gửi

Error – nếu không tìm thấy tệp

getUserAgent()

Lấy chuỗi tác nhân người dùng cho trình duyệt hiện tại. Trả về null cho hầu hết các lần thực thi tập lệnh nếu không được sử dụng trong hàm doGet() hoặc doPost() của ứng dụng web.

Cầu thủ trả bóng

String – chuỗi tác nhân người dùng