تجسم: نمودار منطقه

• 'category' : داده های انتخاب شده را بر اساس x-value گروه بندی کنید.
• 'series' : داده های انتخاب شده را بر اساس سری گروه بندی کنید.
• 'auto' : اگر همه انتخاب‌ها دارای مقدار x یکسان باشند، داده‌های انتخاب‌شده را بر اساس x-value گروه‌بندی کنید، و در غیر این صورت براساس سری.
• 'none' : در هر انتخاب فقط یک نکته ابزار نمایش داده شود.

var options = {
  // Allow multiple
  // simultaneous selections.
  selectionMode: 'multiple',
  // Trigger tooltips
  // on selections.
  tooltip: {trigger: 'selection'},
  // Group selections
  // by x-value.
  aggregationTarget: 'category',
};
    

مدت زمان انیمیشن، بر حسب میلی ثانیه. برای جزئیات، به مستندات انیمیشن مراجعه کنید.

تابع easing برای انیمیشن اعمال می شود. گزینه های ذیل در دسترس هستند:

• "خطی" - سرعت ثابت.
• 'in' - سهولت در ورود - آهسته شروع کنید و سرعت خود را افزایش دهید.
• "خارج" - آسان کردن - سریع شروع کنید و سرعت را کاهش دهید.
• 'inAndOut' - سهولت در ورود و خروج - آهسته شروع کنید، سرعت دهید، سپس سرعت را کم کنید.

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

برای نمودارهایی که از حاشیه نویسی پشتیبانی می کنند، شی annotations.boxStyle ظاهر کادرهای اطراف حاشیه نویسی را کنترل می کند:

var options = {
  annotations: {
    boxStyle: {
      // Color of the box outline.
      stroke: '#888',
      // Thickness of the box outline.
      strokeWidth: 1,
      // x-radius of the corner curvature.
      rx: 10,
      // y-radius of the corner curvature.
      ry: 10,
      // Attributes for linear gradient fill.
      gradient: {
        // Start color for gradient.
        color1: '#fbf6a7',
        // Finish color for gradient.
        color2: '#33b679',
        // Where on the boundary to start and
        // end the color1/color2 gradient,
        // relative to the upper left corner
        // of the boundary.
        x1: '0%', y1: '0%',
        x2: '100%', y2: '100%',
        // If true, the boundary for x1,
        // y1, x2, and y2 is the box. If
        // false, it's the entire chart.
        useObjectBoundingBoxUnits: true
      }
    }
  }
};
    

این گزینه در حال حاضر برای نمودارهای ناحیه، نوار، ستون، ترکیب، خط و پراکندگی پشتیبانی می شود. توسط نمودار حاشیه نویسی پشتیبانی نمی شود.

var options = {
  annotations: {
    textStyle: {
      fontName: 'Times-Roman',
      fontSize: 18,
      bold: true,
      italic: true,
      // The color of the text.
      color: '#871b47',
      // The color of the text outline.
      auraColor: '#d799ae',
      // The transparency of the text.
      opacity: 0.8
    }
  }
};
    

این گزینه در حال حاضر برای نمودارهای ناحیه، نوار، ستون، ترکیب، خط و پراکندگی پشتیبانی می شود. توسط نمودار حاشیه نویسی پشتیبانی نمی شود.

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

محل قرار دادن عناوین محورها، در مقایسه با منطقه نمودار. مقادیر پشتیبانی شده:

• در - عناوین محورها را در داخل ناحیه نمودار رسم کنید.
• خارج - عناوین محورها را خارج از ناحیه نمودار رسم کنید.
• هیچ - عناوین محورها را حذف کنید.

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

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

عرض حاشیه، بر حسب پیکسل.

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

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

• stroke : رنگی که به صورت رشته هگزا یا رنگ انگلیسی ارائه می شود.
• strokeWidth : در صورت ارائه، یک مرز در اطراف منطقه نمودار با عرض داده شده (و با رنگ stroke ) ترسیم می کند.

چقدر می توان نمودار را از حاشیه سمت چپ رسم کرد.

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

عرض منطقه نمودار

ارتفاع منطقه نمودار

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

یک شی حاوی ویژگی های متقاطع برای نمودار.

رنگ متقاطع، که به صورت نام رنگ (مثلاً "آبی") یا یک مقدار RGB (مثلاً "#adf") بیان می شود.

یک شی حاوی ویژگی های متقاطع هنگام فوکوس.
مثال: crosshair: { focused: { color: '#3bc', opacity: 0.8 } }

تیرگی متقاطع، با 0.0 کاملاً شفاف و 1.0 کاملاً مات.

جهت گیری ضربدری، که می تواند فقط برای موهای عمودی «عمودی»، فقط برای موهای افقی «افقی» یا برای موهای متقاطع سنتی «هر دو» باشد.

یک شی حاوی ویژگی های متقاطع پس از انتخاب.
مثال: crosshair: { selected: { color: '#3bc', opacity: 0.8 } }

زمان نمایش خطوط متقاطع: روی 'focus' ، 'selection' یا 'both' .

شفافیت نقاط داده، با 1.0 کاملاً غیر شفاف و 0.0 کاملاً شفاف. در نمودارهای پراکندگی، هیستوگرام، میله ای و ستونی، این به داده های قابل مشاهده اشاره دارد: نقاط در نمودار پراکندگی و مستطیل ها در بقیه. در نمودارهایی که انتخاب داده‌ها یک نقطه ایجاد می‌کند، مانند نمودارهای خط و ناحیه، این به دایره‌هایی اطلاق می‌شود که هنگام شناور یا انتخاب ظاهر می‌شوند. نمودار ترکیبی هر دو رفتار را نشان می دهد و این گزینه روی نمودارهای دیگر تأثیری ندارد. (برای تغییر کدورت خط روند، کدورت خط روند را ببینید.)

