Ein Vorlagenobjekt für die dynamische HTML-Erstellung. Weitere Informationen finden Sie im Leitfaden zu Vorlagen.
Methoden
| Methode | Rückgabetyp | Kurzbeschreibung |
|---|---|---|
evaluate() | HtmlOutput | Wertet diese Vorlage aus und gibt ein HtmlOutput-Objekt zurück. |
getCode() | String | Erzeugt basierend auf der Vorlagendatei einen JavaScript-Code-String, der ausgewertet werden kann. |
getCodeWithComments() | String | Generiert einen JavaScript-Code-String, der ausgewertet werden kann. Dabei enthält jede Codezeile die ursprüngliche Zeile aus der Vorlage als Kommentar. |
getRawContent() | String | Gibt 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 Attribute werden bei der Auswertung einbezogen. Um Fehler in einer Vorlage zu beheben, prüfen Sie den Code mit der Methode getCode().
// A template which evaluates to whatever is bound to 'foo'.
var template = HtmlService.createTemplate('<?= foo ?>');
template.foo = 'Hello World!';
Logger.log(template.evaluate().getContent()); // will log 'Hello World!'
Return
HtmlOutput: Ein HTMLOutput-Objekt
getCode()
Erzeugt basierend auf der Vorlagendatei einen JavaScript-Code-String, der ausgewertet werden kann. Diese Methode erzeugt einen JavaScript-Code-String, der auf der Vorlagendatei basiert. Durch den Aufruf von
eval(<code>) wird ein neues HtmlOutput-Objekt mit dem Inhalt der Vorlage zurückgegeben, nachdem alle eingebetteten Serverskripts ausgeführt wurden. Der generierte Code ist für Menschen lesbar. Wenn Sie also eine Vorlage debuggen müssen, können Sie
Logger.log(<code>) aufrufen, um zu sehen, was ausgegeben wurde.
Wenn Sie diesen Code auswerten, wird implizit alle Variablen im aktuellen Bereich eingebunden. Im Allgemeinen ist es besser, die Methode evaluate() zu verwenden, die explizite Bindungen akzeptiert.
var template = HtmlService.createTemplate('<b>The time is <?= new Date() ?></b>');
Logger.log(template.getCode());
Return
String: ein String, der auf der Vorlage basiert und ausgewertet werden kann
getCodeWithComments()
Generiert einen JavaScript-Code-String, der ausgewertet werden kann. Dabei enthält jede Codezeile die ursprüngliche Zeile aus der Vorlage als Kommentar. Bei dieser Methode wird basierend auf der Vorlagendatei ein JavaScript-Code-String erstellt. Durch den Aufruf von eval(<code>) wird ein neues HtmlOutput-Objekt mit dem Inhalt der Vorlage zurückgegeben, nachdem alle eingebetteten Serverskripts ausgeführt wurden. Der generierte Code ist menschenlesbar. Wenn Sie also Fehler in einer Vorlage beheben müssen, können Sie Logger.log(<code>) aufrufen, um zu sehen, was ausgegeben wurde.
Wenn Sie diesen Code auswerten, wird implizit alle Variablen im aktuellen Bereich eingebunden. Im Allgemeinen ist es besser, die Methode evaluate() zu verwenden, die explizite Bindungen akzeptiert.
var template = HtmlService.createTemplate('<b>The time is <?= new Date() ?></b>');
Logger.log(template.getCodeWithComments());
Return
String: ein String, der auf der Vorlage basiert und ausgewertet werden kann
getRawContent()
Gibt den unverarbeiteten Inhalt dieser Vorlage zurück.
var template = HtmlService.createTemplate('<b>The time is <?= new Date() ?></b>');
Logger.log(template.getRawContent());
Return
String: Der Rohinhalt der Vorlage