Class DataTableBuilder

DataTableBuilder

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

const data = Charts.newDataTable()
                 .addColumn(Charts.ColumnType.STRING, 'Month')
                 .addColumn(Charts.ColumnType.NUMBER, 'In Store')
                 .addColumn(Charts.ColumnType.NUMBER, 'Online')
                 .addRow(['January', 10, 1])
                 .addRow(['February', 12, 1])
                 .addRow(['March', 20, 2])
                 .addRow(['April', 25, 3])
                 .addRow(['May', 30, 4])
                 .build();

Methods

שיטה	סוג הערך המוחזר	תיאור קצר
addColumn(type, label)	DataTableBuilder	הוספת עמודה לטבלת הנתונים.
addRow(values)	DataTableBuilder	הוספת שורה לטבלת הנתונים.
build()	DataTable	יצירת טבלת נתונים והחזרתה.
setValue(row, column, value)	DataTableBuilder	הגדרת ערך ספציפי בטבלה.

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

addColumn(type, label)

הוספת עמודה לטבלת הנתונים. העמודות יתווספו מ-0 עד n.

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

פרמטרים

שם	סוג	תיאור
type	ColumnType	סוג הנתונים בעמודה (מספר, מחרוזת או תאריך)
label	String	התווית של העמודה (היא משמשת לכותרות של התרשימים).

חזרה

DataTableBuilder – ה-builder הזה, לשרשור.

---

addRow(values)

הוספת שורה לטבלת הנתונים.

פרמטרים

שם	סוג	תיאור
values	Object[]	ערכים של השורה, שצוינו באותו הסדר שבו העמודות הוזנו.

חזרה

DataTableBuilder – ה-builder הזה, לשרשור.

---

build()

יצירת טבלת נתונים והחזרתה.

חזרה

DataTable – טבלת הנתונים

זריקות

Error – אם טבלת הנתונים ריקה או לא תקינה מסיבה אחרת

---

setValue(row, column, value)

הגדרת ערך ספציפי בטבלה.

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

לא צריך למלא את כל ערכי העמודות. אלה שחסרים ייחשבו כ-null.

פרמטרים

שם	סוג	תיאור
row	Integer	אינדקס השורה (השורה הראשונה היא בעלת אינדקס 0)
column	Integer	אינדקס העמודה (לעמודה הראשונה יש אינדקס 0)
value	Object	הערך של תא הטבלה (צריך להיות מסוג המתאים לעמודה).

חזרה

DataTableBuilder – ה-builder הזה, לשרשור