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