تمت ترجمة هذه الصفحة بواسطة Cloud Translation API‏.

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