Class HtmlOutput

HtmlOutput

Đối tượng HtmlOutput có thể được phân phát qua một tập lệnh. Do những cân nhắc về bảo mật, các tập lệnh không thể trực tiếp trả lại HTML cho trình duyệt. Thay vào đó, họ phải dọn dẹp vệ sinh để không thể thực hiện hành động độc hại. Bạn có thể trả về HTML đã dọn dẹp như sau:

function doGet() {
  return HtmlService.createHtmlOutput('<b>Hello, world!</b>');
}
Mã trong HtmlOutput có thể bao gồm CSS và JavaScript đã nhúng. (Đây là tiêu chuẩn JavaScript phía máy khách thao tác DOM, không phải Apps Script). Tất cả nội dung này trong hộp cát bằng iframe hộp cát. Để biết thêm thông tin, hãy xem hướng dẫn về các hạn chế trong dịch vụ HTML.

Phương thức

Phương thứcLoại dữ liệu trả vềMô tả ngắn
addMetaTag(name, content)HtmlOutputThêm thẻ meta vào trang.
append(addedContent)HtmlOutputThêm nội dung mới vào nội dung của HtmlOutput này.
appendUntrusted(addedContent)HtmlOutputThêm nội dung mới vào nội dung của HtmlOutput này bằng cách sử dụng tính năng thoát theo ngữ cảnh.
asTemplate()HtmlTemplateTrả về HtmlTemplate được HtmlOutput này hỗ trợ.
clear()HtmlOutputXoá nội dung hiện tại.
getAs(contentType)BlobTrả về dữ liệu bên trong đối tượng này dưới dạng một blob được chuyển đổi sang loại nội dung được chỉ định.
getBlob()BlobTrả về dữ liệu bên trong đối tượng này dưới dạng một blob.
getContent()StringLấy nội dung của HtmlOutput này.
getFaviconUrl()StringLấy URL của thẻ liên kết biểu tượng trang web đã thêm vào trang bằng cách gọi setFaviconUrl(iconUrl).
getHeight()IntegerLấy chiều cao ban đầu của hộp thoại tuỳ chỉnh trong Google Tài liệu, Trang tính hoặc Biểu mẫu.
getMetaTags()HtmlOutputMetaTag[]Lấy một mảng các đối tượng đại diện cho thẻ meta đã được thêm vào trang bằng cách gọi addMetaTag(name, content).
getTitle()StringLấy tiêu đề của trang đầu ra.
getWidth()IntegerLấy chiều rộng ban đầu của hộp thoại tuỳ chỉnh trong Google Tài liệu, Trang tính hoặc Biểu mẫu.
setContent(content)HtmlOutputThiết lập nội dung của HtmlOutput này.
setFaviconUrl(iconUrl)HtmlOutputThêm một thẻ liên kết cho biểu tượng trang web vào trang.
setHeight(height)HtmlOutputĐặt chiều cao ban đầu của hộp thoại tuỳ chỉnh trong Google Tài liệu, Trang tính hoặc Biểu mẫu.
setSandboxMode(mode)HtmlOutputPhương thức này hiện không có hiệu lực — trước đây, phương thức này đặt sandbox mode được dùng cho các tập lệnh phía máy khách.
setTitle(title)HtmlOutputĐặt tiêu đề của trang đầu ra.
setWidth(width)HtmlOutputĐặt chiều rộng ban đầu của hộp thoại tuỳ chỉnh trong Google Tài liệu, Trang tính hoặc Biểu mẫu.
setXFrameOptionsMode(mode)HtmlOutputĐặt trạng thái cho tiêu đề X-Frame-Options của trang để kiểm soát hoạt động nhấp chuột phòng ngừa.

Tài liệu chi tiết

addMetaTag(name, content)

Thêm thẻ meta vào trang. Thẻ meta được đưa trực tiếp vào tệp HTML của Apps Script đã bỏ qua. Bạn chỉ được phép sử dụng các thẻ meta sau:

<meta name="apple-mobile-web-app-capable" content="..."/>
<meta name="google-site-verification" content="..."/>
<meta name="mobile-web-app-capable" content="..."/>
<meta name="viewport" content="..."/>
var output = HtmlService.createHtmlOutput('<b>Hello, world!</b>');
output.addMetaTag('viewport', 'width=device-width, initial-scale=1');

Tham số

TênLoạiMô tả
nameStringGiá trị của thuộc tính tên của thẻ meta.
contentStringGiá trị của thuộc tính nội dung của thẻ meta.

