Class HtmlOutput

Fügt der Seite ein Meta-Tag hinzu. Meta-Tags, die direkt in einer Apps Script-HTML-Datei enthalten sind, 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

Zurücksenden

HtmlOutput: Diese Ausgabe zum Verketten.

Fügt neue Inhalte an den Inhalt von HtmlOutput an. Verwenden Sie diese Option nur für Inhalte aus einer vertrauenswürdigen Quelle, da sie nicht maskiert 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

Zurücksenden

HtmlOutput: Diese Ausgabe zum Verketten.

Throws

Error – wenn der HTML-Code fehlerhaft ist

Weitere Informationen

• appendUntrusted(addedContent)

Fügt neue Inhalte mit Kontext-Escape an den Inhalt von HtmlOutput an.

Bei dieser Methode werden Inhalte anhand des aktuellen Status von HtmlOutput korrekt maskiert, sodass das Ergebnis ein sicherer String ohne Markup oder Nebenwirkungen ist. Verwenden Sie diese Methode anstelle von „Anhängen“, wenn Sie Inhalte aus einer nicht vertrauenswürdigen Quelle hinzufügen, z. B. von einem Nutzer, um versehentliches Cross-Site-Scripting (XSS) zu vermeiden, wenn Inhalte oder Markups, die Sie anhängen, eine unerwartete Codeausführung verursachen.

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

Zurücksenden

HtmlOutput: Diese Ausgabe zum Verketten.

Throws

Error – wenn der HTML-Code sehr fehlerhaft ist

Weitere Informationen

• append(addedContent)

Gibt ein HtmlTemplate zurück, das von diesem HtmlOutput unterstützt wird. Mit dieser Methode kann eine Vorlage inkrementell erstellt werden. Zukünftige Änderungen an HtmlOutput wirken sich auch auf den Inhalt von HtmlTemplate aus.

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

Zurücksenden

HtmlTemplate: Das neue HtmlTemplate.

Der Inhalt wird gelöscht.

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

Zurücksenden

HtmlOutput: Diese Ausgabe zum Verketten.

Gibt die Daten in diesem Objekt als Blob zurück, das in den angegebenen Inhaltstyp konvertiert wurde. Mit dieser Methode wird dem Dateinamen die entsprechende Erweiterung hinzugefügt, z. B. "myfile.pdf". Es wird jedoch davon ausgegangen, dass der Teil des Dateinamens nach dem letzten Punkt (sofern vorhanden) eine vorhandene Erweiterung ist, die ersetzt werden sollte. Daher wird „"ShoppingList.12.25.2014"“ zu „"ShoppingList.12.25.pdf"“ geändert.

Informationen zum Anzeigen der täglichen Kontingente für Conversions finden Sie unter Kontingente für Google-Dienste. Für neu erstellte Google Workspace-Domains gelten möglicherweise vorübergehend strengere Kontingente.

Parameter

Zurücksenden

Blob: Die Daten als Blob.

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

Zurücksenden

Blob: Die Daten als Blob.

Ruft den Inhalt dieses HtmlOutput ab.

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

Zurücksenden

String: Der bereitgestellte Inhalt

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

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

Zurücksenden

String: Die URL des Favicon-Bilds.

Ruft die Anfangshöhe des benutzerdefinierten Dialogfelds in Google Docs, Google Tabellen oder Google Formulare ab. Wenn HtmlOutput stattdessen als Webanwendung veröffentlicht wird, gibt diese Methode null zurück. Wenn Sie die Größe eines bereits geöffneten Dialogfelds ändern möchten, rufen Sie im clientseitigen Code google.script.host.setHeight(height) auf.

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

Zurücksenden

Integer: Die Höhe in Pixeln.

Ruft ein Array von Objekten ab, die Meta-Tags darstellen und der Seite durch Aufrufen von addMetaTag(name, content) hinzugefügt werden. Meta-Tags, die direkt in einer Apps Script-HTML-Datei enthalten sind, 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());

Zurücksenden

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

Ruft den Titel der Ausgabeseite ab. Das HTML-Element wird ignoriert.

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

Zurücksenden

String: Der Titel der Seite.

