Class LineChartBuilder

سازنده نمودار خطی

سازنده نمودارهای خطی. برای جزئیات بیشتر، به مستندات نمودارهای Google مراجعه کنید.

در اینجا مثالی آورده شده است که نحوه ساخت نمودار خطی را نشان می دهد. داده‌ها از صفحه‌گسترده Google وارد می‌شوند.

// Get sample data from a spreadsheet.
const dataSourceUrl = 'https://docs.google.com/spreadsheet/tq?range=A1%3AG5' +
    '&key=0Aq4s9w_HxMs7dHpfX05JdmVSb1FpT21sbXd4NVE3UEE&gid=2&headers=-1';

const chartBuilder = Charts.newLineChart()
                         .setTitle('Yearly Rainfall')
                         .setXAxisTitle('Month')
                         .setYAxisTitle('Rainfall (in)')
                         .setDimensions(600, 500)
                         .setCurveStyle(Charts.CurveStyle.SMOOTH)
                         .setPointStyle(Charts.PointStyle.MEDIUM)
                         .setDataSourceUrl(dataSourceUrl);

const chart = chartBuilder.build();

روش ها

روش نوع برگشت شرح مختصر
build() Chart نمودار را می سازد.
reverse Categories() Line Chart Builder رسم سری ها را در محور دامنه معکوس می کند.
set Background Color(cssValue) Line Chart Builder رنگ پس زمینه نمودار را تنظیم می کند.
set Colors(cssValues) Line Chart Builder رنگ ها را برای خطوط در نمودار تنظیم می کند.
set Curve Style(style) Line Chart Builder سبک را برای استفاده برای منحنی‌های نمودار تنظیم می‌کند.
set Data Source Url(url) Line Chart Builder URL منبع داده را تنظیم می کند که برای وارد کردن داده ها از یک منبع خارجی مانند Google Sheets استفاده می شود.
set Data Table(tableBuilder) Line Chart Builder جدول داده را برای استفاده برای نمودار با استفاده از DataTableBuilder تنظیم می کند.
set Data Table(table) Line Chart Builder جدول داده ای را که شامل خطوط نمودار و همچنین برچسب های محور X است را تنظیم می کند.
set Data View Definition(dataViewDefinition) Line Chart Builder تعریف نمای داده را برای استفاده برای نمودار تنظیم می کند.
set Dimensions(width, height) Line Chart Builder ابعاد نمودار را تعیین می کند.
set Legend Position(position) Line Chart Builder موقعیت افسانه را با توجه به نمودار تنظیم می کند.
set Legend Text Style(textStyle) Line Chart Builder سبک متن افسانه نمودار را تنظیم می کند.
set Option(option, value) Line Chart Builder گزینه های پیشرفته را برای این نمودار تنظیم می کند.
set Point Style(style) Line Chart Builder استایل را برای نقاط در خط تنظیم می کند.
set Range(start, end) Line Chart Builder محدوده را برای نمودار تنظیم می کند.
set Title(chartTitle) Line Chart Builder عنوان نمودار را تعیین می کند.
set Title Text Style(textStyle) Line Chart Builder سبک متن عنوان نمودار را تنظیم می کند.
set XAxis Text Style(textStyle) Line Chart Builder سبک متن محور افقی را تنظیم می کند.
set XAxis Title(title) Line Chart Builder عنوانی را به محور افقی اضافه می کند.
set XAxis Title Text Style(textStyle) Line Chart Builder سبک متن عنوان محور افقی را تنظیم می کند.
set YAxis Text Style(textStyle) Line Chart Builder سبک متن محور عمودی را تنظیم می کند.
set YAxis Title(title) Line Chart Builder عنوانی را به محور عمودی اضافه می کند.
set YAxis Title Text Style(textStyle) Line Chart Builder سبک متن عنوان محور عمودی را تنظیم می کند.
use Log Scale() Line Chart Builder محور دامنه را به یک مقیاس لگاریتمی تبدیل می کند (به مثبت بودن همه مقادیر نیاز دارد).

