Class ScatterChartBuilder

ScatterChartBuilder

أداة إنشاء الرسوم البيانية بالنقاط المبعثرة لمزيد من التفاصيل، يُرجى الاطّلاع على مستندات أدوات الرسم البياني من Google.

في ما يلي مثال يوضّح كيفية إنشاء رسم بياني بالنقاط المبعثرة. يتم استيراد البيانات من جدول بيانات Google.

// 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	ينشئ الرسم البياني.
setBackgroundColor(cssValue)	ScatterChartBuilder	تضبط هذه السمة لون الخلفية للمخطّط.
setColors(cssValues)	ScatterChartBuilder	تضبط هذه السمة ألوان الخطوط في الرسم البياني.
setDataSourceUrl(url)	ScatterChartBuilder	تضبط هذه السمة عنوان URL لمصدر البيانات المستخدَم لجلب البيانات من مصدر خارجي، مثل "جداول بيانات Google".
setDataTable(tableBuilder)	ScatterChartBuilder	تضبط هذه السمة جدول البيانات الذي سيتم استخدامه للرسم البياني باستخدام DataTableBuilder.
setDataTable(table)	ScatterChartBuilder	تضبط جدول البيانات الذي يحتوي على خطوط الرسم البياني، بالإضافة إلى تصنيفات المحور س.
setDataViewDefinition(dataViewDefinition)	ScatterChartBuilder	تضبط هذه السمة تعريف عرض البيانات الذي سيتم استخدامه للرسم البياني.
setDimensions(width, height)	ScatterChartBuilder	تضبط هذه السمة أبعاد الرسم البياني.
setLegendPosition(position)	ScatterChartBuilder	تضبط هذه السمة موضع وسيلة الإيضاح بالنسبة إلى الرسم البياني.
setLegendTextStyle(textStyle)	ScatterChartBuilder	تضبط هذه السمة نمط نص وسيلة الإيضاح في الرسم البياني.
setOption(option, value)	ScatterChartBuilder	تضبط هذه السمة الخيارات المتقدّمة لهذا الرسم البياني.
setPointStyle(style)	ScatterChartBuilder	تضبط هذه السمة نمط النقاط في الخط.
setTitle(chartTitle)	ScatterChartBuilder	تضبط هذه السمة عنوان الرسم البياني.
setTitleTextStyle(textStyle)	ScatterChartBuilder	تضبط هذه السمة نمط النص لعنوان الرسم البياني.
setXAxisLogScale()	ScatterChartBuilder	يحوّل المحور الأفقي إلى مقياس لوغاريتمي (يتطلّب أن تكون جميع القيم موجبة).
setXAxisRange(start, end)	ScatterChartBuilder	تضبط هذه السمة نطاق المحور الأفقي للرسم البياني.
setXAxisTextStyle(textStyle)	ScatterChartBuilder	تضبط هذه السمة نمط نص المحور الأفقي.
setXAxisTitle(title)	ScatterChartBuilder	تضيف هذه السمة عنوانًا إلى المحور الأفقي.
setXAxisTitleTextStyle(textStyle)	ScatterChartBuilder	تضبط هذه السمة نمط نص عنوان المحور الأفقي.
setYAxisLogScale()	ScatterChartBuilder	يحوّل المحور العمودي إلى مقياس لوغاريتمي (يجب أن تكون جميع القيم موجبة).
setYAxisRange(start, end)	ScatterChartBuilder	تضبط هذه السمة نطاق المحور العمودي للرسم البياني.
setYAxisTextStyle(textStyle)	ScatterChartBuilder	تضبط هذه السمة نمط نص المحور العمودي.
setYAxisTitle(title)	ScatterChartBuilder	تضيف هذه السمة عنوانًا إلى المحور العمودي.
setYAxisTitleTextStyle(textStyle)	ScatterChartBuilder	تضبط هذه السمة نمط نص عنوان المحور العمودي.

مستندات تفصيلية

build()

ينشئ الرسم البياني.

الإرجاع

‫Chart: عنصر "رسم بياني" يمكن تضمينه في المستندات أو عناصر واجهة المستخدم أو استخدامه كصورة ثابتة.

---

setBackgroundColor(cssValue)

تضبط هذه السمة لون الخلفية للمخطّط.

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

المعلمات

الاسم	النوع	الوصف
cssValue	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']);

المعلمات

الاسم	النوع	الوصف
cssValues	String[]	مصفوفة من قيم CSS للألوان، مثل ["red", "#acf"] يمثّل العنصر رقم n في المصفوفة لون الخط رقم n في الرسم البياني.

الإرجاع

‫ScatterChartBuilder: أداة إنشاء مفيدة للتسلسل

---

setDataSourceUrl(url)