آیا نمودار رویدادهای مبتنی بر کاربر را نشان می دهد یا به تعامل کاربر واکنش نشان می دهد. اگر نادرست باشد، نمودار «انتخاب» یا سایر رویدادهای مبتنی بر تعامل را پرتاب نمی‌کند (اما رویدادهای آماده یا خطا را پرتاب می‌کند )، و متن شناور را نمایش نمی‌دهد یا بسته به ورودی کاربر تغییر نمی‌کند.

گزینه explorer به کاربران اجازه می دهد تا نمودارهای گوگل را حرکت داده و بزرگنمایی کنند. explorer: {} رفتار کاوشگر پیش‌فرض را ارائه می‌کند و به کاربران امکان می‌دهد با کشیدن به صورت افقی و عمودی حرکت کنند و با پیمایش بزرگ‌نمایی کنند.

این ویژگی آزمایشی است و ممکن است در نسخه های بعدی تغییر کند.

توجه: کاوشگر فقط با محورهای پیوسته (مانند اعداد یا تاریخ) کار می کند.

Google Charts Explorer از سه عمل پشتیبانی می کند:

• dragToPan : برای حرکت در نمودار به صورت افقی و عمودی بکشید. برای حرکت فقط در امتداد محور افقی، از explorer: { axis: 'horizontal' } . به طور مشابه برای محور عمودی.
• dragToZoom : رفتار پیش‌فرض کاوشگر این است که وقتی کاربر اسکرول می‌کند، بزرگ‌نمایی و کوچک‌نمایی می‌کند. اگر explorer: { actions: ['dragToZoom', 'rightClickToReset'] } استفاده می شود، با کشیدن یک ناحیه مستطیلی به آن ناحیه بزرگنمایی می شود. توصیه می کنیم هر زمان که dragToZoom استفاده می شود از rightClickToReset استفاده کنید. برای سفارشی‌سازی‌های بزرگ‌نمایی، explorer.maxZoomIn ، explorer.maxZoomOut و explorer.zoomDelta را ببینید.
• rightClickToReset : کلیک راست بر روی نمودار آن را به صفحه اصلی و سطح زوم برمی گرداند.

به طور پیش فرض، کاربران می توانند در صورت استفاده از گزینه explorer ، هم به صورت افقی و هم به صورت عمودی حرکت کنند. اگر می خواهید کاربران فقط به صورت افقی حرکت کنند، از explorer: { axis: 'horizontal' } . به طور مشابه، explorer: { axis: 'vertical' } پانینگ فقط عمودی را فعال می کند.

به‌طور پیش‌فرض، کاربران می‌توانند بدون توجه به جایی که داده‌ها هستند، همه جا حرکت کنند. برای اطمینان از اینکه کاربران فراتر از نمودار اصلی حرکت نمی کنند، از explorer: { keepInBounds: true } .

حداکثری که کاوشگر می تواند بزرگنمایی کند. به طور پیش فرض، کاربران می توانند به اندازه ای بزرگنمایی کنند که فقط 25٪ از نمای اصلی را ببینند. تنظیم explorer: { maxZoomIn: .5 } به کاربران این امکان را می دهد که فقط به اندازه کافی بزرگنمایی کنند تا نیمی از نمای اصلی را ببینند.

حداکثری که کاوشگر می تواند بزرگنمایی کند. به‌طور پیش‌فرض، کاربران می‌توانند به اندازه‌ای بزرگ‌نمایی کنند که نمودار تنها 1/4 فضای موجود را اشغال کند. تنظیم explorer: { maxZoomOut: 8 } به کاربران این امکان را می دهد که به اندازه ای بزرگنمایی کنند که نمودار فقط 1/8 فضای موجود را اشغال کند.

وقتی کاربران بزرگ‌نمایی یا کوچک‌نمایی می‌کنند، explorer.zoomDelta تعیین می‌کند که چقدر بزرگ‌نمایی می‌کنند. هرچه عدد کوچکتر باشد، زوم نرمتر و کندتر است.

نوع موجودی که فوکوس را روی شناور ماوس دریافت می کند. همچنین تأثیر می گذارد که کدام موجودیت با کلیک ماوس انتخاب می شود و کدام عنصر جدول داده با رویدادها مرتبط است. می تواند یکی از موارد زیر باشد:

• 'datum' - روی یک نقطه داده واحد تمرکز کنید. با یک سلول در جدول داده ها ارتباط دارد.
• 'دسته' - بر گروه بندی تمام نقاط داده در امتداد محور اصلی تمرکز کنید. با یک ردیف در جدول داده ها ارتباط دارد.

در focusTarget 'category'، راهنمای ابزار تمام مقادیر دسته را نمایش می دهد. این ممکن است برای مقایسه مقادیر سری های مختلف مفید باشد.

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

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

نمودار را درون یک قاب درون خطی رسم می کند. (توجه داشته باشید که در IE8، این گزینه نادیده گرفته می شود؛ همه نمودارهای IE8 در i-frame ترسیم می شوند.)

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

{
  title: 'Hello',
  titleTextStyle: {
    color: '#FF0000'
  }
}
    

خط مبنا برای محور افقی.

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

رنگ خط مبنا برای محور افقی. می تواند هر رشته رنگی HTML باشد، به عنوان مثال: 'red' یا '#00cc00' .

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

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

یک رشته قالب برای برچسب های عددی یا محور تاریخ.

برای برچسب‌های محور اعداد، این زیرمجموعه‌ای از مجموعه الگوی ICU قالب‌بندی اعشاری است. برای مثال، {format:'#,###%'} مقادیر "1000%"، "750%" و "50%" را برای مقادیر 10، 7.5 و 0.5 نمایش می دهد. شما همچنین می توانید یکی از موارد زیر را تهیه کنید:

• {format: 'none'} : اعداد را بدون قالب بندی نمایش می دهد (به عنوان مثال، 8000000)
• {format: 'decimal'} : اعداد را با هزاران جداکننده نمایش می دهد (مثلاً 8,000,000)
• {format: 'scientific'} : اعداد را به صورت نماد علمی نمایش می دهد (مثلاً 8e6)
• {format: 'currency'} : اعداد را به واحد پول محلی نمایش می دهد (مثلاً 8,000,000 دلار)
• {format: 'percent'} : اعداد را به صورت درصد نمایش می دهد (به عنوان مثال، 800,000,000%)
• {format: 'short'} : نمایش اعداد مختصر (مثلاً 8M)
• {format: 'long'} : اعداد را به صورت کلمات کامل نمایش می دهد (مثلاً 8 میلیون)

