דף זה תורגם על ידי Cloud Translation API.

Class HtmlTemplate

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

שיטות

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

תיעוד מפורט

`evaluate()`

בודקת את התבנית ומחזירה אובייקט HtmlOutput. כל המאפיינים שמוגדרים באובייקט HtmlTemplate הזה יהיו כלולים בהערכה. כדי לנפות באגים בתבנית, צריך לבדוק את הקוד באמצעות ה-method 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!'

החזרות

HtmlOutput - אובייקט HtmlOutput

`getCode()`

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

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

var 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>) כדי לבדוק מה הופק.

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

החזרות

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

`getRawContent()`

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

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

החזרות

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