Class HtmlOutput

Fügt der Seite ein Meta-Tag hinzu. Meta-Tags, die direkt in eine Apps Script-HTML-Datei eingefügt werden, werden ignoriert. Nur die folgenden Meta-Tags sind zulässig:

<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');

Parameter

Rückflug

HtmlOutput: Diese Ausgabe zur Verkettung.

Hängt neuen Inhalt an den Inhalt von HtmlOutput an. Verwenden Sie diese Option nur für Inhalte aus einem vertrauenswürdigen Quelle, da sie nicht mit einem Escapezeichen versehen ist.

// 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());

Parameter

Rückflug

HtmlOutput: Diese Ausgabe zur Verkettung.

Löst aus

Error, wenn der HTML-Code fehlerhaft ist

Weitere Informationen

• appendUntrusted(addedContent)

Hängt mithilfe von kontextbezogenem Escaping neuen Content an den Inhalt von HtmlOutput an.

Diese Methode maskiert Inhalte auf Grundlage des aktuellen Status von HtmlOutput korrekt. damit das Ergebnis ein sicherer String ohne Markup oder Nebenwirkungen ist. Verwenden Sie diese anstelle von Fügen Sie Inhalte aus einer nicht vertrauenswürdigen Quelle, z. B. von einem Nutzer, hinzu, um zu vermeiden, Sie haben versehentlich XSS-Fehler (Cross-Site-Scripting) zugelassen, bei dem Inhalte oder Markups führt zu einer unerwarteten Codeausführung.

// 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());

Parameter

Rückflug

HtmlOutput: Diese Ausgabe zur Verkettung.

Löst aus

Error, wenn der HTML-Code sehr fehlerhaft ist

Weitere Informationen

• append(addedContent)

Gibt ein HtmlTemplate zurück, das durch diesen HtmlOutput gestützt wird. Diese Methode kann verwendet werden, um um eine Vorlage inkrementell zu erstellen. Zukünftige Änderungen an HtmlOutput wirken sich auf den Inhalt von die HtmlTemplate ebenfalls.

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

Rückflug

HtmlTemplate – Das neue HtmlTemplate.

Löscht den aktuellen Inhalt.

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

Rückflug

HtmlOutput: Diese Ausgabe zur Verkettung.

Gibt die Daten in diesem Objekt als Blob zurück, das in den angegebenen Inhaltstyp konvertiert wurde. Dieses fügt dem Dateinamen die entsprechende Erweiterung hinzu, beispielsweise "meinedatei.pdf". Allerdings geht davon aus, dass der Teil des Dateinamens, der auf den letzten Punkt folgt (falls vorhanden), ein vorhandener die ersetzt werden soll. Daher lautet „Einkaufsliste.12.25.2014“. wird zu „Einkaufsliste.12.25.pdf“.

Die Tageskontingente für Conversions finden Sie unter Kontingente für Google Dienste. Neu erstellte Google Workspace-Domains unterliegen möglicherweise vorübergehend strengeren Richtlinien. Kontingenten.

Parameter

Rückflug

Blob: Die Daten als Blob.

Gibt die Daten in diesem Objekt als Blob zurück.

Rückflug

Blob: Die Daten als Blob.

Ruft den Inhalt von HtmlOutput ab.

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

Rückflug

String: Der bereitgestellte Inhalt.

Ruft die URL für ein Favicon-Link-Tag ab, das der Seite durch Aufrufen von setFaviconUrl(iconUrl) hinzugefügt wurde. Favicon-Link-Tags, die direkt in eine Apps Script-HTML-Datei eingefügt werden, sind ignoriert.

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

Rückflug

String: Die URL des Favicon-Bilds.

Ruft die anfängliche Höhe des benutzerdefinierten Dialogfelds in Google ab Google Docs, Google Tabellen oder Google Formulare. Wenn die HtmlOutput stattdessen als Web-App veröffentlicht wird, gibt null zurück. Zum Anpassen der Größe eines Dialogfelds, das bereits geöffnet ist, rufen Sie auf. google.script.host.setHeight(height) im clientseitigen Code.

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

Rückflug

Integer: Die Höhe in Pixeln.

Ruft ein Array mit Objekten ab, die Meta-Tags darstellen, die durch Aufrufen von addMetaTag(name, content) zur Seite hinzugefügt wurden. Meta-Tags, die direkt in eine Apps Script-HTML-Datei eingefügt werden, werden ignoriert.

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());

Rückflug

HtmlOutputMetaTag[]: Ein Array von Objekten, die Meta-Tags darstellen, die durch Aufrufen von addMetaTag(name, content) in die Seite eingefügt wurden.