برای برچسب‌های محور تاریخ، این زیرمجموعه‌ای از مجموعه الگوی ICU قالب‌بندی تاریخ است. برای مثال، {format:'MMM d, y'} مقدار "1 ژوئیه 2011" را برای تاریخ اول ژوئیه 2011 نمایش می دهد.

قالب بندی واقعی اعمال شده بر روی برچسب از محلی که API با آن بارگذاری شده است مشتق شده است. برای جزئیات بیشتر، به بارگیری نمودارها با یک منطقه خاص مراجعه کنید.

در محاسبه مقادیر تیک و خطوط شبکه، چندین ترکیب جایگزین از همه گزینه‌های خط شبکه مربوطه در نظر گرفته می‌شود و در صورت تکرار یا همپوشانی برچسب‌های تیک قالب‌بندی شده، گزینه‌های جایگزین رد خواهند شد. بنابراین اگر می‌خواهید فقط مقادیر تیک اعداد صحیح را نشان دهد، می‌توانید format:"#" را مشخص کنید، اما توجه داشته باشید که اگر هیچ جایگزینی این شرط را برآورده نکرد، هیچ خط شبکه یا تیکی نشان داده نخواهد شد.

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

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

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

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

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

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

آرایه ای از اندازه ها (به عنوان مقادیر داده، نه پیکسل) بین خطوط شبکه مجاور. این گزینه در حال حاضر فقط برای محورهای عددی است، اما مشابه گزینه های gridlines.units.<unit>.interval است که فقط برای تاریخ ها و زمان ها استفاده می شود. برای مقیاس‌های خطی، پیش‌فرض [1, 2, 2.5, 5] است که به این معنی است که مقادیر خط شبکه می‌توانند روی هر واحد (1)، روی واحدهای زوج (2)، یا مضرب‌های 2.5 یا 5 قرار گیرند. هر توان 10 برابر این مقادیر نیز در نظر گرفته می شوند (به عنوان مثال [10، 20، 25، 50] و [.1، 0.2، 0.25، 0.5]). برای مقیاس های گزارش، پیش فرض [1, 2, 5] است.

حداقل فضای صفحه نمایش، بر حسب پیکسل، بین خطوط شبکه اصلی hAxis. پیش‌فرض برای خطوط شبکه اصلی 40 برای مقیاس‌های خطی و 20 برای مقیاس‌های log است. اگر count و نه minSpacing را مشخص کنید، minSpacing از تعداد محاسبه می شود. و برعکس، اگر minSpacing و نه count مشخص کنید، تعداد از minSpacing محاسبه می‌شود. اگر هر دو را مشخص کنید، minSpacing لغو می شود.

تمام مقادیر خط شبکه و تیک باید مضربی از مقدار این گزینه باشد. توجه داشته باشید که برخلاف فواصل، توان های 10 برابر مضرب در نظر گرفته نمی شوند. بنابراین می‌توانید با مشخص کردن gridlines.multiple = 1 ، تیک‌ها را مجبور به اعداد صحیح کنید یا با تعیین gridlines.multiple = 1000 تیک‌ها را مجبور کنید مضرب 1000 باشند.

وقتی با خطوط شبکه محاسبه شده نمودار استفاده می شود، قالب پیش فرض را برای جنبه های مختلف انواع داده های تاریخ/تاریخ/زمان روز لغو می کند. امکان قالب بندی سال ها، ماه ها، روزها، ساعت ها، دقیقه ها، ثانیه ها و میلی ثانیه ها را فراهم می کند.

قالب کلی:

gridlines: {
  units: {
    years: {format: [/*format strings here*/]},
    months: {format: [/*format strings here*/]},
    days: {format: [/*format strings here*/]}
    hours: {format: [/*format strings here*/]}
    minutes: {format: [/*format strings here*/]}
    seconds: {format: [/*format strings here*/]},
    milliseconds: {format: [/*format strings here*/]},
  }
}
    

اطلاعات اضافی را می توان در تاریخ و زمان یافت.

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

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

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

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

گزینه minorGridlines.interval مانند گزینه main gridlines interval است، اما بازه ای که انتخاب می شود همیشه مقسوم علیه فاصله خط اصلی خواهد بود. فاصله پیش‌فرض برای مقیاس‌های خطی [1, 1.5, 2, 2.5, 5] و برای مقیاس‌های log [1, 2, 5] است.

حداقل فضای مورد نیاز، بر حسب پیکسل، بین خطوط شبکه کوچک مجاور، و بین خطوط شبکه فرعی و اصلی. مقدار پیش فرض 1/2 minSpacing خطوط شبکه اصلی برای مقیاس های خطی و 1/5 minSpacing برای مقیاس های log است.

مانند gridlines.multiple اصلی. چندگانه.

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

قالب کلی:

gridlines: {
  units: {
    years: {format: [/*format strings here*/]},
    months: {format: [/*format strings here*/]},
    days: {format: [/*format strings here*/]}
    hours: {format: [/*format strings here*/]}
    minutes: {format: [/*format strings here*/]}
    seconds: {format: [/*format strings here*/]},
    milliseconds: {format: [/*format strings here*/]},
  }
}
    

اطلاعات اضافی را می توان در تاریخ و زمان یافت.

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

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

ویژگی hAxis که باعث می شود محور افقی یک مقیاس لگاریتمی باشد. می تواند یکی از موارد زیر باشد:

• null - هیچ مقیاس لگاریتمی انجام نمی شود.
• "log" - مقیاس بندی لگاریتمی. مقادیر منفی و صفر رسم نمی شوند. این گزینه مانند تنظیم hAxis: { logscale: true } .
• 'mirrorLog' - مقیاس لگاریتمی که در آن مقادیر منفی و صفر رسم می شوند. مقدار رسم شده یک عدد منفی منفی لاگ قدر مطلق است. مقادیر نزدیک به 0 در مقیاس خطی رسم می شوند.

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

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

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

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

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

