HTML Service

HTML

Mit diesem Dienst können Apps Script-Anwendungen HTML zurückgeben, in der Regel als Benutzeroberfläche. Wenn Sie diese Klasse zum ersten Mal verwenden, empfehlen wir Ihnen, sich auch den Leitfaden zum HTML-Dienst anzusehen.

.

Klassen

NameKurzbeschreibung
HtmlOutputEin HtmlOutput-Objekt, das über ein Skript bereitgestellt werden kann.
HtmlOutputMetaTagEin Objekt, das ein Meta-Tag darstellt, das der Seite durch Aufrufen von HtmlOutput.addMetaTag(name, content) hinzugefügt wurde.
HtmlServiceDienst zum Zurückgeben von HTML- und anderen Textinhalten aus einem Skript.
HtmlTemplateEin Vorlagenobjekt zum dynamischen Erstellen von HTML.
SandboxModeEin Enum, das die Sandbox-Modi darstellt, die für clientseitige HtmlService-Skripts verwendet werden können.
XFrameOptionsModeEin Enum, das die X-Frame-Options-Modi darstellt, die für clientseitige HtmlService-Scripts verwendet werden können.

HtmlOutput

Methoden

MethodeRückgabetypKurzbeschreibung
addMetaTag(name, content)HtmlOutputFügt der Seite ein Meta-Tag hinzu.
append(addedContent)HtmlOutputHängt neue Inhalte an den Inhalt dieses HtmlOutput an.
appendUntrusted(addedContent)HtmlOutputHängt neuen Inhalt an den Inhalt dieses HtmlOutput an und verwendet dabei kontextbezogene Escaping-Methoden.
asTemplate()HtmlTemplateGibt ein HtmlTemplate zurück, das von diesem HtmlOutput unterstützt wird.
clear()HtmlOutputLöscht den aktuellen Inhalt.
getAs(contentType)BlobGibt die Daten in diesem Objekt als Blob zurück, das in den angegebenen Inhaltstyp konvertiert wurde.
getBlob()BlobGibt die Daten in diesem Objekt als Blob zurück.
getContent()StringRuft den Inhalt dieses HtmlOutput ab.
getFaviconUrl()StringRuft die URL für ein Favicon-Link-Tag ab, das der Seite durch Aufrufen von setFaviconUrl(iconUrl) hinzugefügt wurde.
getHeight()IntegerRuft die ursprüngliche Höhe des benutzerdefinierten Dialogfelds in Google Docs, Google Sheets oder Google Forms ab.
getMetaTags()HtmlOutputMetaTag[]Ruft ein Array von Objekten ab, die Meta-Tags darstellen, die der Seite durch Aufrufen von addMetaTag(name, content) hinzugefügt wurden.
getTitle()StringRuft den Titel der Ausgabeseite ab.
getWidth()IntegerRuft die anfängliche Breite des benutzerdefinierten Dialogfelds in Google Docs, Google Sheets oder Google Forms ab.
setContent(content)HtmlOutputLegt den Inhalt dieses HtmlOutput fest.
setFaviconUrl(iconUrl)HtmlOutputFügt der Seite ein Link-Tag für ein Favicon hinzu.
setHeight(height)HtmlOutputLegt die anfängliche Höhe des benutzerdefinierten Dialogfelds in Google Docs, Google Sheets oder Google Formulare fest.
setSandboxMode(mode)HtmlOutputDiese Methode hat jetzt keine Auswirkungen mehr. Zuvor wurde damit die sandbox mode für clientseitige Skripts festgelegt.
setTitle(title)HtmlOutputLegt den Titel der Ausgabeseite fest.
setWidth(width)HtmlOutputLegt die anfängliche Breite eines benutzerdefinierten Dialogfelds in Google Docs, Google Sheets oder Google Forms fest.
setXFrameOptionsMode(mode)HtmlOutputLegt den Status des X-Frame-Options-Headers der Seite fest, der Clickjacking verhindert.

HtmlOutputMetaTag

Methoden

MethodeRückgabetypKurzbeschreibung
getContent()StringRuft den Inhalt dieses Meta-Tags ab.
getName()StringRuft den Namen dieser HtmlOutputMetaTag ab.

HtmlService

Attribute

AttributTypBeschreibung
SandboxModeSandboxModeEin Enum, das die Sandbox-Modi darstellt, die für clientseitige HtmlService-Skripts verwendet werden können.
XFrameOptionsModeXFrameOptionsModeEin Enum, das die X-Frame-Options-Modi darstellt, die für clientseitige HtmlService-Scripts verwendet werden können.

Methoden

MethodeRückgabetypKurzbeschreibung
createHtmlOutput()HtmlOutputErstellt ein neues HtmlOutput-Objekt, das vom Skript zurückgegeben werden kann.
createHtmlOutput(blob)HtmlOutputErstellt ein neues HtmlOutput-Objekt aus einer BlobSource-Ressource.
createHtmlOutput(html)HtmlOutputErstellt ein neues HtmlOutput-Objekt, das vom Skript zurückgegeben werden kann.
createHtmlOutputFromFile(filename)HtmlOutputErstellt ein neues HtmlOutput-Objekt aus einer Datei im Code-Editor.
createTemplate(blob)HtmlTemplateErstellt ein neues HtmlTemplate-Objekt aus einer BlobSource-Ressource.
createTemplate(html)HtmlTemplateErstellt ein neues HtmlTemplate-Objekt, das vom Skript zurückgegeben werden kann.
createTemplateFromFile(filename)HtmlTemplateErstellt ein neues HtmlTemplate-Objekt aus einer Datei im Code-Editor.
getUserAgent()StringRuft den User-Agent-String für den aktuellen Browser ab.

HtmlTemplate

Methoden

MethodeRückgabetypKurzbeschreibung
evaluate()HtmlOutputWertet diese Vorlage aus und gibt ein HtmlOutput-Objekt zurück.
getCode()StringGeneriert einen String mit JavaScript-Code basierend auf der Vorlagendatei, der ausgewertet werden kann.
getCodeWithComments()StringGeneriert einen String mit JavaScript-Code, der ausgewertet werden kann. Jede Codezeile enthält die ursprüngliche Zeile aus der Vorlage als Kommentar.
getRawContent()StringGibt den unverarbeiteten Inhalt dieser Vorlage zurück.

SandboxMode

Attribute

AttributTypBeschreibung
EMULATEDEnumEin Legacy-Sandbox-Modus, der den Strict-Modus von ECMAScript 5 emuliert und dabei nur die in ECMAScript 3 verfügbaren Funktionen verwendet.
IFRAMEEnumEin Sandbox-Modus, der Iframe-Sandboxing anstelle der Caja-Sandbox-Technologie verwendet, die in den Modi EMULATED und NATIVE verwendet wird.
NATIVEEnumEin Sandbox-Modus, der auf dem Strict-Modus von ECMAScript 5 basiert.

XFrameOptionsMode

Attribute

AttributTypBeschreibung
ALLOWALLEnumEs ist kein X-Frame-Options-Header festgelegt.
DEFAULTEnumLegt den Standardwert für den X-Frame-Options-Header fest, wodurch die normalen Sicherheitsvoraussetzungen beibehalten werden.