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 <?= new Date() ?></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