تیک های محور X را که به طور خودکار تولید می شوند با آرایه مشخص شده جایگزین می کند. هر عنصر آرایه باید یا یک مقدار تیک معتبر (مانند یک عدد، تاریخ، تاریخ، یا زمان روز)، یا یک شی باشد. اگر یک شی است، باید یک ویژگی v برای مقدار تیک داشته باشد، و یک ویژگی اختیاری f حاوی رشته حرفی برای نمایش به عنوان برچسب باشد.

viewWindow به طور خودکار گسترش می‌یابد تا تیک‌های حداقل و حداکثر را شامل شود، مگر اینکه یک viewWindow.min یا viewWindow.max را برای لغو تعیین کنید.

مثال ها:

• hAxis: { ticks: [5,10,15,20] }
• hAxis: { ticks: [{v:32, f:'thirty two'}, {v:64, f:'sixty four'}] }
• hAxis: { ticks: [new Date(2014,3,15), new Date(2013,5,15)] }
• hAxis: { ticks: [16, {v:32, f:'thirty two'}, {v:64, f:'sixty four'}, 128] }

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

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

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

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

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

اگر نادرست باشد، خارجی‌ترین برچسب‌ها را پنهان می‌کند نه اینکه اجازه می‌دهد توسط ظرف نمودار برش داده شوند. اگر درست باشد، برش برچسب مجاز است.

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

اگر درست است، متن محور افقی را با زاویه بکشید تا به جا دادن متن بیشتر در امتداد محور کمک کند. اگر نادرست است، متن محور افقی را به صورت عمودی بکشید. رفتار پیش‌فرض عبارت است از کج کردن متن در صورتی که وقتی به صورت عمودی ترسیم می‌شود، همه آن جا نمی‌شوند. توجه داشته باشید که این گزینه فقط زمانی در دسترس است که hAxis.textPosition روی "out" (که پیش فرض است) تنظیم شده باشد. پیش فرض برای تاریخ و زمان false است.

زاویه متن محور افقی، اگر به صورت مایل کشیده شده باشد. اگر hAxis.slantedText false باشد یا در حالت خودکار باشد نادیده گرفته می‌شود و نمودار تصمیم می‌گیرد متن را به صورت افقی ترسیم کند. اگر زاویه مثبت باشد، چرخش در خلاف جهت عقربه های ساعت و اگر منفی باشد، در جهت عقربه های ساعت است.

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

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

حداقل فاصله افقی، بر حسب پیکسل، بین دو برچسب متنی مجاور مجاز است. اگر فاصله بین برچسب‌ها خیلی متراکم باشد یا خیلی طولانی باشد، فاصله می‌تواند به زیر این آستانه کاهش یابد و در این مورد یکی از اقدامات عدم شلوغی برچسب اعمال می‌شود (مثلاً کوتاه کردن برچسب‌ها یا انداختن برخی از آنها).

چند برچسب محور افقی برای نشان دادن، که در آن 1 به معنای نشان دادن هر برچسب، 2 به معنای نشان دادن هر برچسب دیگر و غیره است. پیش‌فرض این است که سعی کنید تا حد ممکن برچسب‌ها را بدون همپوشانی نشان دهید.

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

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

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

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

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

• 'pretty' - مقادیر افقی را به گونه ای مقیاس دهید که مقادیر حداکثر و حداقل داده اندکی در سمت چپ و راست ناحیه نمودار نمایش داده شوند. ViewWindow برای اعداد به نزدیکترین خط شبکه اصلی یا برای تاریخ و زمان به نزدیکترین خط شبکه کوچک گسترش می یابد.
• "بیشینه سازی" - مقادیر افقی را به گونه ای تنظیم کنید که حداکثر و حداقل مقادیر داده، سمت چپ و راست ناحیه نمودار را لمس کنند. این باعث می شود که haxis.viewWindow.min و haxis.viewWindow.max نادیده گرفته شوند.
• 'explicit' - یک گزینه منسوخ برای تعیین مقادیر مقیاس چپ و راست ناحیه نمودار. (منسوخ شده است زیرا با haxis.viewWindow.min و haxis.viewWindow.max اضافی است.) مقادیر داده خارج از این مقادیر برش داده می شوند. شما باید یک شی hAxis.viewWindow را تعیین کنید که مقادیر حداکثر و حداقل را برای نمایش توصیف می کند.

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

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

• برای یک محور continuous :

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

• برای یک محور discrete :

  شاخص ردیف مبتنی بر صفر که در آن پنجره برش به پایان می رسد. نقاط داده در این شاخص و بالاتر حذف خواهند شد. در ارتباط با vAxis.viewWindowMode.min ، یک محدوده نیمه باز [min، max) را تعریف می کند که نشان دهنده شاخص های عنصر برای نمایش است. به عبارت دیگر، هر شاخص به گونه ای که min <= index < max نمایش داده می شود.

وقتی hAxis.viewWindowMode 'زیبا' یا 'بیشینه شده' است نادیده گرفته می شود.

• برای یک محور continuous :

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

• برای یک محور discrete :

  شاخص ردیف مبتنی بر صفر که در آن پنجره برش شروع می شود. نقاط داده در شاخص های پایین تر از این برش داده می شوند. در ارتباط با vAxis.viewWindowMode.max ، یک محدوده نیمه باز [min, max) تعریف می کند که نشان دهنده شاخص های عنصر برای نمایش است. به عبارت دیگر، هر شاخص به گونه ای که min <= index < max نمایش داده می شود.

وقتی hAxis.viewWindowMode 'زیبا' یا 'بیشینه شده' است نادیده گرفته می شود.

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