تضبط هذه السمة عنوان URL لمصدر البيانات المستخدَم لجلب البيانات من مصدر خارجي، مثل "جداول بيانات Google". في حال توفير عنوان URL لمصدر بيانات وDataTable، سيتم تجاهل عنوان URL لمصدر البيانات.

لمزيد من المعلومات حول طلب مصادر البيانات، يُرجى الاطّلاع على مستندات أدوات الرسم البياني من Google.

المعلمات

الاسم	النوع	الوصف
url	String	عنوان URL لمصدر البيانات، بما في ذلك أي مَعلمات طلب بحث

الإرجاع

‫ScatterChartBuilder: أداة إنشاء مفيدة للتسلسل

---

setDataTable(tableBuilder)

تضبط هذه السمة جدول البيانات الذي سيتم استخدامه للرسم البياني باستخدام DataTableBuilder. هذه طريقة ملائمة لضبط جدول البيانات بدون الحاجة إلى استدعاء build().

المعلمات

الاسم	النوع	الوصف
tableBuilder	DataTableBuilder	أداة إنشاء جداول البيانات يتم إنشاء جدول بيانات جديد على الفور كجزء من هذا الطلب، وبالتالي لن تظهر أي تعديلات أخرى على أداة الإنشاء في الرسم البياني.

الإرجاع

‫ScatterChartBuilder: أداة إنشاء مفيدة للتسلسل

---

setDataTable(table)

تضبط جدول البيانات الذي يحتوي على خطوط الرسم البياني، بالإضافة إلى تصنيفات المحور س. يجب أن يكون العمود الأول عبارة عن سلسلة نصية، وأن يحتوي على تصنيفات المحور الأفقي. يمكن أن يتبع ذلك أي عدد من الأعمدة، ويجب أن تكون جميعها رقمية. يتم عرض كل عمود كخط منفصل.

المعلمات

الاسم	النوع	الوصف
table	DataTableSource	جدول البيانات الذي سيتم استخدامه للرسم البياني

الإرجاع

‫ScatterChartBuilder: أداة إنشاء مفيدة للتسلسل

---

setDataViewDefinition(dataViewDefinition)

تضبط هذه السمة تعريف عرض البيانات الذي سيتم استخدامه للرسم البياني.

المعلمات

الاسم	النوع	الوصف
dataViewDefinition	DataViewDefinition	كائن تعريف لعرض البيانات يحدّد العرض الذي يجب استخراجه من مصدر البيانات المحدّد لرسم المخطط.

الإرجاع

‫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);

المعلمات

الاسم	النوع	الوصف
textStyle	TextStyle	نمط النص الذي سيتم استخدامه لتسمية الرسم البياني التوضيحية.

الإرجاع

‫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	PointStyle	نمط النقاط المطلوب استخدامه في الخط

الإرجاع

‫ScatterChartBuilder: أداة إنشاء مفيدة للتسلسل

انظر أيضًا

• PointStyle

---

setTitle(chartTitle)

تضبط هذه السمة عنوان الرسم البياني. يظهر العنوان في المنتصف أعلى الرسم البياني.

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

المعلمات

الاسم	النوع	الوصف
chartTitle	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);

المعلمات

الاسم	النوع	الوصف
textStyle	TextStyle	نمط النص المطلوب استخدامه لعنوان الرسم البياني. يمكنك إنشاء عنصر TextStyleBuilder من خلال استدعاء Charts.newTextStyle().

الإرجاع

‫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);

المعلمات

الاسم	النوع	الوصف
textStyle	TextStyle	نمط النص الذي سيتم استخدامه لعنوان المحور الأفقي. يمكنك إنشاء عنصر TextStyleBuilder من خلال استدعاء Charts.newTextStyle().

الإرجاع

‫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	تمثّل هذه السمة عنوان المحور الأفقي.

الإرجاع

‫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);

المعلمات

الاسم	النوع	الوصف
textStyle	TextStyle	نمط النص الذي سيتم استخدامه لعنوان المحور الأفقي. يمكنك إنشاء عنصر TextStyleBuilder من خلال استدعاء Charts.newTextStyle().

الإرجاع

‫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);

المعلمات

الاسم	النوع	الوصف
textStyle	TextStyle	نمط النص الذي سيتم استخدامه لعنوان المحور الأفقي. يمكنك إنشاء عنصر TextStyleBuilder من خلال استدعاء Charts.newTextStyle().

الإرجاع

‫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);

المعلمات

الاسم	النوع	الوصف
textStyle	TextStyle	نمط النص الذي سيتم استخدامه لعنوان المحور الأفقي. يمكنك إنشاء عنصر TextStyleBuilder من خلال استدعاء Charts.newTextStyle().

الإرجاع

‫ScatterChartBuilder: أداة إنشاء مفيدة للتسلسل