HTML Service

HTML

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

.

שיעורים

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

HtmlOutputMetaTag

Methods

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

HtmlService

מאפיינים

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

מאפיינים

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

XFrameOptionsMode

מאפיינים

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