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, auch den Leitfaden zum HTML-Dienst zu lesen.

.

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.
SandboxModeEine Enum-Klasse, die die Sandbox-Modi darstellt, die für clientseitige HtmlService Skripts verwendet werden können.
XFrameOptionsModeEine Enum-Klasse, die 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 den Inhalten dieses HtmlOutput-Objekts neue Inhalte hinzu.
appendUntrusted(addedContent)HtmlOutputFügt den Inhalten dieses HtmlOutput-Objekts neue Inhalte hinzu und verwendet dabei kontextbezogene Escapes.
asTemplate()HtmlTemplateGibt ein HtmlTemplate-Objekt zurück, das von diesem HtmlOutput-Objekt 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-Objekts 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 anfä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-Objekts 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 Forms fest.
setSandboxMode(mode)HtmlOutputDiese Methode hat jetzt keine Auswirkungen. Zuvor wurde damit der 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 den Schutz vor Clickjacking steuert.

HtmlOutputMetaTag

Methoden

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

HtmlService

Properties

AttributTypBeschreibung
SandboxModeSandboxModeEine Enum-Klasse, die die Sandbox-Modi darstellt, die für clientseitige HtmlService Skripts verwendet werden können.
XFrameOptionsModeXFrameOptionsModeEine Enum-Klasse, die 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 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, der auf der Vorlagendatei basiert und 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

Properties

AttributTypBeschreibung
EMULATEDEnumEin Legacy-Sandbox-Modus, der den ECMAScript 5-Strict-Modus emuliert und nur die in ECMAScript 3 verfügbaren Funktionen verwendet.
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 ECMAScript 5-Strict-Modus basiert.

XFrameOptionsMode

Properties

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