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".
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");

المَعلمات

الاسم	Type	الوصف
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"]);

المَعلمات

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

استرجاع الكرة

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

---

setDataSourceUrl(url)

تحدِّد عنوان URL لمصدر البيانات المستخدَم لسحب البيانات من مصدر خارجي مثل "جداول بيانات Google". في حال تقديم عنوان URL لمصدر البيانات وجدول بيانات، سيتم تجاهل عنوان URL لمصدر البيانات.

للتعرُّف على المزيد من المعلومات عن تنفيذ طلبات بحث في مصادر البيانات، راجِع مستندات مخططات Google.

المَعلمات

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

استرجاع الكرة

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

---

setDataTable(tableBuilder)

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

المَعلمات

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

استرجاع الكرة

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

---

setDataTable(table)

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

المَعلمات

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

استرجاع الكرة

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

---

setDataViewDefinition(dataViewDefinition)

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

المَعلمات

الاسم	Type	الوصف
dataViewDefinition	DataViewDefinition	تمثّل هذه السمة عنصر تعريف عرض البيانات الذي يحدّد العرض الذي يجب اشتقاقه من مصدر البيانات المحدّد لرسم الرسم البياني.

استرجاع الكرة

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

---

setDimensions(width, height)

لضبط الأبعاد للرسم البياني.

المَعلمات

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

المَعلمات

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

المَعلمات

الاسم	Type	الوصف
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();

المَعلمات

الاسم	Type	الوصف
option	String	خيار التعيين.
value	Object	القيمة المطلوب ضبطها.

استرجاع الكرة

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

---

setRange(start, end)

لضبط نطاق الرسم البياني.

إذا كانت أي نقاط بيانات تقع خارج النطاق، يتم توسيع النطاق ليشمل نقاط البيانات هذه.

المَعلمات

الاسم	Type	الوصف
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')

المَعلمات

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

المَعلمات

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

المَعلمات

الاسم	Type	الوصف
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')

المَعلمات

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

المَعلمات

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

المَعلمات

الاسم	Type	الوصف
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')

المَعلمات

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

المَعلمات

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

استرجاع الكرة

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

---

useLogScale()

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

استرجاع الكرة

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