Class HtmlTemplate

تنظيم صفحاتك في مجموعات يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
Htmlنموذج

عنصر نموذج لإنشاء ترميز HTML ديناميكيًا. ولمزيد من المعلومات، راجِع دليل النماذج.

الطُرق

الطريقةنوع الإرجاعوصف قصير
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'.
var template = HtmlService.createTemplate('<?= foo ?>');
template.foo = 'Hello World!';
Logger.log(template.evaluate().getContent());  // will log 'Hello World!'

تذكرة ذهاب وعودة

HtmlOutput: كائن Htmlإخراج


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>) للاطّلاع على ما تم إنشاؤه.

يؤدي تقييم هذا الرمز إلى ربط ضمني في جميع المتغيرات في النطاق الحالي. بشكل عام، يفضَّل استخدام طريقة evaluate() التي تستخدم روابط صريحة.

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 - المحتوى الأولي للنموذج