Class HtmlService

HtmlService

Servizio per restituire HTML e altri contenuti di testo da uno script.

Per motivi di sicurezza, gli script non possono restituire direttamente i contenuti a un browser. Devono invece sanitizzare il codice HTML in modo da non poter eseguire azioni dannose. Consulta la descrizione di HtmlOutput per conoscere le limitazioni che ciò comporta riguardo a ciò che può essere restituito.

Proprietà

Proprietà	Tipo	Descrizione
SandboxMode	SandboxMode	Un'enum che rappresenta le modalità sandbox che possono essere utilizzate per gli script HtmlService lato client.
XFrameOptionsMode	XFrameOptionsMode	Un'enum che rappresenta le modalità X-Frame-Options che possono essere utilizzate per gli script HtmlService lato client.

Metodi

Metodo	Tipo restituito	Breve descrizione
createHtmlOutput()	HtmlOutput	Crea un nuovo oggetto HtmlOutput che può essere restituito dallo script.
createHtmlOutput(blob)	HtmlOutput	Crea un nuovo oggetto HtmlOutput da una risorsa BlobSource.
createHtmlOutput(html)	HtmlOutput	Crea un nuovo oggetto HtmlOutput che può essere restituito dallo script.
createHtmlOutputFromFile(filename)	HtmlOutput	Crea un nuovo oggetto HtmlOutput da un file nell'editor di codice.
createTemplate(blob)	HtmlTemplate	Crea un nuovo oggetto HtmlTemplate da una risorsa BlobSource.
createTemplate(html)	HtmlTemplate	Crea un nuovo oggetto HtmlTemplate che può essere restituito dallo script.
createTemplateFromFile(filename)	HtmlTemplate	Crea un nuovo oggetto HtmlTemplate da un file nell'editor di codice.
getUserAgent()	String	Restituisce la stringa user agent per il browser corrente.

Documentazione dettagliata

createHtmlOutput()

Crea un nuovo oggetto HtmlOutput che può essere restituito dallo script.

var output = HtmlService.createHtmlOutput();

Ritorni

HtmlOutput: il nuovo oggetto HTMLOutput

---

createHtmlOutput(blob)

Crea un nuovo oggetto HtmlOutput da una risorsa BlobSource.

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

Parametri

Nome	Tipo	Descrizione
blob	BlobSource	l'oggetto da cui estrarre il codice HTML

Ritorni

HtmlOutput: il nuovo oggetto HtmlOutput

Tiri

Error: se il blob non contiene HTML o se l'HTML non è corretto

---

createHtmlOutput(html)

Crea un nuovo oggetto HtmlOutput che può essere restituito dallo script.

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

Parametri

Nome	Tipo	Descrizione
html	String	i contenuti da pubblicare

Ritorni

HtmlOutput: il nuovo oggetto HTMLOutput

Tiri

Error: se il formato del codice HTML non è corretto

---

createHtmlOutputFromFile(filename)

Crea un nuovo oggetto HtmlOutput da un file nell'editor di codice.

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

Parametri

Nome	Tipo	Descrizione
filename	String	il nome del file da utilizzare

Ritorni

HtmlOutput: il nuovo oggetto HtmlOutput

Tiri

Error: se il file non è stato trovato o se il formato del codice HTML è errato

---

createTemplate(blob)

Crea un nuovo oggetto HtmlTemplate da una risorsa BlobSource.

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

Parametri

Nome	Tipo	Descrizione
blob	BlobSource	L'oggetto da cui estrarre il codice HTML.

Ritorni

HtmlTemplate: il nuovo oggetto HtmlTemplate

Tiri

Error: se il blob non contiene HTML

---

createTemplate(html)

Crea un nuovo oggetto HtmlTemplate che può essere restituito dallo script.

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

Parametri

Nome	Tipo	Descrizione
html	String	i contenuti del modello

Ritorni

HtmlTemplate: il nuovo oggetto HtmlTemplate

---

createTemplateFromFile(filename)

Crea un nuovo oggetto HtmlTemplate da un file nell'editor di codice.

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

Parametri

Nome	Tipo	Descrizione
filename	String	il nome del file da utilizzare

Ritorni

HtmlTemplate: il nuovo oggetto HtmlTemplate

Tiri

Error: se il file non è stato trovato.

---

getUserAgent()

Restituisce la stringa user agent per il browser corrente. Restituisce null per la maggior parte delle esecuzioni degli script se non viene utilizzato nella funzione doGet() o doPost() di un'app web.

Ritorni

String: la stringa dello user agent