أداة إنشاء للرسوم البيانية في الجداول لمزيد من التفاصيل، يُرجى الاطّلاع على مستندات "رسومات 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 | إنشاء الرسم البياني | 
| enable | Table | لتحديد ما إذا كان سيتم تفعيل التنقل بين صفحات البيانات. | 
| enable | Table | تفعِّل ميزة تقسيم الصفحات وتضبط عدد الصفوف في كل صفحة. | 
| enable | Table | تفعِّل هذه السمة تقسيم الصفحات، وتحدِّد عدد الصفوف في كل صفحة وصفحة الجدول الأولى التي يتم عرضها (تستند أرقام الصفحات إلى الصفر). | 
| enable | Table | توفّر ميزة أساسية للّغات التي تُكتب من اليمين إلى اليسار (مثل العربية أو العبرية) من خلال عكس ترتيب أعمدة الجدول، بحيث يكون العمود صفر هو العمود الأيمن، والعمود الأخير هو العمود الأيسر. | 
| enable | Table | لضبط ما إذا كان سيتم ترتيب الأعمدة عندما ينقر المستخدم على عنوان عمود. | 
| set | Table | لضبط عنوان URL لمصدر البيانات المستخدَم لسحب البيانات من مصدر خارجي، مثل "جداول بيانات Google". | 
| set | Table | تُستخدَم هذه الطريقة لضبط جدول البيانات الذي سيتم استخدامه في الرسم البياني باستخدام DataTableBuilder. | 
| set | Table | تُستخدَم لضبط جدول البيانات الذي يحتوي على خطوط الرسم البياني، بالإضافة إلى تصنيفات محور السّين. | 
| set | Table | لضبط تعريف عرض البيانات المراد استخدامه في الرسم البياني | 
| set | Table | تُستخدَم لضبط سمات الرسم البياني. | 
| set | Table | لتحديد رقم الصف الأول في جدول البيانات | 
| set | Table | لضبط فهرس العمود الذي يجب ترتيب الجدول وفقًا له في البداية (تصاعديًا). | 
| set | Table | لضبط فهرس العمود الذي يجب ترتيب الجدول وفقًا له في البداية (تنازليًا). | 
| set | Table | لضبط الخيارات المتقدّمة لهذا الرسم البياني. | 
| show | Table | لتحديد ما إذا كان سيتم عرض رقم الصف كأول عمود في الجدول. | 
| use | Table | لتحديد ما إذا كان سيتم تعيين نمط الألوان المتناوبة للصفوف الفردية والزوجية في الرسم البياني للجدول. | 
مستندات تفصيلية
build()
إنشاء الرسم البياني
الإرجاع
Chart - عنصر رسم بياني، يمكن تضمينه في المستندات أو عناصر واجهة المستخدم أو استخدامه كصورة ثابتة.
enable
لتحديد ما إذا كان سيتم تفعيل التنقل بين صفحات البيانات.
السلوك التلقائي هو إيقاف تقسيم الصفحة. إذا كان تقسيم الصفحة مفعّلاً، يكون حجم الصفحة التلقائي 10.
المعلمات
| الاسم | النوع | الوصف | 
|---|---|---|
| enable | Boolean |  trueإذا كان يجب تفعيل تقسيم الصفحة،falseفي حال عدم تفعيلها | 
الإرجاع
Table — هذا المُنشئ مفيد لإنشاء سلاسل.
enable
تفعِّل ميزة تقسيم الصفحات وتضبط عدد الصفوف في كل صفحة.
حجم الصفحة التلقائي هو 10.
// Creates a table chart builder and enables paging with page size of 5. const builder = Charts.newTableChart(); builder.enablePaging(5);
المعلمات
| الاسم | النوع | الوصف | 
|---|---|---|
| page | Integer | عدد الصفوف في كل صفحة من الجدول | 
الإرجاع
Table — هذا المُنشئ مفيد لإنشاء سلاسل.
enable
تفعِّل ميزة تقسيم الصفحات، وتحدِّد عدد الصفوف في كل صفحة وصفحة الجدول الأولى التي يتم عرضها (أرقام الصفحات تستند إلى الصفر).
حجم الصفحة التلقائي هو 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);
المعلمات
| الاسم | النوع | الوصف | 
|---|---|---|
| page | Integer | عدد الصفوف في كل صفحة من الجدول | 
| start | Integer | صفحة الجدول الأولى التي يتم عرضها (أرقام الصفحات تستند إلى الصفر). | 
الإرجاع
Table — هذا المُنشئ مفيد لإنشاء سلاسل.
enable
توفّر ميزة "العرض من اليمين إلى اليسار" الأساسية للّغات التي تُكتب من اليمين إلى اليسار (مثل العربية أو العبرية) من خلال عكس ترتيب الأعمدة في الجدول، بحيث يكون العمود صفر هو العمود الأيمن، والعمود الأخير هو العمود الأيسر.
ولا يؤثّر ذلك في فهرس العمود في البيانات الأساسية، بل في ترتيب العرض فقط. لا تتيح ميزة العرض المرئي للجدول عرض اللغة بالكامل بالاتجاهَين (BiDi) حتى مع هذا الخيار. يتم تجاهل هذا الخيار في حال تفعيل التنقل في الصفحات (باستخدام خيار الصفحة)، أو إذا كان جدول البيانات يحتوي على أشرطة تمرير لأنّك حدّدت خيارات الارتفاع والعرض أصغر من حجم الجدول المطلوب. السلوك التلقائي هو إيقاف إتاحة RTL.
المعلمات
| الاسم | النوع | الوصف | 
|---|---|---|
| rtl | Boolean | trueإذا كان يجب تفعيل ميزة الكتابة من اليمين إلى اليسار،falseفي الحالات الأخرى | 
الإرجاع
Table — هذا المُنشئ مفيد لإنشاء سلاسل.
enable
لضبط ما إذا كان سيتم ترتيب الأعمدة عندما ينقر المستخدم على عنوان عمود.
في حال تفعيل الترتيب، يتم ترتيب الصفوف تلقائيًا عند نقر المستخدمين على عنوان العمود. السلوك التلقائي هو تفعيل الترتيب.
المعلمات
| الاسم | النوع | الوصف | 
|---|---|---|
| enable | Boolean | trueلتفعيل الترتيب من خلال النقر على عناوين الأعمدة،falseبخلاف ذلك. | 
الإرجاع
Table — هذا المُنشئ مفيد لإنشاء سلاسل.
set
لضبط عنوان URL لمصدر البيانات المستخدَم لسحب البيانات من مصدر خارجي، مثل "جداول بيانات Google". في حال تقديم عنوان URL لمصدر بيانات وDataTable، يتم تجاهل عنوان URL لمصدر البيانات.
لمزيد من المعلومات عن طلب بيانات من مصادر البيانات، يمكنك الاطّلاع على مستندات "رسومات Google".
المعلمات
| الاسم | النوع | الوصف | 
|---|---|---|
| url | String | عنوان URL لمصدر البيانات، بما في ذلك أي مَعلمات طلب بحث | 
الإرجاع
Table — هذا المُنشئ مفيد لإنشاء سلاسل.
set
تُستخدَم هذه الطريقة لضبط جدول البيانات الذي سيتم استخدامه في الرسم البياني باستخدام DataTableBuilder. هذه طريقة سهلة
لضبط جدول البيانات بدون الحاجة إلى استدعاء build().
المعلمات
| الاسم | النوع | الوصف | 
|---|---|---|
| table | Data | أداة إنشاء جداول البيانات يتم إنشاء جدول بيانات جديد على الفور كجزء من هذا الطلب، لذا لن تظهر أي تعديلات أخرى على أداة الإنشاء في الرسم البياني. | 
الإرجاع
Table — هذا المُنشئ مفيد لإنشاء سلاسل.
set
تُستخدَم لضبط جدول البيانات الذي يحتوي على خطوط الرسم البياني، بالإضافة إلى تصنيفات محور السّين. يجب أن يكون العمود الأول سلسلة، وأن يحتوي على تصنيفات المحور الأفقي. يمكن أن يتبع ذلك أي عدد من الأعمدة ، ويجب أن تكون جميعها رقمية. يتم عرض كل عمود كخط منفصل.
المعلمات
| الاسم | النوع | الوصف | 
|---|---|---|
| table | Data | جدول البيانات المراد استخدامه في الرسم البياني | 
الإرجاع
Table — هذا المُنشئ مفيد لإنشاء سلاسل.
set
لضبط تعريف عرض البيانات المراد استخدامه في الرسم البياني
المعلمات
| الاسم | النوع | الوصف | 
|---|---|---|
| data | Data | عنصر تعريف عرض البيانات الذي يحدِّد العرض الذي يجب أن يتم استخراجه من مصدر البيانات المحدَّد لرسم الرسم البياني | 
الإرجاع
Table — هذا المُنشئ مفيد لإنشاء سلاسل.
set
تُستخدَم لضبط سمات الرسم البياني.
المعلمات
| الاسم | النوع | الوصف | 
|---|---|---|
| width | Integer | عرض الرسم البياني، بالبكسل | 
| height | Integer | ارتفاع الرسم البياني، بالبكسل | 
الإرجاع
Table — هذا المُنشئ مفيد لإنشاء سلاسل.
set
لتحديد رقم الصف الأول في جدول البيانات
رقم الصف التلقائي للصف الأول هو 1.
// Creates a table chart builder and sets the first row to be 2. const builder = Charts.newTableChart(); builder.setFirstRowNumber(2);
المعلمات
| الاسم | النوع | الوصف | 
|---|---|---|
| number | Integer | رقم الصف الأول في جدول البيانات | 
الإرجاع
Table — هذا المُنشئ مفيد لإنشاء سلاسل.
set
لضبط فهرس العمود الذي يجب ترتيب الجدول وفقًا له في البداية (تصاعديًا).
تم ترتيب العمود تصاعديًا ويتم وضع سهم صغير عليه يشير إلى ذلك.
// Creates a table chart builder and sorts it by the second column (ascending). const builder = Charts.newTableChart(); builder.setInitialSortingAscending(2);
المعلمات
| الاسم | النوع | الوصف | 
|---|---|---|
| column | Integer | رقم العمود الذي يجب ترتيب الجدول وفقًا له في البداية. | 
الإرجاع
Table — هذا المُنشئ مفيد لإنشاء سلاسل.
set
لضبط فهرس العمود الذي يجب ترتيب الجدول وفقًا له في البداية (تنازليًا).
تم ترتيب العمود تنازليًا ويتم وضع سهم صغير عليه يشير إلى ذلك.
// Creates a table chart builder and sorts it by the second column (descending). const builder = Charts.newTableChart(); builder.setInitialSortingDescending(2);
المعلمات
| الاسم | النوع | الوصف | 
|---|---|---|
| column | Integer | رقم العمود الذي يجب ترتيب الجدول وفقًا له في البداية. | 
الإرجاع
Table — هذا المُنشئ مفيد لإنشاء سلاسل.
set
لضبط الخيارات المتقدّمة لهذا الرسم البياني. اطّلِع على الخيارات المتاحة لهذا الرسم البياني. لن يكون لهذه الطريقة أي تأثير إذا كان الخيار المحدَّد غير صالح.
// Build a table chart which renders HTML. const builder = Charts.newTableChart(); builder.setOption('allowHtml', {@code true}); const chart = builder.build();
المعلمات
| الاسم | النوع | الوصف | 
|---|---|---|
| option | String | خيار الضبط | 
| value | Object | القيمة المطلوب ضبطها | 
الإرجاع
Table — هذا المُنشئ مفيد لإنشاء سلاسل.
show
لتحديد ما إذا كان سيتم عرض رقم الصف كأول عمود في الجدول.
لا يعرض السلوك التلقائي أرقام الصفوف.
المعلمات
| الاسم | النوع | الوصف | 
|---|---|---|
| show | Boolean | trueإذا كان يجب أن يعرض العمود الأول من الجدول رقم الصف،falseبخلاف ذلك. | 
الإرجاع
Table — هذا المُنشئ مفيد لإنشاء سلاسل.
use
لتحديد ما إذا كان سيتم تعيين نمط الألوان المتناوبة للصفوف الفردية والزوجية في الرسم البياني للجدول.
السلوك التلقائي هو أن يكون للصفوف نمط ألوان متغيّر.
المعلمات
| الاسم | النوع | الوصف | 
|---|---|---|
| alternate | Boolean |  trueإذا كان يجب أن تكون أنماط الألوان بديلة،falseبخلاف ذلك | 
الإرجاع
Table — هذا المُنشئ مفيد لإنشاء سلاسل.