گزینه های پیکربندی نمودار

انواع نمودار

گزینه‌های پیکربندی نمودار حاشیه‌نویسی

نام
رنگ‌ها

رنگ‌هایی که برای عناصر نمودار استفاده می‌شوند. آرایه‌ای از رشته‌ها، که در آن هر عنصر یک رشته رنگ HTML است، برای مثال: colors:['red','#004411'] .

نوع: آرایه‌ای از رشته‌ها
پیش‌فرض: رنگ‌های پیش‌فرض
انتخابگر محدوده نمایش

اینکه آیا ناحیه انتخاب محدوده زوم (ناحیه پایین نمودار) نمایش داده شود یا خیر، که در آن false به معنی خیر است.

طرح کلی در انتخابگر زوم، نسخه‌ای لگاریتمی از سری اول نمودار است که متناسب با ارتفاع انتخابگر زوم، مقیاس‌بندی شده است.

نوع: boolean
پیش‌فرض: true
دکمه‌های نمایش/بزرگنمایی

اینکه آیا دکمه‌های بزرگنمایی ("۱d 5d 1m" و غیره) نمایش داده شوند یا خیر، که در آن false به معنی خیر است.

نوع: boolean
پیش‌فرض: true
حداکثر

حداکثر مقداری که روی محور Y نمایش داده می‌شود. اگر حداکثر داده از این مقدار بیشتر شود، این تنظیم نادیده گرفته می‌شود و نمودار طوری تنظیم می‌شود که علامت تیک اصلی بعدی را بالاتر از حداکثر داده نشان دهد. این مقدار بر حداکثر محور Y که توسط scaleType تعیین می‌شود، اولویت دارد.

این مشابه maxValue در نمودارهای اصلی است.

نوع: number
پیش‌فرض: خودکار
دقیقه

حداقل مقداری که باید روی محور Y نشان داده شود. اگر حداقل داده کمتر از این مقدار باشد، این تنظیم نادیده گرفته می‌شود و نمودار طوری تنظیم می‌شود که علامت تیک اصلی بعدی زیر حداقل داده را نشان دهد. این بر حداقل محور Y که توسط scaleType تعیین می‌شود، اولویت دارد.

این مشابه minValue در نمودارهای اصلی است.

نوع: number
پیش‌فرض: خودکار

گزینه‌های پیکربندی نمودار منطقه‌ای

نام
کدورت ناحیه

میزان شفافیت پیش‌فرض ناحیه رنگی زیر یک سری نمودار مساحتی، که در آن 0.0 کاملاً شفاف و 1.0 کاملاً مات است. برای تعیین میزان شفافیت برای یک سری خاص، مقدار areaOpacity را در ویژگی series تنظیم کنید.

نوع: number ، 0.0- 1.0
پیش‌فرض: 0.3
رنگ پس‌زمینه

رنگ پس‌زمینه برای ناحیه اصلی نمودار. می‌تواند یک رشته رنگ ساده HTML باشد، برای مثال: 'red' یا '#00cc00' ، یا یک شیء با ویژگی‌های زیر.

نوع: string یا object
پیش‌فرض: 'white'
رنگ پس‌زمینه.پر کردن

رنگ پر کردن نمودار، به عنوان یک رشته رنگ HTML.

نوع: string
پیش‌فرض: 'white'
نمودارمنطقه

یک شیء با اعضا برای پیکربندی محل قرارگیری و اندازه ناحیه نمودار (جایی که خود نمودار رسم می‌شود، به استثنای محور و راهنماها). دو قالب پشتیبانی می‌شوند: یک عدد، یا یک عدد به دنبال آن %. یک عدد ساده مقداری بر حسب پیکسل است؛ عددی که به دنبال آن % می‌آید، درصد است. مثال: chartArea:{left:20,top:0,width:'50%',height:'75%'}

نوع: object
پیش‌فرض: null
رنگ زمینه نمودار
رنگ پس‌زمینه‌ی ناحیه‌ی نمودار. وقتی از یک رشته استفاده می‌شود، می‌تواند یک رشته‌ی هگز (مثلاً '#fdc' ) یا یک نام رنگ انگلیسی باشد. وقتی از یک شیء استفاده می‌شود، ویژگی‌های زیر می‌توانند ارائه شوند:
  • stroke : رنگ، که به صورت یک رشته هگز یا نام رنگ انگلیسی ارائه می‌شود.
  • strokeWidth : در صورت وجود، یک حاشیه دور ناحیه نمودار با عرض داده شده (و با رنگ stroke ) رسم می‌کند.
نوع: string یا object
پیش‌فرض: 'white'
مساحت نمودار.ارتفاع

ارتفاع ناحیه نمودار.

نوع: number یا string
پیش‌فرض: خودکار
chartArea.left

نمودار را تا چه فاصله‌ای از مرز چپ رسم کنیم.

نوع: number یا string
پیش‌فرض: خودکار
chartArea.top

نمودار را تا چه فاصله‌ای از حاشیه بالایی رسم کنیم.

نوع: number یا string
پیش‌فرض: خودکار
عرض نمودار

عرض ناحیه نمودار.

نوع: number یا string
پیش‌فرض: خودکار
رنگ‌ها

رنگ‌هایی که برای عناصر نمودار استفاده می‌شوند. آرایه‌ای از رشته‌ها، که در آن هر عنصر یک رشته رنگ HTML است، برای مثال: colors:['red','#004411'] .

نوع: آرایه‌ای از رشته‌ها
پیش‌فرض: رنگ‌های پیش‌فرض
اچ اکسیس

یک شیء با اعضایی برای پیکربندی عناصر مختلف محور افقی. برای مشخص کردن ویژگی‌های این شیء، می‌توانید از نمادگذاری تحت‌اللفظی شیء، همانطور که در اینجا نشان داده شده است، استفاده کنید:

{
  title: 'Hello',
  titleTextStyle: {
    color: '#FF0000'
  }
}
    
نوع: object
پیش‌فرض: null
جهت محور h

جهتی که مقادیر در امتداد محور افقی رشد می‌کنند. برای معکوس کردن ترتیب مقادیر، -1 را مشخص کنید.

نوع: 1 یا -1
پیش‌فرض: 1
خطوط شبکه‌ای hAxis

یک شیء با ویژگی‌هایی برای پیکربندی خطوط شبکه‌ای روی محور افقی. توجه داشته باشید که خطوط شبکه‌ای محور افقی به صورت عمودی ترسیم می‌شوند. برای تعیین ویژگی‌های این شیء، می‌توانید از نمادگذاری تحت‌اللفظی شیء، همانطور که در اینجا نشان داده شده است، استفاده کنید:

{color: '#333', minSpacing: 20}

این گزینه فقط برای یک محور continuous پشتیبانی می‌شود.

نوع: object
پیش‌فرض: null
خطوط شبکه‌ای hAxis.gridlines.color

رنگ خطوط شبکه افقی درون ناحیه نمودار. یک رشته رنگ معتبر HTML مشخص کنید.

نوع: string
پیش‌فرض: '#CCC'
تعداد خطوط شبکه hAxis

تعداد تقریبی خطوط شبکه افقی درون محدوده نمودار. اگر یک عدد مثبت برای gridlines.count تعیین کنید، از آن برای محاسبه minSpacing بین خطوط شبکه استفاده می‌شود. می‌توانید مقدار 1 را برای رسم فقط یک خط شبکه یا 0 برای رسم هیچ خط شبکه‌ای تعیین کنید. مقدار -1 را که مقدار پیش‌فرض است، برای محاسبه خودکار تعداد خطوط شبکه بر اساس گزینه‌های دیگر تعیین کنید.

نوع: number
پیش‌فرض: -1
hAxis.logScale

ویژگی hAxis که محور افقی را به صورت لگاریتمی نمایش می‌دهد (نیازمند مثبت بودن همه مقادیر است). برای بله، روی true تنظیم می‌شود.

این گزینه فقط برای یک محور continuous پشتیبانی می‌شود.

نوع: boolean
پیش‌فرض: false
مقدار حداکثر hAxis

حداکثر مقدار محور افقی را به مقدار مشخص شده منتقل می‌کند؛ این مقدار در اکثر نمودارها به سمت راست خواهد بود. اگر این مقدار کوچکتر از حداکثر مقدار x داده‌ها باشد، نادیده گرفته می‌شود. hAxis.viewWindow.max این ویژگی را لغو می‌کند.

نوع: number
پیش‌فرض: خودکار
خطوط شبکه‌ای جزئی hAxis

یک شیء با اعضایی برای پیکربندی خطوط شبکه فرعی روی محور افقی، مشابه گزینه hAxis.gridlines .

این گزینه فقط برای یک محور continuous پشتیبانی می‌شود.

نوع: object
پیش‌فرض: null
خطوط شبکه جزئی hAxis.minor.color

رنگ خطوط شبکه‌ای فرعی افقی درون ناحیه نمودار. یک رشته رنگ معتبر HTML مشخص کنید.

نوع: string
پیش‌فرض: ترکیبی از رنگ‌های خطوط شبکه و پس‌زمینه
تعداد خطوط شبکه جزئی hAxis

گزینه minorGridlines.count عمدتاً منسوخ شده است، به جز غیرفعال کردن خطوط شبکه فرعی با تنظیم تعداد آنها روی ۰. تعداد خطوط شبکه فرعی اکنون کاملاً به فاصله بین خطوط شبکه اصلی (به hAxis.gridlines.interval مراجعه کنید) و حداقل فضای مورد نیاز (به hAxis.minorGridlines.minSpacing مراجعه کنید) بستگی دارد.

نوع: number
پیش‌فرض: 1
مقدار حداقلی hAxis

مقدار حداقل محور افقی را به مقدار مشخص شده منتقل می‌کند؛ این مقدار در اکثر نمودارها به سمت چپ خواهد بود. اگر این مقدار بزرگتر از حداقل مقدار x داده‌ها باشد، نادیده گرفته می‌شود. hAxis.viewWindow.min این ویژگی را لغو می‌کند.

نوع: number
پیش‌فرض: خودکار
موقعیت متن hAxis

موقعیت متن محور افقی، نسبت به ناحیه نمودار. مقادیر پشتیبانی شده: 'out' ، 'in' ، 'none' .

نوع: string
پیش‌فرض: 'out'
سبک متن hAxis

شیء‌ای که سبک متن محور افقی را مشخص می‌کند. این شیء دارای این قالب است:

{ color: <string>,
  fontName: <string>,
  fontSize: <number>,
  bold: <boolean>,
  italic: <boolean> }
    

color می‌تواند هر رشته رنگی HTML باشد، برای مثال: 'red' یا '#00cc00' . همچنین به fontName و fontSize مراجعه کنید.

نوع: object
پیش‌فرض: {color: 'black', fontName: <global-font-name>, fontSize: <global-font-size>}
hAxis.title

ویژگی hAxis که عنوان محور افقی را مشخص می‌کند.

نوع: string
پیش‌فرض: null
hAxis.titleTextStyle

شیء‌ای که سبک متن عنوان محور افقی را مشخص می‌کند. این شیء دارای این قالب است:

{ color: <string>,
  fontName: <string>,
  fontSize: <number>,
  bold: <boolean>,
  italic: <boolean> }
    

color می‌تواند هر رشته رنگی HTML باشد، برای مثال: 'red' یا '#00cc00' . همچنین به fontName و fontSize مراجعه کنید.

نوع: object
پیش‌فرض: {color: 'black', fontName: <global-font-name>, fontSize: <global-font-size>}
پنجره‌ی نمای محور hAxis

محدوده برش محور افقی را مشخص می‌کند.

نوع: object
پیش‌فرض: null
hAxis.viewWindow.max

حداکثر مقدار داده افقی برای رندر کردن.

وقتی hAxis.viewWindowMode برابر با 'pretty' یا 'maximized' باشد، نادیده گرفته می‌شود.

نوع: number
پیش‌فرض: خودکار
hAxis.viewWindow.min

حداقل مقدار داده افقی برای رندر شدن.

وقتی hAxis.viewWindowMode برابر با 'pretty' یا 'maximized' باشد، نادیده گرفته می‌شود.

نوع: number
پیش‌فرض: خودکار
ارتفاع

ارتفاع نمودار بر حسب پیکسل.

نوع: number
پیش‌فرض: ارتفاع عنصر حاوی
میان‌یابی Nullها

آیا مقدار نقاط گمشده را حدس بزند یا خیر. اگر true ، مقدار هر داده گمشده را بر اساس نقاط همسایه حدس می‌زند. اگر false ، در نقطه نامعلوم، یک شکست در خط ایجاد می‌کند.

این مورد توسط نمودارهای مساحت با گزینه isStacked: true/'percent'/'relative'/'absolute' پشتیبانی نمی‌شود .

نوع: boolean
پیش‌فرض: false
ای‌استکد

اگر روی true تنظیم شود، عناصر را برای همه سری‌ها در هر مقدار دامنه روی هم قرار می‌دهد. توجه: در نمودارهای Column ، Area و SteppedArea ، Google Charts ترتیب عناصر راهنما را معکوس می‌کند تا با چیدمان عناصر سری مطابقت بهتری داشته باشد (مثلاً سری 0 پایین‌ترین عنصر راهنما خواهد بود). این مورد در مورد نمودارهای میله‌ای صدق نمی‌کند .

گزینه isStacked همچنین از انباشتگی ۱۰۰٪ پشتیبانی می‌کند، که در آن، انباشت عناصر در هر مقدار دامنه، برای رسیدن به ۱۰۰٪، مقیاس‌بندی مجدد می‌شوند.

گزینه‌های isStacked عبارتند از:

  • false — عناصر روی هم قرار نمی‌گیرند. این گزینه پیش‌فرض است.
  • true — عناصر همه سری‌ها را در هر مقدار دامنه روی هم قرار می‌دهد.
  • 'percent' - عناصر را برای همه سری‌ها در هر مقدار دامنه روی هم قرار می‌دهد و آنها را طوری مقیاس‌بندی می‌کند که مجموع آنها به ۱۰۰٪ برسد، و مقدار هر عنصر به صورت درصدی از ۱۰۰٪ محاسبه می‌شود.
  • 'relative' - عناصر همه سری‌ها را در هر مقدار دامنه روی هم قرار می‌دهد و آنها را طوری مقیاس‌بندی می‌کند که مجموع آنها برابر با ۱ شود، و مقدار هر عنصر به صورت کسری از ۱ محاسبه شود.
  • 'absolute' - عملکردی مشابه isStacked: true .

برای انباشت ۱۰۰٪، مقدار محاسبه‌شده برای هر عنصر در راهنمای ابزار، پس از مقدار واقعی آن ظاهر می‌شود.

محور هدف به طور پیش‌فرض مقادیر تیک را بر اساس مقیاس نسبی ۰-۱ به عنوان کسری از ۱ برای 'relative' و ۰-۱۰۰٪ برای 'percent' نمایش می‌دهد ( توجه: هنگام استفاده از گزینه 'percent' ، مقادیر محور/تیک به صورت درصد نمایش داده می‌شوند، با این حال مقادیر واقعی، مقادیر مقیاس نسبی ۰-۱ هستند. دلیل این امر این است که تیک‌های محور درصد نتیجه اعمال فرمت "#.##%" به مقادیر مقیاس نسبی ۰-۱ هستند. هنگام استفاده از isStacked: 'percent' ، حتماً هرگونه تیک/خطوط شبکه را با استفاده از مقادیر مقیاس نسبی ۰-۱ مشخص کنید). می‌توانید مقادیر خطوط شبکه/تیک و قالب‌بندی را با استفاده از گزینه‌های hAxis/vAxis مناسب سفارشی کنید.

انباشتگی ۱۰۰٪ فقط از مقادیر داده‌ای از نوع number پشتیبانی می‌کند و باید دارای مقدار پایه صفر باشد.

نوع: boolean / string
پیش‌فرض: false
افسانه

یک شیء با اعضایی برای پیکربندی جنبه‌های مختلف راهنما. برای مشخص کردن ویژگی‌های این شیء، می‌توانید از نمادگذاری تحت‌اللفظی شیء، همانطور که در اینجا نشان داده شده است، استفاده کنید:

{position: 'top', textStyle: {color: 'blue', fontSize: 16}}
نوع: object
پیش‌فرض: null
موقعیت افسانه

موقعیت راهنما. می‌تواند یکی از موارد زیر باشد:

  • 'bottom' - زیر نمودار.
  • 'left' - در سمت چپ نمودار، مشروط بر اینکه محور چپ هیچ series مرتبط با آن نداشته باشد. بنابراین اگر می‌خواهید راهنما در سمت چپ باشد، از گزینه targetAxisIndex: 1 استفاده کنید.
  • 'in' - داخل نمودار، در گوشه بالا سمت چپ.
  • 'none' - هیچ شرحی نمایش داده نمی‌شود.
  • 'right' - در سمت راست نمودار. با گزینه vAxes سازگار نیست.
  • 'top' - بالای نمودار.
نوع: string
پیش‌فرض: 'right'
سبک متن افسانه‌ای

شیء‌ای که سبک متن راهنما را مشخص می‌کند. این شیء دارای این قالب است:

{ color: <string>,
  fontName: <string>,
  fontSize: <number>,
  bold: <boolean>,
  italic: <boolean> }
    

color می‌تواند هر رشته رنگی HTML باشد، برای مثال: 'red' یا '#00cc00' . همچنین به fontName و fontSize مراجعه کنید.

نوع: object
پیش‌فرض: {color: 'black', fontName: <global-font-name>, fontSize: <global-font-size>}
عرض خط

عرض خط داده بر حسب پیکسل. از صفر برای مخفی کردن همه خطوط و نمایش فقط نقاط استفاده کنید. می‌توانید با استفاده از ویژگی series ، مقادیر مربوط به سری‌های منفرد را بازنویسی کنید.

نوع: number
پیش‌فرض: 2
نقطه شکل

شکل عناصر داده‌ای منفرد: 'circle' ، 'triangle' ، 'square' ، 'diamond' ، 'star' یا 'polygon' . برای مثال‌ها به مستندات points مراجعه کنید.

نوع: string
پیش‌فرض: 'circle'
نقطه اندازه

قطر نقاط نمایش داده شده بر حسب پیکسل. برای مخفی کردن همه نقاط از صفر استفاده کنید. می‌توانید با استفاده از ویژگی series ، مقادیر مربوط به سری‌های منفرد را نادیده بگیرید.

نوع: number
پیش‌فرض: 0
معکوسدسته‌بندی‌ها

اگر روی true تنظیم شود، دنباله‌ها را از راست به چپ رسم می‌کند. مقدار پیش‌فرض، رسم از چپ به راست است.

این گزینه فقط برای محور major discrete پشتیبانی می‌شود.

نوع: boolean
پیش‌فرض: false
سری

آرایه‌ای از اشیاء که هر کدام قالب سری مربوطه را در نمودار توصیف می‌کنند. برای استفاده از مقادیر پیش‌فرض برای یک سری، یک شیء خالی {} مشخص کنید. اگر یک سری یا یک مقدار مشخص نشده باشد، از مقدار سراسری استفاده خواهد شد. هر شیء از ویژگی‌های زیر پشتیبانی می‌کند:

  • annotations - شیء‌ای که قرار است روی حاشیه‌نویسی‌های این مجموعه اعمال شود. این شیء می‌تواند برای کنترل، مثلاً، textStyle برای مجموعه، استفاده شود:

    series: {
      0: {
        annotations: {
          textStyle: {fontSize: 12, color: 'red' }
        }
      }
    }
              

    برای فهرست کامل‌تری از موارد قابل سفارشی‌سازی، گزینه‌های مختلف annotations مشاهده کنید.

  • areaOpacity - خاصیت areaOpacity سراسری را برای این مجموعه لغو می‌کند.
  • color - رنگی که برای این سری استفاده می‌شود. یک رشته رنگ معتبر HTML مشخص کنید.
  • labelInLegend - شرح سری که قرار است در راهنمای نمودار نمایش داده شود.
  • lineDashStyle - مقدار سراسری lineDashStyle را برای این سری لغو می‌کند.
  • lineWidth - مقدار سراسری lineWidth را برای این سری نادیده می‌گیرد.
  • pointShape - مقدار سراسری pointShape را برای این سری لغو می‌کند.
  • pointSize - مقدار سراسری pointSize را برای این سری لغو می‌کند.
  • pointsVisible - مقدار سراسری pointsVisible را برای این سری لغو می‌کند.
  • targetAxisIndex - این سری به کدام محور اختصاص داده شود، که در آن 0 محور پیش‌فرض و 1 محور مقابل است. مقدار پیش‌فرض 0 است؛ برای تعریف نموداری که سری‌های مختلف در برابر محورهای مختلف رندر می‌شوند، روی 1 تنظیم شود. حداقل یک سری باید به محور پیش‌فرض اختصاص داده شود. می‌توانید برای محورهای مختلف مقیاس متفاوتی تعریف کنید.
  • visibleInLegend - یک مقدار boolean ، که در آن true به این معنی است که سری باید دارای ورودی راهنما باشد و false به این معنی است که نباید داشته باشد. مقدار پیش‌فرض true است.

شما می‌توانید آرایه‌ای از اشیاء را مشخص کنید که هر کدام به ترتیب داده شده به سری اعمال می‌شوند، یا می‌توانید شیء‌ای را مشخص کنید که هر فرزند آن یک کلید عددی دارد که نشان می‌دهد به کدام سری اعمال می‌شود. برای مثال، دو تعریف زیر یکسان هستند و سری اول را به صورت سیاه و بدون راهنما و سری چهارم را به صورت قرمز و بدون راهنما اعلام می‌کنند:

series: [
  {color: 'black', visibleInLegend: false}, {}, {},
  {color: 'red', visibleInLegend: false}
]
series: {
  0:{color: 'black', visibleInLegend: false},
  3:{color: 'red', visibleInLegend: false}
}
    
نوع: آرایه‌ای از اشیاء، یا شیء با اشیاء تو در تو
پیش‌فرض: {}
زیرنویس

متنی که زیر عنوان نمودار نمایش داده می‌شود.

نوع: string
پیش‌فرض: بدون عنوان
زیرنویسTextStyle

شیء‌ای که سبک متن عنوان را مشخص می‌کند.

color می‌تواند هر رشته رنگی HTML باشد، برای مثال: 'red' یا '#00cc00' . همچنین به fontName و fontSize مراجعه کنید.

نوع: object
پیش‌فرض: {color: 'black', fontName: <global-font-name>, fontSize: <global-font-size>}
تم

یک تم مجموعه‌ای از مقادیر گزینه‌های از پیش تعریف شده است که برای دستیابی به یک رفتار نمودار یا جلوه بصری خاص با هم کار می‌کنند. در حال حاضر فقط یک تم موجود است:

  • 'maximized' - مساحت نمودار را به حداکثر می‌رساند و راهنما و تمام برچسب‌ها را درون محدوده نمودار رسم می‌کند.
نوع: string
پیش‌فرض: null
عنوان

متنی که بالای نمودار نمایش داده می‌شود.

نوع: string
پیش‌فرض: بدون عنوان
عنوانسبک متن

شیء‌ای که سبک متن عنوان را مشخص می‌کند. این شیء دارای این قالب است:

{ color: <string>,
  fontName: <string>,
  fontSize: <number>,
  bold: <boolean>,
  italic: <boolean> }
    

color می‌تواند هر رشته رنگی HTML باشد، برای مثال: 'red' یا '#00cc00' . همچنین به fontName و fontSize مراجعه کنید.

نوع: object
پیش‌فرض: {color: 'black', fontName: <global-font-name>, fontSize: <global-font-size>}
برچسب‌های درمان‌شده به عنوان متن

اگر روی true تنظیم شود، نمودار با ستون به عنوان یک ستون متنی رفتار خواهد کرد.

نوع: boolean
استفاده از ستون اول به عنوان دامنه

اگر روی true تنظیم شود، نمودار ستون را به عنوان دامنه در نظر می‌گیرد.

نوع: boolean
وکس

اگر نمودار دارای چندین محور عمودی باشد، ویژگی‌هایی را برای محورهای عمودی منفرد مشخص می‌کند. هر شیء فرزند یک شیء vAxis است و می‌تواند شامل تمام ویژگی‌های پشتیبانی شده توسط vAxis باشد. مقادیر این ویژگی‌ها، هرگونه تنظیمات سراسری برای همان ویژگی را لغو می‌کنند.

برای مشخص کردن نموداری با چندین محور عمودی، ابتدا یک محور جدید با استفاده از series.targetAxisIndex تعریف کنید، سپس محور را با استفاده vAxes پیکربندی کنید. مثال زیر سری ۲ را به محور سمت راست اختصاص می‌دهد و یک عنوان و سبک متن سفارشی برای آن مشخص می‌کند:

