Class LineChartBuilder

أداةإنشاءالرسوم البيانيةالخطية

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

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

// Get sample data from a spreadsheet.
const dataSourceUrl = 'https://docs.google.com/spreadsheet/tq?range=A1%3AG5' +
    '&key=0Aq4s9w_HxMs7dHpfX05JdmVSb1FpT21sbXd4NVE3UEE&gid=2&headers=-1';

const chartBuilder = Charts.newLineChart()
                         .setTitle('Yearly Rainfall')
                         .setXAxisTitle('Month')
                         .setYAxisTitle('Rainfall (in)')
                         .setDimensions(600, 500)
                         .setCurveStyle(Charts.CurveStyle.SMOOTH)
                         .setPointStyle(Charts.PointStyle.MEDIUM)
                         .setDataSourceUrl(dataSourceUrl);

const chart = chartBuilder.build();

الطُرق

الطريقة	نوع القيمة التي يتم عرضها	وصف قصير
build()	Chart	إنشاء الرسم البياني
reverseCategories()	LineChartBuilder	يعكس رسم السلاسل في محور النطاق.
setBackgroundColor(cssValue)	LineChartBuilder	لضبط لون خلفية الرسم البياني.
setColors(cssValues)	LineChartBuilder	لضبط ألوان الخطوط في الرسم البياني
setCurveStyle(style)	LineChartBuilder	لتحديد النمط المراد استخدامه للخطوط المنحنية في الرسم البياني
setDataSourceUrl(url)	LineChartBuilder	لضبط عنوان URL لمصدر البيانات المستخدَم لسحب البيانات من مصدر خارجي، مثل "جداول بيانات Google".
setDataTable(tableBuilder)	LineChartBuilder	تُستخدَم هذه الطريقة لضبط جدول البيانات الذي سيتم استخدامه في الرسم البياني باستخدام DataTableBuilder.
setDataTable(table)	LineChartBuilder	تُستخدَم لضبط جدول البيانات الذي يحتوي على خطوط الرسم البياني، بالإضافة إلى تصنيفات محور السّين.
setDataViewDefinition(dataViewDefinition)	LineChartBuilder	لضبط تعريف عرض البيانات المراد استخدامه في الرسم البياني
setDimensions(width, height)	LineChartBuilder	تُستخدَم لضبط سمات الرسم البياني.
setLegendPosition(position)	LineChartBuilder	لضبط موضع العنوان التفسيري بالنسبة إلى الرسم البياني
setLegendTextStyle(textStyle)	LineChartBuilder	لضبط نمط النص لشرح الرسم البياني
setOption(option, value)	LineChartBuilder	لضبط الخيارات المتقدّمة لهذا الرسم البياني.
setPointStyle(style)	LineChartBuilder	تُستخدَم لضبط نمط النقاط في الخط.
setRange(start, end)	LineChartBuilder	لضبط النطاق للرسم البياني.
setTitle(chartTitle)	LineChartBuilder	لضبط عنوان الرسم البياني.
setTitleTextStyle(textStyle)	LineChartBuilder	لضبط نمط نص عنوان الرسم البياني
setXAxisTextStyle(textStyle)	LineChartBuilder	لضبط نمط نص المحور الأفقي
setXAxisTitle(title)	LineChartBuilder	تضيف عنوانًا إلى المحور الأفقي.
setXAxisTitleTextStyle(textStyle)	LineChartBuilder	لضبط نمط نص عنوان المحور الأفقي.
setYAxisTextStyle(textStyle)	LineChartBuilder	لضبط نمط نص المحور العمودي
setYAxisTitle(title)	LineChartBuilder	تُضيف عنوانًا إلى المحور العمودي.
setYAxisTitleTextStyle(textStyle)	LineChartBuilder	تُستخدَم لضبط نمط نص عنوان المحور العمودي.
useLogScale()	LineChartBuilder	تحوّل محور النطاق إلى مقياس لوغاريتمي (يتطلب أن تكون جميع القيم موجبة).

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

build()

إنشاء الرسم البياني

الإرجاع

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

---

reverseCategories()

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

// Creates a pie chart builder and sets drawing of the slices in a
// counter-clockwise manner.
const builder = Charts.newPieChart();
builder.reverseCategories();

الإرجاع

‫LineChartBuilder — هذا المُنشئ مفيد لإنشاء سلاسل.

---

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

الإرجاع

‫LineChartBuilder — هذا المُنشئ مفيد لإنشاء سلاسل.

---

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 في الرسم البياني.

الإرجاع

‫LineChartBuilder — هذا المُنشئ مفيد لإنشاء سلاسل.

---

setCurveStyle(style)

لتحديد النمط المراد استخدامه للخطوط المنحنية في الرسم البياني راجِع CurveStyle للاطّلاع على أنماط منحنيات المسموح بها.

// Creates a line chart builder and curves the lines in the chart.
const builder = Charts.newLineChart();
builder.setCurveStyle(Charts.CurveStyle.SMOOTH);

المعلمات

الاسم	النوع	الوصف
style	CurveStyle	نمط الخطوط المنحنية في الرسم البياني

