ওভারভিউ
একটি VegaChart হল ভেগা ভিজ্যুয়ালাইজেশন ব্যাকরণ ব্যবহার করে তৈরি করা হতে পারে এমন অনেক সম্ভাব্য ভিজ্যুয়ালাইজেশনের মধ্যে একটি, যা ইন্টারেক্টিভ ভিজ্যুয়ালাইজেশন ডিজাইন তৈরি, সংরক্ষণ এবং ভাগ করার জন্য একটি ঘোষণামূলক ভাষা। Vega-এর সাহায্যে, আপনি JSON ফর্ম্যাটে একটি ভিজ্যুয়ালাইজেশনের ভিজ্যুয়াল চেহারা এবং ইন্টারেক্টিভ আচরণ বর্ণনা করতে পারেন এবং ক্যানভাস বা SVG ব্যবহার করে ওয়েব-ভিত্তিক ভিউ তৈরি করতে পারেন।
একটি VegaChart আঁকার সময়, আপনাকে অবশ্যই বিকল্পগুলির মধ্যে ভেগা ভিজ্যুয়ালাইজেশন ব্যাকরণে চার্টটি কীভাবে তৈরি করতে হবে তার একটি স্পেসিফিকেশন অন্তর্ভুক্ত করতে হবে। এই জাতীয় নির্দিষ্টকরণের কয়েকটি উদাহরণ নীচে অন্তর্ভুক্ত করা হয়েছে, এবং আরও কয়েকটি উদাহরণ VegaChart উদাহরণ পৃষ্ঠায় পাওয়া যাবে।
দ্রষ্টব্য: যদিও Google চার্ট VegaChart যেকোন Vega চার্ট আঁকতে পারে যা আপনি একটি Vega JSON স্পেসিফিকেশন ( উদাহরণ গ্যালারিতে সবকিছু সহ) দিয়ে নির্দিষ্ট করতে পারেন, তবে Vega API- তে কল করার জন্য অতিরিক্ত বৈশিষ্ট্যগুলি এখনও উপলব্ধ নয়৷
একটি সহজ উদাহরণ, বার চার্ট
এখানে একটি VegaChart এর একটি সাধারণ উদাহরণ যা একটি বার চার্ট আঁকে। ( মূল উদাহরণ , একটি বিশদ টিউটোরিয়াল , এবং ভেগা চার্ট সম্পাদকের বার চার্ট দেখুন।)
যদিও এটি Google চার্টে একটি বার চার্ট তৈরি করার আরেকটি উপায় উপস্থাপন করে, আমরা এই VegaChart-এর উপর ভিত্তি করে একটি নতুন বাস্তবায়নে অন্যান্য বার এবং কলাম চার্টের সমস্ত বৈশিষ্ট্যকে একীভূত করার পরিকল্পনা করছি৷
এই উদাহরণে, মনে রাখবেন যে 'ডেটা' বিকল্পটি নিম্নলিখিতগুলির সাথে প্রতিস্থাপিত হয়েছে, যা 'টেবিল' নামক অন্য ডেটা অবজেক্টের জন্য 'উৎস' হিসাবে ড্র কল দ্বারা প্রদত্ত 'ডেটাটেবল' ব্যবহার করে এবং 'টেবিল' ব্যবহার করা হয় ভেগা স্পেকের অবশিষ্টাংশ।
'data': [{'name': 'table', 'source': 'datatable'}],
<html>
<head>
<script src='https://www.gstatic.com/charts/loader.js'></script>
<script>
google.charts.load('upcoming', {'packages': ['vegachart']}).then(drawChart);
function drawChart() {
const dataTable = new google.visualization.DataTable();
dataTable.addColumn({type: 'string', 'id': 'category'});
dataTable.addColumn({type: 'number', 'id': 'amount'});
dataTable.addRows([
['A', 28],
['B', 55],
['C', 43],
['D', 91],
['E', 81],
['F', 53],
['G', 19],
['H', 87],
]);
const options = {
"vega": {
"$schema": "https://vega.github.io/schema/vega/v4.json",
"width": 500,
"height": 200,
"padding": 5,
'data': [{'name': 'table', 'source': 'datatable'}],
"signals": [
{
"name": "tooltip",
"value": {},
"on": [
{"events": "rect:mouseover", "update": "datum"},
{"events": "rect:mouseout", "update": "{}"}
]
}
],
"scales": [
{
"name": "xscale",
"type": "band",
"domain": {"data": "table", "field": "category"},
"range": "width",
"padding": 0.05,
"round": true
},
{
"name": "yscale",
"domain": {"data": "table", "field": "amount"},
"nice": true,
"range": "height"
}
],
"axes": [
{ "orient": "bottom", "scale": "xscale" },
{ "orient": "left", "scale": "yscale" }
],
"marks": [
{
"type": "rect",
"from": {"data":"table"},
"encode": {
"enter": {
"x": {"scale": "xscale", "field": "category"},
"width": {"scale": "xscale", "band": 1},
"y": {"scale": "yscale", "field": "amount"},
"y2": {"scale": "yscale", "value": 0}
},
"update": {
"fill": {"value": "steelblue"}
},
"hover": {
"fill": {"value": "red"}
}
}
},
{
"type": "text",
"encode": {
"enter": {
"align": {"value": "center"},
"baseline": {"value": "bottom"},
"fill": {"value": "#333"}
},
"update": {
"x": {"scale": "xscale", "signal": "tooltip.category", "band": 0.5},
"y": {"scale": "yscale", "signal": "tooltip.amount", "offset": -2},
"text": {"signal": "tooltip.amount"},
"fillOpacity": [
{"test": "datum === tooltip", "value": 0},
{"value": 1}
]
}
}
}
]
}
};
const chart = new google.visualization.VegaChart(document.getElementById('chart-div'));
chart.draw(dataTable, options);
}
</script>
</head>
<body>
<div id="chart-div" style="width: 700px; height: 250px;"></div>
</body>
</html>
লোড হচ্ছে
google.charts.load প্যাকেজের নাম "vegachart" ।
google.charts.load("current", {packages: ["vegachart"]});
ভিজ্যুয়ালাইজেশনের ক্লাসের নাম হল google.visualization.VegaChart ।
var visualization = new google.visualization.VegaChart(container);
উপাত্ত বিন্যাস
একটি DataTable (বা DataView) ব্যবহার করে অন্যান্য Google চার্টের মতোই একটি VegaChart-এ ডেটা পাঠানো যেতে পারে। মূল পার্থক্য হল যে কলামগুলি কীভাবে ব্যবহার করা হয় তা নির্ধারণ করার জন্য তাদের ক্রমগুলির উপর নির্ভর করার পরিবর্তে, VegaChart প্রতিটি কলামের আইডির উপর নির্ভর করে যা আপনার নির্দিষ্ট করা নির্দিষ্ট ভেগা ভিজ্যুয়ালাইজেশনের জন্য প্রত্যাশিত। উদাহরণ স্বরূপ, নিম্নোক্ত DataTableটি কলাম দিয়ে তৈরি করা হয়েছে যেগুলোতে 'category' এবং 'amount' এর জন্য আইডি রয়েছে এবং এই কলামগুলিকে রেফারেন্স করতে 'ভেগা' বিকল্পের মধ্যে একই আইডি ব্যবহার করা হয়।
const dataTable = new google.visualization.DataTable();
dataTable.addColumn({type: 'string', 'id': 'category'});
dataTable.addColumn({type: 'number', 'id': 'amount'});
dataTable.addRows([
['A', 28],
['B', 55],
['C', 43],
]);
const options = {
'vega': {
...
// Here we create the Vega data object named 'datatable',
// which will be passed in via the draw() call with a DataTable.
'data': {'name': 'datatable'},
'scales': [
{
'name': 'yscale',
// Here is an example of how to use the 'amount' field from 'datatable'.
'domain': {'data': 'datatable', 'field': 'amount'},
}
]
}
};
const chart = new google.visualization.VegaChart(
document.getElementById('chart-div'));
chart.draw(dataTable, options);
// A DataTable is required, but it may be empty.
const dataTable = new google.visualization.DataTable();
const options = {
'vega': {
// Here the data is specified inline in the Vega specification.
"data": [
{
"name": "table",
"values": [
{"category": "A", "amount": 28},
{"category": "B", "amount": 55},
{"category": "C", "amount": 43},
]
}
],
'scales': [
{
'name': 'yscale',
// Here is how Vega normally uses the 'amount' field from 'table'.
"domain": {"data": "table", "field": "category"},
}
]
}
};
const chart = new google.visualization.VegaChart(
document.getElementById('chart-div'));
chart.draw(dataTable, options);
যাইহোক, শুধুমাত্র একটি DataTable এইভাবে VegaChart-এ পাস করা যেতে পারে, যেখানে কিছু Vega চার্টে একাধিক ডেটা টেবিলের প্রয়োজন হয়। আমরা Google চার্টের ভবিষ্যতের রিলিজে এই সীমাবদ্ধতার সমাধান করব।
ইতিমধ্যে, আপনি 'vega' 'data' বিকল্পে ব্যবহার করার জন্য প্রয়োজনীয় যেকোন অতিরিক্ত ডেটা নির্দিষ্ট করতে পারেন, এটি ইনলাইন করে বা একটি URL থেকে লোড করে। উভয়ের উদাহরণ নীচে পাওয়া যাবে।
কনফিগারেশন অপশন
| নাম | |
|---|---|
| চার্ট এরিয়া | চার্ট এলাকার অবস্থান এবং আকার কনফিগার করার জন্য সদস্যদের সাথে একটি বস্তু (যেখানে অক্ষ এবং কিংবদন্তি বাদ দিয়ে চার্ট নিজেই আঁকা হয়)। দুটি বিন্যাস সমর্থিত: একটি সংখ্যা, বা একটি সংখ্যা অনুসরণ করে %৷ একটি সাধারণ সংখ্যা পিক্সেলের একটি মান; % দ্বারা অনুসরণ করা একটি সংখ্যা একটি শতাংশ। উদাহরণ: প্রকার: বস্তু ডিফল্ট: নাল |
| chartArea.bottom | নিচের বর্ডার থেকে চার্টটি কতদূর আঁকতে হবে। প্রকার: সংখ্যা বা স্ট্রিং ডিফল্ট: স্বয়ংক্রিয় |
| chartArea.left | বাম সীমানা থেকে চার্টটি কতদূর আঁকতে হবে। প্রকার: সংখ্যা বা স্ট্রিং ডিফল্ট: স্বয়ংক্রিয় |
| chartArea.right | ডান বর্ডার থেকে চার্টটি কতদূর আঁকতে হবে। প্রকার: সংখ্যা বা স্ট্রিং ডিফল্ট: স্বয়ংক্রিয় |
| chartArea.top | উপরের বর্ডার থেকে চার্টটি কতদূর আঁকতে হবে। প্রকার: সংখ্যা বা স্ট্রিং ডিফল্ট: স্বয়ংক্রিয় |
| chartArea.width | চার্ট এলাকা প্রস্থ. প্রকার: সংখ্যা বা স্ট্রিং ডিফল্ট: স্বয়ংক্রিয় |
| chartArea.height | চার্ট এলাকার উচ্চতা। প্রকার: সংখ্যা বা স্ট্রিং ডিফল্ট: স্বয়ংক্রিয় |
| উচ্চতা | চার্টের উচ্চতা, পিক্সেলে। প্রকার: সংখ্যা ডিফল্ট: ধারণকারী উপাদানের উচ্চতা |
| প্রস্থ | চার্টের প্রস্থ, পিক্সেলে। প্রকার: সংখ্যা ডিফল্ট: ধারণকারী উপাদানের প্রস্থ |
পদ্ধতি
| পদ্ধতি | |
|---|---|
draw(data, options) | চার্ট আঁকে। রিটার্ন টাইপ: কোনোটিই নয় |
getAction(actionID) | অনুরোধ করা রিটার্ন টাইপ: অবজেক্ট |
getBoundingBox(id) | চার্ট এলিমেন্ট
মানগুলি চার্টের কন্টেইনারের সাথে আপেক্ষিক। চার্ট আঁকা পরে এটি কল. রিটার্ন টাইপ: অবজেক্ট |
getChartAreaBoundingBox() | চার্টের বিষয়বস্তুর বাম, শীর্ষ, প্রস্থ এবং উচ্চতা সহ একটি বস্তু ফেরত দেয় (যেমন, লেবেল এবং কিংবদন্তি বাদ দিয়ে):
মানগুলি চার্টের কন্টেইনারের সাথে আপেক্ষিক। চার্ট আঁকা পরে এটি কল. রিটার্ন টাইপ: অবজেক্ট |
getChartLayoutInterface() | চার্টের অনস্ক্রিন বসানো এবং এর উপাদান সম্পর্কে তথ্য সম্বলিত একটি বস্তু প্রদান করে। প্রত্যাবর্তিত বস্তুতে নিম্নলিখিত পদ্ধতিগুলি কল করা যেতে পারে:
চার্ট আঁকা পরে এটি কল. রিটার্ন টাইপ: অবজেক্ট |
getHAxisValue(xPosition, optional_axis_index) | উদাহরণ: চার্ট আঁকা পরে এটি কল. রিটার্ন টাইপ: নম্বর |
getImageURI() | একটি চিত্র URI হিসাবে ক্রমিককৃত চার্ট ফেরত দেয়। চার্ট আঁকা পরে এটি কল. প্রিন্টিং PNG চার্ট দেখুন। রিটার্ন টাইপ: স্ট্রিং |
getSelection() | নির্বাচিত চার্ট সত্তাগুলির একটি অ্যারে প্রদান করে। এই চার্টের জন্য, যে কোনো মুহূর্তে শুধুমাত্র একটি সত্তা নির্বাচন করা যেতে পারে। রিটার্ন টাইপ: নির্বাচন উপাদানের অ্যারে |
getVAxisValue(yPosition, optional_axis_index) | উদাহরণ: চার্ট আঁকা পরে এটি কল. রিটার্ন টাইপ: নম্বর |
getXLocation(dataValue, optional_axis_index) | চার্টের কন্টেইনারের বাম প্রান্তের সাপেক্ষে উদাহরণ: চার্ট আঁকা পরে এটি কল. রিটার্ন টাইপ: নম্বর |
getYLocation(dataValue, optional_axis_index) | চার্টের কন্টেইনারের উপরের প্রান্তের সাপেক্ষে উদাহরণ: চার্ট আঁকা পরে এটি কল. রিটার্ন টাইপ: নম্বর |
removeAction(actionID) | চার্ট থেকে অনুরোধ করা রিটার্ন টাইপ: none |
setAction(action) | ব্যবহারকারী যখন অ্যাকশন টেক্সটে ক্লিক করে তখন কার্যকর করার জন্য একটি টুলটিপ অ্যাকশন সেট করে। চার্টের রিটার্ন টাইপ: none |
setSelection() | নির্দিষ্ট চার্ট সত্তা নির্বাচন করে। আগের যেকোনো নির্বাচন বাতিল করে। এই চার্টের জন্য, একবারে শুধুমাত্র একটি সত্তা নির্বাচন করা যেতে পারে। রিটার্ন টাইপ: কোনোটিই নয় |
clearChart() | চার্টটি সাফ করে এবং এর সমস্ত বরাদ্দকৃত সংস্থান প্রকাশ করে। রিটার্ন টাইপ: কোনোটিই নয় |
ঘটনা
এই ইভেন্টগুলি কীভাবে ব্যবহার করবেন সে সম্পর্কে আরও তথ্যের জন্য, বেসিক ইন্টারঅ্যাকটিভিটি , হ্যান্ডলিং ইভেন্ট এবং ফায়ারিং ইভেন্টগুলি দেখুন।
| নাম | |
|---|---|
animationfinish | ট্রানজিশন অ্যানিমেশন সম্পূর্ণ হলে বহিস্কার করা হয়েছে। বৈশিষ্ট্য: কোনোটিই নয় |
click | ব্যবহারকারী চার্টের ভিতরে ক্লিক করলে বহিস্কার হয়। শিরোনাম, ডেটা উপাদান, কিংবদন্তি এন্ট্রি, অক্ষ, গ্রিডলাইন বা লেবেলগুলি ক্লিক করা হলে সনাক্ত করতে ব্যবহার করা যেতে পারে। বৈশিষ্ট্য: টার্গেটআইডি |
error | চার্ট রেন্ডার করার চেষ্টা করার সময় একটি ত্রুটি ঘটলে বহিস্কার করা হয়। বৈশিষ্ট্য: আইডি, বার্তা |
legendpagination | ব্যবহারকারী কিংবদন্তি পৃষ্ঠায় স্থানান্তর তীর ক্লিক করলে বহিস্কার করা হয়। বর্তমান কিংবদন্তি শূন্য-ভিত্তিক পৃষ্ঠা সূচী এবং পৃষ্ঠার মোট সংখ্যা পাস করে। বৈশিষ্ট্য: বর্তমান পেজ ইনডেক্স, মোট পৃষ্ঠা |
onmouseover | যখন ব্যবহারকারী একটি ভিজ্যুয়াল সত্তার উপর মাউস দেয় তখন বহিস্কার করা হয়। সংশ্লিষ্ট ডেটা টেবিল উপাদানের সারি এবং কলামের সূচকগুলিকে পাস করে। বৈশিষ্ট্য: সারি, কলাম |
onmouseout | ব্যবহারকারী মাউস একটি ভিজ্যুয়াল সত্তা থেকে দূরে থাকলে বহিস্কার করা হয়। সংশ্লিষ্ট ডেটা টেবিল উপাদানের সারি এবং কলামের সূচকগুলিকে পাস করে। বৈশিষ্ট্য: সারি, কলাম |
ready | চার্টটি বাহ্যিক পদ্ধতি কলের জন্য প্রস্তুত। আপনি যদি চার্টের সাথে ইন্টারঅ্যাক্ট করতে চান, এবং আপনি এটি আঁকার পরে কল করার পদ্ধতিগুলি চান, তাহলে বৈশিষ্ট্য: কোনোটিই নয় |
select | ব্যবহারকারী একটি ভিজ্যুয়াল সত্তা ক্লিক করলে বহিস্কার করা হয়। কি নির্বাচন করা হয়েছে তা জানতে, বৈশিষ্ট্য: কোনোটিই নয় |
ডেটা নীতি
সমস্ত কোড এবং ডেটা ব্রাউজারে প্রসেস এবং রেন্ডার করা হয়। কোনো সার্ভারে কোনো ডেটা পাঠানো হয় না।