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

מסמכי תיעוד מפורטים

`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()`

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

חזרה

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