Class TableChartBuilder

TableChartBuilder

‫Builder לתרשימי טבלה. פרטים נוספים מופיעים במאמרי העזרה בנושא 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 – אובייקט Chart, שאפשר להטמיע במסמכים או ברכיבי ממשק משתמש, או להשתמש בו כתמונה סטטית.

enablePaging(enablePaging)

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

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

פרמטרים

שםסוגתיאור
enablePagingBoolean‫true אם צריך להפעיל את העמודים, 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) אינה נתמכת בוויזואליזציית הטבלה. המערכת מתעלמת מהאפשרות הזו אם מפעילים את האפשרות page (חלוקה לדפים), או אם בטבלה יש סרגלי גלילה כי הגדרתם אפשרויות של גובה ורוחב שקטנות יותר מהגודל הנדרש של הטבלה. התנהגות ברירת המחדל היא השבתה של התמיכה ב-RTL.

פרמטרים

שםסוגתיאור
rtlEnabledBoolean‫true אם צריך להפעיל תמיכה בכתיבה מימין לשמאל, 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כלי ליצירת טבלאות נתונים. טבלת נתונים חדשה נוצרת באופן מיידי כחלק מהקריאה הזו, כך שעדכונים נוספים בכלי ליצירת תרשימים לא יבואו לידי ביטוי בתרשים.

חזרה

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

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

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

פרמטרים

שםסוגתיאור
showRowNumberBoolean‫true אם העמודה הראשונה בטבלה צריכה להציג את מספר השורה, false אחרת.

חזרה

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

useAlternatingRowStyle(alternate)

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

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

פרמטרים

שםסוגתיאור
alternateBoolean‫true אם סגנונות הצבע צריכים להיות מתחלפים, false אחרת.

חזרה

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