چارٹ عنصر

پراپقسمضروریمثالقدر کی حدتفصیل
chartTypestringtrue--دکھانے کے لیے چارٹ کی قسم۔ حمایت یافتہ اقسام: بار، لائن، ایریا، اسکیٹر، پائی، ڈونٹ، ریڈار۔
chartWidthnumbertrue-200 - 800چارٹ کینوس کی چوڑائی، پکسلز میں۔
chartHeightnumbertrue-150 - 600چارٹ کینوس کی اونچائی، پکسلز میں۔
bgColorstringfalse--چارٹ کا پس منظر کا رنگ، ہیکس شکل میں۔
bgAlphanumberfalse-0 - 1چارٹ کے پس منظر کی شفافیت کا درجہ۔ 1 مکمل شفافیت کی نمائندگی کرتا ہے، اور 0 مکمل شفافیت کی نمائندگی کرتا ہے۔
showAxisbooleanfalse--کیا چارٹ کے محور کو دکھایا جائے گا۔
axisColorstringfalse--چارٹ کے محور کا رنگ، ہیکس شکل میں۔
axisWidthnumberfalse-1 - 10چارٹ کے محور کی چوڑائی، پکسلز میں۔
showGridbooleanfalse--کیا چارٹ کا گرڈ دکھایا جائے گا۔
gridColorstringfalse--چارٹ کے گرڈ کا رنگ، ہیکس شکل میں۔
gridAlphanumberfalse-0 - 1چارٹ کے گرڈ کی شفافیت کا درجہ۔ 1 مکمل شفافیت کی نمائندگی کرتا ہے، اور 0 مکمل شفافیت کی نمائندگی کرتا ہے۔
showLabelsbooleanfalse--کیا چارٹ کے لیبل دکھائے جائیں گے۔
labelStyleobjectfalse--چارٹ کے لیبلز کے لیے متن کی طرز کی تشکیل۔
labelStyle.fillstringfalse--چارٹ کے لیبلز کا فونٹ کا رنگ، ہیکس شکل میں۔
labelStyle.fontSizenumberfalse-8 - 100چارٹ کے لیبلز کا فونٹ کا سائز، پکسلز میں۔
labelStyle.fontFamilystringfalse--چارٹ کے لیبلز کا فونٹ خاندان۔
labelStyle.fontWeightstringfalse--چارٹ کے لیبلز کا فونٹ کا وزن (جیسے، معمولی، بولڈ)۔
labelStyle.strokestringfalse--چارٹ کے لیبلز کا اسٹروک رنگ، ہیکس شکل میں۔
labelStyle.strokeThicknessnumberfalse-0 - 10چارٹ کے لیبلز کی اسٹروک کی چوڑائی، پکسلز میں۔
labelStyle.dropShadowbooleanfalse--کیا چارٹ کے لیبلز کے لیے سایہ اثر کو فعال کیا جائے گا۔
labelStyle.dropShadowColorstringfalse--چارٹ کے لیبلز کا سایہ رنگ، ہیکس شکل میں۔
labelStyle.dropShadowBlurnumberfalse-0 - 20لیبل سایہ کا دھندلا پن۔
labelStyle.dropShadowDistancenumberfalse-0 - 20متن سے لیبل سایہ کا فاصلہ۔
labelStyle.dropShadowAnglenumberfalse-0 - 6.28لیبل سایہ کا زاویہ، ریڈینز میں۔
labelStyle.dropShadowAlphanumberfalse-0 - 1لیبل سایہ کی شفافیت۔
linePointStylestringfalse--لائن/ایریا چارٹس میں ڈیٹا پوائنٹس کا طرز۔ اختیارات: بھرے ہوئے، خالی۔
lineSmoothbooleanfalse--کیا لائنوں کو لائن/ایریا چارٹس میں ہموار کیا جائے گا۔
lineAreaAlphanumberfalse-0 - 1ایریا چارٹس میں بھرے ہوئے علاقے کی شفافیت کا درجہ۔
showLegendbooleanfalse--کیا چارٹ کا لیجنڈ دکھایا جائے گا۔
legendPositionstringfalse--لیجنڈ کی جگہ۔ فی الحال حمایت کرتا ہے: نیچے۔
legendItemSizenumberfalse-10 - 30لیجنڈ آئٹمز کا سائز، پکسلز میں۔
legendGapnumberfalse-4 - 20لیجنڈ آئٹمز کے درمیان فاصلہ، پکسلز میں۔
showBarBackgroundbooleanfalse--کیا بار چارٹس کا پس منظر دکھایا جائے گا۔
barBackgroundColorstringfalse--بارز کا پس منظر کا رنگ، ہیکس شکل میں۔
barBackgroundAlphanumberfalse-0 - 1بار کے پس منظر کی شفافیت کا درجہ۔
barOrientationstringfalse--بارز کی سمت۔ اختیارات: عمودی، افقی۔
barCornerRadiusnumberfalse-0 - 20بارز کا کونے کا رداس، پکسلز میں۔
dataSetarrayfalse--ڈیٹا سیٹوں کی ایک صف جو چارٹ کو رینڈر کرنے کے لیے استعمال ہوتی ہے۔ ہر ڈیٹا سیٹ میں ایک وقت کا نقطہ (dataTime) اور ڈیٹا پوائنٹس (dataPoints) شامل ہیں۔

چارٹ کی اقسام

