本頁面由 Cloud Translation API 翻譯而成。

Class HtmlService

透過指令碼傳回 HTML 和其他文字內容的服務。

基於安全考量，指令碼無法直接將內容傳回瀏覽器。它們必須掃毒 HTML，而無法執行惡意動作。請參閱 HtmlOutput，瞭解這個值的限制代表可傳回的內容。

屬性

屬性	類型	說明
`SandboxMode`	`SandboxMode`	列舉代表用戶端 `HtmlService` 可使用的沙箱模式指令碼
`XFrameOptionsMode`	`XFrameOptionsMode`	列舉代表可用於用戶端 `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`	取得目前瀏覽器的使用者代理程式字串。

內容詳盡的說明文件

`createHtmlOutput()`

建立可從指令碼傳回的新 HtmlOutput 物件。

var output = HtmlService.createHtmlOutput();

回攻員

HtmlOutput：新的 HtmlOutput 物件

`createHtmlOutput(blob)`

從 BlobSource 資源建立新的 HtmlOutput 物件。

function createFromBlob(blob) {
  var output = HtmlService.createHtmlOutput(blob);
  return output;
}

參數

名稱	類型	說明
`blob`	`BlobSource`	以便取得 HTML

回攻員

HtmlOutput：新的 HtmlOutput 物件

擲回

Error：如果 blob 不包含 HTML，或是 HTML 格式錯誤

`createHtmlOutput(html)`

建立可從指令碼傳回的新 HtmlOutput 物件。

var output = HtmlService.createHtmlOutput('<b>Hello world!</b>');

參數

名稱	類型	說明
`html`	`String`	要放送的內容

回攻員

HtmlOutput：新的 HtmlOutput 物件

擲回

Error：如果 HTML 格式錯誤

`createHtmlOutputFromFile(filename)`

根據程式碼編輯器中的檔案，建立新的 HtmlOutput 物件。

var output = HtmlService.createHtmlOutputFromFile('myPage');

參數

名稱	類型	說明
`filename`	`String`	要使用的檔案名稱

回攻員

HtmlOutput：新的 HtmlOutput 物件

擲回

Error：如果找不到檔案或其中的 HTML 格式有誤

`createTemplate(blob)`

從 BlobSource 資源建立新的 HtmlTemplate 物件。

function createFromBlob(blob) {
  var template = HtmlService.createTemplate(blob);
  return output;
}

參數

名稱	類型	說明
`blob`	`BlobSource`	要取得 HTML 的物件。

回攻員

HtmlTemplate：新的 HtmlTemplate 物件

擲回

Error：如果 blob 不包含 HTML

`createTemplate(html)`

建立可從指令碼傳回的新 HtmlTemplate 物件。

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

參數

名稱	類型	說明
`html`	`String`	範本內容

回攻員

HtmlTemplate：新的 HtmlTemplate 物件

`createTemplateFromFile(filename)`

根據程式碼編輯器中的檔案，建立新的 HtmlTemplate 物件。

var template = HtmlService.createTemplateFromFile('myTemplate');

參數

名稱	類型	說明
`filename`	`String`	要使用的檔案名稱

回攻員

HtmlTemplate：新的 HtmlTemplate 物件

擲回

Error：找不到檔案

`getUserAgent()`

取得目前瀏覽器的使用者代理程式字串。針對大部分指令碼傳回 null 如果未用於網頁應用程式的 doGet() 或 doPost() 函式，就會執行。

回攻員

String：使用者代理程式字串