اینکه آیا ارزش امتیازهای از دست رفته را حدس بزنید. اگر درست باشد، ارزش هر داده از دست رفته را بر اساس نقاط همسایه حدس می زند. اگر نادرست باشد، در نقطه ناشناخته یک شکست در خط ایجاد می کند.

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

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

گزینه isStacked همچنین از انباشته شدن 100% پشتیبانی می کند، که در آن پشته های عناصر در هر مقدار دامنه تغییر مقیاس داده می شوند تا به 100% اضافه شوند.

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

• false - عناصر روی هم قرار نمی گیرند. این گزینه ی پیش فرض می باشد.
• true - عناصر را برای همه سری ها در هر مقدار دامنه پشته می کند.
• 'percent' - عناصر را برای همه سری ها در هر مقدار دامنه روی هم می چیند و آنها را طوری تغییر می دهد که تا 100% جمع شوند و مقدار هر عنصر به صورت درصدی 100% محاسبه شود.
• 'relative' - عناصر را برای همه سری ها در هر مقدار دامنه روی هم قرار می دهد و آنها را به گونه ای تغییر می دهد که جمع آنها به 1 برسد و مقدار هر عنصر به عنوان کسری از 1 محاسبه شود.
• 'absolute' - عملکردی مشابه isStacked: true .

برای انباشته شدن 100%، مقدار محاسبه شده برای هر عنصر پس از مقدار واقعی آن در راهنمای ابزار ظاهر می شود.

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

انباشته شدن 100% فقط از مقادیر داده نوع number پشتیبانی می کند و باید خط پایه صفر داشته باشد.

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

{position: 'top', textStyle: {color: 'blue', fontSize: 16}}

تراز افسانه. می تواند یکی از موارد زیر باشد:

• 'شروع' - با شروع منطقه اختصاص داده شده برای افسانه تراز شده است.
• "مرکز" - در مرکز منطقه اختصاص داده شده برای افسانه.
• "پایان" - در انتهای ناحیه اختصاص داده شده برای افسانه تراز شده است.

شروع، مرکز و پایان نسبت به سبک - عمودی یا افقی - افسانه است. برای مثال، در افسانه «راست»، «شروع» و «پایان» به ترتیب در بالا و پایین هستند. برای افسانه "بالا"، "شروع" و "پایان" به ترتیب در سمت چپ و راست منطقه قرار می گیرند.

مقدار پیش فرض به موقعیت افسانه بستگی دارد. برای افسانه‌های «پایین»، پیش‌فرض «مرکز» است. افسانه های دیگر به طور پیش فرض "شروع" هستند.

حداکثر تعداد خطوط در افسانه. این را روی عددی بزرگتر از یک تنظیم کنید تا خطوطی به افسانه خود اضافه کنید. توجه: منطق دقیق مورد استفاده برای تعیین تعداد واقعی خطوط ارائه شده هنوز در جریان است.

این گزینه در حال حاضر فقط زمانی کار می کند که legend.position 'بالا' باشد.

فهرست اولیه صفحه بر اساس صفر انتخاب شده از افسانه.

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

• "پایین" - زیر نمودار.
• "چپ" - در سمت چپ نمودار، مشروط بر اینکه محور چپ هیچ سری مرتبط با آن نداشته باشد. بنابراین اگر افسانه سمت چپ را می خواهید، از گزینه targetAxisIndex: 1 استفاده کنید.
• 'in' - در داخل نمودار، در گوشه سمت چپ بالا.
• "هیچ" - هیچ افسانه ای نمایش داده نمی شود.
• "راست" - در سمت راست نمودار. با گزینه vAxes ناسازگار است.
• "بالا" - بالای نمودار.

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

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

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

الگوی روشن و خاموش برای خطوط چین. به عنوان مثال، [4, 4] خط تیره های 4 طول و به دنبال آن شکاف های 4 طول را تکرار می کند، و [5, 1, 3] یک خط تیره 5 طول، یک فاصله 1 طول، یک فاصله 3 طول، یک خط تیره را تکرار می کند. فاصله 5 طول، فاصله 1 طول و فاصله 3 طول. برای اطلاعات بیشتر به خطوط چین مراجعه کنید.

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

جهت گیری نمودار. وقتی روی 'vertical' تنظیم می شود، محورهای نمودار را می چرخاند تا (به عنوان مثال) نمودار ستونی به نمودار میله ای تبدیل شود و نمودار ناحیه به جای بالا به سمت راست رشد کند:

شکل تک تک عناصر داده: «دایره»، «مثلث»، «مربع»، «الماس»، «ستاره» یا «چند ضلعی». برای مثال به مستندات امتیاز مراجعه کنید.

قطر نقاط نمایش داده شده بر حسب پیکسل از صفر برای پنهان کردن تمام نقاط استفاده کنید. با استفاده از ویژگی series می توانید مقادیر را برای سری های جداگانه لغو کنید. اگر از خط روند استفاده می‌کنید، گزینه pointSize بر عرض خط روند تأثیر می‌گذارد مگر اینکه آن را با گزینه trendlines.n.pointsize لغو کنید.

تعیین می کند که آیا نقاط نمایش داده می شوند یا خیر. برای پنهان کردن تمام نقاط، روی false تنظیم کنید. با استفاده از ویژگی series می توانید مقادیر را برای سری های جداگانه لغو کنید. اگر از خط روند استفاده می‌کنید، گزینه pointsVisible روی دید نقاط روی همه خطوط روند تأثیر می‌گذارد، مگر اینکه آن را با گزینه trendlines.n.pointsVisible لغو کنید.

این را می توان با استفاده از نقش سبک به شکل "point {visible: true}" لغو کرد.

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

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

وقتی selectionMode 'multiple' است، کاربران ممکن است چندین نقطه داده را انتخاب کنند.

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

• 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 - یک مقدار بولی، که در آن true به این معنی است که سری باید یک ورودی افسانه داشته باشد و false به این معنی است که نباید. پیش فرض درست است.

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

series: [
  {color: 'black', visibleInLegend: false}, {}, {},
  {color: 'red', visibleInLegend: false}
]
series: {
  0:{color: 'black', visibleInLegend: false},
  3:{color: 'red', visibleInLegend: false}
}
    

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

