Class TableChartBuilder

سازنده جدول نمودار

یک سازنده برای نمودارهای جدولی. برای جزئیات بیشتر، به مستندات Google Charts مراجعه کنید.

در اینجا مثالی آورده شده است که نحوه ساخت نمودار جدولی را نشان می‌دهد. داده‌ها از یک صفحه گسترده گوگل وارد شده‌اند .

// 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 Paging(enablePaging) Table Chart Builder تنظیم می‌کند که آیا صفحه‌بندی از طریق داده‌ها فعال شود یا خیر.
enable Paging(pageSize) Table Chart Builder صفحه‌بندی را فعال می‌کند و تعداد سطرها را در هر صفحه تنظیم می‌کند.
enable Paging(pageSize, startPage) Table Chart Builder صفحه‌بندی را فعال می‌کند، تعداد ردیف‌ها در هر صفحه و اولین صفحه جدول را برای نمایش تنظیم می‌کند (شماره صفحات بر اساس صفر است).
enable Rtl Table(rtlEnabled) Table Chart Builder با معکوس کردن ترتیب ستون‌های جدول، پشتیبانی اولیه برای زبان‌های راست به چپ (مانند عربی یا عبری) را اضافه می‌کند، به طوری که ستون صفر، ستون سمت راست و آخرین ستون، ستون سمت چپ است.
enable Sorting(enableSorting) Table Chart Builder تنظیم می‌کند که آیا وقتی کاربر روی عنوان ستون کلیک می‌کند، ستون‌ها مرتب شوند یا خیر.
set Data Source Url(url) Table Chart Builder آدرس اینترنتی منبع داده‌ای را که برای دریافت داده‌ها از یک منبع خارجی، مانند Google Sheets، استفاده می‌شود، تنظیم می‌کند.
set Data Table(tableBuilder) Table Chart Builder با استفاده از DataTableBuilder، جدول داده‌ها را برای استفاده در نمودار تنظیم می‌کند.
set Data Table(table) Table Chart Builder جدول داده‌ها را که شامل خطوط نمودار و همچنین برچسب‌های محور X است، تنظیم می‌کند.
set Data View Definition(dataViewDefinition) Table Chart Builder تعریف نمای داده را برای استفاده در نمودار تنظیم می‌کند.
set Dimensions(width, height) Table Chart Builder ابعاد نمودار را تنظیم می‌کند.
set First Row Number(number) Table Chart Builder شماره ردیف را برای اولین ردیف در جدول داده تنظیم می‌کند.
set Initial Sorting Ascending(column) Table Chart Builder اندیس ستونی را که جدول باید در ابتدا بر اساس آن مرتب‌سازی (صعودی) شود، تنظیم می‌کند.
set Initial Sorting Descending(column) Table Chart Builder اندیس ستونی را که جدول باید در ابتدا بر اساس آن مرتب‌سازی (نزولی) شود، تنظیم می‌کند.
set Option(option, value) Table Chart Builder گزینه‌های پیشرفته‌ای را برای این نمودار تنظیم می‌کند.
show Row Number Column(showRowNumber) Table Chart Builder تعیین می‌کند که آیا شماره ردیف به عنوان اولین ستون جدول نمایش داده شود یا خیر.
use Alternating Row Style(alternate) Table Chart Builder تعیین می‌کند که آیا سبک رنگ متناوب به ردیف‌های زوج و فرد نمودار جدولی اختصاص داده شود یا خیر.

مستندات دقیق

build()

نمودار را می‌سازد.

بازگشت

Chart - یک شیء نمودار که می‌تواند در اسناد، عناصر رابط کاربری تعبیه شود یا به عنوان یک تصویر ثابت استفاده شود.

enablePaging(enablePaging)

تنظیم می‌کند که آیا صفحه‌بندی از طریق داده‌ها فعال شود یا خیر.

رفتار پیش‌فرض، غیرفعال بودن صفحه‌بندی است. اگر صفحه‌بندی فعال باشد، اندازه پیش‌فرض صفحه ۱۰ است.

