Class TableChartBuilder

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)

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

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

المَعلمات

الاسم	النوع	الوصف
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: أداة إنشاء مفيدة للتسلسل