Cầu thủ trả bóng

HtmlOutput – Kết quả này để tạo chuỗi.


append(addedContent)

Thêm nội dung mới vào nội dung của HtmlOutput này. Chỉ sử dụng thuộc tính này cho nội dung từ nguồn đáng tin cậy vì nó không có mã thoát.

// Log "<b>Hello, world!</b><p>Hello again, world.</p>"
var output = HtmlService.createHtmlOutput('<b>Hello, world!</b>');
output.append('<p>Hello again, world.</p>');
Logger.log(output.getContent());

Tham số

TênLoạiMô tả
addedContentStringNội dung cần bổ sung.

Cầu thủ trả bóng

HtmlOutput – Kết quả này để tạo chuỗi.

Gửi

Error – nếu HTML không đúng định dạng

Xem thêm


appendUntrusted(addedContent)

Thêm nội dung mới vào nội dung của HtmlOutput này bằng cách sử dụng tính năng thoát theo ngữ cảnh.

Phương thức này thoát chính xác nội dung dựa trên trạng thái hiện tại của HtmlOutput, để kết quả là một chuỗi an toàn, không bị ảnh hưởng bởi phần đánh dấu hoặc phần phụ thuộc. Hãy sử dụng phương pháp này thay vì sử dụng thêm mỗi khi bạn thêm nội dung từ một nguồn không đáng tin cậy, chẳng hạn như từ người dùng, để tránh vô tình cho phép lỗi tập lệnh trên nhiều trang web (XSS) trong đó nội dung hoặc thẻ đánh dấu mà bạn thêm vào khiến mã thực thi không mong muốn.

// Log "<b>Hello, world!</b>&lt;p&gt;Hello again, world.&lt;/p&gt;"
var output = HtmlService.createHtmlOutput('<b>Hello, world!</b>');
output.appendUntrusted('<p>Hello again, world.</p>');
Logger.log(output.getContent());

Tham số

TênLoạiMô tả
addedContentStringNội dung cần bổ sung.

Cầu thủ trả bóng

HtmlOutput – Kết quả này để tạo chuỗi.

Gửi

Error – nếu HTML không đúng định dạng

Xem thêm


asTemplate()

Trả về HtmlTemplate được HtmlOutput này hỗ trợ. Phương pháp này có thể được dùng để xây dựng một mẫu dần dần. Các thay đổi trong tương lai đối với HtmlOutput sẽ ảnh hưởng đến nội dung của HtmlTemplate.

var output = HtmlService.createHtmlOutput('<b>Hello, world!</b>');
var template = output.asTemplate();

Cầu thủ trả bóng

HtmlTemplateHtmlTemplate mới.


clear()

Xoá nội dung hiện tại.

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

Cầu thủ trả bóng

HtmlOutput – Kết quả này để tạo chuỗi.


getAs(contentType)

Trả về dữ liệu bên trong đối tượng này dưới dạng một blob được chuyển đổi sang loại nội dung được chỉ định. Chiến dịch này sẽ thêm đuôi tệp thích hợp vào tên tệp (ví dụ: "myfile.pdf"). Tuy nhiên, việc này giả định rằng phần tên tệp tiếp sau dấu chấm cuối cùng (nếu có) là phần tên tệp hiện có tiện ích mở rộng cần được thay thế. Do đó, "ShoppingList.12.25.2014" trở thành "ShoppingList.12.25.pdf".

Để xem hạn mức hằng ngày cho lượt chuyển đổi, hãy xem bài viết Hạn mức cho Google Dịch vụ. Các miền Google Workspace mới tạo có thể tạm thời bị áp dụng quy định nghiêm ngặt hơn hạn mức.

Tham số

TênLoạiMô tả
contentTypeStringLoại MIME cần chuyển đổi. Đối với hầu hết các blob, 'application/pdf' là lựa chọn hợp lệ duy nhất. Đối với hình ảnh ở định dạng BMP, GIF, JPEG hoặc PNG, bất kỳ hình ảnh nào có định dạng 'image/bmp', 'image/gif', 'image/jpeg' hoặc 'image/png' cũng hợp lệ. Đối với tài liệu trên Google Tài liệu, 'text/markdown' cũng hợp lệ.

Cầu thủ trả bóng

Blob – Dữ liệu dưới dạng một blob.


getBlob()

Trả về dữ liệu bên trong đối tượng này dưới dạng một blob.

Cầu thủ trả bóng

Blob – Dữ liệu dưới dạng một blob.


getContent()

Lấy nội dung của HtmlOutput này.

