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 yếu tố 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 đó, chúng phải dọn dẹp HTML để không thể thực hiện các hành động độc hại. Xem phần mô tả về HtmlOutput để biết những giới hạn mà điều này ngụ ý về những gì 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 phía máy khách.
XFrameOptionsModeXFrameOptionsModeMột enum đại diện cho các chế độ X-Frame-Options có thể dùng cho tập lệnh HtmlService phía máy khách.

Phương thức

Phương thứcKiểu 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 không đúng định dạng


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 bị sai định dạ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 bị lỗi


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 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