HTML Service

HTML

這項服務可讓 Apps Script 應用程式傳回 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在網頁中加入 Favicon 的連結標記。
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

屬性

屬性類型說明
SandboxModeSandboxMode列舉,代表可用於用戶端 HtmlService 指令碼的沙箱模式。
XFrameOptionsModeXFrameOptionsMode列舉代表可用於用戶端 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

屬性

屬性類型說明
EMULATEDEnum舊版沙箱模式,僅使用 ECMAScript 3 中提供的功能,模擬 ECMAScript 5 嚴格模式。
IFRAMEEnum沙箱模式,使用 iframe 沙箱,而非 EMULATED 和 NATIVE 模式使用的 Caja 沙箱技術。
NATIVEEnum以 ECMAScript 5 嚴格模式為基礎的沙箱模式。

XFrameOptionsMode

屬性

屬性類型說明
ALLOWALLEnum未設定 X-Frame-Options 標頭。
DEFAULTEnum設定 X-Frame-Options 標頭的預設值,保留一般安全性假設。