דף זה תורגם על ידי Cloud Translation API.

HTML Service

השירות הזה מאפשר לאפליקציות של Apps Script להחזיר HTML, בדרך כלל כממשק משתמש. אם אתם משתמשים ב-HTML Service בפעם הראשונה, מומלץ לעיין גם במדריך ל-HTML Service.

שיעורים

שם	תיאור קצר
`HtmlOutput`	אובייקט `HtmlOutput` שאפשר להציג מסקריפט.
`HtmlOutputMetaTag`	אובייקט שמייצג מטא תג שנוסף לדף באמצעות קריאה ל-`HtmlOutput.addMetaTag(name, content)`.
`HtmlService`	שירות להחזרת HTML ותוכן טקסט אחר מסקריפט.
`HtmlTemplate`	אובייקט תבנית ליצירת HTML באופן דינמי.
`SandboxMode`	enum שמייצג את מצבי Sandbox שאפשר להשתמש בהם בסקריפטים של `HtmlService` מצד הלקוח.
`XFrameOptionsMode`	enum שמייצג את המצבים של `X-Frame-Options` שאפשר להשתמש בהם בסקריפטים של `HtmlService` מצד הלקוח.

`HtmlOutput`

Methods

שיטה	סוג הערך המוחזר	תיאור קצר
`addMetaTag(name, content)`	`HtmlOutput`	הוספת מטא תג לדף.
`append(addedContent)`	`HtmlOutput`	הוספת תוכן חדש לתוכן של `HtmlOutput` הזה.
`appendUntrusted(addedContent)`	`HtmlOutput`	הוספת תוכן חדש לתוכן של `HtmlOutput` הזה, באמצעות בריחה לפי הקשר.
`asTemplate()`	`HtmlTemplate`	הפונקציה מחזירה `HtmlTemplate` שמגובים על ידי `HtmlOutput` הזה.
`clear()`	`HtmlOutput`	ניקוי התוכן הנוכחי.
`getAs(contentType)`	`Blob`	החזרת הנתונים שבתוך האובייקט הזה כ-blob שהומר לסוג התוכן שצוין.
`getBlob()`	`Blob`	החזרת הנתונים שבתוך האובייקט הזה כ-blob.
`getContent()`	`String`	הפונקציה מקבלת את התוכן של ה-`HtmlOutput` הזה.
`getFaviconUrl()`	`String`	הפונקציה מקבלת את כתובת ה-URL של תג קישור לסמל אתר שנוסף לדף באמצעות קריאה ל-`setFaviconUrl(iconUrl)`.
`getHeight()`	`Integer`	הפונקציה מקבלת את הגובה הראשוני של תיבת הדו-שיח בהתאמה אישית ב-Google Docs,‏ Sheets או Forms.
`getMetaTags()`	`HtmlOutputMetaTag[]`	הפונקציה מקבלת מערך של אובייקטים שמייצגים מטא תגים שנוספו לדף באמצעות קריאה ל-`addMetaTag(name, content)`.
`getTitle()`	`String`	הפונקציה מקבלת את הכותרת של דף הפלט.
`getWidth()`	`Integer`	הפונקציה מקבלת את הרוחב הראשוני של תיבת הדו-שיח בהתאמה אישית ב-Google Docs,‏ Sheets או Forms.
`setContent(content)`	`HtmlOutput`	הגדרת התוכן של `HtmlOutput` הזה.
`setFaviconUrl(iconUrl)`	`HtmlOutput`	הוספת תג קישור של סמל דף לדף.
`setHeight(height)`	`HtmlOutput`	הגדרת הגובה הראשוני של תיבת הדו-שיח בהתאמה אישית ב-Google Docs,‏ Sheets או Forms.
`setSandboxMode(mode)`	`HtmlOutput`	השיטה הזו לא משפיעה עכשיו – בעבר היא הגדירה את `sandbox mode` ששימש לסקריפטים מצד הלקוח.
`setTitle(title)`	`HtmlOutput`	הגדרת הכותרת של דף הפלט.
`setWidth(width)`	`HtmlOutput`	הגדרת הרוחב הראשוני של תיבת דו-שיח מותאמת אישית ב-Google Docs,‏ Sheets או Forms.
`setXFrameOptionsMode(mode)`	`HtmlOutput`	מגדיר את המצב של הכותרת `X-Frame-Options` בדף, שמאפשרת לשלוט במניעת clickjacking.

`HtmlOutputMetaTag`

Methods

שיטה	סוג הערך המוחזר	תיאור קצר
`getContent()`	`String`	הפונקציה מקבלת את התוכן של המטא תג הזה.
`getName()`	`String`	הפונקציה מקבלת את השם של ה-`HtmlOutputMetaTag` הזה.

`HtmlService`

מאפיינים

נכס	סוג	תיאור
`SandboxMode`	`SandboxMode`	enum שמייצג את מצבי Sandbox שאפשר להשתמש בהם בסקריפטים של `HtmlService` מצד הלקוח.
`XFrameOptionsMode`	`XFrameOptionsMode`	enum שמייצג את המצבים של `X-Frame-Options` שאפשר להשתמש בהם בסקריפטים של `HtmlService` מצד הלקוח.

Methods

שיטה	סוג הערך המוחזר	תיאור קצר
`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`

Methods

שיטה	סוג הערך המוחזר	תיאור קצר
`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`, שמאפשרת לשמור על ההנחות הרגילות של האבטחה.