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.

פרמטרים

שם	סוג	תיאור
enablePaging	Boolean	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);

פרמטרים

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

חזרה

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

פרמטרים

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

חזרה

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

---

enableRtlTable(rtlEnabled)

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

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

פרמטרים

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

חזרה

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

---

enableSorting(enableSorting)

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

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

פרמטרים

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

חזרה

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

---

setDataSourceUrl(url)

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

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

פרמטרים

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

חזרה

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

---

setDataTable(tableBuilder)

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

פרמטרים

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

חזרה

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

---

setDataTable(table)

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

פרמטרים

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

חזרה

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

---

setDataViewDefinition(dataViewDefinition)

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

פרמטרים

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

חזרה

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

---

setDimensions(width, height)

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

פרמטרים

שם	סוג	תיאור
width	Integer	רוחב התרשים, בפיקסלים.
height	Integer	הגובה של התרשים, בפיקסלים.

חזרה

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

פרמטרים

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

חזרה

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

---

setInitialSortingAscending(column)

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

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

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

פרמטרים

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

חזרה

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

---

setInitialSortingDescending(column)

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

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

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

פרמטרים

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

חזרה

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

פרמטרים

שם	סוג	תיאור
option	String	האפשרות להגדרה.
value	Object	הערך להגדרה.

חזרה

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

---

showRowNumberColumn(showRowNumber)

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

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

פרמטרים

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

חזרה

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

---

useAlternatingRowStyle(alternate)

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

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

פרמטרים

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

חזרה

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