Class TableChartBuilder

כלי היצירה שלתרשימיםוטבלאות

כלי ליצירת תרשימים מסוג טבלה. פרטים נוספים זמינים במסמכי העזרה של Google Charts.

הנה דוגמה ליצירת תרשים טבלה. הנתונים מיובאים מגיליון אלקטרוני של 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();

Methods

שיטהסוג הערך המוחזרתיאור קצר
build()Chartיצירת התרשים.
enablePaging(enablePaging)TableChartBuilderההגדרה קובעת אם להפעיל דפדוף בנתונים.
enablePaging(pageSize)TableChartBuilderהפעלת דפים והגדרת מספר השורות בכל דף.
enablePaging(pageSize, startPage)TableChartBuilderהפעלת דפדוף, הגדרת מספר השורות בכל דף והדף הראשון של הטבלה שיוצג (מספרי הדפים מתחילים באפס).
enableRtlTable(rtlEnabled)TableChartBuilderהוספת תמיכה בסיסית בשפות שמנוקדות מימין לשמאל (כמו ערבית או עברית) על ידי היפוך סדר העמודות בטבלה, כך שעמודה אפס היא העמודה הכי ימנית והעמודה האחרונה היא העמודה הכי שמאלית.
enableSorting(enableSorting)TableChartBuilderההגדרה קובעת אם למיין את העמודות כשהמשתמש לוחץ על כותרת עמודה.
setDataSourceUrl(url)TableChartBuilderהגדרת כתובת ה-URL של מקור הנתונים שמשמש כדי למשוך נתונים ממקור חיצוני, כמו Google Sheets.
setDataTable(tableBuilder)TableChartBuilderהגדרת טבלת הנתונים לשימוש בתרשים באמצעות DataTableBuilder.
setDataTable(table)TableChartBuilderהגדרת טבלת הנתונים שמכילה את הקווים של התרשים, וגם את התוויות של ציר ה-X.
setDataViewDefinition(dataViewDefinition)TableChartBuilderמגדיר את ההגדרה של תצוגת הנתונים שישמשו את התרשים.
setDimensions(width, height)TableChartBuilderהגדרת המאפיינים של התרשים.
setFirstRowNumber(number)TableChartBuilderהגדרת מספר השורה של השורה הראשונה בטבלת הנתונים.
setInitialSortingAscending(column)TableChartBuilderהגדרת האינדקס של העמודה לפיה צריך למיין את הטבלה בהתחלה (במצב עולה).
setInitialSortingDescending(column)TableChartBuilderהגדרת האינדקס של העמודה לפיה הטבלה צריכה להיות ממוינת בהתחלה (יורד).
setOption(option, value)TableChartBuilderהגדרת אפשרויות מתקדמות לתרשים הזה.
showRowNumberColumn(showRowNumber)TableChartBuilderמגדיר אם להציג את מספר השורה כעמודה הראשונה בטבלה.
useAlternatingRowStyle(alternate)TableChartBuilderקובע אם סגנון של צבעים מתחלפים יוקצה לשורות האי-זוגיות ולשורות הזוגיות של תרשים טבלה.

מסמכים מפורטים

build()

יצירת התרשים.

חזרה

Chart – אובייקט של תרשים, שאפשר להטמיע במסמכים, ברכיבי ממשק משתמש או להשתמש בו כתמונה סטטית.

enablePaging(enablePaging)

ההגדרה קובעת אם להפעיל דפדוף בנתונים.

ברירת המחדל היא שהדפדוף מושבת. אם הדפדוף מופעל, גודל הדף שמוגדר כברירת מחדל הוא 10.

פרמטרים

שםסוגתיאור
enablePagingBooleantrue אם צריך להפעיל את הדפדוף, false אחרת.

חזרה

TableChartBuilder — ה-builder הזה שימושי לשרשור.

enablePaging(pageSize)

הפעלת דפים והגדרת מספר השורות בכל דף.

גודל הדף שמוגדר כברירת מחדל הוא 10. 

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

