Class HtmlTemplate

HtmlTemplate

用于动态构建 HTML 的模板对象。如需了解详情,请参阅模板指南

方法

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

详细文档

evaluate()

评估此模板并返回 HtmlOutput 对象。在评估时,此 HtmlTemplate 对象上设置的任何属性都将在作用域内。如需调试模板中的错误,请使用 getCode() 方法检查代码。

// A template which evaluates to whatever is bound to 'foo'.
const template = HtmlService.createTemplate('<?= foo ?>');
template.foo = 'Hello World!';
Logger.log(template.evaluate().getContent());  // will log 'Hello World!'

返回

HtmlOutput - HtmlOutput 对象


getCode()

根据模板文件生成可评估的 JavaScript 代码字符串。此方法会根据模板文件生成一串 JavaScript 代码。调用 eval(<code>) 后,系统会在运行所有嵌入式服务器脚本后返回一个包含模板内容的新 HtmlOutput 对象。生成的代码应是人类可读的,因此,如果您需要调试模板,可以调用 Logger.log(<code>) 来查看生成的内容。

评估此代码将隐式绑定当前作用域中的所有变量。一般来说,最好使用 evaluate() 方法,该方法采用了显式绑定。

const template = HtmlService.createTemplate(
    '<b>The time is &lt;?= new Date() ?&gt;</b>',
);
Logger.log(template.getCode());

返回

String - 基于模板的可评估字符串


getCodeWithComments()

生成可评估的 JavaScript 代码字符串,其中代码的每一行都包含模板中的原始行作为注释。此方法会根据模板文件生成 JavaScript 代码字符串。调用 eval(<code>) 后,系统会在运行所有嵌入式服务器脚本后返回一个包含模板内容的新 HtmlOutput 对象。生成的代码应是人类可读的,因此,如果您需要调试模板,可以调用 Logger.log(<code>) 来查看生成的内容。

评估此代码将隐式绑定当前作用域中的所有变量。一般来说,最好使用 evaluate() 方法,该方法采用了显式绑定。

const template = HtmlService.createTemplate(
    '<b>The time is &lt;?= new Date() ?&gt;</b>',
);
Logger.log(template.getCodeWithComments());

返回

String - 基于模板的可评估字符串


getRawContent()

返回此模板的未处理内容。

const template = HtmlService.createTemplate(
    '<b>The time is &lt;?= new Date() ?&gt;</b>',
);
Logger.log(template.getRawContent());

返回

String - 模板的原始内容