پارامترها

نام نوع توضیحات
enable Paging Boolean اگر صفحه‌بندی باید فعال باشد، true و در غیر این صورت false برمی‌گرداند.

بازگشت

TableChartBuilder — این سازنده، برای زنجیره‌سازی مفید است.

enablePaging(pageSize)

صفحه‌بندی را فعال می‌کند و تعداد سطرها را در هر صفحه تنظیم می‌کند.

اندازه صفحه پیش‌فرض ۱۰ است.

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

پارامترها

نام نوع توضیحات
page Size Integer تعداد سطرهای هر صفحه از جدول.

بازگشت

TableChartBuilder — این سازنده، برای زنجیره‌سازی مفید است.

enablePaging(pageSize, startPage)

صفحه‌بندی را فعال می‌کند، تعداد ردیف‌ها در هر صفحه و اولین صفحه جدول را برای نمایش تنظیم می‌کند (شماره صفحات بر اساس صفر است).

اندازه پیش‌فرض صفحه ۱۰ و صفحه شروع پیش‌فرض ۰ است.

// 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 Size Integer تعداد سطرهای هر صفحه از جدول.
start Page Integer اولین صفحه جدول که نمایش داده می‌شود (شماره صفحات بر اساس صفر است).

بازگشت

TableChartBuilder — این سازنده، برای زنجیره‌سازی مفید است.

enableRtlTable(rtlEnabled)

با معکوس کردن ترتیب ستون‌های جدول، پشتیبانی اولیه برای زبان‌های راست به چپ (مانند عربی یا عبری) را اضافه می‌کند، به طوری که ستون صفر، ستون سمت راست و آخرین ستون، ستون سمت چپ است.

این موضوع بر شاخص ستون در داده‌های اصلی تأثیری ندارد، فقط ترتیب نمایش را تغییر می‌دهد. نمایش زبان کاملاً دو جهته (BiDi) حتی با این گزینه توسط تجسم جدول پشتیبانی نمی‌شود. اگر صفحه‌بندی (با استفاده از گزینه صفحه) را فعال کنید، یا اگر جدول دارای نوارهای پیمایش باشد، زیرا گزینه‌های ارتفاع و عرض را کوچکتر از اندازه جدول مورد نیاز تعیین کرده‌اید، این گزینه نادیده گرفته می‌شود. رفتار پیش‌فرض، پشتیبانی RTL غیرفعال است.

پارامترها

نام نوع توضیحات
rtl Enabled Boolean اگر پشتیبانی از راست به چپ باید فعال باشد، true و در غیر این صورت false برمی‌گرداند.

بازگشت

TableChartBuilder — این سازنده، برای زنجیره‌سازی مفید است.

enableSorting(enableSorting)

تنظیم می‌کند که آیا وقتی کاربر روی عنوان ستون کلیک می‌کند، ستون‌ها مرتب شوند یا خیر.

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

پارامترها

نام نوع توضیحات
enable Sorting Boolean برای فعال کردن مرتب‌سازی با کلیک روی سرستون‌ها، true و در غیر این صورت false وارد کنید.

بازگشت

TableChartBuilder — این سازنده، برای زنجیره‌سازی مفید است.

setDataSourceUrl(url)

آدرس اینترنتی منبع داده‌ای را که برای دریافت داده‌ها از یک منبع خارجی، مانند Google Sheets، استفاده می‌شود، تنظیم می‌کند. اگر آدرس اینترنتی منبع داده و یک DataTable ارائه شوند، آدرس اینترنتی منبع داده نادیده گرفته می‌شود.

برای اطلاعات بیشتر در مورد جستجوی منابع داده، مستندات Google Charts را بررسی کنید.

پارامترها

نام نوع توضیحات
url String آدرس اینترنتی منبع داده، شامل هر پارامتر پرس و جو.

بازگشت

TableChartBuilder — این سازنده، برای زنجیره‌سازی مفید است.

