Class HtmlService

HtmlService

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

Per motivi di sicurezza, gli script non possono restituire direttamente i contenuti a un browser. Devono invece sanificare l'HTML in modo che non possa eseguire azioni dannose. Consulta la descrizione di HtmlOutput per conoscere le limitazioni che ciò comporta per i contenuti che possono essere restituiti.

Proprietà

ProprietàTipoDescrizione
SandboxModeSandboxModeUn'enumerazione che rappresenta le modalità sandbox che possono essere utilizzate per gli script HtmlService lato client.
XFrameOptionsModeXFrameOptionsModeUn'enumerazione che rappresenta le modalità X-Frame-Options che possono essere utilizzate per gli script HtmlService lato client.

Metodi

MetodoTipo restituitoBreve descrizione
createHtmlOutput()HtmlOutputCrea un nuovo oggetto HtmlOutput che può essere restituito dallo script.
createHtmlOutput(blob)HtmlOutputCrea un nuovo oggetto HtmlOutput da una risorsa BlobSource.
createHtmlOutput(html)HtmlOutputCrea un nuovo oggetto HtmlOutput che può essere restituito dallo script.
createHtmlOutputFromFile(filename)HtmlOutputCrea un nuovo oggetto HtmlOutput da un file nell'editor di codice.
createTemplate(blob)HtmlTemplateCrea un nuovo oggetto HtmlTemplate da una risorsa BlobSource.
createTemplate(html)HtmlTemplateCrea un nuovo oggetto HtmlTemplate che può essere restituito dallo script.
createTemplateFromFile(filename)HtmlTemplateCrea un nuovo oggetto HtmlTemplate da un file nell'editor di codice.
getUserAgent()StringOttiene la stringa user agent per il browser corrente.

Documentazione dettagliata

createHtmlOutput()

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

const output = HtmlService.createHtmlOutput();

Indietro

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

NomeTipoDescrizione
blobBlobSourceL'oggetto da cui estrarre l'HTML

Indietro

HtmlOutput : il nuovo oggetto HtmlOutput

Genera

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


createHtmlOutput(html)

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

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

Parametri

NomeTipoDescrizione
htmlStringI contenuti da erogare

Indietro

HtmlOutput : il nuovo oggetto HtmlOutput

Genera

Error : se l'HTML non è valido


createHtmlOutputFromFile(filename)

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

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

Parametri

NomeTipoDescrizione
filenameStringIl nome del file da utilizzare

Indietro

HtmlOutput : il nuovo oggetto HtmlOutput

Genera

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


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

NomeTipoDescrizione
blobBlobSourceL'oggetto da cui estrarre l'HTML.

Indietro

HtmlTemplate : il nuovo oggetto HtmlTemplate

Genera

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

NomeTipoDescrizione
htmlStringI contenuti del modello

Indietro

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

NomeTipoDescrizione
filenameStringIl nome del file da utilizzare

Indietro

HtmlTemplate : il nuovo oggetto HtmlTemplate

Genera

Error : se il file non è stato trovato


getUserAgent()

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

Indietro

String : la stringa user agent