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());  // logs '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 - 範本的原始內容。