Class HtmlService

خدمة HTML

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

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

أماكن إقامة

الخاصيةالنوعالوصف
SandboxModeSandboxModeتعداد يمثل أوضاع وضع الحماية التي يمكن استخدامها في نصوص HtmlService البرمجية من جهة العميل
XFrameOptionsModeXFrameOptionsModeتعداد يمثل وضع 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;
}

المعلّمات

الاسمالنوعالوصف
blobBlobSourceالعنصر المطلوب الحصول عليه من HTML

تذكرة ذهاب وعودة

HtmlOutput - العنصر الجديد في HtmlOutput

طرح

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


createHtmlOutput(html)

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

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

المعلّمات

الاسمالنوعالوصف
htmlStringالمحتوى المراد عرضه

تذكرة ذهاب وعودة

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

طرح

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


createHtmlOutputFromFile(filename)

تنشئ كائن HtmlOutput جديدًا من ملف في محرّر الرموز.

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

المعلّمات

الاسمالنوعالوصف
filenameStringاسم الملف المُراد استخدامه

تذكرة ذهاب وعودة

HtmlOutput - العنصر الجديد في HtmlOutput

طرح

Error — إذا لم يتم العثور على الملف أو لم يكن HTML مكتوبًا بشكلٍ صحيح


createTemplate(blob)

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

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

المعلّمات

الاسمالنوعالوصف
blobBlobSourceالكائن الذي يتم الحصول على رمز HTML منه.

تذكرة ذهاب وعودة

HtmlTemplate - العنصر الجديد في HtmlTemplate

طرح

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


createTemplate(html)

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

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

المعلّمات

الاسمالنوعالوصف
htmlStringمحتوى النموذج

تذكرة ذهاب وعودة

HtmlTemplate - العنصر الجديد في HtmlTemplate


createTemplateFromFile(filename)

تنشئ كائن HtmlTemplate جديدًا من ملف في محرّر الرموز.

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

المعلّمات

الاسمالنوعالوصف
filenameStringاسم الملف المُراد استخدامه

تذكرة ذهاب وعودة

HtmlTemplate - العنصر الجديد في HtmlTemplate

طرح

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


getUserAgent()

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

تذكرة ذهاب وعودة

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