HTML Service

HTML

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

.

صفوف

الاسموصف قصير
HtmlOutputتمثّل هذه السمة عنصر HtmlOutput يمكن عرضه من نص برمجي.
HtmlOutputMetaTagهو كائن يمثل علامة وصفية تمت إضافته إلى الصفحة عن طريق استدعاء HtmlOutput.addMetaTag(name, content).
HtmlServiceخدمة لعرض محتوى HTML والمحتوى النصي الآخر من نص برمجي.
HtmlTemplateكائن نموذج لإنشاء HTML ديناميكيًا.
SandboxModeتعداد يمثّل أوضاع وضع الحماية التي يمكن استخدامها للنصوص البرمجية HtmlService من جهة العميل.
XFrameOptionsModeتعداد يمثّل أوضاع X-Frame-Options التي يمكن استخدامها للنص البرمجي HtmlService من جهة العميل.

HtmlOutput

الطُرق

الطريقةنوع القيمة التي يتم إرجاعهاوصف قصير
addMetaTag(name, content)HtmlOutputإضافة علامة وصفية إلى الصفحة
append(addedContent)HtmlOutputلإلحاق محتوى جديد بمحتوى HtmlOutput هذا.
appendUntrusted(addedContent)HtmlOutputلإلحاق محتوى جديد بمحتوى HtmlOutput هذا، باستخدام ميزة الإلغاء السياقي.
asTemplate()HtmlTemplateتعرض HtmlTemplate بدعم من HtmlOutput.
clear()HtmlOutputيؤدي ذلك إلى محو المحتوى الحالي.
getAs(contentType)Blobعرض البيانات داخل هذا الكائن على شكل كائن ثنائي كبير يتم تحويله إلى نوع المحتوى المحدّد.
getBlob()Blobعرض البيانات داخل هذا الكائن على هيئة كائن ثنائي كبير (blob).
getContent()Stringالحصول على محتوى HtmlOutput.
getFaviconUrl()Stringالحصول على عنوان URL لعلامة رابط رمز مفضّل تتم إضافته إلى الصفحة عن طريق استدعاء setFaviconUrl(iconUrl)
getHeight()Integerالحصول على الارتفاع الأولي لمربّع الحوار المخصّص في "مستندات Google" أو "جداول بيانات Google" أو "نماذج Google"
getMetaTags()HtmlOutputMetaTag[]للحصول على مصفوفة من الكائنات التي تمثل العلامات الوصفية التي تمت إضافتها إلى الصفحة عن طريق استدعاء addMetaTag(name, content).
getTitle()Stringللحصول على عنوان صفحة الإخراج
getWidth()Integerالحصول على العرض الأولي لمربّع الحوار المخصّص في "مستندات Google" أو "جداول بيانات Google" أو "نماذج Google"
setContent(content)HtmlOutputتُستخدم هذه السياسة لضبط محتوى HtmlOutput.
setFaviconUrl(iconUrl)HtmlOutputلإضافة علامة رابط لرمز مفضّل إلى الصفحة.
setHeight(height)HtmlOutputيضبط الارتفاع الأولي لمربّع الحوار المخصّص في "مستندات Google" أو "جداول بيانات Google" أو "نماذج Google".
setSandboxMode(mode)HtmlOutputأصبح لهذه الطريقة أي تأثير الآن، حيث تم في السابق ضبط sandbox mode المستخدَمة للنصوص البرمجية من جهة العميل.
setTitle(title)HtmlOutputتحدِّد هذه السياسة عنوان صفحة الإخراج.
setWidth(width)HtmlOutputيضبط العرض الأولي لمربّع حوار مخصّص في "مستندات Google" أو "جداول بيانات Google" أو "نماذج Google".
setXFrameOptionsMode(mode)HtmlOutputتحدِّد حالة عنوان X-Frame-Options للصفحة، والتي تتحكّم في منع تمويه النقر.

HtmlOutputMetaTag

الطُرق

الطريقةنوع القيمة التي يتم إرجاعهاوصف قصير
getContent()Stringالحصول على محتوى هذه العلامة الوصفية.
getName()Stringيحصل على اسم هذا HtmlOutputMetaTag.

HtmlService

أماكن إقامة

الموقعTypeالوصف
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تحصل على سلسلة وكيل المستخدم للمتصفّح الحالي.

HtmlTemplate

الطُرق

الطريقةنوع القيمة التي يتم إرجاعهاوصف قصير
evaluate()HtmlOutputلتقييم هذا النموذج وعرض عنصر HtmlOutput
getCode()Stringتنشئ سلسلة من رمز JavaScript يمكن تقييمها استنادًا إلى ملف النموذج.
getCodeWithComments()Stringتنشئ سلسلة من رمز JavaScript يمكن تقييمها، حيث يحتوي كل سطر من الرمز على السطر الأصلي من النموذج على شكل تعليق.
getRawContent()Stringتعرض المحتوى الذي لم تتم معالجته لهذا النموذج.

SandboxMode

أماكن إقامة

الموقعTypeالوصف
EMULATEDEnumوضع حماية قديم يحاكي الوضع المتشدد ECMAScript 5 باستخدام الميزات المتوفرة في ECMAScript 3 فقط.
IFRAMEEnumهو وضع حماية يستخدم وضع الحماية باستخدام إطارات iframe بدلاً من تقنية وضع حماية Caja التي يستخدمها وضعا EMULATED وNATIVE.
NATIVEEnumوضع حماية تم إنشاؤه فوق الوضع الصارم ECMAScript 5.

XFrameOptionsMode

أماكن إقامة

الموقعTypeالوصف
ALLOWALLEnumلن يتم ضبط عنوان X-Frame-Options.
DEFAULTEnumتحدِّد القيمة التلقائية للعنوان X-Frame-Options، التي تحافظ على افتراضات الأمان العادية.