تمت ترجمة هذه الصفحة بواسطة Cloud Translation API‏.

Class HtmlService

خدمة لعرض محتوى HTML والمحتوى النصي الآخر من نص برمجي.

لأسباب تتعلق بالأمان، لا يمكن للنصوص البرمجية عرض المحتوى في المتصفح مباشرةً. بدلاً من ذلك، يجب تصحيح لغة HTML كي لا تتمكّن من تنفيذ إجراءات ضارة. يمكنك الاطّلاع على وصف HtmlOutput لمعرفة القيود التي يعنيها ذلك على ما يمكن عرضه.

أماكن إقامة

الموقع	Type	الوصف
`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;
}

المَعلمات

الاسم	Type	الوصف
`blob`	`BlobSource`	الكائن للحصول على HTML من

استرجاع الكرة

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

الرميات

Error: إذا كان الكائن الثنائي الكبير لا يحتوي على HTML أو كان محتوى HTML مكتوبًا بشكل غير صحيح

`createHtmlOutput(html)`

تنشئ كائن HtmlOutput جديد يمكن عرضه من النص البرمجي.

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

المَعلمات

الاسم	Type	الوصف
`html`	`String`	المحتوى للعرض

استرجاع الكرة

HtmlOutput: كائن إخراج Html الجديد

الرميات

Error: في حال كان تنسيق html مكتوبًا بشكلٍ غير صحيح

`createHtmlOutputFromFile(filename)`

تنشئ هذه الدالة كائن HtmlOutput جديدًا من ملف في أداة تعديل الرموز.

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

المَعلمات

الاسم	Type	الوصف
`filename`	`String`	اسم الملف المراد استخدامه

استرجاع الكرة

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

الرميات

Error: إذا لم يتم العثور على الملف أو إذا كان تنسيق HTML فيه مكتوبًا بشكل غير صحيح

`createTemplate(blob)`

تنشئ كائن HtmlTemplate جديد من مورد BlobSource.

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

المَعلمات

الاسم	Type	الوصف
`blob`	`BlobSource`	تمثّل هذه السمة الكائن للحصول على HTML منه.

استرجاع الكرة

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

الرميات

Error: إذا كان الكائن الثنائي الكبير (blob) لا يحتوي على HTML

`createTemplate(html)`

تنشئ كائن HtmlTemplate جديد يمكن عرضه من النص البرمجي.

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

المَعلمات

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

استرجاع الكرة

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

`createTemplateFromFile(filename)`

تنشئ هذه الدالة كائن HtmlTemplate جديدًا من ملف في أداة تعديل الرموز.

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

المَعلمات

الاسم	Type	الوصف
`filename`	`String`	اسم الملف المراد استخدامه

استرجاع الكرة

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

الرميات

Error: في حال عدم العثور على الملف

`getUserAgent()`

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

استرجاع الكرة

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