setDataTable(tableBuilder)

جدول داده‌ها را برای استفاده در نمودار با استفاده از DataTableBuilder تنظیم می‌کند. این یک روش راحت برای تنظیم جدول داده‌ها بدون نیاز به فراخوانی build() است.

پارامترها

نام نوع توضیحات
table Builder Data Table Builder یک سازنده جدول داده. یک جدول داده جدید فوراً به عنوان بخشی از این فراخوانی ایجاد می‌شود، بنابراین هرگونه به‌روزرسانی بیشتر در سازنده در نمودار منعکس نخواهد شد.

بازگشت

TableChartBuilder — این سازنده، برای زنجیره‌سازی مفید است.

setDataTable(table)

جدول داده‌ها را که شامل خطوط نمودار و همچنین برچسب‌های محور X است، تنظیم می‌کند. ستون اول باید یک رشته باشد و شامل برچسب‌های محور افقی باشد. هر تعداد ستون می‌تواند در ادامه بیاید، همه باید عددی باشند. هر ستون به صورت یک خط جداگانه نمایش داده می‌شود.

پارامترها

نام نوع توضیحات
table Data Table Source جدول داده‌هایی که برای نمودار استفاده می‌شوند.

بازگشت

TableChartBuilder — این سازنده، برای زنجیره‌سازی مفید است.

setDataViewDefinition(dataViewDefinition)

تعریف نمای داده را برای استفاده در نمودار تنظیم می‌کند.

پارامترها

نام نوع توضیحات
data View Definition Data View Definition یک شیء تعریف نمای داده که نمایی را که باید از منبع داده داده شده برای ترسیم نمودار استخراج شود، تعریف می‌کند.

بازگشت

TableChartBuilder — این سازنده، برای زنجیره‌سازی مفید است.

setDimensions(width, height)

ابعاد نمودار را تنظیم می‌کند.

پارامترها

نام نوع توضیحات
width Integer عرض نمودار، بر حسب پیکسل.
height Integer ارتفاع نمودار، بر حسب پیکسل.

بازگشت

TableChartBuilder — این سازنده، برای زنجیره‌سازی مفید است.

setFirstRowNumber(number)

شماره ردیف را برای اولین ردیف در جدول داده تنظیم می‌کند.

شماره ردیف پیش‌فرض ردیف اول ۱ است.

// 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)

اندیس ستونی را که جدول باید در ابتدا بر اساس آن مرتب‌سازی (صعودی) شود، تنظیم می‌کند.

ستون os به ترتیب صعودی مرتب شده و با یک فلش کوچک مشخص شده است که نشان دهنده آن است.

// 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)

اندیس ستونی را که جدول باید در ابتدا بر اساس آن مرتب‌سازی (نزولی) شود، تنظیم می‌کند.

ستون os به ترتیب نزولی مرتب شده و با یک فلش کوچک علامت گذاری شده است که نشان دهنده این است.

// 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)

تعیین می‌کند که آیا شماره ردیف به عنوان اولین ستون جدول نمایش داده شود یا خیر.

رفتار پیش‌فرض، نمایش شماره ردیف‌ها نیست.

پارامترها

نام نوع توضیحات
show Row Number Boolean اگر ستون اول جدول باید شماره ردیف را نشان دهد، true و در غیر این صورت false برمی‌گرداند.

بازگشت

TableChartBuilder — این سازنده، برای زنجیره‌سازی مفید است.

useAlternatingRowStyle(alternate)

تعیین می‌کند که آیا سبک رنگ متناوب به ردیف‌های زوج و فرد نمودار جدولی اختصاص داده شود یا خیر.

رفتار پیش‌فرض این است که ردیف‌ها سبک رنگ متناوب داشته باشند.

پارامترها

نام نوع توضیحات
alternate Boolean اگر سبک‌های رنگ باید متناوب باشند، true و در غیر این صورت false برمی‌گرداند.

بازگشت

TableChartBuilder — این سازنده، برای زنجیره‌سازی مفید است.