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

HTML Service

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

שיעורים

שם	תיאור קצר
`HtmlOutput`	אובייקט `HtmlOutput` שניתן להציג מסקריפט.
`HtmlOutputMetaTag`	אובייקט המייצג מטא תג שנוסף לדף באמצעות קריאה ל-`HtmlOutput.addMetaTag(name, content)`.
`HtmlService`	שירות להחזרת HTML ותוכן טקסט אחר מסקריפט.
`HtmlTemplate`	אובייקט תבנית לבניית HTML באופן דינמי.
`SandboxMode`	טיפוסים בני מנייה (enum) המייצגים את מצבי ארגז החול, שניתן להשתמש בהם בסקריפטים של `HtmlService` בצד הלקוח.
`XFrameOptionsMode`	טיפוסים בני מנייה (enum) שמייצגים את מצבי `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`	החזרת הנתונים שבתוך האובייקט הזה כ-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` של הדף, השולטת במניעת חטיפות קליקים.

`HtmlOutputMetaTag`

שיטות

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

`HtmlService`

נכסים

מאפיין (property)	סוג	תיאור
`SandboxMode`	`SandboxMode`	טיפוסים בני מנייה (enum) המייצגים את מצבי ארגז החול, שניתן להשתמש בהם בסקריפטים של `HtmlService` בצד הלקוח.
`XFrameOptionsMode`	`XFrameOptionsMode`	טיפוסים בני מנייה (enum) שמייצגים את מצבי `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`

נכסים

מאפיין (property)	סוג	תיאור
`EMULATED`	`Enum`	מצב ארגז חול מדור קודם שמדמה מצב ECMAScript 5 מחמיר באמצעות התכונות הזמינות רק ב-ECMAScript 3.
`IFRAME`	`Enum`	מצב ארגז חול המשתמש בארגז חול של iframe במקום בטכנולוגיית ארגז החול של Caja שבה נעשה שימוש במצבים `EMULATED` ו-`NATIVE`.
`NATIVE`	`Enum`	מצב ארגז חול שנבנה מעל מצב ECMAScript 5 מחמיר.

`XFrameOptionsMode`

נכסים

מאפיין (property)	סוג	תיאור
`ALLOWALL`	`Enum`	לא תוגדר כותרת `X-Frame-Options`.
`DEFAULT`	`Enum`	מגדירה את ערך ברירת המחדל עבור הכותרת `X-Frame-Options`, ששומר על הנחות אבטחה רגילות.