تمت ترجمة هذه الصفحة بواسطة Cloud Translation API‏.

Class BarChartBuilder

أداة إنشاء المخططات الشريطية لمزيد من التفاصيل، اطّلع على مستندات "مخططات 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 Google".
`setDataTable(tableBuilder)`	`BarChartBuilder`	تحدد هذه السمة جدول البيانات لاستخدامه في الرسم البياني باستخدام DataTableBuilder.
`setDataTable(table)`	`BarChartBuilder`	لتعيين جدول البيانات الذي يحتوي على خطوط المخطط، وكذلك تسميات المحور س.
`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 في الصفيفة لون الخط nth في المخطط.

الإرجاع

BarChartBuilder — أداة الإنشاء هذه مفيدة للسلاسل.

`setDataSourceUrl(url)`

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

لمزيد من المعلومات حول طلبات البحث عن مصادر البيانات، يمكنك الاطّلاع على مستندات "مخطّطات Google".

المعلمات

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

الإرجاع

BarChartBuilder — أداة الإنشاء هذه مفيدة للسلاسل.

`setDataTable(tableBuilder)`

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

المعلمات

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

الإرجاع

BarChartBuilder — أداة الإنشاء هذه مفيدة للسلاسل.

`setDataTable(table)`

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

المعلمات

الاسم	النوع	الوصف
`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`	نمط النص المطلوب استخدامه لعنوان الرسم البياني. يمكنك إنشاء كائن `TextStyleBuilder` من خلال استدعاء `Charts.newTextStyle()`.

الإرجاع

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`	نمط النص المطلوب استخدامه لعنوان المحور الأفقي. يمكنك إنشاء كائن `TextStyleBuilder` من خلال استدعاء `Charts.newTextStyle()`.

الإرجاع

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`	عنوان المحور س.

الإرجاع

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`	نمط النص المطلوب استخدامه لعنوان المحور الأفقي. يمكنك إنشاء كائن `TextStyleBuilder` من خلال استدعاء `Charts.newTextStyle()`.

الإرجاع

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`	نمط النص المطلوب استخدامه لعنوان المحور الأفقي. يمكنك إنشاء كائن `TextStyleBuilder` من خلال استدعاء `Charts.newTextStyle()`.

الإرجاع

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`	نمط النص المطلوب استخدامه لعنوان المحور الأفقي. يمكنك إنشاء كائن `TextStyleBuilder` من خلال استدعاء `Charts.newTextStyle()`.

الإرجاع

BarChartBuilder — أداة الإنشاء هذه مفيدة للسلاسل.

`useLogScale()`

تحويل محور النطاق إلى مقياس لوغاريتمي (يتطلب أن تكون جميع القيم موجبة). النطاق هو المحور الرأسي للمخططات العمودية (مثل الخط أو المساحة أو العمود) على المحور الأفقي للمخططات الأفقية (مثل الشريط).

الإرجاع

BarChartBuilder — أداة الإنشاء هذه مفيدة للسلاسل.