أداة إنشاء للمخططات المبعثرة. لمزيد من التفاصيل، راجع مستندات "مخططات Google".
فيما يلي مثال يوضح كيفية إنشاء مخطط مبعثر. يتم استيراد البيانات من جدول بيانات Google.
// Get sample data from a spreadsheet. var dataSourceUrl = 'https://docs.google.com/spreadsheet/tq?range=C1%3AD' + '&key=0Aq4s9w_HxMs7dHpfX05JdmVSb1FpT21sbXd4NVE3UEE&gid=4&headers=-1'; var 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); var 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 var builder = Charts.newLineChart(); builder.setBackgroundColor("gray");
المَعلمات
الاسم | Type | الوصف |
---|---|---|
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. var builder = Charts.newLineChart(); builder.setColors(["green", "red"]);
المَعلمات
الاسم | Type | الوصف |
---|---|---|
cssValues | String[] | مصفوفة من قيم CSS للألوان، مثل ["red", "#acf"] . ويمثّل العنصر nth في الصفيف لون السطر nth في الرسم البياني. |
استرجاع الكرة
ScatterChartBuilder
: أداة الإنشاء هذه مفيدة للسلاسل
setDataSourceUrl(url)
تحدِّد عنوان URL لمصدر البيانات المستخدَم لسحب البيانات من مصدر خارجي مثل "جداول بيانات Google". في حال تقديم عنوان URL لمصدر البيانات وجدول بيانات، سيتم تجاهل عنوان URL لمصدر البيانات.
للتعرُّف على المزيد من المعلومات عن تنفيذ طلبات بحث في مصادر البيانات، راجِع مستندات مخططات Google.
المَعلمات
الاسم | Type | الوصف |
---|---|---|
url | String | عنوان URL لمصدر البيانات، بما في ذلك أيّ مَعلمات طلب بحث. |
استرجاع الكرة
ScatterChartBuilder
: أداة الإنشاء هذه مفيدة للسلاسل
setDataTable(tableBuilder)
تُستخدم هذه السياسة في تحديد جدول البيانات في الرسم البياني باستخدام أداة DataTableBuilder. هذه طريقة سهلة لإعداد جدول البيانات بدون الحاجة إلى طلب البيانات من build()
.
المَعلمات
الاسم | Type | الوصف |
---|---|---|
tableBuilder | DataTableBuilder | إحدى أدوات إنشاء جداول البيانات. يتم إنشاء جدول بيانات جديد بشكل فوري كجزء من هذا الطلب، لذا لن تظهر أي تعديلات أخرى يتم إجراؤها على أداة الإنشاء في الرسم البياني. |
استرجاع الكرة
ScatterChartBuilder
: أداة الإنشاء هذه مفيدة للسلاسل
setDataTable(table)
تعيين جدول البيانات الذي يحتوي على خطوط المخطط، بالإضافة إلى تصنيفات المحور س. ويجب أن يكون العمود الأول سلسلة، وأن يحتوي على تسميات المحور الأفقي. يمكن أن يتبع أي عدد من الأعمدة، يجب أن تكون جميعها رقمية. يتم عرض كل عمود كسطر منفصل.
المَعلمات
الاسم | Type | الوصف |
---|---|---|
table | DataTableSource | جدول البيانات المطلوب استخدامه في الرسم البياني |
استرجاع الكرة
ScatterChartBuilder
: أداة الإنشاء هذه مفيدة للسلاسل
setDataViewDefinition(dataViewDefinition)
لتعيين تعريف عرض البيانات لاستخدامه مع الرسم البياني.
المَعلمات
الاسم | Type | الوصف |
---|---|---|
dataViewDefinition | DataViewDefinition | تمثّل هذه السمة عنصر تعريف عرض البيانات الذي يحدّد العرض الذي يجب اشتقاقه من مصدر البيانات المحدّد لرسم الرسم البياني. |
استرجاع الكرة
ScatterChartBuilder
: أداة الإنشاء هذه مفيدة للسلاسل
setDimensions(width, height)
لضبط الأبعاد للرسم البياني.
المَعلمات
الاسم | Type | الوصف |
---|---|---|
width | Integer | تمثّل هذه السمة عرض الرسم البياني بالبكسل. |
height | Integer | تمثّل هذه السمة ارتفاع الرسم البياني بالبكسل. |
استرجاع الكرة
ScatterChartBuilder
: أداة الإنشاء هذه مفيدة للسلاسل
setLegendPosition(position)
تعيين موضع وسيلة الإيضاح بالنسبة إلى الرسم البياني. وبشكل افتراضي، لا توجد وسيلة إيضاح.
// Creates a line chart builder and sets the legend position to right. var builder = Charts.newLineChart(); builder.setLegendPosition(Charts.Position.RIGHT);
المَعلمات
الاسم | Type | الوصف |
---|---|---|
position | Position | موضع وسيلة الإيضاح. |
استرجاع الكرة
ScatterChartBuilder
: أداة الإنشاء هذه مفيدة للسلاسل
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);
المَعلمات
الاسم | Type | الوصف |
---|---|---|
textStyle | TextStyle | نمط النص المطلوب استخدامه في وسيلة إيضاح الرسم البياني. |
استرجاع الكرة
ScatterChartBuilder
: أداة الإنشاء هذه مفيدة للسلاسل
setOption(option, value)
ضبط الخيارات المتقدمة لهذا الرسم البياني اطّلع على الخيارات المتاحة لهذا المخطط. ليس لهذه الطريقة تأثير إذا كان الخيار المحدّد غير صالح.
// Build a scatter chart with a 1-second animation duration. var builder = Charts.newScatterChart(); builder.setOption('animation.duration', 1000); var chart = builder.build();
المَعلمات
الاسم | Type | الوصف |
---|---|---|
option | String | خيار التعيين. |
value | Object | القيمة المطلوب ضبطها. |
استرجاع الكرة
ScatterChartBuilder
: أداة الإنشاء هذه مفيدة للسلاسل
setPointStyle(style)
لضبط نمط النقاط الموجودة في الخط. بشكل افتراضي، لا يكون للنقاط أنماط معينة، ويكون الخط فقط مرئيًا.
// Creates a line chart builder and sets large point style. var builder = Charts.newLineChart(); builder.setPointStyle(Charts.PointStyle.LARGE);
المَعلمات
الاسم | Type | الوصف |
---|---|---|
style | PointStyle | النمط المطلوب استخدامه للنقاط في الخط. |
استرجاع الكرة
ScatterChartBuilder
: أداة الإنشاء هذه مفيدة للسلاسل
يمكن أيضًا مراجعة
setTitle(chartTitle)
لضبط عنوان الرسم البياني. يتم عرض العنوان في الوسط أعلى الرسم البياني.
// Creates a line chart builder and title to 'My Line Chart'. var builder = Charts.newLineChart(); builder.setTitle('My Line Chart')
المَعلمات
الاسم | Type | الوصف |
---|---|---|
chartTitle | String | عنوان المخطط. |
استرجاع الكرة
ScatterChartBuilder
: أداة الإنشاء هذه مفيدة للسلاسل
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);
المَعلمات
الاسم | Type | الوصف |
---|---|---|
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. var builder = Charts.newTableChart(); builder.setXAxisRange(0, 100);
المَعلمات
الاسم | Type | الوصف |
---|---|---|
start | Number | قيمة خط الشبكة الأدنى بالمحور الأفقي. |
end | Number | قيمة أعلى خط شبكة في المحور الأفقي. |
استرجاع الكرة
ScatterChartBuilder
: أداة الإنشاء هذه مفيدة للسلاسل
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);
المَعلمات
الاسم | Type | الوصف |
---|---|---|
textStyle | TextStyle | نمط النص المطلوب استخدامه لعنوان المحور الأفقي. يمكنك إنشاء كائن TextStyleBuilder من خلال طلب Charts.newTextStyle() . |
استرجاع الكرة
ScatterChartBuilder
: أداة الإنشاء هذه مفيدة للسلاسل
setXAxisTitle(title)
لإضافة عنوان إلى المحور الأفقي. يوضع العنوان في الوسط ويظهر أسفل تسميات قيم المحور.
// Creates a line chart builder and sets the X-axis title. var builder = Charts.newLineChart(); builder.setTitle('X-axis Title')
المَعلمات
الاسم | Type | الوصف |
---|---|---|
title | String | عنوان المحور س. |
استرجاع الكرة
ScatterChartBuilder
: أداة الإنشاء هذه مفيدة للسلاسل
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);
المَعلمات
الاسم | Type | الوصف |
---|---|---|
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. var builder = Charts.newTableChart(); builder.setYAxisRange(0, 100);
المَعلمات
الاسم | Type | الوصف |
---|---|---|
start | Number | قيمة خط الشبكة الأدنى على المحور الرأسي. |
end | Number | قيمة أعلى خط شبكة للمحور الرأسي. |
استرجاع الكرة
ScatterChartBuilder
: أداة الإنشاء هذه مفيدة للسلاسل
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);
المَعلمات
الاسم | Type | الوصف |
---|---|---|
textStyle | TextStyle | نمط النص المطلوب استخدامه لعنوان المحور الأفقي. يمكنك إنشاء كائن TextStyleBuilder من خلال طلب Charts.newTextStyle() . |
استرجاع الكرة
ScatterChartBuilder
: أداة الإنشاء هذه مفيدة للسلاسل
setYAxisTitle(title)
لإضافة عنوان إلى المحور الرأسي. يوضع العنوان في الوسط ويظهر على يسار تسميات القيمة.
// Creates a line chart builder and sets the Y-axis title. var builder = Charts.newLineChart(); builder.setYAxisTitle('Y-axis Title')
المَعلمات
الاسم | Type | الوصف |
---|---|---|
title | String | عنوان المحور Y. |
استرجاع الكرة
ScatterChartBuilder
: أداة الإنشاء هذه مفيدة للسلاسل
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);
المَعلمات
الاسم | Type | الوصف |
---|---|---|
textStyle | TextStyle | نمط النص المطلوب استخدامه لعنوان المحور الأفقي. يمكنك إنشاء كائن TextStyleBuilder من خلال طلب Charts.newTextStyle() . |
استرجاع الكرة
ScatterChartBuilder
: أداة الإنشاء هذه مفيدة للسلاسل