این صفحه به‌وسیله ‏Cloud Translation API‏ ترجمه شده است.

Class HtmlService

سرویس برای برگرداندن HTML و سایر محتوای متنی از یک اسکریپت.

به دلیل ملاحظات امنیتی، اسکریپت ها نمی توانند مستقیماً محتوا را به مرورگر بازگردانند. در عوض، آنها باید HTML را پاکسازی کنند تا نتواند اقدامات مخرب انجام دهد. شرح HtmlOutput را ببینید که چه محدودیت هایی را در مورد آنچه که می توان برگرداند، شامل می شود.

خواص

اموال	تایپ کنید	توضیحات
`SandboxMode`	`SandboxMode`	یک فهرست نشان دهنده حالت های جعبه ایمنی است که می تواند برای اسکریپت های `HtmlService` سمت سرویس گیرنده استفاده شود.
`XFrameOptionsMode`	`XFrameOptionsMode`	فهرستی که حالت های `X-Frame-Options` را نشان می دهد که می تواند برای اسکریپت های `HtmlService` سمت سرویس گیرنده استفاده شود.

روش ها

روش	نوع برگشت	شرح مختصر
`createHtmlOutput()`	`HtmlOutput`	یک شی `HtmlOutput` جدید ایجاد می کند که می تواند از اسکریپت برگردانده شود.
`createHtmlOutput(blob)`	`HtmlOutput`	یک شی `HtmlOutput` جدید از یک منبع `BlobSource` ایجاد می کند.
`createHtmlOutput(html)`	`HtmlOutput`	یک شی `HtmlOutput` جدید ایجاد می کند که می تواند از اسکریپت برگردانده شود.
`createHtmlOutputFromFile(filename)`	`HtmlOutput`	یک شی `HtmlOutput` جدید از یک فایل در ویرایشگر کد ایجاد می کند.
`createTemplate(blob)`	`HtmlTemplate`	یک شی `HtmlTemplate` جدید از یک منبع `BlobSource` ایجاد می کند.
`createTemplate(html)`	`HtmlTemplate`	یک شی `HtmlTemplate` جدید ایجاد می کند که می تواند از اسکریپت برگردانده شود.
`createTemplateFromFile(filename)`	`HtmlTemplate`	یک شی `HtmlTemplate` جدید از یک فایل در ویرایشگر کد ایجاد می کند.
`getUserAgent()`	`String`	رشته user-agent را برای مرورگر فعلی دریافت می کند.

مستندات دقیق

`createHtmlOutput()`

یک شی HtmlOutput جدید ایجاد می کند که می تواند از اسکریپت برگردانده شود.

var output = HtmlService.createHtmlOutput();

بازگشت

HtmlOutput - شی HtmlOutput جدید

`createHtmlOutput(blob)`

یک شی HtmlOutput جدید از یک منبع BlobSource ایجاد می کند.

function createFromBlob(blob) {
  var output = HtmlService.createHtmlOutput(blob);
  return output;
}

پارامترها

نام	تایپ کنید	توضیحات
`blob`	`BlobSource`	شیئی که HTML از آن خارج می شود

بازگشت

HtmlOutput - شی HtmlOutput جدید

پرتاب می کند

Error - اگر لکه حاوی HTML نباشد یا HTML بد شکل باشد

`createHtmlOutput(html)`

یک شی HtmlOutput جدید ایجاد می کند که می تواند از اسکریپت برگردانده شود.

var output = HtmlService.createHtmlOutput('<b>Hello world!</b>');

پارامترها

نام	تایپ کنید	توضیحات
`html`	`String`	محتوای مورد نظر برای ارائه

بازگشت

HtmlOutput - شی HtmlOutput جدید

پرتاب می کند

Error - اگر html بد شکل باشد

`createHtmlOutputFromFile(filename)`

یک شی HtmlOutput جدید از یک فایل در ویرایشگر کد ایجاد می کند.

var output = HtmlService.createHtmlOutputFromFile('myPage');

پارامترها

نام	تایپ کنید	توضیحات
`filename`	`String`	نام فایل مورد استفاده

بازگشت

HtmlOutput - شی HtmlOutput جدید

پرتاب می کند

Error - اگر فایل پیدا نشد یا HTML موجود در آن نادرست است

`createTemplate(blob)`

یک شی HtmlTemplate جدید از یک منبع BlobSource ایجاد می کند.

function createFromBlob(blob) {
  var template = HtmlService.createTemplate(blob);
  return output;
}

پارامترها

نام	تایپ کنید	توضیحات
`blob`	`BlobSource`	شیئی که HTML از آن خارج می شود.

بازگشت

HtmlTemplate - شی HtmlTemplate جدید

پرتاب می کند

Error - اگر لکه حاوی HTML نباشد

`createTemplate(html)`

یک شی HtmlTemplate جدید ایجاد می کند که می تواند از اسکریپت برگردانده شود.

var template = HtmlService.createTemplate('<b>The time is &lt;?= new Date() ?&gt;</b>');

پارامترها

نام	تایپ کنید	توضیحات
`html`	`String`	محتوای قالب

بازگشت

HtmlTemplate - شی HtmlTemplate جدید

`createTemplateFromFile(filename)`

یک شی HtmlTemplate جدید از یک فایل در ویرایشگر کد ایجاد می کند.

var template = HtmlService.createTemplateFromFile('myTemplate');

پارامترها

نام	تایپ کنید	توضیحات
`filename`	`String`	نام فایل مورد استفاده

بازگشت

HtmlTemplate - شی HtmlTemplate جدید

پرتاب می کند

Error - اگر فایل پیدا نشد

`getUserAgent()`

رشته user-agent را برای مرورگر فعلی دریافت می کند. اگر در تابع doGet() doPost() یک برنامه وب استفاده نشود، برای اکثر اجرای اسکریپت ها null برمی گرداند.

بازگشت

String - رشته عامل کاربر