Class HtmlOutput

Aggiunge un meta tag alla pagina. I meta tag inclusi direttamente in un file HTML Apps Script ignorato. Sono consentiti solo i seguenti meta tag:

<meta name="apple-mobile-web-app-capable" content="..."/>
<meta name="google-site-verification" content="..."/>
<meta name="mobile-web-app-capable" content="..."/>
<meta name="viewport" content="..."/>

var output = HtmlService.createHtmlOutput('<b>Hello, world!</b>');
output.addMetaTag('viewport', 'width=device-width, initial-scale=1');

Parametri

Invio

HtmlOutput: output, per il concatenamento.

Aggiunge nuovi contenuti ai contenuti di questo HtmlOutput. Utilizza questa opzione solo per i contenuti provenienti da una fonte attendibile, perché non contiene caratteri di escape.

// Log "<b>Hello, world!</b><p>Hello again, world.</p>"
var output = HtmlService.createHtmlOutput('<b>Hello, world!</b>');
output.append('<p>Hello again, world.</p>');
Logger.log(output.getContent());

Parametri

Invio

HtmlOutput: output, per il concatenamento.

Lanci

Error: se il formato HTML non è valido

Vedi anche

• appendUntrusted(addedContent)

Aggiunge nuovi contenuti ai contenuti di questo HtmlOutput utilizzando l'interpretazione letterale contestuale.

Questo metodo esegue correttamente l'interpretazione letterale dei contenuti in base allo stato attuale dell'elemento HtmlOutput, in modo che il risultato sia una stringa sicura senza markup o effetto collaterale. Usa questo invece di usare aggiungi ogni volta che aggiungi contenuti da una fonte non attendibile, ad esempio da un utente, per evitare consentendo accidentalmente un bug cross-site scripting (XSS) in cui i contenuti o il markup che aggiungi causa un'esecuzione imprevista del codice.

// Log "<b>Hello, world!</b>&lt;p&gt;Hello again, world.&lt;/p&gt;"
var output = HtmlService.createHtmlOutput('<b>Hello, world!</b>');
output.appendUntrusted('<p>Hello again, world.</p>');
Logger.log(output.getContent());

Parametri

Invio

HtmlOutput: output, per il concatenamento.

Lanci

Error: se il formato HTML non è valido

Vedi anche

• append(addedContent)

Restituisce un valore HtmlTemplate supportato da HtmlOutput. Questo metodo può essere utilizzato creare un modello in modo incrementale. Le modifiche future a HtmlOutput influiranno sui contenuti di HtmlTemplate.

var output = HtmlService.createHtmlOutput('<b>Hello, world!</b>');
var template = output.asTemplate();

Invio

HtmlTemplate: il nuovo HtmlTemplate.

Cancella i contenuti correnti.

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

Invio

HtmlOutput: output, per il concatenamento.

Restituisce i dati all'interno di questo oggetto come blob convertito nel tipo di contenuto specificato. Questo aggiunge l'estensione appropriata al nome del file, ad esempio "miofile.pdf". Tuttavia, presuppone che la parte del nome file che segue l'ultimo punto (se presente) sia una un'estensione che deve essere sostituita. Di conseguenza, "ShoppingList.25.12.2014" diventa "ShoppingList.12.25.pdf".

Per visualizzare le quote giornaliere per le conversioni, consulta Quote per Google Servizi. I domini Google Workspace appena creati potrebbero essere temporaneamente soggetti a restrizioni quote.

Parametri

Invio

Blob: i dati come blob.

Restituisce i dati all'interno dell'oggetto sotto forma di blob.

Invio

Blob: i dati come blob.

Recupera i contenuti di HtmlOutput.

// Log "<b>Hello, world!</b>"
var output = HtmlService.createHtmlOutput('<b>Hello, world!</b>');
Logger.log(output.getContent());

Invio

String: i contenuti pubblicati.

Recupera l'URL per un tag link della favicon aggiunto alla pagina chiamando setFaviconUrl(iconUrl). I tag link favicon inclusi direttamente in un file HTML Apps Script ignorato.

var output = HtmlService.createHtmlOutput('<b>Hello, world!</b>');
output.setFaviconUrl('http://www.example.com/image.png');
Logger.log(output.getFaviconUrl());

Invio

String: l'URL dell'immagine della favicon.

Consente di ottenere l'altezza iniziale della finestra di dialogo personalizzata in Google Documenti, Fogli o Moduli. Se invece HtmlOutput viene pubblicata come app web, restituisce null. Per ridimensionare una finestra di dialogo già aperta, chiama google.script.host.setHeight(height) nel codice lato client.

var output = HtmlService.createHtmlOutput('<b>Hello, world!</b>');
output.setHeight(200);
Logger.log(output.getHeight());

Invio

Integer: l'altezza in pixel.

Ottiene un array di oggetti che rappresentano i meta tag aggiunti alla pagina chiamando addMetaTag(name, content). I meta tag inclusi direttamente in un file HTML Apps Script ignorato.

var output = HtmlService.createHtmlOutput('<b>Hello, world!</b>');
output.addMetaTag('viewport', 'width=device-width, initial-scale=1');

