Questa pagina è stata tradotta dall'API Cloud Translation.

Class 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.