كائن نموذج لإنشاء HTML بشكل ديناميكي. لمزيد من المعلومات، اطّلِع على دليل النماذج.
الطُرق
| الطريقة | نوع القيمة التي تم إرجاعها | وصف قصير |
|---|---|---|
evaluate() | Html | يقيّم هذا النموذج ويعرض عنصر Html. |
get | String | تنشئ هذه السمة سلسلة من رموز JavaScript البرمجية، استنادًا إلى ملف النموذج، ويمكن تقييمها. |
get | String | تنشئ هذه الدالة سلسلة من رموز JavaScript البرمجية التي يمكن تقييمها، مع تضمين كل سطر من الرموز البرمجية للسطر الأصلي من النموذج كتعليق. |
get | String | تعرض هذه السمة المحتوى غير المعالج لهذا النموذج. |
مستندات تفصيلية
evaluate()
يقيّم هذا النموذج ويعرض عنصر Html. تكون أي سمات تم ضبطها على عنصر Html هذا ضمن النطاق عند التقييم. لتصحيح أخطاء في أحد النماذج،
افحص الرمز باستخدام طريقة get.
// 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!'
الإرجاع
Html: كائن HtmlOutput.
get Code()
تنشئ هذه السمة سلسلة من رموز JavaScript البرمجية، استنادًا إلى ملف النموذج، ويمكن تقييمها. تنتج هذه الطريقة سلسلة من رموز JavaScript البرمجية استنادًا إلى ملف النموذج. يؤدي استدعاء
eval(<code>) إلى عرض عنصر Html جديد يتضمّن محتوى النموذج بعد تشغيل جميع نصوص البرامج النصية المضمّنة في الخادم. من المفترض أن يكون الرمز الذي تم إنشاؤه قابلاً للقراءة من قِبل الإنسان، وبالتالي إذا كنت بحاجة إلى تصحيح خطأ في نموذج، يمكنك استدعاء
Logger.log(<code>) لمعرفة ما تم إنشاؤه.
يؤدي تقييم هذه الرمز البرمجي إلى ربط جميع المتغيرات في النطاق الحالي ضمنيًا. بشكل عام، من الأفضل استخدام طريقة evaluate() التي تستخدم عمليات ربط صريحة.
const template = HtmlService.createTemplate( '<b>The time is <?= new Date() ?></b>', ); Logger.log(template.getCode());
الإرجاع
String: سلسلة تستند إلى النموذج ويمكن تقييمها.
get Code With Comments()
تنشئ هذه السمة سلسلة من رموز JavaScript البرمجية التي يمكن تقييمها، ويتضمّن كل سطر من الرموز البرمجية السطر الأصلي من النموذج كتعليق. تنتج هذه الطريقة سلسلة من رموز JavaScript البرمجية استنادًا إلى ملف النموذج. يؤدي استدعاء eval(<code>) إلى عرض كائن Html جديد يتضمّن محتوى النموذج بعد تنفيذ جميع النصوص البرمجية المضمّنة على الخادم. من المفترض أن يكون الرمز الذي تم إنشاؤه قابلاً للقراءة، لذا إذا كنت بحاجة إلى تصحيح خطأ في نموذج، يمكنك استدعاء Logger.log(<code>) لمعرفة ما تم إنشاؤه.
يؤدي تقييم هذه الرمز البرمجي إلى ربط جميع المتغيرات في النطاق الحالي ضمنيًا. بشكل عام، من الأفضل استخدام طريقة evaluate() التي تستخدم عمليات ربط صريحة.
const template = HtmlService.createTemplate( '<b>The time is <?= new Date() ?></b>', ); Logger.log(template.getCodeWithComments());
الإرجاع
String: سلسلة تستند إلى النموذج ويمكن تقييمها.
get Raw Content()
تعرض هذه السمة المحتوى غير المعالج لهذا النموذج.
const template = HtmlService.createTemplate( '<b>The time is <?= new Date() ?></b>', ); Logger.log(template.getRawContent());
الإرجاع
String — المحتوى الأولي للنموذج