chartType کی خاصیت بصری طرز کا تعین کرتی ہے:

  • bar: عمودی یا افقی بار چارٹ
  • line: لائن چارٹ جس میں ہموار کرنے کا اختیار ہو
  • area: ایریا چارٹ جس میں بھرے ہوئے علاقے ہوں
  • scatter: اسکیٹر پلاٹ جس میں ڈیٹا پوائنٹس ہوں
  • pie: پائی چارٹ جو تناسب دکھاتا ہے
  • doughnut: ڈونٹ چارٹ (پائی چارٹ جس میں مرکز کا سوراخ ہو)
  • radar: ریڈار/اسپائیڈر چارٹ

ڈیٹا کی ساخت

dataSet ڈیٹا آبجیکٹس کا ایک صف ہے، جہاں ہر آبجیکٹ میں شامل ہے:

  • dataTime: وقت کا نقطہ جو ChartNode کے مطابق ہے (سیکنڈز میں)
  • dataPoints: ایک صف ڈیٹا پوائنٹس کی جو اس وقت دکھائی جائیں گی

dataPoints میں ہر ڈیٹا پوائنٹ میں شامل ہے:

  • id: ڈیٹا پوائنٹ کے لیے منفرد شناخت کنندہ
  • label: ڈیٹا پوائنٹ کا لیبل/نام
  • value: عددی قیمت
  • color (اختیاری): اس ڈیٹا پوائنٹ کے لیے حسب خواہش رنگ ہیکس شکل میں

لیبل اسٹائلنگ

labelStyle آبجیکٹ چارٹ لیبلز کی شکل و صورت کو کنٹرول کرتا ہے:

  • فونٹ کی خصوصیات: fill، fontSize، fontFamily، fontWeight
  • اسٹروک کی خصوصیات: stroke، strokeThickness
  • سایہ کی خصوصیات: dropShadow، dropShadowColor، dropShadowBlur، dropShadowDistance، dropShadowAngle، dropShadowAlpha

لائن اور ایریا چارٹ کی خصوصیات

لائن اور ایریا چارٹس کے لیے، آپ درج ذیل ترتیب دے سکتے ہیں:

  • linePointStyle: ڈیٹا پوائنٹس کو بھرے ہوئے دائرے یا خالی دائرے کے طور پر دکھائیں
  • lineSmooth: سیدھی لائنوں کے بجائے ہموار منحنی خطوط کی اجازت دیں
  • lineAreaAlpha: بھرے ہوئے علاقے کی شفافیت کنٹرول کریں (ایریا چارٹس کے لیے)

بار چارٹ کی خصوصیات

بار چارٹس کے لیے، آپ درج ذیل ترتیب دے سکتے ہیں:

  • barOrientation: بارز کو عمودی یا افقی دکھائیں
  • barCornerRadius: بارز کے کونوں کو گول کریں
  • showBarBackground: بارز کے پیچھے پس منظر دکھائیں
  • barBackgroundColor/barBackgroundAlpha: بار کے پس منظر کی شکل و صورت

لیجنڈ کی ترتیب

چارٹ کے لیجنڈ کو فعال کریں اور حسب ضرورت ترتیب دیں:

  • showLegend: لیجنڈ کی مرئییت کو تبدیل کریں
  • legendPosition: لیجنڈ کی جگہ (فی الحال "نیچے" کی حمایت کرتا ہے)
  • legendItemSize: لیجنڈ رنگ کے اشارے کا سائز
  • legendGap: لیجنڈ آئٹمز کے درمیان فاصلہ
chartElement.json
{
"id": "chart-element-id",
"type": "Chart",
"start": 0,
"duration": 10,
"trackIndex": 0,
"x": 100,
"y": 100,
"chartType": "bar",
"chartWidth": 800,
"chartHeight": 600,
"bgColor": "#ffffff",
"bgAlpha": 1,
"showAxis": true,
"axisColor": "#000000",
"axisWidth": 2,
"showGrid": true,
"gridColor": "#cccccc",
"gridAlpha": 0.5,
"showLabels": true,
"labelStyle": {
  "fill": "#333333",
  "fontSize": 12,
  "fontFamily": "Arial",
  "fontWeight": "normal",
  "stroke": "#000000",
  "strokeThickness": 0,
  "dropShadow": false,
  "dropShadowColor": "#000000",
  "dropShadowBlur": 4,
  "dropShadowDistance": 3,
  "dropShadowAngle": 1.2,
  "dropShadowAlpha": 1
},
"showLegend": true,
"legendPosition": "bottom",
"legendItemSize": 14,
"legendGap": 8,
"barOrientation": "vertical",
"barCornerRadius": 4,
"showBarBackground": false,
"barBackgroundColor": "#eeeeee",
"barBackgroundAlpha": 0.4,
"dataSet": [
  {
    "dataTime": 0,
    "dataPoints": [
      { "id": "1", "label": "A", "value": 10, "color": "#ff6384" },
      { "id": "2", "label": "B", "value": 20, "color": "#36a2eb" },
      { "id": "3", "label": "C", "value": 15, "color": "#ffce56" }
    ]
  },
  {
    "dataTime": 5,
    "dataPoints": [
      { "id": "1", "label": "A", "value": 25, "color": "#ff6384" },
      { "id": "2", "label": "B", "value": 18, "color": "#36a2eb" },
      { "id": "3", "label": "C", "value": 22, "color": "#ffce56" }
    ]
  }
]
}