Class HtmlOutput

向网页添加元标记。系统会忽略直接在 Apps Script HTML 文件中添加的元标记。仅允许使用以下元标记：

const output = HtmlService.createHtmlOutput('Hello, world!');
output.addMetaTag('viewport', 'width=device-width, initial-scale=1');

参数

返回

HtmlOutput - 此输出，用于链式调用。

将新内容附加到此 HtmlOutput 的内容。请仅对来自可信来源的内容使用此属性，因为它未经转义。

// Log "Hello, world!
Hello again, world.
"
const output = HtmlService.createHtmlOutput('Hello, world!');
output.append('
Hello again, world.
');
Logger.log(output.getContent());

参数

返回

HtmlOutput - 此输出，用于链式调用。

抛出

Error - 如果 HTML 格式错误

另请参阅

• appendUntrusted(addedContent)

使用上下文转义将新内容附加到此 HtmlOutput 的内容。

此方法会根据 HtmlOutput 的当前状态正确转义内容，以便生成不含标记或副作用的安全字符串。每当您要添加来自不可信来源（例如用户）的内容时，请使用此方法，而不是使用 append 方法，以免意外允许出现跨站脚本攻击 (XSS) 错误，即您附加的内容或标记导致意外代码执行。

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

参数

返回

HtmlOutput - 此输出，用于链式调用。

抛出

Error - 如果 HTML 格式非常不当

另请参阅

• append(addedContent)

返回由此 HtmlOutput 支持的 HtmlTemplate。此方法可用于增量构建模板。对 HtmlOutput 进行的未来更改也会影响 HtmlTemplate 的内容。

const output = HtmlService.createHtmlOutput('Hello, world!');
const template = output.asTemplate();

返回

HtmlTemplate - 新的 HtmlTemplate。

清除当前内容。

const output = HtmlService.createHtmlOutput('Hello, world!');
output.clear();

返回

HtmlOutput - 此输出，用于链式调用。

将此对象内的数据作为转换为指定内容类型的 blob 返回。此方法会向文件名添加相应的扩展名，例如“myfile.pdf”。不过，它假定文件名最后一个英文句点（如果有）后面的部分是应替换的现有扩展名。因此，“ShoppingList.12.25.2014”会变为“ShoppingList.12.25.pdf”。

如需查看转化每日配额，请参阅 Google 服务的配额。新创建的 Google Workspace 网域可能会暂时受到更严格的配额限制。

参数

返回

Blob - 数据（以 blob 的形式）。

以 blob 的形式返回此对象内的数据。

返回

Blob - 数据（以 blob 的形式）。

获取此 HtmlOutput 的内容。

// Log "Hello, world!"
const output = HtmlService.createHtmlOutput('Hello, world!');
Logger.log(output.getContent());

返回

String - 要投放的内容。

通过调用 setFaviconUrl(iconUrl) 获取添加到网页的网站图标链接标记的网址。系统会忽略直接在 Apps Script HTML 文件中包含的图标链接标记。

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

返回

String - 网站图标图片的网址。

获取 Google 文档、表格或表单中自定义对话框的初始高度。如果 HtmlOutput 改为以 Web 应用的形式发布，此方法会返回 null。如需调整已打开的对话框的大小，请在客户端代码中调用 google.script.host.setHeight(height)。

const output = HtmlService.createHtmlOutput('Hello, world!');
output.setHeight(200);
Logger.log(output.getHeight());

返回

Integer - 高度（以像素为单位）。

获取一个对象数组，该数组表示通过调用 addMetaTag(name, content) 添加到网页的元标记。系统会忽略直接在 Apps Script HTML 文件中添加的元标记。

const output = HtmlService.createHtmlOutput('Hello, world!');
output.addMetaTag('viewport', 'width=device-width, initial-scale=1');

const tags = output.getMetaTags();
Logger.log(
    '',
    tags[0].getName(),
    tags[0].getContent(),
);

返回

HtmlOutputMetaTag[] - 一组对象，表示通过调用 addMetaTag(name, content) 添加到网页的元标记。

获取输出页面的标题。请注意，