Questa pagina è stata tradotta dall'API Cloud Translation.

Class 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. Deve invece eseguire la sanitizzazione del codice HTML in modo che non possa eseguire azioni dannose. Consulta la descrizione di HtmlOutput per conoscere le limitazioni relative a ciò che può essere restituito.

Proprietà

Proprietà	Tipo	Descrizione
`SandboxMode`	`SandboxMode`	Un enum che rappresenta le modalità di 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`	Recupera la stringa user agent del browser corrente.

Documentazione dettagliata

`createHtmlOutput()`

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

const output = HtmlService.createHtmlOutput();

Invio

HtmlOutput: il nuovo oggetto HtmlOutput

`createHtmlOutput(blob)`

Crea un nuovo oggetto HtmlOutput da una risorsa BlobSource.

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

Parametri

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

Invio

HtmlOutput: il nuovo oggetto HtmlOutput

Lanci

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

`createHtmlOutput(html)`

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

const 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 codice HTML non è corretto

`createHtmlOutputFromFile(filename)`

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

const 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 è formattato correttamente

`createTemplate(blob)`

Crea un nuovo oggetto HtmlTemplate da una risorsa BlobSource.

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

Parametri

Nome	Tipo	Descrizione
`blob`	`BlobSource`	L'oggetto da cui estrarre il codice 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.

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

const 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()`

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

Invio

String: la stringa dello user agent