פרמטרים

שםסוגתיאור
pageSizeIntegerמספר השורות בכל דף בטבלה.

חזרה

TableChartBuilder – ה-builder הזה שימושי לשרשור.

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

פרמטרים

שםסוגתיאור
pageSizeIntegerמספר השורות בכל דף בטבלה.
startPageIntegerדף הטבלה הראשון שיוצג (מספרי הדפים מתחילים באפס).

חזרה

TableChartBuilder — ה-builder הזה שימושי לשרשור.

enableRtlTable(rtlEnabled)

הוספת תמיכה בסיסית בשפות שמנוקדות מימין לשמאל (כמו ערבית או עברית) על ידי היפוך סדר העמודות בטבלה, כך שעמודה אפס היא העמודה הכי ימנית והעמודה האחרונה היא העמודה הכי שמאלית.

הפעולה הזו לא משפיעה על אינדקס העמודה בנתונים הבסיסיים, אלא רק על סדר התצוגה. גם עם האפשרות הזו, התצוגה החזותית של הטבלה לא תומכת בתצוגה דו-כיוונית מלאה (BiDi). המערכת תתעלם מהאפשרות הזו אם תפעילו את החלוקה לדפים (באמצעות האפשרות 'דף'), או אם יהיו בטבלה סרגליות גלילה כי ציינת אפשרויות גובה ורוחב קטנות יותר מגודל הטבלה הנדרש. ברירת המחדל היא שהתמיכה ב-RTL מושבתת.

פרמטרים

שםסוגתיאור
rtlEnabledBooleantrue אם צריך להפעיל תמיכה בקריאה מימין לשמאל, false אחרת.

חזרה

TableChartBuilder — ה-builder הזה שימושי לשרשור.

enableSorting(enableSorting)

ההגדרה קובעת אם למיין את העמודות כשהמשתמש לוחץ על כותרת עמודה.

אם המיון מופעל, כשמשתמשים לוחצים על כותרת העמודה, השורות ממוינות באופן אוטומטי. ברירת המחדל היא שהמיון מופעל.

פרמטרים

שםסוגתיאור
enableSortingBooleantrue כדי להפעיל מיון בלחיצה על כותרות העמודות, false אחרת.

חזרה

TableChartBuilder — ה-builder הזה שימושי לשרשור.

setDataSourceUrl(url)

הגדרת כתובת ה-URL של מקור הנתונים שמשמש כדי למשוך נתונים ממקור חיצוני, כמו Google Sheets. אם צוינו כתובת URL של מקור נתונים ו-DataTable, המערכת מתעלמת מכתובת ה-URL של מקור הנתונים.

מידע נוסף על שליחת שאילתות למקורות נתונים זמין במסמכי התיעוד של Google Charts.

פרמטרים

שםסוגתיאור
urlStringכתובת ה-URL של מקור הנתונים, כולל פרמטרים של שאילתה.

חזרה

TableChartBuilder — ה-builder הזה שימושי לשרשור.

setDataTable(tableBuilder)

הגדרת טבלת הנתונים לשימוש בתרשים באמצעות DataTableBuilder. זוהי שיטה נוחה להגדרת טבלת הנתונים בלי צורך לקרוא ל-build().

פרמטרים

שםסוגתיאור
tableBuilderDataTableBuilderכלי ליצירת טבלאות נתונים. כחלק מהקריאה הזו, נוצרת טבלת נתונים חדשה באופן מיידי, כך שעדכונים נוספים ב-builder לא ישתקפו בתרשים.

חזרה

TableChartBuilder — ה-builder הזה שימושי לשרשור.

setDataTable(table)

הגדרת טבלת הנתונים שמכילה את הקווים של התרשים, וגם את התוויות של ציר ה-X. העמודה הראשונה צריכה להיות מחרוזת, ולהכיל את תוויות הציר האנכי. אחרי העמודה הזו אפשר להוסיף כל מספר עמודות שרוצים, והן כולן חייבות לכלול מספרים. כל עמודה מוצגת בשורה נפרדת.

