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	لعرض البيانات داخل هذا العنصر ككائن ثنائي كبير.
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

الخصائص

الموقع	النوع	الوصف
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	وضع تجريبي قديم يحاكي وضع التدقيق الصارم في 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، ما يحافظ على افتراضات الأمان العادية.