Class DataTableBuilder
تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
أداةإنشاءجداول البيانات
أداة إنشاء كائنات DataTable يتكون إنشاء جدول بيانات من تحديد أعمدةه أولاً، ثم
إضافة صفوفه واحدًا تلو الآخر. مثال:
const data = Charts.newDataTable()
.addColumn(Charts.ColumnType.STRING, 'Month')
.addColumn(Charts.ColumnType.NUMBER, 'In Store')
.addColumn(Charts.ColumnType.NUMBER, 'Online')
.addRow(['January', 10, 1])
.addRow(['February', 12, 1])
.addRow(['March', 20, 2])
.addRow(['April', 25, 3])
.addRow(['May', 30, 4])
.build();
مستندات تفصيلية
addColumn(type, label)
تُضيف هذه الدالة عمودًا إلى جدول البيانات. ستتم إضافة الأعمدة من 0 إلى n.
غالبًا ما تستخدم الرسوم البيانية العمود الأول لتصنيف البيانات (على سبيل المثال، تصنيفات محور X في الرسوم البيانية الخطية أو تصنيفات الشرائح في الرسوم البيانية الدائرية). غالبًا ما تُستخدَم الأعمدة الأخرى للبيانات، وبالتالي تحتاج عادةً إلى قيم رقمية.
المعلمات
| الاسم | النوع | الوصف |
type | ColumnType | نوع البيانات في العمود (رقم أو سلسلة أو تاريخ) |
label | String | تصنيف العمود (يُستخدَم في ترجمة وشرح الرسم البياني). |
الإرجاع
DataTableBuilder: أداة الإنشاء هذه لإنشاء سلسلة.
addRow(values)
تُضيف صفًا إلى جدول البيانات.
المعلمات
| الاسم | النوع | الوصف |
values | Object[] | قيم الصف المحدّدة بالترتيب نفسه الذي يتم إدخال الأعمدة به |
الإرجاع
DataTableBuilder: أداة الإنشاء هذه لإنشاء سلسلة.
build()
تُنشئ جدول بيانات وتُعرِضه.
الإرجاع
DataTable - جدول البيانات
عمليات الرمي
Error - إذا كان جدول البيانات فارغًا أو غير صالح
setValue(row, column, value)
لضبط قيمة معيّنة في الجدول
يمكنك ضبط قيمة قبل إضافة العمود إلى جدول البيانات. ومع ذلك، سيتم تجاهل القيمة ما لم تتم إضافة العمود في مرحلة ما.
لا يلزم ملء جميع قيم الأعمدة. وسيتم اعتبار العناصر غير المتوفّرة null.
المعلمات
| الاسم | النوع | الوصف |
row | Integer | فهرس الصف (يحمل الصف الأول الفهرس 0) |
column | Integer | فهرس العمود (يحمل العمود الأول الفهرس 0) |
value | Object | قيمة خلية الجدول (يجب أن يكون لها النوع الصحيح للعمود) |
الإرجاع
DataTableBuilder — هذا المُنشئ، لتسلسل العناصر
إنّ محتوى هذه الصفحة مرخّص بموجب ترخيص Creative Commons Attribution 4.0 ما لم يُنصّ على خلاف ذلك، ونماذج الرموز مرخّصة بموجب ترخيص Apache 2.0. للاطّلاع على التفاصيل، يُرجى مراجعة سياسات موقع Google Developers. إنّ Java هي علامة تجارية مسجَّلة لشركة Oracle و/أو شركائها التابعين.
تاريخ التعديل الأخير: 2025-07-26 (حسب التوقيت العالمي المتفَّق عليه)
[null,null,["تاريخ التعديل الأخير: 2025-07-26 (حسب التوقيت العالمي المتفَّق عليه)"],[[["\u003cp\u003eDataTableBuilder facilitates the creation of DataTable objects by defining columns and adding rows sequentially.\u003c/p\u003e\n"],["\u003cp\u003eColumns are defined using \u003ccode\u003eaddColumn\u003c/code\u003e with specified data type and label, and rows are added using \u003ccode\u003eaddRow\u003c/code\u003e with corresponding values.\u003c/p\u003e\n"],["\u003cp\u003e\u003ccode\u003ebuild\u003c/code\u003e method finalizes the DataTable construction and returns the resulting object.\u003c/p\u003e\n"],["\u003cp\u003e\u003ccode\u003esetValue\u003c/code\u003e allows modification of individual cell values within the table by specifying row, column, and the new value.\u003c/p\u003e\n"],["\u003cp\u003eDataTableBuilder uses a chaining pattern, where method calls can be linked for streamlined table construction.\u003c/p\u003e\n"]]],[],null,["# Class DataTableBuilder\n\nDataTableBuilder\n\nBuilder of DataTable objects. Building a data table consists of first specifying its columns, and\nthen adding its rows, one at a time. Example:\n\n```javascript\nconst data = Charts.newDataTable()\n .addColumn(Charts.ColumnType.STRING, 'Month')\n .addColumn(Charts.ColumnType.NUMBER, 'In Store')\n .addColumn(Charts.ColumnType.NUMBER, 'Online')\n .addRow(['January', 10, 1])\n .addRow(['February', 12, 1])\n .addRow(['March', 20, 2])\n .addRow(['April', 25, 3])\n .addRow(['May', 30, 4])\n .build();\n``` \n\n### Methods\n\n| Method | Return type | Brief description |\n|-------------------------------------------------------------------|-------------------------------------------------------|-------------------------------------|\n| [addColumn(type, label)](#addColumn(ColumnType,String)) | [DataTableBuilder](#) | Adds a column to the data table. |\n| [addRow(values)](#addRow(Object)) | [DataTableBuilder](#) | Adds a row to the data table. |\n| [build()](#build()) | [DataTable](/apps-script/reference/charts/data-table) | Builds and returns a data table. |\n| [setValue(row, column, value)](#setValue(Integer,Integer,Object)) | [DataTableBuilder](#) | Sets a specific value in the table. |\n\nDetailed documentation\n----------------------\n\n### `add``Column(type, label)`\n\nAdds a column to the data table. Columns will be added from 0 to n.\n\nThe first column is often used by charts for labels (for instance, X-axis labels on line\ncharts, or slice labels in pie charts). The other columns are often used for data and therefore\noften require numeric values.\n\n#### Parameters\n\n| Name | Type | Description |\n|---------|---------------------------------------------------------|------------------------------------------------------|\n| `type` | [ColumnType](/apps-script/reference/charts/column-type) | type of data in the column (number, string, or date) |\n| `label` | `String` | label of the column (it's used for chart legends). |\n\n#### Return\n\n\n[DataTableBuilder](#) --- this builder, for chaining.\n\n*** ** * ** ***\n\n### `add``Row(values)`\n\nAdds a row to the data table.\n\n#### Parameters\n\n| Name | Type | Description |\n|----------|------------|-------------------------------------------------------------------------------|\n| `values` | `Object[]` | values for the row, specified in the same order that the columns are entered. |\n\n#### Return\n\n\n[DataTableBuilder](#) --- this builder, for chaining.\n\n*** ** * ** ***\n\n### `build()`\n\nBuilds and returns a data table.\n\n#### Return\n\n\n[DataTable](/apps-script/reference/charts/data-table) --- the data table\n\n#### Throws\n\n\n[`Error`](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Error) --- if the data table is empty or otherwise malformed\n\n*** ** * ** ***\n\n### `set``Value(row, column, value)`\n\nSets a specific value in the table.\n\nYou may set a value before adding the column to the data table. However, unless the column\nis added at some point, the value will be ignored.\n\nNot all column values need to be filled in. Those missing will be considered `null`.\n\n#### Parameters\n\n| Name | Type | Description |\n|----------|-----------|--------------------------------------------------------------------------|\n| `row` | `Integer` | the row index (the first row has index 0) |\n| `column` | `Integer` | the column index (the first column has index 0) |\n| `value` | `Object` | the value of the table cell (should have the right type for the column). |\n\n#### Return\n\n\n[DataTableBuilder](#) --- this builder, for chaining"]]
