HTML Service

تتيح هذه الخدمة لتطبيقات "برمجة التطبيقات" عرض 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`، ما يحافظ على افتراضات الأمان العادية.

HTML Service تنظيم صفحاتك في مجموعات يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.

الدروس

HtmlOutput

الطُرق

HtmlOutputMetaTag

الطُرق

HtmlService

الخصائص

الطُرق

HtmlTemplate

الطُرق

SandboxMode

الخصائص

XFrameOptionsMode

الخصائص

HTML Service

`HtmlOutput`

`HtmlOutputMetaTag`

`HtmlService`

`HtmlTemplate`

`SandboxMode`

`XFrameOptionsMode`