// Log "<b>Hello, world!</b>"
var output = HtmlService.createHtmlOutput('<b>Hello, world!</b>');
Logger.log(output.getContent());

Cầu thủ trả bóng

String – Nội dung được phân phát.


getFaviconUrl()

Lấy URL của thẻ liên kết biểu tượng trang web đã thêm vào trang bằng cách gọi setFaviconUrl(iconUrl). Các thẻ liên kết biểu tượng trang web được đưa trực tiếp vào tệp HTML Apps Script đã bỏ qua.

var output = HtmlService.createHtmlOutput('<b>Hello, world!</b>');
output.setFaviconUrl('http://www.example.com/image.png');
Logger.log(output.getFaviconUrl());

Cầu thủ trả bóng

String – URL của hình ảnh biểu tượng trang web.


getHeight()

Lấy chiều cao ban đầu của hộp thoại tuỳ chỉnh trong Google Tài liệu, Trang tính hoặc Biểu mẫu. Nếu HtmlOutput được xuất bản dưới dạng một ứng dụng web, thì phương thức trả về null. Để đổi kích thước hộp thoại đã mở, hãy gọi google.script.host.setHeight(height) trong mã phía máy khách.

var output = HtmlService.createHtmlOutput('<b>Hello, world!</b>');
output.setHeight(200);
Logger.log(output.getHeight());

Cầu thủ trả bóng

Integer – Chiều cao, tính bằng pixel.


getMetaTags()

Lấy một mảng các đối tượng đại diện cho thẻ meta đã được thêm vào trang bằng cách gọi addMetaTag(name, content). Thẻ meta được đưa trực tiếp vào tệp HTML của Apps Script đã bỏ qua.

var output = HtmlService.createHtmlOutput('<b>Hello, world!</b>');
output.addMetaTag('viewport', 'width=device-width, initial-scale=1');

var tags = output.getMetaTags();
Logger.log('<meta name="%s" content="%s"/>', tags[0].getName(), tags[0].getContent());

Cầu thủ trả bóng

HtmlOutputMetaTag[] – Một mảng các đối tượng đại diện cho thẻ meta đã được thêm vào trang bằng cách gọi addMetaTag(name, content).


getTitle()

Lấy tiêu đề của trang đầu ra. Lưu ý rằng <title> Phần tử HTML bị bỏ qua.

var output = HtmlService.createHtmlOutput('<b>Hello, world!</b>');
Logger.log(output.getTitle());

Cầu thủ trả bóng

String — Tiêu đề của trang.


getWidth()

Lấy chiều rộng ban đầu của hộp thoại tuỳ chỉnh trong Google Tài liệu, Trang tính hoặc Biểu mẫu. Nếu HtmlOutput được xuất bản dưới dạng một ứng dụng web, thì phương thức trả về null. Để đổi kích thước hộp thoại đã mở, hãy gọi google.script.host.setWidth(width) trong mã phía máy khách.

var output = HtmlService.createHtmlOutput('<b>Hello, world!</b>');
output.setWidth(200);
Logger.log(output.getWidth());

Cầu thủ trả bóng

Integer – Chiều rộng tính bằng pixel.


setContent(content)

Thiết lập nội dung của HtmlOutput này.

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

Tham số

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

Cầu thủ trả bóng

HtmlOutput – Kết quả này để tạo chuỗi.

Gửi

Error – nếu HTML không đúng định dạng


setFaviconUrl(iconUrl)

Thêm một thẻ liên kết cho biểu tượng trang web vào trang. Thẻ liên kết biểu tượng trang web được đưa trực tiếp vào Ứng dụng Tệp HTML tập lệnh sẽ bị bỏ qua.

var output = HtmlService.createHtmlOutput('<b>Hello, world!</b>');
output.setFaviconUrl('http://www.example.com/image.png');

Tham số

TênLoạiMô tả
iconUrlStringURL của hình ảnh biểu tượng trang web, với phần mở rộng hình ảnh cho biết hình ảnh loại.

Cầu thủ trả bóng

HtmlOutput – Kết quả này để tạo chuỗi.


setHeight(height)

Đặt chiều cao ban đầu của hộp thoại tuỳ chỉnh trong Google Tài liệu, Trang tính hoặc Biểu mẫu. Nếu HtmlOutput được xuất bản dưới dạng một ứng dụng web, thì không có tác dụng. Để đổi kích thước hộp thoại đã mở, hãy gọi google.script.host.setHeight(height) trong mã phía máy khách.