الإرجاع

‫LineChartBuilder — هذا المُنشئ مفيد لإنشاء سلاسل.

انظر أيضًا

• CurveStyle

---

setDataSourceUrl(url)

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

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

المعلمات

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

الإرجاع

‫LineChartBuilder — هذا المُنشئ مفيد لإنشاء سلاسل.

---

setDataTable(tableBuilder)

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

المعلمات

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

الإرجاع

‫LineChartBuilder — هذا المُنشئ مفيد لإنشاء سلاسل.

---

setDataTable(table)

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

المعلمات

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

الإرجاع

‫LineChartBuilder — هذا المُنشئ مفيد لإنشاء سلاسل.

---

setDataViewDefinition(dataViewDefinition)

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

المعلمات

الاسم	النوع	الوصف
dataViewDefinition	DataViewDefinition	عنصر تعريف عرض البيانات الذي يحدِّد العرض الذي يجب أن يتم استخراجه من مصدر البيانات المحدَّد لرسم الرسم البياني

الإرجاع

‫LineChartBuilder — هذا المُنشئ مفيد لإنشاء سلاسل.

---

setDimensions(width, height)

تُستخدَم لضبط سمات الرسم البياني.

المعلمات

الاسم	النوع	الوصف
width	Integer	عرض الرسم البياني، بالبكسل
height	Integer	ارتفاع الرسم البياني، بالبكسل

الإرجاع

‫LineChartBuilder — هذا المُنشئ مفيد لإنشاء سلاسل.

---

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	موضع التسمية التوضيحية

الإرجاع

‫LineChartBuilder — هذا المُنشئ مفيد لإنشاء سلاسل.

---

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	نمط النص المُستخدَم لشرح الرسم البياني.

الإرجاع

‫LineChartBuilder — هذا المُنشئ مفيد لإنشاء سلاسل.

---

setOption(option, value)

لضبط الخيارات المتقدّمة لهذا الرسم البياني. اطّلِع على الخيارات المتاحة لهذا الرسم البياني. لن يكون لهذه الطريقة أي تأثير إذا كان الخيار المحدَّد غير صالح.

// Build a line chart with a 1-second animation duration.
const builder = Charts.newLineChart();
builder.setOption('animation.duration', 1000);
const chart = builder.build();

المعلمات

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

الإرجاع

‫LineChartBuilder — هذا المُنشئ مفيد لإنشاء سلاسل.

---

setPointStyle(style)

تُستخدَم لضبط نمط النقاط في الخط. لا تتضمّن النقاط تلقائيًا أنماطًا معيّنة، ولا يظهر سوى الخط.

// Creates a line chart builder and sets large point style.
const builder = Charts.newLineChart();
builder.setPointStyle(Charts.PointStyle.LARGE);

المعلمات

الاسم	النوع	الوصف
style	PointStyle	النمط الذي سيتم استخدامه للنقاط في الخط

الإرجاع

‫LineChartBuilder — هذا المُنشئ مفيد لإنشاء سلاسل.

انظر أيضًا

• PointStyle

---

setRange(start, end)

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

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

المعلمات

الاسم	النوع	الوصف
start	Number	قيمة أدنى خط شبكة لمحور النطاق
end	Number	قيمة أعلى خط شبكة لمحور النطاق

الإرجاع

‫LineChartBuilder — هذا المُنشئ مفيد لإنشاء سلاسل.

---

setTitle(chartTitle)

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

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

المعلمات

الاسم	النوع	الوصف
chartTitle	String	عنوان الرسم البياني

الإرجاع

‫LineChartBuilder — هذا المُنشئ مفيد لإنشاء سلاسل.

---

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().

الإرجاع

‫LineChartBuilder — هذا المُنشئ مفيد لإنشاء سلاسل.

---

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().

الإرجاع

‫LineChartBuilder — هذا المُنشئ مفيد لإنشاء سلاسل.

---

setXAxisTitle(title)

تضيف عنوانًا إلى المحور الأفقي. يتم وضع العنوان في المنتصف ويظهر أسفل تصنيفات قيمة المحور.

// Creates a line chart builder and sets the X-axis title.
const builder = Charts.newLineChart();
builder.setTitle('X-axis Title');

المعلمات

الاسم	النوع	الوصف
title	String	عنوان المحور X

الإرجاع

‫LineChartBuilder — هذا المُنشئ مفيد لإنشاء سلاسل.

---

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().

الإرجاع

‫LineChartBuilder — هذا المُنشئ مفيد لإنشاء سلاسل.

---

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().

الإرجاع

‫LineChartBuilder — هذا المُنشئ مفيد لإنشاء سلاسل.

---

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

الإرجاع

‫LineChartBuilder — هذا المُنشئ مفيد لإنشاء سلاسل.

---

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().

الإرجاع

‫LineChartBuilder — هذا المُنشئ مفيد لإنشاء سلاسل.

---

useLogScale()

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

الإرجاع

‫LineChartBuilder — هذا المُنشئ مفيد لإنشاء سلاسل.