var tags = output.getMetaTags();
Logger.log('<meta name="%s" content="%s"/>', tags[0].getName(), tags[0].getContent());

Invio

HtmlOutputMetaTag[]: un array di oggetti che rappresentano i meta tag aggiunti alla pagina richiamando addMetaTag(name, content).

Restituisce il titolo della pagina di output. Nota che l'elemento <title> L'elemento HTML viene ignorato.

var output = HtmlService.createHtmlOutput('<b>Hello, world!</b>');
Logger.log(output.getTitle());

Invio

String: il titolo della pagina.

Ottiene la larghezza iniziale della finestra di dialogo personalizzata in Google Documenti, Fogli o Moduli. Se invece HtmlOutput viene pubblicata come app web, restituisce null. Per ridimensionare una finestra di dialogo già aperta, chiama google.script.host.setWidth(width) nel codice lato client.

var output = HtmlService.createHtmlOutput('<b>Hello, world!</b>');
output.setWidth(200);
Logger.log(output.getWidth());

Invio

Integer: la larghezza in pixel.

Imposta i contenuti di questo campo HtmlOutput.

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

Parametri

Invio

HtmlOutput: output, per il concatenamento.

Lanci

Error: se il formato HTML non è valido

Aggiunge un tag link per una favicon alla pagina. Tag link favicon inclusi direttamente in un'app I file HTML dello script vengono ignorati.

var output = HtmlService.createHtmlOutput('<b>Hello, world!</b>');
output.setFaviconUrl('http://www.example.com/image.png');

Parametri

Invio

HtmlOutput: output, per il concatenamento.

Imposta l'altezza iniziale della finestra di dialogo personalizzata in Google Documenti, Fogli o Moduli. Se invece HtmlOutput viene pubblicata come app web, non ha alcun effetto. Per ridimensionare una finestra di dialogo già aperta, chiama google.script.host.setHeight(height) nel codice lato client.

var output = HtmlService.createHtmlOutput('<b>Hello, world!</b>');
output.setHeight(200);

Parametri

Invio

HtmlOutput: output, per il concatenamento.

Questo metodo ora non ha alcun effetto: in precedenza impostava il sandbox mode utilizzato per gli script lato client. Per proteggere gli utenti da contenuti HTML dannosi o Il codice JavaScript, lato client fornito da un servizio HTML, viene eseguito in una sandbox per la sicurezza che impone restrizioni sul codice. In origine, questo metodo consentiva agli autori di script di scegliere tra diverse versioni della sandbox, ma ora tutti gli script utilizzano la modalità IFRAME a prescindere dalla modalità sandbox impostata. Per ulteriori informazioni, consulta la guida alle limitazioni del servizio HTML.

La modalità IFRAME impone molte meno limitazioni rispetto alle altre modalità sandbox e funziona più velocemente, ma non funziona affatto con alcuni browser meno recenti, tra cui Internet Explorer 9, La modalità sandbox può essere letta in uno script lato client controllando google.script.sandbox.mode. Tieni presente che questa proprietà restituisce la modalità effettiva sul client, che può essere diversa da quella richiesta sul server se la modalità richiesta non è supportata nel browser dell'utente.

<!-- Read the sandbox mode (in a client-side script). -->
<script>
  alert(google.script.sandbox.mode);
</script>

Parametri

Invio

HtmlOutput: output, per il concatenamento.

Imposta il titolo della pagina di output. Per le app web, si tratta del titolo dell'intera pagina, mentre per HtmlOutput mostrato in Fogli Google, questo è il titolo della finestra di dialogo.

var output = HtmlService.createHtmlOutput('<b>Hello, world!</b>');
output.setTitle('My First Page');

Parametri

Invio

HtmlOutput: output, per il concatenamento.

Imposta la larghezza iniziale di una finestra di dialogo personalizzata in Google Documenti, Fogli o Moduli. Se invece HtmlOutput viene pubblicata come app web, non ha alcun effetto. Per ridimensionare una finestra di dialogo già aperta, chiama google.script.host.setWidth(width) nel codice lato client.

var output = HtmlService.createHtmlOutput('<b>Hello, world!</b>');
output.setWidth(200);

Parametri

Invio

HtmlOutput: output, per il concatenamento.

Imposta lo stato dell'intestazione X-Frame-Options della pagina, che controlla il clickjacking prevenzione.

L'impostazione di XFrameOptionsMode.ALLOWALL consente a qualsiasi sito di creare un iframe della pagina, in modo che il gli sviluppatori devono implementare la propria protezione contro il clickjacking.

Se uno script non imposta una modalità X-Frame-Options, Apps Script utilizza la modalità XFrameOptionsMode.DEFAULT come predefinita.

// Serve HTML with no X-Frame-Options header (in Apps Script server-side code).
var output = HtmlService.createHtmlOutput('<b>Hello, world!</b>');
output.setXFrameOptionsMode(HtmlService.XFrameOptionsMode.ALLOWALL);

Parametri

Invio

HtmlOutput: output, per il concatenamento.