Class HtmlTemplate

HtmlTemplate

كائن نموذج لإنشاء 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'.
const template = HtmlService.createTemplate('<?= foo ?>');
template.foo = 'Hello World!';
Logger.log(template.evaluate().getContent());  // logs '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 — المحتوى الأولي للنموذج