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