خدمة لعرض 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 <?= new Date() ?></b>');
المعلّمات
الاسم | النوع | الوصف |
---|---|---|
html | String | محتوى النموذج |
تذكرة ذهاب وعودة
HtmlTemplate
- العنصر الجديد في HtmlTemplate
createTemplateFromFile(filename)
تنشئ كائن HtmlTemplate
جديدًا من ملف في محرّر الرموز.
var template = HtmlService.createTemplateFromFile('myTemplate');
المعلّمات
الاسم | النوع | الوصف |
---|---|---|
filename | String | اسم الملف المُراد استخدامه |
تذكرة ذهاب وعودة
HtmlTemplate
- العنصر الجديد في HtmlTemplate
طرح
Error
— إذا لم يتم العثور على الملف
getUserAgent()
تعرض سلسلة وكيل المستخدم للمتصفّح الحالي. تعرض null
لمعظم عمليات تنفيذ النصوص البرمجية في حال عدم استخدامها في دالة doGet()
لتطبيق doPost()
أو تطبيق ويب.
تذكرة ذهاب وعودة
String
- سلسلة وكيل المستخدم