Class HtmlTemplate

قالب Html

یک شی الگو برای ساخت پویا HTML. برای اطلاعات بیشتر، راهنمای الگوها را ببینید.

روش ها

روش نوع برگشت شرح مختصر
evaluate() Html Output این الگو را ارزیابی می کند و یک شی Html Output را برمی گرداند.
get Code() String رشته ای از کد جاوا اسکریپت را بر اساس فایل الگو تولید می کند که قابل ارزیابی است.
get Code With Comments() String رشته‌ای از کد جاوا اسکریپت را ایجاد می‌کند که می‌تواند ارزیابی شود و هر خط کد حاوی خط اصلی از الگو به عنوان نظر باشد.
get Raw Content() String محتوای پردازش نشده این الگو را برمی گرداند.

مستندات دقیق

evaluate()

این الگو را ارزیابی می کند و یک شی Html Output را برمی گرداند. هر ویژگی تنظیم شده بر روی این شیء Html Template در هنگام ارزیابی در محدوده است. برای اشکال زدایی خطاها در قالب، کد را با استفاده از متد get Code() بررسی کنید.

// 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!'

بازگشت

Html Output - یک شیء HtmlOutput

get Code()

رشته ای از کد جاوا اسکریپت را بر اساس فایل الگو تولید می کند که قابل ارزیابی است. این روش یک رشته کد جاوا اسکریپت را بر اساس فایل قالب تولید می کند. فراخوانی eval(<code>) پس از اجرای تمام اسکریپت های سرور تعبیه شده، یک شی Html Output جدید را با محتوای قالب برمی گرداند. در نظر گرفته شده است که کد تولید شده برای انسان قابل خواندن باشد، بنابراین اگر نیاز به اشکال زدایی یک الگو دارید، می توانید با Logger.log(<code>) تماس بگیرید تا ببینید چه چیزی تولید شده است.

ارزیابی این کد به طور ضمنی به همه متغیرهای موجود در محدوده فعلی متصل می شود. به طور کلی، استفاده از متد evaluate() ترجیح داده می شود که اتصالات صریح را انجام می دهد.

const template = HtmlService.createTemplate(
    '<b>The time is &lt;?= new Date() ?&gt;</b>',
);
Logger.log(template.getCode());

بازگشت

String - رشته ای بر اساس الگو، که می تواند ارزیابی شود

get Code With Comments()

رشته‌ای از کد جاوا اسکریپت را ایجاد می‌کند که می‌تواند ارزیابی شود و هر خط کد حاوی خط اصلی از الگو به عنوان نظر باشد. این روش یک رشته کد جاوا اسکریپت را بر اساس فایل قالب تولید می کند. فراخوانی eval(<code>) پس از اجرای تمام اسکریپت های سرور تعبیه شده، یک شی Html Output جدید را با محتوای قالب برمی گرداند. در نظر گرفته شده است که کد تولید شده برای انسان قابل خواندن باشد، بنابراین اگر نیاز به اشکال زدایی یک الگو دارید، می توانید با Logger.log(<code>) تماس بگیرید تا ببینید چه چیزی تولید شده است.

ارزیابی این کد به طور ضمنی به همه متغیرهای موجود در محدوده فعلی متصل می شود. به طور کلی، استفاده از متد evaluate() ترجیح داده می شود که اتصالات صریح را انجام می دهد.

const template = HtmlService.createTemplate(
    '<b>The time is &lt;?= new Date() ?&gt;</b>',
);
Logger.log(template.getCodeWithComments());

بازگشت

String - رشته ای بر اساس الگو، که می تواند ارزیابی شود

get Raw Content()

محتوای پردازش نشده این الگو را برمی گرداند.

const template = HtmlService.createTemplate(
    '<b>The time is &lt;?= new Date() ?&gt;</b>',
);
Logger.log(template.getRawContent());

بازگشت

String - محتوای خام قالب