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