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

Class HtmlService

שירות להחזרת תוכן 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 &lt;?= new Date() ?&gt;</b>');

פרמטרים

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

החזרות

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

`createTemplateFromFile(filename)`

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

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

פרמטרים

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

החזרות

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

קליעות

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

`getUserAgent()`

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

החזרות

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