Class HtmlTemplate

قالب HTML

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

روش‌ها

روش نوع بازگشتی شرح مختصر
evaluate() Html Output این الگو را ارزیابی کرده و یک شیء Html Output برمی‌گرداند.
get Code() String بر اساس فایل الگو، رشته‌ای از کد جاوا اسکریپت تولید می‌کند که می‌تواند ارزیابی شود.
get Code With Comments() String رشته‌ای از کد جاوا اسکریپت تولید می‌کند که می‌تواند ارزیابی شود، و هر خط از کد شامل خط اصلی از قالب به عنوان یک نظر است.
get Raw Content() 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());  // logs 'Hello World!'

بازگشت

HtmlOutput — یک شیء HtmlOutput.

getCode()

بر اساس فایل الگو، رشته‌ای از کد جاوا اسکریپت تولید می‌کند که قابل ارزیابی است. این متد، رشته‌ای از کد جاوا اسکریپت را بر اساس فایل الگو تولید می‌کند. فراخوانی 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()

رشته‌ای از کد جاوا اسکریپت تولید می‌کند که می‌تواند ارزیابی شود، به طوری که هر خط از کد شامل خط اصلی از قالب به عنوان یک نظر است. این متد یک رشته از کد جاوا اسکریپت را بر اساس فایل قالب تولید می‌کند. فراخوانی 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 — محتوای خام قالب.