مستندات دقیق

build()

نمودار را می سازد.

بازگشت

Chart - یک شی نمودار، که می تواند در اسناد، عناصر رابط کاربری جاسازی شود یا به عنوان یک تصویر ثابت استفاده شود.

reverse Categories()

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

// Creates a pie chart builder and sets drawing of the slices in a
// counter-clockwise manner.
const builder = Charts.newPieChart();
builder.reverseCategories();

بازگشت

Line Chart Builder - این سازنده، برای زنجیره زدن مفید است.

set Background Color(cssValue)

رنگ پس زمینه نمودار را تنظیم می کند.

// Creates a line chart builder and sets the background color to gray
const builder = Charts.newLineChart();
builder.setBackgroundColor('gray');

پارامترها

نام تایپ کنید توضیحات
css Value String مقدار CSS برای رنگ (مانند "blue" یا "#00f" ).

بازگشت

Line Chart Builder - این سازنده، برای زنجیره زدن مفید است.

set Colors(cssValues)

رنگ ها را برای خطوط در نمودار تنظیم می کند.

// Creates a line chart builder and sets the first two lines to be drawn in
// green and red, respectively.
const builder = Charts.newLineChart();
builder.setColors(['green', 'red']);

پارامترها

نام تایپ کنید توضیحات
css Values String[] آرایه ای از مقادیر رنگی CSS، مانند ["red", "#acf"] . عنصر n در آرایه نشان دهنده رنگ خط n ام در نمودار است.

بازگشت

Line Chart Builder - این سازنده، برای زنجیره زدن مفید است.

set Curve Style(style)

سبک را برای استفاده برای منحنی‌های نمودار تنظیم می‌کند. برای سبک‌های منحنی مجاز، به Curve Style مراجعه کنید.

// Creates a line chart builder and curves the lines in the chart.
const builder = Charts.newLineChart();
builder.setCurveStyle(Charts.CurveStyle.SMOOTH);

پارامترها

نام تایپ کنید توضیحات
style Curve Style سبک برای منحنی ها در نمودار.

بازگشت

Line Chart Builder - این سازنده، برای زنجیره زدن مفید است.

همچنین ببینید

set Data Source Url(url)

URL منبع داده را تنظیم می کند که برای وارد کردن داده ها از یک منبع خارجی مانند Google Sheets استفاده می شود. اگر یک URL منبع داده و یک DataTable ارائه شود، URL منبع داده نادیده گرفته می شود.

برای اطلاعات بیشتر در مورد جستجوی منابع داده، اسناد Google Charts را بررسی کنید.

پارامترها

نام تایپ کنید توضیحات
url String نشانی وب منبع داده، از جمله هر پارامتر پرس و جو.

بازگشت

Line Chart Builder - این سازنده، برای زنجیره زدن مفید است.

set Data Table(tableBuilder)

جدول داده را برای استفاده برای نمودار با استفاده از DataTableBuilder تنظیم می کند. این یک روش راحت برای تنظیم جدول داده ها بدون نیاز به فراخوانی build() است.

پارامترها

نام تایپ کنید توضیحات
table Builder Data Table Builder سازنده جدول داده ها یک جدول داده جدید فوراً به عنوان بخشی از این تماس ایجاد می‌شود، بنابراین هرگونه به‌روزرسانی بیشتر برای سازنده در نمودار منعکس نمی‌شود.

بازگشت

Line Chart Builder - این سازنده، برای زنجیره زدن مفید است.

set Data Table(table)

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

پارامترها

نام تایپ کنید توضیحات
table Data Table Source جدول داده برای استفاده برای نمودار.

بازگشت

Line Chart Builder - این سازنده، برای زنجیره زدن مفید است.

set Data View Definition(dataViewDefinition)

تعریف نمای داده را برای استفاده برای نمودار تنظیم می کند.

پارامترها

نام تایپ کنید توضیحات
data View Definition Data View Definition یک شی تعریف نمای داده که نمایه ای را که باید از منبع داده داده شده برای ترسیم نمودار مشتق شود، تعریف می کند.

