خدمة لعرض محتوى 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 <?= new Date() ?></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
— سلسلة وكيل المستخدم