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

Class TableChartBuilder

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

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

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

const chartBuilder = Charts.newTableChart()
                         .setDimensions(600, 500)
                         .enablePaging(20)
                         .setDataSourceUrl(dataSourceUrl);

const chart = chartBuilder.build();

الطُرق

الطريقة	نوع القيمة التي يتم عرضها	وصف قصير
`build()`	`Chart`	إنشاء الرسم البياني
`enablePaging(enablePaging)`	`TableChartBuilder`	لتحديد ما إذا كان سيتم تفعيل التنقل بين صفحات البيانات.
`enablePaging(pageSize)`	`TableChartBuilder`	تفعِّل ميزة تقسيم الصفحات وتضبط عدد الصفوف في كل صفحة.
`enablePaging(pageSize, startPage)`	`TableChartBuilder`	تفعِّل ميزة تقسيم الصفحات، وتحدِّد عدد الصفوف في كل صفحة وصفحة الجدول الأولى التي سيتم عرضها (أرقام الصفحات تستند إلى الصفر).
`enableRtlTable(rtlEnabled)`	`TableChartBuilder`	توفّر ميزة أساسية للّغات التي تُكتب من اليمين إلى اليسار (مثل العربية أو العبرية) من خلال عكس ترتيب أعمدة الجدول، بحيث يكون العمود صفر هو العمود الأيمن، والعمود الأخير هو العمود الأيسر.
`enableSorting(enableSorting)`	`TableChartBuilder`	لضبط ما إذا كان سيتم ترتيب الأعمدة عندما ينقر المستخدم على عنوان عمود.
`setDataSourceUrl(url)`	`TableChartBuilder`	لضبط عنوان URL لمصدر البيانات المستخدَم لسحب البيانات من مصدر خارجي، مثل "جداول بيانات Google".
`setDataTable(tableBuilder)`	`TableChartBuilder`	تُستخدَم هذه الطريقة لضبط جدول البيانات الذي سيتم استخدامه في الرسم البياني باستخدام DataTableBuilder.
`setDataTable(table)`	`TableChartBuilder`	تُستخدَم لضبط جدول البيانات الذي يحتوي على خطوط الرسم البياني، بالإضافة إلى تصنيفات محور السّين.
`setDataViewDefinition(dataViewDefinition)`	`TableChartBuilder`	لضبط تعريف عرض البيانات المراد استخدامه في الرسم البياني
`setDimensions(width, height)`	`TableChartBuilder`	تُستخدَم لضبط سمات الرسم البياني.
`setFirstRowNumber(number)`	`TableChartBuilder`	لتحديد رقم الصف الأول في جدول البيانات
`setInitialSortingAscending(column)`	`TableChartBuilder`	لضبط فهرس العمود الذي يجب ترتيب الجدول وفقًا له في البداية (تصاعديًا).
`setInitialSortingDescending(column)`	`TableChartBuilder`	لضبط فهرس العمود الذي يجب ترتيب الجدول وفقًا له في البداية (تنازليًا).
`setOption(option, value)`	`TableChartBuilder`	لضبط الخيارات المتقدّمة لهذا الرسم البياني
`showRowNumberColumn(showRowNumber)`	`TableChartBuilder`	لتحديد ما إذا كان سيتم عرض رقم الصف كأول عمود في الجدول.
`useAlternatingRowStyle(alternate)`	`TableChartBuilder`	لتحديد ما إذا كان سيتم تعيين نمط الألوان المتناوبة للصفوف الفردية والزوجية في الرسم البياني للجدول.

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

`build()`

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

الإرجاع

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

`enablePaging(enablePaging)`

لتحديد ما إذا كان سيتم تفعيل التنقل بين صفحات البيانات.

السلوك التلقائي هو إيقاف تقسيم الصفحة. إذا كان تقسيم الصفحة مفعّلاً، يكون حجم الصفحة التلقائي 10.

المعلمات

الاسم	النوع	الوصف
`enablePaging`	`Boolean`	‫`true` إذا كان يجب تفعيل تقسيم الصفحة، `false` في حال عدم تفعيلها

الإرجاع

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

`enablePaging(pageSize)`

تفعِّل ميزة تقسيم الصفحات وتضبط عدد الصفوف في كل صفحة.

حجم الصفحة التلقائي هو 10.

// Creates a table chart builder and enables paging with page size of 5.
const builder = Charts.newTableChart();
builder.enablePaging(5);

المعلمات

الاسم	النوع	الوصف
`pageSize`	`Integer`	عدد الصفوف في كل صفحة من الجدول

الإرجاع

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

`enablePaging(pageSize, startPage)`

تفعِّل ميزة تقسيم الصفحات، وتحدِّد عدد الصفوف في كل صفحة وصفحة الجدول الأولى التي سيتم عرضها (أرقام الصفحات تستند إلى الصفر).

