Class ScatterChartBuilder

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

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

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

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

const chartBuilder = Charts.newScatterChart()
                         .setTitle('Adjusted GDP & U.S. Population')
                         .setXAxisTitle('U.S. Population (millions)')
                         .setYAxisTitle('Adjusted GDP ($ billions)')
                         .setDimensions(600, 500)
                         .setLegendPosition(Charts.Position.NONE)
                         .setDataSourceUrl(dataSourceUrl);

const chart = chartBuilder.build();

روش‌ها

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

مستندات دقیق

build()

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

بازگشت

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

setBackgroundColor(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" ).

بازگشت

ScatterChartBuilder — این سازنده، برای زنجیره‌سازی مفید است.

setColors(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ام در نمودار را نشان می‌دهد.

بازگشت

ScatterChartBuilder — این سازنده، برای زنجیره‌سازی مفید است.

setDataSourceUrl(url)

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

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

پارامترها

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

بازگشت

ScatterChartBuilder — این سازنده، برای زنجیره‌سازی مفید است.

setDataTable(tableBuilder)

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

پارامترها

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

بازگشت

ScatterChartBuilder — این سازنده، برای زنجیره‌سازی مفید است.

setDataTable(table)

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

پارامترها

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

بازگشت

ScatterChartBuilder — این سازنده، برای زنجیره‌سازی مفید است.

setDataViewDefinition(dataViewDefinition)

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

پارامترها

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

بازگشت

ScatterChartBuilder — این سازنده، برای زنجیره‌سازی مفید است.

setDimensions(width, height)

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

پارامترها

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

بازگشت

ScatterChartBuilder — این سازنده، برای زنجیره‌سازی مفید است.

setLegendPosition(position)

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

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

پارامترها

نام نوع توضیحات
position Position جایگاه افسانه.

بازگشت

ScatterChartBuilder — این سازنده، برای زنجیره‌سازی مفید است.

setLegendTextStyle(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 سبک متنی که برای راهنمای نمودار استفاده می‌شود.

بازگشت

ScatterChartBuilder — این سازنده، برای زنجیره‌سازی مفید است.

setOption(option, value)

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

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

پارامترها

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

بازگشت

ScatterChartBuilder — این سازنده، برای زنجیره‌سازی مفید است.

setPointStyle(style)

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

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

پارامترها

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

بازگشت

ScatterChartBuilder — این سازنده، برای زنجیره‌سازی مفید است.

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

setTitle(chartTitle)

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

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

پارامترها

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

بازگشت

ScatterChartBuilder — این سازنده، برای زنجیره‌سازی مفید است.

setTitleTextStyle(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 ایجاد کنید.

بازگشت

ScatterChartBuilder — این سازنده، برای زنجیره‌سازی مفید است.

setXAxisLogScale()

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

بازگشت

ScatterChartBuilder — این سازنده، برای زنجیره‌سازی مفید است.

setXAxisRange(start, end)

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

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

// Creates a scatter chart builder and sets the X-axis range to be 0 to 100.
const builder = Charts.newTableChart();
builder.setXAxisRange(0, 100);

پارامترها

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

بازگشت

ScatterChartBuilder — این سازنده، برای زنجیره‌سازی مفید است.

setXAxisTextStyle(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 ایجاد کنید.

بازگشت

ScatterChartBuilder — این سازنده، برای زنجیره‌سازی مفید است.

setXAxisTitle(title)

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

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

پارامترها

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

بازگشت

ScatterChartBuilder — این سازنده، برای زنجیره‌سازی مفید است.

setXAxisTitleTextStyle(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 ایجاد کنید.

بازگشت

ScatterChartBuilder — این سازنده، برای زنجیره‌سازی مفید است.

setYAxisLogScale()

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

بازگشت

ScatterChartBuilder — این سازنده، برای زنجیره‌سازی مفید است.

setYAxisRange(start, end)

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

// Creates a scatter chart builder and sets the Y-axis range to be 0 to 100.
const builder = Charts.newTableChart();
builder.setYAxisRange(0, 100);

پارامترها

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

بازگشت

ScatterChartBuilder — این سازنده، برای زنجیره‌سازی مفید است.

setYAxisTextStyle(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 ایجاد کنید.

بازگشت

ScatterChartBuilder — این سازنده، برای زنجیره‌سازی مفید است.

setYAxisTitle(title)

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

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

پارامترها

نام نوع توضیحات
title String عنوان محور Y.

بازگشت

ScatterChartBuilder — این سازنده، برای زنجیره‌سازی مفید است.

setYAxisTitleTextStyle(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 ایجاد کنید.

بازگشت

ScatterChartBuilder — این سازنده، برای زنجیره‌سازی مفید است.