{
  series: {
    2: {
      targetAxisIndex:1
    }
  },
  vAxes: {
    1: {
      title:'Losses',
      textStyle: {color: 'red'}
    }
  }
}
    

این ویژگی می‌تواند یک شیء یا یک آرایه باشد: شیء مجموعه‌ای از اشیاء است که هر کدام دارای یک برچسب عددی هستند که محوری را که تعریف می‌کند مشخص می‌کند - این قالبی است که در بالا نشان داده شده است؛ آرایه مجموعه‌ای از اشیاء است که برای هر محور یک شیء وجود دارد. برای مثال، نمادگذاری به سبک آرایه زیر با شیء vAxis که در بالا نشان داده شده است، یکسان است:

vAxes: [
  {}, // Nothing specified for axis 0
  {
    title:'Losses',
    textStyle: {color: 'red'} // Axis 1
  }
]
    
نوع: آرایه‌ای از اشیاء، یا اشیاء دارای اشیاء فرزند
پیش‌فرض: null
واکسیس

یک شیء با اعضایی برای پیکربندی عناصر مختلف محور عمودی. برای مشخص کردن ویژگی‌های این شیء، می‌توانید از نمادگذاری تحت‌اللفظی شیء، همانطور که در اینجا نشان داده شده است، استفاده کنید:

{title: 'Hello', titleTextStyle: {color: '#FF0000'}}
نوع: object
پیش‌فرض: null
جهت محور v

جهتی که مقادیر در امتداد محور عمودی رشد می‌کنند. به طور پیش‌فرض، مقادیر پایین در پایین نمودار قرار دارند. برای معکوس کردن ترتیب مقادیر، -1 را مشخص کنید.

نوع: 1 یا -1
پیش‌فرض: 1
vAxis.gridlines

یک شیء با اعضایی برای پیکربندی خطوط شبکه‌ای روی محور عمودی. توجه داشته باشید که خطوط شبکه‌ای محور عمودی به صورت افقی ترسیم می‌شوند. برای تعیین ویژگی‌های این شیء، می‌توانید از نمادگذاری تحت‌اللفظی شیء، همانطور که در اینجا نشان داده شده است، استفاده کنید:

{color: '#333', minSpacing: 20}

این گزینه فقط برای یک محور continuous پشتیبانی می‌شود.

نوع: object
پیش‌فرض: null
vAxis.gridlines.color

رنگ خطوط شبکه عمودی درون ناحیه نمودار. یک رشته رنگ معتبر HTML مشخص کنید.

نوع: string
پیش‌فرض: '#CCC'
vAxis.gridlines.count

تعداد تقریبی خطوط شبکه افقی درون محدوده نمودار. اگر یک عدد مثبت برای gridlines.count تعیین کنید، از آن برای محاسبه minSpacing بین خطوط شبکه استفاده می‌شود. می‌توانید مقدار 1 را برای رسم فقط یک خط شبکه یا 0 برای رسم هیچ خط شبکه‌ای تعیین کنید. مقدار -1 را که مقدار پیش‌فرض است، برای محاسبه خودکار تعداد خطوط شبکه بر اساس گزینه‌های دیگر تعیین کنید.

نوع: number
پیش‌فرض: -1
vAxis.logScale

اگر true ، محور عمودی را به صورت لگاریتمی نمایش می‌دهد. توجه: همه مقادیر باید مثبت باشند.

نوع: boolean
پیش‌فرض: false
vAxis.maxValue

حداکثر مقدار محور عمودی را به مقدار مشخص شده منتقل می‌کند؛ این مقدار در اکثر نمودارها به سمت بالا خواهد بود. اگر این مقدار کوچکتر از حداکثر مقدار y داده‌ها باشد، نادیده گرفته می‌شود. vAxis.viewWindow.max این ویژگی را لغو می‌کند.

نوع: number
پیش‌فرض: خودکار
vAxis.minorGridlines

یک شیء با اعضایی برای پیکربندی خطوط شبکه فرعی روی محور عمودی، مشابه گزینه vAxis.gridlines.

نوع: object
پیش‌فرض: null
vAxis.minorGridlines.color

رنگ خطوط شبکه‌ای فرعی عمودی درون ناحیه نمودار. یک رشته رنگ معتبر HTML مشخص کنید.

نوع: string
پیش‌فرض: ترکیبی از رنگ‌های خطوط شبکه و پس‌زمینه
vAxis.minorGridlines.count

گزینه minorGridlines.count عمدتاً منسوخ شده است، به جز برای غیرفعال کردن خطوط شبکه فرعی با تنظیم تعداد آنها روی 0 تعداد خطوط شبکه فرعی به فاصله بین خطوط شبکه اصلی و حداقل فضای مورد نیاز بستگی دارد.

نوع: number
پیش‌فرض: 1
مقدار حداقلی vAxis

مقدار حداقل محور عمودی را به مقدار مشخص شده منتقل می‌کند؛ این مقدار در اکثر نمودارها رو به پایین خواهد بود. اگر این مقدار بزرگتر از حداقل مقدار y داده‌ها باشد، نادیده گرفته می‌شود. vAxis.viewWindow.min این ویژگی را لغو می‌کند.

نوع: number
پیش‌فرض: null
موقعیت متن vAxis

موقعیت متن محور عمودی، نسبت به ناحیه نمودار. مقادیر پشتیبانی شده: 'out' ، 'in' ، 'none' .

نوع: string
پیش‌فرض: 'out'
سبک متن vAxis

شیء‌ای که سبک متن محور عمودی را مشخص می‌کند. این شیء دارای این قالب است:

{ color: <string>,
  fontName: <string>,
  fontSize: <number>,
  bold: <boolean>,
  italic: <boolean> }
    

color می‌تواند هر رشته رنگی HTML باشد، برای مثال: 'red' یا '#00cc00' . همچنین به fontName و fontSize مراجعه کنید.

نوع: object
پیش‌فرض: {color: 'black', fontName: <global-font-name>, fontSize: <global-font-size>}
vAxis.title

عنوانی را برای محور عمودی مشخص می‌کند.

نوع: string
پیش‌فرض: بدون عنوان
vAxis.titleTextStyle

شیء‌ای که سبک متن عنوان محور عمودی را مشخص می‌کند. این شیء دارای این قالب است:

{ color: <string>,
  fontName: <string>,
  fontSize: <number>,
  bold: <boolean>,
  italic: <boolean> }
  

color می‌تواند هر رشته رنگی HTML باشد، برای مثال: 'red' یا '#00cc00' . همچنین به fontName و fontSize مراجعه کنید.

نوع: object
پیش‌فرض: {color: 'black', fontName: <global-font-name>, fontSize: <global-font-size>}
پنجره‌ی vAxis.viewWindow

محدوده برش محور عمودی را مشخص می‌کند.

نوع: object
پیش‌فرض: null
vAxis.viewWindow.max

حداکثر مقدار داده عمودی برای رندر کردن.

وقتی vAxis.viewWindowMode در حالت «pretty» یا «maximized» باشد، نادیده گرفته می‌شود.

نوع: number
پیش‌فرض: خودکار
vAxis.viewWindow.min

حداقل مقدار داده عمودی برای رندر کردن.

وقتی vAxis.viewWindowMode در حالت «pretty» یا «maximized» باشد، نادیده گرفته می‌شود.

نوع: number
پیش‌فرض: خودکار

گزینه‌های پیکربندی نمودار میله‌ای

نام
رنگ پس‌زمینه

رنگ پس‌زمینه برای ناحیه اصلی نمودار. می‌تواند یک رشته رنگ ساده HTML باشد، برای مثال: 'red' یا '#00cc00' ، یا یک شیء با ویژگی‌های زیر.

نوع: string یا object
پیش‌فرض: 'white'
رنگ پس‌زمینه.پر کردن

رنگ پر کردن نمودار، به عنوان یک رشته رنگ HTML.

نوع: string
پیش‌فرض: 'white'
نمودارمنطقه

یک شیء با اعضا برای پیکربندی محل قرارگیری و اندازه ناحیه نمودار (جایی که خود نمودار رسم می‌شود، به استثنای محور و راهنماها). دو قالب پشتیبانی می‌شوند: یک عدد، یا یک عدد به دنبال آن %. یک عدد ساده مقداری بر حسب پیکسل است؛ عددی که به دنبال آن % می‌آید، درصد است. مثال: chartArea:{left:20,top:0,width:'50%',height:'75%'}

نوع: object
پیش‌فرض: null
رنگ زمینه نمودار
رنگ پس‌زمینه‌ی ناحیه‌ی نمودار. وقتی از یک رشته استفاده می‌شود، می‌تواند یک رشته‌ی هگز (مثلاً '#fdc' ) یا یک نام رنگ انگلیسی باشد. وقتی از یک شیء استفاده می‌شود، ویژگی‌های زیر می‌توانند ارائه شوند:
  • stroke : رنگ، که به صورت یک رشته هگز یا نام رنگ انگلیسی ارائه می‌شود.
  • strokeWidth : در صورت وجود، یک حاشیه دور ناحیه نمودار با عرض داده شده (و با رنگ stroke ) رسم می‌کند.
نوع: string یا object
پیش‌فرض: 'white'
مساحت نمودار.ارتفاع

ارتفاع ناحیه نمودار.

نوع: number یا string
پیش‌فرض: خودکار
chartArea.left

نمودار را تا چه فاصله‌ای از مرز چپ رسم کنیم.

نوع: number یا string
پیش‌فرض: خودکار
chartArea.top

نمودار را تا چه فاصله‌ای از حاشیه بالایی رسم کنیم.

نوع: number یا string
پیش‌فرض: خودکار
عرض نمودار

عرض ناحیه نمودار.

نوع: عدد یا string
پیش‌فرض: خودکار
رنگ‌ها

رنگ‌هایی که برای عناصر نمودار استفاده می‌شوند. آرایه‌ای از رشته‌ها، که در آن هر عنصر یک رشته رنگ HTML است، برای مثال: colors:['red','#004411'] .

نوع: آرایه‌ای از رشته‌ها
پیش‌فرض: رنگ‌های پیش‌فرض
هکس

اگر نمودار دارای چندین محور افقی باشد، ویژگی‌هایی را برای محورهای افقی منفرد مشخص می‌کند. هر شیء فرزند یک شیء hAxis است و می‌تواند شامل تمام ویژگی‌های پشتیبانی شده توسط hAxis باشد. مقادیر این ویژگی‌ها، هرگونه تنظیمات سراسری برای همان ویژگی را لغو می‌کنند.

برای مشخص کردن نموداری با چندین محور افقی، ابتدا یک محور جدید با استفاده از series.targetAxisIndex تعریف کنید، سپس محور را با استفاده hAxes پیکربندی کنید. مثال زیر سری 1 را به محور پایینی اختصاص می‌دهد و یک عنوان و سبک متن سفارشی برای آن مشخص می‌کند:

series:{1:{targetAxisIndex:1{% raw %}}}{% endraw %}, hAxes:{1:{title:'Losses', textStyle:{color: 'red'{% raw %}}}{% endraw %}}

این ویژگی می‌تواند یک شیء یا یک آرایه باشد: شیء مجموعه‌ای از اشیاء است که هر کدام دارای یک برچسب عددی هستند که محوری را که تعریف می‌کند مشخص می‌کند - این قالبی است که در بالا نشان داده شده است؛ آرایه مجموعه‌ای از اشیاء است که برای هر محور یک شیء وجود دارد. برای مثال، نمادگذاری به سبک آرایه زیر با شیء hAxis نشان داده شده در بالا یکسان است:

hAxes: {
  {}, // Nothing specified for axis 0
  {
    title:'Losses',
    textStyle: {
      color: 'red'
    }
  } // Axis 1
    
نوع: آرایه‌ای از اشیاء، یا اشیاء دارای اشیاء فرزند
پیش‌فرض: null
اچ اکسیس

یک شیء با اعضایی برای پیکربندی عناصر مختلف محور افقی. برای مشخص کردن ویژگی‌های این شیء، می‌توانید از نمادگذاری تحت‌اللفظی شیء، همانطور که در اینجا نشان داده شده است، استفاده کنید:

{
  title: 'Hello',
  titleTextStyle: {
    color: '#FF0000'
  }
}
    
نوع: object
پیش‌فرض: null
جهت محور h

جهتی که مقادیر در امتداد محور افقی رشد می‌کنند. برای معکوس کردن ترتیب مقادیر، -1 را مشخص کنید.

نوع: 1 یا -1
پیش‌فرض: 1
خطوط شبکه‌ای hAxis

یک شیء با ویژگی‌هایی برای پیکربندی خطوط شبکه‌ای روی محور افقی. توجه داشته باشید که خطوط شبکه‌ای محور افقی به صورت عمودی ترسیم می‌شوند. برای تعیین ویژگی‌های این شیء، می‌توانید از نمادگذاری تحت‌اللفظی شیء، همانطور که در اینجا نشان داده شده است، استفاده کنید:

{color: '#333', minSpacing: 20}

این گزینه فقط برای یک محور continuous پشتیبانی می‌شود.

نوع: object
پیش‌فرض: null
خطوط شبکه‌ای hAxis.gridlines.color

رنگ خطوط شبکه افقی درون ناحیه نمودار. یک رشته رنگ معتبر HTML مشخص کنید.

نوع: string
پیش‌فرض: '#CCC'
تعداد خطوط شبکه hAxis

تعداد تقریبی خطوط شبکه افقی درون محدوده نمودار. اگر یک عدد مثبت برای gridlines.count تعیین کنید، از آن برای محاسبه minSpacing بین خطوط شبکه استفاده می‌شود. می‌توانید مقدار 1 را برای رسم فقط یک خط شبکه یا 0 برای رسم هیچ خط شبکه‌ای تعیین کنید. مقدار -1 را که مقدار پیش‌فرض است، برای محاسبه خودکار تعداد خطوط شبکه بر اساس گزینه‌های دیگر تعیین کنید.

نوع: number
پیش‌فرض: -1
hAxis.logScale

ویژگی hAxis که محور افقی را به صورت لگاریتمی نمایش می‌دهد (نیازمند مثبت بودن همه مقادیر است). برای بله، روی true تنظیم می‌شود.

این گزینه فقط برای یک محور continuous پشتیبانی می‌شود.

نوع: boolean
پیش‌فرض: false
مقدار حداکثر hAxis

حداکثر مقدار محور افقی را به مقدار مشخص شده منتقل می‌کند؛ این مقدار در اکثر نمودارها به سمت راست خواهد بود. اگر این مقدار کوچکتر از حداکثر مقدار x داده‌ها باشد، نادیده گرفته می‌شود. hAxis.viewWindow.max این ویژگی را لغو می‌کند.

نوع: number
پیش‌فرض: خودکار
خطوط شبکه‌ای جزئی hAxis

یک شیء با اعضایی برای پیکربندی خطوط شبکه فرعی روی محور افقی، مشابه گزینه hAxis.gridlines .

این گزینه فقط برای یک محور continuous پشتیبانی می‌شود.

نوع: object
پیش‌فرض: null
خطوط شبکه جزئی hAxis.minor.color

رنگ خطوط شبکه‌ای فرعی افقی درون ناحیه نمودار. یک رشته رنگ معتبر HTML مشخص کنید.

نوع: string
پیش‌فرض: ترکیبی از رنگ‌های خطوط شبکه و پس‌زمینه
تعداد خطوط شبکه جزئی hAxis

گزینه minorGridlines.count عمدتاً منسوخ شده است، به جز غیرفعال کردن خطوط شبکه فرعی با تنظیم تعداد آنها روی ۰. تعداد خطوط شبکه فرعی اکنون کاملاً به فاصله بین خطوط شبکه اصلی (به hAxis.gridlines.interval مراجعه کنید) و حداقل فضای مورد نیاز (به hAxis.minorGridlines.minSpacing مراجعه کنید) بستگی دارد.

نوع: number
پیش‌فرض: 1
مقدار حداقلی hAxis

مقدار حداقل محور افقی را به مقدار مشخص شده منتقل می‌کند؛ این مقدار در اکثر نمودارها به سمت چپ خواهد بود. اگر این مقدار بزرگتر از حداقل مقدار x داده‌ها باشد، نادیده گرفته می‌شود. hAxis.viewWindow.min این ویژگی را لغو می‌کند.

نوع: number
پیش‌فرض: خودکار
موقعیت متن hAxis

موقعیت متن محور افقی، نسبت به ناحیه نمودار. مقادیر پشتیبانی شده: 'out' ، 'in' ، 'none' .

نوع: string
پیش‌فرض: 'out'
سبک متن hAxis

شیء‌ای که سبک متن محور افقی را مشخص می‌کند. این شیء دارای این قالب است:

{ color: <string>,
  fontName: <string>,
  fontSize: <number>,
  bold: <boolean>,
  italic: <boolean> }
    

color می‌تواند هر رشته رنگی HTML باشد، برای مثال: 'red' یا '#00cc00' . همچنین به fontName و fontSize مراجعه کنید.

نوع: object
پیش‌فرض: {color: 'black', fontName: <global-font-name>, fontSize: <global-font-size>}
hAxis.title

ویژگی hAxis که عنوان محور افقی را مشخص می‌کند.

نوع: string
پیش‌فرض: null
hAxis.titleTextStyle

شیء‌ای که سبک متن عنوان محور افقی را مشخص می‌کند. این شیء دارای این قالب است:

{ color: <string>,
  fontName: <string>,
  fontSize: <number>,
  bold: <boolean>,
  italic: <boolean> }
    

color می‌تواند هر رشته رنگی HTML باشد، برای مثال: 'red' یا '#00cc00' . همچنین به fontName و fontSize مراجعه کنید.

نوع: object
پیش‌فرض: {color: 'black', fontName: <global-font-name>, fontSize: <global-font-size>}
پنجره‌ی نمای محور hAxis

محدوده برش محور افقی را مشخص می‌کند.

نوع: object
پیش‌فرض: null
hAxis.viewWindow.max

حداکثر مقدار داده افقی برای رندر کردن.

وقتی hAxis.viewWindowMode برابر با 'pretty' یا 'maximized' باشد، نادیده گرفته می‌شود.

نوع: number
پیش‌فرض: خودکار
hAxis.viewWindow.min

حداقل مقدار داده افقی برای رندر شدن.

وقتی hAxis.viewWindowMode برابر با 'pretty' یا 'maximized' باشد، نادیده گرفته می‌شود.

نوع: number
پیش‌فرض: خودکار
ارتفاع

ارتفاع نمودار بر حسب پیکسل.

نوع: number
پیش‌فرض: ارتفاع عنصر حاوی
ای‌استکد

اگر روی true تنظیم شود، عناصر را برای همه سری‌ها در هر مقدار دامنه روی هم قرار می‌دهد. توجه: در نمودارهای Column ، Area و SteppedArea ، Google Charts ترتیب عناصر راهنما را معکوس می‌کند تا با چیدمان عناصر سری مطابقت بهتری داشته باشد (مثلاً سری 0 پایین‌ترین عنصر راهنما خواهد بود). این مورد در مورد نمودارهای میله‌ای صدق نمی‌کند .

گزینه isStacked همچنین از انباشتگی ۱۰۰٪ پشتیبانی می‌کند، که در آن، انباشت عناصر در هر مقدار دامنه، برای رسیدن به ۱۰۰٪، مقیاس‌بندی مجدد می‌شوند.

گزینه‌های isStacked عبارتند از:

  • false — عناصر روی هم قرار نمی‌گیرند. این گزینه پیش‌فرض است.
  • true — عناصر همه سری‌ها را در هر مقدار دامنه روی هم قرار می‌دهد.
  • 'percent' - عناصر را برای همه سری‌ها در هر مقدار دامنه روی هم قرار می‌دهد و آنها را طوری مقیاس‌بندی می‌کند که مجموع آنها به ۱۰۰٪ برسد، و مقدار هر عنصر به صورت درصدی از ۱۰۰٪ محاسبه می‌شود.
  • 'relative' - عناصر همه سری‌ها را در هر مقدار دامنه روی هم قرار می‌دهد و آنها را طوری مقیاس‌بندی می‌کند که مجموع آنها برابر با ۱ شود، و مقدار هر عنصر به صورت کسری از ۱ محاسبه شود.
  • 'absolute' - عملکردی مشابه isStacked: true .

برای انباشت ۱۰۰٪، مقدار محاسبه‌شده برای هر عنصر در راهنمای ابزار، پس از مقدار واقعی آن ظاهر می‌شود.

محور هدف به طور پیش‌فرض مقادیر تیک را بر اساس مقیاس نسبی ۰-۱ به عنوان کسری از ۱ برای 'relative' و ۰-۱۰۰٪ برای 'percent' نمایش می‌دهد ( توجه: هنگام استفاده از گزینه 'percent' ، مقادیر محور/تیک به صورت درصد نمایش داده می‌شوند، با این حال مقادیر واقعی، مقادیر مقیاس نسبی ۰-۱ هستند. دلیل این امر این است که تیک‌های محور درصد نتیجه اعمال فرمت "#.##%" به مقادیر مقیاس نسبی ۰-۱ هستند. هنگام استفاده از isStacked: 'percent' ، حتماً هرگونه تیک/خطوط شبکه را با استفاده از مقادیر مقیاس نسبی ۰-۱ مشخص کنید). می‌توانید مقادیر خطوط شبکه/تیک و قالب‌بندی را با استفاده از گزینه‌های hAxis/vAxis مناسب سفارشی کنید.

انباشتگی ۱۰۰٪ فقط از مقادیر داده‌ای از نوع number پشتیبانی می‌کند و باید دارای مقدار پایه صفر باشد.

نوع: boolean / string
پیش‌فرض: false
افسانه

یک شیء با اعضایی برای پیکربندی جنبه‌های مختلف راهنما. برای مشخص کردن ویژگی‌های این شیء، می‌توانید از نمادگذاری تحت‌اللفظی شیء، همانطور که در اینجا نشان داده شده است، استفاده کنید:

{position: 'top', textStyle: {color: 'blue', fontSize: 16}}
نوع: object
پیش‌فرض: null
موقعیت افسانه

موقعیت راهنما. می‌تواند یکی از موارد زیر باشد:

  • 'bottom' - زیر نمودار.
  • 'left' - در سمت چپ نمودار، مشروط بر اینکه محور چپ هیچ سری مرتبط با آن نداشته باشد. بنابراین اگر می‌خواهید راهنما در سمت چپ باشد، از گزینه targetAxisIndex: 1 استفاده کنید.
  • 'in' - داخل نمودار، در گوشه بالا سمت چپ.
  • 'none' - هیچ شرحی نمایش داده نمی‌شود.
  • 'right' - در سمت راست نمودار. با گزینه vAxes سازگار نیست.
  • 'top' - بالای نمودار.
نوع: string
پیش‌فرض: 'right'
سبک متن افسانه‌ای

شیء‌ای که سبک متن راهنما را مشخص می‌کند. این شیء دارای این قالب است:

{ color: <string>,
  fontName: <string>,
  fontSize: <number>,
  bold: <boolean>,
  italic: <boolean> }
    

color می‌تواند هر رشته رنگی HTML باشد، برای مثال: 'red' یا '#00cc00' . همچنین به fontName و fontSize مراجعه کنید.

نوع: object
پیش‌فرض: {color: 'black', fontName: <global-font-name>, fontSize: <global-font-size>}
معکوسدسته‌بندی‌ها

اگر روی true تنظیم شود، دنباله‌ها را از راست به چپ رسم می‌کند. مقدار پیش‌فرض، رسم از چپ به راست است.

این گزینه فقط برای محور major discrete پشتیبانی می‌شود.

نوع: boolean
پیش‌فرض: false
سری

آرایه‌ای از اشیاء که هر کدام قالب سری مربوطه را در نمودار توصیف می‌کنند. برای استفاده از مقادیر پیش‌فرض برای یک سری، یک شیء خالی {} مشخص کنید. اگر یک سری یا یک مقدار مشخص نشده باشد، از مقدار سراسری استفاده خواهد شد. هر شیء از ویژگی‌های زیر پشتیبانی می‌کند:

  • annotations - شیء‌ای که قرار است روی حاشیه‌نویسی‌های این مجموعه اعمال شود. این شیء می‌تواند برای کنترل، مثلاً، textStyle برای مجموعه، استفاده شود:

    series: {
      0: {
        annotations: {
          textStyle: {fontSize: 12, color: 'red' }
        }
      }
    }
              

    برای فهرست کامل‌تری از موارد قابل سفارشی‌سازی، گزینه‌های مختلف annotations مشاهده کنید.

  • color - رنگی که برای این سری استفاده می‌شود. یک رشته رنگ معتبر HTML مشخص کنید.
  • labelInLegend - شرح سری که قرار است در راهنمای نمودار نمایش داده شود.
  • targetAxisIndex - این سری به کدام محور اختصاص داده شود، که در آن 0 محور پیش‌فرض و 1 محور مقابل است. مقدار پیش‌فرض 0 است؛ برای تعریف نموداری که سری‌های مختلف در برابر محورهای مختلف رندر می‌شوند، روی 1 تنظیم شود. حداقل یک سری باید به محور پیش‌فرض اختصاص داده شود. می‌توانید برای محورهای مختلف مقیاس متفاوتی تعریف کنید.
  • visibleInLegend - یک مقدار boolean ، که در آن true به این معنی است که سری باید دارای ورودی راهنما باشد و false به این معنی است که نباید داشته باشد. مقدار پیش‌فرض true است.

شما می‌توانید آرایه‌ای از اشیاء را مشخص کنید که هر کدام به ترتیب داده شده به سری اعمال می‌شوند، یا می‌توانید شیء‌ای را مشخص کنید که هر فرزند آن یک کلید عددی دارد که نشان می‌دهد به کدام سری اعمال می‌شود. برای مثال، دو تعریف زیر یکسان هستند و سری اول را به صورت سیاه و بدون راهنما و سری چهارم را به صورت قرمز و بدون راهنما اعلام می‌کنند:

series: [
  {color: 'black', visibleInLegend: false}, {}, {},
  {color: 'red', visibleInLegend: false}
]
series: {
  0:{color: 'black', visibleInLegend: false},
  3:{color: 'red', visibleInLegend: false}
}
    
نوع: آرایه‌ای از اشیاء، یا شیء با اشیاء تو در تو
پیش‌فرض: {}
زیرنویس

متنی که زیر عنوان نمودار نمایش داده می‌شود.

نوع: string
پیش‌فرض: بدون عنوان
زیرنویسTextStyle

شیء‌ای که سبک متن عنوان را مشخص می‌کند.

color می‌تواند هر رشته رنگی HTML باشد، برای مثال: 'red' یا '#00cc00' . همچنین به fontName و fontSize مراجعه کنید.

نوع: object
پیش‌فرض: {color: 'black', fontName: <global-font-name>, fontSize: <global-font-size>}
تم

یک تم مجموعه‌ای از مقادیر گزینه‌های از پیش تعریف شده است که برای دستیابی به یک رفتار نمودار یا جلوه بصری خاص با هم کار می‌کنند. در حال حاضر فقط یک تم موجود است:

  • 'maximized' - Maximizes the area of the chart, and draws the legend and all of the labels inside the chart area.
Type: string
Default: null
عنوان

Text to display above the chart.

Type: string
Default: no title
titleTextStyle

An object that specifies the title text style. The object has this format:

{ color: <string>,
  fontName: <string>,
  fontSize: <number>,
  bold: <boolean>,
  italic: <boolean> }
    

The color can be any HTML color string, for example: 'red' or '#00cc00' . Also see fontName and fontSize .

Type: object
Default: {color: 'black', fontName: <global-font-name>, fontSize: <global-font-size>}
خطوط روند

Displays trendlines on the charts that support them. By default, linear trendlines are used, but this can be customized with the trendlines. n .type option.

Trendlines are specified on a per-series basis, so most of the time your options will look like this:

var options = {
  trendlines: {
    0: {
      type: 'linear',
      color: 'green',
      lineWidth: 3,
      opacity: 0.3,
      visibleInLegend: true
    }
  }
}
    
Type: object
Default: null
trendlines.n.color

The color of the trendline , expressed as either an English color name or a hex string.

Type: string
Default: default series color
trendlines.n.degree

For trendlines of type: 'polynomial' , the degree of the polynomial ( 2 for quadratic, 3 for cubic, and so on).

Type: number
Default: 3
trendlines.n.labelInLegend

If set, the trendline will appear in the legend as this string.

Type: string
Default: null
trendlines.n.lineWidth

The line width of the trendline , in pixels.

Type: number
پیش‌فرض: 2
trendlines.n.type

Whether the trendlines is 'linear' (the default), 'exponential' , or 'polynomial' .

Type: string
Default: linear
trendlines.n.visibleInLegend

Whether the trendline equation appears in the legend. It will appear in the trendline tooltip.

Type: boolean
پیش‌فرض: false
useFirstColumnAsDomain

If set to true , the chart will treat the column as the domain.

Type: boolean
vAxis

An object with members to configure various vertical axis elements. To specify properties of this object, you can use object literal notation, as shown here:

{title: 'Hello', titleTextStyle: {color: '#FF0000'}}
Type: object
Default: null
vAxis.direction

The direction in which the values along the vertical axis grow. By default, low values are on the bottom of the chart. Specify -1 to reverse the order of the values.

Type: 1 or -1
پیش‌فرض: 1
vAxis.gridlines

An object with members to configure the gridlines on the vertical axis. Note that vertical axis gridlines are drawn horizontally. To specify properties of this object, you can use object literal notation, as shown here:

{color: '#333', minSpacing: 20}

This option is only supported for a continuous axis.

Type: object
Default: null
vAxis.gridlines.color

The color of the vertical gridlines inside the chart area. Specify a valid HTML color string.

Type: string
Default: '#CCC'
vAxis.gridlines.count

The approximate number of horizontal gridlines inside the chart area. If you specify a positive number for gridlines.count , it will be used to compute the minSpacing between gridlines. You can specify a value of 1 to only draw one gridline, or 0 to draw no gridlines. Specify -1 , which is the default, to automatically compute the number of gridlines based on other options.

Type: number
Default: -1
vAxis.logScale

If true , makes the vertical axis a logarithmic scale. Note: All values must be positive.

Type: boolean
پیش‌فرض: false
vAxis.maxValue

Moves the max value of the vertical axis to the specified value; this will be upward in most charts. Ignored if this is set to a value smaller than the maximum y-value of the data. vAxis.viewWindow.max overrides this property.

Type: number
Default: automatic
vAxis.minorGridlines

An object with members to configure the minor gridlines on the vertical axis, similar to the vAxis.gridlines option.

Type: object
Default: null
vAxis.minorGridlines.color

The color of the vertical minor gridlines inside the chart area. Specify a valid HTML color string.

Type: string
Default: A blend of the gridline and background colors
vAxis.minorGridlines.count

The minorGridlines.count option is mostly deprecated, except for disabling minor gridlines by setting the count to 0 . The number of minor gridlines depends on the interval between major gridlines and the minimum required space.

Type: number
پیش‌فرض: 1
vAxis.minValue

Moves the min value of the vertical axis to the specified value; this will be downward in most charts. Ignored if this is set to a value greater than the minimum y-value of the data. vAxis.viewWindow.min overrides this property.

Type: number
Default: null
vAxis.textPosition

Position of the vertical axis text, relative to the chart area. Supported values: 'out' , 'in' , 'none' .

Type: string
Default: 'out'
vAxis.textStyle

An object that specifies the vertical axis text style. The object has this format:

{ color: <string>,
  fontName: <string>,
  fontSize: <number>,
  bold: <boolean>,
  italic: <boolean> }
    

The color can be any HTML color string, for example: 'red' or '#00cc00' . Also see fontName and fontSize .

Type: object
Default: {color: 'black', fontName: <global-font-name>, fontSize: <global-font-size>}
vAxis.title

Specifies a title for the vertical axis.

Type: string
Default: no title
vAxis.titleTextStyle

An object that specifies the vertical axis title text style. The object has this format:

{ color: <string>,
  fontName: <string>,
  fontSize: <number>,
  bold: <boolean>,
  italic: <boolean> }
  

The color can be any HTML color string, for example: 'red' or '#00cc00' . Also see fontName and fontSize .

Type: object
Default: {color: 'black', fontName: <global-font-name>, fontSize: <global-font-size>}
vAxis.viewWindow

Specifies the cropping range of the vertical axis.

Type: object
Default: null
vAxis.viewWindow.max

The maximum vertical data value to render.

Ignored when vAxis.viewWindowMode is 'pretty' or 'maximized'.

Type: number
Default: auto
vAxis.viewWindow.min

The minimum vertical data value to render.

Ignored when vAxis.viewWindowMode is 'pretty' or 'maximized'.

Type: number
Default: auto

Bubble chart configuration options

نام
رنگ پس‌زمینه

The background color for the main area of the chart. Can be either a simple HTML color string, for example: 'red' or '#00cc00' , or an object with the following properties.

Type: string or object
Default: 'white'
backgroundColor.fill

The chart fill color, as an HTML color string.

Type: string
Default: 'white'
حباب

An object with members to configure the visual properties of the bubbles.

Type: object
Default: null
bubble.opacity

The opacity of the bubbles, where 0 is fully transparent and 1 is fully opaque.

Type: number between 0.0 and 1.0
Default: 0.8
bubble.stroke

The color of the bubbles' stroke.

Type: string
Default: '#ccc'
bubble.textStyle

An object that specifies the bubble text style. The object has this format:

{color: <string>, fontName: <string>, fontSize: <number>}

The color can be any HTML color string, for example: 'red' or '#00cc00' . Also see fontName and fontSize .

Type: object
Default: {color: 'black', fontName: <global-font-name>, fontSize: <global-font-size>}
chartArea

An object with members to configure the placement and size of the chart area (where the chart itself is drawn, excluding axis and legends). Two formats are supported: a number or a number followed by %. A simple number is a value in pixels; a number followed by % is a percentage. Example: chartArea:{left:20,top:0,width:'50%',height:'75%'}

Type: object
Default: null
chartArea.backgroundColor
Chart area background color. When a string is used, it can be either a hex string (eg, '#fdc' ) or an English color name. When an object is used, the following properties can be provided:
  • stroke : The color, provided as a hex string or English color name.
  • strokeWidth : If provided, draws a border around the chart area of the given width (and with the color of stroke ).
Type: string or object
Default: 'white'
chartArea.height

Chart area height.

Type: number or string
Default: auto
chartArea.left

How far to draw the chart from the left border.

Type: number or string
Default: auto
chartArea.top

How far to draw the chart from the top border.

Type: number or string
Default: auto
chartArea.width

Chart area width.

Type: number or string
Default: auto
رنگ‌ها

The colors to use for the chart elements. An array of strings, where each element is an HTML color string, for example: colors:['red','#004411'] .

Type: Array of strings
Default: default colors
hAxis

An object with members to configure various horizontal axis elements. To specify properties of this object, you can use object literal notation, as shown here:

{
  title: 'Hello',
  titleTextStyle: {
    color: '#FF0000'
  }
}
    
Type: object
Default: null
hAxis.direction

The direction in which the values along the horizontal axis grow. Specify -1 to reverse the order of the values.

Type: 1 or -1
پیش‌فرض: 1
hAxis.gridlines

An object with properties to configure the gridlines on the horizontal axis. Note that horizontal axis gridlines are drawn vertically. To specify properties of this object, you can use object literal notation, as shown here:

{color: '#333', minSpacing: 20}

This option is only supported for a continuous axis.

Type: object
Default: null
hAxis.gridlines.color

The color of the horizontal gridlines inside the chart area. Specify a valid HTML color string.

Type: string
Default: '#CCC'
hAxis.gridlines.count

The approximate number of horizontal gridlines inside the chart area. If you specify a positive number for gridlines.count , it will be used to compute the minSpacing between gridlines. You can specify a value of 1 to only draw one gridline, or 0 to draw no gridlines. Specify -1 , which is the default, to automatically compute the number of gridlines based on other options.

Type: number
Default: -1
hAxis.logScale

hAxis property that makes the horizontal axis a logarithmic scale (requires all values to be positive). Set to true for yes.

This option is only supported for a continuous axis.

Type: boolean
پیش‌فرض: false
hAxis.maxValue

Moves the max value of the horizontal axis to the specified value; this will be rightward in most charts. Ignored if this is set to a value smaller than the maximum x-value of the data. hAxis.viewWindow.max overrides this property.

Type: number
Default: automatic
hAxis.minorGridlines

An object with members to configure the minor gridlines on the horizontal axis, similar to the hAxis.gridlines option.

This option is only supported for a continuous axis.

Type: object
Default: null
hAxis.minorGridlines.color

The color of the horizontal minor gridlines inside the chart area. Specify a valid HTML color string.

Type: string
Default: A blend of the gridline and background colors
hAxis.minorGridlines.count

The minorGridlines.count option is mostly deprecated, except for disabling minor gridlines by setting the count to 0. The number of minor gridlines now depends entirely on the interval between major gridlines (see hAxis.gridlines.interval ) and the minimum required space (see hAxis.minorGridlines.minSpacing ).

Type: number
پیش‌فرض: 1
hAxis.minValue

Moves the min value of the horizontal axis to the specified value; this will be leftward in most charts. Ignored if this is set to a value greater than the minimum x-value of the data. hAxis.viewWindow.min overrides this property.

Type: number
Default: automatic
hAxis.textPosition

Position of the horizontal axis text, relative to the chart area. Supported values: 'out' , 'in' , 'none' .

Type: string
Default: 'out'
hAxis.textStyle

An object that specifies the horizontal axis text style. The object has this format:

{ color: <string>,
  fontName: <string>,
  fontSize: <number>,
  bold: <boolean>,
  italic: <boolean> }
    

The color can be any HTML color string, for example: 'red' or '#00cc00' . Also see fontName and fontSize .

Type: object
Default: {color: 'black', fontName: <global-font-name>, fontSize: <global-font-size>}
hAxis.title

hAxis property that specifies the title of the horizontal axis.

Type: string
Default: null
hAxis.titleTextStyle

An object that specifies the horizontal axis title text style. The object has this format:

{ color: <string>,
  fontName: <string>,
  fontSize: <number>,
  bold: <boolean>,
  italic: <boolean> }
    

The color can be any HTML color string, for example: 'red' or '#00cc00' . Also see fontName and fontSize .

Type: object
Default: {color: 'black', fontName: <global-font-name>, fontSize: <global-font-size>}
hAxis.viewWindow

Specifies the cropping range of the horizontal axis.

Type: object
Default: null
hAxis.viewWindow.max

The maximum horizontal data value to render.

Ignored when hAxis.viewWindowMode is 'pretty' or 'maximized' .

Type: number
Default: auto
hAxis.viewWindow.min

The minimum horizontal data value to render.

Ignored when hAxis.viewWindowMode is 'pretty' or 'maximized' .

Type: number
Default: auto
ارتفاع

Height of the chart in pixels.

Type: number
Default: height of the containing element
افسانه

An object with members to configure various aspects of the legend. To specify properties of this object, you can use object literal notation, as shown here:

{position: 'top', textStyle: {color: 'blue', fontSize: 16}}
Type: object
Default: null
legend.position

Position of the legend. Can be one of the following:

  • 'bottom' - Below the chart.
  • 'left' - To the left of the chart, provided the left axis has no series associated with it. So if you want the legend on the left, use the option targetAxisIndex: 1 .
  • 'in' - Inside the chart, by the top left corner.
  • 'none' - No legend is displayed.
  • 'right' - To the right of the chart. Incompatible with the vAxes option.
  • 'top' - Above the chart.
Type: string
Default: 'right'
legendTextStyle

An object that specifies the legend text style. The object has this format:

{ color: <string>,
  fontName: <string>,
  fontSize: <number>,
  bold: <boolean>,
  italic: <boolean> }
    

The color can be any HTML color string, for example: 'red' or '#00cc00' . Also see fontName and fontSize .

Type: object
Default: {color: 'black', fontName: <global-font-name>, fontSize: <global-font-size>}
سری

An object of objects, where the keys are series names (the values in the Color column) and each object describing the format of the corresponding series in the chart. If a series or a value is not specified, the global value will be used. Each object supports the following properties:

  • color - The color to use for this series. Specify a valid HTML color string.
  • visibleInLegend - A boolean value, where true means that the series should have a legend entry, and false means that it should not. Default is true .
مثال:
series: {'Europe': {color: 'green'}}
Type: Object with nested objects
پیش‌فرض: {}
sizeAxis

An object with members to configure how values are associated with bubble size. To specify properties of this object, you can use object literal notation, as shown here:

 {minValue: 0,  maxSize: 20}
Type: object
Default: null
sizeAxis.maxSize

Maximum radius of the largest possible bubble, in pixels.

Type: number
پیش‌فرض: ۳۰
sizeAxis.minSize

Minimum radius of the smallest possible bubble, in pixels.

Type: number
پیش‌فرض: ۵
زیرنویس

Text to display below the chart title.

Type: string
Default: no title
subtitleTextStyle

An object that specifies the title text style.

The color can be any HTML color string, for example: 'red' or '#00cc00' . Also see fontName and fontSize .

Type: object
Default: {color: 'black', fontName: <global-font-name>, fontSize: <global-font-size>}
تم

A theme is a set of predefined option values that work together to achieve a specific chart behavior or visual effect. Currently only one theme is available:

  • 'maximized' - Maximizes the area of the chart, and draws the legend and all of the labels inside the chart area.
Type: string
Default: null
عنوان

Text to display above the chart.

Type: string
Default: no title
titleTextStyle

An object that specifies the title text style. The object has this format:

{ color: <string>,
  fontName: <string>,
  fontSize: <number>,
  bold: <boolean>,
  italic: <boolean> }
    

The color can be any HTML color string, for example: 'red' or '#00cc00' . Also see fontName and fontSize .

Type: object
Default: {color: 'black', fontName: <global-font-name>, fontSize: <global-font-size>}
treatLabelsAsText

If set to true , the chart will treat the column as a text column.

Type: boolean
useFirstColumnAsDomain

If set to true , the chart will treat the column as the domain.

Type: boolean
vAxes

Specifies properties for individual vertical axes, if the chart has multiple vertical axes. Each child object is a vAxis object, and can contain all the properties supported by vAxis . These property values override any global settings for the same property.

To specify a chart with multiple vertical axes, first define a new axis using series.targetAxisIndex , then configure the axis using vAxes . The following example assigns series 2 to the right axis and specifies a custom title and text style for it:

{
  series: {
    2: {
      targetAxisIndex:1
    }
  },
  vAxes: {
    1: {
      title:'Losses',
      textStyle: {color: 'red'}
    }
  }
}
    

This property can be either an object or an array: the object is a collection of objects, each with a numeric label that specifies the axis that it defines--this is the format shown above; the array is an array of objects, one per axis. For example, the following array-style notation is identical to the vAxis object shown above:

vAxes: [
  {}, // Nothing specified for axis 0
  {
    title:'Losses',
    textStyle: {color: 'red'} // Axis 1
  }
]
    
Type: Array of object, or object with child objects
Default: null
vAxis

An object with members to configure various vertical axis elements. To specify properties of this object, you can use object literal notation, as shown here:

{title: 'Hello', titleTextStyle: {color: '#FF0000'}}
Type: object
Default: null
vAxis.direction

The direction in which the values along the vertical axis grow. By default, low values are on the bottom of the chart. Specify -1 to reverse the order of the values.

Type: 1 or -1
پیش‌فرض: 1
vAxis.gridlines

An object with members to configure the gridlines on the vertical axis. Note that vertical axis gridlines are drawn horizontally. To specify properties of this object, you can use object literal notation, as shown here:

{color: '#333', minSpacing: 20}

This option is only supported for a continuous axis.

Type: object
Default: null
vAxis.gridlines.color

The color of the vertical gridlines inside the chart area. Specify a valid HTML color string.

Type: string
Default: '#CCC'
vAxis.gridlines.count

The approximate number of horizontal gridlines inside the chart area. If you specify a positive number for gridlines.count , it will be used to compute the minSpacing between gridlines. You can specify a value of 1 to only draw one gridline, or 0 to draw no gridlines. Specify -1 , which is the default, to automatically compute the number of gridlines based on other options.

Type: number
Default: -1
vAxis.logScale

If true , makes the vertical axis a logarithmic scale. Note: All values must be positive.

Type: boolean
پیش‌فرض: false
vAxis.maxValue

Moves the max value of the vertical axis to the specified value; this will be upward in most charts. Ignored if this is set to a value smaller than the maximum y-value of the data. vAxis.viewWindow.max overrides this property.

Type: number
Default: automatic
vAxis.minorGridlines

An object with members to configure the minor gridlines on the vertical axis, similar to the vAxis.gridlines option.

Type: object
Default: null
vAxis.minorGridlines.color

The color of the vertical minor gridlines inside the chart area. Specify a valid HTML color string.

Type: string
Default: A blend of the gridline and background colors
vAxis.minorGridlines.count

The minorGridlines.count option is mostly deprecated, except for disabling minor gridlines by setting the count to 0 . The number of minor gridlines depends on the interval between major gridlines and the minimum required space.

Type: number
پیش‌فرض: 1
vAxis.minValue

Moves the min value of the vertical axis to the specified value; this will be downward in most charts. Ignored if this is set to a value greater than the minimum y-value of the data. vAxis.viewWindow.min overrides this property.

Type: number
Default: null
vAxis.textPosition

Position of the vertical axis text, relative to the chart area. Supported values: 'out' , 'in' , 'none' .

Type: string
Default: 'out'
vAxis.textStyle

An object that specifies the vertical axis text style. The object has this format:

{ color: <string>,
  fontName: <string>,
  fontSize: <number>,
  bold: <boolean>,
  italic: <boolean> }
    

The color can be any HTML color string, for example: 'red' or '#00cc00' . Also see fontName and fontSize .

Type: object
Default: {color: 'black', fontName: <global-font-name>, fontSize: <global-font-size>}
vAxis.title

Specifies a title for the vertical axis.

Type: string
Default: no title
vAxis.titleTextStyle

An object that specifies the vertical axis title text style. The object has this format:

{ color: <string>,
  fontName: <string>,
  fontSize: <number>,
  bold: <boolean>,
  italic: <boolean> }
  

The color can be any HTML color string, for example: 'red' or '#00cc00' . Also see fontName and fontSize .

Type: object
Default: {color: 'black', fontName: <global-font-name>, fontSize: <global-font-size>}
vAxis.viewWindow

Specifies the cropping range of the vertical axis.

Type: object
Default: null
vAxis.viewWindow.max

The maximum vertical data value to render.

Ignored when vAxis.viewWindowMode is 'pretty' or 'maximized'.

Type: number
Default: auto
vAxis.viewWindow.min

The minimum vertical data value to render.

Ignored when vAxis.viewWindowMode is 'pretty' or 'maximized'.

Type: number
Default: auto

Calendar configuration options

نام
ارتفاع

Height of the chart in pixels.

Type: number
Default: height of the containing element
عرض

Width of the chart in pixels.

Type: number
Default: width of the containing element

Candlestick chart configuration options

نام
رنگ پس‌زمینه

The background color for the main area of the chart. Can be either a simple HTML color string, for example: 'red' or '#00cc00' , or an object with the following properties.

Type: string or object
Default: 'white'
backgroundColor.fill

The chart fill color, as an HTML color string.

Type: string
Default: 'white'
chartArea

An object with members to configure the placement and size of the chart area (where the chart itself is drawn, excluding axis and legends). Two formats are supported: a number, or a number followed by %. A simple number is a value in pixels; a number followed by % is a percentage. Example: chartArea:{left:20,top:0,width:'50%',height:'75%'}

Type: object
Default: null
chartArea.backgroundColor
Chart area background color. When a string is used, it can be either a hex string (eg, '#fdc' ) or an English color name. When an object is used, the following properties can be provided:
  • stroke : The color, provided as a hex string or English color name.
  • strokeWidth : If provided, draws a border around the chart area of the given width (and with the color of stroke ).
Type: string or object
Default: 'white'
chartArea.height

Chart area height.

Type: number or string
Default: auto
chartArea.left

How far to draw the chart from the left border.

Type: number or string
Default: auto
chartArea.top

How far to draw the chart from the top border.

Type: number or string
Default: auto
chartArea.width

Chart area width.

Type: number or string
Default: auto
رنگ‌ها

The colors to use for the chart elements. An array of strings, where each element is an HTML color string, for example: colors:['red','#004411'] .

Type: Array of strings
Default: default colors
hAxis

An object with members to configure various horizontal axis elements. To specify properties of this object, you can use object literal notation, as shown here:

{
  title: 'Hello',
  titleTextStyle: {
    color: '#FF0000'
  }
}
    
Type: object
Default: null
hAxis.direction

The direction in which the values along the horizontal axis grow. Specify -1 to reverse the order of the values.

Type: 1 or -1
پیش‌فرض: 1
hAxis.gridlines

An object with properties to configure the gridlines on the horizontal axis. Note that horizontal axis gridlines are drawn vertically. To specify properties of this object, you can use object literal notation, as shown here:

{color: '#333', minSpacing: 20}

This option is only supported for a continuous axis.

Type: object
Default: null
hAxis.gridlines.color

The color of the horizontal gridlines inside the chart area. Specify a valid HTML color string.

Type: string
Default: '#CCC'
hAxis.gridlines.count

The approximate number of horizontal gridlines inside the chart area. If you specify a positive number for gridlines.count , it will be used to compute the minSpacing between gridlines. You can specify a value of 1 to only draw one gridline, or 0 to draw no gridlines. Specify -1 , which is the default, to automatically compute the number of gridlines based on other options.

Type: number
Default: -1
hAxis.logScale

hAxis property that makes the horizontal axis a logarithmic scale (requires all values to be positive). Set to true for yes.

This option is only supported for a continuous axis.

Type: boolean
پیش‌فرض: false
hAxis.maxValue

Moves the max value of the horizontal axis to the specified value; this will be rightward in most charts. Ignored if this is set to a value smaller than the maximum x-value of the data. hAxis.viewWindow.max overrides this property.

Type: number
Default: automatic
hAxis.minorGridlines

An object with members to configure the minor gridlines on the horizontal axis, similar to the hAxis.gridlines option.

This option is only supported for a continuous axis.

Type: object
Default: null
hAxis.minorGridlines.color

The color of the horizontal minor gridlines inside the chart area. Specify a valid HTML color string.

Type: string
Default: A blend of the gridline and background colors
hAxis.minorGridlines.count

The minorGridlines.count option is mostly deprecated, except for disabling minor gridlines by setting the count to 0. The number of minor gridlines now depends entirely on the interval between major gridlines (see hAxis.gridlines.interval ) and the minimum required space (see hAxis.minorGridlines.minSpacing ).

Type: number
پیش‌فرض: 1
hAxis.minValue

Moves the min value of the horizontal axis to the specified value; this will be leftward in most charts. Ignored if this is set to a value greater than the minimum x-value of the data. hAxis.viewWindow.min overrides this property.

Type: number
Default: automatic
hAxis.textPosition

Position of the horizontal axis text, relative to the chart area. Supported values: 'out' , 'in' , 'none' .

Type: string
Default: 'out'
hAxis.textStyle

An object that specifies the horizontal axis text style. The object has this format:

{ color: <string>,
  fontName: <string>,
  fontSize: <number>,
  bold: <boolean>,
  italic: <boolean> }
    

The color can be any HTML color string, for example: 'red' or '#00cc00' . Also see fontName and fontSize .

Type: object
Default: {color: 'black', fontName: <global-font-name>, fontSize: <global-font-size>}
hAxis.title

hAxis property that specifies the title of the horizontal axis.

Type: string
Default: null
hAxis.titleTextStyle

An object that specifies the horizontal axis title text style. The object has this format:

{ color: <string>,
  fontName: <string>,
  fontSize: <number>,
  bold: <boolean>,
  italic: <boolean> }
    

The color can be any HTML color string, for example: 'red' or '#00cc00' . Also see fontName and fontSize .

Type: object
Default: {color: 'black', fontName: <global-font-name>, fontSize: <global-font-size>}
hAxis.viewWindow

Specifies the cropping range of the horizontal axis.

Type: object
Default: null
hAxis.viewWindow.max

The maximum horizontal data value to render.

Ignored when hAxis.viewWindowMode is 'pretty' or 'maximized' .

Type: number
Default: auto
hAxis.viewWindow.min

The minimum horizontal data value to render.

Ignored when hAxis.viewWindowMode is 'pretty' or 'maximized' .

Type: number
Default: auto
ارتفاع

Height of the chart in pixels.

Type: number
Default: height of the containing element
افسانه

An object with members to configure various aspects of the legend. To specify properties of this object, you can use object literal notation, as shown here:

{position: 'top', textStyle: {color: 'blue', fontSize: 16}}
Type: object
Default: null
legend.position

Position of the legend. Can be one of the following:

  • 'bottom' - Below the chart.
  • 'left' - To the left of the chart, provided the left axis has no series associated with it. So if you want the legend on the left, use the option targetAxisIndex: 1 .
  • 'in' - Inside the chart, by the top left corner.
  • 'none' - No legend is displayed.
  • 'right' - To the right of the chart. Incompatible with the vAxes option.
  • 'top' - Above the chart.
Type: string
Default: 'right'
legendTextStyle

An object that specifies the legend text style. The object has this format:

{ color: <string>,
  fontName: <string>,
  fontSize: <number>,
  bold: <boolean>,
  italic: <boolean> }
    

The color can be any HTML color string, for example: 'red' or '#00cc00' . Also see fontName and fontSize .

Type: object
Default: {color: 'black', fontName: <global-font-name>, fontSize: <global-font-size>}
reverseCategories

If set to true , draws series from right to left. The default is to draw left to right.

This option is only supported for a discrete major axis.

Type: boolean
پیش‌فرض: false
سری

An array of objects, each describing the format of the corresponding series in the chart. To use default values for a series, specify an empty object {} . If a series or a value is not specified, the global value will be used. Each object supports the following properties:

  • color - The color to use for this series. Specify a valid HTML color string.
  • fallingColor.fill - Overrides the global candlestick.fallingColor.fill value for this series.
  • fallingColor.stroke - Overrides the global candlestick.fallingColor.stroke value for this series.
  • fallingColor.strokeWidth - Overrides the global candlestick.fallingColor.strokeWidth value for this series.
  • labelInLegend - The description of the series to appear in the chart legend.
  • risingColor.fill - Overrides the global candlestick.risingColor.fill value for this series.
  • risingColor.stroke - Overrides the global candlestick.risingColor.stroke value for this series.
  • risingColor.strokeWidth - Overrides the global candlestick.risingColor.strokeWidth value for this series.
  • targetAxisIndex - Which axis to assign this series to, where 0 is the default axis, and 1 is the opposite axis. Default value is 0 ; set to 1 to define a chart where different series are rendered against different axes. At least one series must be allocated to the default axis. You can define a different scale for different axes.
  • visibleInLegend - A boolean value, where true means that the series should have a legend entry, and false means that it should not. Default is true .

You can specify either an array of objects, each of which applies to the series in the order given, or you can specify an object where each child has a numeric key indicating which series it applies to. For example, the following two declarations are identical, and declare the first series as black and absent from the legend, and the fourth as red and absent from the legend:

series: [
  {color: 'black', visibleInLegend: false}, {}, {},
  {color: 'red', visibleInLegend: false}
]
series: {
  0:{color: 'black', visibleInLegend: false},
  3:{color: 'red', visibleInLegend: false}
}
Type: Array of objects, or object with nested objects
پیش‌فرض: {}
زیرنویس

Text to display below the chart title.

Type: string
Default: no title
subtitleTextStyle

An object that specifies the title text style.

The color can be any HTML color string, for example: 'red' or '#00cc00' . Also see fontName and fontSize .

Type: object
Default: {color: 'black', fontName: <global-font-name>, fontSize: <global-font-size>}
تم

A theme is a set of predefined option values that work together to achieve a specific chart behavior or visual effect. Currently only one theme is available:

  • 'maximized' - Maximizes the area of the chart, and draws the legend and all of the labels inside the chart area.
Type: string
Default: null
عنوان

Text to display above the chart.

Type: string
Default: no title
titleTextStyle

An object that specifies the title text style. The object has this format:

{ color: <string>,
  fontName: <string>,
  fontSize: <number>,
  bold: <boolean>,
  italic: <boolean> }
    

The color can be any HTML color string, for example: 'red' or '#00cc00' . Also see fontName and fontSize .

Type: object
Default: {color: 'black', fontName: <global-font-name>, fontSize: <global-font-size>}
useFirstColumnAsDomain

If set to true , the chart will treat the column as the domain.

Type: boolean
vAxes

Specifies properties for individual vertical axes, if the chart has multiple vertical axes. Each child object is a vAxis object, and can contain all the properties supported by vAxis . These property values override any global settings for the same property.

To specify a chart with multiple vertical axes, first define a new axis using series.targetAxisIndex , then configure the axis using vAxes . The following example assigns series 2 to the right axis and specifies a custom title and text style for it:

{
  series: {
    2: {
      targetAxisIndex:1
    }
  },
  vAxes: {
    1: {
      title:'Losses',
      textStyle: {color: 'red'}
    }
  }
}
    

This property can be either an object or an array: the object is a collection of objects, each with a numeric label that specifies the axis that it defines--this is the format shown above; the array is an array of objects, one per axis. For example, the following array-style notation is identical to the vAxis object shown above:

vAxes: [
  {}, // Nothing specified for axis 0
  {
    title:'Losses',
    textStyle: {color: 'red'} // Axis 1
  }
]
    
Type: Array of object, or object with child objects
Default: null
vAxis

An object with members to configure various vertical axis elements. To specify properties of this object, you can use object literal notation, as shown here:

{title: 'Hello', titleTextStyle: {color: '#FF0000'}}
Type: object
Default: null
vAxis.direction

The direction in which the values along the vertical axis grow. By default, low values are on the bottom of the chart. Specify -1 to reverse the order of the values.

Type: 1 or -1
پیش‌فرض: 1
vAxis.gridlines

An object with members to configure the gridlines on the vertical axis. Note that vertical axis gridlines are drawn horizontally. To specify properties of this object, you can use object literal notation, as shown here:

{color: '#333', minSpacing: 20}

This option is only supported for a continuous axis.

Type: object
Default: null
vAxis.gridlines.color

The color of the vertical gridlines inside the chart area. Specify a valid HTML color string.

Type: string
Default: '#CCC'
vAxis.gridlines.count

The approximate number of horizontal gridlines inside the chart area. If you specify a positive number for gridlines.count , it will be used to compute the minSpacing between gridlines. You can specify a value of 1 to only draw one gridline, or 0 to draw no gridlines. Specify -1 , which is the default, to automatically compute the number of gridlines based on other options.

Type: number
Default: -1
vAxis.logScale

If true , makes the vertical axis a logarithmic scale. Note: All values must be positive.

Type: boolean
پیش‌فرض: false
vAxis.maxValue

Moves the max value of the vertical axis to the specified value; this will be upward in most charts. Ignored if this is set to a value smaller than the maximum y-value of the data. vAxis.viewWindow.max overrides this property.

Type: number
Default: automatic
vAxis.minorGridlines

An object with members to configure the minor gridlines on the vertical axis, similar to the vAxis.gridlines option.

Type: object
Default: null
vAxis.minorGridlines.color

The color of the vertical minor gridlines inside the chart area. Specify a valid HTML color string.

Type: string
Default: A blend of the gridline and background colors
vAxis.minorGridlines.count

The minorGridlines.count option is mostly deprecated, except for disabling minor gridlines by setting the count to 0 . The number of minor gridlines depends on the interval between major gridlines and the minimum required space.

Type: number
پیش‌فرض: 1
vAxis.minValue

Moves the min value of the vertical axis to the specified value; this will be downward in most charts. Ignored if this is set to a value greater than the minimum y-value of the data. vAxis.viewWindow.min overrides this property.

Type: number
Default: null
vAxis.textPosition

Position of the vertical axis text, relative to the chart area. Supported values: 'out' , 'in' , 'none' .

Type: string
Default: 'out'
vAxis.textStyle

An object that specifies the vertical axis text style. The object has this format:

{ color: <string>,
  fontName: <string>,
  fontSize: <number>,
  bold: <boolean>,
  italic: <boolean> }
    

The color can be any HTML color string, for example: 'red' or '#00cc00' . Also see fontName and fontSize .

Type: object
Default: {color: 'black', fontName: <global-font-name>, fontSize: <global-font-size>}
vAxis.title

Specifies a title for the vertical axis.

Type: string
Default: no title
vAxis.titleTextStyle

An object that specifies the vertical axis title text style. The object has this format:

{ color: <string>,
  fontName: <string>,
  fontSize: <number>,
  bold: <boolean>,
  italic: <boolean> }
  

The color can be any HTML color string, for example: 'red' or '#00cc00' . Also see fontName and fontSize .

Type: object
Default: {color: 'black', fontName: <global-font-name>, fontSize: <global-font-size>}
vAxis.viewWindow

Specifies the cropping range of the vertical axis.

Type: object
Default: null
vAxis.viewWindow.max

The maximum vertical data value to render.

Ignored when vAxis.viewWindowMode is 'pretty' or 'maximized'.

Type: number
Default: auto
vAxis.viewWindow.min

The minimum vertical data value to render.

Ignored when vAxis.viewWindowMode is 'pretty' or 'maximized'.

Type: number
Default: auto

Column chart configuration options

نام
رنگ پس‌زمینه

The background color for the main area of the chart. Can be either a simple HTML color string, for example: 'red' or '#00cc00' , or an object with the following properties.

Type: string or object
Default: 'white'
backgroundColor.fill

The chart fill color, as an HTML color string.

Type: string
Default: 'white'
chartArea

An object with members to configure the placement and size of the chart area (where the chart itself is drawn, excluding axis and legends). Two formats are supported: a number, or a number followed by %. A simple number is a value in pixels; a number followed by % is a percentage. Example: chartArea:{left:20,top:0,width:'50%',height:'75%'}

Type: object
Default: null
chartArea.backgroundColor
Chart area background color. When a string is used, it can be either a hex string (eg, '#fdc' ) or an English color name. When an object is used, the following properties can be provided:
  • stroke : The color, provided as a hex string or English color name.
  • strokeWidth : If provided, draws a border around the chart area of the given width (and with the color of stroke ).
Type: string or object
Default: 'white'
chartArea.height

Chart area height.

Type: number or string
Default: auto
chartArea.left

How far to draw the chart from the left border.

Type: number or string
Default: auto
chartArea.top

How far to draw the chart from the top border.

Type: number or string
Default: auto
chartArea.width

Chart area width.

Type: number or string
Default: auto
رنگ‌ها

The colors to use for the chart elements. An array of strings, where each element is an HTML color string, for example: colors:['red','#004411'] .

Type: Array of strings
Default: default colors
hAxis

An object with members to configure various horizontal axis elements. To specify properties of this object, you can use object literal notation, as shown here:

{
  title: 'Hello',
  titleTextStyle: {
    color: '#FF0000'
  }
}
    
Type: object
Default: null
hAxis.direction

The direction in which the values along the horizontal axis grow. Specify -1 to reverse the order of the values.

Type: 1 or -1
پیش‌فرض: 1
hAxis.gridlines

An object with properties to configure the gridlines on the horizontal axis. Note that horizontal axis gridlines are drawn vertically. To specify properties of this object, you can use object literal notation, as shown here:

{color: '#333', minSpacing: 20}

This option is only supported for a continuous axis.

Type: object
Default: null
hAxis.gridlines.color

The color of the horizontal gridlines inside the chart area. Specify a valid HTML color string.

Type: string
Default: '#CCC'
hAxis.gridlines.count

The approximate number of horizontal gridlines inside the chart area. If you specify a positive number for gridlines.count , it will be used to compute the minSpacing between gridlines. You can specify a value of 1 to only draw one gridline, or 0 to draw no gridlines. Specify -1 , which is the default, to automatically compute the number of gridlines based on other options.

Type: number
Default: -1
hAxis.logScale

hAxis property that makes the horizontal axis a logarithmic scale (requires all values to be positive). Set to true for yes.

This option is only supported for a continuous axis.

Type: boolean
پیش‌فرض: false
hAxis.maxValue

Moves the max value of the horizontal axis to the specified value; this will be rightward in most charts. Ignored if this is set to a value smaller than the maximum x-value of the data. hAxis.viewWindow.max overrides this property.

Type: number
Default: automatic
hAxis.minorGridlines

An object with members to configure the minor gridlines on the horizontal axis, similar to the hAxis.gridlines option.

This option is only supported for a continuous axis.

Type: object
Default: null
hAxis.minorGridlines.color

The color of the horizontal minor gridlines inside the chart area. Specify a valid HTML color string.

Type: string
Default: A blend of the gridline and background colors
hAxis.minorGridlines.count

The minorGridlines.count option is mostly deprecated, except for disabling minor gridlines by setting the count to 0. The number of minor gridlines now depends entirely on the interval between major gridlines (see hAxis.gridlines.interval ) and the minimum required space (see hAxis.minorGridlines.minSpacing ).

Type: number
پیش‌فرض: 1
hAxis.minValue

Moves the min value of the horizontal axis to the specified value; this will be leftward in most charts. Ignored if this is set to a value greater than the minimum x-value of the data. hAxis.viewWindow.min overrides this property.

Type: number
Default: automatic
hAxis.textPosition

Position of the horizontal axis text, relative to the chart area. Supported values: 'out' , 'in' , 'none' .

Type: string
Default: 'out'
hAxis.textStyle

An object that specifies the horizontal axis text style. The object has this format:

{ color: <string>,
  fontName: <string>,
  fontSize: <number>,
  bold: <boolean>,
  italic: <boolean> }
    

The color can be any HTML color string, for example: 'red' or '#00cc00' . Also see fontName and fontSize .

Type: object
Default: {color: 'black', fontName: <global-font-name>, fontSize: <global-font-size>}
hAxis.title

hAxis property that specifies the title of the horizontal axis.

Type: string
Default: null
hAxis.titleTextStyle

An object that specifies the horizontal axis title text style. The object has this format:

{ color: <string>,
  fontName: <string>,
  fontSize: <number>,
  bold: <boolean>,
  italic: <boolean> }
    

The color can be any HTML color string, for example: 'red' or '#00cc00' . Also see fontName and fontSize .

Type: object
Default: {color: 'black', fontName: <global-font-name>, fontSize: <global-font-size>}
hAxis.viewWindow

Specifies the cropping range of the horizontal axis.

Type: object
Default: null
hAxis.viewWindow.max

The maximum horizontal data value to render.

Ignored when hAxis.viewWindowMode is 'pretty' or 'maximized' .

Type: number
Default: auto
hAxis.viewWindow.min

The minimum horizontal data value to render.

Ignored when hAxis.viewWindowMode is 'pretty' or 'maximized' .

Type: number
Default: auto
ارتفاع

Height of the chart in pixels.

Type: number
Default: height of the containing element
isStacked

If set to true , stacks the elements for all series at each domain value. Note: In Column , Area , and SteppedArea charts, Google Charts reverses the order of legend items to better correspond with the stacking of the series elements (Eg series 0 will be the bottom-most legend item). This does not apply to Bar Charts.

The isStacked option also supports 100% stacking, where the stacks of elements at each domain value are rescaled to add up to 100%.

The options for isStacked are:

  • false — elements will not stack. This is the default option.
  • true — stacks elements for all series at each domain value.
  • 'percent' — stacks elements for all series at each domain value and rescales them such that they add up to 100%, with each element's value calculated as a percentage of 100%.
  • 'relative' — stacks elements for all series at each domain value and rescales them such that they add up to 1, with each element's value calculated as a fraction of 1.
  • 'absolute' — functions the same as isStacked: true .

For 100% stacking, the calculated value for each element will appear in the tooltip after its actual value.

The target axis will default to tick values based on the relative 0-1 scale as fractions of 1 for 'relative' , and 0-100% for 'percent' ( Note: when using the 'percent' option, the axis/tick values are displayed as percentages, however the actual values are the relative 0-1 scale values. This is because the percentage axis ticks are the result of applying a format of "#.##%" to the relative 0-1 scale values. When using isStacked: 'percent' , be sure to specify any ticks/gridlines using the relative 0-1 scale values). You can customize the gridlines/tick values and formatting using the appropriate hAxis/vAxis options.

100% stacking only supports data values of type number , and must have a baseline of zero.

Type: boolean / string
پیش‌فرض: false
افسانه

An object with members to configure various aspects of the legend. To specify properties of this object, you can use object literal notation, as shown here:

{position: 'top', textStyle: {color: 'blue', fontSize: 16}}
Type: object
Default: null
legend.position

Position of the legend. Can be one of the following:

  • 'bottom' - Below the chart.
  • 'left' - To the left of the chart, provided the left axis has no series associated with it. So if you want the legend on the left, use the option targetAxisIndex: 1 .
  • 'in' - Inside the chart, by the top left corner.
  • 'none' - No legend is displayed.
  • 'right' - To the right of the chart. Incompatible with the vAxes option.
  • 'top' - Above the chart.
Type: string
Default: 'right'
legendTextStyle

An object that specifies the legend text style. The object has this format:

{ color: <string>,
  fontName: <string>,
  fontSize: <number>,
  bold: <boolean>,
  italic: <boolean> }
    

The color can be any HTML color string, for example: 'red' or '#00cc00' . Also see fontName and fontSize .

Type: object
Default: {color: 'black', fontName: <global-font-name>, fontSize: <global-font-size>}
reverseCategories

If set to true , draws series from right to left. The default is to draw left to right.

This option is only supported for a discrete major axis.

Type: boolean
پیش‌فرض: false
سری

An array of objects, each describing the format of the corresponding series in the chart. To use default values for a series, specify an empty object {} . If a series or a value is not specified, the global value will be used. Each object supports the following properties:

  • annotations - An object to be applied to annotations for this series. This can be used to control, for instance, the textStyle for the series:

    series: {
      0: {
        annotations: {
          textStyle: {fontSize: 12, color: 'red' }
        }
      }
    }
              

    See the various annotations options for a more complete list of what can be customized.

  • color - The color to use for this series. Specify a valid HTML color string.
  • labelInLegend - The description of the series to appear in the chart legend.
  • targetAxisIndex - Which axis to assign this series to, where 0 is the default axis, and 1 is the opposite axis. Default value is 0 ; set to 1 to define a chart where different series are rendered against different axes. At least one series must be allocated to the default axis. You can define a different scale for different axes.

You can specify either an array of objects, each of which applies to the series in the order given, or you can specify an object where each child has a numeric key indicating which series it applies to. For example, the following two declarations are identical, and declare the first series as black and absent from the legend, and the fourth as red and absent from the legend:

series: [
  {color: 'black', visibleInLegend: false}, {}, {},
  {color: 'red', visibleInLegend: false}
]
series: {
  0:{color: 'black', visibleInLegend: false},
  3:{color: 'red', visibleInLegend: false}
}
    
Type: Array of objects, or object with nested objects
پیش‌فرض: {}
زیرنویس

Text to display below the chart title.

Type: string
Default: no title
subtitleTextStyle

An object that specifies the title text style.

The color can be any HTML color string, for example: 'red' or '#00cc00' . Also see fontName and fontSize .

Type: object
Default: {color: 'black', fontName: <global-font-name>, fontSize: <global-font-size>}
تم

A theme is a set of predefined option values that work together to achieve a specific chart behavior or visual effect. Currently only one theme is available:

  • 'maximized' - Maximizes the area of the chart, and draws the legend and all of the labels inside the chart area.
Type: string
Default: null
عنوان

Text to display above the chart.

Type: string
Default: no title
titleTextStyle

An object that specifies the title text style. The object has this format:

{ color: <string>,
  fontName: <string>,
  fontSize: <number>,
  bold: <boolean>,
  italic: <boolean> }
    

The color can be any HTML color string, for example: 'red' or '#00cc00' . Also see fontName and fontSize .

Type: object
Default: {color: 'black', fontName: <global-font-name>, fontSize: <global-font-size>}
خطوط روند

Displays trendlines on the charts that support them. By default, linear trendlines are used, but this can be customized with the trendlines. n .type option.

Trendlines are specified on a per-series basis, so most of the time your options will look like this:

var options = {
  trendlines: {
    0: {
      type: 'linear',
      color: 'green',
      lineWidth: 3,
      opacity: 0.3,
      visibleInLegend: true
    }
  }
}
    
Type: object
Default: null
trendlines.n.color

The color of the trendline , expressed as either an English color name or a hex string.

Type: string
Default: default series color
trendlines.n.degree

For trendlines of type: 'polynomial' , the degree of the polynomial ( 2 for quadratic, 3 for cubic, and so on).

Type: number
Default: 3
trendlines.n.labelInLegend

If set, the trendline will appear in the legend as this string.

Type: string
Default: null
trendlines.n.lineWidth

The line width of the trendline , in pixels.

Type: number
پیش‌فرض: 2
trendlines.n.type

Whether the trendlines is 'linear' (the default), 'exponential' , or 'polynomial' .

Type: string
Default: linear
trendlines.n.visibleInLegend

Whether the trendline equation appears in the legend. It will appear in the trendline tooltip.

Type: boolean
پیش‌فرض: false
useFirstColumnAsDomain

If set to true , the chart will treat the column as the domain.

Type: boolean
vAxes

Specifies properties for individual vertical axes, if the chart has multiple vertical axes. Each child object is a vAxis object, and can contain all the properties supported by vAxis . These property values override any global settings for the same property.

To specify a chart with multiple vertical axes, first define a new axis using series.targetAxisIndex , then configure the axis using vAxes . The following example assigns series 2 to the right axis and specifies a custom title and text style for it:

{
  series: {
    2: {
      targetAxisIndex:1
    }
  },
  vAxes: {
    1: {
      title:'Losses',
      textStyle: {color: 'red'}
    }
  }
}
    

This property can be either an object or an array: the object is a collection of objects, each with a numeric label that specifies the axis that it defines--this is the format shown above; the array is an array of objects, one per axis. For example, the following array-style notation is identical to the vAxis object shown above:

vAxes: [
  {}, // Nothing specified for axis 0
  {
    title:'Losses',
    textStyle: {color: 'red'} // Axis 1
  }
]
    
Type: Array of object, or object with child objects
Default: null
vAxis

An object with members to configure various vertical axis elements. To specify properties of this object, you can use object literal notation, as shown here:

{title: 'Hello', titleTextStyle: {color: '#FF0000'}}
Type: object
Default: null
vAxis.direction

The direction in which the values along the vertical axis grow. By default, low values are on the bottom of the chart. Specify -1 to reverse the order of the values.

Type: 1 or -1
پیش‌فرض: 1
vAxis.gridlines

An object with members to configure the gridlines on the vertical axis. Note that vertical axis gridlines are drawn horizontally. To specify properties of this object, you can use object literal notation, as shown here:

{color: '#333', minSpacing: 20}

This option is only supported for a continuous axis.

Type: object
Default: null
vAxis.gridlines.color

The color of the vertical gridlines inside the chart area. Specify a valid HTML color string.

Type: string
Default: '#CCC'
vAxis.gridlines.count

The approximate number of horizontal gridlines inside the chart area. If you specify a positive number for gridlines.count , it will be used to compute the minSpacing between gridlines. You can specify a value of 1 to only draw one gridline, or 0 to draw no gridlines. Specify -1 , which is the default, to automatically compute the number of gridlines based on other options.

Type: number
Default: -1
vAxis.logScale

If true , makes the vertical axis a logarithmic scale. Note: All values must be positive.

Type: boolean
پیش‌فرض: false
vAxis.maxValue

Moves the max value of the vertical axis to the specified value; this will be upward in most charts. Ignored if this is set to a value smaller than the maximum y-value of the data. vAxis.viewWindow.max overrides this property.

Type: number
Default: automatic
vAxis.minorGridlines

An object with members to configure the minor gridlines on the vertical axis, similar to the vAxis.gridlines option.

Type: object
Default: null
vAxis.minorGridlines.color

The color of the vertical minor gridlines inside the chart area. Specify a valid HTML color string.

Type: string
Default: A blend of the gridline and background colors
vAxis.minorGridlines.count

The minorGridlines.count option is mostly deprecated, except for disabling minor gridlines by setting the count to 0 . The number of minor gridlines depends on the interval between major gridlines and the minimum required space.

Type: number
پیش‌فرض: 1
vAxis.minValue

Moves the min value of the vertical axis to the specified value; this will be downward in most charts. Ignored if this is set to a value greater than the minimum y-value of the data. vAxis.viewWindow.min overrides this property.

Type: number
Default: null
vAxis.textPosition

Position of the vertical axis text, relative to the chart area. Supported values: 'out' , 'in' , 'none' .

Type: string
Default: 'out'
vAxis.textStyle

An object that specifies the vertical axis text style. The object has this format:

{ color: <string>,
  fontName: <string>,
  fontSize: <number>,
  bold: <boolean>,
  italic: <boolean> }
    

The color can be any HTML color string, for example: 'red' or '#00cc00' . Also see fontName and fontSize .

Type: object
Default: {color: 'black', fontName: <global-font-name>, fontSize: <global-font-size>}
vAxis.title

Specifies a title for the vertical axis.

Type: string
Default: no title
vAxis.titleTextStyle

An object that specifies the vertical axis title text style. The object has this format:

{ color: <string>,
  fontName: <string>,
  fontSize: <number>,
  bold: <boolean>,
  italic: <boolean> }
  

The color can be any HTML color string, for example: 'red' or '#00cc00' . Also see fontName and fontSize .

Type: object
Default: {color: 'black', fontName: <global-font-name>, fontSize: <global-font-size>}
vAxis.viewWindow

Specifies the cropping range of the vertical axis.

Type: object
Default: null
vAxis.viewWindow.max

The maximum vertical data value to render.

Ignored when vAxis.viewWindowMode is 'pretty' or 'maximized'.

Type: number
Default: auto
vAxis.viewWindow.min

The minimum vertical data value to render.

Ignored when vAxis.viewWindowMode is 'pretty' or 'maximized'.

Type: number
Default: auto

Combo chart configuration options

نام
areaOpacity

The default opacity of the colored area under an area chart series, where 0.0 is fully transparent and 1.0 is fully opaque. To specify opacity for an individual series, set the areaOpacity value in the series property.

Type: number , 0.0- 1.0
Default: 0.3
رنگ پس‌زمینه

The background color for the main area of the chart. Can be either a simple HTML color string, for example: 'red' or '#00cc00' , or an object with the following properties.

Type: string or object
Default: 'white'
backgroundColor.fill

The chart fill color, as an HTML color string.

Type: string
Default: 'white'
chartArea

An object with members to configure the placement and size of the chart area (where the chart itself is drawn, excluding axis and legends). Two formats are supported: a number, or a number followed by %. A simple number is a value in pixels; a number followed by % is a percentage. Example: chartArea:{left:20,top:0,width:'50%',height:'75%'}

Type: object
Default: null
chartArea.backgroundColor
Chart area background color. When a string is used, it can be either a hex string (eg, '#fdc' ) or an English color name. When an object is used, the following properties can be provided:
  • stroke : The color, provided as a hex string or English color name.
  • strokeWidth : If provided, draws a border around the chart area of the given width (and with the color of stroke ).
Type: string or object
Default: 'white'
chartArea.height

Chart area height.

Type: number or string
Default: auto
chartArea.left

How far to draw the chart from the left border.

Type: number or string
Default: auto
chartArea.top

How far to draw the chart from the top border.

Type: number or string
Default: auto
chartArea.width

Chart area width.

Type: number or string
Default: auto
رنگ‌ها

The colors to use for the chart elements. An array of strings, where each element is an HTML color string, for example: colors:['red','#004411'] .

Type: Array of strings
Default: default colors
curveType

Controls the curve of the lines when the line width is not zero. Can be one of the following:

  • 'none' - Straight lines without curve.
  • 'function' - The angles of the line will be smoothed.
Type: string
Default: 'none'
hAxis

An object with members to configure various horizontal axis elements. To specify properties of this object, you can use object literal notation, as shown here:

{
  title: 'Hello',
  titleTextStyle: {
    color: '#FF0000'
  }
}
    
Type: object
Default: null
hAxis.direction

The direction in which the values along the horizontal axis grow. Specify -1 to reverse the order of the values.

Type: 1 or -1
پیش‌فرض: 1
hAxis.gridlines

An object with properties to configure the gridlines on the horizontal axis. Note that horizontal axis gridlines are drawn vertically. To specify properties of this object, you can use object literal notation, as shown here:

{color: '#333', minSpacing: 20}

This option is only supported for a continuous axis.

Type: object
Default: null
hAxis.gridlines.color

The color of the horizontal gridlines inside the chart area. Specify a valid HTML color string.

Type: string
Default: '#CCC'
hAxis.gridlines.count

The approximate number of horizontal gridlines inside the chart area. If you specify a positive number for gridlines.count , it will be used to compute the minSpacing between gridlines. You can specify a value of 1 to only draw one gridline, or 0 to draw no gridlines. Specify -1 , which is the default, to automatically compute the number of gridlines based on other options.

Type: number
Default: -1
hAxis.logScale

hAxis property that makes the horizontal axis a logarithmic scale (requires all values to be positive). Set to true for yes.

This option is only supported for a continuous axis.

Type: boolean
پیش‌فرض: false
hAxis.maxValue

Moves the max value of the horizontal axis to the specified value; this will be rightward in most charts. Ignored if this is set to a value smaller than the maximum x-value of the data. hAxis.viewWindow.max overrides this property.

Type: number
Default: automatic
hAxis.minorGridlines

An object with members to configure the minor gridlines on the horizontal axis, similar to the hAxis.gridlines option.

This option is only supported for a continuous axis.

Type: object
Default: null
hAxis.minorGridlines.color

The color of the horizontal minor gridlines inside the chart area. Specify a valid HTML color string.

Type: string
Default: A blend of the gridline and background colors
hAxis.minorGridlines.count

The minorGridlines.count option is mostly deprecated, except for disabling minor gridlines by setting the count to 0. The number of minor gridlines now depends entirely on the interval between major gridlines (see hAxis.gridlines.interval ) and the minimum required space (see hAxis.minorGridlines.minSpacing ).

Type: number
پیش‌فرض: 1
hAxis.minValue

Moves the min value of the horizontal axis to the specified value; this will be leftward in most charts. Ignored if this is set to a value greater than the minimum x-value of the data. hAxis.viewWindow.min overrides this property.

Type: number
Default: automatic
hAxis.textPosition

Position of the horizontal axis text, relative to the chart area. Supported values: 'out' , 'in' , 'none' .

Type: string
Default: 'out'
hAxis.textStyle

An object that specifies the horizontal axis text style. The object has this format:

{ color: <string>,
  fontName: <string>,
  fontSize: <number>,
  bold: <boolean>,
  italic: <boolean> }
    

The color can be any HTML color string, for example: 'red' or '#00cc00' . Also see fontName and fontSize .

Type: object
Default: {color: 'black', fontName: <global-font-name>, fontSize: <global-font-size>}
hAxis.title

hAxis property that specifies the title of the horizontal axis.

Type: string
Default: null
hAxis.titleTextStyle

An object that specifies the horizontal axis title text style. The object has this format:

{ color: <string>,
  fontName: <string>,
  fontSize: <number>,
  bold: <boolean>,
  italic: <boolean> }
    

The color can be any HTML color string, for example: 'red' or '#00cc00' . Also see fontName and fontSize .

Type: object
Default: {color: 'black', fontName: <global-font-name>, fontSize: <global-font-size>}
hAxis.viewWindow

Specifies the cropping range of the horizontal axis.

Type: object
Default: null
hAxis.viewWindow.max

The maximum horizontal data value to render.

Ignored when hAxis.viewWindowMode is 'pretty' or 'maximized' .

Type: number
Default: auto
hAxis.viewWindow.min

The minimum horizontal data value to render.

Ignored when hAxis.viewWindowMode is 'pretty' or 'maximized' .

Type: number
Default: auto
ارتفاع

Height of the chart in pixels.

Type: number
Default: height of the containing element
interpolateNulls

Whether to guess the value of missing points. If true , it will guess the value of any missing data based on neighboring points. If false , it will leave a break in the line at the unknown point.

This is not supported by Area charts with the isStacked: true/'percent'/'relative'/'absolute' option.

Type: boolean
پیش‌فرض: false
isStacked

If set to true , stacks the elements for all series at each domain value. Note: In Column , Area , and SteppedArea charts, Google Charts reverses the order of legend items to better correspond with the stacking of the series elements (Eg series 0 will be the bottom-most legend item). This does not apply to Bar Charts.

The isStacked option also supports 100% stacking, where the stacks of elements at each domain value are rescaled to add up to 100%.

The options for isStacked are:

  • false — elements will not stack. This is the default option.
  • true — stacks elements for all series at each domain value.
  • 'percent' — stacks elements for all series at each domain value and rescales them such that they add up to 100%, with each element's value calculated as a percentage of 100%.
  • 'relative' — stacks elements for all series at each domain value and rescales them such that they add up to 1, with each element's value calculated as a fraction of 1.
  • 'absolute' — functions the same as isStacked: true .

For 100% stacking, the calculated value for each element will appear in the tooltip after its actual value.

The target axis will default to tick values based on the relative 0-1 scale as fractions of 1 for 'relative' , and 0-100% for 'percent' ( Note: when using the 'percent' option, the axis/tick values are displayed as percentages, however the actual values are the relative 0-1 scale values. This is because the percentage axis ticks are the result of applying a format of "#.##%" to the relative 0-1 scale values. When using isStacked: 'percent' , be sure to specify any ticks/gridlines using the relative 0-1 scale values). You can customize the gridlines/tick values and formatting using the appropriate hAxis/vAxis options.

100% stacking only supports data values of type number , and must have a baseline of zero.

Type: boolean / string
پیش‌فرض: false
افسانه

An object with members to configure various aspects of the legend. To specify properties of this object, you can use object literal notation, as shown here:

{position: 'top', textStyle: {color: 'blue', fontSize: 16}}
Type: object
Default: null
legend.position

Position of the legend. Can be one of the following:

  • 'bottom' - Below the chart.
  • 'left' - To the left of the chart, provided the left axis has no series associated with it. So if you want the legend on the left, use the option targetAxisIndex: 1 .
  • 'in' - Inside the chart, by the top left corner.
  • 'none' - No legend is displayed.
  • 'right' - To the right of the chart. Incompatible with the vAxes option.
  • 'top' - Above the chart.
Type: string
Default: 'right'
legendTextStyle

An object that specifies the legend text style. The object has this format:

{ color: <string>,
  fontName: <string>,
  fontSize: <number>,
  bold: <boolean>,
  italic: <boolean> }
    

The color can be any HTML color string, for example: 'red' or '#00cc00' . Also see fontName and fontSize .

Type: object
Default: {color: 'black', fontName: <global-font-name>, fontSize: <global-font-size>}
lineWidth

Data line width in pixels. Use zero to hide all lines and show only the points. You can override values for individual series using the series property.

Type: number
پیش‌فرض: 2
pointShape

The shape of individual data elements: 'circle' , 'triangle' , 'square' , 'diamond' , 'star' or 'polygon' . See the points documentation for examples.

Type: string
Default: 'circle'
pointSize

Diameter of displayed points in pixels. Use zero to hide all points. You can override values for individual series using the series property. If you're using a trendline , the pointSize option will affect the width of the trendline unless you override it with the trendlines.n.pointsize option.

Type: number
Default: 0
reverseCategories

If set to true , draws series from right to left. The default is to draw left to right.

This option is only supported for a discrete major axis.

Type: boolean
پیش‌فرض: false
سری

An array of objects, each describing the format of the corresponding series in the chart. To use default values for a series, specify an empty object {} . If a series or a value is not specified, the global value will be used. Each object supports the following properties:

  • annotations - An object to be applied to annotations for this series. This can be used to control, for instance, the textStyle for the series:

    series: {
      0: {
        annotations: {
          textStyle: {fontSize: 12, color: 'red' }
        }
      }
    }
              

    See the various annotations options for a more complete list of what can be customized.

  • areaOpacity - Overrides the global areaOpacity for this series..
  • color - The color to use for this series. Specify a valid HTML color string.
  • curveType - Overrides the global curveType value for this series.
  • fallingColor.fill - Overrides the global candlestick.fallingColor.fill value for this series.
  • fallingColor.stroke - Overrides the global candlestick.fallingColor.stroke value for this series.
  • fallingColor.strokeWidth - Overrides the global candlestick.fallingColor.strokeWidth value for this series.
  • labelInLegend - The description of the series to appear in the chart legend.
  • lineDashStyle - Overrides the global lineDashStyle value for this series.
  • lineWidth - Overrides the global lineWidth value for this series.
  • pointShape - Overrides the global pointShape value for this series.
  • pointSize - Overrides the global pointSize value for this series.
  • pointsVisible - Overrides the global pointsVisible value for this series.
  • risingColor.fill - Overrides the global candlestick.risingColor.fill value for this series.
  • risingColor.stroke - Overrides the global candlestick.risingColor.stroke value for this series.
  • risingColor.strokeWidth - Overrides the global candlestick.risingColor.strokeWidth value for this series.
  • targetAxisIndex - Which axis to assign this series to, where 0 is the default axis, and 1 is the opposite axis. Default value is 0 ; set to 1 to define a chart where different series are rendered against different axes. At least one series must be allocated to the default axis. You can define a different scale for different axes.
  • type - The type of marker for this series. Valid values are 'line', 'area', 'bars', and 'steppedArea'. Note that bars are actually vertical bars (columns). The default value is specified by the chart's seriesType option.
  • visibleInLegend - A boolean value, where true means that the series should have a legend entry, and false means that it should not. Default is true .

You can specify either an array of objects, each of which applies to the series in the order given, or you can specify an object where each child has a numeric key indicating which series it applies to. For example, the following two declarations are identical, and declare the first series as black and absent from the legend, and the fourth as red and absent from the legend:

series: [
  {color: 'black', visibleInLegend: false}, {}, {},
  {color: 'red', visibleInLegend: false}
]
series: {
  0:{color: 'black', visibleInLegend: false},
  3:{color: 'red', visibleInLegend: false}
}
    
Type: Array of objects, or object with nested objects
پیش‌فرض: {}
زیرنویس

Text to display below the chart title.

Type: string
Default: no title
subtitleTextStyle

An object that specifies the title text style.

The color can be any HTML color string, for example: 'red' or '#00cc00' . Also see fontName and fontSize .

Type: object
Default: {color: 'black', fontName: <global-font-name>, fontSize: <global-font-size>}
تم

A theme is a set of predefined option values that work together to achieve a specific chart behavior or visual effect. Currently only one theme is available:

  • 'maximized' - Maximizes the area of the chart, and draws the legend and all of the labels inside the chart area.
Type: string
Default: null
عنوان

Text to display above the chart.

Type: string
Default: no title
titleTextStyle

An object that specifies the title text style. The object has this format:

{ color: <string>,
  fontName: <string>,
  fontSize: <number>,
  bold: <boolean>,
  italic: <boolean> }
    

The color can be any HTML color string, for example: 'red' or '#00cc00' . Also see fontName and fontSize .

Type: object
Default: {color: 'black', fontName: <global-font-name>, fontSize: <global-font-size>}
useFirstColumnAsDomain

If set to true , the chart will treat the column as the domain.

Type: boolean
vAxes

Specifies properties for individual vertical axes, if the chart has multiple vertical axes. Each child object is a vAxis object, and can contain all the properties supported by vAxis . These property values override any global settings for the same property.

To specify a chart with multiple vertical axes, first define a new axis using series.targetAxisIndex , then configure the axis using vAxes . The following example assigns series 2 to the right axis and specifies a custom title and text style for it:

{
  series: {
    2: {
      targetAxisIndex:1
    }
  },
  vAxes: {
    1: {
      title:'Losses',
      textStyle: {color: 'red'}
    }
  }
}
    

This property can be either an object or an array: the object is a collection of objects, each with a numeric label that specifies the axis that it defines--this is the format shown above; the array is an array of objects, one per axis. For example, the following array-style notation is identical to the vAxis object shown above:

vAxes: [
  {}, // Nothing specified for axis 0
  {
    title:'Losses',
    textStyle: {color: 'red'} // Axis 1
  }
]
    
Type: Array of object, or object with child objects
Default: null
vAxis

An object with members to configure various vertical axis elements. To specify properties of this object, you can use object literal notation, as shown here:

{title: 'Hello', titleTextStyle: {color: '#FF0000'}}
Type: object
Default: null
vAxis.direction

The direction in which the values along the vertical axis grow. By default, low values are on the bottom of the chart. Specify -1 to reverse the order of the values.

Type: 1 or -1
پیش‌فرض: 1
vAxis.gridlines

An object with members to configure the gridlines on the vertical axis. Note that vertical axis gridlines are drawn horizontally. To specify properties of this object, you can use object literal notation, as shown here:

{color: '#333', minSpacing: 20}

This option is only supported for a continuous axis.

Type: object
Default: null
vAxis.gridlines.color

The color of the vertical gridlines inside the chart area. Specify a valid HTML color string.

Type: string
Default: '#CCC'
vAxis.gridlines.count

The approximate number of horizontal gridlines inside the chart area. If you specify a positive number for gridlines.count , it will be used to compute the minSpacing between gridlines. You can specify a value of 1 to only draw one gridline, or 0 to draw no gridlines. Specify -1 , which is the default, to automatically compute the number of gridlines based on other options.

Type: number
Default: -1
vAxis.logScale

If true , makes the vertical axis a logarithmic scale. Note: All values must be positive.

Type: boolean
پیش‌فرض: false
vAxis.maxValue

Moves the max value of the vertical axis to the specified value; this will be upward in most charts. Ignored if this is set to a value smaller than the maximum y-value of the data. vAxis.viewWindow.max overrides this property.

Type: number
Default: automatic
vAxis.minorGridlines

An object with members to configure the minor gridlines on the vertical axis, similar to the vAxis.gridlines option.

Type: object
Default: null
vAxis.minorGridlines.color

The color of the vertical minor gridlines inside the chart area. Specify a valid HTML color string.

Type: string
Default: A blend of the gridline and background colors
vAxis.minorGridlines.count

The minorGridlines.count option is mostly deprecated, except for disabling minor gridlines by setting the count to 0 . The number of minor gridlines depends on the interval between major gridlines and the minimum required space.

Type: number
پیش‌فرض: 1
vAxis.minValue

Moves the min value of the vertical axis to the specified value; this will be downward in most charts. Ignored if this is set to a value greater than the minimum y-value of the data. vAxis.viewWindow.min overrides this property.

Type: number
Default: null
vAxis.textPosition

Position of the vertical axis text, relative to the chart area. Supported values: 'out' , 'in' , 'none' .

Type: string
Default: 'out'
vAxis.textStyle

An object that specifies the vertical axis text style. The object has this format:

{ color: <string>,
  fontName: <string>,
  fontSize: <number>,
  bold: <boolean>,
  italic: <boolean> }
    

The color can be any HTML color string, for example: 'red' or '#00cc00' . Also see fontName and fontSize .

Type: object
Default: {color: 'black', fontName: <global-font-name>, fontSize: <global-font-size>}
vAxis.title

Specifies a title for the vertical axis.

Type: string
Default: no title
vAxis.titleTextStyle

An object that specifies the vertical axis title text style. The object has this format:

{ color: <string>,
  fontName: <string>,
  fontSize: <number>,
  bold: <boolean>,
  italic: <boolean> }
  

The color can be any HTML color string, for example: 'red' or '#00cc00' . Also see fontName and fontSize .

Type: object
Default: {color: 'black', fontName: <global-font-name>, fontSize: <global-font-size>}
vAxis.viewWindow

Specifies the cropping range of the vertical axis.

Type: object
Default: null
vAxis.viewWindow.max

The maximum vertical data value to render.

Ignored when vAxis.viewWindowMode is 'pretty' or 'maximized'.

Type: number
Default: auto
vAxis.viewWindow.min

The minimum vertical data value to render.

Ignored when vAxis.viewWindowMode is 'pretty' or 'maximized'.

Type: number
Default: auto

Gauge configuration options

نام
greenColor

The color to use for the green section in HTML color notation.

Type: string
Default: '#109618'
greenFrom

The lowest value for a range marked by a green color.

Type: number
Default: none
greenTo

The highest value for a range marked by a green color.

Type: number
Default: none
ارتفاع

Height of the chart in pixels.

Type: number
Default: Container's width
حداکثر

The maximum value to show on the Y axis. If the maximum data point exceeds this value, this setting is ignored, and the chart is adjusted to show the next major tick mark above the maximum data point. This takes precedence over the Y axis maximum determined by scaleType .

This is similar to maxValue in core charts.

Type: number
Default: automatic
دقیقه

The minimum value to show on the Y axis. If the minimum data point is less than this value, this setting is ignored, and the chart is adjusted to show the next major tick mark below the minimum data point. This takes precedence over the Y axis minimum determined by scaleType .

This is similar to minValue in core charts.

Type: number
Default: automatic
redColor

The color to use for the red section in HTML color notation.

Type: string
Default: '#DC3912'
redFrom

The lowest value for a range marked by a red color.

Type: number
Default: none
redTo

The highest value for a range marked by a red color.

Type: number
Default: none
عرض

Width of the chart in pixels.

Type: number
Default: Container's width
yellowColor

The color to use for the yellow section in HTML color notation.

Type: string
Default: '#FF9900'
yellowFrom

The lowest value for a range marked by a yellow color.

Type: number
Default: none
yellowTo

The highest value for a range marked by a yellow color.

Type: number
Default: none

Geochart configuration options

نام
رنگ پس‌زمینه

The background color for the main area of the chart. Can be either a simple HTML color string, for example: 'red' or '#00cc00' , or an object with the following properties.

Type: string or object
Default: 'white'
backgroundColor.fill

The chart fill color, as an HTML color string.

Type: string
Default: 'white'
datalessRegionColor

Color to assign to regions with no associated data.

Type: string
Default: '#F5F5F5'
defaultColor

The color to use for data points in a geochart when the location (eg, 'US' ) is present but the value is either null or unspecified. This is distinct from datalessRegionColor , which is the color used when data is missing.

Type: string
Default: '#267114'
displayMode

Which type of geochart this is. The DataTable format must match the value specified. The following values are supported:

  • 'auto' - Choose based on the format of the DataTable.
  • 'regions' - Color the regions on the geochart.
  • 'markers' - Place markers on the regions.
  • 'text' - Label the regions with text from the DataTable.
Type: string
Default: 'auto'
ارتفاع

Height of the chart in pixels.

Type: number
Default: height of the containing element
افسانه

An object with members to configure various aspects of the legend. To specify properties of this object, you can use object literal notation, as shown here:

{position: 'top', textStyle: {color: 'blue', fontSize: 16}}
Type: object
Default: null
legendTextStyle

An object that specifies the legend text style. The object has this format:

{ color: <string>,
  fontName: <string>,
  fontSize: <number>,
  bold: <boolean>,
  italic: <boolean> }
    

The color can be any HTML color string, for example: 'red' or '#00cc00' . Also see fontName and fontSize .

Type: object
Default: {color: 'black', fontName: <global-font-name>, fontSize: <global-font-size>}
منطقه

The area to display on the geochart. Surrounding areas are displayed as well. Can be one of the following:

  • 'world' - A geochart of the entire world.
  • A continent or a sub-continent, specified by its 3-digit code , eg, '011' for Western Africa.
  • A country, specified by its ISO 3166-1 alpha-2 code, eg, 'AU' for Australia.
  • A state in the United States, specified by its ISO 3166-2:US code, eg, 'US-AL' for Alabama. Note that the resolution option must be set to either 'provinces' or 'metros' .
Type: string
Default: 'world'
عرض

Width of the chart in pixels.

Type: number
Default: width of the containing element

Histogram configuration options

نام
رنگ پس‌زمینه

The background color for the main area of the chart. Can be either a simple HTML color string, for example: 'red' or '#00cc00' , or an object with the following properties.

Type: string or object
Default: 'white'
backgroundColor.fill

The chart fill color, as an HTML color string.

Type: string
Default: 'white'
chartArea

An object with members to configure the placement and size of the chart area (where the chart itself is drawn, excluding axis and legends). Two formats are supported: a number, or a number followed by %. A simple number is a value in pixels; a number followed by % is a percentage. Example: chartArea:{left:20,top:0,width:'50%',height:'75%'}

Type: object
Default: null
chartArea.backgroundColor
Chart area background color. When a string is used, it can be either a hex string (eg, '#fdc' ) or an English color name. When an object is used, the following properties can be provided:
  • stroke : The color, provided as a hex string or English color name.
  • strokeWidth : If provided, draws a border around the chart area of the given width (and with the color of stroke ).
Type: string or object /div>
Default: 'white'
chartArea.height

Chart area height.

Type: number or string
Default: auto
chartArea.left

How far to draw the chart from the left border.

Type: number or string
Default: auto
chartArea.top

How far to draw the chart from the top border.

Type: number or string
Default: auto
chartArea.width

Chart area width.

Type: number or string
Default: auto
رنگ‌ها

The colors to use for the chart elements. An array of strings, where each element is an HTML color string, for example: colors:['red','#004411'] .

Type: Array of strings
Default: default colors
hAxis

An object with members to configure various horizontal axis elements. To specify properties of this object, you can use object literal notation, as shown here:

{
  title: 'Hello',
  titleTextStyle: {
    color: '#FF0000'
  }
}
    
Type: object
Default: null
hAxis.gridlines

An object with properties to configure the gridlines on the horizontal axis. Note that horizontal axis gridlines are drawn vertically. To specify properties of this object, you can use object literal notation, as shown here:

{color: '#333', minSpacing: 20}

This option is only supported for a continuous axis.

Type: object
Default: null
hAxis.gridlines.color

The color of the horizontal gridlines inside the chart area. Specify a valid HTML color string.

Type: string
Default: '#CCC'
hAxis.gridlines.count

The approximate number of horizontal gridlines inside the chart area. If you specify a positive number for gridlines.count , it will be used to compute the minSpacing between gridlines. You can specify a value of 1 to only draw one gridline, or 0 to draw no gridlines. Specify -1 , which is the default, to automatically compute the number of gridlines based on other options.

Type: number
Default: -1
hAxis.minorGridlines

An object with members to configure the minor gridlines on the horizontal axis, similar to the hAxis.gridlines option.

This option is only supported for a continuous axis.

Type: object
Default: null
hAxis.minorGridlines.color

The color of the horizontal minor gridlines inside the chart area. Specify a valid HTML color string.

Type: string
Default: A blend of the gridline and background colors
hAxis.minorGridlines.count

The minorGridlines.count option is mostly deprecated, except for disabling minor gridlines by setting the count to 0. The number of minor gridlines now depends entirely on the interval between major gridlines (see hAxis.gridlines.interval ) and the minimum required space (see hAxis.minorGridlines.minSpacing ).

Type: number
پیش‌فرض: 1
hAxis.textPosition

Position of the horizontal axis text, relative to the chart area. Supported values: 'out' , 'in' , 'none' .

Type: string
Default: 'out'
hAxis.textStyle

An object that specifies the horizontal axis text style. The object has this format:

{ color: <string>,
  fontName: <string>,
  fontSize: <number>,
  bold: <boolean>,
  italic: <boolean> }
    

The color can be any HTML color string, for example: 'red' or '#00cc00' . Also see fontName and fontSize .

Type: object
Default: {color: 'black', fontName: <global-font-name>, fontSize: <global-font-size>}
hAxis.title

hAxis property that specifies the title of the horizontal axis.

Type: string
Default: null
hAxis.titleTextStyle

An object that specifies the horizontal axis title text style. The object has this format:

{ color: <string>,
  fontName: <string>,
  fontSize: <number>,
  bold: <boolean>,
  italic: <boolean> }
    

The color can be any HTML color string, for example: 'red' or '#00cc00' . Also see fontName and fontSize .

Type: object
Default: {color: 'black', fontName: <global-font-name>, fontSize: <global-font-size>}
hAxis.viewWindow

Specifies the cropping range of the horizontal axis.

Type: object
Default: null
hAxis.viewWindow.max

The maximum horizontal data value to render.

Ignored when hAxis.viewWindowMode is 'pretty' or 'maximized' .

Type: number
Default: auto
hAxis.viewWindow.min

The minimum horizontal data value to render.

Ignored when hAxis.viewWindowMode is 'pretty' or 'maximized' .

Type: number
Default: auto
ارتفاع

Height of the chart in pixels.

Type: number
Default: height of the containing element
histogram.bucketSize

Hardcode the size of each histogram bar, rather than letting it be determined algorithmically.

Type: number
Default: auto
histogram.hideBucketItems

Omit the thin divisions between the blocks of the histogram, making it into a series of solid bars.

Type: boolean
پیش‌فرض: false
histogram.lastBucketPercentile

When calculating the histogram's bucket size, ignore the top and bottom lastBucketPercentile percent. The values are still included in the histogram, but do not affect bucketing.

Type: number
Default: 0
interpolateNulls

Whether to guess the value of missing points. If true , it will guess the value of any missing data based on neighboring points. If false , it will leave a break in the line at the unknown point.

This is not supported by Area charts with the isStacked: true/'percent'/'relative'/'absolute' option.

Type: boolean
پیش‌فرض: false
isStacked

If set to true , stacks the elements for all series at each domain value. Note: In Column , Area , and SteppedArea charts, Google Charts reverses the order of legend items to better correspond with the stacking of the series elements (Eg series 0 will be the bottom-most legend item). This does not apply to Bar Charts.

The isStacked option also supports 100% stacking, where the stacks of elements at each domain value are rescaled to add up to 100%.

The options for isStacked are:

  • false — elements will not stack. This is the default option.
  • true — stacks elements for all series at each domain value.
  • 'percent' — stacks elements for all series at each domain value and rescales them such that they add up to 100%, with each element's value calculated as a percentage of 100%.
  • 'relative' — stacks elements for all series at each domain value and rescales them such that they add up to 1, with each element's value calculated as a fraction of 1.
  • 'absolute' — functions the same as isStacked: true .

For 100% stacking, the calculated value for each element will appear in the tooltip after its actual value.

The target axis will default to tick values based on the relative 0-1 scale as fractions of 1 for 'relative' , and 0-100% for 'percent' ( Note: when using the 'percent' option, the axis/tick values are displayed as percentages, however the actual values are the relative 0-1 scale values. This is because the percentage axis ticks are the result of applying a format of "#.##%" to the relative 0-1 scale values. When using isStacked: 'percent' , be sure to specify any ticks/gridlines using the relative 0-1 scale values). You can customize the gridlines/tick values and formatting using the appropriate hAxis/vAxis options.

100% stacking only supports data values of type number , and must have a baseline of zero.

Type: boolean / string
پیش‌فرض: false
افسانه

An object with members to configure various aspects of the legend. To specify properties of this object, you can use object literal notation, as shown here:

{position: 'top', textStyle: {color: 'blue', fontSize: 16}}
Type: object
Default: null
legend.position

Position of the legend. Can be one of the following:

  • 'bottom' - Below the chart.
  • 'left' - To the left of the chart, provided the left axis has no series associated with it. So if you want the legend on the left, use the option targetAxisIndex: 1 .
  • 'in' - Inside the chart, by the top left corner.
  • 'none' - No legend is displayed.
  • 'right' - To the right of the chart. Incompatible with the vAxes option.
  • 'top' - Above the chart.
Type: string
Default: 'right'
legendTextStyle

An object that specifies the legend text style. The object has this format:

{ color: <string>,
  fontName: <string>,
  fontSize: <number>,
  bold: <boolean>,
  italic: <boolean> }
    

The color can be any HTML color string, for example: 'red' or '#00cc00' . Also see fontName and fontSize .

Type: object
Default: {color: 'black', fontName: <global-font-name>, fontSize: <global-font-size>}
reverseCategories

If set to true , draws series from right to left. The default is to draw left to right.

This option is only supported for a discrete major axis.

Type: boolean
پیش‌فرض: false
سری

An array of objects, each describing the format of the corresponding series in the chart. To use default values for a series, specify an empty object {} . If a series or a value is not specified, the global value will be used. Each object supports the following properties:

  • color - The color to use for this series. Specify a valid HTML color string.
  • labelInLegend - The description of the series to appear in the chart legend.
  • targetAxisIndex - Which axis to assign this series to, where 0 is the default axis, and 1 is the opposite axis. Default value is 0 ; set to 1 to define a chart where different series are rendered against different axes. At least one series must be allocated to the default axis. You can define a different scale for different axes.
  • visibleInLegend - A boolean value, where true means that the series should have a legend entry, and false means that it should not. Default is true .

You can specify either an array of objects, each of which applies to the series in the order given, or you can specify an object where each child has a numeric key indicating which series it applies to. For example, the following two declarations are identical, and declare the first series as black and absent from the legend, and the fourth as red and absent from the legend:

series: [
  {color: 'black', visibleInLegend: false}, {}, {},
  {color: 'red', visibleInLegend: false}
]
series: {
  0:{color: 'black', visibleInLegend: false},
  3:{color: 'red', visibleInLegend: false}
}
    
Type: Array of objects, or object with nested objects
پیش‌فرض: {}
زیرنویس

Text to display below the chart title.

Type: string
Default: no title
subtitleTextStyle

An object that specifies the title text style.

The color can be any HTML color string, for example: 'red' or '#00cc00' . Also see fontName and fontSize .

Type: object
Default: {color: 'black', fontName: <global-font-name>, fontSize: <global-font-size>}
تم

A theme is a set of predefined option values that work together to achieve a specific chart behavior or visual effect. Currently only one theme is available:

  • 'maximized' - Maximizes the area of the chart, and draws the legend and all of the labels inside the chart area.
Type: string
Default: null
عنوان

Text to display above the chart.

Type: string
Default: no title
titleTextStyle

An object that specifies the title text style. The object has this format:

{ color: <string>,
  fontName: <string>,
  fontSize: <number>,
  bold: <boolean>,
  italic: <boolean> }
    

The color can be any HTML color string, for example: 'red' or '#00cc00' . Also see fontName and fontSize .

Type: object
Default: {color: 'black', fontName: <global-font-name>, fontSize: <global-font-size>}
useFirstColumnAsDomain

If set to true , the chart will treat the column as the domain.

Type: boolean
vAxes

Specifies properties for individual vertical axes, if the chart has multiple vertical axes. Each child object is a vAxis object, and can contain all the properties supported by vAxis . These property values override any global settings for the same property.

To specify a chart with multiple vertical axes, first define a new axis using series.targetAxisIndex , then configure the axis using vAxes . The following example assigns series 2 to the right axis and specifies a custom title and text style for it:

{
  series: {
    2: {
      targetAxisIndex:1
    }
  },
  vAxes: {
    1: {
      title:'Losses',
      textStyle: {color: 'red'}
    }
  }
}
    

This property can be either an object or an array: the object is a collection of objects, each with a numeric label that specifies the axis that it defines--this is the format shown above; the array is an array of objects, one per axis. For example, the following array-style notation is identical to the vAxis object shown above:

vAxes: [
  {}, // Nothing specified for axis 0
  {
    title:'Losses',
    textStyle: {color: 'red'} // Axis 1
  }
]
    
Type: Array of object, or object with child objects
Default: null
vAxis

An object with members to configure various vertical axis elements. To specify properties of this object, you can use object literal notation, as shown here:

{title: 'Hello', titleTextStyle: {color: '#FF0000'}}
Type: object
Default: null
vAxis.direction

The direction in which the values along the vertical axis grow. By default, low values are on the bottom of the chart. Specify -1 to reverse the order of the values.

Type: 1 or -1
پیش‌فرض: 1
vAxis.gridlines

An object with members to configure the gridlines on the vertical axis. Note that vertical axis gridlines are drawn horizontally. To specify properties of this object, you can use object literal notation, as shown here:

{color: '#333', minSpacing: 20}

This option is only supported for a continuous axis.

Type: object
Default: null
vAxis.gridlines.color

The color of the vertical gridlines inside the chart area. Specify a valid HTML color string.

Type: string
Default: '#CCC'
vAxis.gridlines.count

The approximate number of horizontal gridlines inside the chart area. If you specify a positive number for gridlines.count , it will be used to compute the minSpacing between gridlines. You can specify a value of 1 to only draw one gridline, or 0 to draw no gridlines. Specify -1 , which is the default, to automatically compute the number of gridlines based on other options.

Type: number
Default: -1
vAxis.logScale

If true , makes the vertical axis a logarithmic scale. Note: All values must be positive.

Type: boolean
پیش‌فرض: false
vAxis.maxValue

Moves the max value of the vertical axis to the specified value; this will be upward in most charts. Ignored if this is set to a value smaller than the maximum y-value of the data. vAxis.viewWindow.max overrides this property.

Type: number
Default: automatic
vAxis.minorGridlines

An object with members to configure the minor gridlines on the vertical axis, similar to the vAxis.gridlines option.

Type: object
Default: null
vAxis.minorGridlines.color

The color of the vertical minor gridlines inside the chart area. Specify a valid HTML color string.

Type: string
Default: A blend of the gridline and background colors
vAxis.minorGridlines.count

The minorGridlines.count option is mostly deprecated, except for disabling minor gridlines by setting the count to 0 . The number of minor gridlines depends on the interval between major gridlines and the minimum required space.

Type: number
پیش‌فرض: 1
vAxis.minValue

Moves the min value of the vertical axis to the specified value; this will be downward in most charts. Ignored if this is set to a value greater than the minimum y-value of the data. vAxis.viewWindow.min overrides this property.

Type: number
Default: null
vAxis.textPosition

Position of the vertical axis text, relative to the chart area. Supported values: 'out' , 'in' , 'none' .

Type: string
Default: 'out'
vAxis.textStyle

An object that specifies the vertical axis text style. The object has this format:

{ color: <string>,
  fontName: <string>,
  fontSize: <number>,
  bold: <boolean>,
  italic: <boolean> }
    

The color can be any HTML color string, for example: 'red' or '#00cc00' . Also see fontName and fontSize .

Type: object
Default: {color: 'black', fontName: <global-font-name>, fontSize: <global-font-size>}
vAxis.title

Specifies a title for the vertical axis.

Type: string
Default: no title
vAxis.titleTextStyle

An object that specifies the vertical axis title text style. The object has this format:

{ color: <string>,
  fontName: <string>,
  fontSize: <number>,
  bold: <boolean>,
  italic: <boolean> }
  

The color can be any HTML color string, for example: 'red' or '#00cc00' . Also see fontName and fontSize .

Type: object
Default: {color: 'black', fontName: <global-font-name>, fontSize: <global-font-size>}
vAxis.viewWindow

Specifies the cropping range of the vertical axis.

Type: object
Default: null
vAxis.viewWindow.max

The maximum vertical data value to render.

Ignored when vAxis.viewWindowMode is 'pretty' or 'maximized'.

Type: number
Default: auto
vAxis.viewWindow.min

The minimum vertical data value to render.

Ignored when vAxis.viewWindowMode is 'pretty' or 'maximized'.

Type: number
Default: auto
عرض

Width of the chart in pixels.

Type: number
Default: width of the containing element

Line chart configuration options

نام
رنگ پس‌زمینه

The background color for the main area of the chart. Can be either a simple HTML color string, for example: 'red' or '#00cc00' , or an object with the following properties.

Type: string or object
Default: 'white'
backgroundColor.fill

The chart fill color, as an HTML color string.

Type: string
Default: 'white'
chartArea

An object with members to configure the placement and size of the chart area (where the chart itself is drawn, excluding axis and legends). Two formats are supported: a number, or a number followed by %. A simple number is a value in pixels; a number followed by % is a percentage. Example: chartArea:{left:20,top:0,width:'50%',height:'75%'}

Type: object
Default: null
chartArea.backgroundColor
Chart area background color. When a string is used, it can be either a hex string (eg, '#fdc' ) or an English color name. When an object is used, the following properties can be provided:
  • stroke : The color, provided as a hex string or English color name.
  • strokeWidth : If provided, draws a border around the chart area of the given width (and with the color of stroke ).
Type: string or object
Default: 'white'
chartArea.height

Chart area height.

Type: number or string
Default: auto
chartArea.left

How far to draw the chart from the left border.

Type: number or string
Default: auto
chartArea.top

How far to draw the chart from the top border.

Type: number or string
Default: auto
chartArea.width

Chart area width.

Type: number or string
Default: auto
رنگ‌ها

The colors to use for the chart elements. An array of strings, where each element is an HTML color string, for example: colors:['red','#004411'] .

Type: Array of strings
Default: default colors
curveType

Controls the curve of the lines when the line width is not zero. Can be one of the following:

  • 'none' - Straight lines without curve.
  • 'function' - The angles of the line will be smoothed.
Type: string
Default: 'none'
hAxis

An object with members to configure various horizontal axis elements. To specify properties of this object, you can use object literal notation, as shown here:

{
  title: 'Hello',
  titleTextStyle: {
    color: '#FF0000'
  }
}
    
Type: object
Default: null
hAxis.direction

The direction in which the values along the horizontal axis grow. Specify -1 to reverse the order of the values.

Type: 1 or -1
پیش‌فرض: 1
hAxis.gridlines

An object with properties to configure the gridlines on the horizontal axis. Note that horizontal axis gridlines are drawn vertically. To specify properties of this object, you can use object literal notation, as shown here:

{color: '#333', minSpacing: 20}

This option is only supported for a continuous axis.

Type: object
Default: null
hAxis.gridlines.color

The color of the horizontal gridlines inside the chart area. Specify a valid HTML color string.

Type: string
Default: '#CCC'
hAxis.gridlines.count

The approximate number of horizontal gridlines inside the chart area. If you specify a positive number for gridlines.count , it will be used to compute the minSpacing between gridlines. You can specify a value of 1 to only draw one gridline, or 0 to draw no gridlines. Specify -1 , which is the default, to automatically compute the number of gridlines based on other options.

Type: number
Default: -1
hAxis.logScale

hAxis property that makes the horizontal axis a logarithmic scale (requires all values to be positive). Set to true for yes.

This option is only supported for a continuous axis.

Type: boolean
پیش‌فرض: false
hAxis.maxValue

Moves the max value of the horizontal axis to the specified value; this will be rightward in most charts. Ignored if this is set to a value smaller than the maximum x-value of the data. hAxis.viewWindow.max overrides this property.

Type: number
Default: automatic
hAxis.minorGridlines

An object with members to configure the minor gridlines on the horizontal axis, similar to the hAxis.gridlines option.

This option is only supported for a continuous axis.

Type: object
Default: null
hAxis.minorGridlines.color

The color of the horizontal minor gridlines inside the chart area. Specify a valid HTML color string.

Type: string
Default: A blend of the gridline and background colors
hAxis.minorGridlines.count

The minorGridlines.count option is mostly deprecated, except for disabling minor gridlines by setting the count to 0. The number of minor gridlines now depends entirely on the interval between major gridlines (see hAxis.gridlines.interval ) and the minimum required space (see hAxis.minorGridlines.minSpacing ).

Type: number
پیش‌فرض: 1
hAxis.minValue

Moves the min value of the horizontal axis to the specified value; this will be leftward in most charts. Ignored if this is set to a value greater than the minimum x-value of the data. hAxis.viewWindow.min overrides this property.

Type: number
Default: automatic
hAxis.textPosition

Position of the horizontal axis text, relative to the chart area. Supported values: 'out' , 'in' , 'none' .

Type: string
Default: 'out'
hAxis.textStyle

An object that specifies the horizontal axis text style. The object has this format:

{ color: <string>,
  fontName: <string>,
  fontSize: <number>,
  bold: <boolean>,
  italic: <boolean> }
    

The color can be any HTML color string, for example: 'red' or '#00cc00' . Also see fontName and fontSize .

Type: object
Default: {color: 'black', fontName: <global-font-name>, fontSize: <global-font-size>}
hAxis.title

hAxis property that specifies the title of the horizontal axis.

Type: string
Default: null
hAxis.titleTextStyle

An object that specifies the horizontal axis title text style. The object has this format:

{ color: <string>,
  fontName: <string>,
  fontSize: <number>,
  bold: <boolean>,
  italic: <boolean> }
    

The color can be any HTML color string, for example: 'red' or '#00cc00' . Also see fontName and fontSize .

Type: object
Default: {color: 'black', fontName: <global-font-name>, fontSize: <global-font-size>}
hAxis.viewWindow

Specifies the cropping range of the horizontal axis.

Type: object
Default: null
hAxis.viewWindow.max

The maximum horizontal data value to render.

Ignored when hAxis.viewWindowMode is 'pretty' or 'maximized' .

Type: number
Default: auto
hAxis.viewWindow.min

The minimum horizontal data value to render.

Ignored when hAxis.viewWindowMode is 'pretty' or 'maximized' .

Type: number
Default: auto
ارتفاع

Height of the chart in pixels.

Type: number
Default: height of the containing element
interpolateNulls

Whether to guess the value of missing points. If true , it will guess the value of any missing data based on neighboring points. If false , it will leave a break in the line at the unknown point.

This is not supported by Area charts with the isStacked: true/'percent'/'relative'/'absolute' option.

Type: boolean
پیش‌فرض: false
افسانه

An object with members to configure various aspects of the legend. To specify properties of this object, you can use object literal notation, as shown here:

{position: 'top', textStyle: {color: 'blue', fontSize: 16}}
Type: object
Default: null
legend.position

Position of the legend. Can be one of the following:

  • 'bottom' - Below the chart.
  • 'left' - To the left of the chart, provided the left axis has no series associated with it. So if you want the legend on the left, use the option targetAxisIndex: 1 .
  • 'in' - Inside the chart, by the top left corner.
  • 'none' - No legend is displayed.
  • 'right' - To the right of the chart. Incompatible with the vAxes option.
  • 'top' - Above the chart.
Type: string
Default: 'right'
legendTextStyle

An object that specifies the legend text style. The object has this format:

{ color: <string>,
  fontName: <string>,
  fontSize: <number>,
  bold: <boolean>,
  italic: <boolean> }
    

The color can be any HTML color string, for example: 'red' or '#00cc00' . Also see fontName and fontSize .

Type: object
Default: {color: 'black', fontName: <global-font-name>, fontSize: <global-font-size>}
lineWidth

Data line width in pixels. Use zero to hide all lines and show only the points. You can override values for individual series using the series property.

Type: number
پیش‌فرض: 2
pointShape

The shape of individual data elements: 'circle' , 'triangle' , 'square' , 'diamond' , 'star' or 'polygon' . See the points documentation for examples.

Type: string
Default: 'circle'
pointSize

Diameter of displayed points in pixels. Use zero to hide all points. You can override values for individual series using the series property. If you're using a trendline , the pointSize option will affect the width of the trendline unless you override it with the trendlines.n.pointsize option.

Type: number
Default: 0
reverseCategories

If set to true , draws series from right to left. The default is to draw left to right.

This option is only supported for a discrete major axis.

Type: boolean
پیش‌فرض: false
سری

An array of objects, each describing the format of the corresponding series in the chart. To use default values for a series, specify an empty object {} . If a series or a value is not specified, the global value will be used. Each object supports the following properties:

  • annotations - An object to be applied to annotations for this series. This can be used to control, for instance, the textStyle for the series:

    series: {
      0: {
        annotations: {
          textStyle: {fontSize: 12, color: 'red' }
        }
      }
    }
              

    See the various annotations options for a more complete list of what can be customized.

  • type - The type of marker for this series. Valid values are 'line', 'area', 'bars', and 'steppedArea'. Note that bars are actually vertical bars (columns). The default value is specified by the chart's seriesType option.
  • color - The color to use for this series. Specify a valid HTML color string.
  • curveType - Overrides the global curveType value for this series.
  • labelInLegend - The description of the series to appear in the chart legend.
  • lineDashStyle - Overrides the global lineDashStyle value for this series.
  • lineWidth - Overrides the global lineWidth value for this series.
  • pointShape - Overrides the global pointShape value for this series.
  • pointSize - Overrides the global pointSize value for this series.
  • pointsVisible - Overrides the global pointsVisible value for this series.
  • targetAxisIndex - Which axis to assign this series to, where 0 is the default axis, and 1 is the opposite axis. Default value is 0 ; set to 1 to define a chart where different series are rendered against different axes. At least one series must be allocated to the default axis. You can define a different scale for different axes.
  • visibleInLegend - A boolean value, where true means that the series should have a legend entry, and false means that it should not. Default is true .

You can specify either an array of objects, each of which applies to the series in the order given, or you can specify an object where each child has a numeric key indicating which series it applies to. For example, the following two declarations are identical, and declare the first series as black and absent from the legend, and the fourth as red and absent from the legend:

series: [
  {color: 'black', visibleInLegend: false}, {}, {},
  {color: 'red', visibleInLegend: false}
]
series: {
  0:{color: 'black', visibleInLegend: false},
  3:{color: 'red', visibleInLegend: false}
}
    
Type: Array of objects, or object with nested objects
پیش‌فرض: {}
زیرنویس

Text to display below the chart title.

Type: string
Default: no title
subtitleTextStyle

An object that specifies the title text style.

The color can be any HTML color string, for example: 'red' or '#00cc00' . Also see fontName and fontSize .

Type: object
Default: {color: 'black', fontName: <global-font-name>, fontSize: <global-font-size>}
تم

A theme is a set of predefined option values that work together to achieve a specific chart behavior or visual effect. Currently only one theme is available:

  • 'maximized' - Maximizes the area of the chart, and draws the legend and all of the labels inside the chart area.
Type: string
Default: null
عنوان

Text to display above the chart.

Type: string
Default: no title
titleTextStyle

An object that specifies the title text style. The object has this format:

{ color: <string>,
  fontName: <string>,
  fontSize: <number>,
  bold: <boolean>,
  italic: <boolean> }
    

The color can be any HTML color string, for example: 'red' or '#00cc00' . Also see fontName and fontSize .

Type: object
Default: {color: 'black', fontName: <global-font-name>, fontSize: <global-font-size>}
treatLabelsAsText

If set to true , the chart will treat the column as a text column.

Type: boolean
خطوط روند

Displays trendlines on the charts that support them. By default, linear trendlines are used, but this can be customized with the trendlines. n .type option.

Trendlines are specified on a per-series basis, so most of the time your options will look like this:

var options = {
  trendlines: {
    0: {
      type: 'linear',
      color: 'green',
      lineWidth: 3,
      opacity: 0.3,
      visibleInLegend: true
    }
  }
}
    
Type: object
Default: null
trendlines.n.color

The color of the trendline , expressed as either an English color name or a hex string.

Type: string
Default: default series color
trendlines.n.degree

For trendlines of type: 'polynomial' , the degree of the polynomial ( 2 for quadratic, 3 for cubic, and so on).

Type: number
Default: 3
trendlines.n.labelInLegend

If set, the trendline will appear in the legend as this string.

Type: string
Default: null
trendlines.n.lineWidth

The line width of the trendline , in pixels.

Type: number
پیش‌فرض: 2
trendlines.n.type

Whether the trendlines is 'linear' (the default), 'exponential' , or 'polynomial' .

Type: string
Default: linear
trendlines.n.visibleInLegend

Whether the trendline equation appears in the legend. It will appear in the trendline tooltip.

Type: boolean
پیش‌فرض: false
useFirstColumnAsDomain

If set to true , the chart will treat the column as the domain.

Type: boolean
vAxes

Specifies properties for individual vertical axes, if the chart has multiple vertical axes. Each child object is a vAxis object, and can contain all the properties supported by vAxis . These property values override any global settings for the same property.

To specify a chart with multiple vertical axes, first define a new axis using series.targetAxisIndex , then configure the axis using vAxes . The following example assigns series 2 to the right axis and specifies a custom title and text style for it:

{
  series: {
    2: {
      targetAxisIndex:1
    }
  },
  vAxes: {
    1: {
      title:'Losses',
      textStyle: {color: 'red'}
    }
  }
}
    

This property can be either an object or an array: the object is a collection of objects, each with a numeric label that specifies the axis that it defines--this is the format shown above; the array is an array of objects, one per axis. For example, the following array-style notation is identical to the vAxis object shown above:

vAxes: [
  {}, // Nothing specified for axis 0
  {
    title:'Losses',
    textStyle: {color: 'red'} // Axis 1
  }
]
    
Type: Array of object, or object with child objects
Default: null
vAxis

An object with members to configure various vertical axis elements. To specify properties of this object, you can use object literal notation, as shown here:

{title: 'Hello', titleTextStyle: {color: '#FF0000'}}
Type: object
Default: null
vAxis.direction

The direction in which the values along the vertical axis grow. By default, low values are on the bottom of the chart. Specify -1 to reverse the order of the values.

Type: 1 or -1
پیش‌فرض: 1
vAxis.gridlines

An object with members to configure the gridlines on the vertical axis. Note that vertical axis gridlines are drawn horizontally. To specify properties of this object, you can use object literal notation, as shown here:

{color: '#333', minSpacing: 20}

This option is only supported for a continuous axis.

Type: object
Default: null
vAxis.gridlines.color

The color of the vertical gridlines inside the chart area. Specify a valid HTML color string.

Type: string
Default: '#CCC'
vAxis.gridlines.count

The approximate number of horizontal gridlines inside the chart area. If you specify a positive number for gridlines.count , it will be used to compute the minSpacing between gridlines. You can specify a value of 1 to only draw one gridline, or 0 to draw no gridlines. Specify -1 , which is the default, to automatically compute the number of gridlines based on other options.

Type: number
Default: -1
vAxis.logScale

If true , makes the vertical axis a logarithmic scale. Note: All values must be positive.

Type: boolean
پیش‌فرض: false
vAxis.maxValue

Moves the max value of the vertical axis to the specified value; this will be upward in most charts. Ignored if this is set to a value smaller than the maximum y-value of the data. vAxis.viewWindow.max overrides this property.

Type: number
Default: automatic
vAxis.minorGridlines

An object with members to configure the minor gridlines on the vertical axis, similar to the vAxis.gridlines option.

Type: object
Default: null
vAxis.minorGridlines.color

The color of the vertical minor gridlines inside the chart area. Specify a valid HTML color string.

Type: string
Default: A blend of the gridline and background colors
vAxis.minorGridlines.count

The minorGridlines.count option is mostly deprecated, except for disabling minor gridlines by setting the count to 0 . The number of minor gridlines depends on the interval between major gridlines and the minimum required space.

Type: number
پیش‌فرض: 1
vAxis.minValue

Moves the min value of the vertical axis to the specified value; this will be downward in most charts. Ignored if this is set to a value greater than the minimum y-value of the data. vAxis.viewWindow.min overrides this property.

Type: number
Default: null
vAxis.textPosition

Position of the vertical axis text, relative to the chart area. Supported values: 'out' , 'in' , 'none' .

Type: string
Default: 'out'
vAxis.textStyle

An object that specifies the vertical axis text style. The object has this format:

{ color: <string>,
  fontName: <string>,
  fontSize: <number>,
  bold: <boolean>,
  italic: <boolean> }
    

The color can be any HTML color string, for example: 'red' or '#00cc00' . Also see fontName and fontSize .

Type: object
Default: {color: 'black', fontName: <global-font-name>, fontSize: <global-font-size>}
vAxis.title

Specifies a title for the vertical axis.

Type: string
Default: no title
vAxis.titleTextStyle

An object that specifies the vertical axis title text style. The object has this format:

{ color: <string>,
  fontName: <string>,
  fontSize: <number>,
  bold: <boolean>,
  italic: <boolean> }
  

The color can be any HTML color string, for example: 'red' or '#00cc00' . Also see fontName and fontSize .

Type: object
Default: {color: 'black', fontName: <global-font-name>, fontSize: <global-font-size>}
vAxis.viewWindow

Specifies the cropping range of the vertical axis.

Type: object
Default: null
vAxis.viewWindow.max

The maximum vertical data value to render.

Ignored when vAxis.viewWindowMode is 'pretty' or 'maximized'.

Type: number
Default: auto
vAxis.viewWindow.min

The minimum vertical data value to render.

Ignored when vAxis.viewWindowMode is 'pretty' or 'maximized'.

Type: number
Default: auto

Org chart configuration options

نام
رنگ

The background color of the org chart elements.

Type: string
Default: '#edf7ff'
selectionColor

The background color of selected org chart elements.

Type: string
Default: '#d6e9f8'
اندازه

The overall size of the chart. Options include 'small' , 'medium' , or 'large' .

Type: string
Default: 'medium'

Pie chart configuration options

نام
رنگ پس‌زمینه

The background color for the main area of the chart. Can be either a simple HTML color string, for example: 'red' or '#00cc00' , or an object with the following properties.

Type: string or object
Default: 'white'
backgroundColor.fill

The chart fill color, as an HTML color string.

Type: string
Default: 'white'
chartArea

An object with members to configure the placement and size of the chart area (where the chart itself is drawn, excluding axis and legends). Two formats are supported: a number, or a number followed by %. A simple number is a value in pixels; a number followed by % is a percentage. Example: chartArea:{left:20,top:0,width:'50%',height:'75%'}

Type: object
Default: null
chartArea.backgroundColor
Chart area background color. When a string is used, it can be either a hex string (eg, '#fdc' ) or an English color name. When an object is used, the following properties can be provided:
  • stroke : The color, provided as a hex string or English color name.
  • strokeWidth : If provided, draws a border around the chart area of the given width (and with the color of stroke ).
Type: string or object
Default: 'white'
chartArea.height

Chart area height.

Type: number or string
Default: auto
chartArea.left

How far to draw the chart from the left border.

Type: number or string
Default: auto
chartArea.top

How far to draw the chart from the top border.

Type: number or string
Default: auto
chartArea.width

Chart area width.

Type: number or string
Default: auto
رنگ‌ها

The colors to use for the chart elements. An array of strings, where each element is an HTML color string, for example: colors:['red','#004411'] .

Type: Array of strings
Default: default colors
ارتفاع

Height of the chart in pixels.

Type: number
Default: height of the containing element
is3D

If true , displays a three-dimensional chart.

Type: boolean
پیش‌فرض: false
افسانه

An object with members to configure various aspects of the legend. To specify properties of this object, you can use object literal notation, as shown here:

{position: 'top', textStyle: {color: 'blue', fontSize: 16}}
Type: object
Default: null
legend.position

Position of the legend. Can be one of the following:

  • 'bottom' - Below the chart.
  • 'left' - To the left of the chart, provided the left axis has no series associated with it. So if you want the legend on the left, use the option targetAxisIndex: 1 .
  • 'in' - Inside the chart, by the top left corner.
  • 'none' - No legend is displayed.
  • 'right' - To the right of the chart. Incompatible with the vAxes option.
  • 'top' - Above the chart.
Type: string
Default: 'right'
legendTextStyle

An object that specifies the legend text style. The object has this format:

{ color: <string>,
  fontName: <string>,
  fontSize: <number>,
  bold: <boolean>,
  italic: <boolean> }
    

The color can be any HTML color string, for example: 'red' or '#00cc00' . Also see fontName and fontSize .

Type: object
Default: {color: 'black', fontName: <global-font-name>, fontSize: <global-font-size>}
pieHole

If between 0 and 1 , displays a donut chart. The hole has a radius equal to number times the radius of the chart.

Type: number
Default: 0
pieSliceBorderColor

The color of the slice borders. Only applicable when the chart is two-dimensional.

Type: string
Default: 'white'
pieSliceText

The content of the text displayed on the slice. Can be one of the following:

  • 'percentage' - The percentage of the slice size out of the total.
  • 'value' - The quantitative value of the slice.
  • 'label' - The name of the slice.
  • 'none' - No text is displayed.
Type: string
Default: 'percentage'
pieSliceTextStyle

An object that specifies the slice text style. The object has this format:

{color: <string>, fontName: <string>, fontSize: <number>}

The color can be any HTML color string, for example: 'red' or '#00cc00' . Also see fontName and fontSize .

Type: object
Default: {color: 'black', fontName: <global-font-name>, fontSize: <global-font-size>}
reverseCategories

If set to true , draws series from right to left. The default is to draw left to right.

This option is only supported for a discrete major axis.

Type: boolean
پیش‌فرض: false
slices.color

The color to use for this slice.

Type: string
زیرنویس

Text to display below the chart title.

Type: string
Default: no title
subtitleTextStyle

An object that specifies the title text style.

The color can be any HTML color string, for example: 'red' or '#00cc00' . Also see fontName and fontSize .

Type: object
Default: {color: 'black', fontName: <global-font-name>, fontSize: <global-font-size>}
عنوان

Text to display above the chart.

Type: string
Default: no title
titleTextStyle

An object that specifies the title text style. The object has this format:

{ color: <string>,
  fontName: <string>,
  fontSize: <number>,
  bold: <boolean>,
  italic: <boolean> }
    

The color can be any HTML color string, for example: 'red' or '#00cc00' . Also see fontName and fontSize .

Type: object
Default: {color: 'black', fontName: <global-font-name>, fontSize: <global-font-size>}

Scatter chart configuration options

نام
رنگ پس‌زمینه

The background color for the main area of the chart. Can be either a simple HTML color string, for example: 'red' or '#00cc00' , or an object with the following properties.

Type: string or object
Default: 'white'
backgroundColor.fill

The chart fill color, as an HTML color string.

Type: string
Default: 'white'
chartArea

An object with members to configure the placement and size of the chart area (where the chart itself is drawn, excluding axis and legends). Two formats are supported: a number, or a number followed by %. A simple number is a value in pixels; a number followed by % is a percentage. Example: chartArea:{left:20,top:0,width:'50%',height:'75%'}

Type: object
Default: null
chartArea.backgroundColor
Chart area background color. When a string is used, it can be either a hex string (eg, '#fdc' ) or an English color name. When an object is used, the following properties can be provided:
  • stroke : The color, provided as a hex string or English color name.
  • strokeWidth : If provided, draws a border around the chart area of the given width (and with the color of stroke ).
Type: string or object
Default: 'white'
chartArea.height

Chart area height.

Type: number or string
Default: auto
chartArea.left

How far to draw the chart from the left border.

Type: number or string
Default: auto
chartArea.top

How far to draw the chart from the top border.

Type: number or string
Default: auto
chartArea.width

Chart area width.

Type: number or string
Default: auto
رنگ‌ها

The colors to use for the chart elements. An array of strings, where each element is an HTML color string, for example: colors:['red','#004411'] .

Type: Array of strings
Default: default colors
curveType

Controls the curve of the lines when the line width is not zero. Can be one of the following:

  • 'none' - Straight lines without curve.
  • 'function' - The angles of the line will be smoothed.
Type: string
Default: 'none'
hAxis

An object with members to configure various horizontal axis elements. To specify properties of this object, you can use object literal notation, as shown here:

{
  title: 'Hello',
  titleTextStyle: {
    color: '#FF0000'
  }
}
    
Type: object
Default: null
hAxis.direction

The direction in which the values along the horizontal axis grow. Specify -1 to reverse the order of the values.

Type: 1 or -1
پیش‌فرض: 1
hAxis.gridlines

An object with properties to configure the gridlines on the horizontal axis. Note that horizontal axis gridlines are drawn vertically. To specify properties of this object, you can use object literal notation, as shown here:

{color: '#333', minSpacing: 20}

This option is only supported for a continuous axis.

Type: object
Default: null
hAxis.gridlines.color

The color of the horizontal gridlines inside the chart area. Specify a valid HTML color string.

Type: string
Default: '#CCC'
hAxis.gridlines.count

The approximate number of horizontal gridlines inside the chart area. If you specify a positive number for gridlines.count , it will be used to compute the minSpacing between gridlines. You can specify a value of 1 to only draw one gridline, or 0 to draw no gridlines. Specify -1 , which is the default, to automatically compute the number of gridlines based on other options.

Type: number
Default: -1
hAxis.logScale

hAxis property that makes the horizontal axis a logarithmic scale (requires all values to be positive). Set to true for yes.

This option is only supported for a continuous axis.

Type: boolean
پیش‌فرض: false
hAxis.maxValue

Moves the max value of the horizontal axis to the specified value; this will be rightward in most charts. Ignored if this is set to a value smaller than the maximum x-value of the data. hAxis.viewWindow.max overrides this property.

Type: number
Default: automatic
hAxis.minorGridlines

An object with members to configure the minor gridlines on the horizontal axis, similar to the hAxis.gridlines option.

This option is only supported for a continuous axis.

Type: object
Default: null
hAxis.minorGridlines.color

The color of the horizontal minor gridlines inside the chart area. Specify a valid HTML color string.

Type: string
Default: A blend of the gridline and background colors
hAxis.minorGridlines.count

The minorGridlines.count option is mostly deprecated, except for disabling minor gridlines by setting the count to 0. The number of minor gridlines now depends entirely on the interval between major gridlines (see hAxis.gridlines.interval ) and the minimum required space (see hAxis.minorGridlines.minSpacing ).

Type: number
پیش‌فرض: 1
hAxis.minValue

Moves the min value of the horizontal axis to the specified value; this will be leftward in most charts. Ignored if this is set to a value greater than the minimum x-value of the data. hAxis.viewWindow.min overrides this property.

Type: number
Default: automatic
hAxis.textPosition

Position of the horizontal axis text, relative to the chart area. Supported values: 'out' , 'in' , 'none' .

Type: string
Default: 'out'
hAxis.textStyle

An object that specifies the horizontal axis text style. The object has this format:

{ color: <string>,
  fontName: <string>,
  fontSize: <number>,
  bold: <boolean>,
  italic: <boolean> }
    

The color can be any HTML color string, for example: 'red' or '#00cc00' . Also see fontName and fontSize .

Type: object
Default: {color: 'black', fontName: <global-font-name>, fontSize: <global-font-size>}
hAxis.title

hAxis property that specifies the title of the horizontal axis.

Type: string
Default: null
hAxis.titleTextStyle

An object that specifies the horizontal axis title text style. The object has this format:

{ color: <string>,
  fontName: <string>,
  fontSize: <number>,
  bold: <boolean>,
  italic: <boolean> }
    

The color can be any HTML color string, for example: 'red' or '#00cc00' . Also see fontName and fontSize .

Type: object
Default: {color: 'black', fontName: <global-font-name>, fontSize: <global-font-size>}
hAxis.viewWindow

Specifies the cropping range of the horizontal axis.

Type: object
Default: null
hAxis.viewWindow.max

The maximum horizontal data value to render.

Ignored when hAxis.viewWindowMode is 'pretty' or 'maximized' .

Type: number
Default: auto
hAxis.viewWindow.min

The minimum horizontal data value to render.

Ignored when hAxis.viewWindowMode is 'pretty' or 'maximized' .

Type: number
Default: auto
ارتفاع

Height of the chart in pixels.

Type: number
Default: height of the containing element
افسانه

An object with members to configure various aspects of the legend. To specify properties of this object, you can use object literal notation, as shown here:

{position: 'top', textStyle: {color: 'blue', fontSize: 16}}
Type: object
Default: null
legend.position

Position of the legend. Can be one of the following:

  • 'bottom' - Below the chart.
  • 'left' - To the left of the chart, provided the left axis has no series associated with it. So if you want the legend on the left, use the option targetAxisIndex: 1 .
  • 'in' - Inside the chart, by the top left corner.
  • 'none' - No legend is displayed.
  • 'right' - To the right of the chart. Incompatible with the vAxes option.
  • 'top' - Above the chart.
Type: string
Default: 'right'
legendTextStyle

An object that specifies the legend text style. The object has this format:

{ color: <string>,
  fontName: <string>,
  fontSize: <number>,
  bold: <boolean>,
  italic: <boolean> }
    

The color can be any HTML color string, for example: 'red' or '#00cc00' . Also see fontName and fontSize .

Type: object
Default: {color: 'black', fontName: <global-font-name>, fontSize: <global-font-size>}
lineWidth

Data line width in pixels. Use zero to hide all lines and show only the points. You can override values for individual series using the series property.

Type: number
پیش‌فرض: 2
pointShape

The shape of individual data elements: 'circle' , 'triangle' , 'square' , 'diamond' , 'star' or 'polygon' . See the points documentation for examples.

Type: string
Default: 'circle'
pointSize

Diameter of displayed points in pixels. Use zero to hide all points. You can override values for individual series using the series property. If you're using a trendline , the pointSize option will affect the width of the trendline unless you override it with the trendlines.n.pointsize option.

Type: number
Default: 0
سری

An array of objects, each describing the format of the corresponding series in the chart. To use default values for a series, specify an empty object {} . If a series or a value is not specified, the global value will be used. Each object supports the following properties:

  • color - The color to use for this series. Specify a valid HTML color string.
  • labelInLegend - The description of the series to appear in the chart legend.
  • lineWidth - Overrides the global lineWidth value for this series.
  • pointShape - Overrides the global pointShape value for this series.
  • pointSize - Overrides the global pointSize value for this series.
  • pointsVisible - Overrides the global pointsVisible value for this series.
  • visibleInLegend - A boolean value, where true means that the series should have a legend entry, and false means that it should not. Default is true .

You can specify either an array of objects, each of which applies to the series in the order given,or you can specify an object where each child has a numeric key indicating which series it applies to. For example, the following two declarations are identical, and declare the first series as black and absent from the legend, and the fourth as red and absent from the legend:

series: [
  {color: 'black', visibleInLegend: false}, {}, {},
  {color: 'red', visibleInLegend: false}
]
series: {
  0:{color: 'black', visibleInLegend: false},
  3:{color: 'red', visibleInLegend: false}
}
    
Type: Array of objects, or object with nested objects
پیش‌فرض: {}
زیرنویس

Text to display below the chart title.

Type: string
Default: no title
subtitleTextStyle

An object that specifies the title text style.

The color can be any HTML color string, for example: 'red' or '#00cc00' . Also see fontName and fontSize .

Type: object
Default: {color: 'black', fontName: <global-font-name>, fontSize: <global-font-size>}
تم

A theme is a set of predefined option values that work together to achieve a specific chart behavior or visual effect. Currently only one theme is available:

  • 'maximized' - Maximizes the area of the chart, and draws the legend and all of the labels inside the chart area.
Type: string
Default: null
عنوان

Text to display above the chart.

Type: string
Default: no title
titleTextStyle

An object that specifies the title text style. The object has this format:

{ color: <string>,
  fontName: <string>,
  fontSize: <number>,
  bold: <boolean>,
  italic: <boolean> }
    

The color can be any HTML color string, for example: 'red' or '#00cc00' . Also see fontName and fontSize .

Type: object
Default: {color: 'black', fontName: <global-font-name>, fontSize: <global-font-size>}
treatLabelsAsText

If set to true , the chart will treat the column as a text column.

Type: boolean
خطوط روند

Displays trendlines on the charts that support them. By default, linear trendlines are used, but this can be customized with the trendlines. n .type option.

Trendlines are specified on a per-series basis, so most of the time your options will look like this:

var options = {
  trendlines: {
    0: {
      type: 'linear',
      color: 'green',
      lineWidth: 3,
      opacity: 0.3,
      visibleInLegend: true
    }
  }
}
    
Type: object
Default: null
trendlines.n.color

The color of the trendline , expressed as either an English color name or a hex string.

Type: string
Default: default series color
trendlines.n.degree

For trendlines of type: 'polynomial' , the degree of the polynomial ( 2 for quadratic, 3 for cubic, and so on).

Type: number
Default: 3
trendlines.n.labelInLegend

If set, the trendline will appear in the legend as this string.

Type: string
Default: null
trendlines.n.lineWidth

The line width of the trendline , in pixels.

Type: number
پیش‌فرض: 2
trendlines.n.type

Whether the trendlines is 'linear' (the default), 'exponential' , or 'polynomial' .

Type: string
Default: linear
trendlines.n.visibleInLegend

Whether the trendline equation appears in the legend. It will appear in the trendline tooltip.

Type: boolean
پیش‌فرض: false
useFirstColumnAsDomain

If set to true , the chart will treat the column as the domain.

Type: boolean
vAxes

Specifies properties for individual vertical axes, if the chart has multiple vertical axes. Each child object is a vAxis object, and can contain all the properties supported by vAxis . These property values override any global settings for the same property.

To specify a chart with multiple vertical axes, first define a new axis using series.targetAxisIndex , then configure the axis using vAxes . The following example assigns series 2 to the right axis and specifies a custom title and text style for it:

{
  series: {
    2: {
      targetAxisIndex:1
    }
  },
  vAxes: {
    1: {
      title:'Losses',
      textStyle: {color: 'red'}
    }
  }
}
    

This property can be either an object or an array: the object is a collection of objects, each with a numeric label that specifies the axis that it defines--this is the format shown above; the array is an array of objects, one per axis. For example, the following array-style notation is identical to the vAxis object shown above:

vAxes: [
  {}, // Nothing specified for axis 0
  {
    title:'Losses',
    textStyle: {color: 'red'} // Axis 1
  }
]
    
Type: Array of object, or object with child objects
Default: null
vAxis

An object with members to configure various vertical axis elements. To specify properties of this object, you can use object literal notation, as shown here:

{title: 'Hello', titleTextStyle: {color: '#FF0000'}}
Type: object
Default: null
vAxis.direction

The direction in which the values along the vertical axis grow. By default, low values are on the bottom of the chart. Specify -1 to reverse the order of the values.

Type: 1 or -1
پیش‌فرض: 1
vAxis.gridlines

An object with members to configure the gridlines on the vertical axis. Note that vertical axis gridlines are drawn horizontally. To specify properties of this object, you can use object literal notation, as shown here:

{color: '#333', minSpacing: 20}

This option is only supported for a continuous axis.

Type: object
Default: null
vAxis.gridlines.color

The color of the vertical gridlines inside the chart area. Specify a valid HTML color string.

Type: string
Default: '#CCC'
vAxis.gridlines.count

The approximate number of horizontal gridlines inside the chart area. If you specify a positive number for gridlines.count , it will be used to compute the minSpacing between gridlines. You can specify a value of 1 to only draw one gridline, or 0 to draw no gridlines. Specify -1 , which is the default, to automatically compute the number of gridlines based on other options.

Type: number
Default: -1
vAxis.logScale

If true , makes the vertical axis a logarithmic scale. Note: All values must be positive.

Type: boolean
پیش‌فرض: false
vAxis.maxValue

Moves the max value of the vertical axis to the specified value; this will be upward in most charts. Ignored if this is set to a value smaller than the maximum y-value of the data. vAxis.viewWindow.max overrides this property.

Type: number
Default: automatic
vAxis.minorGridlines

An object with members to configure the minor gridlines on the vertical axis, similar to the vAxis.gridlines option.

Type: object
Default: null
vAxis.minorGridlines.color

The color of the vertical minor gridlines inside the chart area. Specify a valid HTML color string.

Type: string
Default: A blend of the gridline and background colors
vAxis.minorGridlines.count

The minorGridlines.count option is mostly deprecated, except for disabling minor gridlines by setting the count to 0 . The number of minor gridlines depends on the interval between major gridlines and the minimum required space.

Type: number
پیش‌فرض: 1
vAxis.minValue

Moves the min value of the vertical axis to the specified value; this will be downward in most charts. Ignored if this is set to a value greater than the minimum y-value of the data. vAxis.viewWindow.min overrides this property.

Type: number
Default: null
vAxis.textPosition

Position of the vertical axis text, relative to the chart area. Supported values: 'out' , 'in' , 'none' .

Type: string
Default: 'out'
vAxis.textStyle

An object that specifies the vertical axis text style. The object has this format:

{ color: <string>,
  fontName: <string>,
  fontSize: <number>,
  bold: <boolean>,
  italic: <boolean> }
    

The color can be any HTML color string, for example: 'red' or '#00cc00' . Also see fontName and fontSize .

Type: object
Default: {color: 'black', fontName: <global-font-name>, fontSize: <global-font-size>}
vAxis.title

Specifies a title for the vertical axis.

Type: string
Default: no title
vAxis.titleTextStyle

An object that specifies the vertical axis title text style. The object has this format:

{ color: <string>,
  fontName: <string>,
  fontSize: <number>,
  bold: <boolean>,
  italic: <boolean> }
  

The color can be any HTML color string, for example: 'red' or '#00cc00' . Also see fontName and fontSize .

Type: object
Default: {color: 'black', fontName: <global-font-name>, fontSize: <global-font-size>}
vAxis.viewWindow

Specifies the cropping range of the vertical axis.

Type: object
Default: null
vAxis.viewWindow.max

The maximum vertical data value to render.

Ignored when vAxis.viewWindowMode is 'pretty' or 'maximized'.

Type: number
Default: auto
vAxis.viewWindow.min

The minimum vertical data value to render.

Ignored when vAxis.viewWindowMode is 'pretty' or 'maximized'.

Type: number
Default: auto

Stepped area chart configuration options

نام
areaOpacity

The default opacity of the colored area under an area chart series, where 0.0 is fully transparent and 1.0 is fully opaque. To specify opacity for an individual series, set the areaOpacity value in the series property.

Type: number , 0.0- 1.0
Default: 0.3
رنگ پس‌زمینه

The background color for the main area of the chart. Can be either a simple HTML color string, for example: 'red' or '#00cc00' , or an object with the following properties.

Type: string or object
Default: 'white'
backgroundColor.fill

The chart fill color, as an HTML color string.

Type: string
Default: 'white'
chartArea

An object with members to configure the placement and size of the chart area (where the chart itself is drawn, excluding axis and legends). Two formats are supported: a number, or a number followed by %. A simple number is a value in pixels; a number followed by % is a percentage. Example: chartArea:{left:20,top:0,width:'50%',height:'75%'}

Type: object
Default: null
chartArea.backgroundColor
Chart area background color. When a string is used, it can be either a hex string (eg, '#fdc' ) or an English color name. When an object is used, the following properties can be provided:
  • stroke : The color, provided as a hex string or English color name.
  • strokeWidth : If provided, draws a border around the chart area of the given width (and with the color of stroke ).
Type: string or object
Default: 'white'
chartArea.height

Chart area height.

Type: number or string
Default: auto
chartArea.left

How far to draw the chart from the left border.

Type: number or string
Default: auto
chartArea.top

How far to draw the chart from the top border.

Type: number or string
Default: auto
chartArea.width

Chart area width.

Type: number or string
Default: auto
رنگ‌ها

The colors to use for the chart elements. An array of strings, where each element is an HTML color string, for example: colors:['red','#004411'] .

Type: Array of strings
Default: default colors
hAxis

An object with members to configure various horizontal axis elements. To specify properties of this object, you can use object literal notation, as shown here:

{
  title: 'Hello',
  titleTextStyle: {
    color: '#FF0000'
  }
}
    
Type: object
Default: null
hAxis.direction

The direction in which the values along the horizontal axis grow. Specify -1 to reverse the order of the values.

Type: 1 or -1
پیش‌فرض: 1
hAxis.textPosition

Position of the horizontal axis text, relative to the chart area. Supported values: 'out' , 'in' , 'none' .

Type: string
Default: 'out'
hAxis.textStyle

An object that specifies the horizontal axis text style. The object has this format:

{ color: <string>,
  fontName: <string>,
  fontSize: <number>,
  bold: <boolean>,
  italic: <boolean> }
    

The color can be any HTML color string, for example: 'red' or '#00cc00' . Also see fontName and fontSize .

Type: object
Default: {color: 'black', fontName: <global-font-name>, fontSize: <global-font-size>}
hAxis.title

hAxis property that specifies the title of the horizontal axis.

Type: string
Default: null
hAxis.titleTextStyle

An object that specifies the horizontal axis title text style. The object has this format:

{ color: <string>,
  fontName: <string>,
  fontSize: <number>,
  bold: <boolean>,
  italic: <boolean> }
    

The color can be any HTML color string, for example: 'red' or '#00cc00' . Also see fontName and fontSize .

Type: object
Default: {color: 'black', fontName: <global-font-name>, fontSize: <global-font-size>}
hAxis.viewWindow

Specifies the cropping range of the horizontal axis.

Type: object
Default: null
hAxis.viewWindow.max

The maximum horizontal data value to render.

Ignored when hAxis.viewWindowMode is 'pretty' or 'maximized' .

Type: number
Default: auto
hAxis.viewWindow.min

The minimum horizontal data value to render.

Ignored when hAxis.viewWindowMode is 'pretty' or 'maximized' .

Type: number
Default: auto
ارتفاع

Height of the chart in pixels.

Type: number
Default: height of the containing element
isStacked

If set to true , stacks the elements for all series at each domain value. Note: In Column , Area , and SteppedArea charts, Google Charts reverses the order of legend items to better correspond with the stacking of the series elements (Eg series 0 will be the bottom-most legend item). This does not apply to Bar Charts.

The isStacked option also supports 100% stacking, where the stacks of elements at each domain value are rescaled to add up to 100%.

The options for isStacked are:

  • false — elements will not stack. This is the default option.
  • true — stacks elements for all series at each domain value.
  • 'percent' — stacks elements for all series at each domain value and rescales them such that they add up to 100%, with each element's value calculated as a percentage of 100%.
  • 'relative' — stacks elements for all series at each domain value and rescales them such that they add up to 1, with each element's value calculated as a fraction of 1.
  • 'absolute' — functions the same as isStacked: true .

For 100% stacking, the calculated value for each element will appear in the tooltip after its actual value.

The target axis will default to tick values based on the relative 0-1 scale as fractions of 1 for 'relative' , and 0-100% for 'percent' ( Note: when using the 'percent' option, the axis/tick values are displayed as percentages, however the actual values are the relative 0-1 scale values. This is because the percentage axis ticks are the result of applying a format of "#.##%" to the relative 0-1 scale values. When using isStacked: 'percent' , be sure to specify any ticks/gridlines using the relative 0-1 scale values). You can customize the gridlines/tick values and formatting using the appropriate hAxis/vAxis options.

100% stacking only supports data values of type number , and must have a baseline of zero.

Type: boolean / string
پیش‌فرض: false
افسانه

An object with members to configure various aspects of the legend. To specify properties of this object, you can use object literal notation, as shown here:

{position: 'top', textStyle: {color: 'blue', fontSize: 16}}
Type: object
Default: null
legend.position

Position of the legend. Can be one of the following:

  • 'bottom' - Below the chart.
  • 'left' - To the left of the chart, provided the left axis has no series associated with it. So if you want the legend on the left, use the option targetAxisIndex: 1 .
  • 'in' - Inside the chart, by the top left corner.
  • 'none' - No legend is displayed.
  • 'right' - To the right of the chart. Incompatible with the vAxes option.
  • 'top' - Above the chart.
Type: string
Default: 'right'
legendTextStyle

An object that specifies the legend text style. The object has this format:

{ color: <string>,
  fontName: <string>,
  fontSize: <number>,
  bold: <boolean>,
  italic: <boolean> }
    

The color can be any HTML color string, for example: 'red' or '#00cc00' . Also see fontName and fontSize .

Type: object
Default: {color: 'black', fontName: <global-font-name>, fontSize: <global-font-size>}
reverseCategories

If set to true , draws series from right to left. The default is to draw left to right.

This option is only supported for a discrete major axis.

Type: boolean
پیش‌فرض: false
سری

An array of objects, each describing the format of the corresponding series in the chart. To use default values for a series, specify an empty object {} . If a series or a value is not specified, the global value will be used. Each object supports the following properties:

  • areaOpacity - Overrides the global areaOpacity for this series.
  • color - The color to use for this series. Specify a valid HTML color string.
  • type - The type of marker for this series. Valid values are 'line', 'area', 'bars', and 'steppedArea'. Note that bars are actually vertical bars (columns). The default value is specified by the chart's seriesType option.
  • labelInLegend - The description of the series to appear in the chart legend.
  • lineDashStyle - Overrides the global lineDashStyle value for this series.
  • targetAxisIndex - Which axis to assign this series to, where 0 is the default axis, and 1 is the opposite axis. Default value is 0 ; set to 1 to define a chart where different series are rendered against different axes. At least one series must be allocated to the default axis. You can define a different scale for different axes.
  • visibleInLegend - A boolean value, where true means that the series should have a legend entry, and false means that it should not. Default is true .

You can specify either an array of objects, each of which applies to the series in the order given, or you can specify an object where each child has a numeric key indicating which series it applies to.For example, the following two declarations are identical, and declare the first series as black and absent from the legend, and the fourth as red and absent from the legend:

series: [
  {color: 'black', visibleInLegend: false}, {}, {},
  {color: 'red', visibleInLegend: false}
]
series: {
  0:{color: 'black', visibleInLegend: false},
  3:{color: 'red', visibleInLegend: false}
}
    
Type: Array of objects, or object with nested objects
پیش‌فرض: {}
زیرنویس

Text to display below the chart title.

Type: string
Default: no title
subtitleTextStyle

An object that specifies the title text style.

The color can be any HTML color string, for example: 'red' or '#00cc00' . Also see fontName and fontSize .

Type: object
Default: {color: 'black', fontName: <global-font-name>, fontSize: <global-font-size>}
تم

A theme is a set of predefined option values that work together to achieve a specific chart behavior or visual effect. Currently only one theme is available:

  • 'maximized' - Maximizes the area of the chart, and draws the legend and all of the labels inside the chart area.
Type: string
Default: null
عنوان

Text to display above the chart.

Type: string
Default: no title
titleTextStyle

An object that specifies the title text style. The object has this format:

{ color: <string>,
  fontName: <string>,
  fontSize: <number>,
  bold: <boolean>,
  italic: <boolean> }
    

The color can be any HTML color string, for example: 'red' or '#00cc00' . Also see fontName and fontSize .

Type: object
Default: {color: 'black', fontName: <global-font-name>, fontSize: <global-font-size>}
treatLabelsAsText

If set to true , the chart will treat the column as a text column.

Type: boolean
useFirstColumnAsDomain

If set to true , the chart will treat the column as the domain.

Type: boolean
vAxes

Specifies properties for individual vertical axes, if the chart has multiple vertical axes. Each child object is a vAxis object, and can contain all the properties supported by vAxis . These property values override any global settings for the same property.

To specify a chart with multiple vertical axes, first define a new axis using series.targetAxisIndex , then configure the axis using vAxes . The following example assigns series 2 to the right axis and specifies a custom title and text style for it:

{
  series: {
    2: {
      targetAxisIndex:1
    }
  },
  vAxes: {
    1: {
      title:'Losses',
      textStyle: {color: 'red'}
    }
  }
}
    

This property can be either an object or an array: the object is a collection of objects, each with a numeric label that specifies the axis that it defines--this is the format shown above; the array is an array of objects, one per axis. For example, the following array-style notation is identical to the vAxis object shown above:

vAxes: [
  {}, // Nothing specified for axis 0
  {
    title:'Losses',
    textStyle: {color: 'red'} // Axis 1
  }
]
    
Type: Array of object, or object with child objects
Default: null
vAxis

An object with members to configure various vertical axis elements. To specify properties of this object, you can use object literal notation, as shown here:

{title: 'Hello', titleTextStyle: {color: '#FF0000'}}
Type: object
Default: null
vAxis.direction

The direction in which the values along the vertical axis grow. By default, low values are on the bottom of the chart. Specify -1 to reverse the order of the values.

Type: 1 or -1
پیش‌فرض: 1
vAxis.gridlines

An object with members to configure the gridlines on the vertical axis. Note that vertical axis gridlines are drawn horizontally. To specify properties of this object, you can use object literal notation, as shown here:

{color: '#333', minSpacing: 20}

This option is only supported for a continuous axis.

Type: object
Default: null
vAxis.gridlines.color

The color of the vertical gridlines inside the chart area. Specify a valid HTML color string.

Type: string
Default: '#CCC'
vAxis.gridlines.count

The approximate number of horizontal gridlines inside the chart area. If you specify a positive number for gridlines.count , it will be used to compute the minSpacing between gridlines. You can specify a value of 1 to only draw one gridline, or 0 to draw no gridlines. Specify -1 , which is the default, to automatically compute the number of gridlines based on other options.

Type: number
Default: -1
vAxis.logScale

If true , makes the vertical axis a logarithmic scale. Note: All values must be positive.

Type: boolean
پیش‌فرض: false
vAxis.maxValue

Moves the max value of the vertical axis to the specified value; this will be upward in most charts. Ignored if this is set to a value smaller than the maximum y-value of the data. vAxis.viewWindow.max overrides this property.

Type: number
Default: automatic
vAxis.minorGridlines

An object with members to configure the minor gridlines on the vertical axis, similar to the vAxis.gridlines option.

Type: object
Default: null
vAxis.minorGridlines.color

The color of the vertical minor gridlines inside the chart area. Specify a valid HTML color string.

Type: string
Default: A blend of the gridline and background colors
vAxis.minorGridlines.count

The minorGridlines.count option is mostly deprecated, except for disabling minor gridlines by setting the count to 0 . The number of minor gridlines depends on the interval between major gridlines and the minimum required space.

Type: number
پیش‌فرض: 1
vAxis.minValue

Moves the min value of the vertical axis to the specified value; this will be downward in most charts. Ignored if this is set to a value greater than the minimum y-value of the data. vAxis.viewWindow.min overrides this property.

Type: number
Default: null
vAxis.textPosition

Position of the vertical axis text, relative to the chart area. Supported values: 'out' , 'in' , 'none' .

Type: string
Default: 'out'
vAxis.textStyle

An object that specifies the vertical axis text style. The object has this format:

{ color: <string>,
  fontName: <string>,
  fontSize: <number>,
  bold: <boolean>,
  italic: <boolean> }
    

The color can be any HTML color string, for example: 'red' or '#00cc00' . Also see fontName and fontSize .

Type: object
Default: {color: 'black', fontName: <global-font-name>, fontSize: <global-font-size>}
vAxis.title

Specifies a title for the vertical axis.

Type: string
Default: no title
vAxis.titleTextStyle

An object that specifies the vertical axis title text style. The object has this format:

{ color: <string>,
  fontName: <string>,
  fontSize: <number>,
  bold: <boolean>,
  italic: <boolean> }
  

The color can be any HTML color string, for example: 'red' or '#00cc00' . Also see fontName and fontSize .

Type: object
Default: {color: 'black', fontName: <global-font-name>, fontSize: <global-font-size>}
vAxis.viewWindow

Specifies the cropping range of the vertical axis.

Type: object
Default: null
vAxis.viewWindow.max

The maximum vertical data value to render.

Ignored when vAxis.viewWindowMode is 'pretty' or 'maximized'.

Type: number
Default: auto
vAxis.viewWindow.min

The minimum vertical data value to render.

Ignored when vAxis.viewWindowMode is 'pretty' or 'maximized'.

Type: number
Default: auto
عرض

Width of the chart in pixels.

Type: number
Default: width of the containing element

Table chart configuration options

نام
alternatingRowStyle

Determines if an alternating color style will be assigned to odd and even rows.

Type: boolean
Default: true
ارتفاع

Height of the chart in pixels.

Type: number
Default: height of the containing element
صفحه

If and how to enable paging through the data. Choose one of the following string values:

  • 'enable' - The table will include page-forward and page-back buttons. Clicking on these buttons will perform the paging operation and change the displayed page. You might want to also set the pageSize option.
  • 'event' - The table will include page-forward and page-back buttons, but clicking them will trigger a 'page' event and will not change the displayed page. This option should be used when the code implements its own page turning logic. See the TableQueryWrapper example for an example of how to handle paging events manually.
  • 'disable' - [ Default ] Paging is not supported.
  • Type: string
    Default: 'disable'
اندازه صفحه

The number of rows in each page, when paging is enabled with the page option.

Type: number
پیش‌فرض: 10
showRowNumber

If set to true , shows the row number as the first column of the table.

Type: boolean
پیش‌فرض: false
مرتب سازی

If and how to sort columns when the user clicks a column heading. If sorting is enabled, consider setting the sortAscending and sortColumn properties as well. Choose one of the following string values:

  • 'enable' - [ Default ] Users can click on column headers to sort by the clicked column. When users click on the column header, the rows are automatically sorted, and a 'sort' event is triggered.
  • 'event' - When users click on the column header, a 'sort' event is triggered, but the rows aren't automatically sorted. This option should be used when the page implements its own sort. See the TableQueryWrapper example for an example of how to handle sorting events manually.
  • 'disable' - Clicking a column header has no effect.
Type: string
Default: 'enable'
sortAscending

The order in which the initial sort column is sorted. True for ascending, false for descending. Ignored if sortColumn is not specified.

Type: boolean
Default: true
sortColumn

An index of a column in the data table, by which the table is initially sorted. The column is marked with a small arrow indicating the sort order.

Type: number
Default: -1
عرض

Width of the chart in pixels.

Type: number
Default: width of the containing element

Timeline configuration options

نام
رنگ پس‌زمینه

The background color for the main area of the chart. Can be either a simple HTML color string, for example: 'red' or '#00cc00' , or an object with the following properties.

Type: string or object
Default: 'white'
رنگ‌ها

The colors to use for the chart elements. An array of strings, where each element is an HTML color string, for example: colors:['red','#004411'] .

Type: Array of strings
Default: default colors
ارتفاع

Height of the chart in pixels.

Type: number
Default: height of the containing element
عرض

Width of the chart in pixels.

Type: number
Default: width of the containing element

Tree map configuration options

نام
headerColor

The color of the header section for each node. Specify an HTML color value.

Type: string
Default: #988f86
maxColor

The color for a rectangle with a column 3 value of maxColorValue . Specify an HTML color value.

Type: string
Default: #00dd00
maxDepth

The maximum number of node levels to show in the current view. Levels are flattened into the current plane. If your tree has more levels than this, you must go up or down to see them. You can additionally see maxPostDepth levels below this as shaded rectangles within these nodes.

Type: number
پیش‌فرض: 1
maxPostDepth

How many levels of nodes beyond maxDepth to show in "hinted" fashion. Hinted nodes are shown as shaded rectangles within a node that is within the maxDepth limit.

Type: number
Default: 0
midColor

The color for a rectangle with a column 3 value midway between maxColorValue and minColorValue . Specify an HTML color value.

Type: string
Default: #000000
حداقل رنگ

The color for a rectangle with the column 3 value of minColorValue . Specify an HTML color value.

Type: string
Default: #dd0000
noColor

The color to use for a rectangle when a node has no value for column 3, and that node is a leaf (or contains only leaves). Specify an HTML color value.

Type: string
Default: #000000
زیرنویس

Text to display below the chart title.

Type: string
Default: no title
subtitleTextStyle

An object that specifies the title text style.

The color can be any HTML color string, for example: 'red' or '#00cc00' . Also see fontName and fontSize .

Type: object
Default: {color: 'black', fontName: <global-font-name>, fontSize: <global-font-size>}
textStyle

An object that specifies the title text style. The color can be any HTML color string, for example: 'red' or '#00cc00' . Also see fontName and fontSize.

Type: object
Default: {color: 'black', fontName: <global-font-name>, fontSize: <global-font-size>}
عنوان

Text to display above the chart.

Type: string
Default: no title
titleTextStyle

An object that specifies the title text style. The object has this format:

{ color: <string>,
  fontName: <string>,
  fontSize: <number>,
  bold: <boolean>,
  italic: <boolean> }
    

The color can be any HTML color string, for example: 'red' or '#00cc00' . Also see fontName and fontSize .

Type: object
Default: {color: 'black', fontName: <global-font-name>, fontSize: <global-font-size>}