פרמטרים

שםסוגתיאור
tableDataTableSourceטבלת הנתונים שתשמש לתרשים.

חזרה

TableChartBuilder – ה-builder הזה שימושי לשרשור.

setDataViewDefinition(dataViewDefinition)

מגדיר את ההגדרה של תצוגת הנתונים שישמשו את התרשים.

פרמטרים

שםסוגתיאור
dataViewDefinitionDataViewDefinitionאובייקט של הגדרת תצוגת נתונים שמגדיר את התצוגה שצריך להפיק ממקור הנתונים הנתון לצורך ציור התרשים.

חזרה

TableChartBuilder – ה-builder הזה שימושי לשרשור.

setDimensions(width, height)

הגדרת המאפיינים של התרשים.

פרמטרים

שםסוגתיאור
widthIntegerרוחב התרשים, בפיקסלים.
heightIntegerהגובה של התרשים, בפיקסלים.

חזרה

TableChartBuilder — ה-builder הזה שימושי לשרשור.

setFirstRowNumber(number)

הגדרת מספר השורה של השורה הראשונה בטבלת הנתונים.

מספר השורה שמוגדר כברירת מחדל לשורה הראשונה הוא 1. 

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

פרמטרים

שםסוגתיאור
numberIntegerמספר השורה של השורה הראשונה בטבלת הנתונים.

חזרה

TableChartBuilder — ה-builder הזה שימושי לשרשור.

setInitialSortingAscending(column)

הגדרת האינדקס של העמודה לפיה צריך למיין את הטבלה בשלב הראשון (במצב עולה).

העמודה ממוינת בסדר עולה ומסומנת בחץ קטן שמציין זאת. 

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

פרמטרים

שםסוגתיאור
columnIntegerמספר העמודה שלפיה צריך למיין את הטבלה בשלב הראשון.

חזרה

TableChartBuilder — ה-builder הזה שימושי לשרשור.

setInitialSortingDescending(column)

הגדרת האינדקס של העמודה לפיה הטבלה צריכה להיות ממוינת בהתחלה (יורד).

העמודה ממוינת בסדר יורד ומסומנת בחץ קטן שמציין זאת. 

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

פרמטרים

שםסוגתיאור
columnIntegerמספר העמודה שלפיה צריך למיין את הטבלה בשלב הראשון.

חזרה

TableChartBuilder – ה-builder הזה שימושי לשרשור.

setOption(option, value)

הגדרת אפשרויות מתקדמות לתרשים הזה. האפשרויות הזמינות לתרשים הזה אם האפשרות שצוינה לא חוקית, אין להשפעה על השיטה הזו. 

// Build a table chart which renders HTML.
const builder = Charts.newTableChart();
builder.setOption('allowHtml', {@code true});
const chart = builder.build();

פרמטרים

שםסוגתיאור
optionStringהאפשרות להגדרה.
valueObjectהערך להגדרה.

חזרה

TableChartBuilder — ה-builder הזה שימושי לשרשור.

showRowNumberColumn(showRowNumber)

מגדיר אם להציג את מספר השורה כעמודה הראשונה בטבלה.

ברירת המחדל היא לא להציג את מספרי השורות.

פרמטרים

שםסוגתיאור
showRowNumberBooleantrue אם מספר השורה צריך להופיע בעמודה הראשונה של הטבלה, false אחרת.

חזרה

TableChartBuilder — ה-builder הזה שימושי לשרשור.

useAlternatingRowStyle(alternate)

קובע אם סגנון צבע לסירוגין יוקצה לשורות האי-זוגיות והזוגיות של תרשים טבלה.

ברירת המחדל היא שהשורות יהיו בסגנון צבע לסירוגין.

פרמטרים

שםסוגתיאור
alternateBooleantrue אם סגנונות הצבעים צריכים להיות לסירוגין, false אחרת.

חזרה

TableChartBuilder — ה-builder הזה שימושי לשרשור.