HTML Service

اچ‌تی‌ام‌ال

این سرویس به برنامه‌های Apps Script اجازه می‌دهد تا HTML را، معمولاً به عنوان رابط کاربری، برگردانند. اگر در استفاده از این کلاس تازه‌کار هستید، توصیه می‌کنیم راهنمای سرویس Html را نیز مشاهده کنید.

.

کلاس‌ها

نام شرح مختصر
Html Output یک شیء Html Output که می‌تواند از یک اسکریپت ارائه شود.
Html Output Meta Tag یک شیء که نشان دهنده یک متا تگ اضافه شده به صفحه با فراخوانی Html Output.addMetaTag(name, content) .
Html Service سرویسی برای برگرداندن HTML و سایر محتوای متنی از یک اسکریپت.
Html Template یک شیء الگو برای ساخت پویای HTML.
Sandbox Mode یک enum که حالت‌های sandbox را نشان می‌دهد که می‌توانند برای اسکریپت‌های Html Service سمت کلاینت استفاده شوند.
XFrameOptionsMode یک enum که حالت‌های X-Frame-Options را نشان می‌دهد که می‌توانند برای اسکریپت‌های Html Service سمت کلاینت استفاده شوند.

Html Output

روش‌ها

روش نوع بازگشتی شرح مختصر
add Meta Tag(name, content) Html Output یک متا تگ به صفحه اضافه می‌کند.
append(addedContent) Html Output محتوای جدیدی را به محتوای این Html Output اضافه می‌کند.
append Untrusted(addedContent) Html Output با استفاده از escape کردن زمینه، محتوای جدیدی را به محتوای این Html Output اضافه می‌کند.
as Template() Html Template یک Html Template که توسط این Html Output پشتیبانی می‌شود، برمی‌گرداند.
clear() Html Output محتوای فعلی را پاک می‌کند.
get As(contentType) Blob داده‌های درون این شیء را به صورت یک blob تبدیل‌شده به نوع محتوای مشخص‌شده، برمی‌گرداند.
get Blob() Blob داده‌های درون این شیء را به صورت یک blob برمی‌گرداند.
get Content() String محتوای این Html Output را دریافت می‌کند.
get Favicon Url() String با فراخوانی set Favicon Url(iconUrl) آدرس اینترنتی (URL) مربوط به تگ لینک favicon که به صفحه اضافه شده است را دریافت می‌کند.
get Height() Integer ارتفاع اولیه کادر محاوره‌ای سفارشی را در Google Docs، Sheets یا Forms دریافت می‌کند.
get Meta Tags() Html Output Meta Tag[] با فراخوانی تابع add Meta Tag(name, content) آرایه‌ای از اشیاء را دریافت می‌کند که نشان‌دهنده‌ی متا تگ‌های اضافه شده به صفحه هستند.
get Title() String عنوان صفحه خروجی را دریافت می‌کند.
get Width() Integer عرض اولیه کادر محاوره‌ای سفارشی را در Google Docs، Sheets یا Forms دریافت می‌کند.
set Content(content) Html Output محتوای این Html Output را تنظیم می‌کند.
set Favicon Url(iconUrl) Html Output یک تگ لینک برای فاوآیکون به صفحه اضافه می‌کند.
set Height(height) Html Output ارتفاع اولیه کادر محاوره‌ای سفارشی را در اسناد گوگل، برگه‌ها یا فرم‌ها تنظیم می‌کند.
set Sandbox Mode(mode) Html Output این روش اکنون هیچ تاثیری ندارد - قبلاً sandbox mode را که برای اسکریپت‌های سمت کلاینت استفاده می‌شد، تنظیم می‌کرد.
set Title(title) Html Output عنوان صفحه خروجی را تنظیم می‌کند.
set Width(width) Html Output عرض اولیه یک کادر محاوره‌ای سفارشی را در اسناد گوگل، برگه‌ها یا فرم‌ها تنظیم می‌کند.
set XFrame Options Mode(mode) Html Output وضعیت هدر X-Frame-Options صفحه را تنظیم می‌کند، که جلوگیری از کلیک‌ربایی را کنترل می‌کند.

Html Output Meta Tag

روش‌ها

روش نوع بازگشتی شرح مختصر
get Content() String محتوای این متا تگ را دریافت می‌کند.
get Name() String نام این Html Output Meta Tag را برمی‌گرداند.

Html Service

خواص

ملک نوع توضیحات
Sandbox Mode Sandbox Mode یک enum که حالت‌های sandbox را نشان می‌دهد که می‌توانند برای اسکریپت‌های Html Service سمت کلاینت استفاده شوند.
XFrameOptionsMode XFrameOptionsMode یک enum که حالت‌های X-Frame-Options را نشان می‌دهد که می‌توانند برای اسکریپت‌های Html Service سمت کلاینت استفاده شوند.

روش‌ها

روش نوع بازگشتی شرح مختصر
create Html Output() Html Output یک شیء Html Output جدید ایجاد می‌کند که می‌تواند از اسکریپت برگردانده شود.
create Html Output(blob) Html Output یک شیء Html Output جدید از یک منبع Blob Source ایجاد می‌کند.
create Html Output(html) Html Output یک شیء Html Output جدید ایجاد می‌کند که می‌تواند از اسکریپت برگردانده شود.
create Html Output From File(filename) Html Output یک شیء Html Output جدید از یک فایل در ویرایشگر کد ایجاد می‌کند.
create Template(blob) Html Template یک شیء Html Template جدید از یک منبع Blob Source ایجاد می‌کند.
create Template(html) Html Template یک شیء Html Template جدید ایجاد می‌کند که می‌تواند از اسکریپت برگردانده شود.
create Template From File(filename) Html Template یک شیء Html Template جدید از یک فایل در ویرایشگر کد ایجاد می‌کند.
get User Agent() String رشته‌ی user-agent مرورگر فعلی را دریافت می‌کند.

Html Template

روش‌ها

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

Sandbox Mode

خواص

ملک نوع توضیحات
EMULATED Enum یک حالت سندباکس قدیمی که حالت strict ECMAScript 5 را تنها با استفاده از ویژگی‌های موجود در ECMAScript 3 شبیه‌سازی می‌کند.
IFRAME Enum یک حالت سندباکس که به جای فناوری سندباکس Caja که توسط حالت‌های EMULATED و NATIVE استفاده می‌شود، از سندباکس iframe استفاده می‌کند.
NATIVE Enum یک حالت سندباکس که بر پایه حالت strict ECMAScript 5 ساخته شده است.

XFrameOptionsMode

خواص

ملک نوع توضیحات
ALLOWALL Enum هیچ هدر X-Frame-Options تنظیم نشده است.
DEFAULT Enum مقدار پیش‌فرض برای هدر X-Frame-Options را تنظیم می‌کند که فرضیات امنیتی معمول را حفظ می‌کند.