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

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: إذا لم يحتوي الكائن الثنائي الكبير (blob) على 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: إذا كان الكائن الثنائي الكبير (blob) لا يحتوي على 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()`

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

الإرجاع

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