Class HtmlTemplate

قالب اچ‌تی‌ام‌ال

یک شیء الگو برای ساخت پویای 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());  // logs '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 — محتوای خام قالب.