سازنده نمودارهای میله ای برای جزئیات بیشتر، به مستندات نمودارهای Google مراجعه کنید.
در اینجا مثالی آورده شده است که نحوه ساخت نمودار میله ای را نشان می دهد. داده‌ها از صفحه‌گسترده Google وارد می‌شوند .
// Get sample data from a spreadsheet.
var dataSourceUrl = 'https://docs.google.com/spreadsheet/tq?range=B1%3AC11' +
'&key=0Aq4s9w_HxMs7dHpfX05JdmVSb1FpT21sbXd4NVE3UEE&gid=0&headers=-1';
var chartBuilder = Charts.newBarChart()
.setTitle('Top Grossing Films in US and Canada')
.setXAxisTitle('USD')
.setYAxisTitle('Film')
.setDimensions(600, 500)
.setLegendPosition(Charts.Position.BOTTOM)
.setDataSourceUrl(dataSourceUrl);
var chart = chartBuilder.build();مواد و روش ها
| روش | نوع برگشت | توضیح مختصر |
|---|---|---|
build() | Chart | نمودار را می سازد. |
reverseCategories() | BarChartBuilder | رسم سری ها را در محور دامنه معکوس می کند. |
reverseDirection() | BarChartBuilder | جهت رشد میله ها را در امتداد محور افقی معکوس می کند. |
setBackgroundColor(cssValue) | BarChartBuilder | رنگ پس زمینه نمودار را تنظیم می کند. |
setColors(cssValues) | BarChartBuilder | رنگ ها را برای خطوط در نمودار تنظیم می کند. |
setDataSourceUrl(url) | BarChartBuilder | URL منبع داده را تنظیم می کند که برای وارد کردن داده ها از یک منبع خارجی مانند Google Sheets استفاده می شود. |
setDataTable(tableBuilder) | BarChartBuilder | جدول داده را برای استفاده برای نمودار با استفاده از DataTableBuilder تنظیم می کند. |
setDataTable(table) | BarChartBuilder | جدول داده ای را که شامل خطوط نمودار و همچنین برچسب های محور X است را تنظیم می کند. |
setDataViewDefinition(dataViewDefinition) | BarChartBuilder | تعریف نمای داده را برای استفاده برای نمودار تنظیم می کند. |
setDimensions(width, height) | BarChartBuilder | ابعاد نمودار را تعیین می کند. |
setLegendPosition(position) | BarChartBuilder | موقعیت افسانه را با توجه به نمودار تنظیم می کند. |
setLegendTextStyle(textStyle) | BarChartBuilder | سبک متن افسانه نمودار را تنظیم می کند. |
setOption(option, value) | BarChartBuilder | گزینه های پیشرفته را برای این نمودار تنظیم می کند. |
setRange(start, end) | BarChartBuilder | محدوده را برای نمودار تنظیم می کند. |
setStacked() | BarChartBuilder | از خطوط انباشته شده استفاده می کند، به این معنی که مقادیر خط و نوار روی هم انباشته شده اند. |
setTitle(chartTitle) | BarChartBuilder | عنوان نمودار را تعیین می کند. |
setTitleTextStyle(textStyle) | BarChartBuilder | سبک متن عنوان نمودار را تنظیم می کند. |
setXAxisTextStyle(textStyle) | BarChartBuilder | سبک متن محور افقی را تنظیم می کند. |
setXAxisTitle(title) | BarChartBuilder | عنوانی را به محور افقی اضافه می کند. |
setXAxisTitleTextStyle(textStyle) | BarChartBuilder | سبک متن عنوان محور افقی را تنظیم می کند. |
setYAxisTextStyle(textStyle) | BarChartBuilder | سبک متن محور عمودی را تنظیم می کند. |
setYAxisTitle(title) | BarChartBuilder | عنوانی را به محور عمودی اضافه می کند. |
setYAxisTitleTextStyle(textStyle) | BarChartBuilder | سبک متن عنوان محور عمودی را تنظیم می کند. |
useLogScale() | BarChartBuilder | محور دامنه را به یک مقیاس لگاریتمی تبدیل می کند (به مثبت بودن همه مقادیر نیاز دارد). |
مستندات دقیق
build()
نمودار را می سازد.
برگشت
Chart - یک شی نمودار، که می تواند در اسناد، عناصر رابط کاربری جاسازی شود یا به عنوان یک تصویر ثابت استفاده شود.
reverseCategories()
رسم سری ها را در محور دامنه معکوس می کند. برای نمودارهای با برد عمودی (مانند نمودارهای خط، ناحیه یا ستون)، این بدان معناست که محور افقی از راست به چپ ترسیم شده است. برای نمودارهای با دامنه افقی (مانند نمودارهای میله ای)، این بدان معنی است که محور عمودی از بالا به پایین ترسیم می شود. برای نمودار دایره ای، این بدان معناست که برش ها در خلاف جهت عقربه های ساعت کشیده می شوند.
// Creates a pie chart builder and sets drawing of the slices in a counter-clockwise manner. var builder = Charts.newPieChart(); builder.reverseCategories();
برگشت
BarChartBuilder - این سازنده، برای زنجیره‌سازی مفید است.
reverseDirection()
جهت رشد میله ها را در امتداد محور افقی معکوس می کند. به طور پیش فرض، مقادیر از چپ به راست رشد می کنند. فراخوانی این روش باعث رشد آنها از راست به چپ می شود.
برگشت
BarChartBuilder - این سازنده، برای زنجیره‌سازی مفید است.
setBackgroundColor(cssValue)
رنگ پس زمینه نمودار را تنظیم می کند.
// Creates a line chart builder and sets the background color to gray
var builder = Charts.newLineChart();
builder.setBackgroundColor("gray");مولفه های
| نام | تایپ کنید | شرح |
|---|---|---|
cssValue | String | مقدار CSS برای رنگ (مانند "blue" یا "#00f" ). |
برگشت
BarChartBuilder - این سازنده، برای زنجیره‌سازی مفید است.
setColors(cssValues)
رنگ ها را برای خطوط در نمودار تنظیم می کند.
// Creates a line chart builder and sets the first two lines to be drawn in green and red, // respectively. var builder = Charts.newLineChart(); builder.setColors(["green", "red"]);
مولفه های
| نام | تایپ کنید | شرح |
|---|---|---|
cssValues | String[] | آرایه ای از مقادیر رنگی CSS، مانند ["red", "#acf"] . عنصر n در آرایه نشان دهنده رنگ خط n ام در نمودار است. |
برگشت
BarChartBuilder - این سازنده، برای زنجیره‌سازی مفید است.
setDataSourceUrl(url)
URL منبع داده را تنظیم می کند که برای وارد کردن داده ها از یک منبع خارجی مانند Google Sheets استفاده می شود. اگر یک URL منبع داده و یک DataTable ارائه شود، URL منبع داده نادیده گرفته می شود.
برای اطلاعات بیشتر در مورد جستجوی منابع داده، اسناد Google Charts را بررسی کنید.
مولفه های
| نام | تایپ کنید | شرح |
|---|---|---|
url | String | نشانی وب منبع داده، از جمله هر پارامتر پرس و جو. |
برگشت
BarChartBuilder - این سازنده، برای زنجیره‌سازی مفید است.
setDataTable(tableBuilder)
جدول داده را برای استفاده برای نمودار با استفاده از DataTableBuilder تنظیم می کند. این یک روش راحت برای تنظیم جدول داده ها بدون نیاز به فراخوانی build() است.
مولفه های
| نام | تایپ کنید | شرح |
|---|---|---|
tableBuilder | DataTableBuilder | سازنده جدول داده ها یک جدول داده جدید فوراً به عنوان بخشی از این تماس ایجاد می‌شود، بنابراین هرگونه به‌روزرسانی بیشتر برای سازنده در نمودار منعکس نمی‌شود. |
برگشت
BarChartBuilder - این سازنده، برای زنجیره‌سازی مفید است.
setDataTable(table)
جدول داده ای را که شامل خطوط نمودار و همچنین برچسب های محور X است را تنظیم می کند. ستون اول باید یک رشته باشد و حاوی برچسب های محور افقی باشد. هر تعداد ستون می تواند دنبال شود، همه باید عددی باشند. هر ستون به صورت یک خط جداگانه نمایش داده می شود.
مولفه های
| نام | تایپ کنید | شرح |
|---|---|---|
table | DataTableSource | جدول داده برای استفاده برای نمودار. |
برگشت
BarChartBuilder - این سازنده، برای زنجیره‌سازی مفید است.
setDataViewDefinition(dataViewDefinition)
تعریف نمای داده را برای استفاده برای نمودار تنظیم می کند.
مولفه های
| نام | تایپ کنید | شرح |
|---|---|---|
dataViewDefinition | DataViewDefinition | یک شی تعریف نمای داده که نمایه ای را که باید از منبع داده داده شده برای ترسیم نمودار مشتق شود، تعریف می کند. |
برگشت
BarChartBuilder - این سازنده، برای زنجیره‌سازی مفید است.
setDimensions(width, height)
ابعاد نمودار را تعیین می کند.
مولفه های
| نام | تایپ کنید | شرح |
|---|---|---|
width | Integer | عرض نمودار، بر حسب پیکسل. |
height | Integer | ارتفاع نمودار، بر حسب پیکسل. |
برگشت
BarChartBuilder - این سازنده، برای زنجیره‌سازی مفید است.
setLegendPosition(position)
موقعیت افسانه را با توجه به نمودار تنظیم می کند. به طور پیش فرض، هیچ افسانه ای وجود ندارد.
// Creates a line chart builder and sets the legend position to right. var builder = Charts.newLineChart(); builder.setLegendPosition(Charts.Position.RIGHT);
مولفه های
| نام | تایپ کنید | شرح |
|---|---|---|
position | Position | موقعیت افسانه. |
برگشت
BarChartBuilder - این سازنده، برای زنجیره‌سازی مفید است.
setLegendTextStyle(textStyle)
سبک متن افسانه نمودار را تنظیم می کند.
// Creates a line chart builder and sets it up for a blue, 26-point legend.
var textStyleBuilder = Charts.newTextStyle().setColor('#0000FF').setFontSize(26);
var style = textStyleBuilder.build();
var builder = Charts.newLineChart();
builder.setLegendTextStyle(style);مولفه های
| نام | تایپ کنید | شرح |
|---|---|---|
textStyle | TextStyle | سبک متن برای استفاده برای افسانه نمودار. |
برگشت
BarChartBuilder - این سازنده، برای زنجیره‌سازی مفید است.
setOption(option, value)
گزینه های پیشرفته را برای این نمودار تنظیم می کند. گزینه های موجود برای این نمودار را ببینید. اگر گزینه داده شده نامعتبر باشد، این روش تاثیری ندارد.
// Build a bar chart with a 1-second animation duration.
var builder = Charts.newBarChart();
builder.setOption('animation.duration', 1000);
var chart = builder.build();مولفه های
| نام | تایپ کنید | شرح |
|---|---|---|
option | String | گزینه تنظیم. |
value | Object | مقدار برای تنظیم |
برگشت
BarChartBuilder - این سازنده، برای زنجیره‌سازی مفید است.
setRange(start, end)
محدوده را برای نمودار تنظیم می کند.
اگر هر یک از نقاط داده خارج از محدوده باشد، محدوده برای شامل آن نقاط داده گسترش می یابد.
مولفه های
| نام | تایپ کنید | شرح |
|---|---|---|
start | Number | مقدار برای پایین ترین خط شبکه محور محدوده. |
end | Number | مقدار بالاترین خط شبکه محور محدوده. |
برگشت
BarChartBuilder - این سازنده، برای زنجیره‌سازی مفید است.
setStacked()
از خطوط انباشته شده استفاده می کند، به این معنی که مقادیر خط و نوار روی هم انباشته شده اند. به طور پیش فرض، انباشتگی وجود ندارد.
برگشت
BarChartBuilder - این سازنده، برای زنجیره‌سازی مفید است.
setTitle(chartTitle)
عنوان نمودار را تعیین می کند. عنوان در مرکز بالای نمودار نمایش داده می شود.
// Creates a line chart builder and title to 'My Line Chart'.
var builder = Charts.newLineChart();
builder.setTitle('My Line Chart')مولفه های
| نام | تایپ کنید | شرح |
|---|---|---|
chartTitle | String | عنوان نمودار |
برگشت
BarChartBuilder - این سازنده، برای زنجیره‌سازی مفید است.
setTitleTextStyle(textStyle)
سبک متن عنوان نمودار را تنظیم می کند.
// Creates a line chart builder and sets it up for a blue, 26-point title.
var textStyleBuilder = Charts.newTextStyle().setColor('#0000FF').setFontSize(26);
var style = textStyleBuilder.build();
var builder = Charts.newLineChart();
builder.setTitleTextStyle(style);مولفه های
| نام | تایپ کنید | شرح |
|---|---|---|
textStyle | TextStyle | سبک متنی که برای عنوان نمودار استفاده می شود. می توانید با فراخوانی Charts.newTextStyle() یک شی TextStyleBuilder ایجاد کنید. |
برگشت
BarChartBuilder - این سازنده، برای زنجیره‌سازی مفید است.
setXAxisTextStyle(textStyle)
سبک متن محور افقی را تنظیم می کند.
// Creates a line chart builder and sets the X-axis text style to blue, 18-point font.
var textStyle = Charts.newTextStyle().setColor('blue').setFontSize(18).build();
var builder = Charts.newLineChart();
builder.setXAxisTextStyle(textStyle);مولفه های
| نام | تایپ کنید | شرح |
|---|---|---|
textStyle | TextStyle | سبک متنی که برای عنوان محور افقی استفاده می شود. می توانید با فراخوانی Charts.newTextStyle() یک شی TextStyleBuilder ایجاد کنید. |
برگشت
BarChartBuilder - این سازنده، برای زنجیره‌سازی مفید است.
setXAxisTitle(title)
عنوانی را به محور افقی اضافه می کند. عنوان در مرکز قرار دارد و در زیر برچسب های مقدار محور ظاهر می شود.
// Creates a line chart builder and sets the X-axis title.
var builder = Charts.newLineChart();
builder.setTitle('X-axis Title')مولفه های
| نام | تایپ کنید | شرح |
|---|---|---|
title | String | عنوان برای محور X. |
برگشت
BarChartBuilder - این سازنده، برای زنجیره‌سازی مفید است.
setXAxisTitleTextStyle(textStyle)
سبک متن عنوان محور افقی را تنظیم می کند.
// Creates a line chart builder and sets the X-axis title text style to blue, 18-point font.
var textStyle = Charts.newTextStyle().setColor('blue').setFontSize(18).build();
var builder = Charts.newLineChart();
builder.setXAxisTitleTextStyle(textStyle);مولفه های
| نام | تایپ کنید | شرح |
|---|---|---|
textStyle | TextStyle | سبک متنی که برای عنوان محور افقی استفاده می شود. می توانید با فراخوانی Charts.newTextStyle() یک شی TextStyleBuilder ایجاد کنید. |
برگشت
BarChartBuilder - این سازنده، برای زنجیره‌سازی مفید است.
setYAxisTextStyle(textStyle)
سبک متن محور عمودی را تنظیم می کند.
// Creates a line chart builder and sets the Y-axis text style to blue, 18-point font.
var textStyle = Charts.newTextStyle().setColor('blue').setFontSize(18).build();
var builder = Charts.newLineChart();
builder.setYAxisTextStyle(textStyle);مولفه های
| نام | تایپ کنید | شرح |
|---|---|---|
textStyle | TextStyle | سبک متنی که برای عنوان محور افقی استفاده می شود. می توانید با فراخوانی Charts.newTextStyle() یک شی TextStyleBuilder ایجاد کنید. |
برگشت
BarChartBuilder - این سازنده، برای زنجیره‌سازی مفید است.
setYAxisTitle(title)
عنوانی را به محور عمودی اضافه می کند. عنوان در مرکز قرار دارد و در سمت چپ برچسب های مقدار ظاهر می شود.
// Creates a line chart builder and sets the Y-axis title.
var builder = Charts.newLineChart();
builder.setYAxisTitle('Y-axis Title')مولفه های
| نام | تایپ کنید | شرح |
|---|---|---|
title | String | عنوان برای محور Y. |
برگشت
BarChartBuilder - این سازنده، برای زنجیره‌سازی مفید است.
setYAxisTitleTextStyle(textStyle)
سبک متن عنوان محور عمودی را تنظیم می کند.
// Creates a line chart builder and sets the Y-axis title text style to blue, 18-point font.
var textStyle = Charts.newTextStyle().setColor('blue').setFontSize(18).build();
var builder = Charts.newLineChart();
builder.setYAxisTitleTextStyle(textStyle);مولفه های
| نام | تایپ کنید | شرح |
|---|---|---|
textStyle | TextStyle | سبک متنی که برای عنوان محور افقی استفاده می شود. می توانید با فراخوانی Charts.newTextStyle() یک شی TextStyleBuilder ایجاد کنید. |
برگشت
BarChartBuilder - این سازنده، برای زنجیره‌سازی مفید است.
useLogScale()
محور دامنه را به یک مقیاس لگاریتمی تبدیل می کند (به مثبت بودن همه مقادیر نیاز دارد). محور محدوده، محور عمودی برای نمودارهای عمودی (مانند خط، مساحت یا ستون) و محور افقی برای نمودارهای افقی (مانند میله) است.
برگشت
BarChartBuilder - این سازنده، برای زنجیره‌سازی مفید است.