此页面由 Cloud Translation API 翻译。

HTML Service

此服务允许 Apps 脚本应用返回 HTML（通常作为界面）。如果您是第一次使用此类，我们还建议您查看 HTML 服务指南

类

名称	简介
`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`	向网页添加网站图标的链接标记。
`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` 标头设置默认值，以保留一般的安全假设。