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

روش ها

روش نوع برگشت شرح مختصر
add Column(type, label) Data Table Builder یک ستون به جدول داده ها اضافه می کند.
add Row(values) Data Table Builder یک ردیف به جدول داده ها اضافه می کند.
build() Data Table جدول داده را می سازد و برمی گرداند.
set Value(row, column, value) Data Table Builder مقدار خاصی را در جدول تعیین می کند.

مستندات دقیق

add Column(type, label)

یک ستون به جدول داده ها اضافه می کند. ستون ها از 0 تا n اضافه خواهند شد.

ستون اول اغلب توسط نمودارها برای برچسب ها استفاده می شود (به عنوان مثال، برچسب های محور X در نمودارهای خطی، یا برچسب های برش در نمودارهای دایره ای). ستون های دیگر اغلب برای داده ها استفاده می شوند و بنابراین اغلب به مقادیر عددی نیاز دارند.

پارامترها

نام تایپ کنید توضیحات
type Column Type نوع داده در ستون (عدد، رشته یا تاریخ)
label String برچسب ستون (برای افسانه های نمودار استفاده می شود).

بازگشت

Data Table Builder - این سازنده، برای زنجیر کردن.

add Row(values)

یک ردیف به جدول داده ها اضافه می کند.

پارامترها

نام تایپ کنید توضیحات
values Object[] مقادیر برای سطر، به همان ترتیبی که ستون‌ها وارد می‌شوند مشخص شده‌اند.

بازگشت

Data Table Builder - این سازنده، برای زنجیر کردن.

build()

جدول داده را می سازد و برمی گرداند.

بازگشت

Data Table - جدول داده ها

پرتاب می کند

Error - اگر جدول داده ها خالی یا بد شکل باشد

set Value(row, column, value)

مقدار خاصی را در جدول تعیین می کند.

می توانید قبل از اضافه کردن ستون به جدول داده ها، مقداری را تعیین کنید. با این حال، مگر اینکه ستون در نقطه ای اضافه شود، مقدار نادیده گرفته می شود.

همه مقادیر null نیازی به پر کردن ندارند.

پارامترها

نام تایپ کنید توضیحات
row Integer شاخص ردیف (ردیف اول دارای شاخص 0 است)
column Integer نمایه ستون (ستون اول دارای شاخص 0 است)
value Object مقدار سلول جدول (باید نوع مناسب ستون را داشته باشد).

بازگشت

Data Table Builder - این سازنده، برای زنجیر کردن