حجم الصفحة التلقائي هو 10، وتكون الصفحة التلقائية التي تبدأ بها هي 0.

// Creates a table chart builder and enables paging with page size of 5 and
// displays page 2 first.
const builder = Charts.newTableChart();
builder.enablePaging(5, 2);

المعلمات

الاسم	النوع	الوصف
`pageSize`	`Integer`	عدد الصفوف في كل صفحة من الجدول
`startPage`	`Integer`	صفحة الجدول الأولى التي يتم عرضها (أرقام الصفحات تستند إلى الصفر).

الإرجاع

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

`enableRtlTable(rtlEnabled)`

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

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

المعلمات

الاسم	النوع	الوصف
`rtlEnabled`	`Boolean`	`true` إذا كان يجب تفعيل ميزة الكتابة من اليمين إلى اليسار، `false` في حال عدم تفعيلها

الإرجاع

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

`enableSorting(enableSorting)`

لضبط ما إذا كان سيتم ترتيب الأعمدة عندما ينقر المستخدم على عنوان عمود.

في حال تفعيل الترتيب، يتم ترتيب الصفوف تلقائيًا عند نقر المستخدمين على عنوان العمود. السلوك التلقائي هو تفعيل الترتيب.

المعلمات

الاسم	النوع	الوصف
`enableSorting`	`Boolean`	`true` لتفعيل الترتيب من خلال النقر على عناوين الأعمدة، `false` في حال عدم تفعيله

الإرجاع

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

`setDataSourceUrl(url)`

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

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

المعلمات

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

الإرجاع

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

`setDataTable(tableBuilder)`

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

المعلمات

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

الإرجاع

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

`setDataTable(table)`

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

المعلمات

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

الإرجاع

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

`setDataViewDefinition(dataViewDefinition)`

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

المعلمات

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

الإرجاع

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

`setDimensions(width, height)`

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

المعلمات

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

الإرجاع

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

`setFirstRowNumber(number)`

لتحديد رقم الصف الأول في جدول البيانات

رقم الصف التلقائي للصف الأول هو 1.

// Creates a table chart builder and sets the first row to be 2.
const builder = Charts.newTableChart();
builder.setFirstRowNumber(2);

المعلمات

الاسم	النوع	الوصف
`number`	`Integer`	رقم الصف الأول في جدول البيانات

الإرجاع

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

`setInitialSortingAscending(column)`

لضبط فهرس العمود الذي يجب ترتيب الجدول وفقًا له في البداية (تصاعديًا).

تم ترتيب العمود تصاعديًا وتم وضع سهم صغير عليه يشير إلى ذلك.

// Creates a table chart builder and sorts it by the second column (ascending).
const builder = Charts.newTableChart();
builder.setInitialSortingAscending(2);

المعلمات

الاسم	النوع	الوصف
`column`	`Integer`	رقم العمود الذي يجب ترتيب الجدول وفقًا له في البداية.

الإرجاع

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

`setInitialSortingDescending(column)`

لضبط فهرس العمود الذي يجب ترتيب الجدول وفقًا له في البداية (تنازليًا).

تم ترتيب العمود تنازليًا وتم وضع سهم صغير عليه يشير إلى ذلك.

// Creates a table chart builder and sorts it by the second column (descending).
const builder = Charts.newTableChart();
builder.setInitialSortingDescending(2);

المعلمات

الاسم	النوع	الوصف
`column`	`Integer`	رقم العمود الذي يجب ترتيب الجدول وفقًا له في البداية.

الإرجاع

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

`setOption(option, value)`

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

// Build a table chart which renders HTML.
const builder = Charts.newTableChart();
builder.setOption('allowHtml', {@code true});
const chart = builder.build();

المعلمات

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

الإرجاع

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

`showRowNumberColumn(showRowNumber)`

لتحديد ما إذا كان سيتم عرض رقم الصف كأول عمود في الجدول.

لا يعرض السلوك التلقائي أرقام الصفوف.

المعلمات

الاسم	النوع	الوصف
`showRowNumber`	`Boolean`	`true` إذا كان يجب أن يعرض العمود الأول من الجدول رقم الصف، `false` بخلاف ذلك.

الإرجاع

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

`useAlternatingRowStyle(alternate)`

لتحديد ما إذا كان سيتم تعيين نمط الألوان المتناوبة للصفوف الفردية والزوجية في الرسم البياني للجدول.

السلوك التلقائي هو أنّ الصفوف لها نمط ألوان متغيّر.

المعلمات

الاسم	النوع	الوصف
`alternate`	`Boolean`	`true` إذا كان يجب أن تكون أنماط الألوان بديلة، `false` بخلاف ذلك.

الإرجاع

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