Class HtmlService

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