Ruft den Titel der Ausgabeseite ab. Beachten Sie, dass der <title> Das HTML-Element wird ignoriert.

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

Rückflug

String: Der Titel der Seite.

Ruft die anfängliche Breite des benutzerdefinierten Dialogfelds in Google ab. Google Docs, Google Tabellen oder Google Formulare. Wenn die HtmlOutput stattdessen als Web-App veröffentlicht wird, gibt null zurück. Zum Anpassen der Größe eines Dialogfelds, das bereits geöffnet ist, rufen Sie auf. google.script.host.setWidth(width) im clientseitigen Code.

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

Rückflug

Integer: Die Breite in Pixeln.

Legt den Inhalt von HtmlOutput fest.

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

Parameter

Rückflug

HtmlOutput: Diese Ausgabe zur Verkettung.

Löst aus

Error, wenn der HTML-Code fehlerhaft ist

Fügt der Seite ein Link-Tag für ein Favicon hinzu. Favicon-Link-Tags werden direkt in eine App eingefügt. Script-HTML-Datei wird ignoriert.

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

Parameter

Rückflug

HtmlOutput: Diese Ausgabe zur Verkettung.

Legt die anfängliche Höhe des benutzerdefinierten Dialogfelds in Google fest Google Docs, Google Tabellen oder Google Formulare. Wenn die HtmlOutput stattdessen als Web-App veröffentlicht wird, hat keine Auswirkungen. Zum Anpassen der Größe eines Dialogfelds, das bereits geöffnet ist, rufen Sie auf. google.script.host.setHeight(height) im clientseitigen Code.

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

Parameter

Rückflug

HtmlOutput: Diese Ausgabe zur Verkettung.

Diese Methode hat jetzt keine Auswirkungen. Zuvor wurde das sandbox mode festgelegt, das für clientseitige Skripts verwendet wurde. Um Nutzer vor schädlichem HTML-Code oder JavaScript-Code, clientseitiger Code aus dem HTML-Dienst, wird in einer Sicherheits-Sandbox ausgeführt, legt Einschränkungen für den Code fest. Ursprünglich ließ sich mit dieser Methode zwischen verschiedenen Versionen der Sandbox zu wechseln, aber jetzt verwenden alle Skripts jetzt den IFRAME-Modus unabhängig davon, welchen Sandbox-Modus festgelegt ist. Weitere Informationen finden Sie im Leitfaden zu Einschränkungen beim HTML-Dienst.

Der IFRAME-Modus hat viel weniger Einschränkungen als die anderen Sandbox-Modi und wird am schnellsten ausgeführt, funktioniert jedoch bei bestimmten älteren Browsern, einschließlich Internet Explorer, überhaupt nicht. 9. Der Sandbox-Modus kann durch Prüfen von google.script.sandbox.mode in einem clientseitigen Script gelesen werden. Dieses Attribut gibt den tatsächlichen Modus auf dem Client zurück. Er kann sich von dem vom Server angeforderten Modus unterscheiden, wenn er nicht unterstützt wird. im Browser des Nutzers.

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

Parameter

Rückflug

HtmlOutput: Diese Ausgabe zur Verkettung.

Legt den Titel der Ausgabeseite fest. Bei Web-Apps ist dies der Titel der gesamten Seite, während Für HtmlOutput in Google Tabellen ist dies der Titel des Dialogfelds.

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

Parameter

Rückflug

HtmlOutput: Diese Ausgabe zur Verkettung.

Legt die anfängliche Breite eines benutzerdefinierten Dialogfelds in Google fest Google Docs, Google Tabellen oder Google Formulare. Wenn die HtmlOutput stattdessen als Web-App veröffentlicht wird, hat keine Auswirkungen. Zum Anpassen der Größe eines Dialogfelds, das bereits geöffnet ist, rufen Sie auf. google.script.host.setWidth(width) im clientseitigen Code.

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

Parameter

Rückflug

HtmlOutput: Diese Ausgabe zur Verkettung.

Legt den Status des X-Frame-Options-Headers der Seite fest, der das Clickjacking steuert Prävention.

Wenn XFrameOptionsMode.ALLOWALL festgelegt ist, kann die Seite von jeder Website in einem iFrame gehostet werden, sodass das Entwickler sollten eigene Schutzvorkehrungen gegen Clickjacking implementieren.

Wenn ein Skript keinen X-Frame-Options-Modus festlegt, verwendet Apps Script den XFrameOptionsMode.DEFAULT-Modus als Standard.

// 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);

Parameter

Rückflug

HtmlOutput: Diese Ausgabe zur Verkettung.