此页面由 Cloud Translation API 翻译。

HTML Service

借助此服务，Apps Script 应用可以返回 HTML，通常以界面的形式返回。如果您刚开始使用此类，我们建议您同时参阅 Html Service 指南

类

名称	简介
`HtmlOutput`	可从脚本提供的 `HtmlOutput` 对象。
`HtmlOutputMetaTag`	一个对象，表示通过调用 `HtmlOutput.addMetaTag(name, content)` 添加到网页中的元标记。
`HtmlService`	用于从脚本返回 HTML 和其他文本内容的服务。
`HtmlTemplate`	用于动态构建 HTML 的模板对象。
`SandboxMode`	一个枚举，表示可用于客户端 `HtmlService` 脚本的沙盒模式。
`XFrameOptionsMode`	一个枚举，表示可用于客户端 `HtmlService` 脚本的 `X-Frame-Options` 模式。

`HtmlOutput`

方法

方法	返回类型	简介
`addMetaTag(name, content)`	`HtmlOutput`	向网页添加元标记。
`append(addedContent)`	`HtmlOutput`	将新内容附加到此 `HtmlOutput` 的内容。
`appendUntrusted(addedContent)`	`HtmlOutput`	使用上下文转义将新内容附加到此 `HtmlOutput` 的内容。
`asTemplate()`	`HtmlTemplate`	返回由此 `HtmlOutput` 支持的 `HtmlTemplate`。
`clear()`	`HtmlOutput`	清除当前内容。
`getAs(contentType)`	`Blob`	将此对象内的数据作为转换为指定内容类型的 blob 返回。
`getBlob()`	`Blob`	以 blob 的形式返回此对象内的数据。
`getContent()`	`String`	获取此 `HtmlOutput` 的内容。
`getFaviconUrl()`	`String`	通过调用 `setFaviconUrl(iconUrl)` 获取添加到网页的网站图标链接标记的网址。
`getHeight()`	`Integer`	获取 Google 文档、表格或表单中自定义对话框的初始高度。
`getMetaTags()`	`HtmlOutputMetaTag[]`	获取一个对象数组，该数组表示通过调用 `addMetaTag(name, content)` 添加到网页的元标记。
`getTitle()`	`String`	获取输出页面的标题。
`getWidth()`	`Integer`	获取 Google 文档、表格或表单中自定义对话框的初始宽度。
`setContent(content)`	`HtmlOutput`	设置此 `HtmlOutput` 的内容。
`setFaviconUrl(iconUrl)`	`HtmlOutput`	向网页添加了用于显示 Favicon 的链接标记。
`setHeight(height)`	`HtmlOutput`	设置 Google 文档、表格或表单中自定义对话框的初始高度。
`setSandboxMode(mode)`	`HtmlOutput`	此方法现在没有任何影响，之前它会设置用于客户端脚本的 `sandbox mode`。
`setTitle(title)`	`HtmlOutput`	设置输出页面的标题。
`setWidth(width)`	`HtmlOutput`	设置 Google 文档、表格或表单中自定义对话框的初始宽度。
`setXFrameOptionsMode(mode)`	`HtmlOutput`	设置网页的 `X-Frame-Options` 标头的状态，该状态用于控制防范点击盗用。

`HtmlOutputMetaTag`

方法

方法	返回类型	简介
`getContent()`	`String`	获取此元标记的内容。
`getName()`	`String`	获取此 `HtmlOutputMetaTag` 的名称。

`HtmlService`

属性

属性	类型	说明
`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`	获取当前浏览器的用户代理字符串。

`HtmlTemplate`

方法

方法	返回类型	简介
`evaluate()`	`HtmlOutput`	评估此模板并返回 `HtmlOutput` 对象。
`getCode()`	`String`	根据模板文件生成可评估的 JavaScript 代码字符串。
`getCodeWithComments()`	`String`	生成可评估的 JavaScript 代码字符串，其中代码的每一行都包含模板中的原始行作为注释。
`getRawContent()`	`String`	返回此模板的未处理内容。

`SandboxMode`

属性

属性	类型	说明
`EMULATED`	`Enum`	一种旧版沙盒模式，仅使用 ECMAScript 3 中提供的功能来模拟 ECMAScript 5 严格模式。
`IFRAME`	`Enum`	一种沙盒模式，使用 iframe 沙盒化（而非 `EMULATED` 和 `NATIVE` 模式使用的 Caja 沙盒技术）。
`NATIVE`	`Enum`	一种沙盒模式，基于 ECMAScript 5 严格模式构建而成。

`XFrameOptionsMode`

属性

属性	类型	说明
`ALLOWALL`	`Enum`	系统不会设置任何 `X-Frame-Options` 标头。
`DEFAULT`	`Enum`	设置 `X-Frame-Options` 标头的默认值，以保留正常的安全假设。