আপনার ভিজ্যুয়ালাইজেশন ইভেন্টগুলিকে ফায়ার করতে পারে যা একটি হোস্ট পৃষ্ঠা গ্রহণ করতে নিবন্ধন করতে পারে। ইভেন্টগুলি ব্যবহারকারীর ক্রিয়া দ্বারা বহিস্কার করা যেতে পারে: উদাহরণস্বরূপ একজন ব্যবহারকারী একটি চার্টে ক্লিক করে, বা অভ্যন্তরীণ হতে পারে: উদাহরণস্বরূপ, প্রতি 10 সেকেন্ডে একটি ইভেন্ট ফায়ার করা৷ আপনি একটি জাভাস্ক্রিপ্ট পদ্ধতি নিবন্ধন করতে পারেন যখনই নির্দিষ্ট ইভেন্ট গুলি চালানো হয়, সম্ভবত সেই ইভেন্টের নির্দিষ্ট ডেটা সহ।
প্রতিটি ভিজ্যুয়ালাইজেশন তার নিজস্ব ইভেন্টগুলিকে সংজ্ঞায়িত করে, এবং সেই ভিজ্যুয়ালাইজেশনের ডকুমেন্টেশনে বর্ণনা করা উচিত যখন প্রতিটি ইভেন্ট ফায়ার করা হয়, এর অর্থ কী এবং এটি আপনার ইভেন্ট হ্যান্ডলারকে কী তথ্য পাঠায় (উদাহরণস্বরূপ, অর্গচার্ট ভিজ্যুয়ালাইজেশন দেখুন)। এই পৃষ্ঠাটি বর্ণনা করে কিভাবে একজন ভিজ্যুয়ালাইজেশন স্রষ্টা ইভেন্টগুলিকে ফায়ার করতে পারেন৷ ক্লায়েন্টরা কীভাবে ইভেন্টগুলি পেতে নিবন্ধন করতে পারে তা জানতে, হ্যান্ডলিং ইভেন্ট পৃষ্ঠাটি দেখুন।
একটি ইভেন্ট আছে যে কোনো নির্বাচনযোগ্য ভিজ্যুয়ালাইজেশান ফায়ার করা উচিত: নির্বাচন ইভেন্ট। যাইহোক, এই ইভেন্টের আচরণ এবং অর্থ প্রতিটি ভিজ্যুয়ালাইজেশন দ্বারা সংজ্ঞায়িত করা হয়।
draw পদ্ধতি ব্যবহারকারীর কাছে নিয়ন্ত্রণ ফেরানোর পর অবিলম্বে কোনো ভিজ্যুয়ালাইজেশন ইন্টারঅ্যাকশনের জন্য প্রস্তুত না হলে, ভিজ্যুয়ালাইজেশনটি ফায়ার করা উচিত: প্রস্তুত ইভেন্ট। এই ইভেন্টের সঠিক আচরণ এবং অর্থ রেডি ইভেন্ট বিভাগে সংজ্ঞায়িত করা হয়েছে।
এটি লক্ষ্য করা গুরুত্বপূর্ণ যে ভিজ্যুয়ালাইজেশন API ইভেন্টগুলি স্ট্যান্ডার্ড DOM ইভেন্টগুলি থেকে আলাদা এবং স্বতন্ত্র।
বিষয়বস্তু
একটি ইভেন্ট ফায়ারিং
আপনার ভিজ্যুয়ালাইজেশন থেকে একটি ইভেন্ট ফায়ার করতে, google.visualization.events.trigger() ফাংশনটিতে কল করুন৷ ফাংশন নিম্নলিখিত পরামিতি আশা করে:
- উৎস ভিজ্যুয়ালাইজেশন (সাধারণত এটি
thisমান)। - ইভেন্টের নাম (স্ট্রিং)।
- ঘটনার বিবরণ (অবজেক্ট)। নির্দিষ্ট ইভেন্টের বিবরণের একটি ঐচ্ছিক মানচিত্র (নাম/মান)।
নিম্নলিখিত উদাহরণটি দেখায় কিভাবে একটি ভিজ্যুয়ালাইজেশন নির্বাচিত ইভেন্টকে নিক্ষেপ করে:
MyVisualization.prototype.onclick = function(rowIndex) {
this.highlightRow(this.selectedRow, false); // Clear previous selection
this.highlightRow(rowIndex, true); // Highlight new selection
// Save the selected row index in case getSelection is called.
this.selectedRow = rowIndex;
// Fire a select event.
google.visualization.events.trigger(this, 'select', {});
};
হোস্টিং পৃষ্ঠাগুলি google.visualization.events.addListener() বা google.visualization.events.addOneTimeListener() এ কল করে আপনার ইভেন্টগুলি পেতে নিবন্ধন করতে পারে৷ আপনি যে কোনো ইভেন্ট ফায়ার করেন তা পুঙ্খানুপুঙ্খভাবে নথিভুক্ত করতে ভুলবেন না।
ইভেন্ট নির্বাচন করুন
"নির্বাচন" ইভেন্ট হল একটি সাধারণ ইভেন্ট যা ব্যবহারকারীর মাউস ক্লিকের প্রতিক্রিয়ায় অনেক ভিজ্যুয়ালাইজেশন দ্বারা নিক্ষিপ্ত হয়। আপনি যদি মাউস ক্লিকের প্রতিক্রিয়া হিসাবে একটি ইভেন্ট ফায়ার করতে চান, তাহলে আপনাকে এখানে বর্ণিত আদর্শ পদ্ধতিতে "নির্বাচন" ইভেন্টটি বাস্তবায়ন করা উচিত:
- ব্যবহারকারী যখন ভিজ্যুয়ালাইজেশনের মধ্যে কিছু ডেটা নির্বাচন করে তখন 'নির্বাচন' নামে একটি ইভেন্ট ফায়ার করুন। ইভেন্ট শ্রবণ ফাংশন কোনো আর্গুমেন্ট পাঠায় না.
- লিঙ্কড নথি বিভাগে বর্ণিত
getSelection()পদ্ধতিটি প্রকাশ করুন। এই পদ্ধতিটি ব্যবহারকারীর নির্বাচিত ডেটা উপাদানগুলির সূচী ফেরত দেবে। - রেফারেন্স বিভাগে বর্ণিত একটি
setSelection()পদ্ধতি প্রকাশ করুন। এছাড়াও কিভাবে ইভেন্ট পরিচালনা করতে হয় তা জানতে হ্যান্ডলিং ইভেন্ট পৃষ্ঠাটি দেখুন।
প্রস্তুত ইভেন্ট
যেকোন ভিজ্যুয়ালাইজেশনের একটি "প্রস্তুত" ইভেন্ট চালু করা উচিত যা একটি আদর্শ উপায়ে কাজ করে যাতে বিকাশকারীকে জানাতে পারে যে ভিজ্যুয়ালাইজেশনটি পদ্ধতি নামক প্রক্রিয়ার জন্য প্রস্তুত। (তবে, একটি ভিজ্যুয়ালাইজেশন এইভাবে আচরণ করার কোন পরম প্রয়োজন নেই; আপনার ভিজ্যুয়ালাইজেশনের জন্য ডকুমেন্টেশন পরীক্ষা করুন)।
সাধারণভাবে, "প্রস্তুত" ইভেন্টটি প্রকাশ করে এমন ভিজ্যুয়ালাইজেশনগুলি নিম্নলিখিত বৈশিষ্ট্যগুলির সাথে ডিজাইন করা হয়েছে:
- প্রস্তুত ইভেন্ট হ্যান্ডলারের কাছে কোনো বৈশিষ্ট্য পাস করে না (আপনার ফাংশন হ্যান্ডলারের কাছে কোনো পরামিতি পাস করার আশা করা উচিত নয়)।
- ভিজ্যুয়ালাইজেশন মিথস্ক্রিয়া জন্য ভিজ্যুয়ালাইজেশন প্রস্তুত হওয়ার পরে প্রস্তুত ইভেন্ট ফায়ার করা উচিত । যদি ভিজ্যুয়ালাইজেশনের অঙ্কনটি অ্যাসিঙ্ক্রোনাস হয়, তবে এটি গুরুত্বপূর্ণ যে ইভেন্টটি যখন মিথস্ক্রিয়া পদ্ধতিগুলিকে প্রকৃতপক্ষে কল করা যেতে পারে, এবং শুধুমাত্র যখন
drawপদ্ধতি শেষ হয় তখন নয়। - এই ইভেন্টে একজন শ্রোতা যোগ করা
drawপদ্ধতিতে কল করার আগে করা উচিত, কারণ অন্যথায় শ্রোতা সেট আপ হওয়ার আগেই ইভেন্টটি বরখাস্ত করা হতে পারে এবং আপনি এটি ধরতে পারবেন না। - প্রস্তুত ইভেন্ট ফায়ার করার আগে ইন্টারঅ্যাকশন পদ্ধতিতে কল করে, আপনি একটি ঝুঁকি নিতে পারেন যে এই পদ্ধতিগুলি সঠিকভাবে কাজ করবে না।
কনভেনশন হল যে ভিজ্যুয়ালাইজেশনগুলি যেগুলি একটি "প্রস্তুত" ইভেন্ট চালু করে না সেগুলি draw পদ্ধতি শেষ হওয়ার সাথে সাথে মিথস্ক্রিয়া করার জন্য প্রস্তুত হয় এবং ব্যবহারকারীকে নিয়ন্ত্রণ ফিরিয়ে দেয়।