HTML Service

HTML

השירות הזה מאפשר לאפליקציות 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 זה, באמצעות escape לפי הקשר.
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

תכונות

נכסתיאורהתיאור
SandboxModeSandboxModeטיפוסים בני מנייה (enum) שמייצג את מצבי ארגז החול שאפשר להשתמש בהם לסקריפטים של HtmlService בצד הלקוח.
XFrameOptionsModeXFrameOptionsModeטיפוסים בני מנייה (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

תכונות

נכסתיאורהתיאור
EMULATEDEnumמצב ארגז חול מדור קודם שמדמה את המצב הקפדני של ECMAScript 5 תוך שימוש בתכונות שזמינות ב-ECMAScript 3 בלבד.
IFRAMEEnumמצב ארגז חול שמשתמש בהרצה בארגז חול (sandboxing) של iframe במקום בטכנולוגיית ארגז חול של Caja, שמשמשת את המצבים EMULATED ו-NATIVE.
NATIVEEnumמצב ארגז חול שמבוסס על מצב קפדני של ECMAScript 5.

XFrameOptionsMode

תכונות

נכסתיאורהתיאור
ALLOWALLEnumלא תוגדר כותרת X-Frame-Options.
DEFAULTEnumהערך הזה מגדיר את ערך ברירת המחדל לכותרת X-Frame-Options, שמשמרת הנחות אבטחה רגילות.