Class 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 نمودار را می سازد.
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 URL منبع داده را تنظیم می کند که برای وارد کردن داده ها از یک منبع خارجی مانند 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 - یک شی نمودار، که می تواند در اسناد، عناصر رابط کاربری جاسازی شود یا به عنوان یک تصویر ثابت استفاده شود.

enable Paging(enablePaging)

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

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

پارامترها

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

بازگشت

Table Chart Builder - این سازنده، برای زنجیر کردن مفید است.

enable Paging(pageSize)

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

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

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

پارامترها

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

بازگشت

Table Chart Builder - این سازنده، برای زنجیر کردن مفید است.

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

پارامترها

نام تایپ کنید توضیحات
page Size Integer تعداد سطرها در هر صفحه از جدول.
start Page Integer اولین صفحه جدولی که نمایش داده می شود (اعداد صفحات بر اساس صفر هستند).

بازگشت

Table Chart Builder - این سازنده، برای زنجیر کردن مفید است.

enable Rtl Table(rtlEnabled)

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

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

پارامترها

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

بازگشت

Table Chart Builder - این سازنده، برای زنجیر کردن مفید است.

enable Sorting(enableSorting)

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

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

پارامترها

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

بازگشت

Table Chart Builder - این سازنده ، برای زنجیره ای مفید است.

set Data Source Url(url)

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

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

پارامترها

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

بازگشت

Table Chart Builder - این سازنده، برای زنجیر کردن مفید است.

set Data Table(tableBuilder)

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

پارامترها

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

بازگشت

Table Chart Builder - این سازنده، برای زنجیر کردن مفید است.

set Data Table(table)

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

پارامترها

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

بازگشت

Table Chart Builder - این سازنده، برای زنجیر کردن مفید است.

set Data View Definition(dataViewDefinition)

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

پارامترها

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

بازگشت

Table Chart Builder - این سازنده، برای زنجیر کردن مفید است.

set Dimensions(width, height)

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

پارامترها

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

بازگشت

Table Chart Builder - این سازنده، برای زنجیر کردن مفید است.

set First Row Number(number)

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

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

// Creates a table chart builder and sets the first row to be 2.
const builder = Charts.newTableChart();
builder.setFirstRowNumber(2);

پارامترها

نام تایپ کنید توضیحات
number Integer شماره ردیف برای ردیف اول در جدول داده ها.

بازگشت

Table Chart Builder - این سازنده، برای زنجیر کردن مفید است.

set Initial Sorting Ascending(column)

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

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

// Creates a table chart builder and sorts it by the second column (ascending).
const builder = Charts.newTableChart();
builder.setInitialSortingAscending(2);

پارامترها

نام تایپ کنید توضیحات
column Integer شماره ستونی که جدول ابتدا باید بر اساس آن مرتب شود.

بازگشت

Table Chart Builder - این سازنده، برای زنجیر کردن مفید است.

set Initial Sorting Descending(column)

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

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

// Creates a table chart builder and sorts it by the second column (descending).
const builder = Charts.newTableChart();
builder.setInitialSortingDescending(2);

پارامترها

نام تایپ کنید توضیحات
column Integer شماره ستونی که جدول ابتدا باید بر اساس آن مرتب شود.

بازگشت

Table Chart Builder - این سازنده، برای زنجیر کردن مفید است.

set Option(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 مقدار برای تنظیم

بازگشت

Table Chart Builder - این سازنده ، برای زنجیره ای مفید است.

show Row Number Column(showRowNumber)

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

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

پارامترها

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

بازگشت

Table Chart Builder - این سازنده، برای زنجیر کردن مفید است.

use Alternating Row Style(alternate)

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

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

پارامترها

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

بازگشت

Table Chart Builder - این سازنده، برای زنجیر کردن مفید است.