• 'maximized' - مساحت نمودار را به حداکثر می رساند و افسانه و همه برچسب ها را در داخل منطقه نمودار ترسیم می کند. گزینه های زیر را تنظیم می کند:

  chartArea: {width: '100%', height: '100%'},
  legend: {position: 'in'},
  titlePosition: 'in', axisTitlesPosition: 'in',
  hAxis: {textPosition: 'in'}, vAxis: {textPosition: 'in'}
          

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

محل قرار دادن عنوان نمودار، در مقایسه با منطقه نمودار. مقادیر پشتیبانی شده:

• در - عنوان را داخل ناحیه نمودار بکشید.
• بیرون - عنوان را خارج از ناحیه نمودار بکشید.
• هیچ - عنوان را حذف کنید.

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

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

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

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

{textStyle: {color: '#FF0000'}, showColorCode: true}

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

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

اگر روی true تنظیم شده باشد، از نکات ابزار رندر شده HTML (به جای SVG) استفاده کنید. برای جزئیات بیشتر به سفارشی کردن محتوای راهنمای ابزار مراجعه کنید.

توجه: سفارشی‌سازی محتوای راهنمای ابزار HTML از طریق نقش داده ستون راهنمای ابزار توسط تجسم نمودار حباب پشتیبانی نمی‌شود .

اگر درست است، مربع های رنگی را در کنار اطلاعات سری در راهنمای ابزار نشان دهید. پیش‌فرض زمانی درست است که focusTarget روی «دسته» تنظیم شده باشد، در غیر این صورت پیش‌فرض نادرست است.

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

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

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

تعامل کاربر که باعث می شود راهنمای ابزار نمایش داده شود:

• 'focus' - وقتی کاربر روی عنصر قرار می گیرد، راهنمای ابزار نمایش داده می شود.
• 'none' - راهنمای ابزار نمایش داده نخواهد شد.
• 'انتخاب' - وقتی کاربر عنصر را انتخاب می کند، راهنمای ابزار نمایش داده می شود.

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

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

{
  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
  }
]
    

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

{title: 'Hello', titleTextStyle: {color: '#FF0000'}}

ویژگی vAxis که خط مبنا را برای محور عمودی مشخص می کند. اگر خط مبنا بزرگتر از بالاترین خط شبکه یا کوچکتر از پایین ترین خط شبکه باشد، به نزدیکترین خط شبکه گرد می شود.

رنگ خط مبنا را برای محور عمودی مشخص می کند. می تواند هر رشته رنگی HTML باشد، به عنوان مثال: 'red' یا '#00cc00' .

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

یک رشته قالب برای برچسب های محورهای عددی. این زیر مجموعه ای از الگوی ICU است. برای مثال، {format:'#,###%'} مقادیر "1000%"، "750%" و "50%" را برای مقادیر 10، 7.5 و 0.5 نمایش می دهد. شما همچنین می توانید یکی از موارد زیر را تهیه کنید:

• {format: 'none'} : اعداد را بدون قالب بندی نمایش می دهد (به عنوان مثال، 8000000)
• {format: 'decimal'} : اعداد را با هزاران جداکننده نمایش می دهد (مثلاً 8,000,000)
• {format: 'scientific'} : اعداد را به صورت نماد علمی نمایش می دهد (مثلاً 8e6)
• {format: 'currency'} : اعداد را به واحد پول محلی نمایش می دهد (مثلاً 8,000,000 دلار)
• {format: 'percent'} : اعداد را به صورت درصد نمایش می دهد (به عنوان مثال، 800,000,000%)
• {format: 'short'} : نمایش اعداد مختصر (مثلاً 8M)
• {format: 'long'} : اعداد را به صورت کلمات کامل نمایش می دهد (مثلاً 8 میلیون)

قالب بندی واقعی اعمال شده بر روی برچسب از محلی که API با آن بارگذاری شده است مشتق شده است. برای جزئیات بیشتر، به بارگیری نمودارها با یک منطقه خاص مراجعه کنید.

در محاسبه مقادیر تیک و خطوط شبکه، چندین ترکیب جایگزین از همه گزینه‌های خط شبکه مربوطه در نظر گرفته می‌شود و در صورت تکرار یا همپوشانی برچسب‌های تیک قالب‌بندی شده، گزینه‌های جایگزین رد خواهند شد. بنابراین اگر می‌خواهید فقط مقادیر تیک اعداد صحیح را نشان دهد، می‌توانید format:"#" را مشخص کنید، اما توجه داشته باشید که اگر هیچ جایگزینی این شرط را برآورده نکرد، هیچ خط شبکه یا تیکی نشان داده نخواهد شد.

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

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

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

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

آرایه ای از اندازه ها (به عنوان مقادیر داده، نه پیکسل) بین خطوط شبکه مجاور. این گزینه در حال حاضر فقط برای محورهای عددی است، اما مشابه گزینه های gridlines.units.<unit>.interval است که فقط برای تاریخ ها و زمان ها استفاده می شود. برای مقیاس‌های خطی، پیش‌فرض [1, 2, 2.5, 5] است که به این معنی است که مقادیر خط شبکه می‌توانند روی هر واحد (1)، روی واحدهای زوج (2)، یا مضرب‌های 2.5 یا 5 قرار گیرند. هر توان 10 برابر این مقادیر نیز در نظر گرفته می شوند (به عنوان مثال [10، 20، 25، 50] و [.1، 0.2، 0.25، 0.5]). برای مقیاس های گزارش، پیش فرض [1, 2, 5] است.

حداقل فضای صفحه نمایش، بر حسب پیکسل، بین خطوط شبکه اصلی hAxis. پیش‌فرض برای خطوط شبکه اصلی 40 برای مقیاس‌های خطی و 20 برای مقیاس‌های log است. اگر count و نه minSpacing را مشخص کنید، minSpacing از تعداد محاسبه می شود. و برعکس، اگر minSpacing و نه count مشخص کنید، تعداد از minSpacing محاسبه می‌شود. اگر هر دو را مشخص کنید، minSpacing لغو می شود.

