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عرض البيانات داخل هذا العنصر ككائن ثنائي كبير (blob) تم تحويله إلى نوع المحتوى المحدد.
getBlob()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 أو نماذج Google.
setContent(content)HtmlOutputلضبط محتوى HtmlOutput.
setFaviconUrl(iconUrl)HtmlOutputإضافة علامة رابط إلى رمز مفضّل إلى الصفحة
setHeight(height)HtmlOutputيحدد الارتفاع المبدئي لـ مربع الحوار المخصص في Google مستندات 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

أماكن إقامة

الخاصيةالنوعالوصف
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

أماكن إقامة

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

XFrameOptionsMode

أماكن إقامة

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