Class HtmlTemplate

HtmlTemplate

אובייקט תבנית ליצירת HTML באופן דינמי. מידע נוסף זמין במדריך לתבניות.

Methods

שיטה	סוג הערך המוחזר	תיאור קצר
evaluate()	HtmlOutput	הפונקציה מעריכה את התבנית הזו ומחזירה אובייקט HtmlOutput.
getCode()	String	יצירת מחרוזת של קוד JavaScript, על סמך קובץ התבנית, שאפשר להעריך.
getCodeWithComments()	String	הפונקציה יוצרת מחרוזת של קוד JavaScript שאפשר להעריך, כאשר כל שורה בקוד מכילה את השורה המקורית מהתבנית בתור תגובה.
getRawContent()	String	הפונקציה מחזירה את התוכן הלא מעובד של התבנית הזו.

מסמכים מפורטים

evaluate()

הפונקציה מעריכה את התבנית הזו ומחזירה אובייקט HtmlOutput. כל המאפיינים שמוגדרים באובייקט HtmlTemplate הזה ייכללו בהיקף הבדיקה. כדי לנפות באגים בשגיאות בתבנית, צריך לבדוק את הקוד באמצעות השיטה 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());  // will log 'Hello World!'

חזרה

HtmlOutput – אובייקט HtmlOutput

---

getCode()

יצירת מחרוזת של קוד JavaScript, על סמך קובץ התבנית, שאפשר להעריך. השיטה הזו יוצרת מחרוזת של קוד JavaScript על סמך קובץ התבנית. קריאה ל- eval(<code>) תחזיר אובייקט HtmlOutput חדש עם תוכן התבנית אחרי הריצה של כל סקריפט השרת המוטמע. הקוד שנוצר מיועד לקריאה על ידי בני אדם, כך שאם אתם צריכים לנפות באגים בתבנית, תוכלו להפעיל את Logger.log(<code>) כדי לראות מה נוצר.

הערכת הקוד הזה תגרום לקישור של כל המשתנים בהיקף הנוכחי באופן משתמע. באופן כללי, עדיף להשתמש בשיטה evaluate(), שמקבלת קישורים מפורשים.

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

חזרה

String – מחרוזת שמבוססת על התבנית, שניתן להעריך אותה

---

getCodeWithComments()

הפונקציה יוצרת מחרוזת של קוד JavaScript שאפשר להעריך, כאשר כל שורה בקוד מכילה את השורה המקורית מהתבנית בתור תגובה. השיטה הזו יוצרת מחרוזת של קוד JavaScript על סמך קובץ התבנית. קריאה ל-eval(<code>) תחזיר אובייקט HtmlOutput חדש עם תוכן התבנית אחרי הרצת כל הסקריפטים המוטמעים בשרת. הקוד שנוצר מיועד לקריאה על ידי בני אדם, כך שאם אתם צריכים לנפות באגים בתבנית, תוכלו להפעיל את Logger.log(<code>) כדי לראות מה נוצר.

הערכת הקוד הזה תגרום לקישור של כל המשתנים בהיקף הנוכחי באופן משתמע. באופן כללי, עדיף להשתמש בשיטה evaluate(), שמקבלת קישורים מפורשים.

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

חזרה

String – מחרוזת שמבוססת על התבנית, שניתן להעריך אותה

---

getRawContent()

הפונקציה מחזירה את התוכן הלא מעובד של התבנית הזו.

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

חזרה

String – התוכן הגולמי של התבנית