HTML Service

HTML

تسمح هذه الخدمة لتطبيقات Apps Script بعرض صفحات 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	عرض البيانات داخل هذا الكائن ككتلة بيانات
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	تُضيف علامة رابط لرمز favicon إلى الصفحة.
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

أماكن إقامة

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

HtmlTemplate

الطُرق

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

SandboxMode

أماكن إقامة

الموقع	النوع	الوصف
EMULATED	Enum	وضع Sandbox قديم يحاكي وضع ECMAScript 5 الصارم باستخدام الميزات المتاحة فقط في ECMAScript 3
IFRAME	Enum	وضع حماية يستخدم وضع حماية إطارات iframe بدلاً من تقنية وضع حماية Caja المستخدَمة في وضعَي EMULATED وNATIVE
NATIVE	Enum	وضع الحماية الذي تم إنشاؤه على وضع ECMAScript 5 الصارم

XFrameOptionsMode

أماكن إقامة

الموقع	النوع	الوصف
ALLOWALL	Enum	لن يتم ضبط أي عنوان X-Frame-Options.
DEFAULT	Enum	تُستخدَم لضبط القيمة التلقائية لعنوان X-Frame-Options، ما يحافظ على افتراضات أمان المعمول بها.