Class BarChartBuilder

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 — أداة الإنشاء هذه مفيدة للسلاسل.