تمت ترجمة هذه الصفحة بواسطة 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`	تحصل على سلسلة وكيل المستخدم للمتصفّح الحالي.

مستندات تفصيلية

`createHtmlOutput()`

لإنشاء عنصر HtmlOutput جديد يمكن إرجاعه من النص البرمجي.

const output = HtmlService.createHtmlOutput();

الإرجاع

HtmlOutput: عنصر HtmlOutput الجديد

`createHtmlOutput(blob)`

لإنشاء عنصر HtmlOutput جديد من مورد BlobSource

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

المعلَمات

الاسم	النوع	الوصف
`blob`	`BlobSource`	العنصر الذي يتم استخراج HTML منه

الإرجاع

HtmlOutput: عنصر HtmlOutput الجديد

عمليات الرمي

‫Error - إذا لم تحتوي الكتلة على محتوى HTML أو كان تنسيق HTML غير صحيح

`createHtmlOutput(html)`

لإنشاء عنصر HtmlOutput جديد يمكن إرجاعه من النص البرمجي.

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

المعلَمات

الاسم	النوع	الوصف
`html`	`String`	المحتوى المطلوب عرضه

الإرجاع

HtmlOutput: عنصر HtmlOutput الجديد

عمليات الرمي

Error - إذا كان رمز HTML غير صالح

`createHtmlOutputFromFile(filename)`

لإنشاء عنصر HtmlOutput جديد من ملف في محرِّر الرموز البرمجية

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

المعلَمات

الاسم	النوع	الوصف
`filename`	`String`	اسم الملف المطلوب استخدامه

الإرجاع

HtmlOutput: عنصر HtmlOutput الجديد

عمليات الرمي

Error - إذا لم يتم العثور على الملف أو إذا كان ملف HTML فيه غير صالح

`createTemplate(blob)`

لإنشاء عنصر HtmlTemplate جديد من مورد BlobSource

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

المعلَمات

الاسم	النوع	الوصف
`blob`	`BlobSource`	العنصر الذي يتم استخراج HTML منه

الإرجاع

HtmlTemplate: عنصر HtmlTemplate الجديد

عمليات الرمي

‫Error - إذا لم تحتوي السلسلة على محتوى HTML

`createTemplate(html)`

لإنشاء عنصر HtmlTemplate جديد يمكن إرجاعه من النص البرمجي.

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

المعلَمات

الاسم	النوع	الوصف
`html`	`String`	محتوى النموذج

الإرجاع

HtmlTemplate: عنصر HtmlTemplate الجديد

`createTemplateFromFile(filename)`

لإنشاء عنصر HtmlTemplate جديد من ملف في محرِّر الرموز البرمجية

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

المعلَمات

الاسم	النوع	الوصف
`filename`	`String`	اسم الملف المطلوب استخدامه

الإرجاع

HtmlTemplate: عنصر HtmlTemplate الجديد

عمليات الرمي

Error - إذا لم يتم العثور على الملف

`getUserAgent()`

تحصل على سلسلة وكيل المستخدم للمتصفّح الحالي. تعرِض هذه الدالة القيمة null لمعظم عمليات تنفيذ النصوص البرمجية في حال عدم استخدامها في دالة doGet() أو doPost() في تطبيق الويب.

الإرجاع

String: سلسلة وكيل المستخدم