google.script.host
הוא ממשק API אסינכרוני של JavaScript בצד הלקוח, שיכול לבצע פעולות עם תיבות דו-שיח או סרגלי צד ב-Google Docs, Sheets או Forms שמכילים דפי שירות HTML. כדי להפעיל פונקציות בצד השרת מקוד בצד הלקוח, משתמשים ב-google.script.run
. למידע נוסף, קראו את המדריך לתקשורת עם פונקציות שרת בשירות HTML.
תכונות
נכס | התיאור |
---|---|
origin | הכתובת מספקת את הדומיין המארח, כך שסקריפטים יכולים להגדיר את המקור בצורה נכונה. |
שיטות
שיטה | סוג הערך שמוחזר | תיאור קצר |
---|---|---|
close() |
void |
סוגר את תיבת הדו-שיח או את סרגל הצד הנוכחיים. |
editor.focus() |
void |
מעביר את המיקוד של הדפדפן מתיבת הדו-שיח או מסרגל הצד לעורך Google Docs, Sheets או Forms. |
setHeight(height) |
void |
מגדיר את הגובה של תיבת הדו-שיח הנוכחית. |
setWidth(width) |
void |
מגדיר את הרוחב של תיבת הדו-שיח הנוכחית. |
תיעוד מפורט
close()
סוגר את תיבת הדו-שיח או את סרגל הצד הנוכחיים.
Code.gs
function onOpen(e) { SpreadsheetApp.getUi() // Or DocumentApp or FormApp. .createMenu('Sidebar').addItem('Show', 'showSidebar').addToUi(); } function showSidebar() { var html = HtmlService.createHtmlOutputFromFile('Index'); SpreadsheetApp.getUi() // Or DocumentApp or FormApp. .showSidebar(html); }
Index.html
<input type="button" value="Close" onclick="google.script.host.close()" />
editor.focus()
מעביר את המיקוד של הדפדפן מתיבת הדו-שיח או מסרגל הצד לעורך Google Docs, Sheets או Forms.
Code.gs
function onOpen(e) { SpreadsheetApp.getUi() // Or DocumentApp or FormApp. .createMenu('Sidebar').addItem('Show', 'showSidebar').addToUi(); } function showSidebar() { var html = HtmlService.createHtmlOutputFromFile('Index'); SpreadsheetApp.getUi() // Or DocumentApp or FormApp. .showSidebar(html); }
Index.html
<input type="button" value="Switch focus" onclick="google.script.host.editor.focus()" />
setHeight(height)
מגדיר את הגובה של תיבת הדו-שיח הנוכחית.
Code.gs
function onOpen(e) { SpreadsheetApp.getUi() // Or DocumentApp or FormApp. .createMenu('Dialog').addItem('Show', 'showDialog').addToUi(); } function showDialog() { var html = HtmlService.createHtmlOutputFromFile('Index') .setWidth(300) .setHeight(200); SpreadsheetApp.getUi() // Or DocumentApp or FormApp. .showModalDialog(html, 'Dialog title'); }
Index.html
<script> function resizeDialog(width, height) { google.script.host.setWidth(width); google.script.host.setHeight(height); } </script> <input type="button" value="Resize dialog" onclick="resizeDialog(450, 300)" />
פרמטרים
שם | תיאור | התיאור |
---|---|---|
height | Integer | הגובה החדש, בפיקסלים |
setWidth(width)
מגדיר את הרוחב של תיבת הדו-שיח הנוכחית.
Code.gs
function onOpen(e) { SpreadsheetApp.getUi() // Or DocumentApp or FormApp. .createMenu('Dialog').addItem('Show', 'showDialog').addToUi(); } function showDialog() { var html = HtmlService.createHtmlOutputFromFile('Index') .setWidth(300) .setHeight(200); SpreadsheetApp.getUi() // Or DocumentApp or FormApp. .showModalDialog(html, 'Dialog title'); }
Index.html
<script> function resizeDialog(width, height) { google.script.host.setWidth(width); google.script.host.setHeight(height); } </script> <input type="button" value="Resize dialog" onclick="resizeDialog(450, 300)" />
פרמטרים
שם | תיאור | התיאור |
---|---|---|
width | Integer | הרוחב החדש, בפיקסלים |