HTML Service

HTML

Mit diesem Dienst können Apps Script-Anwendungen HTML zurückgeben, in der Regel als Benutzeroberfläche. Wenn Sie mit der Nutzung dieser Klasse noch nicht vertraut sind, empfehlen wir Ihnen außerdem den Leitfaden zum HTML-Dienst.

.

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 wird.
HtmlServiceDienst zum Zurückgeben von HTML- und anderen Textinhalten aus einem Skript
HtmlTemplateEin Vorlagenobjekt zum dynamischen Erstellen von HTML.
SandboxModeEin Enum-Wert, der die Sandbox-Modi darstellt, die für clientseitige HtmlService-Skripts verwendet werden können.
XFrameOptionsModeEin Enum-Wert, der die X-Frame-Options-Modi darstellt, die für clientseitige HtmlService-Skripts verwendet werden können.

HtmlOutput

Methoden

MethodeRückgabetypKurzbeschreibung
addMetaTag(name, content)HtmlOutputFügt der Seite ein Meta-Tag hinzu.
append(addedContent)HtmlOutputFügt neue Inhalte an den Inhalt von HtmlOutput an.
appendUntrusted(addedContent)HtmlOutputFügt neue Inhalte mit Kontext-Escape an den Inhalt von HtmlOutput an.
asTemplate()HtmlTemplateGibt ein HtmlTemplate zurück, das von diesem HtmlOutput unterstützt wird.
clear()HtmlOutputDer Inhalt wird gelöscht.
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 wird.
getHeight()IntegerRuft die Anfangshö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 und der Seite durch Aufrufen von addMetaTag(name, content) hinzugefügt werden.
getTitle()StringRuft den Titel der Ausgabeseite ab.
getWidth()IntegerRuft die Anfangsbreite des benutzerdefinierten Dialogfelds in Google Docs, Google Tabellen oder Google Formulare 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 Anfangshöhe des benutzerdefinierten Dialogfelds in Google Docs, Google Tabellen oder Google Formulare fest.
setSandboxMode(mode)HtmlOutputDiese Methode hat nun keine Wirkung mehr. Bisher wurde die sandbox mode für clientseitige Skripts festgelegt.
setTitle(title)HtmlOutputLegt den Titel der Ausgabeseite fest.
setWidth(width)HtmlOutputLegt die Anfangsbreite eines benutzerdefinierten Dialogfelds in Google Docs, Google Tabellen oder Google Formulare fest.
setXFrameOptionsMode(mode)HtmlOutputLegt den Status des X-Frame-Options-Headers der Seite fest, der die Verhinderung von Clickjacking steuert.

HtmlOutputMetaTag

Methoden

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

HtmlService

Attribute

PropertyTypBeschreibung
SandboxModeSandboxModeEin Enum-Wert, der die Sandbox-Modi darstellt, die für clientseitige HtmlService-Skripts verwendet werden können.
XFrameOptionsModeXFrameOptionsModeEin Enum-Wert, der die X-Frame-Options-Modi darstellt, die für clientseitige HtmlService-Skripts 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 Codeeditor.
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 Codeeditor.
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()StringErzeugt einen String aus JavaScript-Code, der auf der Vorlagendatei basiert und ausgewertet werden kann.
getCodeWithComments()StringErstellt einen JavaScript-String, der ausgewertet werden kann. Dabei enthält jede Codezeile die ursprüngliche Zeile aus der Vorlage als Kommentar.
getRawContent()StringGibt den nicht verarbeiteten Inhalt dieser Vorlage zurück.

SandboxMode

Attribute

PropertyTypBeschreibung
EMULATEDEnumEin älterer Sandbox-Modus, der den strengen Modus von ECMAScript 5 mithilfe der Funktionen emuliert, die in ECMAScript 3 verfügbar sind.
IFRAMEEnumEin Sandbox-Modus, der iFrame-Sandboxing anstelle der Caja-Sandbox-Technologie verwendet, die von den Modi EMULATED und NATIVE verwendet wird.
NATIVEEnumEin Sandbox-Modus, der auf dem strengen Modus von ECMAScript 5 aufbaut

XFrameOptionsMode

Attribute

PropertyTypBeschreibung
ALLOWALLEnumEs wird kein X-Frame-Options-Header festgelegt.
DEFAULTEnumLegt den Standardwert für den Header X-Frame-Options fest, der die normalen Annahmen zur Sicherheit beibehält.