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, sollten Sie sich auch den Leitfaden zum HTML-Dienst ansehen.

.

Classes

NameKurzbeschreibung
HtmlOutputEin HtmlOutput-Objekt, das über ein Script 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 Script.
HtmlTemplateEin Vorlagenobjekt zum dynamischen Erstellen von HTML.
SandboxModeEin Enum, das die Sandbox-Modi darstellt, die für clientseitige HtmlService-Scripts 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ügen Sie der Seite ein Meta-Tag hinzu.
append(addedContent)HtmlOutputDem Inhalt dieser HtmlOutput werden neue Inhalte angefügt.
appendUntrusted(addedContent)HtmlOutputFügen Sie dem Inhalt dieser HtmlOutput mithilfe von kontextbezogenem Escapen neue Inhalte an.
asTemplate()HtmlTemplateGibt eine HtmlTemplate zurück, die von diesem HtmlOutput unterstützt wird.
clear()HtmlOutputLöscht den aktuellen Inhalt.
getAs(contentType)BlobGibt die Daten in diesem Objekt als Blob zurück, der in den angegebenen Inhaltstyp konvertiert wurde.
getBlob()BlobGibt die Daten in diesem Objekt als Blob zurück.
getContent()StringRuft den Inhalt dieser 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 Tabellen oder Google Formulare 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()IntegerDie anfängliche Breite des benutzerdefinierten Dialogfelds in Google Docs, Google Tabellen oder Google Formulare.
setContent(content)HtmlOutputLegt den Inhalt dieser HtmlOutput fest.
setFaviconUrl(iconUrl)HtmlOutputFügen Sie 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 Tabellen oder Google Formulare fest.
setSandboxMode(mode)HtmlOutputDiese Methode hat jetzt keine Auswirkungen mehr. Bisher wurde damit die sandbox mode für clientseitige Scripts festgelegt.
setTitle(title)HtmlOutputHiermit wird der Titel der Ausgabeseite festgelegt.
setWidth(width)HtmlOutputDamit wird die Anfangsbreite eines benutzerdefinierten Dialogfelds in Google Docs, Google Tabellen oder Google Formulare festgelegt.
setXFrameOptionsMode(mode)HtmlOutputLegt den Status des X-Frame-Options-Headers der Seite fest, der die Clickjacking-Prävention steuert.

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-Scripts 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 Script zurückgegeben werden kann.
createHtmlOutput(blob)HtmlOutputErstellt ein neues HtmlOutput-Objekt aus einer BlobSource-Ressource.
createHtmlOutput(html)HtmlOutputErstellt ein neues HtmlOutput-Objekt, das vom Script 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 Script 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()HtmlOutputDiese Vorlage wird ausgewertet und ein HtmlOutput-Objekt zurückgegeben.
getCode()StringGeneriert einen JavaScript-Code-String basierend auf der Vorlagendatei, der ausgewertet werden kann.
getCodeWithComments()StringGeneriert einen String aus 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 älterer Sandbox-Modus, der den strengen Modus von ECMAScript 5 emuliert und dabei nur die in ECMAScript 3 verfügbaren Funktionen verwendet.
IFRAMEEnumEin Sandbox-Modus, der die Iframe-Sandbox-Technologie anstelle der Caja-Sandbox-Technologie verwendet, die in den Modi EMULATED und NATIVE verwendet wird.
NATIVEEnumEin Sandbox-Modus, der auf dem strengen Modus von ECMAScript 5 basiert.

XFrameOptionsMode

Attribute

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