Class HtmlTemplate

HtmlTemplate

Ein Vorlagenobjekt zum dynamischen Erstellen von HTML. Weitere Informationen finden Sie im Leitfaden zu Vorlagen.

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.

Detaillierte Dokumentation

evaluate()

Wertet diese Vorlage aus und gibt ein HtmlOutput-Objekt zurück. Alle für dieses HtmlTemplate-Objekt festgelegten Eigenschaften werden bei der Auswertung berücksichtigt. Wenn Sie Fehler in einer Vorlage beheben möchten, untersuchen Sie den Code mit der Methode getCode().

// A template which evaluates to whatever is bound to 'foo'.
const template = HtmlService.createTemplate('<?= foo ?>');
template.foo = 'Hello World!';
Logger.log(template.evaluate().getContent());  // logs 'Hello World!'

Rückflug

HtmlOutput: Ein HtmlOutput-Objekt.


getCode()

Generiert einen String mit JavaScript-Code basierend auf der Vorlagendatei, der ausgewertet werden kann. Mit dieser Methode wird ein String mit JavaScript-Code basierend auf der Vorlagendatei generiert. Durch Aufrufen von eval(<code>) wird ein neues HtmlOutput-Objekt mit dem Inhalt der Vorlage zurückgegeben, nachdem alle eingebetteten Server-Skripts ausgeführt wurden. Der generierte Code soll für Menschen lesbar sein. Wenn Sie also eine Vorlage debuggen müssen, können Sie Logger.log(<code>) aufrufen, um zu sehen, was generiert wurde.

Durch die Auswertung dieses Codes werden implizit alle Variablen im aktuellen Bereich gebunden. Im Allgemeinen ist es besser, die evaluate()-Methode zu verwenden, die explizite Bindungen akzeptiert.

const template = HtmlService.createTemplate(
    '<b>The time is &lt;?= new Date() ?&gt;</b>',
);
Logger.log(template.getCode());

Rückflug

String: Ein String, der auf der Vorlage basiert und ausgewertet werden kann.


getCodeWithComments()

Generiert einen String mit JavaScript-Code, der ausgewertet werden kann. Jede Codezeile enthält die ursprüngliche Zeile aus der Vorlage als Kommentar. Mit dieser Methode wird ein String mit JavaScript-Code basierend auf der Vorlagendatei erstellt. Beim Aufrufen von eval(<code>) wird ein neues HtmlOutput-Objekt mit dem Inhalt der Vorlage zurückgegeben, nachdem alle eingebetteten Server-Skripts ausgeführt wurden. Der generierte Code soll für Menschen lesbar sein. Wenn Sie also eine Vorlage debuggen müssen, können Sie Logger.log(<code>) aufrufen, um zu sehen, was generiert wurde.

Durch die Auswertung dieses Codes werden implizit alle Variablen im aktuellen Bereich gebunden. Im Allgemeinen ist es besser, die evaluate()-Methode zu verwenden, die explizite Bindungen akzeptiert.

const template = HtmlService.createTemplate(
    '<b>The time is &lt;?= new Date() ?&gt;</b>',
);
Logger.log(template.getCodeWithComments());

Rückflug

String: Ein String, der auf der Vorlage basiert und ausgewertet werden kann.


getRawContent()

Gibt den unverarbeiteten Inhalt dieser Vorlage zurück.

const template = HtmlService.createTemplate(
    '<b>The time is &lt;?= new Date() ?&gt;</b>',
);
Logger.log(template.getRawContent());

Rückflug

String: Der Rohinhalt der Vorlage.