تمت ترجمة هذه الصفحة بواسطة 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: كائن Htmlإخراج الجديد

`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: كائن Htmlإخراج الجديد

طرح

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 - سلسلة وكيل المستخدم