HTML Service

HTML

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