Ruft die Anfangsbreite des benutzerdefinierten Dialogfelds in Google Docs, Google Tabellen oder Google Formulare ab. Wenn HtmlOutput stattdessen als Webanwendung veröffentlicht wird, gibt diese Methode null zurück. Wenn Sie die Größe eines bereits geöffneten Dialogfelds ändern möchten, rufen Sie im clientseitigen Code google.script.host.setWidth(width) auf.

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

Zurücksenden

Integer: Die Breite in Pixeln.

Legt den Inhalt dieses HtmlOutput fest.

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

Parameter

Zurücksenden

HtmlOutput: Diese Ausgabe zum Verketten.

Throws

Error – wenn der HTML-Code fehlerhaft ist

Fügt der Seite ein Link-Tag für ein Favicon hinzu. Favicon-Link-Tags, die direkt in einer Apps Script-HTML-Datei enthalten sind, werden ignoriert.

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

Parameter

Zurücksenden

HtmlOutput: Diese Ausgabe zum Verketten.

Legt die Anfangshöhe des benutzerdefinierten Dialogfelds in Google Docs, Google Tabellen oder Google Formulare fest. Wenn HtmlOutput stattdessen als Web-App veröffentlicht wird, hat diese Methode keine Auswirkungen. Wenn Sie die Größe eines bereits geöffneten Dialogfelds ändern möchten, rufen Sie im clientseitigen Code google.script.host.setHeight(height) auf.

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

Parameter

Zurücksenden

HtmlOutput: Diese Ausgabe zum Verketten.

Diese Methode hat nun keine Wirkung mehr. Bisher wurde die sandbox mode für clientseitige Skripts festgelegt. Damit Nutzer kein schädliches HTML oder JavaScript erhalten, wird clientseitiger Code, der vom HTML-Dienst bereitgestellt wird, in einer Sicherheits-Sandbox ausgeführt, die Einschränkungen für den Code auferlegt. Ursprünglich haben diese Methoden Skriptautoren die Wahl zwischen verschiedenen Versionen der Sandbox ermöglicht, jetzt kann für alle Skripts jedoch der Modus IFRAME verwendet werden, unabhängig davon, welcher Sandbox-Modus aktiviert ist. Weitere Informationen finden Sie im Leitfaden zu Einschränkungen im HTML-Dienst.

Der Modus IFRAME gibt viel weniger Einschränkungen als die anderen Sandbox-Modi vor und wird am schnellsten ausgeführt, funktioniert jedoch in bestimmten älteren Browsern, einschließlich Internet Explorer 9, überhaupt nicht. Der Sandbox-Modus kann in einem clientseitigen Skript gelesen werden. Dazu prüfen Sie google.script.sandbox.mode. Dieses Attribut gibt den tatsächlichen Modus auf dem Client zurück. Dieser kann sich vom Modus unterscheiden, der auf dem Server angefordert wird, wenn der angeforderte Modus vom Browser des Nutzers nicht unterstützt wird.

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

Parameter

Zurücksenden

HtmlOutput: Diese Ausgabe zum Verketten.

Legt den Titel der Ausgabeseite fest. Bei Webanwendungen ist dies der Titel der gesamten Seite. 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

Zurücksenden

HtmlOutput: Diese Ausgabe zum Verketten.

Legt die Anfangsbreite eines benutzerdefinierten Dialogfelds in Google Docs, Google Tabellen oder Google Formulare fest. Wenn HtmlOutput stattdessen als Web-App veröffentlicht wird, hat diese Methode keine Auswirkungen. Wenn Sie die Größe eines bereits geöffneten Dialogfelds ändern möchten, rufen Sie im clientseitigen Code google.script.host.setWidth(width) auf.

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

Parameter

Zurücksenden

HtmlOutput: Diese Ausgabe zum Verketten.

Legt den Status des X-Frame-Options-Headers der Seite fest, der die Verhinderung von Clickjacking steuert.

Wenn XFrameOptionsMode.ALLOWALL festgelegt ist, kann die Website die Seite einbetten. Der Entwickler sollte daher einen eigenen Schutz vor Hackerangriffen implementieren.

Wenn ein Skript den X-Frame-Options-Modus nicht aktiviert, verwendet Apps Script den Standardmodus XFrameOptionsMode.DEFAULT.

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

Zurücksenden

HtmlOutput: Diese Ausgabe zum Verketten.