این صفحه به‌وسیله ‏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 - رشته عامل کاربر