تمام مقادیر خط شبکه و تیک باید مضربی از مقدار این گزینه باشد. توجه داشته باشید که برخلاف فواصل، توان های 10 برابر مضرب در نظر گرفته نمی شوند. بنابراین می‌توانید با مشخص کردن gridlines.multiple = 1 ، تیک‌ها را مجبور به اعداد صحیح کنید یا با تعیین gridlines.multiple = 1000 تیک‌ها را مجبور کنید مضرب 1000 باشند.

وقتی با خطوط شبکه محاسبه شده نمودار استفاده می شود، قالب پیش فرض را برای جنبه های مختلف انواع داده های تاریخ/تاریخ/زمان روز لغو می کند. امکان قالب بندی سال ها، ماه ها، روزها، ساعت ها، دقیقه ها، ثانیه ها و میلی ثانیه ها را فراهم می کند.

قالب کلی:

gridlines: {
  units: {
    years: {format: [/*format strings here*/]},
    months: {format: [/*format strings here*/]},
    days: {format: [/*format strings here*/]},
    hours: {format: [/*format strings here*/]},
    minutes: {format: [/*format strings here*/]},
    seconds: {format: [/*format strings here*/]},
    milliseconds: {format: [/*format strings here*/]}
  }
}
    

اطلاعات اضافی را می توان در تاریخ و زمان یافت.

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

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

گزینه minorGridlines.interval مانند گزینه main gridlines interval است، اما بازه ای که انتخاب می شود همیشه مقسوم علیه فاصله خط اصلی خواهد بود. فاصله پیش‌فرض برای مقیاس‌های خطی [1, 1.5, 2, 2.5, 5] و برای مقیاس‌های log [1, 2, 5] است.

حداقل فضای مورد نیاز، بر حسب پیکسل، بین خطوط شبکه کوچک مجاور، و بین خطوط شبکه فرعی و اصلی. مقدار پیش فرض 1/2 minSpacing خطوط شبکه اصلی برای مقیاس های خطی و 1/5 minSpacing برای مقیاس های log است.

مانند gridlines.multiple اصلی. چندگانه.

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

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

قالب کلی:

gridlines: {
  units: {
    years: {format: [/*format strings here*/]},
    months: {format: [/*format strings here*/]},
    days: {format: [/*format strings here*/]}
    hours: {format: [/*format strings here*/]}
    minutes: {format: [/*format strings here*/]}
    seconds: {format: [/*format strings here*/]},
    milliseconds: {format: [/*format strings here*/]},
  }
}
    

اطلاعات اضافی را می توان در تاریخ و زمان یافت.

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

ویژگی vAxis که باعث می شود محور عمودی یک مقیاس لگاریتمی باشد. می تواند یکی از موارد زیر باشد:

• null - هیچ مقیاس لگاریتمی انجام نمی شود.
• "log" - مقیاس بندی لگاریتمی. مقادیر منفی و صفر رسم نمی شوند. این گزینه مانند تنظیم vAxis: { logscale: true } .
• 'mirrorLog' - مقیاس لگاریتمی که در آن مقادیر منفی و صفر رسم می شوند. مقدار رسم شده یک عدد منفی منفی لاگ قدر مطلق است. مقادیر نزدیک به 0 در مقیاس خطی رسم می شوند.

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

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

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

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

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

تیک های محور Y را که به طور خودکار تولید می شوند با آرایه مشخص شده جایگزین می کند. هر عنصر آرایه باید یا یک مقدار تیک معتبر (مانند یک عدد، تاریخ، تاریخ، یا زمان روز)، یا یک شی باشد. اگر یک شی است، باید یک ویژگی v برای مقدار تیک داشته باشد، و یک ویژگی اختیاری f حاوی رشته حرفی برای نمایش به عنوان برچسب باشد.

viewWindow به طور خودکار گسترش می‌یابد تا تیک‌های حداقل و حداکثر را شامل شود، مگر اینکه یک viewWindow.min یا viewWindow.max را برای لغو تعیین کنید.

مثال ها:

• vAxis: { ticks: [5,10,15,20] }
• vAxis: { ticks: [{v:32, f:'thirty two'}, {v:64, f:'sixty four'}] }
• vAxis: { ticks: [new Date(2014,3,15), new Date(2013,5,15)] }
• vAxis: { ticks: [16, {v:32, f:'thirty two'}, {v:64, f:'sixty four'}, 128] }

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

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

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

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

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

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

نحوه مقیاس بندی محور عمودی برای ارائه مقادیر در ناحیه نمودار را مشخص می کند. مقادیر رشته زیر پشتیبانی می شوند:

