此页面由 Cloud Translation API 翻译。

Class HtmlService

用于从脚本返回 HTML 和其他文本内容的服务。

出于安全考虑，脚本不能直接将内容返回到浏览器。相反，它们必须清理 HTML，使其无法执行恶意操作。请参阅 HtmlOutput：了解这对返回内容意味着什么的限制。

属性

属性	类型	说明
`SandboxMode`	`SandboxMode`	表示可用于客户端 `HtmlService` 的沙盒模式的枚举脚本。
`XFrameOptionsMode`	`XFrameOptionsMode`	表示可用于客户端 `HtmlService` 脚本的 `X-Frame-Options` 模式的枚举。

方法

方法	返回类型	简介
`createHtmlOutput()`	`HtmlOutput`	创建可从脚本返回的新 `HtmlOutput` 对象。
`createHtmlOutput(blob)`	`HtmlOutput`	根据 `BlobSource` 资源创建新的 `HtmlOutput` 对象。
`createHtmlOutput(html)`	`HtmlOutput`	创建可从脚本返回的新 `HtmlOutput` 对象。
`createHtmlOutputFromFile(filename)`	`HtmlOutput`	基于代码编辑器中的文件创建新的 `HtmlOutput` 对象。
`createTemplate(blob)`	`HtmlTemplate`	根据 `BlobSource` 资源创建新的 `HtmlTemplate` 对象。
`createTemplate(html)`	`HtmlTemplate`	创建可从脚本返回的新 `HtmlTemplate` 对象。
`createTemplateFromFile(filename)`	`HtmlTemplate`	基于代码编辑器中的文件创建新的 `HtmlTemplate` 对象。
`getUserAgent()`	`String`	获取当前浏览器的用户代理字符串。

详细文档

`createHtmlOutput()`

创建可从脚本返回的新 HtmlOutput 对象。

var output = HtmlService.createHtmlOutput();

HtmlOutput - 新的 htmlOutput 对象

`createHtmlOutput(blob)`

根据 BlobSource 资源创建新的 HtmlOutput 对象。

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

参数

名称	类型	说明
`blob`	`BlobSource`	要从中获取 HTML 的对象

HtmlOutput - 新的 HtmlOutput 对象

抛出

Error - 如果 blob 不包含 HTML 或 HTML 格式不正确

`createHtmlOutput(html)`

创建可从脚本返回的新 HtmlOutput 对象。

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

参数

名称	类型	说明
`html`	`String`	要传送的内容

HtmlOutput - 新的 htmlOutput 对象

抛出

Error - 如果 HTML 格式不正确

`createHtmlOutputFromFile(filename)`

基于代码编辑器中的文件创建新的 HtmlOutput 对象。

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

参数

名称	类型	说明
`filename`	`String`	要使用的文件的名称

HtmlOutput - 新的 HtmlOutput 对象

抛出

Error - 如果找不到文件或其中的 HTML 格式不正确

`createTemplate(blob)`

根据 BlobSource 资源创建新的 HtmlTemplate 对象。

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

参数

名称	类型	说明
`blob`	`BlobSource`	要获取 HTML 的对象。

HtmlTemplate - 新的 HtmlTemplate 对象

抛出

Error - 如果 blob 不包含 HTML

`createTemplate(html)`

创建可从脚本返回的新 HtmlTemplate 对象。

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

参数

名称	类型	说明
`html`	`String`	模板的内容

HtmlTemplate - 新的 HtmlTemplate 对象

`createTemplateFromFile(filename)`

基于代码编辑器中的文件创建新的 HtmlTemplate 对象。

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

参数

名称	类型	说明
`filename`	`String`	要使用的文件的名称

HtmlTemplate - 新的 HtmlTemplate 对象

抛出

Error - 如果未找到文件

`getUserAgent()`

获取当前浏览器的用户代理字符串。对大多数脚本返回 null 如果未在 Web 应用的 doGet() 或 doPost() 函数中使用，则会执行。

String - 用户代理字符串