דף זה תורגם על ידי Cloud Translation API.

Class HtmlService

שירות להחזרת HTML ותוכן טקסט אחר מסקריפט.

מטעמי אבטחה, סקריפטים לא יכולים להחזיר תוכן ישירות לדפדפן. במקום זאת, הם צריכים לנקות את ה-HTML כדי שלא יהיה אפשר לבצע באמצעותו פעולות זדוניות. בתיאור של HtmlOutput מפורטות המגבלות על מה שאפשר להחזיר.

מאפיינים

נכס	סוג	תיאור
`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`	הפונקציה מקבלת את המחרוזת של סוכן המשתמש בדפדפן הנוכחי.

מסמכים מפורטים

`createHtmlOutput()`

יצירת אובייקט HtmlOutput חדש שניתן להחזיר מהסקריפט.

const output = HtmlService.createHtmlOutput();

חזרה

HtmlOutput – האובייקט החדש של HtmlOutput

`createHtmlOutput(blob)`

יצירת אובייקט HtmlOutput חדש ממשאב BlobSource.

function createFromBlob(blob) {
  const output = HtmlService.createHtmlOutput(blob);
  return output;
}

פרמטרים

שם	סוג	תיאור
`blob`	`BlobSource`	האובייקט שממנו רוצים לקבל את ה-HTML

חזרה

HtmlOutput – האובייקט החדש של HtmlOutput

זריקות

Error – אם ה-blob לא מכיל HTML או שה-HTML פגום

`createHtmlOutput(html)`

יצירת אובייקט HtmlOutput חדש שניתן להחזיר מהסקריפט.

const output = HtmlService.createHtmlOutput('<b>Hello world!</b>');

פרמטרים

שם	סוג	תיאור
`html`	`String`	התוכן להצגה

חזרה

HtmlOutput – האובייקט החדש של HtmlOutput

זריקות

Error – אם ה-HTML לא תקין

`createHtmlOutputFromFile(filename)`

יצירת אובייקט HtmlOutput חדש מקובץ בעורך הקוד.

const output = HtmlService.createHtmlOutputFromFile('myPage');

פרמטרים

שם	סוג	תיאור
`filename`	`String`	שם הקובץ שבו רוצים להשתמש

חזרה

HtmlOutput – האובייקט החדש של HtmlOutput

זריקות

Error – אם הקובץ לא נמצא או שהקוד ב-HTML שלו לא תקין

`createTemplate(blob)`

יצירת אובייקט HtmlTemplate חדש ממשאב BlobSource.

function createFromBlob(blob) {
  const template = HtmlService.createTemplate(blob);
  const output = template.evaluate();
  return output;
}

פרמטרים

שם	סוג	תיאור
`blob`	`BlobSource`	האובייקט שממנו רוצים לחלץ את ה-HTML.

חזרה

HtmlTemplate – האובייקט החדש של HtmlTemplate

זריקות

Error – אם ה-blob לא מכיל HTML

`createTemplate(html)`

יצירת אובייקט HtmlTemplate חדש שניתן להחזיר מהסקריפט.

const template = HtmlService.createTemplate(
    '<b>The time is &lt;?= new Date() ?&gt;</b>',
);

פרמטרים

שם	סוג	תיאור
`html`	`String`	התוכן של התבנית

חזרה

HtmlTemplate – האובייקט החדש של HtmlTemplate

`createTemplateFromFile(filename)`

יצירת אובייקט HtmlTemplate חדש מקובץ בעורך הקוד.

const template = HtmlService.createTemplateFromFile('myTemplate');

פרמטרים

שם	סוג	תיאור
`filename`	`String`	שם הקובץ שבו רוצים להשתמש

חזרה

HtmlTemplate – האובייקט החדש של HtmlTemplate

זריקות

Error – אם הקובץ לא נמצא

`getUserAgent()`

הפונקציה מקבלת את המחרוזת של סוכן המשתמש בדפדפן הנוכחי. הפונקציה מחזירה את הערך null ברוב ההפעלות של הסקריפט, אם לא נעשה בה שימוש בפונקציה doGet() או doPost() של אפליקציית האינטרנט.

חזרה

String – מחרוזת סוכן המשתמש