بازگشت

Line Chart Builder - این سازنده، برای زنجیره زدن مفید است.

set Dimensions(width, height)

ابعاد نمودار را تعیین می کند.

پارامترها

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

بازگشت

Line Chart Builder - این سازنده، برای زنجیره زدن مفید است.

set Legend Position(position)

موقعیت افسانه را با توجه به نمودار تنظیم می کند. به طور پیش فرض، هیچ افسانه ای وجود ندارد.

// Creates a line chart builder and sets the legend position to right.
const builder = Charts.newLineChart();
builder.setLegendPosition(Charts.Position.RIGHT);

پارامترها

نام تایپ کنید توضیحات
position Position موقعیت افسانه.

بازگشت

Line Chart Builder - این سازنده، برای زنجیره زدن مفید است.

set Legend Text Style(textStyle)

سبک متن افسانه نمودار را تنظیم می کند.

// Creates a line chart builder and sets it up for a  blue, 26-point legend.
const textStyleBuilder =
    Charts.newTextStyle().setColor('#0000FF').setFontSize(26);
const style = textStyleBuilder.build();
const builder = Charts.newLineChart();
builder.setLegendTextStyle(style);

پارامترها

نام تایپ کنید توضیحات
text Style Text Style سبک متن برای استفاده برای افسانه نمودار.

بازگشت

Line Chart Builder - این سازنده، برای زنجیره زدن مفید است.

set Option(option, value)

گزینه های پیشرفته را برای این نمودار تنظیم می کند. گزینه های موجود برای این نمودار را ببینید. اگر گزینه داده شده نامعتبر باشد، این روش تاثیری ندارد.

// Build a line chart with a 1-second animation duration.
const builder = Charts.newLineChart();
builder.setOption('animation.duration', 1000);
const chart = builder.build();

پارامترها

نام تایپ کنید توضیحات
option String گزینه تنظیم.
value Object مقدار برای تنظیم

بازگشت

Line Chart Builder - این سازنده، برای زنجیره زدن مفید است.

set Point Style(style)

استایل را برای نقاط در خط تنظیم می کند. به طور پیش فرض، نقاط هیچ سبک خاصی ندارند و فقط خط قابل مشاهده است.

// Creates a line chart builder and sets large point style.
const builder = Charts.newLineChart();
builder.setPointStyle(Charts.PointStyle.LARGE);

پارامترها

نام تایپ کنید توضیحات
style Point Style سبک مورد استفاده برای نقاط در خط.

بازگشت

Line Chart Builder - این سازنده، برای زنجیره زدن مفید است.

همچنین ببینید

set Range(start, end)

محدوده را برای نمودار تنظیم می کند.

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

پارامترها

نام تایپ کنید توضیحات
start Number مقدار برای پایین ترین خط شبکه محور محدوده.
end Number مقدار بالاترین خط شبکه محور محدوده.

بازگشت

Line Chart Builder - این سازنده، برای زنجیره زدن مفید است.

set Title(chartTitle)

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

// Creates a line chart builder and title to 'My Line Chart'.
const builder = Charts.newLineChart();
builder.setTitle('My Line Chart');

پارامترها

نام تایپ کنید توضیحات
chart Title String عنوان نمودار

بازگشت

Line Chart Builder - این سازنده، برای زنجیره زدن مفید است.

set Title Text Style(textStyle)

سبک متن عنوان نمودار را تنظیم می کند. 

// Creates a line chart builder and sets it up for a  blue, 26-point title.
const textStyleBuilder =
    Charts.newTextStyle().setColor('#0000FF').setFontSize(26);
const style = textStyleBuilder.build();
const builder = Charts.newLineChart();
builder.setTitleTextStyle(style);

پارامترها

نام تایپ کنید توضیحات
text Style Text Style سبک متنی که برای عنوان نمودار استفاده می شود. می توانید با فراخوانی Charts.newTextStyle() یک شی Text Style Builder ایجاد کنید.

بازگشت

