एडिटर ऐड-ऑन के लिए डायलॉग और साइडबार

ज़्यादातर एडिटर ऐड-ऑन के लिए, डायलॉग विंडो और साइडबार पैनल, मुख्य ऐड-ऑन यूज़र इंटरफ़ेस हैं. स्टैंडर्ड एचटीएमएल और सीएसएस का इस्तेमाल करके, दोनों को पूरी तरह से पसंद के मुताबिक बनाया जा सकता है. साथ ही, आपको Apps Script क्लाइंट-सर्वर कम्यूनिकेशन मॉडल का इस्तेमाल करें. आपका ऐड-ऑन एक से ज़्यादा साइडबार और डायलॉग बॉक्स तय कर सकता है, लेकिन ऐड-ऑन दिख सकता है एक बार में सिर्फ़ एक.

जब उपयोगकर्ता को, एडिटर के साथ इंटरैक्ट करने से तब तक रोकना है, जब तक कि वह ऐड-ऑन इंटरफ़ेस में कोई विकल्प चुनने के लिए, डायलॉग बॉक्स का इस्तेमाल करें; नहीं तो, किसी साइडबार.

डायलॉग

डायलॉग ऐसे विंडो पैनल होते हैं जो प्राइमरी एडिटर के कॉन्टेंट को ओवरले करते हैं. Apps स्क्रिप्ट डायलॉग मोडल होते हैं; जब इन्हें खोला जाता है, तो उपयोगकर्ता एडिटर इंटरफ़ेस के दूसरे एलिमेंट शामिल हैं. कॉन्टेंट और साइज़ को अपनी पसंद के मुताबिक बनाया जा सकता है. दिखाई दे सकता है.

ऐड-ऑन डायलॉग, Apps Script की तरह ही बनाए जाते हैं कस्टम डायलॉग; सामान्य यह तरीका अपनाने का सुझाव दिया जाता है:

1. एक ऐसी स्क्रिप्ट प्रोजेक्ट फ़ाइल बनाएं जो आपके डायलॉग के एचटीएमएल स्ट्रक्चर को तय करती हो, सीएसएस, और क्लाइंट-साइड JavaScript बिहेवियर. संवाद परिभाषित करते समय, देखें एडिटर ऐड-ऑन की स्टाइल से जुड़े दिशा-निर्देश पढ़ें.
2. अपने सर्वर साइड कोड में, जहां आपको डायलॉग बॉक्स खोलना है वहां कॉल करें HtmlService.createHtmlOutputFromFile(filename) HtmlOutput बनाने के लिए ऑब्जेक्ट, जो डायलॉग दिखा रहा है. वैकल्पिक रूप से, अगर आपको टेंप्लेट एचटीएमएल में मौजूद है जिसे कॉल किया जा सकता है HtmlService.createTemplateFromFile(filename) और फिर टेंप्लेट बनाने के लिए HtmlTemplate.evaluate() इसे एक HtmlOutput ऑब्जेक्ट.
3. Ui.showModalDialog(htmlOutput, dialogTitle) पर कॉल करें उसका इस्तेमाल करके डायलॉग दिखाने के लिए HtmlOutput.

डायलॉग बॉक्स, सर्वर-साइड स्क्रिप्ट के खुले होने पर उन्हें निलंबित नहीं करते. कॉन्टेंट बनाने क्लाइंट-साइड JavaScript, सर्वर-साइड को एसिंक्रोनस कॉल कर सकता है google.script.run() का इस्तेमाल करके और जुड़े हुए हैंडलर फ़ंक्शन. ज़्यादा जानकारी के लिए, यह देखें क्लाइंट-टू-सर्वर कम्यूनिकेशन.

फ़ाइल खोलने के डायलॉग

फ़ाइल खोलने वाले डायलॉग पहले से बने हुए डायलॉग होते हैं. इनकी मदद से, उपयोगकर्ता फ़ाइलें चुन सकते हैं Google Drive से कॉपी की जा सकती हैं. ऐड-ऑन के बिना भी, 'फ़ाइल खोलें' डायलॉग बॉक्स जोड़ा जा सकता है जिसे डिज़ाइन करने की ज़रूरत है, लेकिन इसके लिए कुछ अतिरिक्त कॉन्फ़िगरेशन की ज़रूरत होती है. आपको यह भी ऐड-ऑन के ऐक्सेस की ज़रूरत होती है Cloud Platform प्रोजेक्ट ताकि Google पिकर एपीआई को चालू किया जा सके.

पूरी जानकारी के लिए, फ़ाइल-ओपन डायलॉग देखें.

साइडबार

साइडबार ऐसे पैनल होते हैं जो एडिटर इंटरफ़ेस की दाईं ओर दिखते हैं और सबसे सामान्य ऐड-ऑन इंटरफ़ेस हैं. डायलॉग के उलट, इस प्रोसेस को जारी रखा जा सकता है एडिटर इंटरफ़ेस के दूसरे एलिमेंट के साथ इंटरैक्ट करने के लिए, जबकि साइडबार खोलें. साइडबार की चौड़ाई तय होती है, लेकिन आप इसके कॉन्टेंट को अपनी पसंद के मुताबिक बना सकते हैं.

ऐड-ऑन साइडबार को Apps Script की तरह ही बनाया जाता है कस्टम साइडबार; सामान्य यह तरीका अपनाने का सुझाव दिया जाता है:

1. एक ऐसी स्क्रिप्ट प्रोजेक्ट फ़ाइल बनाएं जो आपके साइडबार के एचटीएमएल के स्ट्रक्चर को परिभाषित करे, सीएसएस, और क्लाइंट-साइड JavaScript बिहेवियर. साइडबार परिभाषित करते समय, देखें एडिटर ऐड-ऑन की स्टाइल से जुड़े दिशा-निर्देश पढ़ें.

2. अपने सर्वर-साइड कोड में जहां आपको साइडबार खोलना है, वहां कॉल करें HtmlService.createHtmlOutputFromFile(filename) HtmlOutput बनाने के लिए ऑब्जेक्ट, जो साइडबार को दिखा रहा है. वैकल्पिक रूप से, अगर आपको टेंप्लेट एचटीएमएल में मौजूद है जिसे कॉल किया जा सकता है HtmlService.createTemplateFromFile(filename) और फिर टेंप्लेट बनाने के लिए HtmlTemplate.evaluate() इसे एक HtmlOutput ऑब्जेक्ट.

3. Ui.showSidebar(htmlOutput) पर कॉल करें उसका इस्तेमाल करके साइडबार को प्रदर्शित करने के लिए HtmlOutput.

साइडबार के खुले होने पर, वह सर्वर-साइड स्क्रिप्ट को निलंबित नहीं करता है. कॉन्टेंट बनाने क्लाइंट-साइड JavaScript, सर्वर-साइड को एसिंक्रोनस कॉल कर सकता है google.script.run() का इस्तेमाल करके और जुड़े हुए हैंडलर फ़ंक्शन. ज़्यादा जानकारी के लिए, यह देखें क्लाइंट-टू-सर्वर कम्यूनिकेशन.