Class HtmlService

HtmlService

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

Per motivi di sicurezza, gli script non possono restituire direttamente i contenuti a un browser. Invece, occorre sanificare l'HTML in modo che non possa eseguire azioni dannose. Vedi la descrizione di HtmlOutput per conoscere le limitazioni di ciò che è possibile restituire.

Proprietà

Proprietà	Tipo	Descrizione
SandboxMode	SandboxMode	Un'enumerazione che rappresenta le modalità sandbox che possono essere utilizzate per HtmlService lato client script.
XFrameOptionsMode	XFrameOptionsMode	Un'enumerazione 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();

Invio

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	per estrarre il codice HTML

Invio

HtmlOutput: il nuovo oggetto HtmlOutput

Lanci

Error: se il blob non contiene HTML o se il codice HTML non è valido

---

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

Invio

HtmlOutput: il nuovo oggetto htmlOutput

Lanci

Error: se il formato HTML non è valido

---

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

Invio

HtmlOutput: il nuovo oggetto HtmlOutput

Lanci

Error: se il file non è stato trovato o se il codice HTML al suo interno non è valido

---

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 l'HTML.

Invio

HtmlTemplate: il nuovo oggetto HtmlTemplate

Lanci

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

Invio

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

Invio

HtmlTemplate: il nuovo oggetto HtmlTemplate

Lanci

Error: se il file non è stato trovato

---

getUserAgent()

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

Invio

String: la stringa dello user agent.