Line Chart Builder - این سازنده، برای زنجیره زدن مفید است.

set XAxis Text Style(textStyle)

سبک متن محور افقی را تنظیم می کند. 

// Creates a line chart builder and sets the X-axis text style to blue, 18-point
// font.
const textStyle =
    Charts.newTextStyle().setColor('blue').setFontSize(18).build();
const builder = Charts.newLineChart();
builder.setXAxisTextStyle(textStyle);

پارامترها

نام تایپ کنید توضیحات
text Style Text Style سبک متنی که برای عنوان محور افقی استفاده می شود. می توانید با فراخوانی Charts.newTextStyle() یک شی Text Style Builder ایجاد کنید.

بازگشت

Line Chart Builder - این سازنده، برای زنجیره زدن مفید است.

set XAxis Title(title)

عنوانی را به محور افقی اضافه می کند. عنوان در مرکز قرار دارد و در زیر برچسب های مقدار محور ظاهر می شود. 

// Creates a line chart builder and sets the X-axis title.
const builder = Charts.newLineChart();
builder.setTitle('X-axis Title');

پارامترها

نام تایپ کنید توضیحات
title String عنوان برای محور X.

بازگشت

Line Chart Builder - این سازنده، برای زنجیره زدن مفید است.

set XAxis Title Text Style(textStyle)

سبک متن عنوان محور افقی را تنظیم می کند. 

// Creates a line chart builder and sets the X-axis title text style to blue,
// 18-point font.
const textStyle =
    Charts.newTextStyle().setColor('blue').setFontSize(18).build();
const builder = Charts.newLineChart();
builder.setXAxisTitleTextStyle(textStyle);

پارامترها

نام تایپ کنید توضیحات
text Style Text Style سبک متنی که برای عنوان محور افقی استفاده می شود. می توانید با فراخوانی Charts.newTextStyle() یک شی Text Style Builder ایجاد کنید.

بازگشت

Line Chart Builder - این سازنده، برای زنجیره زدن مفید است.

set YAxis Text Style(textStyle)

سبک متن محور عمودی را تنظیم می کند. 

// Creates a line chart builder and sets the Y-axis text style to blue, 18-point
// font.
const textStyle =
    Charts.newTextStyle().setColor('blue').setFontSize(18).build();
const builder = Charts.newLineChart();
builder.setYAxisTextStyle(textStyle);

پارامترها

نام تایپ کنید توضیحات
text Style Text Style سبک متنی که برای عنوان محور افقی استفاده می شود. می توانید با فراخوانی Charts.newTextStyle() یک شی Text Style Builder ایجاد کنید.

بازگشت

Line Chart Builder - این سازنده، برای زنجیره زدن مفید است.

set YAxis Title(title)

عنوانی را به محور عمودی اضافه می کند. عنوان در مرکز قرار دارد و در سمت چپ برچسب های مقدار ظاهر می شود. 

// Creates a line chart builder and sets the Y-axis title.
const builder = Charts.newLineChart();
builder.setYAxisTitle('Y-axis Title');

پارامترها

نام تایپ کنید توضیحات
title String عنوان برای محور Y.

بازگشت

Line Chart Builder - این سازنده، برای زنجیره زدن مفید است.

set YAxis Title Text Style(textStyle)

سبک متن عنوان محور عمودی را تنظیم می کند. 

// Creates a line chart builder and sets the Y-axis title text style to blue,
// 18-point font.
const textStyle =
    Charts.newTextStyle().setColor('blue').setFontSize(18).build();
const builder = Charts.newLineChart();
builder.setYAxisTitleTextStyle(textStyle);

پارامترها

نام تایپ کنید توضیحات
text Style Text Style سبک متنی که برای عنوان محور افقی استفاده می شود. می توانید با فراخوانی Charts.newTextStyle() یک شی Text Style Builder ایجاد کنید.

بازگشت

Line Chart Builder - این سازنده، برای زنجیره زدن مفید است.

use Log Scale()

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

بازگشت

Line Chart Builder - این سازنده، برای زنجیره زدن مفید است.