বেশিরভাগ এডিটর অ্যাড-অনের জন্য, ডায়ালগ উইন্ডো এবং সাইডবার প্যানেল হল প্রাথমিক অ্যাড-অন ইউজার ইন্টারফেস। স্ট্যান্ডার্ড HTML এবং CSS ব্যবহার করে উভয়ই সম্পূর্ণরূপে কাস্টমাইজযোগ্য, এবং ব্যবহারকারী যখন সাইডবার বা ডায়ালগের সাথে ইন্টারঅ্যাক্ট করে তখন আপনি অ্যাপস স্ক্রিপ্ট ফাংশন চালানোর জন্য অ্যাপস স্ক্রিপ্টের ক্লায়েন্ট-সার্ভার যোগাযোগ মডেল ব্যবহার করতে পারেন। আপনার অ্যাড-অন একাধিক সাইডবার এবং ডায়ালগ সংজ্ঞায়িত করতে পারে, তবে অ্যাড-অন একবারে কেবল একটি প্রদর্শন করতে পারে।
যখন আপনি ব্যবহারকারীকে এডিটরের সাথে ইন্টারঅ্যাক্ট করতে বাধা দিতে চান যতক্ষণ না তারা অ্যাড-অন ইন্টারফেসে কিছু পছন্দ করে, তখন একটি ডায়ালগ ব্যবহার করুন; অন্যথায় একটি সাইডবার ব্যবহার করুন।
সংলাপ
ডায়ালগ হল উইন্ডো প্যানেল যা প্রাথমিক সম্পাদকের বিষয়বস্তুকে ওভারলে করে। অ্যাপস স্ক্রিপ্ট ডায়ালগগুলি মোডাল; যখন সেগুলি খোলা থাকে তখন ব্যবহারকারী সম্পাদক ইন্টারফেসের অন্যান্য উপাদানগুলির সাথে ইন্টারঅ্যাক্ট করতে পারে না। আপনি ডায়ালগের বিষয়বস্তু এবং আকার কাস্টমাইজ করতে পারেন।
আপনি অ্যাপস স্ক্রিপ্ট কাস্টম ডায়ালগের মতোই অ্যাড-অন ডায়ালগ তৈরি করতে পারেন; সাধারণভাবে প্রস্তাবিত পদ্ধতিটি হল নিম্নলিখিত:
- আপনার ডায়ালগের HTML কাঠামো, CSS এবং ক্লায়েন্ট-সাইড জাভাস্ক্রিপ্ট আচরণ সংজ্ঞায়িত করে এমন একটি স্ক্রিপ্ট প্রজেক্ট ফাইল তৈরি করুন। ডায়ালগ সংজ্ঞায়িত করার সময়, সম্পাদক অ্যাড-অন স্টাইল নির্দেশিকা পড়ুন।
- আপনার সার্ভার-সাইড কোডে যেখানে আপনি ডায়ালগটি খুলতে চান, সেখানে
HtmlService.createHtmlOutputFromFile(filename)কল করে একটিHtmlOutputঅবজেক্ট তৈরি করুন যা ডায়ালগের প্রতিনিধিত্ব করে। অন্যথায়, যদি আপনি templated HTML ব্যবহার করেন তবে আপনিHtmlService.createTemplateFromFile(filename)কল করে একটি টেমপ্লেট তৈরি করতে পারেন এবং তারপরHtmlTemplate.evaluate()কল করে এটিকেHtmlOutputঅবজেক্টে রূপান্তর করতে পারেন। -
HtmlOutputব্যবহার করে ডায়ালগটি প্রদর্শন করতেUi.showModalDialog(htmlOutput, dialogTitle)এ কল করুন।
খোলা থাকাকালীন ডায়ালগগুলি সার্ভার-সাইড স্ক্রিপ্ট সাসপেন্ড করে না। ক্লায়েন্ট-সাইড জাভাস্ক্রিপ্ট google.script.run() এবং সংশ্লিষ্ট হ্যান্ডলার ফাংশন ব্যবহার করে সার্ভার-সাইডের সাথে অ্যাসিঙ্ক্রোনাস কল করতে পারে। আরও বিস্তারিত জানার জন্য, ক্লায়েন্ট-টু-সার্ভার যোগাযোগ দেখুন।
ফাইল-খোলা ডায়ালগ
ফাইল-ওপেন ডায়ালগ হল আগে থেকে তৈরি ডায়ালগ যা আপনার ব্যবহারকারীদের তাদের Google ড্রাইভ থেকে ফাইল নির্বাচন করতে দেয়। আপনি আপনার অ্যাড-অনে একটি ফাইল-ওপেন ডায়ালগ যুক্ত করতে পারেন এটি ডিজাইন করার প্রয়োজন ছাড়াই, তবে এর জন্য কিছু অতিরিক্ত কনফিগারেশন প্রয়োজন। গুগল পিকার API সক্ষম করার জন্য আপনার অ্যাড-অনের ক্লাউড প্ল্যাটফর্ম প্রকল্পেও অ্যাক্সেস প্রয়োজন।
সম্পূর্ণ বিবরণের জন্য, ফাইল-খোলা ডায়ালগ দেখুন।
সাইডবার
সাইডবার হল এমন প্যানেল যা এডিটর ইন্টারফেসের ডানদিকে প্রদর্শিত হয় এবং এটি অ্যাড-অন ইন্টারফেসের সবচেয়ে সাধারণ ধরণ। ডায়ালগের বিপরীতে, আপনি সাইডবার খোলা থাকাকালীন এডিটর ইন্টারফেসের অন্যান্য উপাদানগুলির সাথে ইন্টারঅ্যাক্ট চালিয়ে যেতে পারেন। সাইডবারগুলির একটি নির্দিষ্ট প্রস্থ থাকে, তবে আপনি তাদের বিষয়বস্তু কাস্টমাইজ করতে পারেন।
আপনি অ্যাপস স্ক্রিপ্ট কাস্টম সাইডবারের মতোই অ্যাড-অন সাইডবার তৈরি করতে পারেন; সাধারণভাবে প্রস্তাবিত পদ্ধতিটি হল নিম্নলিখিত:
- আপনার সাইডবারের HTML কাঠামো, CSS এবং ক্লায়েন্ট-সাইড জাভাস্ক্রিপ্ট আচরণ সংজ্ঞায়িত করে এমন একটি স্ক্রিপ্ট প্রজেক্ট ফাইল তৈরি করুন। সাইডবার সংজ্ঞায়িত করার সময়, সম্পাদক অ্যাড-অন স্টাইল নির্দেশিকা পড়ুন।
আপনার সার্ভার-সাইড কোডে যেখানে আপনি সাইডবারটি খুলতে চান, সেখানে
HtmlService.createHtmlOutputFromFile(filename)কল করে সাইডবারের প্রতিনিধিত্বকারী একটিHtmlOutputঅবজেক্ট তৈরি করুন। বিকল্পভাবে, যদি আপনি টেমপ্লেটযুক্ত HTML ব্যবহার করেন তবে আপনি একটি টেমপ্লেট তৈরি করতেHtmlService.createTemplateFromFile(filename)কল করতে পারেন এবং তারপরHtmlTemplate.evaluate()কল করে এটিকেHtmlOutputঅবজেক্টে রূপান্তর করতে পারেন।HtmlOutputব্যবহার করে সাইডবার প্রদর্শন করতেUi.showSidebar(htmlOutput)এ কল করুন।
সাইডবারগুলি খোলা থাকাকালীন সার্ভার-সাইড স্ক্রিপ্ট সাসপেন্ড করে না। ক্লায়েন্ট-সাইড জাভাস্ক্রিপ্ট google.script.run() এবং সংশ্লিষ্ট হ্যান্ডলার ফাংশন ব্যবহার করে সার্ভার-সাইডের সাথে অ্যাসিঙ্ক্রোনাস কল করতে পারে। আরও বিস্তারিত জানার জন্য, ক্লায়েন্ট-টু-সার্ভার যোগাযোগ দেখুন।