Class HtmlTemplate

HtmlTemplate

HTML を動的に作成するためのテンプレート オブジェクト。詳しくは、テンプレートのガイドをご覧ください。

Methods

メソッド戻り値の型概要
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'.
var 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() メソッドを使用することをおすすめします。

var 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() メソッドを使用することをおすすめします。

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

リターン

String - 評価可能なテンプレートに基づく文字列


getRawContent()

このテンプレートの未処理のコンテンツを返します。

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

リターン

String - テンプレートの未加工コンテンツ