שירות להחזרת תוכן HTML ותוכן טקסט אחר מסקריפט.
מטעמי אבטחה, סקריפטים לא יכולים להחזיר תוכן ישירות לדפדפן. במקום זאת, עליהם לנקות את ה-HTML כך שלא יוכל לבצע פעולות זדוניות. בתיאור של HtmlOutput
מפורטות המגבלות שחלות על הפריטים שאפשר להחזיר.
תכונות
נכס | תיאור | התיאור |
---|---|---|
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 | הפונקציה מקבלת את מחרוזת הסוכן המשתמש של הדפדפן הנוכחי. |
תיעוד מפורט
createHtmlOutput()
יוצר אובייקט HtmlOutput
חדש שניתן להחזיר מהסקריפט.
var output = HtmlService.createHtmlOutput();
החזרות
HtmlOutput
- אובייקט HtmlOutput החדש
createHtmlOutput(blob)
יוצר אובייקט HtmlOutput
חדש ממשאב BlobSource
.
function createFromBlob(blob) { var output = HtmlService.createHtmlOutput(blob); return output; }
פרמטרים
שם | תיאור | התיאור |
---|---|---|
blob | BlobSource | את האובייקט שממנו יש להוציא את ה-HTML |
החזרות
HtmlOutput
– האובייקט החדש HtmlOutput
קליעות
Error
– אם ה-blob אין HTML או שה-HTML לא תקין
createHtmlOutput(html)
יוצר אובייקט HtmlOutput
חדש שניתן להחזיר מהסקריפט.
var output = HtmlService.createHtmlOutput('<b>Hello world!</b>');
פרמטרים
שם | תיאור | התיאור |
---|---|---|
html | String | את התוכן שיש להציג |
החזרות
HtmlOutput
- אובייקט HtmlOutput החדש
קליעות
Error
- אם פורמט ה-HTML שגוי
createHtmlOutputFromFile(filename)
יוצר אובייקט HtmlOutput
חדש מקובץ בעורך הקוד.
var output = HtmlService.createHtmlOutputFromFile('myPage');
פרמטרים
שם | תיאור | התיאור |
---|---|---|
filename | String | שם הקובץ לשימוש |
החזרות
HtmlOutput
– האובייקט החדש HtmlOutput
קליעות
Error
– אם הקובץ לא נמצא או אם קוד ה-HTML שבו שגוי
createTemplate(blob)
יוצר אובייקט HtmlTemplate
חדש ממשאב BlobSource
.
function createFromBlob(blob) { var template = HtmlService.createTemplate(blob); return output; }
פרמטרים
שם | תיאור | התיאור |
---|---|---|
blob | BlobSource | האובייקט שממנו יש להוציא את ה-HTML. |
החזרות
HtmlTemplate
– האובייקט החדש HtmlTemplate
קליעות
Error
– אם ה-blob אינו מכיל HTML
createTemplate(html)
יוצר אובייקט HtmlTemplate
חדש שניתן להחזיר מהסקריפט.
var template = HtmlService.createTemplate('<b>The time is <?= new Date() ?></b>');
פרמטרים
שם | תיאור | התיאור |
---|---|---|
html | String | את תוכן התבנית |
החזרות
HtmlTemplate
– האובייקט החדש HtmlTemplate
createTemplateFromFile(filename)
יוצר אובייקט HtmlTemplate
חדש מקובץ בעורך הקוד.
var template = HtmlService.createTemplateFromFile('myTemplate');
פרמטרים
שם | תיאור | התיאור |
---|---|---|
filename | String | שם הקובץ לשימוש |
החזרות
HtmlTemplate
– האובייקט החדש HtmlTemplate
קליעות
Error
– אם הקובץ לא נמצא
getUserAgent()
הפונקציה מקבלת את מחרוזת הסוכן המשתמש של הדפדפן הנוכחי. הפונקציה מחזירה את הערך null
לרוב הפעלות הסקריפט, אם לא נעשה בה שימוש בפונקציה doGet()
או doPost()
של אפליקציית אינטרנט.
החזרות
String
- המחרוזת של סוכן המשתמש