تمت ترجمة هذه الصفحة بواسطة 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 — كائن إخراج 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>) للاطّلاع على ما تم إنتاجه.

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