• 'pretty' - مقادیر عمودی را به گونه ای مقیاس دهید که حداکثر و حداقل مقادیر داده اندکی در پایین و بالای ناحیه نمودار ارائه شوند. ViewWindow برای اعداد به نزدیکترین خط شبکه اصلی یا برای تاریخ و زمان به نزدیکترین خط شبکه کوچک گسترش می یابد.
• "بیشینه سازی" - مقادیر عمودی را به گونه ای مقیاس دهید که حداکثر و حداقل مقادیر داده، بالا و پایین ناحیه نمودار را لمس کنند. این باعث می شود که vaxis.viewWindow.min و vaxis.viewWindow.max نادیده گرفته شوند.
• 'explicit' - یک گزینه منسوخ برای تعیین مقادیر مقیاس بالا و پایین ناحیه نمودار. (منسوخ شده است زیرا با vaxis.viewWindow.min و vaxis.viewWindow.max اضافی است. مقادیر داده خارج از این مقادیر بریده می شوند. شما باید یک شی vAxis.viewWindow را تعیین کنید که حداکثر و حداقل مقادیر را برای نمایش توضیح دهد.

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

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

هنگامی که vAxis.viewWindowMode 'زیبا' یا 'بیشینه شده' است نادیده گرفته می شود.

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

هنگامی که vAxis.viewWindowMode 'زیبا' یا 'بیشینه شده' است نادیده گرفته می شود.

عرض نمودار، بر حسب پیکسل.

نمودار را رسم می کند. نمودار فراخوانی های متد بیشتر را فقط پس از فعال شدن رویداد ready می پذیرد. Extended description

شی عمل راهنمای tooltip را با actionID درخواستی برمی گرداند.

یک شی شامل سمت چپ، بالا، عرض و ارتفاع id عنصر نمودار را برمی‌گرداند. قالب id هنوز مستند نشده است (آنها مقادیر بازگشتی کنترل کننده رویداد هستند)، اما در اینجا چند نمونه وجود دارد:

var cli = chart.getChartLayoutInterface();

ارتفاع منطقه نمودار

cli.getBoundingBox('chartarea').height

عرض میله سوم در سری اول نمودار میله ای یا ستونی

cli.getBoundingBox('bar#0#2').width

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

cli.getBoundingBox('slice#4')

کادر مرزی داده های نمودار یک نمودار عمودی (مثلاً ستونی):

cli.getBoundingBox('vAxis#0#gridline')

کادر مرزی داده های نمودار یک نمودار افقی (مثلاً میله ای):

cli.getBoundingBox('hAxis#0#gridline')

مقادیر نسبت به ظرف نمودار هستند. بعد از ترسیم نمودار این را صدا بزنید.

یک شی شامل سمت چپ، بالا، عرض و ارتفاع محتوای نمودار را برمی‌گرداند (یعنی به استثنای برچسب‌ها و افسانه‌ها):

var cli = chart.getChartLayoutInterface();

cli.getChartAreaBoundingBox().left

cli.getChartAreaBoundingBox().top

cli.getChartAreaBoundingBox().height

cli.getChartAreaBoundingBox().width

مقادیر نسبت به ظرف نمودار هستند. بعد از ترسیم نمودار این را صدا بزنید.

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

متدهای زیر را می توان بر روی شی برگشتی فراخوانی کرد:

• getBoundingBox
• getChartAreaBoundingBox
• getHAxisValue
• getVAxisValue
• getXLocation
• getYLocation

بعد از ترسیم نمودار این را صدا بزنید.

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

مثال: chart.getChartLayoutInterface().getHAxisValue(400) .

بعد از ترسیم نمودار این را صدا بزنید.

نمودار را به صورت سریال URI تصویر برمی‌گرداند.

بعد از ترسیم نمودار این را صدا بزنید.

چاپ نمودارهای PNG را ببینید.

آرایه ای از موجودیت های نمودار انتخاب شده را برمی گرداند. موجودیت های قابل انتخاب نقاط، حاشیه نویسی، ورودی های افسانه و دسته ها هستند. یک نقطه یا حاشیه نویسی مربوط به یک سلول در جدول داده، یک ورودی افسانه به یک ستون (شاخص ردیف خالی است)، و یک دسته به یک ردیف (شاخص ستون تهی است). برای این نمودار، در هر لحظه می توان تنها یک موجودیت را انتخاب کرد. Extended description

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

مثال: chart.getChartLayoutInterface().getVAxisValue(300) .

بعد از ترسیم نمودار این را صدا بزنید.

مختصات x پیکسل dataValue را نسبت به لبه سمت چپ ظرف نمودار برمی‌گرداند.

مثال: chart.getChartLayoutInterface().getXLocation(400) .

بعد از ترسیم نمودار این را صدا بزنید.

مختصات پیکسل y dataValue را نسبت به لبه بالای محفظه نمودار برمی‌گرداند.

مثال: chart.getChartLayoutInterface().getYLocation(300) .

بعد از ترسیم نمودار این را صدا بزنید.

عملکرد راهنمای ابزار با actionID درخواستی را از نمودار حذف می کند.

زمانی که کاربر روی متن اقدام کلیک می‌کند، یک عمل راهنمای ابزار را تنظیم می‌کند.

متد setAction یک شی را به عنوان پارامتر عمل خود می گیرد. این شی باید 3 ویژگی را مشخص کند: id - شناسه عملکرد در حال تنظیم، text - متنی که باید در راهنمای عمل نمایش داده شود و action - عملکردی که باید هنگام کلیک کردن کاربر روی متن عمل اجرا شود.

قبل از فراخوانی متد رسم نمودار draw() هر و همه اقدامات راهنمای ابزار باید تنظیم شوند. توضیحات گسترده

موجودیت های نمودار مشخص شده را انتخاب می کند. هر انتخاب قبلی را لغو می کند. موجودیت های قابل انتخاب نقاط، حاشیه نویسی، ورودی های افسانه و دسته ها هستند. یک نقطه یا حاشیه نویسی مربوط به یک سلول در جدول داده، یک ورودی افسانه به یک ستون (شاخص ردیف خالی است)، و یک دسته به یک ردیف (شاخص ستون تهی است). برای این نمودار، تنها یک موجودیت را می توان در یک زمان انتخاب کرد. Extended description

نمودار را پاک می کند و تمام منابع اختصاص داده شده آن را آزاد می کند.

هنگامی که انیمیشن انتقال کامل شد فعال می شود.

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

هنگامی که هنگام تلاش برای ارائه نمودار، خطایی رخ می دهد، فعال می شود.

هنگامی که کاربر روی فلش های صفحه بندی افسانه کلیک می کند فعال می شود. نمایه صفحه مبتنی بر صفر افسانه فعلی و تعداد کل صفحات را به عقب پس می دهد.

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

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

نمودار برای تماس های متد خارجی آماده است. اگر می‌خواهید با نمودار تعامل داشته باشید و پس از ترسیم روش‌ها را فراخوانی کنید، باید قبل از فراخوانی متد draw ، شنونده‌ای برای این رویداد تنظیم کنید و تنها پس از فعال شدن رویداد، آنها را فراخوانی کنید.

هنگامی که کاربر روی یک موجودیت بصری کلیک می کند فعال می شود. برای اطلاع از آنچه انتخاب شده است، getSelection() را فراخوانی کنید.