var output = HtmlService.createHtmlOutput('<b>Hello, world!</b>');
output.setHeight(200);

Tham số

TênLoạiMô tả
heightIntegerChiều cao mới tính bằng pixel; null dẫn đến giá trị mặc định.

Cầu thủ trả bóng

HtmlOutput – Kết quả này để tạo chuỗi.


setSandboxMode(mode)

Phương thức này hiện không có hiệu lực — trước đây, phương thức này đặt sandbox mode được dùng cho các tập lệnh phía máy khách. Để bảo vệ người dùng khỏi bị phân phát HTML độc hại hoặc JavaScript, mã phía máy khách được cung cấp từ dịch vụ HTML sẽ thực thi trong hộp cát bảo mật áp dụng các hạn chế đối với mã. Ban đầu, phương thức này cho phép tác giả tập lệnh chọn giữa các phiên bản khác nhau của hộp cát, nhưng giờ đây tất cả tập lệnh đều sử dụng chế độ IFRAME bất kể chế độ hộp cát được thiết lập là gì. Để biết thêm thông tin, hãy xem hướng dẫn về các hạn chế trong dịch vụ HTML.

Chế độ IFRAME áp dụng ít hạn chế hơn so với các chế độ hộp cát khác và chạy nhanh nhất, nhưng hoàn toàn không hoạt động ở một số trình duyệt cũ hơn, bao gồm Internet Explorer 9. Bạn có thể đọc chế độ hộp cát trong tập lệnh phía máy khách bằng cách kiểm tra google.script.sandbox.mode. Xin lưu ý rằng thuộc tính này trả về chế độ thực tế trên ứng dụng, có thể khác với chế độ được yêu cầu trên máy chủ nếu chế độ bạn yêu cầu không được hỗ trợ trong trình duyệt của người dùng.

<!-- Read the sandbox mode (in a client-side script). -->
<script>
  alert(google.script.sandbox.mode);
</script>

Tham số

TênLoạiMô tả
modeSandboxModeChế độ hộp cát để sử dụng.

Cầu thủ trả bóng

HtmlOutput – Kết quả này để tạo chuỗi.


setTitle(title)

Đặt tiêu đề của trang đầu ra. Đối với ứng dụng web, đây là tiêu đề của toàn bộ trang, trong khi cho HtmlOutput hiển thị trong Google Trang tính, đây là tiêu đề hộp thoại.

var output = HtmlService.createHtmlOutput('<b>Hello, world!</b>');
output.setTitle('My First Page');

Tham số

TênLoạiMô tả
titleStringTiêu đề mới.

Cầu thủ trả bóng

HtmlOutput – Kết quả này để tạo chuỗi.


setWidth(width)

Đặt chiều rộng ban đầu của hộp thoại tuỳ chỉnh trong Google Tài liệu, Trang tính hoặc Biểu mẫu. Nếu HtmlOutput được xuất bản dưới dạng một ứng dụng web, thì không có tác dụng. Để đổi kích thước hộp thoại đã mở, hãy gọi google.script.host.setWidth(width) trong mã phía máy khách.

var output = HtmlService.createHtmlOutput('<b>Hello, world!</b>');
output.setWidth(200);

Tham số

TênLoạiMô tả
widthIntegerChiều rộng mới tính bằng pixel; null dẫn đến giá trị mặc định.

Cầu thủ trả bóng

HtmlOutput – Kết quả này để tạo chuỗi.


setXFrameOptionsMode(mode)

Đặt trạng thái cho tiêu đề X-Frame-Options của trang để kiểm soát hoạt động nhấp chuột phòng ngừa.

Việc đặt XFrameOptionsMode.ALLOWALL cho phép mọi trang web tạo iframe cho trang, vì vậy, nhà phát triển nên triển khai biện pháp bảo vệ của riêng họ khỏi hành vi tấn công giả mạo.

Nếu một tập lệnh không đặt chế độ X-Frame-Options, thì Apps Script sẽ dùng chế độ XFrameOptionsMode.DEFAULT làm chế độ mặc định.

// Serve HTML with no X-Frame-Options header (in Apps Script server-side code).
var output = HtmlService.createHtmlOutput('<b>Hello, world!</b>');
output.setXFrameOptionsMode(HtmlService.XFrameOptionsMode.ALLOWALL);

Tham số

TênLoạiMô tả
modeXFrameOptionsModeChế độ tuỳ chọn XFrame cần đặt.

Cầu thủ trả bóng

HtmlOutput – Kết quả này để tạo chuỗi.