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